diff --git a/.gitignore b/.gitignore index b856834e..f5a95545 100644 --- a/.gitignore +++ b/.gitignore @@ -36,4 +36,14 @@ dist false/ metadata-v1.3/ registry.npmmirror.com/ -registry.npmjs.com/ \ No newline at end of file +registry.npmjs.com/ + +other/ +tools_optimize.md +Agents.md +CLAUDE.md + +**/*/coverage/* + +.docs/ +.claude/ \ No newline at end of file diff --git a/README.md b/README.md index 7dab132b..170c0c27 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,6 @@ [![Chrome Extension](https://img.shields.io/badge/Chrome-Extension-green.svg)](https://developer.chrome.com/docs/extensions/) [![Release](https://img.shields.io/github/v/release/hangwin/mcp-chrome.svg)](https://img.shields.io/github/v/release/hangwin/mcp-chrome.svg) - > 🌟 **Turn your Chrome browser into your intelligent assistant** - Let AI take control of your browser, transforming it into a powerful AI-controlled automation tool. **📖 Documentation**: [English](README.md) | [中文](README_zh.md) @@ -19,6 +18,10 @@ Chrome MCP Server is a Chrome extension-based **Model Context Protocol (MCP) server** that exposes your Chrome browser functionality to AI assistants like Claude, enabling complex browser automation, content analysis, and semantic search. Unlike traditional browser automation tools (like Playwright), **Chrome MCP Server** directly uses your daily Chrome browser, leveraging existing user habits, configurations, and login states, allowing various large models or chatbots to take control of your browser and truly become your everyday assistant. +## ✨ New Features(2025/12/30) + +- **A New Visual Editor for Claude Code & Codex**, for more detail here: [VisualEditor](docs/VisualEditor.md) + ## ✨ Core Features - 😁 **Chatbot/Model Agnostic**: Let any LLM or chatbot client or agent you prefer automate your browser @@ -46,7 +49,7 @@ Chrome MCP Server is a Chrome extension-based **Model Context Protocol (MCP) ser ### Prerequisites -- Node.js >= 18.19.0 and pnpm/npm +- Node.js >= 20.0.0 and pnpm/npm - Chrome/Chromium browser ### Installation Steps diff --git a/README_zh.md b/README_zh.md index 7ab48820..016eea42 100644 --- a/README_zh.md +++ b/README_zh.md @@ -16,6 +16,10 @@ Chrome MCP Server 是一个基于chrome插件的 **模型上下文协议 (MCP) 服务器**，它将您的 Chrome 浏览器功能暴露给 Claude 等 AI 助手，实现复杂的浏览器自动化、内容分析和语义搜索等。与传统的浏览器自动化工具（如playwright）不同，**Chrome MCP server**直接使用您日常使用的chrome浏览器，基于现有的用户习惯和配置、登录态，让各种大模型或者各种chatbot都可以接管你的浏览器，真正成为你的日常助手 +## ✨ 船新的功能(2025/12/30) + +- **让Claude Code/Codex也能使用的可视化编辑器**, 更多详情请看: [VisualEditor](docs/VisualEditor_zh.md) + ## ✨ 核心特性 - 😁 **chatbot/模型无关**：让任意你喜欢的llm或chatbot客户端或agent来自动化操作你的浏览器 @@ -43,7 +47,7 @@ Chrome MCP Server 是一个基于chrome插件的 **模型上下文协议 (MCP) ### 环境要求 -- Node.js >= 18.19.0 和 （npm 或 pnpm） +- Node.js >= 20.0.0 和 （npm 或 pnpm） - Chrome/Chromium 浏览器 ### 安装步骤 @@ -79,7 +83,7 @@ mcp-chrome-bridge register - 启用"开发者模式" - 点击"加载已解压的扩展程序"，选择 `your/dowloaded/extension/folder` - 点击插件图标打开插件，点击连接即可看到mcp的配置 - 截屏2025-06-09 15 52 06 + 截屏2025-06-09 15 52 06 ### 在支持MCP协议的客户端中使用 diff --git a/app/chrome-extension/_locales/en/messages.json b/app/chrome-extension/_locales/en/messages.json index c7500979..cc9b8f5a 100644 --- a/app/chrome-extension/_locales/en/messages.json +++ b/app/chrome-extension/_locales/en/messages.json @@ -442,5 +442,63 @@ "pagesUnit": { "message": "pages", "description": "Pages count unit" - } + }, + "userscriptsManagerTitle": { + "message": "Userscripts Manager", + "description": "Options page title" + }, + "emergencySwitchLabel": { "message": "Emergency Switch", "description": "Global disable switch" }, + "createRunSectionTitle": { + "message": "Create / Run", + "description": "Create & run section title" + }, + "nameLabel": { "message": "Name", "description": "Name input label" }, + "runAtLabel": { "message": "Run At", "description": "runAt select label" }, + "runAtAuto": { "message": "auto", "description": "runAt auto" }, + "runAtDocumentStart": { "message": "document_start", "description": "runAt document_start" }, + "runAtDocumentEnd": { "message": "document_end", "description": "runAt document_end" }, + "runAtDocumentIdle": { "message": "document_idle", "description": "runAt document_idle" }, + "worldLabel": { "message": "World", "description": "world select label" }, + "worldAuto": { "message": "auto", "description": "world auto" }, + "worldIsolated": { "message": "ISOLATED", "description": "ISOLATED world" }, + "worldMain": { "message": "MAIN", "description": "MAIN world" }, + "modeLabel": { "message": "Mode", "description": "mode select label" }, + "modeAuto": { "message": "auto", "description": "mode auto" }, + "modePersistent": { "message": "persistent", "description": "mode persistent" }, + "modeCss": { "message": "css", "description": "mode css" }, + "modeOnce": { "message": "once", "description": "mode once" }, + "allFramesLabel": { "message": "All Frames", "description": "allFrames checkbox" }, + "persistLabel": { "message": "Persist", "description": "persist checkbox" }, + "dnrFallbackLabel": { "message": "DNR Fallback", "description": "dnr fallback checkbox" }, + "matchesInputLabel": { "message": "Matches (comma-separated)", "description": "matches input" }, + "excludesInputLabel": { + "message": "Excludes (comma-separated)", + "description": "excludes input" + }, + "tagsInputLabel": { "message": "Tags (comma-separated)", "description": "tags input" }, + "scriptLabel": { "message": "Script", "description": "script textarea label" }, + "applyButton": { "message": "Apply", "description": "apply button" }, + "runOnceButton": { "message": "Run Once (CDP)", "description": "run once button" }, + "listSectionTitle": { "message": "List", "description": "list section title" }, + "queryLabel": { "message": "Query", "description": "query input label" }, + "statusAll": { "message": "all", "description": "status all" }, + "statusEnabled": { "message": "enabled", "description": "status enabled" }, + "statusDisabled": { "message": "disabled", "description": "status disabled" }, + "domainLabel": { "message": "Domain", "description": "domain filter label" }, + "exportAllButton": { "message": "Export All", "description": "export button" }, + "tableHeaderName": { "message": "Name", "description": "table header name" }, + "tableHeaderWorld": { "message": "World", "description": "table header world" }, + "tableHeaderRunAt": { "message": "Run At", "description": "table header runAt" }, + "tableHeaderUpdated": { "message": "Updated", "description": "table header updated" }, + "deleteButton": { "message": "Delete", "description": "delete button" }, + "placeholderOptional": { "message": "optional", "description": "generic optional placeholder" }, + "placeholderMatchesExample": { + "message": "e.g. https://*.example.com/*", + "description": "matches example placeholder" + }, + "placeholderScriptHint": { + "message": "Paste JS/CSS/TM here", + "description": "script textarea placeholder" + }, + "placeholderDomainHint": { "message": "example.com", "description": "domain filter placeholder" } } diff --git a/app/chrome-extension/_locales/zh_CN/messages.json b/app/chrome-extension/_locales/zh_CN/messages.json index 7c5a72ad..a8901ab1 100644 --- a/app/chrome-extension/_locales/zh_CN/messages.json +++ b/app/chrome-extension/_locales/zh_CN/messages.json @@ -442,5 +442,51 @@ "pagesUnit": { "message": "页", "description": "页面计数单位" - } + }, + "userscriptsManagerTitle": { "message": "脚本管理器", "description": "Options 页标题" }, + "emergencySwitchLabel": { "message": "紧急开关", "description": "紧急关闭开关" }, + "createRunSectionTitle": { "message": "创建 / 运行", "description": "创建与运行分区标题" }, + "nameLabel": { "message": "名称", "description": "名称输入标签" }, + "runAtLabel": { "message": "运行时机", "description": "runAt 选择标签" }, + "runAtAuto": { "message": "自动", "description": "runAt auto" }, + "runAtDocumentStart": { "message": "document_start", "description": "runAt document_start" }, + "runAtDocumentEnd": { "message": "document_end", "description": "runAt document_end" }, + "runAtDocumentIdle": { "message": "document_idle", "description": "runAt document_idle" }, + "worldLabel": { "message": "执行上下文", "description": "world 选择标签" }, + "worldAuto": { "message": "自动", "description": "world auto" }, + "worldIsolated": { "message": "隔离 (ISOLATED)", "description": "ISOLATED world" }, + "worldMain": { "message": "页面 (MAIN)", "description": "MAIN world" }, + "modeLabel": { "message": "模式", "description": "模式选择标签" }, + "modeAuto": { "message": "自动", "description": "mode auto" }, + "modePersistent": { "message": "持久", "description": "mode persistent" }, + "modeCss": { "message": "仅样式 (CSS)", "description": "mode css" }, + "modeOnce": { "message": "一次运行 (CDP)", "description": "mode once" }, + "allFramesLabel": { "message": "全部 frame", "description": "allFrames 复选框" }, + "persistLabel": { "message": "持久化", "description": "persist 复选框" }, + "dnrFallbackLabel": { "message": "DNR 回退", "description": "DNR fallback 复选框" }, + "matchesInputLabel": { "message": "匹配（逗号分隔）", "description": "matches 输入" }, + "excludesInputLabel": { "message": "排除（逗号分隔）", "description": "excludes 输入" }, + "tagsInputLabel": { "message": "标签（逗号分隔）", "description": "tags 输入" }, + "scriptLabel": { "message": "脚本", "description": "脚本文本标签" }, + "applyButton": { "message": "应用", "description": "应用按钮" }, + "runOnceButton": { "message": "一次运行（CDP）", "description": "一次运行按钮" }, + "listSectionTitle": { "message": "脚本列表", "description": "列表分区标题" }, + "queryLabel": { "message": "搜索", "description": "查询输入标签" }, + "statusAll": { "message": "全部", "description": "状态-全部" }, + "statusEnabled": { "message": "启用", "description": "状态-启用" }, + "statusDisabled": { "message": "禁用", "description": "状态-禁用" }, + "domainLabel": { "message": "域名", "description": "域名过滤标签" }, + "exportAllButton": { "message": "导出全部", "description": "导出按钮" }, + "tableHeaderName": { "message": "名称", "description": "表头-名称" }, + "tableHeaderWorld": { "message": "执行上下文", "description": "表头-World" }, + "tableHeaderRunAt": { "message": "运行时机", "description": "表头-RunAt" }, + "tableHeaderUpdated": { "message": "更新时间", "description": "表头-更新时间" }, + "deleteButton": { "message": "删除", "description": "删除按钮" }, + "placeholderOptional": { "message": "可选", "description": "通用可选占位符" }, + "placeholderMatchesExample": { + "message": "例如：https://*.example.com/*", + "description": "匹配示例占位符" + }, + "placeholderScriptHint": { "message": "在此粘贴 JS/CSS/TM", "description": "脚本文本域占位符" }, + "placeholderDomainHint": { "message": "example.com", "description": "域名筛选占位符" } } diff --git a/app/chrome-extension/common/agent-models.ts b/app/chrome-extension/common/agent-models.ts new file mode 100644 index 00000000..85b81d7d --- /dev/null +++ b/app/chrome-extension/common/agent-models.ts @@ -0,0 +1,270 @@ +/** + * Agent CLI Model Definitions. + * + * Static model definitions for each CLI type. + * Based on the pattern from Claudable (other/cweb). + */ + +import type { CodexReasoningEffort } from 'chrome-mcp-shared'; + +// ============================================================ +// Types +// ============================================================ + +export interface ModelDefinition { + id: string; + name: string; + description?: string; + supportsImages?: boolean; + /** Supported reasoning effort levels for Codex models */ + supportedReasoningEfforts?: readonly CodexReasoningEffort[]; +} + +export type AgentCliType = 'claude' | 'codex' | 'cursor' | 'qwen' | 'glm'; + +// ============================================================ +// Claude Models +// ============================================================ + +export const CLAUDE_MODELS: ModelDefinition[] = [ + { + id: 'claude-sonnet-4-5-20250929', + name: 'Claude Sonnet 4.5', + description: 'Balanced model with large context window', + supportsImages: true, + }, + { + id: 'claude-opus-4-5-20251101', + name: 'Claude Opus 4.5', + description: 'Strongest reasoning model', + supportsImages: true, + }, + { + id: 'claude-haiku-4-5-20251001', + name: 'Claude Haiku 4.5', + description: 'Fast and cost-efficient', + supportsImages: true, + }, +]; + +export const CLAUDE_DEFAULT_MODEL = 'claude-sonnet-4-5-20250929'; + +// ============================================================ +// Codex Models +// ============================================================ + +/** Standard reasoning efforts supported by all models */ +const CODEX_STANDARD_EFFORTS: readonly CodexReasoningEffort[] = ['low', 'medium', 'high']; +/** Extended reasoning efforts (includes xhigh) - only for gpt-5.2 and gpt-5.1-codex-max */ +const CODEX_EXTENDED_EFFORTS: readonly CodexReasoningEffort[] = ['low', 'medium', 'high', 'xhigh']; + +export const CODEX_MODELS: ModelDefinition[] = [ + { + id: 'gpt-5.1', + name: 'GPT-5.1', + description: 'OpenAI high-quality reasoning model', + supportedReasoningEfforts: CODEX_STANDARD_EFFORTS, + }, + { + id: 'gpt-5.2', + name: 'GPT-5.2', + description: 'OpenAI flagship reasoning model with extended effort support', + supportedReasoningEfforts: CODEX_EXTENDED_EFFORTS, + }, + { + id: 'gpt-5.1-codex', + name: 'GPT-5.1 Codex', + description: 'Coding-optimized model for agent workflows', + supportedReasoningEfforts: CODEX_STANDARD_EFFORTS, + }, + { + id: 'gpt-5.1-codex-max', + name: 'GPT-5.1 Codex Max', + description: 'Highest quality coding model with extended effort support', + supportedReasoningEfforts: CODEX_EXTENDED_EFFORTS, + }, + { + id: 'gpt-5.1-codex-mini', + name: 'GPT-5.1 Codex Mini', + description: 'Fast, cost-efficient coding model', + supportedReasoningEfforts: CODEX_STANDARD_EFFORTS, + }, +]; + +export const CODEX_DEFAULT_MODEL = 'gpt-5.1'; + +// Codex model alias normalization +const CODEX_ALIAS_MAP: Record = { + gpt5: 'gpt-5.1', + gpt_5: 'gpt-5.1', + 'gpt-5': 'gpt-5.1', + 'gpt-5.0': 'gpt-5.1', +}; + +const CODEX_KNOWN_IDS = new Set(CODEX_MODELS.map((model) => model.id)); + +/** + * Normalize a Codex model ID, handling aliases and falling back to default. + */ +export function normalizeCodexModelId(model?: string | null): string { + if (!model || typeof model !== 'string') { + return CODEX_DEFAULT_MODEL; + } + + const trimmed = model.trim(); + if (!trimmed) { + return CODEX_DEFAULT_MODEL; + } + + const lower = trimmed.toLowerCase(); + if (CODEX_ALIAS_MAP[lower]) { + return CODEX_ALIAS_MAP[lower]; + } + + if (CODEX_KNOWN_IDS.has(lower)) { + return lower; + } + + // If the exact casing exists, allow it + if (CODEX_KNOWN_IDS.has(trimmed)) { + return trimmed; + } + + return CODEX_DEFAULT_MODEL; +} + +/** + * Get supported reasoning efforts for a Codex model. + * Returns standard efforts (low/medium/high) for unknown models. + */ +export function getCodexReasoningEfforts(modelId?: string | null): readonly CodexReasoningEffort[] { + const normalized = normalizeCodexModelId(modelId); + const model = CODEX_MODELS.find((m) => m.id === normalized); + return model?.supportedReasoningEfforts ?? CODEX_STANDARD_EFFORTS; +} + +/** + * Check if a model supports xhigh reasoning effort. + */ +export function supportsXhighEffort(modelId?: string | null): boolean { + const efforts = getCodexReasoningEfforts(modelId); + return efforts.includes('xhigh'); +} + +// ============================================================ +// Cursor Models +// ============================================================ + +export const CURSOR_MODELS: ModelDefinition[] = [ + { + id: 'auto', + name: 'Auto', + description: 'Cursor auto-selects the best model', + }, + { + id: 'claude-sonnet-4-5-20250929', + name: 'Claude Sonnet 4.5', + description: 'Anthropic Claude via Cursor', + supportsImages: true, + }, + { + id: 'gpt-4.1', + name: 'GPT-4.1', + description: 'OpenAI model via Cursor', + }, +]; + +export const CURSOR_DEFAULT_MODEL = 'auto'; + +// ============================================================ +// Qwen Models +// ============================================================ + +export const QWEN_MODELS: ModelDefinition[] = [ + { + id: 'qwen3-coder-plus', + name: 'Qwen3 Coder Plus', + description: 'Balanced 32k context model for coding', + }, + { + id: 'qwen3-coder-pro', + name: 'Qwen3 Coder Pro', + description: 'Larger 128k context with stronger reasoning', + }, + { + id: 'qwen3-coder', + name: 'Qwen3 Coder', + description: 'Fast iteration model', + }, +]; + +export const QWEN_DEFAULT_MODEL = 'qwen3-coder-plus'; + +// ============================================================ +// GLM Models +// ============================================================ + +export const GLM_MODELS: ModelDefinition[] = [ + { + id: 'glm-4.6', + name: 'GLM 4.6', + description: 'Zhipu GLM 4.6 agent runtime', + }, +]; + +export const GLM_DEFAULT_MODEL = 'glm-4.6'; + +// ============================================================ +// Aggregated Definitions +// ============================================================ + +export const CLI_MODEL_DEFINITIONS: Record = { + claude: CLAUDE_MODELS, + codex: CODEX_MODELS, + cursor: CURSOR_MODELS, + qwen: QWEN_MODELS, + glm: GLM_MODELS, +}; + +export const CLI_DEFAULT_MODELS: Record = { + claude: CLAUDE_DEFAULT_MODEL, + codex: CODEX_DEFAULT_MODEL, + cursor: CURSOR_DEFAULT_MODEL, + qwen: QWEN_DEFAULT_MODEL, + glm: GLM_DEFAULT_MODEL, +}; + +// ============================================================ +// Helper Functions +// ============================================================ + +/** + * Get model definitions for a specific CLI type. + */ +export function getModelsForCli(cli: string | null | undefined): ModelDefinition[] { + if (!cli) return []; + const key = cli.toLowerCase() as AgentCliType; + return CLI_MODEL_DEFINITIONS[key] || []; +} + +/** + * Get the default model for a CLI type. + */ +export function getDefaultModelForCli(cli: string | null | undefined): string { + if (!cli) return ''; + const key = cli.toLowerCase() as AgentCliType; + return CLI_DEFAULT_MODELS[key] || ''; +} + +/** + * Get display name for a model ID. + */ +export function getModelDisplayName( + cli: string | null | undefined, + modelId: string | null | undefined, +): string { + if (!cli || !modelId) return modelId || ''; + const models = getModelsForCli(cli); + const model = models.find((m) => m.id === modelId); + return model?.name || modelId; +} diff --git a/app/chrome-extension/common/constants.ts b/app/chrome-extension/common/constants.ts index 6cd5cc4b..bae7ff01 100644 --- a/app/chrome-extension/common/constants.ts +++ b/app/chrome-extension/common/constants.ts @@ -56,6 +56,11 @@ export const SUCCESS_MESSAGES = { SERVER_STOPPED: 'Server stopped successfully', } as const; +// External Links +export const LINKS = { + TROUBLESHOOTING: 'https://github.com/hangwin/mcp-chrome/blob/master/docs/TROUBLESHOOTING.md', +} as const; + // File Extensions and MIME Types export const FILE_TYPES = { STATIC_EXTENSIONS: [ @@ -77,12 +82,128 @@ export const FILE_TYPES = { // Network Filtering export const NETWORK_FILTERS = { + // Substring match against full URL (not just hostname) to support patterns like 'facebook.com/tr' EXCLUDED_DOMAINS: [ + // Google 'google-analytics.com', 'googletagmanager.com', - 'facebook.com', + 'analytics.google.com', 'doubleclick.net', 'googlesyndication.com', + 'googleads.g.doubleclick.net', + 'stats.g.doubleclick.net', + 'adservice.google.com', + 'pagead2.googlesyndication.com', + // Amazon + 'amazon-adsystem.com', + // Microsoft + 'bat.bing.com', + 'clarity.ms', + // Facebook + 'connect.facebook.net', + 'facebook.com/tr', + // Twitter + 'analytics.twitter.com', + 'ads-twitter.com', + // Other ad networks + 'ads.yahoo.com', + 'adroll.com', + 'adnxs.com', + 'criteo.com', + 'quantserve.com', + 'scorecardresearch.com', + // Analytics & session recording + 'segment.io', + 'amplitude.com', + 'mixpanel.com', + 'optimizely.com', + 'static.hotjar.com', + 'script.hotjar.com', + 'crazyegg.com', + 'clicktale.net', + 'mouseflow.com', + 'fullstory.com', + // LinkedIn (tracking pixels) + 'linkedin.com/px', + ], + // Static resource extensions (used when includeStatic=false) + STATIC_RESOURCE_EXTENSIONS: [ + '.jpg', + '.jpeg', + '.png', + '.gif', + '.svg', + '.webp', + '.ico', + '.bmp', + '.cur', + '.css', + '.scss', + '.less', + '.js', + '.jsx', + '.ts', + '.tsx', + '.map', + '.woff', + '.woff2', + '.ttf', + '.eot', + '.otf', + '.mp3', + '.mp4', + '.avi', + '.mov', + '.wmv', + '.flv', + '.webm', + '.ogg', + '.wav', + '.pdf', + '.zip', + '.rar', + '.7z', + '.iso', + '.dmg', + '.doc', + '.docx', + '.xls', + '.xlsx', + '.ppt', + '.pptx', + ], + // MIME types treated as static/binary (filtered when includeStatic=false) + STATIC_MIME_TYPES_TO_FILTER: [ + 'image/', + 'font/', + 'audio/', + 'video/', + 'text/css', + 'text/javascript', + 'application/javascript', + 'application/x-javascript', + 'application/pdf', + 'application/zip', + 'application/octet-stream', + ], + // API-like MIME types (never filtered by MIME) + API_MIME_TYPES: [ + 'application/json', + 'application/xml', + 'text/xml', + 'text/plain', + 'text/event-stream', + 'application/x-www-form-urlencoded', + 'application/graphql', + 'application/grpc', + 'application/protobuf', + 'application/x-protobuf', + 'application/x-json', + 'application/ld+json', + 'application/problem+json', + 'application/problem+xml', + 'application/soap+xml', + 'application/vnd.api+json', ], STATIC_RESOURCE_TYPES: ['stylesheet', 'image', 'font', 'media', 'other'], } as const; @@ -99,9 +220,21 @@ export const SEMANTIC_CONFIG = { // Storage Keys export const STORAGE_KEYS = { SERVER_STATUS: 'serverStatus', + NATIVE_SERVER_PORT: 'nativeServerPort', + NATIVE_AUTO_CONNECT_ENABLED: 'nativeAutoConnectEnabled', SEMANTIC_MODEL: 'selectedModel', USER_PREFERENCES: 'userPreferences', VECTOR_INDEX: 'vectorIndex', + USERSCRIPTS: 'userscripts', + USERSCRIPTS_DISABLED: 'userscripts_disabled', + // Record & Replay storage keys + RR_FLOWS: 'rr_flows', + RR_RUNS: 'rr_runs', + RR_PUBLISHED: 'rr_published_flows', + RR_SCHEDULES: 'rr_schedules', + RR_TRIGGERS: 'rr_triggers', + // Persistent recording state (guards resume across navigations/service worker restarts) + RR_RECORDING_STATE: 'rr_recording_state', } as const; // Notification Configuration diff --git a/app/chrome-extension/common/element-marker-types.ts b/app/chrome-extension/common/element-marker-types.ts new file mode 100644 index 00000000..30403fea --- /dev/null +++ b/app/chrome-extension/common/element-marker-types.ts @@ -0,0 +1,83 @@ +// Element marker types shared across background, content scripts, and popup + +export type UrlMatchType = 'exact' | 'prefix' | 'host'; + +export interface ElementMarker { + id: string; + // Original URL where the marker was created + url: string; + // Normalized pieces to support matching + origin: string; // scheme + host + port + host: string; // hostname + path: string; // pathname part only + matchType: UrlMatchType; // default: 'prefix' + + name: string; // Human-friendly name, e.g., "Login Button" + selector: string; // Selector string + selectorType?: 'css' | 'xpath'; // Default: css + listMode?: boolean; // Whether this marker was created in list mode (allows multiple matches) + action?: 'click' | 'fill' | 'custom'; // Intended action hint (optional) + + createdAt: number; + updatedAt: number; +} + +export interface UpsertMarkerRequest { + id?: string; + url: string; + name: string; + selector: string; + selectorType?: 'css' | 'xpath'; + listMode?: boolean; + matchType?: UrlMatchType; + action?: 'click' | 'fill' | 'custom'; +} + +// Validation actions for MCP-integrated verification +export enum MarkerValidationAction { + Hover = 'hover', + LeftClick = 'left_click', + RightClick = 'right_click', + DoubleClick = 'double_click', + TypeText = 'type_text', + PressKeys = 'press_keys', + Scroll = 'scroll', +} + +export interface MarkerValidationRequest { + selector: string; + selectorType?: 'css' | 'xpath'; + action: MarkerValidationAction; + // Optional payload for certain actions + text?: string; // for type_text + keys?: string; // for press_keys + // Event options for click-like actions + button?: 'left' | 'right' | 'middle'; + bubbles?: boolean; + cancelable?: boolean; + modifiers?: { altKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; shiftKey?: boolean }; + // Targeting options + coordinates?: { x: number; y: number }; // absolute viewport coords + offsetX?: number; // relative to element center if relativeTo = 'element' + offsetY?: number; + relativeTo?: 'element' | 'viewport'; + // Navigation options for click-like actions + waitForNavigation?: boolean; + timeoutMs?: number; + // Scroll options + scrollDirection?: 'up' | 'down' | 'left' | 'right'; + scrollAmount?: number; // pixels per tick +} + +export interface MarkerValidationResponse { + success: boolean; + resolved?: boolean; + ref?: string; + center?: { x: number; y: number }; + tool?: { name: string; ok: boolean; error?: string }; + error?: string; +} + +export interface MarkerQuery { + url?: string; // If present, query by URL match; otherwise list all +} diff --git a/app/chrome-extension/common/message-types.ts b/app/chrome-extension/common/message-types.ts index 4cc03c86..96981858 100644 --- a/app/chrome-extension/common/message-types.ts +++ b/app/chrome-extension/common/message-types.ts @@ -3,6 +3,8 @@ * Note: Native message types are imported from the shared package */ +import type { RealtimeEvent } from 'chrome-mcp-shared'; + // Message targets for routing export enum MessageTarget { Offscreen = 'offscreen', @@ -21,6 +23,71 @@ export const BACKGROUND_MESSAGE_TYPES = { REFRESH_SERVER_STATUS: 'refresh_server_status', SERVER_STATUS_CHANGED: 'server_status_changed', INITIALIZE_SEMANTIC_ENGINE: 'initialize_semantic_engine', + // Record & Replay background control and queries + RR_START_RECORDING: 'rr_start_recording', + RR_STOP_RECORDING: 'rr_stop_recording', + RR_PAUSE_RECORDING: 'rr_pause_recording', + RR_RESUME_RECORDING: 'rr_resume_recording', + RR_GET_RECORDING_STATUS: 'rr_get_recording_status', + RR_LIST_FLOWS: 'rr_list_flows', + RR_FLOWS_CHANGED: 'rr_flows_changed', + RR_GET_FLOW: 'rr_get_flow', + RR_DELETE_FLOW: 'rr_delete_flow', + RR_PUBLISH_FLOW: 'rr_publish_flow', + RR_UNPUBLISH_FLOW: 'rr_unpublish_flow', + RR_RUN_FLOW: 'rr_run_flow', + RR_SAVE_FLOW: 'rr_save_flow', + RR_EXPORT_FLOW: 'rr_export_flow', + RR_EXPORT_ALL: 'rr_export_all', + RR_IMPORT_FLOW: 'rr_import_flow', + RR_LIST_RUNS: 'rr_list_runs', + // Triggers + RR_LIST_TRIGGERS: 'rr_list_triggers', + RR_SAVE_TRIGGER: 'rr_save_trigger', + RR_DELETE_TRIGGER: 'rr_delete_trigger', + RR_REFRESH_TRIGGERS: 'rr_refresh_triggers', + // Scheduling + RR_SCHEDULE_FLOW: 'rr_schedule_flow', + RR_UNSCHEDULE_FLOW: 'rr_unschedule_flow', + RR_LIST_SCHEDULES: 'rr_list_schedules', + // Element marker management + ELEMENT_MARKER_LIST_ALL: 'element_marker_list_all', + ELEMENT_MARKER_LIST_FOR_URL: 'element_marker_list_for_url', + ELEMENT_MARKER_SAVE: 'element_marker_save', + ELEMENT_MARKER_UPDATE: 'element_marker_update', + ELEMENT_MARKER_DELETE: 'element_marker_delete', + ELEMENT_MARKER_VALIDATE: 'element_marker_validate', + ELEMENT_MARKER_START: 'element_marker_start_from_popup', + // Element picker (human-in-the-loop element selection) + ELEMENT_PICKER_UI_EVENT: 'element_picker_ui_event', + ELEMENT_PICKER_FRAME_EVENT: 'element_picker_frame_event', + // Web editor (in-page visual editing) + WEB_EDITOR_TOGGLE: 'web_editor_toggle', + WEB_EDITOR_APPLY: 'web_editor_apply', + WEB_EDITOR_STATUS_QUERY: 'web_editor_status_query', + // Web editor <-> AgentChat integration (Phase 1.1) + WEB_EDITOR_APPLY_BATCH: 'web_editor_apply_batch', + WEB_EDITOR_TX_CHANGED: 'web_editor_tx_changed', + WEB_EDITOR_HIGHLIGHT_ELEMENT: 'web_editor_highlight_element', + // Web editor <-> AgentChat integration (Phase 2 - Revert) + WEB_EDITOR_REVERT_ELEMENT: 'web_editor_revert_element', + // Web editor <-> AgentChat integration - Selection sync + WEB_EDITOR_SELECTION_CHANGED: 'web_editor_selection_changed', + // Web editor <-> AgentChat integration - Clear selection (sidepanel -> web-editor) + WEB_EDITOR_CLEAR_SELECTION: 'web_editor_clear_selection', + // Web editor <-> AgentChat integration - Cancel execution + WEB_EDITOR_CANCEL_EXECUTION: 'web_editor_cancel_execution', + // Web editor props (Phase 7.1.6 early injection) + WEB_EDITOR_PROPS_REGISTER_EARLY_INJECTION: 'web_editor_props_register_early_injection', + // Web editor props - open source file in VSCode + WEB_EDITOR_OPEN_SOURCE: 'web_editor_open_source', + // Quick Panel <-> AgentChat integration + QUICK_PANEL_SEND_TO_AI: 'quick_panel_send_to_ai', + QUICK_PANEL_CANCEL_AI: 'quick_panel_cancel_ai', + // Quick Panel Search - Tabs bridge + QUICK_PANEL_TABS_QUERY: 'quick_panel_tabs_query', + QUICK_PANEL_TAB_ACTIVATE: 'quick_panel_tab_activate', + QUICK_PANEL_TAB_CLOSE: 'quick_panel_tab_close', } as const; // Offscreen message types @@ -29,6 +96,10 @@ export const OFFSCREEN_MESSAGE_TYPES = { SIMILARITY_ENGINE_COMPUTE: 'similarityEngineCompute', SIMILARITY_ENGINE_BATCH_COMPUTE: 'similarityEngineBatchCompute', SIMILARITY_ENGINE_STATUS: 'similarityEngineStatus', + // GIF encoding + GIF_ADD_FRAME: 'gifAddFrame', + GIF_FINISH: 'gifFinish', + GIF_RESET: 'gifReset', } as const; // Content script message types @@ -41,6 +112,9 @@ export const CONTENT_MESSAGE_TYPES = { KEYBOARD_HELPER_PING: 'keyboard_helper_ping', SCREENSHOT_HELPER_PING: 'screenshot_helper_ping', INTERACTIVE_ELEMENTS_HELPER_PING: 'interactive_elements_helper_ping', + ACCESSIBILITY_TREE_HELPER_PING: 'chrome_read_page_ping', + WAIT_HELPER_PING: 'wait_helper_ping', + DOM_OBSERVER_PING: 'dom_observer_ping', } as const; // Tool action message types (for chrome.runtime.sendMessage) @@ -64,12 +138,44 @@ export const TOOL_MESSAGE_TYPES = { // Interactive elements GET_INTERACTIVE_ELEMENTS: 'getInteractiveElements', + // Accessibility tree + GENERATE_ACCESSIBILITY_TREE: 'generateAccessibilityTree', + RESOLVE_REF: 'resolveRef', + ENSURE_REF_FOR_SELECTOR: 'ensureRefForSelector', + VERIFY_FINGERPRINT: 'verifyFingerprint', + DISPATCH_HOVER_FOR_REF: 'dispatchHoverForRef', + // Network requests NETWORK_SEND_REQUEST: 'sendPureNetworkRequest', + // Wait helper + WAIT_FOR_TEXT: 'waitForText', + // Semantic similarity engine SIMILARITY_ENGINE_INIT: 'similarityEngineInit', SIMILARITY_ENGINE_COMPUTE_BATCH: 'similarityEngineComputeBatch', + // Record & Replay content script bridge + RR_RECORDER_CONTROL: 'rr_recorder_control', + RR_RECORDER_EVENT: 'rr_recorder_event', + // Record & Replay timeline feed (background -> content overlay) + RR_TIMELINE_UPDATE: 'rr_timeline_update', + // Quick Panel AI streaming events (background -> content script) + QUICK_PANEL_AI_EVENT: 'quick_panel_ai_event', + // DOM observer trigger bridge + SET_DOM_TRIGGERS: 'set_dom_triggers', + DOM_TRIGGER_FIRED: 'dom_trigger_fired', + // Record & Replay overlay: variable collection + COLLECT_VARIABLES: 'collectVariables', + // Element marker overlay control (content-side) + ELEMENT_MARKER_START: 'element_marker_start', + // Element picker (tool-driven, background <-> content scripts) + ELEMENT_PICKER_START: 'elementPickerStart', + ELEMENT_PICKER_STOP: 'elementPickerStop', + ELEMENT_PICKER_SET_ACTIVE_REQUEST: 'elementPickerSetActiveRequest', + ELEMENT_PICKER_UI_PING: 'elementPickerUiPing', + ELEMENT_PICKER_UI_SHOW: 'elementPickerUiShow', + ELEMENT_PICKER_UI_UPDATE: 'elementPickerUiUpdate', + ELEMENT_PICKER_UI_HIDE: 'elementPickerUiHide', } as const; // Type unions for type safety @@ -112,3 +218,178 @@ export enum SendMessageType { SimilarityEngineInit = 'similarityEngineInit', SimilarityEngineComputeBatch = 'similarityEngineComputeBatch', } + +// ============================================================ +// Quick Panel <-> AgentChat Message Contracts +// ============================================================ + +/** + * Context information that can be attached to a Quick Panel AI request. + * Allows passing page-specific data to enhance the AI's understanding. + */ +export interface QuickPanelAIContext { + /** Current page URL */ + pageUrl?: string; + /** User's text selection on the page */ + selectedText?: string; + /** + * Optional element metadata from the page. + * Kept as unknown to avoid tight coupling with specific element types. + */ + elementInfo?: unknown; +} + +/** + * Payload for sending a message to AI via Quick Panel. + */ +export interface QuickPanelSendToAIPayload { + /** The user's instruction/question for the AI */ + instruction: string; + /** Optional contextual information from the page */ + context?: QuickPanelAIContext; +} + +/** + * Response from QUICK_PANEL_SEND_TO_AI message handler. + */ +export type QuickPanelSendToAIResponse = + | { success: true; requestId: string; sessionId: string } + | { success: false; error: string }; + +/** + * Message structure for sending to AI. + */ +export interface QuickPanelSendToAIMessage { + type: typeof BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_SEND_TO_AI; + payload: QuickPanelSendToAIPayload; +} + +/** + * Payload for cancelling an active AI request. + */ +export interface QuickPanelCancelAIPayload { + /** The request ID to cancel */ + requestId: string; + /** + * Optional session ID for fallback when background state is missing. + * This can happen after MV3 Service Worker restarts. + */ + sessionId?: string; +} + +/** + * Response from QUICK_PANEL_CANCEL_AI message handler. + */ +export type QuickPanelCancelAIResponse = { success: true } | { success: false; error: string }; + +/** + * Message structure for cancelling AI request. + */ +export interface QuickPanelCancelAIMessage { + type: typeof BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_CANCEL_AI; + payload: QuickPanelCancelAIPayload; +} + +/** + * Message pushed from background to content script with AI streaming events. + * Uses the same RealtimeEvent type as AgentChat for consistency. + */ +export interface QuickPanelAIEventMessage { + action: typeof TOOL_MESSAGE_TYPES.QUICK_PANEL_AI_EVENT; + requestId: string; + sessionId: string; + event: RealtimeEvent; +} + +// ============================================================ +// Quick Panel Search - Tabs Bridge Contracts +// ============================================================ + +/** + * Payload for querying open tabs. + */ +export interface QuickPanelTabsQueryPayload { + /** + * When true (default), query tabs across all windows. + * When false, restrict results to the sender's window. + */ + includeAllWindows?: boolean; +} + +/** + * Summary of a single tab returned from the background. + */ +export interface QuickPanelTabSummary { + tabId: number; + windowId: number; + title: string; + url: string; + favIconUrl?: string; + active: boolean; + pinned: boolean; + audible: boolean; + muted: boolean; + index: number; + lastAccessed?: number; +} + +/** + * Response from QUICK_PANEL_TABS_QUERY message handler. + */ +export type QuickPanelTabsQueryResponse = + | { + success: true; + tabs: QuickPanelTabSummary[]; + currentTabId: number | null; + currentWindowId: number | null; + } + | { success: false; error: string }; + +/** + * Message structure for querying tabs. + */ +export interface QuickPanelTabsQueryMessage { + type: typeof BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TABS_QUERY; + payload?: QuickPanelTabsQueryPayload; +} + +/** + * Payload for activating a tab. + */ +export interface QuickPanelActivateTabPayload { + tabId: number; + windowId?: number; +} + +/** + * Response from QUICK_PANEL_TAB_ACTIVATE message handler. + */ +export type QuickPanelActivateTabResponse = { success: true } | { success: false; error: string }; + +/** + * Message structure for activating a tab. + */ +export interface QuickPanelActivateTabMessage { + type: typeof BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_ACTIVATE; + payload: QuickPanelActivateTabPayload; +} + +/** + * Payload for closing a tab. + */ +export interface QuickPanelCloseTabPayload { + tabId: number; +} + +/** + * Response from QUICK_PANEL_TAB_CLOSE message handler. + */ +export type QuickPanelCloseTabResponse = { success: true } | { success: false; error: string }; + +/** + * Message structure for closing a tab. + */ +export interface QuickPanelCloseTabMessage { + type: typeof BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_CLOSE; + payload: QuickPanelCloseTabPayload; +} diff --git a/app/chrome-extension/common/node-types.ts b/app/chrome-extension/common/node-types.ts new file mode 100644 index 00000000..38c828c9 --- /dev/null +++ b/app/chrome-extension/common/node-types.ts @@ -0,0 +1,14 @@ +// node-types.ts — centralized node type constants for Builder/UI layer +// Combines all executable Step types with UI-only nodes (e.g., trigger, delay) + +import { STEP_TYPES } from './step-types'; + +export const NODE_TYPES = { + // Executable step types (spread from STEP_TYPES) + ...STEP_TYPES, + // UI-only nodes + TRIGGER: 'trigger', + DELAY: 'delay', +} as const; + +export type NodeTypeConst = (typeof NODE_TYPES)[keyof typeof NODE_TYPES]; diff --git a/app/chrome-extension/common/rr-v3-keepalive-protocol.ts b/app/chrome-extension/common/rr-v3-keepalive-protocol.ts new file mode 100644 index 00000000..cf33f7d8 --- /dev/null +++ b/app/chrome-extension/common/rr-v3-keepalive-protocol.ts @@ -0,0 +1,26 @@ +/** + * @fileoverview RR V3 Keepalive Protocol Constants + * @description Shared protocol constants for Background-Offscreen keepalive communication + */ + +/** Keepalive Port 名称 */ +export const RR_V3_KEEPALIVE_PORT_NAME = 'rr_v3_keepalive' as const; + +/** Keepalive 消息类型 */ +export type KeepaliveMessageType = + | 'keepalive.ping' + | 'keepalive.pong' + | 'keepalive.start' + | 'keepalive.stop'; + +/** Keepalive 消息 */ +export interface KeepaliveMessage { + type: KeepaliveMessageType; + timestamp: number; +} + +/** 默认心跳间隔（毫秒） - Offscreen 每隔这个间隔发送 ping */ +export const DEFAULT_KEEPALIVE_PING_INTERVAL_MS = 20_000; + +/** 最大心跳间隔（毫秒）- Chrome MV3 SW 约 30s 空闲后终止 */ +export const MAX_KEEPALIVE_PING_INTERVAL_MS = 25_000; diff --git a/app/chrome-extension/common/step-types.ts b/app/chrome-extension/common/step-types.ts new file mode 100644 index 00000000..16d56800 --- /dev/null +++ b/app/chrome-extension/common/step-types.ts @@ -0,0 +1,4 @@ +// step-types.ts — re-export shared constants to keep single source of truth +export { STEP_TYPES } from 'chrome-mcp-shared'; +export type StepTypeConst = + (typeof import('chrome-mcp-shared'))['STEP_TYPES'][keyof (typeof import('chrome-mcp-shared'))['STEP_TYPES']]; diff --git a/app/chrome-extension/common/web-editor-types.ts b/app/chrome-extension/common/web-editor-types.ts new file mode 100644 index 00000000..815dbebf --- /dev/null +++ b/app/chrome-extension/common/web-editor-types.ts @@ -0,0 +1,539 @@ +/** + * Web Editor V2 - Shared Type Definitions + * + * This module defines types shared between: + * - Background script (injection control) + * - Inject script (web-editor-v2.ts) + * - Future: UI panels + */ + +// ============================================================================= +// Editor State +// ============================================================================= + +/** Current state of the web editor */ +export interface WebEditorState { + /** Whether the editor is currently active */ + active: boolean; + /** Editor version for compatibility checks */ + version: 2; +} + +// ============================================================================= +// Message Protocol (Background <-> Inject Script) +// ============================================================================= + +/** + * Action types for web editor V2 messages + * + * IMPORTANT: V2 uses versioned action names (suffix _v2) to avoid + * conflicts with V1 when both scripts might be injected in the same tab. + * This prevents double-response race conditions. + * + * V1 uses: web_editor_ping, web_editor_toggle, etc. + * V2 uses: web_editor_ping_v2, web_editor_toggle_v2, etc. + */ +export const WEB_EDITOR_V2_ACTIONS = { + /** Check if V2 editor is injected and get status */ + PING: 'web_editor_ping_v2', + /** Toggle V2 editor on/off */ + TOGGLE: 'web_editor_toggle_v2', + /** Start V2 editor */ + START: 'web_editor_start_v2', + /** Stop V2 editor */ + STOP: 'web_editor_stop_v2', + /** Highlight an element (from sidepanel hover) */ + HIGHLIGHT_ELEMENT: 'web_editor_highlight_element_v2', + /** Revert an element to its original state (Phase 2 - Selective Undo) */ + REVERT_ELEMENT: 'web_editor_revert_element_v2', + /** Clear selection (from sidepanel after send) */ + CLEAR_SELECTION: 'web_editor_clear_selection_v2', +} as const; + +/** + * Legacy V1 action types (for reference and background compatibility) + * These are used when USE_WEB_EDITOR_V2 is false + */ +export const WEB_EDITOR_V1_ACTIONS = { + PING: 'web_editor_ping', + TOGGLE: 'web_editor_toggle', + START: 'web_editor_start', + STOP: 'web_editor_stop', + APPLY: 'web_editor_apply', +} as const; + +export type WebEditorV2Action = (typeof WEB_EDITOR_V2_ACTIONS)[keyof typeof WEB_EDITOR_V2_ACTIONS]; +export type WebEditorV1Action = (typeof WEB_EDITOR_V1_ACTIONS)[keyof typeof WEB_EDITOR_V1_ACTIONS]; + +/** Editor version literal type */ +export type WebEditorVersion = 1 | 2; + +/** Ping request (V2) */ +export interface WebEditorV2PingRequest { + action: typeof WEB_EDITOR_V2_ACTIONS.PING; +} + +/** Ping response (V2) */ +export interface WebEditorV2PingResponse { + status: 'pong'; + active: boolean; + version: 2; +} + +/** Toggle request (V2) */ +export interface WebEditorV2ToggleRequest { + action: typeof WEB_EDITOR_V2_ACTIONS.TOGGLE; +} + +/** Toggle response (V2) */ +export interface WebEditorV2ToggleResponse { + active: boolean; +} + +/** Start request (V2) */ +export interface WebEditorV2StartRequest { + action: typeof WEB_EDITOR_V2_ACTIONS.START; +} + +/** Start response (V2) */ +export interface WebEditorV2StartResponse { + active: boolean; +} + +/** Stop request (V2) */ +export interface WebEditorV2StopRequest { + action: typeof WEB_EDITOR_V2_ACTIONS.STOP; +} + +/** Stop response (V2) */ +export interface WebEditorV2StopResponse { + active: boolean; +} + +/** Union types for V2 type-safe message handling */ +export type WebEditorV2Request = + | WebEditorV2PingRequest + | WebEditorV2ToggleRequest + | WebEditorV2StartRequest + | WebEditorV2StopRequest; + +export type WebEditorV2Response = + | WebEditorV2PingResponse + | WebEditorV2ToggleResponse + | WebEditorV2StartResponse + | WebEditorV2StopResponse; + +// ============================================================================= +// Element Locator (Phase 1 - Basic Structure) +// ============================================================================= + +/** + * Framework debug source information + * Extracted from React Fiber or Vue component instance + */ +export interface DebugSource { + /** Source file path */ + file: string; + /** Line number (1-based) */ + line?: number; + /** Column number (1-based) */ + column?: number; + /** Component name (if available) */ + componentName?: string; +} + +/** + * Element Locator - Primary key for element identification + * + * Uses multiple strategies to locate elements, supporting: + * - HMR/DOM changes recovery + * - Cross-session persistence + * - Framework-agnostic identification + */ +export interface ElementLocator { + /** CSS selector candidates (ordered by specificity) */ + selectors: string[]; + /** Structural fingerprint for similarity matching */ + fingerprint: string; + /** Framework debug information (React/Vue) */ + debugSource?: DebugSource; + /** DOM tree path (child indices from root) */ + path: number[]; + /** iframe selector chain (from top to target frame) - Phase 4 */ + frameChain?: string[]; + /** Shadow DOM host selector chain - Phase 2 */ + shadowHostChain?: string[]; +} + +// ============================================================================= +// Transaction System (Phase 1 - Basic Structure, Low Priority) +// ============================================================================= + +/** Transaction operation types */ +export type TransactionType = 'style' | 'text' | 'class' | 'move' | 'structure'; + +/** + * Transaction snapshot for undo/redo + * Captures element state before/after changes + */ +export interface TransactionSnapshot { + /** Element locator for re-identification */ + locator: ElementLocator; + /** innerHTML snapshot (for structure changes) */ + html?: string; + /** Changed style properties */ + styles?: Record; + /** Class list tokens (from `class` attribute) */ + classes?: string[]; + /** Text content */ + text?: string; +} + +/** + * Move position data + * Captures a concrete insertion point under a parent element + */ +export interface MoveOperationData { + /** Target parent element locator */ + parentLocator: ElementLocator; + /** Insert position index (among element children) */ + insertIndex: number; + /** Anchor sibling element locator (for stable positioning) */ + anchorLocator?: ElementLocator; + /** Position relative to anchor */ + anchorPosition: 'before' | 'after'; +} + +/** + * Move transaction data + * Captures both source and destination for undo/redo + */ +export interface MoveTransactionData { + /** Original location before move */ + from: MoveOperationData; + /** Target location after move */ + to: MoveOperationData; +} + +/** + * Structure operation data + * For wrap/unwrap/delete/duplicate operations (Phase 5.5) + */ +export interface StructureOperationData { + /** Structure action type */ + action: 'wrap' | 'unwrap' | 'delete' | 'duplicate'; + /** Wrapper tag for wrap/unwrap actions */ + wrapperTag?: string; + /** Wrapper inline styles for wrap/unwrap actions */ + wrapperStyles?: Record; + /** + * Deterministic insertion position for undo/redo. + * Required for delete (restore) and duplicate (re-create). + */ + position?: MoveOperationData; + /** + * Serialized element HTML for undo/redo. + * Must be a single-root element outerHTML string. + * Used by delete (restore original) and duplicate (re-create clone). + */ + html?: string; +} + +/** + * Transaction record for undo/redo system + */ +export interface Transaction { + /** Unique transaction ID */ + id: string; + /** Operation type */ + type: TransactionType; + /** Target element locator */ + targetLocator: ElementLocator; + /** + * Stable element identifier for cross-transaction grouping. + * Used by AgentChat integration for element chips aggregation. + * Optional for backward compatibility with existing transactions. + */ + elementKey?: string; + /** State before change */ + before: TransactionSnapshot; + /** State after change */ + after: TransactionSnapshot; + /** Move-specific data */ + moveData?: MoveTransactionData; + /** Structure-specific data */ + structureData?: StructureOperationData; + /** Timestamp */ + timestamp: number; + /** Whether merged with previous transaction */ + merged: boolean; +} + +// ============================================================================= +// AgentChat Integration Types (Phase 1.1) +// ============================================================================= + +/** Stable element identifier for aggregating transactions across UI contexts */ +export type WebEditorElementKey = string; + +/** + * Net effect payload for a single element aggregated from the undo stack. + * Designed to be directly consumable by prompt builders. + */ +export interface NetEffectPayload { + /** Stable element key */ + elementKey: WebEditorElementKey; + /** Locator snapshot for element re-identification */ + locator: ElementLocator; + /** + * Aggregated style changes (first before -> last after). + * Contains ONLY the affected properties, not a full style snapshot. + * Empty string value means the property was removed/unset. + */ + styleChanges?: { + before: Record; + after: Record; + }; + /** Aggregated text change (first before -> last after) */ + textChange?: { + before: string; + after: string; + }; + /** Aggregated class changes (first before -> last after) */ + classChanges?: { + before: string[]; + after: string[]; + }; +} + +/** High-level change category for UI display */ +export type ElementChangeType = 'style' | 'text' | 'class' | 'mixed'; + +/** + * Element change summary for Chips rendering in AgentChat. + * Aggregates multiple transactions for the same element. + */ +export interface ElementChangeSummary { + /** Stable element identifier */ + elementKey: WebEditorElementKey; + /** Short label for Chips display (e.g., "button#submit") */ + label: string; + /** Full label for tooltips with more context */ + fullLabel: string; + /** Locator snapshot for highlighting and element recovery */ + locator: ElementLocator; + /** High-level change category */ + type: ElementChangeType; + /** Detailed change statistics for UI tooltips */ + changes: { + style?: { + /** Number of new style properties added */ + added: number; + /** Number of style properties removed */ + removed: number; + /** Number of style properties modified */ + modified: number; + /** List of affected style property names */ + details: string[]; + }; + text?: { + /** Truncated preview of original text */ + beforePreview: string; + /** Truncated preview of new text */ + afterPreview: string; + }; + class?: { + /** Classes added */ + added: string[]; + /** Classes removed */ + removed: string[]; + }; + }; + /** Contributing transaction IDs in chronological order */ + transactionIds: string[]; + /** Net effect payload for batch Apply */ + netEffect: NetEffectPayload; + /** Timestamp of the most recent transaction */ + updatedAt: number; + /** Debug source information if available */ + debugSource?: DebugSource; +} + +/** Action types for TX change events */ +export type WebEditorTxChangeAction = 'push' | 'merge' | 'undo' | 'redo' | 'clear' | 'rollback'; + +/** + * TX change broadcast payload sent to Sidepanel/AgentChat. + * Emitted when the undo stack changes (push, undo, redo, clear). + */ +export interface WebEditorTxChangedPayload { + /** Source tab ID for multi-tab isolation */ + tabId: number; + /** Action that triggered this change (for UI animations/incremental updates) */ + action: WebEditorTxChangeAction; + /** Aggregated element-level summaries from the current undo stack */ + elements: ElementChangeSummary[]; + /** Current undo stack size */ + undoCount: number; + /** Current redo stack size */ + redoCount: number; + /** Whether there are applicable changes (style/text/class) */ + hasApplicableChanges: boolean; + /** Page URL for context */ + pageUrl?: string; +} + +/** + * Batch Apply payload sent from web-editor to background. + */ +export interface WebEditorApplyBatchPayload { + /** Source tab ID */ + tabId: number; + /** Element changes to apply */ + elements: ElementChangeSummary[]; + /** Element keys excluded by user */ + excludedKeys: WebEditorElementKey[]; + /** Page URL for context */ + pageUrl?: string; +} + +/** + * Highlight element request sent from AgentChat to the active tab. + */ +export interface WebEditorHighlightElementPayload { + /** Target tab ID */ + tabId: number; + /** Element key to highlight */ + elementKey: WebEditorElementKey; + /** Locator for element identification */ + locator: ElementLocator; + /** Highlight mode: 'hover' to show, 'clear' to hide */ + mode: 'hover' | 'clear'; +} + +/** + * Revert element request sent from AgentChat to the active tab. + * Used for Phase 2 - Selective Undo (reverting individual element changes). + */ +export interface WebEditorRevertElementPayload { + /** Target tab ID */ + tabId: number; + /** Element key to revert */ + elementKey: WebEditorElementKey; +} + +/** + * Revert element response from content script. + */ +export interface WebEditorRevertElementResponse { + /** Whether the revert was successful */ + success: boolean; + /** What was reverted (for UI feedback) */ + reverted?: { + style?: boolean; + text?: boolean; + class?: boolean; + }; + /** Error message if revert failed */ + error?: string; +} + +// ============================================================================= +// Selection Sync Types +// ============================================================================= + +/** + * Summary of currently selected element. + * Lightweight payload for selection sync (no transaction data). + */ +export interface SelectedElementSummary { + /** Stable element identifier */ + elementKey: WebEditorElementKey; + /** Locator for element identification and highlighting */ + locator: ElementLocator; + /** Short display label (e.g., "div#app") */ + label: string; + /** Full label with context (e.g., "body > div#app") */ + fullLabel: string; + /** Tag name of the element */ + tagName: string; + /** Timestamp for deduplication */ + updatedAt: number; +} + +/** + * Selection change broadcast payload. + * Sent immediately when user selects/deselects elements (no debounce). + */ +export interface WebEditorSelectionChangedPayload { + /** Source tab ID (filled by background from sender.tab.id) */ + tabId: number; + /** Currently selected element, or null if deselected */ + selected: SelectedElementSummary | null; + /** Page URL for context */ + pageUrl?: string; +} + +// ============================================================================= +// Execution Cancel Types +// ============================================================================= + +/** + * Payload for canceling an ongoing Apply execution. + * Sent from web-editor toolbar or sidepanel to background. + */ +export interface WebEditorCancelExecutionPayload { + /** Session ID of the execution to cancel */ + sessionId: string; + /** Request ID of the execution to cancel */ + requestId: string; +} + +/** + * Response from cancel execution request. + */ +export interface WebEditorCancelExecutionResponse { + /** Whether the cancel request was successful */ + success: boolean; + /** Error message if cancellation failed */ + error?: string; +} + +// ============================================================================= +// Public API Interface +// ============================================================================= + +/** + * Web Editor V2 Public API + * Exposed on window.__MCP_WEB_EDITOR_V2__ + */ +export interface WebEditorV2Api { + /** Start the editor */ + start: () => void; + /** Stop the editor */ + stop: () => void; + /** Toggle editor on/off, returns new state */ + toggle: () => boolean; + /** Get current state */ + getState: () => WebEditorState; + /** + * Revert a specific element to its original state (Phase 2 - Selective Undo). + * Creates a compensating transaction that can be undone. + */ + revertElement: (elementKey: WebEditorElementKey) => Promise; + /** + * Clear current selection (called from sidepanel after send). + * Triggers deselect and broadcasts null selection. + */ + clearSelection: () => void; +} + +// ============================================================================= +// Global Declaration +// ============================================================================= + +declare global { + interface Window { + __MCP_WEB_EDITOR_V2__?: WebEditorV2Api; + } +} diff --git a/app/chrome-extension/entrypoints/background/element-marker/element-marker-storage.ts b/app/chrome-extension/entrypoints/background/element-marker/element-marker-storage.ts new file mode 100644 index 00000000..7a90956e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/element-marker/element-marker-storage.ts @@ -0,0 +1,95 @@ +// IndexedDB storage for element markers (URL -> marked selectors) +// Uses the shared IndexedDbClient for robust transaction handling. + +import { IndexedDbClient } from '@/utils/indexeddb-client'; +import type { ElementMarker, UpsertMarkerRequest } from '@/common/element-marker-types'; + +const DB_NAME = 'element_marker_storage'; +const DB_VERSION = 1; +const STORE = 'markers'; + +const idb = new IndexedDbClient(DB_NAME, DB_VERSION, (db, oldVersion) => { + switch (oldVersion) { + case 0: { + const store = db.createObjectStore(STORE, { keyPath: 'id' }); + // Useful indexes for lookups + store.createIndex('by_host', 'host', { unique: false }); + store.createIndex('by_origin', 'origin', { unique: false }); + store.createIndex('by_path', 'path', { unique: false }); + } + } +}); + +function normalizeUrl(raw: string): { url: string; origin: string; host: string; path: string } { + try { + const u = new URL(raw); + return { url: raw, origin: u.origin, host: u.hostname, path: u.pathname }; + } catch { + return { url: raw, origin: '', host: '', path: '' }; + } +} + +function now(): number { + return Date.now(); +} + +export async function listAllMarkers(): Promise { + return idb.getAll(STORE); +} + +export async function listMarkersForUrl(url: string): Promise { + const { origin, path, host } = normalizeUrl(url); + const all = await idb.getAll(STORE); + // Simple matching policy: + // - exact: origin + path must match exactly + // - prefix: origin matches and marker.path is a prefix of current path + // - host: host matches regardless of path + return all.filter((m) => { + if (!m) return false; + if (m.matchType === 'exact') return m.origin === origin && m.path === path; + if (m.matchType === 'host') return !!m.host && m.host === host; + // default 'prefix' + return m.origin === origin && (m.path ? path.startsWith(m.path) : true); + }); +} + +export async function saveMarker(req: UpsertMarkerRequest): Promise { + const { url: rawUrl, selector } = req; + if (!rawUrl || !selector) throw new Error('url and selector are required'); + const { url, origin, host, path } = normalizeUrl(rawUrl); + const ts = now(); + const marker: ElementMarker = { + id: req.id || (globalThis.crypto?.randomUUID?.() ?? `${ts}_${Math.random()}`), + url, + origin, + host, + path, + matchType: req.matchType || 'prefix', + name: req.name || selector, + selector, + selectorType: req.selectorType || 'css', + listMode: req.listMode || false, + action: req.action || 'custom', + createdAt: ts, + updatedAt: ts, + }; + await idb.put(STORE, marker); + return marker; +} + +export async function updateMarker(marker: ElementMarker): Promise { + const existing = await idb.get(STORE, marker.id); + if (!existing) throw new Error('marker not found'); + + // Preserve createdAt from existing record, only update updatedAt + const updated: ElementMarker = { + ...marker, + createdAt: existing.createdAt, // Never overwrite createdAt + updatedAt: now(), + }; + await idb.put(STORE, updated); +} + +export async function deleteMarker(id: string): Promise { + await idb.delete(STORE, id); +} diff --git a/app/chrome-extension/entrypoints/background/element-marker/index.ts b/app/chrome-extension/entrypoints/background/element-marker/index.ts new file mode 100644 index 00000000..01d4a1b1 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/element-marker/index.ts @@ -0,0 +1,409 @@ +import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; +import type { + UpsertMarkerRequest, + ElementMarker, + MarkerValidationRequest, + MarkerValidationAction, +} from '@/common/element-marker-types'; +import { + deleteMarker, + listAllMarkers, + listMarkersForUrl, + saveMarker, + updateMarker, +} from './element-marker-storage'; +import { computerTool } from '@/entrypoints/background/tools/browser/computer'; +import { clickTool } from '@/entrypoints/background/tools/browser/interaction'; +import { keyboardTool } from '@/entrypoints/background/tools/browser/keyboard'; + +const CONTEXT_MENU_ID = 'element_marker_mark'; + +/** + * Extract error message from MCP tool result + */ +function extractToolError(result: any): string | undefined { + if (!result) return undefined; + + // Check for error in result content array + if (Array.isArray(result.content)) { + for (const item of result.content) { + if (item?.text) { + try { + const parsed = JSON.parse(item.text); + if (parsed?.error) return parsed.error; + if (parsed?.message) return parsed.message; + } catch { + // Not JSON, use as-is + return item.text; + } + } + } + } + + // Fallback to direct error field + return result.error || (result.isError ? 'unknown tool error' : undefined); +} + +async function ensureContextMenu() { + try { + // Guard: contextMenus permission may be missing + if (!(chrome as any).contextMenus?.create) return; + // Remove and re-create our single menu to avoid duplication + try { + await chrome.contextMenus.remove(CONTEXT_MENU_ID); + } catch {} + await chrome.contextMenus.create({ + id: CONTEXT_MENU_ID, + title: '标注元素', + contexts: ['all'], + }); + } catch (e) { + console.warn('ElementMarker: ensureContextMenu failed:', e); + } +} + +/** + * Check if element-marker.js is already injected in the tab + * Uses a short timeout to avoid hanging on unresponsive tabs + */ +async function isMarkerInjected(tabId: number): Promise { + try { + const response = await Promise.race([ + chrome.tabs.sendMessage(tabId, { action: 'element_marker_ping' }), + new Promise((resolve) => setTimeout(() => resolve(null), 300)), + ]); + return response?.status === 'pong'; + } catch { + return false; + } +} + +/** + * Inject element-marker.js into the tab if not already injected + */ +async function injectMarkerHelper(tabId: number) { + // Check if already injected via ping + const alreadyInjected = await isMarkerInjected(tabId); + + if (!alreadyInjected) { + try { + await chrome.scripting.executeScript({ + target: { tabId, allFrames: true }, + files: ['inject-scripts/element-marker.js'], + world: 'ISOLATED', + } as any); + } catch (e) { + // Script injection may fail on some pages (e.g., chrome:// URLs) + console.warn('ElementMarker: script injection failed:', e); + } + } + + try { + await chrome.tabs.sendMessage(tabId, { action: 'element_marker_start' } as any); + } catch (e) { + console.warn('ElementMarker: start overlay failed:', e); + } +} + +export function initElementMarkerListeners() { + // Ensure context menu on startup + ensureContextMenu().catch(() => {}); + + // Respond to RR triggers refresh by re-ensuring our menu a bit later + chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => { + try { + switch (message?.type) { + // Handle element marker start from popup + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_START: { + const tabId = message.tabId; + if (typeof tabId !== 'number') { + sendResponse({ success: false, error: 'invalid tabId' }); + return true; + } + injectMarkerHelper(tabId) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_LIST_ALL: { + listAllMarkers() + .then((markers) => sendResponse({ success: true, markers })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_LIST_FOR_URL: { + const url = String(message.url || ''); + listMarkersForUrl(url) + .then((markers) => sendResponse({ success: true, markers })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_SAVE: { + const req = message.marker as UpsertMarkerRequest; + saveMarker(req) + .then((marker) => sendResponse({ success: true, marker })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_UPDATE: { + const marker = message.marker as ElementMarker; + updateMarker(marker) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_DELETE: { + const id = String(message.id || ''); + if (!id) { + sendResponse({ success: false, error: 'invalid id' }); + return true; + } + deleteMarker(id) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.ELEMENT_MARKER_VALIDATE: { + // Validate via MCP tool chain + (async () => { + const req = message as { + selector: string; + selectorType?: 'css' | 'xpath'; + action: MarkerValidationAction; + listMode?: boolean; + text?: string; + keys?: string; + button?: 'left' | 'right' | 'middle'; + bubbles?: boolean; + cancelable?: boolean; + modifiers?: any; + coordinates?: { x: number; y: number }; + offsetX?: number; + offsetY?: number; + relativeTo?: 'element' | 'viewport'; + }; + // enrich typing with optional nav + scroll params + (req as any).waitForNavigation = (message as any).waitForNavigation; + (req as any).timeoutMs = (message as any).timeoutMs; + (req as any).scrollDirection = (message as any).scrollDirection; + (req as any).scrollAmount = (message as any).scrollAmount; + const selector = String(req.selector || '').trim(); + const selectorType = (req.selectorType || 'css') as 'css' | 'xpath'; + const action = req.action as MarkerValidationAction; + if (!selector) return sendResponse({ success: false, error: 'selector is required' }); + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tab = tabs[0]; + if (!tab?.id) return sendResponse({ success: false, error: 'active tab not found' }); + + // 1) Ensure helper + try { + await chrome.scripting.executeScript({ + target: { tabId: tab.id, allFrames: true }, + files: ['inject-scripts/accessibility-tree-helper.js'], + world: 'ISOLATED', + } as any); + } catch {} + + // 2) Resolve selector -> ref/center via helper (same as tools) + let ensured: any; + try { + ensured = await chrome.tabs.sendMessage(tab.id, { + action: 'ensureRefForSelector', + selector, + isXPath: selectorType === 'xpath', + allowMultiple: !!req.listMode, + } as any); + } catch (e) { + return sendResponse({ + success: false, + error: String(e instanceof Error ? e.message : e), + }); + } + if (!ensured || !ensured.success || !ensured.ref) { + return sendResponse({ + success: false, + error: ensured?.error || 'failed to resolve selector', + }); + } + + const base = { + success: true, + resolved: true, + ref: ensured.ref, + center: ensured.center, + } as any; + + // Compute optional coordinates from offsets + let coords: { x: number; y: number } | undefined = undefined; + if ( + req.coordinates && + typeof req.coordinates.x === 'number' && + typeof req.coordinates.y === 'number' + ) { + coords = { x: Math.round(req.coordinates.x), y: Math.round(req.coordinates.y) }; + } else if ( + req.relativeTo === 'element' && + ensured.center && + (typeof req.offsetX === 'number' || typeof req.offsetY === 'number') + ) { + const dx = Number.isFinite(req.offsetX as any) ? (req.offsetX as number) : 0; + const dy = Number.isFinite(req.offsetY as any) ? (req.offsetY as number) : 0; + coords = { x: ensured.center.x + dx, y: ensured.center.y + dy }; + } + + // 3) Dispatch to appropriate tool for end-to-end validation + try { + switch (action) { + case 'hover': { + const r = await computerTool.execute( + coords + ? { action: 'hover', coordinates: coords } + : ({ action: 'hover', ref: ensured.ref } as any), + ); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'computer.hover', ok: !r.isError, error }; + break; + } + case 'left_click': { + const r = await clickTool.execute({ + ...(coords ? { coordinates: coords } : { ref: ensured.ref }), + waitForNavigation: !!req.waitForNavigation, + timeout: Number.isFinite(req.timeoutMs as any) + ? (req.timeoutMs as number) + : 3000, + button: (req.button || 'left') as any, + modifiers: req.modifiers || {}, + } as any); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'interaction.click', ok: !r.isError, error }; + break; + } + case 'double_click': { + const r = await clickTool.execute({ + ...(coords ? { coordinates: coords } : { ref: ensured.ref }), + double: true, + waitForNavigation: !!req.waitForNavigation, + timeout: Number.isFinite(req.timeoutMs as any) + ? (req.timeoutMs as number) + : 3000, + button: (req.button || 'left') as any, + modifiers: req.modifiers || {}, + } as any); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'interaction.click(double)', ok: !r.isError, error }; + break; + } + case 'right_click': { + const r = await clickTool.execute({ + ...(coords ? { coordinates: coords } : { ref: ensured.ref }), + waitForNavigation: !!req.waitForNavigation, + timeout: Number.isFinite(req.timeoutMs as any) + ? (req.timeoutMs as number) + : 3000, + button: 'right', + modifiers: req.modifiers || {}, + } as any); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'interaction.click(right)', ok: !r.isError, error }; + break; + } + case 'scroll': { + const direction = (req as any).scrollDirection || 'down'; + const amount = Number.isFinite((req as any).scrollAmount) + ? Number((req as any).scrollAmount) + : 300; + const payload = coords + ? { + action: 'scroll', + scrollDirection: direction, + scrollAmount: amount, + coordinates: coords, + } + : ({ + action: 'scroll', + scrollDirection: direction, + scrollAmount: amount, + ref: ensured.ref, + } as any); + const r = await computerTool.execute(payload as any); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'computer.scroll', ok: !r.isError, error }; + break; + } + case 'type_text': { + const text = String(req.text || ''); + const r = await computerTool.execute({ action: 'type', ref: ensured.ref, text }); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'computer.type', ok: !r.isError, error }; + break; + } + case 'press_keys': { + const keys = String(req.keys || ''); + // Focus first by ref to ensure key target + try { + await clickTool.execute({ + ref: ensured.ref, + waitForNavigation: false, + timeout: 2000, + }); + } catch {} + const r = await keyboardTool.execute({ keys, delay: 0 } as any); + const error = r.isError ? extractToolError(r) : undefined; + base.tool = { name: 'keyboard.simulate', ok: !r.isError, error }; + break; + } + default: { + base.tool = { name: 'noop', ok: true }; + } + } + } catch (e) { + console.warn('[ElementMarker] Validation failed before tool execution', e); + base.tool = { + name: 'unknown', + ok: false, + error: String(e instanceof Error ? e.message : e), + }; + } + + // Log tool failures for debugging + if (base.tool && base.tool.ok === false) { + console.warn('[ElementMarker] Tool validation failure', { + action, + toolName: base.tool.name, + error: base.tool.error, + selector, + selectorType, + }); + } + + return sendResponse(base); + })(); + return true; + } + // When RR refresh (or similar) happens, re-add our menu + case BACKGROUND_MESSAGE_TYPES.RR_REFRESH_TRIGGERS: + case BACKGROUND_MESSAGE_TYPES.RR_SAVE_TRIGGER: + case BACKGROUND_MESSAGE_TYPES.RR_DELETE_TRIGGER: { + setTimeout(() => ensureContextMenu().catch(() => {}), 300); + break; + } + } + } catch (e) { + sendResponse({ success: false, error: (e as any)?.message || String(e) }); + } + return false; + }); + + // Context menu click routing + if ((chrome as any).contextMenus?.onClicked?.addListener) { + chrome.contextMenus.onClicked.addListener(async (info, tab) => { + try { + if (info.menuItemId === CONTEXT_MENU_ID && tab?.id) { + await injectMarkerHelper(tab.id); + } + } catch (e) { + console.warn('ElementMarker: context menu click failed:', e); + } + }); + } +} diff --git a/app/chrome-extension/entrypoints/background/index.ts b/app/chrome-extension/entrypoints/background/index.ts index ee592910..fcac7e3b 100644 --- a/app/chrome-extension/entrypoints/background/index.ts +++ b/app/chrome-extension/entrypoints/background/index.ts @@ -5,16 +5,65 @@ import { } from './semantic-similarity'; import { initStorageManagerListener } from './storage-manager'; import { cleanupModelCache } from '@/utils/semantic-similarity-engine'; +import { initRecordReplayListeners } from './record-replay'; +import { initElementMarkerListeners } from './element-marker'; +import { initWebEditorListeners } from './web-editor'; +import { initQuickPanelAgentHandler } from './quick-panel/agent-handler'; +import { initQuickPanelCommands } from './quick-panel/commands'; +import { initQuickPanelTabsHandler } from './quick-panel/tabs-handler'; + +// Record-Replay V3 (feature flag) +import { bootstrapV3 } from './record-replay-v3/bootstrap'; + +/** + * Feature flag for RR-V3 + * Set to true to enable the new Record-Replay V3 engine + */ +const ENABLE_RR_V3 = true; /** * Background script entry point * Initializes all background services and listeners */ export default defineBackground(() => { + // Open welcome page on first install + chrome.runtime.onInstalled.addListener((details) => { + if (details.reason === 'install') { + // Open the welcome/onboarding page for new installations + chrome.tabs.create({ + url: chrome.runtime.getURL('/welcome.html'), + }); + } + }); + // Initialize core services initNativeHostListener(); initSemanticSimilarityListener(); initStorageManagerListener(); + // Record & Replay V1/V2 listeners + initRecordReplayListeners(); + + // Record & Replay V3 (new engine) + if (ENABLE_RR_V3) { + bootstrapV3() + .then((runtime) => { + console.log(`[RR-V3] Bootstrap complete, ownerId: ${runtime.ownerId}`); + }) + .catch((error) => { + console.error('[RR-V3] Bootstrap failed:', error); + }); + } + + // Element marker: context menu + CRUD listeners + initElementMarkerListeners(); + // Web editor: toggle edit-mode overlay + initWebEditorListeners(); + // Quick Panel: send messages to AgentChat via background-stream bridge + initQuickPanelAgentHandler(); + // Quick Panel: tabs search bridge for content script UI + initQuickPanelTabsHandler(); + // Quick Panel: keyboard shortcut handler + initQuickPanelCommands(); // Conditionally initialize semantic similarity engine if model cache exists initializeSemanticEngineIfCached() diff --git a/app/chrome-extension/entrypoints/background/keepalive-manager.ts b/app/chrome-extension/entrypoints/background/keepalive-manager.ts new file mode 100644 index 00000000..ca1c20f7 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/keepalive-manager.ts @@ -0,0 +1,87 @@ +/** + * @fileoverview Keepalive Manager + * @description Global singleton service for managing Service Worker keepalive. + * + * This module provides a unified interface for acquiring and releasing keepalive + * references. Multiple modules can acquire keepalive independently using tags, + * and the underlying keepalive mechanism will remain active as long as at least + * one reference is held. + */ + +import { + createOffscreenKeepaliveController, + type KeepaliveController, +} from './record-replay-v3/engine/keepalive/offscreen-keepalive'; + +const LOG_PREFIX = '[KeepaliveManager]'; + +/** + * Singleton keepalive controller instance. + * Created lazily to avoid initialization issues during module loading. + */ +let controller: KeepaliveController | null = null; + +/** + * Get or create the singleton keepalive controller. + */ +function getController(): KeepaliveController { + if (!controller) { + controller = createOffscreenKeepaliveController({ logger: console }); + console.debug(`${LOG_PREFIX} Controller initialized`); + } + return controller; +} + +/** + * Acquire a keepalive reference with a tag. + * + * @param tag - Identifier for the reference (e.g., 'native-host', 'rr-engine') + * @returns A release function to call when keepalive is no longer needed + * + * @example + * ```typescript + * const release = acquireKeepalive('native-host'); + * // ... do work that needs SW to stay alive ... + * release(); // Release when done + * ``` + */ +export function acquireKeepalive(tag: string): () => void { + try { + const release = getController().acquire(tag); + console.debug(`${LOG_PREFIX} Acquired keepalive for tag: ${tag}`); + return () => { + try { + release(); + console.debug(`${LOG_PREFIX} Released keepalive for tag: ${tag}`); + } catch (error) { + console.warn(`${LOG_PREFIX} Failed to release keepalive for ${tag}:`, error); + } + }; + } catch (error) { + console.warn(`${LOG_PREFIX} Failed to acquire keepalive for ${tag}:`, error); + return () => {}; + } +} + +/** + * Check if keepalive is currently active (any references held). + */ +export function isKeepaliveActive(): boolean { + try { + return getController().isActive(); + } catch { + return false; + } +} + +/** + * Get the current keepalive reference count. + * Useful for debugging. + */ +export function getKeepaliveRefCount(): number { + try { + return getController().getRefCount(); + } catch { + return 0; + } +} diff --git a/app/chrome-extension/entrypoints/background/native-host.ts b/app/chrome-extension/entrypoints/background/native-host.ts index 72a9df39..6cc79e18 100644 --- a/app/chrome-extension/entrypoints/background/native-host.ts +++ b/app/chrome-extension/entrypoints/background/native-host.ts @@ -1,18 +1,32 @@ import { NativeMessageType } from 'chrome-mcp-shared'; import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; -import { - NATIVE_HOST, - ICONS, - NOTIFICATIONS, - STORAGE_KEYS, - ERROR_MESSAGES, - SUCCESS_MESSAGES, -} from '@/common/constants'; +import { NATIVE_HOST, STORAGE_KEYS, ERROR_MESSAGES, SUCCESS_MESSAGES } from '@/common/constants'; import { handleCallTool } from './tools'; +import { listPublished, getFlow } from './record-replay/flow-store'; +import { acquireKeepalive } from './keepalive-manager'; + +const LOG_PREFIX = '[NativeHost]'; let nativePort: chrome.runtime.Port | null = null; export const HOST_NAME = NATIVE_HOST.NAME; +// ==================== Reconnect Configuration ==================== + +const RECONNECT_BASE_DELAY_MS = 500; +const RECONNECT_MAX_DELAY_MS = 60_000; +const RECONNECT_MAX_FAST_ATTEMPTS = 8; +const RECONNECT_COOLDOWN_DELAY_MS = 5 * 60_000; + +// ==================== Auto-connect State ==================== + +let keepaliveRelease: (() => void) | null = null; +let autoConnectEnabled = true; +let autoConnectLoaded = false; +let ensurePromise: Promise | null = null; +let reconnectTimer: ReturnType | null = null; +let reconnectAttempts = 0; +let manualDisconnect = false; + /** * Server status management interface */ @@ -70,26 +84,266 @@ function broadcastServerStatusChange(status: ServerStatus): void { }); } +// ==================== Port Normalization ==================== + +/** + * Normalize a port value to a valid port number or null. + */ +function normalizePort(value: unknown): number | null { + const n = + typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : Number.NaN; + if (!Number.isFinite(n)) return null; + const port = Math.floor(n); + if (port <= 0 || port > 65535) return null; + return port; +} + +// ==================== Reconnect Utilities ==================== + +/** + * Add jitter to a delay value to avoid thundering herd. + */ +function withJitter(ms: number): number { + const ratio = 0.7 + Math.random() * 0.6; + return Math.max(0, Math.round(ms * ratio)); +} + +/** + * Calculate reconnect delay based on attempt number. + * Uses exponential backoff with jitter, then switches to cooldown interval. + */ +function getReconnectDelayMs(attempt: number): number { + if (attempt >= RECONNECT_MAX_FAST_ATTEMPTS) { + return withJitter(RECONNECT_COOLDOWN_DELAY_MS); + } + const delay = Math.min(RECONNECT_BASE_DELAY_MS * Math.pow(2, attempt), RECONNECT_MAX_DELAY_MS); + return withJitter(delay); +} + +/** + * Clear the reconnect timer if active. + */ +function clearReconnectTimer(): void { + if (!reconnectTimer) return; + clearTimeout(reconnectTimer); + reconnectTimer = null; +} + +/** + * Reset reconnect state after successful connection. + */ +function resetReconnectState(): void { + reconnectAttempts = 0; + clearReconnectTimer(); +} + +// ==================== Keepalive Management ==================== + +/** + * Sync keepalive hold based on autoConnectEnabled state. + * When auto-connect is enabled, we hold a keepalive reference to keep SW alive. + */ +function syncKeepaliveHold(): void { + if (autoConnectEnabled) { + if (!keepaliveRelease) { + keepaliveRelease = acquireKeepalive('native-host'); + console.debug(`${LOG_PREFIX} Acquired keepalive`); + } + return; + } + if (keepaliveRelease) { + try { + keepaliveRelease(); + console.debug(`${LOG_PREFIX} Released keepalive`); + } catch { + // Ignore + } + keepaliveRelease = null; + } +} + +// ==================== Auto-connect Settings ==================== + +/** + * Load the nativeAutoConnectEnabled setting from storage. + */ +async function loadNativeAutoConnectEnabled(): Promise { + try { + const result = await chrome.storage.local.get([STORAGE_KEYS.NATIVE_AUTO_CONNECT_ENABLED]); + const raw = result[STORAGE_KEYS.NATIVE_AUTO_CONNECT_ENABLED]; + if (typeof raw === 'boolean') return raw; + } catch (error) { + console.warn(`${LOG_PREFIX} Failed to load nativeAutoConnectEnabled`, error); + } + return true; // Default to enabled +} + +/** + * Set the nativeAutoConnectEnabled setting and persist to storage. + */ +async function setNativeAutoConnectEnabled(enabled: boolean): Promise { + autoConnectEnabled = enabled; + autoConnectLoaded = true; + try { + await chrome.storage.local.set({ [STORAGE_KEYS.NATIVE_AUTO_CONNECT_ENABLED]: enabled }); + console.debug(`${LOG_PREFIX} Set nativeAutoConnectEnabled=${enabled}`); + } catch (error) { + console.warn(`${LOG_PREFIX} Failed to persist nativeAutoConnectEnabled`, error); + } + syncKeepaliveHold(); +} + +// ==================== Port Preference ==================== + +/** + * Get the preferred port for connecting to native server. + * Priority: explicit override > user preference > last known port > default + */ +async function getPreferredPort(override?: unknown): Promise { + const explicit = normalizePort(override); + if (explicit) return explicit; + + try { + const result = await chrome.storage.local.get([ + STORAGE_KEYS.NATIVE_SERVER_PORT, + STORAGE_KEYS.SERVER_STATUS, + ]); + + const userPort = normalizePort(result[STORAGE_KEYS.NATIVE_SERVER_PORT]); + if (userPort) return userPort; + + const status = result[STORAGE_KEYS.SERVER_STATUS] as Partial | undefined; + const statusPort = normalizePort(status?.port); + if (statusPort) return statusPort; + } catch (error) { + console.warn(`${LOG_PREFIX} Failed to read preferred port`, error); + } + + const inMemoryPort = normalizePort(currentServerStatus.port); + if (inMemoryPort) return inMemoryPort; + + return NATIVE_HOST.DEFAULT_PORT; +} + +// ==================== Reconnect Scheduling ==================== + +/** + * Schedule a reconnect attempt with exponential backoff. + */ +function scheduleReconnect(reason: string): void { + if (nativePort) return; + if (manualDisconnect) return; + if (!autoConnectEnabled) return; + if (reconnectTimer) return; + + const delay = getReconnectDelayMs(reconnectAttempts); + console.debug( + `${LOG_PREFIX} Reconnect scheduled in ${delay}ms (attempt=${reconnectAttempts}, reason=${reason})`, + ); + + reconnectTimer = setTimeout(() => { + reconnectTimer = null; + if (nativePort) return; + if (manualDisconnect || !autoConnectEnabled) return; + + reconnectAttempts += 1; + void ensureNativeConnected(`reconnect:${reason}`).catch(() => {}); + }, delay); +} + +// ==================== Server Status Update ==================== + +/** + * Mark server as stopped and broadcast the change. + */ +async function markServerStopped(reason: string): Promise { + currentServerStatus = { + isRunning: false, + port: currentServerStatus.port, + lastUpdated: Date.now(), + }; + try { + await saveServerStatus(currentServerStatus); + } catch { + // Ignore + } + broadcastServerStatusChange(currentServerStatus); + console.debug(`${LOG_PREFIX} Server marked stopped (${reason})`); +} + +// ==================== Core Ensure Function ==================== + +/** + * Ensure native connection is established. + * This is the main entry point for auto-connect logic. + * + * @param trigger - Description of what triggered this call (for logging) + * @param portOverride - Optional explicit port to use + * @returns Whether the connection is now established + */ +async function ensureNativeConnected(trigger: string, portOverride?: unknown): Promise { + // Concurrency protection: only one ensure flow at a time + if (ensurePromise) return ensurePromise; + + ensurePromise = (async () => { + // Load auto-connect setting if not yet loaded + if (!autoConnectLoaded) { + autoConnectEnabled = await loadNativeAutoConnectEnabled(); + autoConnectLoaded = true; + syncKeepaliveHold(); + } + + // If auto-connect is disabled, do nothing + if (!autoConnectEnabled) { + console.debug(`${LOG_PREFIX} Auto-connect disabled, skipping ensure (trigger=${trigger})`); + return false; + } + + // Sync keepalive hold + syncKeepaliveHold(); + + // Already connected + if (nativePort) { + console.debug(`${LOG_PREFIX} Already connected (trigger=${trigger})`); + return true; + } + + // Get the port to use + const port = await getPreferredPort(portOverride); + console.debug(`${LOG_PREFIX} Attempting connection on port ${port} (trigger=${trigger})`); + + // Attempt connection + const ok = connectNativeHost(port); + if (!ok) { + console.warn(`${LOG_PREFIX} Connection failed (trigger=${trigger})`); + scheduleReconnect(`connect_failed:${trigger}`); + return false; + } + + console.debug(`${LOG_PREFIX} Connection initiated successfully (trigger=${trigger})`); + // Note: Don't reset reconnect state here. Wait for SERVER_STARTED confirmation. + // Chrome may return a Port but disconnect immediately if native host is missing. + return true; + })().finally(() => { + ensurePromise = null; + }); + + return ensurePromise; +} + /** * Connect to the native messaging host + * @returns Whether the connection was initiated successfully */ -export function connectNativeHost(port: number = NATIVE_HOST.DEFAULT_PORT) { +export function connectNativeHost(port: number = NATIVE_HOST.DEFAULT_PORT): boolean { if (nativePort) { - return; + return true; } try { nativePort = chrome.runtime.connectNative(HOST_NAME); nativePort.onMessage.addListener(async (message) => { - // chrome.notifications.create({ - // type: NOTIFICATIONS.TYPE, - // iconUrl: chrome.runtime.getURL(ICONS.NOTIFICATION), - // title: 'Message from native host', - // message: `Received data from host: ${JSON.stringify(message)}`, - // priority: NOTIFICATIONS.PRIORITY, - // }); - if (message.type === NativeMessageType.PROCESS_DATA && message.requestId) { const requestId = message.requestId; const requestPayload = message.payload; @@ -124,6 +378,34 @@ export function connectNativeHost(port: number = NATIVE_HOST.DEFAULT_PORT) { }, }); } + } else if (message.type === 'rr_list_published_flows' && message.requestId) { + const requestId = message.requestId; + try { + const published = await listPublished(); + const items = [] as any[]; + for (const p of published) { + const flow = await getFlow(p.id); + if (!flow) continue; + items.push({ + id: p.id, + slug: p.slug, + version: p.version, + name: p.name, + description: p.description || flow.description || '', + variables: flow.variables || [], + meta: flow.meta || {}, + }); + } + nativePort?.postMessage({ + responseToRequestId: requestId, + payload: { status: 'success', items }, + }); + } catch (error: any) { + nativePort?.postMessage({ + responseToRequestId: requestId, + payload: { status: 'error', error: error?.message || String(error) }, + }); + } } else if (message.type === NativeMessageType.SERVER_STARTED) { const port = message.payload?.port; currentServerStatus = { @@ -133,6 +415,8 @@ export function connectNativeHost(port: number = NATIVE_HOST.DEFAULT_PORT) { }; await saveServerStatus(currentServerStatus); broadcastServerStatusChange(currentServerStatus); + // Server is confirmed running - now we can reset reconnect state + resetReconnectState(); console.log(`${SUCCESS_MESSAGES.SERVER_STARTED} on port ${port}`); } else if (message.type === NativeMessageType.SERVER_STOPPED) { currentServerStatus = { @@ -154,13 +438,29 @@ export function connectNativeHost(port: number = NATIVE_HOST.DEFAULT_PORT) { }); nativePort.onDisconnect.addListener(() => { - console.error(ERROR_MESSAGES.NATIVE_DISCONNECTED, chrome.runtime.lastError); + console.warn(ERROR_MESSAGES.NATIVE_DISCONNECTED, chrome.runtime.lastError); nativePort = null; + + // Mark server as stopped since native host disconnection means server is down + void markServerStopped('native_port_disconnected'); + + // Handle reconnection based on disconnect reason + if (manualDisconnect) { + manualDisconnect = false; + return; + } + if (!autoConnectEnabled) return; + scheduleReconnect('native_port_disconnected'); }); nativePort.postMessage({ type: NativeMessageType.START, payload: { port } }); + // Note: Don't reset reconnect state here. Wait for SERVER_STARTED confirmation. + // Chrome may return a Port but disconnect immediately if native host is missing. + return true; } catch (error) { - console.error(ERROR_MESSAGES.NATIVE_CONNECTION_FAILED, error); + console.warn(ERROR_MESSAGES.NATIVE_CONNECTION_FAILED, error); + nativePort = null; + return false; } } @@ -177,34 +477,108 @@ export const initNativeHostListener = () => { console.error(ERROR_MESSAGES.SERVER_STATUS_LOAD_FAILED, error); }); - chrome.runtime.onStartup.addListener(connectNativeHost); + // Auto-connect on SW activation (covers SW restart after idle termination) + void ensureNativeConnected('sw_startup').catch(() => {}); + + // Auto-connect on Chrome browser startup + chrome.runtime.onStartup.addListener(() => { + void ensureNativeConnected('onStartup').catch(() => {}); + }); + + // Auto-connect on extension install/update + chrome.runtime.onInstalled.addListener(() => { + void ensureNativeConnected('onInstalled').catch(() => {}); + }); chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => { - if ( - message === NativeMessageType.CONNECT_NATIVE || - message.type === NativeMessageType.CONNECT_NATIVE - ) { - const port = - typeof message === 'object' && message.port ? message.port : NATIVE_HOST.DEFAULT_PORT; - connectNativeHost(port); - sendResponse({ success: true, port }); + // Allow UI to call tools directly + if (message && message.type === 'call_tool' && message.name) { + handleCallTool({ name: message.name, args: message.args }) + .then((res) => sendResponse({ success: true, result: res })) + .catch((err) => + sendResponse({ success: false, error: err instanceof Error ? err.message : String(err) }), + ); + return true; + } + + const msgType = typeof message === 'string' ? message : message?.type; + + // ENSURE_NATIVE: Trigger ensure without changing autoConnectEnabled + if (msgType === NativeMessageType.ENSURE_NATIVE) { + const portOverride = typeof message === 'object' ? message.port : undefined; + ensureNativeConnected('ui_ensure', portOverride) + .then((connected) => { + sendResponse({ success: true, connected, autoConnectEnabled }); + }) + .catch((e) => { + sendResponse({ success: false, connected: nativePort !== null, error: String(e) }); + }); + return true; + } + + // CONNECT_NATIVE: Explicit user connect, re-enables auto-connect + if (msgType === NativeMessageType.CONNECT_NATIVE) { + const portOverride = typeof message === 'object' ? message.port : undefined; + const normalized = normalizePort(portOverride); + + (async () => { + // Explicit user connect: re-enable auto-connect + await setNativeAutoConnectEnabled(true); + + if (normalized) { + // Best-effort: persist preferred port + try { + await chrome.storage.local.set({ [STORAGE_KEYS.NATIVE_SERVER_PORT]: normalized }); + } catch { + // Ignore + } + } + + return ensureNativeConnected('ui_connect', normalized ?? undefined); + })() + .then((connected) => { + sendResponse({ success: true, connected }); + }) + .catch((e) => { + sendResponse({ success: false, connected: nativePort !== null, error: String(e) }); + }); return true; } - if (message.type === NativeMessageType.PING_NATIVE) { + if (msgType === NativeMessageType.PING_NATIVE) { const connected = nativePort !== null; - sendResponse({ connected }); + sendResponse({ connected, autoConnectEnabled }); return true; } - if (message.type === NativeMessageType.DISCONNECT_NATIVE) { - if (nativePort) { - nativePort.disconnect(); - nativePort = null; - sendResponse({ success: true }); - } else { - sendResponse({ success: false, error: 'No active connection' }); - } + // DISCONNECT_NATIVE: Explicit user disconnect, disables auto-connect + if (msgType === NativeMessageType.DISCONNECT_NATIVE) { + (async () => { + // Explicit user disconnect: disable auto-connect and stop reconnect loop + await setNativeAutoConnectEnabled(false); + clearReconnectTimer(); + reconnectAttempts = 0; + syncKeepaliveHold(); + + if (nativePort) { + // Only set manualDisconnect if we actually have a port to disconnect. + // This prevents the flag from persisting when there's no active connection. + manualDisconnect = true; + try { + nativePort.disconnect(); + } catch { + // Ignore + } + nativePort = null; + } + await markServerStopped('manual_disconnect'); + })() + .then(() => { + sendResponse({ success: true }); + }) + .catch((e) => { + sendResponse({ success: false, error: String(e) }); + }); return true; } diff --git a/app/chrome-extension/entrypoints/background/quick-panel/agent-handler.ts b/app/chrome-extension/entrypoints/background/quick-panel/agent-handler.ts new file mode 100644 index 00000000..c6fec7f9 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/quick-panel/agent-handler.ts @@ -0,0 +1,779 @@ +/** + * Quick Panel Agent Handler + * + * Background service that bridges Quick Panel (content script) with the native-server Agent. + * Handles message routing, SSE streaming, and lifecycle management for AI chat requests. + * + * Architecture: + * - Quick Panel sends QUICK_PANEL_SEND_TO_AI via chrome.runtime.sendMessage + * - This handler subscribes to SSE first, then fires POST /act + * - Incoming RealtimeEvents are filtered by requestId and forwarded to the originating tab + * - Keepalive is explicitly managed to prevent MV3 Service Worker suspension during streaming + * + * @see https://developer.chrome.com/docs/extensions/mv3/service_workers/ + */ + +import type { AgentActRequest, RealtimeEvent } from 'chrome-mcp-shared'; +import { NativeMessageType } from 'chrome-mcp-shared'; + +import { NATIVE_HOST, STORAGE_KEYS } from '@/common/constants'; +import { + BACKGROUND_MESSAGE_TYPES, + TOOL_MESSAGE_TYPES, + type QuickPanelAIEventMessage, + type QuickPanelCancelAIMessage, + type QuickPanelCancelAIResponse, + type QuickPanelSendToAIMessage, + type QuickPanelSendToAIResponse, +} from '@/common/message-types'; +import { acquireKeepalive } from '../keepalive-manager'; +import { openAgentChatSidepanel } from '../utils/sidepanel'; + +// ============================================================ +// Constants +// ============================================================ + +const LOG_PREFIX = '[QuickPanelAgent]'; +const KEEPALIVE_TAG = 'quick-panel-ai'; + +/** Storage key for AgentChat selected session ID (owned by sidepanel composables) */ +const STORAGE_KEY_SELECTED_SESSION = 'agent-selected-session-id'; + +/** Timeout for initial SSE connection establishment */ +const SSE_CONNECT_TIMEOUT_MS = 3000; + +/** Safety timeout for entire request lifecycle (15 minutes) */ +const REQUEST_TIMEOUT_MS = 15 * 60 * 1000; + +/** Flag indicating SSE connection was successful */ +const SSE_CONNECTED = Symbol('SSE_CONNECTED'); + +/** Flag indicating SSE connection timed out but we should continue */ +const SSE_TIMEOUT = Symbol('SSE_TIMEOUT'); + +// ============================================================ +// Types +// ============================================================ + +/** + * Represents an active streaming request from Quick Panel. + * + * Background maintains this state to: + * 1. Route SSE events to the correct tab + * 2. Manage keepalive lifecycle + * 3. Handle cancellation and cleanup + */ +interface ActiveRequest { + readonly requestId: string; + readonly sessionId: string; + readonly instruction: string; + readonly tabId: number; + readonly windowId?: number; + readonly frameId?: number; + readonly port: number; + readonly createdAt: number; + readonly abortController: AbortController; + readonly releaseKeepalive: () => void; + readonly timeoutId: ReturnType; +} + +// ============================================================ +// State +// ============================================================ + +/** Active streaming requests indexed by requestId */ +const activeRequests = new Map(); + +/** Initialization flag to prevent duplicate listeners */ +let initialized = false; + +// ============================================================ +// Utility Functions +// ============================================================ + +function normalizeString(value: unknown): string { + return typeof value === 'string' ? value : ''; +} + +function normalizePort(value: unknown): number | null { + const num = + typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : Number.NaN; + + if (!Number.isFinite(num)) return null; + + const port = Math.floor(num); + if (port <= 0 || port > 65535) return null; + + return port; +} + +function createRequestId(): string { + // Prefer crypto.randomUUID for proper UUID format + try { + const id = crypto?.randomUUID?.(); + if (id) return id; + } catch { + // Fallback for environments without crypto.randomUUID + } + return `req_${Date.now()}_${Math.random().toString(16).slice(2)}`; +} + +function sleep(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +function isTerminalStatus(status: string): boolean { + return status === 'completed' || status === 'error' || status === 'cancelled'; +} + +// ============================================================ +// Event Factories +// ============================================================ + +function createErrorEvent(sessionId: string, requestId: string, error: string): RealtimeEvent { + return { + type: 'error', + error: error || 'Unknown error', + data: { sessionId, requestId }, + }; +} + +function createCancelledStatusEvent( + sessionId: string, + requestId: string, + message?: string, +): RealtimeEvent { + return { + type: 'status', + data: { + sessionId, + status: 'cancelled', + requestId, + message: message || 'Cancelled by user', + }, + }; +} + +// ============================================================ +// Event Forwarding +// ============================================================ + +/** + * Forward a RealtimeEvent to the Quick Panel in the originating tab. + * Handles receiver unavailability gracefully by cleaning up the request. + */ +function forwardEventToQuickPanel(request: ActiveRequest, event: RealtimeEvent): void { + const message: QuickPanelAIEventMessage = { + action: TOOL_MESSAGE_TYPES.QUICK_PANEL_AI_EVENT, + requestId: request.requestId, + sessionId: request.sessionId, + event, + }; + + const sendOptions = + typeof request.frameId === 'number' ? { frameId: request.frameId } : undefined; + + const sendPromise = sendOptions + ? chrome.tabs.sendMessage(request.tabId, message, sendOptions) + : chrome.tabs.sendMessage(request.tabId, message); + + sendPromise.catch((err) => { + const msg = err instanceof Error ? err.message : String(err); + + // Detect receiver unavailability (tab closed, navigated, Quick Panel closed) + const receiverGone = + msg.includes('Receiving end does not exist') || + msg.includes('No tab with id') || + msg.includes('The message port closed'); + + if (receiverGone) { + cleanupRequest(request.requestId, 'receiver_unavailable'); + } + }); +} + +// ============================================================ +// Request Lifecycle Management +// ============================================================ + +/** + * Clean up an active request and release all associated resources. + * Idempotent - safe to call multiple times. + */ +function cleanupRequest(requestId: string, reason: string): void { + const request = activeRequests.get(requestId); + if (!request) return; + + activeRequests.delete(requestId); + + // Clear timeout + try { + clearTimeout(request.timeoutId); + } catch { + // Ignore + } + + // Abort SSE connection + try { + request.abortController.abort(); + } catch { + // Ignore + } + + // Release keepalive + try { + request.releaseKeepalive(); + } catch { + // Ignore + } + + console.debug(`${LOG_PREFIX} Cleaned up request ${requestId} (${reason})`); +} + +// ============================================================ +// Session Validation +// ============================================================ + +/** + * Validate that the selected session exists on the native server. + * Returns false if the session is invalid or server is unreachable. + */ +async function validateSession(port: number, sessionId: string): Promise { + const url = `http://127.0.0.1:${port}/agent/sessions/${encodeURIComponent(sessionId)}`; + try { + const response = await fetch(url); + return response.ok; + } catch { + return false; + } +} + +// ============================================================ +// SSE Event Filtering +// ============================================================ + +/** + * Determine if a RealtimeEvent should be forwarded for a specific requestId. + * + * Events without requestId (connected, heartbeat) are session-level signals + * and are not forwarded to avoid confusion with request-specific events. + */ +function shouldForwardEvent(event: RealtimeEvent, requestId: string): boolean { + switch (event.type) { + case 'message': + return event.data?.requestId === requestId; + case 'status': + return event.data?.requestId === requestId; + case 'usage': + return event.data?.requestId === requestId; + case 'error': + return event.data?.requestId === requestId; + case 'connected': + case 'heartbeat': + // Session-level signals, not request-scoped + return false; + default: + return false; + } +} + +// ============================================================ +// SSE Subscription +// ============================================================ + +interface SseSubscription { + /** + * Resolves with true when SSE connection is established. + * Resolves with false if connection failed (request was cleaned up). + */ + ready: Promise; + /** Resolves when SSE stream ends (normally or due to error/abort) */ + done: Promise; +} + +/** + * Create an SSE subscription for the request's session. + * + * The subscription: + * 1. Connects to the session's /stream endpoint + * 2. Filters events by requestId + * 3. Forwards matching events to Quick Panel + * 4. Triggers cleanup on terminal status + * + * @returns SseSubscription with ready promise that resolves to: + * - true: SSE connected successfully + * - false: SSE failed (request was cleaned up, don't send /act) + */ +function createSseSubscription(request: ActiveRequest): SseSubscription { + // Track whether ready has been resolved + let readySettled = false; + let readyResolve: (connected: boolean) => void; + + const ready = new Promise((resolve) => { + readyResolve = resolve; + }); + + // Helper to resolve ready exactly once + const settleReady = (connected: boolean): void => { + if (readySettled) return; + readySettled = true; + readyResolve(connected); + }; + + const done = (async () => { + const sseUrl = `http://127.0.0.1:${request.port}/agent/chat/${encodeURIComponent(request.sessionId)}/stream`; + + try { + const response = await fetch(sseUrl, { + method: 'GET', + headers: { Accept: 'text/event-stream' }, + signal: request.abortController.signal, + }); + + if (!response.ok || !response.body) { + throw new Error(`SSE stream unavailable (HTTP ${response.status})`); + } + + // Signal that SSE is connected successfully + settleReady(true); + + const reader = response.body.getReader(); + const decoder = new TextDecoder(); + let buffer = ''; + + // Read and parse SSE stream + while (true) { + const { done, value } = await reader.read(); + if (done) break; + + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split('\n'); + buffer = lines.pop() ?? ''; + + for (const line of lines) { + if (!line.startsWith('data:')) continue; + const raw = line.slice(5).trim(); + if (!raw) continue; + + try { + const event = JSON.parse(raw) as RealtimeEvent; + + // Filter by requestId to prevent cross-request leakage + if (!shouldForwardEvent(event, request.requestId)) { + continue; + } + + forwardEventToQuickPanel(request, event); + + // Cleanup on terminal status + if (event.type === 'status' && event.data?.requestId === request.requestId) { + if (isTerminalStatus(event.data.status)) { + cleanupRequest(request.requestId, `terminal_status:${event.data.status}`); + return; + } + } + } catch { + // Ignore parse errors (best-effort stream processing) + } + } + } + } catch (err) { + // AbortError is intentional (cancellation or cleanup) + if (err instanceof Error && err.name === 'AbortError') { + // Signal not connected if aborted before connecting + settleReady(false); + return; + } + + // Surface error to UI and cleanup if request is still active + if (activeRequests.has(request.requestId)) { + const msg = err instanceof Error ? err.message : String(err); + forwardEventToQuickPanel( + request, + createErrorEvent(request.sessionId, request.requestId, msg), + ); + cleanupRequest(request.requestId, 'sse_error'); + } + + // Signal failed connection + settleReady(false); + } + })(); + + return { ready, done }; +} + +// ============================================================ +// Agent API +// ============================================================ + +/** + * Send the act request to native-server. + * The server will emit events via SSE which are already being subscribed. + * + * @param request - Active request context + * @throws Error if request was cancelled/aborted or HTTP request fails + */ +async function postActRequest(request: ActiveRequest): Promise { + // Check if request was cancelled before sending + if (request.abortController.signal.aborted) { + throw new Error('Request was cancelled'); + } + + const url = `http://127.0.0.1:${request.port}/agent/chat/${encodeURIComponent(request.sessionId)}/act`; + + const payload: AgentActRequest = { + instruction: request.instruction, + // Ensures session-level config is loaded (engine, model, options, project binding) + dbSessionId: request.sessionId, + // Enables SSE-first flow and requestId filtering on session-scoped streams + requestId: request.requestId, + }; + + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + signal: request.abortController.signal, + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } +} + +/** + * Cancel an active request on the native-server. + */ +async function cancelRequestOnServer( + port: number, + sessionId: string, + requestId: string, +): Promise { + const url = `http://127.0.0.1:${port}/agent/chat/${encodeURIComponent(sessionId)}/cancel/${encodeURIComponent(requestId)}`; + try { + await fetch(url, { method: 'DELETE' }); + } catch { + // Best-effort: cancellation might still succeed if request already ended + } +} + +// ============================================================ +// Request Orchestration +// ============================================================ + +/** + * Check if the request is still active and not cancelled. + * Used as a guard before each async operation to handle race conditions. + */ +function isRequestStillActive(request: ActiveRequest): boolean { + return activeRequests.has(request.requestId) && !request.abortController.signal.aborted; +} + +/** + * Main orchestration function for starting a Quick Panel AI request. + * + * Flow: + * 1. Ensure native server is running + * 2. Validate session exists + * 3. Open sidepanel (best-effort) + * 4. Start SSE subscription (wait for connection) + * 5. Fire act request + * 6. Let SSE handle event forwarding and cleanup + * + * @remarks + * Guards are placed after each async operation to handle cancellation races. + */ +async function startRequest(request: ActiveRequest): Promise { + try { + // Best-effort: ensure native server is running + await chrome.runtime.sendMessage({ type: NativeMessageType.ENSURE_NATIVE }).catch(() => null); + + // Guard: check if cancelled during ENSURE_NATIVE + if (!isRequestStillActive(request)) return; + + // Validate session still exists + const sessionValid = await validateSession(request.port, request.sessionId); + + // Guard: check if cancelled during validation + if (!isRequestStillActive(request)) return; + + if (!sessionValid) { + forwardEventToQuickPanel( + request, + createErrorEvent( + request.sessionId, + request.requestId, + 'Selected Agent session is not available. Please open AgentChat and select a valid session.', + ), + ); + // Open sidepanel without deep-linking to invalid session + openAgentChatSidepanel(request.tabId, request.windowId).catch(() => {}); + cleanupRequest(request.requestId, 'session_invalid'); + return; + } + + // Best-effort: open sidepanel deep-linked to current session + openAgentChatSidepanel(request.tabId, request.windowId, request.sessionId).catch(() => {}); + + // Start SSE subscription BEFORE sending act request to avoid missing early events + const sse = createSseSubscription(request); + + // Wait for SSE connection with timeout + // The race returns either: + // - boolean from sse.ready (true=connected, false=failed) + // - undefined from timeout (treat as "proceed with caution") + const sseResult = await Promise.race([ + sse.ready, + sleep(SSE_CONNECT_TIMEOUT_MS).then(() => SSE_TIMEOUT), + ]); + + // Guard: check if cancelled during SSE connection + if (!isRequestStillActive(request)) return; + + // If SSE explicitly failed (returned false), don't send /act + // The SSE subscription already cleaned up and sent error to UI + if (sseResult === false) { + console.debug(`${LOG_PREFIX} SSE failed for ${request.requestId}, not sending /act`); + return; + } + + // If SSE timed out, log warning but continue (degraded experience) + if (sseResult === SSE_TIMEOUT) { + console.warn( + `${LOG_PREFIX} SSE connection timed out for ${request.requestId}, proceeding anyway`, + ); + } + + // Fire the act request + await postActRequest(request); + + // SSE subscription continues running and will handle cleanup on terminal status + void sse.done; + } catch (err) { + // Abort errors are expected during cancellation + if (err instanceof Error && err.name === 'AbortError') { + return; + } + + // Request may have been cleaned up already + if (!activeRequests.has(request.requestId)) return; + + const msg = err instanceof Error ? err.message : String(err); + forwardEventToQuickPanel(request, createErrorEvent(request.sessionId, request.requestId, msg)); + cleanupRequest(request.requestId, 'start_failed'); + } +} + +// ============================================================ +// Message Handlers +// ============================================================ + +/** + * Handle QUICK_PANEL_SEND_TO_AI message. + * Creates a new streaming request and starts the orchestration flow. + */ +async function handleSendToAI( + message: QuickPanelSendToAIMessage, + sender: chrome.runtime.MessageSender, +): Promise { + const tabId = sender?.tab?.id; + const windowId = sender?.tab?.windowId; + const frameId = typeof sender?.frameId === 'number' ? sender.frameId : undefined; + + if (typeof tabId !== 'number') { + return { success: false, error: 'Quick Panel request must originate from a tab.' }; + } + + const instruction = normalizeString(message?.payload?.instruction).trim(); + if (!instruction) { + return { success: false, error: 'instruction is required' }; + } + + // Read server port and selected session from storage + const stored = await chrome.storage.local.get([ + STORAGE_KEYS.NATIVE_SERVER_PORT, + STORAGE_KEY_SELECTED_SESSION, + ]); + + const port = normalizePort(stored?.[STORAGE_KEYS.NATIVE_SERVER_PORT]) ?? NATIVE_HOST.DEFAULT_PORT; + const sessionId = normalizeString(stored?.[STORAGE_KEY_SELECTED_SESSION]).trim(); + + if (!sessionId) { + // No session selected: open sidepanel for user to select/create one + openAgentChatSidepanel(tabId, windowId).catch(() => {}); + return { + success: false, + error: + 'No Agent session selected. Please open AgentChat, select or create a session, then try again.', + }; + } + + // Create request state + const requestId = createRequestId(); + const releaseKeepalive = acquireKeepalive(KEEPALIVE_TAG); + const abortController = new AbortController(); + + // Safety timeout to prevent infinite streaming + const timeoutId = setTimeout(() => { + const activeRequest = activeRequests.get(requestId); + if (!activeRequest) return; + + forwardEventToQuickPanel( + activeRequest, + createErrorEvent( + activeRequest.sessionId, + activeRequest.requestId, + 'Quick Panel stream timed out. Please continue in AgentChat sidepanel.', + ), + ); + cleanupRequest(requestId, 'timeout'); + }, REQUEST_TIMEOUT_MS); + + const request: ActiveRequest = { + requestId, + sessionId, + instruction, + tabId, + windowId: typeof windowId === 'number' ? windowId : undefined, + frameId, + port, + createdAt: Date.now(), + abortController, + releaseKeepalive, + timeoutId, + }; + + activeRequests.set(requestId, request); + + // Start the request asynchronously (don't await) + void startRequest(request); + + return { success: true, requestId, sessionId }; +} + +/** + * Handle QUICK_PANEL_CANCEL_AI message. + * Cancels an active request both locally and on the server. + */ +async function handleCancelAI( + message: QuickPanelCancelAIMessage, + sender: chrome.runtime.MessageSender, +): Promise { + const tabId = sender?.tab?.id; + const frameId = typeof sender?.frameId === 'number' ? sender.frameId : undefined; + + if (typeof tabId !== 'number') { + return { success: false, error: 'Cancel request must originate from a tab.' }; + } + + const requestId = normalizeString(message?.payload?.requestId).trim(); + const fallbackSessionId = normalizeString(message?.payload?.sessionId).trim(); + + if (!requestId) { + return { success: false, error: 'requestId is required' }; + } + + const activeRequest = activeRequests.get(requestId); + const sessionId = activeRequest?.sessionId || fallbackSessionId; + + if (!sessionId) { + return { + success: false, + error: 'Unknown sessionId for this request. Please cancel from AgentChat sidepanel.', + }; + } + + // Abort SSE immediately for responsive UX + if (activeRequest) { + try { + activeRequest.abortController.abort(); + } catch { + // Ignore + } + } + + // Determine port + let port = activeRequest?.port; + if (!port) { + const stored = await chrome.storage.local.get([STORAGE_KEYS.NATIVE_SERVER_PORT]); + port = normalizePort(stored?.[STORAGE_KEYS.NATIVE_SERVER_PORT]) ?? NATIVE_HOST.DEFAULT_PORT; + } + + // Cancel on server (async, don't await) + void cancelRequestOnServer(port, sessionId, requestId); + + // Send synthetic cancelled status to UI + const cancelledEvent = createCancelledStatusEvent(sessionId, requestId); + const eventMessage: QuickPanelAIEventMessage = { + action: TOOL_MESSAGE_TYPES.QUICK_PANEL_AI_EVENT, + requestId, + sessionId, + event: cancelledEvent, + }; + + const sendOptions = typeof frameId === 'number' ? { frameId } : undefined; + const sendPromise = sendOptions + ? chrome.tabs.sendMessage(tabId, eventMessage, sendOptions) + : chrome.tabs.sendMessage(tabId, eventMessage); + + sendPromise + .catch(() => {}) + .finally(() => { + cleanupRequest(requestId, 'cancelled_by_user'); + }); + + return { success: true }; +} + +// ============================================================ +// Initialization +// ============================================================ + +/** + * Initialize the Quick Panel Agent Handler. + * Sets up message listeners and tab cleanup handlers. + */ +export function initQuickPanelAgentHandler(): void { + if (initialized) return; + initialized = true; + + // Message listener for Quick Panel messages + chrome.runtime.onMessage.addListener((message, sender, sendResponse) => { + // Handle QUICK_PANEL_SEND_TO_AI + if (message?.type === BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_SEND_TO_AI) { + handleSendToAI(message as QuickPanelSendToAIMessage, sender) + .then(sendResponse) + .catch((err) => { + const msg = err instanceof Error ? err.message : String(err); + sendResponse({ success: false, error: msg || 'Unknown error' }); + }); + return true; // Async response + } + + // Handle QUICK_PANEL_CANCEL_AI + if (message?.type === BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_CANCEL_AI) { + handleCancelAI(message as QuickPanelCancelAIMessage, sender) + .then(sendResponse) + .catch((err) => { + const msg = err instanceof Error ? err.message : String(err); + sendResponse({ success: false, error: msg || 'Unknown error' }); + }); + return true; // Async response + } + + return false; + }); + + // Clean up requests when their tab is closed + chrome.tabs.onRemoved.addListener((tabId) => { + for (const [requestId, request] of activeRequests) { + if (request.tabId === tabId) { + cleanupRequest(requestId, 'tab_removed'); + } + } + }); + + console.debug(`${LOG_PREFIX} Initialized`); +} diff --git a/app/chrome-extension/entrypoints/background/quick-panel/commands.ts b/app/chrome-extension/entrypoints/background/quick-panel/commands.ts new file mode 100644 index 00000000..a9425e2f --- /dev/null +++ b/app/chrome-extension/entrypoints/background/quick-panel/commands.ts @@ -0,0 +1,124 @@ +/** + * Quick Panel Commands Handler + * + * Handles keyboard shortcuts for Quick Panel functionality. + * Listens for the 'toggle_quick_panel' command and sends toggle message + * to the content script in the active tab. + */ + +// ============================================================ +// Constants +// ============================================================ + +const COMMAND_KEY = 'toggle_quick_panel'; +const LOG_PREFIX = '[QuickPanelCommands]'; + +// ============================================================ +// Helpers +// ============================================================ + +/** + * Get the ID of the currently active tab + */ +async function getActiveTabId(): Promise { + try { + const [tab] = await chrome.tabs.query({ active: true, currentWindow: true }); + return tab?.id ?? null; + } catch (err) { + console.warn(`${LOG_PREFIX} Failed to get active tab:`, err); + return null; + } +} + +/** + * Check if a tab can receive content scripts + */ +function isValidTabUrl(url?: string): boolean { + if (!url) return false; + + // Cannot inject into browser internal pages + const invalidPrefixes = [ + 'chrome://', + 'chrome-extension://', + 'edge://', + 'about:', + 'moz-extension://', + 'devtools://', + 'view-source:', + 'data:', + // 'file://', + ]; + + return !invalidPrefixes.some((prefix) => url.startsWith(prefix)); +} + +// ============================================================ +// Main Handler +// ============================================================ + +/** + * Toggle Quick Panel in the active tab + */ +async function toggleQuickPanelInActiveTab(): Promise { + const tabId = await getActiveTabId(); + if (tabId === null) { + console.warn(`${LOG_PREFIX} No active tab found`); + return; + } + + // Get tab info to check URL validity + try { + const tab = await chrome.tabs.get(tabId); + if (!isValidTabUrl(tab.url)) { + console.warn(`${LOG_PREFIX} Cannot inject into tab URL: ${tab.url}`); + return; + } + } catch (err) { + console.warn(`${LOG_PREFIX} Failed to get tab info:`, err); + return; + } + + // Send toggle message to content script + try { + const response = await chrome.tabs.sendMessage(tabId, { action: 'toggle_quick_panel' }); + if (response?.success) { + console.log(`${LOG_PREFIX} Quick Panel toggled, visible: ${response.visible}`); + } else { + console.warn(`${LOG_PREFIX} Toggle failed:`, response?.error); + } + } catch (err) { + // Content script may not be loaded yet; this is expected on some pages + console.warn( + `${LOG_PREFIX} Failed to send toggle message (content script may not be loaded):`, + err, + ); + } +} + +// ============================================================ +// Initialization +// ============================================================ + +/** + * Initialize Quick Panel keyboard command listener + */ +export function initQuickPanelCommands(): void { + console.log(`${LOG_PREFIX} initQuickPanelCommands called`); + chrome.commands.onCommand.addListener(async (command) => { + console.log(`${LOG_PREFIX} onCommand received:`, command); + if (command !== COMMAND_KEY) { + console.log(`${LOG_PREFIX} Command not matched, expected:`, COMMAND_KEY); + return; + } + console.log(`${LOG_PREFIX} Command matched, calling toggleQuickPanelInActiveTab...`); + + try { + await toggleQuickPanelInActiveTab(); + console.log(`${LOG_PREFIX} toggleQuickPanelInActiveTab completed`); + } catch (err) { + console.error(`${LOG_PREFIX} Command handler error:`, err); + } + }); + + console.log(`${LOG_PREFIX} Command listener registered for: ${COMMAND_KEY}`); +} diff --git a/app/chrome-extension/entrypoints/background/quick-panel/tabs-handler.ts b/app/chrome-extension/entrypoints/background/quick-panel/tabs-handler.ts new file mode 100644 index 00000000..1a248ca6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/quick-panel/tabs-handler.ts @@ -0,0 +1,230 @@ +/** + * Quick Panel Tabs Handler + * + * Background service worker bridge for Quick Panel (content script) to: + * - Enumerate tabs for search suggestions + * - Activate a selected tab + * - Close a tab + * + * Note: Content scripts cannot access chrome.tabs.* directly. + */ + +import { + BACKGROUND_MESSAGE_TYPES, + type QuickPanelActivateTabMessage, + type QuickPanelActivateTabResponse, + type QuickPanelCloseTabMessage, + type QuickPanelCloseTabResponse, + type QuickPanelTabSummary, + type QuickPanelTabsQueryMessage, + type QuickPanelTabsQueryResponse, +} from '@/common/message-types'; + +// ============================================================ +// Constants +// ============================================================ + +const LOG_PREFIX = '[QuickPanelTabs]'; + +// ============================================================ +// Helpers +// ============================================================ + +function isValidTabId(value: unknown): value is number { + return typeof value === 'number' && Number.isFinite(value) && value > 0; +} + +function isValidWindowId(value: unknown): value is number { + return typeof value === 'number' && Number.isFinite(value) && value > 0; +} + +function normalizeBoolean(value: unknown): boolean { + return value === true; +} + +function getLastAccessed(tab: chrome.tabs.Tab): number | undefined { + const anyTab = tab as unknown as { lastAccessed?: unknown }; + const value = anyTab.lastAccessed; + return typeof value === 'number' && Number.isFinite(value) ? value : undefined; +} + +function safeErrorMessage(err: unknown): string { + if (err instanceof Error) { + return err.message || String(err); + } + return String(err); +} + +/** + * Convert a chrome.tabs.Tab to our summary format. + * Returns null if tab is invalid. + */ +function toTabSummary(tab: chrome.tabs.Tab): QuickPanelTabSummary | null { + if (!isValidTabId(tab.id)) return null; + + const windowId = isValidWindowId(tab.windowId) ? tab.windowId : null; + if (windowId === null) return null; + + return { + tabId: tab.id, + windowId, + title: tab.title ?? '', + url: tab.url ?? '', + favIconUrl: tab.favIconUrl ?? undefined, + active: normalizeBoolean(tab.active), + pinned: normalizeBoolean(tab.pinned), + audible: normalizeBoolean(tab.audible), + muted: normalizeBoolean(tab.mutedInfo?.muted), + index: typeof tab.index === 'number' && Number.isFinite(tab.index) ? tab.index : 0, + lastAccessed: getLastAccessed(tab), + }; +} + +// ============================================================ +// Message Handlers +// ============================================================ + +async function handleTabsQuery( + message: QuickPanelTabsQueryMessage, + sender: chrome.runtime.MessageSender, +): Promise { + try { + const includeAllWindows = message.payload?.includeAllWindows ?? true; + + // Extract current context from sender + const currentWindowId = isValidWindowId(sender.tab?.windowId) ? sender.tab!.windowId : null; + const currentTabId = isValidTabId(sender.tab?.id) ? sender.tab!.id : null; + + // Quick Panel should only be called from content scripts (which have sender.tab) + // Reject requests without valid sender tab context for security + if (!includeAllWindows && currentWindowId === null) { + return { + success: false, + error: 'Invalid request: sender tab context required for window-scoped queries', + }; + } + + // Build query info based on scope + const queryInfo: chrome.tabs.QueryInfo = includeAllWindows + ? {} + : { windowId: currentWindowId! }; + + const tabs = await chrome.tabs.query(queryInfo); + + // Convert to summaries, filtering out invalid tabs + const summaries: QuickPanelTabSummary[] = []; + for (const tab of tabs) { + const summary = toTabSummary(tab); + if (summary) { + summaries.push(summary); + } + } + + return { + success: true, + tabs: summaries, + currentTabId, + currentWindowId, + }; + } catch (err) { + console.warn(`${LOG_PREFIX} Error querying tabs:`, err); + return { + success: false, + error: safeErrorMessage(err) || 'Failed to query tabs', + }; + } +} + +async function handleActivateTab( + message: QuickPanelActivateTabMessage, +): Promise { + try { + const tabId = message.payload?.tabId; + const windowId = message.payload?.windowId; + + if (!isValidTabId(tabId)) { + return { success: false, error: 'Invalid tabId' }; + } + + // Focus the window first if provided + if (isValidWindowId(windowId)) { + try { + await chrome.windows.update(windowId, { focused: true }); + } catch { + // Best-effort: tab activation may still succeed without focusing window. + } + } + + // Activate the tab + await chrome.tabs.update(tabId, { active: true }); + + return { success: true }; + } catch (err) { + console.warn(`${LOG_PREFIX} Error activating tab:`, err); + return { + success: false, + error: safeErrorMessage(err) || 'Failed to activate tab', + }; + } +} + +async function handleCloseTab( + message: QuickPanelCloseTabMessage, +): Promise { + try { + const tabId = message.payload?.tabId; + + if (!isValidTabId(tabId)) { + return { success: false, error: 'Invalid tabId' }; + } + + await chrome.tabs.remove(tabId); + + return { success: true }; + } catch (err) { + console.warn(`${LOG_PREFIX} Error closing tab:`, err); + return { + success: false, + error: safeErrorMessage(err) || 'Failed to close tab', + }; + } +} + +// ============================================================ +// Initialization +// ============================================================ + +let initialized = false; + +/** + * Initialize the Quick Panel Tabs handler. + * Safe to call multiple times - subsequent calls are no-ops. + */ +export function initQuickPanelTabsHandler(): void { + if (initialized) return; + initialized = true; + + chrome.runtime.onMessage.addListener((message, sender, sendResponse) => { + // Tabs query + if (message?.type === BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TABS_QUERY) { + handleTabsQuery(message as QuickPanelTabsQueryMessage, sender).then(sendResponse); + return true; // Will respond asynchronously + } + + // Tab activate + if (message?.type === BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_ACTIVATE) { + handleActivateTab(message as QuickPanelActivateTabMessage).then(sendResponse); + return true; + } + + // Tab close + if (message?.type === BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_CLOSE) { + handleCloseTab(message as QuickPanelCloseTabMessage).then(sendResponse); + return true; + } + + return false; // Not handled by this listener + }); + + console.debug(`${LOG_PREFIX} Initialized`); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/bootstrap.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/bootstrap.ts new file mode 100644 index 00000000..75704c46 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/bootstrap.ts @@ -0,0 +1,469 @@ +/** + * @fileoverview Record-Replay V3 composition root (bootstrap) + * @description + * Wires storage, events, scheduler, triggers and RPC for the MV3 background service worker. + * + * 设计说明： + * - 必须先执行 recoverFromCrash() 再启动 scheduler.start() + * - 使用全局单例 keepalive-manager 避免多个控制器冲突 + * - RunExecutor 使用 RunRunner 执行实际的 Flow + */ + +import type { UnixMillis } from './domain/json'; +import type { RunId } from './domain/ids'; +import { RR_ERROR_CODES, createRRError, type RRError } from './domain/errors'; + +import type { StoragePort } from './engine/storage/storage-port'; +import { StorageBackedEventsBus, type EventsBus } from './engine/transport/events-bus'; + +import { DEFAULT_QUEUE_CONFIG, type RunQueueItem } from './engine/queue/queue'; +import { createLeaseManager, generateOwnerId, type LeaseManager } from './engine/queue/leasing'; +import { createRunScheduler, type RunExecutor, type RunScheduler } from './engine/queue/scheduler'; +import { recoverFromCrash } from './engine/recovery/recovery-coordinator'; + +import { RpcServer } from './engine/transport/rpc-server'; + +import { createTriggerManager, type TriggerManager } from './engine/triggers/trigger-manager'; +import { createUrlTriggerHandlerFactory } from './engine/triggers/url-trigger'; +import { createCommandTriggerHandlerFactory } from './engine/triggers/command-trigger'; +import { createContextMenuTriggerHandlerFactory } from './engine/triggers/context-menu-trigger'; +import { createDomTriggerHandlerFactory } from './engine/triggers/dom-trigger'; +import { createCronTriggerHandlerFactory } from './engine/triggers/cron-trigger'; +import { createIntervalTriggerHandlerFactory } from './engine/triggers/interval-trigger'; +import { createOnceTriggerHandlerFactory } from './engine/triggers/once-trigger'; +import { createManualTriggerHandlerFactory } from './engine/triggers/manual-trigger'; + +import { createChromeArtifactService } from './engine/kernel/artifacts'; +import { createRunRunnerFactory, type RunRunnerFactory } from './engine/kernel/runner'; +import { + createDebugController, + createRunnerRegistry, + type DebugController, + type RunnerRegistry, +} from './engine/kernel/debug-controller'; + +import { PluginRegistry } from './engine/plugins/registry'; +import { + registerV2ReplayNodesAsV3Nodes, + DEFAULT_V2_EXCLUDE_LIST, +} from './engine/plugins/register-v2-replay-nodes'; + +import { acquireKeepalive } from '../keepalive-manager'; +import { createStoragePort } from './index'; + +// ==================== Types ==================== + +type Logger = Pick; + +/** + * V3 运行时句柄 + */ +export interface V3Runtime { + ownerId: string; + storage: StoragePort; + events: EventsBus; + leaseManager: LeaseManager; + scheduler: RunScheduler; + runners: RunnerRegistry; + debugController: DebugController; + triggers: TriggerManager; + rpcServer: RpcServer; + stop(): Promise; +} + +// ==================== Singleton State ==================== + +let runtime: V3Runtime | null = null; +let bootstrapPromise: Promise | null = null; + +// ==================== Utilities ==================== + +function errorMessage(err: unknown): string { + if (err instanceof Error) return err.message; + if (err && typeof err === 'object' && 'message' in err) + return String((err as { message: unknown }).message); + return String(err); +} + +function isFiniteNumber(v: unknown): v is number { + return typeof v === 'number' && Number.isFinite(v); +} + +async function tabExists(tabId: number): Promise { + try { + await chrome.tabs.get(tabId); + return true; + } catch { + return false; + } +} + +async function createEphemeralTab(logger: Logger): Promise { + const tab = await chrome.tabs.create({ url: 'about:blank', active: false }); + if (tab.id === undefined) { + throw new Error('chrome.tabs.create returned a tab without id'); + } + logger.debug(`[RR-V3] Allocated ephemeral tab ${tab.id}`); + return tab.id; +} + +async function safeRemoveTab(tabId: number, logger: Logger): Promise { + try { + await chrome.tabs.remove(tabId); + } catch (e) { + logger.debug(`[RR-V3] Failed to close tab ${tabId}:`, e); + } +} + +/** + * 解析运行 Run 所需的 Tab ID + * 优先级: run.tabId > queue.tabId > trigger.sourceTabId > 创建新 Tab + */ +async function resolveRunTab(input: { + runTabId?: number; + queueTabId?: number; + triggerTabId?: number; + logger: Logger; +}): Promise<{ tabId: number; shouldClose: boolean }> { + const candidates = [input.runTabId, input.queueTabId, input.triggerTabId].filter( + (x): x is number => isFiniteNumber(x), + ); + + for (const tabId of candidates) { + if (await tabExists(tabId)) { + return { tabId, shouldClose: false }; + } + } + + const tabId = await createEphemeralTab(input.logger); + return { tabId, shouldClose: true }; +} + +/** + * 将 Run 标记为失败 + * 注意：会重新读取最新的 RunRecord 以获取正确的 startedAt + */ +async function failRun( + deps: { storage: StoragePort; events: EventsBus; now: () => UnixMillis; logger: Logger }, + runId: RunId, + error: RRError, +): Promise { + const finishedAt = deps.now(); + + // 重新获取最新的 run 记录以获取正确的 startedAt + let startedAt = finishedAt; + try { + const latestRun = await deps.storage.runs.get(runId); + if (latestRun?.startedAt !== undefined) { + startedAt = latestRun.startedAt; + } + } catch { + // ignore - use finishedAt as startedAt + } + + const tookMs = Math.max(0, finishedAt - startedAt); + + try { + await deps.storage.runs.patch(runId, { + status: 'failed', + finishedAt, + tookMs, + error, + }); + } catch (e) { + deps.logger.error(`[RR-V3] Failed to patch run "${runId}" as failed:`, e); + return; + } + + try { + await deps.events.append({ runId, type: 'run.failed', error }); + } catch (e) { + deps.logger.warn(`[RR-V3] Failed to append run.failed for "${runId}":`, e); + } +} + +// ==================== Run Executor ==================== + +/** + * 创建默认的 RunExecutor + * 使用 RunRunner 执行 Flow + */ +function createDefaultRunExecutor(deps: { + storage: StoragePort; + events: EventsBus; + runnerFactory: RunRunnerFactory; + runners: RunnerRegistry; + now: () => UnixMillis; + logger: Logger; +}): RunExecutor { + return async (item: RunQueueItem): Promise => { + const runId = item.id; + + // 1. 获取 RunRecord + const run = await deps.storage.runs.get(runId); + if (!run) { + deps.logger.warn(`[RR-V3] RunRecord not found for queue item "${runId}", skipping execution`); + return; + } + + // 2. 获取 Flow + const flow = await deps.storage.flows.get(item.flowId); + if (!flow) { + await failRun( + deps, + runId, + createRRError(RR_ERROR_CODES.VALIDATION_ERROR, `Flow "${item.flowId}" not found`), + ); + return; + } + + // 3. 解析 Tab ID + const { tabId, shouldClose } = await resolveRunTab({ + runTabId: run.tabId, + queueTabId: item.tabId, + triggerTabId: item.trigger?.sourceTabId, + logger: deps.logger, + }); + + // 4. 同步 attempt 到 RunRecord + try { + await deps.storage.runs.patch(runId, { + attempt: item.attempt, + maxAttempts: item.maxAttempts, + tabId, + }); + } catch (e) { + deps.logger.debug(`[RR-V3] Failed to patch run "${runId}" attempt/tabId:`, e); + } + + // 5. 执行 Run + let runner; + try { + runner = deps.runnerFactory.create(runId, { + flow, + tabId, + args: item.args, + startNodeId: run.startNodeId, + debug: item.debug, + }); + + // 注册到 RunnerRegistry，供 DebugController 和 RPC 使用 + deps.runners.register(runId, runner); + + await runner.start(); + } catch (e) { + await failRun( + deps, + runId, + createRRError(RR_ERROR_CODES.INTERNAL, `Executor crashed: ${errorMessage(e)}`), + ); + } finally { + // 6. 注销 Runner + if (runner) { + deps.runners.unregister(runId); + } + + // 7. 清理临时 Tab + if (shouldClose) { + await safeRemoveTab(tabId, deps.logger); + } + } + }; +} + +// ==================== Bootstrap ==================== + +/** + * 启动 RR-V3 运行时 + * @returns 运行时句柄 + */ +export async function bootstrapV3(): Promise { + if (runtime) return runtime; + if (bootstrapPromise) return bootstrapPromise; + + bootstrapPromise = (async () => { + const logger: Logger = console; + const now = (): UnixMillis => Date.now(); + + logger.info('[RR-V3] Bootstrapping...'); + + // 1) Storage + const storage = createStoragePort(); + + // 2) EventsBus + const events: EventsBus = new StorageBackedEventsBus(storage.events); + + // 3) Lease owner identity (per SW instance) + const ownerId = generateOwnerId(); + logger.debug(`[RR-V3] Owner ID: ${ownerId}`); + + // 4) LeaseManager + const leaseManager = createLeaseManager(storage.queue, DEFAULT_QUEUE_CONFIG); + + // 5) RunnerRegistry + DebugController + const runners = createRunnerRegistry(); + const debugController = createDebugController({ storage, events, runners }); + + // 6) Keepalive (reuse global singleton to avoid multiple controllers fighting) + const keepalive = { + acquire: (tag: string) => acquireKeepalive(`rr_v3:${tag}`), + }; + + // 7) PluginRegistry - register V2 action handlers as V3 nodes + const plugins = new PluginRegistry(); + const registeredNodes = registerV2ReplayNodesAsV3Nodes(plugins, { + // Exclude control directives that V3 runner doesn't support + exclude: [...DEFAULT_V2_EXCLUDE_LIST], + }); + logger.debug(`[RR-V3] Registered ${registeredNodes.length} V2 action handlers as V3 nodes`); + + // 8) RunExecutor via RunRunnerFactory + const runnerFactory = createRunRunnerFactory({ + storage, + events, + plugins, + artifactService: createChromeArtifactService(), + now, + }); + + const execute = createDefaultRunExecutor({ + storage, + events, + runnerFactory, + runners, + now, + logger, + }); + + // 7) Scheduler + const scheduler = createRunScheduler({ + queue: storage.queue, + leaseManager, + keepalive, + config: DEFAULT_QUEUE_CONFIG, + ownerId, + execute, + now, + logger, + }); + + // 8) TriggerManager + const triggers = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { + url: createUrlTriggerHandlerFactory({ logger }), + command: createCommandTriggerHandlerFactory({ logger }), + contextMenu: createContextMenuTriggerHandlerFactory({ logger }), + dom: createDomTriggerHandlerFactory({ logger }), + cron: createCronTriggerHandlerFactory({ logger, now }), + interval: createIntervalTriggerHandlerFactory({ logger }), + once: createOnceTriggerHandlerFactory({ logger }), + manual: createManualTriggerHandlerFactory({ logger }), + }, + now, + logger, + }); + + // 10) RpcServer (created but started after recovery) + const rpcServer = new RpcServer({ + storage, + events, + scheduler, + debugController, + runners, + triggerManager: triggers, + now, + }); + + // Cleanup helper for error recovery + const cleanup = async (): Promise => { + try { + rpcServer.stop(); + } catch { + /* ignore */ + } + try { + await triggers.stop(); + } catch { + /* ignore */ + } + try { + scheduler.stop(); + } catch { + /* ignore */ + } + try { + leaseManager.dispose(); + } catch { + /* ignore */ + } + try { + debugController.stop(); + } catch { + /* ignore */ + } + }; + + try { + // 10) Recovery - MUST run before scheduler.start() + logger.info('[RR-V3] Running crash recovery...'); + await recoverFromCrash({ storage, events, ownerId, now, logger }); + + // 11) Start components + scheduler.start(); + await triggers.start(); + rpcServer.start(); + + logger.info('[RR-V3] Bootstrap complete'); + } catch (e) { + await cleanup(); + throw e; + } + + // Build runtime handle + runtime = { + ownerId, + storage, + events, + leaseManager, + scheduler, + runners, + debugController, + triggers, + rpcServer, + stop: async () => { + logger.info('[RR-V3] Stopping...'); + // Stop order: RPC first (block new requests) -> triggers -> scheduler -> lease -> debug + rpcServer.stop(); + await triggers.stop().catch(() => {}); + scheduler.stop(); + leaseManager.dispose(); + debugController.stop(); + runtime = null; + logger.info('[RR-V3] Stopped'); + }, + }; + + return runtime; + })().finally(() => { + bootstrapPromise = null; + }); + + return bootstrapPromise; +} + +/** + * 获取当前运行时（如果已启动） + */ +export function getV3Runtime(): V3Runtime | null { + return runtime; +} + +/** + * 检查 V3 是否已启动 + */ +export function isV3Running(): boolean { + return runtime !== null; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/debug.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/debug.ts new file mode 100644 index 00000000..ed540643 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/debug.ts @@ -0,0 +1,88 @@ +/** + * @fileoverview 调试器类型定义 + * @description 定义 Record-Replay V3 中的调试器状态和协议 + */ + +import type { JsonValue } from './json'; +import type { NodeId, RunId } from './ids'; +import type { PauseReason } from './events'; + +/** + * 断点定义 + */ +export interface Breakpoint { + /** 断点所在节点 ID */ + nodeId: NodeId; + /** 是否启用 */ + enabled: boolean; +} + +/** + * 调试器状态 + * @description 描述调试器当前的连接和执行状态 + */ +export interface DebuggerState { + /** 关联的 Run ID */ + runId: RunId; + /** 调试器连接状态 */ + status: 'attached' | 'detached'; + /** 执行状态 */ + execution: 'running' | 'paused'; + /** 暂停原因（仅当 execution='paused' 时有效） */ + pauseReason?: PauseReason; + /** 当前节点 ID */ + currentNodeId?: NodeId; + /** 断点列表 */ + breakpoints: Breakpoint[]; + /** 单步模式 */ + stepMode?: 'none' | 'stepOver'; +} + +/** + * 调试器命令 + * @description 客户端发送给调试器的命令 + */ +export type DebuggerCommand = + // ===== 连接控制 ===== + | { type: 'debug.attach'; runId: RunId } + | { type: 'debug.detach'; runId: RunId } + + // ===== 执行控制 ===== + | { type: 'debug.pause'; runId: RunId } + | { type: 'debug.resume'; runId: RunId } + | { type: 'debug.stepOver'; runId: RunId } + + // ===== 断点管理 ===== + | { type: 'debug.setBreakpoints'; runId: RunId; nodeIds: NodeId[] } + | { type: 'debug.addBreakpoint'; runId: RunId; nodeId: NodeId } + | { type: 'debug.removeBreakpoint'; runId: RunId; nodeId: NodeId } + + // ===== 状态查询 ===== + | { type: 'debug.getState'; runId: RunId } + + // ===== 变量操作 ===== + | { type: 'debug.getVar'; runId: RunId; name: string } + | { type: 'debug.setVar'; runId: RunId; name: string; value: JsonValue }; + +/** 调试器命令类型（从联合类型提取） */ +export type DebuggerCommandType = DebuggerCommand['type']; + +/** + * 调试器命令响应 + */ +export type DebuggerResponse = + | { ok: true; state?: DebuggerState; value?: JsonValue } + | { ok: false; error: string }; + +/** + * 创建初始调试器状态 + */ +export function createInitialDebuggerState(runId: RunId): DebuggerState { + return { + runId, + status: 'detached', + execution: 'running', + breakpoints: [], + stepMode: 'none', + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/errors.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/errors.ts new file mode 100644 index 00000000..d0f6cc5c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/errors.ts @@ -0,0 +1,92 @@ +/** + * @fileoverview 错误类型定义 + * @description 定义 Record-Replay V3 中使用的错误码和错误类型 + */ + +import type { JsonValue } from './json'; + +/** 错误码常量 */ +export const RR_ERROR_CODES = { + // ===== 验证错误 ===== + /** 通用验证错误 */ + VALIDATION_ERROR: 'VALIDATION_ERROR', + /** 不支持的节点类型 */ + UNSUPPORTED_NODE: 'UNSUPPORTED_NODE', + /** DAG 结构无效 */ + DAG_INVALID: 'DAG_INVALID', + /** DAG 存在循环 */ + DAG_CYCLE: 'DAG_CYCLE', + + // ===== 运行时错误 ===== + /** 操作超时 */ + TIMEOUT: 'TIMEOUT', + /** Tab 未找到 */ + TAB_NOT_FOUND: 'TAB_NOT_FOUND', + /** Frame 未找到 */ + FRAME_NOT_FOUND: 'FRAME_NOT_FOUND', + /** 目标元素未找到 */ + TARGET_NOT_FOUND: 'TARGET_NOT_FOUND', + /** 元素不可见 */ + ELEMENT_NOT_VISIBLE: 'ELEMENT_NOT_VISIBLE', + /** 导航失败 */ + NAVIGATION_FAILED: 'NAVIGATION_FAILED', + /** 网络请求失败 */ + NETWORK_REQUEST_FAILED: 'NETWORK_REQUEST_FAILED', + + // ===== 脚本/工具错误 ===== + /** 脚本执行失败 */ + SCRIPT_FAILED: 'SCRIPT_FAILED', + /** 权限被拒绝 */ + PERMISSION_DENIED: 'PERMISSION_DENIED', + /** 工具执行错误 */ + TOOL_ERROR: 'TOOL_ERROR', + + // ===== 控制错误 ===== + /** Run 被取消 */ + RUN_CANCELED: 'RUN_CANCELED', + /** Run 被暂停 */ + RUN_PAUSED: 'RUN_PAUSED', + + // ===== 内部错误 ===== + /** 内部错误 */ + INTERNAL: 'INTERNAL', + /** 不变量违规 */ + INVARIANT_VIOLATION: 'INVARIANT_VIOLATION', +} as const; + +/** 错误码类型 */ +export type RRErrorCode = (typeof RR_ERROR_CODES)[keyof typeof RR_ERROR_CODES]; + +/** + * Record-Replay 错误接口 + * @description 统一的错误表示，支持错误链和可重试标记 + */ +export interface RRError { + /** 错误码 */ + code: RRErrorCode; + /** 错误消息 */ + message: string; + /** 附加数据 */ + data?: JsonValue; + /** 是否可重试 */ + retryable?: boolean; + /** 原因错误（错误链） */ + cause?: RRError; +} + +/** + * 创建 RRError 的工厂函数 + */ +export function createRRError( + code: RRErrorCode, + message: string, + options?: { data?: JsonValue; retryable?: boolean; cause?: RRError }, +): RRError { + return { + code, + message, + ...(options?.data !== undefined && { data: options.data }), + ...(options?.retryable !== undefined && { retryable: options.retryable }), + ...(options?.cause !== undefined && { cause: options.cause }), + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/events.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/events.ts new file mode 100644 index 00000000..8f87137c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/events.ts @@ -0,0 +1,185 @@ +/** + * @fileoverview 事件类型定义 + * @description 定义 Record-Replay V3 中的运行事件和状态 + */ + +import type { JsonObject, JsonValue, UnixMillis } from './json'; +import type { EdgeLabel, FlowId, NodeId, RunId } from './ids'; +import type { RRError } from './errors'; +import type { TriggerFireContext } from './triggers'; + +/** 取消订阅函数类型 */ +export type Unsubscribe = () => void; + +/** Run 状态 */ +export type RunStatus = 'queued' | 'running' | 'paused' | 'succeeded' | 'failed' | 'canceled'; + +/** + * 事件基础接口 + * @description 所有事件的公共字段 + */ +export interface EventBase { + /** 所属 Run ID */ + runId: RunId; + /** 事件时间戳 */ + ts: UnixMillis; + /** 单调递增序列号 */ + seq: number; +} + +/** + * 暂停原因 + * @description 描述 Run 暂停的原因 + */ +export type PauseReason = + | { kind: 'breakpoint'; nodeId: NodeId } + | { kind: 'step'; nodeId: NodeId } + | { kind: 'command' } + | { kind: 'policy'; nodeId: NodeId; reason: string }; + +/** 恢复原因 */ +export type RecoveryReason = 'sw_restart' | 'lease_expired'; + +/** + * Run 事件联合类型 + * @description 所有可能的运行时事件 + */ +export type RunEvent = + // ===== Run 生命周期事件 ===== + | (EventBase & { type: 'run.queued'; flowId: FlowId }) + | (EventBase & { type: 'run.started'; flowId: FlowId; tabId: number }) + | (EventBase & { type: 'run.paused'; reason: PauseReason; nodeId?: NodeId }) + | (EventBase & { type: 'run.resumed' }) + | (EventBase & { + type: 'run.recovered'; + /** 恢复原因 */ + reason: RecoveryReason; + /** 恢复前状态 */ + fromStatus: 'running' | 'paused'; + /** 恢复后状态 */ + toStatus: 'queued'; + /** 原 ownerId（用于审计） */ + prevOwnerId?: string; + }) + | (EventBase & { type: 'run.canceled'; reason?: string }) + | (EventBase & { type: 'run.succeeded'; tookMs: number; outputs?: JsonObject }) + | (EventBase & { type: 'run.failed'; error: RRError; nodeId?: NodeId }) + + // ===== Node 执行事件 ===== + | (EventBase & { type: 'node.queued'; nodeId: NodeId }) + | (EventBase & { type: 'node.started'; nodeId: NodeId; attempt: number }) + | (EventBase & { + type: 'node.succeeded'; + nodeId: NodeId; + tookMs: number; + next?: { kind: 'edgeLabel'; label: EdgeLabel } | { kind: 'end' }; + }) + | (EventBase & { + type: 'node.failed'; + nodeId: NodeId; + attempt: number; + error: RRError; + decision: 'retry' | 'continue' | 'stop' | 'goto'; + }) + | (EventBase & { type: 'node.skipped'; nodeId: NodeId; reason: 'disabled' | 'unreachable' }) + + // ===== 变量和日志事件 ===== + | (EventBase & { + type: 'vars.patch'; + patch: Array<{ op: 'set' | 'delete'; name: string; value?: JsonValue }>; + }) + | (EventBase & { type: 'artifact.screenshot'; nodeId: NodeId; data: string; savedAs?: string }) + | (EventBase & { + type: 'log'; + level: 'debug' | 'info' | 'warn' | 'error'; + message: string; + data?: JsonValue; + }); + +/** Run 事件类型（从联合类型提取） */ +export type RunEventType = RunEvent['type']; + +/** + * 分布式 Omit（保留联合类型） + */ +type DistributiveOmit = T extends unknown ? Omit : never; + +/** + * Run 事件输入类型 + * @description seq 必须由 storage 层原子分配（通过 RunRecordV3.nextSeq） + * ts 可选，默认为 Date.now() + */ +export type RunEventInput = DistributiveOmit & { + ts?: UnixMillis; +}; + +/** Run Schema 版本 */ +export const RUN_SCHEMA_VERSION = 3 as const; + +/** + * Run 记录 V3 + * @description 存储在 IndexedDB 中的 Run 摘要记录 + */ +export interface RunRecordV3 { + /** Schema 版本 */ + schemaVersion: typeof RUN_SCHEMA_VERSION; + /** Run 唯一标识符 */ + id: RunId; + /** 关联的 Flow ID */ + flowId: FlowId; + + /** 当前状态 */ + status: RunStatus; + /** 创建时间 */ + createdAt: UnixMillis; + /** 最后更新时间 */ + updatedAt: UnixMillis; + + /** 开始执行时间 */ + startedAt?: UnixMillis; + /** 结束时间 */ + finishedAt?: UnixMillis; + /** 总耗时（毫秒） */ + tookMs?: number; + + /** 绑定的 Tab ID（每 Run 独占） */ + tabId?: number; + /** 起始节点 ID（如果不是默认入口） */ + startNodeId?: NodeId; + /** 当前执行节点 ID */ + currentNodeId?: NodeId; + + /** 当前尝试次数 */ + attempt: number; + /** 最大尝试次数 */ + maxAttempts: number; + + /** 运行参数 */ + args?: JsonObject; + /** 触发器上下文 */ + trigger?: TriggerFireContext; + /** 调试配置 */ + debug?: { breakpoints?: NodeId[]; pauseOnStart?: boolean }; + + /** 错误信息（如果失败） */ + error?: RRError; + /** 输出结果 */ + outputs?: JsonObject; + + /** 下一个事件序列号（缓存字段） */ + nextSeq: number; +} + +/** + * 判断 Run 是否已终止 + */ +export function isTerminalStatus(status: RunStatus): boolean { + return status === 'succeeded' || status === 'failed' || status === 'canceled'; +} + +/** + * 判断 Run 是否正在执行 + */ +export function isActiveStatus(status: RunStatus): boolean { + return status === 'running' || status === 'paused'; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/flow.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/flow.ts new file mode 100644 index 00000000..9a236c85 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/flow.ts @@ -0,0 +1,119 @@ +/** + * @fileoverview Flow 类型定义 + * @description 定义 Record-Replay V3 中的 Flow IR（中间表示） + */ + +import type { ISODateTimeString, JsonObject } from './json'; +import type { EdgeId, EdgeLabel, FlowId, NodeId } from './ids'; +import type { FlowPolicy, NodePolicy } from './policy'; +import type { VariableDefinition } from './variables'; + +/** Flow Schema 版本 */ +export const FLOW_SCHEMA_VERSION = 3 as const; + +/** + * Edge V3 + * @description DAG 中的边，连接两个节点 + */ +export interface EdgeV3 { + /** Edge 唯一标识符 */ + id: EdgeId; + /** 源节点 ID */ + from: NodeId; + /** 目标节点 ID */ + to: NodeId; + /** 边标签（用于条件分支和错误处理） */ + label?: EdgeLabel; +} + +/** 节点类型（可扩展） */ +export type NodeKind = string; + +/** + * Node V3 + * @description DAG 中的节点，代表一个可执行的操作 + */ +export interface NodeV3 { + /** Node 唯一标识符 */ + id: NodeId; + /** 节点类型 */ + kind: NodeKind; + /** 节点名称（用于显示） */ + name?: string; + /** 是否禁用 */ + disabled?: boolean; + /** 节点级策略 */ + policy?: NodePolicy; + /** 节点配置（类型由 kind 决定） */ + config: JsonObject; + /** UI 布局信息 */ + ui?: { x: number; y: number }; +} + +/** + * Flow 元数据绑定 + * @description 定义 Flow 与特定域名/路径/URL 的关联 + */ +export interface FlowBinding { + kind: 'domain' | 'path' | 'url'; + value: string; +} + +/** + * Flow V3 + * @description 完整的 Flow 定义，包含节点、边和配置 + */ +export interface FlowV3 { + /** Schema 版本 */ + schemaVersion: typeof FLOW_SCHEMA_VERSION; + /** Flow 唯一标识符 */ + id: FlowId; + /** Flow 名称 */ + name: string; + /** Flow 描述 */ + description?: string; + /** 创建时间 */ + createdAt: ISODateTimeString; + /** 更新时间 */ + updatedAt: ISODateTimeString; + + /** 入口节点 ID（显式指定，不依赖入度推断） */ + entryNodeId: NodeId; + /** 节点列表 */ + nodes: NodeV3[]; + /** 边列表 */ + edges: EdgeV3[]; + + /** 变量定义 */ + variables?: VariableDefinition[]; + /** Flow 级策略 */ + policy?: FlowPolicy; + /** 元数据 */ + meta?: { + /** 标签 */ + tags?: string[]; + /** 绑定规则 */ + bindings?: FlowBinding[]; + }; +} + +/** + * 根据 ID 查找节点 + */ +export function findNodeById(flow: FlowV3, nodeId: NodeId): NodeV3 | undefined { + return flow.nodes.find((n) => n.id === nodeId); +} + +/** + * 查找从指定节点出发的所有边 + */ +export function findEdgesFrom(flow: FlowV3, nodeId: NodeId): EdgeV3[] { + return flow.edges.filter((e) => e.from === nodeId); +} + +/** + * 查找指向指定节点的所有边 + */ +export function findEdgesTo(flow: FlowV3, nodeId: NodeId): EdgeV3[] { + return flow.edges.filter((e) => e.to === nodeId); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/ids.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/ids.ts new file mode 100644 index 00000000..b3f98dca --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/ids.ts @@ -0,0 +1,37 @@ +/** + * @fileoverview ID 类型定义 + * @description 定义 Record-Replay V3 中使用的各种 ID 类型 + */ + +/** Flow 唯一标识符 */ +export type FlowId = string; + +/** Node 唯一标识符 */ +export type NodeId = string; + +/** Edge 唯一标识符 */ +export type EdgeId = string; + +/** Run 唯一标识符 */ +export type RunId = string; + +/** Trigger 唯一标识符 */ +export type TriggerId = string; + +/** Edge 标签类型 */ +export type EdgeLabel = string; + +/** 预定义的 Edge 标签常量 */ +export const EDGE_LABELS = { + /** 默认边 */ + DEFAULT: 'default', + /** 错误处理边 */ + ON_ERROR: 'onError', + /** 条件为真时的边 */ + TRUE: 'true', + /** 条件为假时的边 */ + FALSE: 'false', +} as const; + +/** Edge 标签类型（从常量推导） */ +export type EdgeLabelValue = (typeof EDGE_LABELS)[keyof typeof EDGE_LABELS]; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/index.ts new file mode 100644 index 00000000..3010d101 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/index.ts @@ -0,0 +1,31 @@ +/** + * @fileoverview Domain 层导出入口 + * @description 导出所有 Domain 类型定义 + */ + +// JSON 基础类型 +export * from './json'; + +// ID 类型 +export * from './ids'; + +// 错误类型 +export * from './errors'; + +// 策略类型 +export * from './policy'; + +// 变量类型 +export * from './variables'; + +// Flow 类型 +export * from './flow'; + +// 事件类型 +export * from './events'; + +// 调试器类型 +export * from './debug'; + +// 触发器类型 +export * from './triggers'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/json.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/json.ts new file mode 100644 index 00000000..d723583d --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/json.ts @@ -0,0 +1,24 @@ +/** + * @fileoverview JSON 基础类型定义 + * @description 定义 Record-Replay V3 中使用的 JSON 相关类型 + */ + +/** JSON 原始类型 */ +export type JsonPrimitive = string | number | boolean | null; + +/** JSON 对象类型 */ +export interface JsonObject { + [key: string]: JsonValue; +} + +/** JSON 数组类型 */ +export type JsonArray = JsonValue[]; + +/** 任意 JSON 值类型 */ +export type JsonValue = JsonPrimitive | JsonObject | JsonArray; + +/** ISO 8601 日期时间字符串 */ +export type ISODateTimeString = string; + +/** Unix 毫秒时间戳 */ +export type UnixMillis = number; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/policy.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/policy.ts new file mode 100644 index 00000000..e4f90c0c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/policy.ts @@ -0,0 +1,115 @@ +/** + * @fileoverview 策略类型定义 + * @description 定义 Record-Replay V3 中使用的超时、重试、错误处理和工件策略 + */ + +import type { EdgeLabel, NodeId } from './ids'; +import type { RRErrorCode } from './errors'; +import type { UnixMillis } from './json'; + +/** + * 超时策略 + * @description 定义操作的超时时间和作用范围 + */ +export interface TimeoutPolicy { + /** 超时时间（毫秒） */ + ms: UnixMillis; + /** 超时范围：attempt=每次尝试, node=整个节点执行 */ + scope?: 'attempt' | 'node'; +} + +/** + * 重试策略 + * @description 定义失败后的重试行为 + */ +export interface RetryPolicy { + /** 最大重试次数 */ + retries: number; + /** 重试间隔（毫秒） */ + intervalMs: UnixMillis; + /** 退避策略：none=固定间隔, exp=指数退避, linear=线性增长 */ + backoff?: 'none' | 'exp' | 'linear'; + /** 最大重试间隔（毫秒） */ + maxIntervalMs?: UnixMillis; + /** 抖动策略：none=无抖动, full=完全随机 */ + jitter?: 'none' | 'full'; + /** 仅在这些错误码时重试 */ + retryOn?: ReadonlyArray; +} + +/** + * 错误处理策略 + * @description 定义节点执行失败后的处理方式 + */ +export type OnErrorPolicy = + | { kind: 'stop' } + | { kind: 'continue'; as?: 'warning' | 'error' } + | { + kind: 'goto'; + target: { kind: 'edgeLabel'; label: EdgeLabel } | { kind: 'node'; nodeId: NodeId }; + } + | { kind: 'retry'; override?: Partial }; + +/** + * 工件策略 + * @description 定义截图和日志收集的行为 + */ +export interface ArtifactPolicy { + /** 截图策略：never=从不, onFailure=失败时, always=总是 */ + screenshot?: 'never' | 'onFailure' | 'always'; + /** 截图保存路径模板 */ + saveScreenshotAs?: string; + /** 是否包含控制台日志 */ + includeConsole?: boolean; + /** 是否包含网络请求 */ + includeNetwork?: boolean; +} + +/** + * 节点级策略 + * @description 单个节点的执行策略配置 + */ +export interface NodePolicy { + /** 超时策略 */ + timeout?: TimeoutPolicy; + /** 重试策略 */ + retry?: RetryPolicy; + /** 错误处理策略 */ + onError?: OnErrorPolicy; + /** 工件策略 */ + artifacts?: ArtifactPolicy; +} + +/** + * Flow 级策略 + * @description 整个 Flow 的执行策略配置 + */ +export interface FlowPolicy { + /** 默认节点策略 */ + defaultNodePolicy?: NodePolicy; + /** 不支持节点的处理策略 */ + unsupportedNodePolicy?: OnErrorPolicy; + /** Run 总超时时间（毫秒） */ + runTimeoutMs?: UnixMillis; +} + +/** + * 合并节点策略 + * @description 将 Flow 级默认策略与节点级策略合并 + */ +export function mergeNodePolicy( + flowDefault: NodePolicy | undefined, + nodePolicy: NodePolicy | undefined, +): NodePolicy { + if (!flowDefault) return nodePolicy ?? {}; + if (!nodePolicy) return flowDefault; + + return { + timeout: nodePolicy.timeout ?? flowDefault.timeout, + retry: nodePolicy.retry ?? flowDefault.retry, + onError: nodePolicy.onError ?? flowDefault.onError, + artifacts: nodePolicy.artifacts + ? { ...flowDefault.artifacts, ...nodePolicy.artifacts } + : flowDefault.artifacts, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/triggers.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/triggers.ts new file mode 100644 index 00000000..37f2c1b2 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/triggers.ts @@ -0,0 +1,143 @@ +/** + * @fileoverview 触发器类型定义 + * @description 定义 Record-Replay V3 中的触发器规范 + */ + +import type { JsonObject, UnixMillis } from './json'; +import type { FlowId, TriggerId } from './ids'; + +/** 触发器类型 */ +export type TriggerKind = + | 'manual' + | 'url' + | 'cron' + | 'interval' + | 'once' + | 'command' + | 'contextMenu' + | 'dom'; + +/** + * 触发器基础接口 + */ +export interface TriggerSpecBase { + /** 触发器 ID */ + id: TriggerId; + /** 触发器类型 */ + kind: TriggerKind; + /** 是否启用 */ + enabled: boolean; + /** 关联的 Flow ID */ + flowId: FlowId; + /** 传递给 Flow 的参数 */ + args?: JsonObject; +} + +/** + * URL 匹配规则 + */ +export interface UrlMatchRule { + kind: 'url' | 'domain' | 'path'; + value: string; +} + +/** + * 触发器规范联合类型 + */ +export type TriggerSpec = + // 手动触发 + | (TriggerSpecBase & { kind: 'manual' }) + + // URL 触发 + | (TriggerSpecBase & { + kind: 'url'; + match: UrlMatchRule[]; + }) + + // Cron 定时触发 + | (TriggerSpecBase & { + kind: 'cron'; + cron: string; + timezone?: string; + }) + + // Interval 定时触发（固定间隔重复） + | (TriggerSpecBase & { + kind: 'interval'; + /** 间隔分钟数，最小为 1 */ + periodMinutes: number; + }) + + // Once 定时触发（指定时间触发一次后自动禁用） + | (TriggerSpecBase & { + kind: 'once'; + /** 触发时间戳 (Unix milliseconds) */ + whenMs: UnixMillis; + }) + + // 快捷键触发 + | (TriggerSpecBase & { + kind: 'command'; + commandKey: string; + }) + + // 右键菜单触发 + | (TriggerSpecBase & { + kind: 'contextMenu'; + title: string; + contexts?: ReadonlyArray; + }) + + // DOM 元素出现触发 + | (TriggerSpecBase & { + kind: 'dom'; + selector: string; + appear?: boolean; + once?: boolean; + debounceMs?: UnixMillis; + }); + +/** + * 触发器触发上下文 + * @description 描述触发器被触发时的上下文信息 + */ +export interface TriggerFireContext { + /** 触发器 ID */ + triggerId: TriggerId; + /** 触发器类型 */ + kind: TriggerKind; + /** 触发时间 */ + firedAt: UnixMillis; + /** 来源 Tab ID */ + sourceTabId?: number; + /** 来源 URL */ + sourceUrl?: string; +} + +/** + * 根据触发器类型获取类型化的触发器规范 + */ +export type TriggerSpecByKind = Extract; + +/** + * 判断触发器是否启用 + */ +export function isTriggerEnabled(trigger: TriggerSpec): boolean { + return trigger.enabled; +} + +/** + * 创建触发器触发上下文 + */ +export function createTriggerFireContext( + trigger: TriggerSpec, + options?: { sourceTabId?: number; sourceUrl?: string }, +): TriggerFireContext { + return { + triggerId: trigger.id, + kind: trigger.kind, + firedAt: Date.now(), + sourceTabId: options?.sourceTabId, + sourceUrl: options?.sourceUrl, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/domain/variables.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/variables.ts new file mode 100644 index 00000000..7651703d --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/domain/variables.ts @@ -0,0 +1,98 @@ +/** + * @fileoverview 变量类型定义 + * @description 定义 Record-Replay V3 中使用的变量指针和持久化变量 + */ + +import type { JsonValue, UnixMillis } from './json'; + +/** 变量名称 */ +export type VariableName = string; + +/** 持久化变量名称（以 $ 开头） */ +export type PersistentVariableName = `$${string}`; + +/** 变量作用域 */ +export type VariableScope = 'run' | 'flow' | 'persistent'; + +/** + * 变量指针 + * @description 指向变量的引用，支持 JSON path 访问 + */ +export interface VariablePointer { + /** 变量作用域 */ + scope: VariableScope; + /** 变量名称 */ + name: VariableName; + /** JSON path（用于访问嵌套属性） */ + path?: ReadonlyArray; +} + +/** + * 变量定义 + * @description Flow 中声明的变量 + */ +export interface VariableDefinition { + /** 变量名称 */ + name: VariableName; + /** 显示标签 */ + label?: string; + /** 描述 */ + description?: string; + /** 是否敏感（不显示/导出） */ + sensitive?: boolean; + /** 是否必需 */ + required?: boolean; + /** 默认值 */ + default?: JsonValue; + /** 作用域（不含 persistent，persistent 通过 $ 前缀判断） */ + scope?: Exclude; +} + +/** + * 持久化变量记录 + * @description 存储在 IndexedDB 中的持久化变量 + */ +export interface PersistentVarRecord { + /** 变量键（以 $ 开头） */ + key: PersistentVariableName; + /** 变量值 */ + value: JsonValue; + /** 最后更新时间 */ + updatedAt: UnixMillis; + /** 版本号（单调递增，用于 LWW 和调试） */ + version: number; +} + +/** + * 判断变量名是否为持久化变量 + */ +export function isPersistentVariable(name: string): name is PersistentVariableName { + return name.startsWith('$'); +} + +/** + * 解析变量指针字符串 + * @example "$user.name" -> { scope: 'persistent', name: '$user', path: ['name'] } + */ +export function parseVariablePointer(ref: string): VariablePointer | null { + if (!ref) return null; + + const parts = ref.split('.'); + const name = parts[0]; + const path = parts.slice(1); + + if (isPersistentVariable(name)) { + return { + scope: 'persistent', + name, + path: path.length > 0 ? path : undefined, + }; + } + + // 默认为 run 作用域 + return { + scope: 'run', + name, + path: path.length > 0 ? path : undefined, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/index.ts new file mode 100644 index 00000000..0d3a6792 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/index.ts @@ -0,0 +1,27 @@ +/** + * @fileoverview Engine 层导出入口 + */ + +// Kernel +export * from './kernel'; + +// Queue +export * from './queue'; + +// Plugins +export * from './plugins'; + +// Transport +export * from './transport'; + +// Keepalive +export * from './keepalive'; + +// Recovery +export * from './recovery'; + +// Triggers +export * from './triggers'; + +// Storage Port +export * from './storage'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/index.ts new file mode 100644 index 00000000..4f28d18a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/index.ts @@ -0,0 +1,5 @@ +/** + * @fileoverview Keepalive 模块导出入口 + */ + +export * from './offscreen-keepalive'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/offscreen-keepalive.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/offscreen-keepalive.ts new file mode 100644 index 00000000..3f50220b --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/keepalive/offscreen-keepalive.ts @@ -0,0 +1,451 @@ +/** + * @fileoverview Offscreen Keepalive Controller + * @description Keeps the MV3 service worker alive using an Offscreen Document + Port heartbeat. + * + * Architecture: + * - Background (this module) listens for an Offscreen Port connection. + * - Offscreen connects and sends heartbeat pings. + * - Background replies with pong and controls the heartbeat via `start`/`stop`. + * + * Contract: + * - When at least one keepalive reference is held, keepalive must be running. + * - When the reference count drops to zero, keepalive must fully stop (no ping loop, no Port, no reconnect). + */ + +import { offscreenManager } from '@/utils/offscreen-manager'; +import { + RR_V3_KEEPALIVE_PORT_NAME, + type KeepaliveMessage, +} from '@/common/rr-v3-keepalive-protocol'; + +// ==================== Runtime Control Protocol ==================== + +const KEEPALIVE_CONTROL_MESSAGE_TYPE = 'rr_v3_keepalive.control' as const; + +type KeepaliveControlCommand = 'start' | 'stop'; + +interface KeepaliveControlMessage { + type: typeof KEEPALIVE_CONTROL_MESSAGE_TYPE; + command: KeepaliveControlCommand; +} + +// ==================== Types ==================== + +/** + * Keepalive controller interface. + * @description Manages Service Worker keepalive state. + */ +export interface KeepaliveController { + /** + * Acquire (increment reference count). + * @param tag Tag used for debugging. + * @returns Release function. + */ + acquire(tag: string): () => void; + + /** Whether any keepalive reference is currently held. */ + isActive(): boolean; + + /** Current reference count. */ + getRefCount(): number; + + /** Release all references (primarily for testing). */ + releaseAll(): void; +} + +/** + * Offscreen keepalive options. + */ +export interface OffscreenKeepaliveOptions { + /** Logger. */ + logger?: Pick; +} + +// ==================== Factory ==================== + +/** + * Create an Offscreen keepalive controller. + * @description Reuses the global OffscreenManager to avoid creating multiple Offscreen Documents concurrently. + */ +export function createOffscreenKeepaliveController( + options: OffscreenKeepaliveOptions = {}, +): KeepaliveController { + return new OffscreenKeepaliveControllerImpl(options); +} + +/** + * Create a NotImplemented KeepaliveController. + * @description Placeholder implementation. + */ +export function createNotImplementedKeepaliveController(): KeepaliveController { + return { + acquire: () => { + console.warn('[KeepaliveController] Not implemented, returning no-op release'); + return () => {}; + }, + isActive: () => false, + getRefCount: () => 0, + releaseAll: () => {}, + }; +} + +// ==================== Implementation ==================== + +/** + * Offscreen keepalive controller implementation. + */ +class OffscreenKeepaliveControllerImpl implements KeepaliveController { + private readonly refs = new Map(); + private totalRefs = 0; + + private offscreenPort: chrome.runtime.Port | null = null; + private connectionListenerRegistered = false; + + // Used to serialize async operations to avoid races. + private syncPromise: Promise = Promise.resolve(); + + private readonly logger: Pick; + + constructor(options: OffscreenKeepaliveOptions) { + this.logger = options.logger ?? console; + // Register listener eagerly to avoid missing Offscreen connect events. + // This prevents race conditions where Offscreen connects before we start listening. + this.ensureConnectionListener(); + } + + acquire(tag: string): () => void { + this.totalRefs += 1; + + const count = this.refs.get(tag) ?? 0; + this.refs.set(tag, count + 1); + + this.logger.debug(`[OffscreenKeepalive] acquire(${tag}), totalRefs=${this.totalRefs}`); + + // Start keepalive when the first reference is acquired. + if (this.totalRefs === 1) { + this.scheduleSync(); + } + + let released = false; + return () => { + if (released) return; + released = true; + + if (this.totalRefs > 0) { + this.totalRefs -= 1; + } + + const currentCount = this.refs.get(tag) ?? 0; + if (currentCount <= 1) { + this.refs.delete(tag); + } else { + this.refs.set(tag, currentCount - 1); + } + + this.logger.debug(`[OffscreenKeepalive] release(${tag}), totalRefs=${this.totalRefs}`); + + // Stop keepalive when the reference count drops to zero. + if (this.totalRefs === 0) { + this.scheduleSync(); + } + }; + } + + isActive(): boolean { + return this.totalRefs > 0; + } + + getRefCount(): number { + return this.totalRefs; + } + + releaseAll(): void { + if (this.totalRefs === 0) return; + + this.logger.debug('[OffscreenKeepalive] releaseAll()'); + this.refs.clear(); + this.totalRefs = 0; + this.scheduleSync(); + } + + /** + * Get the current reference counts grouped by tag. + * @description Useful for debugging. + */ + getRefsByTag(): Record { + return Object.fromEntries(this.refs); + } + + // ==================== Private Methods ==================== + + /** + * Schedule a sync operation. + * @description Serializes async operations to avoid races. + */ + private scheduleSync(): void { + this.syncPromise = this.syncPromise + .catch(() => { + // Ignore previous operation errors. + }) + .then(() => this.syncOnce()) + .catch((e) => { + this.logger.warn('[OffscreenKeepalive] sync failed:', e); + }); + } + + /** + * Perform a single sync step based on the current ref count. + */ + private async syncOnce(): Promise { + if (this.totalRefs > 0) { + // Ensure listener exists before Offscreen connects (race prevention). + this.ensureConnectionListener(); + + // Ensure the Offscreen document exists. + await offscreenManager.ensureOffscreenDocument(); + + // Re-check after await: state may have changed while we were creating the document. + if (this.totalRefs === 0) { + await this.teardown(); + return; + } + + // Send start command via runtime message (works even if Port is not connected). + await this.sendRuntimeControl('start'); + // Also send via Port if connected. + this.sendStartCommand(); + } else { + // Send stop via Port first (if connected). + this.sendStopCommand(); + // Then send via runtime message to ensure Offscreen stops. + await this.sendRuntimeControl('stop'); + await this.teardown(); + } + } + + /** + * Clean up resources. + */ + private async teardown(): Promise { + this.disconnectPort(); + // Note: We do not close the Offscreen Document here because it may be used by other modules. + // If Offscreen Document lifecycle needs ref-counting, it should be implemented in OffscreenManager. + } + + /** + * Ensure the Port connection listener is registered. + */ + private ensureConnectionListener(): void { + if (this.connectionListenerRegistered) return; + + if (typeof chrome === 'undefined' || !chrome.runtime?.onConnect) { + this.logger.warn('[OffscreenKeepalive] chrome.runtime.onConnect not available'); + return; + } + + chrome.runtime.onConnect.addListener(this.handleConnect); + this.connectionListenerRegistered = true; + + this.logger.debug('[OffscreenKeepalive] Connection listener registered'); + } + + /** + * Handle Port connections from Offscreen. + */ + private handleConnect = (port: chrome.runtime.Port): void => { + if (port.name !== RR_V3_KEEPALIVE_PORT_NAME) return; + + this.logger.debug('[OffscreenKeepalive] Offscreen connected'); + + // Store Port reference. + this.offscreenPort = port; + + // Listen to messages. + port.onMessage.addListener(this.handlePortMessage); + + // Listen to disconnect. + port.onDisconnect.addListener(() => { + this.logger.debug('[OffscreenKeepalive] Offscreen disconnected'); + if (this.offscreenPort === port) { + this.offscreenPort = null; + } + }); + + // If active, send the start command. + if (this.totalRefs > 0) { + this.sendStartCommand(); + } + }; + + /** + * Handle messages from Offscreen. + */ + private handlePortMessage = (msg: unknown): void => { + const m = msg as Partial | null; + if (!m || typeof m !== 'object') return; + + if (m.type === 'keepalive.ping') { + this.logger.debug('[OffscreenKeepalive] Received ping, sending pong'); + this.sendPong(); + } + }; + + /** + * Disconnect the Port. + */ + private disconnectPort(): void { + if (!this.offscreenPort) return; + + const port = this.offscreenPort; + this.offscreenPort = null; + + try { + port.disconnect(); + } catch { + // Port may already be disconnected. + } + + this.logger.debug('[OffscreenKeepalive] Port disconnected'); + } + + /** + * Send the start command to Offscreen (Port channel). + */ + private sendStartCommand(): void { + if (!this.offscreenPort) return; + + const msg: KeepaliveMessage = { + type: 'keepalive.start', + timestamp: Date.now(), + }; + + try { + this.offscreenPort.postMessage(msg); + this.logger.debug('[OffscreenKeepalive] Sent start command via Port'); + } catch (e) { + this.logger.warn('[OffscreenKeepalive] Failed to send start command:', e); + } + } + + /** + * Send the stop command to Offscreen (Port channel). + */ + private sendStopCommand(): void { + if (!this.offscreenPort) return; + + const msg: KeepaliveMessage = { + type: 'keepalive.stop', + timestamp: Date.now(), + }; + + try { + this.offscreenPort.postMessage(msg); + this.logger.debug('[OffscreenKeepalive] Sent stop command via Port'); + } catch (e) { + this.logger.warn('[OffscreenKeepalive] Failed to send stop command:', e); + } + } + + /** + * Send a pong response. + */ + private sendPong(): void { + if (!this.offscreenPort) return; + + const msg: KeepaliveMessage = { + type: 'keepalive.pong', + timestamp: Date.now(), + }; + + try { + this.offscreenPort.postMessage(msg); + } catch (e) { + this.logger.warn('[OffscreenKeepalive] Failed to send pong:', e); + } + } + + /** + * Send a runtime control command to Offscreen. + * This is the control plane used to start/stop keepalive even when the Port is not connected. + */ + private async sendRuntimeControl(command: KeepaliveControlCommand): Promise { + if (typeof chrome === 'undefined' || !chrome.runtime?.sendMessage) { + this.logger.warn('[OffscreenKeepalive] chrome.runtime.sendMessage not available'); + return; + } + + const msg: KeepaliveControlMessage = { + type: KEEPALIVE_CONTROL_MESSAGE_TYPE, + command, + }; + + // Retry with delays for start command (Offscreen document may not be ready yet). + const delaysMs = command === 'start' ? [0, 50, 200] : [0]; + for (const delayMs of delaysMs) { + if (delayMs > 0) { + await new Promise((resolve) => setTimeout(resolve, delayMs)); + } + try { + await chrome.runtime.sendMessage(msg); + this.logger.debug(`[OffscreenKeepalive] Sent runtime ${command} command`); + return; + } catch { + // Best-effort: Offscreen document may not be ready yet. + } + } + + this.logger.warn(`[OffscreenKeepalive] Failed to send runtime ${command} command`); + } +} + +// ==================== Test Utilities ==================== + +/** + * In-memory keepalive controller. + * @description For tests only: tracks reference counts without using Offscreen. + */ +export class InMemoryKeepaliveController implements KeepaliveController { + private refs = new Map(); + + acquire(tag: string): () => void { + const count = this.refs.get(tag) ?? 0; + this.refs.set(tag, count + 1); + + let released = false; + return () => { + if (released) return; + released = true; + + const currentCount = this.refs.get(tag) ?? 0; + if (currentCount <= 1) { + this.refs.delete(tag); + } else { + this.refs.set(tag, currentCount - 1); + } + }; + } + + isActive(): boolean { + return this.refs.size > 0; + } + + getRefCount(): number { + let total = 0; + for (const count of this.refs.values()) { + total += count; + } + return total; + } + + releaseAll(): void { + this.refs.clear(); + } + + /** + * Get the current reference counts grouped by tag. + * @description Useful for debugging. + */ + getRefsByTag(): Record { + return Object.fromEntries(this.refs); + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/artifacts.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/artifacts.ts new file mode 100644 index 00000000..6cadb734 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/artifacts.ts @@ -0,0 +1,193 @@ +/** + * @fileoverview 工件（Artifacts）接口 + * @description 定义截图等工件的获取和存储接口 + */ + +import type { NodeId, RunId } from '../../domain/ids'; +import type { RRError } from '../../domain/errors'; +import { RR_ERROR_CODES, createRRError } from '../../domain/errors'; + +/** + * 截图结果 + */ +export type ScreenshotResult = { ok: true; base64: string } | { ok: false; error: RRError }; + +/** + * 工件服务接口 + * @description 提供工件获取和存储功能 + */ +export interface ArtifactService { + /** + * 截取页面截图 + * @param tabId Tab ID + * @param options 截图选项 + */ + screenshot( + tabId: number, + options?: { + format?: 'png' | 'jpeg'; + quality?: number; + }, + ): Promise; + + /** + * 保存截图 + * @param runId Run ID + * @param nodeId Node ID + * @param base64 截图数据 + * @param filename 文件名（可选） + */ + saveScreenshot( + runId: RunId, + nodeId: NodeId, + base64: string, + filename?: string, + ): Promise<{ savedAs: string } | { error: RRError }>; +} + +/** + * 创建 NotImplemented 的 ArtifactService + * @description Phase 0-1 占位实现 + */ +export function createNotImplementedArtifactService(): ArtifactService { + return { + screenshot: async () => ({ + ok: false, + error: createRRError(RR_ERROR_CODES.INTERNAL, 'ArtifactService.screenshot not implemented'), + }), + saveScreenshot: async () => ({ + error: createRRError( + RR_ERROR_CODES.INTERNAL, + 'ArtifactService.saveScreenshot not implemented', + ), + }), + }; +} + +/** + * 创建基于 chrome.tabs.captureVisibleTab 的 ArtifactService + * @description 使用 Chrome API 截取可见标签页 + */ +export function createChromeArtifactService(): ArtifactService { + // In-memory storage for screenshots (could be replaced with IndexedDB) + const screenshotStore = new Map(); + + return { + screenshot: async (tabId, options) => { + try { + // Get the window ID for the tab + const tab = await chrome.tabs.get(tabId); + if (!tab.windowId) { + return { + ok: false, + error: createRRError(RR_ERROR_CODES.INTERNAL, `Tab ${tabId} has no window`), + }; + } + + // Capture the visible tab + const format = options?.format ?? 'png'; + const quality = options?.quality ?? 100; + + const dataUrl = await chrome.tabs.captureVisibleTab(tab.windowId, { + format, + quality: format === 'jpeg' ? quality : undefined, + }); + + // Extract base64 from data URL + const base64Match = dataUrl.match(/^data:image\/\w+;base64,(.+)$/); + if (!base64Match) { + return { + ok: false, + error: createRRError(RR_ERROR_CODES.INTERNAL, 'Invalid screenshot data URL'), + }; + } + + return { ok: true, base64: base64Match[1] }; + } catch (e) { + const message = e instanceof Error ? e.message : String(e); + return { + ok: false, + error: createRRError(RR_ERROR_CODES.INTERNAL, `Screenshot failed: ${message}`), + }; + } + }, + + saveScreenshot: async (runId, nodeId, base64, filename) => { + try { + // Generate filename if not provided + const savedAs = filename ?? `${runId}_${nodeId}_${Date.now()}.png`; + const key = `${runId}/${savedAs}`; + + // Store in memory (in production, this would go to IndexedDB or cloud storage) + screenshotStore.set(key, base64); + + return { savedAs }; + } catch (e) { + const message = e instanceof Error ? e.message : String(e); + return { + error: createRRError(RR_ERROR_CODES.INTERNAL, `Save screenshot failed: ${message}`), + }; + } + }, + }; +} + +/** + * 工件策略执行器 + * @description 根据策略配置决定是否获取工件 + */ +export interface ArtifactPolicyExecutor { + /** + * 执行截图策略 + * @param policy 截图策略 + * @param context 上下文 + */ + executeScreenshotPolicy( + policy: 'never' | 'onFailure' | 'always', + context: { + tabId: number; + runId: RunId; + nodeId: NodeId; + failed: boolean; + saveAs?: string; + }, + ): Promise<{ captured: boolean; savedAs?: string; error?: RRError }>; +} + +/** + * 创建默认的工件策略执行器 + */ +export function createArtifactPolicyExecutor(service: ArtifactService): ArtifactPolicyExecutor { + return { + executeScreenshotPolicy: async (policy, context) => { + // 根据策略决定是否截图 + const shouldCapture = policy === 'always' || (policy === 'onFailure' && context.failed); + + if (!shouldCapture) { + return { captured: false }; + } + + // 截图 + const result = await service.screenshot(context.tabId); + if (!result.ok) { + return { captured: false, error: result.error }; + } + + // 保存（如果指定了文件名） + if (context.saveAs) { + const saveResult = await service.saveScreenshot( + context.runId, + context.nodeId, + result.base64, + context.saveAs, + ); + if ('error' in saveResult) { + return { captured: true, error: saveResult.error }; + } + return { captured: true, savedAs: saveResult.savedAs }; + } + + return { captured: true }; + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/breakpoints.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/breakpoints.ts new file mode 100644 index 00000000..53105a86 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/breakpoints.ts @@ -0,0 +1,187 @@ +/** + * @fileoverview 断点管理器 + * @description 管理调试断点的添加、删除和命中检测 + */ + +import type { NodeId, RunId } from '../../domain/ids'; +import type { Breakpoint, DebuggerState } from '../../domain/debug'; + +/** + * 断点管理器 + * @description 管理单个 Run 的断点 + */ +export class BreakpointManager { + private breakpoints = new Map(); + private stepMode: 'none' | 'stepOver' = 'none'; + + constructor(initialBreakpoints?: NodeId[]) { + if (initialBreakpoints) { + for (const nodeId of initialBreakpoints) { + this.add(nodeId); + } + } + } + + /** + * 添加断点 + */ + add(nodeId: NodeId): void { + this.breakpoints.set(nodeId, { nodeId, enabled: true }); + } + + /** + * 删除断点 + */ + remove(nodeId: NodeId): void { + this.breakpoints.delete(nodeId); + } + + /** + * 设置断点列表（替换所有现有断点） + */ + setAll(nodeIds: NodeId[]): void { + this.breakpoints.clear(); + for (const nodeId of nodeIds) { + this.add(nodeId); + } + } + + /** + * 启用断点 + */ + enable(nodeId: NodeId): void { + const bp = this.breakpoints.get(nodeId); + if (bp) { + bp.enabled = true; + } + } + + /** + * 禁用断点 + */ + disable(nodeId: NodeId): void { + const bp = this.breakpoints.get(nodeId); + if (bp) { + bp.enabled = false; + } + } + + /** + * 检查节点是否有启用的断点 + */ + hasBreakpoint(nodeId: NodeId): boolean { + const bp = this.breakpoints.get(nodeId); + return bp?.enabled ?? false; + } + + /** + * 检查是否应该在节点处暂停 + * @description 考虑断点和单步模式 + */ + shouldPauseAt(nodeId: NodeId): boolean { + // 如果在单步模式，总是暂停 + if (this.stepMode === 'stepOver') { + return true; + } + // 否则检查断点 + return this.hasBreakpoint(nodeId); + } + + /** + * 获取所有断点 + */ + getAll(): Breakpoint[] { + return Array.from(this.breakpoints.values()); + } + + /** + * 获取启用的断点 + */ + getEnabled(): Breakpoint[] { + return this.getAll().filter((bp) => bp.enabled); + } + + /** + * 设置单步模式 + */ + setStepMode(mode: 'none' | 'stepOver'): void { + this.stepMode = mode; + } + + /** + * 获取单步模式 + */ + getStepMode(): 'none' | 'stepOver' { + return this.stepMode; + } + + /** + * 清除所有断点 + */ + clear(): void { + this.breakpoints.clear(); + this.stepMode = 'none'; + } +} + +/** + * 断点管理器注册表 + * @description 管理多个 Run 的断点管理器 + */ +export class BreakpointRegistry { + private managers = new Map(); + + /** + * 获取或创建断点管理器 + */ + getOrCreate(runId: RunId, initialBreakpoints?: NodeId[]): BreakpointManager { + let manager = this.managers.get(runId); + if (!manager) { + manager = new BreakpointManager(initialBreakpoints); + this.managers.set(runId, manager); + } + return manager; + } + + /** + * 获取断点管理器 + */ + get(runId: RunId): BreakpointManager | undefined { + return this.managers.get(runId); + } + + /** + * 删除断点管理器 + */ + remove(runId: RunId): void { + this.managers.delete(runId); + } + + /** + * 清空所有 + */ + clear(): void { + this.managers.clear(); + } +} + +/** 全局断点注册表 */ +let globalBreakpointRegistry: BreakpointRegistry | null = null; + +/** + * 获取全局断点注册表 + */ +export function getBreakpointRegistry(): BreakpointRegistry { + if (!globalBreakpointRegistry) { + globalBreakpointRegistry = new BreakpointRegistry(); + } + return globalBreakpointRegistry; +} + +/** + * 重置全局断点注册表 + * @description 主要用于测试 + */ +export function resetBreakpointRegistry(): void { + globalBreakpointRegistry = null; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/debug-controller.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/debug-controller.ts new file mode 100644 index 00000000..1200e303 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/debug-controller.ts @@ -0,0 +1,485 @@ +/** + * @fileoverview Debug Controller + * @description Central control plane for debugging - command routing, state aggregation, and UI push + */ + +import type { NodeId, RunId } from '../../domain/ids'; +import type { JsonValue } from '../../domain/json'; +import type { PauseReason, RunEvent, Unsubscribe } from '../../domain/events'; +import type { + DebuggerCommand, + DebuggerResponse, + DebuggerState, + Breakpoint, +} from '../../domain/debug'; +import { createInitialDebuggerState } from '../../domain/debug'; + +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from '../transport/events-bus'; +import type { RunRunner } from './runner'; +import { BreakpointManager, getBreakpointRegistry } from './breakpoints'; + +/** + * Runner registry for managing active runners + */ +export interface RunnerRegistry { + get(runId: RunId): RunRunner | undefined; + register(runId: RunId, runner: RunRunner): void; + unregister(runId: RunId): void; + list(): RunId[]; +} + +/** + * Create a simple runner registry + */ +export function createRunnerRegistry(): RunnerRegistry { + const runners = new Map(); + return { + get: (runId) => runners.get(runId), + register: (runId, runner) => runners.set(runId, runner), + unregister: (runId) => runners.delete(runId), + list: () => Array.from(runners.keys()), + }; +} + +/** + * Debug session state (per-run) + */ +interface DebugSession { + runId: RunId; + attached: boolean; + lastPauseReason?: PauseReason; + lastKnownNodeId?: NodeId; + lastKnownExecution: 'running' | 'paused'; +} + +/** + * Debug state listener + */ +type DebugStateListener = (state: DebuggerState) => void; + +/** + * Debug Controller Configuration + */ +export interface DebugControllerConfig { + storage: StoragePort; + events: EventsBus; + runners: RunnerRegistry; +} + +/** + * Debug Controller + * @description Single entry point for all debug operations + */ +export class DebugController { + private readonly storage: StoragePort; + private readonly events: EventsBus; + private readonly runners: RunnerRegistry; + + private readonly sessions = new Map(); + private readonly listeners = new Map>(); + private eventUnsubscribe: Unsubscribe | null = null; + + constructor(config: DebugControllerConfig) { + this.storage = config.storage; + this.events = config.events; + this.runners = config.runners; + } + + /** + * Start the debug controller + */ + start(): void { + // Subscribe to all events to track pause/resume state + this.eventUnsubscribe = this.events.subscribe((event) => { + this.handleEvent(event); + }); + } + + /** + * Stop the debug controller + */ + stop(): void { + if (this.eventUnsubscribe) { + this.eventUnsubscribe(); + this.eventUnsubscribe = null; + } + this.sessions.clear(); + this.listeners.clear(); + } + + /** + * Handle a debug command + */ + async handle(cmd: DebuggerCommand): Promise { + try { + switch (cmd.type) { + case 'debug.attach': + return this.handleAttach(cmd.runId); + + case 'debug.detach': + return this.handleDetach(cmd.runId); + + case 'debug.pause': + return this.handlePause(cmd.runId); + + case 'debug.resume': + return this.handleResume(cmd.runId); + + case 'debug.stepOver': + return this.handleStepOver(cmd.runId); + + case 'debug.setBreakpoints': + return this.handleSetBreakpoints(cmd.runId, cmd.nodeIds); + + case 'debug.addBreakpoint': + return this.handleAddBreakpoint(cmd.runId, cmd.nodeId); + + case 'debug.removeBreakpoint': + return this.handleRemoveBreakpoint(cmd.runId, cmd.nodeId); + + case 'debug.getState': + return this.handleGetState(cmd.runId); + + case 'debug.getVar': + return this.handleGetVar(cmd.runId, cmd.name); + + case 'debug.setVar': + return this.handleSetVar(cmd.runId, cmd.name, cmd.value); + + default: + return { ok: false, error: `Unknown debug command: ${(cmd as { type: string }).type}` }; + } + } catch (e) { + const message = e instanceof Error ? e.message : String(e); + return { ok: false, error: message }; + } + } + + /** + * Subscribe to debug state changes + */ + subscribe(listener: DebugStateListener, filter?: { runId?: RunId }): Unsubscribe { + const key = filter?.runId ?? null; + let set = this.listeners.get(key); + if (!set) { + set = new Set(); + this.listeners.set(key, set); + } + set.add(listener); + + return () => { + set?.delete(listener); + if (set?.size === 0) { + this.listeners.delete(key); + } + }; + } + + /** + * Get current debug state for a run + */ + async getState(runId: RunId): Promise { + const session = this.sessions.get(runId); + const run = await this.storage.runs.get(runId); + const bpManager = getBreakpointRegistry().get(runId); + + const state: DebuggerState = { + runId, + status: session?.attached ? 'attached' : 'detached', + execution: session?.lastKnownExecution ?? (run?.status === 'paused' ? 'paused' : 'running'), + pauseReason: session?.lastPauseReason, + currentNodeId: session?.lastKnownNodeId ?? run?.currentNodeId, + breakpoints: bpManager?.getAll() ?? [], + stepMode: bpManager?.getStepMode() ?? 'none', + }; + + return state; + } + + // ==================== Command Handlers ==================== + + private async handleAttach(runId: RunId): Promise { + const run = await this.storage.runs.get(runId); + if (!run) { + return { ok: false, error: `Run "${runId}" not found` }; + } + + // Create or update session + let session = this.sessions.get(runId); + if (!session) { + session = { + runId, + attached: true, + lastKnownExecution: run.status === 'paused' ? 'paused' : 'running', + lastKnownNodeId: run.currentNodeId, + }; + this.sessions.set(runId, session); + } else { + session.attached = true; + } + + // Get or create breakpoint manager + getBreakpointRegistry().getOrCreate(runId, run.debug?.breakpoints); + + const state = await this.getState(runId); + this.notifyStateChange(runId, state); + return { ok: true, state }; + } + + private async handleDetach(runId: RunId): Promise { + const session = this.sessions.get(runId); + if (session) { + session.attached = false; + } + + const state = await this.getState(runId); + this.notifyStateChange(runId, state); + return { ok: true, state }; + } + + private async handlePause(runId: RunId): Promise { + const runner = this.runners.get(runId); + if (!runner) { + return { ok: false, error: `Runner for "${runId}" not found` }; + } + + runner.pause(); + const state = await this.getState(runId); + return { ok: true, state }; + } + + private async handleResume(runId: RunId): Promise { + const runner = this.runners.get(runId); + if (!runner) { + return { ok: false, error: `Runner for "${runId}" not found` }; + } + + runner.resume(); + const state = await this.getState(runId); + return { ok: true, state }; + } + + private async handleStepOver(runId: RunId): Promise { + const runner = this.runners.get(runId); + if (!runner) { + return { ok: false, error: `Runner for "${runId}" not found` }; + } + + // Set step mode to stepOver (will pause at next node) + const bpManager = getBreakpointRegistry().getOrCreate(runId); + bpManager.setStepMode('stepOver'); + + // Resume execution - runner will pause at next node due to stepOver mode + runner.resume(); + + const state = await this.getState(runId); + return { ok: true, state }; + } + + private async handleSetBreakpoints(runId: RunId, nodeIds: NodeId[]): Promise { + const bpManager = getBreakpointRegistry().getOrCreate(runId); + bpManager.setAll(nodeIds); + + // Persist breakpoints to run record + await this.persistBreakpoints(runId, bpManager); + + const state = await this.getState(runId); + this.notifyStateChange(runId, state); + return { ok: true, state }; + } + + private async handleAddBreakpoint(runId: RunId, nodeId: NodeId): Promise { + const bpManager = getBreakpointRegistry().getOrCreate(runId); + bpManager.add(nodeId); + + await this.persistBreakpoints(runId, bpManager); + + const state = await this.getState(runId); + this.notifyStateChange(runId, state); + return { ok: true, state }; + } + + private async handleRemoveBreakpoint(runId: RunId, nodeId: NodeId): Promise { + const bpManager = getBreakpointRegistry().getOrCreate(runId); + bpManager.remove(nodeId); + + await this.persistBreakpoints(runId, bpManager); + + const state = await this.getState(runId); + this.notifyStateChange(runId, state); + return { ok: true, state }; + } + + private async handleGetState(runId: RunId): Promise { + const state = await this.getState(runId); + return { ok: true, state }; + } + + private async handleGetVar(runId: RunId, name: string): Promise { + // Try to get from active runner first + const runner = this.runners.get(runId); + if (runner) { + const value = runner.getVar(name); + return { ok: true, value: value ?? null }; + } + + // Fallback: reconstruct from events + const value = await this.reconstructVar(runId, name); + return { ok: true, value: value ?? null }; + } + + private async handleSetVar( + runId: RunId, + name: string, + value: JsonValue, + ): Promise { + const runner = this.runners.get(runId); + if (!runner) { + return { + ok: false, + error: `Runner for "${runId}" not found - cannot set variable on inactive run`, + }; + } + + runner.setVar(name, value); + return { ok: true }; + } + + // ==================== Event Handling ==================== + + private handleEvent(event: RunEvent): void { + const { runId } = event; + let session = this.sessions.get(runId); + + // Track pause/resume state + if (event.type === 'run.paused') { + if (!session) { + session = { + runId, + attached: false, + lastKnownExecution: 'paused', + }; + this.sessions.set(runId, session); + } + session.lastKnownExecution = 'paused'; + session.lastPauseReason = event.reason; + session.lastKnownNodeId = event.nodeId; + } else if (event.type === 'run.resumed') { + if (session) { + session.lastKnownExecution = 'running'; + session.lastPauseReason = undefined; + } + } else if (event.type === 'run.started') { + if (!session) { + session = { + runId, + attached: false, + lastKnownExecution: 'running', + }; + this.sessions.set(runId, session); + } + } else if ( + event.type === 'run.succeeded' || + event.type === 'run.failed' || + event.type === 'run.canceled' + ) { + // Run ended - keep session for querying but mark as not running + if (session) { + session.lastKnownExecution = 'running'; // Technically ended, but not paused + } + } else if (event.type === 'node.started') { + if (session) { + session.lastKnownNodeId = event.nodeId; + } + } + + // Notify listeners if session is attached + if (session?.attached) { + void this.getState(runId).then((state) => { + this.notifyStateChange(runId, state); + }); + } + } + + // ==================== Helpers ==================== + + private async persistBreakpoints(runId: RunId, bpManager: BreakpointManager): Promise { + const breakpoints = bpManager.getEnabled().map((bp) => bp.nodeId); + try { + await this.storage.runs.patch(runId, { + debug: { breakpoints }, + }); + } catch { + // Run may not exist yet - ignore persistence error + } + } + + private async reconstructVar(runId: RunId, name: string): Promise { + // Get flow and run to reconstruct initial vars + const run = await this.storage.runs.get(runId); + if (!run) return undefined; + + const flow = await this.storage.flows.get(run.flowId); + if (!flow) return undefined; + + // Build initial vars + const vars: Record = { ...(run.args ?? {}) }; + for (const def of flow.variables ?? []) { + if (vars[def.name] === undefined && def.default !== undefined) { + vars[def.name] = def.default; + } + } + + // Apply all vars.patch events + const events = await this.storage.events.list(runId); + for (const event of events) { + if (event.type === 'vars.patch') { + for (const op of event.patch) { + if (op.op === 'set') { + vars[op.name] = op.value ?? null; + } else { + delete vars[op.name]; + } + } + } + } + + return vars[name]; + } + + private notifyStateChange(runId: RunId, state: DebuggerState): void { + // Notify specific run listeners + const runListeners = this.listeners.get(runId); + if (runListeners) { + for (const listener of runListeners) { + try { + listener(state); + } catch (e) { + console.error('[DebugController] Listener error:', e); + } + } + } + + // Notify global listeners + const globalListeners = this.listeners.get(null); + if (globalListeners) { + for (const listener of globalListeners) { + try { + listener(state); + } catch (e) { + console.error('[DebugController] Listener error:', e); + } + } + } + } +} + +/** + * Create and start a debug controller + */ +export function createDebugController(config: DebugControllerConfig): DebugController { + const controller = new DebugController(config); + controller.start(); + return controller; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/index.ts new file mode 100644 index 00000000..94fba51c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/index.ts @@ -0,0 +1,11 @@ +/** + * @fileoverview Kernel 模块导出入口 + */ + +export * from './kernel'; +export * from './runner'; +export * from './traversal'; +export * from './breakpoints'; +export * from './artifacts'; +export * from './debug-controller'; +export * from './recovery-kernel'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/kernel.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/kernel.ts new file mode 100644 index 00000000..497be257 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/kernel.ts @@ -0,0 +1,149 @@ +/** + * @fileoverview ExecutionKernel 接口定义 + * @description 定义 Record-Replay V3 的核心执行引擎接口 + */ + +import type { JsonObject } from '../../domain/json'; +import type { FlowId, NodeId, RunId } from '../../domain/ids'; +import type { RRError } from '../../domain/errors'; +import type { FlowV3 } from '../../domain/flow'; +import type { DebuggerCommand, DebuggerState } from '../../domain/debug'; +import type { RunEvent, RunStatus, Unsubscribe } from '../../domain/events'; + +/** + * Run 启动请求 + */ +export interface RunStartRequest { + /** Run ID（由调用方生成） */ + runId: RunId; + /** Flow ID */ + flowId: FlowId; + /** Flow 快照（执行时使用的完整 Flow 定义） */ + flowSnapshot: FlowV3; + /** 运行参数 */ + args?: JsonObject; + /** 起始节点 ID（默认为 Flow 的 entryNodeId） */ + startNodeId?: NodeId; + /** Tab ID（必须由调用方分配，每 Run 独占） */ + tabId: number; + /** 调试配置 */ + debug?: { breakpoints?: NodeId[]; pauseOnStart?: boolean }; +} + +/** + * Run 执行结果 + */ +export interface RunResult { + /** Run ID */ + runId: RunId; + /** 最终状态 */ + status: Extract; + /** 总耗时（毫秒） */ + tookMs: number; + /** 错误信息（如果失败） */ + error?: RRError; + /** 输出结果 */ + outputs?: JsonObject; +} + +/** + * Run 状态查询结果 + */ +export interface RunStatusInfo { + /** 当前状态 */ + status: RunStatus; + /** 当前节点 ID */ + currentNodeId?: NodeId; + /** 开始时间 */ + startedAt?: number; + /** 最后更新时间 */ + updatedAt: number; + /** Tab ID */ + tabId?: number; +} + +/** + * ExecutionKernel 接口 + * @description Record-Replay V3 的核心执行引擎 + */ +export interface ExecutionKernel { + /** + * 订阅事件流 + * @param listener 事件监听器 + * @returns 取消订阅函数 + */ + onEvent(listener: (event: RunEvent) => void): Unsubscribe; + + /** + * 启动 Run + * @description 将 Run 加入队列并开始执行 + */ + startRun(req: RunStartRequest): Promise; + + /** + * 暂停 Run + * @param runId Run ID + * @param reason 暂停原因 + */ + pauseRun(runId: RunId, reason?: { kind: 'command' }): Promise; + + /** + * 恢复 Run + * @param runId Run ID + */ + resumeRun(runId: RunId): Promise; + + /** + * 取消 Run + * @param runId Run ID + * @param reason 取消原因 + */ + cancelRun(runId: RunId, reason?: string): Promise; + + /** + * 执行调试命令 + * @param runId Run ID + * @param cmd 调试命令 + */ + debug( + runId: RunId, + cmd: DebuggerCommand, + ): Promise<{ ok: true; state?: DebuggerState } | { ok: false; error: string }>; + + /** + * 获取 Run 状态 + * @param runId Run ID + * @returns Run 状态信息或 null（如果不存在） + */ + getRunStatus(runId: RunId): Promise; + + /** + * 恢复执行 + * @description 在 Service Worker 重启后调用，恢复中断的 Run + */ + recover(): Promise; +} + +/** + * 创建 NotImplemented 的 ExecutionKernel + * @description Phase 0 占位实现 + */ +export function createNotImplementedKernel(): ExecutionKernel { + const notImplemented = () => { + throw new Error('ExecutionKernel not implemented'); + }; + + return { + onEvent: () => { + notImplemented(); + return () => {}; + }, + startRun: async () => notImplemented(), + pauseRun: async () => notImplemented(), + resumeRun: async () => notImplemented(), + cancelRun: async () => notImplemented(), + debug: async () => notImplemented(), + getRunStatus: async () => notImplemented(), + recover: async () => notImplemented(), + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/recovery-kernel.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/recovery-kernel.ts new file mode 100644 index 00000000..ccbcb9be --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/recovery-kernel.ts @@ -0,0 +1,97 @@ +/** + * @fileoverview 支持崩溃恢复的 ExecutionKernel 实现 (P3-06) + * @description + * 提供 ExecutionKernel 的恢复增强实现，支持 `recover()` 方法。 + * 通过委托给 RecoveryCoordinator 实现崩溃恢复。 + * + * 其他执行方法（startRun, pauseRun 等）暂未实现，将在后续阶段完成。 + */ + +import type { UnixMillis } from '../../domain/json'; +import type { RunId } from '../../domain/ids'; +import type { DebuggerCommand, DebuggerState } from '../../domain/debug'; + +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from '../transport/events-bus'; +import { recoverFromCrash } from '../recovery/recovery-coordinator'; + +import type { ExecutionKernel, RunStartRequest, RunStatusInfo } from './kernel'; + +// ==================== Types ==================== + +/** + * 支持恢复的 Kernel 依赖 + */ +export interface RecoveryEnabledKernelDeps { + /** 存储层 */ + storage: StoragePort; + /** 事件总线 */ + events: EventsBus; + /** 当前 Service Worker 的 ownerId */ + ownerId: string; + /** 时间源 */ + now?: () => UnixMillis; + /** 日志器 */ + logger?: Pick; +} + +// ==================== Factory ==================== + +/** + * 创建支持恢复的 ExecutionKernel + * @description + * 此实现仅支持 `recover()` 和 `getRunStatus()` 方法。 + * 其他执行方法暂未实现，将在后续阶段完成。 + */ +export function createRecoveryEnabledKernel(deps: RecoveryEnabledKernelDeps): ExecutionKernel { + const logger = deps.logger ?? console; + const now = deps.now ?? (() => Date.now()); + + if (!deps.ownerId) { + throw new Error('ownerId is required'); + } + + const notImplemented = (name: string): never => { + throw new Error(`ExecutionKernel.${name} not implemented`); + }; + + return { + onEvent: (listener) => deps.events.subscribe(listener), + + startRun: async (_req: RunStartRequest) => notImplemented('startRun'), + pauseRun: async (_runId: RunId) => notImplemented('pauseRun'), + resumeRun: async (_runId: RunId) => notImplemented('resumeRun'), + cancelRun: async (_runId: RunId) => notImplemented('cancelRun'), + + debug: async ( + _runId: RunId, + _cmd: DebuggerCommand, + ): Promise<{ ok: true; state?: DebuggerState } | { ok: false; error: string }> => { + return { ok: false, error: 'ExecutionKernel.debug not configured' }; + }, + + getRunStatus: async (runId: RunId): Promise => { + const run = await deps.storage.runs.get(runId); + if (!run) return null; + return { + status: run.status, + currentNodeId: run.currentNodeId, + startedAt: run.startedAt, + updatedAt: run.updatedAt, + tabId: run.tabId, + }; + }, + + recover: async (): Promise => { + logger.info('[RecoveryKernel] Starting crash recovery...'); + const result = await recoverFromCrash({ + storage: deps.storage, + events: deps.events, + ownerId: deps.ownerId, + now, + logger, + }); + logger.info('[RecoveryKernel] Recovery complete:', result); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/runner.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/runner.ts new file mode 100644 index 00000000..9f0042e6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/runner.ts @@ -0,0 +1,893 @@ +/** + * @fileoverview RunRunner 接口和实现 + * @description 定义和实现单个 Run 的顺序执行器 + */ + +import type { NodeId, RunId } from '../../domain/ids'; +import { EDGE_LABELS } from '../../domain/ids'; +import type { FlowV3, NodeV3 } from '../../domain/flow'; +import { findNodeById } from '../../domain/flow'; +import type { + PauseReason, + RunEvent, + RunEventInput, + RunRecordV3, + Unsubscribe, +} from '../../domain/events'; +import { RUN_SCHEMA_VERSION } from '../../domain/events'; +import type { JsonObject, JsonValue } from '../../domain/json'; +import { RR_ERROR_CODES, createRRError, type RRError } from '../../domain/errors'; +import type { NodePolicy, RetryPolicy } from '../../domain/policy'; +import { mergeNodePolicy } from '../../domain/policy'; + +import type { EventsBus } from '../transport/events-bus'; +import type { StoragePort } from '../storage/storage-port'; +import type { PluginRegistry } from '../plugins/registry'; +import { getPluginRegistry } from '../plugins/registry'; +import type { NodeExecutionContext, NodeExecutionResult, VarsPatchOp } from '../plugins/types'; + +import type { ArtifactService } from './artifacts'; +import { createNotImplementedArtifactService } from './artifacts'; +import { getBreakpointRegistry, type BreakpointManager } from './breakpoints'; +import { findEdgeByLabel, findNextNode, validateFlowDAG } from './traversal'; +import type { RunResult } from './kernel'; + +// ==================== Types ==================== + +/** + * RunRunner 运行时状态 + */ +export interface RunnerRuntimeState { + /** Run ID */ + runId: RunId; + /** 当前节点 ID */ + currentNodeId: NodeId | null; + /** 当前尝试次数 */ + attempt: number; + /** 变量表 */ + vars: Record; + /** 是否暂停 */ + paused: boolean; + /** 是否取消 */ + canceled: boolean; +} + +/** + * RunRunner 配置 + */ +export interface RunnerConfig { + /** Flow 快照 */ + flow: FlowV3; + /** Tab ID */ + tabId: number; + /** 初始参数 */ + args?: JsonObject; + /** 起始节点 ID */ + startNodeId?: NodeId; + /** 调试配置 */ + debug?: { breakpoints?: NodeId[]; pauseOnStart?: boolean }; +} + +/** + * RunRunner 接口 + */ +export interface RunRunner { + /** Run ID */ + readonly runId: RunId; + /** 当前状态 */ + readonly state: RunnerRuntimeState; + /** 订阅事件 */ + onEvent(listener: (event: RunEvent) => void): Unsubscribe; + /** 开始执行 */ + start(): Promise; + /** 暂停执行 */ + pause(): void; + /** 恢复执行 */ + resume(): void; + /** 取消执行 */ + cancel(reason?: string): void; + /** 获取变量值 */ + getVar(name: string): JsonValue | undefined; + /** 设置变量值 */ + setVar(name: string, value: JsonValue): void; +} + +/** + * RunRunner 工厂接口 + */ +export interface RunRunnerFactory { + create(runId: RunId, config: RunnerConfig): RunRunner; +} + +/** + * RunRunner 工厂依赖 + */ +export interface RunRunnerFactoryDeps { + storage: StoragePort; + events: EventsBus; + plugins?: PluginRegistry; + artifactService?: ArtifactService; + now?: () => number; +} + +// ==================== Helpers ==================== + +interface Deferred { + promise: Promise; + resolve: (value: T) => void; + reject: (reason?: unknown) => void; +} + +function createDeferred(): Deferred { + let resolve!: (value: T) => void; + let reject!: (reason?: unknown) => void; + const promise = new Promise((res, rej) => { + resolve = res; + reject = rej; + }); + return { promise, resolve, reject }; +} + +function sleep(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +function errorMessage(err: unknown): string { + if (err instanceof Error) return err.message; + if (err && typeof err === 'object' && 'message' in err) + return String((err as { message: unknown }).message); + return String(err); +} + +async function withTimeout( + p: Promise, + ms: number | undefined, + onTimeout: () => RRError, +): Promise { + if (ms === undefined || !Number.isFinite(ms) || ms <= 0) { + return p; + } + + let timer: ReturnType | undefined; + try { + return await Promise.race([ + p, + new Promise((_resolve, reject) => { + timer = setTimeout(() => reject(onTimeout()), ms); + }), + ]); + } finally { + if (timer !== undefined) { + clearTimeout(timer); + } + } +} + +function computeRetryDelayMs(policy: RetryPolicy, attempt: number): number { + const base = Math.max(0, policy.intervalMs); + let delay = base; + const backoff = policy.backoff ?? 'none'; + + if (backoff === 'linear') { + delay = base * attempt; + } else if (backoff === 'exp') { + delay = base * Math.pow(2, Math.max(0, attempt - 1)); + } + + if (policy.maxIntervalMs !== undefined) { + delay = Math.min(delay, Math.max(0, policy.maxIntervalMs)); + } + + if (policy.jitter === 'full') { + delay = Math.floor(Math.random() * (delay + 1)); + } + + return Math.max(0, Math.floor(delay)); +} + +function applyVarsPatch(vars: Record, patch: VarsPatchOp[]): void { + for (const op of patch) { + if (op.op === 'set') { + vars[op.name] = op.value ?? null; + } else { + delete vars[op.name]; + } + } +} + +function toRRError(err: unknown, fallback: { code: string; message: string }): RRError { + if (err && typeof err === 'object' && 'code' in err && 'message' in err) { + return err as RRError; + } + return createRRError( + fallback.code as RRError['code'], + `${fallback.message}: ${errorMessage(err)}`, + ); +} + +/** + * Serial queue for write operations + * Ensures event ordering and reduces write races + */ +class SerialQueue { + private tail: Promise = Promise.resolve(); + + run(fn: () => Promise): Promise { + const next = this.tail.then(fn, fn); + this.tail = next.then( + () => undefined, + () => undefined, + ); + return next; + } +} + +// ==================== Factory ==================== + +/** + * 创建 NotImplemented 的 RunRunnerFactory + */ +export function createNotImplementedRunnerFactory(): RunRunnerFactory { + return { + create: () => { + throw new Error('RunRunnerFactory not implemented'); + }, + }; +} + +/** + * 创建 RunRunner 工厂 + */ +export function createRunRunnerFactory(deps: RunRunnerFactoryDeps): RunRunnerFactory { + const plugins = deps.plugins ?? getPluginRegistry(); + const artifactService = deps.artifactService ?? createNotImplementedArtifactService(); + const now = deps.now ?? Date.now; + + return { + create: (runId, config) => + new StorageBackedRunRunner(runId, config, { + storage: deps.storage, + events: deps.events, + plugins, + artifactService, + now, + }), + }; +} + +// ==================== Implementation ==================== + +interface RunnerEnv { + storage: StoragePort; + events: EventsBus; + plugins: PluginRegistry; + artifactService: ArtifactService; + now: () => number; +} + +type OnErrorDecision = + | { kind: 'stop' } + | { kind: 'continue' } + | { + kind: 'goto'; + target: { kind: 'edgeLabel'; label: string } | { kind: 'node'; nodeId: NodeId }; + } + | { kind: 'retry'; retryPolicy: RetryPolicy | null }; + +type NodeRunResult = + | { nextNodeId: NodeId | null } + | { terminal: 'failed'; error: RRError } + | { terminal: 'canceled' }; + +/** + * Storage-backed RunRunner implementation + */ +class StorageBackedRunRunner implements RunRunner { + readonly runId: RunId; + readonly state: RunnerRuntimeState; + + private readonly config: RunnerConfig; + private readonly env: RunnerEnv; + private readonly queue = new SerialQueue(); + private readonly breakpoints: BreakpointManager; + + private startPromise: Promise | null = null; + private outputs: JsonObject = {}; + private cancelReason: string | undefined; + private pauseWaiter: Deferred | null = null; + + constructor(runId: RunId, config: RunnerConfig, env: RunnerEnv) { + this.runId = runId; + this.config = config; + this.env = env; + + this.state = { + runId, + currentNodeId: null, + attempt: 0, + vars: this.buildInitialVars(), + paused: false, + canceled: false, + }; + + this.breakpoints = getBreakpointRegistry().getOrCreate(runId, config.debug?.breakpoints); + } + + onEvent(listener: (event: RunEvent) => void): Unsubscribe { + return this.env.events.subscribe(listener, { runId: this.runId }); + } + + start(): Promise { + if (!this.startPromise) { + this.startPromise = this.run(); + } + return this.startPromise; + } + + pause(): void { + this.requestPause({ kind: 'command' }); + } + + resume(): void { + if (!this.state.paused) return; + this.state.paused = false; + this.pauseWaiter?.resolve(undefined); + this.pauseWaiter = null; + + void this.queue + .run(async () => { + await this.env.storage.runs.patch(this.runId, { status: 'running' }); + await this.env.events.append({ runId: this.runId, type: 'run.resumed' } as RunEventInput); + }) + .catch((e) => { + console.error('[RunRunner] resume persistence failed:', e); + }); + } + + cancel(reason?: string): void { + if (this.state.canceled) return; + this.state.canceled = true; + this.cancelReason = reason; + + if (this.state.paused) { + this.state.paused = false; + this.pauseWaiter?.resolve(undefined); + this.pauseWaiter = null; + } + } + + getVar(name: string): JsonValue | undefined { + return this.state.vars[name]; + } + + setVar(name: string, value: JsonValue): void { + this.state.vars[name] = value; + + // Best-effort: emit vars.patch event + void this.queue + .run(() => + this.env.events.append({ + runId: this.runId, + type: 'vars.patch', + patch: [{ op: 'set', name, value }], + } as RunEventInput), + ) + .catch(() => {}); + } + + // ==================== Private Methods ==================== + + private buildInitialVars(): Record { + const vars: Record = { ...(this.config.args ?? {}) }; + for (const def of this.config.flow.variables ?? []) { + if (vars[def.name] === undefined && def.default !== undefined) { + vars[def.name] = def.default; + } + } + return vars; + } + + private requestPause(reason: PauseReason): void { + if (this.state.canceled) return; + if (this.state.paused) return; + + this.state.paused = true; + if (!this.pauseWaiter) { + this.pauseWaiter = createDeferred(); + } + + const nodeId = this.state.currentNodeId ?? undefined; + void this.queue + .run(async () => { + await this.env.storage.runs.patch(this.runId, { + status: 'paused', + ...(nodeId ? { currentNodeId: nodeId } : {}), + }); + await this.env.events.append({ + runId: this.runId, + type: 'run.paused', + reason, + ...(nodeId ? { nodeId } : {}), + } as RunEventInput); + }) + .catch((e) => { + console.error('[RunRunner] pause persistence failed:', e); + }); + } + + private async waitIfPaused(): Promise { + while (this.state.paused && !this.state.canceled) { + if (!this.pauseWaiter) { + this.pauseWaiter = createDeferred(); + } + await this.pauseWaiter.promise; + } + } + + private async ensureRunRecord(startNodeId: NodeId, startedAt: number): Promise { + await this.queue.run(async () => { + const existing = await this.env.storage.runs.get(this.runId); + if (!existing) { + const record: RunRecordV3 = { + schemaVersion: RUN_SCHEMA_VERSION, + id: this.runId, + flowId: this.config.flow.id, + status: 'running', + createdAt: startedAt, + updatedAt: startedAt, + startedAt, + tabId: this.config.tabId, + startNodeId: this.config.startNodeId, + currentNodeId: startNodeId, + attempt: 0, + maxAttempts: 1, + args: this.config.args, + debug: this.config.debug, + nextSeq: 1, + }; + await this.env.storage.runs.save(record); + return; + } + + if (!Number.isSafeInteger(existing.nextSeq) || existing.nextSeq < 0) { + throw createRRError( + RR_ERROR_CODES.INVARIANT_VIOLATION, + `Invalid nextSeq for run "${this.runId}": ${String(existing.nextSeq)}`, + ); + } + + const patch: Partial = { + status: 'running', + tabId: this.config.tabId, + currentNodeId: startNodeId, + }; + if (existing.startedAt === undefined) patch.startedAt = startedAt; + if (this.config.startNodeId !== undefined) patch.startNodeId = this.config.startNodeId; + if (this.config.args !== undefined) patch.args = this.config.args; + if (this.config.debug !== undefined) patch.debug = this.config.debug; + await this.env.storage.runs.patch(this.runId, patch); + }); + } + + private async run(): Promise { + const startedAt = this.env.now(); + const { flow } = this.config; + + const startNodeId = (this.config.startNodeId ?? flow.entryNodeId) as NodeId; + + // Ensure Run record exists FIRST (before DAG validation) + // so that finishFailed can safely patch the record + await this.ensureRunRecord(startNodeId, startedAt); + + // Validate DAG + const validation = validateFlowDAG(flow); + if (!validation.ok) { + const error = + validation.errors[0] ?? createRRError(RR_ERROR_CODES.DAG_INVALID, 'Invalid DAG'); + return this.finishFailed(startedAt, error, undefined); + } + + if (this.state.canceled) { + return this.finishCanceled(startedAt); + } + + // Emit run.started + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'run.started', + flowId: flow.id, + tabId: this.config.tabId, + } as RunEventInput), + ); + + // Handle pauseOnStart + if (this.config.debug?.pauseOnStart) { + this.requestPause({ kind: 'policy', nodeId: startNodeId, reason: 'pauseOnStart' }); + } + + // Main execution loop + let currentNodeId: NodeId | null = startNodeId; + while (currentNodeId) { + this.state.currentNodeId = currentNodeId; + + // Only update currentNodeId, not status (to preserve paused state) + const nodeIdToUpdate = currentNodeId; // Capture for closure + await this.queue.run(() => + this.env.storage.runs.patch(this.runId, { currentNodeId: nodeIdToUpdate }), + ); + + if (this.state.canceled) break; + await this.waitIfPaused(); + if (this.state.canceled) break; + + const node = findNodeById(flow, currentNodeId); + if (!node) { + const error = createRRError( + RR_ERROR_CODES.DAG_INVALID, + `Node "${currentNodeId}" not found in flow`, + ); + return this.finishFailed(startedAt, error, currentNodeId); + } + + // Skip disabled nodes + if (node.disabled) { + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'node.skipped', + nodeId: node.id, + reason: 'disabled', + } as RunEventInput), + ); + currentNodeId = findNextNode(flow, node.id); + continue; + } + + // Check breakpoints + if (this.breakpoints.shouldPauseAt(node.id)) { + const reason: PauseReason = + this.breakpoints.getStepMode() === 'stepOver' + ? { kind: 'step', nodeId: node.id } + : { kind: 'breakpoint', nodeId: node.id }; + + // Clear step mode after hitting (to avoid infinite pause loop) + if (this.breakpoints.getStepMode() === 'stepOver') { + this.breakpoints.setStepMode('none'); + } + + this.requestPause(reason); + await this.waitIfPaused(); + // After resume, proceed to execute the node (don't continue loop) + } + + // Emit node.queued + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'node.queued', + nodeId: node.id, + } as RunEventInput), + ); + + // Execute node + const nodeStartAt = this.env.now(); + const next = await this.runNode(flow, node, nodeStartAt); + if ('terminal' in next) { + if (next.terminal === 'canceled') break; + if (next.terminal === 'failed') { + return this.finishFailed(startedAt, next.error, node.id); + } + break; + } + + currentNodeId = next.nextNodeId; + } + + if (this.state.canceled) { + return this.finishCanceled(startedAt); + } + + return this.finishSucceeded(startedAt); + } + + private async runNode(flow: FlowV3, node: NodeV3, nodeStartAt: number): Promise { + let attempt = 1; + + for (;;) { + if (this.state.canceled) return { terminal: 'canceled' }; + await this.waitIfPaused(); + if (this.state.canceled) return { terminal: 'canceled' }; + + this.state.attempt = attempt; + + // Emit node.started + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'node.started', + nodeId: node.id, + attempt, + } as RunEventInput), + ); + + const exec = await this.executeNodeAttempt(flow, node); + if (exec.status === 'succeeded') { + const tookMs = this.env.now() - nodeStartAt; + + // Apply vars patch + if (exec.varsPatch && exec.varsPatch.length > 0) { + applyVarsPatch(this.state.vars, exec.varsPatch); + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'vars.patch', + patch: exec.varsPatch, + } as RunEventInput), + ); + } + + // Merge outputs + if (exec.outputs) { + this.outputs = { ...this.outputs, ...exec.outputs }; + } + + // Emit node.succeeded + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'node.succeeded', + nodeId: node.id, + tookMs, + ...(exec.next ? { next: exec.next } : {}), + } as RunEventInput), + ); + + if (exec.next?.kind === 'end') { + return { nextNodeId: null }; + } + + const label = exec.next?.kind === 'edgeLabel' ? exec.next.label : undefined; + return { nextNodeId: findNextNode(flow, node.id, label) }; + } + + // Handle failure + const error = exec.error; + const policy = this.resolveNodePolicy(flow, node); + const decision = this.decideOnError(flow, node, policy, error); + + // Emit node.failed + await this.queue.run(() => + this.env.events.append({ + runId: this.runId, + type: 'node.failed', + nodeId: node.id, + attempt, + error, + decision: decision.kind, + } as RunEventInput), + ); + + if (decision.kind === 'retry' && decision.retryPolicy) { + const maxAttempts = 1 + Math.max(0, decision.retryPolicy.retries); + const canRetry = + attempt < maxAttempts && + (decision.retryPolicy.retryOn + ? decision.retryPolicy.retryOn.includes( + error.code as (typeof decision.retryPolicy.retryOn)[number], + ) + : true); + + if (!canRetry) { + return { terminal: 'failed', error }; + } + + const delay = computeRetryDelayMs(decision.retryPolicy, attempt); + if (delay > 0) { + await sleep(delay); + } + attempt++; + continue; + } + + if (decision.kind === 'continue') { + return { nextNodeId: findNextNode(flow, node.id) }; + } + + if (decision.kind === 'goto') { + if (decision.target.kind === 'node') { + return { nextNodeId: decision.target.nodeId }; + } + return { nextNodeId: findNextNode(flow, node.id, decision.target.label) }; + } + + return { terminal: 'failed', error }; + } + } + + private resolveNodePolicy(flow: FlowV3, node: NodeV3): NodePolicy { + const def = this.env.plugins.getNode(node.kind); + const flowDefault = flow.policy?.defaultNodePolicy; + const pluginDefault = def?.defaultPolicy; + const merged1 = mergeNodePolicy(flowDefault, pluginDefault); + return mergeNodePolicy(merged1, node.policy); + } + + private decideOnError( + flow: FlowV3, + node: NodeV3, + policy: NodePolicy, + _error: RRError, + ): OnErrorDecision { + const configured = policy.onError; + + // Default: if there's an ON_ERROR edge, use it + if (!configured) { + const onErrorEdge = findEdgeByLabel(flow, node.id, EDGE_LABELS.ON_ERROR); + if (onErrorEdge) { + return { kind: 'goto', target: { kind: 'edgeLabel', label: EDGE_LABELS.ON_ERROR } }; + } + return { kind: 'stop' }; + } + + if (configured.kind === 'stop') return { kind: 'stop' }; + if (configured.kind === 'continue') return { kind: 'continue' }; + if (configured.kind === 'goto') { + return { + kind: 'goto', + target: configured.target as + | { kind: 'edgeLabel'; label: string } + | { kind: 'node'; nodeId: NodeId }, + }; + } + + // retry + const base: RetryPolicy = policy.retry ?? { retries: 1, intervalMs: 0 }; + const retryPolicy: RetryPolicy = configured.override + ? { ...base, ...configured.override } + : base; + return { kind: 'retry', retryPolicy }; + } + + private async executeNodeAttempt(flow: FlowV3, node: NodeV3): Promise { + const def = this.env.plugins.getNode(node.kind); + if (!def) { + return { + status: 'failed', + error: createRRError( + RR_ERROR_CODES.UNSUPPORTED_NODE, + `Node kind "${node.kind}" is not registered`, + ), + }; + } + + let parsedConfig: unknown = node.config; + try { + parsedConfig = def.schema.parse(node.config); + } catch (e) { + return { + status: 'failed', + error: createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Invalid node config: ${errorMessage(e)}`, + ), + }; + } + + const ctx: NodeExecutionContext = { + runId: this.runId, + flow, + nodeId: node.id, + tabId: this.config.tabId, + vars: this.state.vars, + log: (level, message, data) => { + void this.queue + .run(() => + this.env.events.append({ + runId: this.runId, + type: 'log', + level, + message, + ...(data !== undefined ? { data } : {}), + } as RunEventInput), + ) + .catch(() => {}); + }, + chooseNext: (label) => ({ kind: 'edgeLabel', label }), + artifacts: { + screenshot: () => this.env.artifactService.screenshot(this.config.tabId), + }, + persistent: { + get: async (name) => (await this.env.storage.persistentVars.get(name))?.value, + set: async (name, value) => { + await this.env.storage.persistentVars.set(name, value); + }, + delete: async (name) => { + await this.env.storage.persistentVars.delete(name); + }, + }, + }; + + const policy = this.resolveNodePolicy(flow, node); + const timeoutMs = policy.timeout?.ms; + const scope = policy.timeout?.scope ?? 'attempt'; + const attemptTimeoutMs = scope === 'attempt' && timeoutMs !== undefined ? timeoutMs : undefined; + + try { + const nodeWithConfig = { ...node, config: parsedConfig } as Parameters[1]; + const execPromise = def.execute(ctx, nodeWithConfig); + const result = await withTimeout(execPromise, attemptTimeoutMs, () => + createRRError(RR_ERROR_CODES.TIMEOUT, `Node "${node.id}" timed out`), + ); + return result; + } catch (e) { + return { + status: 'failed', + error: toRRError(e, { code: RR_ERROR_CODES.INTERNAL, message: 'Node execution threw' }), + }; + } + } + + private async finishSucceeded(startedAt: number): Promise { + const tookMs = this.env.now() - startedAt; + await this.queue.run(async () => { + await this.env.storage.runs.patch(this.runId, { + status: 'succeeded', + finishedAt: this.env.now(), + tookMs, + outputs: this.outputs, + }); + await this.env.events.append({ + runId: this.runId, + type: 'run.succeeded', + tookMs, + outputs: this.outputs, + } as RunEventInput); + }); + + return { runId: this.runId, status: 'succeeded', tookMs, outputs: this.outputs }; + } + + private async finishFailed( + startedAt: number, + error: RRError, + nodeId?: NodeId, + ): Promise { + const tookMs = this.env.now() - startedAt; + await this.queue.run(async () => { + await this.env.storage.runs.patch(this.runId, { + status: 'failed', + finishedAt: this.env.now(), + tookMs, + error, + ...(nodeId ? { currentNodeId: nodeId } : {}), + }); + await this.env.events.append({ + runId: this.runId, + type: 'run.failed', + error, + ...(nodeId ? { nodeId } : {}), + } as RunEventInput); + }); + + return { runId: this.runId, status: 'failed', tookMs, error }; + } + + private async finishCanceled(startedAt: number): Promise { + const tookMs = this.env.now() - startedAt; + await this.queue.run(async () => { + await this.env.storage.runs.patch(this.runId, { + status: 'canceled', + finishedAt: this.env.now(), + tookMs, + }); + await this.env.events.append({ + runId: this.runId, + type: 'run.canceled', + ...(this.cancelReason ? { reason: this.cancelReason } : {}), + } as RunEventInput); + }); + + return { runId: this.runId, status: 'canceled', tookMs }; + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/traversal.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/traversal.ts new file mode 100644 index 00000000..b93c1bd7 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/kernel/traversal.ts @@ -0,0 +1,226 @@ +/** + * @fileoverview DAG 遍历和校验 + * @description 提供 Flow DAG 的校验、遍历和下一节点查找功能 + */ + +import type { NodeId, EdgeLabel } from '../../domain/ids'; +import type { FlowV3, EdgeV3 } from '../../domain/flow'; +import { EDGE_LABELS } from '../../domain/ids'; +import { RR_ERROR_CODES, createRRError, type RRError } from '../../domain/errors'; + +/** + * DAG 校验结果 + */ +export type ValidateFlowDAGResult = { ok: true } | { ok: false; errors: RRError[] }; + +/** + * 校验 Flow DAG 结构 + * @param flow Flow 定义 + * @returns 校验结果 + */ +export function validateFlowDAG(flow: FlowV3): ValidateFlowDAGResult { + const errors: RRError[] = []; + const nodeIds = new Set(flow.nodes.map((n) => n.id)); + + // 检查 entryNodeId 是否存在 + if (!nodeIds.has(flow.entryNodeId)) { + errors.push( + createRRError( + RR_ERROR_CODES.DAG_INVALID, + `Entry node "${flow.entryNodeId}" does not exist in flow`, + ), + ); + } + + // 检查边引用的节点是否存在 + for (const edge of flow.edges) { + if (!nodeIds.has(edge.from)) { + errors.push( + createRRError( + RR_ERROR_CODES.DAG_INVALID, + `Edge "${edge.id}" references non-existent source node "${edge.from}"`, + ), + ); + } + if (!nodeIds.has(edge.to)) { + errors.push( + createRRError( + RR_ERROR_CODES.DAG_INVALID, + `Edge "${edge.id}" references non-existent target node "${edge.to}"`, + ), + ); + } + } + + // 检查循环 + const cycle = detectCycle(flow); + if (cycle) { + errors.push( + createRRError(RR_ERROR_CODES.DAG_CYCLE, `Cycle detected in flow: ${cycle.join(' -> ')}`), + ); + } + + return errors.length > 0 ? { ok: false, errors } : { ok: true }; +} + +/** + * 检测 DAG 中的循环 + * @param flow Flow 定义 + * @returns 循环路径（如果存在）或 null + */ +export function detectCycle(flow: FlowV3): NodeId[] | null { + const adjacency = buildAdjacencyMap(flow); + const visited = new Set(); + const recursionStack = new Set(); + const path: NodeId[] = []; + + function dfs(nodeId: NodeId): boolean { + visited.add(nodeId); + recursionStack.add(nodeId); + path.push(nodeId); + + const neighbors = adjacency.get(nodeId) || []; + for (const neighbor of neighbors) { + if (!visited.has(neighbor)) { + if (dfs(neighbor)) { + return true; + } + } else if (recursionStack.has(neighbor)) { + // 找到循环 + const cycleStart = path.indexOf(neighbor); + path.push(neighbor); // 闭合循环 + path.splice(0, cycleStart); // 移除循环前的节点 + return true; + } + } + + path.pop(); + recursionStack.delete(nodeId); + return false; + } + + for (const node of flow.nodes) { + if (!visited.has(node.id)) { + if (dfs(node.id)) { + return path; + } + } + } + + return null; +} + +/** + * 查找下一个节点 + * @param flow Flow 定义 + * @param currentNodeId 当前节点 ID + * @param label 边标签（可选，默认使用 default） + * @returns 下一个节点 ID 或 null（如果没有后续节点） + */ +export function findNextNode( + flow: FlowV3, + currentNodeId: NodeId, + label?: EdgeLabel, +): NodeId | null { + const outEdges = flow.edges.filter((e) => e.from === currentNodeId); + + if (outEdges.length === 0) { + return null; + } + + // 如果指定了 label，优先匹配 + if (label) { + const matchedEdge = outEdges.find((e) => e.label === label); + if (matchedEdge) { + return matchedEdge.to; + } + } + + // 否则使用 default 边 + const defaultEdge = outEdges.find( + (e) => e.label === EDGE_LABELS.DEFAULT || e.label === undefined, + ); + if (defaultEdge) { + return defaultEdge.to; + } + + // 如果只有一条边，使用它 + if (outEdges.length === 1) { + return outEdges[0].to; + } + + return null; +} + +/** + * 查找指定标签的边 + */ +export function findEdgeByLabel( + flow: FlowV3, + fromNodeId: NodeId, + label: EdgeLabel, +): EdgeV3 | undefined { + return flow.edges.find((e) => e.from === fromNodeId && e.label === label); +} + +/** + * 获取节点的所有出边 + */ +export function getOutEdges(flow: FlowV3, nodeId: NodeId): EdgeV3[] { + return flow.edges.filter((e) => e.from === nodeId); +} + +/** + * 获取节点的所有入边 + */ +export function getInEdges(flow: FlowV3, nodeId: NodeId): EdgeV3[] { + return flow.edges.filter((e) => e.to === nodeId); +} + +/** + * 构建邻接表 + */ +function buildAdjacencyMap(flow: FlowV3): Map { + const map = new Map(); + + for (const node of flow.nodes) { + map.set(node.id, []); + } + + for (const edge of flow.edges) { + const neighbors = map.get(edge.from); + if (neighbors) { + neighbors.push(edge.to); + } + } + + return map; +} + +/** + * 获取从入口节点可达的所有节点 + */ +export function getReachableNodes(flow: FlowV3): Set { + const reachable = new Set(); + const adjacency = buildAdjacencyMap(flow); + + function dfs(nodeId: NodeId): void { + if (reachable.has(nodeId)) return; + reachable.add(nodeId); + + const neighbors = adjacency.get(nodeId) || []; + for (const neighbor of neighbors) { + dfs(neighbor); + } + } + + dfs(flow.entryNodeId); + return reachable; +} + +/** + * 检查节点是否可达 + */ +export function isNodeReachable(flow: FlowV3, nodeId: NodeId): boolean { + return getReachableNodes(flow).has(nodeId); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/index.ts new file mode 100644 index 00000000..0a493f46 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/index.ts @@ -0,0 +1,8 @@ +/** + * @fileoverview 插件系统导出入口 + */ + +export * from './types'; +export * from './registry'; +export * from './v2-action-adapter'; +export * from './register-v2-replay-nodes'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/register-v2-replay-nodes.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/register-v2-replay-nodes.ts new file mode 100644 index 00000000..011eb46f --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/register-v2-replay-nodes.ts @@ -0,0 +1,90 @@ +/** + * @fileoverview Register RR-V2 replay action handlers as RR-V3 nodes + * @description + * Batch registration of V2 action handlers into the V3 PluginRegistry. + * This enables V3 to execute flows that use V2 action types. + */ + +import { createReplayActionRegistry } from '@/entrypoints/background/record-replay/actions/handlers'; +import type { + ActionHandler, + ExecutableActionType, +} from '@/entrypoints/background/record-replay/actions/types'; + +import type { PluginRegistry } from './registry'; +import { + adaptV2ActionHandlerToV3NodeDefinition, + type V2ActionNodeAdapterOptions, +} from './v2-action-adapter'; + +export interface RegisterV2ReplayNodesOptions extends V2ActionNodeAdapterOptions { + /** + * Only include these action types. If not specified, all V2 handlers are included. + */ + include?: ReadonlyArray; + + /** + * Exclude these action types. Applied after include filter. + */ + exclude?: ReadonlyArray; +} + +/** + * Register V2 replay action handlers as V3 node definitions. + * + * @param registry The V3 PluginRegistry to register nodes into + * @param options Configuration options + * @returns Array of registered node kinds + * + * @example + * ```ts + * const plugins = new PluginRegistry(); + * const registered = registerV2ReplayNodesAsV3Nodes(plugins, { + * // Exclude control flow handlers that V3 runner doesn't support + * exclude: ['foreach', 'while'], + * }); + * console.log('Registered:', registered); + * ``` + */ +export function registerV2ReplayNodesAsV3Nodes( + registry: PluginRegistry, + options: RegisterV2ReplayNodesOptions = {}, +): string[] { + const actionRegistry = createReplayActionRegistry(); + const handlers = actionRegistry.list(); + + const include = options.include ? new Set(options.include) : null; + const exclude = options.exclude ? new Set(options.exclude) : null; + + const registered: string[] = []; + + for (const handler of handlers) { + if (include && !include.has(handler.type)) continue; + if (exclude && exclude.has(handler.type)) continue; + + // Cast needed because V2 handler types don't perfectly align with V3 NodeKind + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition( + handler as ActionHandler, + options, + ); + registry.registerNode(nodeDef as unknown as Parameters[0]); + registered.push(handler.type); + } + + return registered; +} + +/** + * Get list of V2 action types that can be registered. + * Useful for debugging and documentation. + */ +export function listV2ActionTypes(): string[] { + const actionRegistry = createReplayActionRegistry(); + return actionRegistry.list().map((h) => h.type); +} + +/** + * Default exclude list for V3 registration. + * These handlers rely on V2 control directives that V3 runner doesn't support. + */ +export const DEFAULT_V2_EXCLUDE_LIST = ['foreach', 'while'] as const; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/registry.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/registry.ts new file mode 100644 index 00000000..dbf307a0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/registry.ts @@ -0,0 +1,157 @@ +/** + * @fileoverview 插件注册表 + * @description 管理节点和触发器插件的注册和查询 + */ + +import type { NodeKind } from '../../domain/flow'; +import type { TriggerKind } from '../../domain/triggers'; +import { RR_ERROR_CODES, createRRError } from '../../domain/errors'; +import type { + NodeDefinition, + TriggerDefinition, + PluginRegistrationContext, + RRPlugin, +} from './types'; + +/** + * 插件注册表 + * @description 单例模式，管理所有已注册的节点和触发器 + */ +export class PluginRegistry implements PluginRegistrationContext { + private nodes = new Map(); + private triggers = new Map(); + + /** + * 注册节点定义 + * @description 如果已存在同名节点，会覆盖 + */ + registerNode(def: NodeDefinition): void { + this.nodes.set(def.kind, def); + } + + /** + * 注册触发器定义 + * @description 如果已存在同名触发器，会覆盖 + */ + registerTrigger(def: TriggerDefinition): void { + this.triggers.set(def.kind, def); + } + + /** + * 获取节点定义 + * @returns 节点定义或 undefined + */ + getNode(kind: NodeKind): NodeDefinition | undefined { + return this.nodes.get(kind); + } + + /** + * 获取节点定义（必须存在） + * @throws RRError 如果节点未注册 + */ + getNodeOrThrow(kind: NodeKind): NodeDefinition { + const def = this.nodes.get(kind); + if (!def) { + throw createRRError(RR_ERROR_CODES.UNSUPPORTED_NODE, `Node kind "${kind}" is not registered`); + } + return def; + } + + /** + * 获取触发器定义 + * @returns 触发器定义或 undefined + */ + getTrigger(kind: TriggerKind): TriggerDefinition | undefined { + return this.triggers.get(kind); + } + + /** + * 获取触发器定义（必须存在） + * @throws RRError 如果触发器未注册 + */ + getTriggerOrThrow(kind: TriggerKind): TriggerDefinition { + const def = this.triggers.get(kind); + if (!def) { + throw createRRError( + RR_ERROR_CODES.UNSUPPORTED_NODE, + `Trigger kind "${kind}" is not registered`, + ); + } + return def; + } + + /** + * 检查节点是否已注册 + */ + hasNode(kind: NodeKind): boolean { + return this.nodes.has(kind); + } + + /** + * 检查触发器是否已注册 + */ + hasTrigger(kind: TriggerKind): boolean { + return this.triggers.has(kind); + } + + /** + * 获取所有已注册的节点类型 + */ + listNodeKinds(): NodeKind[] { + return Array.from(this.nodes.keys()); + } + + /** + * 获取所有已注册的触发器类型 + */ + listTriggerKinds(): TriggerKind[] { + return Array.from(this.triggers.keys()); + } + + /** + * 注册插件 + * @description 调用插件的 register 方法 + */ + registerPlugin(plugin: RRPlugin): void { + plugin.register(this); + } + + /** + * 批量注册插件 + */ + registerPlugins(plugins: RRPlugin[]): void { + for (const plugin of plugins) { + this.registerPlugin(plugin); + } + } + + /** + * 清空所有注册 + * @description 主要用于测试 + */ + clear(): void { + this.nodes.clear(); + this.triggers.clear(); + } +} + +/** 全局插件注册表实例 */ +let globalRegistry: PluginRegistry | null = null; + +/** + * 获取全局插件注册表 + */ +export function getPluginRegistry(): PluginRegistry { + if (!globalRegistry) { + globalRegistry = new PluginRegistry(); + } + return globalRegistry; +} + +/** + * 重置全局插件注册表 + * @description 主要用于测试 + */ +export function resetPluginRegistry(): void { + globalRegistry = null; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/types.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/types.ts new file mode 100644 index 00000000..8851f7bb --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/types.ts @@ -0,0 +1,181 @@ +/** + * @fileoverview 插件类型定义 + * @description 定义 Record-Replay V3 中的节点和触发器插件接口 + */ + +import { z } from 'zod'; + +import type { JsonObject, JsonValue } from '../../domain/json'; +import type { FlowId, NodeId, RunId, TriggerId } from '../../domain/ids'; +import type { NodeKind } from '../../domain/flow'; +import type { RRError } from '../../domain/errors'; +import type { NodePolicy } from '../../domain/policy'; +import type { FlowV3, NodeV3 } from '../../domain/flow'; +import type { TriggerKind } from '../../domain/triggers'; + +/** + * Schema 类型 + * @description 使用 Zod 进行配置校验 + */ +export type Schema = z.ZodType; + +/** + * 节点执行上下文 + * @description 提供给节点执行器的运行时上下文 + */ +export interface NodeExecutionContext { + /** Run ID */ + runId: RunId; + /** Flow 定义（快照） */ + flow: FlowV3; + /** 当前节点 ID */ + nodeId: NodeId; + + /** 绑定的 Tab ID（每 Run 独占） */ + tabId: number; + /** Frame ID（默认 0 为主框架） */ + frameId?: number; + + /** 当前变量表 */ + vars: Record; + + /** + * 日志记录 + */ + log: (level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: JsonValue) => void; + + /** + * 选择下一个边 + * @description 用于条件分支节点 + */ + chooseNext: (label: string) => { kind: 'edgeLabel'; label: string }; + + /** + * 工件操作 + */ + artifacts: { + /** 截取当前页面截图 */ + screenshot: () => Promise<{ ok: true; base64: string } | { ok: false; error: RRError }>; + }; + + /** + * 持久化变量操作 + */ + persistent: { + /** 获取持久化变量 */ + get: (name: `$${string}`) => Promise; + /** 设置持久化变量 */ + set: (name: `$${string}`, value: JsonValue) => Promise; + /** 删除持久化变量 */ + delete: (name: `$${string}`) => Promise; + }; +} + +/** + * 变量补丁操作 + */ +export interface VarsPatchOp { + op: 'set' | 'delete'; + name: string; + value?: JsonValue; +} + +/** + * 节点执行结果 + */ +export type NodeExecutionResult = + | { + status: 'succeeded'; + /** 下一步执行方向 */ + next?: { kind: 'edgeLabel'; label: string } | { kind: 'end' }; + /** 输出结果 */ + outputs?: JsonObject; + /** 变量修改 */ + varsPatch?: VarsPatchOp[]; + } + | { status: 'failed'; error: RRError }; + +/** + * 节点定义 + * @description 定义一种节点类型的执行逻辑 + */ +export interface NodeDefinition< + TKind extends NodeKind = NodeKind, + TConfig extends JsonObject = JsonObject, +> { + /** 节点类型标识 */ + kind: TKind; + /** 配置校验 Schema */ + schema: Schema; + /** 默认策略 */ + defaultPolicy?: NodePolicy; + /** + * 执行节点 + * @param ctx 执行上下文 + * @param node 节点定义（含配置） + */ + execute( + ctx: NodeExecutionContext, + node: NodeV3 & { kind: TKind; config: TConfig }, + ): Promise; +} + +/** + * 触发器安装上下文 + */ +export interface TriggerInstallContext< + TKind extends TriggerKind = TriggerKind, + TConfig extends JsonObject = JsonObject, +> { + /** 触发器 ID */ + triggerId: TriggerId; + /** 触发器类型 */ + kind: TKind; + /** 是否启用 */ + enabled: boolean; + /** 关联的 Flow ID */ + flowId: FlowId; + /** 触发器配置 */ + config: TConfig; + /** 传递给 Flow 的参数 */ + args?: JsonObject; +} + +/** + * 触发器定义 + * @description 定义一种触发器类型的安装和卸载逻辑 + */ +export interface TriggerDefinition< + TKind extends TriggerKind = TriggerKind, + TConfig extends JsonObject = JsonObject, +> { + /** 触发器类型标识 */ + kind: TKind; + /** 配置校验 Schema */ + schema: Schema; + /** 安装触发器 */ + install(ctx: TriggerInstallContext): Promise | void; + /** 卸载触发器 */ + uninstall(ctx: TriggerInstallContext): Promise | void; +} + +/** + * 插件注册上下文 + */ +export interface PluginRegistrationContext { + /** 注册节点定义 */ + registerNode(def: NodeDefinition): void; + /** 注册触发器定义 */ + registerTrigger(def: TriggerDefinition): void; +} + +/** + * 插件接口 + * @description Record-Replay 插件的标准接口 + */ +export interface RRPlugin { + /** 插件名称 */ + name: string; + /** 注册插件内容 */ + register(ctx: PluginRegistrationContext): void; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/v2-action-adapter.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/v2-action-adapter.ts new file mode 100644 index 00000000..cbc10684 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/plugins/v2-action-adapter.ts @@ -0,0 +1,414 @@ +/** + * @fileoverview V2 ActionHandler -> V3 NodeDefinition adapter + * @description Bridges legacy RR-V2 action handlers into the RR-V3 PluginRegistry. + * + * Design notes: + * - V3 requires variable mutations to be represented as varsPatch so they are auditable in the event log. + * - V2 handlers mutate ctx.vars directly, so we run them against a cloned VariableStore and diff it. + * - Cross-node state (tabId/frameId changes from switchFrame/openTab/switchTab) is persisted in internal vars. + * + * WARNING: This adapter accesses V2 handler internals and may need updates if V2 types change. + */ + +import { z } from 'zod'; + +import type { + ActionExecutionContext, + ActionExecutionResult, + ActionHandler, + ActionError, + ActionErrorCode, + ActionPolicy, + ExecutableActionType, + ValidationResult, + Action, +} from '@/entrypoints/background/record-replay/actions/types'; + +import type { JsonValue, JsonObject } from '../../domain/json'; +import { RR_ERROR_CODES, createRRError, type RRError, type RRErrorCode } from '../../domain/errors'; +import type { NodePolicy } from '../../domain/policy'; +import { mergeNodePolicy } from '../../domain/policy'; + +import type { + NodeDefinition, + NodeExecutionContext, + NodeExecutionResult, + VarsPatchOp, +} from './types'; + +// Internal run-scoped state keys used to emulate V2 "mutable context" across nodes. +const DEFAULT_TAB_ID_VAR = '__rr_v2__tabId'; +const DEFAULT_FRAME_ID_VAR = '__rr_v2__frameId'; + +export interface V2ActionNodeAdapterOptions { + /** + * Whether to emit v2 ActionExecutionResult.output into V3 NodeExecutionResult.outputs. + * Defaults to true. + */ + includeOutput?: boolean; + + /** + * Where to store cross-node "mutable context" state (tabId/frameId). + * Defaults are "__rr_v2__tabId" and "__rr_v2__frameId". + */ + stateVars?: { + tabIdVar?: string; + frameIdVar?: string; + }; + + /** + * Execution flags forwarded into V2 ActionExecutionContext.execution. + * Keep default undefined to preserve V2 handler behavior. + */ + executionFlags?: ActionExecutionContext['execution']; +} + +// ==================== Utilities ==================== + +function toErrorMessage(e: unknown): string { + if (e instanceof Error) return e.message; + if (e && typeof e === 'object' && 'message' in e) + return String((e as { message: unknown }).message); + return String(e); +} + +function deepClone(value: T): T { + const sc = (globalThis as unknown as { structuredClone?: (v: U) => U }).structuredClone; + if (typeof sc === 'function') return sc(value); + return JSON.parse(JSON.stringify(value)) as T; +} + +function safeJsonValue(value: unknown): JsonValue { + if (value === undefined) return null; + try { + const s = JSON.stringify(value); + if (s === undefined) return String(value); + return JSON.parse(s) as JsonValue; + } catch { + return String(value); + } +} + +function mapLogLevel(level: 'info' | 'warn' | 'error' | undefined): 'info' | 'warn' | 'error' { + return level ?? 'info'; +} + +function mapV2ErrorCode(code: ActionErrorCode): RRErrorCode { + switch (code) { + case 'VALIDATION_ERROR': + return RR_ERROR_CODES.VALIDATION_ERROR; + case 'TIMEOUT': + return RR_ERROR_CODES.TIMEOUT; + case 'TAB_NOT_FOUND': + return RR_ERROR_CODES.TAB_NOT_FOUND; + case 'FRAME_NOT_FOUND': + return RR_ERROR_CODES.FRAME_NOT_FOUND; + case 'TARGET_NOT_FOUND': + return RR_ERROR_CODES.TARGET_NOT_FOUND; + case 'ELEMENT_NOT_VISIBLE': + return RR_ERROR_CODES.ELEMENT_NOT_VISIBLE; + case 'NAVIGATION_FAILED': + return RR_ERROR_CODES.NAVIGATION_FAILED; + case 'NETWORK_REQUEST_FAILED': + return RR_ERROR_CODES.NETWORK_REQUEST_FAILED; + case 'SCRIPT_FAILED': + return RR_ERROR_CODES.SCRIPT_FAILED; + + // V3 doesn't currently have dedicated codes for these. + case 'DOWNLOAD_FAILED': + case 'ASSERTION_FAILED': + return RR_ERROR_CODES.TOOL_ERROR; + + case 'UNKNOWN': + default: + return RR_ERROR_CODES.INTERNAL; + } +} + +function toRRErrorFromV2(error: ActionError): RRError { + const data = error.data !== undefined ? safeJsonValue(error.data) : undefined; + return createRRError( + mapV2ErrorCode(error.code), + error.message, + data !== undefined ? { data } : undefined, + ); +} + +function isRecord(value: unknown): value is Record { + return typeof value === 'object' && value !== null; +} + +function jsonEquals(a: JsonValue, b: JsonValue): boolean { + if (a === b) return true; + + const aIsArray = Array.isArray(a); + const bIsArray = Array.isArray(b); + if (aIsArray || bIsArray) { + if (!aIsArray || !bIsArray) return false; + if (a.length !== b.length) return false; + for (let i = 0; i < a.length; i++) { + if (!jsonEquals(a[i] as JsonValue, b[i] as JsonValue)) return false; + } + return true; + } + + const aIsObj = isRecord(a); + const bIsObj = isRecord(b); + if (aIsObj || bIsObj) { + if (!aIsObj || !bIsObj) return false; + const aKeys = Object.keys(a); + const bKeys = Object.keys(b); + if (aKeys.length !== bKeys.length) return false; + for (const k of aKeys) { + if (!Object.prototype.hasOwnProperty.call(b, k)) return false; + if (!jsonEquals(a[k] as JsonValue, (b as Record)[k] as JsonValue)) + return false; + } + return true; + } + + return false; +} + +function diffVars( + before: Record, + after: Record, +): VarsPatchOp[] { + const patch: VarsPatchOp[] = []; + const keys = new Set([...Object.keys(before), ...Object.keys(after)]); + + for (const key of keys) { + const beforeHas = Object.prototype.hasOwnProperty.call(before, key); + const afterHas = Object.prototype.hasOwnProperty.call(after, key); + + if (!afterHas) { + if (beforeHas) patch.push({ op: 'delete', name: key }); + continue; + } + + const afterVal = after[key]; + if (!beforeHas) { + patch.push({ op: 'set', name: key, value: afterVal }); + continue; + } + + const beforeVal = before[key]; + if (!jsonEquals(beforeVal, afterVal)) { + patch.push({ op: 'set', name: key, value: afterVal }); + } + } + + return patch; +} + +function readNumberVar(vars: Record, key: string): number | undefined { + const v = vars[key]; + return typeof v === 'number' && Number.isFinite(v) ? v : undefined; +} + +function toV2ActionPolicy(policy: NodePolicy | undefined): ActionPolicy | undefined { + if (!policy) return undefined; + + const timeout = policy.timeout + ? { + ms: policy.timeout.ms, + scope: policy.timeout.scope === 'node' ? ('action' as const) : ('attempt' as const), + } + : undefined; + + // NodePolicy/ActionPolicy are structurally similar; we only normalize timeout.scope. + return { + ...(timeout ? { timeout } : {}), + ...(policy.retry ? { retry: policy.retry as unknown as ActionPolicy['retry'] } : {}), + ...(policy.artifacts + ? { artifacts: policy.artifacts as unknown as ActionPolicy['artifacts'] } + : {}), + ...(policy.onError + ? (() => { + // V2 only supports goto by edge label. Node-target goto can't be represented. + if (policy.onError.kind === 'goto' && policy.onError.target.kind === 'node') { + return { onError: { kind: 'stop' } as ActionPolicy['onError'] }; + } + if (policy.onError.kind === 'continue') { + return { + onError: { + kind: 'continue', + level: policy.onError.as, + } as ActionPolicy['onError'], + }; + } + if (policy.onError.kind === 'goto') { + const target = policy.onError.target; + if (target.kind === 'edgeLabel') { + return { + onError: { + kind: 'goto', + label: target.label, + } as ActionPolicy['onError'], + }; + } + // Node target can't be represented in V2, fall through to stop + return { onError: { kind: 'stop' } as ActionPolicy['onError'] }; + } + if (policy.onError.kind === 'retry') { + // V2 has retry policy on action.policy.retry; keep onError as stop to avoid double semantics. + return { onError: { kind: 'stop' } as ActionPolicy['onError'] }; + } + return { onError: policy.onError as unknown as ActionPolicy['onError'] }; + })() + : {}), + }; +} + +function toJsonRecord(value: unknown): Record { + const out: Record = {}; + if (!isRecord(value)) return out; + + for (const [k, v] of Object.entries(value)) { + // Treat undefined as deletion (omit). + if (v === undefined) continue; + out[k] = safeJsonValue(v); + } + + return out; +} + +// ==================== Main Adapter ==================== + +/** + * Adapt a single V2 ActionHandler into a V3 NodeDefinition. + */ +export function adaptV2ActionHandlerToV3NodeDefinition( + handler: ActionHandler, + options: V2ActionNodeAdapterOptions = {}, +): NodeDefinition { + const tabIdVar = options.stateVars?.tabIdVar ?? DEFAULT_TAB_ID_VAR; + const frameIdVar = options.stateVars?.frameIdVar ?? DEFAULT_FRAME_ID_VAR; + + return { + kind: handler.type, + schema: z.record(z.any()) as unknown as NodeDefinition['schema'], + execute: async (ctx: NodeExecutionContext, node): Promise => { + const beforeVars = ctx.vars; + + const effectiveTabId = readNumberVar(beforeVars, tabIdVar) ?? ctx.tabId; + const effectiveFrameId = readNumberVar(beforeVars, frameIdVar); + + // Run against a cloned variable store to prevent bypassing vars.patch event stream. + const v2Vars = deepClone(beforeVars) as unknown as Record; + + const v2Ctx: ActionExecutionContext = { + vars: v2Vars as unknown as ActionExecutionContext['vars'], + tabId: effectiveTabId, + frameId: effectiveFrameId, + runId: ctx.runId, + log: (message, level) => ctx.log(mapLogLevel(level), message), + pushLog: (entry) => { + try { + ctx.log('debug', 'v2.pushLog', safeJsonValue(entry)); + } catch { + // ignore + } + }, + captureScreenshot: async () => { + const r = await ctx.artifacts.screenshot(); + if (r.ok) return r.base64; + throw new Error(r.error.message); + }, + ...(options.executionFlags ? { execution: options.executionFlags } : {}), + }; + + const effectivePolicy = mergeNodePolicy(ctx.flow.policy?.defaultNodePolicy, node.policy); + const v2Policy = toV2ActionPolicy(effectivePolicy); + + const action: Action = { + id: node.id as Action['id'], + type: handler.type, + ...(node.name ? { name: node.name } : {}), + ...(node.disabled ? { disabled: true } : {}), + ...(v2Policy ? { policy: v2Policy } : {}), + params: node.config as unknown as Action['params'], + ...(node.ui ? { ui: node.ui as Action['ui'] } : {}), + }; + + // V2 handler-level validation + if (handler.validate) { + const v: ValidationResult = handler.validate(action); + if (!v.ok) { + return { + status: 'failed', + error: createRRError(RR_ERROR_CODES.VALIDATION_ERROR, v.errors.join(', ')), + }; + } + } + + let result: ActionExecutionResult; + try { + result = await handler.run(v2Ctx, action); + } catch (e) { + return { + status: 'failed', + error: createRRError( + RR_ERROR_CODES.INTERNAL, + `V2 handler "${handler.type}" threw: ${toErrorMessage(e)}`, + ), + }; + } + + if (result.status === 'failed') { + const err = result.error + ? toRRErrorFromV2(result.error) + : createRRError(RR_ERROR_CODES.INTERNAL, `V2 handler "${handler.type}" failed`); + return { status: 'failed', error: err }; + } + + if (result.status === 'paused') { + return { + status: 'failed', + error: createRRError( + RR_ERROR_CODES.RUN_PAUSED, + `V2 handler "${handler.type}" returned paused (not supported in V3 NodeExecutionResult)`, + ), + }; + } + + // V3 does not support V2 scheduler control directives (foreach/while). + if (result.control) { + return { + status: 'failed', + error: createRRError( + RR_ERROR_CODES.UNSUPPORTED_NODE, + `V2 control directive "${result.control.kind}" is not supported by the V3 runner`, + { data: safeJsonValue(result.control) }, + ), + }; + } + + // Persist cross-node context changes via internal vars. + if (typeof v2Ctx.frameId === 'number' && Number.isFinite(v2Ctx.frameId)) { + v2Vars[frameIdVar] = v2Ctx.frameId; + } else { + delete v2Vars[frameIdVar]; + } + + if (typeof result.newTabId === 'number' && Number.isFinite(result.newTabId)) { + v2Vars[tabIdVar] = result.newTabId; + } + + const afterVars = toJsonRecord(v2Vars); + const varsPatch = diffVars(beforeVars, afterVars); + + const outputs: Record | undefined = + options.includeOutput === false || result.output === undefined + ? undefined + : { [node.id]: safeJsonValue(result.output) }; + + return { + status: 'succeeded', + ...(result.nextLabel ? { next: ctx.chooseNext(result.nextLabel) } : {}), + ...(outputs ? { outputs } : {}), + ...(varsPatch.length > 0 ? { varsPatch } : {}), + }; + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/enqueue-run.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/enqueue-run.ts new file mode 100644 index 00000000..52e25917 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/enqueue-run.ts @@ -0,0 +1,219 @@ +/** + * @fileoverview 共享入队服务 + * @description + * 提供统一的 Run 入队逻辑，供 RPC Server 和 TriggerManager 共用。 + * + * 设计理由： + * - 将原本位于 RpcServer 的入队逻辑抽离为独立服务 + * - 避免 RPC 和 TriggerManager 之间的行为漂移 + * - 统一参数校验、Run 创建、队列入队、事件发布流程 + */ + +import type { JsonObject, UnixMillis } from '../../domain/json'; +import type { FlowId, NodeId, RunId } from '../../domain/ids'; +import type { TriggerFireContext } from '../../domain/triggers'; +import { RUN_SCHEMA_VERSION, type RunRecordV3 } from '../../domain/events'; +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from '../transport/events-bus'; +import type { RunScheduler } from './scheduler'; + +// ==================== Types ==================== + +/** + * 入队服务依赖 + */ +export interface EnqueueRunDeps { + /** 存储层 (仅需 flows/runs/queue) */ + storage: Pick; + /** 事件总线 */ + events: Pick; + /** 调度器 (可选) */ + scheduler?: Pick; + /** RunId 生成器 (用于测试注入) */ + generateRunId?: () => RunId; + /** 时间源 (用于测试注入) */ + now?: () => UnixMillis; +} + +/** + * 入队请求参数 + */ +export interface EnqueueRunInput { + /** Flow ID (必选) */ + flowId: FlowId; + /** 起始节点 ID (可选，默认使用 Flow 的 entryNodeId) */ + startNodeId?: NodeId; + /** 优先级 (默认 0) */ + priority?: number; + /** 最大尝试次数 (默认 1) */ + maxAttempts?: number; + /** 传递给 Flow 的参数 */ + args?: JsonObject; + /** 触发上下文 (由 TriggerManager 设置) */ + trigger?: TriggerFireContext; + /** 调试选项 */ + debug?: { + breakpoints?: NodeId[]; + pauseOnStart?: boolean; + }; +} + +/** + * 入队结果 + */ +export interface EnqueueRunResult { + /** 新创建的 Run ID */ + runId: RunId; + /** 在队列中的位置 (1-based) */ + position: number; +} + +// ==================== Utilities ==================== + +/** + * 默认 RunId 生成器 + */ +function defaultGenerateRunId(): RunId { + return `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; +} + +/** + * 校验整数参数 + */ +function validateInt( + value: unknown, + defaultValue: number, + fieldName: string, + opts?: { min?: number; max?: number }, +): number { + if (value === undefined || value === null) { + return defaultValue; + } + if (typeof value !== 'number' || !Number.isFinite(value)) { + throw new Error(`${fieldName} must be a finite number`); + } + const intValue = Math.floor(value); + if (opts?.min !== undefined && intValue < opts.min) { + throw new Error(`${fieldName} must be >= ${opts.min}`); + } + if (opts?.max !== undefined && intValue > opts.max) { + throw new Error(`${fieldName} must be <= ${opts.max}`); + } + return intValue; +} + +/** + * 计算 Run 在队列中的位置 + * @description 按调度顺序: priority DESC + createdAt ASC + * @returns 1-based position, or -1 if run not found in queued items + * + * Note: Due to race conditions (scheduler may claim the run before this is called), + * position may be -1. Callers should handle this gracefully. + */ +async function computeQueuePosition( + storage: Pick, + runId: RunId, +): Promise { + const queueItems = await storage.queue.list('queued'); + queueItems.sort((a, b) => { + if (a.priority !== b.priority) return b.priority - a.priority; + return a.createdAt - b.createdAt; + }); + const index = queueItems.findIndex((item) => item.id === runId); + // Return -1 if not found (run may have been claimed already) + return index === -1 ? -1 : index + 1; +} + +// ==================== Main Function ==================== + +/** + * 入队执行一个 Run + * @description + * 执行步骤： + * 1. 参数校验 + * 2. 验证 Flow 存在 + * 3. 创建 RunRecordV3 (status=queued) + * 4. 入队到 RunQueue + * 5. 发布 run.queued 事件 + * 6. 触发调度 (best-effort) + * 7. 计算队列位置 + */ +export async function enqueueRun( + deps: EnqueueRunDeps, + input: EnqueueRunInput, +): Promise { + const { flowId } = input; + if (!flowId) { + throw new Error('flowId is required'); + } + + const now = deps.now ?? (() => Date.now()); + const generateRunId = deps.generateRunId ?? defaultGenerateRunId; + + // 参数校验 + const priority = validateInt(input.priority, 0, 'priority'); + const maxAttempts = validateInt(input.maxAttempts, 1, 'maxAttempts', { min: 1 }); + + // 验证 Flow 存在 + const flow = await deps.storage.flows.get(flowId); + if (!flow) { + throw new Error(`Flow "${flowId}" not found`); + } + + // 验证 startNodeId 存在于 Flow 中 + if (input.startNodeId) { + const nodeExists = flow.nodes.some((n) => n.id === input.startNodeId); + if (!nodeExists) { + throw new Error(`startNodeId "${input.startNodeId}" not found in flow "${flowId}"`); + } + } + + const ts = now(); + const runId = generateRunId(); + + // 1. 创建 RunRecordV3 + const runRecord: RunRecordV3 = { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId, + status: 'queued', + createdAt: ts, + updatedAt: ts, + attempt: 0, + maxAttempts, + args: input.args, + trigger: input.trigger, + debug: input.debug, + startNodeId: input.startNodeId, + nextSeq: 0, + }; + await deps.storage.runs.save(runRecord); + + // 2. 入队 + await deps.storage.queue.enqueue({ + id: runId, + flowId, + priority, + maxAttempts, + args: input.args, + trigger: input.trigger, + debug: input.debug, + }); + + // 3. 发布 run.queued 事件 + await deps.events.append({ + runId, + type: 'run.queued', + flowId, + }); + + // 4. 计算队列位置 (在 kick 之前计算，减少竞态条件导致 position=-1 的概率) + const position = await computeQueuePosition(deps.storage, runId); + + // 5. 触发调度 (best-effort, 不阻塞返回) + if (deps.scheduler) { + void deps.scheduler.kick(); + } + + return { runId, position }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/index.ts new file mode 100644 index 00000000..2d3b052f --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/index.ts @@ -0,0 +1,8 @@ +/** + * @fileoverview Queue 模块导出入口 + */ + +export * from './queue'; +export * from './leasing'; +export * from './scheduler'; +export * from './enqueue-run'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/leasing.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/leasing.ts new file mode 100644 index 00000000..9925ee15 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/leasing.ts @@ -0,0 +1,113 @@ +/** + * @fileoverview 租约管理 + * @description 管理 Run 的租约续约和过期回收 + */ + +import type { UnixMillis } from '../../domain/json'; +import type { RunId } from '../../domain/ids'; +import type { RunQueue, RunQueueConfig, Lease } from './queue'; + +/** + * 租约管理器 + * @description 管理租约续约和过期检测 + */ +export interface LeaseManager { + /** + * 开始心跳 + * @param ownerId 持有者 ID + */ + startHeartbeat(ownerId: string): void; + + /** + * 停止心跳 + * @param ownerId 持有者 ID + */ + stopHeartbeat(ownerId: string): void; + + /** + * 检查并回收过期租约 + * @param now 当前时间 + * @returns 被回收的 Run ID 列表 + */ + reclaimExpiredLeases(now: UnixMillis): Promise; + + /** + * 判断租约是否过期 + */ + isLeaseExpired(lease: Lease, now: UnixMillis): boolean; + + /** + * 创建新租约 + */ + createLease(ownerId: string, now: UnixMillis): Lease; + + /** + * 停止所有心跳 + */ + dispose(): void; +} + +/** + * 创建租约管理器 + */ +export function createLeaseManager(queue: RunQueue, config: RunQueueConfig): LeaseManager { + const heartbeatTimers = new Map>(); + + return { + startHeartbeat(ownerId: string): void { + // 如果已有定时器，先停止 + this.stopHeartbeat(ownerId); + + // 创建新的心跳定时器 + const timer = setInterval(async () => { + try { + await queue.heartbeat(ownerId, Date.now()); + } catch (error) { + console.error(`[LeaseManager] Heartbeat failed for ${ownerId}:`, error); + } + }, config.heartbeatIntervalMs); + + heartbeatTimers.set(ownerId, timer); + }, + + stopHeartbeat(ownerId: string): void { + const timer = heartbeatTimers.get(ownerId); + if (timer) { + clearInterval(timer); + heartbeatTimers.delete(ownerId); + } + }, + + async reclaimExpiredLeases(now: UnixMillis): Promise { + // Delegate to the queue implementation which uses the lease_expiresAt index + // for efficient scanning and updates storage atomically. + return queue.reclaimExpiredLeases(now); + }, + + isLeaseExpired(lease: Lease, now: UnixMillis): boolean { + return lease.expiresAt < now; + }, + + createLease(ownerId: string, now: UnixMillis): Lease { + return { + ownerId, + expiresAt: now + config.leaseTtlMs, + }; + }, + + dispose(): void { + for (const timer of heartbeatTimers.values()) { + clearInterval(timer); + } + heartbeatTimers.clear(); + }, + }; +} + +/** + * 生成唯一的 owner ID + * @description 用于标识当前 Service Worker 实例 + */ +export function generateOwnerId(): string { + return `sw_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/queue.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/queue.ts new file mode 100644 index 00000000..ec8fd2c3 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/queue.ts @@ -0,0 +1,199 @@ +/** + * @fileoverview RunQueue 接口定义 + * @description 定义 Run 队列的管理接口 + */ + +import type { JsonObject, UnixMillis } from '../../domain/json'; +import type { FlowId, NodeId, RunId } from '../../domain/ids'; +import type { TriggerFireContext } from '../../domain/triggers'; + +/** + * RunQueue 配置 + */ +export interface RunQueueConfig { + /** 最大并行 Run 数量 */ + maxParallelRuns: number; + /** 租约 TTL（毫秒） */ + leaseTtlMs: number; + /** 心跳间隔（毫秒） */ + heartbeatIntervalMs: number; +} + +/** + * 默认队列配置 + */ +export const DEFAULT_QUEUE_CONFIG: RunQueueConfig = { + maxParallelRuns: 3, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, +}; + +/** + * 队列项状态 + */ +export type QueueItemStatus = 'queued' | 'running' | 'paused'; + +/** + * 租约信息 + */ +export interface Lease { + /** 持有者 ID */ + ownerId: string; + /** 过期时间 */ + expiresAt: UnixMillis; +} + +/** + * RunQueue 队列项 + */ +export interface RunQueueItem { + /** Run ID */ + id: RunId; + /** Flow ID */ + flowId: FlowId; + /** 状态 */ + status: QueueItemStatus; + /** 创建时间 */ + createdAt: UnixMillis; + /** 更新时间 */ + updatedAt: UnixMillis; + /** 优先级（数字越大优先级越高） */ + priority: number; + /** 当前尝试次数 */ + attempt: number; + /** 最大尝试次数 */ + maxAttempts: number; + /** Tab ID */ + tabId?: number; + /** 运行参数 */ + args?: JsonObject; + /** 触发器上下文 */ + trigger?: TriggerFireContext; + /** 租约信息 */ + lease?: Lease; + /** 调试配置 */ + debug?: { breakpoints?: NodeId[]; pauseOnStart?: boolean }; +} + +/** + * 入队请求（不含自动生成的字段） + * - priority 默认为 0 + * - maxAttempts 默认为 1 + */ +export type EnqueueInput = Omit< + RunQueueItem, + 'status' | 'createdAt' | 'updatedAt' | 'attempt' | 'lease' | 'priority' | 'maxAttempts' +> & { + id: RunId; + /** 优先级（数字越大优先级越高，默认 0） */ + priority?: number; + /** 最大尝试次数（默认 1） */ + maxAttempts?: number; +}; + +/** + * RunQueue 接口 + * @description 管理 Run 的队列和调度 + */ +export interface RunQueue { + /** + * 入队 + * @param input 入队请求 + * @returns 队列项 + */ + enqueue(input: EnqueueInput): Promise; + + /** + * 领取下一个可执行的 Run + * @param ownerId 领取者 ID + * @param now 当前时间 + * @returns 队列项或 null + */ + claimNext(ownerId: string, now: UnixMillis): Promise; + + /** + * 续约心跳 + * @param ownerId 领取者 ID + * @param now 当前时间 + */ + heartbeat(ownerId: string, now: UnixMillis): Promise; + + /** + * 回收过期租约 + * @description 将 lease.expiresAt < now 的 running/paused 项回收为 queued + * @param now 当前时间 + * @returns 被回收的 Run ID 列表 + */ + reclaimExpiredLeases(now: UnixMillis): Promise; + + /** + * 恢复孤儿租约（SW 重启后调用） + * @description + * - 将孤儿 running 项回收为 queued（status -> queued，租约清除） + * - 将孤儿 paused 项接管（保持 status=paused，租约 ownerId 更新为新 ownerId） + * @param ownerId 新的 ownerId（当前 Service Worker 实例） + * @param now 当前时间 + * @returns 受影响的 runId 列表（含原 ownerId 用于审计） + */ + recoverOrphanLeases( + ownerId: string, + now: UnixMillis, + ): Promise<{ + requeuedRunning: Array<{ runId: RunId; prevOwnerId?: string }>; + adoptedPaused: Array<{ runId: RunId; prevOwnerId?: string }>; + }>; + + /** + * 标记为 running + */ + markRunning(runId: RunId, ownerId: string, now: UnixMillis): Promise; + + /** + * 标记为 paused + */ + markPaused(runId: RunId, ownerId: string, now: UnixMillis): Promise; + + /** + * 标记为完成（从队列移除） + */ + markDone(runId: RunId, now: UnixMillis): Promise; + + /** + * 取消 Run + */ + cancel(runId: RunId, now: UnixMillis, reason?: string): Promise; + + /** + * 获取队列项 + */ + get(runId: RunId): Promise; + + /** + * 列出队列项 + */ + list(status?: QueueItemStatus): Promise; +} + +/** + * 创建 NotImplemented 的 RunQueue + * @description Phase 0 占位实现 + */ +export function createNotImplementedQueue(): RunQueue { + const notImplemented = () => { + throw new Error('RunQueue not implemented'); + }; + + return { + enqueue: async () => notImplemented(), + claimNext: async () => notImplemented(), + heartbeat: async () => notImplemented(), + reclaimExpiredLeases: async () => notImplemented(), + recoverOrphanLeases: async () => notImplemented(), + markRunning: async () => notImplemented(), + markPaused: async () => notImplemented(), + markDone: async () => notImplemented(), + cancel: async () => notImplemented(), + get: async () => notImplemented(), + list: async () => notImplemented(), + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/scheduler.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/scheduler.ts new file mode 100644 index 00000000..75da4b68 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/queue/scheduler.ts @@ -0,0 +1,336 @@ +/** + * @fileoverview RunQueue scheduler (maxParallelRuns) + * @description + * Orchestrates atomic claims from RunQueue and launches execution with an injected executor. + * + * Responsibilities: + * - Enforce maxParallelRuns (per scheduler instance) + * - Backfill available slots when runs complete + * - Periodically reclaim expired leases (best-effort) + * - Start/stop lease heartbeats via LeaseManager + * - Acquire/release keepalive to prevent MV3 SW termination (P3-05) + * + * Non-responsibilities: + * - Run execution details (Flow loading, tab allocation, etc.) are injected via RunExecutor + */ + +import type { UnixMillis } from '../../domain/json'; +import type { RunId } from '../../domain/ids'; +import type { LeaseManager } from './leasing'; +import type { RunQueue, RunQueueConfig, RunQueueItem } from './queue'; +import type { KeepaliveController } from '../keepalive/offscreen-keepalive'; + +// ==================== Types ==================== + +/** + * Run executor contract: + * - Resolve when the run reaches a terminal state (succeeded/failed/canceled). + * - Throw/reject only for unexpected infrastructure errors. + */ +export type RunExecutor = (item: RunQueueItem) => Promise; + +/** + * Scheduler tuning parameters + */ +export interface RunSchedulerTuning { + /** + * Poll interval for queue consumption fallback. + * Set to 0 to disable polling (kick-only). + */ + pollIntervalMs?: number; + + /** + * Minimum interval between lease reclaim scans. + * Set to 0 to disable periodic reclaim (not recommended in production). + */ + reclaimIntervalMs?: number; +} + +/** + * Scheduler dependencies (dependency injection) + */ +export interface RunSchedulerDeps { + queue: Pick; + leaseManager: Pick; + keepalive: Pick; + config: RunQueueConfig; + ownerId: string; + execute: RunExecutor; + now?: () => UnixMillis; + tuning?: RunSchedulerTuning; + logger?: Pick; +} + +/** + * Scheduler state for inspection + */ +export interface RunSchedulerState { + started: boolean; + ownerId: string; + maxParallelRuns: number; + activeRunIds: RunId[]; +} + +/** + * Scheduler interface + */ +export interface RunScheduler { + /** Start the scheduler */ + start(): void; + /** Stop the scheduler */ + stop(): void; + /** + * Trigger a scheduling pass. + * Safe to call frequently; re-entrancy is coalesced. + */ + kick(): Promise; + /** Get current state */ + getState(): RunSchedulerState; + /** Dispose the scheduler */ + dispose(): void; +} + +// ==================== Constants ==================== + +const DEFAULT_POLL_INTERVAL_MS = 500; + +// ==================== Helpers ==================== + +function clampNonNegativeInt(value: unknown, fallback: number): number { + const n = typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : fallback; + return Math.max(0, n); +} + +function defaultReclaimIntervalMs(leaseTtlMs: number): number { + const ttl = clampNonNegativeInt(leaseTtlMs, 0); + // Reclaim at most every ~TTL/2, but never less than 1s to avoid tight loops. + return Math.max(1_000, Math.floor(ttl / 2)); +} + +// ==================== Factory ==================== + +/** + * Create a RunScheduler + * + * Scheduling model: + * - Concurrency is enforced by an in-memory set of active runIds. + * - Ordering is delegated to RunQueue.claimNext() (priority DESC, createdAt ASC). + * + * MV3 Service Worker may be suspended/restarted, so we use a "kick + polling" strategy: + * - kick: Immediate scheduling trigger on enqueue/completion (low latency) + * - polling: Fallback to ensure queue is consumed even if caller forgets to kick + */ +export function createRunScheduler(deps: RunSchedulerDeps): RunScheduler { + const logger = deps.logger ?? console; + + if (!deps.ownerId) { + throw new Error('ownerId is required'); + } + + const now = deps.now ?? (() => Date.now()); + const maxParallelRuns = clampNonNegativeInt(deps.config.maxParallelRuns, 0); + const pollIntervalMs = clampNonNegativeInt( + deps.tuning?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS, + DEFAULT_POLL_INTERVAL_MS, + ); + const reclaimIntervalMs = clampNonNegativeInt( + deps.tuning?.reclaimIntervalMs ?? defaultReclaimIntervalMs(deps.config.leaseTtlMs), + defaultReclaimIntervalMs(deps.config.leaseTtlMs), + ); + + let started = false; + let pollTimer: ReturnType | null = null; + let releaseKeepalive: (() => void) | null = null; + + const activeRunIds = new Set(); + + // Coalesced re-entrancy control for tick() + let pendingKick = false; + let pumpPromise: Promise | null = null; + + let lastReclaimAt: UnixMillis | null = null; + + /** + * Single scheduling tick: + * 1. Reclaim expired leases (if interval elapsed) + * 2. Fill available slots up to maxParallelRuns + */ + async function tick(): Promise { + const t = now(); + + // Best-effort lease reclaim (disabled when reclaimIntervalMs === 0) + if (reclaimIntervalMs > 0) { + const shouldReclaim = lastReclaimAt === null || t - lastReclaimAt >= reclaimIntervalMs; + if (shouldReclaim) { + lastReclaimAt = t; + try { + await deps.leaseManager.reclaimExpiredLeases(t); + } catch (e) { + logger.warn('[RunScheduler] reclaimExpiredLeases failed:', e); + } + } + } + + // Fill available slots up to maxParallelRuns + // + // Note: `stop()` can be called while an async claim is in-flight. Guard the loop + // with `started` to prevent claiming additional items after stop is requested. + while (started && activeRunIds.size < maxParallelRuns) { + let claimed: RunQueueItem | null = null; + try { + claimed = await deps.queue.claimNext(deps.ownerId, t); + } catch (e) { + logger.error('[RunScheduler] claimNext failed:', e); + return; + } + + if (!claimed) return; + + // Guard against double-launch within the same scheduler instance + if (activeRunIds.has(claimed.id)) { + logger.error( + `[RunScheduler] Invariant violation: run "${claimed.id}" was claimed twice in the same scheduler instance`, + ); + // Best-effort cleanup: avoid a stuck running entry + void deps.queue + .markDone(claimed.id, now()) + .catch((err) => + logger.warn('[RunScheduler] markDone after duplicate claim failed:', err), + ); + continue; + } + + activeRunIds.add(claimed.id); + + // Capture claimed item for the closure + const claimedItem = claimed; + + const runPromise = Promise.resolve() + .then(() => deps.execute(claimedItem)) + .catch((e) => { + // If execution failed unexpectedly, log but still cleanup + logger.error(`[RunScheduler] execute failed for run "${claimedItem.id}":`, e); + }) + .finally(async () => { + activeRunIds.delete(claimedItem.id); + try { + await deps.queue.markDone(claimedItem.id, now()); + } catch (e) { + logger.warn(`[RunScheduler] markDone failed for run "${claimedItem.id}":`, e); + } + + // Backfill immediately when a slot frees up + if (started) { + void kick(); + } + }); + + // Ensure no floating promise warnings + void runPromise; + } + } + + /** + * Pump loop: keeps running while pendingKick is set + */ + async function pump(): Promise { + try { + while (started && pendingKick) { + pendingKick = false; + try { + await tick(); + } catch (e) { + logger.error('[RunScheduler] tick failed:', e); + } + } + } finally { + pumpPromise = null; + } + } + + function start(): void { + if (started) return; + started = true; + + // Acquire keepalive to prevent MV3 SW termination + try { + releaseKeepalive = deps.keepalive.acquire('scheduler'); + } catch (e) { + logger.warn('[RunScheduler] keepalive.acquire failed:', e); + releaseKeepalive = null; + } + + try { + deps.leaseManager.startHeartbeat(deps.ownerId); + } catch (e) { + logger.warn('[RunScheduler] startHeartbeat failed:', e); + } + + if (pollIntervalMs > 0) { + pollTimer = setInterval(() => { + void kick(); + }, pollIntervalMs); + } + + void kick(); + } + + function stop(): void { + if (!started) return; + + if (activeRunIds.size > 0) { + logger.warn( + `[RunScheduler] stop() called with ${activeRunIds.size} active runs; heartbeats will stop and leases may expire/reclaim concurrently`, + ); + } + + started = false; + + if (pollTimer) { + clearInterval(pollTimer); + pollTimer = null; + } + + try { + deps.leaseManager.stopHeartbeat(deps.ownerId); + } catch (e) { + logger.warn('[RunScheduler] stopHeartbeat failed:', e); + } + + // Release keepalive + if (releaseKeepalive) { + try { + releaseKeepalive(); + } catch (e) { + logger.warn('[RunScheduler] keepalive release failed:', e); + } + releaseKeepalive = null; + } + } + + function kick(): Promise { + if (!started) return Promise.resolve(); + + pendingKick = true; + if (!pumpPromise) { + pumpPromise = pump(); + } + return pumpPromise; + } + + function getState(): RunSchedulerState { + return { + started, + ownerId: deps.ownerId, + maxParallelRuns, + activeRunIds: Array.from(activeRunIds), + }; + } + + function dispose(): void { + stop(); + activeRunIds.clear(); + } + + return { start, stop, kick, getState, dispose }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/index.ts new file mode 100644 index 00000000..2e5bba36 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/index.ts @@ -0,0 +1,6 @@ +/** + * @fileoverview Recovery module exports + * @description 崩溃恢复模块导出 + */ + +export * from './recovery-coordinator'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/recovery-coordinator.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/recovery-coordinator.ts new file mode 100644 index 00000000..45d9c7c2 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/recovery/recovery-coordinator.ts @@ -0,0 +1,260 @@ +/** + * @fileoverview 崩溃恢复协调器 (P3-06) + * @description + * MV3 Service Worker 可能随时被终止。此协调器在 SW 启动时协调队列状态和 Run 记录， + * 使中断的 Run 能够被恢复执行。 + * + * 恢复策略： + * - 孤儿 running 项：回收为 queued，等待重新调度（从头重跑） + * - 孤儿 paused 项：接管 lease，保持 paused 状态 + * - 已终态 Run 的队列残留：清理 + * + * 调用时机： + * - 必须在 scheduler.start() 之前调用 + * - 通常在 SW 启动时调用一次 + */ + +import type { UnixMillis } from '../../domain/json'; +import type { RunId } from '../../domain/ids'; +import { isTerminalStatus, type RunStatus } from '../../domain/events'; +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from '../transport/events-bus'; + +// ==================== Types ==================== + +/** + * 恢复结果 + */ +export interface RecoveryResult { + /** 被回收为 queued 的 running Run ID */ + requeuedRunning: RunId[]; + /** 被接管的 paused Run ID */ + adoptedPaused: RunId[]; + /** 被清理的已终态 Run ID */ + cleanedTerminal: RunId[]; +} + +/** + * 恢复协调器依赖 + */ +export interface RecoveryCoordinatorDeps { + /** 存储层 */ + storage: StoragePort; + /** 事件总线 */ + events: EventsBus; + /** 当前 Service Worker 的 ownerId */ + ownerId: string; + /** 时间源 */ + now: () => UnixMillis; + /** 日志器 */ + logger?: Pick; +} + +// ==================== Main Function ==================== + +/** + * 执行崩溃恢复 + * @description + * 在 SW 启动时调用，协调队列状态和 Run 记录。 + * + * 执行顺序： + * 1. 预清理：检查队列中的所有项，清理已终态或无对应 RunRecord 的残留 + * 2. 恢复孤儿租约：回收 running，接管 paused + * 3. 同步 RunRecord 状态：确保 RunRecord 与队列状态一致 + * 4. 发送恢复事件：为 requeued running 项发送 run.recovered 事件 + */ +export async function recoverFromCrash(deps: RecoveryCoordinatorDeps): Promise { + const logger = deps.logger ?? console; + + if (!deps.ownerId) { + throw new Error('ownerId is required'); + } + + const now = deps.now(); + + // 设计理由：恢复过程必须"先清理后接管/回收"，否则可能把已经终态的 Run 重新排队执行 + const cleanedTerminalSet = new Set(); + + // ==================== Step 1: 预清理 ==================== + // 检查队列中的所有项，清理已终态或无对应 RunRecord 的残留 + try { + const items = await deps.storage.queue.list(); + for (const item of items) { + const runId = item.id; + const run = await deps.storage.runs.get(runId); + + // 防御性清理：无 RunRecord 的队列项无法执行 + if (!run) { + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + logger.debug(`[Recovery] Cleaned orphan queue item without RunRecord: ${runId}`); + } catch (e) { + logger.warn('[Recovery] markDone for missing RunRecord failed:', runId, e); + } + continue; + } + + // 清理已终态的 Run（SW 可能在 runner 完成后、scheduler markDone 前崩溃） + if (isTerminalStatus(run.status)) { + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + logger.debug(`[Recovery] Cleaned terminal queue item: ${runId} (status=${run.status})`); + } catch (e) { + logger.warn('[Recovery] markDone for terminal run failed:', runId, e); + } + } + } + } catch (e) { + logger.warn('[Recovery] Pre-clean failed:', e); + } + + // ==================== Step 2: 恢复孤儿租约 ==================== + // Best-effort：即使失败也不应该阻止启动 + let requeuedRunning: Array<{ runId: RunId; prevOwnerId?: string }> = []; + let adoptedPaused: Array<{ runId: RunId; prevOwnerId?: string }> = []; + try { + const result = await deps.storage.queue.recoverOrphanLeases(deps.ownerId, now); + requeuedRunning = result.requeuedRunning; + adoptedPaused = result.adoptedPaused; + } catch (e) { + logger.error('[Recovery] recoverOrphanLeases failed:', e); + // 继续执行，不阻止启动 + } + + // ==================== Step 3: 同步 RunRecord 状态 ==================== + const requeuedRunningIds: RunId[] = []; + for (const entry of requeuedRunning) { + const runId = entry.runId; + requeuedRunningIds.push(runId); + + // 跳过在 Step 1 中已清理的项 + if (cleanedTerminalSet.has(runId)) { + continue; + } + + try { + const run = await deps.storage.runs.get(runId); + if (!run) { + // RunRecord 不存在，清理队列项（防御性） + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + } catch (markDoneErr) { + logger.warn( + '[Recovery] markDone for missing RunRecord in Step3 failed:', + runId, + markDoneErr, + ); + } + continue; + } + + // 跳过已终态的 Run（可能在恢复过程中被其他逻辑更新） + // 同时清理队列项，防止残留 + if (isTerminalStatus(run.status)) { + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + logger.debug( + `[Recovery] Cleaned terminal queue item in Step3: ${runId} (status=${run.status})`, + ); + } catch (markDoneErr) { + logger.warn('[Recovery] markDone for terminal run in Step3 failed:', runId, markDoneErr); + } + continue; + } + + // 更新 RunRecord 状态为 queued + await deps.storage.runs.patch(runId, { status: 'queued', updatedAt: now }); + + // 发送恢复事件（best-effort，失败不影响恢复流程） + try { + const fromStatus: 'running' | 'paused' = run.status === 'paused' ? 'paused' : 'running'; + await deps.events.append({ + runId, + type: 'run.recovered', + reason: 'sw_restart', + fromStatus, + toStatus: 'queued', + prevOwnerId: entry.prevOwnerId, + ts: now, + }); + logger.info(`[Recovery] Requeued orphan running run: ${runId} (from=${fromStatus})`); + } catch (eventErr) { + logger.warn('[Recovery] Failed to emit run.recovered event:', runId, eventErr); + // 继续执行，不影响恢复流程 + } + } catch (e) { + logger.warn('[Recovery] Reconcile requeued running failed:', runId, e); + } + } + + // ==================== Step 4: 同步 adopted paused 的 RunRecord ==================== + const adoptedPausedIds: RunId[] = []; + for (const entry of adoptedPaused) { + const runId = entry.runId; + adoptedPausedIds.push(runId); + + // 跳过在 Step 1 中已清理的项 + if (cleanedTerminalSet.has(runId)) { + continue; + } + + try { + const run = await deps.storage.runs.get(runId); + if (!run) { + // RunRecord 不存在，清理队列项（防御性） + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + } catch (markDoneErr) { + logger.warn( + '[Recovery] markDone for missing RunRecord in Step4 failed:', + runId, + markDoneErr, + ); + } + continue; + } + + // 跳过已终态的 Run，同时清理队列项 + if (isTerminalStatus(run.status)) { + try { + await deps.storage.queue.markDone(runId, now); + cleanedTerminalSet.add(runId); + logger.debug( + `[Recovery] Cleaned terminal queue item in Step4: ${runId} (status=${run.status})`, + ); + } catch (markDoneErr) { + logger.warn('[Recovery] markDone for terminal run in Step4 failed:', runId, markDoneErr); + } + continue; + } + + // 如果 RunRecord 状态不是 paused，同步更新 + if (run.status !== 'paused') { + await deps.storage.runs.patch(runId, { status: 'paused' as RunStatus, updatedAt: now }); + } + + logger.info(`[Recovery] Adopted orphan paused run: ${runId}`); + } catch (e) { + logger.warn('[Recovery] Reconcile adopted paused failed:', runId, e); + } + } + + const result: RecoveryResult = { + requeuedRunning: requeuedRunningIds, + adoptedPaused: adoptedPausedIds, + cleanedTerminal: Array.from(cleanedTerminalSet), + }; + + logger.info('[Recovery] Complete:', { + requeuedRunning: result.requeuedRunning.length, + adoptedPaused: result.adoptedPaused.length, + cleanedTerminal: result.cleanedTerminal.length, + }); + + return result; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/index.ts new file mode 100644 index 00000000..df3f3a7c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/index.ts @@ -0,0 +1,5 @@ +/** + * @fileoverview Engine Storage 模块导出入口 + */ + +export * from './storage-port'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/storage-port.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/storage-port.ts new file mode 100644 index 00000000..0ab9df65 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/storage/storage-port.ts @@ -0,0 +1,144 @@ +/** + * @fileoverview StoragePort 接口定义 + * @description 定义 Storage 层的抽象接口，用于依赖注入 + */ + +import type { FlowId, RunId, TriggerId } from '../../domain/ids'; +import type { FlowV3 } from '../../domain/flow'; +import type { RunEvent, RunEventInput, RunRecordV3 } from '../../domain/events'; +import type { PersistentVarRecord, PersistentVariableName } from '../../domain/variables'; +import type { TriggerSpec } from '../../domain/triggers'; +import type { RunQueue } from '../queue/queue'; + +/** + * FlowsStore 接口 + */ +export interface FlowsStore { + /** 列出所有 Flow */ + list(): Promise; + /** 获取单个 Flow */ + get(id: FlowId): Promise; + /** 保存 Flow */ + save(flow: FlowV3): Promise; + /** 删除 Flow */ + delete(id: FlowId): Promise; +} + +/** + * RunsStore 接口 + */ +export interface RunsStore { + /** 列出所有 Run 记录 */ + list(): Promise; + /** 获取单个 Run 记录 */ + get(id: RunId): Promise; + /** 保存 Run 记录 */ + save(record: RunRecordV3): Promise; + /** 部分更新 Run 记录 */ + patch(id: RunId, patch: Partial): Promise; +} + +/** + * EventsStore 接口 + * @description seq 分配必须由 append() 内部原子完成 + */ +export interface EventsStore { + /** + * 追加事件并原子分配 seq + * @description 在单个事务中：读取 RunRecordV3.nextSeq -> 写入事件 -> 递增 nextSeq + * @param event 事件输入（不含 seq） + * @returns 完整事件（含分配的 seq 和 ts） + */ + append(event: RunEventInput): Promise; + + /** + * 列出事件 + * @param runId Run ID + * @param opts 查询选项 + */ + list(runId: RunId, opts?: { fromSeq?: number; limit?: number }): Promise; +} + +/** + * PersistentVarsStore 接口 + */ +export interface PersistentVarsStore { + /** 获取持久化变量 */ + get(key: PersistentVariableName): Promise; + /** 设置持久化变量 */ + set( + key: PersistentVariableName, + value: PersistentVarRecord['value'], + ): Promise; + /** 删除持久化变量 */ + delete(key: PersistentVariableName): Promise; + /** 列出持久化变量 */ + list(prefix?: PersistentVariableName): Promise; +} + +/** + * TriggersStore 接口 + */ +export interface TriggersStore { + /** 列出所有触发器 */ + list(): Promise; + /** 获取单个触发器 */ + get(id: TriggerId): Promise; + /** 保存触发器 */ + save(spec: TriggerSpec): Promise; + /** 删除触发器 */ + delete(id: TriggerId): Promise; +} + +/** + * StoragePort 接口 + * @description 聚合所有存储接口，用于依赖注入 + */ +export interface StoragePort { + /** Flows 存储 */ + flows: FlowsStore; + /** Runs 存储 */ + runs: RunsStore; + /** Events 存储 */ + events: EventsStore; + /** Queue 存储 */ + queue: RunQueue; + /** 持久化变量存储 */ + persistentVars: PersistentVarsStore; + /** 触发器存储 */ + triggers: TriggersStore; +} + +/** + * 创建 NotImplemented 的 Store + * @description 避免 Proxy 生成 'then' 导致 thenable 行为 + */ +function createNotImplementedStore(name: string): T { + const target = {} as T; + return new Proxy(target, { + get(_, prop) { + // Avoid thenable behavior by returning undefined for 'then' + if (prop === 'then') { + return undefined; + } + return async () => { + throw new Error(`${name}.${String(prop)} not implemented`); + }; + }, + }); +} + +/** + * 创建 NotImplemented 的 StoragePort + * @description Phase 0 占位实现 + */ +export function createNotImplementedStoragePort(): StoragePort { + return { + flows: createNotImplementedStore('FlowsStore'), + runs: createNotImplementedStore('RunsStore'), + events: createNotImplementedStore('EventsStore'), + queue: createNotImplementedStore('RunQueue'), + persistentVars: createNotImplementedStore('PersistentVarsStore'), + triggers: createNotImplementedStore('TriggersStore'), + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/events-bus.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/events-bus.ts new file mode 100644 index 00000000..2ecd93d0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/events-bus.ts @@ -0,0 +1,222 @@ +/** + * @fileoverview EventsBus Interface and Implementation + * @description Event subscription, publishing, and persistence + */ + +import type { RunId } from '../../domain/ids'; +import type { RunEvent, RunEventInput, Unsubscribe } from '../../domain/events'; +import type { EventsStore } from '../storage/storage-port'; + +/** + * Event query parameters + */ +export interface EventsQuery { + /** Run ID */ + runId: RunId; + /** Starting sequence number (inclusive) */ + fromSeq?: number; + /** Maximum number of results */ + limit?: number; +} + +/** + * Subscription filter + */ +export interface EventsFilter { + /** Only receive events for this Run */ + runId?: RunId; +} + +/** + * EventsBus Interface + * @description Responsible for event subscription, publishing, and persistence + */ +export interface EventsBus { + /** + * Subscribe to events + * @param listener Event listener + * @param filter Optional filter + * @returns Unsubscribe function + */ + subscribe(listener: (event: RunEvent) => void, filter?: EventsFilter): Unsubscribe; + + /** + * Append event + * @description Delegates to EventsStore for atomic seq allocation, then broadcasts + * @param event Event input (without seq) + * @returns Complete event (with seq and ts) + */ + append(event: RunEventInput): Promise; + + /** + * Query historical events + * @param query Query parameters + * @returns Events sorted by seq ascending + */ + list(query: EventsQuery): Promise; +} + +/** + * Create NotImplemented EventsBus + * @description Phase 0 placeholder + */ +export function createNotImplementedEventsBus(): EventsBus { + const notImplemented = () => { + throw new Error('EventsBus not implemented'); + }; + + return { + subscribe: () => { + notImplemented(); + return () => {}; + }, + append: async () => notImplemented(), + list: async () => notImplemented(), + }; +} + +/** + * Listener entry for subscription management + */ +interface ListenerEntry { + listener: (event: RunEvent) => void; + filter?: EventsFilter; +} + +/** + * Storage-backed EventsBus Implementation + * @description + * - seq allocation is done by EventsStore.append() (atomic with RunRecordV3.nextSeq) + * - broadcast happens only after append resolves (i.e. after commit) + */ +export class StorageBackedEventsBus implements EventsBus { + private listeners = new Set(); + + constructor(private readonly store: EventsStore) {} + + subscribe(listener: (event: RunEvent) => void, filter?: EventsFilter): Unsubscribe { + const entry: ListenerEntry = { listener, filter }; + this.listeners.add(entry); + return () => { + this.listeners.delete(entry); + }; + } + + async append(input: RunEventInput): Promise { + // Delegate to storage for atomic seq allocation + const event = await this.store.append(input); + + // Broadcast after successful commit + this.broadcast(event); + + return event; + } + + async list(query: EventsQuery): Promise { + return this.store.list(query.runId, { + fromSeq: query.fromSeq, + limit: query.limit, + }); + } + + /** + * Broadcast event to all matching listeners + */ + private broadcast(event: RunEvent): void { + const { runId } = event; + for (const { listener, filter } of this.listeners) { + if (!filter || !filter.runId || filter.runId === runId) { + try { + listener(event); + } catch (error) { + console.error('[StorageBackedEventsBus] Listener error:', error); + } + } + } + } +} + +/** + * In-memory EventsBus for testing + * @description Uses internal seq counter, NOT suitable for production + * @deprecated Use StorageBackedEventsBus with mock EventsStore for testing + */ +export class InMemoryEventsBus implements EventsBus { + private events = new Map(); + private seqCounters = new Map(); + private listeners = new Set(); + + subscribe(listener: (event: RunEvent) => void, filter?: EventsFilter): Unsubscribe { + const entry: ListenerEntry = { listener, filter }; + this.listeners.add(entry); + return () => { + this.listeners.delete(entry); + }; + } + + async append(input: RunEventInput): Promise { + const { runId } = input; + + // Allocate seq (NOT atomic, for testing only) + const currentSeq = this.seqCounters.get(runId) ?? 0; + const seq = currentSeq + 1; + this.seqCounters.set(runId, seq); + + // Create complete event + const event: RunEvent = { + ...input, + seq, + ts: input.ts ?? Date.now(), + } as RunEvent; + + // Store + const runEvents = this.events.get(runId) ?? []; + runEvents.push(event); + this.events.set(runId, runEvents); + + // Broadcast + for (const { listener, filter } of this.listeners) { + if (!filter || !filter.runId || filter.runId === runId) { + try { + listener(event); + } catch (error) { + console.error('[InMemoryEventsBus] Listener error:', error); + } + } + } + + return event; + } + + async list(query: EventsQuery): Promise { + const runEvents = this.events.get(query.runId) ?? []; + + let result = runEvents; + + if (query.fromSeq !== undefined) { + result = result.filter((e) => e.seq >= query.fromSeq!); + } + + if (query.limit !== undefined) { + result = result.slice(0, query.limit); + } + + return result; + } + + /** + * Clear all data (for testing) + */ + clear(): void { + this.events.clear(); + this.seqCounters.clear(); + this.listeners.clear(); + } + + /** + * Get current seq for a run (for testing) + */ + getSeq(runId: RunId): number { + return this.seqCounters.get(runId) ?? 0; + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/index.ts new file mode 100644 index 00000000..f9a62c53 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/index.ts @@ -0,0 +1,7 @@ +/** + * @fileoverview Transport 模块导出入口 + */ + +export * from './rpc'; +export * from './rpc-server'; +export * from './events-bus'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc-server.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc-server.ts new file mode 100644 index 00000000..810fcd11 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc-server.ts @@ -0,0 +1,1168 @@ +/** + * @fileoverview RPC Server Implementation + * @description Handles RPC requests from UI via chrome.runtime.Port + */ + +import type { ISODateTimeString, JsonObject, JsonValue } from '../../domain/json'; +import type { EdgeId, FlowId, NodeId, RunId, TriggerId } from '../../domain/ids'; +import type { DebuggerCommand } from '../../domain/debug'; +import type { RunEvent } from '../../domain/events'; +import type { FlowV3, NodeV3, EdgeV3 } from '../../domain/flow'; +import { FLOW_SCHEMA_VERSION as CURRENT_FLOW_SCHEMA_VERSION } from '../../domain/flow'; +import type { VariableDefinition } from '../../domain/variables'; +import type { TriggerKind, TriggerSpec } from '../../domain/triggers'; +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from './events-bus'; +import type { DebugController, RunnerRegistry } from '../kernel/debug-controller'; +import type { RunScheduler } from '../queue/scheduler'; +import type { QueueItemStatus } from '../queue/queue'; +import { enqueueRun } from '../queue/enqueue-run'; +import type { TriggerManager } from '../triggers/trigger-manager'; +import { + RR_V3_PORT_NAME, + isRpcRequest, + createRpcResponseOk, + createRpcResponseErr, + createRpcEventMessage, + type RpcRequest, +} from './rpc'; + +/** + * RPC Server 配置 + */ +export interface RpcServerConfig { + storage: StoragePort; + events: EventsBus; + debugController?: DebugController; + runners?: RunnerRegistry; + scheduler?: RunScheduler; + triggerManager?: TriggerManager; + /** ID 生成器（用于测试注入） */ + generateRunId?: () => RunId; + /** 时间源（用于测试注入） */ + now?: () => number; +} + +/** + * 活跃的 Port 连接 + */ +interface PortConnection { + port: chrome.runtime.Port; + subscriptions: Set; // null means subscribe to all +} + +/** + * 默认 RunId 生成器 + */ +function defaultGenerateRunId(): RunId { + return `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; +} + +/** + * RPC Server + * @description 处理来自 UI 的 RPC 请求 + */ +export class RpcServer { + private readonly storage: StoragePort; + private readonly events: EventsBus; + private readonly debugController?: DebugController; + private readonly runners?: RunnerRegistry; + private readonly scheduler?: RunScheduler; + private readonly triggerManager?: TriggerManager; + private readonly generateRunId: () => RunId; + private readonly now: () => number; + private readonly connections = new Map(); + private eventUnsubscribe: (() => void) | null = null; + + constructor(config: RpcServerConfig) { + this.storage = config.storage; + this.events = config.events; + this.debugController = config.debugController; + this.runners = config.runners; + this.scheduler = config.scheduler; + this.triggerManager = config.triggerManager; + this.generateRunId = config.generateRunId ?? defaultGenerateRunId; + this.now = config.now ?? Date.now; + } + + /** + * 启动 RPC Server + */ + start(): void { + chrome.runtime.onConnect.addListener(this.handleConnect); + + // Subscribe to all events and broadcast to connected ports + this.eventUnsubscribe = this.events.subscribe((event) => { + this.broadcastEvent(event); + }); + } + + /** + * 停止 RPC Server + */ + stop(): void { + chrome.runtime.onConnect.removeListener(this.handleConnect); + + if (this.eventUnsubscribe) { + this.eventUnsubscribe(); + this.eventUnsubscribe = null; + } + + // Disconnect all ports + for (const conn of this.connections.values()) { + conn.port.disconnect(); + } + this.connections.clear(); + } + + /** + * 处理新连接 + */ + private handleConnect = (port: chrome.runtime.Port): void => { + if (port.name !== RR_V3_PORT_NAME) return; + + const connId = `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; + const connection: PortConnection = { + port, + subscriptions: new Set(), + }; + + this.connections.set(connId, connection); + + port.onMessage.addListener((msg) => this.handleMessage(connId, msg)); + port.onDisconnect.addListener(() => this.handleDisconnect(connId)); + }; + + /** + * 处理消息 + */ + private handleMessage = async (connId: string, msg: unknown): Promise => { + if (!isRpcRequest(msg)) return; + + const conn = this.connections.get(connId); + if (!conn) return; + + try { + const result = await this.handleRequest(msg, conn); + conn.port.postMessage(createRpcResponseOk(msg.requestId, result)); + } catch (e) { + const error = e instanceof Error ? e.message : String(e); + conn.port.postMessage(createRpcResponseErr(msg.requestId, error)); + } + }; + + /** + * 处理断开连接 + */ + private handleDisconnect = (connId: string): void => { + this.connections.delete(connId); + }; + + /** + * 广播事件 + */ + private broadcastEvent(event: RunEvent): void { + const message = createRpcEventMessage(event); + + for (const conn of this.connections.values()) { + // Check if this connection subscribed to this event + const subs = conn.subscriptions; + if (subs.size === 0) continue; // No subscriptions + if (subs.has(null) || subs.has(event.runId)) { + try { + conn.port.postMessage(message); + } catch { + // Port may be disconnected + } + } + } + } + + // ===== Queue Management Handlers ===== + + /** + * 处理 enqueueRun 请求 + * @description 委托给共享的 enqueueRun 服务 + */ + private async handleEnqueueRun(params: JsonObject | undefined): Promise { + const result = await enqueueRun( + { + storage: this.storage, + events: this.events, + scheduler: this.scheduler, + generateRunId: this.generateRunId, + now: this.now, + }, + { + flowId: params?.flowId as FlowId, + startNodeId: params?.startNodeId as NodeId | undefined, + priority: params?.priority as number | undefined, + maxAttempts: params?.maxAttempts as number | undefined, + args: params?.args as JsonObject | undefined, + debug: params?.debug as { breakpoints?: string[]; pauseOnStart?: boolean } | undefined, + }, + ); + + return result as unknown as JsonValue; + } + + /** + * 处理 listQueue 请求 + * @description 列出队列项，按 priority DESC + createdAt ASC 排序 + */ + private async handleListQueue(params: JsonObject | undefined): Promise { + const rawStatus = params?.status; + + // 校验 status 白名单 + let status: QueueItemStatus | undefined; + if (rawStatus !== undefined) { + if (rawStatus !== 'queued' && rawStatus !== 'running' && rawStatus !== 'paused') { + throw new Error('status must be one of: queued, running, paused'); + } + status = rawStatus; + } + + const items = await this.storage.queue.list(status); + + // 按 priority DESC + createdAt ASC 排序 + items.sort((a, b) => { + if (a.priority !== b.priority) { + return b.priority - a.priority; // DESC + } + return a.createdAt - b.createdAt; // ASC (FIFO) + }); + + return items as unknown as JsonValue; + } + + /** + * 处理 cancelQueueItem 请求 + * @description 取消排队中的队列项，更新 Run 状态，发布 run.canceled 事件 + * @note 仅允许取消 status=queued 的项；running/paused 需使用 rr_v3.cancelRun + */ + private async handleCancelQueueItem(params: JsonObject | undefined): Promise { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + + const reason = params?.reason as string | undefined; + const now = this.now(); + + // 1. 检查队列项存在 + const queueItem = await this.storage.queue.get(runId); + if (!queueItem) { + throw new Error(`Queue item "${runId}" not found`); + } + + // 2. 仅允许取消 queued 状态（running/paused 需使用 rr_v3.cancelRun） + if (queueItem.status !== 'queued') { + throw new Error( + `Cannot cancel queue item "${runId}" with status "${queueItem.status}"; use rr_v3.cancelRun for running/paused runs`, + ); + } + + // 3. 从队列移除 + await this.storage.queue.cancel(runId, now, reason); + + // 4. 更新 Run 记录状态 + await this.storage.runs.patch(runId, { + status: 'canceled', + updatedAt: now, + finishedAt: now, + }); + + // 5. 发布 run.canceled 事件（通过 EventsBus 以确保广播） + await this.events.append({ + runId, + type: 'run.canceled', + reason, + }); + + return { ok: true, runId }; + } + + /** + * 处理 RPC 请求 + */ + private async handleRequest(request: RpcRequest, conn: PortConnection): Promise { + const { method, params } = request; + + switch (method) { + case 'rr_v3.listRuns': { + const runs = await this.storage.runs.list(); + return runs as unknown as JsonValue; + } + + case 'rr_v3.getRun': { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + const run = await this.storage.runs.get(runId); + return run as unknown as JsonValue; + } + + case 'rr_v3.getEvents': { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + const fromSeq = params?.fromSeq as number | undefined; + const limit = params?.limit as number | undefined; + const events = await this.storage.events.list(runId, { fromSeq, limit }); + return events as unknown as JsonValue; + } + + case 'rr_v3.getFlow': { + const flowId = params?.flowId as FlowId | undefined; + if (!flowId) throw new Error('flowId is required'); + const flow = await this.storage.flows.get(flowId); + return flow as unknown as JsonValue; + } + + case 'rr_v3.listFlows': { + const flows = await this.storage.flows.list(); + return flows as unknown as JsonValue; + } + + case 'rr_v3.saveFlow': { + return this.handleSaveFlow(params); + } + + case 'rr_v3.deleteFlow': { + return this.handleDeleteFlow(params); + } + + // ===== Trigger APIs ===== + + case 'rr_v3.createTrigger': + return this.handleCreateTrigger(params); + + case 'rr_v3.updateTrigger': + return this.handleUpdateTrigger(params); + + case 'rr_v3.deleteTrigger': + return this.handleDeleteTrigger(params); + + case 'rr_v3.getTrigger': + return this.handleGetTrigger(params); + + case 'rr_v3.listTriggers': + return this.handleListTriggers(params); + + case 'rr_v3.enableTrigger': + return this.handleEnableTrigger(params); + + case 'rr_v3.disableTrigger': + return this.handleDisableTrigger(params); + + case 'rr_v3.fireTrigger': + return this.handleFireTrigger(params); + + // ===== Queue Management APIs ===== + + case 'rr_v3.enqueueRun': { + return this.handleEnqueueRun(params); + } + + case 'rr_v3.listQueue': { + return this.handleListQueue(params); + } + + case 'rr_v3.cancelQueueItem': { + return this.handleCancelQueueItem(params); + } + + case 'rr_v3.subscribe': { + const runId = (params?.runId as RunId | undefined) ?? null; + conn.subscriptions.add(runId); + return { subscribed: true, runId }; + } + + case 'rr_v3.unsubscribe': { + const runId = (params?.runId as RunId | undefined) ?? null; + conn.subscriptions.delete(runId); + return { unsubscribed: true, runId }; + } + + // Debug method - route to DebugController + case 'rr_v3.debug': { + if (!this.debugController) { + throw new Error('DebugController not configured'); + } + const cmd = params as unknown as DebuggerCommand; + if (!cmd || !cmd.type) { + throw new Error('Invalid debug command'); + } + const response = await this.debugController.handle(cmd); + return response as unknown as JsonValue; + } + + // Control methods + case 'rr_v3.startRun': + // startRun is essentially enqueueRun - the run starts when claimed by scheduler + return this.handleEnqueueRun(params); + + case 'rr_v3.pauseRun': + return this.handlePauseRun(params); + + case 'rr_v3.resumeRun': + return this.handleResumeRun(params); + + case 'rr_v3.cancelRun': + return this.handleCancelRun(params); + + default: + throw new Error(`Unknown method: ${method}`); + } + } + + // ===== Flow Management Handlers ===== + + /** + * 处理 saveFlow 请求 + * @description 保存或更新 Flow，执行完整的结构验证 + */ + private async handleSaveFlow(params: JsonObject | undefined): Promise { + const rawFlow = params?.flow; + if (!rawFlow || typeof rawFlow !== 'object' || Array.isArray(rawFlow)) { + throw new Error('flow is required'); + } + + // 检查是否为更新现有 flow（使用 trim 后的 ID 查询） + const rawId = (rawFlow as JsonObject).id; + let existingFlow: FlowV3 | null = null; + if (typeof rawId === 'string' && rawId.trim()) { + existingFlow = await this.storage.flows.get(rawId.trim() as FlowId); + } + + // 规范化 flow，传入 existingFlow 以继承 createdAt + const flow = this.normalizeFlowSpec(rawFlow, existingFlow); + + // 保存到存储（存储层会执行二次验证） + await this.storage.flows.save(flow); + + return flow as unknown as JsonValue; + } + + /** + * 处理 deleteFlow 请求 + * @description 删除 Flow，先检查是否有关联的 Trigger 和 queued runs + */ + private async handleDeleteFlow(params: JsonObject | undefined): Promise { + const flowId = params?.flowId as FlowId | undefined; + if (!flowId) throw new Error('flowId is required'); + + // 检查 Flow 是否存在 + const existing = await this.storage.flows.get(flowId); + if (!existing) { + throw new Error(`Flow "${flowId}" not found`); + } + + // 检查是否有关联的 Trigger + const triggers = await this.storage.triggers.list(); + const linkedTriggers = triggers.filter((t) => t.flowId === flowId); + if (linkedTriggers.length > 0) { + const triggerIds = linkedTriggers.map((t) => t.id).join(', '); + throw new Error( + `Cannot delete flow "${flowId}": it has ${linkedTriggers.length} linked trigger(s): ${triggerIds}. ` + + `Delete the trigger(s) first.`, + ); + } + + // 检查是否有 queued runs（未执行的 runs 删除后会失败） + const queuedItems = await this.storage.queue.list('queued'); + const linkedQueuedRuns = queuedItems.filter((item) => item.flowId === flowId); + if (linkedQueuedRuns.length > 0) { + const runIds = linkedQueuedRuns.map((r) => r.id).join(', '); + throw new Error( + `Cannot delete flow "${flowId}": it has ${linkedQueuedRuns.length} queued run(s): ${runIds}. ` + + `Cancel the run(s) first or wait for them to complete.`, + ); + } + + // 删除 Flow + await this.storage.flows.delete(flowId); + + return { ok: true, flowId }; + } + + /** + * 规范化 FlowV3 输入 + * @description 验证并转换输入为完整的 FlowV3 结构 + * @param value 原始输入 + * @param existingFlow 已存在的 flow（用于继承 createdAt） + */ + private normalizeFlowSpec(value: unknown, existingFlow: FlowV3 | null = null): FlowV3 { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + throw new Error('flow is required'); + } + const raw = value as JsonObject; + + // id 校验与生成 + let id: FlowId; + if (raw.id === undefined || raw.id === null) { + id = `flow_${Date.now()}_${Math.random().toString(36).slice(2, 8)}` as FlowId; + } else { + if (typeof raw.id !== 'string' || !raw.id.trim()) { + throw new Error('flow.id must be a non-empty string'); + } + id = raw.id.trim() as FlowId; + } + + // name 校验 + if (!raw.name || typeof raw.name !== 'string' || !raw.name.trim()) { + throw new Error('flow.name is required'); + } + const name = raw.name.trim(); + + // description 校验 + let description: string | undefined; + if (raw.description !== undefined && raw.description !== null) { + if (typeof raw.description !== 'string') { + throw new Error('flow.description must be a string'); + } + description = raw.description; + } + + // entryNodeId 校验 + if (!raw.entryNodeId || typeof raw.entryNodeId !== 'string' || !raw.entryNodeId.trim()) { + throw new Error('flow.entryNodeId is required'); + } + const entryNodeId = raw.entryNodeId.trim() as NodeId; + + // nodes 校验 + if (!Array.isArray(raw.nodes)) { + throw new Error('flow.nodes must be an array'); + } + const nodes = raw.nodes.map((n, i) => this.normalizeNode(n, i)); + + // 验证 node ID 唯一性 + const nodeIdSet = new Set(); + for (const node of nodes) { + if (nodeIdSet.has(node.id)) { + throw new Error(`Duplicate node ID: "${node.id}"`); + } + nodeIdSet.add(node.id); + } + + // edges 校验 + let edges: EdgeV3[] = []; + if (raw.edges !== undefined && raw.edges !== null) { + if (!Array.isArray(raw.edges)) { + throw new Error('flow.edges must be an array'); + } + edges = raw.edges.map((e, i) => this.normalizeEdge(e, i)); + } + + // 验证 edge ID 唯一性 + const edgeIdSet = new Set(); + for (const edge of edges) { + if (edgeIdSet.has(edge.id)) { + throw new Error(`Duplicate edge ID: "${edge.id}"`); + } + edgeIdSet.add(edge.id); + } + + // 验证 entryNodeId 存在 + if (!nodeIdSet.has(entryNodeId)) { + throw new Error(`Entry node "${entryNodeId}" does not exist in flow`); + } + + // 验证边引用 + for (const edge of edges) { + if (!nodeIdSet.has(edge.from)) { + throw new Error(`Edge "${edge.id}" references non-existent source node "${edge.from}"`); + } + if (!nodeIdSet.has(edge.to)) { + throw new Error(`Edge "${edge.id}" references non-existent target node "${edge.to}"`); + } + } + + // 时间戳：更新时继承 existingFlow.createdAt，新建时用当前时间 + const now = new Date(this.now()).toISOString() as ISODateTimeString; + const createdAt = existingFlow?.createdAt ?? now; + const updatedAt = now; + + // 构建完整的 FlowV3 + const flow: FlowV3 = { + schemaVersion: CURRENT_FLOW_SCHEMA_VERSION, + id, + name, + createdAt, + updatedAt, + entryNodeId, + nodes, + edges, + }; + + // 可选字段 + if (description !== undefined) { + flow.description = description; + } + + // variables 验证：每项必须是 object 且有 name 字段 + if (raw.variables !== undefined && raw.variables !== null) { + if (!Array.isArray(raw.variables)) { + throw new Error('flow.variables must be an array'); + } + const variables: VariableDefinition[] = []; + const varNameSet = new Set(); + for (let i = 0; i < raw.variables.length; i++) { + const v = raw.variables[i]; + if (!v || typeof v !== 'object' || Array.isArray(v)) { + throw new Error(`flow.variables[${i}] must be an object`); + } + const varObj = v as JsonObject; + if (!varObj.name || typeof varObj.name !== 'string' || !varObj.name.trim()) { + throw new Error(`flow.variables[${i}].name is required`); + } + const varName = varObj.name.trim(); + if (varNameSet.has(varName)) { + throw new Error(`Duplicate variable name: "${varName}"`); + } + varNameSet.add(varName); + // 使用 trim 后的 name + variables.push({ ...varObj, name: varName } as unknown as VariableDefinition); + } + if (variables.length > 0) { + flow.variables = variables; + } + } + + if (raw.policy !== undefined && raw.policy !== null) { + if (typeof raw.policy !== 'object' || Array.isArray(raw.policy)) { + throw new Error('flow.policy must be an object'); + } + flow.policy = raw.policy as FlowV3['policy']; + } + if (raw.meta !== undefined && raw.meta !== null) { + if (typeof raw.meta !== 'object' || Array.isArray(raw.meta)) { + throw new Error('flow.meta must be an object'); + } + flow.meta = raw.meta as FlowV3['meta']; + } + + return flow; + } + + /** + * 规范化 Node 输入 + */ + private normalizeNode(value: unknown, index: number): NodeV3 { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + throw new Error(`flow.nodes[${index}] must be an object`); + } + const raw = value as JsonObject; + + // id 校验（非空 + trim） + if (!raw.id || typeof raw.id !== 'string' || !raw.id.trim()) { + throw new Error(`flow.nodes[${index}].id is required`); + } + const nodeId = raw.id.trim() as NodeId; + + // kind 校验（非空 + trim） + if (!raw.kind || typeof raw.kind !== 'string' || !raw.kind.trim()) { + throw new Error(`flow.nodes[${index}].kind is required`); + } + const kind = raw.kind.trim(); + + // config 校验 + if (raw.config !== undefined && raw.config !== null) { + if (typeof raw.config !== 'object' || Array.isArray(raw.config)) { + throw new Error(`flow.nodes[${index}].config must be an object`); + } + } + + const node: NodeV3 = { + id: nodeId, + kind, + config: (raw.config as JsonObject) ?? {}, + }; + + // 可选字段 + if (raw.name !== undefined && raw.name !== null) { + if (typeof raw.name !== 'string') { + throw new Error(`flow.nodes[${index}].name must be a string`); + } + node.name = raw.name; + } + if (raw.disabled !== undefined && raw.disabled !== null) { + if (typeof raw.disabled !== 'boolean') { + throw new Error(`flow.nodes[${index}].disabled must be a boolean`); + } + node.disabled = raw.disabled; + } + if (raw.policy !== undefined && raw.policy !== null) { + if (typeof raw.policy !== 'object' || Array.isArray(raw.policy)) { + throw new Error(`flow.nodes[${index}].policy must be an object`); + } + node.policy = raw.policy as NodeV3['policy']; + } + if (raw.ui !== undefined && raw.ui !== null) { + if (typeof raw.ui !== 'object' || Array.isArray(raw.ui)) { + throw new Error(`flow.nodes[${index}].ui must be an object`); + } + node.ui = raw.ui as NodeV3['ui']; + } + + return node; + } + + /** + * 规范化 Edge 输入 + */ + private normalizeEdge(value: unknown, index: number): EdgeV3 { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + throw new Error(`flow.edges[${index}] must be an object`); + } + const raw = value as JsonObject; + + // id 校验或生成（非空 + trim） + let id: EdgeId; + if (raw.id === undefined || raw.id === null) { + id = `edge_${index}_${Math.random().toString(36).slice(2, 8)}` as EdgeId; + } else { + if (typeof raw.id !== 'string' || !raw.id.trim()) { + throw new Error(`flow.edges[${index}].id must be a non-empty string`); + } + id = raw.id.trim() as EdgeId; + } + + // from 校验（非空 + trim） + if (!raw.from || typeof raw.from !== 'string' || !raw.from.trim()) { + throw new Error(`flow.edges[${index}].from is required`); + } + const from = raw.from.trim() as NodeId; + + // to 校验（非空 + trim） + if (!raw.to || typeof raw.to !== 'string' || !raw.to.trim()) { + throw new Error(`flow.edges[${index}].to is required`); + } + const to = raw.to.trim() as NodeId; + + const edge: EdgeV3 = { + id, + from, + to, + }; + + // label 可选 + if (raw.label !== undefined && raw.label !== null) { + if (typeof raw.label !== 'string') { + throw new Error(`flow.edges[${index}].label must be a string`); + } + edge.label = raw.label as EdgeV3['label']; + } + + return edge; + } + + // ===== Trigger Management Handlers ===== + + private requireTriggerManager(): TriggerManager { + if (!this.triggerManager) { + throw new Error('TriggerManager not configured'); + } + return this.triggerManager; + } + + private async handleCreateTrigger(params: JsonObject | undefined): Promise { + const trigger = this.normalizeTriggerSpec(params?.trigger, { requireId: false }); + + const existing = await this.storage.triggers.get(trigger.id); + if (existing) { + throw new Error(`Trigger "${trigger.id}" already exists`); + } + + const flow = await this.storage.flows.get(trigger.flowId); + if (!flow) { + throw new Error(`Flow "${trigger.flowId}" not found`); + } + + await this.storage.triggers.save(trigger); + await this.requireTriggerManager().refresh(); + return trigger as unknown as JsonValue; + } + + private async handleUpdateTrigger(params: JsonObject | undefined): Promise { + const trigger = this.normalizeTriggerSpec(params?.trigger, { requireId: true }); + + const existing = await this.storage.triggers.get(trigger.id); + if (!existing) { + throw new Error(`Trigger "${trigger.id}" not found`); + } + + const flow = await this.storage.flows.get(trigger.flowId); + if (!flow) { + throw new Error(`Flow "${trigger.flowId}" not found`); + } + + await this.storage.triggers.save(trigger); + await this.requireTriggerManager().refresh(); + return trigger as unknown as JsonValue; + } + + private async handleDeleteTrigger(params: JsonObject | undefined): Promise { + const triggerId = params?.triggerId as TriggerId | undefined; + if (!triggerId) throw new Error('triggerId is required'); + + await this.storage.triggers.delete(triggerId); + await this.requireTriggerManager().refresh(); + return { ok: true, triggerId }; + } + + private async handleGetTrigger(params: JsonObject | undefined): Promise { + const triggerId = params?.triggerId as TriggerId | undefined; + if (!triggerId) throw new Error('triggerId is required'); + const trigger = await this.storage.triggers.get(triggerId); + return trigger as unknown as JsonValue; + } + + private async handleListTriggers(params: JsonObject | undefined): Promise { + const flowIdValue = params?.flowId; + let flowId: FlowId | undefined; + if (flowIdValue !== undefined && flowIdValue !== null) { + if (typeof flowIdValue !== 'string') { + throw new Error('flowId must be a string'); + } + flowId = flowIdValue as FlowId; + } + + const triggers = await this.storage.triggers.list(); + const filtered = flowId ? triggers.filter((t) => t.flowId === flowId) : triggers; + return filtered as unknown as JsonValue; + } + + private async handleEnableTrigger(params: JsonObject | undefined): Promise { + const triggerId = params?.triggerId as TriggerId | undefined; + if (!triggerId) throw new Error('triggerId is required'); + + const trigger = await this.storage.triggers.get(triggerId); + if (!trigger) { + throw new Error(`Trigger "${triggerId}" not found`); + } + + const updated: TriggerSpec = { ...trigger, enabled: true }; + await this.storage.triggers.save(updated); + await this.requireTriggerManager().refresh(); + return updated as unknown as JsonValue; + } + + private async handleDisableTrigger(params: JsonObject | undefined): Promise { + const triggerId = params?.triggerId as TriggerId | undefined; + if (!triggerId) throw new Error('triggerId is required'); + + const trigger = await this.storage.triggers.get(triggerId); + if (!trigger) { + throw new Error(`Trigger "${triggerId}" not found`); + } + + const updated: TriggerSpec = { ...trigger, enabled: false }; + await this.storage.triggers.save(updated); + await this.requireTriggerManager().refresh(); + return updated as unknown as JsonValue; + } + + private async handleFireTrigger(params: JsonObject | undefined): Promise { + const triggerId = params?.triggerId as TriggerId | undefined; + if (!triggerId) throw new Error('triggerId is required'); + + const trigger = await this.storage.triggers.get(triggerId); + if (!trigger) { + throw new Error(`Trigger "${triggerId}" not found`); + } + if (trigger.kind !== 'manual') { + throw new Error(`fireTrigger only supports manual triggers (got kind="${trigger.kind}")`); + } + if (!trigger.enabled) { + throw new Error(`Trigger "${triggerId}" is disabled`); + } + + let sourceTabId: number | undefined; + if (params?.sourceTabId !== undefined && params?.sourceTabId !== null) { + if (typeof params.sourceTabId !== 'number' || !Number.isFinite(params.sourceTabId)) { + throw new Error('sourceTabId must be a finite number'); + } + sourceTabId = Math.floor(params.sourceTabId); + } + + let sourceUrl: string | undefined; + if (params?.sourceUrl !== undefined && params?.sourceUrl !== null) { + if (typeof params.sourceUrl !== 'string') { + throw new Error('sourceUrl must be a string'); + } + sourceUrl = params.sourceUrl; + } + + const result = await this.requireTriggerManager().fire(triggerId, { + sourceTabId, + sourceUrl, + }); + return result as unknown as JsonValue; + } + + /** + * 规范化 TriggerSpec 输入 + */ + private normalizeTriggerSpec(value: unknown, opts: { requireId: boolean }): TriggerSpec { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + throw new Error('trigger is required'); + } + const raw = value as JsonObject; + + // kind 校验 + const kind = raw.kind; + if (!kind || typeof kind !== 'string') { + throw new Error('trigger.kind is required'); + } + + // flowId 校验 + const flowId = raw.flowId; + if (!flowId || typeof flowId !== 'string') { + throw new Error('trigger.flowId is required'); + } + + // id 校验 + let id: TriggerId; + if (raw.id === undefined || raw.id === null) { + if (opts.requireId) { + throw new Error('trigger.id is required'); + } + id = `trg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}` as TriggerId; + } else { + if (typeof raw.id !== 'string' || !raw.id.trim()) { + throw new Error('trigger.id must be a non-empty string'); + } + id = raw.id as TriggerId; + } + + // enabled 校验 + let enabled = true; + if (raw.enabled !== undefined && raw.enabled !== null) { + if (typeof raw.enabled !== 'boolean') { + throw new Error('trigger.enabled must be a boolean'); + } + enabled = raw.enabled; + } + + // args 校验 + let args: JsonObject | undefined; + if (raw.args !== undefined && raw.args !== null) { + if (typeof raw.args !== 'object' || Array.isArray(raw.args)) { + throw new Error('trigger.args must be an object'); + } + args = raw.args as JsonObject; + } + + // 基础字段 + const base = { id, kind: kind as TriggerKind, enabled, flowId: flowId as FlowId, args }; + + // 根据 kind 添加特定字段 + switch (kind) { + case 'manual': + return base as TriggerSpec; + + case 'url': { + let match: unknown[] = []; + if (raw.match !== undefined && raw.match !== null) { + if (!Array.isArray(raw.match)) { + throw new Error('trigger.match must be an array'); + } + match = raw.match; + } + return { ...base, match } as TriggerSpec; + } + + case 'cron': { + if (!raw.cron || typeof raw.cron !== 'string') { + throw new Error('trigger.cron is required for cron triggers'); + } + let timezone: string | undefined; + if (raw.timezone !== undefined && raw.timezone !== null) { + if (typeof raw.timezone !== 'string') { + throw new Error('trigger.timezone must be a string'); + } + timezone = raw.timezone.trim() || undefined; + } + return { ...base, cron: raw.cron, timezone } as TriggerSpec; + } + + case 'interval': { + if (raw.periodMinutes === undefined || raw.periodMinutes === null) { + throw new Error('trigger.periodMinutes is required for interval triggers'); + } + if (typeof raw.periodMinutes !== 'number' || !Number.isFinite(raw.periodMinutes)) { + throw new Error('trigger.periodMinutes must be a finite number'); + } + if (raw.periodMinutes < 1) { + throw new Error('trigger.periodMinutes must be >= 1'); + } + return { ...base, periodMinutes: raw.periodMinutes } as TriggerSpec; + } + + case 'once': { + if (raw.whenMs === undefined || raw.whenMs === null) { + throw new Error('trigger.whenMs is required for once triggers'); + } + if (typeof raw.whenMs !== 'number' || !Number.isFinite(raw.whenMs)) { + throw new Error('trigger.whenMs must be a finite number'); + } + return { ...base, whenMs: Math.floor(raw.whenMs) } as TriggerSpec; + } + + case 'command': { + if (!raw.commandKey || typeof raw.commandKey !== 'string') { + throw new Error('trigger.commandKey is required for command triggers'); + } + return { ...base, commandKey: raw.commandKey } as TriggerSpec; + } + + case 'contextMenu': { + if (!raw.title || typeof raw.title !== 'string') { + throw new Error('trigger.title is required for contextMenu triggers'); + } + let contexts: string[] | undefined; + if (raw.contexts !== undefined && raw.contexts !== null) { + if (!Array.isArray(raw.contexts) || !raw.contexts.every((c) => typeof c === 'string')) { + throw new Error('trigger.contexts must be an array of strings'); + } + contexts = raw.contexts as string[]; + } + return { ...base, title: raw.title, contexts } as TriggerSpec; + } + + case 'dom': { + if (!raw.selector || typeof raw.selector !== 'string') { + throw new Error('trigger.selector is required for dom triggers'); + } + let appear: boolean | undefined; + if (raw.appear !== undefined && raw.appear !== null) { + if (typeof raw.appear !== 'boolean') { + throw new Error('trigger.appear must be a boolean'); + } + appear = raw.appear; + } + let once: boolean | undefined; + if (raw.once !== undefined && raw.once !== null) { + if (typeof raw.once !== 'boolean') { + throw new Error('trigger.once must be a boolean'); + } + once = raw.once; + } + let debounceMs: number | undefined; + if (raw.debounceMs !== undefined && raw.debounceMs !== null) { + if (typeof raw.debounceMs !== 'number' || !Number.isFinite(raw.debounceMs)) { + throw new Error('trigger.debounceMs must be a finite number'); + } + debounceMs = raw.debounceMs; + } + return { ...base, selector: raw.selector, appear, once, debounceMs } as TriggerSpec; + } + + default: + throw new Error( + `trigger.kind must be one of: manual, url, cron, interval, once, command, contextMenu, dom`, + ); + } + } + + // ===== Run Control Handlers ===== + + private async handlePauseRun(params: JsonObject | undefined): Promise { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + + if (!this.runners) { + throw new Error('RunnerRegistry not configured'); + } + + const runner = this.runners.get(runId); + if (!runner) { + throw new Error(`Runner for "${runId}" not found (run may not be executing)`); + } + + const queueItem = await this.storage.queue.get(runId); + if (!queueItem) { + throw new Error(`Queue item "${runId}" not found`); + } + if (queueItem.status === 'queued') { + throw new Error(`Cannot pause run "${runId}" while status=queued`); + } + + const ownerId = queueItem.lease?.ownerId; + if (!ownerId) { + throw new Error(`Queue item "${runId}" has no lease ownerId`); + } + + const now = this.now(); + await this.storage.queue.markPaused(runId, ownerId, now); + runner.pause(); + + return { ok: true, runId }; + } + + private async handleResumeRun(params: JsonObject | undefined): Promise { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + + if (!this.runners) { + throw new Error('RunnerRegistry not configured'); + } + + const runner = this.runners.get(runId); + if (!runner) { + throw new Error(`Runner for "${runId}" not found (run may not be executing)`); + } + + const queueItem = await this.storage.queue.get(runId); + if (!queueItem) { + throw new Error(`Queue item "${runId}" not found`); + } + if (queueItem.status !== 'paused') { + throw new Error(`Cannot resume run "${runId}" with status=${queueItem.status}`); + } + + const ownerId = queueItem.lease?.ownerId; + if (!ownerId) { + throw new Error(`Queue item "${runId}" has no lease ownerId`); + } + + const now = this.now(); + await this.storage.queue.markRunning(runId, ownerId, now); + runner.resume(); + + return { ok: true, runId }; + } + + private async handleCancelRun(params: JsonObject | undefined): Promise { + const runId = params?.runId as RunId | undefined; + if (!runId) throw new Error('runId is required'); + + const reason = (params?.reason as string) ?? 'Canceled by user'; + const queueItem = await this.storage.queue.get(runId); + + // If still queued (not yet claimed), cancel via queue + if (queueItem?.status === 'queued') { + return this.handleCancelQueueItem({ runId, reason } as unknown as JsonObject); + } + + // If running/paused, cancel via runner + if (!this.runners) { + throw new Error('RunnerRegistry not configured'); + } + + const runner = this.runners.get(runId); + if (!runner) { + // Run may have already finished + throw new Error(`Runner for "${runId}" not found (run may have already finished)`); + } + + runner.cancel(reason); + return { ok: true, runId }; + } +} + +/** + * 创建并启动 RPC Server + */ +export function createRpcServer(config: RpcServerConfig): RpcServer { + const server = new RpcServer(config); + server.start(); + return server; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc.ts new file mode 100644 index 00000000..9b531312 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/transport/rpc.ts @@ -0,0 +1,192 @@ +/** + * @fileoverview Port RPC 协议定义 + * @description 定义通过 chrome.runtime.Port 进行通信的协议类型 + */ + +import type { JsonObject, JsonValue } from '../../domain/json'; +import type { RunId } from '../../domain/ids'; +import type { RunEvent } from '../../domain/events'; + +/** Port 名称 */ +export const RR_V3_PORT_NAME = 'rr_v3' as const; + +/** + * RPC 方法名称 + */ +export type RpcMethod = + // 查询方法 + | 'rr_v3.listRuns' + | 'rr_v3.getRun' + | 'rr_v3.getEvents' + // Flow 管理方法 + | 'rr_v3.getFlow' + | 'rr_v3.listFlows' + | 'rr_v3.saveFlow' + | 'rr_v3.deleteFlow' + // 触发器管理方法 + | 'rr_v3.createTrigger' + | 'rr_v3.updateTrigger' + | 'rr_v3.deleteTrigger' + | 'rr_v3.getTrigger' + | 'rr_v3.listTriggers' + | 'rr_v3.enableTrigger' + | 'rr_v3.disableTrigger' + | 'rr_v3.fireTrigger' + // 队列管理方法 + | 'rr_v3.enqueueRun' + | 'rr_v3.listQueue' + | 'rr_v3.cancelQueueItem' + // 控制方法 + | 'rr_v3.startRun' + | 'rr_v3.cancelRun' + | 'rr_v3.pauseRun' + | 'rr_v3.resumeRun' + // 调试方法 + | 'rr_v3.debug' + // 订阅方法 + | 'rr_v3.subscribe' + | 'rr_v3.unsubscribe'; + +/** + * RPC 请求消息 + */ +export interface RpcRequest { + type: 'rr_v3.request'; + /** 请求 ID（用于匹配响应） */ + requestId: string; + /** 方法名 */ + method: RpcMethod; + /** 参数 */ + params?: JsonObject; +} + +/** + * RPC 成功响应 + */ +export interface RpcResponseOk { + type: 'rr_v3.response'; + /** 对应的请求 ID */ + requestId: string; + ok: true; + /** 返回结果 */ + result: JsonValue; +} + +/** + * RPC 错误响应 + */ +export interface RpcResponseErr { + type: 'rr_v3.response'; + /** 对应的请求 ID */ + requestId: string; + ok: false; + /** 错误信息 */ + error: string; +} + +/** + * RPC 响应 + */ +export type RpcResponse = RpcResponseOk | RpcResponseErr; + +/** + * RPC 事件推送 + */ +export interface RpcEventMessage { + type: 'rr_v3.event'; + /** 事件数据 */ + event: RunEvent; +} + +/** + * RPC 订阅确认 + */ +export interface RpcSubscribeAck { + type: 'rr_v3.subscribeAck'; + /** 订阅的 Run ID（可选，null 表示订阅所有） */ + runId: RunId | null; +} + +/** + * 所有 RPC 消息类型 + */ +export type RpcMessage = + | RpcRequest + | RpcResponseOk + | RpcResponseErr + | RpcEventMessage + | RpcSubscribeAck; + +/** + * 生成唯一的请求 ID + */ +export function generateRequestId(): string { + return `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; +} + +/** + * 判断消息是否为 RPC 请求 + */ +export function isRpcRequest(msg: unknown): msg is RpcRequest { + return typeof msg === 'object' && msg !== null && (msg as RpcRequest).type === 'rr_v3.request'; +} + +/** + * 判断消息是否为 RPC 响应 + */ +export function isRpcResponse(msg: unknown): msg is RpcResponse { + return typeof msg === 'object' && msg !== null && (msg as RpcResponse).type === 'rr_v3.response'; +} + +/** + * 判断消息是否为 RPC 事件 + */ +export function isRpcEvent(msg: unknown): msg is RpcEventMessage { + return typeof msg === 'object' && msg !== null && (msg as RpcEventMessage).type === 'rr_v3.event'; +} + +/** + * 创建 RPC 请求 + */ +export function createRpcRequest(method: RpcMethod, params?: JsonObject): RpcRequest { + return { + type: 'rr_v3.request', + requestId: generateRequestId(), + method, + params, + }; +} + +/** + * 创建成功响应 + */ +export function createRpcResponseOk(requestId: string, result: JsonValue): RpcResponseOk { + return { + type: 'rr_v3.response', + requestId, + ok: true, + result, + }; +} + +/** + * 创建错误响应 + */ +export function createRpcResponseErr(requestId: string, error: string): RpcResponseErr { + return { + type: 'rr_v3.response', + requestId, + ok: false, + error, + }; +} + +/** + * 创建事件消息 + */ +export function createRpcEventMessage(event: RunEvent): RpcEventMessage { + return { + type: 'rr_v3.event', + event, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/command-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/command-trigger.ts new file mode 100644 index 00000000..17c90c3d --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/command-trigger.ts @@ -0,0 +1,147 @@ +/** + * @fileoverview Command Trigger Handler (P4-04) + * @description + * Listens to `chrome.commands.onCommand` and fires installed command triggers. + * + * Command triggers allow users to execute flows via keyboard shortcuts + * defined in the extension's manifest. + * + * Design notes: + * - Commands must be registered in manifest.json under the "commands" key + * - Each command is identified by its commandKey (e.g., "run-flow-1") + * - Active tab info is captured when available + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +export interface CommandTriggerHandlerDeps { + logger?: Pick; +} + +type CommandTriggerSpec = TriggerSpecByKind<'command'>; + +interface InstalledCommandTrigger { + spec: CommandTriggerSpec; +} + +// ==================== Handler Implementation ==================== + +/** + * Create command trigger handler factory + */ +export function createCommandTriggerHandlerFactory( + deps?: CommandTriggerHandlerDeps, +): TriggerHandlerFactory<'command'> { + return (fireCallback) => createCommandTriggerHandler(fireCallback, deps); +} + +/** + * Create command trigger handler + */ +export function createCommandTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: CommandTriggerHandlerDeps, +): TriggerHandler<'command'> { + const logger = deps?.logger ?? console; + + // Map commandKey -> triggerId for fast lookup + const commandKeyToTriggerId = new Map(); + const installed = new Map(); + let listening = false; + + /** + * Handle chrome.commands.onCommand event + */ + const onCommand = (command: string, tab?: chrome.tabs.Tab): void => { + const triggerId = commandKeyToTriggerId.get(command); + if (!triggerId) return; + + const trigger = installed.get(triggerId); + if (!trigger) return; + + // Fire and forget: chrome event listeners should not block + Promise.resolve( + fireCallback.onFire(triggerId, { + sourceTabId: tab?.id, + sourceUrl: tab?.url, + }), + ).catch((e) => { + logger.error(`[CommandTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + }); + }; + + /** + * Ensure listener is registered + */ + function ensureListening(): void { + if (listening) return; + if (!chrome.commands?.onCommand?.addListener) { + logger.warn('[CommandTriggerHandler] chrome.commands.onCommand is unavailable'); + return; + } + chrome.commands.onCommand.addListener(onCommand); + listening = true; + } + + /** + * Stop listening + */ + function stopListening(): void { + if (!listening) return; + try { + chrome.commands.onCommand.removeListener(onCommand); + } catch (e) { + logger.debug('[CommandTriggerHandler] removeListener failed:', e); + } finally { + listening = false; + } + } + + return { + kind: 'command', + + async install(trigger: CommandTriggerSpec): Promise { + const { id, commandKey } = trigger; + + // Warn if commandKey already used by another trigger + const existingTriggerId = commandKeyToTriggerId.get(commandKey); + if (existingTriggerId && existingTriggerId !== id) { + logger.warn( + `[CommandTriggerHandler] Command "${commandKey}" already used by trigger "${existingTriggerId}", overwriting with "${id}"`, + ); + // Remove old mapping + installed.delete(existingTriggerId); + } + + installed.set(id, { spec: trigger }); + commandKeyToTriggerId.set(commandKey, id); + ensureListening(); + }, + + async uninstall(triggerId: string): Promise { + const trigger = installed.get(triggerId as TriggerId); + if (trigger) { + commandKeyToTriggerId.delete(trigger.spec.commandKey); + installed.delete(triggerId as TriggerId); + } + + if (installed.size === 0) { + stopListening(); + } + }, + + async uninstallAll(): Promise { + installed.clear(); + commandKeyToTriggerId.clear(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/context-menu-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/context-menu-trigger.ts new file mode 100644 index 00000000..d873a45c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/context-menu-trigger.ts @@ -0,0 +1,217 @@ +/** + * @fileoverview ContextMenu Trigger Handler (P4-05) + * @description + * Uses `chrome.contextMenus` API to create right-click menu items that fire triggers. + * + * Design notes: + * - Each trigger creates a separate menu item with unique ID + * - Menu item ID is prefixed with 'rr_v3_' to avoid conflicts + * - Context types: 'page', 'selection', 'link', 'image', 'video', 'audio', etc. + * - Captures click info and tab info for trigger context + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +export interface ContextMenuTriggerHandlerDeps { + logger?: Pick; +} + +type ContextMenuTriggerSpec = TriggerSpecByKind<'contextMenu'>; + +interface InstalledContextMenuTrigger { + spec: ContextMenuTriggerSpec; + menuItemId: string; +} + +// ==================== Constants ==================== + +const MENU_ITEM_PREFIX = 'rr_v3_'; + +// Default context types if not specified +const DEFAULT_CONTEXTS: chrome.contextMenus.ContextType[] = ['page']; + +// ==================== Handler Implementation ==================== + +/** + * Create context menu trigger handler factory + */ +export function createContextMenuTriggerHandlerFactory( + deps?: ContextMenuTriggerHandlerDeps, +): TriggerHandlerFactory<'contextMenu'> { + return (fireCallback) => createContextMenuTriggerHandler(fireCallback, deps); +} + +/** + * Create context menu trigger handler + */ +export function createContextMenuTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: ContextMenuTriggerHandlerDeps, +): TriggerHandler<'contextMenu'> { + const logger = deps?.logger ?? console; + + // Map menuItemId -> triggerId for fast lookup + const menuItemIdToTriggerId = new Map(); + const installed = new Map(); + let listening = false; + + /** + * Generate unique menu item ID for a trigger + */ + function generateMenuItemId(triggerId: TriggerId): string { + return `${MENU_ITEM_PREFIX}${triggerId}`; + } + + /** + * Handle chrome.contextMenus.onClicked event + */ + const onClicked = (info: chrome.contextMenus.OnClickData, tab?: chrome.tabs.Tab): void => { + const menuItemId = String(info.menuItemId); + const triggerId = menuItemIdToTriggerId.get(menuItemId); + if (!triggerId) return; + + const trigger = installed.get(triggerId); + if (!trigger) return; + + // Fire and forget: chrome event listeners should not block + Promise.resolve( + fireCallback.onFire(triggerId, { + sourceTabId: tab?.id, + sourceUrl: info.pageUrl ?? tab?.url, + }), + ).catch((e) => { + logger.error(`[ContextMenuTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + }); + }; + + /** + * Ensure listener is registered + */ + function ensureListening(): void { + if (listening) return; + if (!chrome.contextMenus?.onClicked?.addListener) { + logger.warn('[ContextMenuTriggerHandler] chrome.contextMenus.onClicked is unavailable'); + return; + } + chrome.contextMenus.onClicked.addListener(onClicked); + listening = true; + } + + /** + * Stop listening + */ + function stopListening(): void { + if (!listening) return; + try { + chrome.contextMenus.onClicked.removeListener(onClicked); + } catch (e) { + logger.debug('[ContextMenuTriggerHandler] removeListener failed:', e); + } finally { + listening = false; + } + } + + /** + * Convert context types from spec to chrome API format + */ + function normalizeContexts( + contexts: ReadonlyArray | undefined, + ): chrome.contextMenus.ContextType[] { + if (!contexts || contexts.length === 0) { + return DEFAULT_CONTEXTS; + } + return contexts as chrome.contextMenus.ContextType[]; + } + + return { + kind: 'contextMenu', + + async install(trigger: ContextMenuTriggerSpec): Promise { + const { id, title, contexts } = trigger; + const menuItemId = generateMenuItemId(id); + + // Check if chrome.contextMenus.create is available + if (!chrome.contextMenus?.create) { + logger.warn('[ContextMenuTriggerHandler] chrome.contextMenus.create is unavailable'); + return; + } + + // Create menu item + await new Promise((resolve, reject) => { + chrome.contextMenus.create( + { + id: menuItemId, + title: title, + contexts: normalizeContexts(contexts), + }, + () => { + if (chrome.runtime.lastError) { + reject(new Error(chrome.runtime.lastError.message)); + } else { + resolve(); + } + }, + ); + }); + + installed.set(id, { spec: trigger, menuItemId }); + menuItemIdToTriggerId.set(menuItemId, id); + ensureListening(); + }, + + async uninstall(triggerId: string): Promise { + const trigger = installed.get(triggerId as TriggerId); + if (!trigger) return; + + // Remove menu item + if (chrome.contextMenus?.remove) { + await new Promise((resolve) => { + chrome.contextMenus.remove(trigger.menuItemId, () => { + // Ignore errors (item may not exist) + if (chrome.runtime.lastError) { + logger.debug( + `[ContextMenuTriggerHandler] Failed to remove menu item: ${chrome.runtime.lastError.message}`, + ); + } + resolve(); + }); + }); + } + + menuItemIdToTriggerId.delete(trigger.menuItemId); + installed.delete(triggerId as TriggerId); + + if (installed.size === 0) { + stopListening(); + } + }, + + async uninstallAll(): Promise { + // Remove all menu items created by this handler + if (chrome.contextMenus?.remove) { + const removePromises = Array.from(installed.values()).map( + (trigger) => + new Promise((resolve) => { + chrome.contextMenus.remove(trigger.menuItemId, () => { + // Ignore errors + resolve(); + }); + }), + ); + await Promise.all(removePromises); + } + + installed.clear(); + menuItemIdToTriggerId.clear(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/cron-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/cron-trigger.ts new file mode 100644 index 00000000..d67a9170 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/cron-trigger.ts @@ -0,0 +1,583 @@ +/** + * @fileoverview Cron Trigger Handler (P4-07) + * @description + * Schedules cron triggers via `chrome.alarms` (MV3). + * + * Strategy: + * - One alarm per trigger (one-shot `when` alarm). + * - When fired: call `fireCallback.onFire(triggerId)` then compute and schedule next. + * + * Timezone: + * - Accepts IANA timezones (e.g. "UTC", "Asia/Shanghai"). + * - Validated via `Intl.DateTimeFormat(..., { timeZone })`. + * + * Cron parsing: + * - Delegated to an external library (recommended: `cron-parser`) to avoid DST edge cases. + * - Falls back to a minimal built-in parser if library not available. + */ + +import type { UnixMillis } from '../../domain/json'; +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +type CronTriggerSpec = TriggerSpecByKind<'cron'>; + +/** + * Function to compute next fire time from cron expression + */ +export type ComputeNextFireAtMs = (input: { + cron: string; + timezone?: string; + fromMs: UnixMillis; +}) => UnixMillis | Promise; + +export interface CronTriggerHandlerDeps { + logger?: Pick; + now?: () => UnixMillis; + computeNextFireAtMs?: ComputeNextFireAtMs; +} + +interface InstalledCronTrigger { + spec: CronTriggerSpec; + timezone?: string; + version: number; +} + +// ==================== Constants ==================== + +const ALARM_PREFIX = 'rr_v3_cron_'; + +// ==================== Utilities ==================== + +/** + * Normalize cron expression + */ +function normalizeCronExpression(value: unknown): string { + const raw = typeof value === 'string' ? value : String(value ?? ''); + const normalized = raw.trim().replace(/\s+/g, ' '); + if (!normalized) { + throw new Error('cron must be a non-empty string'); + } + return normalized; +} + +/** + * Validate and normalize timezone + */ +function normalizeTimezone(value: unknown): string | undefined { + if (value === undefined || value === null) return undefined; + if (typeof value !== 'string') { + throw new Error('timezone must be a string'); + } + const trimmed = value.trim(); + if (!trimmed) return undefined; + + try { + // Throws RangeError for invalid IANA timezones + new Intl.DateTimeFormat('en-US', { timeZone: trimmed }).format(new Date(0)); + } catch { + throw new Error(`Invalid timezone: "${trimmed}"`); + } + + return trimmed; +} + +/** + * Generate alarm name for trigger + */ +function alarmNameForTrigger(triggerId: TriggerId): string { + return `${ALARM_PREFIX}${triggerId}`; +} + +/** + * Parse trigger ID from alarm name + */ +function parseTriggerIdFromAlarmName(name: string): TriggerId | null { + if (!name.startsWith(ALARM_PREFIX)) return null; + const id = name.slice(ALARM_PREFIX.length); + return id ? (id as TriggerId) : null; +} + +/** + * Simple cron expression parser (minimal subset) + * Supports: minute hour day-of-month month day-of-week + * Values: numbers, * (any), intervals (e.g., * /5) + * + * For production use with complex cron expressions, install 'cron-parser'. + */ +function parseSimpleCron(cron: string): { + minute: number[]; + hour: number[]; + dayOfMonth: number[]; + month: number[]; + dayOfWeek: number[]; +} { + const parts = cron.split(' '); + if (parts.length !== 5) { + throw new Error(`Invalid cron expression: expected 5 fields, got ${parts.length}`); + } + + function parseField(field: string, min: number, max: number): number[] { + const values: number[] = []; + + for (const part of field.split(',')) { + if (part === '*') { + for (let i = min; i <= max; i++) values.push(i); + } else if (part.includes('/')) { + const [range, stepStr] = part.split('/'); + const step = parseInt(stepStr, 10); + // Guard against infinite loop: step must be positive + if (!Number.isFinite(step) || step < 1) { + throw new Error(`Invalid step in cron field: "${part}" (step must be >= 1)`); + } + const start = range === '*' ? min : parseInt(range, 10); + if (!Number.isFinite(start) || start < min || start > max) { + throw new Error(`Invalid range start in cron field: "${part}"`); + } + for (let i = start; i <= max; i += step) values.push(i); + } else if (part.includes('-')) { + const [startStr, endStr] = part.split('-'); + const start = parseInt(startStr, 10); + const end = parseInt(endStr, 10); + if (!Number.isFinite(start) || !Number.isFinite(end) || start > end) { + throw new Error(`Invalid range in cron field: "${part}"`); + } + for (let i = start; i <= end; i++) values.push(i); + } else { + const num = parseInt(part, 10); + if (!Number.isFinite(num)) { + throw new Error(`Invalid number in cron field: "${part}"`); + } + values.push(num); + } + } + + // Validate all values are within bounds + for (const v of values) { + if (v < min || v > max) { + throw new Error(`Cron field value ${v} out of range [${min}, ${max}]`); + } + } + + return [...new Set(values)].sort((a, b) => a - b); + } + + return { + minute: parseField(parts[0], 0, 59), + hour: parseField(parts[1], 0, 23), + dayOfMonth: parseField(parts[2], 1, 31), + month: parseField(parts[3], 1, 12), + dayOfWeek: parseField(parts[4], 0, 6), + }; +} + +// ==================== Timezone Utilities ==================== + +interface ZonedTimeParts { + year: number; + month: number; + day: number; + hour: number; + minute: number; + dayOfWeek: number; +} + +// Cache DateTimeFormat instances per timezone for performance +const dtfCache = new Map(); + +/** + * Get or create cached DateTimeFormat for a timezone + */ +function getDateTimeFormat(timezone: string): Intl.DateTimeFormat { + let dtf = dtfCache.get(timezone); + if (!dtf) { + dtf = new Intl.DateTimeFormat('en-US', { + timeZone: timezone, + hourCycle: 'h23', + year: 'numeric', + month: '2-digit', + day: '2-digit', + hour: '2-digit', + minute: '2-digit', + weekday: 'short', + }); + dtfCache.set(timezone, dtf); + } + return dtf; +} + +// Map weekday string to number (0=Sunday) +const WEEKDAY_MAP: Record = { + Sun: 0, + Mon: 1, + Tue: 2, + Wed: 3, + Thu: 4, + Fri: 5, + Sat: 6, +}; + +/** + * Get time parts in a specific timezone using Intl.DateTimeFormat + */ +function getZonedTimeParts(utcMs: UnixMillis, timezone: string): ZonedTimeParts { + const dtf = getDateTimeFormat(timezone); + const parts = dtf.formatToParts(new Date(utcMs)); + const map: Record = Object.create(null); + for (const p of parts) { + if (p.type !== 'literal') map[p.type] = p.value; + } + + // Handle edge case: some environments emit "24" for midnight + const rawHour = Number(map.hour); + + return { + year: Number(map.year), + month: Number(map.month), + day: Number(map.day), + hour: rawHour === 24 ? 0 : rawHour, + minute: Number(map.minute), + dayOfWeek: WEEKDAY_MAP[map.weekday] ?? 0, + }; +} + +/** + * Calculate timezone offset in milliseconds at a given UTC timestamp + * Positive offset means timezone is ahead of UTC (e.g., Asia/Shanghai = +8h = +28800000ms) + */ +function getTimezoneOffsetMs(utcMs: UnixMillis, timezone: string): number { + const z = getZonedTimeParts(utcMs, timezone); + const asUtc = Date.UTC(z.year, z.month - 1, z.day, z.hour, z.minute, 0); + return asUtc - utcMs; +} + +/** + * Convert zoned datetime to UTC milliseconds + * Uses iterative refinement to handle DST transitions + */ +function zonedToUtcMs( + zoned: { year: number; month: number; day: number; hour: number; minute: number }, + timezone: string, +): UnixMillis { + // Start with the zoned time interpreted as UTC + const baseUtc = Date.UTC(zoned.year, zoned.month - 1, zoned.day, zoned.hour, zoned.minute, 0); + + // Iteratively solve: utcMs = baseUtc - offset(utcMs) + let utcMs = baseUtc; + for (let i = 0; i < 3; i++) { + const offsetMs = getTimezoneOffsetMs(utcMs, timezone); + const next = baseUtc - offsetMs; + if (next === utcMs) break; + utcMs = next; + } + return utcMs; +} + +// ==================== Cron Computation ==================== + +/** + * Compute next fire time using built-in simple parser (local timezone) + */ +function computeNextFireAtMsLocal( + parsed: ReturnType, + fromMs: UnixMillis, +): UnixMillis { + const baseDate = new Date(fromMs + 1000); // Add 1 second to ensure next occurrence + + for (let dayOffset = 0; dayOffset < 366; dayOffset++) { + for (const hour of parsed.hour) { + for (const minute of parsed.minute) { + const candidate = new Date(baseDate); + candidate.setDate(candidate.getDate() + dayOffset); + candidate.setHours(hour, minute, 0, 0); + + if (candidate.getTime() <= fromMs) continue; + + const month = candidate.getMonth() + 1; + const dayOfMonth = candidate.getDate(); + const dayOfWeek = candidate.getDay(); + + if (!parsed.month.includes(month)) continue; + if (!parsed.dayOfMonth.includes(dayOfMonth) && !parsed.dayOfWeek.includes(dayOfWeek)) + continue; + + return candidate.getTime(); + } + } + } + + throw new Error('Failed to compute next cron fire time within 1 year'); +} + +/** + * Compute next fire time in a specific timezone + */ +function computeNextFireAtMsZoned( + parsed: ReturnType, + fromMs: UnixMillis, + timezone: string, +): UnixMillis { + const baseZoned = getZonedTimeParts(fromMs + 1000, timezone); + const dayCursor = new Date(Date.UTC(baseZoned.year, baseZoned.month - 1, baseZoned.day)); + + for (let dayOffset = 0; dayOffset < 366; dayOffset++) { + if (dayOffset > 0) dayCursor.setUTCDate(dayCursor.getUTCDate() + 1); + + const year = dayCursor.getUTCFullYear(); + const month = dayCursor.getUTCMonth() + 1; + const dayOfMonth = dayCursor.getUTCDate(); + const dayOfWeek = dayCursor.getUTCDay(); + + if (!parsed.month.includes(month)) continue; + if (!parsed.dayOfMonth.includes(dayOfMonth) && !parsed.dayOfWeek.includes(dayOfWeek)) continue; + + for (const hour of parsed.hour) { + for (const minute of parsed.minute) { + const candidateUtcMs = zonedToUtcMs( + { year, month, day: dayOfMonth, hour, minute }, + timezone, + ); + + if (candidateUtcMs <= fromMs) continue; + + // Validate conversion didn't drift (DST gaps/ambiguity can cause skipped times) + const candidateZoned = getZonedTimeParts(candidateUtcMs, timezone); + if ( + candidateZoned.year !== year || + candidateZoned.month !== month || + candidateZoned.day !== dayOfMonth || + candidateZoned.hour !== hour || + candidateZoned.minute !== minute + ) { + continue; // Skip DST gap times + } + + return candidateUtcMs; + } + } + } + + throw new Error('Failed to compute next cron fire time within 1 year'); +} + +/** + * Compute next fire time using built-in simple parser + */ +function computeNextFireAtMsSimple(input: { + cron: string; + timezone?: string; + fromMs: UnixMillis; +}): UnixMillis { + const parsed = parseSimpleCron(input.cron); + + if (input.timezone) { + return computeNextFireAtMsZoned(parsed, input.fromMs, input.timezone); + } + + return computeNextFireAtMsLocal(parsed, input.fromMs); +} + +/** + * Default compute next fire time function + * Uses simple built-in parser + */ +function defaultComputeNextFireAtMs(input: { + cron: string; + timezone?: string; + fromMs: UnixMillis; +}): UnixMillis { + return computeNextFireAtMsSimple(input); +} + +// ==================== Handler Implementation ==================== + +/** + * Create cron trigger handler factory + */ +export function createCronTriggerHandlerFactory( + deps?: CronTriggerHandlerDeps, +): TriggerHandlerFactory<'cron'> { + return (fireCallback) => createCronTriggerHandler(fireCallback, deps); +} + +/** + * Create cron trigger handler + */ +export function createCronTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: CronTriggerHandlerDeps, +): TriggerHandler<'cron'> { + const logger = deps?.logger ?? console; + const now = deps?.now ?? (() => Date.now()); + const computeNextFireAtMs: ComputeNextFireAtMs = + deps?.computeNextFireAtMs ?? defaultComputeNextFireAtMs; + + const installed = new Map(); + const versions = new Map(); + let listening = false; + + /** + * Bump version to invalidate pending operations + */ + function bumpVersion(triggerId: TriggerId): number { + const next = (versions.get(triggerId) ?? 0) + 1; + versions.set(triggerId, next); + return next; + } + + /** + * Clear alarm by name + */ + async function clearAlarmByName(name: string): Promise { + if (!chrome.alarms?.clear) return; + try { + await Promise.resolve(chrome.alarms.clear(name)); + } catch (e) { + logger.debug('[CronTriggerHandler] alarms.clear failed:', e); + } + } + + /** + * Clear all cron alarms + */ + async function clearAllCronAlarms(): Promise { + if (!chrome.alarms?.getAll || !chrome.alarms?.clear) return; + try { + const alarms = await Promise.resolve(chrome.alarms.getAll()); + const list = Array.isArray(alarms) ? alarms : []; + await Promise.all( + list + .filter((a) => a?.name && a.name.startsWith(ALARM_PREFIX)) + .map((a) => clearAlarmByName(a.name)), + ); + } catch (e) { + logger.debug('[CronTriggerHandler] alarms.getAll failed:', e); + } + } + + /** + * Schedule next alarm for trigger + */ + async function scheduleNext(triggerId: TriggerId, expectedVersion: number): Promise { + if (!chrome.alarms?.create) { + logger.warn('[CronTriggerHandler] chrome.alarms.create is unavailable'); + return; + } + + const entry = installed.get(triggerId); + if (!entry || entry.version !== expectedVersion) return; + + const fromMs = now(); + const nextMs = await Promise.resolve( + computeNextFireAtMs({ + cron: entry.spec.cron, + timezone: entry.timezone, + fromMs, + }), + ); + + // Check version again after async + if (installed.get(triggerId)?.version !== expectedVersion) return; + + const name = alarmNameForTrigger(triggerId); + await Promise.resolve(chrome.alarms.create(name, { when: nextMs })); + } + + /** + * Handle alarm event + */ + const onAlarm = (alarm: chrome.alarms.Alarm): void => { + const triggerId = parseTriggerIdFromAlarmName(alarm?.name ?? ''); + if (!triggerId) return; + + const entry = installed.get(triggerId); + if (!entry) return; + + const expectedVersion = entry.version; + + void (async () => { + try { + await fireCallback.onFire(triggerId, { + sourceTabId: undefined, + sourceUrl: undefined, + }); + } catch (e) { + logger.error(`[CronTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + } finally { + // Reschedule if still valid + // eslint-disable-next-line no-unsafe-finally + if (installed.get(triggerId)?.version !== expectedVersion) return; + try { + await scheduleNext(triggerId, expectedVersion); + } catch (e) { + logger.error(`[CronTriggerHandler] Failed to reschedule trigger "${triggerId}":`, e); + } + } + })(); + }; + + function ensureListening(): void { + if (listening) return; + if (!chrome.alarms?.onAlarm?.addListener) { + logger.warn('[CronTriggerHandler] chrome.alarms.onAlarm is unavailable'); + return; + } + chrome.alarms.onAlarm.addListener(onAlarm); + listening = true; + } + + function stopListening(): void { + if (!listening) return; + try { + chrome.alarms.onAlarm.removeListener(onAlarm); + } catch (e) { + logger.debug('[CronTriggerHandler] alarms.onAlarm.removeListener failed:', e); + } finally { + listening = false; + } + } + + return { + kind: 'cron', + + async install(trigger: CronTriggerSpec): Promise { + const cron = normalizeCronExpression(trigger.cron); + const timezone = normalizeTimezone(trigger.timezone); + + const version = bumpVersion(trigger.id); + installed.set(trigger.id, { + spec: { ...trigger, cron }, + timezone, + version, + }); + + ensureListening(); + await scheduleNext(trigger.id, version); + }, + + async uninstall(triggerId: string): Promise { + const id = triggerId as TriggerId; + bumpVersion(id); + installed.delete(id); + await clearAlarmByName(alarmNameForTrigger(id)); + + if (installed.size === 0) { + stopListening(); + } + }, + + async uninstallAll(): Promise { + for (const id of installed.keys()) bumpVersion(id); + installed.clear(); + await clearAllCronAlarms(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/dom-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/dom-trigger.ts new file mode 100644 index 00000000..5e889ee8 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/dom-trigger.ts @@ -0,0 +1,398 @@ +/** + * @fileoverview DOM Trigger Handler (P4-06) + * @description + * Bridges DOM triggers to a content-script MutationObserver (`inject-scripts/dom-observer.js`). + * + * Contract: + * - Background -> content: { action: 'set_dom_triggers', triggers: [...] } + * - Content -> background: { action: 'dom_trigger_fired', triggerId, url } + * - Ping: { action: 'dom_observer_ping' } -> { status:'pong' } + * + * Design notes: + * - Reuses existing V2 dom observer script for consistency and auditability. + * - Single handler instance manages multiple triggers. + * - Sync is coalesced to avoid storms during TriggerManager.refresh(). + * - Top-frame only (no frameId in TriggerFireContext). + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import { CONTENT_MESSAGE_TYPES, TOOL_MESSAGE_TYPES } from '../../../../../common/message-types'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +export interface DomTriggerHandlerDeps { + logger?: Pick; +} + +type DomTriggerSpec = TriggerSpecByKind<'dom'>; + +/** + * Payload sent to dom-observer content script + */ +interface DomObserverTriggerPayload { + id: string; + selector: string; + appear: boolean; + once: boolean; + debounceMs: number; +} + +/** + * Message received when DOM trigger fires + */ +interface DomTriggerFiredMessage { + action: string; + triggerId: string; + url?: string; +} + +// ==================== Constants ==================== + +const DOM_OBSERVER_SCRIPT_FILE = 'inject-scripts/dom-observer.js'; +const DEFAULT_DEBOUNCE_MS = 800; + +// ==================== Utilities ==================== + +function normalizeDebounceMs(value: unknown): number { + if (value === undefined || value === null) return DEFAULT_DEBOUNCE_MS; + if (typeof value !== 'number' || !Number.isFinite(value)) return DEFAULT_DEBOUNCE_MS; + return Math.max(0, Math.floor(value)); +} + +/** + * Build payload for dom-observer content script + */ +function buildDomObserverPayload( + installed: Map, +): DomObserverTriggerPayload[] { + const out: DomObserverTriggerPayload[] = []; + + for (const t of installed.values()) { + const selector = String(t.selector ?? '').trim(); + if (!selector) continue; + + out.push({ + id: t.id, + selector, + appear: t.appear !== false, // default true + once: t.once !== false, // default true + debounceMs: normalizeDebounceMs(t.debounceMs), + }); + } + + // Deterministic ordering for tests and debugging + out.sort((a, b) => a.id.localeCompare(b.id)); + return out; +} + +/** + * Check if URL is injectable (http/https/file) + */ +function isInjectableUrl(url: string): boolean { + return /^(https?:|file:)/i.test(url); +} + +/** + * Type guard for DOM trigger fired message + */ +function isDomTriggerFiredMessage(msg: unknown): msg is DomTriggerFiredMessage { + if (!msg || typeof msg !== 'object') return false; + const anyMsg = msg as Record; + return ( + anyMsg.action === TOOL_MESSAGE_TYPES.DOM_TRIGGER_FIRED && typeof anyMsg.triggerId === 'string' + ); +} + +// ==================== Handler Implementation ==================== + +/** + * Create DOM trigger handler factory + */ +export function createDomTriggerHandlerFactory( + deps?: DomTriggerHandlerDeps, +): TriggerHandlerFactory<'dom'> { + return (fireCallback) => createDomTriggerHandler(fireCallback, deps); +} + +/** + * Create DOM trigger handler + */ +export function createDomTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: DomTriggerHandlerDeps, +): TriggerHandler<'dom'> { + const logger = deps?.logger ?? console; + + const installed = new Map(); + + // Payload cache for efficiency + let payloadDirty = true; + let payloadCache: DomObserverTriggerPayload[] = []; + + // Listener states + let messageListening = false; + let navigationListening = false; + + // Coalesce sync to avoid storms (e.g. TriggerManager.refresh) + let syncPromise: Promise | null = null; + let pendingSync = false; + + function markPayloadDirty(): void { + payloadDirty = true; + } + + function getPayload(): DomObserverTriggerPayload[] { + if (!payloadDirty) return payloadCache; + payloadCache = buildDomObserverPayload(installed); + payloadDirty = false; + return payloadCache; + } + + /** + * Ping dom-observer to check if injected + */ + async function pingDomObserver(tabId: number): Promise { + try { + const resp = await chrome.tabs.sendMessage(tabId, { + action: CONTENT_MESSAGE_TYPES.DOM_OBSERVER_PING, + }); + return (resp as { status?: string } | undefined)?.status === 'pong'; + } catch { + return false; + } + } + + /** + * Inject dom-observer script if not present + */ + async function ensureDomObserverInjected(tabId: number): Promise { + const ok = await pingDomObserver(tabId); + if (ok) return; + + if (!chrome.scripting?.executeScript) { + logger.warn('[DomTriggerHandler] chrome.scripting.executeScript is unavailable'); + return; + } + + try { + await chrome.scripting.executeScript({ + target: { tabId }, + files: [DOM_OBSERVER_SCRIPT_FILE], + world: 'ISOLATED', + }); + } catch (e) { + // Best-effort: injection can fail on restricted pages (chrome://, etc.) + logger.debug('[DomTriggerHandler] executeScript failed:', e); + } + } + + /** + * Send triggers to dom-observer + */ + async function setDomTriggers( + tabId: number, + triggers: DomObserverTriggerPayload[], + ): Promise { + try { + await chrome.tabs.sendMessage(tabId, { + action: TOOL_MESSAGE_TYPES.SET_DOM_TRIGGERS, + triggers, + }); + } catch (e) { + // No receiver / restricted pages are expected; keep best-effort. + logger.debug('[DomTriggerHandler] set_dom_triggers sendMessage failed:', e); + } + } + + /** + * Sync triggers to a single tab + */ + async function syncTab(tabId: number, url: string | undefined): Promise { + if (typeof url === 'string' && url && !isInjectableUrl(url)) return; + + const payload = getPayload(); + if (payload.length > 0) { + await ensureDomObserverInjected(tabId); + } + await setDomTriggers(tabId, payload); + } + + /** + * Sync triggers to all tabs + */ + async function doSyncAllTabs(): Promise { + if (!chrome.tabs?.query) { + logger.warn('[DomTriggerHandler] chrome.tabs.query is unavailable'); + return; + } + + let tabs: chrome.tabs.Tab[] = []; + try { + tabs = await chrome.tabs.query({}); + } catch (e) { + logger.debug('[DomTriggerHandler] tabs.query failed:', e); + return; + } + + await Promise.all( + tabs + .filter((t) => typeof t.id === 'number') + .filter((t) => (typeof t.url === 'string' ? isInjectableUrl(t.url) : true)) + .map((t) => syncTab(t.id as number, t.url)), + ); + } + + /** + * Request sync (coalesced) + */ + async function requestSyncAllTabs(): Promise { + pendingSync = true; + if (!syncPromise) { + syncPromise = (async () => { + while (pendingSync) { + pendingSync = false; + await doSyncAllTabs(); + } + })().finally(() => { + syncPromise = null; + }); + } + return syncPromise; + } + + /** + * Handle runtime message (dom_trigger_fired) + */ + const onRuntimeMessage = ( + message: unknown, + sender: chrome.runtime.MessageSender, + sendResponse: (response?: unknown) => void, + ): boolean => { + if (!isDomTriggerFiredMessage(message)) return false; + + const triggerId = message.triggerId as TriggerId; + if (!installed.has(triggerId)) { + try { + sendResponse({ ok: false }); + } catch { + // ignore + } + return false; + } + + const sourceTabId = sender.tab?.id; + const sourceUrl = message.url ?? sender.tab?.url; + + // Fire-and-forget: do not block chrome messaging thread + Promise.resolve(fireCallback.onFire(triggerId, { sourceTabId, sourceUrl })).catch((e) => { + logger.error(`[DomTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + }); + + try { + sendResponse({ ok: true }); + } catch { + // ignore + } + return false; + }; + + /** + * Handle navigation completed (re-sync triggers to tab) + */ + const onNavigationCompleted = ( + details: chrome.webNavigation.WebNavigationFramedCallbackDetails, + ): void => { + if (details.frameId !== 0) return; // Top frame only + if (installed.size === 0) return; + if (typeof details.url === 'string' && details.url && !isInjectableUrl(details.url)) return; + + void syncTab(details.tabId, details.url).catch((e) => { + logger.debug('[DomTriggerHandler] syncTab on navigation failed:', e); + }); + }; + + function ensureMessageListening(): void { + if (messageListening) return; + if (!chrome.runtime?.onMessage?.addListener) { + logger.warn('[DomTriggerHandler] chrome.runtime.onMessage is unavailable'); + return; + } + chrome.runtime.onMessage.addListener(onRuntimeMessage); + messageListening = true; + } + + function stopMessageListening(): void { + if (!messageListening) return; + try { + chrome.runtime.onMessage.removeListener(onRuntimeMessage); + } catch (e) { + logger.debug('[DomTriggerHandler] runtime.onMessage.removeListener failed:', e); + } finally { + messageListening = false; + } + } + + function ensureNavigationListening(): void { + if (navigationListening) return; + if (!chrome.webNavigation?.onCompleted?.addListener) { + logger.warn('[DomTriggerHandler] chrome.webNavigation.onCompleted is unavailable'); + return; + } + chrome.webNavigation.onCompleted.addListener(onNavigationCompleted); + navigationListening = true; + } + + function stopNavigationListening(): void { + if (!navigationListening) return; + try { + chrome.webNavigation.onCompleted.removeListener(onNavigationCompleted); + } catch (e) { + logger.debug('[DomTriggerHandler] webNavigation.onCompleted.removeListener failed:', e); + } finally { + navigationListening = false; + } + } + + return { + kind: 'dom', + + async install(trigger: DomTriggerSpec): Promise { + installed.set(trigger.id, trigger); + markPayloadDirty(); + + // Ensure listeners are ready before pushing triggers + ensureMessageListening(); + ensureNavigationListening(); + + await requestSyncAllTabs(); + }, + + async uninstall(triggerId: string): Promise { + installed.delete(triggerId as TriggerId); + markPayloadDirty(); + + await requestSyncAllTabs(); + + if (installed.size === 0) { + stopNavigationListening(); + stopMessageListening(); + } + }, + + async uninstallAll(): Promise { + installed.clear(); + markPayloadDirty(); + + await requestSyncAllTabs(); + + stopNavigationListening(); + stopMessageListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/index.ts new file mode 100644 index 00000000..63c36f5b --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/index.ts @@ -0,0 +1,12 @@ +/** + * @fileoverview Triggers 模块导出入口 + */ + +export * from './trigger-handler'; +export * from './trigger-manager'; +export * from './url-trigger'; +export * from './command-trigger'; +export * from './context-menu-trigger'; +export * from './dom-trigger'; +export * from './cron-trigger'; +export * from './manual-trigger'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/interval-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/interval-trigger.ts new file mode 100644 index 00000000..0bd6c4ec --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/interval-trigger.ts @@ -0,0 +1,243 @@ +/** + * @fileoverview Interval Trigger Handler (M3.1) + * @description + * 使用 chrome.alarms 的 periodInMinutes 实现固定间隔触发。 + * + * 策略： + * - 每个触发器对应一个重复 alarm + * - 使用 delayInMinutes 使首次触发在配置的间隔后 + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +type IntervalTriggerSpec = TriggerSpecByKind<'interval'>; + +export interface IntervalTriggerHandlerDeps { + logger?: Pick; +} + +interface InstalledIntervalTrigger { + spec: IntervalTriggerSpec; + periodMinutes: number; + version: number; +} + +// ==================== Constants ==================== + +const ALARM_PREFIX = 'rr_v3_interval_'; + +// ==================== Utilities ==================== + +/** + * 校验并规范化 periodMinutes + */ +function normalizePeriodMinutes(value: unknown): number { + if (typeof value !== 'number' || !Number.isFinite(value)) { + throw new Error('periodMinutes must be a finite number'); + } + if (value < 1) { + throw new Error('periodMinutes must be >= 1'); + } + return value; +} + +/** + * 生成 alarm 名称 + */ +function alarmNameForTrigger(triggerId: TriggerId): string { + return `${ALARM_PREFIX}${triggerId}`; +} + +/** + * 从 alarm 名称解析 triggerId + */ +function parseTriggerIdFromAlarmName(name: string): TriggerId | null { + if (!name.startsWith(ALARM_PREFIX)) return null; + const id = name.slice(ALARM_PREFIX.length); + return id ? (id as TriggerId) : null; +} + +// ==================== Handler Implementation ==================== + +/** + * 创建 interval 触发器处理器工厂 + */ +export function createIntervalTriggerHandlerFactory( + deps?: IntervalTriggerHandlerDeps, +): TriggerHandlerFactory<'interval'> { + return (fireCallback) => createIntervalTriggerHandler(fireCallback, deps); +} + +/** + * 创建 interval 触发器处理器 + */ +export function createIntervalTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: IntervalTriggerHandlerDeps, +): TriggerHandler<'interval'> { + const logger = deps?.logger ?? console; + + const installed = new Map(); + const versions = new Map(); + let listening = false; + + /** + * 递增版本号以使挂起的操作失效 + */ + function bumpVersion(triggerId: TriggerId): number { + const next = (versions.get(triggerId) ?? 0) + 1; + versions.set(triggerId, next); + return next; + } + + /** + * 清除指定 alarm + */ + async function clearAlarmByName(name: string): Promise { + if (!chrome.alarms?.clear) return; + try { + await Promise.resolve(chrome.alarms.clear(name)); + } catch (e) { + logger.debug('[IntervalTriggerHandler] alarms.clear failed:', e); + } + } + + /** + * 清除所有 interval alarms + */ + async function clearAllIntervalAlarms(): Promise { + if (!chrome.alarms?.getAll || !chrome.alarms?.clear) return; + try { + const alarms = await Promise.resolve(chrome.alarms.getAll()); + const list = Array.isArray(alarms) ? alarms : []; + await Promise.all( + list.filter((a) => a?.name?.startsWith(ALARM_PREFIX)).map((a) => clearAlarmByName(a.name)), + ); + } catch (e) { + logger.debug('[IntervalTriggerHandler] alarms.getAll failed:', e); + } + } + + /** + * 调度 alarm + */ + async function schedule(triggerId: TriggerId, expectedVersion: number): Promise { + if (!chrome.alarms?.create) { + logger.warn('[IntervalTriggerHandler] chrome.alarms.create is unavailable'); + return; + } + + const entry = installed.get(triggerId); + if (!entry || entry.version !== expectedVersion) return; + + const name = alarmNameForTrigger(triggerId); + const periodInMinutes = entry.periodMinutes; + + try { + // 使用 delayInMinutes 和 periodInMinutes 创建重复 alarm + // 首次触发在 periodInMinutes 后，之后每隔 periodInMinutes 触发 + await Promise.resolve( + chrome.alarms.create(name, { + delayInMinutes: periodInMinutes, + periodInMinutes, + }), + ); + } catch (e) { + logger.error(`[IntervalTriggerHandler] alarms.create failed for trigger "${triggerId}":`, e); + } + } + + /** + * Alarm 事件处理 + */ + const onAlarm = (alarm: chrome.alarms.Alarm): void => { + const triggerId = parseTriggerIdFromAlarmName(alarm?.name ?? ''); + if (!triggerId) return; + + const entry = installed.get(triggerId); + if (!entry) return; + + // 触发回调 + Promise.resolve( + fireCallback.onFire(triggerId, { + sourceTabId: undefined, + sourceUrl: undefined, + }), + ).catch((e) => { + logger.error(`[IntervalTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + }); + }; + + /** + * 确保正在监听 alarm 事件 + */ + function ensureListening(): void { + if (listening) return; + if (!chrome.alarms?.onAlarm?.addListener) { + logger.warn('[IntervalTriggerHandler] chrome.alarms.onAlarm is unavailable'); + return; + } + chrome.alarms.onAlarm.addListener(onAlarm); + listening = true; + } + + /** + * 停止监听 alarm 事件 + */ + function stopListening(): void { + if (!listening) return; + try { + chrome.alarms.onAlarm.removeListener(onAlarm); + } catch (e) { + logger.debug('[IntervalTriggerHandler] removeListener failed:', e); + } finally { + listening = false; + } + } + + return { + kind: 'interval', + + async install(trigger: IntervalTriggerSpec): Promise { + const periodMinutes = normalizePeriodMinutes(trigger.periodMinutes); + + const version = bumpVersion(trigger.id); + installed.set(trigger.id, { + spec: { ...trigger, periodMinutes }, + periodMinutes, + version, + }); + + ensureListening(); + await schedule(trigger.id, version); + }, + + async uninstall(triggerId: string): Promise { + const id = triggerId as TriggerId; + bumpVersion(id); + installed.delete(id); + await clearAlarmByName(alarmNameForTrigger(id)); + + if (installed.size === 0) { + stopListening(); + } + }, + + async uninstallAll(): Promise { + for (const id of installed.keys()) { + bumpVersion(id); + } + installed.clear(); + await clearAllIntervalAlarms(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/manual-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/manual-trigger.ts new file mode 100644 index 00000000..81082211 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/manual-trigger.ts @@ -0,0 +1,65 @@ +/** + * @fileoverview Manual Trigger Handler (P4-08) + * @description + * Manual triggers are the simplest trigger type - they don't auto-fire. + * They're only triggered programmatically via RPC or UI. + * + * This handler just tracks installed triggers but doesn't set up any listeners. + * Manual triggers are fired by calling TriggerManager's fire method directly. + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +export interface ManualTriggerHandlerDeps { + logger?: Pick; +} + +type ManualTriggerSpec = TriggerSpecByKind<'manual'>; + +// ==================== Handler Implementation ==================== + +/** + * Create manual trigger handler factory + */ +export function createManualTriggerHandlerFactory( + deps?: ManualTriggerHandlerDeps, +): TriggerHandlerFactory<'manual'> { + return (fireCallback) => createManualTriggerHandler(fireCallback, deps); +} + +/** + * Create manual trigger handler + * + * Manual triggers don't auto-fire - they're only triggered via RPC. + * This handler just tracks which manual triggers are installed. + */ +export function createManualTriggerHandler( + _fireCallback: TriggerFireCallback, + _deps?: ManualTriggerHandlerDeps, +): TriggerHandler<'manual'> { + const installed = new Map(); + + return { + kind: 'manual', + + async install(trigger: ManualTriggerSpec): Promise { + installed.set(trigger.id, trigger); + }, + + async uninstall(triggerId: string): Promise { + installed.delete(triggerId as TriggerId); + }, + + async uninstallAll(): Promise { + installed.clear(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/once-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/once-trigger.ts new file mode 100644 index 00000000..fb14acf7 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/once-trigger.ts @@ -0,0 +1,290 @@ +/** + * @fileoverview Once Trigger Handler (M3.1) + * @description + * 使用 chrome.alarms 的 when 参数实现一次性定时触发。 + * + * 行为： + * - 每个触发器对应一个一次性 alarm + * - 触发后自动将触发器禁用 (enabled=false) 并卸载 + */ + +import type { UnixMillis } from '../../domain/json'; +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind } from '../../domain/triggers'; +import { createTriggersStore } from '../../storage/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +type OnceTriggerSpec = TriggerSpecByKind<'once'>; + +export interface OnceTriggerHandlerDeps { + logger?: Pick; + /** + * 可选：自定义禁用触发器的方法 + * 如果未提供，将直接更新 TriggerStore + */ + disableTrigger?: (triggerId: TriggerId) => Promise; +} + +interface InstalledOnceTrigger { + spec: OnceTriggerSpec; + whenMs: UnixMillis; + version: number; +} + +// ==================== Constants ==================== + +const ALARM_PREFIX = 'rr_v3_once_'; + +// ==================== Utilities ==================== + +/** + * 校验并规范化 whenMs + */ +function normalizeWhenMs(value: unknown): UnixMillis { + if (typeof value !== 'number' || !Number.isFinite(value)) { + throw new Error('whenMs must be a finite number'); + } + return Math.floor(value) as UnixMillis; +} + +/** + * 生成 alarm 名称 + */ +function alarmNameForTrigger(triggerId: TriggerId): string { + return `${ALARM_PREFIX}${triggerId}`; +} + +/** + * 从 alarm 名称解析 triggerId + */ +function parseTriggerIdFromAlarmName(name: string): TriggerId | null { + if (!name.startsWith(ALARM_PREFIX)) return null; + const id = name.slice(ALARM_PREFIX.length); + return id ? (id as TriggerId) : null; +} + +// ==================== Handler Implementation ==================== + +/** + * 创建 once 触发器处理器工厂 + */ +export function createOnceTriggerHandlerFactory( + deps?: OnceTriggerHandlerDeps, +): TriggerHandlerFactory<'once'> { + return (fireCallback) => createOnceTriggerHandler(fireCallback, deps); +} + +/** + * 创建 once 触发器处理器 + */ +export function createOnceTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: OnceTriggerHandlerDeps, +): TriggerHandler<'once'> { + const logger = deps?.logger ?? console; + + // 延迟创建 store，避免在测试环境中出问题 + let triggersStore: ReturnType | null = null; + const getTriggersStore = () => { + if (!triggersStore) { + triggersStore = createTriggersStore(); + } + return triggersStore; + }; + + const disableTrigger = + deps?.disableTrigger ?? + (async (triggerId: TriggerId) => { + const store = getTriggersStore(); + const existing = await store.get(triggerId); + if (!existing) return; + if (!existing.enabled) return; + await store.save({ ...existing, enabled: false }); + }); + + const installed = new Map(); + const versions = new Map(); + let listening = false; + + /** + * 递增版本号以使挂起的操作失效 + */ + function bumpVersion(triggerId: TriggerId): number { + const next = (versions.get(triggerId) ?? 0) + 1; + versions.set(triggerId, next); + return next; + } + + /** + * 清除指定 alarm + */ + async function clearAlarmByName(name: string): Promise { + if (!chrome.alarms?.clear) return; + try { + await Promise.resolve(chrome.alarms.clear(name)); + } catch (e) { + logger.debug('[OnceTriggerHandler] alarms.clear failed:', e); + } + } + + /** + * 清除所有 once alarms + */ + async function clearAllOnceAlarms(): Promise { + if (!chrome.alarms?.getAll || !chrome.alarms?.clear) return; + try { + const alarms = await Promise.resolve(chrome.alarms.getAll()); + const list = Array.isArray(alarms) ? alarms : []; + await Promise.all( + list.filter((a) => a?.name?.startsWith(ALARM_PREFIX)).map((a) => clearAlarmByName(a.name)), + ); + } catch (e) { + logger.debug('[OnceTriggerHandler] alarms.getAll failed:', e); + } + } + + /** + * 调度 alarm + */ + async function schedule(triggerId: TriggerId, expectedVersion: number): Promise { + if (!chrome.alarms?.create) { + logger.warn('[OnceTriggerHandler] chrome.alarms.create is unavailable'); + return; + } + + const entry = installed.get(triggerId); + if (!entry || entry.version !== expectedVersion) return; + + const name = alarmNameForTrigger(triggerId); + + try { + await Promise.resolve(chrome.alarms.create(name, { when: entry.whenMs })); + } catch (e) { + logger.error(`[OnceTriggerHandler] alarms.create failed for trigger "${triggerId}":`, e); + } + } + + /** + * 内部卸载逻辑（不触发外部 uninstall） + */ + async function uninstallInternal(triggerId: TriggerId): Promise { + bumpVersion(triggerId); + installed.delete(triggerId); + await clearAlarmByName(alarmNameForTrigger(triggerId)); + + if (installed.size === 0) { + stopListening(); + } + } + + /** + * Alarm 事件处理 + */ + const onAlarm = (alarm: chrome.alarms.Alarm): void => { + const triggerId = parseTriggerIdFromAlarmName(alarm?.name ?? ''); + if (!triggerId) return; + + const entry = installed.get(triggerId); + if (!entry) return; + + const expectedVersion = entry.version; + + void (async () => { + try { + await fireCallback.onFire(triggerId, { + sourceTabId: undefined, + sourceUrl: undefined, + }); + } catch (e) { + logger.error(`[OnceTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + } finally { + // 检查版本是否仍然有效 + if (installed.get(triggerId)?.version === expectedVersion) { + // 禁用触发器 + try { + await disableTrigger(triggerId); + } catch (e) { + logger.error( + `[OnceTriggerHandler] Failed to disable trigger "${triggerId}" after fire:`, + e, + ); + } + + // 卸载触发器 + try { + await uninstallInternal(triggerId); + } catch (e) { + logger.error( + `[OnceTriggerHandler] Failed to uninstall trigger "${triggerId}" after fire:`, + e, + ); + } + } + } + })(); + }; + + /** + * 确保正在监听 alarm 事件 + */ + function ensureListening(): void { + if (listening) return; + if (!chrome.alarms?.onAlarm?.addListener) { + logger.warn('[OnceTriggerHandler] chrome.alarms.onAlarm is unavailable'); + return; + } + chrome.alarms.onAlarm.addListener(onAlarm); + listening = true; + } + + /** + * 停止监听 alarm 事件 + */ + function stopListening(): void { + if (!listening) return; + try { + chrome.alarms.onAlarm.removeListener(onAlarm); + } catch (e) { + logger.debug('[OnceTriggerHandler] removeListener failed:', e); + } finally { + listening = false; + } + } + + return { + kind: 'once', + + async install(trigger: OnceTriggerSpec): Promise { + const whenMs = normalizeWhenMs(trigger.whenMs); + + const version = bumpVersion(trigger.id); + installed.set(trigger.id, { + spec: { ...trigger, whenMs }, + whenMs, + version, + }); + + ensureListening(); + await schedule(trigger.id, version); + }, + + async uninstall(triggerId: string): Promise { + await uninstallInternal(triggerId as TriggerId); + }, + + async uninstallAll(): Promise { + for (const id of installed.keys()) { + bumpVersion(id); + } + installed.clear(); + await clearAllOnceAlarms(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler.ts new file mode 100644 index 00000000..fcd9e8a6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler.ts @@ -0,0 +1,66 @@ +/** + * @fileoverview 触发器处理器接口定义 + * @description 定义各类触发器的统一接口 + */ + +import type { TriggerSpec, TriggerKind } from '../../domain/triggers'; + +/** + * 触发器处理器接口 + * @description 每种触发器类型需要实现此接口 + */ +export interface TriggerHandler { + /** 触发器类型 */ + readonly kind: K; + + /** + * 安装触发器 + * @description 注册 chrome API 监听器等 + * @param trigger 触发器规范 + */ + install(trigger: Extract): Promise; + + /** + * 卸载触发器 + * @description 移除 chrome API 监听器等 + * @param triggerId 触发器 ID + */ + uninstall(triggerId: string): Promise; + + /** + * 卸载所有触发器 + * @description 清理所有此类型的触发器 + */ + uninstallAll(): Promise; + + /** + * 获取已安装的触发器 ID 列表 + */ + getInstalledIds(): string[]; +} + +/** + * 触发器触发回调 + * @description TriggerManager 注入给各 Handler 的回调 + */ +export interface TriggerFireCallback { + /** + * 触发器被触发时调用 + * @param triggerId 触发器 ID + * @param context 触发上下文 + */ + onFire( + triggerId: string, + context: { + sourceTabId?: number; + sourceUrl?: string; + }, + ): Promise; +} + +/** + * 触发器处理器工厂 + */ +export type TriggerHandlerFactory = ( + fireCallback: TriggerFireCallback, +) => TriggerHandler; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-manager.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-manager.ts new file mode 100644 index 00000000..c9a93164 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/trigger-manager.ts @@ -0,0 +1,427 @@ +/** + * @fileoverview 触发器管理器 + * @description + * TriggerManager 负责管理所有触发器 Handler 的生命周期： + * - 从 TriggerStore 加载触发器并安装 + * - 处理触发器触发事件，调用 enqueueRun + * - 提供防风暴机制 (cooldown + maxQueued) + * + * 设计理由： + * - Orchestrator 模式：TriggerManager 不直接实现各类触发器逻辑，而是委托给 per-kind Handler + * - Handler 工厂模式：TriggerManager 在构造时创建 Handler 实例，注入 fireCallback + * - 防风暴：cooldown (per-trigger) + maxQueued (global best-effort) + */ + +import type { UnixMillis } from '../../domain/json'; +import type { RunId, TriggerId } from '../../domain/ids'; +import type { TriggerFireContext, TriggerKind, TriggerSpec } from '../../domain/triggers'; +import type { StoragePort } from '../storage/storage-port'; +import type { EventsBus } from '../transport/events-bus'; +import type { RunScheduler } from '../queue/scheduler'; +import { enqueueRun, type EnqueueRunResult } from '../queue/enqueue-run'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +/** + * Handler 工厂映射 + */ +export type TriggerHandlerFactories = Partial<{ + [K in TriggerKind]: TriggerHandlerFactory; +}>; + +/** + * 防风暴配置 + */ +export interface TriggerManagerStormControl { + /** + * 同一触发器两次触发之间的最小间隔 (ms) + * - 0 或 undefined 表示禁用冷却 + */ + cooldownMs?: number; + + /** + * 全局最大排队 Run 数量 + * - 达到上限时拒绝新的触发 + * - undefined 表示禁用上限检查 + * - 注意：这是 best-effort 检查，非原子性 + */ + maxQueued?: number; +} + +/** + * TriggerManager 依赖 + */ +export interface TriggerManagerDeps { + /** 存储层 */ + storage: Pick; + /** 事件总线 */ + events: Pick; + /** 调度器 (可选) */ + scheduler?: Pick; + /** Handler 工厂映射 */ + handlerFactories: TriggerHandlerFactories; + /** 防风暴配置 */ + storm?: TriggerManagerStormControl; + /** RunId 生成器 (用于测试注入) */ + generateRunId?: () => RunId; + /** 时间源 (用于测试注入) */ + now?: () => UnixMillis; + /** 日志器 */ + logger?: Pick; +} + +/** + * TriggerManager 状态 + */ +export interface TriggerManagerState { + /** 是否已启动 */ + started: boolean; + /** 已安装的触发器 ID 列表 */ + installedTriggerIds: TriggerId[]; +} + +/** + * TriggerManager 接口 + */ +export interface TriggerManager { + /** 启动管理器，加载并安装所有启用的触发器 */ + start(): Promise; + /** 停止管理器，卸载所有触发器 */ + stop(): Promise; + /** 刷新触发器，重新从存储加载并安装 */ + refresh(): Promise; + /** + * 手动触发一个触发器 + * @description 仅供 RPC/UI 调用，用于 manual 触发器 + */ + fire( + triggerId: TriggerId, + context?: { sourceTabId?: number; sourceUrl?: string }, + ): Promise; + /** 销毁管理器 */ + dispose(): Promise; + /** 获取当前状态 */ + getState(): TriggerManagerState; +} + +// ==================== Utilities ==================== + +/** + * 校验非负整数 + */ +function normalizeNonNegativeInt(value: unknown, fallback: number, fieldName: string): number { + if (value === undefined || value === null) return fallback; + if (typeof value !== 'number' || !Number.isFinite(value)) { + throw new Error(`${fieldName} must be a finite number`); + } + return Math.max(0, Math.floor(value)); +} + +/** + * 校验正整数 + */ +function normalizePositiveInt(value: unknown, fieldName: string): number { + if (typeof value !== 'number' || !Number.isFinite(value)) { + throw new Error(`${fieldName} must be a finite number`); + } + const intValue = Math.floor(value); + if (intValue < 1) { + throw new Error(`${fieldName} must be >= 1`); + } + return intValue; +} + +// ==================== Implementation ==================== + +/** + * 创建 TriggerManager + */ +export function createTriggerManager(deps: TriggerManagerDeps): TriggerManager { + const logger = deps.logger ?? console; + const now = deps.now ?? (() => Date.now()); + + // 防风暴参数 + const cooldownMs = normalizeNonNegativeInt(deps.storm?.cooldownMs, 0, 'storm.cooldownMs'); + const maxQueued = + deps.storm?.maxQueued === undefined || deps.storm?.maxQueued === null + ? undefined + : normalizePositiveInt(deps.storm.maxQueued, 'storm.maxQueued'); + + // 状态 + const installed = new Map(); + const lastFireAt = new Map(); + let started = false; + let inFlightEnqueues = 0; + + // 防止 refresh 重入 + let refreshPromise: Promise | null = null; + let pendingRefresh = false; + + // Handler 实例 + const handlers = new Map>(); + + // 触发回调 + const fireCallback: TriggerFireCallback = { + onFire: async (triggerId, context) => { + // 捕获所有异常，避免抛入 chrome API 监听器 + try { + await handleFire(triggerId as TriggerId, context); + } catch (e) { + logger.error('[TriggerManager] onFire failed:', e); + } + }, + }; + + // 初始化 Handler 实例 + for (const [kind, factory] of Object.entries(deps.handlerFactories) as Array< + [TriggerKind, TriggerHandlerFactory | undefined] + >) { + if (!factory) continue; // Skip undefined factory values + + const handler = factory(fireCallback) as TriggerHandler; + if (handler.kind !== kind) { + throw new Error( + `[TriggerManager] Handler kind mismatch: factory key is "${kind}", but handler.kind is "${handler.kind}"`, + ); + } + handlers.set(kind, handler); + } + + /** + * 处理触发器触发（内部方法） + * @param throwOnDrop 如果为 true，则在 cooldown/maxQueued 等情况下抛出错误 + * @returns EnqueueRunResult 或 null（静默丢弃） + */ + async function handleFire( + triggerId: TriggerId, + context: { sourceTabId?: number; sourceUrl?: string }, + options?: { throwOnDrop?: boolean }, + ): Promise { + if (!started) { + if (options?.throwOnDrop) { + throw new Error('TriggerManager is not started'); + } + return null; + } + + const trigger = installed.get(triggerId); + if (!trigger) { + if (options?.throwOnDrop) { + throw new Error(`Trigger "${triggerId}" is not installed`); + } + return null; + } + + const t = now(); + + // Per-trigger cooldown 检查 + const prevLastFireAt = lastFireAt.get(triggerId); + if (cooldownMs > 0 && prevLastFireAt !== undefined && t - prevLastFireAt < cooldownMs) { + logger.debug(`[TriggerManager] Dropping trigger "${triggerId}" (cooldown ${cooldownMs}ms)`); + if (options?.throwOnDrop) { + throw new Error(`Trigger "${triggerId}" dropped (cooldown ${cooldownMs}ms)`); + } + return null; + } + + // Global maxQueued 检查 (best-effort) + // 注意：在 cooldown 设置前检查，避免因 maxQueued drop 而误设 cooldown + if (maxQueued !== undefined) { + const queued = await deps.storage.queue.list('queued'); + if (queued.length + inFlightEnqueues >= maxQueued) { + logger.warn( + `[TriggerManager] Dropping trigger "${triggerId}" (queued=${queued.length}, inFlight=${inFlightEnqueues}, maxQueued=${maxQueued})`, + ); + if (options?.throwOnDrop) { + throw new Error(`Trigger "${triggerId}" dropped (maxQueued=${maxQueued})`); + } + return null; + } + } + + // 设置 lastFireAt 以抑制并发触发（在 maxQueued 检查通过后） + if (cooldownMs > 0) { + lastFireAt.set(triggerId, t); + } + + // 构建触发上下文 + const triggerContext: TriggerFireContext = { + triggerId: trigger.id, + kind: trigger.kind, + firedAt: t, + sourceTabId: context.sourceTabId, + sourceUrl: context.sourceUrl, + }; + + inFlightEnqueues += 1; + try { + const result = await enqueueRun( + { + storage: deps.storage, + events: deps.events, + scheduler: deps.scheduler, + generateRunId: deps.generateRunId, + now, + }, + { + flowId: trigger.flowId, + args: trigger.args, + trigger: triggerContext, + }, + ); + return result; + } catch (e) { + // 入队失败时回滚 cooldown 标记 + if (cooldownMs > 0) { + if (prevLastFireAt === undefined) { + lastFireAt.delete(triggerId); + } else { + lastFireAt.set(triggerId, prevLastFireAt); + } + } + const msg = e instanceof Error ? e.message : String(e); + logger.error(`[TriggerManager] enqueueRun failed for trigger "${triggerId}":`, e); + if (options?.throwOnDrop) { + throw new Error(`enqueueRun failed for trigger "${triggerId}": ${msg}`); + } + return null; + } finally { + inFlightEnqueues -= 1; + } + } + + /** + * 手动触发一个触发器（对外暴露） + * @description 用于 RPC/UI 调用，会抛出错误而不是静默丢弃 + */ + async function fire( + triggerId: TriggerId, + context: { sourceTabId?: number; sourceUrl?: string } = {}, + ): Promise { + const result = await handleFire(triggerId, context, { throwOnDrop: true }); + if (!result) { + throw new Error(`Trigger "${triggerId}" did not enqueue a run`); + } + return result; + } + + /** + * 执行刷新 + */ + async function doRefresh(): Promise { + const triggers = await deps.storage.triggers.list(); + if (!started) return; + + // 先卸载所有，再重新安装 (简单策略，保证一致性) + // Best-effort: 单个 handler 卸载失败不影响其他 + for (const handler of handlers.values()) { + try { + await handler.uninstallAll(); + } catch (e) { + logger.warn(`[TriggerManager] Error during uninstallAll for kind "${handler.kind}":`, e); + } + } + installed.clear(); + + // 安装启用的触发器 + for (const trigger of triggers) { + if (!started) return; + if (!trigger.enabled) continue; + + const handler = handlers.get(trigger.kind); + if (!handler) { + logger.warn(`[TriggerManager] No handler registered for kind "${trigger.kind}"`); + continue; + } + + try { + await handler.install(trigger as Parameters[0]); + installed.set(trigger.id, trigger); + } catch (e) { + logger.error(`[TriggerManager] Failed to install trigger "${trigger.id}":`, e); + } + } + } + + /** + * 刷新触发器 (合并并发调用) + */ + async function refresh(): Promise { + if (!started) { + throw new Error('TriggerManager is not started'); + } + + pendingRefresh = true; + if (!refreshPromise) { + refreshPromise = (async () => { + while (started && pendingRefresh) { + pendingRefresh = false; + await doRefresh(); + } + })().finally(() => { + refreshPromise = null; + }); + } + + return refreshPromise; + } + + /** + * 启动管理器 + */ + async function start(): Promise { + if (started) return; + started = true; + await refresh(); + } + + /** + * 停止管理器 + */ + async function stop(): Promise { + if (!started) return; + + started = false; + pendingRefresh = false; + + // 等待进行中的 refresh 完成 + if (refreshPromise) { + try { + await refreshPromise; + } catch { + // 忽略 refresh 错误 + } + } + + // 卸载所有触发器 + for (const handler of handlers.values()) { + try { + await handler.uninstallAll(); + } catch (e) { + logger.warn('[TriggerManager] Error uninstalling handler:', e); + } + } + installed.clear(); + lastFireAt.clear(); + } + + /** + * 销毁管理器 + */ + async function dispose(): Promise { + await stop(); + } + + /** + * 获取状态 + */ + function getState(): TriggerManagerState { + return { + started, + installedTriggerIds: Array.from(installed.keys()), + }; + } + + return { start, stop, refresh, fire, dispose, getState }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/url-trigger.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/url-trigger.ts new file mode 100644 index 00000000..fa4dddcd --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/engine/triggers/url-trigger.ts @@ -0,0 +1,261 @@ +/** + * @fileoverview URL Trigger Handler (P4-03) + * @description + * Listens to `chrome.webNavigation.onCompleted` and fires installed URL triggers. + * + * URL matching semantics: + * - kind:'url' - Full URL prefix match (allows query/hash variations) + * - kind:'domain' - Safe subdomain match (hostname === domain OR hostname.endsWith('.' + domain)) + * - kind:'path' - Pathname prefix match + * + * Design rationale: + * - No regex/wildcards for performance and auditability + * - Domain matching uses safe subdomain logic to avoid false positives (e.g. 'notexample.com') + * - Single listener instance manages multiple triggers efficiently + */ + +import type { TriggerId } from '../../domain/ids'; +import type { TriggerSpecByKind, UrlMatchRule } from '../../domain/triggers'; +import type { TriggerFireCallback, TriggerHandler, TriggerHandlerFactory } from './trigger-handler'; + +// ==================== Types ==================== + +export interface UrlTriggerHandlerDeps { + logger?: Pick; +} + +type UrlTriggerSpec = TriggerSpecByKind<'url'>; + +/** + * Compiled URL match rules for efficient matching + */ +interface CompiledUrlRules { + /** Full URL prefixes */ + urlPrefixes: string[]; + /** Normalized domains (lowercase, no leading/trailing dots) */ + domains: string[]; + /** Normalized path prefixes (always starts with '/') */ + pathPrefixes: string[]; +} + +interface InstalledUrlTrigger { + spec: UrlTriggerSpec; + rules: CompiledUrlRules; +} + +// ==================== Normalization Utilities ==================== + +/** + * Normalize domain value + * - Trim whitespace + * - Convert to lowercase + * - Remove leading/trailing dots + */ +function normalizeDomain(value: string): string | null { + const normalized = value.trim().toLowerCase().replace(/^\.+/, '').replace(/\.+$/, ''); + return normalized || null; +} + +/** + * Normalize path prefix + * - Trim whitespace + * - Ensure starts with '/' + */ +function normalizePathPrefix(value: string): string | null { + const trimmed = value.trim(); + if (!trimmed) return null; + return trimmed.startsWith('/') ? trimmed : `/${trimmed}`; +} + +/** + * Normalize URL prefix + * - Trim whitespace only + */ +function normalizeUrlPrefix(value: string): string | null { + const trimmed = value.trim(); + return trimmed || null; +} + +/** + * Compile URL match rules from spec + */ +function compileUrlMatchRules(match: UrlMatchRule[] | undefined): CompiledUrlRules { + const urlPrefixes: string[] = []; + const domains: string[] = []; + const pathPrefixes: string[] = []; + + for (const rule of match ?? []) { + const { kind } = rule; + const raw = typeof rule.value === 'string' ? rule.value : String(rule.value ?? ''); + + switch (kind) { + case 'url': { + const normalized = normalizeUrlPrefix(raw); + if (normalized) urlPrefixes.push(normalized); + break; + } + case 'domain': { + const normalized = normalizeDomain(raw); + if (normalized) domains.push(normalized); + break; + } + case 'path': { + const normalized = normalizePathPrefix(raw); + if (normalized) pathPrefixes.push(normalized); + break; + } + } + } + + return { urlPrefixes, domains, pathPrefixes }; +} + +// ==================== Matching Logic ==================== + +/** + * Check if hostname matches domain (exact or subdomain) + */ +function hostnameMatchesDomain(hostname: string, domain: string): boolean { + if (hostname === domain) return true; + return hostname.endsWith(`.${domain}`); +} + +/** + * Check if URL matches any of the compiled rules + */ +function matchesRules(compiled: CompiledUrlRules, urlString: string, parsed: URL): boolean { + // URL prefix match + for (const prefix of compiled.urlPrefixes) { + if (urlString.startsWith(prefix)) return true; + } + + // Domain match + const hostname = parsed.hostname.toLowerCase(); + for (const domain of compiled.domains) { + if (hostnameMatchesDomain(hostname, domain)) return true; + } + + // Path prefix match + const pathname = parsed.pathname || '/'; + for (const prefix of compiled.pathPrefixes) { + if (pathname.startsWith(prefix)) return true; + } + + return false; +} + +// ==================== Handler Implementation ==================== + +/** + * Create URL trigger handler factory + */ +export function createUrlTriggerHandlerFactory( + deps?: UrlTriggerHandlerDeps, +): TriggerHandlerFactory<'url'> { + return (fireCallback) => createUrlTriggerHandler(fireCallback, deps); +} + +/** + * Create URL trigger handler + */ +export function createUrlTriggerHandler( + fireCallback: TriggerFireCallback, + deps?: UrlTriggerHandlerDeps, +): TriggerHandler<'url'> { + const logger = deps?.logger ?? console; + + const installed = new Map(); + let listening = false; + + /** + * Handle webNavigation.onCompleted event + */ + const onCompleted = (details: chrome.webNavigation.WebNavigationFramedCallbackDetails): void => { + // Only handle main frame navigations + if (details.frameId !== 0) return; + + const urlString = details.url; + + // Parse URL + let parsed: URL; + try { + parsed = new URL(urlString); + } catch { + return; // Invalid URL, skip + } + + if (installed.size === 0) return; + + // Snapshot to avoid iteration hazards during concurrent install/uninstall + const snapshot = Array.from(installed.entries()); + + for (const [triggerId, trigger] of snapshot) { + if (!matchesRules(trigger.rules, urlString, parsed)) continue; + + // Fire and forget: chrome event listeners should not block navigation + Promise.resolve( + fireCallback.onFire(triggerId, { + sourceTabId: details.tabId, + sourceUrl: urlString, + }), + ).catch((e) => { + logger.error(`[UrlTriggerHandler] onFire failed for trigger "${triggerId}":`, e); + }); + } + }; + + /** + * Ensure listener is registered + */ + function ensureListening(): void { + if (listening) return; + if (!chrome.webNavigation?.onCompleted?.addListener) { + logger.warn('[UrlTriggerHandler] chrome.webNavigation.onCompleted is unavailable'); + return; + } + chrome.webNavigation.onCompleted.addListener(onCompleted); + listening = true; + } + + /** + * Stop listening + */ + function stopListening(): void { + if (!listening) return; + try { + chrome.webNavigation.onCompleted.removeListener(onCompleted); + } catch (e) { + logger.debug('[UrlTriggerHandler] removeListener failed:', e); + } finally { + listening = false; + } + } + + return { + kind: 'url', + + async install(trigger: UrlTriggerSpec): Promise { + installed.set(trigger.id, { + spec: trigger, + rules: compileUrlMatchRules(trigger.match), + }); + ensureListening(); + }, + + async uninstall(triggerId: string): Promise { + installed.delete(triggerId as TriggerId); + if (installed.size === 0) { + stopListening(); + } + }, + + async uninstallAll(): Promise { + installed.clear(); + stopListening(); + }, + + getInstalledIds(): string[] { + return Array.from(installed.keys()); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/index.ts new file mode 100644 index 00000000..1e7aad7a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/index.ts @@ -0,0 +1,45 @@ +/** + * @fileoverview Record-Replay V3 公共 API 入口 + * @description 导出所有公共类型和接口 + */ + +// ==================== Domain ==================== +export * from './domain'; + +// ==================== Engine ==================== +export * from './engine'; + +// ==================== Storage ==================== +export * from './storage'; + +// ==================== Factory Functions ==================== + +import type { StoragePort } from './engine/storage/storage-port'; +import { createFlowsStore } from './storage/flows'; +import { createRunsStore } from './storage/runs'; +import { createEventsStore } from './storage/events'; +import { createQueueStore } from './storage/queue'; +import { createPersistentVarsStore } from './storage/persistent-vars'; +import { createTriggersStore } from './storage/triggers'; + +/** + * 创建完整的 StoragePort 实现 + */ +export function createStoragePort(): StoragePort { + return { + flows: createFlowsStore(), + runs: createRunsStore(), + events: createEventsStore(), + queue: createQueueStore(), + persistentVars: createPersistentVarsStore(), + triggers: createTriggersStore(), + }; +} + +// ==================== Version ==================== + +/** V3 API 版本 */ +export const RR_V3_VERSION = '3.0.0' as const; + +/** 是否为 V3 API */ +export const IS_RR_V3 = true as const; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/db.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/db.ts new file mode 100644 index 00000000..cac040ec --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/db.ts @@ -0,0 +1,231 @@ +/** + * @fileoverview V3 IndexedDB 数据库定义 + * @description 定义 rr_v3 数据库的 schema 和初始化逻辑 + */ + +/** 数据库名称 */ +export const RR_V3_DB_NAME = 'rr_v3'; + +/** 数据库版本 */ +export const RR_V3_DB_VERSION = 1; + +/** + * Store 名称常量 + */ +export const RR_V3_STORES = { + FLOWS: 'flows', + RUNS: 'runs', + EVENTS: 'events', + QUEUE: 'queue', + PERSISTENT_VARS: 'persistent_vars', + TRIGGERS: 'triggers', +} as const; + +/** + * Store 配置 + */ +export interface StoreConfig { + keyPath: string | string[]; + autoIncrement?: boolean; + indexes?: Array<{ + name: string; + keyPath: string | string[]; + options?: IDBIndexParameters; + }>; +} + +/** + * V3 Store Schema 定义 + * @description 包含 Phase 1-3 所需的所有索引，避免后续升级 + */ +export const RR_V3_STORE_SCHEMAS: Record = { + [RR_V3_STORES.FLOWS]: { + keyPath: 'id', + indexes: [ + { name: 'name', keyPath: 'name' }, + { name: 'updatedAt', keyPath: 'updatedAt' }, + ], + }, + [RR_V3_STORES.RUNS]: { + keyPath: 'id', + indexes: [ + { name: 'status', keyPath: 'status' }, + { name: 'flowId', keyPath: 'flowId' }, + { name: 'createdAt', keyPath: 'createdAt' }, + { name: 'updatedAt', keyPath: 'updatedAt' }, + // Compound index for listing runs by flow and status + { name: 'flowId_status', keyPath: ['flowId', 'status'] }, + ], + }, + [RR_V3_STORES.EVENTS]: { + keyPath: ['runId', 'seq'], + indexes: [ + { name: 'runId', keyPath: 'runId' }, + { name: 'type', keyPath: 'type' }, + // Compound index for filtering events by run and type + { name: 'runId_type', keyPath: ['runId', 'type'] }, + ], + }, + [RR_V3_STORES.QUEUE]: { + keyPath: 'id', + indexes: [ + { name: 'status', keyPath: 'status' }, + { name: 'priority', keyPath: 'priority' }, + { name: 'createdAt', keyPath: 'createdAt' }, + { name: 'flowId', keyPath: 'flowId' }, + // Phase 3: Used by claimNext(); cursor direction + key ranges implement priority DESC + createdAt ASC. + { name: 'status_priority_createdAt', keyPath: ['status', 'priority', 'createdAt'] }, + // Phase 3: Lease expiration tracking + { name: 'lease_expiresAt', keyPath: 'lease.expiresAt' }, + ], + }, + [RR_V3_STORES.PERSISTENT_VARS]: { + keyPath: 'key', + indexes: [{ name: 'updatedAt', keyPath: 'updatedAt' }], + }, + [RR_V3_STORES.TRIGGERS]: { + keyPath: 'id', + indexes: [ + { name: 'kind', keyPath: 'kind' }, + { name: 'flowId', keyPath: 'flowId' }, + { name: 'enabled', keyPath: 'enabled' }, + // Compound index for listing enabled triggers by kind + { name: 'kind_enabled', keyPath: ['kind', 'enabled'] }, + ], + }, +}; + +/** + * 数据库升级处理器 + */ +export function handleUpgrade(db: IDBDatabase, oldVersion: number, _newVersion: number): void { + // Version 0 -> 1: 创建所有 stores + if (oldVersion < 1) { + for (const [storeName, config] of Object.entries(RR_V3_STORE_SCHEMAS)) { + const store = db.createObjectStore(storeName, { + keyPath: config.keyPath, + autoIncrement: config.autoIncrement, + }); + + // 创建索引 + if (config.indexes) { + for (const index of config.indexes) { + store.createIndex(index.name, index.keyPath, index.options); + } + } + } + } +} + +/** 全局数据库实例 */ +let dbInstance: IDBDatabase | null = null; +let dbPromise: Promise | null = null; + +/** + * 打开 V3 数据库 + * @description 单例模式，确保只有一个数据库连接 + */ +export async function openRrV3Db(): Promise { + if (dbInstance) { + return dbInstance; + } + + if (dbPromise) { + return dbPromise; + } + + dbPromise = new Promise((resolve, reject) => { + const request = indexedDB.open(RR_V3_DB_NAME, RR_V3_DB_VERSION); + + request.onerror = () => { + dbPromise = null; + reject(new Error(`Failed to open database: ${request.error?.message}`)); + }; + + request.onsuccess = () => { + dbInstance = request.result; + + // 处理版本变更（其他 tab 升级了数据库） + dbInstance.onversionchange = () => { + dbInstance?.close(); + dbInstance = null; + dbPromise = null; + }; + + resolve(dbInstance); + }; + + request.onupgradeneeded = (event) => { + const db = request.result; + const oldVersion = event.oldVersion; + const newVersion = event.newVersion ?? RR_V3_DB_VERSION; + handleUpgrade(db, oldVersion, newVersion); + }; + }); + + return dbPromise; +} + +/** + * 关闭数据库连接 + * @description 主要用于测试 + */ +export function closeRrV3Db(): void { + if (dbInstance) { + dbInstance.close(); + dbInstance = null; + dbPromise = null; + } +} + +/** + * 删除数据库 + * @description 主要用于测试 + */ +export async function deleteRrV3Db(): Promise { + closeRrV3Db(); + + return new Promise((resolve, reject) => { + const request = indexedDB.deleteDatabase(RR_V3_DB_NAME); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); +} + +/** + * 执行事务 + * @param storeNames Store 名称（单个或多个） + * @param mode 事务模式 + * @param callback 事务回调 + */ +export async function withTransaction( + storeNames: string | string[], + mode: IDBTransactionMode, + callback: (stores: Record) => Promise | T, +): Promise { + const db = await openRrV3Db(); + const names = Array.isArray(storeNames) ? storeNames : [storeNames]; + const tx = db.transaction(names, mode); + + const stores: Record = {}; + for (const name of names) { + stores[name] = tx.objectStore(name); + } + + return new Promise((resolve, reject) => { + let result: T; + + tx.oncomplete = () => resolve(result); + tx.onerror = () => reject(tx.error); + tx.onabort = () => reject(tx.error || new Error('Transaction aborted')); + + Promise.resolve(callback(stores)) + .then((r) => { + result = r; + }) + .catch((err) => { + tx.abort(); + reject(err); + }); + }); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/events.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/events.ts new file mode 100644 index 00000000..e6d6ffdd --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/events.ts @@ -0,0 +1,149 @@ +/** + * @fileoverview RunEvent 持久化 + * @description 实现事件的原子 seq 分配和存储 + */ + +import type { RunId } from '../domain/ids'; +import type { RunEvent, RunEventInput, RunRecordV3 } from '../domain/events'; +import { RR_ERROR_CODES, createRRError } from '../domain/errors'; +import type { EventsStore } from '../engine/storage/storage-port'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** + * IDB request helper - promisify IDBRequest with RRError wrapping + */ +function idbRequest(request: IDBRequest, context: string): Promise { + return new Promise((resolve, reject) => { + request.onsuccess = () => resolve(request.result); + request.onerror = () => { + const error = request.error; + reject( + createRRError( + RR_ERROR_CODES.INTERNAL, + `IDB error in ${context}: ${error?.message ?? 'unknown'}`, + ), + ); + }; + }); +} + +/** + * 创建 EventsStore 实现 + * @description + * - append() 在单个事务中原子分配 seq + * - seq 由 RunRecordV3.nextSeq 作为单一事实来源 + */ +export function createEventsStore(): EventsStore { + return { + /** + * 追加事件并原子分配 seq + * @description 在单个事务中：读取 RunRecordV3.nextSeq -> 写入事件 -> 递增 nextSeq + */ + async append(input: RunEventInput): Promise { + return withTransaction( + [RR_V3_STORES.RUNS, RR_V3_STORES.EVENTS], + 'readwrite', + async (stores) => { + const runsStore = stores[RR_V3_STORES.RUNS]; + const eventsStore = stores[RR_V3_STORES.EVENTS]; + + // Step 1: Read nextSeq from RunRecordV3 (single source of truth) + const run = await idbRequest( + runsStore.get(input.runId), + `append.getRun(${input.runId})`, + ); + + if (!run) { + throw createRRError( + RR_ERROR_CODES.INTERNAL, + `Run "${input.runId}" not found when appending event`, + ); + } + + const seq = run.nextSeq; + + // Validate seq integrity + if (!Number.isSafeInteger(seq) || seq < 0) { + throw createRRError( + RR_ERROR_CODES.INVARIANT_VIOLATION, + `Invalid nextSeq for run "${input.runId}": ${String(seq)}`, + ); + } + + // Step 2: Create complete event with allocated seq + const event: RunEvent = { + ...input, + seq, + ts: input.ts ?? Date.now(), + } as RunEvent; + + // Step 3: Write event to events store + await idbRequest(eventsStore.add(event), `append.addEvent(${input.runId}, seq=${seq})`); + + // Step 4: Increment nextSeq in runs store (same transaction) + const updatedRun: RunRecordV3 = { + ...run, + nextSeq: seq + 1, + updatedAt: Date.now(), + }; + + await idbRequest( + runsStore.put(updatedRun), + `append.updateNextSeq(${input.runId}, nextSeq=${seq + 1})`, + ); + + return event; + }, + ); + }, + + /** + * 列出事件 + * @description 利用复合主键 [runId, seq] 实现高效范围查询 + */ + async list(runId: RunId, opts?: { fromSeq?: number; limit?: number }): Promise { + return withTransaction(RR_V3_STORES.EVENTS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.EVENTS]; + const fromSeq = opts?.fromSeq ?? 0; + const limit = opts?.limit; + + // Early return for zero limit + if (limit === 0) { + return []; + } + + return new Promise((resolve, reject) => { + const results: RunEvent[] = []; + + // Use compound primary key [runId, seq] for efficient range query + // This yields events in seq-ascending order naturally + const range = IDBKeyRange.bound([runId, fromSeq], [runId, Number.MAX_SAFE_INTEGER]); + + const request = store.openCursor(range); + + request.onsuccess = () => { + const cursor = request.result; + + if (!cursor) { + resolve(results); + return; + } + + const event = cursor.value as RunEvent; + results.push(event); + + // Check limit + if (limit !== undefined && results.length >= limit) { + resolve(results); + return; + } + + cursor.continue(); + }; + + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/flows.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/flows.ts new file mode 100644 index 00000000..360e024f --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/flows.ts @@ -0,0 +1,114 @@ +/** + * @fileoverview FlowV3 持久化 + * @description 实现 Flow 的 CRUD 操作 + */ + +import type { FlowId } from '../domain/ids'; +import type { FlowV3 } from '../domain/flow'; +import { FLOW_SCHEMA_VERSION } from '../domain/flow'; +import { RR_ERROR_CODES, createRRError } from '../domain/errors'; +import type { FlowsStore } from '../engine/storage/storage-port'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** + * 校验 Flow 结构 + */ +function validateFlow(flow: FlowV3): void { + // 校验 schema 版本 + if (flow.schemaVersion !== FLOW_SCHEMA_VERSION) { + throw createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Invalid schema version: expected ${FLOW_SCHEMA_VERSION}, got ${flow.schemaVersion}`, + ); + } + + // 校验必填字段 + if (!flow.id) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Flow id is required'); + } + if (!flow.name) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Flow name is required'); + } + if (!flow.entryNodeId) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Flow entryNodeId is required'); + } + + // 校验 entryNodeId 存在 + const nodeIds = new Set(flow.nodes.map((n) => n.id)); + if (!nodeIds.has(flow.entryNodeId)) { + throw createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Entry node "${flow.entryNodeId}" does not exist in flow`, + ); + } + + // 校验边引用 + for (const edge of flow.edges) { + if (!nodeIds.has(edge.from)) { + throw createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Edge "${edge.id}" references non-existent source node "${edge.from}"`, + ); + } + if (!nodeIds.has(edge.to)) { + throw createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Edge "${edge.id}" references non-existent target node "${edge.to}"`, + ); + } + } +} + +/** + * 创建 FlowsStore 实现 + */ +export function createFlowsStore(): FlowsStore { + return { + async list(): Promise { + return withTransaction(RR_V3_STORES.FLOWS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.FLOWS]; + return new Promise((resolve, reject) => { + const request = store.getAll(); + request.onsuccess = () => resolve(request.result as FlowV3[]); + request.onerror = () => reject(request.error); + }); + }); + }, + + async get(id: FlowId): Promise { + return withTransaction(RR_V3_STORES.FLOWS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.FLOWS]; + return new Promise((resolve, reject) => { + const request = store.get(id); + request.onsuccess = () => resolve((request.result as FlowV3) ?? null); + request.onerror = () => reject(request.error); + }); + }); + }, + + async save(flow: FlowV3): Promise { + // 校验 + validateFlow(flow); + + return withTransaction(RR_V3_STORES.FLOWS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.FLOWS]; + return new Promise((resolve, reject) => { + const request = store.put(flow); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async delete(id: FlowId): Promise { + return withTransaction(RR_V3_STORES.FLOWS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.FLOWS]; + return new Promise((resolve, reject) => { + const request = store.delete(id); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/index.ts new file mode 100644 index 00000000..ca8a67cb --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/index.ts @@ -0,0 +1,6 @@ +/** + * @fileoverview Import 模块导出入口 + */ + +export * from './v2-reader'; +export * from './v2-to-v3'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-reader.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-reader.ts new file mode 100644 index 00000000..4e7897dd --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-reader.ts @@ -0,0 +1,35 @@ +/** + * @fileoverview V2 数据读取器 + * @description 读取 V2 格式的数据（占位实现） + */ + +/** + * V2 数据读取器接口 + * @description Phase 5+ 实现 + */ +export interface V2Reader { + /** 读取 V2 Flows */ + readFlows(): Promise; + /** 读取 V2 Runs */ + readRuns(): Promise; + /** 读取 V2 Triggers */ + readTriggers(): Promise; + /** 读取 V2 Schedules */ + readSchedules(): Promise; +} + +/** + * 创建 NotImplemented 的 V2Reader + */ +export function createNotImplementedV2Reader(): V2Reader { + const notImplemented = async () => { + throw new Error('V2Reader not implemented'); + }; + + return { + readFlows: notImplemented, + readRuns: notImplemented, + readTriggers: notImplemented, + readSchedules: notImplemented, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-to-v3.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-to-v3.ts new file mode 100644 index 00000000..bd1e671b --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/import/v2-to-v3.ts @@ -0,0 +1,671 @@ +/** + * @fileoverview V2 到 V3 数据转换器 + * @description 将 V2 格式数据转换为 V3 格式，支持双向转换 + */ + +import type { FlowV3, NodeV3, EdgeV3, FlowBinding } from '../../domain/flow'; +import type { TriggerSpec } from '../../domain/triggers'; +import type { VariableDefinition } from '../../domain/variables'; +import type { NodeId, FlowId, EdgeId } from '../../domain/ids'; +import type { ISODateTimeString } from '../../domain/json'; +import { FLOW_SCHEMA_VERSION } from '../../domain/flow'; + +// ==================== V2 Types (imported from record-replay) ==================== + +/** V2 Node type definition */ +interface V2Node { + id: string; + type: string; + name?: string; + disabled?: boolean; + config?: Record; + ui?: { x: number; y: number }; +} + +/** V2 Edge type definition */ +interface V2Edge { + id: string; + from: string; + to: string; + label?: string; +} + +/** V2 Variable definition */ +interface V2VariableDef { + key: string; + label?: string; + sensitive?: boolean; + default?: unknown; + type?: string; + rules?: { required?: boolean; pattern?: string; enum?: string[] }; +} + +/** V2 Flow binding */ +interface V2Binding { + type: 'domain' | 'path' | 'url'; + value: string; +} + +/** V2 Flow definition */ +interface V2Flow { + id: string; + name: string; + description?: string; + version: number; + meta?: { + createdAt?: string; + updatedAt?: string; + domain?: string; + tags?: string[]; + bindings?: V2Binding[]; + tool?: { category?: string; description?: string }; + exposedOutputs?: Array<{ nodeId: string; as: string }>; + }; + variables?: V2VariableDef[]; + nodes?: V2Node[]; + edges?: V2Edge[]; + subflows?: Record; +} + +// ==================== Conversion Result Types ==================== + +export interface ConversionResult { + success: boolean; + data?: T; + errors: string[]; + warnings: string[]; +} + +// ==================== V2 -> V3 Conversion ==================== + +/** + * 将 V2 Flow 转换为 V3 Flow + * @param v2Flow V2 格式的 Flow + * @returns 转换结果，包含成功/失败状态、数据和错误/警告信息 + */ +export function convertFlowV2ToV3(v2Flow: V2Flow): ConversionResult { + const errors: string[] = []; + const warnings: string[] = []; + + // 1. 基础字段验证 + if (!v2Flow.id) { + errors.push('V2 Flow missing required field: id'); + } + if (!v2Flow.name) { + errors.push('V2 Flow missing required field: name'); + } + if (!v2Flow.nodes || v2Flow.nodes.length === 0) { + errors.push('V2 Flow has no nodes'); + } + + // 2. 检查不支持的特性 + if (v2Flow.subflows && Object.keys(v2Flow.subflows).length > 0) { + errors.push( + 'V3 does not support subflows yet. Flow contains subflows: ' + + Object.keys(v2Flow.subflows).join(', '), + ); + } + + // 检查 foreach/while 节点 + const unsupportedNodes = (v2Flow.nodes || []).filter( + (n) => n.type === 'foreach' || n.type === 'while', + ); + if (unsupportedNodes.length > 0) { + errors.push( + 'V3 does not support foreach/while nodes yet. Found: ' + + unsupportedNodes.map((n) => `${n.id} (${n.type})`).join(', '), + ); + } + + // 如果有致命错误，直接返回 + if (errors.length > 0) { + return { success: false, errors, warnings }; + } + + // 3. 转换节点 + const nodes: NodeV3[] = []; + for (const v2Node of v2Flow.nodes || []) { + const node = convertNodeV2ToV3(v2Node); + if (node) { + nodes.push(node); + } else { + warnings.push(`Skipped invalid node: ${v2Node.id}`); + } + } + + // 4. 转换边 + const edges: EdgeV3[] = []; + for (const v2Edge of v2Flow.edges || []) { + const edge = convertEdgeV2ToV3(v2Edge); + if (edge) { + edges.push(edge); + } else { + warnings.push(`Skipped invalid edge: ${v2Edge.id}`); + } + } + + // 5. 计算 entryNodeId + const entryResult = findEntryNodeId(nodes, edges); + warnings.push(...entryResult.warnings); + if (!entryResult.nodeId) { + errors.push('Could not determine entry node. No valid root node found.'); + return { success: false, errors, warnings }; + } + const entryNodeId = entryResult.nodeId; + + // 6. 转换变量 + const variables = convertVariablesV2ToV3(v2Flow.variables || []); + + // 7. 转换元数据 + const meta = convertMetaV2ToV3(v2Flow.meta); + + // 8. 构建 V3 Flow + const now = new Date().toISOString() as ISODateTimeString; + const v3Flow: FlowV3 = { + schemaVersion: FLOW_SCHEMA_VERSION, + id: v2Flow.id as FlowId, + name: v2Flow.name, + createdAt: (v2Flow.meta?.createdAt as ISODateTimeString) || now, + updatedAt: (v2Flow.meta?.updatedAt as ISODateTimeString) || now, + entryNodeId, + nodes, + edges, + }; + + // 可选字段 + if (v2Flow.description) { + v3Flow.description = v2Flow.description; + } + if (variables.length > 0) { + v3Flow.variables = variables; + } + if (meta) { + v3Flow.meta = meta; + } + + return { success: true, data: v3Flow, errors, warnings }; +} + +/** + * 转换单个 V2 Node 为 V3 Node + */ +function convertNodeV2ToV3(v2Node: V2Node): NodeV3 | null { + if (!v2Node.id || !v2Node.type) { + return null; + } + + const node: NodeV3 = { + id: v2Node.id as NodeId, + kind: v2Node.type, // V2 type -> V3 kind + config: (v2Node.config as Record) || {}, + }; + + // 可选字段 + if (v2Node.name) { + node.name = v2Node.name; + } + if (v2Node.disabled) { + node.disabled = v2Node.disabled; + } + if (v2Node.ui) { + node.ui = v2Node.ui; + } + + return node; +} + +/** + * 转换单个 V2 Edge 为 V3 Edge + */ +function convertEdgeV2ToV3(v2Edge: V2Edge): EdgeV3 | null { + if (!v2Edge.id || !v2Edge.from || !v2Edge.to) { + return null; + } + + const edge: EdgeV3 = { + id: v2Edge.id as EdgeId, + from: v2Edge.from as NodeId, + to: v2Edge.to as NodeId, + }; + + // label 直接传递 + if (v2Edge.label) { + edge.label = v2Edge.label as EdgeV3['label']; + } + + return edge; +} + +/** entryNodeId 计算结果 */ +interface EntryNodeResult { + nodeId: NodeId | null; + warnings: string[]; +} + +/** + * 找到入口节点 ID + * + * 规则： + * 1. 排除 trigger 类型节点（这些是 UI 节点，不参与执行） + * 2. 只统计「可执行节点 -> 可执行节点」的边来计算入度（忽略 trigger 指出的边） + * 3. 找到入度为 0 的节点作为候选 + * 4. 如果有多个候选，使用稳定选择规则： + * - 优先选择 UI 坐标最靠左上的节点（按 x 升序，x 相同按 y 升序） + * - 如果无 UI 坐标，按 ID 字典序取第一个 + */ +function findEntryNodeId(nodes: NodeV3[], edges: EdgeV3[]): EntryNodeResult { + const warnings: string[] = []; + + // 1. 排除 trigger 节点，获取可执行节点 + const executableNodes = nodes.filter((n) => n.kind !== 'trigger'); + if (executableNodes.length === 0) { + warnings.push('No executable nodes found; cannot determine entry node'); + return { nodeId: null, warnings }; + } + + const executableNodeIds = new Set(executableNodes.map((n) => n.id)); + + // 2. 计算入度（只统计可执行节点之间的边） + const inDegree = new Map(); + for (const node of executableNodes) { + inDegree.set(node.id, 0); + } + for (const edge of edges) { + // 忽略从非可执行节点（如 trigger）指出的边 + if (!executableNodeIds.has(edge.from)) { + continue; + } + // 忽略指向非可执行节点的边 + if (!executableNodeIds.has(edge.to)) { + continue; + } + inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1); + } + + // 3. 找入度为 0 的节点 + const rootNodes = executableNodes.filter((n) => inDegree.get(n.id) === 0); + + if (rootNodes.length === 0) { + // 没有入度为 0 的节点，说明图中存在环，使用稳定选择器选择 fallback + const fallbackResult = selectStableRootNode(executableNodes); + warnings.push( + `No inDegree=0 executable node found (graph may contain cycles); ` + + `falling back to "${fallbackResult.node.id}" by ${fallbackResult.rule}`, + ); + return { nodeId: fallbackResult.node.id, warnings }; + } + + // 4. 单个根节点，直接返回 + if (rootNodes.length === 1) { + return { nodeId: rootNodes[0].id, warnings }; + } + + // 5. 多个根节点，使用稳定选择规则 + const selectedResult = selectStableRootNode(rootNodes); + const candidateIds = rootNodes + .map((n) => n.id) + .sort((a, b) => a.localeCompare(b)) + .join(', '); + warnings.push( + `Multiple inDegree=0 executable nodes (${candidateIds}); ` + + `selected "${selectedResult.node.id}" by ${selectedResult.rule}`, + ); + + return { nodeId: selectedResult.node.id, warnings }; +} + +/** 稳定选择结果 */ +interface StableSelectionResult { + node: NodeV3; + rule: string; +} + +/** + * 从多个根节点中选择一个稳定的入口节点 + * 优先按 UI 坐标（左上角优先），其次按 ID 字典序 + */ +function selectStableRootNode(nodes: NodeV3[]): StableSelectionResult { + // 检查节点是否有有效的 UI 坐标 + const hasValidUi = (n: NodeV3): n is NodeV3 & { ui: { x: number; y: number } } => + !!n.ui && Number.isFinite(n.ui.x) && Number.isFinite(n.ui.y); + + const nodesWithUi = nodes.filter(hasValidUi); + + if (nodesWithUi.length > 0) { + // 按 UI 坐标排序：x 升序 -> y 升序 -> id 字典序（作为 tie-breaker） + nodesWithUi.sort((a, b) => { + if (a.ui.x !== b.ui.x) return a.ui.x - b.ui.x; + if (a.ui.y !== b.ui.y) return a.ui.y - b.ui.y; + return a.id.localeCompare(b.id); + }); + const selected = nodesWithUi[0]; + return { + node: selected, + rule: `ui(x=${selected.ui.x}, y=${selected.ui.y})`, + }; + } + + // 无 UI 坐标，按 ID 字典序 + const sortedById = [...nodes].sort((a, b) => a.id.localeCompare(b.id)); + return { node: sortedById[0], rule: 'id' }; +} + +/** + * 转换变量定义 + */ +function convertVariablesV2ToV3(v2Variables: V2VariableDef[]): VariableDefinition[] { + return v2Variables + .filter((v) => v.key) + .map((v) => { + const variable: VariableDefinition = { + name: v.key, + }; + + if (v.label) { + variable.label = v.label; + } + if (v.sensitive) { + variable.sensitive = v.sensitive; + } + if (v.default !== undefined) { + variable.default = v.default; + } + if (v.rules?.required) { + variable.required = v.rules.required; + } + + return variable; + }); +} + +/** + * 转换元数据 + */ +function convertMetaV2ToV3(v2Meta: V2Flow['meta']): FlowV3['meta'] | undefined { + if (!v2Meta) return undefined; + + const meta: FlowV3['meta'] = {}; + + if (v2Meta.tags && v2Meta.tags.length > 0) { + meta.tags = v2Meta.tags; + } + + if (v2Meta.bindings && v2Meta.bindings.length > 0) { + meta.bindings = v2Meta.bindings.map((b) => ({ + kind: b.type, // V2 type -> V3 kind + value: b.value, + })); + } + + // 如果 meta 为空对象，返回 undefined + if (Object.keys(meta).length === 0) { + return undefined; + } + + return meta; +} + +// ==================== V3 -> V2 Conversion ==================== + +/** + * 将 V3 Flow 转换为 V2 Flow（用于在 V2 Builder 中编辑） + * @param v3Flow V3 格式的 Flow + * @returns 转换结果 + */ +export function convertFlowV3ToV2(v3Flow: FlowV3): ConversionResult { + const errors: string[] = []; + const warnings: string[] = []; + + // 1. 转换节点 + const nodes: V2Node[] = v3Flow.nodes.map((n) => ({ + id: n.id, + type: n.kind, // V3 kind -> V2 type + name: n.name, + disabled: n.disabled, + config: n.config as Record, + ui: n.ui, + })); + + // 2. 转换边 + const edges: V2Edge[] = v3Flow.edges.map((e) => ({ + id: e.id, + from: e.from, + to: e.to, + label: e.label, + })); + + // 3. 转换变量 + const variables: V2VariableDef[] = (v3Flow.variables || []).map((v) => ({ + key: v.name, + label: v.label, + sensitive: v.sensitive, + default: v.default, + rules: v.required ? { required: v.required } : undefined, + })); + + // 4. 转换元数据 + const meta: V2Flow['meta'] = { + createdAt: v3Flow.createdAt, + updatedAt: v3Flow.updatedAt, + }; + + if (v3Flow.meta?.tags) { + meta.tags = v3Flow.meta.tags; + } + + if (v3Flow.meta?.bindings) { + meta.bindings = v3Flow.meta.bindings.map((b) => ({ + type: b.kind, // V3 kind -> V2 type + value: b.value, + })); + } + + // 5. 构建 V2 Flow + const v2Flow: V2Flow = { + id: v3Flow.id, + name: v3Flow.name, + description: v3Flow.description, + version: 2, // V2 版本 + meta, + variables: variables.length > 0 ? variables : undefined, + nodes, + edges, + }; + + return { success: true, data: v2Flow, errors, warnings }; +} + +// ==================== Trigger Conversion ==================== + +/** V2 Trigger 定义 */ +interface V2Trigger { + id: string; + type: 'url' | 'command' | 'manual' | 'schedule' | 'element'; + flowId: string; + enabled?: boolean; + match?: Array<{ kind: string; value: string }>; + title?: string; + commandKey?: string; + selector?: string; + appear?: boolean; + once?: boolean; + debounceMs?: number; + schedule?: { + type: 'interval' | 'daily' | 'weekly'; + intervalMs?: number; + time?: string; + days?: number[]; + }; +} + +/** + * 将 V2 Trigger 转换为 V3 TriggerSpec + * @param v2Trigger V2 格式的 Trigger + * @returns 转换结果 + */ +export function convertTriggerV2ToV3(v2Trigger: V2Trigger): ConversionResult { + const errors: string[] = []; + const warnings: string[] = []; + + if (!v2Trigger.id) { + errors.push('V2 Trigger missing required field: id'); + } + if (!v2Trigger.flowId) { + errors.push('V2 Trigger missing required field: flowId'); + } + if (!v2Trigger.type) { + errors.push('V2 Trigger missing required field: type'); + } + + if (errors.length > 0) { + return { success: false, errors, warnings }; + } + + // 根据 type 构建不同的 TriggerSpec + let trigger: TriggerSpec; + + switch (v2Trigger.type) { + case 'manual': + trigger = { + id: v2Trigger.id, + kind: 'manual', + flowId: v2Trigger.flowId as FlowId, + enabled: v2Trigger.enabled ?? true, + }; + break; + + case 'command': + trigger = { + id: v2Trigger.id, + kind: 'command', + flowId: v2Trigger.flowId as FlowId, + enabled: v2Trigger.enabled ?? true, + command: v2Trigger.commandKey || 'run_workflow', + }; + break; + + case 'url': + trigger = { + id: v2Trigger.id, + kind: 'url', + flowId: v2Trigger.flowId as FlowId, + enabled: v2Trigger.enabled ?? true, + patterns: (v2Trigger.match || []).map((m) => m.value), + }; + break; + + case 'schedule': { // 将 V2 schedule 转换为 cron 表达式 + const cron = convertScheduleToCron(v2Trigger.schedule); + if (!cron) { + errors.push('Could not convert V2 schedule to cron expression'); + return { success: false, errors, warnings }; + } + trigger = { + id: v2Trigger.id, + kind: 'cron', + flowId: v2Trigger.flowId as FlowId, + enabled: v2Trigger.enabled ?? true, + cron, + }; + break; + } + + case 'element': + warnings.push('Element trigger is not fully supported in V3, converting to manual'); + trigger = { + id: v2Trigger.id, + kind: 'manual', + flowId: v2Trigger.flowId as FlowId, + enabled: v2Trigger.enabled ?? true, + }; + break; + + default: + errors.push(`Unknown V2 trigger type: ${v2Trigger.type}`); + return { success: false, errors, warnings }; + } + + return { success: true, data: trigger, errors, warnings }; +} + +/** + * 将 V2 schedule 配置转换为 cron 表达式 + */ +function convertScheduleToCron(schedule: V2Trigger['schedule']): string | null { + if (!schedule) return null; + + switch (schedule.type) { + case 'interval': { // 将间隔转换为近似 cron（每 N 分钟） + const intervalMinutes = Math.max(1, Math.round((schedule.intervalMs || 60000) / 60000)); + if (intervalMinutes < 60) { + return `*/${intervalMinutes} * * * *`; + } else { + const hours = Math.round(intervalMinutes / 60); + return `0 */${hours} * * *`; + } + } + + case 'daily': + // 每天指定时间 + if (schedule.time) { + const [hour, minute] = schedule.time.split(':').map(Number); + return `${minute || 0} ${hour || 0} * * *`; + } + return '0 0 * * *'; // 默认每天 0:00 + + case 'weekly': { // 每周指定天数和时间 + const days = (schedule.days || [0]).join(','); + if (schedule.time) { + const [hour, minute] = schedule.time.split(':').map(Number); + return `${minute || 0} ${hour || 0} * * ${days}`; + } + return `0 0 * * ${days}`; + } + + default: + return null; + } +} + +// ==================== Converter Interface ==================== + +/** + * V2 到 V3 转换器接口 + */ +export interface V2ToV3Converter { + /** 转换 Flow */ + convertFlow(v2Flow: unknown): FlowV3; + /** 转换 Trigger */ + convertTrigger(v2Trigger: unknown): TriggerSpec; +} + +/** + * 创建 V2ToV3Converter 实例 + */ +export function createV2ToV3Converter(): V2ToV3Converter { + return { + convertFlow(v2Flow: unknown): FlowV3 { + const result = convertFlowV2ToV3(v2Flow as V2Flow); + if (!result.success || !result.data) { + throw new Error(`Flow conversion failed: ${result.errors.join('; ')}`); + } + return result.data; + }, + + convertTrigger(v2Trigger: unknown): TriggerSpec { + const result = convertTriggerV2ToV3(v2Trigger as V2Trigger); + if (!result.success || !result.data) { + throw new Error(`Trigger conversion failed: ${result.errors.join('; ')}`); + } + return result.data; + }, + }; +} + +/** + * 创建 NotImplemented 的 V2ToV3Converter（向后兼容） + * @deprecated 使用 createV2ToV3Converter() 替代 + */ +export function createNotImplementedV2ToV3Converter(): V2ToV3Converter { + return createV2ToV3Converter(); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/index.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/index.ts new file mode 100644 index 00000000..c7fd8c17 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/index.ts @@ -0,0 +1,12 @@ +/** + * @fileoverview Storage 层导出入口 + */ + +export * from './db'; +export * from './flows'; +export * from './runs'; +export * from './events'; +export * from './queue'; +export * from './persistent-vars'; +export * from './triggers'; +export * from './import'; diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/persistent-vars.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/persistent-vars.ts new file mode 100644 index 00000000..4e87b168 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/persistent-vars.ts @@ -0,0 +1,88 @@ +/** + * @fileoverview 持久化变量存储 + * @description 实现 $ 前缀变量的持久化，使用 LWW（Last-Write-Wins）策略 + */ + +import type { PersistentVarRecord, PersistentVariableName } from '../domain/variables'; +import type { JsonValue } from '../domain/json'; +import type { PersistentVarsStore } from '../engine/storage/storage-port'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** + * 创建 PersistentVarsStore 实现 + */ +export function createPersistentVarsStore(): PersistentVarsStore { + return { + async get(key: PersistentVariableName): Promise { + return withTransaction(RR_V3_STORES.PERSISTENT_VARS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.PERSISTENT_VARS]; + return new Promise((resolve, reject) => { + const request = store.get(key); + request.onsuccess = () => resolve(request.result as PersistentVarRecord | undefined); + request.onerror = () => reject(request.error); + }); + }); + }, + + async set(key: PersistentVariableName, value: JsonValue): Promise { + return withTransaction(RR_V3_STORES.PERSISTENT_VARS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.PERSISTENT_VARS]; + + // 先读取现有记录（用于 version 递增） + const existing = await new Promise((resolve, reject) => { + const request = store.get(key); + request.onsuccess = () => resolve(request.result as PersistentVarRecord | undefined); + request.onerror = () => reject(request.error); + }); + + const now = Date.now(); + const record: PersistentVarRecord = { + key, + value, + updatedAt: now, + version: (existing?.version ?? 0) + 1, + }; + + await new Promise((resolve, reject) => { + const request = store.put(record); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + + return record; + }); + }, + + async delete(key: PersistentVariableName): Promise { + return withTransaction(RR_V3_STORES.PERSISTENT_VARS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.PERSISTENT_VARS]; + return new Promise((resolve, reject) => { + const request = store.delete(key); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async list(prefix?: PersistentVariableName): Promise { + return withTransaction(RR_V3_STORES.PERSISTENT_VARS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.PERSISTENT_VARS]; + + return new Promise((resolve, reject) => { + const request = store.getAll(); + request.onsuccess = () => { + let results = request.result as PersistentVarRecord[]; + + // 如果指定了前缀，过滤结果 + if (prefix) { + results = results.filter((r) => r.key.startsWith(prefix)); + } + + resolve(results); + }; + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/queue.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/queue.ts new file mode 100644 index 00000000..5b51cc91 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/queue.ts @@ -0,0 +1,526 @@ +/** + * @fileoverview RunQueue 持久化 + * @description 实现队列的 CRUD 操作和原子 claim + */ + +import type { RunId } from '../domain/ids'; +import { + DEFAULT_QUEUE_CONFIG, + type EnqueueInput, + type QueueItemStatus, + type RunQueue, + type RunQueueItem, +} from '../engine/queue/queue'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** Default lease TTL in milliseconds (from shared config to avoid drift) */ +const DEFAULT_LEASE_TTL_MS = DEFAULT_QUEUE_CONFIG.leaseTtlMs; + +/** + * IDB key range bounds for numeric fields. + * Use MAX_VALUE to cover the full range of finite numbers (not just safe integers). + */ +const IDB_NUMBER_MIN = -Number.MAX_VALUE; +const IDB_NUMBER_MAX = Number.MAX_VALUE; + +/** + * 创建 RunQueue 持久化实现 + * @description 实现队列持久化，包括 Phase 3 原子 claim + */ +export function createQueueStore(): RunQueue { + return { + async enqueue(input: EnqueueInput): Promise { + const now = Date.now(); + const item: RunQueueItem = { + ...input, + priority: input.priority ?? 0, + maxAttempts: input.maxAttempts ?? 1, + status: 'queued', + createdAt: now, + updatedAt: now, + attempt: 0, + }; + + await withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + return new Promise((resolve, reject) => { + const request = store.add(item); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + + return item; + }, + + async claimNext(ownerId: string, now: number): Promise { + // Validate inputs + if (!ownerId) { + throw new Error('ownerId is required'); + } + if (!Number.isFinite(now)) { + throw new Error(`Invalid now: ${String(now)}`); + } + + return withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + const index = store.index('status_priority_createdAt'); + + /** + * Atomic claim implementation using two-step cursor approach: + * + * Desired ordering: priority DESC, createdAt ASC (FIFO within same priority) + * + * IndexedDB compound indexes only support single sort direction for the entire tuple. + * The index ['status', 'priority', 'createdAt'] is stored ASC. + * + * Strategy: + * 1. Use 'prev' cursor to find the highest priority (overall DESC) + * 2. Use 'next' cursor within that priority to find earliest createdAt (FIFO) + * + * Both operations are within the same readwrite transaction, ensuring atomicity + * since IndexedDB serializes readwrite transactions on the same store. + */ + + // Step 1: Find the highest priority among queued items + const queuedRange = IDBKeyRange.bound( + ['queued', IDB_NUMBER_MIN, IDB_NUMBER_MIN], + ['queued', IDB_NUMBER_MAX, IDB_NUMBER_MAX], + ); + + const highestPriority = await new Promise((resolve, reject) => { + const request = index.openCursor(queuedRange, 'prev'); + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + resolve(null); + return; + } + const item = cursor.value as RunQueueItem; + resolve(item.priority); + }; + }); + + // No queued items available + if (highestPriority === null) { + return null; + } + + // Step 2: Find the earliest createdAt within the highest priority (FIFO) + const fifoRange = IDBKeyRange.bound( + ['queued', highestPriority, IDB_NUMBER_MIN], + ['queued', highestPriority, IDB_NUMBER_MAX], + ); + + return new Promise((resolve, reject) => { + const request = index.openCursor(fifoRange, 'next'); + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + // No items found (should not happen given step 1 succeeded) + resolve(null); + return; + } + + const existing = cursor.value as RunQueueItem; + + // Defensive check: ensure status is still queued + if (existing.status !== 'queued') { + resolve(null); + return; + } + + // Atomically update to running with lease + const updated: RunQueueItem = { + ...existing, + status: 'running', + updatedAt: now, + attempt: existing.attempt + 1, + lease: { + ownerId, + expiresAt: now + DEFAULT_LEASE_TTL_MS, + }, + }; + + const updateRequest = cursor.update(updated); + updateRequest.onerror = () => reject(updateRequest.error); + updateRequest.onsuccess = () => resolve(updated); + }; + }); + }); + }, + + async heartbeat(ownerId: string, now: number): Promise { + // Validate inputs + if (!ownerId) { + throw new Error('ownerId is required'); + } + if (!Number.isFinite(now)) { + throw new Error(`Invalid now: ${String(now)}`); + } + + await withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + const statusIndex = store.index('status'); + + /** + * Renew leases for all items owned by ownerId in the given status. + * Uses cursor iteration to update each item atomically. + */ + const renewForStatus = async (status: QueueItemStatus): Promise => { + await new Promise((resolve, reject) => { + const request = statusIndex.openCursor(IDBKeyRange.only(status)); + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + resolve(); + return; + } + + const item = cursor.value as RunQueueItem; + const lease = item.lease; + + // Skip items not owned by this ownerId + if (!lease || lease.ownerId !== ownerId) { + cursor.continue(); + return; + } + + // Renew the lease + const updated: RunQueueItem = { + ...item, + updatedAt: now, + lease: { + ...lease, + expiresAt: now + DEFAULT_LEASE_TTL_MS, + }, + }; + + const updateRequest = cursor.update(updated); + updateRequest.onerror = () => reject(updateRequest.error); + updateRequest.onsuccess = () => cursor.continue(); + }; + }); + }; + + // Renew both running and paused items for the owner. + // Paused items also need renewal to prevent TTL expiration during debug/manual pause. + await renewForStatus('running'); + await renewForStatus('paused'); + }); + }, + + async reclaimExpiredLeases(now: number): Promise { + if (!Number.isFinite(now)) { + throw new Error(`Invalid now: ${String(now)}`); + } + + return withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + const leaseIndex = store.index('lease_expiresAt'); + + // Scan all items where lease.expiresAt < now (strictly less than) + const expiredRange = IDBKeyRange.upperBound(now, true); + + return new Promise((resolve, reject) => { + const reclaimed: RunId[] = []; + const request = leaseIndex.openCursor(expiredRange); + + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + resolve(reclaimed); + return; + } + + const item = cursor.value as RunQueueItem; + const expiresAtKey = cursor.key; + + // Defensive: index key should be a finite number (Unix millis) + if (typeof expiresAtKey !== 'number' || !Number.isFinite(expiresAtKey)) { + cursor.continue(); + return; + } + + // The key range already guarantees expiresAtKey < now, but keep a guard + // to be resilient to non-standard IndexedDB implementations. + if (expiresAtKey >= now) { + cursor.continue(); + return; + } + + const isReclaimable = item.status === 'running' || item.status === 'paused'; + + // Reclaim policy: + // - running/paused + expired lease => move back to queued, drop lease + // - any other status + expired lease => drop lease defensively (shouldn't happen) + // Note: attempt is NOT reset on reclaim - preserves retry history. + const { lease: _droppedLease, ...itemWithoutLease } = item; + const updated: RunQueueItem = isReclaimable + ? { ...itemWithoutLease, status: 'queued', updatedAt: now } + : { ...itemWithoutLease, updatedAt: now }; + + const updateRequest = cursor.update(updated); + updateRequest.onerror = () => reject(updateRequest.error); + updateRequest.onsuccess = () => { + if (isReclaimable) { + reclaimed.push(item.id); + } + cursor.continue(); + }; + }; + }); + }); + }, + + async recoverOrphanLeases( + ownerId: string, + now: number, + ): Promise<{ + requeuedRunning: Array<{ runId: RunId; prevOwnerId?: string }>; + adoptedPaused: Array<{ runId: RunId; prevOwnerId?: string }>; + }> { + // Validate inputs + if (!ownerId) { + throw new Error('ownerId is required'); + } + if (!Number.isFinite(now)) { + throw new Error(`Invalid now: ${String(now)}`); + } + + return withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + const statusIndex = store.index('status'); + + const requeuedRunning: Array<{ runId: RunId; prevOwnerId?: string }> = []; + const adoptedPaused: Array<{ runId: RunId; prevOwnerId?: string }> = []; + + /** + * 扫描并回收孤儿 running 项 + * @description + * - 孤儿定义：无租约或 lease.ownerId !== currentOwnerId + * - 回收策略：status -> queued，清除 lease，保留 attempt + */ + const recoverRunningItems = (): Promise => + new Promise((resolve, reject) => { + const request = statusIndex.openCursor(IDBKeyRange.only('running')); + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + resolve(); + return; + } + + const item = cursor.value as RunQueueItem; + const prevOwnerId = item.lease?.ownerId; + + // 非孤儿：lease 存在且属于当前 ownerId + const isOrphan = !item.lease || item.lease.ownerId !== ownerId; + if (!isOrphan) { + cursor.continue(); + return; + } + + // 回收：移除 lease，状态改为 queued + const { lease: _droppedLease, ...itemWithoutLease } = item; + const updated: RunQueueItem = { + ...itemWithoutLease, + status: 'queued', + updatedAt: now, + }; + + const updateRequest = cursor.update(updated); + updateRequest.onerror = () => reject(updateRequest.error); + updateRequest.onsuccess = () => { + requeuedRunning.push({ + runId: item.id, + ...(prevOwnerId ? { prevOwnerId } : {}), + }); + cursor.continue(); + }; + }; + }); + + /** + * 扫描并接管孤儿 paused 项 + * @description + * - 孤儿定义：无租约或 lease.ownerId !== currentOwnerId + * - 接管策略：保持 status=paused，更新 lease.ownerId 为新 ownerId，续约 TTL + */ + const recoverPausedItems = (): Promise => + new Promise((resolve, reject) => { + const request = statusIndex.openCursor(IDBKeyRange.only('paused')); + request.onerror = () => reject(request.error); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor) { + resolve(); + return; + } + + const item = cursor.value as RunQueueItem; + const prevOwnerId = item.lease?.ownerId; + + // 非孤儿：lease 存在且属于当前 ownerId + const isOrphan = !item.lease || item.lease.ownerId !== ownerId; + if (!isOrphan) { + cursor.continue(); + return; + } + + // 接管：更新 lease 为新 ownerId，续约 TTL + const updated: RunQueueItem = { + ...item, + updatedAt: now, + lease: { + ownerId, + expiresAt: now + DEFAULT_LEASE_TTL_MS, + }, + }; + + const updateRequest = cursor.update(updated); + updateRequest.onerror = () => reject(updateRequest.error); + updateRequest.onsuccess = () => { + adoptedPaused.push({ + runId: item.id, + ...(prevOwnerId ? { prevOwnerId } : {}), + }); + cursor.continue(); + }; + }; + }); + + // 顺序执行：先处理 running，再处理 paused + await recoverRunningItems(); + await recoverPausedItems(); + + return { requeuedRunning, adoptedPaused }; + }); + }, + + async markRunning(runId: RunId, ownerId: string, now: number): Promise { + await withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + + const existing = await new Promise((resolve, reject) => { + const request = store.get(runId); + request.onsuccess = () => resolve((request.result as RunQueueItem) ?? null); + request.onerror = () => reject(request.error); + }); + + if (!existing) { + throw new Error(`Queue item "${runId}" not found`); + } + + // Attempt semantics: + // - queued -> running: attempt + 1 (a new scheduling attempt) + // - paused/running -> running: attempt unchanged (resume/idempotent) + const nextAttempt = existing.status === 'queued' ? existing.attempt + 1 : existing.attempt; + + const updated: RunQueueItem = { + ...existing, + status: 'running', + updatedAt: now, + attempt: nextAttempt, + lease: { + ownerId, + expiresAt: now + DEFAULT_LEASE_TTL_MS, + }, + }; + + return new Promise((resolve, reject) => { + const request = store.put(updated); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async markPaused(runId: RunId, ownerId: string, now: number): Promise { + await withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + + const existing = await new Promise((resolve, reject) => { + const request = store.get(runId); + request.onsuccess = () => resolve((request.result as RunQueueItem) ?? null); + request.onerror = () => reject(request.error); + }); + + if (!existing) { + throw new Error(`Queue item "${runId}" not found`); + } + + const updated: RunQueueItem = { + ...existing, + status: 'paused', + updatedAt: now, + lease: { + ownerId, + expiresAt: now + DEFAULT_LEASE_TTL_MS, + }, + }; + + return new Promise((resolve, reject) => { + const request = store.put(updated); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async markDone(runId: RunId, now: number): Promise { + await withTransaction(RR_V3_STORES.QUEUE, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + return new Promise((resolve, reject) => { + const request = store.delete(runId); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async cancel(runId: RunId, _now: number, _reason?: string): Promise { + // 从队列中删除 + await this.markDone(runId, _now); + }, + + async get(runId: RunId): Promise { + return withTransaction(RR_V3_STORES.QUEUE, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + return new Promise((resolve, reject) => { + const request = store.get(runId); + request.onsuccess = () => resolve((request.result as RunQueueItem) ?? null); + request.onerror = () => reject(request.error); + }); + }); + }, + + async list(status?: QueueItemStatus): Promise { + return withTransaction(RR_V3_STORES.QUEUE, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.QUEUE]; + + if (status) { + // 使用索引查询 + const index = store.index('status'); + return new Promise((resolve, reject) => { + const request = index.getAll(IDBKeyRange.only(status)); + request.onsuccess = () => resolve(request.result as RunQueueItem[]); + request.onerror = () => reject(request.error); + }); + } + + // 获取所有 + return new Promise((resolve, reject) => { + const request = store.getAll(); + request.onsuccess = () => resolve(request.result as RunQueueItem[]); + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/runs.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/runs.ts new file mode 100644 index 00000000..39753bf7 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/runs.ts @@ -0,0 +1,110 @@ +/** + * @fileoverview RunRecordV3 持久化 + * @description 实现 Run 记录的 CRUD 操作 + */ + +import type { RunId } from '../domain/ids'; +import type { RunRecordV3 } from '../domain/events'; +import { RUN_SCHEMA_VERSION } from '../domain/events'; +import { RR_ERROR_CODES, createRRError } from '../domain/errors'; +import type { RunsStore } from '../engine/storage/storage-port'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** + * 校验 Run 记录结构 + */ +function validateRunRecord(record: RunRecordV3): void { + // 校验 schema 版本 + if (record.schemaVersion !== RUN_SCHEMA_VERSION) { + throw createRRError( + RR_ERROR_CODES.VALIDATION_ERROR, + `Invalid schema version: expected ${RUN_SCHEMA_VERSION}, got ${record.schemaVersion}`, + ); + } + + // 校验必填字段 + if (!record.id) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Run id is required'); + } + if (!record.flowId) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Run flowId is required'); + } + if (!record.status) { + throw createRRError(RR_ERROR_CODES.VALIDATION_ERROR, 'Run status is required'); + } +} + +/** + * 创建 RunsStore 实现 + */ +export function createRunsStore(): RunsStore { + return { + async list(): Promise { + return withTransaction(RR_V3_STORES.RUNS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.RUNS]; + return new Promise((resolve, reject) => { + const request = store.getAll(); + request.onsuccess = () => resolve(request.result as RunRecordV3[]); + request.onerror = () => reject(request.error); + }); + }); + }, + + async get(id: RunId): Promise { + return withTransaction(RR_V3_STORES.RUNS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.RUNS]; + return new Promise((resolve, reject) => { + const request = store.get(id); + request.onsuccess = () => resolve((request.result as RunRecordV3) ?? null); + request.onerror = () => reject(request.error); + }); + }); + }, + + async save(record: RunRecordV3): Promise { + // 校验 + validateRunRecord(record); + + return withTransaction(RR_V3_STORES.RUNS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.RUNS]; + return new Promise((resolve, reject) => { + const request = store.put(record); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async patch(id: RunId, patch: Partial): Promise { + return withTransaction(RR_V3_STORES.RUNS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.RUNS]; + + // 先读取现有记录 + const existing = await new Promise((resolve, reject) => { + const request = store.get(id); + request.onsuccess = () => resolve((request.result as RunRecordV3) ?? null); + request.onerror = () => reject(request.error); + }); + + if (!existing) { + throw createRRError(RR_ERROR_CODES.INTERNAL, `Run "${id}" not found`); + } + + // 合并并更新 + const updated: RunRecordV3 = { + ...existing, + ...patch, + id: existing.id, // 确保 id 不变 + schemaVersion: existing.schemaVersion, // 确保版本不变 + updatedAt: Date.now(), + }; + + return new Promise((resolve, reject) => { + const request = store.put(updated); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay-v3/storage/triggers.ts b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/triggers.ts new file mode 100644 index 00000000..a9152b76 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay-v3/storage/triggers.ts @@ -0,0 +1,60 @@ +/** + * @fileoverview 触发器存储 + * @description 实现触发器的 CRUD 操作（Phase 4 完整实现） + */ + +import type { TriggerId } from '../domain/ids'; +import type { TriggerSpec } from '../domain/triggers'; +import type { TriggersStore } from '../engine/storage/storage-port'; +import { RR_V3_STORES, withTransaction } from './db'; + +/** + * 创建 TriggersStore 实现 + */ +export function createTriggersStore(): TriggersStore { + return { + async list(): Promise { + return withTransaction(RR_V3_STORES.TRIGGERS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.TRIGGERS]; + return new Promise((resolve, reject) => { + const request = store.getAll(); + request.onsuccess = () => resolve(request.result as TriggerSpec[]); + request.onerror = () => reject(request.error); + }); + }); + }, + + async get(id: TriggerId): Promise { + return withTransaction(RR_V3_STORES.TRIGGERS, 'readonly', async (stores) => { + const store = stores[RR_V3_STORES.TRIGGERS]; + return new Promise((resolve, reject) => { + const request = store.get(id); + request.onsuccess = () => resolve((request.result as TriggerSpec) ?? null); + request.onerror = () => reject(request.error); + }); + }); + }, + + async save(spec: TriggerSpec): Promise { + return withTransaction(RR_V3_STORES.TRIGGERS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.TRIGGERS]; + return new Promise((resolve, reject) => { + const request = store.put(spec); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + + async delete(id: TriggerId): Promise { + return withTransaction(RR_V3_STORES.TRIGGERS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.TRIGGERS]; + return new Promise((resolve, reject) => { + const request = store.delete(id); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/adapter.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/adapter.ts new file mode 100644 index 00000000..e35a7180 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/adapter.ts @@ -0,0 +1,513 @@ +/** + * Adapter Layer: Step ↔ Action + * + * Provides conversion utilities between the legacy Step system and the new Action system. + * This adapter enables gradual migration while maintaining backward compatibility. + * + * Architecture: + * - `stepToAction`: Converts a Step to an ExecutableAction + * - `execCtxToActionCtx`: Converts ExecCtx to ActionExecutionContext + * - `actionResultToExecResult`: Converts ActionExecutionResult to ExecResult + * - `createStepExecutor`: Factory for a Step executor backed by ActionRegistry + */ + +import type { ExecCtx, ExecResult } from '../nodes/types'; +import type { Step } from '../types'; +import type { ActionRegistry } from './registry'; +import type { + ActionExecutionContext, + ActionExecutionResult, + ActionPolicy, + ExecutableAction, + ExecutableActionType, + ExecutionFlags, + VariableStore, +} from './types'; + +// ================================ +// Type Mapping +// ================================ + +/** + * Map legacy step types to new action types + * Most types map 1:1, but some require special handling + */ +const STEP_TYPE_TO_ACTION_TYPE: Record = { + // Interaction + click: 'click', + dblclick: 'dblclick', + fill: 'fill', + key: 'key', + scroll: 'scroll', + drag: 'drag', + + // Timing + wait: 'wait', + delay: 'delay', + + // Validation + assert: 'assert', + + // Data + extract: 'extract', + script: 'script', + http: 'http', + screenshot: 'screenshot', + + // Navigation / Tabs + navigate: 'navigate', + openTab: 'openTab', + switchTab: 'switchTab', + closeTab: 'closeTab', + handleDownload: 'handleDownload', + + // Control Flow + if: 'if', + foreach: 'foreach', + while: 'while', + switchFrame: 'switchFrame', + + // TODO: Add when handlers are implemented + // triggerEvent: 'triggerEvent', + // setAttribute: 'setAttribute', + // loopElements: 'loopElements', + // executeFlow: 'executeFlow', +}; + +// ================================ +// Context Conversion +// ================================ + +/** + * Convert legacy ExecCtx to ActionExecutionContext + */ +export function execCtxToActionCtx( + ctx: ExecCtx, + tabId: number, + options?: { + stepId?: string; + runId?: string; + pushLog?: (entry: unknown) => void; + /** Execution flags to pass to action handlers */ + execution?: ExecutionFlags; + }, +): ActionExecutionContext { + // Use provided stepId for proper log attribution, fallback to 'action' only if not provided + const logStepId = options?.stepId || 'action'; + return { + vars: ctx.vars as VariableStore, + tabId, + frameId: ctx.frameId, + runId: options?.runId, + log: (message: string, level?: 'info' | 'warn' | 'error') => { + ctx.logger({ + stepId: logStepId, + status: level === 'error' ? 'failed' : level === 'warn' ? 'warning' : 'success', + message, + }); + }, + pushLog: options?.pushLog, + execution: options?.execution, + }; +} + +// ================================ +// Step → Action Conversion +// ================================ + +/** + * Convert a legacy Step to an ExecutableAction + * + * The conversion maps step properties to action params and policy. + * Unknown step types are passed through as-is for forward compatibility. + */ +export function stepToAction(step: Step): ExecutableAction | null { + const actionType = STEP_TYPE_TO_ACTION_TYPE[step.type]; + + if (!actionType) { + // Unsupported step type + return null; + } + + // Build policy if step has timeout or retry config + let policy: ActionPolicy | undefined; + if (step.timeoutMs || step.retry) { + policy = {}; + + if (step.timeoutMs) { + policy.timeout = { ms: step.timeoutMs }; + } + + if (step.retry) { + policy.retry = { + retries: step.retry.count ?? 0, + intervalMs: step.retry.intervalMs ?? 0, + // Step backoff only supports 'none' | 'exp', map to Action backoff type + backoff: step.retry.backoff === 'exp' ? 'exp' : 'none', + }; + } + } + + // Build base action - use type assertion for generic action + // Note: Step doesn't have name/disabled at base level, they are on NodeBase + const action = { + id: step.id, + type: actionType, + params: extractParams(step), + policy, + } as ExecutableAction; + + return action; +} + +/** + * Legacy SelectorCandidate format: { type, value, weight? } + * Action SelectorCandidate format: { type, selector/xpath/text/etc, weight? } + */ +interface LegacySelectorCandidate { + type: string; + value: string; + weight?: number; +} + +interface LegacyTargetLocator { + ref?: string; + candidates: LegacySelectorCandidate[]; + // Additional fields from recorder + selector?: string; + tag?: string; +} + +/** + * Parse legacy ARIA value format + * Formats: + * - "role[name=...]" (e.g., "button[name=\"Submit\"]") + * - "aria-label=..." (role-less, just name) + */ +function parseAriaValue(value: string): { role?: string; name: string } { + // Try "role[name=...]" format + const roleMatch = value.match(/^([a-zA-Z]+)\[name=["']?(.+?)["']?\]$/); + if (roleMatch) { + return { role: roleMatch[1], name: roleMatch[2] }; + } + + // Try "aria-label=..." format + const labelMatch = value.match(/^aria-label=["']?(.+?)["']?$/); + if (labelMatch) { + return { name: labelMatch[1] }; + } + + // Fallback: treat entire value as name + return { name: value }; +} + +/** + * Convert legacy SelectorCandidate to Action SelectorCandidate + */ +function convertSelectorCandidate(legacy: LegacySelectorCandidate): Record { + const base: Record = { type: legacy.type }; + if (typeof legacy.weight === 'number') { + base.weight = legacy.weight; + } + + switch (legacy.type) { + case 'css': + case 'attr': + // CSS and attr use 'selector' field + base.selector = legacy.value; + break; + case 'xpath': + // XPath uses 'xpath' field + base.xpath = legacy.value; + break; + case 'text': + // Text uses 'text' field + base.text = legacy.value; + break; + case 'aria': { + // ARIA: parse "role[name=...]" or "aria-label=..." format + const parsed = parseAriaValue(legacy.value); + if (parsed.role) { + base.role = parsed.role; + } + base.name = parsed.name; + break; + } + default: + // Unknown type, pass through as-is + base.value = legacy.value; + } + + return base; +} + +/** + * Convert legacy TargetLocator to Action ElementTarget + * Preserves additional fields like selector and tag for locator optimization + */ +function convertTargetLocator(target: LegacyTargetLocator): Record { + const result: Record = {}; + + if (target.ref) { + result.ref = target.ref; + } + + // Preserve selector field for fast-path (e.g., #id selectors) + if (typeof target.selector === 'string' && target.selector.trim()) { + result.selector = target.selector; + } + + // Preserve tag hint for text/aria matching + if (typeof target.tag === 'string' && target.tag.trim()) { + result.hint = { tagName: target.tag }; + } + + if (Array.isArray(target.candidates) && target.candidates.length > 0) { + result.candidates = target.candidates.map(convertSelectorCandidate); + } + + return result; +} + +/** + * Check if a value looks like a legacy TargetLocator that needs conversion + * + * Detection criteria: + * 1. Must be an object with candidates array + * 2. Candidates must use legacy format (has 'value' field, not 'selector'/'xpath'/'text') + * + * This prevents double-conversion of already-converted Action format targets. + */ +function isLegacyTargetLocator(value: unknown): value is LegacyTargetLocator { + if (!value || typeof value !== 'object') return false; + const obj = value as Record; + + // Must have candidates array + if (!Array.isArray(obj.candidates)) { + // If only has ref without candidates, check if it's legacy format + return typeof obj.ref === 'string' && !obj.hint; + } + + // Check first candidate to determine format + const firstCandidate = obj.candidates[0]; + if (!firstCandidate || typeof firstCandidate !== 'object') { + return false; + } + + const candidate = firstCandidate as Record; + // Legacy format uses 'value' field + // Action format uses 'selector', 'xpath', 'text', etc. (NOT 'value') + const hasValueField = typeof candidate.value === 'string'; + const hasActionFields = + typeof candidate.selector === 'string' || + typeof candidate.xpath === 'string' || + typeof candidate.text === 'string' || + typeof candidate.name === 'string'; + + // It's legacy if it has 'value' field and doesn't have action-specific fields + return hasValueField && !hasActionFields; +} + +/** + * Extract action params from step + * Each step type has its own param structure + * + * This function also converts legacy data structures to Action-compatible formats: + * - TargetLocator.candidates: { type, value } -> { type, selector/xpath/text } + */ +function extractParams(step: Step): Record { + // The step already contains params inline, so we extract them + // excluding common fields that go into the action base + // Use unknown first to satisfy TypeScript's type narrowing + const stepObj = step as unknown as Record; + const { id, type, timeoutMs, retry, screenshotOnFail, ...params } = stepObj; + + // Convert TargetLocator fields if present + const converted: Record = {}; + for (const [key, value] of Object.entries(params)) { + if (key === 'target' && isLegacyTargetLocator(value)) { + converted[key] = convertTargetLocator(value); + } else if (key === 'start' && isLegacyTargetLocator(value)) { + // For drag step + converted[key] = convertTargetLocator(value); + } else if (key === 'end' && isLegacyTargetLocator(value)) { + // For drag step + converted[key] = convertTargetLocator(value); + } else { + converted[key] = value; + } + } + + return converted; +} + +// ================================ +// Result Conversion +// ================================ + +/** + * Convert ActionExecutionResult to legacy ExecResult + */ +export function actionResultToExecResult(result: ActionExecutionResult): ExecResult { + const execResult: ExecResult = {}; + + // Map nextLabel for control flow + if (result.nextLabel) { + execResult.nextLabel = result.nextLabel; + } + + // Map control directives + if (result.control) { + execResult.control = result.control; + } + + // If action already handled logging, mark it + if (result.status === 'success') { + execResult.alreadyLogged = false; // Let StepRunner handle logging + } + + return execResult; +} + +// ================================ +// Executor Factory +// ================================ + +/** + * Result from attempting to execute a step via actions + */ +export type StepExecutionAttempt = + | { supported: true; result: ExecResult } + | { supported: false; reason: string }; + +/** + * Options for step executor + */ +export interface StepExecutorOptions { + runId?: string; + pushLog?: (entry: unknown) => void; + /** + * If true, throws on unsupported step types instead of returning { supported: false } + * Use this in strict mode where all steps must go through ActionRegistry + */ + strict?: boolean; + /** + * Skip ActionRegistry retry policy. + * When true, the action's retry policy is removed before execution. + * Use this when StepRunner already handles retry via withRetry(). + */ + skipRetry?: boolean; + /** + * Skip navigation waiting inside action handlers. + * When true, handlers like click/navigate skip their internal nav-wait logic. + * Use this when StepRunner already handles navigation waiting. + */ + skipNavWait?: boolean; +} + +/** + * Create a step executor that uses ActionRegistry + * + * This is the main integration point - it creates a function that can + * replace the legacy `executeStep` call in StepRunner. + * + * The executor returns a discriminated union indicating whether the step + * was supported by ActionRegistry. This allows hybrid mode to fall back + * to legacy execution gracefully. + */ +export function createStepExecutor(registry: ActionRegistry) { + return async function executeStepViaActions( + ctx: ExecCtx, + step: Step, + tabId: number, + options?: StepExecutorOptions, + ): Promise { + // Convert step to action + let action = stepToAction(step); + + if (!action) { + const reason = `Unsupported step type for ActionRegistry: ${step.type}`; + if (options?.strict) { + throw new Error(reason); + } + return { supported: false, reason }; + } + + // Skip retry policy if StepRunner handles it + // This avoids double retry: StepRunner.withRetry() + ActionRegistry.retry + if (options?.skipRetry === true && action.policy?.retry) { + action = { ...action, policy: { ...action.policy, retry: undefined } }; + } + + // Check if handler exists + const handler = registry.get(action.type); + if (!handler) { + const reason = `No handler registered for action type: ${action.type}`; + if (options?.strict) { + throw new Error(reason); + } + return { supported: false, reason }; + } + + // Build execution flags for handlers + const execution: ExecutionFlags | undefined = + options?.skipNavWait === true ? { skipNavWait: true } : undefined; + + // Convert context with proper stepId for log attribution + const actionCtx = execCtxToActionCtx(ctx, tabId, { + stepId: step.id, + runId: options?.runId, + pushLog: options?.pushLog, + execution, + }); + + // Execute via registry (includes retry, timeout, hooks) + const result = await registry.execute(actionCtx, action); + + // Handle failure - still return as supported, but throw the error + if (result.status === 'failed') { + const error = result.error; + throw new Error( + error?.message || `Action ${action.type} failed: ${error?.code || 'UNKNOWN'}`, + ); + } + + // Sync vars back (in case action modified them) + Object.assign(ctx.vars, actionCtx.vars); + + // Sync frameId back (in case switchFrame modified it) + if (actionCtx.frameId !== undefined) { + ctx.frameId = actionCtx.frameId; + } + + // Sync tabId back (in case openTab/switchTab changed it) + // Chrome tabId is always a positive safe integer + if (result.status === 'success') { + const nextTabId = result.newTabId; + if (typeof nextTabId === 'number' && Number.isSafeInteger(nextTabId) && nextTabId > 0) { + ctx.tabId = nextTabId; + } + } + + // Convert result + return { supported: true, result: actionResultToExecResult(result) }; + }; +} + +// ================================ +// Type Guards +// ================================ + +/** + * Check if a step type is supported by ActionRegistry + */ +export function isActionSupported(stepType: string): boolean { + return stepType in STEP_TYPE_TO_ACTION_TYPE; +} + +/** + * Get the action type for a step type + */ +export function getActionType(stepType: string): ExecutableActionType | undefined { + return STEP_TYPE_TO_ACTION_TYPE[stepType]; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/assert.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/assert.ts new file mode 100644 index 00000000..bff322e9 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/assert.ts @@ -0,0 +1,356 @@ +/** + * Assert Action Handler + * + * Validates page state against specified conditions: + * - exists: Selector can be resolved to an element + * - visible: Element exists and has non-zero dimensions + * - textPresent: Text appears in the page content + * - attribute: Element attribute equals/matches/exists + */ + +import { failed, invalid, ok, tryResolveString } from '../registry'; +import type { ActionHandler, Assertion, VariableStore } from '../types'; + +/** Default timeout for polling assertions (ms) */ +const DEFAULT_ASSERT_TIMEOUT_MS = 5000; + +/** Polling interval for retry assertions (ms) */ +const POLL_INTERVAL_MS = 200; + +/** Maximum attribute name length */ +const MAX_ATTR_NAME_LENGTH = 256; + +/** + * Validates assertion configuration at build time + */ +function validateAssertion(assert: Assertion): { ok: true } | { ok: false; error: string } { + switch (assert.kind) { + case 'exists': + case 'visible': + if (assert.selector === undefined) { + return { ok: false, error: `Assertion "${assert.kind}" requires a selector` }; + } + break; + + case 'textPresent': + if (assert.text === undefined) { + return { ok: false, error: 'Assertion "textPresent" requires a text value' }; + } + break; + + case 'attribute': + if (assert.selector === undefined) { + return { ok: false, error: 'Assertion "attribute" requires a selector' }; + } + if (assert.name === undefined) { + return { ok: false, error: 'Assertion "attribute" requires an attribute name' }; + } + // Must have at least equals or matches (or neither for existence check) + break; + + default: { + const exhaustive: never = assert; + return { ok: false, error: `Unknown assertion kind: ${(exhaustive as Assertion).kind}` }; + } + } + + return { ok: true }; +} + +/** + * Resolve assertion parameters at runtime + */ +function resolveAssertionParams( + assert: Assertion, + vars: VariableStore, +): { ok: true; resolved: ResolvedAssertion } | { ok: false; error: string } { + switch (assert.kind) { + case 'exists': + case 'visible': { + const selectorResult = tryResolveString(assert.selector, vars); + if (!selectorResult.ok) return selectorResult; + const selector = selectorResult.value.trim(); + if (!selector) return { ok: false, error: `Empty selector for "${assert.kind}" assertion` }; + return { + ok: true, + resolved: { kind: assert.kind, selector }, + }; + } + + case 'textPresent': { + const textResult = tryResolveString(assert.text, vars); + if (!textResult.ok) return textResult; + const text = textResult.value; + if (!text) return { ok: false, error: 'Empty text for "textPresent" assertion' }; + return { + ok: true, + resolved: { kind: 'textPresent', text }, + }; + } + + case 'attribute': { + const selectorResult = tryResolveString(assert.selector, vars); + if (!selectorResult.ok) return selectorResult; + const selector = selectorResult.value.trim(); + if (!selector) return { ok: false, error: 'Empty selector for "attribute" assertion' }; + + const nameResult = tryResolveString(assert.name, vars); + if (!nameResult.ok) return nameResult; + const attrName = nameResult.value.trim(); + if (!attrName) return { ok: false, error: 'Empty attribute name' }; + if (attrName.length > MAX_ATTR_NAME_LENGTH) { + return { ok: false, error: `Attribute name exceeds ${MAX_ATTR_NAME_LENGTH} characters` }; + } + + let equals: string | undefined; + let matches: string | undefined; + + if (assert.equals !== undefined) { + const equalsResult = tryResolveString(assert.equals, vars); + if (!equalsResult.ok) return equalsResult; + equals = equalsResult.value; + } + + if (assert.matches !== undefined) { + const matchesResult = tryResolveString(assert.matches, vars); + if (!matchesResult.ok) return matchesResult; + matches = matchesResult.value; + // Validate regex + try { + new RegExp(matches); + } catch { + return { ok: false, error: `Invalid regex pattern: ${matches}` }; + } + } + + return { + ok: true, + resolved: { kind: 'attribute', selector, attrName, equals, matches }, + }; + } + } +} + +/** + * Resolved assertion with all variables interpolated + */ +type ResolvedAssertion = + | { kind: 'exists'; selector: string } + | { kind: 'visible'; selector: string } + | { kind: 'textPresent'; text: string } + | { kind: 'attribute'; selector: string; attrName: string; equals?: string; matches?: string }; + +/** + * Execute assertion check in page context + */ +async function checkAssertionInPage( + tabId: number, + frameId: number | undefined, + resolved: ResolvedAssertion, +): Promise<{ passed: boolean; message?: string }> { + const frameIds = typeof frameId === 'number' ? [frameId] : undefined; + + try { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: 'MAIN', + func: (assertion: ResolvedAssertion) => { + try { + switch (assertion.kind) { + case 'exists': { + const el = document.querySelector(assertion.selector); + return el ? { passed: true } : { passed: false, message: 'Element not found' }; + } + + case 'visible': { + const el = document.querySelector(assertion.selector); + if (!el) return { passed: false, message: 'Element not found' }; + const rect = el.getBoundingClientRect(); + const hasSize = rect.width > 0 && rect.height > 0; + if (!hasSize) return { passed: false, message: 'Element has zero dimensions' }; + + // Check if element is visible in viewport + const style = window.getComputedStyle(el); + if ( + style.display === 'none' || + style.visibility === 'hidden' || + style.opacity === '0' + ) { + return { passed: false, message: 'Element is hidden via CSS' }; + } + return { passed: true }; + } + + case 'textPresent': { + const text = assertion.text; + const bodyText = document.body?.textContent || ''; + if (bodyText.includes(text)) return { passed: true }; + return { passed: false, message: `Text "${text}" not found in page` }; + } + + case 'attribute': { + const el = document.querySelector(assertion.selector); + if (!el) return { passed: false, message: 'Element not found' }; + + const attrValue = el.getAttribute(assertion.attrName); + + // Check existence only + if (assertion.equals === undefined && assertion.matches === undefined) { + return attrValue !== null + ? { passed: true } + : { passed: false, message: `Attribute "${assertion.attrName}" not found` }; + } + + // Check equals + if (assertion.equals !== undefined) { + if (attrValue === assertion.equals) return { passed: true }; + return { + passed: false, + message: `Attribute "${assertion.attrName}" is "${attrValue}", expected "${assertion.equals}"`, + }; + } + + // Check matches (regex) + if (assertion.matches !== undefined) { + if (attrValue === null) { + return { passed: false, message: `Attribute "${assertion.attrName}" not found` }; + } + const regex = new RegExp(assertion.matches); + if (regex.test(attrValue)) return { passed: true }; + return { + passed: false, + message: `Attribute "${assertion.attrName}" value "${attrValue}" does not match pattern "${assertion.matches}"`, + }; + } + + return { passed: true }; + } + } + } catch (e) { + return { passed: false, message: e instanceof Error ? e.message : String(e) }; + } + }, + args: [resolved], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (!result || typeof result !== 'object') { + return { passed: false, message: 'Assertion script returned invalid result' }; + } + + return result as { passed: boolean; message?: string }; + } catch (e) { + return { + passed: false, + message: `Script execution failed: ${e instanceof Error ? e.message : String(e)}`, + }; + } +} + +/** + * Poll assertion until it passes or timeout + */ +async function pollAssertion( + tabId: number, + frameId: number | undefined, + resolved: ResolvedAssertion, + timeoutMs: number, +): Promise<{ passed: boolean; message?: string }> { + const startTime = Date.now(); + let lastResult: { passed: boolean; message?: string } = { + passed: false, + message: 'Timeout before first check', + }; + + while (Date.now() - startTime < timeoutMs) { + lastResult = await checkAssertionInPage(tabId, frameId, resolved); + if (lastResult.passed) return lastResult; + + // Wait before next poll + const remaining = timeoutMs - (Date.now() - startTime); + if (remaining > 0) { + await new Promise((resolve) => setTimeout(resolve, Math.min(POLL_INTERVAL_MS, remaining))); + } + } + + return { + passed: false, + message: `${lastResult.message || 'Assertion failed'} (timeout: ${timeoutMs}ms)`, + }; +} + +export const assertHandler: ActionHandler<'assert'> = { + type: 'assert', + + validate: (action) => { + const validation = validateAssertion(action.params.assert); + if (!validation.ok) { + return invalid(validation.error); + } + return ok(); + }, + + describe: (action) => { + const assert = action.params.assert; + switch (assert.kind) { + case 'exists': + return `Assert exists: ${truncate(String(assert.selector), 30)}`; + case 'visible': + return `Assert visible: ${truncate(String(assert.selector), 30)}`; + case 'textPresent': + return `Assert text: "${truncate(String(assert.text), 25)}"`; + case 'attribute': + return `Assert attr: ${truncate(String(assert.name), 15)}`; + default: + return 'Assert'; + } + }, + + run: async (ctx, action) => { + const tabId = ctx.tabId; + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for assert action'); + } + + // Resolve assertion parameters + const resolved = resolveAssertionParams(action.params.assert, ctx.vars); + if (!resolved.ok) { + return failed('VALIDATION_ERROR', resolved.error); + } + + // Determine timeout from policy or default + const timeoutMs = action.policy?.timeout?.ms ?? DEFAULT_ASSERT_TIMEOUT_MS; + const failStrategy = action.params.failStrategy ?? 'stop'; + + // Execute assertion with polling + const result = await pollAssertion(tabId, ctx.frameId, resolved.resolved, timeoutMs); + + if (result.passed) { + return { status: 'success' }; + } + + // Handle failure based on strategy + const errorMessage = result.message || 'Assertion failed'; + + switch (failStrategy) { + case 'warn': + ctx.log(`Assertion warning: ${errorMessage}`, 'warn'); + return { status: 'success' }; + + case 'retry': + // Return failed with retryable error code + // The scheduler should handle retry based on policy + return failed('ASSERTION_FAILED', errorMessage); + + case 'stop': + default: + return failed('ASSERTION_FAILED', errorMessage); + } + }, +}; + +/** Truncate string for display */ +function truncate(str: string, maxLen: number): string { + if (typeof str !== 'string') return '(dynamic)'; + return str.length > maxLen ? str.slice(0, maxLen) + '...' : str; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/click.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/click.ts new file mode 100644 index 00000000..b4acbe29 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/click.ts @@ -0,0 +1,193 @@ +/** + * Click and Double-Click Action Handlers + * + * Handles click interactions: + * - Single click + * - Double click + * - Post-click navigation/network wait + * - Selector fallback with logging + */ + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { ENGINE_CONSTANTS } from '../../engine/constants'; +import { + maybeQuickWaitForNav, + waitForNavigationDone, + waitForNetworkIdle, +} from '../../engine/policies/wait'; +import { failed, invalid, ok } from '../registry'; +import type { + Action, + ActionExecutionContext, + ActionExecutionResult, + ActionHandler, +} from '../types'; +import { + clampInt, + ensureElementVisible, + logSelectorFallback, + readTabUrl, + selectorLocator, + toSelectorTarget, +} from './common'; + +/** + * Shared click execution logic for both click and dblclick + */ +async function executeClick( + ctx: ActionExecutionContext, + action: Action, +): Promise> { + const vars = ctx.vars; + const tabId = ctx.tabId; + // Check if StepRunner owns nav-wait (skip internal nav-wait logic) + const skipNavWait = ctx.execution?.skipNavWait === true; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found'); + } + + // Ensure page is read before locating element + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + + // Only read beforeUrl if we need to do nav-wait + const beforeUrl = skipNavWait ? '' : await readTabUrl(tabId); + const { selectorTarget, firstCandidateType, firstCssOrAttr } = toSelectorTarget( + action.params.target, + vars, + ); + + // Locate element using shared selector locator + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId: ctx.frameId, + preferRef: false, + }); + + const frameId = located?.frameId ?? ctx.frameId; + const refToUse = located?.ref ?? selectorTarget.ref; + const selectorToUse = !located?.ref ? firstCssOrAttr : undefined; + + if (!refToUse && !selectorToUse) { + return failed('TARGET_NOT_FOUND', 'Could not locate target element'); + } + + // Verify element visibility if we have a ref + if (located?.ref) { + const isVisible = await ensureElementVisible(tabId, located.ref, frameId); + if (!isVisible) { + return failed('ELEMENT_NOT_VISIBLE', 'Target element is not visible'); + } + } + + // Execute click with tool timeout + const toolTimeout = clampInt(action.policy?.timeout?.ms ?? 10000, 1000, 30000); + + const clickResult = await handleCallTool({ + name: TOOL_NAMES.BROWSER.CLICK, + args: { + ref: refToUse, + selector: selectorToUse, + waitForNavigation: false, + timeout: toolTimeout, + frameId, + tabId, + double: action.type === 'dblclick', + }, + }); + + if ((clickResult as { isError?: boolean })?.isError) { + const errorContent = (clickResult as { content?: Array<{ text?: string }> })?.content; + const errorMsg = errorContent?.[0]?.text || `${action.type} action failed`; + return failed('UNKNOWN', errorMsg); + } + + // Log selector fallback if used + const resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + const fallbackUsed = + resolvedBy && firstCandidateType && resolvedBy !== 'ref' && resolvedBy !== firstCandidateType; + + if (fallbackUsed) { + logSelectorFallback(ctx, action.id, String(firstCandidateType), String(resolvedBy)); + } + + // Skip post-click wait if StepRunner handles it + if (skipNavWait) { + return { status: 'success' }; + } + + // Post-click wait handling (only when handler owns nav-wait) + const waitMs = clampInt( + action.policy?.timeout?.ms ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, + 0, + ENGINE_CONSTANTS.MAX_WAIT_MS, + ); + const after = action.params.after ?? {}; + + if (after.waitForNavigation) { + await waitForNavigationDone(beforeUrl, waitMs); + } else if (after.waitForNetworkIdle) { + const totalMs = clampInt(waitMs, 1000, ENGINE_CONSTANTS.MAX_WAIT_MS); + const idleMs = Math.min(1500, Math.max(500, Math.floor(totalMs / 3))); + await waitForNetworkIdle(totalMs, idleMs); + } else { + // Quick sniff for navigation that might have been triggered + await maybeQuickWaitForNav(beforeUrl, waitMs); + } + + return { status: 'success' }; +} + +/** + * Validate click target configuration + */ +function validateClickTarget(target: { + ref?: string; + candidates?: unknown[]; +}): { ok: true } | { ok: false; errors: [string, ...string[]] } { + const hasRef = typeof target?.ref === 'string' && target.ref.trim().length > 0; + const hasCandidates = Array.isArray(target?.candidates) && target.candidates.length > 0; + + if (hasRef || hasCandidates) { + return ok(); + } + return invalid('Missing target selector or ref'); +} + +export const clickHandler: ActionHandler<'click'> = { + type: 'click', + + validate: (action) => + validateClickTarget(action.params.target as { ref?: string; candidates?: unknown[] }), + + describe: (action) => { + const target = action.params.target; + if (typeof (target as { ref?: string }).ref === 'string') { + return `Click element ${(target as { ref: string }).ref}`; + } + return 'Click element'; + }, + + run: async (ctx, action) => { + return await executeClick(ctx, action); + }, +}; + +export const dblclickHandler: ActionHandler<'dblclick'> = { + type: 'dblclick', + + validate: (action) => + validateClickTarget(action.params.target as { ref?: string; candidates?: unknown[] }), + + describe: (action) => { + const target = action.params.target; + if (typeof (target as { ref?: string }).ref === 'string') { + return `Double-click element ${(target as { ref: string }).ref}`; + } + return 'Double-click element'; + }, + + run: async (ctx, action) => { + return await executeClick(ctx, action); + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/common.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/common.ts new file mode 100644 index 00000000..cc0e0a08 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/common.ts @@ -0,0 +1,332 @@ +/** + * Common utilities for Action handlers + * + * Shared helpers for: + * - Variable resolution and template interpolation + * - Selector target conversion + * - Element visibility verification + * - Logging utilities + */ + +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { + createChromeSelectorLocator, + type SelectorCandidate as SharedSelectorCandidate, + type SelectorCandidateSource, + type SelectorStability, + type SelectorTarget, +} from '@/shared/selector'; +import { tryResolveString } from '../registry'; +import type { ActionExecutionContext, ElementTarget, Resolvable, VariableStore } from '../types'; + +// ================================ +// Selector Locator Instance +// ================================ + +export const selectorLocator = createChromeSelectorLocator(); + +// ================================ +// String Resolution Utilities +// ================================ + +/** + * Interpolate {varName} placeholders in a string using variable store + */ +export function interpolateBraces(template: string, vars: VariableStore): string { + return String(template || '').replace(/\{([^}]+)\}/g, (_match, key) => { + const value = (vars as Record)[key]; + return value == null ? '' : String(value); + }); +} + +/** + * Resolve a Resolvable value with template interpolation + */ +export function resolveString( + value: Resolvable, + vars: VariableStore, +): { ok: true; value: string } | { ok: false; error: string } { + const resolved = tryResolveString(value, vars); + if (!resolved.ok) return resolved; + return { ok: true, value: interpolateBraces(resolved.value, vars) }; +} + +/** + * Resolve an optional Resolvable value + */ +export function resolveOptionalString( + value: Resolvable | undefined, + vars: VariableStore, +): string | undefined { + if (value === undefined) return undefined; + const resolved = resolveString(value, vars); + if (!resolved.ok) return undefined; + const out = resolved.value.trim(); + return out.length > 0 ? out : undefined; +} + +// ================================ +// Number Utilities +// ================================ + +/** + * Clamp a number to a range with integer conversion + */ +export function clampInt(value: number, min: number, max: number): number { + const n = Number(value); + if (!Number.isFinite(n)) return min; + return Math.min(max, Math.max(min, Math.floor(n))); +} + +// ================================ +// Selector Target Conversion +// ================================ + +export interface ConvertedSelectorTarget { + selectorTarget: SelectorTarget; + /** Type of the first candidate (for fallback logging) */ + firstCandidateType?: string; + /** First CSS or attr selector value (for tool fallback) */ + firstCssOrAttr?: string; +} + +/** + * Convert Action ElementTarget to shared SelectorTarget + * + * Handles: + * - Resolvable candidate values + * - Template interpolation + * - Weight assignment for locator priority + */ +export function toSelectorTarget( + target: ElementTarget, + vars: VariableStore, +): ConvertedSelectorTarget { + const srcCandidates = Array.isArray(target.candidates) ? target.candidates : []; + const firstCandidateType = + srcCandidates.length > 0 + ? String((srcCandidates[0] as { type?: string })?.type || '') || undefined + : undefined; + + // Find first CSS/attr selector for tool fallback + let firstCssOrAttr: string | undefined; + for (const c of srcCandidates) { + if (c.type !== 'css' && c.type !== 'attr') continue; + const resolved = resolveString(c.selector, vars); + if (resolved.ok && resolved.value.trim()) { + firstCssOrAttr = resolved.value; + break; + } + } + + // Extract selector from target if present + const primaryRaw = + typeof (target as { selector?: string }).selector === 'string' + ? String((target as { selector?: string }).selector).trim() + : ''; + const selectorInterpolated = primaryRaw ? interpolateBraces(primaryRaw, vars).trim() : ''; + const selector = selectorInterpolated || undefined; + + // Extract tagName hint + const tagName = + typeof (target as { tag?: string }).tag === 'string' + ? String((target as { tag?: string }).tag) + : typeof (target as { hint?: { tagName?: string } }).hint?.tagName === 'string' + ? String((target as { hint?: { tagName?: string } }).hint!.tagName) + : undefined; + + // Convert candidates with weight assignment + // Preserve user-defined weights while keeping text candidates as last resort + let nonTextIndex = 0; + let textIndex = 0; + const candidates: SharedSelectorCandidate[] = []; + + for (const c of srcCandidates) { + const idx = c.type === 'text' ? textIndex++ : nonTextIndex++; + // Respect user-defined weight if present, otherwise use position-based weight + const userWeight = + typeof (c as { weight?: number }).weight === 'number' && + Number.isFinite((c as { weight?: number }).weight) + ? (c as { weight: number }).weight + : 0; + // Non-text candidates get higher base weight + const weightBase = c.type === 'text' ? 0 : 1000; + const weight = weightBase + userWeight - idx; + + // Preserve source and stability metadata from original candidate + // Type-safely extract optional source and stability fields + const rawSource = (c as { source?: SelectorCandidateSource }).source; + const rawStability = (c as { stability?: SelectorStability }).stability; + const meta: Pick = { + weight, + ...(rawSource && { source: rawSource }), + ...(rawStability && { stability: rawStability }), + }; + + switch (c.type) { + case 'css': { + const resolved = resolveString(c.selector, vars); + if (!resolved.ok) continue; + candidates.push({ type: 'css', value: resolved.value, ...meta }); + break; + } + case 'attr': { + const resolved = resolveString(c.selector, vars); + if (!resolved.ok) continue; + candidates.push({ type: 'attr', value: resolved.value, ...meta }); + break; + } + case 'xpath': { + const resolved = resolveString(c.xpath, vars); + if (!resolved.ok) continue; + candidates.push({ type: 'xpath', value: resolved.value, ...meta }); + break; + } + case 'text': { + const resolved = resolveString(c.text, vars); + if (!resolved.ok) continue; + candidates.push({ + type: 'text', + value: resolved.value, + ...meta, + match: c.match, + tagNameHint: c.tagNameHint ?? tagName, + }); + break; + } + case 'aria': { + const role = resolveOptionalString(c.role, vars); + const name = resolveOptionalString(c.name, vars); + // Skip aria candidate if no name provided (would produce useless selector) + if (!name) break; + // Avoid injecting fake role; use aria-label format when role is not specified + const value = role + ? `${role}[name=${JSON.stringify(name)}]` + : `aria-label=${JSON.stringify(name)}`; + candidates.push({ type: 'aria', value, ...meta, role, name }); + break; + } + } + } + + // Ensure at least one candidate + const ensuredCandidates: [SharedSelectorCandidate, ...SharedSelectorCandidate[]] = + candidates.length > 0 + ? (candidates as [SharedSelectorCandidate, ...SharedSelectorCandidate[]]) + : [{ type: 'css', value: '' }]; + + return { + selectorTarget: { + selector, + candidates: ensuredCandidates, + tagName, + ref: + typeof (target as { ref?: string }).ref === 'string' + ? String((target as { ref?: string }).ref) + : undefined, + }, + firstCandidateType, + firstCssOrAttr, + }; +} + +// ================================ +// Chrome Message Utilities +// ================================ + +/** + * Result type for sendMessageToTab + */ +export type SendMessageResult = { ok: true; value: T } | { ok: false; error: string }; + +/** + * Send message to tab with optional frameId + * Returns structured result to avoid silent failures + */ +export async function sendMessageToTab( + tabId: number, + message: unknown, + frameId?: number, +): Promise> { + try { + let response: T; + if (typeof frameId === 'number') { + response = await chrome.tabs.sendMessage(tabId, message, { frameId }); + } else { + response = await chrome.tabs.sendMessage(tabId, message); + } + return { ok: true, value: response }; + } catch (e) { + return { ok: false, error: e instanceof Error ? e.message : String(e) }; + } +} + +// ================================ +// Element Verification +// ================================ + +/** + * Verify element is visible by checking its bounding rect + */ +export async function ensureElementVisible( + tabId: number, + ref: string, + frameId: number | undefined, +): Promise { + const result = await sendMessageToTab<{ rect?: { width: number; height: number } }>( + tabId, + { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref }, + frameId, + ); + if (!result.ok) return false; + const rect = result.value?.rect; + return !!rect && rect.width > 0 && rect.height > 0; +} + +/** + * Get current tab URL + */ +export async function readTabUrl(tabId: number): Promise { + try { + const tab = await chrome.tabs.get(tabId); + return tab?.url || ''; + } catch { + return ''; + } +} + +// ================================ +// Logging Utilities +// ================================ + +export interface FallbackLogEntry { + stepId: string; + status: 'success'; + message: string; + fallbackUsed: boolean; + fallbackFrom: string; + fallbackTo: string; +} + +/** + * Log selector fallback usage for debugging + */ +export function logSelectorFallback( + ctx: Pick, + actionId: string, + from: string, + to: string, +): void { + try { + ctx.pushLog?.({ + stepId: actionId, + status: 'success', + message: `Selector fallback used (${from} -> ${to})`, + fallbackUsed: true, + fallbackFrom: from, + fallbackTo: to, + }); + } catch { + // Ignore logging errors + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/control-flow.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/control-flow.ts new file mode 100644 index 00000000..696a3b37 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/control-flow.ts @@ -0,0 +1,382 @@ +/** + * Control Flow Action Handlers + * + * Handles flow control operations: + * - if: Conditional branching + * - foreach: Loop over array + * - while: Loop with condition + * - switchFrame: Switch to a different frame + * + * Note: The actual loop iteration is handled by the Scheduler. + * These handlers return control directives that tell the Scheduler how to proceed. + */ + +import { + failed, + invalid, + ok, + tryResolveNumber, + tryResolveString, + tryResolveValue, +} from '../registry'; +import type { + ActionHandler, + Condition, + ControlDirective, + EdgeLabel, + VariableStore, +} from '../types'; + +/** Default max iterations for while loops */ +const DEFAULT_MAX_ITERATIONS = 1000; + +// ================================ +// Condition Evaluation +// ================================ + +/** + * Evaluate a condition against variables + */ +function evaluateCondition(condition: Condition, vars: VariableStore): boolean { + switch (condition.kind) { + case 'expr': { + // Expression evaluation not supported in default resolver + // Return false for safety + return false; + } + + case 'compare': { + const leftResult = tryResolveValue(condition.left, vars); + const rightResult = tryResolveValue(condition.right, vars); + + if (!leftResult.ok || !rightResult.ok) return false; + + const left = leftResult.value; + const right = rightResult.value; + + switch (condition.op) { + case 'eq': + return left === right; + case 'eqi': + return String(left).toLowerCase() === String(right).toLowerCase(); + case 'neq': + return left !== right; + case 'gt': + return Number(left) > Number(right); + case 'gte': + return Number(left) >= Number(right); + case 'lt': + return Number(left) < Number(right); + case 'lte': + return Number(left) <= Number(right); + case 'contains': + return String(left).includes(String(right)); + case 'containsI': + return String(left).toLowerCase().includes(String(right).toLowerCase()); + case 'notContains': + return !String(left).includes(String(right)); + case 'notContainsI': + return !String(left).toLowerCase().includes(String(right).toLowerCase()); + case 'startsWith': + return String(left).startsWith(String(right)); + case 'endsWith': + return String(left).endsWith(String(right)); + case 'regex': { + try { + const regex = new RegExp(String(right)); + return regex.test(String(left)); + } catch { + return false; + } + } + default: + return false; + } + } + + case 'truthy': { + const result = tryResolveValue(condition.value, vars); + if (!result.ok) return false; + return Boolean(result.value); + } + + case 'falsy': { + const result = tryResolveValue(condition.value, vars); + if (!result.ok) return true; + return !result.value; + } + + case 'not': + return !evaluateCondition(condition.condition, vars); + + case 'and': + return condition.conditions.every((c) => evaluateCondition(c, vars)); + + case 'or': + return condition.conditions.some((c) => evaluateCondition(c, vars)); + + default: + return false; + } +} + +// ================================ +// if Handler +// ================================ + +export const ifHandler: ActionHandler<'if'> = { + type: 'if', + + validate: (action) => { + const params = action.params; + + if (params.mode === 'binary') { + if (!params.condition) { + return invalid('Binary if requires a condition'); + } + } else if (params.mode === 'branches') { + if (!params.branches || params.branches.length === 0) { + return invalid('Branches if requires at least one branch'); + } + } else { + return invalid(`Unknown if mode: ${String((params as { mode: string }).mode)}`); + } + + return ok(); + }, + + describe: (action) => { + if (action.params.mode === 'binary') { + return 'If condition'; + } + const branchCount = action.params.mode === 'branches' ? action.params.branches.length : 0; + return `If (${branchCount} branches)`; + }, + + run: async (ctx, action) => { + const params = action.params; + + if (params.mode === 'binary') { + const result = evaluateCondition(params.condition, ctx.vars); + const label: EdgeLabel = result + ? (params.trueLabel ?? 'true') + : (params.falseLabel ?? 'false'); + return { status: 'success', nextLabel: label }; + } + + // Branches mode + if (params.mode === 'branches') { + for (const branch of params.branches) { + if (evaluateCondition(branch.condition, ctx.vars)) { + return { status: 'success', nextLabel: branch.label }; + } + } + // No branch matched, use else label + const elseLabel = params.elseLabel ?? 'default'; + return { status: 'success', nextLabel: elseLabel }; + } + + return failed('VALIDATION_ERROR', 'Invalid if mode'); + }, +}; + +// ================================ +// foreach Handler +// ================================ + +export const foreachHandler: ActionHandler<'foreach'> = { + type: 'foreach', + + validate: (action) => { + const params = action.params; + + if (!params.listVar) { + return invalid('foreach requires a listVar'); + } + + if (!params.subflowId) { + return invalid('foreach requires a subflowId'); + } + + return ok(); + }, + + describe: (action) => { + return `For each in ${action.params.listVar}`; + }, + + run: async (ctx, action) => { + const params = action.params; + + // Check if listVar exists and is an array + const list = ctx.vars[params.listVar]; + if (!Array.isArray(list)) { + return failed('VALIDATION_ERROR', `Variable "${params.listVar}" is not an array`); + } + + if (list.length === 0) { + // Empty list, nothing to iterate + return { status: 'success' }; + } + + // Return control directive for scheduler to handle + const directive: ControlDirective = { + kind: 'foreach', + listVar: params.listVar, + itemVar: params.itemVar || 'item', + subflowId: params.subflowId, + concurrency: params.concurrency, + }; + + return { status: 'success', control: directive }; + }, +}; + +// ================================ +// while Handler +// ================================ + +export const whileHandler: ActionHandler<'while'> = { + type: 'while', + + validate: (action) => { + const params = action.params; + + if (!params.condition) { + return invalid('while requires a condition'); + } + + if (!params.subflowId) { + return invalid('while requires a subflowId'); + } + + return ok(); + }, + + describe: () => { + return 'While loop'; + }, + + run: async (ctx, action) => { + const params = action.params; + + // Check if condition is currently true + const conditionResult = evaluateCondition(params.condition, ctx.vars); + + if (!conditionResult) { + // Condition is false, don't enter loop + return { status: 'success' }; + } + + // Return control directive for scheduler to handle + const directive: ControlDirective = { + kind: 'while', + condition: params.condition, + subflowId: params.subflowId, + maxIterations: params.maxIterations ?? DEFAULT_MAX_ITERATIONS, + }; + + return { status: 'success', control: directive }; + }, +}; + +// ================================ +// switchFrame Handler +// ================================ + +export const switchFrameHandler: ActionHandler<'switchFrame'> = { + type: 'switchFrame', + + validate: (action) => { + const target = action.params.target; + + if (!target) { + return invalid('switchFrame requires a target'); + } + + if (target.kind !== 'top' && target.kind !== 'index' && target.kind !== 'urlContains') { + return invalid(`Unknown frame target kind: ${String((target as { kind: string }).kind)}`); + } + + return ok(); + }, + + describe: (action) => { + const target = action.params.target; + if (target.kind === 'top') return 'Switch to top frame'; + if (target.kind === 'index') return `Switch to frame #${target.index}`; + if (target.kind === 'urlContains') return 'Switch frame (by URL)'; + return 'Switch frame'; + }, + + run: async (ctx, action) => { + const target = action.params.target; + const tabId = ctx.tabId; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found'); + } + + try { + if (target.kind === 'top') { + // Reset to main frame (frameId = 0) + ctx.frameId = 0; + return { status: 'success' }; + } + + // Get all frames in the tab + const frames = await chrome.webNavigation.getAllFrames({ tabId }); + if (!frames || frames.length === 0) { + return failed('FRAME_NOT_FOUND', 'No frames found in tab'); + } + + let targetFrame: chrome.webNavigation.GetAllFrameResultDetails | undefined; + + if (target.kind === 'index') { + const indexResult = tryResolveNumber(target.index, ctx.vars); + if (!indexResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve frame index: ${indexResult.error}`); + } + const index = Math.floor(indexResult.value); + + // Find frame by index (excluding main frame which is 0) + const childFrames = frames.filter((f) => f.frameId !== 0); + if (index < 0 || index >= childFrames.length) { + return failed( + 'FRAME_NOT_FOUND', + `Frame index ${index} out of bounds (${childFrames.length} frames)`, + ); + } + targetFrame = childFrames[index]; + } else if (target.kind === 'urlContains') { + const urlResult = tryResolveString(target.value, ctx.vars); + if (!urlResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve URL pattern: ${urlResult.error}`); + } + const urlPattern = urlResult.value.trim().toLowerCase(); + + // Empty pattern is invalid + if (!urlPattern) { + return failed('VALIDATION_ERROR', 'URL pattern cannot be empty'); + } + + targetFrame = frames.find((f) => f.url && f.url.toLowerCase().includes(urlPattern)); + } + + if (!targetFrame) { + return failed('FRAME_NOT_FOUND', 'No matching frame found'); + } + + // The frameId will be used by subsequent actions + // Store it in context (this is typically handled by scheduler) + ctx.frameId = targetFrame.frameId; + + return { status: 'success' }; + } catch (e) { + return failed( + 'FRAME_NOT_FOUND', + `Failed to switch frame: ${e instanceof Error ? e.message : String(e)}`, + ); + } + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/delay.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/delay.ts new file mode 100644 index 00000000..4495fd19 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/delay.ts @@ -0,0 +1,43 @@ +/** + * Delay Action Handler + * + * Provides a simple pause in execution flow. + * Supports variable resolution for dynamic delay times. + */ + +import { failed, invalid, ok, tryResolveNumber } from '../registry'; +import type { ActionHandler } from '../types'; + +/** Maximum delay time to prevent integer overflow in setTimeout */ +const MAX_DELAY_MS = 2_147_483_647; + +export const delayHandler: ActionHandler<'delay'> = { + type: 'delay', + + validate: (action) => { + if (action.params.sleep === undefined) { + return invalid('Missing sleep parameter'); + } + return ok(); + }, + + describe: (action) => { + const ms = typeof action.params.sleep === 'number' ? action.params.sleep : '(dynamic)'; + return `Delay ${ms}ms`; + }, + + run: async (ctx, action) => { + const resolved = tryResolveNumber(action.params.sleep, ctx.vars); + if (!resolved.ok) { + return failed('VALIDATION_ERROR', resolved.error); + } + + const ms = Math.max(0, Math.min(MAX_DELAY_MS, Math.floor(resolved.value))); + + if (ms > 0) { + await new Promise((resolve) => setTimeout(resolve, ms)); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/dom.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/dom.ts new file mode 100644 index 00000000..3080d95f --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/dom.ts @@ -0,0 +1,427 @@ +/** + * DOM Tools Action Handlers + * + * Handles DOM manipulation actions: + * - triggerEvent: Dispatch a custom DOM Event on an element + * - setAttribute: Set or remove an attribute on an element + * + * Design notes: + * - Both handlers follow the same pattern as click.ts + * - Element location uses selectorLocator from shared code + * - CSS selector resolution supports ref fallback + */ + +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok, tryResolveJson } from '../registry'; +import type { + ActionExecutionResult, + ActionHandler, + ElementTarget, + JsonValue, + VariableStore, +} from '../types'; +import { + interpolateBraces, + logSelectorFallback, + resolveString, + selectorLocator, + sendMessageToTab, + toSelectorTarget, +} from './common'; + +// ================================ +// Type Definitions +// ================================ + +interface ResolveRefResponse { + success?: boolean; + selector?: string; + error?: string; +} + +interface DomScriptResult { + success: boolean; + error?: string; +} + +interface ResolvedTarget { + selector: string; + frameId: number | undefined; + firstCandidateType?: string; + resolvedBy?: string; +} + +// ================================ +// Shared Utilities +// ================================ + +/** + * Check if target has valid ref or candidates + * Accepts unknown to safely handle malformed input in validate() + */ +function hasValidTarget(target: unknown): boolean { + if (typeof target !== 'object' || target === null) return false; + const t = target as { ref?: unknown; candidates?: unknown }; + const hasRef = typeof t.ref === 'string' && t.ref.trim().length > 0; + const hasCandidates = Array.isArray(t.candidates) && t.candidates.length > 0; + return hasRef || hasCandidates; +} + +/** + * Strip frame prefix from composite selector (e.g., "frame|>selector" -> "selector") + */ +function stripCompositePrefix(selector: string): string { + const raw = String(selector || '').trim(); + if (!raw.includes('|>')) return raw; + + const parts = raw + .split('|>') + .map((p) => p.trim()) + .filter(Boolean); + return parts.length > 0 ? parts[parts.length - 1] : raw; +} + +/** + * Resolve ElementTarget to a CSS selector string + * + * Resolution order: + * 1. Try to locate element using selectorLocator + * 2. If ref found, resolve it to CSS selector via content script + * 3. Fall back to first CSS/attr candidate if no ref + */ +async function resolveTargetSelector( + tabId: number, + target: ElementTarget, + vars: VariableStore, + contextFrameId: number | undefined, +): Promise<{ ok: true; value: ResolvedTarget } | { ok: false; error: string }> { + const { selectorTarget, firstCandidateType, firstCssOrAttr } = toSelectorTarget(target, vars); + + // Locate element using shared selector locator + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId: contextFrameId, + preferRef: false, + }); + + const frameId = located?.frameId ?? contextFrameId; + const refToUse = located?.ref ?? selectorTarget.ref; + + // Must have either ref or CSS/attr candidate + if (!refToUse && !firstCssOrAttr) { + return { ok: false, error: 'Could not locate target element' }; + } + + let selector: string | undefined; + + // Try to resolve ref to CSS selector + if (refToUse) { + const resolved = await sendMessageToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref: refToUse }, + frameId, + ); + + if (resolved.ok && resolved.value?.success !== false && resolved.value?.selector) { + const sel = resolved.value.selector.trim(); + if (sel) selector = sel; + } + } + + // Fall back to CSS/attr candidate + if (!selector && firstCssOrAttr) { + const stripped = stripCompositePrefix(firstCssOrAttr); + if (stripped) selector = stripped; + } + + if (!selector) { + return { ok: false, error: 'Could not resolve a CSS selector for the target element' }; + } + + return { + ok: true, + value: { + selector, + frameId, + firstCandidateType, + // Only mark as 'ref' if locator actually resolved via ref + resolvedBy: located?.resolvedBy || (located?.ref ? 'ref' : undefined), + }, + }; +} + +/** + * Log selector fallback if a different selector type was used + */ +function maybeLogFallback( + ctx: Parameters[0], + actionId: string, + resolved: ResolvedTarget, +): void { + const { resolvedBy, firstCandidateType } = resolved; + + const fallbackUsed = + resolvedBy && firstCandidateType && resolvedBy !== 'ref' && resolvedBy !== firstCandidateType; + + if (fallbackUsed) { + logSelectorFallback(ctx, actionId, String(firstCandidateType), String(resolvedBy)); + } +} + +// ================================ +// triggerEvent Handler +// ================================ + +export const triggerEventHandler: ActionHandler<'triggerEvent'> = { + type: 'triggerEvent', + + validate: (action) => { + if (!hasValidTarget(action.params.target)) { + return invalid('triggerEvent requires a target ref or selector candidates'); + } + + const event = action.params.event; + if (event === undefined || event === null) { + return invalid('Missing event parameter'); + } + if (typeof event === 'string' && event.trim().length === 0) { + return invalid('event must be a non-empty string'); + } + + return ok(); + }, + + describe: (action) => { + const ev = typeof action.params.event === 'string' ? action.params.event : '(dynamic)'; + const display = ev.length > 30 ? ev.slice(0, 30) + '...' : ev; + return `Trigger event "${display}"`; + }, + + run: async (ctx, action): Promise> => { + const { tabId, vars, frameId } = ctx; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for triggerEvent action'); + } + + // Resolve event type + const eventResolved = resolveString(action.params.event, vars); + if (!eventResolved.ok) { + return failed('VALIDATION_ERROR', eventResolved.error); + } + + const eventType = eventResolved.value.trim(); + if (!eventType) { + return failed('VALIDATION_ERROR', 'Event type is empty'); + } + + // Event options + const bubbles = action.params.bubbles !== false; + const cancelable = action.params.cancelable === true; + + // Ensure page is read for element location + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: { tabId } }); + + // Resolve target selector + const targetResolved = await resolveTargetSelector(tabId, action.params.target, vars, frameId); + if (!targetResolved.ok) { + return failed('TARGET_NOT_FOUND', targetResolved.error); + } + + const { selector, frameId: resolvedFrameId } = targetResolved.value; + const frameIds = typeof resolvedFrameId === 'number' ? [resolvedFrameId] : undefined; + + // Execute event dispatch in page context + try { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: 'MAIN', + func: ( + sel: string, + type: string, + bubbles: boolean, + cancelable: boolean, + ): DomScriptResult => { + try { + const el = document.querySelector(sel); + if (!el) { + // Use special error code to distinguish from script execution errors + return { success: false, error: `[TARGET_NOT_FOUND] Element not found: ${sel}` }; + } + + const event = new Event(type, { bubbles, cancelable }); + el.dispatchEvent(event); + return { success: true }; + } catch (e) { + return { success: false, error: e instanceof Error ? e.message : String(e) }; + } + }, + args: [selector, eventType, bubbles, cancelable], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (!result || typeof result !== 'object') { + return failed('SCRIPT_FAILED', 'triggerEvent script returned invalid result'); + } + + const typed = result as DomScriptResult; + if (!typed.success) { + // Parse error code from message if present (e.g., "[TARGET_NOT_FOUND] ...") + const errorMsg = typed.error || `Failed to dispatch "${eventType}"`; + const code = errorMsg.startsWith('[TARGET_NOT_FOUND]') + ? 'TARGET_NOT_FOUND' + : 'SCRIPT_FAILED'; + return failed(code, errorMsg.replace(/^\[TARGET_NOT_FOUND\]\s*/, '')); + } + } catch (e) { + return failed( + 'SCRIPT_FAILED', + `Failed to trigger event "${eventType}": ${e instanceof Error ? e.message : String(e)}`, + ); + } + + maybeLogFallback(ctx, action.id, targetResolved.value); + + return { status: 'success' }; + }, +}; + +// ================================ +// setAttribute Handler +// ================================ + +export const setAttributeHandler: ActionHandler<'setAttribute'> = { + type: 'setAttribute', + + validate: (action) => { + if (!hasValidTarget(action.params.target)) { + return invalid('setAttribute requires a target ref or selector candidates'); + } + + const name = action.params.name; + if (name === undefined || name === null) { + return invalid('Missing name parameter'); + } + if (typeof name === 'string' && name.trim().length === 0) { + return invalid('name must be a non-empty string'); + } + + return ok(); + }, + + describe: (action) => { + const name = typeof action.params.name === 'string' ? action.params.name : '(dynamic)'; + const display = name.length > 30 ? name.slice(0, 30) + '...' : name; + return action.params.remove ? `Remove attribute "${display}"` : `Set attribute "${display}"`; + }, + + run: async (ctx, action): Promise> => { + const { tabId, vars, frameId } = ctx; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for setAttribute action'); + } + + // Resolve attribute name + const nameResolved = resolveString(action.params.name, vars); + if (!nameResolved.ok) { + return failed('VALIDATION_ERROR', nameResolved.error); + } + + const attrName = nameResolved.value.trim(); + if (!attrName) { + return failed('VALIDATION_ERROR', 'Attribute name is empty'); + } + + const remove = action.params.remove === true; + + // Resolve attribute value (only if not removing) + let attrValue: JsonValue = null; + if (!remove && action.params.value !== undefined) { + const valueResolved = tryResolveJson(action.params.value, vars); + if (!valueResolved.ok) { + return failed('VALIDATION_ERROR', valueResolved.error); + } + + // Apply template interpolation for string values + attrValue = + typeof valueResolved.value === 'string' + ? interpolateBraces(valueResolved.value, vars) + : valueResolved.value; + } + + // Ensure page is read for element location + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: { tabId } }); + + // Resolve target selector + const targetResolved = await resolveTargetSelector(tabId, action.params.target, vars, frameId); + if (!targetResolved.ok) { + return failed('TARGET_NOT_FOUND', targetResolved.error); + } + + const { selector, frameId: resolvedFrameId } = targetResolved.value; + const frameIds = typeof resolvedFrameId === 'number' ? [resolvedFrameId] : undefined; + + // Execute attribute modification in page context + try { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: 'MAIN', + func: (sel: string, name: string, value: JsonValue, remove: boolean): DomScriptResult => { + try { + const el = document.querySelector(sel); + if (!el) { + // Use special error code to distinguish from script execution errors + return { success: false, error: `[TARGET_NOT_FOUND] Element not found: ${sel}` }; + } + + if (remove) { + el.removeAttribute(name); + } else { + // Convert value to string for setAttribute + const strValue = + value === null || value === undefined + ? '' + : typeof value === 'string' + ? value + : String(value); + el.setAttribute(name, strValue); + } + + return { success: true }; + } catch (e) { + return { success: false, error: e instanceof Error ? e.message : String(e) }; + } + }, + args: [selector, attrName, attrValue, remove], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (!result || typeof result !== 'object') { + return failed('SCRIPT_FAILED', 'setAttribute script returned invalid result'); + } + + const typed = result as DomScriptResult; + if (!typed.success) { + const actionDesc = remove ? 'remove' : 'set'; + // Parse error code from message if present (e.g., "[TARGET_NOT_FOUND] ...") + const errorMsg = typed.error || `Failed to ${actionDesc} attribute "${attrName}"`; + const code = errorMsg.startsWith('[TARGET_NOT_FOUND]') + ? 'TARGET_NOT_FOUND' + : 'SCRIPT_FAILED'; + return failed(code, errorMsg.replace(/^\[TARGET_NOT_FOUND\]\s*/, '')); + } + } catch (e) { + const actionDesc = remove ? 'remove' : 'set'; + return failed( + 'SCRIPT_FAILED', + `Failed to ${actionDesc} attribute "${attrName}": ${e instanceof Error ? e.message : String(e)}`, + ); + } + + maybeLogFallback(ctx, action.id, targetResolved.value); + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/drag.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/drag.ts new file mode 100644 index 00000000..798cf472 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/drag.ts @@ -0,0 +1,249 @@ +/** + * Drag Action Handler + * + * Performs a left-click drag from a start target to an end target. + * + * Features: + * - Locates start/end via shared SelectorLocator (ref + candidates) + * - Executes via chrome_computer with action="left_click_drag" (CDP-based) + * - Uses optional `path` endpoints as a fallback for coordinates + * - Validates element visibility before drag + */ + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok } from '../registry'; +import type { ActionHandler, ElementTarget, Point, VariableStore } from '../types'; +import { + ensureElementVisible, + logSelectorFallback, + selectorLocator, + toSelectorTarget, +} from './common'; + +interface Coordinates { + x: number; + y: number; +} + +/** Check if target has valid selector specification */ +function hasTargetSpec(target: unknown): boolean { + if (!target || typeof target !== 'object') return false; + const t = target as { ref?: unknown; candidates?: unknown }; + const hasRef = typeof t.ref === 'string' && t.ref.trim().length > 0; + const hasCandidates = Array.isArray(t.candidates) && t.candidates.length > 0; + return hasRef || hasCandidates; +} + +/** Check if value is a finite number */ +function isFiniteNumber(v: unknown): v is number { + return typeof v === 'number' && Number.isFinite(v); +} + +/** Extract start/end coordinates from path array */ +function getPathEndpoints( + path: ReadonlyArray | undefined, +): { startCoordinates: Coordinates; endCoordinates: Coordinates } | null { + if (!Array.isArray(path) || path.length < 2) return null; + + const first = path[0]; + const last = path[path.length - 1]; + + if (!first || !last) return null; + if (!isFiniteNumber(first.x) || !isFiniteNumber(first.y)) return null; + if (!isFiniteNumber(last.x) || !isFiniteNumber(last.y)) return null; + + return { + startCoordinates: { x: first.x, y: first.y }, + endCoordinates: { x: last.x, y: last.y }, + }; +} + +/** Extract error text from tool result */ +function extractToolError(result: unknown, fallback: string): string { + const content = (result as { content?: Array<{ text?: string }> })?.content; + return content?.find((c) => typeof c?.text === 'string')?.text || fallback; +} + +/** Locate target and verify visibility */ +async function locateTarget( + tabId: number, + frameId: number | undefined, + target: ElementTarget | undefined, + vars: VariableStore, + role: 'start' | 'end', +): Promise< + | { ok: true; ref?: string; firstCandidateType?: string; resolvedBy?: string } + | { ok: false; error: string; code: 'TARGET_NOT_FOUND' | 'ELEMENT_NOT_VISIBLE' } +> { + if (!target || !hasTargetSpec(target)) { + return { ok: true }; + } + + const { selectorTarget, firstCandidateType } = toSelectorTarget(target, vars); + + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId, + preferRef: false, + }); + + const locatedFrameId = located?.frameId ?? frameId; + const ref = located?.ref ?? selectorTarget.ref; + const resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + + // Verify visibility for freshly located refs + if (located?.ref) { + const visible = await ensureElementVisible(tabId, located.ref, locatedFrameId); + if (!visible) { + return { + ok: false, + error: `Drag ${role} element is not visible`, + code: 'ELEMENT_NOT_VISIBLE', + }; + } + } + + return { ok: true, ref, firstCandidateType, resolvedBy }; +} + +export const dragHandler: ActionHandler<'drag'> = { + type: 'drag', + + validate: (action) => { + const pathEndpoints = getPathEndpoints(action.params.path); + + // If path is present, it must be well-formed + if (action.params.path !== undefined && action.params.path.length > 0 && !pathEndpoints) { + return invalid('path must contain at least two points with finite x/y coordinates'); + } + + const hasStart = hasTargetSpec(action.params.start); + const hasEnd = hasTargetSpec(action.params.end); + const hasPath = !!pathEndpoints; + + // Must have either target spec or path coordinates + if (!hasStart && !hasPath) { + return invalid('Drag start must include a non-empty ref or selector candidates'); + } + if (!hasEnd && !hasPath) { + return invalid('Drag end must include a non-empty ref or selector candidates'); + } + + return ok(); + }, + + describe: (action) => { + const startRef = (action.params.start as { ref?: unknown })?.ref; + const endRef = (action.params.end as { ref?: unknown })?.ref; + + const s = typeof startRef === 'string' && startRef.trim() ? startRef.trim() : ''; + const e = typeof endRef === 'string' && endRef.trim() ? endRef.trim() : ''; + + if (s && e) { + const truncS = s.length > 15 ? s.slice(0, 15) + '...' : s; + const truncE = e.length > 15 ? e.slice(0, 15) + '...' : e; + return `Drag ${truncS} → ${truncE}`; + } + if (s) return `Drag from ${s.length > 20 ? s.slice(0, 20) + '...' : s}`; + if (e) return `Drag to ${e.length > 20 ? e.slice(0, 20) + '...' : e}`; + + const pathEndpoints = getPathEndpoints(action.params.path); + if (pathEndpoints) { + const { startCoordinates, endCoordinates } = pathEndpoints; + return `Drag (${startCoordinates.x},${startCoordinates.y}) → (${endCoordinates.x},${endCoordinates.y})`; + } + + return 'Drag'; + }, + + run: async (ctx, action) => { + const tabId = ctx.tabId; + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for drag action'); + } + + // Ensure element refs are fresh before locating + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: { tabId } }); + + // Get path coordinates as fallback + const pathEndpoints = getPathEndpoints(action.params.path); + const startCoordinates = pathEndpoints?.startCoordinates; + const endCoordinates = pathEndpoints?.endCoordinates; + + // Locate start target + const startResult = await locateTarget( + tabId, + ctx.frameId, + action.params.start, + ctx.vars, + 'start', + ); + if (!startResult.ok) { + return failed(startResult.code, startResult.error); + } + + // Locate end target + const endResult = await locateTarget(tabId, ctx.frameId, action.params.end, ctx.vars, 'end'); + if (!endResult.ok) { + return failed(endResult.code, endResult.error); + } + + // Validate we have at least one way to identify start and end + if (!startResult.ref && !startCoordinates) { + return failed('TARGET_NOT_FOUND', 'Could not resolve drag start (ref or path coordinates)'); + } + if (!endResult.ref && !endCoordinates) { + return failed('TARGET_NOT_FOUND', 'Could not resolve drag end (ref or path coordinates)'); + } + + // Execute drag via chrome_computer tool + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: { + action: 'left_click_drag', + tabId, + startRef: startResult.ref, + ref: endResult.ref, + startCoordinates, + coordinates: endCoordinates, + }, + }); + + if ((res as { isError?: boolean })?.isError) { + return failed('UNKNOWN', extractToolError(res, 'Drag action failed')); + } + + // Log selector fallback after successful execution + const startFallbackUsed = + startResult.resolvedBy && + startResult.firstCandidateType && + startResult.resolvedBy !== 'ref' && + startResult.resolvedBy !== startResult.firstCandidateType; + + if (startFallbackUsed) { + logSelectorFallback( + ctx, + action.id, + `start:${String(startResult.firstCandidateType)}`, + `start:${String(startResult.resolvedBy)}`, + ); + } + + const endFallbackUsed = + endResult.resolvedBy && + endResult.firstCandidateType && + endResult.resolvedBy !== 'ref' && + endResult.resolvedBy !== endResult.firstCandidateType; + + if (endFallbackUsed) { + logSelectorFallback( + ctx, + action.id, + `end:${String(endResult.firstCandidateType)}`, + `end:${String(endResult.resolvedBy)}`, + ); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/extract.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/extract.ts new file mode 100644 index 00000000..519e3252 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/extract.ts @@ -0,0 +1,271 @@ +/** + * Extract Action Handler + * + * Extracts data from the page and stores in variables: + * - selector mode: Extract text/attribute from elements + * - js mode: Execute JavaScript and capture return value + */ + +import { failed, invalid, ok, tryResolveString } from '../registry'; +import type { ActionHandler, BrowserWorld, JsonValue, VariableStore } from '../types'; + +/** Default attribute to extract */ +const DEFAULT_EXTRACT_ATTR = 'textContent'; + +/** + * Execute extraction script in page context + */ +async function executeExtraction( + tabId: number, + frameId: number | undefined, + mode: 'selector' | 'js', + params: { + selector?: string; + attr?: string; + code?: string; + world?: BrowserWorld; + }, +): Promise<{ ok: true; value: JsonValue } | { ok: false; error: string }> { + const frameIds = typeof frameId === 'number' ? [frameId] : undefined; + const world = params.world === 'ISOLATED' ? 'ISOLATED' : 'MAIN'; + + try { + if (mode === 'selector') { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world, + func: (selector: string, attr: string) => { + const el = document.querySelector(selector); + if (!el) { + return { success: false, error: `Element not found: ${selector}` }; + } + + let value: JsonValue; + + // Handle special attribute names + if (attr === 'text' || attr === 'textContent') { + value = el.textContent?.trim() ?? ''; + } else if (attr === 'innerText') { + value = (el as HTMLElement).innerText?.trim() ?? ''; + } else if (attr === 'innerHTML') { + value = el.innerHTML; + } else if (attr === 'outerHTML') { + value = el.outerHTML; + } else if (attr === 'value') { + // For form elements + value = (el as HTMLInputElement).value ?? ''; + } else if (attr === 'checked') { + value = (el as HTMLInputElement).checked ?? false; + } else if (attr === 'href') { + value = (el as HTMLAnchorElement).href ?? el.getAttribute('href') ?? ''; + } else if (attr === 'src') { + value = (el as HTMLImageElement).src ?? el.getAttribute('src') ?? ''; + } else { + // Generic attribute + const attrValue = el.getAttribute(attr); + value = attrValue ?? ''; + } + + return { success: true, value }; + }, + args: [params.selector!, params.attr!], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (!result || typeof result !== 'object') { + return { ok: false, error: 'Extraction script returned invalid result' }; + } + + if (!result.success) { + return { ok: false, error: result.error || 'Extraction failed' }; + } + + return { ok: true, value: result.value as JsonValue }; + } + + // JS mode + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world, + func: (code: string) => { + try { + // Create function and execute + const fn = new Function(code); + const result = fn(); + + // Handle promises + if (result instanceof Promise) { + return result.then( + (value: unknown) => ({ success: true, value }), + (error: Error) => ({ success: false, error: error?.message || String(error) }), + ); + } + + return { success: true, value: result }; + } catch (e) { + return { success: false, error: e instanceof Error ? e.message : String(e) }; + } + }, + args: [params.code!], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + + // Handle async result + if (result instanceof Promise) { + const asyncResult = await result; + if (!asyncResult || typeof asyncResult !== 'object') { + return { ok: false, error: 'Async extraction returned invalid result' }; + } + if (!asyncResult.success) { + return { ok: false, error: asyncResult.error || 'Extraction failed' }; + } + return { ok: true, value: asyncResult.value as JsonValue }; + } + + if (!result || typeof result !== 'object') { + return { ok: false, error: 'Extraction script returned invalid result' }; + } + + const typedResult = result as { success: boolean; value?: unknown; error?: string }; + if (!typedResult.success) { + return { ok: false, error: typedResult.error || 'Extraction failed' }; + } + + return { ok: true, value: typedResult.value as JsonValue }; + } catch (e) { + return { + ok: false, + error: `Script execution failed: ${e instanceof Error ? e.message : String(e)}`, + }; + } +} + +/** + * Resolve extraction parameters + */ +function resolveExtractParams( + params: unknown, + vars: VariableStore, +): { ok: true; mode: 'selector' | 'js'; resolved: ResolvedParams } | { ok: false; error: string } { + const p = params as { + mode: 'selector' | 'js'; + selector?: unknown; + attr?: unknown; + code?: string; + world?: BrowserWorld; + saveAs: string; + }; + + if (p.mode === 'selector') { + const selectorResult = tryResolveString(p.selector as string, vars); + if (!selectorResult.ok) return selectorResult; + const selector = selectorResult.value.trim(); + if (!selector) return { ok: false, error: 'Empty selector' }; + + let attr = DEFAULT_EXTRACT_ATTR; + if (p.attr !== undefined && p.attr !== null) { + const attrResult = tryResolveString(p.attr as string, vars); + if (!attrResult.ok) return attrResult; + attr = attrResult.value.trim() || DEFAULT_EXTRACT_ATTR; + } + + return { + ok: true, + mode: 'selector', + resolved: { selector, attr, saveAs: p.saveAs }, + }; + } + + if (p.mode === 'js') { + if (!p.code || typeof p.code !== 'string') { + return { ok: false, error: 'JS mode requires code string' }; + } + return { + ok: true, + mode: 'js', + resolved: { code: p.code, world: p.world, saveAs: p.saveAs }, + }; + } + + return { ok: false, error: `Unknown extract mode: ${String(p.mode)}` }; +} + +type ResolvedParams = + | { selector: string; attr: string; saveAs: string } + | { code: string; world?: BrowserWorld; saveAs: string }; + +export const extractHandler: ActionHandler<'extract'> = { + type: 'extract', + + validate: (action) => { + const params = action.params as { + mode: string; + selector?: unknown; + code?: string; + saveAs?: string; + }; + + if (params.mode !== 'selector' && params.mode !== 'js') { + return invalid(`Invalid extract mode: ${String(params.mode)}`); + } + + if (!params.saveAs || typeof params.saveAs !== 'string' || params.saveAs.trim().length === 0) { + return invalid('Extract action requires a non-empty saveAs variable name'); + } + + if (params.mode === 'selector' && params.selector === undefined) { + return invalid('Selector mode requires a selector'); + } + + if (params.mode === 'js' && (!params.code || typeof params.code !== 'string')) { + return invalid('JS mode requires a code string'); + } + + return ok(); + }, + + describe: (action) => { + const params = action.params as { mode: string; saveAs?: string }; + const varName = params.saveAs || '?'; + return params.mode === 'js' ? `Extract JS → ${varName}` : `Extract → ${varName}`; + }, + + run: async (ctx, action) => { + const tabId = ctx.tabId; + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for extract action'); + } + + const resolved = resolveExtractParams(action.params, ctx.vars); + if (!resolved.ok) { + return failed('VALIDATION_ERROR', resolved.error); + } + + const extractParams = + resolved.mode === 'selector' + ? { + selector: (resolved.resolved as { selector: string }).selector, + attr: (resolved.resolved as { attr: string }).attr, + } + : { + code: (resolved.resolved as { code: string }).code, + world: (resolved.resolved as { world?: BrowserWorld }).world, + }; + + const result = await executeExtraction(tabId, ctx.frameId, resolved.mode, extractParams); + + if (!result.ok) { + return failed('SCRIPT_FAILED', result.error); + } + + // Store in variables + const saveAs = (resolved.resolved as { saveAs: string }).saveAs; + ctx.vars[saveAs] = result.value; + + return { + status: 'success', + output: { value: result.value }, + }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/fill.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/fill.ts new file mode 100644 index 00000000..ca0bdb19 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/fill.ts @@ -0,0 +1,190 @@ +/** + * Fill Action Handler + * + * Handles form input actions: + * - Text input + * - File upload + * - Auto-scroll and focus + * - Selector fallback with logging + */ + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok } from '../registry'; +import type { ActionHandler } from '../types'; +import { + ensureElementVisible, + logSelectorFallback, + resolveString, + selectorLocator, + sendMessageToTab, + toSelectorTarget, +} from './common'; + +export const fillHandler: ActionHandler<'fill'> = { + type: 'fill', + + validate: (action) => { + const target = action.params.target as { ref?: string; candidates?: unknown[] }; + const hasRef = typeof target?.ref === 'string' && target.ref.trim().length > 0; + const hasCandidates = Array.isArray(target?.candidates) && target.candidates.length > 0; + const hasValue = action.params.value !== undefined; + + if (!hasValue) { + return invalid('Missing value parameter'); + } + if (!hasRef && !hasCandidates) { + return invalid('Missing target selector or ref'); + } + return ok(); + }, + + describe: (action) => { + const value = typeof action.params.value === 'string' ? action.params.value : '(dynamic)'; + const displayValue = value.length > 20 ? value.slice(0, 20) + '...' : value; + return `Fill "${displayValue}"`; + }, + + run: async (ctx, action) => { + const vars = ctx.vars; + const tabId = ctx.tabId; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found'); + } + + // Ensure page is read before locating element + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + + // Resolve fill value + const valueResolved = resolveString(action.params.value, vars); + if (!valueResolved.ok) { + return failed('VALIDATION_ERROR', valueResolved.error); + } + const value = valueResolved.value; + + // Locate target element + const { selectorTarget, firstCandidateType, firstCssOrAttr } = toSelectorTarget( + action.params.target, + vars, + ); + + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId: ctx.frameId, + preferRef: false, + }); + + const frameId = located?.frameId ?? ctx.frameId; + const refToUse = located?.ref ?? selectorTarget.ref; + const cssSelector = !located?.ref ? firstCssOrAttr : undefined; + + if (!refToUse && !cssSelector) { + return failed('TARGET_NOT_FOUND', 'Could not locate target element'); + } + + // Verify element visibility if we have a ref + if (located?.ref) { + const isVisible = await ensureElementVisible(tabId, located.ref, frameId); + if (!isVisible) { + return failed('ELEMENT_NOT_VISIBLE', 'Target element is not visible'); + } + } + + // Check for file input and handle file upload + // Use firstCssOrAttr to check input type even when ref is available + const selectorForTypeCheck = firstCssOrAttr || cssSelector; + if (selectorForTypeCheck) { + const attrResult = await sendMessageToTab<{ value?: string }>( + tabId, + { action: 'getAttributeForSelector', selector: selectorForTypeCheck, name: 'type' }, + frameId, + ); + const inputType = (attrResult.ok ? (attrResult.value?.value ?? '') : '').toLowerCase(); + + if (inputType === 'file') { + const uploadResult = await handleCallTool({ + name: TOOL_NAMES.BROWSER.FILE_UPLOAD, + args: { selector: selectorForTypeCheck, filePath: value, tabId }, + }); + + if ((uploadResult as { isError?: boolean })?.isError) { + const errorContent = (uploadResult as { content?: Array<{ text?: string }> })?.content; + const errorMsg = errorContent?.[0]?.text || 'File upload failed'; + return failed('UNKNOWN', errorMsg); + } + + // Log fallback if used + const resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + const fallbackUsed = + resolvedBy && + firstCandidateType && + resolvedBy !== 'ref' && + resolvedBy !== firstCandidateType; + if (fallbackUsed) { + logSelectorFallback(ctx, action.id, String(firstCandidateType), String(resolvedBy)); + } + + return { status: 'success' }; + } + } + + // Scroll element into view (best-effort) + if (cssSelector) { + try { + await handleCallTool({ + name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + args: { + type: 'MAIN', + jsScript: `try{var el=document.querySelector(${JSON.stringify(cssSelector)});if(el){el.scrollIntoView({behavior:'instant',block:'center',inline:'nearest'});}}catch(e){}`, + tabId, + }, + }); + } catch { + // Ignore scroll errors + } + } + + // Focus element (best-effort, ignore errors) + if (located?.ref) { + await sendMessageToTab(tabId, { action: 'focusByRef', ref: located.ref }, frameId); + } else if (cssSelector) { + await handleCallTool({ + name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + args: { + type: 'MAIN', + jsScript: `try{var el=document.querySelector(${JSON.stringify(cssSelector)});if(el&&el.focus){el.focus();}}catch(e){}`, + tabId, + }, + }); + } + + // Execute fill + const fillResult = await handleCallTool({ + name: TOOL_NAMES.BROWSER.FILL, + args: { + ref: refToUse, + selector: cssSelector, + value, + frameId, + tabId, + }, + }); + + if ((fillResult as { isError?: boolean })?.isError) { + const errorContent = (fillResult as { content?: Array<{ text?: string }> })?.content; + const errorMsg = errorContent?.[0]?.text || 'Fill action failed'; + return failed('UNKNOWN', errorMsg); + } + + // Log fallback if used + const resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + const fallbackUsed = + resolvedBy && firstCandidateType && resolvedBy !== 'ref' && resolvedBy !== firstCandidateType; + + if (fallbackUsed) { + logSelectorFallback(ctx, action.id, String(firstCandidateType), String(resolvedBy)); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/http.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/http.ts new file mode 100644 index 00000000..a4256af6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/http.ts @@ -0,0 +1,361 @@ +/** + * HTTP Action Handler + * + * Makes HTTP requests from the extension context. + * Supports: + * - All common HTTP methods (GET, POST, PUT, PATCH, DELETE) + * - JSON and text body types + * - Form data + * - Custom headers + * - Response validation + * - Result capture to variables + */ + +import { failed, invalid, ok, tryResolveString, tryResolveValue } from '../registry'; +import type { + ActionHandler, + Assignments, + HttpBody, + HttpHeaders, + HttpFormData, + HttpMethod, + HttpOkStatus, + HttpResponse, + JsonValue, + Resolvable, + VariableStore, +} from '../types'; + +/** Default timeout for HTTP requests */ +const DEFAULT_HTTP_TIMEOUT_MS = 30000; + +/** Maximum URL length */ +const MAX_URL_LENGTH = 8192; + +/** + * Resolve HTTP headers + */ +async function resolveHeaders( + headers: HttpHeaders | undefined, + vars: VariableStore, +): Promise<{ ok: true; resolved: Record } | { ok: false; error: string }> { + if (!headers) return { ok: true, resolved: {} }; + + const resolved: Record = {}; + for (const [key, resolvable] of Object.entries(headers)) { + const result = tryResolveString(resolvable, vars); + if (!result.ok) { + return { ok: false, error: `Failed to resolve header "${key}": ${result.error}` }; + } + resolved[key] = result.value; + } + + return { ok: true, resolved }; +} + +/** + * Resolve form data + */ +async function resolveFormData( + formData: HttpFormData | undefined, + vars: VariableStore, +): Promise<{ ok: true; resolved: Record } | { ok: false; error: string }> { + if (!formData) return { ok: true, resolved: {} }; + + const resolved: Record = {}; + for (const [key, resolvable] of Object.entries(formData)) { + const result = tryResolveString(resolvable, vars); + if (!result.ok) { + return { ok: false, error: `Failed to resolve form field "${key}": ${result.error}` }; + } + resolved[key] = result.value; + } + + return { ok: true, resolved }; +} + +/** + * Resolve HTTP body + */ +async function resolveBody( + body: HttpBody | undefined, + vars: VariableStore, +): Promise< + | { ok: true; contentType: string | undefined; data: string | undefined } + | { ok: false; error: string } +> { + if (!body || body.kind === 'none') { + return { ok: true, contentType: undefined, data: undefined }; + } + + if (body.kind === 'text') { + const textResult = tryResolveString(body.text, vars); + if (!textResult.ok) { + return { ok: false, error: `Failed to resolve body text: ${textResult.error}` }; + } + + let contentType = 'text/plain'; + if (body.contentType) { + const ctResult = tryResolveString(body.contentType, vars); + if (!ctResult.ok) { + return { ok: false, error: `Failed to resolve content type: ${ctResult.error}` }; + } + contentType = ctResult.value; + } + + return { ok: true, contentType, data: textResult.value }; + } + + if (body.kind === 'json') { + const jsonResult = tryResolveValue(body.json, vars); + if (!jsonResult.ok) { + return { ok: false, error: `Failed to resolve JSON body: ${jsonResult.error}` }; + } + + return { + ok: true, + contentType: 'application/json', + data: JSON.stringify(jsonResult.value), + }; + } + + return { ok: false, error: `Unknown body kind: ${(body as { kind: string }).kind}` }; +} + +/** + * Check if status code is considered successful + */ +function isStatusOk(status: number, okStatus: HttpOkStatus | undefined): boolean { + if (!okStatus) { + // Default: 2xx is OK + return status >= 200 && status < 300; + } + + if (okStatus.kind === 'range') { + return status >= okStatus.min && status <= okStatus.max; + } + + if (okStatus.kind === 'list') { + return okStatus.statuses.includes(status); + } + + return false; +} + +/** + * Get value from result using dot/bracket path notation + */ +function getValueByPath(obj: unknown, path: string): JsonValue | undefined { + if (!path || typeof obj !== 'object' || obj === null) { + return obj as JsonValue; + } + + const segments: Array = []; + const pathRegex = /([^.[\]]+)|\[(\d+)\]/g; + let match: RegExpExecArray | null; + + while ((match = pathRegex.exec(path)) !== null) { + if (match[1]) { + segments.push(match[1]); + } else if (match[2]) { + segments.push(parseInt(match[2], 10)); + } + } + + let current: unknown = obj; + for (const segment of segments) { + if (current === null || current === undefined) return undefined; + if (typeof current !== 'object') return undefined; + current = (current as Record)[segment]; + } + + return current as JsonValue; +} + +/** + * Apply assignments from response to variables + */ +function applyAssignments( + response: HttpResponse, + assignments: Assignments, + vars: VariableStore, +): void { + for (const [varName, path] of Object.entries(assignments)) { + const value = getValueByPath(response, path); + if (value !== undefined) { + vars[varName] = value; + } + } +} + +export const httpHandler: ActionHandler<'http'> = { + type: 'http', + + validate: (action) => { + const params = action.params; + + if (params.url === undefined) { + return invalid('HTTP action requires a URL'); + } + + if (params.method !== undefined) { + const validMethods: HttpMethod[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']; + if (!validMethods.includes(params.method)) { + return invalid(`Invalid HTTP method: ${String(params.method)}`); + } + } + + return ok(); + }, + + describe: (action) => { + const method = action.params.method || 'GET'; + const url = typeof action.params.url === 'string' ? action.params.url : '(dynamic)'; + const displayUrl = url.length > 40 ? url.slice(0, 40) + '...' : url; + return `${method} ${displayUrl}`; + }, + + run: async (ctx, action) => { + const params = action.params; + const method: HttpMethod = params.method || 'GET'; + + // Resolve URL + const urlResult = tryResolveString(params.url, ctx.vars); + if (!urlResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve URL: ${urlResult.error}`); + } + + const url = urlResult.value.trim(); + if (!url) { + return failed('VALIDATION_ERROR', 'URL is empty'); + } + + if (url.length > MAX_URL_LENGTH) { + return failed('VALIDATION_ERROR', `URL exceeds maximum length of ${MAX_URL_LENGTH}`); + } + + // Validate URL format + try { + new URL(url); + } catch { + return failed('VALIDATION_ERROR', `Invalid URL format: ${url}`); + } + + // Resolve headers + const headersResult = await resolveHeaders(params.headers, ctx.vars); + if (!headersResult.ok) { + return failed('VALIDATION_ERROR', headersResult.error); + } + + // Resolve body + const bodyResult = await resolveBody(params.body, ctx.vars); + if (!bodyResult.ok) { + return failed('VALIDATION_ERROR', bodyResult.error); + } + + // Resolve form data (alternative to body) + const formDataResult = await resolveFormData(params.formData, ctx.vars); + if (!formDataResult.ok) { + return failed('VALIDATION_ERROR', formDataResult.error); + } + + // Build request + const headers: Record = { ...headersResult.resolved }; + let requestBody: string | FormData | undefined; + + if (Object.keys(formDataResult.resolved).length > 0) { + // Use form data + const formData = new FormData(); + for (const [key, value] of Object.entries(formDataResult.resolved)) { + formData.append(key, value); + } + requestBody = formData as unknown as string; // FormData handled by fetch + } else if (bodyResult.data !== undefined) { + // Use body + requestBody = bodyResult.data; + if (bodyResult.contentType && !headers['Content-Type']) { + headers['Content-Type'] = bodyResult.contentType; + } + } + + // Execute request + const timeoutMs = action.policy?.timeout?.ms ?? DEFAULT_HTTP_TIMEOUT_MS; + const controller = new AbortController(); + const timeoutId = setTimeout(() => controller.abort(), timeoutMs); + + try { + const fetchOptions: RequestInit = { + method, + headers, + signal: controller.signal, + }; + + if (requestBody !== undefined && method !== 'GET' && method !== 'DELETE') { + fetchOptions.body = requestBody; + } + + const response = await fetch(url, fetchOptions); + clearTimeout(timeoutId); + + // Parse response + const responseHeaders: Record = {}; + response.headers.forEach((value, key) => { + responseHeaders[key] = value; + }); + + let responseBody: JsonValue | string | null = null; + const contentType = response.headers.get('content-type') || ''; + + try { + if (contentType.includes('application/json')) { + responseBody = (await response.json()) as JsonValue; + } else { + responseBody = await response.text(); + } + } catch { + responseBody = null; + } + + const httpResponse: HttpResponse = { + url: response.url, + status: response.status, + headers: responseHeaders, + body: responseBody, + }; + + // Check status + if (!isStatusOk(response.status, params.okStatus)) { + return failed( + 'NETWORK_REQUEST_FAILED', + `HTTP ${response.status}: ${response.statusText || 'Request failed'}`, + ); + } + + // Store response if saveAs specified + if (params.saveAs) { + ctx.vars[params.saveAs] = httpResponse as unknown as JsonValue; + } + + // Apply assignments + if (params.assign) { + applyAssignments(httpResponse, params.assign, ctx.vars); + } + + return { + status: 'success', + output: { response: httpResponse }, + }; + } catch (e) { + clearTimeout(timeoutId); + + if (e instanceof Error && e.name === 'AbortError') { + return failed('TIMEOUT', `HTTP request timed out after ${timeoutMs}ms`); + } + + return failed( + 'NETWORK_REQUEST_FAILED', + `HTTP request failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/index.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/index.ts new file mode 100644 index 00000000..e14feaae --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/index.ts @@ -0,0 +1,164 @@ +/** + * Action Handlers Registry + * + * Central registration point for all action handlers. + * Provides factory function to create a fully-configured ActionRegistry + * with all replay handlers registered. + */ + +import { ActionRegistry, createActionRegistry } from '../registry'; +import { assertHandler } from './assert'; +import { clickHandler, dblclickHandler } from './click'; +import { foreachHandler, ifHandler, switchFrameHandler, whileHandler } from './control-flow'; +import { delayHandler } from './delay'; +import { setAttributeHandler, triggerEventHandler } from './dom'; +import { dragHandler } from './drag'; +import { extractHandler } from './extract'; +import { fillHandler } from './fill'; +import { httpHandler } from './http'; +import { keyHandler } from './key'; +import { navigateHandler } from './navigate'; +import { screenshotHandler } from './screenshot'; +import { scriptHandler } from './script'; +import { scrollHandler } from './scroll'; +import { closeTabHandler, handleDownloadHandler, openTabHandler, switchTabHandler } from './tabs'; +import { waitHandler } from './wait'; + +// Re-export individual handlers for direct access +export { assertHandler } from './assert'; +export { clickHandler, dblclickHandler } from './click'; +export { foreachHandler, ifHandler, switchFrameHandler, whileHandler } from './control-flow'; +export { delayHandler } from './delay'; +export { setAttributeHandler, triggerEventHandler } from './dom'; +export { dragHandler } from './drag'; +export { extractHandler } from './extract'; +export { fillHandler } from './fill'; +export { httpHandler } from './http'; +export { keyHandler } from './key'; +export { navigateHandler } from './navigate'; +export { screenshotHandler } from './screenshot'; +export { scriptHandler } from './script'; +export { scrollHandler } from './scroll'; +export { closeTabHandler, handleDownloadHandler, openTabHandler, switchTabHandler } from './tabs'; +export { waitHandler } from './wait'; + +// Re-export common utilities +export * from './common'; + +/** + * All available action handlers for replay + * + * Organized by category: + * - Navigation: navigate + * - Interaction: click, dblclick, fill, key, scroll, drag + * - Timing: wait, delay + * - Validation: assert + * - Data: extract, script, http, screenshot + * - DOM Tools: triggerEvent, setAttribute + * - Tabs: openTab, switchTab, closeTab, handleDownload + * - Control Flow: if, foreach, while, switchFrame + * + * TODO: Add remaining handlers: + * - loopElements, executeFlow (advanced control flow) + */ +const ALL_HANDLERS = [ + // Navigation + navigateHandler, + // Interaction + clickHandler, + dblclickHandler, + fillHandler, + keyHandler, + scrollHandler, + dragHandler, + // Timing + waitHandler, + delayHandler, + // Validation + assertHandler, + // Data + extractHandler, + scriptHandler, + httpHandler, + screenshotHandler, + // DOM Tools + triggerEventHandler, + setAttributeHandler, + // Tabs + openTabHandler, + switchTabHandler, + closeTabHandler, + handleDownloadHandler, + // Control Flow + ifHandler, + foreachHandler, + whileHandler, + switchFrameHandler, +] as const; + +/** + * Register all replay handlers to an ActionRegistry instance + */ +export function registerReplayHandlers(registry: ActionRegistry): void { + // Register each handler individually to satisfy TypeScript's type checker + registry.register(navigateHandler, { override: true }); + registry.register(clickHandler, { override: true }); + registry.register(dblclickHandler, { override: true }); + registry.register(fillHandler, { override: true }); + registry.register(keyHandler, { override: true }); + registry.register(scrollHandler, { override: true }); + registry.register(dragHandler, { override: true }); + registry.register(waitHandler, { override: true }); + registry.register(delayHandler, { override: true }); + registry.register(assertHandler, { override: true }); + registry.register(extractHandler, { override: true }); + registry.register(scriptHandler, { override: true }); + registry.register(httpHandler, { override: true }); + registry.register(screenshotHandler, { override: true }); + registry.register(triggerEventHandler, { override: true }); + registry.register(setAttributeHandler, { override: true }); + registry.register(openTabHandler, { override: true }); + registry.register(switchTabHandler, { override: true }); + registry.register(closeTabHandler, { override: true }); + registry.register(handleDownloadHandler, { override: true }); + registry.register(ifHandler, { override: true }); + registry.register(foreachHandler, { override: true }); + registry.register(whileHandler, { override: true }); + registry.register(switchFrameHandler, { override: true }); +} + +/** + * Create a new ActionRegistry with all replay handlers registered + * + * This is the primary entry point for creating an action execution context. + * + * @example + * ```ts + * const registry = createReplayActionRegistry(); + * + * const result = await registry.execute(ctx, { + * id: 'action-1', + * type: 'click', + * params: { target: { candidates: [...] } }, + * }); + * ``` + */ +export function createReplayActionRegistry(): ActionRegistry { + const registry = createActionRegistry(); + registerReplayHandlers(registry); + return registry; +} + +/** + * Get list of supported action types + */ +export function getSupportedActionTypes(): ReadonlyArray { + return ALL_HANDLERS.map((h) => h.type); +} + +/** + * Check if an action type is supported + */ +export function isActionTypeSupported(type: string): boolean { + return ALL_HANDLERS.some((h) => h.type === type); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/key.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/key.ts new file mode 100644 index 00000000..7f446d77 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/key.ts @@ -0,0 +1,196 @@ +/** + * Key Action Handler + * + * Handles keyboard input: + * - Resolves key sequences via variables/templates + * - Optionally focuses a target element before sending keys + * - Dispatches keyboard events via the keyboard tool + */ + +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok } from '../registry'; +import type { ActionHandler, ElementTarget } from '../types'; +import { + ensureElementVisible, + logSelectorFallback, + resolveString, + selectorLocator, + sendMessageToTab, + toSelectorTarget, +} from './common'; + +/** Extract error text from tool result */ +function extractToolError(result: unknown, fallback: string): string { + const content = (result as { content?: Array<{ text?: string }> })?.content; + return content?.find((c) => typeof c?.text === 'string')?.text || fallback; +} + +/** Check if target has valid selector specification */ +function hasTargetSpec(target: unknown): boolean { + if (!target || typeof target !== 'object') return false; + const t = target as { ref?: unknown; candidates?: unknown }; + const hasRef = typeof t.ref === 'string' && t.ref.trim().length > 0; + const hasCandidates = Array.isArray(t.candidates) && t.candidates.length > 0; + return hasRef || hasCandidates; +} + +/** Strip frame prefix from composite selector */ +function stripCompositeSelector(selector: string): string { + const raw = String(selector || '').trim(); + if (!raw || !raw.includes('|>')) return raw; + const parts = raw + .split('|>') + .map((p) => p.trim()) + .filter(Boolean); + return parts.length > 0 ? parts[parts.length - 1] : raw; +} + +export const keyHandler: ActionHandler<'key'> = { + type: 'key', + + validate: (action) => { + if (action.params.keys === undefined) { + return invalid('Missing keys parameter'); + } + + if (action.params.target !== undefined && !hasTargetSpec(action.params.target)) { + return invalid('Target must include a non-empty ref or selector candidates'); + } + + return ok(); + }, + + describe: (action) => { + const keys = typeof action.params.keys === 'string' ? action.params.keys : '(dynamic)'; + const display = keys.length > 30 ? keys.slice(0, 30) + '...' : keys; + return `Keys "${display}"`; + }, + + run: async (ctx, action) => { + const vars = ctx.vars; + const tabId = ctx.tabId; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for key action'); + } + + // Resolve keys string + const keysResolved = resolveString(action.params.keys, vars); + if (!keysResolved.ok) { + return failed('VALIDATION_ERROR', keysResolved.error); + } + + const keys = keysResolved.value.trim(); + if (!keys) { + return failed('VALIDATION_ERROR', 'Keys string is empty'); + } + + let frameId = ctx.frameId; + let selectorForTool: string | undefined; + let firstCandidateType: string | undefined; + let resolvedBy: string | undefined; + + // Handle optional target focusing + const target = action.params.target as ElementTarget | undefined; + if (target) { + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: { tabId } }); + + const { + selectorTarget, + firstCandidateType: firstType, + firstCssOrAttr, + } = toSelectorTarget(target, vars); + firstCandidateType = firstType; + + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId: ctx.frameId, + preferRef: false, + }); + + frameId = located?.frameId ?? ctx.frameId; + const refToUse = located?.ref ?? selectorTarget.ref; + + if (!refToUse && !firstCssOrAttr) { + return failed('TARGET_NOT_FOUND', 'Could not locate target element for key action'); + } + + resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + + // Only verify visibility for freshly located refs (not stale refs from payload) + if (located?.ref) { + const visible = await ensureElementVisible(tabId, located.ref, frameId); + if (!visible) { + return failed('ELEMENT_NOT_VISIBLE', 'Target element is not visible'); + } + + const focusResult = await sendMessageToTab<{ success?: boolean; error?: string }>( + tabId, + { action: 'focusByRef', ref: located.ref }, + frameId, + ); + + if (!focusResult.ok || focusResult.value?.success !== true) { + const focusErr = focusResult.ok ? focusResult.value?.error : focusResult.error; + + if (!firstCssOrAttr) { + return failed( + 'TARGET_NOT_FOUND', + `Failed to focus target element: ${focusErr || 'ref may be stale'}`, + ); + } + + ctx.log(`focusByRef failed; falling back to selector: ${focusErr}`, 'warn'); + } + + // Try to resolve ref to CSS selector for tool + const resolved = await sendMessageToTab<{ + success?: boolean; + selector?: string; + error?: string; + }>(tabId, { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref: located.ref }, frameId); + + if ( + resolved.ok && + resolved.value?.success !== false && + typeof resolved.value?.selector === 'string' + ) { + const sel = resolved.value.selector.trim(); + if (sel) selectorForTool = sel; + } + } + + // Fallback to CSS/attr selector + if (!selectorForTool && firstCssOrAttr) { + const stripped = stripCompositeSelector(firstCssOrAttr); + if (stripped) selectorForTool = stripped; + } + } + + // Execute keyboard input + const keyboardResult = await handleCallTool({ + name: TOOL_NAMES.BROWSER.KEYBOARD, + args: { + keys, + selector: selectorForTool, + selectorType: selectorForTool ? 'css' : undefined, + tabId, + frameId, + }, + }); + + if ((keyboardResult as { isError?: boolean })?.isError) { + return failed('UNKNOWN', extractToolError(keyboardResult, 'Keyboard input failed')); + } + + // Log fallback after successful execution + const fallbackUsed = + resolvedBy && firstCandidateType && resolvedBy !== 'ref' && resolvedBy !== firstCandidateType; + if (fallbackUsed) { + logSelectorFallback(ctx, action.id, String(firstCandidateType), String(resolvedBy)); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/navigate.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/navigate.ts new file mode 100644 index 00000000..0a2c9749 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/navigate.ts @@ -0,0 +1,104 @@ +/** + * Navigate Action Handler + * + * Handles page navigation actions: + * - Navigate to URL + * - Page refresh + * - Wait for navigation completion + */ + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { ENGINE_CONSTANTS } from '../../engine/constants'; +import { ensureReadPageIfWeb, waitForNavigationDone } from '../../engine/policies/wait'; +import { failed, invalid, ok } from '../registry'; +import type { ActionHandler } from '../types'; +import { clampInt, readTabUrl, resolveString } from './common'; + +export const navigateHandler: ActionHandler<'navigate'> = { + type: 'navigate', + + validate: (action) => { + const hasRefresh = action.params.refresh === true; + const hasUrl = action.params.url !== undefined; + return hasRefresh || hasUrl ? ok() : invalid('Missing url or refresh parameter'); + }, + + describe: (action) => { + if (action.params.refresh) return 'Refresh page'; + const url = typeof action.params.url === 'string' ? action.params.url : '(dynamic)'; + return `Navigate to ${url}`; + }, + + run: async (ctx, action) => { + const vars = ctx.vars; + const tabId = ctx.tabId; + // Check if StepRunner owns nav-wait (skip internal nav-wait logic) + const skipNavWait = ctx.execution?.skipNavWait === true; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found'); + } + + // Only read beforeUrl and calculate waitMs if we need to do nav-wait + const beforeUrl = skipNavWait ? '' : await readTabUrl(tabId); + const waitMs = skipNavWait + ? 0 + : clampInt( + action.policy?.timeout?.ms ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, + 0, + ENGINE_CONSTANTS.MAX_WAIT_MS, + ); + + // Handle page refresh + if (action.params.refresh) { + const result = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NAVIGATE, + args: { refresh: true, tabId }, + }); + + if ((result as { isError?: boolean })?.isError) { + const errorContent = (result as { content?: Array<{ text?: string }> })?.content; + const errorMsg = errorContent?.[0]?.text || 'Page refresh failed'; + return failed('NAVIGATION_FAILED', errorMsg); + } + + // Skip nav-wait if StepRunner handles it + if (!skipNavWait) { + await waitForNavigationDone(beforeUrl, waitMs); + await ensureReadPageIfWeb(); + } + return { status: 'success' }; + } + + // Handle URL navigation + const urlResolved = resolveString(action.params.url, vars); + if (!urlResolved.ok) { + return failed('VALIDATION_ERROR', urlResolved.error); + } + + const url = urlResolved.value.trim(); + if (!url) { + return failed('VALIDATION_ERROR', 'URL is empty'); + } + + const result = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NAVIGATE, + args: { url, tabId }, + }); + + if ((result as { isError?: boolean })?.isError) { + const errorContent = (result as { content?: Array<{ text?: string }> })?.content; + const errorMsg = errorContent?.[0]?.text || `Navigation to ${url} failed`; + return failed('NAVIGATION_FAILED', errorMsg); + } + + // Skip nav-wait if StepRunner handles it + if (!skipNavWait) { + await waitForNavigationDone(beforeUrl, waitMs); + await ensureReadPageIfWeb(); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/screenshot.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/screenshot.ts new file mode 100644 index 00000000..af2b4b9a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/screenshot.ts @@ -0,0 +1,101 @@ +/** + * Screenshot Action Handler + * + * Captures screenshots and optionally stores base64 data in variables. + * Supports full page, selector-based, and viewport screenshots. + */ + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok } from '../registry'; +import type { ActionHandler } from '../types'; +import { resolveString } from './common'; + +/** Extract text content from tool result */ +function extractToolText(result: unknown): string | undefined { + const content = (result as { content?: Array<{ type?: string; text?: string }> })?.content; + const text = content?.find((c) => c?.type === 'text' && typeof c.text === 'string')?.text; + return typeof text === 'string' && text.trim() ? text : undefined; +} + +export const screenshotHandler: ActionHandler<'screenshot'> = { + type: 'screenshot', + + validate: (action) => { + const saveAs = action.params.saveAs; + if (saveAs !== undefined && (!saveAs || String(saveAs).trim().length === 0)) { + return invalid('saveAs must be a non-empty variable name when provided'); + } + return ok(); + }, + + describe: (action) => { + if (action.params.fullPage) return 'Screenshot (full page)'; + if (typeof action.params.selector === 'string') { + const sel = + action.params.selector.length > 30 + ? action.params.selector.slice(0, 30) + '...' + : action.params.selector; + return `Screenshot: ${sel}`; + } + if (action.params.selector) return 'Screenshot (dynamic selector)'; + return 'Screenshot'; + }, + + run: async (ctx, action) => { + const tabId = ctx.tabId; + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for screenshot action'); + } + + // Resolve optional selector + let selector: string | undefined; + if (action.params.selector !== undefined) { + const resolved = resolveString(action.params.selector, ctx.vars); + if (!resolved.ok) return failed('VALIDATION_ERROR', resolved.error); + const s = resolved.value.trim(); + if (s) selector = s; + } + + // Call screenshot tool + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.SCREENSHOT, + args: { + name: 'workflow', + storeBase64: true, + fullPage: action.params.fullPage === true, + selector, + tabId, + }, + }); + + if ((res as { isError?: boolean })?.isError) { + return failed('UNKNOWN', extractToolText(res) || 'Screenshot failed'); + } + + // Parse response + const text = extractToolText(res); + if (!text) { + return failed('UNKNOWN', 'Screenshot tool returned an empty response'); + } + + let payload: unknown; + try { + payload = JSON.parse(text); + } catch { + return failed('UNKNOWN', 'Screenshot tool returned invalid JSON'); + } + + const base64Data = (payload as { base64Data?: unknown })?.base64Data; + if (typeof base64Data !== 'string' || base64Data.length === 0) { + return failed('UNKNOWN', 'Screenshot tool returned empty base64Data'); + } + + // Store in variables if saveAs specified + if (action.params.saveAs) { + ctx.vars[action.params.saveAs] = base64Data; + } + + return { status: 'success', output: { base64Data } }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/script.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/script.ts new file mode 100644 index 00000000..6908e5d5 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/script.ts @@ -0,0 +1,237 @@ +/** + * Script Action Handler + * + * Executes custom JavaScript in the page context. + * Supports: + * - MAIN or ISOLATED world execution + * - Argument passing with variable resolution + * - Result capture to variables + * - Assignment mapping from result paths + */ + +import { failed, invalid, ok, tryResolveValue } from '../registry'; +import type { + ActionHandler, + Assignments, + BrowserWorld, + JsonValue, + Resolvable, + VariableStore, +} from '../types'; + +/** Maximum code length to prevent abuse */ +const MAX_CODE_LENGTH = 100000; + +/** + * Resolve script arguments + */ +function resolveArgs( + args: Record> | undefined, + vars: VariableStore, +): { ok: true; resolved: Record } | { ok: false; error: string } { + if (!args) return { ok: true, resolved: {} }; + + const resolved: Record = {}; + for (const [key, resolvable] of Object.entries(args)) { + const result = tryResolveValue(resolvable, vars); + if (!result.ok) { + return { ok: false, error: `Failed to resolve arg "${key}": ${result.error}` }; + } + resolved[key] = result.value; + } + + return { ok: true, resolved }; +} + +/** + * Get value from result using dot/bracket path notation + */ +function getValueByPath(obj: unknown, path: string): JsonValue | undefined { + if (!path || typeof obj !== 'object' || obj === null) { + return obj as JsonValue; + } + + // Parse path: supports "data.items[0].name" style + const segments: Array = []; + const pathRegex = /([^.[\]]+)|\[(\d+)\]/g; + let match: RegExpExecArray | null; + + while ((match = pathRegex.exec(path)) !== null) { + if (match[1]) { + segments.push(match[1]); + } else if (match[2]) { + segments.push(parseInt(match[2], 10)); + } + } + + let current: unknown = obj; + for (const segment of segments) { + if (current === null || current === undefined) return undefined; + if (typeof current !== 'object') return undefined; + current = (current as Record)[segment]; + } + + return current as JsonValue; +} + +/** + * Apply assignments from result to variables + */ +function applyAssignments(result: JsonValue, assignments: Assignments, vars: VariableStore): void { + for (const [varName, path] of Object.entries(assignments)) { + const value = getValueByPath(result, path); + if (value !== undefined) { + vars[varName] = value; + } + } +} + +/** + * Execute script in page context + */ +async function executeScript( + tabId: number, + frameId: number | undefined, + code: string, + args: Record, + world: BrowserWorld, +): Promise<{ ok: true; result: JsonValue } | { ok: false; error: string }> { + const frameIds = typeof frameId === 'number' ? [frameId] : undefined; + + try { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: world === 'ISOLATED' ? 'ISOLATED' : 'MAIN', + func: (scriptCode: string, scriptArgs: Record) => { + try { + // Create function with args available + const argNames = Object.keys(scriptArgs); + const argValues = Object.values(scriptArgs); + + // Wrap code to return result + const wrappedCode = ` + return (function(${argNames.join(', ')}) { + ${scriptCode} + })(${argNames.map((_, i) => `arguments[${i}]`).join(', ')}); + `; + + const fn = new Function(...argNames, wrappedCode); + const result = fn(...argValues); + + // Handle promises + if (result instanceof Promise) { + return result.then( + (value: unknown) => ({ success: true, result: value }), + (error: Error) => ({ success: false, error: error?.message || String(error) }), + ); + } + + return { success: true, result }; + } catch (e) { + return { success: false, error: e instanceof Error ? e.message : String(e) }; + } + }, + args: [code, args], + }); + + const scriptResult = Array.isArray(injected) ? injected[0]?.result : undefined; + + // Handle async result + if (scriptResult instanceof Promise) { + const asyncResult = await scriptResult; + if (!asyncResult || typeof asyncResult !== 'object') { + return { ok: false, error: 'Async script returned invalid result' }; + } + if (!asyncResult.success) { + return { ok: false, error: asyncResult.error || 'Script failed' }; + } + return { ok: true, result: asyncResult.result as JsonValue }; + } + + if (!scriptResult || typeof scriptResult !== 'object') { + return { ok: false, error: 'Script returned invalid result' }; + } + + const typedResult = scriptResult as { success: boolean; result?: unknown; error?: string }; + if (!typedResult.success) { + return { ok: false, error: typedResult.error || 'Script failed' }; + } + + return { ok: true, result: typedResult.result as JsonValue }; + } catch (e) { + return { + ok: false, + error: `Script execution failed: ${e instanceof Error ? e.message : String(e)}`, + }; + } +} + +export const scriptHandler: ActionHandler<'script'> = { + type: 'script', + + validate: (action) => { + const params = action.params; + + if (!params.code || typeof params.code !== 'string') { + return invalid('Script action requires a code string'); + } + + if (params.code.length > MAX_CODE_LENGTH) { + return invalid(`Script code exceeds maximum length of ${MAX_CODE_LENGTH} characters`); + } + + if (params.world !== undefined && params.world !== 'MAIN' && params.world !== 'ISOLATED') { + return invalid(`Invalid world: ${String(params.world)}`); + } + + if (params.when !== undefined && params.when !== 'before' && params.when !== 'after') { + return invalid(`Invalid timing: ${String(params.when)}`); + } + + return ok(); + }, + + describe: (action) => { + const world = action.params.world === 'ISOLATED' ? '[isolated]' : ''; + const timing = action.params.when ? `(${action.params.when})` : ''; + return `Script ${world}${timing}`.trim(); + }, + + run: async (ctx, action) => { + const tabId = ctx.tabId; + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for script action'); + } + + const params = action.params; + const world: BrowserWorld = params.world || 'MAIN'; + + // Resolve arguments + const argsResult = resolveArgs(params.args, ctx.vars); + if (!argsResult.ok) { + return failed('VALIDATION_ERROR', argsResult.error); + } + + // Execute script + const result = await executeScript(tabId, ctx.frameId, params.code, argsResult.resolved, world); + + if (!result.ok) { + return failed('SCRIPT_FAILED', result.error); + } + + // Store result if saveAs specified + if (params.saveAs) { + ctx.vars[params.saveAs] = result.result; + } + + // Apply assignments if specified + if (params.assign) { + applyAssignments(result.result, params.assign, ctx.vars); + } + + return { + status: 'success', + output: { result: result.result }, + }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/scroll.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/scroll.ts new file mode 100644 index 00000000..a1969e16 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/scroll.ts @@ -0,0 +1,260 @@ +/** + * Scroll Action Handler + * + * Supports three scroll modes: + * - offset: Scroll the window to absolute coordinates + * - element: Scroll an element into view + * - container: Scroll within a container element + */ + +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { failed, invalid, ok, tryResolveNumber } from '../registry'; +import type { ActionHandler, ElementTarget } from '../types'; +import { logSelectorFallback, selectorLocator, sendMessageToTab, toSelectorTarget } from './common'; + +/** Check if target has valid selector specification */ +function hasTargetSpec(target: unknown): boolean { + if (!target || typeof target !== 'object') return false; + const t = target as { ref?: unknown; candidates?: unknown }; + const hasRef = typeof t.ref === 'string' && t.ref.trim().length > 0; + const hasCandidates = Array.isArray(t.candidates) && t.candidates.length > 0; + return hasRef || hasCandidates; +} + +/** Strip frame prefix from composite selector */ +function stripCompositeSelector(selector: string): string { + const raw = String(selector || '').trim(); + if (!raw || !raw.includes('|>')) return raw; + const parts = raw + .split('|>') + .map((p) => p.trim()) + .filter(Boolean); + return parts.length > 0 ? parts[parts.length - 1] : raw; +} + +/** Format offset value for description */ +function describeOffset(v: unknown): string { + return typeof v === 'number' && Number.isFinite(v) ? String(v) : '(dynamic)'; +} + +export const scrollHandler: ActionHandler<'scroll'> = { + type: 'scroll', + + validate: (action) => { + const mode = action.params.mode; + if (mode !== 'offset' && mode !== 'element' && mode !== 'container') { + return invalid(`Unsupported scroll mode: ${String(mode)}`); + } + + if ((mode === 'element' || mode === 'container') && !hasTargetSpec(action.params.target)) { + return invalid(`Scroll mode "${mode}" requires a target ref or selector candidates`); + } + + return ok(); + }, + + describe: (action) => { + const mode = action.params.mode; + if (mode === 'offset') { + const x = describeOffset(action.params.offset?.x); + const y = describeOffset(action.params.offset?.y); + return `Scroll window to x=${x}, y=${y}`; + } + if (mode === 'container') return 'Scroll container'; + return 'Scroll to element'; + }, + + run: async (ctx, action) => { + const vars = ctx.vars; + const tabId = ctx.tabId; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found for scroll action'); + } + + const mode = action.params.mode; + + // ---------------------------- + // Offset mode: window scroll + // ---------------------------- + if (mode === 'offset') { + let top: number | undefined; + let left: number | undefined; + + if (action.params.offset?.y !== undefined) { + const yResolved = tryResolveNumber(action.params.offset.y, vars); + if (!yResolved.ok) return failed('VALIDATION_ERROR', yResolved.error); + top = yResolved.value; + } + + if (action.params.offset?.x !== undefined) { + const xResolved = tryResolveNumber(action.params.offset.x, vars); + if (!xResolved.ok) return failed('VALIDATION_ERROR', xResolved.error); + left = xResolved.value; + } + + const frameIds = typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined; + + try { + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: 'MAIN', + func: (t: number | null, l: number | null) => { + try { + const hasTop = typeof t === 'number' && Number.isFinite(t); + const hasLeft = typeof l === 'number' && Number.isFinite(l); + if (!hasTop && !hasLeft) return true; + + window.scrollTo({ + top: hasTop ? t : window.scrollY, + left: hasLeft ? l : window.scrollX, + behavior: 'auto', + }); + return true; + } catch { + return false; + } + }, + args: [top ?? null, left ?? null], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (result !== true) { + return failed('SCRIPT_FAILED', 'Window scroll script returned failure'); + } + } catch (e) { + return failed( + 'SCRIPT_FAILED', + `Failed to scroll window: ${e instanceof Error ? e.message : String(e)}`, + ); + } + + return { status: 'success' }; + } + + // ---------------------------- + // Element/Container mode + // ---------------------------- + const target = action.params.target as ElementTarget | undefined; + if (!target) { + return failed('VALIDATION_ERROR', `Scroll mode "${mode}" requires a target`); + } + + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: { tabId } }); + + const { selectorTarget, firstCandidateType, firstCssOrAttr } = toSelectorTarget(target, vars); + const located = await selectorLocator.locate(tabId, selectorTarget, { + frameId: ctx.frameId, + preferRef: false, + }); + + const frameId = located?.frameId ?? ctx.frameId; + const refToUse = located?.ref ?? selectorTarget.ref; + + // Resolve selector from ref or fallback + let selector: string | undefined; + if (refToUse) { + const resolved = await sendMessageToTab<{ success?: boolean; selector?: string }>( + tabId, + { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref: refToUse }, + frameId, + ); + if ( + resolved.ok && + resolved.value?.success !== false && + typeof resolved.value?.selector === 'string' + ) { + const sel = resolved.value.selector.trim(); + if (sel) selector = sel; + } + } + + if (!selector && firstCssOrAttr) { + const stripped = stripCompositeSelector(firstCssOrAttr); + if (stripped) selector = stripped; + } + + if (!selector) { + return failed('TARGET_NOT_FOUND', 'Could not resolve a CSS selector for the scroll target'); + } + + // Resolve offset for container mode + let scrollTop: number | undefined; + let scrollLeft: number | undefined; + if (mode === 'container') { + if (action.params.offset?.y !== undefined) { + const yResolved = tryResolveNumber(action.params.offset.y, vars); + if (!yResolved.ok) return failed('VALIDATION_ERROR', yResolved.error); + scrollTop = yResolved.value; + } + + if (action.params.offset?.x !== undefined) { + const xResolved = tryResolveNumber(action.params.offset.x, vars); + if (!xResolved.ok) return failed('VALIDATION_ERROR', xResolved.error); + scrollLeft = xResolved.value; + } + } + + // Execute scroll script + try { + const frameIds = typeof frameId === 'number' ? [frameId] : undefined; + const injected = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + world: 'MAIN', + func: ( + sel: string, + scrollMode: 'element' | 'container', + top: number | null, + left: number | null, + ) => { + const el = document.querySelector(sel) as HTMLElement | null; + if (!el) return false; + + if (scrollMode === 'element') { + el.scrollIntoView({ behavior: 'instant', block: 'center', inline: 'nearest' }); + return true; + } + + // Container scroll + const hasTop = typeof top === 'number' && Number.isFinite(top); + const hasLeft = typeof left === 'number' && Number.isFinite(left); + + if (typeof el.scrollTo === 'function') { + el.scrollTo({ + top: hasTop ? top : el.scrollTop, + left: hasLeft ? left : el.scrollLeft, + behavior: 'instant', + }); + } else { + if (hasTop) el.scrollTop = top; + if (hasLeft) el.scrollLeft = left; + } + return true; + }, + args: [selector, mode, scrollTop ?? null, scrollLeft ?? null], + }); + + const result = Array.isArray(injected) ? injected[0]?.result : undefined; + if (result !== true) { + return failed('TARGET_NOT_FOUND', `Scroll target not found: ${selector}`); + } + } catch (e) { + return failed( + 'SCRIPT_FAILED', + `Failed to execute scroll: ${e instanceof Error ? e.message : String(e)}`, + ); + } + + // Log fallback if used + const resolvedBy = located?.resolvedBy || (located?.ref ? 'ref' : ''); + const fallbackUsed = + resolvedBy && firstCandidateType && resolvedBy !== 'ref' && resolvedBy !== firstCandidateType; + if (fallbackUsed) { + logSelectorFallback(ctx, action.id, String(firstCandidateType), String(resolvedBy)); + } + + return { status: 'success' }; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/tabs.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/tabs.ts new file mode 100644 index 00000000..1356ae6e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/tabs.ts @@ -0,0 +1,419 @@ +/** + * Tab Management Action Handlers + * + * Handles browser tab operations: + * - openTab: Open a new tab or window + * - switchTab: Switch to a different tab + * - closeTab: Close tab(s) + * - handleDownload: Monitor and capture download information + */ + +import { failed, invalid, ok, tryResolveString } from '../registry'; +import type { ActionHandler, DownloadInfo, DownloadState, VariableStore } from '../types'; + +/** Default timeout for tab operations */ +const DEFAULT_TAB_TIMEOUT_MS = 10000; + +/** Default timeout for download operations */ +const DEFAULT_DOWNLOAD_TIMEOUT_MS = 60000; + +// ================================ +// openTab Handler +// ================================ + +export const openTabHandler: ActionHandler<'openTab'> = { + type: 'openTab', + + validate: () => ok(), + + describe: (action) => { + const url = typeof action.params.url === 'string' ? action.params.url : undefined; + const displayUrl = url ? (url.length > 30 ? url.slice(0, 30) + '...' : url) : 'blank'; + return action.params.newWindow ? `Open window: ${displayUrl}` : `Open tab: ${displayUrl}`; + }, + + run: async (ctx, action) => { + const params = action.params; + + // Resolve URL if provided + let url: string | undefined; + if (params.url !== undefined) { + const urlResult = tryResolveString(params.url, ctx.vars); + if (!urlResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve URL: ${urlResult.error}`); + } + url = urlResult.value.trim() || undefined; + } + + try { + let tabId: number; + + if (params.newWindow) { + // Create new window + const window = await chrome.windows.create({ + url: url || 'about:blank', + focused: true, + }); + + const tab = window?.tabs?.[0]; + if (!tab?.id) { + return failed('TAB_NOT_FOUND', 'Failed to create new window'); + } + tabId = tab.id; + } else { + // Create new tab in current window + const tab = await chrome.tabs.create({ + url: url || 'about:blank', + active: true, + }); + + if (!tab.id) { + return failed('TAB_NOT_FOUND', 'Failed to create new tab'); + } + tabId = tab.id; + } + + // Wait for tab to be ready if URL was specified + if (url) { + await waitForTabComplete(tabId, DEFAULT_TAB_TIMEOUT_MS); + } + + // Return newTabId for ctx.tabId sync + return { status: 'success', newTabId: tabId }; + } catch (e) { + return failed('UNKNOWN', `Failed to open tab: ${e instanceof Error ? e.message : String(e)}`); + } + }, +}; + +// ================================ +// switchTab Handler +// ================================ + +export const switchTabHandler: ActionHandler<'switchTab'> = { + type: 'switchTab', + + validate: (action) => { + const params = action.params; + const hasTabId = params.tabId !== undefined; + const hasUrlContains = params.urlContains !== undefined; + const hasTitleContains = params.titleContains !== undefined; + + if (!hasTabId && !hasUrlContains && !hasTitleContains) { + return invalid('switchTab requires tabId, urlContains, or titleContains'); + } + + return ok(); + }, + + describe: (action) => { + if (action.params.tabId !== undefined) { + return `Switch to tab #${action.params.tabId}`; + } + if (action.params.urlContains !== undefined) { + return `Switch tab (URL contains)`; + } + if (action.params.titleContains !== undefined) { + return `Switch tab (title contains)`; + } + return 'Switch tab'; + }, + + run: async (ctx, action) => { + const params = action.params; + + try { + let targetTabId: number | undefined; + + if (params.tabId !== undefined) { + targetTabId = params.tabId; + } else { + // Find tab by URL or title + const tabs = await chrome.tabs.query({}); + + if (params.urlContains !== undefined) { + const urlResult = tryResolveString(params.urlContains, ctx.vars); + if (!urlResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve urlContains: ${urlResult.error}`); + } + const urlPattern = urlResult.value.trim().toLowerCase(); + + // Empty pattern is invalid + if (!urlPattern) { + return failed('VALIDATION_ERROR', 'urlContains pattern cannot be empty'); + } + + const matchingTab = tabs.find( + (tab) => tab.url && tab.url.toLowerCase().includes(urlPattern), + ); + targetTabId = matchingTab?.id; + } else if (params.titleContains !== undefined) { + const titleResult = tryResolveString(params.titleContains, ctx.vars); + if (!titleResult.ok) { + return failed( + 'VALIDATION_ERROR', + `Failed to resolve titleContains: ${titleResult.error}`, + ); + } + const titlePattern = titleResult.value.trim().toLowerCase(); + + // Empty pattern is invalid + if (!titlePattern) { + return failed('VALIDATION_ERROR', 'titleContains pattern cannot be empty'); + } + + const matchingTab = tabs.find( + (tab) => tab.title && tab.title.toLowerCase().includes(titlePattern), + ); + targetTabId = matchingTab?.id; + } + } + + if (targetTabId === undefined) { + return failed('TAB_NOT_FOUND', 'No matching tab found'); + } + + // Activate the tab + await chrome.tabs.update(targetTabId, { active: true }); + + // Focus the window containing the tab + const tab = await chrome.tabs.get(targetTabId); + if (tab.windowId) { + await chrome.windows.update(tab.windowId, { focused: true }); + } + + // Return newTabId for ctx.tabId sync + return { status: 'success', newTabId: targetTabId }; + } catch (e) { + return failed( + 'UNKNOWN', + `Failed to switch tab: ${e instanceof Error ? e.message : String(e)}`, + ); + } + }, +}; + +// ================================ +// closeTab Handler +// ================================ + +export const closeTabHandler: ActionHandler<'closeTab'> = { + type: 'closeTab', + + validate: () => ok(), + + describe: (action) => { + if (action.params.tabIds && action.params.tabIds.length > 0) { + return `Close ${action.params.tabIds.length} tab(s)`; + } + if (action.params.url !== undefined) { + return 'Close tab (by URL)'; + } + return 'Close current tab'; + }, + + run: async (ctx, action) => { + const params = action.params; + + try { + let tabIds: number[] = []; + + if (params.tabIds && params.tabIds.length > 0) { + // Close specific tabs + tabIds = [...params.tabIds]; + } else if (params.url !== undefined) { + // Find and close tabs by URL + const urlResult = tryResolveString(params.url, ctx.vars); + if (!urlResult.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve URL: ${urlResult.error}`); + } + const urlPattern = urlResult.value.trim().toLowerCase(); + + // Empty pattern is invalid + if (!urlPattern) { + return failed('VALIDATION_ERROR', 'URL pattern cannot be empty'); + } + + const tabs = await chrome.tabs.query({}); + tabIds = tabs + .filter((tab) => tab.url && tab.url.toLowerCase().includes(urlPattern) && tab.id) + .map((tab) => tab.id!); + } else { + // Close current tab + if (typeof ctx.tabId === 'number') { + tabIds = [ctx.tabId]; + } + } + + if (tabIds.length === 0) { + return failed('TAB_NOT_FOUND', 'No tabs to close'); + } + + await chrome.tabs.remove(tabIds); + return { status: 'success' }; + } catch (e) { + return failed( + 'UNKNOWN', + `Failed to close tab: ${e instanceof Error ? e.message : String(e)}`, + ); + } + }, +}; + +// ================================ +// handleDownload Handler +// ================================ + +export const handleDownloadHandler: ActionHandler<'handleDownload'> = { + type: 'handleDownload', + + validate: () => ok(), + + describe: (action) => { + if (action.params.filenameContains !== undefined) { + return 'Handle download (by filename)'; + } + return 'Handle download'; + }, + + run: async (ctx, action) => { + const params = action.params; + const timeoutMs = action.policy?.timeout?.ms ?? DEFAULT_DOWNLOAD_TIMEOUT_MS; + const waitForComplete = params.waitForComplete !== false; + + // Resolve filename pattern if provided + let filenamePattern: string | undefined; + if (params.filenameContains !== undefined) { + const result = tryResolveString(params.filenameContains, ctx.vars); + if (!result.ok) { + return failed('VALIDATION_ERROR', `Failed to resolve filenameContains: ${result.error}`); + } + filenamePattern = result.value.toLowerCase(); + } + + return new Promise((resolve) => { + const startTime = Date.now(); + let downloadId: number | undefined; + let downloadInfo: DownloadInfo | undefined; + let resolved = false; + + const cleanup = () => { + chrome.downloads.onCreated.removeListener(onCreated); + chrome.downloads.onChanged.removeListener(onChanged); + }; + + const finish = (result: Awaited['run']>>) => { + if (!resolved) { + resolved = true; + cleanup(); + resolve(result); + } + }; + + const onCreated = (item: chrome.downloads.DownloadItem) => { + // Check if this download matches our criteria + if (filenamePattern) { + const filename = item.filename.toLowerCase(); + if (!filename.includes(filenamePattern)) return; + } + + downloadId = item.id; + downloadInfo = { + id: String(item.id), + filename: item.filename, + url: item.url, + state: item.state as DownloadState, + size: item.totalBytes > 0 ? item.totalBytes : undefined, + }; + + if (!waitForComplete || item.state === 'complete') { + storeAndFinish(); + } + }; + + const onChanged = (delta: chrome.downloads.DownloadDelta) => { + if (delta.id !== downloadId) return; + + if (delta.state) { + if (downloadInfo) { + downloadInfo.state = delta.state.current as DownloadState; + } + + if (delta.state.current === 'complete') { + storeAndFinish(); + } else if (delta.state.current === 'interrupted') { + finish(failed('DOWNLOAD_FAILED', 'Download was interrupted')); + } + } + + if (delta.filename && downloadInfo) { + downloadInfo.filename = delta.filename.current || downloadInfo.filename; + } + + if (delta.totalBytes && downloadInfo && delta.totalBytes.current) { + downloadInfo.size = delta.totalBytes.current; + } + }; + + const storeAndFinish = () => { + if (params.saveAs && downloadInfo) { + ctx.vars[params.saveAs] = downloadInfo as unknown as VariableStore[string]; + } + finish({ + status: 'success', + output: downloadInfo ? { download: downloadInfo } : undefined, + }); + }; + + // Set up listeners + chrome.downloads.onCreated.addListener(onCreated); + chrome.downloads.onChanged.addListener(onChanged); + + // Set up timeout + const checkTimeout = () => { + if (resolved) return; + if (Date.now() - startTime > timeoutMs) { + finish(failed('TIMEOUT', `Download timeout after ${timeoutMs}ms`)); + } else { + setTimeout(checkTimeout, 500); + } + }; + setTimeout(checkTimeout, 500); + }); + }, +}; + +// ================================ +// Helper Functions +// ================================ + +/** + * Wait for a tab to complete loading + */ +async function waitForTabComplete(tabId: number, timeoutMs: number): Promise { + const startTime = Date.now(); + + return new Promise((resolve, reject) => { + const checkStatus = async () => { + try { + const tab = await chrome.tabs.get(tabId); + + if (tab.status === 'complete') { + resolve(); + return; + } + + if (Date.now() - startTime > timeoutMs) { + reject(new Error(`Tab load timeout after ${timeoutMs}ms`)); + return; + } + + setTimeout(checkStatus, 100); + } catch (e) { + reject(e); + } + }; + + checkStatus(); + }); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/wait.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/wait.ts new file mode 100644 index 00000000..e2ec8d9e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/handlers/wait.ts @@ -0,0 +1,195 @@ +/** + * Wait Action Handler + * + * Handles various wait conditions: + * - Sleep (fixed delay) + * - Network idle + * - Navigation complete + * - Text appears/disappears + * - Selector visible/hidden + */ + +import { ENGINE_CONSTANTS } from '../../engine/constants'; +import { waitForNavigation, waitForNetworkIdle } from '../../rr-utils'; +import { failed, invalid, ok, tryResolveNumber } from '../registry'; +import type { ActionHandler } from '../types'; +import { clampInt, resolveString, sendMessageToTab } from './common'; + +export const waitHandler: ActionHandler<'wait'> = { + type: 'wait', + + validate: (action) => { + const condition = action.params.condition; + if (!condition || typeof condition !== 'object') { + return invalid('Missing condition parameter'); + } + if (!('kind' in condition)) { + return invalid('Condition must have a kind property'); + } + return ok(); + }, + + describe: (action) => { + const condition = action.params.condition; + if (!condition) return 'Wait'; + + switch (condition.kind) { + case 'sleep': { + const ms = typeof condition.sleep === 'number' ? condition.sleep : '(dynamic)'; + return `Wait ${ms}ms`; + } + case 'networkIdle': + return 'Wait for network idle'; + case 'navigation': + return 'Wait for navigation'; + case 'text': { + const appear = condition.appear !== false; + const text = typeof condition.text === 'string' ? condition.text : '(dynamic)'; + const displayText = text.length > 20 ? text.slice(0, 20) + '...' : text; + return `Wait for text "${displayText}" to ${appear ? 'appear' : 'disappear'}`; + } + case 'selector': { + const visible = condition.visible !== false; + return `Wait for selector to be ${visible ? 'visible' : 'hidden'}`; + } + default: + return 'Wait'; + } + }, + + run: async (ctx, action) => { + const vars = ctx.vars; + const tabId = ctx.tabId; + + if (typeof tabId !== 'number') { + return failed('TAB_NOT_FOUND', 'No active tab found'); + } + + const timeoutMs = action.policy?.timeout?.ms; + const frameIds = typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined; + const condition = action.params.condition; + + // Handle sleep condition + if (condition.kind === 'sleep') { + const msResolved = tryResolveNumber(condition.sleep, vars); + if (!msResolved.ok) { + return failed('VALIDATION_ERROR', msResolved.error); + } + const ms = Math.max(0, Number(msResolved.value ?? 0)); + await new Promise((resolve) => setTimeout(resolve, ms)); + return { status: 'success' }; + } + + // Handle network idle condition + if (condition.kind === 'networkIdle') { + const totalMs = clampInt(timeoutMs ?? 5000, 1000, ENGINE_CONSTANTS.MAX_WAIT_MS); + let idleMs: number; + + if (condition.idleMs !== undefined) { + const idleResolved = tryResolveNumber(condition.idleMs, vars); + idleMs = idleResolved.ok + ? clampInt(idleResolved.value, 200, 5000) + : Math.min(1500, Math.max(500, Math.floor(totalMs / 3))); + } else { + idleMs = Math.min(1500, Math.max(500, Math.floor(totalMs / 3))); + } + + await waitForNetworkIdle(totalMs, idleMs); + return { status: 'success' }; + } + + // Handle navigation condition + if (condition.kind === 'navigation') { + const timeout = timeoutMs === undefined ? undefined : Math.max(0, Number(timeoutMs)); + await waitForNavigation(timeout); + return { status: 'success' }; + } + + // Handle text condition + if (condition.kind === 'text') { + const textResolved = resolveString(condition.text, vars); + if (!textResolved.ok) { + return failed('VALIDATION_ERROR', textResolved.error); + } + + const appear = condition.appear !== false; + const timeout = clampInt(timeoutMs ?? 10000, 0, ENGINE_CONSTANTS.MAX_WAIT_MS); + + // Inject wait helper script + try { + await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + files: ['inject-scripts/wait-helper.js'], + world: 'ISOLATED', + }); + } catch (e) { + return failed('SCRIPT_FAILED', `Failed to inject wait helper: ${(e as Error).message}`); + } + + // Execute wait for text + const response = await sendMessageToTab<{ success?: boolean }>( + tabId, + { action: 'waitForText', text: textResolved.value, appear, timeout }, + ctx.frameId, + ); + + if (!response.ok) { + return failed('TIMEOUT', `Wait for text failed: ${response.error}`); + } + if (response.value?.success !== true) { + return failed( + 'TIMEOUT', + `Text "${textResolved.value}" did not ${appear ? 'appear' : 'disappear'} within timeout`, + ); + } + + return { status: 'success' }; + } + + // Handle selector condition + if (condition.kind === 'selector') { + const selectorResolved = resolveString(condition.selector, vars); + if (!selectorResolved.ok) { + return failed('VALIDATION_ERROR', selectorResolved.error); + } + + const visible = condition.visible !== false; + const timeout = clampInt(timeoutMs ?? 10000, 0, ENGINE_CONSTANTS.MAX_WAIT_MS); + + // Inject wait helper script + try { + await chrome.scripting.executeScript({ + target: { tabId, frameIds } as chrome.scripting.InjectionTarget, + files: ['inject-scripts/wait-helper.js'], + world: 'ISOLATED', + }); + } catch (e) { + return failed('SCRIPT_FAILED', `Failed to inject wait helper: ${(e as Error).message}`); + } + + // Execute wait for selector + const response = await sendMessageToTab<{ success?: boolean }>( + tabId, + { action: 'waitForSelector', selector: selectorResolved.value, visible, timeout }, + ctx.frameId, + ); + + if (!response.ok) { + return failed('TIMEOUT', `Wait for selector failed: ${response.error}`); + } + if (response.value?.success !== true) { + return failed( + 'TIMEOUT', + `Selector "${selectorResolved.value}" did not become ${visible ? 'visible' : 'hidden'} within timeout`, + ); + } + + return { status: 'success' }; + } + + return failed( + 'VALIDATION_ERROR', + `Unsupported wait condition kind: ${(condition as { kind: string }).kind}`, + ); + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/index.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/index.ts new file mode 100644 index 00000000..e8df2b66 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/index.ts @@ -0,0 +1,43 @@ +/** + * Action System - 导出模块 + */ + +// 类型导出 +export * from './types'; + +// 注册表导出 +export { + ActionRegistry, + createActionRegistry, + ok, + invalid, + failed, + tryResolveString, + tryResolveNumber, + tryResolveJson, + tryResolveValue, + type BeforeExecuteArgs, + type BeforeExecuteHook, + type AfterExecuteArgs, + type AfterExecuteHook, + type ActionRegistryHooks, +} from './registry'; + +// 适配器导出 +export { + execCtxToActionCtx, + stepToAction, + actionResultToExecResult, + createStepExecutor, + isActionSupported, + getActionType, + type StepExecutionAttempt, +} from './adapter'; + +// Handler 工厂导出 +export { + createReplayActionRegistry, + registerReplayHandlers, + getSupportedActionTypes, + isActionTypeSupported, +} from './handlers'; diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/registry.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/registry.ts new file mode 100644 index 00000000..89fedc81 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/registry.ts @@ -0,0 +1,640 @@ +/** + * Action Registry - Action 执行器注册表和执行管道 + * + * 特性： + * - 动态注册/注销 handler + * - 中间件/钩子机制 (beforeExecute, afterExecute) + * - 重试和超时策略 + * - 类型安全 + */ + +import type { + Action, + ActionError, + ActionErrorCode, + ActionExecutionContext, + ActionExecutionResult, + ActionHandler, + EdgeLabel, + ElementTarget, + ExecutableAction, + ExecutableActionType, + FrameTarget, + JsonValue, + NonEmptyArray, + Resolvable, + RetryPolicy, + SelectorCandidate, + TimeoutPolicy, + ValidationResult, + VariablePathSegment, + VariablePointer, + VariableStore, +} from './types'; + +// ================================ +// 类型定义 +// ================================ + +type AnyExecutableAction = { + [T in ExecutableActionType]: ExecutableAction; +}[ExecutableActionType]; +type AnyExecutableHandler = { [T in ExecutableActionType]: ActionHandler }[ExecutableActionType]; + +export interface BeforeExecuteArgs { + ctx: ActionExecutionContext; + action: ExecutableAction; + handler: ActionHandler; + attempt: number; +} + +export type BeforeExecuteHook = ( + args: BeforeExecuteArgs, +) => void | ActionExecutionResult | Promise>; + +export interface AfterExecuteArgs { + ctx: ActionExecutionContext; + action: ExecutableAction; + handler: ActionHandler; + result: ActionExecutionResult; + attempt: number; +} + +export type AfterExecuteHook = ( + args: AfterExecuteArgs, +) => void | ActionExecutionResult | Promise>; + +export interface ActionRegistryHooks { + beforeExecute?: BeforeExecuteHook; + afterExecute?: AfterExecuteHook; +} + +// ================================ +// 工具函数 +// ================================ + +function isRecord(value: unknown): value is Record { + return typeof value === 'object' && value !== null; +} + +function toNonEmptyArray(value: string[], fallback: string): NonEmptyArray { + return (value.length > 0 ? value : [fallback]) as NonEmptyArray; +} + +const ACTION_ERROR_CODES: ReadonlyArray = [ + 'VALIDATION_ERROR', + 'TIMEOUT', + 'TAB_NOT_FOUND', + 'FRAME_NOT_FOUND', + 'TARGET_NOT_FOUND', + 'ELEMENT_NOT_VISIBLE', + 'NAVIGATION_FAILED', + 'NETWORK_REQUEST_FAILED', + 'DOWNLOAD_FAILED', + 'ASSERTION_FAILED', + 'SCRIPT_FAILED', + 'UNKNOWN', +] as const; + +function isActionErrorCode(value: unknown): value is ActionErrorCode { + return typeof value === 'string' && (ACTION_ERROR_CODES as ReadonlyArray).includes(value); +} + +function toErrorMessage(e: unknown): string { + if (e instanceof Error) return e.message; + if (typeof e === 'string') return e; + if (isRecord(e) && typeof e.message === 'string') return e.message; + return 'Unknown error'; +} + +function toActionError(e: unknown, fallbackCode: ActionErrorCode = 'UNKNOWN'): ActionError { + if (isRecord(e) && isActionErrorCode(e.code) && typeof e.message === 'string') { + return { code: e.code, message: e.message, data: undefined }; + } + return { code: fallbackCode, message: toErrorMessage(e) }; +} + +export function ok(): ValidationResult { + return { ok: true }; +} + +export function invalid(...errors: string[]): ValidationResult { + return { ok: false, errors: toNonEmptyArray(errors.filter(Boolean), 'Validation failed') }; +} + +export function failed( + code: ActionErrorCode, + message: string, +): ActionExecutionResult { + return { status: 'failed', error: { code, message } }; +} + +function sleep(ms: number): Promise { + const safe = Math.max(0, Math.floor(ms)); + return new Promise((resolve) => setTimeout(resolve, safe)); +} + +// ================================ +// Resolvable 解析器 +// ================================ + +function isVariablePointer(value: unknown): value is VariablePointer { + if (!isRecord(value)) return false; + if (typeof value.name !== 'string' || value.name.length === 0) return false; + if (value.path === undefined) return true; + if (!Array.isArray(value.path)) return false; + return value.path.every((s) => typeof s === 'string' || typeof s === 'number'); +} + +function isVarValue( + value: unknown, +): value is { kind: 'var'; ref: VariablePointer; default?: unknown } { + if (!isRecord(value)) return false; + if (value.kind !== 'var') return false; + return isVariablePointer(value.ref); +} + +function isExprValue(value: unknown): value is { kind: 'expr'; default?: unknown } { + if (!isRecord(value)) return false; + if (value.kind !== 'expr') return false; + return 'expr' in value; +} + +function isStringTemplate(value: unknown): value is { kind: 'template'; parts: unknown[] } { + if (!isRecord(value)) return false; + if (value.kind !== 'template') return false; + return Array.isArray(value.parts) && value.parts.length > 0; +} + +function readByPath( + value: JsonValue, + path?: ReadonlyArray, +): JsonValue | undefined { + if (!path || path.length === 0) return value; + let cur: JsonValue | undefined = value; + for (const seg of path) { + if (cur === undefined || cur === null) return undefined; + if (typeof seg === 'number') { + if (!Array.isArray(cur)) return undefined; + cur = cur[seg] as JsonValue | undefined; + continue; + } + if (typeof seg === 'string') { + if (!isRecord(cur)) return undefined; + cur = (cur as Record)[seg] as JsonValue | undefined; + continue; + } + return undefined; + } + return cur; +} + +export function tryResolveJson( + value: Resolvable, + vars: VariableStore, +): { ok: true; value: JsonValue } | { ok: false; error: string } { + if (isVarValue(value)) { + const ref = value.ref; + const root = vars[ref.name]; + const resolved = root === undefined ? undefined : readByPath(root, ref.path); + if (resolved !== undefined) return { ok: true, value: resolved }; + if ('default' in value) return { ok: true, value: (value.default ?? null) as JsonValue }; + return { ok: true, value: null }; + } + if (isExprValue(value)) { + if ('default' in value) return { ok: true, value: (value.default ?? null) as JsonValue }; + return { ok: false, error: 'Expression value is not supported by the default resolver' }; + } + return { ok: true, value }; +} + +function formatInserted(value: JsonValue, format?: 'text' | 'json' | 'urlEncoded'): string { + if (format === 'json') return JSON.stringify(value); + const text = value === null ? '' : typeof value === 'string' ? value : String(value); + if (format === 'urlEncoded') return encodeURIComponent(text); + return text; +} + +export function tryResolveString( + value: Resolvable, + vars: VariableStore, +): { ok: true; value: string } | { ok: false; error: string } { + if (typeof value === 'string') return { ok: true, value }; + if (isVarValue(value)) { + const ref = value.ref; + const root = vars[ref.name]; + const resolved = root === undefined ? undefined : readByPath(root, ref.path); + if (resolved !== undefined && resolved !== null) return { ok: true, value: String(resolved) }; + if ('default' in value && typeof value.default === 'string') + return { ok: true, value: value.default }; + return { ok: true, value: '' }; + } + if (isStringTemplate(value)) { + const parts = value.parts; + let out = ''; + for (const p of parts) { + if (!isRecord(p) || typeof p.kind !== 'string') + return { ok: false, error: 'Invalid template part' }; + if (p.kind === 'text') { + if (typeof p.value !== 'string') return { ok: false, error: 'Invalid template text part' }; + out += p.value; + continue; + } + if (p.kind === 'insert') { + const resolved = tryResolveJson(p.value as Resolvable, vars); + if (!resolved.ok) return { ok: false, error: resolved.error }; + out += formatInserted( + resolved.value, + (p.format as 'text' | 'json' | 'urlEncoded' | undefined) ?? 'text', + ); + continue; + } + return { + ok: false, + error: `Unknown template part kind: ${String((p as { kind: string }).kind)}`, + }; + } + return { ok: true, value: out }; + } + if (isExprValue(value)) { + if ('default' in value && typeof value.default === 'string') + return { ok: true, value: value.default }; + return { ok: false, error: 'Expression value is not supported by the default resolver' }; + } + return { ok: false, error: 'Unsupported resolvable string value' }; +} + +export function tryResolveNumber( + value: Resolvable, + vars: VariableStore, +): { ok: true; value: number } | { ok: false; error: string } { + if (typeof value === 'number' && Number.isFinite(value)) return { ok: true, value }; + if (isVarValue(value)) { + const ref = value.ref; + const root = vars[ref.name]; + const resolved = root === undefined ? undefined : readByPath(root, ref.path); + if (typeof resolved === 'number' && Number.isFinite(resolved)) + return { ok: true, value: resolved }; + if (typeof resolved === 'string' && resolved.trim() !== '') { + const n = Number(resolved); + if (Number.isFinite(n)) return { ok: true, value: n }; + } + if ('default' in value && typeof value.default === 'number' && Number.isFinite(value.default)) + return { ok: true, value: value.default }; + return { ok: false, error: `Variable "${ref.name}" is not a finite number` }; + } + if (isExprValue(value)) { + if ('default' in value && typeof value.default === 'number' && Number.isFinite(value.default)) + return { ok: true, value: value.default }; + return { ok: false, error: 'Expression value is not supported by the default resolver' }; + } + return { ok: false, error: 'Unsupported resolvable number value' }; +} + +/** + * Resolve a generic JSON value (alias for tryResolveJson) + * Useful for script/http handlers that work with arbitrary JSON + */ +export const tryResolveValue = tryResolveJson; + +// ================================ +// 重试和超时逻辑 +// ================================ + +function shouldRetry(policy: RetryPolicy | undefined, error: ActionError | undefined): boolean { + if (!policy) return false; + if (policy.retries <= 0) return false; + if (!error) return false; + if (error.code === 'VALIDATION_ERROR') return false; + if (policy.retryOn && policy.retryOn.length > 0) return policy.retryOn.includes(error.code); + return true; +} + +function computeRetryDelayMs(policy: RetryPolicy, retryIndex: number): number { + const base = Math.max(0, Math.floor(policy.intervalMs)); + const backoff = policy.backoff ?? 'none'; + + let delay = base; + if (backoff === 'linear') delay = base * (retryIndex + 1); + if (backoff === 'exp') delay = base * Math.pow(2, retryIndex); + + const capped = + policy.maxIntervalMs !== undefined ? Math.min(delay, Math.max(0, policy.maxIntervalMs)) : delay; + if ((policy.jitter ?? 'none') === 'full') return Math.floor(Math.random() * capped); + return capped; +} + +async function runWithTimeout( + run: () => Promise, + timeoutMs: number | undefined, +): Promise<{ ok: true; value: T } | { ok: false; error: ActionError }> { + if (timeoutMs === undefined) { + try { + return { ok: true, value: await run() }; + } catch (e) { + return { ok: false, error: toActionError(e) }; + } + } + + const ms = Math.max(0, Math.floor(timeoutMs)); + if (ms === 0) return { ok: false, error: { code: 'TIMEOUT', message: 'Timeout reached' } }; + + return await new Promise((resolve) => { + const timer: ReturnType = setTimeout(() => { + resolve({ ok: false, error: { code: 'TIMEOUT', message: 'Timeout reached' } }); + }, ms); + + run() + .then((value) => { + clearTimeout(timer); + resolve({ ok: true, value }); + }) + .catch((e) => { + clearTimeout(timer); + resolve({ ok: false, error: toActionError(e) }); + }); + }); +} + +// ================================ +// ActionRegistry 类 +// ================================ + +export class ActionRegistry { + private readonly handlers: { [T in ExecutableActionType]?: ActionHandler } = {}; + private readonly beforeHooks: BeforeExecuteHook[] = []; + private readonly afterHooks: AfterExecuteHook[] = []; + + /** + * 注册 action handler + */ + register( + handler: ActionHandler, + options?: { override?: boolean }, + ): void { + const override = options?.override !== false; + const existing = this.handlers[handler.type]; + if (existing && !override) { + throw new Error(`Handler already registered for type: ${handler.type}`); + } + // Type assertion needed due to TypeScript mapped type limitation + + (this.handlers as Record>)[handler.type] = handler; + } + + /** + * 注销 action handler + */ + unregister(type: T): boolean { + const exists = this.handlers[type] !== undefined; + delete this.handlers[type]; + return exists; + } + + /** + * 获取 handler + */ + get(type: T): ActionHandler | undefined { + return this.handlers[type]; + } + + /** + * 检查是否存在 handler + */ + has(type: ExecutableActionType): boolean { + return this.handlers[type] !== undefined; + } + + /** + * 列出所有已注册的 handler + */ + list(): ReadonlyArray { + const arr = Object.values(this.handlers).filter( + (h): h is AnyExecutableHandler => h !== undefined, + ); + return arr; + } + + /** + * 注册 beforeExecute 钩子 + */ + onBeforeExecute(hook: BeforeExecuteHook): () => void { + this.beforeHooks.push(hook); + return () => { + const idx = this.beforeHooks.indexOf(hook); + if (idx >= 0) this.beforeHooks.splice(idx, 1); + }; + } + + /** + * 注册 afterExecute 钩子 + */ + onAfterExecute(hook: AfterExecuteHook): () => void { + this.afterHooks.push(hook); + return () => { + const idx = this.afterHooks.indexOf(hook); + if (idx >= 0) this.afterHooks.splice(idx, 1); + }; + } + + /** + * 批量注册钩子 + */ + use(hooks: ActionRegistryHooks): () => void { + const disposers: Array<() => void> = []; + if (hooks.beforeExecute) disposers.push(this.onBeforeExecute(hooks.beforeExecute)); + if (hooks.afterExecute) disposers.push(this.onAfterExecute(hooks.afterExecute)); + return () => { + for (const d of disposers) d(); + }; + } + + /** + * 验证 action 配置 + */ + validate(action: ExecutableAction): ValidationResult { + const handler = this.get(action.type); + if (!handler) return invalid(`Unsupported action type: ${String(action.type)}`); + if (!handler.validate) return ok(); + return handler.validate(action); + } + + /** + * 执行 action + */ + async execute( + ctx: ActionExecutionContext, + action: ExecutableAction, + ): Promise> { + const startedAt = Date.now(); + + // 跳过禁用的 action + if (action.disabled) { + return { status: 'skipped', durationMs: Date.now() - startedAt }; + } + + // 获取 handler + const handler = this.get(action.type); + if (!handler) { + return { + status: 'failed', + error: { + code: 'VALIDATION_ERROR', + message: `Unsupported action type: ${String(action.type)}`, + }, + durationMs: Date.now() - startedAt, + }; + } + + // 验证 + const v = this.validate(action); + if (!v.ok) { + let result: ActionExecutionResult = { + status: 'failed', + error: { code: 'VALIDATION_ERROR', message: v.errors.join(', ') }, + }; + + // 调用 afterExecute 钩子 + for (const hook of this.afterHooks) { + try { + const maybe = await hook({ ctx, action, handler, result, attempt: 0 }); + if (maybe) result = maybe; + } catch (e) { + try { + ctx.log(`afterExecute hook failed: ${toErrorMessage(e)}`, 'warn'); + } catch { + // ignore + } + } + } + + result.durationMs = Date.now() - startedAt; + return result; + } + + // 计算重试和超时参数 + const retryPolicy = action.policy?.retry; + const timeoutPolicy = action.policy?.timeout; + const maxAttempts = 1 + Math.max(0, Math.floor(retryPolicy?.retries ?? 0)); + + const actionDeadline = + timeoutPolicy && timeoutPolicy.ms > 0 && (timeoutPolicy.scope ?? 'attempt') === 'action' + ? startedAt + timeoutPolicy.ms + : undefined; + + const remainingActionMs = () => + actionDeadline === undefined ? undefined : Math.max(0, actionDeadline - Date.now()); + + let last: ActionExecutionResult | undefined; + + // 执行循环（支持重试） + for (let attempt = 0; attempt < maxAttempts; attempt++) { + const attemptTimeoutMs: number | undefined = (() => { + if (!timeoutPolicy || timeoutPolicy.ms <= 0) return undefined; + const scope = timeoutPolicy.scope ?? 'attempt'; + if (scope === 'attempt') return timeoutPolicy.ms; + return remainingActionMs(); + })(); + + if (attemptTimeoutMs !== undefined && attemptTimeoutMs <= 0) { + last = failed('TIMEOUT', 'Timeout reached'); + break; + } + + // beforeExecute 钩子（可以短路） + let shortCircuited: ActionExecutionResult | undefined; + for (const hook of this.beforeHooks) { + try { + const maybe = await hook({ ctx, action, handler, attempt }); + if (maybe) { + shortCircuited = maybe; + break; + } + } catch (e) { + try { + ctx.log(`beforeExecute hook failed: ${toErrorMessage(e)}`, 'warn'); + } catch { + // ignore + } + } + } + + // 执行 handler + const runOutcome = + shortCircuited ?? + (await (async () => { + const out = await runWithTimeout(() => handler.run(ctx, action), attemptTimeoutMs); + if (!out.ok) return failed(out.error.code, out.error.message); + + const result = out.value ?? ({} as ActionExecutionResult); + if (result.status === 'failed' && !result.error) { + return { ...result, error: { code: 'UNKNOWN' as const, message: 'Action failed' } }; + } + return result; + })()); + + let result: ActionExecutionResult = runOutcome; + + // afterExecute 钩子（可以替换结果） + for (const hook of this.afterHooks) { + try { + const maybe = await hook({ ctx, action, handler, result, attempt }); + if (maybe) result = maybe; + } catch (e) { + try { + ctx.log(`afterExecute hook failed: ${toErrorMessage(e)}`, 'warn'); + } catch { + // ignore + } + } + } + + last = result; + + // 成功则退出 + if (result.status !== 'failed') break; + + // 判断是否重试 + const canRetry = attempt < maxAttempts - 1 && shouldRetry(retryPolicy, result.error); + if (!canRetry) break; + + const delay = computeRetryDelayMs(retryPolicy!, attempt); + if ( + actionDeadline !== undefined && + remainingActionMs() !== undefined && + (remainingActionMs() as number) < delay + ) { + break; + } + + try { + ctx.log(`Retrying action "${action.type}" (attempt ${attempt + 1}/${maxAttempts})`, 'warn'); + } catch { + // ignore + } + + if (delay > 0) await sleep(delay); + } + + const finalResult: ActionExecutionResult = + last ?? + ({ + status: 'failed', + error: { code: 'UNKNOWN', message: 'Action execution produced no result' }, + } as ActionExecutionResult); + + finalResult.durationMs = Date.now() - startedAt; + return finalResult; + } +} + +// ================================ +// 导出工厂函数 +// ================================ + +/** + * 创建默认的 ActionRegistry 实例 + */ +export function createActionRegistry(): ActionRegistry { + return new ActionRegistry(); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/actions/types.ts b/app/chrome-extension/entrypoints/background/record-replay/actions/types.ts new file mode 100644 index 00000000..41fa9547 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/actions/types.ts @@ -0,0 +1,944 @@ +/** + * Action Type System for Record & Replay + * 商业级录制回放的核心类型定义 + * + * 设计原则： + * - 类型安全，无 any + * - 支持所有操作类型 + * - 支持重试、超时、错误处理策略 + * - 支持选择器候选列表和稳定性评分 + * - 支持变量系统 + * - 符合 SOLID 原则（接口可通过声明合并扩展） + */ + +// ================================ +// 基础类型 +// ================================ + +export type Milliseconds = number; +export type ISODateTimeString = string; +export type NonEmptyArray = [T, ...T[]]; + +// JSON 类型 +export type JsonPrimitive = string | number | boolean | null; +export type JsonValue = JsonPrimitive | JsonObject | JsonArray; +export interface JsonObject { + [key: string]: JsonValue; +} +export type JsonArray = JsonValue[]; + +// ID 类型 +export type FlowId = string; +export type ActionId = string; +export type SubflowId = string; +export type EdgeId = string; +export type VariableName = string; + +// ================================ +// Edge Labels +// ================================ + +export const EDGE_LABELS = { + DEFAULT: 'default', + TRUE: 'true', + FALSE: 'false', + ON_ERROR: 'onError', +} as const; + +export type BuiltinEdgeLabel = (typeof EDGE_LABELS)[keyof typeof EDGE_LABELS]; +export type EdgeLabel = string; + +// ================================ +// 错误处理 +// ================================ + +export type ActionErrorCode = + | 'VALIDATION_ERROR' + | 'TIMEOUT' + | 'TAB_NOT_FOUND' + | 'FRAME_NOT_FOUND' + | 'TARGET_NOT_FOUND' + | 'ELEMENT_NOT_VISIBLE' + | 'NAVIGATION_FAILED' + | 'NETWORK_REQUEST_FAILED' + | 'DOWNLOAD_FAILED' + | 'ASSERTION_FAILED' + | 'SCRIPT_FAILED' + | 'UNKNOWN'; + +export interface ActionError { + code: ActionErrorCode; + message: string; + data?: JsonValue; +} + +// ================================ +// 执行策略 +// ================================ + +export interface TimeoutPolicy { + ms: Milliseconds; + /** 'attempt' = 每次尝试独立计时, 'action' = 整个 action 总计时 */ + scope?: 'attempt' | 'action'; +} + +export type BackoffKind = 'none' | 'exp' | 'linear'; + +export interface RetryPolicy { + /** 重试次数（不含首次尝试） */ + retries: number; + /** 重试间隔 */ + intervalMs: Milliseconds; + /** 退避策略 */ + backoff?: BackoffKind; + /** 最大间隔（用于 exp/linear） */ + maxIntervalMs?: Milliseconds; + /** 抖动策略 */ + jitter?: 'none' | 'full'; + /** 仅在这些错误码时重试 */ + retryOn?: ReadonlyArray; +} + +export type ErrorHandlingStrategy = + | { kind: 'stop' } + | { kind: 'continue'; level?: 'warning' | 'error' } + | { kind: 'goto'; label: EdgeLabel }; + +export interface ArtifactCapturePolicy { + screenshot?: 'never' | 'onFailure' | 'always'; + saveScreenshotAs?: VariableName; + includeConsole?: boolean; + includeNetwork?: boolean; +} + +export interface ActionPolicy { + timeout?: TimeoutPolicy; + retry?: RetryPolicy; + onError?: ErrorHandlingStrategy; + artifacts?: ArtifactCapturePolicy; +} + +// ================================ +// 变量系统 +// ================================ + +export interface VariableDefinitionBase { + name: VariableName; + label?: string; + description?: string; + sensitive?: boolean; + required?: boolean; +} + +export interface VariableStringRules { + pattern?: string; + minLength?: number; + maxLength?: number; +} + +export interface VariableNumberRules { + min?: number; + max?: number; + integer?: boolean; +} + +export type VariableDefinition = + | (VariableDefinitionBase & { + kind: 'string'; + default?: string; + rules?: VariableStringRules; + }) + | (VariableDefinitionBase & { + kind: 'number'; + default?: number; + rules?: VariableNumberRules; + }) + | (VariableDefinitionBase & { + kind: 'boolean'; + default?: boolean; + }) + | (VariableDefinitionBase & { + kind: 'enum'; + options: NonEmptyArray; + default?: string; + }) + | (VariableDefinitionBase & { + kind: 'array'; + item: 'string' | 'number' | 'boolean' | 'json'; + default?: JsonValue[]; + }) + | (VariableDefinitionBase & { + kind: 'json'; + default?: JsonValue; + }); + +export type VariableStore = Record; + +export type VariableScope = 'flow' | 'run' | 'env' | 'secret'; +export type VariablePathSegment = string | number; + +export interface VariablePointer { + scope?: VariableScope; + name: VariableName; + path?: ReadonlyArray; +} + +// ================================ +// 表达式和模板 +// ================================ + +export type ExpressionLanguage = 'js' | 'rr'; + +export interface Expression<_T = JsonValue> { + language: ExpressionLanguage; + code: string; +} + +export interface VariableValue { + kind: 'var'; + ref: VariablePointer; + default?: T; +} + +export interface ExpressionValue { + kind: 'expr'; + expr: Expression; + default?: T; +} + +export type TemplateFormat = 'text' | 'json' | 'urlEncoded'; + +export type TemplatePart = + | { kind: 'text'; value: string } + | { kind: 'insert'; value: Resolvable; format?: TemplateFormat }; + +export interface StringTemplate { + kind: 'template'; + parts: NonEmptyArray; +} + +export type Resolvable = + | T + | VariableValue + | ExpressionValue + | ([T] extends [string] ? StringTemplate : never); + +export type DataPath = string; // dot/bracket path: e.g. "data.items[0].id" +export type Assignments = Record; + +// ================================ +// 条件表达式 +// ================================ + +export type CompareOp = + | 'eq' + | 'eqi' + | 'neq' + | 'gt' + | 'gte' + | 'lt' + | 'lte' + | 'contains' + | 'containsI' + | 'notContains' + | 'notContainsI' + | 'startsWith' + | 'endsWith' + | 'regex'; + +export type Condition = + | { kind: 'expr'; expr: Expression } + | { + kind: 'compare'; + left: Resolvable; + op: CompareOp; + right: Resolvable; + } + | { kind: 'truthy'; value: Resolvable } + | { kind: 'falsy'; value: Resolvable } + | { kind: 'not'; condition: Condition } + | { kind: 'and'; conditions: NonEmptyArray } + | { kind: 'or'; conditions: NonEmptyArray }; + +// ================================ +// 选择器系统 +// ================================ + +export type SelectorCandidateSource = 'recorded' | 'user' | 'generated'; + +export interface SelectorStability { + /** 稳定性评分 0-1 */ + score: number; + signals?: { + usesId?: boolean; + usesAria?: boolean; + usesText?: boolean; + usesNthOfType?: boolean; + usesAttributes?: boolean; + usesClass?: boolean; + }; + note?: string; +} + +export interface SelectorCandidateBase { + weight?: number; + stability?: SelectorStability; + source?: SelectorCandidateSource; +} + +export type SelectorCandidate = + | (SelectorCandidateBase & { type: 'css'; selector: Resolvable }) + | (SelectorCandidateBase & { type: 'xpath'; xpath: Resolvable }) + | (SelectorCandidateBase & { type: 'attr'; selector: Resolvable }) + | (SelectorCandidateBase & { + type: 'aria'; + role?: Resolvable; + name?: Resolvable; + }) + | (SelectorCandidateBase & { + type: 'text'; + text: Resolvable; + tagNameHint?: string; + match?: 'exact' | 'contains'; + }); + +export type FrameTarget = + | { kind: 'top' } + | { kind: 'index'; index: Resolvable } + | { kind: 'urlContains'; value: Resolvable }; + +export interface TargetHint { + tagName?: string; + role?: string; + name?: string; + text?: string; +} + +export interface ElementTargetBase { + frame?: FrameTarget; + hint?: TargetHint; +} + +export type ElementTarget = + | (ElementTargetBase & { + /** 临时引用（快速路径） */ + ref: string; + candidates?: ReadonlyArray; + }) + | (ElementTargetBase & { + ref?: string; + candidates: NonEmptyArray; + }); + +// ================================ +// Action 参数定义 +// ================================ + +export type BrowserWorld = 'MAIN' | 'ISOLATED'; + +// --- 页面交互 --- + +export interface ClickParams { + target: ElementTarget; + button?: 'left' | 'middle' | 'right'; + before?: { scrollIntoView?: boolean; waitForSelector?: boolean }; + after?: { waitForNavigation?: boolean; waitForNetworkIdle?: boolean }; +} + +export interface FillParams { + target: ElementTarget; + value: Resolvable; + clearFirst?: boolean; + mode?: 'replace' | 'append'; +} + +export interface KeyParams { + keys: Resolvable; // e.g. "Backspace Enter" or "cmd+a" + target?: ElementTarget; +} + +export type ScrollMode = 'element' | 'offset' | 'container'; + +export interface ScrollOffset { + x?: Resolvable; + y?: Resolvable; +} + +export interface ScrollParams { + mode: ScrollMode; + target?: ElementTarget; + offset?: ScrollOffset; +} + +export interface Point { + x: number; + y: number; +} + +export interface DragParams { + start: ElementTarget; + end: ElementTarget; + path?: ReadonlyArray; +} + +// --- 导航 --- + +export interface NavigateParams { + url: Resolvable; + refresh?: boolean; +} + +// --- 等待和断言 --- + +export type WaitCondition = + | { kind: 'sleep'; sleep: Resolvable } + | { kind: 'navigation' } + | { kind: 'networkIdle'; idleMs?: Resolvable } + | { kind: 'text'; text: Resolvable; appear?: boolean } + | { kind: 'selector'; selector: Resolvable; visible?: boolean }; + +export interface WaitParams { + condition: WaitCondition; +} + +export type Assertion = + | { kind: 'exists'; selector: Resolvable } + | { kind: 'visible'; selector: Resolvable } + | { kind: 'textPresent'; text: Resolvable } + | { + kind: 'attribute'; + selector: Resolvable; + name: Resolvable; + equals?: Resolvable; + matches?: Resolvable; + }; + +export type AssertFailStrategy = 'stop' | 'warn' | 'retry'; + +export interface AssertParams { + assert: Assertion; + failStrategy?: AssertFailStrategy; +} + +// --- 数据和脚本 --- + +export type ExtractParams = + | { + mode: 'selector'; + selector: Resolvable; + attr?: Resolvable; // "text" | "textContent" | attribute name + saveAs: VariableName; + } + | { + mode: 'js'; + code: string; + world?: BrowserWorld; + saveAs: VariableName; + }; + +export type ScriptTiming = 'before' | 'after'; + +export interface ScriptParams { + world?: BrowserWorld; + code: string; + when?: ScriptTiming; + args?: Record>; + saveAs?: VariableName; + assign?: Assignments; +} + +export interface ScreenshotParams { + selector?: Resolvable; + fullPage?: boolean; + saveAs?: VariableName; +} + +// --- HTTP --- + +export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; +export type HttpHeaders = Record>; +export type HttpFormData = Record>; + +export type HttpBody = + | { kind: 'none' } + | { kind: 'text'; text: Resolvable; contentType?: Resolvable } + | { kind: 'json'; json: Resolvable }; + +export type HttpOkStatus = + | { kind: 'range'; min: number; max: number } + | { kind: 'list'; statuses: NonEmptyArray }; + +export interface HttpParams { + method?: HttpMethod; + url: Resolvable; + headers?: HttpHeaders; + body?: HttpBody; + formData?: HttpFormData; + okStatus?: HttpOkStatus; + saveAs?: VariableName; + assign?: Assignments; +} + +// --- DOM 工具 --- + +export interface TriggerEventParams { + target: ElementTarget; + event: Resolvable; + bubbles?: boolean; + cancelable?: boolean; +} + +export interface SetAttributeParams { + target: ElementTarget; + name: Resolvable; + value?: Resolvable; + remove?: boolean; +} + +export interface SwitchFrameParams { + target: FrameTarget; +} + +export interface LoopElementsParams { + selector: Resolvable; + saveAs?: VariableName; + itemVar?: VariableName; + subflowId: SubflowId; +} + +// --- 标签页管理 --- + +export interface OpenTabParams { + url?: Resolvable; + newWindow?: boolean; +} + +export interface SwitchTabParams { + tabId?: number; + urlContains?: Resolvable; + titleContains?: Resolvable; +} + +export interface CloseTabParams { + tabIds?: ReadonlyArray; + url?: Resolvable; +} + +export interface HandleDownloadParams { + filenameContains?: Resolvable; + waitForComplete?: boolean; + saveAs?: VariableName; +} + +// --- 控制流 --- + +export interface ExecuteFlowParams { + flowId: FlowId; + inline?: boolean; + args?: Record>; +} + +export interface ForeachParams { + listVar: VariableName; + itemVar?: VariableName; + subflowId: SubflowId; + concurrency?: number; +} + +export interface WhileParams { + condition: Condition; + subflowId: SubflowId; + maxIterations?: number; +} + +export interface IfBranch { + id: string; + label: EdgeLabel; + condition: Condition; +} + +export type IfParams = + | { + mode: 'binary'; + condition: Condition; + trueLabel?: EdgeLabel; + falseLabel?: EdgeLabel; + } + | { + mode: 'branches'; + branches: NonEmptyArray; + elseLabel?: EdgeLabel; + }; + +export interface DelayParams { + sleep: Resolvable; +} + +// --- 触发器 --- + +export type TriggerUrlRuleKind = 'url' | 'domain' | 'path'; + +export interface TriggerUrlRule { + kind: TriggerUrlRuleKind; + value: Resolvable; +} + +export interface TriggerUrlConfig { + rules?: ReadonlyArray; +} + +export interface TriggerModeConfig { + manual?: boolean; + url?: boolean; + contextMenu?: boolean; + command?: boolean; + dom?: boolean; + schedule?: boolean; +} + +export interface TriggerContextMenuConfig { + title?: Resolvable; + enabled?: boolean; +} + +export interface TriggerCommandConfig { + commandKey?: Resolvable; + enabled?: boolean; +} + +export interface TriggerDomConfig { + selector?: Resolvable; + appear?: boolean; + once?: boolean; + debounceMs?: Milliseconds; + enabled?: boolean; +} + +export type TriggerScheduleType = 'once' | 'interval' | 'daily'; + +export interface TriggerSchedule { + id: string; + type: TriggerScheduleType; + when: Resolvable; // ISO/cron-like string + enabled?: boolean; +} + +export interface TriggerParams { + enabled?: boolean; + description?: Resolvable; + modes?: TriggerModeConfig; + url?: TriggerUrlConfig; + contextMenu?: TriggerContextMenuConfig; + command?: TriggerCommandConfig; + dom?: TriggerDomConfig; + schedules?: ReadonlyArray; +} + +// ================================ +// Action 核心定义 +// ================================ + +/** + * ActionParamsByType 使用 interface 声明 + * 允许外部模块通过声明合并扩展 Action 类型（符合 OCP 原则） + */ +export interface ActionParamsByType { + // UI/构建时 + trigger: TriggerParams; + delay: DelayParams; + + // 页面交互 + click: ClickParams; + dblclick: ClickParams; + fill: FillParams; + key: KeyParams; + scroll: ScrollParams; + drag: DragParams; + + // 同步和验证 + wait: WaitParams; + assert: AssertParams; + + // 数据和脚本 + extract: ExtractParams; + script: ScriptParams; + http: HttpParams; + screenshot: ScreenshotParams; + + // DOM 工具 + triggerEvent: TriggerEventParams; + setAttribute: SetAttributeParams; + + // 帧和循环 + switchFrame: SwitchFrameParams; + loopElements: LoopElementsParams; + + // 控制流 + if: IfParams; + foreach: ForeachParams; + while: WhileParams; + executeFlow: ExecuteFlowParams; + + // 标签页 + navigate: NavigateParams; + openTab: OpenTabParams; + switchTab: SwitchTabParams; + closeTab: CloseTabParams; + handleDownload: HandleDownloadParams; +} + +export type ActionType = keyof ActionParamsByType; + +export interface ActionBase { + id: ActionId; + type: T; + name?: string; + disabled?: boolean; + tags?: ReadonlyArray; + policy?: ActionPolicy; + ui?: { x: number; y: number }; +} + +export type Action = ActionBase & { + params: ActionParamsByType[T]; +}; + +export type AnyAction = { [T in ActionType]: Action }[ActionType]; + +export type ExecutableActionType = Exclude; +export type ExecutableAction = Action; + +// ================================ +// Action 输出 +// ================================ + +export interface HttpResponse { + url: string; + status: number; + headers?: Record; + body?: JsonValue | string | null; +} + +export type DownloadState = 'in_progress' | 'complete' | 'interrupted' | 'canceled'; + +export interface DownloadInfo { + id: string; + filename: string; + url?: string; + state?: DownloadState; + size?: number; +} + +/** + * Action 输出类型映射（可通过声明合并扩展） + */ +export interface ActionOutputsByType { + screenshot: { base64Data: string }; + extract: { value: JsonValue }; + script: { result: JsonValue }; + http: { response: HttpResponse }; + handleDownload: { download: DownloadInfo }; + loopElements: { elements: string[] }; +} + +export type ActionOutput = T extends keyof ActionOutputsByType + ? ActionOutputsByType[T] + : undefined; + +// ================================ +// 执行接口 +// ================================ + +export type ValidationResult = { ok: true } | { ok: false; errors: NonEmptyArray }; + +/** + * Execution flags for coordinating with orchestrator policies. + * Used to avoid duplicate retry/nav-wait when StepRunner owns these policies. + */ +export interface ExecutionFlags { + /** + * When true, navigation waiting should be handled by StepRunner. + * Action handlers (click, navigate) should skip their internal nav-wait logic. + */ + skipNavWait?: boolean; +} + +export interface ActionExecutionContext { + vars: VariableStore; + tabId: number; + frameId?: number; + runId?: string; + /** 日志记录函数 */ + log: (message: string, level?: 'info' | 'warn' | 'error') => void; + /** 截图函数 */ + captureScreenshot?: () => Promise; + /** + * Optional structured log sink for replay UIs (legacy RunLogger integration). + * Action handlers may emit richer entries (e.g. selector fallback) via this hook. + */ + pushLog?: (entry: unknown) => void; + /** + * Execution flags provided by the orchestrator. + * Handlers should respect these flags to avoid duplicating StepRunner policies. + */ + execution?: ExecutionFlags; +} + +export type ControlDirective = + | { + kind: 'foreach'; + listVar: VariableName; + itemVar: VariableName; + subflowId: SubflowId; + concurrency?: number; + } + | { + kind: 'while'; + condition: Condition; + subflowId: SubflowId; + maxIterations: number; + }; + +export interface ActionExecutionResult { + status: 'success' | 'failed' | 'skipped' | 'paused'; + output?: ActionOutput; + error?: ActionError; + /** 下一个边的 label（用于条件分支） */ + nextLabel?: EdgeLabel; + /** 控制流指令（foreach/while） */ + control?: ControlDirective; + /** 执行耗时 */ + durationMs?: Milliseconds; + /** + * New tab ID after tab operations (openTab/switchTab). + * Used to update execution context for subsequent steps. + */ + newTabId?: number; +} + +/** + * Action 执行器接口 + */ +export interface ActionHandler { + type: T; + /** 验证 action 配置 */ + validate?: (action: Action) => ValidationResult; + /** 执行 action */ + run: (ctx: ActionExecutionContext, action: Action) => Promise>; + /** 生成 action 描述（用于 UI 显示） */ + describe?: (action: Action) => string; +} + +// ================================ +// Flow 图结构 +// ================================ + +export interface ActionEdge { + id: EdgeId; + from: ActionId; + to: ActionId; + label?: EdgeLabel; +} + +export interface FlowBinding { + type: 'domain' | 'path' | 'url'; + value: string; +} + +export interface FlowMeta { + createdAt: ISODateTimeString; + updatedAt: ISODateTimeString; + domain?: string; + tags?: ReadonlyArray; + bindings?: ReadonlyArray; + tool?: { category?: string; description?: string }; + exposedOutputs?: ReadonlyArray<{ nodeId: ActionId; as: VariableName }>; +} + +export interface Flow { + id: FlowId; + name: string; + description?: string; + version: number; + meta: FlowMeta; + variables?: ReadonlyArray; + + /** DAG 节点 */ + nodes: ReadonlyArray; + /** DAG 边 */ + edges: ReadonlyArray; + /** 子流程（用于 foreach/while/loopElements） */ + subflows?: Record< + SubflowId, + { nodes: ReadonlyArray; edges: ReadonlyArray } + >; +} + +// ================================ +// Action 规格（用于 UI） +// ================================ + +export type ActionCategory = 'Flow' | 'Actions' | 'Logic' | 'Tools' | 'Tabs' | 'Page'; + +export interface ActionSpecDisplay { + label: string; + description?: string; + category: ActionCategory; + icon?: string; + docUrl?: string; +} + +export interface ActionSpecPorts { + inputs: number | 'any'; + outputs: Array<{ label?: EdgeLabel }> | 'any'; + maxConnection?: number; + allowedInputs?: boolean; +} + +export interface ActionSpec { + type: T; + version: number; + display: ActionSpecDisplay; + ports: ActionSpecPorts; + defaults?: Partial; + /** 需要进行模板替换的字段路径 */ + refDataKeys?: ReadonlyArray; +} + +// ================================ +// 常量导出 +// ================================ + +export const ACTION_TYPES: ReadonlyArray = [ + 'trigger', + 'delay', + 'click', + 'dblclick', + 'fill', + 'key', + 'scroll', + 'drag', + 'wait', + 'assert', + 'extract', + 'script', + 'http', + 'screenshot', + 'triggerEvent', + 'setAttribute', + 'switchFrame', + 'loopElements', + 'if', + 'foreach', + 'while', + 'executeFlow', + 'navigate', + 'openTab', + 'switchTab', + 'closeTab', + 'handleDownload', +] as const; + +export const EXECUTABLE_ACTION_TYPES: ReadonlyArray = ACTION_TYPES.filter( + (t): t is ExecutableActionType => t !== 'trigger', +); diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/constants.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/constants.ts new file mode 100644 index 00000000..c30e462c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/constants.ts @@ -0,0 +1,31 @@ +// constants.ts — centralized engine constants and labels +import { EDGE_LABELS } from 'chrome-mcp-shared'; + +export const ENGINE_CONSTANTS = { + DEFAULT_WAIT_MS: 5000, + MAX_WAIT_MS: 120000, + NETWORK_IDLE_SAMPLE_MS: 1200, + MAX_ITERATIONS: 1000, + MAX_FOREACH_CONCURRENCY: 16, + EDGE_LABELS: EDGE_LABELS, +} as const; + +export type EdgeLabel = + (typeof ENGINE_CONSTANTS.EDGE_LABELS)[keyof typeof ENGINE_CONSTANTS.EDGE_LABELS]; + +// Centralized stepId values used in run logs for non-step events +export const LOG_STEP_IDS = { + GLOBAL_TIMEOUT: 'global-timeout', + PLUGIN_RUN_START: 'plugin-runStart', + VARIABLE_COLLECT: 'variable-collect', + BINDING_CHECK: 'binding-check', + NETWORK_CAPTURE: 'network-capture', + DAG_REQUIRED: 'dag-required', + DAG_CYCLE: 'dag-cycle', + LOOP_GUARD: 'loop-guard', + PLUGIN_RUN_END: 'plugin-runEnd', + RUNSTATE_UPDATE: 'runState-update', + RUNSTATE_DELETE: 'runState-delete', +} as const; + +export type LogStepId = (typeof LOG_STEP_IDS)[keyof typeof LOG_STEP_IDS]; diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/execution-mode.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/execution-mode.ts new file mode 100644 index 00000000..2d7d9ef3 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/execution-mode.ts @@ -0,0 +1,237 @@ +/** + * Execution Mode Configuration + * + * Controls whether step execution uses the legacy node system or the new ActionRegistry. + * Provides a migration path from legacy to actions with hybrid mode for gradual rollout. + * + * Modes: + * - 'legacy': Use the existing executeStep from nodes/index.ts (default, safest) + * - 'actions': Use ActionRegistry exclusively (strict mode, throws on unsupported) + * - 'hybrid': Try ActionRegistry first, fall back to legacy for unsupported types + */ + +import type { Step } from '../types'; + +/** + * Execution mode determines how steps are executed + */ +export type ExecutionMode = 'legacy' | 'actions' | 'hybrid'; + +/** + * Configuration for execution mode + */ +export interface ExecutionModeConfig { + /** + * The execution mode to use + * @default 'legacy' + */ + mode: ExecutionMode; + + /** + * Step types that should always use legacy execution (denylist for actions) + * Only applies in hybrid mode + */ + legacyOnlyTypes?: Set; + + /** + * Step types that should use actions execution (allowlist) + * Only applies in hybrid mode. + * - If undefined: uses MINIMAL_HYBRID_ACTION_TYPES (safest default) + * - If empty Set (size=0): falls back to MIGRATED_ACTION_TYPES policy + * - If non-empty Set: only these types use actions + */ + actionsAllowlist?: Set; + + /** + * Whether to log when falling back from actions to legacy in hybrid mode + * @default true + */ + logFallbacks?: boolean; + + /** + * Skip ActionRegistry's built-in retry policy. + * When true, action.policy.retry is removed before execution. + * @default true - StepRunner already handles retry via withRetry() + * + * Note: ActionRegistry timeout is NOT disabled (provides per-action timeout safety). + */ + skipActionsRetry?: boolean; + + /** + * Skip ActionRegistry's navigation waiting when StepRunner handles it + * @default true - StepRunner already handles navigation waiting + */ + skipActionsNavWait?: boolean; +} + +/** + * Default execution mode configuration + * Starts with legacy mode for maximum safety during migration + */ +export const DEFAULT_EXECUTION_MODE_CONFIG: ExecutionModeConfig = { + mode: 'legacy', + logFallbacks: true, + skipActionsRetry: true, + skipActionsNavWait: true, +}; + +/** + * Minimal allowlist for initial hybrid rollout. + * + * This keeps high-risk step types (navigation/click/tab management) on legacy + * until policy (retry/timeout/nav-wait) and tab cursor semantics are unified. + * + * These types are chosen for their low risk: + * - No navigation side effects + * - No tab management + * - No complex timing requirements + * - Simple input/output semantics + */ +export const MINIMAL_HYBRID_ACTION_TYPES = new Set([ + 'fill', // Form input - no navigation + 'key', // Keyboard input - no navigation + 'scroll', // Viewport manipulation - no navigation + 'drag', // Drag and drop - local operation + 'wait', // Condition waiting - no side effects + 'delay', // Simple delay - no side effects + 'screenshot', // Capture only - no side effects + 'assert', // Validation only - no side effects +]); + +/** + * Step types that are fully migrated and tested with ActionRegistry + * These are safe to run in actions mode + * + * NOTE: Start conservative and expand gradually as testing confirms equivalence. + * Types NOT included here will fall back to legacy in hybrid mode. + * + * Criteria for inclusion: + * 1. Handler implementation matches legacy behavior exactly + * 2. Step data structure is compatible (no complex transformation needed) + * 3. No timing-sensitive dependencies (like script when:'after' defer) + */ +export const MIGRATED_ACTION_TYPES = new Set([ + // Navigation - well tested, simple mapping + 'navigate', + // Interaction - well tested, core functionality + 'click', + 'dblclick', + 'fill', + 'key', + 'scroll', + 'drag', + // Timing - simple logic, no complex state + 'wait', + 'delay', + // Screenshot - simple, no side effects + 'screenshot', + // Assert - validation only, no state changes + 'assert', +]); + +/** + * Step types that need more validation before migration + * These are supported by ActionRegistry but may have behavior differences + */ +export const NEEDS_VALIDATION_TYPES = new Set([ + // Data extraction - need to verify selector/js mode equivalence + 'extract', + // HTTP - body type handling may differ + 'http', + // Script - when:'after' defer semantics differ from legacy + 'script', + // Tabs - tabId tracking needs careful integration + 'openTab', + 'switchTab', + 'closeTab', + 'handleDownload', + // Control flow - condition evaluation may differ + 'if', + 'foreach', + 'while', + 'switchFrame', +]); + +/** + * Step types that must use legacy execution + * These have complex integration requirements not yet supported by ActionRegistry + */ +export const LEGACY_ONLY_TYPES = new Set([ + // Complex legacy types not yet migrated + 'triggerEvent', + 'setAttribute', + 'loopElements', + 'executeFlow', +]); + +/** + * Determine whether a step should use actions execution based on config + */ +export function shouldUseActions(step: Step, config: ExecutionModeConfig): boolean { + if (config.mode === 'legacy') { + return false; + } + + if (config.mode === 'actions') { + return true; + } + + // Hybrid mode: check allowlist/denylist + const stepType = step.type; + + // Denylist takes precedence + if (config.legacyOnlyTypes?.has(stepType)) { + return false; + } + + // If allowlist is specified and non-empty, step must be in it + if (config.actionsAllowlist && config.actionsAllowlist.size > 0) { + return config.actionsAllowlist.has(stepType); + } + + // Default to using actions for supported types + return MIGRATED_ACTION_TYPES.has(stepType); +} + +/** + * Create a hybrid execution mode config for gradual migration. + * + * By default uses MINIMAL_HYBRID_ACTION_TYPES as allowlist, which excludes + * high-risk types (navigate/click/tab management) from actions execution. + * + * @param overrides - Optional overrides for the config + * @param overrides.actionsAllowlist - Set of step types to execute via actions. + * If provided with size > 0, only these types use actions. + * If empty Set, falls back to MIGRATED_ACTION_TYPES. + * If undefined, uses MINIMAL_HYBRID_ACTION_TYPES (safest default). + */ +export function createHybridConfig(overrides?: Partial): ExecutionModeConfig { + return { + ...DEFAULT_EXECUTION_MODE_CONFIG, + mode: 'hybrid', + legacyOnlyTypes: new Set(LEGACY_ONLY_TYPES), + actionsAllowlist: new Set(MINIMAL_HYBRID_ACTION_TYPES), + ...overrides, + }; +} + +/** + * Create a strict actions mode config for testing. + * All steps must be handled by ActionRegistry or throw. + * + * Note: Even in actions mode, StepRunner remains the policy authority for + * retry/nav-wait. This ensures consistent behavior across all execution modes + * and avoids double-strategy issues. + */ +export function createActionsOnlyConfig( + overrides?: Partial, +): ExecutionModeConfig { + return { + ...DEFAULT_EXECUTION_MODE_CONFIG, + mode: 'actions', + // Keep StepRunner as policy authority - skip ActionRegistry's internal policies + skipActionsRetry: true, + skipActionsNavWait: true, + ...overrides, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/logging/run-logger.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/logging/run-logger.ts new file mode 100644 index 00000000..419799b0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/logging/run-logger.ts @@ -0,0 +1,69 @@ +// engine/logging/run-logger.ts — run logs, overlay and persistence +import type { RunLogEntry, RunRecord, Flow } from '../../types'; +import { appendRun } from '../../flow-store'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; + +export class RunLogger { + private logs: RunLogEntry[] = []; + constructor(private runId: string) {} + + push(e: RunLogEntry) { + this.logs.push(e); + } + + getLogs() { + return this.logs; + } + + async overlayInit() { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + if (tabs[0]?.id) + await chrome.tabs.sendMessage(tabs[0].id, { action: 'rr_overlay', cmd: 'init' } as any); + } catch {} + } + + async overlayAppend(text: string) { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + if (tabs[0]?.id) + await chrome.tabs.sendMessage(tabs[0].id, { + action: 'rr_overlay', + cmd: 'append', + text, + } as any); + } catch {} + } + + async overlayDone() { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + if (tabs[0]?.id) + await chrome.tabs.sendMessage(tabs[0].id, { action: 'rr_overlay', cmd: 'done' } as any); + } catch {} + } + + async screenshotOnFailure() { + try { + const shot = await handleCallTool({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: { action: 'screenshot' }, + }); + const img = (shot?.content?.find((c: any) => c.type === 'image') as any)?.data as string; + if (img) this.logs[this.logs.length - 1].screenshotBase64 = img; + } catch {} + } + + async persist(flow: Flow, startedAt: number, success: boolean) { + const record: RunRecord = { + id: this.runId, + flowId: flow.id, + startedAt: new Date(startedAt).toISOString(), + finishedAt: new Date().toISOString(), + success, + entries: this.logs, + }; + await appendRun(record); + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/breakpoint.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/breakpoint.ts new file mode 100644 index 00000000..0d668a17 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/breakpoint.ts @@ -0,0 +1,19 @@ +import type { RunPlugin, StepContext } from './types'; +import { runState } from '../state-manager'; + +export function breakpointPlugin(): RunPlugin { + return { + name: 'breakpoint', + async onBeforeStep(ctx: StepContext) { + try { + const step: any = ctx.step as any; + const hasBreakpoint = step?.$breakpoint === true || step?.breakpoint === true; + if (!hasBreakpoint) return; + // mark run paused for external UI to resume + await runState.update(ctx.runId, { status: 'stopped', updatedAt: Date.now() } as any); + return { pause: true }; + } catch {} + return; + }, + }; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/manager.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/manager.ts new file mode 100644 index 00000000..509a463e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/manager.ts @@ -0,0 +1,74 @@ +import type { + RunPlugin, + HookControl, + RunContext, + StepContext, + StepAfterContext, + StepErrorContext, + StepRetryContext, + RunEndContext, + SubflowContext, +} from './types'; + +export class PluginManager { + constructor(private plugins: RunPlugin[]) {} + + async runStart(ctx: RunContext) { + for (const p of this.plugins) await safeCall(p, 'onRunStart', ctx); + } + + async beforeStep(ctx: StepContext): Promise { + for (const p of this.plugins) { + const out = await safeCall(p, 'onBeforeStep', ctx); + if (out && (out.pause || out.nextLabel)) return out; + } + return undefined; + } + + async afterStep(ctx: StepAfterContext) { + for (const p of this.plugins) await safeCall(p, 'onAfterStep', ctx); + } + + async onError(ctx: StepErrorContext): Promise { + for (const p of this.plugins) { + const out = await safeCall(p, 'onStepError', ctx); + if (out && (out.pause || out.nextLabel)) return out; + } + return undefined; + } + + async onRetry(ctx: StepRetryContext) { + for (const p of this.plugins) await safeCall(p, 'onRetry', ctx); + } + + async onChooseNextLabel(ctx: StepContext & { suggested?: string }): Promise { + for (const p of this.plugins) { + const out = await safeCall(p, 'onChooseNextLabel', ctx); + if (out && out.nextLabel) return String(out.nextLabel); + } + return undefined; + } + + async subflowStart(ctx: SubflowContext) { + for (const p of this.plugins) await safeCall(p, 'onSubflowStart', ctx); + } + + async subflowEnd(ctx: SubflowContext) { + for (const p of this.plugins) await safeCall(p, 'onSubflowEnd', ctx); + } + + async runEnd(ctx: RunEndContext) { + for (const p of this.plugins) await safeCall(p, 'onRunEnd', ctx); + } +} + +async function safeCall(plugin: RunPlugin, key: T, arg: any) { + try { + const fn = plugin[key] as any; + if (typeof fn === 'function') return await fn.call(plugin, arg); + } catch (e) { + // swallow plugin errors to keep core stable + // console.warn(`[plugin:${plugin.name}] ${String(key)} error:`, e); + } + return undefined; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/types.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/types.ts new file mode 100644 index 00000000..b27cac49 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/plugins/types.ts @@ -0,0 +1,56 @@ +// Plugin system for record-replay engine +// Inspired by webpack-like lifecycle hooks, to avoid touching core for extensibility + +import type { Flow, Step } from '../../types'; +import type { ExecResult } from '../../nodes'; + +export interface RunContext { + runId: string; + flow: Flow; + vars: Record; +} + +export interface StepContext extends RunContext { + step: Step; +} + +export interface StepErrorContext extends StepContext { + error: any; +} + +export interface StepRetryContext extends StepErrorContext { + attempt: number; +} + +export interface StepAfterContext extends StepContext { + result?: ExecResult; +} + +export interface SubflowContext extends RunContext { + subflowId: string; +} + +export interface RunEndContext extends RunContext { + success: boolean; + failed: number; +} + +export interface HookControl { + pause?: boolean; // request scheduler to pause run (e.g., breakpoint) + nextLabel?: string; // override next edge label +} + +export interface RunPlugin { + name: string; + onRunStart?(ctx: RunContext): Promise | void; + onBeforeStep?(ctx: StepContext): Promise | HookControl | void; + onAfterStep?(ctx: StepAfterContext): Promise | void; + onStepError?(ctx: StepErrorContext): Promise | HookControl | void; + onRetry?(ctx: StepRetryContext): Promise | void; + onChooseNextLabel?( + ctx: StepContext & { suggested?: string }, + ): Promise | HookControl | void; + onSubflowStart?(ctx: SubflowContext): Promise | void; + onSubflowEnd?(ctx: SubflowContext): Promise | void; + onRunEnd?(ctx: RunEndContext): Promise | void; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/policies/retry.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/policies/retry.ts new file mode 100644 index 00000000..3b0cb4af --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/policies/retry.ts @@ -0,0 +1,31 @@ +// engine/policies/retry.ts — unified retry/backoff policy + +export type BackoffKind = 'none' | 'exp'; + +export interface RetryOptions { + count?: number; // max attempts beyond the first run + intervalMs?: number; + backoff?: BackoffKind; +} + +export async function withRetry( + run: () => Promise, + onRetry?: (attempt: number, err: any) => Promise | void, + opts?: RetryOptions, +): Promise { + const max = Math.max(0, Number(opts?.count ?? 0)); + const base = Math.max(0, Number(opts?.intervalMs ?? 0)); + const backoff = (opts?.backoff || 'none') as BackoffKind; + let attempt = 0; + while (true) { + try { + return await run(); + } catch (e) { + if (attempt >= max) throw e; + if (onRetry) await onRetry(attempt, e); + const delay = base > 0 ? (backoff === 'exp' ? base * Math.pow(2, attempt) : base) : 0; + if (delay > 0) await new Promise((r) => setTimeout(r, delay)); + attempt += 1; + } + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/policies/wait.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/policies/wait.ts new file mode 100644 index 00000000..67f26fe6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/policies/wait.ts @@ -0,0 +1,94 @@ +// engine/policies/wait.ts — wrappers around rr-utils navigation/network waits +// Keep logic centralized to avoid duplication in schedulers and nodes + +import { handleCallTool } from '@/entrypoints/background/tools'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { waitForNavigation as rrWaitForNavigation, waitForNetworkIdle } from '../../rr-utils'; + +export async function waitForNavigationDone(prevUrl: string, timeoutMs?: number) { + await rrWaitForNavigation(timeoutMs, prevUrl); +} + +export async function ensureReadPageIfWeb() { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const url = tabs?.[0]?.url || ''; + if (/^(https?:|file:)/i.test(url)) { + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + } + } catch {} +} + +export async function maybeQuickWaitForNav(prevUrl: string, timeoutMs?: number) { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') return; + const sniffMs = 350; + const startedAt = Date.now(); + let seen = false; + await new Promise((resolve) => { + let timer: any = null; + const cleanup = () => { + try { + chrome.webNavigation.onCommitted.removeListener(onCommitted); + } catch {} + try { + chrome.webNavigation.onCompleted.removeListener(onCompleted); + } catch {} + try { + (chrome.webNavigation as any).onHistoryStateUpdated?.removeListener?.( + onHistoryStateUpdated, + ); + } catch {} + try { + chrome.tabs.onUpdated.removeListener(onUpdated); + } catch {} + if (timer) { + try { + clearTimeout(timer); + } catch {} + } + }; + const finish = async () => { + cleanup(); + if (seen) { + try { + await rrWaitForNavigation( + prevUrl ? Math.min(timeoutMs || 15000, 30000) : undefined, + prevUrl, + ); + } catch {} + } + resolve(); + }; + const mark = () => { + seen = true; + }; + const onCommitted = (d: any) => { + if (d.tabId === tabId && d.frameId === 0 && d.timeStamp >= startedAt) mark(); + }; + const onCompleted = (d: any) => { + if (d.tabId === tabId && d.frameId === 0 && d.timeStamp >= startedAt) mark(); + }; + const onHistoryStateUpdated = (d: any) => { + if (d.tabId === tabId && d.frameId === 0 && d.timeStamp >= startedAt) mark(); + }; + const onUpdated = (updatedId: number, change: chrome.tabs.TabChangeInfo) => { + if (updatedId !== tabId) return; + if (change.status === 'loading') mark(); + if (typeof change.url === 'string' && (!prevUrl || change.url !== prevUrl)) mark(); + }; + + chrome.webNavigation.onCommitted.addListener(onCommitted); + chrome.webNavigation.onCompleted.addListener(onCompleted); + try { + (chrome.webNavigation as any).onHistoryStateUpdated?.addListener?.(onHistoryStateUpdated); + } catch {} + chrome.tabs.onUpdated.addListener(onUpdated); + timer = setTimeout(finish, sniffMs); + }); + } catch {} +} + +export { waitForNetworkIdle }; diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/runners/after-script-queue.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/after-script-queue.ts new file mode 100644 index 00000000..f7f247b9 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/after-script-queue.ts @@ -0,0 +1,88 @@ +// after-script-queue.ts — queue + executor for deferred after-scripts +// Notes: +// - Executes user-provided code in the specified world (ISOLATED by default) +// - Clears queue before execution to avoid leaks; re-queues remainder on failure +// - Logs warnings instead of throwing to keep the main engine resilient + +import type { StepScript } from '../../types'; +import type { ExecCtx } from '../../nodes'; +import { RunLogger } from '../logging/run-logger'; +import { applyAssign } from '../../rr-utils'; + +export class AfterScriptQueue { + private queue: StepScript[] = []; + + constructor(private logger: RunLogger) {} + + enqueue(script: StepScript) { + this.queue.push(script); + } + + size() { + return this.queue.length; + } + + async flush(ctx: ExecCtx, vars: Record) { + if (this.queue.length === 0) return; + const scriptsToFlush = this.queue.splice(0, this.queue.length); + for (let i = 0; i < scriptsToFlush.length; i++) { + const s = scriptsToFlush[i]!; + const tScript = Date.now(); + const world = (s as any).world || 'ISOLATED'; + const code = String((s as any).code || ''); + if (!code.trim()) { + this.logger.push({ stepId: s.id, status: 'success', tookMs: Date.now() - tScript }); + continue; + } + try { + // Warn on obviously dangerous constructs; not a sandbox, just visibility. + const dangerous = + /[;{}]|\b(function|=>|while|for|class|globalThis|window|self|this|constructor|__proto__|prototype|eval|Function|import|require|XMLHttpRequest|fetch|chrome)\b/; + if (dangerous.test(code)) { + this.logger.push({ + stepId: s.id, + status: 'warning', + message: 'Script contains potentially unsafe tokens; executed in isolated world', + }); + } + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const [{ result }] = await chrome.scripting.executeScript({ + target: { tabId }, + func: (userCode: string) => { + try { + return (0, eval)(userCode); + } catch (e) { + return { __error: true, message: String(e) } as any; + } + }, + args: [code], + world: world as any, + } as any); + if ((result as any)?.__error) { + this.logger.push({ + stepId: s.id, + status: 'warning', + message: `After-script error: ${(result as any).message || 'unknown'}`, + }); + } + const value = (result as any)?.__error ? null : result; + if ((s as any).saveAs) (vars as any)[(s as any).saveAs] = value; + if ((s as any).assign && typeof (s as any).assign === 'object') + applyAssign(vars, value, (s as any).assign); + } catch (e: any) { + // Re-queue remaining and stop flush cycle for now + const remaining = scriptsToFlush.slice(i + 1); + if (remaining.length) this.queue.unshift(...remaining); + this.logger.push({ + stepId: s.id, + status: 'warning', + message: `After-script execution failed: ${e?.message || String(e)}`, + }); + break; + } + this.logger.push({ stepId: s.id, status: 'success', tookMs: Date.now() - tScript }); + } + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/runners/control-flow-runner.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/control-flow-runner.ts new file mode 100644 index 00000000..3d798cbb --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/control-flow-runner.ts @@ -0,0 +1,59 @@ +// control-flow-runner.ts — foreach / while orchestration + +import type { ExecCtx } from '../../nodes'; +import { RunLogger } from '../logging/run-logger'; + +export interface ControlFlowEnv { + vars: Record; + logger: RunLogger; + evalCondition: (cond: any) => boolean; + runSubflowById: (subflowId: string, ctx: ExecCtx) => Promise; + isPaused: () => boolean; +} + +export class ControlFlowRunner { + constructor(private env: ControlFlowEnv) {} + + async run(control: any, ctx: ExecCtx): Promise<'ok' | 'paused'> { + if (control?.kind === 'foreach') { + const list = Array.isArray(this.env.vars[control.listVar]) + ? (this.env.vars[control.listVar] as any[]) + : []; + const concurrency = Math.max(1, Math.min(16, Number(control.concurrency ?? 1))); + if (concurrency <= 1) { + for (const it of list) { + this.env.vars[control.itemVar] = it; + await this.env.runSubflowById(control.subflowId, ctx); + if (this.env.isPaused()) return 'paused'; + } + return this.env.isPaused() ? 'paused' : 'ok'; + } + // Parallel with shallow-cloned vars per task (no automatic merge) + let idx = 0; + const runOne = async () => { + while (idx < list.length) { + const cur = idx++; + const it = list[cur]; + const childCtx: ExecCtx = { ...ctx, vars: { ...this.env.vars } }; + childCtx.vars[control.itemVar] = it; + await this.env.runSubflowById(control.subflowId, childCtx); + if (this.env.isPaused()) return; + } + }; + const workers = Array.from({ length: Math.min(concurrency, list.length) }, () => runOne()); + await Promise.all(workers); + return this.env.isPaused() ? 'paused' : 'ok'; + } + if (control?.kind === 'while') { + let i = 0; + while (i < control.maxIterations && this.env.evalCondition(control.condition)) { + await this.env.runSubflowById(control.subflowId, ctx); + if (this.env.isPaused()) return 'paused'; + i++; + } + return this.env.isPaused() ? 'paused' : 'ok'; + } + // Unknown control type → no-op + return 'ok'; + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-executor.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-executor.ts new file mode 100644 index 00000000..49e727e6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-executor.ts @@ -0,0 +1,256 @@ +/** + * Step Executor Interface + * + * Provides a unified interface for step execution that supports multiple execution modes. + * This abstraction allows seamless switching between legacy and actions execution. + * + * Architecture: + * - StepExecutorInterface: Base interface for all executors + * - LegacyStepExecutor: Uses the existing executeStep from nodes/ + * - ActionsStepExecutor: Uses ActionRegistry from actions/ + * - HybridStepExecutor: Tries actions first, falls back to legacy + */ + +import type { Step } from '../../types'; +import type { ExecCtx, ExecResult } from '../../nodes/types'; +import { executeStep as legacyExecuteStep } from '../../nodes'; +import type { ActionRegistry } from '../../actions/registry'; +import { + createStepExecutor, + isActionSupported, + type StepExecutionAttempt, +} from '../../actions/adapter'; +import type { ExecutionModeConfig } from '../execution-mode'; +import { shouldUseActions } from '../execution-mode'; + +/** + * Step execution result with additional metadata + */ +export interface StepExecutionResult { + /** The execution result from the step */ + result: ExecResult; + /** Which executor was used */ + executor: 'legacy' | 'actions'; + /** Whether fallback was used (only in hybrid mode) */ + fallback?: boolean; + /** Reason for fallback (only when fallback=true) */ + fallbackReason?: string; +} + +/** + * Options for step execution + */ +export interface StepExecutionOptions { + /** Current tab ID */ + tabId: number; + /** Run ID for logging/tracing */ + runId?: string; + /** Logger for recording fallback information */ + pushLog?: (entry: unknown) => void; + /** Remaining time budget from global deadline */ + remainingBudgetMs?: number; +} + +/** + * Base interface for step executors + */ +export interface StepExecutorInterface { + /** + * Execute a single step + */ + execute(ctx: ExecCtx, step: Step, options: StepExecutionOptions): Promise; + + /** + * Check if executor supports a step type + */ + supports(stepType: string): boolean; +} + +/** + * Legacy step executor using nodes/executeStep + * + * This executor delegates to the existing node execution system. + * The options parameter is accepted but not used - retry/timeout/navigation + * waiting are handled by StepRunner to maintain existing behavior. + */ +export class LegacyStepExecutor implements StepExecutorInterface { + async execute( + ctx: ExecCtx, + step: Step, + _options: StepExecutionOptions, + ): Promise { + // Note: tabId from options is not used here because legacy executeStep + // queries the active tab internally. In hybrid/actions mode, tabId is + // passed through to ActionRegistry handlers. + const result = await legacyExecuteStep(ctx, step); + return { + result: result || {}, + executor: 'legacy', + }; + } + + supports(_stepType: string): boolean { + // Legacy executor supports all step types via its own registry + return true; + } +} + +/** + * Actions step executor using ActionRegistry + * + * In strict mode, any unsupported step type throws an error. + * This executor does NOT fall back to legacy - use HybridStepExecutor for fallback behavior. + * + * Respects ExecutionModeConfig for: + * - skipActionsRetry: Disables ActionRegistry retry (StepRunner owns retry) + * - skipActionsNavWait: Disables handler nav-wait (StepRunner owns nav-wait) + */ +export class ActionsStepExecutor implements StepExecutorInterface { + private executor: ReturnType; + + constructor( + private registry: ActionRegistry, + private config: ExecutionModeConfig, + ) { + this.executor = createStepExecutor(registry); + } + + async execute( + ctx: ExecCtx, + step: Step, + options: StepExecutionOptions, + ): Promise { + // Use strict=true: throws on unsupported types instead of returning { supported: false } + // This ensures all steps must be handled by ActionRegistry in actions-only mode + const attempt = (await this.executor(ctx, step, options.tabId, { + runId: options.runId, + pushLog: options.pushLog, + strict: true, + // Pass policy skip flags from config (default to true = skip) + skipRetry: this.config.skipActionsRetry !== false, + skipNavWait: this.config.skipActionsNavWait !== false, + })) as StepExecutionAttempt; + + // With strict=true, we should never get { supported: false } - it would throw instead + // This check exists for type safety and defensive programming + if (!attempt.supported) { + throw new Error(attempt.reason); + } + + return { + result: attempt.result, + executor: 'actions', + }; + } + + supports(stepType: string): boolean { + // Use adapter's type guard to check if step type is supported + return isActionSupported(stepType); + } +} + +/** + * Hybrid step executor that tries actions first, falls back to legacy + * + * Respects ExecutionModeConfig for: + * - actionsAllowlist/legacyOnlyTypes: Controls which steps use actions vs legacy + * - skipActionsRetry: Disables ActionRegistry retry (StepRunner owns retry) + * - skipActionsNavWait: Disables handler nav-wait (StepRunner owns nav-wait) + * - logFallbacks: Whether to log when falling back to legacy + */ +export class HybridStepExecutor implements StepExecutorInterface { + private actionsExecutor: ReturnType; + + constructor( + private registry: ActionRegistry, + private config: ExecutionModeConfig, + ) { + this.actionsExecutor = createStepExecutor(registry); + } + + async execute( + ctx: ExecCtx, + step: Step, + options: StepExecutionOptions, + ): Promise { + // Check if step should use actions based on config + if (!shouldUseActions(step, this.config)) { + // Use legacy directly + const result = await legacyExecuteStep(ctx, step); + return { + result: result || {}, + executor: 'legacy', + }; + } + + // Try actions first + const attempt = (await this.actionsExecutor(ctx, step, options.tabId, { + runId: options.runId, + pushLog: options.pushLog, + strict: false, // Don't throw on unsupported, return { supported: false } + // Pass policy skip flags from config (default to true = skip) + skipRetry: this.config.skipActionsRetry !== false, + skipNavWait: this.config.skipActionsNavWait !== false, + })) as StepExecutionAttempt; + + if (attempt.supported) { + return { + result: attempt.result, + executor: 'actions', + }; + } + + // Fall back to legacy + if (this.config.logFallbacks) { + options.pushLog?.({ + stepId: step.id, + status: 'warning', + message: `Falling back to legacy execution: ${attempt.reason}`, + }); + } + + const legacyResult = await legacyExecuteStep(ctx, step); + return { + result: legacyResult || {}, + executor: 'legacy', + fallback: true, + fallbackReason: attempt.reason, + }; + } + + supports(stepType: string): boolean { + // Hybrid executor supports all types (via fallback) + return true; + } +} + +/** + * Factory function to create the appropriate executor based on config + */ +export function createExecutor( + config: ExecutionModeConfig, + registry?: ActionRegistry, +): StepExecutorInterface { + switch (config.mode) { + case 'legacy': + return new LegacyStepExecutor(); + + case 'actions': + if (!registry) { + throw new Error('ActionRegistry required for actions execution mode'); + } + return new ActionsStepExecutor(registry, config); + + case 'hybrid': + if (!registry) { + throw new Error('ActionRegistry required for hybrid execution mode'); + } + return new HybridStepExecutor(registry, config); + + default: { + // TypeScript exhaustiveness check + const _exhaustive: never = config.mode; + throw new Error(`Unknown execution mode: ${_exhaustive}`); + } + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-runner.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-runner.ts new file mode 100644 index 00000000..69810917 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/step-runner.ts @@ -0,0 +1,238 @@ +/** + * step-runner.ts + * + * Encapsulates execution of a single step with policies (retry, navigation wait) and plugins. + * Uses dependency-injected StepExecutorInterface for actual step execution, enabling + * seamless switching between legacy and ActionRegistry execution modes. + */ + +import type { Flow, Step, StepClick } from '../../types'; +import { STEP_TYPES } from 'chrome-mcp-shared'; +import type { ExecCtx, ExecResult } from '../../nodes'; +import { RunLogger } from '../logging/run-logger'; +import { withRetry } from '../policies/retry'; +import { + waitForNavigationDone, + maybeQuickWaitForNav, + ensureReadPageIfWeb, + waitForNetworkIdle, +} from '../policies/wait'; +import { ENGINE_CONSTANTS } from '../constants'; +import { AfterScriptQueue } from './after-script-queue'; +import { PluginManager } from '../plugins/manager'; +import type { HookControl } from '../plugins/types'; +import type { StepExecutorInterface } from './step-executor'; + +// Narrow error-like value used for overlay reporting +interface ErrorLike { + message?: string; +} + +function errorMessage(e: unknown): string { + if (e instanceof Error) return e.message; + if (e && typeof e === 'object' && 'message' in e) return String((e as any).message); + return String(e); +} + +/** + * Environment dependencies for StepRunner. + * Injected by Scheduler to allow flexible configuration and testing. + */ +export interface StepRunEnv { + /** Unique identifier for this run */ + runId: string; + /** The flow being executed */ + flow: Flow; + /** Runtime variables */ + vars: Record; + /** Run logger for recording execution events */ + logger: RunLogger; + /** Plugin manager for hooks (beforeStep, afterStep, onRetry, onError) */ + pluginManager: PluginManager; + /** Queue for deferred after-scripts */ + afterScripts: AfterScriptQueue; + /** Returns remaining time budget from global deadline (ms), Infinity if no deadline */ + getRemainingBudgetMs: () => number; + /** + * Step executor for actual step execution. + * Defaults to LegacyStepExecutor if not provided (for backwards compatibility). + * In future, Scheduler will inject ActionsStepExecutor or HybridStepExecutor. + */ + stepExecutor: StepExecutorInterface; +} + +export class StepRunner { + constructor(private env: StepRunEnv) {} + + private async getActiveTabInfo(): Promise<{ url: string; status: string | '' }> { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tab = tabs[0]; + return { url: tab?.url || '', status: (tab?.status as string) || '' }; + } + + async run( + ctx: ExecCtx, + step: Step, + appendOverlayOk: (s: Step) => Promise | void, + appendOverlayFail: (s: Step, e: ErrorLike) => Promise | void, + ): Promise<{ + status: 'success' | 'failed' | 'paused'; + nextLabel?: string; + control?: ExecResult['control']; + }> { + const t0 = Date.now(); + let stepNextLabel: string | undefined; + let controlOut: ExecResult['control'] | undefined = undefined; + let ctrlStart: HookControl | undefined; + try { + ctrlStart = await this.env.pluginManager.beforeStep({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + step, + }); + } catch (e: unknown) { + this.env.logger.push({ + stepId: step.id, + status: 'warning', + message: `plugin.beforeStep error: ${errorMessage(e)}`, + }); + } + if (ctrlStart?.pause) return { status: 'paused' }; + + const beforeInfo = await this.getActiveTabInfo(); + try { + await withRetry( + async () => { + // Execute step via injected executor (legacy, actions, or hybrid) + // tabId is expected to be set by Scheduler in ctx; fallback to active tab if missing + let tabId = ctx.tabId; + if (typeof tabId !== 'number') { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + tabId = tabs?.[0]?.id; + } + if (typeof tabId !== 'number') { + throw new Error('No active tab found for step execution'); + } + + const execResult = await this.env.stepExecutor.execute(ctx, step, { + tabId, + runId: this.env.runId, + pushLog: (entry) => this.env.logger.push(entry as any), + remainingBudgetMs: this.env.getRemainingBudgetMs(), + }); + const result = execResult.result; + const remainingBudget = this.env.getRemainingBudgetMs(); + if (step.type === STEP_TYPES.CLICK || step.type === STEP_TYPES.DBLCLICK) { + const after = step.after ?? ({} as NonNullable); + if (after.waitForNavigation) + await waitForNavigationDone( + beforeInfo.url, + Math.min(step.timeoutMs ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, remainingBudget), + ); + else if (after.waitForNetworkIdle) { + const totalMs = Math.min( + step.timeoutMs ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, + remainingBudget, + ); + const idleMs = Math.min(1500, Math.max(500, Math.floor(totalMs / 3))); + await waitForNetworkIdle(totalMs, idleMs); + } else + await maybeQuickWaitForNav( + beforeInfo.url, + Math.min(step.timeoutMs ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, remainingBudget), + ); + } + if (step.type === STEP_TYPES.NAVIGATE || step.type === STEP_TYPES.OPEN_TAB) { + await waitForNavigationDone( + beforeInfo.url, + Math.min( + step.timeoutMs ?? ENGINE_CONSTANTS.DEFAULT_WAIT_MS, + this.env.getRemainingBudgetMs(), + ), + ); + await ensureReadPageIfWeb(); + } else if (step.type === STEP_TYPES.SWITCH_TAB) { + await ensureReadPageIfWeb(); + } + if (!result?.alreadyLogged) + this.env.logger.push({ stepId: step.id, status: 'success', tookMs: Date.now() - t0 }); + try { + await this.env.pluginManager.afterStep({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + step, + result, + }); + } catch (e: unknown) { + this.env.logger.push({ + stepId: step.id, + status: 'warning', + message: `plugin.afterStep error: ${errorMessage(e)}`, + }); + } + await appendOverlayOk(step); + if (result?.nextLabel) stepNextLabel = String(result.nextLabel); + if (result?.control) controlOut = result.control; + if (result?.deferAfterScript) this.env.afterScripts.enqueue(result.deferAfterScript); + await this.env.afterScripts.flush(ctx, this.env.vars); + }, + async (attempt, e) => { + this.env.logger.push({ + stepId: step.id, + status: 'retrying', + message: errorMessage(e), + }); + try { + await this.env.pluginManager.onRetry({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + step, + error: e, + attempt, + }); + } catch (pe: unknown) { + this.env.logger.push({ + stepId: step.id, + status: 'warning', + message: `plugin.onRetry error: ${errorMessage(pe)}`, + }); + } + }, + { + count: Math.max(0, step.retry?.count ?? 0), + intervalMs: Math.max(0, step.retry?.intervalMs ?? 0), + backoff: step.retry?.backoff || 'none', + }, + ); + } catch (e: unknown) { + this.env.logger.push({ + stepId: step.id, + status: 'failed', + message: errorMessage(e), + tookMs: Date.now() - t0, + }); + await appendOverlayFail(step, e as ErrorLike); + try { + const hook = await this.env.pluginManager.onError({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + step, + error: e, + }); + if (hook?.pause) return { status: 'paused' }; + } catch (pe: unknown) { + this.env.logger.push({ + stepId: step.id, + status: 'warning', + message: `plugin.onError error: ${errorMessage(pe)}`, + }); + } + return { status: 'failed' }; + } + return { status: 'success', nextLabel: stepNextLabel, control: controlOut }; + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/runners/subflow-runner.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/subflow-runner.ts new file mode 100644 index 00000000..f91826d7 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/runners/subflow-runner.ts @@ -0,0 +1,169 @@ +// subflow-runner.ts — execute a subflow (nodes/edges) using DAG traversal with branch support + +import { STEP_TYPES } from 'chrome-mcp-shared'; +import type { ExecCtx } from '../../nodes'; +import { RunLogger } from '../logging/run-logger'; +import { PluginManager } from '../plugins/manager'; +import { mapDagNodeToStep } from '../../rr-utils'; +import type { Edge, NodeBase, Step } from '../../types'; +import { StepRunner } from './step-runner'; +import { ENGINE_CONSTANTS } from '../constants'; + +export interface SubflowEnv { + runId: string; + flow: any; + vars: Record; + logger: RunLogger; + pluginManager: PluginManager; + stepRunner: StepRunner; +} + +export class SubflowRunner { + constructor(private env: SubflowEnv) {} + + async runSubflowById(subflowId: string, ctx: ExecCtx, pausedRef: () => boolean): Promise { + const sub = (this.env.flow.subflows || {})[subflowId]; + if (!sub || !Array.isArray(sub.nodes) || sub.nodes.length === 0) return; + + try { + await this.env.pluginManager.subflowStart({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + subflowId, + }); + } catch (e: any) { + this.env.logger.push({ + stepId: `subflow:${subflowId}`, + status: 'warning', + message: `plugin.subflowStart error: ${e?.message || String(e)}`, + }); + } + + const sNodes: NodeBase[] = sub.nodes; + const sEdges: Edge[] = sub.edges || []; + + // Build lookup maps + const id2node = new Map(sNodes.map((n) => [n.id, n] as const)); + const outEdges = new Map(); + for (const e of sEdges) { + if (!outEdges.has(e.from)) outEdges.set(e.from, []); + outEdges.get(e.from)!.push(e); + } + + // Calculate in-degrees to find root nodes + const indeg = new Map(sNodes.map((n) => [n.id, 0] as const)); + for (const e of sEdges) { + indeg.set(e.to, (indeg.get(e.to) || 0) + 1); + } + + // Find start node: prefer non-trigger nodes with indeg=0 + const findFirstExecutableRoot = (): string | undefined => { + const executableRoot = sNodes.find( + (n) => (indeg.get(n.id) || 0) === 0 && n.type !== STEP_TYPES.TRIGGER, + ); + if (executableRoot) return executableRoot.id; + + // If all roots are triggers, follow default edge to first executable + const triggerRoot = sNodes.find((n) => (indeg.get(n.id) || 0) === 0); + if (triggerRoot) { + const defaultEdge = (outEdges.get(triggerRoot.id) || []).find( + (e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT, + ); + if (defaultEdge) return defaultEdge.to; + } + + return sNodes[0]?.id; + }; + + let currentId: string | undefined = findFirstExecutableRoot(); + let guard = 0; + const maxIterations = ENGINE_CONSTANTS.MAX_ITERATIONS; + + const ok = (s: Step) => this.env.logger.overlayAppend(`✔ ${s.type} (${s.id})`); + const fail = (s: Step, e: any) => + this.env.logger.overlayAppend(`✘ ${s.type} (${s.id}) -> ${e?.message || String(e)}`); + + while (currentId) { + if (pausedRef()) break; + if (guard++ >= maxIterations) { + this.env.logger.push({ + stepId: `subflow:${subflowId}`, + status: 'warning', + message: `Subflow exceeded ${maxIterations} iterations - possible cycle`, + }); + break; + } + + const node = id2node.get(currentId); + if (!node) break; + + // Skip trigger nodes + if (node.type === STEP_TYPES.TRIGGER) { + const defaultEdge = (outEdges.get(currentId) || []).find( + (e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT, + ); + if (defaultEdge) { + currentId = defaultEdge.to; + continue; + } + break; + } + + const step: Step = mapDagNodeToStep(node); + const r = await this.env.stepRunner.run(ctx, step, ok, fail); + + if (r.status === 'paused' || pausedRef()) break; + + if (r.status === 'failed') { + // Try to find on_error edge + const errEdge = (outEdges.get(currentId) || []).find( + (e) => e.label === ENGINE_CONSTANTS.EDGE_LABELS.ON_ERROR, + ); + if (errEdge) { + currentId = errEdge.to; + continue; + } + break; + } + + // Determine next edge by label + const suggestedLabel = r.nextLabel + ? String(r.nextLabel) + : ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT; + const oes = outEdges.get(currentId) || []; + const nextEdge = + oes.find((e) => (e.label || ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT) === suggestedLabel) || + oes.find((e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT); + + if (!nextEdge) { + // Log warning if we expected a labeled edge but couldn't find it + if (r.nextLabel && oes.length > 0) { + const availableLabels = oes.map((e) => e.label || ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT); + this.env.logger.push({ + stepId: step.id, + status: 'warning', + message: `No edge for label '${suggestedLabel}'. Available: [${availableLabels.join(', ')}]`, + }); + } + break; + } + currentId = nextEdge.to; + } + + try { + await this.env.pluginManager.subflowEnd({ + runId: this.env.runId, + flow: this.env.flow, + vars: this.env.vars, + subflowId, + }); + } catch (e: any) { + this.env.logger.push({ + stepId: `subflow:${subflowId}`, + status: 'warning', + message: `plugin.subflowEnd error: ${e?.message || String(e)}`, + }); + } + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/scheduler.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/scheduler.ts new file mode 100644 index 00000000..9bf5e89e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/scheduler.ts @@ -0,0 +1,846 @@ +import { STEP_TYPES, TOOL_NAMES } from 'chrome-mcp-shared'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { Edge, Flow, NodeBase, RunLogEntry, RunResult, Step } from '../types'; +import { + mapDagNodeToStep, + topoOrder, + ensureTab, + expandTemplatesDeep, + defaultEdgesOnly, +} from '../rr-utils'; +import type { ExecCtx } from '../nodes'; +import { RunLogger } from './logging/run-logger'; +import { PluginManager } from './plugins/manager'; +import type { RunPlugin } from './plugins/types'; +import { breakpointPlugin } from './plugins/breakpoint'; +import { evalExpression } from './utils/expression'; +import { runState } from './state-manager'; +import { AfterScriptQueue } from './runners/after-script-queue'; +import { StepRunner } from './runners/step-runner'; +import { ControlFlowRunner } from './runners/control-flow-runner'; +import { SubflowRunner } from './runners/subflow-runner'; +import { ENGINE_CONSTANTS, LOG_STEP_IDS } from './constants'; +import { + DEFAULT_EXECUTION_MODE_CONFIG, + createActionsOnlyConfig, + createHybridConfig, + type ExecutionMode, + type ExecutionModeConfig, +} from './execution-mode'; +import { createExecutor, type StepExecutorInterface } from './runners/step-executor'; +import { createReplayActionRegistry } from '../actions/handlers'; + +export interface RunOptions { + tabTarget?: 'current' | 'new'; + refresh?: boolean; + captureNetwork?: boolean; + returnLogs?: boolean; + timeoutMs?: number; + startUrl?: string; + args?: Record; + startNodeId?: string; + plugins?: RunPlugin[]; + + /** + * Step execution mode switch. + * - 'legacy': Use existing nodes/executeStep (default, safest) + * - 'hybrid': Try ActionRegistry first, fall back to legacy + * - 'actions': Use ActionRegistry exclusively (strict mode) + */ + executionMode?: ExecutionMode; + + /** + * Hybrid mode only: allowlist of step types executed via ActionRegistry. + * - undefined: use MINIMAL_HYBRID_ACTION_TYPES (safest default) + * - []: disable allowlist, fall back to MIGRATED_ACTION_TYPES policy + * - ['fill', 'key', ...]: only these types use actions + */ + actionsAllowlist?: string[]; + + /** + * Hybrid mode only: denylist of step types forced to legacy. + * When omitted, createHybridConfig defaults to LEGACY_ONLY_TYPES. + */ + legacyOnlyTypes?: string[]; +} + +/** + * Type guard for ExecutionMode + */ +function isExecutionMode(value: unknown): value is ExecutionMode { + return value === 'legacy' || value === 'hybrid' || value === 'actions'; +} + +/** + * Convert array to Set, filtering invalid values + */ +function toStringSet(value: unknown): Set { + const result = new Set(); + if (!Array.isArray(value)) return result; + for (const item of value) { + if (typeof item === 'string') { + const trimmed = item.trim(); + if (trimmed) result.add(trimmed); + } + } + return result; +} + +/** + * Build ExecutionModeConfig from RunOptions. + * Defaults to legacy mode if executionMode is not specified. + * + * Note: Only array inputs for actionsAllowlist/legacyOnlyTypes are accepted. + * Non-array values are ignored to prevent accidental misconfiguration + * (e.g., passing a string instead of array would unexpectedly widen the allowlist). + */ +function buildExecutionModeConfig(options: RunOptions): ExecutionModeConfig { + const mode: ExecutionMode = isExecutionMode(options.executionMode) + ? options.executionMode + : DEFAULT_EXECUTION_MODE_CONFIG.mode; + + if (mode === 'hybrid') { + const overrides: Partial = {}; + // Only apply override if it's a valid array + // This prevents misconfiguration from widening the actions scope + if (Array.isArray(options.actionsAllowlist)) { + overrides.actionsAllowlist = toStringSet(options.actionsAllowlist); + } + if (Array.isArray(options.legacyOnlyTypes)) { + overrides.legacyOnlyTypes = toStringSet(options.legacyOnlyTypes); + } + return createHybridConfig(overrides); + } + + if (mode === 'actions') { + return createActionsOnlyConfig(); + } + + // Default: legacy mode + return { ...DEFAULT_EXECUTION_MODE_CONFIG }; +} + +/** + * ExecutionOrchestrator manages the lifecycle of a flow execution. + * + * Architecture: + * - Creates StepExecutor based on ExecutionModeConfig (legacy by default) + * - Injects StepExecutor into StepRunner for step execution + * - Manages tabId and passes it through ExecCtx + * - Handles DAG traversal, control flow, and cleanup + */ +class ExecutionOrchestrator { + private readonly runId = `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; + private readonly startAt = Date.now(); + private readonly logger = new RunLogger(this.runId); + private readonly pluginManager: PluginManager; + private readonly afterScripts = new AfterScriptQueue(this.logger); + + // Execution mode configuration (defaults to legacy for safety) + private readonly executionModeConfig: ExecutionModeConfig; + private readonly stepExecutor: StepExecutorInterface; + + // Runtime state + private vars: Record = Object.create(null); + private tabId: number | null = null; + private deadline = 0; + private networkCaptureStarted = false; + private paused = false; + private failed = 0; + private executed = 0; + private steps: Step[] = []; + private prepareError: RunResult | null = null; + + // Runners + private stepRunner: StepRunner; + private controlFlowRunner!: ControlFlowRunner; + private subflowRunner!: SubflowRunner; + + constructor( + private flow: Flow, + private options: RunOptions = {}, + ) { + // Initialize variables from flow defaults and args + for (const v of flow.variables || []) { + if (v.default !== undefined) this.vars[v.key] = v.default; + } + if (options.args) Object.assign(this.vars, options.args); + + // Set up global deadline + const globalTimeout = Math.max(0, Number(options.timeoutMs || 0)); + this.deadline = globalTimeout > 0 ? this.startAt + globalTimeout : 0; + + // Initialize plugin manager + this.pluginManager = new PluginManager( + options.plugins && options.plugins.length ? options.plugins : [breakpointPlugin()], + ); + + // Create step executor based on execution mode configuration + // Default to legacy mode for maximum safety during migration + this.executionModeConfig = buildExecutionModeConfig(options); + + // Only create ActionRegistry when needed (hybrid or actions mode) + // This avoids unnecessary initialization overhead in legacy mode + const registry = + this.executionModeConfig.mode === 'legacy' ? undefined : createReplayActionRegistry(); + this.stepExecutor = createExecutor(this.executionModeConfig, registry); + + // Initialize step runner with injected executor + this.stepRunner = new StepRunner({ + runId: this.runId, + flow: this.flow, + vars: this.vars, + logger: this.logger, + pluginManager: this.pluginManager, + afterScripts: this.afterScripts, + getRemainingBudgetMs: () => + this.deadline > 0 ? Math.max(0, this.deadline - Date.now()) : Number.POSITIVE_INFINITY, + stepExecutor: this.stepExecutor, + }); + } + + private ensureWithinDeadline() { + if (this.deadline > 0 && Date.now() > this.deadline) { + const err = new Error('Global timeout reached'); + this.logger.push({ + stepId: LOG_STEP_IDS.GLOBAL_TIMEOUT, + status: 'failed', + message: 'Global timeout reached', + }); + throw err; + } + } + + async run(): Promise { + try { + await this.prepareExecution(); + if (this.prepareError) return this.prepareError; + return await this.traverseDag(); + } finally { + await this.cleanup(); + } + } + + private async prepareExecution() { + // Derive default startUrl + let derivedStartUrl: string | undefined; + try { + const hasDag0 = Array.isArray(this.flow.nodes) && (this.flow.nodes?.length || 0) > 0; + const nodes0: NodeBase[] = hasDag0 ? this.flow.nodes || [] : []; + const edges0: Edge[] = hasDag0 ? this.flow.edges || [] : []; + const defaultEdges0 = hasDag0 ? defaultEdgesOnly(edges0) : []; + const order0 = hasDag0 ? topoOrder(nodes0, defaultEdges0) : []; + const steps0: Step[] = hasDag0 ? order0.map((n) => mapDagNodeToStep(n)) : []; + const nav = steps0.find((s) => s.type === STEP_TYPES.NAVIGATE); + if (nav && nav.type === STEP_TYPES.NAVIGATE) + derivedStartUrl = expandTemplatesDeep(nav.url, this.vars); + } catch { + // ignore: best-effort derive startUrl + } + + const ensured = await ensureTab({ + tabTarget: this.options.tabTarget, + startUrl: this.options.startUrl || derivedStartUrl, + refresh: this.options.refresh, + }); + // Capture tabId for use in ExecCtx + this.tabId = ensured?.tabId ?? null; + + // register run state + await runState.restore(); + await runState.add(this.runId, { + id: this.runId, + flowId: this.flow.id, + name: this.flow.name, + status: 'running', + startedAt: this.startAt, + updatedAt: this.startAt, + }); + + try { + await this.pluginManager.runStart({ runId: this.runId, flow: this.flow, vars: this.vars }); + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.PLUGIN_RUN_START, + status: 'warning', + message: e?.message || String(e), + }); + } + + // pre-load read_page when on web + try { + const u = ensured?.url || ''; + if (/^(https?:|file:)/i.test(u)) + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + } catch { + // ignore: preloading read_page is best-effort + } + + // overlay variable collection + try { + const needed = (this.flow.variables || []).filter( + (v) => + (this.options.args?.[v.key] == null || this.options.args?.[v.key] === '') && + (v.rules?.required || (v.default ?? '') === ''), + ); + if (needed.length) { + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.SEND_COMMAND_TO_INJECT_SCRIPT, + args: { + eventName: TOOL_MESSAGE_TYPES.COLLECT_VARIABLES, + payload: JSON.stringify({ variables: needed, useOverlay: true }), + }, + }); + let values: Record | null = null; + try { + const t = (res?.content || []).find((c: any) => c.type === 'text')?.text; + const j = t ? JSON.parse(t) : null; + if (j && j.success && j.values) values = j.values; + } catch { + // ignore: parse result from tool response + } + if (!values) { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId === 'number') { + const res2 = await chrome.tabs.sendMessage(tabId, { + action: TOOL_MESSAGE_TYPES.COLLECT_VARIABLES, + variables: needed, + useOverlay: true, + }); + if (res2 && res2.success && res2.values) values = res2.values; + } + } + if (values) Object.assign(this.vars, values); + else + this.logger.push({ + stepId: LOG_STEP_IDS.VARIABLE_COLLECT, + status: 'warning', + message: 'Variable collection failed; using provided args/defaults', + }); + } + } catch { + // ignore: variable collection is optional + } + + await this.logger.overlayInit(); + + // binding enforcement + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const currentUrl = tabs?.[0]?.url || ''; + const bindings = this.flow.meta?.bindings || []; + if (!this.options.startUrl && bindings.length > 0) { + const ok = bindings.some((b) => { + try { + if (b.type === 'domain') return new URL(currentUrl).hostname.includes(b.value); + if (b.type === 'path') return new URL(currentUrl).pathname.startsWith(b.value); + if (b.type === 'url') return currentUrl.startsWith(b.value); + } catch { + // ignore: URL parsing for binding check + } + return false; + }); + if (!ok) { + this.prepareError = { + runId: this.runId, + success: false, + summary: { total: 0, success: 0, failed: 0, tookMs: 0 }, + url: currentUrl, + outputs: null, + logs: [ + { + stepId: LOG_STEP_IDS.BINDING_CHECK, + status: 'failed', + message: + 'Flow binding mismatch. Provide startUrl or open a page matching flow.meta.bindings.', + }, + ], + screenshots: { onFailure: null }, + paused: false, + }; + return; + } + } + } catch { + // ignore: binding enforcement failures fall back to default behavior + } + + // network capture start + if (this.options.captureNetwork) { + try { + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NETWORK_DEBUGGER_START, + args: { includeStatic: false, maxCaptureTime: 3 * 60_000, inactivityTimeout: 0 }, + }); + let started = false; + try { + const t = res?.content?.find?.((c: any) => c.type === 'text')?.text; + if (t) { + const j = JSON.parse(t); + started = !!j?.success; + } + } catch { + // ignore: parse network debugger start response + } + this.networkCaptureStarted = started; + if (!started) { + this.logger.push({ + stepId: LOG_STEP_IDS.NETWORK_CAPTURE, + status: 'warning', + message: 'Failed to confirm network capture start', + }); + } + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.NETWORK_CAPTURE, + status: 'warning', + message: e?.message || 'Network capture start errored', + }); + } + } + + // build DAG steps + const hasDag = Array.isArray(this.flow.nodes) && (this.flow.nodes?.length || 0) > 0; + if (!hasDag) { + this.prepareError = { + runId: this.runId, + success: false, + summary: { total: 0, success: 0, failed: 0, tookMs: 0 }, + url: null, + outputs: null, + logs: [ + { + stepId: LOG_STEP_IDS.DAG_REQUIRED, + status: 'failed', + message: + 'Flow has no DAG nodes. Linear steps are no longer supported. Please migrate this flow to nodes/edges.', + }, + ], + screenshots: { onFailure: null }, + paused: false, + }; + return; + } + const nodes: NodeBase[] = (this.flow.nodes || []) as NodeBase[]; + const edges: Edge[] = (this.flow.edges || []) as Edge[]; + // Validate DAG for potential cycles on full edge set + try { + if (this.hasCycle(nodes, edges)) { + this.prepareError = { + runId: this.runId, + success: false, + summary: { total: 0, success: 0, failed: 0, tookMs: 0 }, + url: null, + outputs: null, + logs: [ + { + stepId: LOG_STEP_IDS.DAG_CYCLE, + status: 'failed', + message: + 'Flow DAG contains a cycle. Please break the cycle or add explicit labels/branches to avoid infinite loops.', + }, + ], + screenshots: { onFailure: null }, + paused: false, + }; + return; + } + } catch { + // ignore: cycle detection guard + } + const defaultEdges = defaultEdgesOnly(edges); + const order = topoOrder(nodes, defaultEdges); + // Filter out trigger nodes - they are configuration nodes, not executable steps + this.steps = order.filter((n) => n.type !== STEP_TYPES.TRIGGER).map((n) => mapDagNodeToStep(n)); + // initialize runners + this.subflowRunner = new SubflowRunner({ + runId: this.runId, + flow: this.flow, + vars: this.vars, + logger: this.logger, + pluginManager: this.pluginManager, + stepRunner: this.stepRunner, + }); + this.controlFlowRunner = new ControlFlowRunner({ + vars: this.vars, + logger: this.logger, + evalCondition: (c) => this.evalCondition(c), + runSubflowById: (id, ctx) => this.subflowRunner.runSubflowById(id, ctx, () => this.paused), + isPaused: () => this.paused, + }); + } + + // Basic cycle detection using DFS coloring on the full edge set + private hasCycle( + nodes: Array<{ id: string }>, + edges: Array<{ from: string; to: string }>, + ): boolean { + const adj = new Map(); + for (const n of nodes) adj.set(n.id, []); + for (const e of edges) { + if (!adj.has(e.from)) adj.set(e.from, []); + adj.get(e.from)!.push(e.to); + } + const color = new Map(); // 0=unvisited,1=visiting,2=done + const visit = (u: string): boolean => { + const c = color.get(u) || 0; + if (c === 1) return true; // back-edge + if (c === 2) return false; + color.set(u, 1); + for (const v of adj.get(u) || []) if (visit(v)) return true; + color.set(u, 2); + return false; + }; + for (const n of nodes) if ((color.get(n.id) || 0) === 0 && visit(n.id)) return true; + return false; + } + + private async traverseDag(): Promise { + if (!this.steps.length) { + await this.logger.overlayDone(); + const tookMs0 = Date.now() - this.startAt; + return ( + this.prepareError || { + runId: this.runId, + success: false, + summary: { total: 0, success: 0, failed: 0, tookMs: tookMs0 }, + url: null, + outputs: null, + logs: this.options.returnLogs ? this.logger.getLogs() : undefined, + screenshots: { onFailure: null }, + paused: false, + } + ); + } + const nodes: NodeBase[] = this.flow.nodes || []; + const edges: Edge[] = this.flow.edges || []; + const id2node = new Map(nodes.map((n) => [n.id, n] as const)); + const outEdges = new Map>(); + for (const e of edges) { + if (!outEdges.has(e.from)) outEdges.set(e.from, []); + outEdges.get(e.from)!.push(e); + } + const indeg = new Map(nodes.map((n) => [n.id, 0] as const)); + for (const e of edges) indeg.set(e.to, (indeg.get(e.to) || 0) + 1); + // Find start node: prefer non-trigger nodes with indeg=0 + // Trigger nodes are configuration nodes and should be skipped + const findFirstExecutableRoot = (): string | undefined => { + // First try to find a non-trigger root node + const executableRoot = nodes.find( + (n) => (indeg.get(n.id) || 0) === 0 && n.type !== STEP_TYPES.TRIGGER, + ); + if (executableRoot) return executableRoot.id; + + // If all roots are triggers, find one and follow default edge to first executable + const triggerRoot = nodes.find((n) => (indeg.get(n.id) || 0) === 0); + if (triggerRoot) { + const defaultEdge = (outEdges.get(triggerRoot.id) || []).find( + (e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT, + ); + if (defaultEdge) return defaultEdge.to; + } + + // Fallback to first node + return nodes[0]?.id; + }; + + let currentId: string | undefined = + this.options.startNodeId && id2node.has(this.options.startNodeId) + ? this.options.startNodeId + : findFirstExecutableRoot(); + let guard = 0; + + // Create execution context with tabId from ensureTab + // tabId is managed by Scheduler and may be updated by openTab/switchTab actions + const ctx: ExecCtx = { + vars: this.vars, + tabId: this.tabId ?? undefined, + logger: (e: RunLogEntry) => this.logger.push(e), + }; + if (currentId) { + try { + await this.logger.overlayAppend( + `▶ start at ${id2node.get(currentId)?.type || ''} (${currentId})`, + ); + } catch { + // ignore: eval condition failure treated as false + } + } + while (currentId) { + this.ensureWithinDeadline(); + if (guard++ >= ENGINE_CONSTANTS.MAX_ITERATIONS) { + this.logger.push({ + stepId: LOG_STEP_IDS.LOOP_GUARD, + status: 'failed', + message: `Exceeded ${ENGINE_CONSTANTS.MAX_ITERATIONS} iterations - possible cycle in DAG`, + }); + this.failed++; + break; + } + const node = id2node.get(currentId); + if (!node) break; + + // Skip trigger nodes - they are configuration nodes, not executable steps + // Follow default edge to the next executable node + if (node.type === STEP_TYPES.TRIGGER) { + try { + await this.logger.overlayAppend(`⏭ skip trigger (${node.id})`); + } catch {} + const defaultEdge = (outEdges.get(currentId) || []).find( + (e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT, + ); + if (defaultEdge) { + currentId = defaultEdge.to; + continue; + } + // No successor after trigger - end execution + this.logger.push({ + stepId: node.id, + status: 'warning', + message: 'Trigger node has no successor - nothing to execute', + }); + break; + } + + const step: Step = mapDagNodeToStep(node); + // lightweight trace to aid debugging edge traversal + try { + await this.logger.overlayAppend(`→ ${step.type} (${step.id})`); + } catch { + // ignore: stopping network capture is best-effort + } + // Count this step as executed (regardless of success/failure) + this.executed++; + + const r = await this.stepRunner.run( + ctx, + step, + (s) => this.logger.overlayAppend(`✔ ${s.type} (${s.id})`), + (s, e) => this.logger.overlayAppend(`✘ ${s.type} (${s.id}) -> ${e?.message || String(e)}`), + ); + if (r.status === 'paused') { + this.paused = true; + break; + } + if (r.status === 'failed') { + this.failed++; + const oes = (outEdges.get(currentId) || []) as Edge[]; + const errEdge = oes.find((edg) => edg.label === ENGINE_CONSTANTS.EDGE_LABELS.ON_ERROR); + if (errEdge) { + currentId = errEdge.to; + continue; + } else { + break; + } + } + if (r.control) { + const control = r.control; + const st = await this.controlFlowRunner.run(control, ctx); + if (st === 'paused') { + this.paused = true; + break; + } + const suggested = r.nextLabel ? String(r.nextLabel) : ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT; + const next = await this.advanceToNext(currentId, step, suggested, id2node, outEdges); + if (!next) break; + currentId = next; + continue; + } + // choose next by label + { + const suggested = r.nextLabel ? String(r.nextLabel) : ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT; + const next = await this.advanceToNext(currentId, step, suggested, id2node, outEdges); + if (!next) break; + currentId = next; + } + } + const tookMs = Date.now() - this.startAt; + const sensitiveKeys = new Set( + (this.flow.variables || []).filter((v) => v.sensitive).map((v) => v.key), + ); + const outputs: Record = {}; + for (const [k, v] of Object.entries(this.vars)) if (!sensitiveKeys.has(k)) outputs[k] = v; + return { + runId: this.runId, + success: !this.paused && this.failed === 0, + summary: { + total: this.executed, + success: this.executed - this.failed, + failed: this.failed, + tookMs, + }, + url: null, + outputs, + logs: this.options.returnLogs ? this.logger.getLogs() : undefined, + screenshots: { + onFailure: this.logger.getLogs().find((l) => l.status === 'failed')?.screenshotBase64, + }, + paused: this.paused, + }; + } + + // Advance to next node by suggested label, with overlay/logging and fallback to default edge. + private async advanceToNext( + currentId: string, + step: Step, + suggested: string, + id2node: Map, + outEdges: Map>, + ): Promise { + const nextLabel = await this.chooseNextLabel(step, suggested); + const nextId = this.findNextNodeId(currentId, outEdges, nextLabel); + if (nextId) { + try { + await this.logger.overlayAppend( + `↪ next(${nextLabel}) → ${id2node.get(nextId)?.type || ''} (${nextId})`, + ); + } catch {} + return nextId; + } + const labels = (outEdges.get(currentId) || []).map((e) => + String(e.label || ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT), + ); + this.logger.push({ + stepId: step.id, + status: 'warning', + message: `No next edge for label '${nextLabel}'. Outgoing labels: [${labels.join(', ')}]`, + }); + return undefined; + } + + // Decide next label, allowing plugins to override; logs plugin errors as warnings + private async chooseNextLabel(step: Step, suggested: string): Promise { + try { + const override = await this.pluginManager.onChooseNextLabel({ + runId: this.runId, + flow: this.flow, + vars: this.vars, + step, + suggested, + }); + return override ? String(override) : suggested; + } catch (e: any) { + this.logger.push({ + stepId: step.id, + status: 'warning', + message: `plugin.onChooseNextLabel error: ${e?.message || String(e)}`, + }); + return suggested; + } + } + + // From current node and label, pick next nodeId using outEdges; prefers labeled edge then default + private findNextNodeId( + currentId: string, + outEdges: Map>, + nextLabel: string, + ): string | undefined { + const oes = (outEdges.get(currentId) || []) as Edge[]; + const edge = + oes.find((e) => String(e.label || ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT) === nextLabel) || + oes.find((e) => !e.label || e.label === ENGINE_CONSTANTS.EDGE_LABELS.DEFAULT); + return edge ? edge.to : undefined; + } + + private evalCondition(cond: any): boolean { + try { + if (cond && typeof cond.expression === 'string' && cond.expression.trim()) { + return !!evalExpression(String(cond.expression), { vars: this.vars }); + } + if (cond && typeof cond.var === 'string') { + const v = this.vars[cond.var]; + if ('equals' in cond) return String(v) === String(cond.equals); + return !!v; + } + } catch { + // ignore: cleanup guard + } + return false; + } + + private async cleanup() { + if (this.networkCaptureStarted) { + try { + const stopRes = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NETWORK_DEBUGGER_STOP, + args: {}, + }); + const text = (stopRes?.content || []).find((c: any) => c.type === 'text')?.text; + if (text) { + try { + const data = JSON.parse(text); + const requests: any[] = Array.isArray(data?.requests) ? data.requests : []; + const snippets = requests + .filter((r) => ['XHR', 'Fetch'].includes(String(r.type))) + .slice(0, 10) + .map((r) => ({ + method: String(r.method || 'GET'), + url: String(r.url || ''), + status: r.statusCode || r.status, + ms: Math.max(0, (r.responseTime || 0) - (r.requestTime || 0)), + })); + this.logger.push({ + stepId: LOG_STEP_IDS.NETWORK_CAPTURE, + status: 'success', + message: `Captured ${Number(data?.requestCount || 0)} requests`, + networkSnippets: snippets, + }); + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.NETWORK_CAPTURE, + status: 'warning', + message: `Failed parsing network capture result: ${e?.message || String(e)}`, + }); + } + } + } catch {} + } + await this.logger.overlayDone(); + try { + try { + await this.pluginManager.runEnd({ + runId: this.runId, + flow: this.flow, + vars: this.vars, + success: this.failed === 0 && !this.paused, + failed: this.failed, + }); + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.PLUGIN_RUN_END, + status: 'warning', + message: e?.message || String(e), + }); + } + if (!this.paused) await this.logger.persist(this.flow, this.startAt, this.failed === 0); + try { + await runState.update(this.runId, { + status: this.paused ? 'stopped' : this.failed === 0 ? 'completed' : 'failed', + updatedAt: Date.now(), + }); + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.RUNSTATE_UPDATE, + status: 'warning', + message: e?.message || String(e), + }); + } + try { + if (!this.paused) await runState.delete(this.runId); + } catch (e: any) { + this.logger.push({ + stepId: LOG_STEP_IDS.RUNSTATE_DELETE, + status: 'warning', + message: e?.message || String(e), + }); + } + } catch {} + } +} + +export async function runFlow(flow: Flow, options: RunOptions = {}): Promise { + const orchestrator = new ExecutionOrchestrator(flow, options); + return await orchestrator.run(); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/state-manager.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/state-manager.ts new file mode 100644 index 00000000..036e47de --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/state-manager.ts @@ -0,0 +1,87 @@ +// engine/state-manager.ts — lightweight run state store with events and persistence + +type Listener = (payload: T) => void; + +export interface RunState { + id: string; + flowId: string; + name?: string; + status: 'running' | 'completed' | 'failed' | 'stopped'; + startedAt: number; + updatedAt: number; +} + +export class StateManager { + private key: string; + private states = new Map(); + private listeners: Record[]> = Object.create(null); + + constructor(storageKey: string) { + this.key = storageKey; + } + + on(name: string, listener: Listener) { + (this.listeners[name] = this.listeners[name] || []).push(listener); + } + + off(name: string, listener: Listener) { + const arr = this.listeners[name]; + if (!arr) return; + const i = arr.indexOf(listener as any); + if (i >= 0) arr.splice(i, 1); + } + + private emit(name: string, payload: E) { + const arr = this.listeners[name] || []; + for (const fn of arr) + try { + fn(payload); + } catch {} + } + + getAll(): Map { + return this.states; + } + + get(id: string): T | undefined { + return this.states.get(id); + } + + async add(id: string, data: T): Promise { + this.states.set(id, data); + this.emit('add', { id, data }); + await this.persist(); + } + + async update(id: string, patch: Partial): Promise { + const cur = this.states.get(id); + if (!cur) return; + const next = Object.assign({}, cur, patch); + this.states.set(id, next); + this.emit('update', { id, data: next }); + await this.persist(); + } + + async delete(id: string): Promise { + this.states.delete(id); + this.emit('delete', { id }); + await this.persist(); + } + + private async persist(): Promise { + try { + const obj = Object.fromEntries(this.states.entries()); + await chrome.storage.local.set({ [this.key]: obj }); + } catch {} + } + + async restore(): Promise { + try { + const res = await chrome.storage.local.get(this.key); + const obj = (res && res[this.key]) || {}; + this.states = new Map(Object.entries(obj) as any); + } catch {} + } +} + +export const runState = new StateManager('rr_run_states'); diff --git a/app/chrome-extension/entrypoints/background/record-replay/engine/utils/expression.ts b/app/chrome-extension/entrypoints/background/record-replay/engine/utils/expression.ts new file mode 100644 index 00000000..44352216 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/engine/utils/expression.ts @@ -0,0 +1,227 @@ +// expression.ts — minimal safe boolean expression evaluator (no access to global scope) +// Supported: +// - Literals: numbers (123, 1.23), strings ('x' or "x"), booleans (true/false) +// - Variables: vars.x, vars.a.b (only reads from provided vars object) +// - Operators: !, &&, ||, ==, !=, >, >=, <, <=, +, -, *, / +// - Parentheses: ( ... ) + +type Token = { type: string; value?: any }; + +function tokenize(input: string): Token[] { + const s = input.trim(); + const out: Token[] = []; + let i = 0; + const isAlpha = (c: string) => /[a-zA-Z_]/.test(c); + const isNum = (c: string) => /[0-9]/.test(c); + const isIdChar = (c: string) => /[a-zA-Z0-9_]/.test(c); + while (i < s.length) { + const c = s[i]; + if (c === ' ' || c === '\t' || c === '\n' || c === '\r') { + i++; + continue; + } + // operators + if ( + s.startsWith('&&', i) || + s.startsWith('||', i) || + s.startsWith('==', i) || + s.startsWith('!=', i) || + s.startsWith('>=', i) || + s.startsWith('<=', i) + ) { + out.push({ type: 'op', value: s.slice(i, i + 2) }); + i += 2; + continue; + } + if ('!+-*/()<>'.includes(c)) { + out.push({ type: 'op', value: c }); + i++; + continue; + } + // number + if (isNum(c) || (c === '.' && isNum(s[i + 1] || ''))) { + let j = i + 1; + while (j < s.length && (isNum(s[j]) || s[j] === '.')) j++; + out.push({ type: 'num', value: parseFloat(s.slice(i, j)) }); + i = j; + continue; + } + // string + if (c === '"' || c === "'") { + const quote = c; + let j = i + 1; + let str = ''; + while (j < s.length) { + if (s[j] === '\\' && j + 1 < s.length) { + str += s[j + 1]; + j += 2; + } else if (s[j] === quote) { + j++; + break; + } else { + str += s[j++]; + } + } + out.push({ type: 'str', value: str }); + i = j; + continue; + } + // identifier (vars or true/false) + if (isAlpha(c)) { + let j = i + 1; + while (j < s.length && isIdChar(s[j])) j++; + let id = s.slice(i, j); + // dotted path + while (s[j] === '.' && isAlpha(s[j + 1] || '')) { + let k = j + 1; + while (k < s.length && isIdChar(s[k])) k++; + id += s.slice(j, k); + j = k; + } + out.push({ type: 'id', value: id }); + i = j; + continue; + } + // unknown token, skip to avoid crash + i++; + } + return out; +} + +// Recursive descent parser +export function evalExpression(expr: string, scope: { vars: Record }): any { + const tokens = tokenize(expr); + let i = 0; + const peek = () => tokens[i]; + const consume = () => tokens[i++]; + + function parsePrimary(): any { + const t = peek(); + if (!t) return undefined; + if (t.type === 'num') { + consume(); + return t.value; + } + if (t.type === 'str') { + consume(); + return t.value; + } + if (t.type === 'id') { + consume(); + const id = String(t.value); + if (id === 'true') return true; + if (id === 'false') return false; + // Only allow vars.* lookups + if (!id.startsWith('vars')) return undefined; + try { + const parts = id.split('.').slice(1); + let cur: any = scope.vars; + for (const p of parts) { + if (cur == null) return undefined; + cur = cur[p]; + } + return cur; + } catch { + return undefined; + } + } + if (t.type === 'op' && t.value === '(') { + consume(); + const v = parseOr(); + if (peek()?.type === 'op' && peek()?.value === ')') consume(); + return v; + } + return undefined; + } + + function parseUnary(): any { + const t = peek(); + if (t && t.type === 'op' && (t.value === '!' || t.value === '-')) { + consume(); + const v = parseUnary(); + return t.value === '!' ? !truthy(v) : -Number(v || 0); + } + return parsePrimary(); + } + + function parseMulDiv(): any { + let v = parseUnary(); + while (peek() && peek().type === 'op' && (peek().value === '*' || peek().value === '/')) { + const op = consume().value; + const r = parseUnary(); + v = op === '*' ? Number(v || 0) * Number(r || 0) : Number(v || 0) / Number(r || 0); + } + return v; + } + + function parseAddSub(): any { + let v = parseMulDiv(); + while (peek() && peek().type === 'op' && (peek().value === '+' || peek().value === '-')) { + const op = consume().value; + const r = parseMulDiv(); + v = op === '+' ? Number(v || 0) + Number(r || 0) : Number(v || 0) - Number(r || 0); + } + return v; + } + + function parseRel(): any { + let v = parseAddSub(); + while (peek() && peek().type === 'op' && ['>', '>=', '<', '<='].includes(peek().value)) { + const op = consume().value as string; + const r = parseAddSub(); + const a = toComparable(v); + const b = toComparable(r); + if (op === '>') v = (a as any) > (b as any); + else if (op === '>=') v = (a as any) >= (b as any); + else if (op === '<') v = (a as any) < (b as any); + else v = (a as any) <= (b as any); + } + return v; + } + + function parseEq(): any { + let v = parseRel(); + while (peek() && peek().type === 'op' && (peek().value === '==' || peek().value === '!=')) { + const op = consume().value as string; + const r = parseRel(); + const a = toComparable(v); + const b = toComparable(r); + v = op === '==' ? a === b : a !== b; + } + return v; + } + + function parseAnd(): any { + let v = parseEq(); + while (peek() && peek().type === 'op' && peek().value === '&&') { + consume(); + const r = parseEq(); + v = truthy(v) && truthy(r); + } + return v; + } + + function parseOr(): any { + let v = parseAnd(); + while (peek() && peek().type === 'op' && peek().value === '||') { + consume(); + const r = parseAnd(); + v = truthy(v) || truthy(r); + } + return v; + } + + function truthy(v: any) { + return !!v; + } + function toComparable(v: any) { + return typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean' ? v : String(v); + } + + try { + const res = parseOr(); + return res; + } catch { + return false; + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/flow-runner.ts b/app/chrome-extension/entrypoints/background/record-replay/flow-runner.ts new file mode 100644 index 00000000..2682e3a5 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/flow-runner.ts @@ -0,0 +1,3 @@ +// thin re-export for backward compatibility +export { runFlow } from './engine/scheduler'; +export type { RunOptions } from './engine/scheduler'; diff --git a/app/chrome-extension/entrypoints/background/record-replay/flow-store.ts b/app/chrome-extension/entrypoints/background/record-replay/flow-store.ts new file mode 100644 index 00000000..5e96fa28 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/flow-store.ts @@ -0,0 +1,422 @@ +import type { Flow, RunRecord, NodeBase, Edge } from './types'; +import { stepsToDAG, type RRNode, type RREdge } from 'chrome-mcp-shared'; +import { NODE_TYPES } from '@/common/node-types'; +import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; +import { IndexedDbStorage, ensureMigratedFromLocal } from './storage/indexeddb-manager'; + +// Design note: IndexedDB-backed store for flows and run records. +// Includes lazy migration from chrome.storage.local for backwards compatibility. + +// Validate if a type string is a valid NodeType +const VALID_NODE_TYPES = new Set(Object.values(NODE_TYPES)); +function isValidNodeType(type: string): boolean { + return VALID_NODE_TYPES.has(type); +} + +// Convert RRNode to NodeBase (ui coordinates are optional, not added here) +function toNodeBase(node: RRNode): NodeBase { + return { + id: node.id, + type: isValidNodeType(node.type) ? (node.type as NodeBase['type']) : NODE_TYPES.SCRIPT, + config: node.config, + }; +} + +// Convert RREdge to Edge +function toEdge(edge: RREdge): Edge { + return { + id: edge.id, + from: edge.from, + to: edge.to, + label: edge.label, + }; +} + +/** + * Filter edges to only keep those whose from/to both exist in nodeIds. + * Prevents topoOrder crash when edges reference non-existent nodes. + */ +function filterValidEdges(edges: Edge[], nodeIds: Set): Edge[] { + return edges.filter((e) => nodeIds.has(e.from) && nodeIds.has(e.to)); +} + +// ============================================================================= +// UI Notification +// ============================================================================= + +/** + * Timer handle for coalescing flow change notifications. + * Prevents multiple rapid changes (e.g., during import) from flooding UI. + */ +let flowsChangedTimer: ReturnType | undefined; + +/** + * Notify UI that flows have changed. + * Uses a short debounce (50ms) to coalesce rapid changes. + */ +function notifyFlowsChanged(): void { + // If timer is already scheduled, skip (will be handled by pending timer) + if (flowsChangedTimer !== undefined) return; + + flowsChangedTimer = setTimeout(() => { + flowsChangedTimer = undefined; + try { + // Send message to all extension contexts (popup, sidepanel, etc.) + // Use void cast to avoid unhandled promise rejection + void chrome.runtime + .sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.RR_FLOWS_CHANGED, + }) + .catch(() => { + // Ignore errors - no listeners is expected when UI is closed + }); + } catch { + // Ignore errors (e.g., if chrome.runtime is not available) + } + }, 50); +} + +/** + * Strip deprecated steps field before persisting to IndexedDB. + * This ensures new saves only contain the DAG model (nodes/edges). + * + * @param flow - Flow with or without steps + * @returns Flow without steps field (omit entirely, not set to empty array) + */ +function stripStepsForSave(flow: Flow): Flow { + if (!('steps' in flow)) { + return flow; + } + + const { steps: _steps, ...rest } = flow; + return rest as Flow; +} + +/** + * Normalize flow before saving: ensure nodes/edges exist for scheduler compatibility. + * Only generates DAG from steps if nodes are missing or empty. + * Preserves existing nodes/edges to avoid overwriting user edits. + * + * Also validates edges: removes edges referencing non-existent nodes to prevent + * runtime errors in scheduler's topoOrder calculation. + */ +function normalizeFlowForSave(flow: Flow): Flow { + const hasNodes = Array.isArray(flow.nodes) && flow.nodes.length > 0; + if (hasNodes) { + // Validate edges even when nodes exist (e.g., imported flows may have invalid edges) + const nodeIds = new Set(flow.nodes!.map((n) => n.id)); + if (Array.isArray(flow.edges) && flow.edges.length > 0) { + const validEdges = filterValidEdges(flow.edges, nodeIds); + if (validEdges.length !== flow.edges.length) { + // Some edges were invalid, return cleaned flow + return { ...flow, edges: validEdges }; + } + } + return flow; + } + + // No nodes - generate from steps + if (!Array.isArray(flow.steps) || flow.steps.length === 0) { + return flow; + } + + const dag = stepsToDAG(flow.steps); + if (dag.nodes.length === 0) { + return flow; + } + + const nodes: NodeBase[] = dag.nodes.map(toNodeBase); + const nodeIds = new Set(nodes.map((n) => n.id)); + + // Validate existing edges: only keep if from/to both exist in new nodes + // Otherwise fall back to generated chain edges + let edges: Edge[]; + if (Array.isArray(flow.edges) && flow.edges.length > 0) { + const validEdges = filterValidEdges(flow.edges, nodeIds); + edges = validEdges.length > 0 ? validEdges : dag.edges.map(toEdge); + } else { + edges = dag.edges.map(toEdge); + } + + return { + ...flow, + nodes, + edges, + }; +} + +export interface PublishedFlowInfo { + id: string; + slug: string; // for tool name `flow.` + version: number; + name: string; + description?: string; +} + +/** + * Check if a flow needs normalization (missing nodes when steps exist). + */ +function needsNormalization(flow: Flow): boolean { + const hasSteps = Array.isArray(flow.steps) && flow.steps.length > 0; + const hasNodes = Array.isArray(flow.nodes) && flow.nodes.length > 0; + return hasSteps && !hasNodes; +} + +/** + * Lazy normalize a flow if needed, and persist the normalized version. + * This handles legacy flows that only have steps but no nodes. + * After normalization, steps field is stripped before persist AND return. + */ +async function lazyNormalize(flow: Flow): Promise { + if (!needsNormalization(flow)) { + return stripStepsForSave(flow); + } + // Normalize and save back to storage (strip steps before persist) + const normalized = normalizeFlowForSave(flow); + const cleanFlow = stripStepsForSave(normalized); + try { + await IndexedDbStorage.flows.save(cleanFlow); + } catch (e) { + console.warn('lazyNormalize: failed to save normalized flow', e); + } + // Return DAG-only flow (do not leak deprecated steps to callers) + return cleanFlow; +} + +export async function listFlows(): Promise { + await ensureMigratedFromLocal(); + const flows = await IndexedDbStorage.flows.list(); + // Check if any flows need normalization + const needsNorm = flows.some(needsNormalization); + if (!needsNorm) { + // Strip steps from all flows before returning + return flows.map(stripStepsForSave); + } + // Normalize flows that need it (in parallel) + // lazyNormalize already returns DAG-only flow + const normalized = await Promise.all( + flows.map(async (flow) => { + if (needsNormalization(flow)) { + return lazyNormalize(flow); + } + return stripStepsForSave(flow); + }), + ); + return normalized; +} + +export async function getFlow(flowId: string): Promise { + await ensureMigratedFromLocal(); + const flow = await IndexedDbStorage.flows.get(flowId); + if (!flow) return undefined; + // Lazy normalize if needed (lazyNormalize returns DAG-only) + if (needsNormalization(flow)) { + return lazyNormalize(flow); + } + // Strip steps before returning + return stripStepsForSave(flow); +} + +export async function saveFlow(flow: Flow, options?: { notify?: boolean }): Promise { + await ensureMigratedFromLocal(); + // 1. Normalize: generate nodes/edges from steps if missing + // 2. Strip: remove deprecated steps field before persist + const normalizedFlow = normalizeFlowForSave(flow); + const cleanFlow = stripStepsForSave(normalizedFlow); + await IndexedDbStorage.flows.save(cleanFlow); + // Notify UI by default, can be disabled for batch operations + if (options?.notify !== false) { + notifyFlowsChanged(); + } +} + +export async function deleteFlow(flowId: string): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.flows.delete(flowId); + notifyFlowsChanged(); +} + +export async function listRuns(): Promise { + await ensureMigratedFromLocal(); + return await IndexedDbStorage.runs.list(); +} + +export async function appendRun(record: RunRecord): Promise { + await ensureMigratedFromLocal(); + const runs = await IndexedDbStorage.runs.list(); + runs.push(record); + // Trim to keep last 10 runs per flowId to avoid unbounded growth + try { + const byFlow = new Map(); + for (const r of runs) { + const list = byFlow.get(r.flowId) || []; + list.push(r); + byFlow.set(r.flowId, list); + } + const merged: RunRecord[] = []; + for (const [, arr] of byFlow.entries()) { + arr.sort((a, b) => new Date(a.startedAt).getTime() - new Date(b.startedAt).getTime()); + const last = arr.slice(Math.max(0, arr.length - 10)); + merged.push(...last); + } + await IndexedDbStorage.runs.replaceAll(merged); + } catch (e) { + console.warn('appendRun: trim failed, saving all', e); + await IndexedDbStorage.runs.replaceAll(runs); + } +} + +export async function listPublished(): Promise { + await ensureMigratedFromLocal(); + return await IndexedDbStorage.published.list(); +} + +export async function publishFlow(flow: Flow, slug?: string): Promise { + await ensureMigratedFromLocal(); + const info: PublishedFlowInfo = { + id: flow.id, + slug: slug || toSlug(flow.name) || flow.id, + version: flow.version, + name: flow.name, + description: flow.description, + }; + await IndexedDbStorage.published.save(info); + return info; +} + +export async function unpublishFlow(flowId: string): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.published.delete(flowId); +} + +export function toSlug(name: string): string { + return (name || '') + .toLowerCase() + .replace(/[^a-z0-9]+/g, '-') + .replace(/(^-|-$)+/g, '') + .slice(0, 64); +} + +export async function exportFlow(flowId: string): Promise { + const flow = await getFlow(flowId); + if (!flow) throw new Error('flow not found'); + return JSON.stringify(flow, null, 2); +} + +export async function exportAllFlows(): Promise { + const flows = await listFlows(); + return JSON.stringify({ flows }, null, 2); +} + +/** + * Import flows from JSON string. + * + * Supported formats: + * 1. Array of flows: [...flows] + * 2. Object with flows array: { flows: [...] } + * 3. Single flow with steps: { id, steps: [...] } + * 4. Single flow with nodes (new format): { id, nodes: [...], edges?: [...] } + * + * Flows are normalized on save (steps → nodes if needed). + */ +export async function importFlowFromJson(json: string): Promise { + await ensureMigratedFromLocal(); + const parsed = JSON.parse(json); + + // Detect candidates from various formats + const candidates: unknown[] = Array.isArray(parsed) + ? parsed + : Array.isArray(parsed?.flows) + ? parsed.flows + : parsed?.id && (Array.isArray(parsed?.steps) || Array.isArray(parsed?.nodes)) + ? [parsed] + : []; + + if (!candidates.length) { + throw new Error('invalid flow json: no flows found'); + } + + const nowIso = new Date().toISOString(); + const flowsToImport: Flow[] = []; + + for (const raw of candidates) { + if (!raw || typeof raw !== 'object') { + throw new Error('invalid flow json: flow must be an object'); + } + + const f = raw as Record; + const id = String(f.id || '').trim(); + if (!id) { + throw new Error('invalid flow json: missing id'); + } + + // Normalize fields with sensible defaults + const name = typeof f.name === 'string' && f.name.trim() ? f.name : id; + const version = Number.isFinite(Number(f.version)) ? Number(f.version) : 1; + + // Handle meta with proper timestamps + const existingMeta = + f.meta && typeof f.meta === 'object' ? (f.meta as Record) : {}; + const createdAt = typeof existingMeta.createdAt === 'string' ? existingMeta.createdAt : nowIso; + + // Build flow object - preserve steps only if present (for normalize) + // saveFlow() will normalize (steps→nodes) then strip steps before persist + const flow: Flow = { + ...(f as object), + id, + name, + version, + meta: { + ...existingMeta, + createdAt, + updatedAt: nowIso, + }, + } as Flow; + + // Preserve steps for normalization if present in import data + if (Array.isArray(f.steps) && f.steps.length > 0) { + flow.steps = f.steps as Flow['steps']; + } + + flowsToImport.push(flow); + } + + // Save all flows (normalize on save) + // Disable individual notifications to avoid flooding UI during batch import + for (const f of flowsToImport) { + await saveFlow(f, { notify: false }); + } + + // Send single notification after all flows are imported + notifyFlowsChanged(); + + return flowsToImport; +} + +// Scheduling support +export type ScheduleType = 'once' | 'interval' | 'daily'; +export interface FlowSchedule { + id: string; // schedule id + flowId: string; + type: ScheduleType; + enabled: boolean; + // when: ISO string for 'once'; HH:mm for 'daily'; minutes for 'interval' + when: string; + // optional variables to pass when running + args?: Record; +} + +export async function listSchedules(): Promise { + await ensureMigratedFromLocal(); + return await IndexedDbStorage.schedules.list(); +} + +export async function saveSchedule(s: FlowSchedule): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.schedules.save(s); +} + +export async function removeSchedule(scheduleId: string): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.schedules.delete(scheduleId); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/index.ts b/app/chrome-extension/entrypoints/background/record-replay/index.ts new file mode 100644 index 00000000..1f603511 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/index.ts @@ -0,0 +1,504 @@ +import { BACKGROUND_MESSAGE_TYPES, CONTENT_MESSAGE_TYPES } from '@/common/message-types'; +import { Flow } from './types'; +import { + listFlows, + saveFlow, + getFlow, + deleteFlow, + publishFlow, + unpublishFlow, + exportFlow, + exportAllFlows, + importFlowFromJson, + listSchedules, + saveSchedule, + removeSchedule, + type FlowSchedule, +} from './flow-store'; +import { listRuns } from './flow-store'; +import { STORAGE_KEYS } from '@/common/constants'; +import { listTriggers, saveTrigger, deleteTrigger, type FlowTrigger } from './trigger-store'; +import { runFlow } from './flow-runner'; +import { RecorderManager } from './recording/recorder-manager'; +import { recordingSession } from './recording/session-manager'; +// Browser/content listeners are initialized via RecorderManager.init + +// design note: background listener for record & replay; delegates recording to dedicated modules + +// Alarm helpers for schedules +async function rescheduleAlarms() { + const schedules = await listSchedules(); + // Clear existing rr_schedule_* alarms + const alarms = await chrome.alarms.getAll(); + await Promise.all( + alarms + .filter((a) => a.name && a.name.startsWith('rr_schedule_')) + .map((a) => chrome.alarms.clear(a.name)), + ); + for (const s of schedules) { + if (!s.enabled) continue; + const name = `rr_schedule_${s.id}`; + if (s.type === 'interval') { + const minutes = Math.max(1, Math.floor(Number(s.when) || 0)); + await chrome.alarms.create(name, { periodInMinutes: minutes }); + } else if (s.type === 'once') { + const whenMs = Date.parse(s.when); + if (Number.isFinite(whenMs)) await chrome.alarms.create(name, { when: whenMs }); + } else if (s.type === 'daily') { + // daily HH:mm local time + const [hh, mm] = String(s.when || '00:00') + .split(':') + .map((x) => Number(x)); + const now = new Date(); + const next = new Date(); + next.setHours(hh || 0, mm || 0, 0, 0); + if (next.getTime() <= now.getTime()) next.setDate(next.getDate() + 1); + await chrome.alarms.create(name, { when: next.getTime(), periodInMinutes: 24 * 60 }); + } + } +} + +// legacy injection helpers removed — use recording/content-injection when needed + +async function startRecording(meta?: Partial): Promise<{ success: boolean; error?: string }> { + return await RecorderManager.start(meta); +} + +async function stopRecording(): Promise<{ success: boolean; flow?: Flow; error?: string }> { + return await RecorderManager.stop(); +} + +export function initRecordReplayListeners() { + // Storage state sync is handled within session manager and recorder manager + // On startup, re-schedule alarms + rescheduleAlarms().catch(() => {}); + // Initialize trigger engine (contextMenus/commands/url/dom) + initTriggerEngine().catch(() => {}); + // Initialize recorder manager (wires browser and content listeners) + RecorderManager.init().catch(() => {}); + + chrome.runtime.onMessage.addListener((message, sender, sendResponse) => { + try { + // rr_recorder_event 交由 ContentMessageHandler 处理 + switch (message?.type) { + case BACKGROUND_MESSAGE_TYPES.RR_START_RECORDING: { + startRecording(message.meta) + .then(sendResponse) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_STOP_RECORDING: { + stopRecording() + .then(sendResponse) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_PAUSE_RECORDING: { + RecorderManager.pause() + .then(sendResponse) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_RESUME_RECORDING: { + RecorderManager.resume() + .then(sendResponse) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_GET_RECORDING_STATUS: { + const status = recordingSession.getStatus(); + const session = recordingSession.getSession(); + sendResponse({ + success: true, + status, + sessionId: session.sessionId, + originTabId: session.originTabId, + }); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_LIST_FLOWS: { + listFlows() + .then((flows) => sendResponse({ success: true, flows })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_GET_FLOW: { + getFlow(message.flowId) + .then((flow) => sendResponse({ success: !!flow, flow })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_DELETE_FLOW: { + deleteFlow(message.flowId) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_PUBLISH_FLOW: { + getFlow(message.flowId) + .then(async (flow) => { + if (!flow) return sendResponse({ success: false, error: 'flow not found' }); + await publishFlow(flow, message.slug); + sendResponse({ success: true }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_UNPUBLISH_FLOW: { + unpublishFlow(message.flowId) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_RUN_FLOW: { + getFlow(message.flowId) + .then(async (flow) => { + if (!flow) return sendResponse({ success: false, error: 'flow not found' }); + const result = await runFlow(flow, message.options || {}); + sendResponse({ success: true, result }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_SAVE_FLOW: { + const flow = message.flow as Flow; + if (!flow || !flow.id) { + sendResponse({ success: false, error: 'invalid flow' }); + return true; + } + saveFlow(flow) + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_EXPORT_FLOW: { + exportFlow(message.flowId) + .then((json) => sendResponse({ success: true, json })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_EXPORT_ALL: { + exportAllFlows() + .then((json) => sendResponse({ success: true, json })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_IMPORT_FLOW: { + importFlowFromJson(message.json) + .then((flows) => sendResponse({ success: true, imported: flows.length, flows })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_LIST_RUNS: { + listRuns() + .then((runs) => sendResponse({ success: true, runs })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_LIST_TRIGGERS: { + listTriggers() + .then((triggers) => sendResponse({ success: true, triggers })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_SAVE_TRIGGER: { + const t = message.trigger as FlowTrigger; + if (!t || !t.id || !t.type || !t.flowId) { + sendResponse({ success: false, error: 'invalid trigger' }); + return true; + } + saveTrigger(t) + .then(async () => { + await refreshTriggers(); + sendResponse({ success: true }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_DELETE_TRIGGER: { + const id = String(message.id || ''); + if (!id) { + sendResponse({ success: false, error: 'invalid id' }); + return true; + } + deleteTrigger(id) + .then(async () => { + await refreshTriggers(); + sendResponse({ success: true }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_REFRESH_TRIGGERS: { + refreshTriggers() + .then(() => sendResponse({ success: true })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_LIST_SCHEDULES: { + listSchedules() + .then((s) => sendResponse({ success: true, schedules: s })) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_SCHEDULE_FLOW: { + const s = message.schedule as FlowSchedule; + if (!s || !s.id || !s.flowId) { + sendResponse({ success: false, error: 'invalid schedule' }); + return true; + } + saveSchedule(s) + .then(async () => { + await rescheduleAlarms(); + sendResponse({ success: true }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + case BACKGROUND_MESSAGE_TYPES.RR_UNSCHEDULE_FLOW: { + const scheduleId = String(message.scheduleId || ''); + if (!scheduleId) { + sendResponse({ success: false, error: 'invalid scheduleId' }); + return true; + } + removeSchedule(scheduleId) + .then(async () => { + await rescheduleAlarms(); + sendResponse({ success: true }); + }) + .catch((e) => sendResponse({ success: false, error: e?.message || String(e) })); + return true; + } + } + } catch (err) { + sendResponse({ success: false, error: (err as any)?.message || String(err) }); + } + return false; + }); + + // Trigger engine: contextMenus/commands/url/dom + if ((chrome as any).contextMenus?.onClicked?.addListener) { + chrome.contextMenus.onClicked.addListener(async (info) => { + try { + const triggers = await listTriggers(); + const t = triggers.find( + (x) => x.type === 'contextMenu' && (x as any).menuId === info.menuItemId, + ); + if (!t || t.enabled === false) return; + const flow = await getFlow(t.flowId); + if (!flow) return; + await runFlow(flow, { args: t.args || {}, returnLogs: false }); + } catch {} + }); + } + chrome.commands.onCommand.addListener(async (command) => { + try { + const triggers = await listTriggers(); + const t = triggers.find((x) => x.type === 'command' && (x as any).commandKey === command); + if (!t || t.enabled === false) return; + const flow = await getFlow(t.flowId); + if (!flow) return; + await runFlow(flow, { args: t.args || {}, returnLogs: false }); + } catch {} + }); + chrome.webNavigation.onCommitted.addListener(async (details) => { + try { + if (details.frameId !== 0) return; + const url = details.url || ''; + // Ensure core content scripts are injected for this tab (pre-heat for replay) + await ensureCoreInjected(details.tabId); + // Ensure DOM observer is active on this tab (if triggers exist) + try { + const { [STORAGE_KEYS.RR_TRIGGERS]: stored } = + (await chrome.storage.local.get(STORAGE_KEYS.RR_TRIGGERS)) || {}; + const triggers: any[] = Array.isArray(stored) ? stored : []; + const domTriggers = triggers + .filter((x) => x.type === 'dom' && x.enabled !== false) + .map((x: any) => ({ + id: x.id, + selector: x.selector, + appear: x.appear !== false, + once: x.once !== false, + debounceMs: x.debounceMs ?? 800, + })); + if (typeof details.tabId === 'number') { + try { + await chrome.scripting.executeScript({ + target: { tabId: details.tabId, allFrames: true }, + files: ['inject-scripts/dom-observer.js'], + world: 'ISOLATED', + } as any); + await chrome.tabs.sendMessage(details.tabId, { + action: 'set_dom_triggers', + triggers: domTriggers, + } as any); + } catch {} + } + } catch {} + const triggers = await listTriggers(); + const list = triggers.filter((x) => x.type === 'url' && x.enabled !== false) as any[]; + for (const t of list) { + if (matchUrl(url, (t as any).match || [])) { + const flow = await getFlow(t.flowId); + if (!flow) continue; + await runFlow(flow, { args: t.args || {}, returnLogs: false }); + } + } + } catch {} + }); + chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => { + try { + if (message && message.action === 'dom_trigger_fired') { + const id = message.triggerId; + listTriggers().then(async (arr) => { + const t = arr.find((x) => x.id === id && x.type === 'dom'); + if (!t || t.enabled === false) return; + const flow = await getFlow(t.flowId); + if (!flow) return; + await runFlow(flow, { args: t.args || {}, returnLogs: false }); + }); + sendResponse({ ok: true }); + return true; + } + } catch {} + return false; + }); +} + +function matchUrl( + u: string, + rules: Array<{ kind: 'url' | 'domain' | 'path'; value: string }>, +): boolean { + try { + const url = new URL(u); + for (const r of rules || []) { + const v = String(r.value || ''); + if (r.kind === 'url' && u.startsWith(v)) return true; + if (r.kind === 'domain' && url.hostname.includes(v)) return true; + if (r.kind === 'path' && url.pathname.startsWith(v)) return true; + } + } catch {} + return false; +} + +// Track context menu IDs created by record-replay to avoid removing other menus +const rrContextMenuIds = new Set(); + +async function refreshContextMenus(triggers: FlowTrigger[]) { + if (!(chrome as any).contextMenus?.create) return; + + // Remove only our own menu items + await removeRecordReplayMenus(); + + // Create menus for enabled context menu triggers + for (const t of triggers) { + if (t.type !== 'contextMenu' || t.enabled === false) continue; + const id = `rr_menu_${t.id}`; + (t as any).menuId = id; + + try { + await chrome.contextMenus.create({ + id, + title: (t as any).title || '运行工作流', + contexts: (t as any).contexts || ['all'], + }); + rrContextMenuIds.add(id); + } catch (err) { + console.warn('[RecordReplay] Failed to create context menu:', err); + } + } +} + +async function removeRecordReplayMenus() { + if (!(chrome as any).contextMenus?.remove) { + rrContextMenuIds.clear(); + return; + } + + const pending = Array.from(rrContextMenuIds.values()).map((id) => + chrome.contextMenus.remove(id).catch(() => {}), + ); + + if (pending.length) await Promise.all(pending); + rrContextMenuIds.clear(); +} + +async function refreshTriggers() { + try { + const triggers = await listTriggers(); + await refreshContextMenus(triggers); + await chrome.storage.local.set({ [STORAGE_KEYS.RR_TRIGGERS]: triggers }); + const domTriggers = triggers + .filter((x) => x.type === 'dom' && x.enabled !== false) + .map((x: any) => ({ + id: x.id, + selector: x.selector, + appear: x.appear !== false, + once: x.once !== false, + debounceMs: x.debounceMs ?? 800, + })); + const tabs = await chrome.tabs.query({}); + for (const t of tabs) { + if (!t.id) continue; + try { + await chrome.scripting.executeScript({ + target: { tabId: t.id, allFrames: true }, + files: ['inject-scripts/dom-observer.js'], + world: 'ISOLATED', + } as any); + await chrome.tabs.sendMessage(t.id, { + action: 'set_dom_triggers', + triggers: domTriggers, + } as any); + } catch {} + } + } catch {} +} + +// Backward-compatible init function; initialize all trigger-related hooks/state +async function initTriggerEngine() { + await refreshTriggers(); +} + +// Ensure core content scripts are present for a tab after navigation +async function ensureCoreInjected(tabId?: number) { + try { + if (typeof tabId !== 'number') return; + // Ping accessibility helper + const ok = await pingTab(tabId, CONTENT_MESSAGE_TYPES.ACCESSIBILITY_TREE_HELPER_PING); + if (!ok) { + await chrome.scripting.executeScript({ + target: { tabId, allFrames: true }, + files: ['inject-scripts/inject-bridge.js', 'inject-scripts/accessibility-tree-helper.js'], + world: 'ISOLATED', + } as any); + } + } catch {} +} + +async function pingTab(tabId: number, action: string): Promise { + try { + const resp: any = await chrome.tabs.sendMessage(tabId, { action } as any); + if (!resp) return false; + // Helpers generally respond { status: 'pong' } or { ok: true } + return resp.status === 'pong' || resp.ok === true; + } catch { + return false; + } +} + +// Alarm listener executes scheduled flows +chrome.alarms.onAlarm.addListener(async (alarm) => { + try { + if (!alarm?.name || !alarm.name.startsWith('rr_schedule_')) return; + const id = alarm.name.slice('rr_schedule_'.length); + const schedules = await listSchedules(); + const s = schedules.find((x) => x.id === id && x.enabled); + if (!s) return; + const flow = await getFlow(s.flowId); + if (!flow) return; + await runFlow(flow, { args: s.args || {}, returnLogs: false }); + } catch (e) { + // swallow to not spam logs + } +}); diff --git a/app/chrome-extension/entrypoints/background/record-replay/legacy-types.ts b/app/chrome-extension/entrypoints/background/record-replay/legacy-types.ts new file mode 100644 index 00000000..2586abb9 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/legacy-types.ts @@ -0,0 +1,252 @@ +/** + * Legacy Step Types for Record & Replay + * + * This file contains the legacy Step type system that is being phased out + * in favor of the DAG-based execution model (nodes/edges). + * + * These types are kept for: + * 1. Backward compatibility with existing flows that use steps array + * 2. Recording pipeline that still produces Step[] output + * 3. Legacy node handlers in nodes/ directory + * + * New code should use the Action type system from ./actions/types.ts instead. + * + * Migration status: P4 phase 1 - types extracted, re-exported from types.ts + */ + +import { STEP_TYPES } from '@/common/step-types'; + +// ============================================================================= +// Legacy Selector Types +// ============================================================================= + +export type SelectorType = 'css' | 'xpath' | 'attr' | 'aria' | 'text'; + +export interface SelectorCandidate { + type: SelectorType; + value: string; // literal selector or text/aria expression + weight?: number; // user-adjustable priority; higher first +} + +export interface TargetLocator { + ref?: string; // ephemeral ref from read_page + candidates: SelectorCandidate[]; // ordered by priority +} + +// ============================================================================= +// Legacy Step Types +// ============================================================================= + +export type StepType = (typeof STEP_TYPES)[keyof typeof STEP_TYPES]; + +export interface StepBase { + id: string; + type: StepType; + timeoutMs?: number; // default 10000 + retry?: { count: number; intervalMs: number; backoff?: 'none' | 'exp' }; + screenshotOnFail?: boolean; // default true +} + +export interface StepClick extends StepBase { + type: 'click' | 'dblclick'; + target: TargetLocator; + before?: { scrollIntoView?: boolean; waitForSelector?: boolean }; + after?: { waitForNavigation?: boolean; waitForNetworkIdle?: boolean }; +} + +export interface StepFill extends StepBase { + type: 'fill'; + target: TargetLocator; + value: string; // may contain {var} +} + +export interface StepTriggerEvent extends StepBase { + type: 'triggerEvent'; + target: TargetLocator; + event: string; // e.g. 'input', 'change', 'mouseover' + bubbles?: boolean; + cancelable?: boolean; +} + +export interface StepSetAttribute extends StepBase { + type: 'setAttribute'; + target: TargetLocator; + name: string; + value?: string; // when omitted and remove=true, remove attribute + remove?: boolean; +} + +export interface StepScreenshot extends StepBase { + type: 'screenshot'; + selector?: string; + fullPage?: boolean; + saveAs?: string; // variable name to store base64 +} + +export interface StepSwitchFrame extends StepBase { + type: 'switchFrame'; + frame?: { index?: number; urlContains?: string }; +} + +export interface StepLoopElements extends StepBase { + type: 'loopElements'; + selector: string; + saveAs?: string; // list var name + itemVar?: string; // default 'item' + subflowId: string; +} + +export interface StepKey extends StepBase { + type: 'key'; + keys: string; // e.g. "Backspace Enter" or "cmd+a" + target?: TargetLocator; // optional focus target +} + +export interface StepScroll extends StepBase { + type: 'scroll'; + mode: 'element' | 'offset' | 'container'; + target?: TargetLocator; // when mode = element / container + offset?: { x?: number; y?: number }; +} + +export interface StepDrag extends StepBase { + type: 'drag'; + start: TargetLocator; + end: TargetLocator; + path?: Array<{ x: number; y: number }>; // sampled trajectory +} + +export interface StepWait extends StepBase { + type: 'wait'; + condition: + | { selector: string; visible?: boolean } + | { text: string; appear?: boolean } + | { navigation: true } + | { networkIdle: true } + | { sleep: number }; +} + +export interface StepAssert extends StepBase { + type: 'assert'; + assert: + | { exists: string } + | { visible: string } + | { textPresent: string } + | { attribute: { selector: string; name: string; equals?: string; matches?: string } }; + // 失败策略：stop=失败即停（默认）、warn=仅告警并继续、retry=触发重试机制 + failStrategy?: 'stop' | 'warn' | 'retry'; +} + +export interface StepScript extends StepBase { + type: 'script'; + world?: 'MAIN' | 'ISOLATED'; + code: string; // user script string + when?: 'before' | 'after'; +} + +export interface StepIf extends StepBase { + type: 'if'; + // condition supports: { var: string; equals?: any } | { expression: string } + condition: any; +} + +export interface StepForeach extends StepBase { + type: 'foreach'; + listVar: string; + itemVar?: string; + subflowId: string; +} + +export interface StepWhile extends StepBase { + type: 'while'; + condition: any; + subflowId: string; + maxIterations?: number; +} + +export interface StepHttp extends StepBase { + type: 'http'; + method?: string; + url: string; + headers?: Record; + body?: any; + formData?: any; + saveAs?: string; + assign?: Record; +} + +export interface StepExtract extends StepBase { + type: 'extract'; + selector?: string; + attr?: string; // 'text'|'textContent' to read text + js?: string; // custom JS that returns value + saveAs: string; +} + +export interface StepOpenTab extends StepBase { + type: 'openTab'; + url?: string; + newWindow?: boolean; +} + +export interface StepSwitchTab extends StepBase { + type: 'switchTab'; + tabId?: number; + urlContains?: string; + titleContains?: string; +} + +export interface StepCloseTab extends StepBase { + type: 'closeTab'; + tabIds?: number[]; + url?: string; +} + +export interface StepNavigate extends StepBase { + type: 'navigate'; + url: string; +} + +export interface StepHandleDownload extends StepBase { + type: 'handleDownload'; + filenameContains?: string; + saveAs?: string; + waitForComplete?: boolean; +} + +export interface StepExecuteFlow extends StepBase { + type: 'executeFlow'; + flowId: string; + inline?: boolean; + args?: Record; +} + +// ============================================================================= +// Step Union Type +// ============================================================================= + +export type Step = + | StepClick + | StepFill + | StepTriggerEvent + | StepSetAttribute + | StepScreenshot + | StepSwitchFrame + | StepLoopElements + | StepKey + | StepScroll + | StepDrag + | StepWait + | StepAssert + | StepScript + | StepIf + | StepForeach + | StepWhile + | StepNavigate + | StepHttp + | StepExtract + | StepOpenTab + | StepSwitchTab + | StepCloseTab + | StepHandleDownload + | StepExecuteFlow; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/assert.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/assert.ts new file mode 100644 index 00000000..3a23bbdb --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/assert.ts @@ -0,0 +1,91 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepAssert } from '../types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const assertNode: NodeRuntime = { + validate: (step) => { + const s = step as any; + const ok = !!s.assert; + if (ok && s.assert && 'attribute' in s.assert) { + const a = s.assert.attribute || {}; + if (!a.selector || !a.name) + return { ok: false, errors: ['assert.attribute: 需提供 selector 与 name'] }; + } + return ok ? { ok } : { ok, errors: ['缺少断言条件'] }; + }, + run: async (ctx: ExecCtx, step: StepAssert) => { + const s = expandTemplatesDeep(step as StepAssert, ctx.vars) as any; + const failStrategy = (s as any).failStrategy || 'stop'; + const fail = (msg: string) => { + if (failStrategy === 'warn') { + ctx.logger({ stepId: (step as any).id, status: 'warning', message: msg }); + return { alreadyLogged: true } as any; + } + throw new Error(msg); + }; + if ('textPresent' in s.assert) { + const text = (s.assert as any).textPresent; + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: { action: 'wait', text, appear: true, timeout: (step as any).timeoutMs || 5000 }, + }); + if ((res as any).isError) return fail('assert text failed'); + } else if ('exists' in s.assert || 'visible' in s.assert) { + const selector = (s.assert as any).exists || (s.assert as any).visible; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const firstTab = tabs && tabs[0]; + const tabId = firstTab && typeof firstTab.id === 'number' ? firstTab.id : undefined; + if (!tabId) return fail('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const ensured: any = (await chrome.tabs.sendMessage( + tabId, + { + action: 'ensureRefForSelector', + selector, + } as any, + { frameId: ctx.frameId } as any, + )) as any; + if (!ensured || !ensured.success) return fail('assert selector not found'); + if ('visible' in s.assert) { + const rect = ensured && ensured.center ? ensured.center : null; + if (!rect) return fail('assert visible failed'); + } + } else if ('attribute' in s.assert) { + const { selector, name, equals, matches } = (s.assert as any).attribute || {}; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const firstTab = tabs && tabs[0]; + const tabId = firstTab && typeof firstTab.id === 'number' ? firstTab.id : undefined; + if (!tabId) return fail('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const resp: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'getAttributeForSelector', selector, name } as any, + { frameId: ctx.frameId } as any, + )) as any; + if (!resp || !resp.success) return fail('assert attribute: element not found'); + const actual: string | null = resp.value ?? null; + if (equals !== undefined && equals !== null) { + const expected = String(equals); + if (String(actual) !== String(expected)) + return fail( + `assert attribute equals failed: ${name} actual=${String(actual)} expected=${String(expected)}`, + ); + } else if (matches !== undefined && matches !== null) { + try { + const re = new RegExp(String(matches)); + if (!re.test(String(actual))) + return fail( + `assert attribute matches failed: ${name} actual=${String(actual)} regex=${String(matches)}`, + ); + } catch { + return fail(`invalid regex for attribute matches: ${String(matches)}`); + } + } else { + if (actual == null) return fail(`assert attribute failed: ${name} missing`); + } + } + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/click.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/click.ts new file mode 100644 index 00000000..6a4757d9 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/click.ts @@ -0,0 +1,108 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { Step } from '../types'; +import { locateElement } from '../selector-engine'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const clickNode: NodeRuntime = { + validate: (step) => { + const ok = !!(step as any).target?.candidates?.length; + return ok ? { ok } : { ok, errors: ['缺少目标选择器候选'] }; + }, + run: async (ctx: ExecCtx, step: Step) => { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const firstTab = tabs && tabs[0]; + const tabId = firstTab && typeof firstTab.id === 'number' ? firstTab.id : undefined; + if (!tabId) throw new Error('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const located = await locateElement(tabId, s.target, ctx.frameId); + const frameId = (located as any)?.frameId ?? ctx.frameId; + const first = s.target?.candidates?.[0]?.type; + const resolvedBy = (located as any)?.resolvedBy || ((located as any)?.ref ? 'ref' : ''); + const fallbackUsed = resolvedBy && first && resolvedBy !== 'ref' && resolvedBy !== first; + if ((located as any)?.ref) { + const resolved: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'resolveRef', ref: (located as any).ref } as any, + { frameId } as any, + )) as any; + const rect = resolved?.rect; + if (!rect || rect.width <= 0 || rect.height <= 0) throw new Error('element not visible'); + } + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.CLICK, + args: { + ref: (located as any)?.ref || (step as any).target?.ref, + selector: !(located as any)?.ref + ? s.target?.candidates?.find((c: any) => c.type === 'css' || c.type === 'attr')?.value + : undefined, + waitForNavigation: false, + timeout: Math.max(1000, Math.min(s.timeoutMs || 10000, 30000)), + frameId, + }, + }); + if ((res as any).isError) throw new Error('click failed'); + if (fallbackUsed) + ctx.logger({ + stepId: step.id, + status: 'success', + message: `Selector fallback used (${String(first)} -> ${String(resolvedBy)})`, + fallbackUsed: true, + fallbackFrom: String(first), + fallbackTo: String(resolvedBy), + } as any); + return {} as ExecResult; + }, +}; + +export const dblclickNode: NodeRuntime = { + validate: clickNode.validate, + run: async (ctx: ExecCtx, step: Step) => { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const firstTab = tabs && tabs[0]; + const tabId = firstTab && typeof firstTab.id === 'number' ? firstTab.id : undefined; + if (!tabId) throw new Error('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const located = await locateElement(tabId, s.target, ctx.frameId); + const frameId = (located as any)?.frameId ?? ctx.frameId; + const first = s.target?.candidates?.[0]?.type; + const resolvedBy = (located as any)?.resolvedBy || ((located as any)?.ref ? 'ref' : ''); + const fallbackUsed = resolvedBy && first && resolvedBy !== 'ref' && resolvedBy !== first; + if ((located as any)?.ref) { + const resolved: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'resolveRef', ref: (located as any).ref } as any, + { frameId } as any, + )) as any; + const rect = resolved?.rect; + if (!rect || rect.width <= 0 || rect.height <= 0) throw new Error('element not visible'); + } + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.CLICK, + args: { + ref: (located as any)?.ref || (step as any).target?.ref, + selector: !(located as any)?.ref + ? s.target?.candidates?.find((c: any) => c.type === 'css' || c.type === 'attr')?.value + : undefined, + waitForNavigation: false, + timeout: Math.max(1000, Math.min(s.timeoutMs || 10000, 30000)), + frameId, + double: true, + }, + }); + if ((res as any).isError) throw new Error('dblclick failed'); + if (fallbackUsed) + ctx.logger({ + stepId: step.id, + status: 'success', + message: `Selector fallback used (${String(first)} -> ${String(resolvedBy)})`, + fallbackUsed: true, + fallbackFrom: String(first), + fallbackTo: String(resolvedBy), + } as any); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/conditional.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/conditional.ts new file mode 100644 index 00000000..7d08013a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/conditional.ts @@ -0,0 +1,55 @@ +import type { Step } from '../types'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const ifNode: NodeRuntime = { + validate: (step) => { + const s = step as any; + const hasBranches = Array.isArray(s.branches) && s.branches.length > 0; + const ok = hasBranches || !!s.condition; + return ok ? { ok } : { ok, errors: ['缺少条件或分支'] }; + }, + run: async (ctx: ExecCtx, step: Step) => { + const s: any = step; + if (Array.isArray(s.branches) && s.branches.length > 0) { + const evalExpr = (expr: string): boolean => { + const code = String(expr || '').trim(); + if (!code) return false; + try { + const fn = new Function( + 'vars', + 'workflow', + `try { return !!(${code}); } catch (e) { return false; }`, + ); + return !!fn(ctx.vars, ctx.vars); + } catch { + return false; + } + }; + for (const br of s.branches) { + if (br?.expr && evalExpr(String(br.expr))) + return { nextLabel: String(br.label || `case:${br.id || 'match'}`) } as ExecResult; + } + if ('else' in s) return { nextLabel: String(s.else || 'default') } as ExecResult; + return { nextLabel: 'default' } as ExecResult; + } + // legacy condition: { var/equals | expression } + try { + let result = false; + const cond = s.condition; + if (cond && typeof cond.expression === 'string' && cond.expression.trim()) { + const fn = new Function( + 'vars', + `try { return !!(${cond.expression}); } catch (e) { return false; }`, + ); + result = !!fn(ctx.vars); + } else if (cond && typeof cond.var === 'string') { + const v = ctx.vars[cond.var]; + if ('equals' in cond) result = String(v) === String(cond.equals); + else result = !!v; + } + return { nextLabel: result ? 'true' : 'false' } as ExecResult; + } catch { + return { nextLabel: 'false' } as ExecResult; + } + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/download-screenshot-attr-event-frame-loop.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/download-screenshot-attr-event-frame-loop.ts new file mode 100644 index 00000000..66dd37d6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/download-screenshot-attr-event-frame-loop.ts @@ -0,0 +1,252 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { Step } from '../types'; +import { locateElement } from '../selector-engine'; + +export const handleDownloadNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const args: any = { + filenameContains: s.filenameContains || undefined, + timeoutMs: Math.max(1000, Math.min(Number(s.timeoutMs ?? 60000), 300000)), + waitForComplete: s.waitForComplete !== false, + }; + const res = await handleCallTool({ name: TOOL_NAMES.BROWSER.HANDLE_DOWNLOAD, args }); + const text = (res as any)?.content?.find((c: any) => c.type === 'text')?.text; + try { + const payload = text ? JSON.parse(text) : null; + if (s.saveAs && payload && payload.download) ctx.vars[s.saveAs] = payload.download; + } catch {} + return {} as ExecResult; + }, +}; + +export const screenshotNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const args: any = { name: 'workflow', storeBase64: true }; + if (s.fullPage) args.fullPage = true; + if (s.selector && typeof s.selector === 'string' && s.selector.trim()) + args.selector = s.selector; + const res = await handleCallTool({ name: TOOL_NAMES.BROWSER.SCREENSHOT, args }); + const text = (res as any)?.content?.find((c: any) => c.type === 'text')?.text; + try { + const payload = text ? JSON.parse(text) : null; + if (s.saveAs && payload && payload.base64Data) ctx.vars[s.saveAs] = payload.base64Data; + } catch {} + return {} as ExecResult; + }, +}; + +export const triggerEventNode: NodeRuntime = { + validate: (step) => { + const s: any = step; + const ok = !!s?.target?.candidates?.length && typeof s?.event === 'string' && s.event; + return ok ? { ok } : { ok, errors: ['缺少目标选择器或事件类型'] }; + }, + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const located = await locateElement(tabId, s.target, ctx.frameId); + const cssSelector = !(located as any)?.ref + ? s.target.candidates?.find((c: any) => c.type === 'css' || c.type === 'attr')?.value + : undefined; + let sel = cssSelector as string | undefined; + if (!sel && (located as any)?.ref) { + try { + const resolved: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'resolveRef', ref: (located as any).ref } as any, + { frameId: ctx.frameId } as any, + )) as any; + sel = resolved?.selector; + } catch {} + } + if (!sel) throw new Error('triggerEvent: selector not resolved'); + const world: any = 'MAIN'; + const ev = String(s.event || '').trim(); + const bubbles = s.bubbles !== false; + const cancelable = s.cancelable === true; + await chrome.scripting.executeScript({ + target: { + tabId, + frameIds: typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined, + } as any, + world, + func: (selector: string, type: string, bubbles: boolean, cancelable: boolean) => { + try { + const el = document.querySelector(selector); + if (!el) return false; + const e = new Event(type, { bubbles, cancelable }); + (el as any).dispatchEvent(e); + return true; + } catch (e) { + return false; + } + }, + args: [sel, ev, !!bubbles, !!cancelable], + } as any); + return {} as ExecResult; + }, +}; + +export const setAttributeNode: NodeRuntime = { + validate: (step) => { + const s: any = step; + const ok = !!s?.target?.candidates?.length && typeof s?.name === 'string' && s.name; + return ok ? { ok } : { ok, errors: ['需提供目标选择器与属性名'] }; + }, + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const located = await locateElement(tabId, s.target, ctx.frameId); + const frameId = (located as any)?.frameId ?? ctx.frameId; + const cssSelector = !(located as any)?.ref + ? s.target.candidates?.find((c: any) => c.type === 'css' || c.type === 'attr')?.value + : undefined; + let sel = cssSelector as string | undefined; + if (!sel && (located as any)?.ref) { + try { + const resolved: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'resolveRef', ref: (located as any).ref } as any, + { frameId } as any, + )) as any; + sel = resolved?.selector; + } catch {} + } + if (!sel) throw new Error('setAttribute: selector not resolved'); + const world: any = 'MAIN'; + const name = String(s.name || ''); + const value = s.value; + const remove = s.remove === true; + await chrome.scripting.executeScript({ + target: { tabId, frameIds: typeof frameId === 'number' ? [frameId] : undefined } as any, + world, + func: (selector: string, name: string, value: any, remove: boolean) => { + try { + const el = document.querySelector(selector) as any; + if (!el) return false; + if (remove) el.removeAttribute(name); + else el.setAttribute(name, String(value ?? '')); + return true; + } catch { + return false; + } + }, + args: [sel, name, value, remove], + } as any); + return {} as ExecResult; + }, +}; + +export const switchFrameNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = step; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const frames = await chrome.webNavigation.getAllFrames({ tabId }); + if (!Array.isArray(frames) || frames.length === 0) { + ctx.frameId = undefined; + return {} as ExecResult; + } + let target: any | undefined; + const idx = Number(s?.frame?.index ?? NaN); + if (Number.isFinite(idx)) { + const list = frames.filter((f) => f.frameId !== 0); + target = list[Math.max(0, Math.min(list.length - 1, idx))]; + } + const urlContains = String(s?.frame?.urlContains || '').trim(); + if (!target && urlContains) + target = frames.find((f) => typeof f.url === 'string' && f.url.includes(urlContains)); + if (!target) ctx.frameId = undefined; + else ctx.frameId = target.frameId; + try { + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + } catch {} + ctx.logger({ + stepId: (step as any).id, + status: 'success', + message: `frameId=${String(ctx.frameId ?? 'top')}`, + } as any); + return {} as ExecResult; + }, +}; + +export const loopElementsNode: NodeRuntime = { + validate: (step) => { + const s: any = step; + const ok = + typeof s?.selector === 'string' && + s.selector && + typeof s?.subflowId === 'string' && + s.subflowId; + return ok ? { ok } : { ok, errors: ['需提供 selector 与 subflowId'] }; + }, + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const world: any = 'MAIN'; + const selector = String(s.selector || ''); + const res = await chrome.scripting.executeScript({ + target: { + tabId, + frameIds: typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined, + } as any, + world, + func: (sel: string) => { + try { + const list = Array.from(document.querySelectorAll(sel)); + const toCss = (node: Element) => { + try { + if ((node as HTMLElement).id) { + const idSel = `#${CSS.escape((node as HTMLElement).id)}`; + if (document.querySelectorAll(idSel).length === 1) return idSel; + } + } catch {} + let path = ''; + let current: Element | null = node; + while (current && current.tagName !== 'BODY') { + let part = current.tagName.toLowerCase(); + const parentEl: Element | null = current.parentElement; + if (parentEl) { + const siblings = Array.from(parentEl.children).filter( + (c) => (c as any).tagName === current!.tagName, + ); + if (siblings.length > 1) { + const idx = siblings.indexOf(current) + 1; + part += `:nth-of-type(${idx})`; + } + } + path = path ? `${part} > ${path}` : part; + current = parentEl; + } + return path ? `body > ${path}` : 'body'; + }; + return list.map(toCss); + } catch (e) { + return []; + } + }, + args: [selector], + } as any); + const arr: string[] = (res && Array.isArray(res[0]?.result) ? res[0].result : []) as any; + const listVar = String(s.saveAs || 'elements'); + const itemVar = String(s.itemVar || 'item'); + ctx.vars[listVar] = arr; + return { + control: { kind: 'foreach', listVar, itemVar, subflowId: String(s.subflowId) }, + } as any; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/drag.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/drag.ts new file mode 100644 index 00000000..6d35c502 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/drag.ts @@ -0,0 +1,42 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepDrag } from '../types'; +import { locateElement } from '../selector-engine'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const dragNode: NodeRuntime = { + run: async (_ctx, step: StepDrag) => { + const s = step as StepDrag; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + let startRef: string | undefined; + let endRef: string | undefined; + try { + if (typeof tabId === 'number') { + const locatedStart = await locateElement(tabId, (s as any).start); + const locatedEnd = await locateElement(tabId, (s as any).end); + startRef = (locatedStart as any)?.ref || (s as any).start.ref; + endRef = (locatedEnd as any)?.ref || (s as any).end.ref; + } + } catch {} + let startCoordinates: { x: number; y: number } | undefined; + let endCoordinates: { x: number; y: number } | undefined; + if ((!startRef || !endRef) && Array.isArray((s as any).path) && (s as any).path.length >= 2) { + startCoordinates = { x: Number((s as any).path[0].x), y: Number((s as any).path[0].y) }; + const last = (s as any).path[(s as any).path.length - 1]; + endCoordinates = { x: Number(last.x), y: Number(last.y) }; + } + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: { + action: 'left_click_drag', + startRef, + ref: endRef, + startCoordinates, + coordinates: endCoordinates, + }, + }); + if ((res as any).isError) throw new Error('drag failed'); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/execute-flow.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/execute-flow.ts new file mode 100644 index 00000000..65510f8a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/execute-flow.ts @@ -0,0 +1,92 @@ +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const executeFlowNode: NodeRuntime = { + validate: (step) => { + const s: any = step; + const ok = typeof s.flowId === 'string' && !!s.flowId; + return ok ? { ok } : { ok, errors: ['需提供 flowId'] }; + }, + run: async (ctx: ExecCtx, step) => { + const s: any = step; + const { getFlow } = await import('../flow-store'); + const flow = await getFlow(String(s.flowId)); + if (!flow) throw new Error('referenced flow not found'); + const inline = s.inline !== false; // default inline + if (!inline) { + const { runFlow } = await import('../flow-runner'); + await runFlow(flow, { args: s.args || {}, returnLogs: false }); + return {} as ExecResult; + } + const { defaultEdgesOnly, topoOrder, mapDagNodeToStep, waitForNetworkIdle, waitForNavigation } = + await import('../rr-utils'); + const vars = ctx.vars; + if (s.args && typeof s.args === 'object') Object.assign(vars, s.args); + + // DAG is required - flow-store guarantees nodes/edges via normalization + const nodes = ((flow as any).nodes || []) as any[]; + const edges = ((flow as any).edges || []) as any[]; + if (nodes.length === 0) { + throw new Error( + 'Flow has no DAG nodes. Linear steps are no longer supported. Please migrate this flow to nodes/edges.', + ); + } + const defaultEdges = defaultEdgesOnly(edges as any); + const order = topoOrder(nodes as any, defaultEdges as any); + const stepsToRun: any[] = order.map((n) => mapDagNodeToStep(n as any)); + for (const st of stepsToRun) { + const t0 = Date.now(); + const maxRetries = Math.max(0, (st as any).retry?.count ?? 0); + const baseInterval = Math.max(0, (st as any).retry?.intervalMs ?? 0); + let attempt = 0; + const doDelay = async (i: number) => { + const delay = + baseInterval > 0 + ? (st as any).retry?.backoff === 'exp' + ? baseInterval * Math.pow(2, i) + : baseInterval + : 0; + if (delay > 0) await new Promise((r) => setTimeout(r, delay)); + }; + while (true) { + try { + const beforeInfo = await (async () => { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tab = tabs[0]; + return { url: tab?.url || '', status: (tab as any)?.status || '' }; + })(); + const { executeStep } = await import('../nodes'); + const result = await executeStep(ctx as any, st as any); + if ((st.type === 'click' || st.type === 'dblclick') && (st as any).after) { + const after = (st as any).after as any; + if (after.waitForNavigation) + await waitForNavigation((st as any).timeoutMs, beforeInfo.url); + else if (after.waitForNetworkIdle) + await waitForNetworkIdle(Math.min((st as any).timeoutMs || 5000, 120000), 1200); + } + if (!result?.alreadyLogged) + ctx.logger({ stepId: st.id, status: 'success', tookMs: Date.now() - t0 } as any); + break; + } catch (e: any) { + if (attempt < maxRetries) { + ctx.logger({ + stepId: st.id, + status: 'retrying', + message: e?.message || String(e), + } as any); + await doDelay(attempt); + attempt += 1; + continue; + } + ctx.logger({ + stepId: st.id, + status: 'failed', + message: e?.message || String(e), + tookMs: Date.now() - t0, + } as any); + throw e; + } + } + } + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/extract.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/extract.ts new file mode 100644 index 00000000..b2775425 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/extract.ts @@ -0,0 +1,47 @@ +import type { StepExtract } from '../types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const extractNode: NodeRuntime = { + run: async (ctx: ExecCtx, step: StepExtract) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + let value: any = null; + if (s.js && String(s.js).trim()) { + const [{ result }] = await chrome.scripting.executeScript({ + target: { tabId }, + func: (code: string) => { + try { + return (0, eval)(code); + } catch (e) { + return null; + } + }, + args: [String(s.js)], + } as any); + value = result; + } else if (s.selector) { + const attr = String(s.attr || 'text'); + const sel = String(s.selector); + const [{ result }] = await chrome.scripting.executeScript({ + target: { tabId }, + func: (selector: string, attr: string) => { + try { + const el = document.querySelector(selector) as any; + if (!el) return null; + if (attr === 'text' || attr === 'textContent') return (el.textContent || '').trim(); + return el.getAttribute ? el.getAttribute(attr) : null; + } catch { + return null; + } + }, + args: [sel, attr], + } as any); + value = result; + } + if (s.saveAs) ctx.vars[s.saveAs] = value; + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/fill.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/fill.ts new file mode 100644 index 00000000..843b88b5 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/fill.ts @@ -0,0 +1,116 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepFill } from '../types'; +import { locateElement } from '../selector-engine'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const fillNode: NodeRuntime = { + validate: (step) => { + const ok = !!(step as any).target?.candidates?.length && 'value' in (step as any); + return ok ? { ok } : { ok, errors: ['缺少目标选择器候选或输入值'] }; + }, + run: async (ctx: ExecCtx, step: StepFill) => { + const s: any = step; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const firstTab = tabs && tabs[0]; + const tabId = firstTab && typeof firstTab.id === 'number' ? firstTab.id : undefined; + if (!tabId) throw new Error('Active tab not found'); + await handleCallTool({ name: TOOL_NAMES.BROWSER.READ_PAGE, args: {} }); + const located = await locateElement(tabId, s.target, ctx.frameId); + const frameId = (located as any)?.frameId ?? ctx.frameId; + const first = s.target?.candidates?.[0]?.type; + const resolvedBy = (located as any)?.resolvedBy || ((located as any)?.ref ? 'ref' : ''); + const fallbackUsed = resolvedBy && first && resolvedBy !== 'ref' && resolvedBy !== first; + const interpolate = (v: any) => + typeof v === 'string' + ? v.replace(/\{([^}]+)\}/g, (_m, k) => (ctx.vars[k] ?? '').toString()) + : v; + const value = interpolate(s.value); + if ((located as any)?.ref) { + const resolved: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'resolveRef', ref: (located as any).ref } as any, + { frameId } as any, + )) as any; + const rect = resolved?.rect; + if (!rect || rect.width <= 0 || rect.height <= 0) throw new Error('element not visible'); + } + const cssSelector = !(located as any)?.ref + ? s.target.candidates?.find((c: any) => c.type === 'css' || c.type === 'attr')?.value + : undefined; + if (cssSelector) { + try { + const attr: any = (await chrome.tabs.sendMessage( + tabId, + { action: 'getAttributeForSelector', selector: cssSelector, name: 'type' } as any, + { frameId } as any, + )) as any; + const typeName = (attr && attr.value ? String(attr.value) : '').toLowerCase(); + if (typeName === 'file') { + const uploadRes = await handleCallTool({ + name: TOOL_NAMES.BROWSER.FILE_UPLOAD, + args: { selector: cssSelector, filePath: String(value ?? '') }, + }); + if ((uploadRes as any).isError) throw new Error('file upload failed'); + if (fallbackUsed) + ctx.logger({ + stepId: (step as any).id, + status: 'success', + message: `Selector fallback used (${String(first)} -> ${String(resolvedBy)})`, + fallbackUsed: true, + fallbackFrom: String(first), + fallbackTo: String(resolvedBy), + } as any); + return {} as ExecResult; + } + } catch {} + } + try { + if (cssSelector) + await handleCallTool({ + name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + args: { + type: 'MAIN', + jsScript: `try{var el=document.querySelector(${JSON.stringify(cssSelector)});if(el){el.scrollIntoView({behavior:'instant',block:'center',inline:'nearest'});} }catch(e){}`, + }, + }); + } catch {} + try { + if ((located as any)?.ref) + await chrome.tabs.sendMessage( + tabId, + { action: 'focusByRef', ref: (located as any).ref } as any, + { frameId } as any, + ); + else if (cssSelector) + await handleCallTool({ + name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + args: { + type: 'MAIN', + jsScript: `try{var el=document.querySelector(${JSON.stringify(cssSelector)});if(el&&el.focus){el.focus();}}catch(e){}`, + }, + }); + } catch {} + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.FILL, + args: { + ref: (located as any)?.ref || (s as any).target?.ref, + selector: cssSelector, + value, + frameId, + }, + }); + if ((res as any).isError) throw new Error('fill failed'); + if (fallbackUsed) + ctx.logger({ + stepId: (step as any).id, + status: 'success', + message: `Selector fallback used (${String(first)} -> ${String(resolvedBy)})`, + fallbackUsed: true, + fallbackFrom: String(first), + fallbackTo: String(resolvedBy), + } as any); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/http.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/http.ts new file mode 100644 index 00000000..3a6b1bf8 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/http.ts @@ -0,0 +1,28 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepHttp } from '../types'; +import { applyAssign, expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const httpNode: NodeRuntime = { + run: async (ctx: ExecCtx, step: StepHttp) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NETWORK_REQUEST, + args: { + url: s.url, + method: s.method || 'GET', + headers: s.headers || {}, + body: s.body, + formData: s.formData, + }, + }); + const text = (res as any)?.content?.find((c: any) => c.type === 'text')?.text; + try { + const payload = text ? JSON.parse(text) : null; + if (s.saveAs && payload !== undefined) ctx.vars[s.saveAs] = payload; + if (s.assign && payload !== undefined) applyAssign(ctx.vars, payload, s.assign); + } catch {} + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/index.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/index.ts new file mode 100644 index 00000000..882de36a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/index.ts @@ -0,0 +1,65 @@ +import type { Step } from '../types'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; +import { clickNode, dblclickNode } from './click'; +import { fillNode } from './fill'; +import { httpNode } from './http'; +import { extractNode } from './extract'; +import { scriptNode } from './script'; +import { openTabNode, switchTabNode, closeTabNode } from './tabs'; +import { scrollNode } from './scroll'; +import { dragNode } from './drag'; +import { keyNode } from './key'; +import { waitNode } from './wait'; +import { assertNode } from './assert'; +import { navigateNode } from './navigate'; +import { ifNode } from './conditional'; +import { STEP_TYPES } from 'chrome-mcp-shared'; +import { foreachNode, whileNode } from './loops'; +import { executeFlowNode } from './execute-flow'; +import { + handleDownloadNode, + screenshotNode, + triggerEventNode, + setAttributeNode, + switchFrameNode, + loopElementsNode, +} from './download-screenshot-attr-event-frame-loop'; + +const registry = new Map>([ + [STEP_TYPES.CLICK, clickNode], + [STEP_TYPES.DBLCLICK, dblclickNode], + [STEP_TYPES.FILL, fillNode], + [STEP_TYPES.HTTP, httpNode], + [STEP_TYPES.EXTRACT, extractNode], + [STEP_TYPES.SCRIPT, scriptNode], + [STEP_TYPES.OPEN_TAB, openTabNode], + [STEP_TYPES.SWITCH_TAB, switchTabNode], + [STEP_TYPES.CLOSE_TAB, closeTabNode], + [STEP_TYPES.SCROLL, scrollNode], + [STEP_TYPES.DRAG, dragNode], + [STEP_TYPES.KEY, keyNode], + [STEP_TYPES.WAIT, waitNode], + [STEP_TYPES.ASSERT, assertNode], + [STEP_TYPES.NAVIGATE, navigateNode], + [STEP_TYPES.IF, ifNode], + [STEP_TYPES.FOREACH, foreachNode], + [STEP_TYPES.WHILE, whileNode], + [STEP_TYPES.EXECUTE_FLOW, executeFlowNode], + [STEP_TYPES.HANDLE_DOWNLOAD, handleDownloadNode], + [STEP_TYPES.SCREENSHOT, screenshotNode], + [STEP_TYPES.TRIGGER_EVENT, triggerEventNode], + [STEP_TYPES.SET_ATTRIBUTE, setAttributeNode], + [STEP_TYPES.SWITCH_FRAME, switchFrameNode], + [STEP_TYPES.LOOP_ELEMENTS, loopElementsNode], +]); + +export async function executeStep(ctx: ExecCtx, step: Step): Promise { + const rt = registry.get(step.type); + if (!rt) throw new Error(`unsupported step type: ${String(step.type)}`); + const v = rt.validate ? rt.validate(step) : { ok: true }; + if (!v.ok) throw new Error((v.errors || []).join(', ') || 'validation failed'); + const out = await rt.run(ctx, step); + return out || {}; +} + +export type { ExecCtx, ExecResult, NodeRuntime } from './types'; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/key.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/key.ts new file mode 100644 index 00000000..adb31b40 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/key.ts @@ -0,0 +1,31 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepKey } from '../types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const keyNode: NodeRuntime = { + run: async (ctx, step: StepKey) => { + const s = expandTemplatesDeep(step as StepKey, ctx.vars) as StepKey; + const args: { keys: string; frameId?: number; selector?: string } = { keys: s.keys }; + + // Support target selector for focusing before key input + if (s.target && s.target.candidates?.length) { + const selector = s.target.candidates[0]?.value; + if (selector) { + args.selector = selector; + } + } + + if (typeof ctx.frameId === 'number') { + args.frameId = ctx.frameId; + } + + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.KEYBOARD, + args, + }); + if ((res as any).isError) throw new Error('key failed'); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/loops.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/loops.ts new file mode 100644 index 00000000..2cf37404 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/loops.ts @@ -0,0 +1,47 @@ +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; +import { ENGINE_CONSTANTS } from '../engine/constants'; + +export const foreachNode: NodeRuntime = { + validate: (step) => { + const s = step as any; + const ok = + typeof s.listVar === 'string' && s.listVar && typeof s.subflowId === 'string' && s.subflowId; + return ok ? { ok } : { ok, errors: ['foreach: 需提供 listVar 与 subflowId'] }; + }, + run: async (_ctx: ExecCtx, step) => { + const s: any = step; + const itemVar = typeof s.itemVar === 'string' && s.itemVar ? s.itemVar : 'item'; + return { + control: { + kind: 'foreach', + listVar: String(s.listVar), + itemVar, + subflowId: String(s.subflowId), + concurrency: Math.max( + 1, + Math.min(ENGINE_CONSTANTS.MAX_FOREACH_CONCURRENCY, Number(s.concurrency ?? 1)), + ), + }, + } as ExecResult; + }, +}; + +export const whileNode: NodeRuntime = { + validate: (step) => { + const s = step as any; + const ok = !!s.condition && typeof s.subflowId === 'string' && s.subflowId; + return ok ? { ok } : { ok, errors: ['while: 需提供 condition 与 subflowId'] }; + }, + run: async (_ctx: ExecCtx, step) => { + const s: any = step; + const max = Math.max(1, Math.min(10000, Number(s.maxIterations ?? 100))); + return { + control: { + kind: 'while', + condition: s.condition, + subflowId: String(s.subflowId), + maxIterations: max, + }, + } as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/navigate.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/navigate.ts new file mode 100644 index 00000000..dc6e182d --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/navigate.ts @@ -0,0 +1,17 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { Step } from '../types'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const navigateNode: NodeRuntime = { + validate: (step) => { + const ok = !!(step as any).url; + return ok ? { ok } : { ok, errors: ['缺少 URL'] }; + }, + run: async (_ctx: ExecCtx, step: Step) => { + const url = (step as any).url; + const res = await handleCallTool({ name: TOOL_NAMES.BROWSER.NAVIGATE, args: { url } }); + if ((res as any).isError) throw new Error('navigate failed'); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/script.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/script.ts new file mode 100644 index 00000000..a9f33c5c --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/script.ts @@ -0,0 +1,32 @@ +import type { StepScript } from '../types'; +import { expandTemplatesDeep, applyAssign } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const scriptNode: NodeRuntime = { + run: async (ctx: ExecCtx, step: StepScript) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + if (s.when === 'after') return { deferAfterScript: s } as ExecResult; + const world = s.world || 'ISOLATED'; + const code = String(s.code || ''); + if (!code.trim()) return {} as ExecResult; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const frameIds = typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined; + const [{ result }] = await chrome.scripting.executeScript({ + target: { tabId, frameIds } as any, + func: (userCode: string) => { + try { + return (0, eval)(userCode); + } catch { + return null; + } + }, + args: [code], + world: world as any, + } as any); + if (s.saveAs) ctx.vars[s.saveAs] = result; + if (s.assign && typeof s.assign === 'object') applyAssign(ctx.vars, result, s.assign); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/scroll.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/scroll.ts new file mode 100644 index 00000000..26a0a569 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/scroll.ts @@ -0,0 +1,45 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepScroll } from '../types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const scrollNode: NodeRuntime = { + run: async (ctx, step: StepScroll) => { + const s = expandTemplatesDeep(step as StepScroll, ctx.vars); + const top = s.offset?.y ?? undefined; + const left = s.offset?.x ?? undefined; + const selectorFromTarget = (s as any).target?.candidates?.find( + (c: any) => c.type === 'css' || c.type === 'attr', + )?.value; + let code = ''; + if (s.mode === 'offset' && !(s as any).target) { + const t = top != null ? Number(top) : 'undefined'; + const l = left != null ? Number(left) : 'undefined'; + code = `try { window.scrollTo({ top: ${t}, left: ${l}, behavior: 'instant' }); } catch (e) {}`; + } else if (s.mode === 'element' && selectorFromTarget) { + code = `(() => { try { const el = document.querySelector(${JSON.stringify(selectorFromTarget)}); if (el) el.scrollIntoView({ behavior: 'instant', block: 'center', inline: 'nearest' }); } catch (e) {} })();`; + } else if (s.mode === 'container' && selectorFromTarget) { + const t = top != null ? Number(top) : 'undefined'; + const l = left != null ? Number(left) : 'undefined'; + code = `(() => { try { const el = document.querySelector(${JSON.stringify(selectorFromTarget)}); if (el && typeof el.scrollTo === 'function') el.scrollTo({ top: ${t}, left: ${l}, behavior: 'instant' }); } catch (e) {} })();`; + } else { + const direction = top != null && Number(top) < 0 ? 'up' : 'down'; + const amount = 3; + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: { action: 'scroll', scrollDirection: direction, scrollAmount: amount }, + }); + if ((res as any).isError) throw new Error('scroll failed'); + return {} as ExecResult; + } + if (code) { + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + args: { type: 'MAIN', jsScript: code }, + }); + if ((res as any).isError) throw new Error('scroll failed'); + } + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/tabs.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/tabs.ts new file mode 100644 index 00000000..0523f238 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/tabs.ts @@ -0,0 +1,49 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { handleCallTool } from '@/entrypoints/background/tools'; +import type { StepOpenTab, StepSwitchTab, StepCloseTab } from '../types'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const openTabNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + if (s.newWindow) await chrome.windows.create({ url: s.url || undefined, focused: true }); + else await chrome.tabs.create({ url: s.url || undefined, active: true }); + return {} as ExecResult; + }, +}; + +export const switchTabNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + let targetTabId: number | undefined = s.tabId; + if (!targetTabId) { + const tabs = await chrome.tabs.query({}); + const hit = tabs.find( + (t) => + (s.urlContains && (t.url || '').includes(String(s.urlContains))) || + (s.titleContains && (t.title || '').includes(String(s.titleContains))), + ); + targetTabId = (hit && hit.id) as number | undefined; + } + if (!targetTabId) throw new Error('switchTab: no matching tab'); + const res = await handleCallTool({ + name: TOOL_NAMES.BROWSER.SWITCH_TAB, + args: { tabId: targetTabId }, + }); + if ((res as any).isError) throw new Error('switchTab failed'); + return {} as ExecResult; + }, +}; + +export const closeTabNode: NodeRuntime = { + run: async (ctx, step) => { + const s: any = expandTemplatesDeep(step as any, ctx.vars); + const args: any = {}; + if (Array.isArray(s.tabIds) && s.tabIds.length) args.tabIds = s.tabIds; + if (s.url) args.url = s.url; + const res = await handleCallTool({ name: TOOL_NAMES.BROWSER.CLOSE_TABS, args }); + if ((res as any).isError) throw new Error('closeTab failed'); + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/types.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/types.ts new file mode 100644 index 00000000..315888ea --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/types.ts @@ -0,0 +1,36 @@ +import type { RunLogEntry, Step, StepScript } from '../types'; + +/** + * Execution context for step execution. + * Contains runtime state that may change during flow execution. + */ +export interface ExecCtx { + /** Runtime variables accessible to steps */ + vars: Record; + /** Logger function for recording execution events */ + logger: (e: RunLogEntry) => void; + /** + * Current tab ID for this execution context. + * Managed by Scheduler, may change after openTab/switchTab actions. + */ + tabId?: number; + /** + * Current frame ID within the tab. + * Used for iframe targeting, 0 for main frame. + */ + frameId?: number; +} + +export interface ExecResult { + alreadyLogged?: boolean; + deferAfterScript?: StepScript | null; + nextLabel?: string; + control?: + | { kind: 'foreach'; listVar: string; itemVar: string; subflowId: string; concurrency?: number } + | { kind: 'while'; condition: any; subflowId: string; maxIterations: number }; +} + +export interface NodeRuntime { + validate?: (step: S) => { ok: boolean; errors?: string[] }; + run: (ctx: ExecCtx, step: S) => Promise; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/nodes/wait.ts b/app/chrome-extension/entrypoints/background/record-replay/nodes/wait.ts new file mode 100644 index 00000000..b0f13d68 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/nodes/wait.ts @@ -0,0 +1,73 @@ +import type { StepWait } from '../types'; +import { waitForNetworkIdle, waitForNavigation } from '../rr-utils'; +import { expandTemplatesDeep } from '../rr-utils'; +import type { ExecCtx, ExecResult, NodeRuntime } from './types'; + +export const waitNode: NodeRuntime = { + validate: (step) => { + const ok = !!(step as any).condition; + return ok ? { ok } : { ok, errors: ['缺少等待条件'] }; + }, + run: async (ctx: ExecCtx, step: StepWait) => { + const s = expandTemplatesDeep(step as StepWait, ctx.vars); + const cond = (s as StepWait).condition as + | { selector: string; visible?: boolean } + | { text: string; appear?: boolean } + | { navigation: true } + | { networkIdle: true } + | { sleep: number }; + if ('text' in cond) { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const frameIds = typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined; + await chrome.scripting.executeScript({ + target: { tabId, frameIds }, + files: ['inject-scripts/wait-helper.js'], + world: 'ISOLATED', + } as any); + const resp: any = (await chrome.tabs.sendMessage( + tabId, + { + action: 'waitForText', + text: cond.text, + appear: (cond as any).appear !== false, + timeout: Math.max(0, Math.min((s as any).timeoutMs || 10000, 120000)), + } as any, + { frameId: ctx.frameId } as any, + )) as any; + if (!resp || resp.success !== true) throw new Error('wait text failed'); + } else if ('networkIdle' in cond) { + const total = Math.min(Math.max(1000, (s as any).timeoutMs || 5000), 120000); + const idle = Math.min(1500, Math.max(500, Math.floor(total / 3))); + await waitForNetworkIdle(total, idle); + } else if ('navigation' in cond) { + await waitForNavigation((s as any).timeoutMs); + } else if ('sleep' in cond) { + const ms = Math.max(0, Number(cond.sleep ?? 0)); + await new Promise((r) => setTimeout(r, ms)); + } else if ('selector' in cond) { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const frameIds = typeof ctx.frameId === 'number' ? [ctx.frameId] : undefined; + await chrome.scripting.executeScript({ + target: { tabId, frameIds }, + files: ['inject-scripts/wait-helper.js'], + world: 'ISOLATED', + } as any); + const resp: any = (await chrome.tabs.sendMessage( + tabId, + { + action: 'waitForSelector', + selector: (cond as any).selector, + visible: (cond as any).visible !== false, + timeout: Math.max(0, Math.min((s as any).timeoutMs || 10000, 120000)), + } as any, + { frameId: ctx.frameId } as any, + )) as any; + if (!resp || resp.success !== true) throw new Error('wait selector failed'); + } + return {} as ExecResult; + }, +}; diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/browser-event-listener.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/browser-event-listener.ts new file mode 100644 index 00000000..af1867e6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/browser-event-listener.ts @@ -0,0 +1,77 @@ +import { addNavigationStep } from './flow-builder'; +import { STEP_TYPES } from '@/common/step-types'; +import { ensureRecorderInjected, broadcastControlToTab, REC_CMD } from './content-injection'; +import type { RecordingSessionManager } from './session-manager'; +import type { Step } from '../types'; + +export function initBrowserEventListeners(session: RecordingSessionManager): void { + chrome.tabs.onActivated.addListener(async (activeInfo) => { + try { + if (session.getStatus() !== 'recording') return; + const tabId = activeInfo.tabId; + await ensureRecorderInjected(tabId); + await broadcastControlToTab(tabId, REC_CMD.START); + // Track active tab for targeted STOP later + session.addActiveTab(tabId); + + const flow = session.getFlow(); + if (!flow) return; + const tab = await chrome.tabs.get(tabId); + const url = tab.url; + const step: Step = { + id: '', + type: STEP_TYPES.SWITCH_TAB, + ...(url ? { urlContains: url } : {}), + }; + session.appendSteps([step]); + } catch (e) { + console.warn('onActivated handler failed', e); + } + }); + + chrome.webNavigation.onCommitted.addListener(async (details) => { + try { + if (session.getStatus() !== 'recording') return; + if (details.frameId !== 0) return; + const tabId = details.tabId; + const t = details.transitionType; + const link = t === 'link'; + if (!link) { + const shouldRecord = + t === 'reload' || + t === 'typed' || + t === 'generated' || + t === 'auto_bookmark' || + t === 'keyword' || + // include form_submit to better capture Enter-to-search navigations + t === 'form_submit'; + if (shouldRecord) { + const tab = await chrome.tabs.get(tabId); + const url = tab.url || details.url; + const flow = session.getFlow(); + if (flow && url) addNavigationStep(flow, url); + } + } + await ensureRecorderInjected(tabId); + await broadcastControlToTab(tabId, REC_CMD.START); + // Track active tab for targeted STOP later + session.addActiveTab(tabId); + if (session.getFlow()) { + session.broadcastTimelineUpdate(); + } + } catch (e) { + console.warn('onCommitted handler failed', e); + } + }); + + // Remove closed tabs from the active set to avoid stale broadcasts + chrome.tabs.onRemoved.addListener((tabId) => { + try { + // Even if not recording, removing is harmless; keep guard for clarity + if (session.getStatus() !== 'recording') return; + session.removeActiveTab(tabId); + } catch (e) { + console.warn('onRemoved handler failed', e); + } + }); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/content-injection.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/content-injection.ts new file mode 100644 index 00000000..d2cedca0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/content-injection.ts @@ -0,0 +1,95 @@ +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; + +// Avoid magic strings for recorder control commands +export type RecorderCmd = 'start' | 'stop' | 'pause' | 'resume'; +export const REC_CMD = { + START: 'start', + STOP: 'stop', + PAUSE: 'pause', + RESUME: 'resume', +} as const satisfies Record; + +const RECORDER_JS_SCRIPT = 'inject-scripts/recorder.js'; + +export async function ensureRecorderInjected(tabId: number): Promise { + // Discover frames (top + subframes) + let frames: Array<{ frameId: number } & Record> = []; + try { + const res = (await chrome.webNavigation.getAllFrames({ tabId })) as + | Array<{ frameId: number } & Record> + | null + | undefined; + frames = Array.isArray(res) ? res : []; + } catch { + // ignore and fallback to top frame only + } + if (frames.length === 0) frames = [{ frameId: 0 }]; + + const needRecorder: number[] = []; + await Promise.all( + frames.map(async (f) => { + const frameId = f.frameId ?? 0; + try { + const res = await chrome.tabs.sendMessage( + tabId, + { action: 'rr_recorder_ping' }, + { frameId }, + ); + const pong = res?.status === 'pong'; + if (!pong) needRecorder.push(frameId); + } catch { + needRecorder.push(frameId); + } + }), + ); + + if (needRecorder.length > 0) { + try { + await chrome.scripting.executeScript({ + target: { tabId, frameIds: needRecorder }, + files: [RECORDER_JS_SCRIPT], + world: 'ISOLATED', + }); + } catch { + // Fallback: try allFrames to cover dynamic/subframe changes; safe due to idempotent guard in recorder.js + try { + await chrome.scripting.executeScript({ + target: { tabId, allFrames: true }, + files: [RECORDER_JS_SCRIPT], + world: 'ISOLATED', + }); + } catch { + // ignore injection failures per-tab + } + } + } +} + +export async function broadcastControlToTab( + tabId: number, + cmd: RecorderCmd, + meta?: unknown, +): Promise { + try { + const res = (await chrome.webNavigation.getAllFrames({ tabId })) as + | Array<{ frameId: number } & Record> + | null + | undefined; + const targets = Array.isArray(res) && res.length ? res : [{ frameId: 0 }]; + await Promise.all( + targets.map(async (f) => { + try { + await chrome.tabs.sendMessage( + tabId, + { action: TOOL_MESSAGE_TYPES.RR_RECORDER_CONTROL, cmd, meta }, + { frameId: f.frameId }, + ); + } catch { + // ignore per-frame send failure + } + }), + ); + } catch { + // ignore + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/content-message-handler.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/content-message-handler.ts new file mode 100644 index 00000000..4d964cda --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/content-message-handler.ts @@ -0,0 +1,78 @@ +import type { RecordingSessionManager } from './session-manager'; +import type { Step, VariableDef } from '../types'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; + +/** + * Initialize the content message handler for receiving steps and variables from content scripts. + * + * Supports the following payload kinds: + * - 'steps' | 'step': Append steps to the current flow + * - 'variables': Append variables to the current flow (for sensitive input handling) + * - 'finalize': Content script has finished flushing (used during stop barrier) + */ +export function initContentMessageHandler(session: RecordingSessionManager): void { + chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => { + try { + if (!message || message.type !== TOOL_MESSAGE_TYPES.RR_RECORDER_EVENT) return false; + + // Accept messages during 'recording' or 'stopping' states + // 'stopping' allows final steps to arrive during the drain phase + if (!session.canAcceptSteps()) { + sendResponse({ ok: true, ignored: true }); + return true; + } + + const flow = session.getFlow(); + if (!flow) { + sendResponse({ ok: true, ignored: true }); + return true; + } + + const payload = message?.payload || {}; + + // Handle steps + if (payload.kind === 'steps' || payload.kind === 'step') { + const steps: Step[] = Array.isArray(payload.steps) + ? (payload.steps as Step[]) + : payload.step + ? [payload.step as Step] + : []; + if (steps.length > 0) { + session.appendSteps(steps); + } + } + + // Handle variables (for sensitive input handling) + if (payload.kind === 'variables') { + const variables: VariableDef[] = Array.isArray(payload.variables) + ? (payload.variables as VariableDef[]) + : []; + if (variables.length > 0) { + session.appendVariables(variables); + } + } + + // Handle combined payload (steps + variables in one message) + if (payload.kind === 'batch') { + const steps: Step[] = Array.isArray(payload.steps) ? (payload.steps as Step[]) : []; + const variables: VariableDef[] = Array.isArray(payload.variables) + ? (payload.variables as VariableDef[]) + : []; + if (steps.length > 0) { + session.appendSteps(steps); + } + if (variables.length > 0) { + session.appendVariables(variables); + } + } + + // payload.kind === 'start'|'stop'|'finalize' are no-ops here (lifecycle handled elsewhere) + sendResponse({ ok: true }); + return true; + } catch (e) { + console.warn('ContentMessageHandler: processing message failed', e); + sendResponse({ ok: false, error: String((e as Error)?.message || e) }); + return true; + } + }); +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/flow-builder.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/flow-builder.ts new file mode 100644 index 00000000..4e87e04e --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/flow-builder.ts @@ -0,0 +1,100 @@ +import type { Edge, Flow, NodeBase, Step } from '../types'; +import { STEP_TYPES } from '@/common/step-types'; +import { recordingSession } from './session-manager'; +import { mapStepToNodeConfig, EDGE_LABELS } from 'chrome-mcp-shared'; + +const WORKFLOW_VERSION = 1; + +/** + * Creates an initial flow structure for recording. + * Initializes with nodes/edges (DAG) instead of steps. + */ +export function createInitialFlow(meta?: Partial): Flow { + const timeStamp = new Date().toISOString(); + const flow: Flow = { + id: meta?.id || `flow_${Date.now()}`, + name: meta?.name || 'new_workflow', + version: WORKFLOW_VERSION, + nodes: [], + edges: [], + variables: [], + meta: { + createdAt: timeStamp, + updatedAt: timeStamp, + ...meta?.meta, + }, + }; + return flow; +} + +export function generateStepId(): string { + return `step_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`; +} + +/** + * Appends a navigation step to the flow. + * Prefers centralized session append when recording is active. + * Falls back to direct DAG mutation (does NOT write flow.steps). + */ +export function addNavigationStep(flow: Flow, url: string): void { + const step: Step = { id: generateStepId(), type: STEP_TYPES.NAVIGATE, url } as Step; + + // Prefer centralized session append (single broadcast path) when active and matching flow + const sessFlow = recordingSession.getFlow?.(); + if (recordingSession.getStatus?.() === 'recording' && sessFlow === flow) { + recordingSession.appendSteps([step]); + return; + } + + // Fallback: mutate DAG directly (do not write flow.steps) + appendNodeToFlow(flow, step); +} + +/** + * Appends a step as a node to the flow's DAG structure. + * Creates node and edge from the previous node if exists. + * + * Internal helper - rarely invoked in practice. During active recording, + * addNavigationStep() routes to session.appendSteps() which handles DAG + * maintenance, caching, and timeline broadcast. This fallback only runs + * when session is not active or flow reference doesn't match. + */ +function appendNodeToFlow(flow: Flow, step: Step): void { + // Ensure DAG arrays exist + if (!Array.isArray(flow.nodes)) flow.nodes = []; + if (!Array.isArray(flow.edges)) flow.edges = []; + + const prevNodeId = flow.nodes.length > 0 ? flow.nodes[flow.nodes.length - 1]?.id : undefined; + + // Create new node + const newNode: NodeBase = { + id: step.id, + type: step.type as NodeBase['type'], + config: mapStepToNodeConfig(step), + }; + flow.nodes.push(newNode); + + // Create edge from previous node if exists + if (prevNodeId) { + const edgeId = `e_${flow.edges.length}_${prevNodeId}_${step.id}`; + const edge: Edge = { + id: edgeId, + from: prevNodeId, + to: step.id, + label: EDGE_LABELS.DEFAULT, + }; + flow.edges.push(edge); + } + + // Update meta timestamp (with error tolerance like session-manager) + try { + const timeStamp = new Date().toISOString(); + if (!flow.meta) { + flow.meta = { createdAt: timeStamp, updatedAt: timeStamp }; + } else { + flow.meta.updatedAt = timeStamp; + } + } catch { + // ignore meta update errors to not block recording + } +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/recorder-manager.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/recorder-manager.ts new file mode 100644 index 00000000..ee89344a --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/recorder-manager.ts @@ -0,0 +1,307 @@ +import type { Flow } from '../types'; +import { saveFlow } from '../flow-store'; +import { broadcastControlToTab, ensureRecorderInjected, REC_CMD } from './content-injection'; +import { recordingSession as session } from './session-manager'; +import { createInitialFlow, addNavigationStep } from './flow-builder'; +import { initBrowserEventListeners } from './browser-event-listener'; +import { initContentMessageHandler } from './content-message-handler'; + +/** Timeout for waiting for the top-frame content script to acknowledge stop. */ +const STOP_BARRIER_TOP_TIMEOUT_MS = 5000; + +/** Best-effort stop timeout for subframes (keeps top-frame still listening). */ +const STOP_BARRIER_SUBFRAME_TIMEOUT_MS = 1500; + +/** Small grace period for in-flight messages after all ACKs. */ +const STOP_BARRIER_GRACE_MS = 150; + +/** Types for stop barrier results */ +interface StopAckStats { + ack: boolean; + steps: number; + variables: number; +} + +interface StopFrameAck { + frameId: number; + ack: boolean; + timedOut: boolean; + error?: string; + stats?: StopAckStats; +} + +interface StopTabBarrierResult { + tabId: number; + ok: boolean; + skipped?: boolean; + reason?: string; + top?: StopFrameAck; + subframes: StopFrameAck[]; +} + +/** + * List frameIds for a tab. Always includes 0 (main frame). + */ +async function listFrameIds(tabId: number): Promise { + try { + const res = await chrome.webNavigation.getAllFrames({ tabId }); + const ids = Array.isArray(res) + ? res.map((f) => f.frameId).filter((n) => typeof n === 'number') + : []; + if (!ids.includes(0)) ids.unshift(0); + return Array.from(new Set(ids)).sort((a, b) => a - b); + } catch { + return [0]; + } +} + +/** + * Send stop command to a specific frame and wait for acknowledgment. + */ +async function sendStopToFrameWithAck( + tabId: number, + sessionId: string, + frameId: number, + timeoutMs: number, +): Promise { + return new Promise((resolve) => { + const t = setTimeout(() => { + resolve({ frameId, ack: false, timedOut: true }); + }, timeoutMs); + + chrome.tabs + .sendMessage( + tabId, + { + action: REC_CMD.STOP, + sessionId, + requireAck: true, + }, + { frameId }, + ) + .then((response) => { + clearTimeout(t); + const ack = !!(response && response.ack); + const stats = response && response.stats ? (response.stats as StopAckStats) : undefined; + resolve({ frameId, ack, timedOut: false, stats }); + }) + .catch((err) => { + clearTimeout(t); + resolve({ frameId, ack: false, timedOut: false, error: String(err) }); + }); + }); +} + +/** + * Stop a tab with full barrier support. + * 1. Stop subframes first (so they can finalize and postMessage to top while top is still listening) + * 2. Stop the main frame (top) and wait for ACK + */ +async function stopTabWithBarrier(tabId: number, sessionId: string): Promise { + // If the tab is already gone, don't block stop. + try { + await chrome.tabs.get(tabId); + } catch { + return { tabId, ok: true, skipped: true, reason: 'tab not found', subframes: [] }; + } + + // Ensure recorder is available in frames (best-effort). + try { + await ensureRecorderInjected(tabId); + } catch {} + + const frameIds = await listFrameIds(tabId); + const subframeIds = frameIds.filter((id) => id !== 0); + + // Stop subframes first so they can finalize and postMessage to top while top is still listening. + const subframes = await Promise.all( + subframeIds.map((fid) => + sendStopToFrameWithAck(tabId, sessionId, fid, STOP_BARRIER_SUBFRAME_TIMEOUT_MS), + ), + ); + + // Stop the main frame (top) with longer timeout + const top = await sendStopToFrameWithAck(tabId, sessionId, 0, STOP_BARRIER_TOP_TIMEOUT_MS); + + return { tabId, ok: top.ack, top, subframes }; +} + +class RecorderManagerImpl { + private initialized = false; + + async init(): Promise { + if (this.initialized) return; + initBrowserEventListeners(session); + initContentMessageHandler(session); + this.initialized = true; + } + + async start(meta?: Partial): Promise<{ success: boolean; error?: string }> { + if (session.getStatus() !== 'idle') + return { success: false, error: 'Recording already active' }; + // Resolve active tab + const [active] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!active?.id) return { success: false, error: 'Active tab not found' }; + + // Initialize flow & session + const flow: Flow = createInitialFlow(meta); + await session.startSession(flow, active.id); + + // Ensure recorder available and start listening + await ensureRecorderInjected(active.id); + await broadcastControlToTab(active.id, REC_CMD.START, { + id: flow.id, + name: flow.name, + description: flow.description, + sessionId: session.getSession().sessionId, + }); + // Track active tab for targeted STOP broadcasts + session.addActiveTab(active.id); + + // Record first step + const url = active.url; + if (url) { + addNavigationStep(flow, url); + try { + await saveFlow(flow); + } catch (e) { + console.warn('RecorderManager: initial saveFlow failed', e); + } + } + + return { success: true }; + } + + /** + * Stop recording with reliable step collection using barrier protocol. + * + * Flow: + * 1. Transition to 'stopping' state (still accepts final steps) + * 2. For each tab: stop subframes first (best-effort), then stop main frame + * 3. Wait for main frame ACK (required) with timeout + * 4. Grace period for any final messages in flight + * 5. Finalize session and save flow with barrier metadata + * + * The barrier ensures: + * - All tabs have flushed their data before save + * - Subframes finalize to top before top stops + * - Barrier status is recorded in flow.meta for debugging + */ + async stop(): Promise<{ success: boolean; error?: string; flow?: Flow }> { + const currentStatus = session.getStatus(); + if (currentStatus === 'idle' || !session.getFlow()) { + return { success: false, error: 'No active recording' }; + } + + // Already stopping - don't double-stop + if (currentStatus === 'stopping') { + return { success: false, error: 'Stop already in progress' }; + } + + // Step 1: Transition to stopping state + const sessionId = session.beginStopping(); + const tabs = session.getActiveTabs(); + + // Step 2: Send stop commands to all tabs with full barrier support + // Each tab: stop subframes first, then stop main frame and wait for ACK + let results: StopTabBarrierResult[] = []; + try { + results = await Promise.all(tabs.map((tabId) => stopTabWithBarrier(tabId, sessionId))); + } catch (e) { + console.warn('RecorderManager: Error during stop broadcast:', e); + } + + // Step 3: Allow a small grace period for any final messages in flight + await new Promise((resolve) => setTimeout(resolve, STOP_BARRIER_GRACE_MS)); + + // Step 4: Finalize - clear session state and save with barrier metadata + const flow = await session.stopSession(); + const barrierOk = results.length === tabs.length && results.every((r) => r.ok || r.skipped); + const stoppedAt = new Date().toISOString(); + + if (flow) { + // Add barrier metadata to flow + try { + if (!flow.meta) flow.meta = { createdAt: stoppedAt, updatedAt: stoppedAt }; + const failed = results + .filter((r) => !r.ok || r.skipped || r.subframes.some((sf) => !sf.ack)) + .map((r) => ({ + tabId: r.tabId, + skipped: r.skipped || undefined, + reason: r.reason || undefined, + topTimedOut: r.top?.timedOut || undefined, + topError: r.top?.error || undefined, + subframesFailed: r.subframes.filter((sf) => !sf.ack).length || undefined, + })) + .slice(0, 20); // Limit to first 20 to avoid bloating metadata + + flow.meta.stopBarrier = { + ok: barrierOk, + sessionId, + stoppedAt, + failed: failed.length ? failed : undefined, + }; + } catch {} + + await saveFlow(flow); + } + + // Return with barrier status + if (!barrierOk) { + const failedTabs = results.filter((r) => !r.ok && !r.skipped).map((r) => r.tabId); + return { + success: true, // Flow is still saved, but with incomplete barrier + flow: flow || undefined, + error: failedTabs.length + ? `Stop barrier incomplete; missing ACK from tabs: ${failedTabs.join(', ')}` + : 'Stop barrier incomplete; missing ACK(s)', + }; + } + + return flow ? { success: true, flow } : { success: true }; + } + + /** + * Pause recording. Steps are not collected while paused. + */ + async pause(): Promise<{ success: boolean; error?: string }> { + if (session.getStatus() !== 'recording') { + return { success: false, error: 'Not currently recording' }; + } + + session.pause(); + + // Broadcast pause to all active tabs + const tabs = session.getActiveTabs(); + try { + await Promise.all(tabs.map((id) => broadcastControlToTab(id, REC_CMD.PAUSE))); + } catch (e) { + console.warn('RecorderManager: Error during pause broadcast:', e); + } + + return { success: true }; + } + + /** + * Resume recording after pause. + */ + async resume(): Promise<{ success: boolean; error?: string }> { + if (session.getStatus() !== 'paused') { + return { success: false, error: 'Not currently paused' }; + } + + session.resume(); + + // Broadcast resume to all active tabs + const tabs = session.getActiveTabs(); + try { + await Promise.all(tabs.map((id) => broadcastControlToTab(id, REC_CMD.RESUME))); + } catch (e) { + console.warn('RecorderManager: Error during resume broadcast:', e); + } + + return { success: true }; + } +} + +export const RecorderManager = new RecorderManagerImpl(); diff --git a/app/chrome-extension/entrypoints/background/record-replay/recording/session-manager.ts b/app/chrome-extension/entrypoints/background/record-replay/recording/session-manager.ts new file mode 100644 index 00000000..7a8c1d32 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/recording/session-manager.ts @@ -0,0 +1,495 @@ +import type { Edge, Flow, NodeBase, Step, VariableDef } from '../types'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { NODE_TYPES } from '@/common/node-types'; +import { mapStepToNodeConfig, stepsToDAG, EDGE_LABELS } from 'chrome-mcp-shared'; + +/** + * Recording status state machine: + * - idle: No active recording + * - recording: Actively capturing user interactions + * - paused: Temporarily paused (UI can resume) + * - stopping: Draining final steps from content scripts before save + */ +export type RecordingStatus = 'idle' | 'recording' | 'paused' | 'stopping'; + +export interface RecordingSessionState { + sessionId: string; + status: RecordingStatus; + originTabId: number | null; + flow: Flow | null; + // Track tabs that have participated in this recording session + activeTabs: Set; + // Track which tabs have acknowledged stop command + stoppedTabs: Set; +} + +// Valid node types for type checking +const VALID_NODE_TYPES = new Set(Object.values(NODE_TYPES)); + +export class RecordingSessionManager { + private state: RecordingSessionState = { + sessionId: '', + status: 'idle', + originTabId: null, + flow: null, + activeTabs: new Set(), + stoppedTabs: new Set(), + }; + + // Session-level cache for incremental DAG sync (cleared on session start/stop) + // Note: stepIndexMap removed - we no longer write to flow.steps + private nodeIndexMap: Map = new Map(); + // Monotonic counter for edge id generation (avoids collision on delete/reorder) + private edgeSeq: number = 0; + + getStatus(): RecordingStatus { + return this.state.status; + } + + getSession(): Readonly { + return this.state; + } + + getFlow(): Flow | null { + return this.state.flow; + } + + getOriginTabId(): number | null { + return this.state.originTabId; + } + + addActiveTab(tabId: number): void { + if (typeof tabId === 'number') this.state.activeTabs.add(tabId); + } + + removeActiveTab(tabId: number): void { + this.state.activeTabs.delete(tabId); + } + + getActiveTabs(): number[] { + return Array.from(this.state.activeTabs); + } + + async startSession(flow: Flow, originTabId: number): Promise { + // Clear cache for fresh session + this.nodeIndexMap.clear(); + this.edgeSeq = 0; + + this.state = { + sessionId: `sess_${Date.now()}`, + status: 'recording', + originTabId, + flow, + activeTabs: new Set([originTabId]), + stoppedTabs: new Set(), + }; + + // Initialize caches from existing flow data (supports resume scenarios) + this.rebuildCaches(); + } + + /** + * Transition to stopping state. Content scripts can still send final steps. + * Returns the sessionId for barrier verification. + */ + beginStopping(): string { + if (this.state.status === 'idle') return ''; + this.state.status = 'stopping'; + this.state.stoppedTabs.clear(); + return this.state.sessionId; + } + + /** + * Mark a tab as having acknowledged the stop command. + * Returns true if all active tabs have stopped. + */ + markTabStopped(tabId: number): boolean { + this.state.stoppedTabs.add(tabId); + // Check if all active tabs have acknowledged + for (const activeTabId of this.state.activeTabs) { + if (!this.state.stoppedTabs.has(activeTabId)) { + return false; + } + } + return true; + } + + /** + * Check if we're in stopping state (still accepting final steps). + */ + isStopping(): boolean { + return this.state.status === 'stopping'; + } + + /** + * Check if we can accept steps (recording or stopping). + */ + canAcceptSteps(): boolean { + return this.state.status === 'recording' || this.state.status === 'stopping'; + } + + /** + * Transition to paused state. + */ + pause(): void { + if (this.state.status === 'recording') { + this.state.status = 'paused'; + } + } + + /** + * Resume from paused state. + */ + resume(): void { + if (this.state.status === 'paused') { + this.state.status = 'recording'; + } + } + + /** + * Finalize stop and clear session state. + */ + async stopSession(): Promise { + const flow = this.state.flow; + this.state.status = 'idle'; + this.state.flow = null; + this.state.originTabId = null; + this.state.activeTabs.clear(); + this.state.stoppedTabs.clear(); + // Clear cache + this.nodeIndexMap.clear(); + this.edgeSeq = 0; + return flow; + } + + updateFlow(mutator: (f: Flow) => void): void { + const f = this.state.flow; + if (!f) return; + mutator(f); + try { + (f.meta as any).updatedAt = new Date().toISOString(); + } catch (e) { + // ignore meta update errors + } + } + + /** + * Append or upsert steps to the flow with incremental DAG sync. + * Uses upsert semantics: if a step with the same id exists, update it in place. + * This ensures fill steps get their final value even after initial flush. + * + * DAG sync: maintains flow.nodes/edges during recording. + * - New step → create node + edge from previous node + * - Upsert step → update node.config and node.type + * - Invariant violation → fallback to linear DAG rebuild + * + * Note: flow.steps is no longer written. Nodes are the source of truth. + */ + appendSteps(steps: Step[]): void { + const f = this.state.flow; + if (!f || !Array.isArray(steps) || steps.length === 0) return; + + // Initialize arrays if missing + if (!Array.isArray(f.nodes)) f.nodes = []; + if (!Array.isArray(f.edges)) f.edges = []; + + // Legacy compatibility: if flow only has steps, initialize DAG from them once + if (f.nodes.length === 0 && Array.isArray(f.steps) && f.steps.length > 0) { + this.rebuildDagFromSteps(); + } + + const nodes = f.nodes; + const edges = f.edges; + + // Check invariants: edges must match linear chain + // If violated (e.g., imported flow, manual edit), rebuild linear chain + if (!this.checkDagInvariant(nodes, edges)) { + this.rechainEdges(); + } + + // Process each incoming step with upsert semantics + incremental DAG sync + let needsRebuild = false; + for (const step of steps) { + // Ensure step has an id + if (!step.id) { + step.id = `step_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`; + } + + const nodeIdx = this.nodeIndexMap.get(step.id); + if (nodeIdx !== undefined) { + // Upsert: update existing node in place + if (!nodes[nodeIdx]) { + needsRebuild = true; + continue; + } + nodes[nodeIdx] = { + ...nodes[nodeIdx], + type: this.toNodeType(step.type), + config: mapStepToNodeConfig(step), + }; + } else { + // Append: new node + const prevNodeId = nodes.length > 0 ? nodes[nodes.length - 1]?.id : undefined; + + // Create corresponding node + const newNode: NodeBase = { + id: step.id, + type: this.toNodeType(step.type), + config: mapStepToNodeConfig(step), + }; + nodes.push(newNode); + this.nodeIndexMap.set(step.id, nodes.length - 1); + + // Create edge from previous node (if exists) + if (prevNodeId) { + if (!this.nodeIndexMap.has(prevNodeId)) { + needsRebuild = true; + continue; + } + const edgeId = `e_${this.edgeSeq++}_${prevNodeId}_${step.id}`; + edges.push({ + id: edgeId, + from: prevNodeId, + to: step.id, + label: EDGE_LABELS.DEFAULT, + }); + } + } + } + + // Final invariant check: if any inconsistency detected, rebuild edges + if (needsRebuild || !this.checkDagInvariant(nodes, edges)) { + this.rechainEdges(); + } + + // Update meta timestamp + try { + if (f.meta) { + f.meta.updatedAt = new Date().toISOString(); + } + } catch { + // ignore meta update errors + } + + this.broadcastTimelineUpdate(); + } + + /** + * Convert step type to valid NodeType with fallback to SCRIPT. + * Logs a warning for unknown types to help detect upstream type drift. + */ + private toNodeType(stepType: string): NodeBase['type'] { + if (VALID_NODE_TYPES.has(stepType)) { + return stepType as NodeBase['type']; + } + console.warn(`[RecordingSession] Unknown step type "${stepType}", falling back to "script"`); + return NODE_TYPES.SCRIPT; + } + + /** + * Check DAG invariant for linear recording: + * - edges.length === max(0, nodes.length - 1) + * - Last edge (if exists) points to the last node + */ + private checkDagInvariant(nodes: NodeBase[], edges: Edge[]): boolean { + const nodeCount = nodes.length; + const expectedEdgeCount = Math.max(0, nodeCount - 1); + + // Check edge count matches expected linear chain + if (edges.length !== expectedEdgeCount) { + return false; + } + + // Check last edge points to last node (if edges exist) + if (edges.length > 0 && nodes.length > 0) { + const lastEdge = edges[edges.length - 1]; + const lastNodeId = nodes[nodes.length - 1]?.id; + if (lastEdge.to !== lastNodeId) { + return false; + } + } + + return true; + } + + /** + * Rebuild caches from current flow state. + * Called on session start and after DAG rebuild. + */ + private rebuildCaches(): void { + const f = this.state.flow; + if (!f) return; + + this.nodeIndexMap.clear(); + + if (Array.isArray(f.nodes)) { + for (let i = 0; i < f.nodes.length; i++) { + const id = f.nodes[i]?.id; + if (id) this.nodeIndexMap.set(id, i); + } + } + + // Sync edgeSeq to continue from current edge count (avoids id collision) + this.edgeSeq = Array.isArray(f.edges) ? f.edges.length : 0; + } + + /** + * Full DAG rebuild from legacy steps. + * Used when flow only has steps[] but no nodes[]. + */ + private rebuildDagFromSteps(): void { + const f = this.state.flow; + if (!f || !Array.isArray(f.steps) || f.steps.length === 0) return; + + const dag = stepsToDAG(f.steps); + + // Clear and repopulate nodes + if (!Array.isArray(f.nodes)) f.nodes = []; + f.nodes.length = 0; + for (const n of dag.nodes) { + f.nodes.push({ + id: n.id, + type: this.toNodeType(n.type), + config: n.config, + }); + } + + // Clear and repopulate edges + if (!Array.isArray(f.edges)) f.edges = []; + f.edges.length = 0; + for (const e of dag.edges) { + f.edges.push({ + id: e.id, + from: e.from, + to: e.to, + label: e.label, + }); + } + + // Rebuild caches + this.rebuildCaches(); + } + + /** + * Re-chain edges linearly according to current nodes order. + * Used when edge invariant is violated but nodes exist. + */ + private rechainEdges(): void { + const f = this.state.flow; + if (!f) return; + + if (!Array.isArray(f.nodes)) f.nodes = []; + if (!Array.isArray(f.edges)) f.edges = []; + + // Clear and re-chain edges + f.edges.length = 0; + for (let i = 0; i < f.nodes.length - 1; i++) { + const from = f.nodes[i].id; + const to = f.nodes[i + 1].id; + f.edges.push({ + id: `e_${i}_${from}_${to}`, + from, + to, + label: EDGE_LABELS.DEFAULT, + }); + } + + // Rebuild caches + this.rebuildCaches(); + } + + /** + * Append variables to the flow. Deduplicates by key. + */ + appendVariables(variables: VariableDef[]): void { + const f = this.state.flow; + if (!f || !Array.isArray(variables) || variables.length === 0) return; + + if (!f.variables) { + f.variables = []; + } + + // Deduplicate by key - newer definitions override older ones + const existingKeys = new Set(f.variables.map((v) => v.key)); + for (const v of variables) { + if (!v.key) continue; + if (existingKeys.has(v.key)) { + // Update existing variable + const idx = f.variables.findIndex((fv) => fv.key === v.key); + if (idx >= 0) { + f.variables[idx] = v; + } + } else { + f.variables.push(v); + existingKeys.add(v.key); + } + } + + // Update meta timestamp + try { + if (f.meta) { + f.meta.updatedAt = new Date().toISOString(); + } + } catch { + // ignore meta update errors + } + } + + /** + * Derive timeline steps from nodes for UI broadcast. + * This keeps protocol compatibility with recorder.js without storing steps. + */ + private getTimelineSteps(): Step[] { + const f = this.state.flow; + if (!f) return []; + + // Primary: derive from nodes + if (Array.isArray(f.nodes) && f.nodes.length > 0) { + return f.nodes.map((n) => { + const cfg = + n && typeof n.config === 'object' && n.config != null + ? (n.config as Record) + : {}; + // Important: id and type must override any values in config + // (config may contain 'type' for trigger nodes, etc.) + return { ...cfg, id: n.id, type: n.type } as Step; + }); + } + + // Legacy fallback: use steps if no nodes (shouldn't happen in normal recording) + if (Array.isArray(f.steps) && f.steps.length > 0) { + return f.steps; + } + + return []; + } + + // Broadcast timeline updates to relevant tabs (top-frame only) + broadcastTimelineUpdate(): void { + try { + // Derive steps from nodes for UI consumption (protocol unchanged) + const fullSteps = this.getTimelineSteps(); + if (fullSteps.length === 0) return; + + // Prefer broadcasting to all tabs that participated in this session, so timeline + // stays consistent when user switches across tabs/windows during a single session. + const targets = this.getActiveTabs(); + const list = + targets && targets.length + ? targets + : this.state.originTabId != null + ? [this.state.originTabId] + : []; + for (const tabId of list) { + chrome.tabs.sendMessage( + tabId, + { action: TOOL_MESSAGE_TYPES.RR_TIMELINE_UPDATE, steps: fullSteps }, + { frameId: 0 }, + ); + } + } catch {} + } +} + +// Singleton for wiring convenience +export const recordingSession = new RecordingSessionManager(); diff --git a/app/chrome-extension/entrypoints/background/record-replay/rr-utils.ts b/app/chrome-extension/entrypoints/background/record-replay/rr-utils.ts new file mode 100644 index 00000000..6a747f24 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/rr-utils.ts @@ -0,0 +1,253 @@ +// rr-utils.ts — shared helpers for record-replay runner +// Note: comments in English + +import { + TOOL_NAMES, + topoOrder as sharedTopoOrder, + mapNodeToStep as sharedMapNodeToStep, +} from 'chrome-mcp-shared'; +import type { Edge as DagEdge, NodeBase as DagNode, Step } from './types'; +import { handleCallTool } from '../tools'; +import { EDGE_LABELS } from 'chrome-mcp-shared'; + +export function applyAssign( + target: Record, + source: any, + assign: Record, +) { + const getByPath = (obj: any, path: string) => { + try { + const parts = path + .replace(/\[(\d+)\]/g, '.$1') + .split('.') + .filter(Boolean); + let cur = obj; + for (const p of parts) { + if (cur == null) return undefined; + cur = (cur as any)[p as any]; + } + return cur; + } catch { + return undefined; + } + }; + for (const [k, v] of Object.entries(assign || {})) { + target[k] = getByPath(source, String(v)); + } +} + +export function expandTemplatesDeep(value: T, scope: Record): T { + const replaceOne = (s: string) => + s.replace(/\{([^}]+)\}/g, (_m, k) => (scope[k] ?? '').toString()); + const walk = (v: any): any => { + if (v == null) return v; + if (typeof v === 'string') return replaceOne(v); + if (Array.isArray(v)) return v.map((x) => walk(x)); + if (typeof v === 'object') { + const out: any = {}; + for (const [k, val] of Object.entries(v)) out[k] = walk(val); + return out; + } + return v; + }; + return walk(value); +} + +export async function ensureTab(options: { + tabTarget?: 'current' | 'new'; + startUrl?: string; + refresh?: boolean; +}): Promise<{ tabId: number; url?: string }> { + const target = options.tabTarget || 'current'; + const startUrl = options.startUrl; + const isWebUrl = (u?: string | null) => !!u && /^(https?:|file:)/i.test(u); + + const tabs = await chrome.tabs.query({ currentWindow: true }); + const [active] = tabs.filter((t) => t.active); + + if (target === 'new') { + let urlToOpen = startUrl; + if (!urlToOpen) urlToOpen = isWebUrl(active?.url) ? active!.url! : 'about:blank'; + const created = await chrome.tabs.create({ url: urlToOpen, active: true }); + await new Promise((r) => setTimeout(r, 300)); + return { tabId: created.id!, url: created.url }; + } + + // current tab target + if (startUrl) { + await handleCallTool({ name: TOOL_NAMES.BROWSER.NAVIGATE, args: { url: startUrl } }); + } else if (options.refresh) { + // only refresh if current tab is a web page + if (isWebUrl(active?.url)) + await handleCallTool({ name: TOOL_NAMES.BROWSER.NAVIGATE, args: { refresh: true } }); + } + + // Re-evaluate active after potential navigation + const cur = (await chrome.tabs.query({ active: true, currentWindow: true }))[0]; + let tabId = cur?.id; + let url = cur?.url; + + // If still on extension/internal page and no startUrl, try switch to an existing web tab + if (!isWebUrl(url) && !startUrl) { + const candidate = tabs.find((t) => isWebUrl(t.url)); + if (candidate?.id) { + await chrome.tabs.update(candidate.id, { active: true }); + tabId = candidate.id; + url = candidate.url; + } + } + return { tabId: tabId!, url }; +} + +export async function waitForNetworkIdle(totalTimeoutMs: number, idleThresholdMs: number) { + const deadline = Date.now() + Math.max(500, totalTimeoutMs); + const threshold = Math.max(200, idleThresholdMs); + while (Date.now() < deadline) { + await handleCallTool({ + name: TOOL_NAMES.BROWSER.NETWORK_CAPTURE_START, + args: { + includeStatic: false, + // Ensure capture remains active until we explicitly stop it + maxCaptureTime: Math.min(60_000, Math.max(threshold + 500, 2_000)), + inactivityTimeout: 0, + }, + }); + await new Promise((r) => setTimeout(r, threshold + 200)); + const stopRes = await handleCallTool({ + name: TOOL_NAMES.BROWSER.NETWORK_CAPTURE_STOP, + args: {}, + }); + const text = (stopRes as any)?.content?.find((c: any) => c.type === 'text')?.text; + try { + const json = text ? JSON.parse(text) : null; + const captureEnd = Number(json?.captureEndTime) || Date.now(); + const reqs: any[] = Array.isArray(json?.requests) ? json.requests : []; + const lastActivity = reqs.reduce( + (acc, r) => { + const t = Number(r.responseTime || r.requestTime || 0); + return t > acc ? t : acc; + }, + Number(json?.captureStartTime || 0), + ); + if (captureEnd - lastActivity >= threshold) return; // idle reached + } catch { + // ignore parse errors + } + await new Promise((r) => setTimeout(r, Math.min(500, threshold))); + } + throw new Error('wait for network idle timed out'); +} + +// Event-driven navigation wait helper +// Waits for top-frame navigation completion or SPA history updates on active tab. +// Falls back to short network idle on timeout. +export async function waitForNavigation(timeoutMs?: number, prevUrl?: string): Promise { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + if (typeof tabId !== 'number') throw new Error('Active tab not found'); + const timeout = Math.max(1000, Math.min(timeoutMs || 15000, 30000)); + const startedAt = Date.now(); + + await new Promise((resolve, reject) => { + let done = false; + let timer: any = null; + const cleanup = () => { + try { + chrome.webNavigation.onCommitted.removeListener(onCommitted); + } catch {} + try { + chrome.webNavigation.onCompleted.removeListener(onCompleted); + } catch {} + try { + (chrome.webNavigation as any).onHistoryStateUpdated?.removeListener?.( + onHistoryStateUpdated, + ); + } catch {} + try { + chrome.tabs.onUpdated.removeListener(onTabUpdated); + } catch {} + if (timer) { + try { + clearTimeout(timer); + } catch {} + } + }; + const finish = () => { + if (done) return; + done = true; + cleanup(); + resolve(); + }; + const onCommitted = (details: any) => { + if ( + details && + details.tabId === tabId && + details.frameId === 0 && + details.timeStamp >= startedAt + ) { + // committed observed; we'll wait for completion or SPA fallback + } + }; + const onCompleted = (details: any) => { + if ( + details && + details.tabId === tabId && + details.frameId === 0 && + details.timeStamp >= startedAt + ) + finish(); + }; + const onHistoryStateUpdated = (details: any) => { + if ( + details && + details.tabId === tabId && + details.frameId === 0 && + details.timeStamp >= startedAt + ) + finish(); + }; + const onTabUpdated = (updatedTabId: number, changeInfo: chrome.tabs.TabChangeInfo) => { + if (updatedTabId !== tabId) return; + if (changeInfo.status === 'complete') finish(); + if (typeof changeInfo.url === 'string' && (!prevUrl || changeInfo.url !== prevUrl)) finish(); + }; + const onTimeout = async () => { + cleanup(); + try { + await waitForNetworkIdle(2000, 800); + resolve(); + } catch { + reject(new Error('navigation timeout')); + } + }; + + chrome.webNavigation.onCommitted.addListener(onCommitted); + chrome.webNavigation.onCompleted.addListener(onCompleted); + try { + (chrome.webNavigation as any).onHistoryStateUpdated?.addListener?.(onHistoryStateUpdated); + } catch {} + chrome.tabs.onUpdated.addListener(onTabUpdated); + timer = setTimeout(onTimeout, timeout); + }); +} + +export function topoOrder(nodes: DagNode[], edges: DagEdge[]): DagNode[] { + return sharedTopoOrder(nodes, edges as any); +} + +// Helper: filter only default edges (no label or label === 'default') +export function defaultEdgesOnly(edges: DagEdge[] = []): DagEdge[] { + return (edges || []).filter((e) => !e.label || e.label === EDGE_LABELS.DEFAULT); +} + +export function mapDagNodeToStep(n: DagNode): Step { + const s: any = sharedMapNodeToStep(n as any); + if ((n as any)?.type === 'if') { + // forward extended conditional config for DAG mode + const cfg: any = (n as any).config || {}; + if (Array.isArray(cfg.branches)) s.branches = cfg.branches; + if ('else' in cfg) s.else = cfg.else; + if (cfg.condition && !s.condition) s.condition = cfg.condition; // backward-compat + } + return s as Step; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/selector-engine.ts b/app/chrome-extension/entrypoints/background/record-replay/selector-engine.ts new file mode 100644 index 00000000..e9cec024 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/selector-engine.ts @@ -0,0 +1,185 @@ +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { TargetLocator, SelectorCandidate } from './types'; + +// design note: minimal selector engine that tries ref then candidates + +export interface LocatedElement { + ref?: string; + center?: { x: number; y: number }; + resolvedBy?: 'ref' | SelectorCandidate['type']; + frameId?: number; +} + +// Helper: decide whether selector is a composite cross-frame selector +function isCompositeSelector(sel: string): boolean { + return typeof sel === 'string' && sel.includes('|>'); +} + +// Helper: typed wrapper for chrome.tabs.sendMessage with optional frameId +async function sendToTab(tabId: number, message: any, frameId?: number): Promise { + if (typeof frameId === 'number') { + return await chrome.tabs.sendMessage(tabId, message, { frameId }); + } + return await chrome.tabs.sendMessage(tabId, message); +} + +// Helper: ensure ref for a selector, handling composite selectors and mapping frameId +async function ensureRefForSelector( + tabId: number, + selector: string, + frameId?: number, +): Promise<{ ref: string; center: { x: number; y: number }; frameId?: number } | null> { + try { + let ensured: any = null; + if (isCompositeSelector(selector)) { + // Always query top for composite; helper will bridge to child and return href + ensured = await sendToTab(tabId, { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector, + }); + } else { + ensured = await sendToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, selector }, + frameId, + ); + } + if (!ensured || !ensured.success || !ensured.ref || !ensured.center) return null; + // Map frameId when composite via returned href + let locFrameId: number | undefined = undefined; + if (isCompositeSelector(selector) && ensured.href) { + try { + const frames = (await chrome.webNavigation.getAllFrames({ tabId })) as any[]; + const match = frames?.find((f) => typeof f.url === 'string' && f.url === ensured.href); + if (match) locFrameId = match.frameId; + } catch {} + } + return { ref: ensured.ref, center: ensured.center, frameId: locFrameId }; + } catch { + return null; + } +} + +/** + * Try to resolve an element using ref or candidates via content scripts + */ +export async function locateElement( + tabId: number, + target: TargetLocator, + frameId?: number, +): Promise { + // 0) Fast path: try primary selector if provided + const primarySel = (target as any)?.selector ? String((target as any).selector).trim() : ''; + if (primarySel) { + const ensured = await ensureRefForSelector(tabId, primarySel, frameId); + if (ensured) return { ...ensured, resolvedBy: 'css' }; + } + + // 1) Non-text candidates first for stability (css/attr/aria/xpath) + const nonText = (target.candidates || []).filter((c) => c.type !== 'text'); + for (const c of nonText) { + try { + if (c.type === 'css' || c.type === 'attr') { + const ensured = await ensureRefForSelector(tabId, String(c.value || ''), frameId); + if (ensured) return { ...ensured, resolvedBy: c.type }; + } else if (c.type === 'aria') { + // Minimal ARIA role+name parser like: "button[name=提交]" or "textbox[name=用户名]" + const v = String(c.value || '').trim(); + const m = v.match(/^(\w+)\s*\[\s*name\s*=\s*([^\]]+)\]$/); + const role = m ? m[1] : ''; + const name = m ? m[2] : ''; + const cleanName = name.replace(/^['"]|['"]$/g, ''); + const ariaSelectors: string[] = []; + if (role === 'textbox') { + ariaSelectors.push( + `[role="textbox"][aria-label=${JSON.stringify(cleanName)}]`, + `input[aria-label=${JSON.stringify(cleanName)}]`, + `textarea[aria-label=${JSON.stringify(cleanName)}]`, + ); + } else if (role === 'button') { + ariaSelectors.push( + `[role="button"][aria-label=${JSON.stringify(cleanName)}]`, + `button[aria-label=${JSON.stringify(cleanName)}]`, + ); + } else if (role === 'link') { + ariaSelectors.push( + `[role="link"][aria-label=${JSON.stringify(cleanName)}]`, + `a[aria-label=${JSON.stringify(cleanName)}]`, + ); + } + if (!ariaSelectors.length && role) { + ariaSelectors.push( + `[role=${JSON.stringify(role)}][aria-label=${JSON.stringify(cleanName)}]`, + ); + } + for (const sel of ariaSelectors) { + const ensured = await sendToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, selector: sel } as any, + frameId, + ); + if (ensured && ensured.success && ensured.ref && ensured.center) { + return { ref: ensured.ref, center: ensured.center, resolvedBy: c.type, frameId }; + } + } + } else if (c.type === 'xpath') { + // Minimal xpath support via document.evaluate through injected helper + const ensured = await sendToTab( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: c.value, + isXPath: true, + } as any, + frameId, + ); + if (ensured && ensured.success && ensured.ref && ensured.center) { + return { ref: ensured.ref, center: ensured.center, resolvedBy: c.type, frameId }; + } + } + } catch (e) { + // continue to next candidate + } + } + // 2) Human-intent fallback: text-based search as last resort + const textCands = (target.candidates || []).filter((c) => c.type === 'text'); + const tagName = ((target as any)?.tag || '').toString(); + for (const c of textCands) { + try { + const ensured = await sendToTab( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + useText: true, + text: c.value, + tagName, + } as any, + frameId, + ); + if (ensured && ensured.success && ensured.ref && ensured.center) { + return { ref: ensured.ref, center: ensured.center, resolvedBy: c.type }; + } + } catch {} + } + // Fallback: try ref (works when ref was produced in the same page lifecycle) + if (target.ref) { + try { + const res = await sendToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref: target.ref } as any, + frameId, + ); + if (res && res.success && res.center) { + return { ref: target.ref, center: res.center, resolvedBy: 'ref' }; + } + } catch (e) { + // ignore + } + } + return null; +} + +/** + * Ensure screenshot context hostname is still valid for coordinate-based actions + */ +// Note: screenshot hostname validation is handled elsewhere; removed legacy stub. diff --git a/app/chrome-extension/entrypoints/background/record-replay/storage/indexeddb-manager.ts b/app/chrome-extension/entrypoints/background/record-replay/storage/indexeddb-manager.ts new file mode 100644 index 00000000..22193dc0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/storage/indexeddb-manager.ts @@ -0,0 +1,174 @@ +// indexeddb-manager.ts +// IndexedDB storage manager for Record & Replay data. +// Stores: flows, runs, published, schedules, triggers. + +import type { Flow, RunRecord } from '../types'; +import type { FlowSchedule } from '../flow-store'; +import type { PublishedFlowInfo } from '../flow-store'; +import type { FlowTrigger } from '../trigger-store'; +import { IndexedDbClient } from '@/utils/indexeddb-client'; + +type StoreName = 'flows' | 'runs' | 'published' | 'schedules' | 'triggers'; + +const DB_NAME = 'rr_storage'; +// Version history: +// v1: Initial schema with flows, runs, published, schedules, triggers stores +// v2: (Previous iteration - no schema change, version was bumped during development) +// v3: Current - ensure all stores exist, support upgrade from any previous version +const DB_VERSION = 3; + +const REQUIRED_STORES = ['flows', 'runs', 'published', 'schedules', 'triggers'] as const; + +const idb = new IndexedDbClient(DB_NAME, DB_VERSION, (db, oldVersion) => { + // Idempotent upgrade: ensure all required stores exist regardless of oldVersion + // This handles both fresh installs (oldVersion=0) and upgrades from any version + for (const storeName of REQUIRED_STORES) { + if (!db.objectStoreNames.contains(storeName)) { + db.createObjectStore(storeName, { keyPath: 'id' }); + } + } +}); + +const tx = ( + store: StoreName, + mode: IDBTransactionMode, + op: (s: IDBObjectStore, t: IDBTransaction) => T | Promise, +) => idb.tx(store, mode, op); + +async function getAll(store: StoreName): Promise { + return idb.getAll(store); +} + +async function getOne(store: StoreName, key: string): Promise { + return idb.get(store, key); +} + +async function putOne(store: StoreName, value: T): Promise { + return idb.put(store, value); +} + +async function deleteOne(store: StoreName, key: string): Promise { + return idb.delete(store, key); +} + +async function clearStore(store: StoreName): Promise { + return idb.clear(store); +} + +async function putMany(storeName: StoreName, values: T[]): Promise { + return idb.putMany(storeName, values); +} + +export const IndexedDbStorage = { + flows: { + async list(): Promise { + return getAll('flows'); + }, + async get(id: string): Promise { + return getOne('flows', id); + }, + async save(flow: Flow): Promise { + return putOne('flows', flow); + }, + async delete(id: string): Promise { + return deleteOne('flows', id); + }, + }, + runs: { + async list(): Promise { + return getAll('runs'); + }, + async save(record: RunRecord): Promise { + return putOne('runs', record); + }, + async replaceAll(records: RunRecord[]): Promise { + return tx('runs', 'readwrite', async (st) => { + st.clear(); + for (const r of records) st.put(r); + return; + }); + }, + }, + published: { + async list(): Promise { + return getAll('published'); + }, + async save(info: PublishedFlowInfo): Promise { + return putOne('published', info); + }, + async delete(id: string): Promise { + return deleteOne('published', id); + }, + }, + schedules: { + async list(): Promise { + return getAll('schedules'); + }, + async save(s: FlowSchedule): Promise { + return putOne('schedules', s); + }, + async delete(id: string): Promise { + return deleteOne('schedules', id); + }, + }, + triggers: { + async list(): Promise { + return getAll('triggers'); + }, + async save(t: FlowTrigger): Promise { + return putOne('triggers', t); + }, + async delete(id: string): Promise { + return deleteOne('triggers', id); + }, + }, +}; + +// One-time migration from chrome.storage.local to IndexedDB +let migrationPromise: Promise | null = null; +let migrationFailed = false; + +export async function ensureMigratedFromLocal(): Promise { + // If previous migration failed, allow retry + if (migrationFailed) { + migrationPromise = null; + migrationFailed = false; + } + if (migrationPromise) return migrationPromise; + + migrationPromise = (async () => { + try { + const flag = await chrome.storage.local.get(['rr_idb_migrated']); + if (flag && flag['rr_idb_migrated']) return; + + // Read existing data from chrome.storage.local + const res = await chrome.storage.local.get([ + 'rr_flows', + 'rr_runs', + 'rr_published_flows', + 'rr_schedules', + 'rr_triggers', + ]); + const flows = (res['rr_flows'] as Flow[]) || []; + const runs = (res['rr_runs'] as RunRecord[]) || []; + const published = (res['rr_published_flows'] as PublishedFlowInfo[]) || []; + const schedules = (res['rr_schedules'] as FlowSchedule[]) || []; + const triggers = (res['rr_triggers'] as FlowTrigger[]) || []; + + // Write into IDB + if (flows.length) await putMany('flows', flows); + if (runs.length) await putMany('runs', runs); + if (published.length) await putMany('published', published); + if (schedules.length) await putMany('schedules', schedules); + if (triggers.length) await putMany('triggers', triggers); + + await chrome.storage.local.set({ rr_idb_migrated: true }); + } catch (e) { + migrationFailed = true; + console.error('IndexedDbStorage migration failed:', e); + // Re-throw to let callers know migration failed + throw e; + } + })(); + return migrationPromise; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/trigger-store.ts b/app/chrome-extension/entrypoints/background/record-replay/trigger-store.ts new file mode 100644 index 00000000..0c1c08a4 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/trigger-store.ts @@ -0,0 +1,56 @@ +import { IndexedDbStorage, ensureMigratedFromLocal } from './storage/indexeddb-manager'; + +export type TriggerType = 'url' | 'contextMenu' | 'command' | 'dom'; + +export interface BaseTrigger { + id: string; + type: TriggerType; + enabled: boolean; + flowId: string; + args?: Record; +} + +export interface UrlTrigger extends BaseTrigger { + type: 'url'; + match: Array<{ kind: 'url' | 'domain' | 'path'; value: string }>; +} + +export interface ContextMenuTrigger extends BaseTrigger { + type: 'contextMenu'; + title: string; + contexts?: chrome.contextMenus.ContextType[]; +} + +export interface CommandTrigger extends BaseTrigger { + type: 'command'; + commandKey: string; // e.g., run_quick_trigger_1 +} + +export interface DomTrigger extends BaseTrigger { + type: 'dom'; + selector: string; + appear?: boolean; // default true + once?: boolean; // default true + debounceMs?: number; // default 800 +} + +export type FlowTrigger = UrlTrigger | ContextMenuTrigger | CommandTrigger | DomTrigger; + +export async function listTriggers(): Promise { + await ensureMigratedFromLocal(); + return await IndexedDbStorage.triggers.list(); +} + +export async function saveTrigger(t: FlowTrigger): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.triggers.save(t); +} + +export async function deleteTrigger(id: string): Promise { + await ensureMigratedFromLocal(); + await IndexedDbStorage.triggers.delete(id); +} + +export function toId(prefix = 'trg') { + return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; +} diff --git a/app/chrome-extension/entrypoints/background/record-replay/types.ts b/app/chrome-extension/entrypoints/background/record-replay/types.ts new file mode 100644 index 00000000..c8f039d0 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/record-replay/types.ts @@ -0,0 +1,178 @@ +/** + * Record & Replay Core Types + * + * This file contains the core type definitions for the record-replay system. + * Legacy Step types have been moved to ./legacy-types.ts and are re-exported + * here for backward compatibility. + * + * Type system architecture: + * - Legacy types (./legacy-types.ts): Step-based execution model (being phased out) + * - Action types (./actions/types.ts): DAG-based execution model (new standard) + * - Core types (this file): Flow, Node, Edge, Run records (shared by both) + */ + +import { NODE_TYPES } from '@/common/node-types'; + +// ============================================================================= +// Re-export Legacy Types for Backward Compatibility +// ============================================================================= + +export type { + // Selector types + SelectorType, + SelectorCandidate, + TargetLocator, + // Step types + StepType, + StepBase, + StepClick, + StepFill, + StepTriggerEvent, + StepSetAttribute, + StepScreenshot, + StepSwitchFrame, + StepLoopElements, + StepKey, + StepScroll, + StepDrag, + StepWait, + StepAssert, + StepScript, + StepIf, + StepForeach, + StepWhile, + StepHttp, + StepExtract, + StepOpenTab, + StepSwitchTab, + StepCloseTab, + StepNavigate, + StepHandleDownload, + StepExecuteFlow, + Step, +} from './legacy-types'; + +// Import Step type for use in Flow interface +import type { Step } from './legacy-types'; + +// ============================================================================= +// Variable Definitions +// ============================================================================= + +export type VariableType = 'string' | 'number' | 'boolean' | 'enum' | 'array'; + +export interface VariableDef { + key: string; + label?: string; + sensitive?: boolean; + // default value can be string/number/boolean/array depending on type + default?: any; // keep broad for backward compatibility + type?: VariableType; // default to 'string' when omitted + rules?: { required?: boolean; pattern?: string; enum?: string[] }; +} + +// ============================================================================= +// DAG Node and Edge Types (Flow V2) +// ============================================================================= + +export type NodeType = (typeof NODE_TYPES)[keyof typeof NODE_TYPES]; + +export interface NodeBase { + id: string; + type: NodeType; + name?: string; + disabled?: boolean; + config?: any; + ui?: { x: number; y: number }; +} + +export interface Edge { + id: string; + from: string; + to: string; + // label identifies the logical branch. Keep 'default' for linear/main path. + // For conditionals, use arbitrary strings like 'case:' or 'else'. + label?: string; +} + +// ============================================================================= +// Flow Definition +// ============================================================================= + +export interface Flow { + id: string; + name: string; + description?: string; + version: number; + meta?: { + createdAt: string; + updatedAt: string; + domain?: string; + tags?: string[]; + bindings?: Array<{ type: 'domain' | 'path' | 'url'; value: string }>; + tool?: { category?: string; description?: string }; + exposedOutputs?: Array<{ nodeId: string; as: string }>; + /** Recording stop barrier status (used during recording stop) */ + stopBarrier?: { + ok: boolean; + sessionId?: string; + stoppedAt?: string; + failed?: Array<{ + tabId: number; + skipped?: boolean; + reason?: string; + topTimedOut?: boolean; + topError?: string; + subframesFailed?: number; + }>; + }; + }; + variables?: VariableDef[]; + /** + * @deprecated Use nodes/edges instead. This field is no longer written to storage. + * Kept as optional for backward compatibility with existing flows and imports. + */ + steps?: Step[]; + // Flow V2: DAG-based execution model + nodes?: NodeBase[]; + edges?: Edge[]; + subflows?: Record; +} + +// ============================================================================= +// Run Records and Results +// ============================================================================= + +export interface RunLogEntry { + stepId: string; + status: 'success' | 'failed' | 'retrying' | 'warning'; + message?: string; + tookMs?: number; + screenshotBase64?: string; // small thumbnail (optional) + consoleSnippets?: string[]; // critical lines + networkSnippets?: Array<{ method: string; url: string; status?: number; ms?: number }>; + // selector fallback info + fallbackUsed?: boolean; + fallbackFrom?: string; + fallbackTo?: string; +} + +export interface RunRecord { + id: string; + flowId: string; + startedAt: string; + finishedAt?: string; + success?: boolean; + entries: RunLogEntry[]; +} + +export interface RunResult { + runId: string; + success: boolean; + summary: { total: number; success: number; failed: number; tookMs: number }; + url?: string | null; + outputs?: Record | null; + logs?: RunLogEntry[]; + screenshots?: { onFailure?: string | null }; + paused?: boolean; // when true, the run was intentionally paused (e.g., breakpoint) +} diff --git a/app/chrome-extension/entrypoints/background/tools/base-browser.ts b/app/chrome-extension/entrypoints/background/tools/base-browser.ts index bb77b97b..1e0bc604 100644 --- a/app/chrome-extension/entrypoints/background/tools/base-browser.ts +++ b/app/chrome-extension/entrypoints/background/tools/base-browser.ts @@ -19,13 +19,22 @@ export abstract class BaseBrowserToolExecutor implements ToolExecutor { files: string[], injectImmediately = false, world: 'MAIN' | 'ISOLATED' = 'ISOLATED', + allFrames: boolean = false, + frameIds?: number[], ): Promise { console.log(`Injecting ${files.join(', ')} into tab ${tabId}`); // check if script is already injected try { + const pingFrameId = frameIds?.[0]; const response = await Promise.race([ - chrome.tabs.sendMessage(tabId, { action: `${this.name}_ping` }), + typeof pingFrameId === 'number' + ? chrome.tabs.sendMessage( + tabId, + { action: `${this.name}_ping` }, + { frameId: pingFrameId }, + ) + : chrome.tabs.sendMessage(tabId, { action: `${this.name}_ping` }), new Promise((_, reject) => setTimeout( () => reject(new Error(`${this.name} Ping action to tab ${tabId} timed out`)), @@ -49,12 +58,18 @@ export abstract class BaseBrowserToolExecutor implements ToolExecutor { } try { + const target: { tabId: number; allFrames?: boolean; frameIds?: number[] } = { tabId }; + if (frameIds && frameIds.length > 0) { + target.frameIds = frameIds; + } else if (allFrames) { + target.allFrames = true; + } await chrome.scripting.executeScript({ - target: { tabId }, + target, files, injectImmediately, world, - }); + } as any); console.log(`'${files.join(', ')}' injection successful for tab ${tabId}`); } catch (injectionError) { const errorMessage = @@ -71,9 +86,12 @@ export abstract class BaseBrowserToolExecutor implements ToolExecutor { /** * Send message to tab */ - protected async sendMessageToTab(tabId: number, message: any): Promise { + protected async sendMessageToTab(tabId: number, message: any, frameId?: number): Promise { try { - const response = await chrome.tabs.sendMessage(tabId, message); + const response = + typeof frameId === 'number' + ? await chrome.tabs.sendMessage(tabId, message, { frameId }) + : await chrome.tabs.sendMessage(tabId, message); if (response && response.error) { throw new Error(String(response.error)); @@ -92,4 +110,64 @@ export abstract class BaseBrowserToolExecutor implements ToolExecutor { throw new Error(errorMessage); } } + + /** + * Try to get an existing tab by id. Returns null when not found. + */ + protected async tryGetTab(tabId?: number): Promise { + if (typeof tabId !== 'number') return null; + try { + return await chrome.tabs.get(tabId); + } catch { + return null; + } + } + + /** + * Get the active tab in the current window. Throws when not found. + */ + protected async getActiveTabOrThrow(): Promise { + const [active] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!active || !active.id) throw new Error('Active tab not found'); + return active; + } + + /** + * Optionally focus window and/or activate tab. Defaults preserve current behavior + * when caller sets activate/focus flags explicitly. + */ + protected async ensureFocus( + tab: chrome.tabs.Tab, + options: { activate?: boolean; focusWindow?: boolean } = {}, + ): Promise { + const activate = options.activate === true; + const focusWindow = options.focusWindow === true; + if (focusWindow && typeof tab.windowId === 'number') { + await chrome.windows.update(tab.windowId, { focused: true }); + } + if (activate && typeof tab.id === 'number') { + await chrome.tabs.update(tab.id, { active: true }); + } + } + + /** + * Get the active tab. When windowId provided, search within that window; otherwise currentWindow. + */ + protected async getActiveTabInWindow(windowId?: number): Promise { + if (typeof windowId === 'number') { + const tabs = await chrome.tabs.query({ active: true, windowId }); + return tabs && tabs[0] ? tabs[0] : null; + } + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + return tabs && tabs[0] ? tabs[0] : null; + } + + /** + * Same as getActiveTabInWindow, but throws if not found. + */ + protected async getActiveTabOrThrowInWindow(windowId?: number): Promise { + const tab = await this.getActiveTabInWindow(windowId); + if (!tab || !tab.id) throw new Error('Active tab not found'); + return tab; + } } diff --git a/app/chrome-extension/entrypoints/background/tools/browser/common.ts b/app/chrome-extension/entrypoints/background/tools/browser/common.ts index 472fd1c7..7cd9e201 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/common.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/common.ts @@ -1,6 +1,7 @@ import { createErrorResponse, ToolResult } from '@/common/tool-handler'; import { BaseBrowserToolExecutor } from '../base-browser'; import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { captureFrameOnAction, isAutoCaptureActive } from './gif-recorder'; // Default window dimensions const DEFAULT_WINDOW_WIDTH = 1280; @@ -12,6 +13,9 @@ interface NavigateToolParams { width?: number; height?: number; refresh?: boolean; + tabId?: number; + windowId?: number; + background?: boolean; // when true, do not activate tab or focus window } /** @@ -20,8 +24,31 @@ interface NavigateToolParams { class NavigateTool extends BaseBrowserToolExecutor { name = TOOL_NAMES.BROWSER.NAVIGATE; + /** + * Trigger GIF auto-capture after successful navigation + */ + private async triggerAutoCapture(tabId: number, url?: string): Promise { + if (!isAutoCaptureActive(tabId)) { + return; + } + try { + await captureFrameOnAction(tabId, { type: 'navigate', url }); + } catch (error) { + console.warn('[NavigateTool] Auto-capture failed:', error); + } + } + async execute(args: NavigateToolParams): Promise { - const { newWindow = false, width, height, url, refresh = false } = args; + const { + newWindow = false, + width, + height, + url, + refresh = false, + tabId, + background, + windowId, + } = args; console.log( `Attempting to ${refresh ? 'refresh current tab' : `open URL: ${url}`} with options:`, @@ -32,21 +59,19 @@ class NavigateTool extends BaseBrowserToolExecutor { // Handle refresh option first if (refresh) { console.log('Refreshing current active tab'); + const explicit = await this.tryGetTab(tabId); + // Get target tab (explicit or active in provided window) + const targetTab = explicit || (await this.getActiveTabOrThrowInWindow(windowId)); + if (!targetTab.id) return createErrorResponse('No target tab found to refresh'); + await chrome.tabs.reload(targetTab.id); - // Get current active tab - const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); - - if (!activeTab || !activeTab.id) { - return createErrorResponse('No active tab found to refresh'); - } - - // Reload the tab - await chrome.tabs.reload(activeTab.id); - - console.log(`Refreshed tab ID: ${activeTab.id}`); + console.log(`Refreshed tab ID: ${targetTab.id}`); // Get updated tab information - const updatedTab = await chrome.tabs.get(activeTab.id); + const updatedTab = await chrome.tabs.get(targetTab.id); + + // Trigger auto-capture on refresh + await this.triggerAutoCapture(updatedTab.id!, updatedTab.url); return { content: [ @@ -70,55 +95,199 @@ class NavigateTool extends BaseBrowserToolExecutor { return createErrorResponse('URL parameter is required when refresh is not true'); } + // Handle history navigation: url="back" or url="forward" + if (url === 'back' || url === 'forward') { + const explicitTab = await this.tryGetTab(tabId); + const targetTab = explicitTab || (await this.getActiveTabOrThrowInWindow(windowId)); + if (!targetTab.id) { + return createErrorResponse('No target tab found for history navigation'); + } + + // Respect background flag for focus behavior + await this.ensureFocus(targetTab, { + activate: background !== true, + focusWindow: background !== true, + }); + + if (url === 'forward') { + await chrome.tabs.goForward(targetTab.id); + console.log(`Navigated forward in tab ID: ${targetTab.id}`); + } else { + await chrome.tabs.goBack(targetTab.id); + console.log(`Navigated back in tab ID: ${targetTab.id}`); + } + + const updatedTab = await chrome.tabs.get(targetTab.id); + + // Trigger auto-capture on history navigation + await this.triggerAutoCapture(updatedTab.id!, updatedTab.url); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + message: `Successfully navigated ${url} in browser history`, + tabId: updatedTab.id, + windowId: updatedTab.windowId, + url: updatedTab.url, + }), + }, + ], + isError: false, + }; + } + // 1. Check if URL is already open - // Get all tabs and manually compare URLs + // Prefer Chrome's URL match patterns for robust matching (host/path variations) console.log(`Checking if URL is already open: ${url}`); - // Get all tabs - const allTabs = await chrome.tabs.query({}); - // Manually filter matching tabs - const tabs = allTabs.filter((tab) => { - // Normalize URLs for comparison (remove trailing slashes) - const tabUrl = tab.url?.endsWith('/') ? tab.url.slice(0, -1) : tab.url; - const targetUrl = url.endsWith('/') ? url.slice(0, -1) : url; - return tabUrl === targetUrl; - }); - console.log(`Found ${tabs.length} matching tabs`); - - if (tabs && tabs.length > 0) { - const existingTab = tabs[0]; - console.log( - `URL already open in Tab ID: ${existingTab.id}, Window ID: ${existingTab.windowId}`, - ); - if (existingTab.id !== undefined) { - // Activate the tab - await chrome.tabs.update(existingTab.id, { active: true }); + // Build robust match patterns from the provided URL. + // This mirrors the approach in CloseTabsTool: ensure wildcard path and + // add common variants (www/no-www, http/https) to handle real-world redirects. + const buildUrlPatterns = (input: string): string[] => { + const patterns = new Set(); + try { + if (!input.includes('*')) { + const u = new URL(input); + // Use host-level wildcard to include all paths; we'll do precise selection later + const pathWildcard = '/*'; + + const hostNoWww = u.host.replace(/^www\./, ''); + const hostWithWww = hostNoWww.startsWith('www.') ? hostNoWww : `www.${hostNoWww}`; + + // Keep original host + patterns.add(`${u.protocol}//${u.host}${pathWildcard}`); + // Add no-www variant + patterns.add(`${u.protocol}//${hostNoWww}${pathWildcard}`); + // Add www variant + patterns.add(`${u.protocol}//${hostWithWww}${pathWildcard}`); + + // Add protocol variant to catch http↔https redirects + const altProtocol = u.protocol === 'https:' ? 'http:' : 'https:'; + patterns.add(`${altProtocol}//${u.host}${pathWildcard}`); + patterns.add(`${altProtocol}//${hostNoWww}${pathWildcard}`); + patterns.add(`${altProtocol}//${hostWithWww}${pathWildcard}`); + } else { + patterns.add(input); + } + } catch { + // Fallback: best-effort wildcard suffix + patterns.add(input.endsWith('/') ? `${input}*` : `${input}/*`); + } + return Array.from(patterns); + }; + + const urlPatterns = buildUrlPatterns(url); + const candidateTabs = await chrome.tabs.query({ url: urlPatterns }); + console.log(`Found ${candidateTabs.length} matching tabs with patterns:`, urlPatterns); + + // Prefer strict match when user specifies a concrete path/query. + // Only fall back to host-level activation when the target is site root. + const pickBestMatch = (target: string, tabsToPick: chrome.tabs.Tab[]) => { + let targetUrl: URL | undefined; + try { + targetUrl = new URL(target); + } catch { + // Not a fully-qualified URL; cannot do structured comparison + return tabsToPick[0]; + } + + const normalizePath = (p: string) => { + if (!p) return '/'; + // Ensure leading slash + const withLeading = p.startsWith('/') ? p : `/${p}`; + // Remove trailing slash except when root + return withLeading !== '/' && withLeading.endsWith('/') + ? withLeading.slice(0, -1) + : withLeading; + }; - if (existingTab.windowId !== undefined) { - // Bring the window containing this tab to the foreground and focus it - await chrome.windows.update(existingTab.windowId, { focused: true }); + const hostBase = (h: string) => h.replace(/^www\./, '').toLowerCase(); + const isRootTarget = normalizePath(targetUrl.pathname) === '/' && !targetUrl.search; + const targetPath = normalizePath(targetUrl.pathname); + const targetSearch = targetUrl.search || ''; + const targetHostBase = hostBase(targetUrl.host); + + let best: { tab?: chrome.tabs.Tab; score: number } = { score: -1 }; + + for (const tab of tabsToPick) { + const tabUrlStr = tab.url || ''; + let tabUrl: URL | undefined; + try { + tabUrl = new URL(tabUrlStr); + } catch { + continue; } - console.log(`Activated existing Tab ID: ${existingTab.id}`); - // Get updated tab information and return it - const updatedTab = await chrome.tabs.get(existingTab.id); + const tabHostBase = hostBase(tabUrl.host); + if (tabHostBase !== targetHostBase) continue; - return { - content: [ - { - type: 'text', - text: JSON.stringify({ - success: true, - message: 'Activated existing tab', - tabId: updatedTab.id, - windowId: updatedTab.windowId, - url: updatedTab.url, - }), - }, - ], - isError: false, - }; + const tabPath = normalizePath(tabUrl.pathname); + const tabSearch = tabUrl.search || ''; + + // Scoring: + // 3 - exact path match and (if target has query) exact query match + // 2 - exact path match ignoring query (target without query) + // 1 - same host, any path (only if target is root) + let score = -1; + const pathEqual = tabPath === targetPath; + const searchEqual = tabSearch === targetSearch; + + if (pathEqual && (targetSearch ? searchEqual : true)) { + score = 3; + } else if (pathEqual && !targetSearch) { + score = 2; + } + + if (score > best.score) { + best = { tab, score }; + if (score === 3) break; // Cannot do better + } + } + + return best.tab; + }; + + const explicitTab = await this.tryGetTab(tabId); + const existingTab = explicitTab || pickBestMatch(url, candidateTabs); + if (existingTab?.id !== undefined) { + console.log( + `URL already open in Tab ID: ${existingTab.id}, Window ID: ${existingTab.windowId}`, + ); + // Update URL only when explicit tab specified and url differs + if (explicitTab && typeof explicitTab.id === 'number') { + await chrome.tabs.update(explicitTab.id, { url }); } + // Optionally bring to foreground based on background flag + await this.ensureFocus(existingTab, { + activate: background !== true, + focusWindow: background !== true, + }); + + console.log(`Activated existing Tab ID: ${existingTab.id}`); + // Get updated tab information and return it + const updatedTab = await chrome.tabs.get(existingTab.id); + + // Trigger auto-capture on existing tab activation + await this.triggerAutoCapture(updatedTab.id!, updatedTab.url); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + message: 'Activated existing tab', + tabId: updatedTab.id, + windowId: updatedTab.windowId, + url: updatedTab.url, + }), + }, + ], + isError: false, + }; } // 2. If URL is not already open, decide how to open it based on options @@ -132,12 +301,18 @@ class NavigateTool extends BaseBrowserToolExecutor { url: url, width: typeof width === 'number' ? width : DEFAULT_WINDOW_WIDTH, height: typeof height === 'number' ? height : DEFAULT_WINDOW_HEIGHT, - focused: true, + focused: background === true ? false : true, }); if (newWindow && newWindow.id !== undefined) { console.log(`URL opened in new Window ID: ${newWindow.id}`); + // Trigger auto-capture if the new window has a tab + const firstTab = newWindow.tabs?.[0]; + if (firstTab?.id) { + await this.triggerAutoCapture(firstTab.id, firstTab.url); + } + return { content: [ { @@ -160,25 +335,36 @@ class NavigateTool extends BaseBrowserToolExecutor { } } else { console.log('Opening URL in the last active window.'); - // Try to open a new tab in the most recently active window - const lastFocusedWindow = await chrome.windows.getLastFocused({ populate: false }); + // Try to open a new tab in the specified window, otherwise the most recently active window + let targetWindow: chrome.windows.Window | null = null; + if (typeof windowId === 'number') { + targetWindow = await chrome.windows.get(windowId, { populate: false }); + } + if (!targetWindow) { + targetWindow = await chrome.windows.getLastFocused({ populate: false }); + } - if (lastFocusedWindow && lastFocusedWindow.id !== undefined) { - console.log(`Found last focused Window ID: ${lastFocusedWindow.id}`); + if (targetWindow && targetWindow.id !== undefined) { + console.log(`Found target Window ID: ${targetWindow.id}`); const newTab = await chrome.tabs.create({ url: url, - windowId: lastFocusedWindow.id, - active: true, + windowId: targetWindow.id, + active: background === true ? false : true, }); - - // Ensure the window also gets focus - await chrome.windows.update(lastFocusedWindow.id, { focused: true }); + if (background !== true) { + await chrome.windows.update(targetWindow.id, { focused: true }); + } console.log( - `URL opened in new Tab ID: ${newTab.id} in existing Window ID: ${lastFocusedWindow.id}`, + `URL opened in new Tab ID: ${newTab.id} in existing Window ID: ${targetWindow.id}`, ); + // Trigger auto-capture on new tab + if (newTab.id) { + await this.triggerAutoCapture(newTab.id, newTab.url); + } + return { content: [ { @@ -187,7 +373,7 @@ class NavigateTool extends BaseBrowserToolExecutor { success: true, message: 'Opened URL in new tab in existing window', tabId: newTab.id, - windowId: lastFocusedWindow.id, + windowId: targetWindow.id, url: newTab.url, }), }, @@ -209,6 +395,12 @@ class NavigateTool extends BaseBrowserToolExecutor { if (fallbackWindow && fallbackWindow.id !== undefined) { console.log(`URL opened in fallback new Window ID: ${fallbackWindow.id}`); + // Trigger auto-capture if fallback window has a tab + const firstTab = fallbackWindow.tabs?.[0]; + if (firstTab?.id) { + await this.triggerAutoCapture(firstTab.id, firstTab.url); + } + return { content: [ { @@ -269,20 +461,42 @@ class CloseTabsTool extends BaseBrowserToolExecutor { // If URL is provided, close all tabs matching that URL if (urlPattern) { console.log(`Searching for tabs with URL: ${url}`); - if (!urlPattern.endsWith('/')) { - urlPattern += '/*'; + try { + // Build a proper Chrome match pattern from a concrete URL. + // If caller already provided a match pattern with '*', use as-is. + if (!urlPattern.includes('*')) { + // Ignore search/hash; match by origin + pathname prefix. + // Use URL to normalize; fallback to simple suffixing when parsing fails. + try { + const u = new URL(urlPattern); + const basePath = u.pathname || '/'; + const pathWithWildcard = basePath.endsWith('/') ? `${basePath}*` : `${basePath}/*`; + urlPattern = `${u.protocol}//${u.host}${pathWithWildcard}`; + } catch { + // Not a fully-qualified URL; ensure it ends with wildcard + urlPattern = urlPattern.endsWith('/') ? `${urlPattern}*` : `${urlPattern}/*`; + } + } + } catch { + // Best-effort: ensure we have some wildcard + urlPattern = urlPattern.endsWith('*') + ? urlPattern + : urlPattern.endsWith('/') + ? `${urlPattern}*` + : `${urlPattern}/*`; } - const tabs = await chrome.tabs.query({ url }); + + const tabs = await chrome.tabs.query({ url: urlPattern }); if (!tabs || tabs.length === 0) { - console.log(`No tabs found with URL: ${url}`); + console.log(`No tabs found with URL pattern: ${urlPattern}`); return { content: [ { type: 'text', text: JSON.stringify({ success: false, - message: `No tabs found with URL: ${url}`, + message: `No tabs found with URL pattern: ${urlPattern}`, closedCount: 0, }), }, @@ -291,7 +505,7 @@ class CloseTabsTool extends BaseBrowserToolExecutor { }; } - console.log(`Found ${tabs.length} tabs with URL: ${url}`); + console.log(`Found ${tabs.length} tabs with URL pattern: ${urlPattern}`); const tabIdsToClose = tabs .map((tab) => tab.id) .filter((id): id is number => id !== undefined); @@ -409,74 +623,6 @@ class CloseTabsTool extends BaseBrowserToolExecutor { export const closeTabsTool = new CloseTabsTool(); -interface GoBackOrForwardToolParams { - isForward?: boolean; -} - -/** - * Tool for navigating back or forward in browser history - */ -class GoBackOrForwardTool extends BaseBrowserToolExecutor { - name = TOOL_NAMES.BROWSER.GO_BACK_OR_FORWARD; - - async execute(args: GoBackOrForwardToolParams): Promise { - const { isForward = false } = args; - - console.log(`Attempting to navigate ${isForward ? 'forward' : 'back'} in browser history`); - - try { - // Get current active tab - const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); - - if (!activeTab || !activeTab.id) { - return createErrorResponse('No active tab found'); - } - - // Navigate back or forward based on the isForward parameter - if (isForward) { - await chrome.tabs.goForward(activeTab.id); - console.log(`Navigated forward in tab ID: ${activeTab.id}`); - } else { - await chrome.tabs.goBack(activeTab.id); - console.log(`Navigated back in tab ID: ${activeTab.id}`); - } - - // Get updated tab information - const updatedTab = await chrome.tabs.get(activeTab.id); - - return { - content: [ - { - type: 'text', - text: JSON.stringify({ - success: true, - message: `Successfully navigated ${isForward ? 'forward' : 'back'} in browser history`, - tabId: updatedTab.id, - windowId: updatedTab.windowId, - url: updatedTab.url, - }), - }, - ], - isError: false, - }; - } catch (error) { - if (chrome.runtime.lastError) { - console.error(`Chrome API Error: ${chrome.runtime.lastError.message}`, error); - return createErrorResponse(`Chrome API Error: ${chrome.runtime.lastError.message}`); - } else { - console.error('Error in GoBackOrForwardTool.execute:', error); - return createErrorResponse( - `Error navigating ${isForward ? 'forward' : 'back'}: ${ - error instanceof Error ? error.message : String(error) - }`, - ); - } - } - } -} - -export const goBackOrForwardTool = new GoBackOrForwardTool(); - interface SwitchTabToolParams { tabId: number; windowId?: number; diff --git a/app/chrome-extension/entrypoints/background/tools/browser/computer.ts b/app/chrome-extension/entrypoints/background/tools/browser/computer.ts new file mode 100644 index 00000000..28507395 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/computer.ts @@ -0,0 +1,1427 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { ERROR_MESSAGES, TIMEOUTS } from '@/common/constants'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { clickTool, fillTool } from './interaction'; +import { keyboardTool } from './keyboard'; +import { screenshotTool } from './screenshot'; +import { screenshotContextManager, scaleCoordinates } from '@/utils/screenshot-context'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { + captureFrameOnAction, + isAutoCaptureActive, + type ActionMetadata, + type ActionType, +} from './gif-recorder'; + +type MouseButton = 'left' | 'right' | 'middle'; + +interface Coordinates { + x: number; + y: number; +} + +interface ZoomRegion { + x0: number; + y0: number; + x1: number; + y1: number; +} + +interface Modifiers { + altKey?: boolean; + ctrlKey?: boolean; + metaKey?: boolean; + shiftKey?: boolean; +} + +interface ComputerParams { + action: + | 'left_click' + | 'right_click' + | 'double_click' + | 'triple_click' + | 'left_click_drag' + | 'scroll' + | 'type' + | 'key' + | 'hover' + | 'wait' + | 'fill' + | 'fill_form' + | 'resize_page' + | 'scroll_to' + | 'zoom' + | 'screenshot'; + // click/scroll coordinates in screenshot space (if screenshot context exists) or viewport space + coordinates?: Coordinates; // for click/scroll; for drag, this is endCoordinates + startCoordinates?: Coordinates; // for drag start + // Optional element refs (from chrome_read_page) as alternative to coordinates + ref?: string; // click target or drag end + startRef?: string; // drag start + scrollDirection?: 'up' | 'down' | 'left' | 'right'; + scrollAmount?: number; + text?: string; // for type/key + repeat?: number; // for key action (1-100) + modifiers?: Modifiers; // for click actions + region?: ZoomRegion; // for zoom action + duration?: number; // seconds for wait + // For fill + selector?: string; + selectorType?: 'css' | 'xpath'; // Type of selector (default: 'css') + value?: string; + frameId?: number; // Target frame for selector/ref resolution + tabId?: number; // target existing tab id + windowId?: number; + background?: boolean; // avoid focusing/activating +} + +// Minimal CDP helper encapsulated here to avoid scattering CDP code +class CDPHelper { + static async attach(tabId: number): Promise { + await cdpSessionManager.attach(tabId, 'computer'); + } + + static async detach(tabId: number): Promise { + await cdpSessionManager.detach(tabId, 'computer'); + } + + static async send(tabId: number, method: string, params?: object): Promise { + return await cdpSessionManager.sendCommand(tabId, method, params); + } + + static async dispatchMouseEvent(tabId: number, opts: any) { + const params: any = { + type: opts.type, + x: Math.round(opts.x), + y: Math.round(opts.y), + modifiers: opts.modifiers || 0, + }; + if ( + opts.type === 'mousePressed' || + opts.type === 'mouseReleased' || + opts.type === 'mouseMoved' + ) { + params.button = opts.button || 'none'; + if (opts.type === 'mousePressed' || opts.type === 'mouseReleased') { + params.clickCount = opts.clickCount || 1; + } + // Per CDP: buttons is ignored for mouseWheel + params.buttons = opts.buttons !== undefined ? opts.buttons : 0; + } + if (opts.type === 'mouseWheel') { + params.deltaX = opts.deltaX || 0; + params.deltaY = opts.deltaY || 0; + } + await this.send(tabId, 'Input.dispatchMouseEvent', params); + } + + static async insertText(tabId: number, text: string) { + await this.send(tabId, 'Input.insertText', { text }); + } + + static modifierMask(mods: string[]): number { + const map: Record = { + alt: 1, + ctrl: 2, + control: 2, + meta: 4, + cmd: 4, + command: 4, + win: 4, + windows: 4, + shift: 8, + }; + let mask = 0; + for (const m of mods) mask |= map[m] || 0; + return mask; + } + + // Enhanced key mapping for common non-character keys + private static KEY_ALIASES: Record = { + enter: { key: 'Enter', code: 'Enter' }, + return: { key: 'Enter', code: 'Enter' }, + backspace: { key: 'Backspace', code: 'Backspace' }, + delete: { key: 'Delete', code: 'Delete' }, + tab: { key: 'Tab', code: 'Tab' }, + escape: { key: 'Escape', code: 'Escape' }, + esc: { key: 'Escape', code: 'Escape' }, + space: { key: ' ', code: 'Space', text: ' ' }, + pageup: { key: 'PageUp', code: 'PageUp' }, + pagedown: { key: 'PageDown', code: 'PageDown' }, + home: { key: 'Home', code: 'Home' }, + end: { key: 'End', code: 'End' }, + arrowup: { key: 'ArrowUp', code: 'ArrowUp' }, + arrowdown: { key: 'ArrowDown', code: 'ArrowDown' }, + arrowleft: { key: 'ArrowLeft', code: 'ArrowLeft' }, + arrowright: { key: 'ArrowRight', code: 'ArrowRight' }, + }; + + private static resolveKeyDef(token: string): { key: string; code?: string; text?: string } { + const t = (token || '').toLowerCase(); + if (this.KEY_ALIASES[t]) return this.KEY_ALIASES[t]; + if (/^f([1-9]|1[0-2])$/.test(t)) { + return { key: t.toUpperCase(), code: t.toUpperCase() }; + } + if (t.length === 1) { + const upper = t.toUpperCase(); + return { key: upper, code: `Key${upper}`, text: t }; + } + return { key: token }; + } + + static async dispatchSimpleKey(tabId: number, token: string) { + const def = this.resolveKeyDef(token); + if (def.text && def.text.length === 1) { + await this.insertText(tabId, def.text); + return; + } + await this.send(tabId, 'Input.dispatchKeyEvent', { + type: 'rawKeyDown', + key: def.key, + code: def.code, + }); + await this.send(tabId, 'Input.dispatchKeyEvent', { + type: 'keyUp', + key: def.key, + code: def.code, + }); + } + + static async dispatchKeyChord(tabId: number, chord: string) { + const parts = chord.split('+'); + const modifiers: string[] = []; + let keyToken = ''; + for (const pRaw of parts) { + const p = pRaw.trim().toLowerCase(); + if ( + ['ctrl', 'control', 'alt', 'shift', 'cmd', 'meta', 'command', 'win', 'windows'].includes(p) + ) + modifiers.push(p); + else keyToken = pRaw.trim(); + } + const mask = this.modifierMask(modifiers); + const def = this.resolveKeyDef(keyToken); + await this.send(tabId, 'Input.dispatchKeyEvent', { + type: 'rawKeyDown', + key: def.key, + code: def.code, + text: def.text, + modifiers: mask, + }); + await this.send(tabId, 'Input.dispatchKeyEvent', { + type: 'keyUp', + key: def.key, + code: def.code, + modifiers: mask, + }); + } +} + +class ComputerTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.COMPUTER; + + async execute(args: ComputerParams): Promise { + const params = args || ({} as ComputerParams); + if (!params.action) return createErrorResponse('Action parameter is required'); + + try { + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); + if (!tab.id) + return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); + + // Execute the action and capture frame on success + const result = await this.executeAction(params, tab); + + // Trigger auto-capture on successful actions (except screenshot which is read-only) + if (!result.isError && params.action !== 'screenshot' && params.action !== 'wait') { + const actionType = this.mapActionToCapture(params.action); + if (actionType) { + // Convert to viewport-space coordinates for GIF overlays + // params.coordinates may be screenshot-space when screenshot context exists + const ctx = screenshotContextManager.getContext(tab.id); + const toViewport = (c?: Coordinates): { x: number; y: number } | undefined => { + if (!c) return undefined; + if (!ctx) return { x: c.x, y: c.y }; + const scaled = scaleCoordinates(c.x, c.y, ctx); + return { x: scaled.x, y: scaled.y }; + }; + + const endCoords = toViewport(params.coordinates); + const startCoords = toViewport(params.startCoordinates); + + await this.triggerAutoCapture(tab.id, actionType, { + coordinateSpace: 'viewport', + coordinates: endCoords, + startCoordinates: startCoords, + endCoordinates: actionType === 'drag' ? endCoords : undefined, + text: params.text, + ref: params.ref, + }); + } + } + + return result; + } catch (error) { + console.error('Error in computer tool:', error); + return createErrorResponse( + `Failed to execute action: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + private mapActionToCapture(action: string): ActionType | null { + const mapping: Record = { + left_click: 'click', + right_click: 'right_click', + double_click: 'double_click', + triple_click: 'triple_click', + left_click_drag: 'drag', + scroll: 'scroll', + type: 'type', + key: 'key', + hover: 'hover', + fill: 'fill', + fill_form: 'fill', + resize_page: 'other', + scroll_to: 'scroll', + zoom: 'other', + }; + return mapping[action] || null; + } + + private async executeAction(params: ComputerParams, tab: chrome.tabs.Tab): Promise { + if (!tab.id) { + return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); + } + + // Helper to project coordinates using screenshot context when available + const project = (c?: Coordinates): Coordinates | undefined => { + if (!c) return undefined; + const ctx = screenshotContextManager.getContext(tab.id!); + if (!ctx) return c; + const scaled = scaleCoordinates(c.x, c.y, ctx); + return { x: scaled.x, y: scaled.y }; + }; + + switch (params.action) { + case 'resize_page': { + const width = Number((params as any).coordinates?.x || (params as any).text); + const height = Number((params as any).coordinates?.y || (params as any).value); + const w = Number((params as any).width ?? width); + const h = Number((params as any).height ?? height); + if (!Number.isFinite(w) || !Number.isFinite(h) || w <= 0 || h <= 0) { + return createErrorResponse('Provide width and height for resize_page (positive numbers)'); + } + try { + // Prefer precise CDP emulation + await CDPHelper.attach(tab.id); + try { + await CDPHelper.send(tab.id, 'Emulation.setDeviceMetricsOverride', { + width: Math.round(w), + height: Math.round(h), + deviceScaleFactor: 0, + mobile: false, + screenWidth: Math.round(w), + screenHeight: Math.round(h), + }); + } finally { + await CDPHelper.detach(tab.id); + } + } catch (e) { + // Fallback: window resize + if (tab.windowId !== undefined) { + await chrome.windows.update(tab.windowId, { + width: Math.round(w), + height: Math.round(h), + }); + } else { + return createErrorResponse( + `Failed to resize via CDP and cannot determine windowId: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, action: 'resize_page', width: w, height: h }), + }, + ], + isError: false, + }; + } + case 'hover': { + // Resolve target point from ref | selector | coordinates + let coord: Coordinates | undefined = undefined; + let resolvedBy: 'ref' | 'selector' | 'coordinates' | undefined; + + try { + if (params.ref) { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + // Scroll element into view first to ensure it's visible + try { + await this.sendMessageToTab(tab.id, { action: 'focusByRef', ref: params.ref }); + } catch { + // Best effort - continue even if scroll fails + } + // Re-resolve coordinates after scroll + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: params.ref, + }); + if (resolved && resolved.success) { + coord = project({ x: resolved.center.x, y: resolved.center.y }); + resolvedBy = 'ref'; + } + } else if (params.selector) { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + const selectorType = params.selectorType || 'css'; + const ensured = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: params.selector, + isXPath: selectorType === 'xpath', + }); + if (ensured && ensured.success) { + // Scroll element into view first to ensure it's visible + const resolvedRef = typeof ensured.ref === 'string' ? ensured.ref : undefined; + if (resolvedRef) { + try { + await this.sendMessageToTab(tab.id, { action: 'focusByRef', ref: resolvedRef }); + } catch { + // Best effort - continue even if scroll fails + } + // Re-resolve coordinates after scroll + const reResolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: resolvedRef, + }); + if (reResolved && reResolved.success) { + coord = project({ x: reResolved.center.x, y: reResolved.center.y }); + } else { + coord = project({ x: ensured.center.x, y: ensured.center.y }); + } + } else { + coord = project({ x: ensured.center.x, y: ensured.center.y }); + } + resolvedBy = 'selector'; + } + } else if (params.coordinates) { + coord = project(params.coordinates); + resolvedBy = 'coordinates'; + } + } catch (e) { + // fall through to error handling below + } + + if (!coord) + return createErrorResponse( + 'Provide ref or selector or coordinates for hover, or failed to resolve target', + ); + { + const stale = ((): any => { + if (!params.coordinates) return null; + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const currentHostname = getHostname(tab.url || ''); + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during hover. Capture a new screenshot or use ref/selector.`, + ); + } + return null; + })(); + if (stale) return stale; + } + + try { + await CDPHelper.attach(tab.id); + try { + // Move pointer to target. We can dispatch a single mouseMoved; browsers will generate mouseover/mouseenter as needed. + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseMoved', + x: coord.x, + y: coord.y, + button: 'none', + buttons: 0, + }); + } finally { + await CDPHelper.detach(tab.id); + } + + // Optional hold to allow UI (menus/tooltips) to appear + const holdMs = Math.max( + 0, + Math.min(params.duration ? params.duration * 1000 : 400, 5000), + ); + if (holdMs > 0) await new Promise((r) => setTimeout(r, holdMs)); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'hover', + coordinates: coord, + resolvedBy, + transport: 'cdp', + }), + }, + ], + isError: false, + }; + } catch (error) { + console.warn('[ComputerTool] CDP hover failed, attempting DOM fallback', error); + return await this.domHoverFallback(tab.id, coord, resolvedBy, params.ref); + } + } + case 'left_click': + case 'right_click': { + // Calculate CDP modifier mask for click events + const modifiersMask = CDPHelper.modifierMask( + [ + params.modifiers?.altKey ? 'alt' : undefined, + params.modifiers?.ctrlKey ? 'ctrl' : undefined, + params.modifiers?.metaKey ? 'meta' : undefined, + params.modifiers?.shiftKey ? 'shift' : undefined, + ].filter((v): v is string => typeof v === 'string'), + ); + + if (params.ref) { + // Prefer DOM click via ref + const domResult = await clickTool.execute({ + ref: params.ref, + waitForNavigation: false, + timeout: TIMEOUTS.DEFAULT_WAIT * 5, + button: params.action === 'right_click' ? 'right' : 'left', + modifiers: params.modifiers, + }); + return domResult; + } + if (params.selector) { + // Support selector-based click + const domResult = await clickTool.execute({ + selector: params.selector, + selectorType: params.selectorType, + frameId: params.frameId, + waitForNavigation: false, + timeout: TIMEOUTS.DEFAULT_WAIT * 5, + button: params.action === 'right_click' ? 'right' : 'left', + modifiers: params.modifiers, + }); + return domResult; + } + if (!params.coordinates) + return createErrorResponse('Provide ref, selector, or coordinates for click action'); + { + const stale = ((): any => { + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const currentHostname = getHostname(tab.url || ''); + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during ${params.action}. Capture a new screenshot or use ref/selector.`, + ); + } + return null; + })(); + if (stale) return stale; + } + const coord = project(params.coordinates)!; + // Prefer DOM path via existing click tool + const domResult = await clickTool.execute({ + coordinates: coord, + waitForNavigation: false, + timeout: TIMEOUTS.DEFAULT_WAIT * 5, + button: params.action === 'right_click' ? 'right' : 'left', + modifiers: params.modifiers, + }); + if (!domResult.isError) { + return domResult; // Standardized response from click tool + } + // Fallback to CDP if DOM failed + try { + await CDPHelper.attach(tab.id); + const button: MouseButton = params.action === 'right_click' ? 'right' : 'left'; + const clickCount = 1; + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseMoved', + x: coord.x, + y: coord.y, + button: 'none', + buttons: 0, + modifiers: modifiersMask, + }); + for (let i = 1; i <= clickCount; i++) { + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mousePressed', + x: coord.x, + y: coord.y, + button, + buttons: button === 'left' ? 1 : 2, + clickCount: i, + modifiers: modifiersMask, + }); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseReleased', + x: coord.x, + y: coord.y, + button, + buttons: 0, + clickCount: i, + modifiers: modifiersMask, + }); + } + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: params.action, + coordinates: coord, + }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + return createErrorResponse( + `CDP click failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + case 'double_click': + case 'triple_click': { + // Calculate CDP modifier mask for click events + const modifiersMask = CDPHelper.modifierMask( + [ + params.modifiers?.altKey ? 'alt' : undefined, + params.modifiers?.ctrlKey ? 'ctrl' : undefined, + params.modifiers?.metaKey ? 'meta' : undefined, + params.modifiers?.shiftKey ? 'shift' : undefined, + ].filter((v): v is string => typeof v === 'string'), + ); + + if (!params.coordinates && !params.ref && !params.selector) + return createErrorResponse( + 'Provide ref, selector, or coordinates for double/triple click', + ); + let coord = params.coordinates ? project(params.coordinates)! : (undefined as any); + // If ref is provided, resolve center via accessibility helper + if (params.ref) { + try { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: params.ref, + }); + if (resolved && resolved.success) { + coord = project({ x: resolved.center.x, y: resolved.center.y })!; + } + } catch (e) { + // ignore and use provided coordinates + } + } else if (params.selector) { + // Support selector-based click + try { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + const selectorType = params.selectorType || 'css'; + const ensured = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: params.selector, + isXPath: selectorType === 'xpath', + }, + params.frameId, + ); + if (ensured && ensured.success) { + coord = project({ x: ensured.center.x, y: ensured.center.y })!; + } + } catch (e) { + // ignore + } + } + if (!coord) return createErrorResponse('Failed to resolve coordinates from ref/selector'); + { + const stale = ((): any => { + if (!params.coordinates) return null; + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const currentHostname = getHostname(tab.url || ''); + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during ${params.action}. Capture a new screenshot or use ref/selector.`, + ); + } + return null; + })(); + if (stale) return stale; + } + try { + await CDPHelper.attach(tab.id); + const button: MouseButton = 'left'; + const clickCount = params.action === 'double_click' ? 2 : 3; + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseMoved', + x: coord.x, + y: coord.y, + button: 'none', + buttons: 0, + modifiers: modifiersMask, + }); + for (let i = 1; i <= clickCount; i++) { + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mousePressed', + x: coord.x, + y: coord.y, + button, + buttons: 1, + clickCount: i, + modifiers: modifiersMask, + }); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseReleased', + x: coord.x, + y: coord.y, + button, + buttons: 0, + clickCount: i, + modifiers: modifiersMask, + }); + } + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: params.action, + coordinates: coord, + }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + return createErrorResponse( + `CDP ${params.action} failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + case 'left_click_drag': { + if (!params.startCoordinates && !params.startRef) + return createErrorResponse('Provide startRef or startCoordinates for drag'); + if (!params.coordinates && !params.ref) + return createErrorResponse('Provide ref or end coordinates for drag'); + let start = params.startCoordinates + ? project(params.startCoordinates)! + : (undefined as any); + let end = params.coordinates ? project(params.coordinates)! : (undefined as any); + { + const stale = ((): any => { + if (!params.startCoordinates && !params.coordinates) return null; + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const currentHostname = getHostname(tab.url || ''); + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during left_click_drag. Capture a new screenshot or use ref/selector.`, + ); + } + return null; + })(); + if (stale) return stale; + } + if (params.startRef || params.ref) { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + } + if (params.startRef) { + try { + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: params.startRef, + }); + if (resolved && resolved.success) + start = project({ x: resolved.center.x, y: resolved.center.y })!; + } catch { + // ignore + } + } + if (params.ref) { + try { + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: params.ref, + }); + if (resolved && resolved.success) + end = project({ x: resolved.center.x, y: resolved.center.y })!; + } catch { + // ignore + } + } + if (!start || !end) return createErrorResponse('Failed to resolve drag coordinates'); + try { + await CDPHelper.attach(tab.id); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseMoved', + x: start.x, + y: start.y, + button: 'none', + buttons: 0, + }); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mousePressed', + x: start.x, + y: start.y, + button: 'left', + buttons: 1, + clickCount: 1, + }); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseMoved', + x: end.x, + y: end.y, + button: 'left', + buttons: 1, + }); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseReleased', + x: end.x, + y: end.y, + button: 'left', + buttons: 0, + clickCount: 1, + }); + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, action: 'left_click_drag', start, end }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + return createErrorResponse(`Drag failed: ${e instanceof Error ? e.message : String(e)}`); + } + } + case 'scroll': { + if (!params.coordinates && !params.ref) + return createErrorResponse('Provide ref or coordinates for scroll'); + let coord = params.coordinates ? project(params.coordinates)! : (undefined as any); + if (params.ref) { + try { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: params.ref, + }); + if (resolved && resolved.success) + coord = project({ x: resolved.center.x, y: resolved.center.y })!; + } catch { + // ignore + } + } + if (!coord) return createErrorResponse('Failed to resolve scroll coordinates'); + { + const stale = ((): any => { + if (!params.coordinates) return null; + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const currentHostname = getHostname(tab.url || ''); + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during scroll. Capture a new screenshot or use ref/selector.`, + ); + } + return null; + })(); + if (stale) return stale; + } + const direction = params.scrollDirection || 'down'; + const amount = Math.max(1, Math.min(params.scrollAmount || 3, 10)); + // Convert to deltas (~100px per tick) + const unit = 100; + let deltaX = 0, + deltaY = 0; + if (direction === 'up') deltaY = -amount * unit; + if (direction === 'down') deltaY = amount * unit; + if (direction === 'left') deltaX = -amount * unit; + if (direction === 'right') deltaX = amount * unit; + try { + await CDPHelper.attach(tab.id); + await CDPHelper.dispatchMouseEvent(tab.id, { + type: 'mouseWheel', + x: coord.x, + y: coord.y, + deltaX, + deltaY, + }); + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'scroll', + coordinates: coord, + deltaX, + deltaY, + }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + return createErrorResponse( + `Scroll failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + case 'type': { + if (!params.text) return createErrorResponse('Text parameter is required for type action'); + try { + // Optional focus via ref before typing + if (params.ref) { + await clickTool.execute({ + ref: params.ref, + waitForNavigation: false, + timeout: TIMEOUTS.DEFAULT_WAIT * 5, + }); + } + await CDPHelper.attach(tab.id); + // Use CDP insertText to avoid complex KeyboardEvent emulation for long text + await CDPHelper.insertText(tab.id, params.text); + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'type', + length: params.text.length, + }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + // Fallback to DOM-based keyboard tool + const res = await keyboardTool.execute({ + keys: params.text.split('').join(','), + delay: 0, + selector: undefined, + }); + return res; + } + } + case 'fill': { + if (!params.ref && !params.selector) { + return createErrorResponse('Provide ref or selector and a value for fill'); + } + // Reuse existing fill tool to leverage robust DOM event behavior + const res = await fillTool.execute({ + selector: params.selector as any, + selectorType: params.selectorType as any, + ref: params.ref as any, + value: params.value as any, + } as any); + return res; + } + case 'fill_form': { + const elements = (params as any).elements as Array<{ + ref: string; + value: string | number | boolean; + }>; + if (!Array.isArray(elements) || elements.length === 0) { + return createErrorResponse('elements must be a non-empty array for fill_form'); + } + const results: Array<{ ref: string; ok: boolean; error?: string }> = []; + for (const item of elements) { + if (!item || !item.ref) { + results.push({ ref: String(item?.ref || ''), ok: false, error: 'missing ref' }); + continue; + } + try { + const r = await fillTool.execute({ + ref: item.ref as any, + value: item.value as any, + } as any); + const ok = !r.isError; + results.push({ ref: item.ref, ok, error: ok ? undefined : 'failed' }); + } catch (e) { + results.push({ + ref: item.ref, + ok: false, + error: String(e instanceof Error ? e.message : e), + }); + } + } + const successCount = results.filter((r) => r.ok).length; + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'fill_form', + filled: successCount, + total: results.length, + results, + }), + }, + ], + isError: false, + }; + } + case 'key': { + if (!params.text) + return createErrorResponse( + 'text is required for key action (e.g., "Backspace Backspace Enter" or "cmd+a")', + ); + const tokens = params.text.trim().split(/\s+/).filter(Boolean); + const repeat = params.repeat ?? 1; + if (!Number.isInteger(repeat) || repeat < 1 || repeat > 100) { + return createErrorResponse('repeat must be an integer between 1 and 100 for key action'); + } + try { + // Optional focus via ref before key events + if (params.ref) { + await clickTool.execute({ + ref: params.ref, + waitForNavigation: false, + timeout: TIMEOUTS.DEFAULT_WAIT * 5, + }); + } + await CDPHelper.attach(tab.id); + for (let i = 0; i < repeat; i++) { + for (const t of tokens) { + if (t.includes('+')) await CDPHelper.dispatchKeyChord(tab.id, t); + else await CDPHelper.dispatchSimpleKey(tab.id, t); + } + } + await CDPHelper.detach(tab.id); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, action: 'key', keys: tokens, repeat }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + // Fallback to DOM keyboard simulation (comma-separated combinations) + const keysStr = tokens.join(','); + const repeatedKeys = + repeat === 1 ? keysStr : Array.from({ length: repeat }, () => keysStr).join(','); + const res = await keyboardTool.execute({ keys: repeatedKeys }); + return res; + } + } + case 'wait': { + const hasTextCondition = + typeof (params as any).text === 'string' && (params as any).text.trim().length > 0; + if (hasTextCondition) { + try { + // Conditional wait for text appearance/disappearance using content script + await this.injectContentScript( + tab.id, + ['inject-scripts/wait-helper.js'], + false, + 'ISOLATED', + true, + ); + const appear = (params as any).appear !== false; // default to true + const timeoutMs = Math.max( + 0, + Math.min(((params as any).timeout as number) || 10000, 120000), + ); + const resp = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.WAIT_FOR_TEXT, + text: (params as any).text, + appear, + timeout: timeoutMs, + }); + if (!resp || resp.success !== true) { + return createErrorResponse( + resp && resp.reason === 'timeout' + ? `wait_for timed out after ${timeoutMs}ms for text: ${(params as any).text}` + : `wait_for failed: ${resp && resp.error ? resp.error : 'unknown error'}`, + ); + } + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'wait_for', + appear, + text: (params as any).text, + matched: resp.matched || null, + tookMs: resp.tookMs, + }), + }, + ], + isError: false, + }; + } catch (e) { + return createErrorResponse( + `wait_for failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } else { + const seconds = Math.max(0, Math.min((params as any).duration || 0, 30)); + if (!seconds) + return createErrorResponse('Duration parameter is required and must be > 0'); + await new Promise((r) => setTimeout(r, seconds * 1000)); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, action: 'wait', duration: seconds }), + }, + ], + isError: false, + }; + } + } + case 'scroll_to': { + if (!params.ref) { + return createErrorResponse('ref is required for scroll_to action'); + } + try { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + const resp = await this.sendMessageToTab(tab.id, { + action: 'focusByRef', + ref: params.ref, + }); + if (!resp || resp.success !== true) { + return createErrorResponse(resp?.error || 'scroll_to failed: element not found'); + } + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'scroll_to', + ref: params.ref, + }), + }, + ], + isError: false, + }; + } catch (e) { + return createErrorResponse( + `scroll_to failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + case 'zoom': { + const region = params.region; + if (!region) { + return createErrorResponse('region is required for zoom action'); + } + const x0 = Number(region.x0); + const y0 = Number(region.y0); + const x1 = Number(region.x1); + const y1 = Number(region.y1); + if (![x0, y0, x1, y1].every(Number.isFinite)) { + return createErrorResponse('region must contain finite numbers (x0, y0, x1, y1)'); + } + if (x0 < 0 || y0 < 0 || x1 <= x0 || y1 <= y0) { + return createErrorResponse('Invalid region: require x0>=0, y0>=0 and x1>x0, y1>y0'); + } + + // Project coordinates from screenshot space to viewport space + const p0 = project({ x: x0, y: y0 })!; + const p1 = project({ x: x1, y: y1 })!; + const rx0 = Math.min(p0.x, p1.x); + const ry0 = Math.min(p0.y, p1.y); + const rx1 = Math.max(p0.x, p1.x); + const ry1 = Math.max(p0.y, p1.y); + const w = rx1 - rx0; + const h = ry1 - ry0; + if (w <= 0 || h <= 0) { + return createErrorResponse('Invalid region after projection'); + } + + // Security check: verify domain hasn't changed since last screenshot + { + const getHostname = (url: string): string => { + try { + return new URL(url).hostname; + } catch { + return ''; + } + }; + const ctx = screenshotContextManager.getContext(tab.id!); + const contextHostname = (ctx as any)?.hostname as string | undefined; + const currentHostname = getHostname(tab.url || ''); + if (contextHostname && contextHostname !== currentHostname) { + return createErrorResponse( + `Security check failed: Domain changed since last screenshot (from ${contextHostname} to ${currentHostname}) during zoom. Capture a new screenshot first.`, + ); + } + } + + try { + await CDPHelper.attach(tab.id); + const metrics: any = await CDPHelper.send(tab.id, 'Page.getLayoutMetrics', {}); + const viewport = metrics?.layoutViewport || + metrics?.visualViewport || { + clientWidth: 800, + clientHeight: 600, + pageX: 0, + pageY: 0, + }; + const vw = Math.round(Number(viewport.clientWidth || 800)); + const vh = Math.round(Number(viewport.clientHeight || 600)); + if (rx1 > vw || ry1 > vh) { + await CDPHelper.detach(tab.id); + return createErrorResponse( + `Region exceeds viewport boundaries (${vw}x${vh}). Choose a region within the visible viewport.`, + ); + } + const pageX = Number(viewport.pageX || 0); + const pageY = Number(viewport.pageY || 0); + + const shot: any = await CDPHelper.send(tab.id, 'Page.captureScreenshot', { + format: 'png', + captureBeyondViewport: false, + fromSurface: true, + clip: { + x: pageX + rx0, + y: pageY + ry0, + width: w, + height: h, + scale: 1, + }, + }); + await CDPHelper.detach(tab.id); + + const base64Data = String(shot?.data || ''); + if (!base64Data) { + return createErrorResponse('Failed to capture zoom screenshot via CDP'); + } + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'zoom', + mimeType: 'image/png', + base64Data, + region: { x0: rx0, y0: ry0, x1: rx1, y1: ry1 }, + }), + }, + ], + isError: false, + }; + } catch (e) { + await CDPHelper.detach(tab.id); + return createErrorResponse(`zoom failed: ${e instanceof Error ? e.message : String(e)}`); + } + } + case 'screenshot': { + // Reuse existing screenshot tool; it already supports base64 save option + const result = await screenshotTool.execute({ + name: 'computer', + storeBase64: true, + fullPage: false, + }); + return result; + } + default: + return createErrorResponse(`Unsupported action: ${params.action}`); + } + } + + /** + * DOM-based hover fallback when CDP is unavailable + * Tries ref-based approach first (works with iframes), falls back to coordinates + */ + private async domHoverFallback( + tabId: number, + coord?: Coordinates, + resolvedBy?: 'ref' | 'selector' | 'coordinates', + ref?: string, + ): Promise { + // Try ref-based approach first (handles iframes correctly) + if (ref) { + try { + const resp = await this.sendMessageToTab(tabId, { + action: TOOL_MESSAGE_TYPES.DISPATCH_HOVER_FOR_REF, + ref, + }); + if (resp?.success) { + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'hover', + resolvedBy: 'ref', + transport: 'dom-ref', + target: resp.target, + }), + }, + ], + isError: false, + }; + } + } catch (error) { + console.warn('[ComputerTool] DOM ref hover failed, falling back to coordinates', error); + } + } + + // Fallback to coordinate-based approach + if (!coord) { + return createErrorResponse('Hover fallback requires coordinates or ref'); + } + + try { + const [injection] = await chrome.scripting.executeScript({ + target: { tabId }, + world: 'MAIN', + func: (point) => { + const target = document.elementFromPoint(point.x, point.y); + if (!target) { + return { success: false, error: 'No element found at coordinates' }; + } + + // Dispatch hover-related events + for (const type of ['mousemove', 'mouseover', 'mouseenter']) { + target.dispatchEvent( + new MouseEvent(type, { + bubbles: true, + cancelable: true, + clientX: point.x, + clientY: point.y, + view: window, + }), + ); + } + + return { + success: true, + target: { + tagName: target.tagName, + id: target.id, + className: target.className, + text: target.textContent?.trim()?.slice(0, 100) || '', + }, + }; + }, + args: [coord], + }); + + const payload = injection?.result; + if (!payload?.success) { + return createErrorResponse(payload?.error || 'DOM hover fallback failed'); + } + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + action: 'hover', + coordinates: coord, + resolvedBy, + transport: 'dom', + target: payload.target, + }), + }, + ], + isError: false, + }; + } catch (error) { + return createErrorResponse( + `DOM hover fallback failed: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + /** + * Trigger GIF auto-capture after a successful action. + * This is a no-op if auto-capture is not active. + */ + private async triggerAutoCapture( + tabId: number, + actionType: ActionType, + metadata?: Partial, + ): Promise { + if (!isAutoCaptureActive(tabId)) { + return; + } + + try { + await captureFrameOnAction(tabId, { + type: actionType, + ...metadata, + }); + } catch (error) { + // Log but don't fail the main action + console.warn('[ComputerTool] Auto-capture failed:', error); + } + } +} + +export const computerTool = new ComputerTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/console-buffer.ts b/app/chrome-extension/entrypoints/background/tools/browser/console-buffer.ts new file mode 100644 index 00000000..4dd9fdb2 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/console-buffer.ts @@ -0,0 +1,450 @@ +import { cdpSessionManager } from '@/utils/cdp-session-manager'; + +/** + * ConsoleBuffer - 持久化的控制台日志缓冲管理器 + * + * 为每个 tab 维护一个滚动缓冲区，持续收集控制台事件。 + * 当 tab 导航到新域名时会自动清空缓冲，避免不同站点日志混淆。 + */ + +const DEFAULT_MAX_BUFFER_MESSAGES = 2000; +const DEFAULT_MAX_BUFFER_EXCEPTIONS = 500; + +export interface BufferedConsoleMessage { + timestamp: number; + level: string; + text: string; + args?: unknown[]; + source?: string; + url?: string; + lineNumber?: number; + stackTrace?: unknown; +} + +export interface BufferedConsoleException { + timestamp: number; + text: string; + url?: string; + lineNumber?: number; + columnNumber?: number; + stackTrace?: unknown; +} + +interface TabConsoleBufferState { + tabId: number; + tabUrl: string; + tabTitle: string; + hostname: string; + captureStartTime: number; + messages: BufferedConsoleMessage[]; + exceptions: BufferedConsoleException[]; + droppedMessageCount: number; + droppedExceptionCount: number; +} + +export interface ConsoleBufferReadOptions { + pattern?: RegExp; + onlyErrors?: boolean; + limit?: number; + includeExceptions?: boolean; +} + +export interface ConsoleBufferReadResult { + tabId: number; + tabUrl: string; + tabTitle: string; + captureStartTime: number; + captureEndTime: number; + totalDurationMs: number; + messages: BufferedConsoleMessage[]; + exceptions: BufferedConsoleException[]; + totalBufferedMessages: number; + totalBufferedExceptions: number; + messageCount: number; + exceptionCount: number; + messageLimitReached: boolean; + droppedMessageCount: number; + droppedExceptionCount: number; +} + +function extractHostname(url?: string): string { + if (!url) return ''; + try { + return new URL(url).hostname; + } catch { + return ''; + } +} + +function isErrorLevel(level?: string): boolean { + const normalized = (level || '').toLowerCase(); + return normalized === 'error' || normalized === 'assert'; +} + +function matchesPattern(pattern: RegExp, text: string): boolean { + pattern.lastIndex = 0; + return pattern.test(text); +} + +function formatConsoleArgs(args: unknown[]): string { + if (!args || args.length === 0) return ''; + + return args + .map((arg: unknown) => { + const a = arg as Record; + if (a.type === 'string') return (a.value as string) || ''; + if (a.type === 'number') return String(a.value ?? ''); + if (a.type === 'boolean') return String(a.value ?? ''); + if (a.type === 'object') return (a.description as string) || '[Object]'; + if (a.type === 'undefined') return 'undefined'; + if (a.type === 'function') return (a.description as string) || '[Function]'; + return (a.description as string) || (a.value as string) || String(arg); + }) + .join(' '); +} + +/** + * 从 CDP RemoteObject 提取安全的预览数据，丢弃 objectId 避免内存泄漏 + */ +function extractArgPreview(arg: unknown): unknown { + const a = arg as Record; + if (!a || typeof a !== 'object') return arg; + + // 只保留安全的字段，丢弃 objectId + const preview: Record = { + type: a.type, + }; + + if ('value' in a) preview.value = a.value; + if ('unserializableValue' in a) preview.unserializableValue = a.unserializableValue; + if ('description' in a) preview.description = a.description; + if ('subtype' in a) preview.subtype = a.subtype; + if ('className' in a) preview.className = a.className; + + return preview; +} + +function safeTimestamp(value: unknown): number { + if (typeof value === 'number' && Number.isFinite(value)) { + return value; + } + return Date.now(); +} + +function safeString(value: unknown): string { + return typeof value === 'string' ? value : ''; +} + +function safeNumber(value: unknown): number | undefined { + return typeof value === 'number' ? value : undefined; +} + +class ConsoleBuffer { + private buffers = new Map(); + private starting = new Map>(); + private static instance: ConsoleBuffer | null = null; + + constructor() { + if (ConsoleBuffer.instance) { + return ConsoleBuffer.instance; + } + ConsoleBuffer.instance = this; + + chrome.debugger.onEvent.addListener(this.handleDebuggerEvent.bind(this)); + chrome.debugger.onDetach.addListener(this.handleDebuggerDetach.bind(this)); + chrome.tabs.onRemoved.addListener(this.handleTabRemoved.bind(this)); + chrome.tabs.onUpdated.addListener(this.handleTabUpdated.bind(this)); + } + + /** + * 检查指定 tab 是否正在进行 buffer 模式的捕获 + */ + isCapturing(tabId: number): boolean { + return this.buffers.has(tabId); + } + + /** + * 确保指定 tab 的 buffer 捕获已启动 + */ + async ensureStarted(tabId: number): Promise { + if (this.buffers.has(tabId)) return; + + const existing = this.starting.get(tabId); + if (existing) return existing; + + const promise = this.startCapture(tabId).finally(() => { + this.starting.delete(tabId); + }); + this.starting.set(tabId, promise); + return promise; + } + + /** + * 清空指定 tab 的缓冲区 + */ + clear( + tabId: number, + reason: string = 'manual', + ): { clearedMessages: number; clearedExceptions: number } | null { + const state = this.buffers.get(tabId); + if (!state) return null; + + const clearedMessages = state.messages.length; + const clearedExceptions = state.exceptions.length; + + state.messages.length = 0; + state.exceptions.length = 0; + state.droppedMessageCount = 0; + state.droppedExceptionCount = 0; + state.captureStartTime = Date.now(); + + console.log( + `ConsoleBuffer: Cleared buffer for tab ${tabId} (reason=${reason}). ` + + `${clearedMessages} messages, ${clearedExceptions} exceptions.`, + ); + + return { clearedMessages, clearedExceptions }; + } + + /** + * 读取指定 tab 的缓冲区内容 + */ + read(tabId: number, options: ConsoleBufferReadOptions = {}): ConsoleBufferReadResult | null { + const state = this.buffers.get(tabId); + if (!state) return null; + + const { pattern, onlyErrors = false, limit, includeExceptions = true } = options; + + const totalBufferedMessages = state.messages.length; + const totalBufferedExceptions = state.exceptions.length; + + // 过滤消息 + let messages = state.messages; + if (onlyErrors) { + messages = messages.filter((m) => isErrorLevel(m.level)); + } + if (pattern) { + messages = messages.filter((m) => matchesPattern(pattern, m.text || '')); + } + + // 按时间排序 + messages = [...messages].sort((a, b) => a.timestamp - b.timestamp); + + // 应用 limit + let messageLimitReached = false; + const normalizedLimit = + typeof limit === 'number' && Number.isFinite(limit) ? Math.max(0, Math.floor(limit)) : null; + if (normalizedLimit !== null && messages.length > normalizedLimit) { + messageLimitReached = true; + // 保留最新的消息 + messages = messages.slice(messages.length - normalizedLimit); + } + + // 过滤异常 + let exceptions: BufferedConsoleException[] = []; + if (includeExceptions) { + exceptions = state.exceptions; + if (pattern) { + exceptions = exceptions.filter((e) => matchesPattern(pattern, e.text || '')); + } + exceptions = [...exceptions].sort((a, b) => a.timestamp - b.timestamp); + } + + const now = Date.now(); + + return { + tabId, + tabUrl: state.tabUrl, + tabTitle: state.tabTitle, + captureStartTime: state.captureStartTime, + captureEndTime: now, + totalDurationMs: now - state.captureStartTime, + messages, + exceptions, + totalBufferedMessages, + totalBufferedExceptions, + messageCount: messages.length, + exceptionCount: exceptions.length, + messageLimitReached, + droppedMessageCount: state.droppedMessageCount, + droppedExceptionCount: state.droppedExceptionCount, + }; + } + + private async startCapture(tabId: number): Promise { + const tab = await chrome.tabs.get(tabId); + const url = tab.url || ''; + const title = tab.title || ''; + const hostname = extractHostname(url); + + const state: TabConsoleBufferState = { + tabId, + tabUrl: url, + tabTitle: title, + hostname, + captureStartTime: Date.now(), + messages: [], + exceptions: [], + droppedMessageCount: 0, + droppedExceptionCount: 0, + }; + + this.buffers.set(tabId, state); + + try { + await cdpSessionManager.attach(tabId, 'console-buffer'); + await cdpSessionManager.sendCommand(tabId, 'Runtime.enable'); + await cdpSessionManager.sendCommand(tabId, 'Log.enable'); + } catch (error) { + this.buffers.delete(tabId); + await cdpSessionManager.detach(tabId, 'console-buffer').catch(() => {}); + throw error; + } + } + + private handleTabRemoved(tabId: number): void { + if (!this.buffers.has(tabId)) return; + void this.stopCapture(tabId, 'tab_closed'); + } + + private handleTabUpdated( + tabId: number, + changeInfo: chrome.tabs.TabChangeInfo, + tab: chrome.tabs.Tab, + ): void { + const state = this.buffers.get(tabId); + if (!state) return; + + const nextUrl = changeInfo.url ?? tab.url; + const nextTitle = tab.title; + + if (typeof nextUrl === 'string') { + const nextHost = extractHostname(nextUrl); + // 域名变化时清空缓冲 + if (nextHost !== state.hostname) { + this.clear(tabId, 'domain_changed'); + state.hostname = nextHost; + } + state.tabUrl = nextUrl; + } + + if (typeof nextTitle === 'string') { + state.tabTitle = nextTitle; + } + } + + private handleDebuggerDetach(source: chrome.debugger.Debuggee, reason: string): void { + if (typeof source.tabId !== 'number') return; + if (!this.buffers.has(source.tabId)) return; + + console.log( + `ConsoleBuffer: Debugger detached from tab ${source.tabId} (reason=${reason}), cleaning up.`, + ); + + this.buffers.delete(source.tabId); + this.starting.delete(source.tabId); + cdpSessionManager.detach(source.tabId, 'console-buffer').catch(() => {}); + } + + private handleDebuggerEvent( + source: chrome.debugger.Debuggee, + method: string, + params?: unknown, + ): void { + const tabId = source.tabId; + if (typeof tabId !== 'number') return; + + const state = this.buffers.get(tabId); + if (!state) return; + + const p = params as Record; + + if (method === 'Log.entryAdded' && p?.entry) { + const entry = p.entry as Record; + state.messages.push({ + timestamp: safeTimestamp(entry.timestamp), + level: safeString(entry.level) || 'log', + text: safeString(entry.text), + source: safeString(entry.source), + url: safeString(entry.url), + lineNumber: safeNumber(entry.lineNumber), + stackTrace: entry.stackTrace, + }); + this.trimMessages(state); + return; + } + + if (method === 'Runtime.consoleAPICalled' && p) { + const stackTrace = p.stackTrace as Record | undefined; + const callFrame = stackTrace?.callFrames?.[0] as Record | undefined; + const rawArgs = (p.args as unknown[]) || []; + + state.messages.push({ + timestamp: safeTimestamp(p.timestamp), + level: safeString(p.type) || 'log', + text: formatConsoleArgs(rawArgs), + source: 'console-api', + url: safeString(callFrame?.url), + lineNumber: safeNumber(callFrame?.lineNumber), + stackTrace: stackTrace, + // 只存储安全的预览数据，避免内存泄漏 + args: rawArgs.map(extractArgPreview), + }); + this.trimMessages(state); + return; + } + + if (method === 'Runtime.exceptionThrown' && p?.exceptionDetails) { + const exceptionDetails = p.exceptionDetails as Record; + const exception = exceptionDetails.exception as Record | undefined; + state.exceptions.push({ + timestamp: Date.now(), + text: + safeString(exceptionDetails.text) || + safeString(exception?.description) || + 'Unknown exception', + url: safeString(exceptionDetails.url), + lineNumber: safeNumber(exceptionDetails.lineNumber), + columnNumber: safeNumber(exceptionDetails.columnNumber), + stackTrace: exceptionDetails.stackTrace, + }); + this.trimExceptions(state); + } + } + + private trimMessages(state: TabConsoleBufferState): void { + const overflow = state.messages.length - DEFAULT_MAX_BUFFER_MESSAGES; + if (overflow <= 0) return; + state.messages.splice(0, overflow); + state.droppedMessageCount += overflow; + } + + private trimExceptions(state: TabConsoleBufferState): void { + const overflow = state.exceptions.length - DEFAULT_MAX_BUFFER_EXCEPTIONS; + if (overflow <= 0) return; + state.exceptions.splice(0, overflow); + state.droppedExceptionCount += overflow; + } + + private async stopCapture(tabId: number, reason: string): Promise { + if (!this.buffers.has(tabId)) return; + + this.buffers.delete(tabId); + this.starting.delete(tabId); + + try { + await cdpSessionManager.sendCommand(tabId, 'Runtime.disable'); + } catch { + // best effort + } + try { + await cdpSessionManager.sendCommand(tabId, 'Log.disable'); + } catch { + // best effort + } + await cdpSessionManager.detach(tabId, 'console-buffer').catch(() => {}); + console.log(`ConsoleBuffer: Stopped buffer for tab ${tabId} (reason=${reason}).`); + } +} + +export const consoleBuffer = new ConsoleBuffer(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/console.ts b/app/chrome-extension/entrypoints/background/tools/browser/console.ts index 8af45d0b..e524ac97 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/console.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/console.ts @@ -1,14 +1,28 @@ import { createErrorResponse, ToolResult } from '@/common/tool-handler'; import { BaseBrowserToolExecutor } from '../base-browser'; import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { consoleBuffer, BufferedConsoleMessage, BufferedConsoleException } from './console-buffer'; -const DEBUGGER_PROTOCOL_VERSION = '1.3'; const DEFAULT_MAX_MESSAGES = 100; +type ConsoleMode = 'snapshot' | 'buffer'; + interface ConsoleToolParams { url?: string; + tabId?: number; + background?: boolean; + windowId?: number; includeExceptions?: boolean; maxMessages?: number; + // 新增参数 + mode?: ConsoleMode; + buffer?: boolean; // mode="buffer" 的别名 + clear?: boolean; // 读取前清空 + clearAfterRead?: boolean; // 读取后清空（mcp-tools.js 风格） + pattern?: string; + onlyErrors?: boolean; + limit?: number; } interface ConsoleMessage { @@ -16,6 +30,7 @@ interface ConsoleMessage { level: string; text: string; args?: any[]; + argsSerialized?: any[]; source?: string; url?: string; lineNumber?: number; @@ -45,6 +60,80 @@ interface ConsoleResult { messageCount: number; exceptionCount: number; messageLimitReached: boolean; + droppedMessageCount: number; + droppedExceptionCount: number; +} + +// 辅助函数 + +function normalizeLimit(value: unknown, fallback: number): number { + const n = typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : fallback; + return Math.max(0, n); +} + +function parseRegexPattern(pattern?: string): RegExp | undefined { + if (typeof pattern !== 'string') return undefined; + const trimmed = pattern.trim(); + if (!trimmed) return undefined; + // 支持 /pattern/flags 语法 + const match = trimmed.match(/^\/(.+)\/([gimsuy]*)$/); + try { + return match ? new RegExp(match[1], match[2]) : new RegExp(trimmed); + } catch (e: unknown) { + const msg = e instanceof Error ? e.message : String(e); + throw new Error(`Invalid regex pattern: ${msg}`); + } +} + +function matchesPattern(pattern: RegExp, text: string): boolean { + pattern.lastIndex = 0; + return pattern.test(text); +} + +function isErrorLevel(level?: string): boolean { + const normalized = (level || '').toLowerCase(); + return normalized === 'error' || normalized === 'assert'; +} + +function applyResultFilters( + result: ConsoleResult, + options: { pattern?: RegExp; onlyErrors?: boolean; includeExceptions: boolean }, +): ConsoleResult { + const { pattern, onlyErrors = false, includeExceptions } = options; + + let messages = result.messages; + if (onlyErrors) { + messages = messages.filter((m) => isErrorLevel(m.level)); + } + if (pattern) { + messages = messages.filter((m) => matchesPattern(pattern, m.text || '')); + } + + let exceptions = includeExceptions ? result.exceptions : []; + if (includeExceptions && pattern) { + exceptions = exceptions.filter((e) => matchesPattern(pattern, e.text || '')); + } + + return { + ...result, + messages, + exceptions, + messageCount: messages.length, + exceptionCount: exceptions.length, + }; +} + +function isDebuggerConflictError(error: unknown): boolean { + const msg = (error instanceof Error ? error.message : String(error)).toLowerCase(); + return msg.includes('debugger is already attached') || msg.includes('another client'); +} + +function formatDebuggerConflictMessage(tabId: number, originalMessage: string): string { + return ( + `Failed to attach Chrome Debugger to tab ${tabId}: another debugger client is already attached ` + + `(likely DevTools or another extension). Close DevTools for this tab or disable the conflicting extension, ` + + `then retry. Original error: ${originalMessage}` + ); } /** @@ -54,17 +143,49 @@ class ConsoleTool extends BaseBrowserToolExecutor { name = TOOL_NAMES.BROWSER.CONSOLE; async execute(args: ConsoleToolParams): Promise { - const { url, includeExceptions = true, maxMessages = DEFAULT_MAX_MESSAGES } = args; + const { + url, + tabId, + windowId, + background = false, + includeExceptions = true, + maxMessages = DEFAULT_MAX_MESSAGES, + mode = 'snapshot', + buffer, + clear = false, + clearAfterRead = false, + pattern, + onlyErrors = false, + limit, + } = args; let targetTab: chrome.tabs.Tab; + let targetTabId: number | undefined; + + // 解析正则表达式 + let compiledPattern: RegExp | undefined; + try { + compiledPattern = parseRegexPattern(pattern); + } catch (e: unknown) { + const msg = e instanceof Error ? e.message : String(e); + return createErrorResponse(msg); + } try { - if (url) { + if (typeof tabId === 'number') { + // Use explicit tab + const t = await chrome.tabs.get(tabId); + if (!t?.id) return createErrorResponse('Failed to identify target tab.'); + targetTab = t; + } else if (url) { // Navigate to the specified URL - targetTab = await this.navigateToUrl(url); + targetTab = await this.navigateToUrl(url, background === true, windowId); } else { // Use current active tab - const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); + const [activeTab] = + typeof windowId === 'number' + ? await chrome.tabs.query({ active: true, windowId }) + : await chrome.tabs.query({ active: true, currentWindow: true }); if (!activeTab?.id) { return createErrorResponse('No active tab found and no URL provided.'); } @@ -75,42 +196,139 @@ class ConsoleTool extends BaseBrowserToolExecutor { return createErrorResponse('Failed to identify target tab.'); } - const tabId = targetTab.id; + targetTabId = targetTab.id; + + // 确定模式：buffer 参数是 mode="buffer" 的别名 + const resolvedMode: ConsoleMode = + mode === 'buffer' || buffer === true ? 'buffer' : 'snapshot'; + + // 计算有效的消息限制 + const normalizedMaxMessages = normalizeLimit(maxMessages, DEFAULT_MAX_MESSAGES); + const effectiveLimit = + typeof limit === 'number' + ? normalizeLimit(limit, normalizedMaxMessages) + : normalizedMaxMessages; + + // Buffer 模式 + if (resolvedMode === 'buffer') { + try { + await consoleBuffer.ensureStarted(targetTabId); + } catch (error: unknown) { + const msg = error instanceof Error ? error.message : String(error); + if (isDebuggerConflictError(error)) { + return createErrorResponse(formatDebuggerConflictMessage(targetTabId, msg)); + } + throw error; + } + + // 处理读取前清空请求 + let clearedBefore: { clearedMessages: number; clearedExceptions: number } | null = null; + if (clear === true) { + clearedBefore = consoleBuffer.clear(targetTabId, 'manual'); + } + + // 读取缓冲区 + const read = consoleBuffer.read(targetTabId, { + pattern: compiledPattern, + onlyErrors, + limit: effectiveLimit, + includeExceptions, + }); + + if (!read) { + return createErrorResponse('Console buffer is not available for this tab.'); + } + + // 处理读取后清空请求（mcp-tools.js 风格，避免重复读取） + let clearedAfter: { clearedMessages: number; clearedExceptions: number } | null = null; + if (clearAfterRead === true) { + clearedAfter = consoleBuffer.clear(targetTabId, 'manual'); + } + + // 构建清空摘要 + let clearedSummary = ''; + if (clearedBefore) { + clearedSummary += ` Cleared ${clearedBefore.clearedMessages} messages and ${clearedBefore.clearedExceptions} exceptions before reading.`; + } + if (clearedAfter) { + clearedSummary += ` Cleared ${clearedAfter.clearedMessages} messages and ${clearedAfter.clearedExceptions} exceptions after reading.`; + } + + const result: ConsoleResult = { + success: true, + message: + `Console buffer read for tab ${targetTabId}.` + + clearedSummary + + ` Returned ${read.messageCount} messages and ${read.exceptionCount} exceptions.`, + tabId: targetTabId, + tabUrl: read.tabUrl || '', + tabTitle: read.tabTitle || '', + captureStartTime: read.captureStartTime, + captureEndTime: read.captureEndTime, + totalDurationMs: read.totalDurationMs, + messages: read.messages as ConsoleMessage[], + exceptions: read.exceptions as ConsoleException[], + messageCount: read.messageCount, + exceptionCount: read.exceptionCount, + messageLimitReached: read.messageLimitReached, + droppedMessageCount: read.droppedMessageCount, + droppedExceptionCount: read.droppedExceptionCount, + }; + + return { + content: [{ type: 'text', text: JSON.stringify(result) }], + isError: false, + }; + } + + // Snapshot 模式（一次性捕获） + const result = await this.captureConsoleMessages(targetTabId, { + includeExceptions, + maxMessages: effectiveLimit, + }); - // Capture console messages (one-time capture) - const result = await this.captureConsoleMessages(tabId, { + // 应用过滤器 + const filtered = applyResultFilters(result, { + pattern: compiledPattern, + onlyErrors, includeExceptions, - maxMessages, }); return { - content: [ - { - type: 'text', - text: JSON.stringify(result), - }, - ], + content: [{ type: 'text', text: JSON.stringify(filtered) }], isError: false, }; - } catch (error: any) { + } catch (error: unknown) { console.error('ConsoleTool: Critical error during execute:', error); - return createErrorResponse(`Error in ConsoleTool: ${error.message || String(error)}`); + const msg = error instanceof Error ? error.message : String(error); + if (typeof targetTabId === 'number' && isDebuggerConflictError(error)) { + return createErrorResponse(formatDebuggerConflictMessage(targetTabId, msg)); + } + return createErrorResponse(`Error in ConsoleTool: ${msg}`); } } - private async navigateToUrl(url: string): Promise { + private async navigateToUrl( + url: string, + background = false, + windowId?: number, + ): Promise { // Check if URL is already open const existingTabs = await chrome.tabs.query({ url }); if (existingTabs.length > 0 && existingTabs[0]?.id) { const tab = existingTabs[0]; - // Activate the existing tab - await chrome.tabs.update(tab.id!, { active: true }); - await chrome.windows.update(tab.windowId, { focused: true }); + if (!background) { + // Activate the existing tab + await chrome.tabs.update(tab.id!, { active: true }); + await chrome.windows.update(tab.windowId, { focused: true }); + } return tab; } else { // Create new tab with the URL - const newTab = await chrome.tabs.create({ url, active: true }); + const createInfo: chrome.tabs.CreateProperties = { url, active: background ? false : true }; + if (typeof windowId === 'number') createInfo.windowId = windowId; + const newTab = await chrome.tabs.create(createInfo); // Wait for tab to be ready await this.waitForTabReady(newTab.id!); return newTab; @@ -177,28 +395,8 @@ class ConsoleTool extends BaseBrowserToolExecutor { // Get tab information const tab = await chrome.tabs.get(tabId); - // Check if debugger is already attached - const targets = await chrome.debugger.getTargets(); - const existingTarget = targets.find( - (t) => t.tabId === tabId && t.attached && t.type === 'page', - ); - if (existingTarget && !existingTarget.extensionId) { - throw new Error( - `Debugger is already attached to tab ${tabId} by another tool (e.g., DevTools).`, - ); - } - - // Attach debugger - try { - await chrome.debugger.attach({ tabId }, DEBUGGER_PROTOCOL_VERSION); - } catch (error: any) { - if (error.message?.includes('Cannot attach to the target with an attached client')) { - throw new Error( - `Debugger is already attached to tab ${tabId}. This might be DevTools or another extension.`, - ); - } - throw error; - } + // Attach via shared manager + await cdpSessionManager.attach(tabId, 'console'); // Set up event listener to collect messages const collectedMessages: any[] = []; @@ -235,15 +433,90 @@ class ConsoleTool extends BaseBrowserToolExecutor { try { // Enable Runtime domain first to capture console API calls and exceptions - await chrome.debugger.sendCommand({ tabId }, 'Runtime.enable'); + await cdpSessionManager.sendCommand(tabId, 'Runtime.enable'); // Also enable Log domain to capture other log entries - await chrome.debugger.sendCommand({ tabId }, 'Log.enable'); + await cdpSessionManager.sendCommand(tabId, 'Log.enable'); // Wait for all messages to be flushed await new Promise((resolve) => setTimeout(resolve, 2000)); // Process collected messages + // Helper to deeply serialize console arguments when possible + const serializeArg = async (arg: any): Promise => { + try { + if (!arg) return arg; + if (Object.prototype.hasOwnProperty.call(arg, 'unserializableValue')) { + return arg.unserializableValue; + } + if (Object.prototype.hasOwnProperty.call(arg, 'value')) { + return arg.value; + } + if (arg.objectId) { + const resp = await cdpSessionManager.sendCommand(tabId, 'Runtime.callFunctionOn', { + objectId: arg.objectId, + functionDeclaration: + 'function(maxDepth, maxProps){\n' + + ' const seen=new WeakSet();\n' + + ' function S(v,d){\n' + + ' try{\n' + + ' if(d<0) return "[MaxDepth]";\n' + + ' if(v===null) return null;\n' + + ' const t=typeof v;\n' + + ' if(t!=="object"){\n' + + ' if(t==="bigint") return v.toString()+"n";\n' + + ' return v;\n' + + ' }\n' + + ' if(seen.has(v)) return "[Circular]";\n' + + ' seen.add(v);\n' + + ' if(Array.isArray(v)){\n' + + ' const out=[];\n' + + ' for(let i=0;i=maxProps){ out.push("[...truncated]"); break; }\n' + + ' out.push(S(v[i], d-1));\n' + + ' }\n' + + ' return out;\n' + + ' }\n' + + ' if(v instanceof Date) return {__type:"Date", value:v.toISOString()};\n' + + ' if(v instanceof RegExp) return {__type:"RegExp", value:String(v)};\n' + + ' if(v instanceof Map){\n' + + ' const out={__type:"Map", entries:[]}; let c=0;\n' + + ' for(const [k,val] of v.entries()){\n' + + ' if(c++>=maxProps){ out.entries.push(["[...truncated]","[...truncated]"]); break; }\n' + + ' out.entries.push([S(k,d-1), S(val,d-1)]);\n' + + ' }\n' + + ' return out;\n' + + ' }\n' + + ' if(v instanceof Set){\n' + + ' const out={__type:"Set", values:[]}; let c=0;\n' + + ' for(const val of v.values()){\n' + + ' if(c++>=maxProps){ out.values.push("[...truncated]"); break; }\n' + + ' out.values.push(S(val,d-1));\n' + + ' }\n' + + ' return out;\n' + + ' }\n' + + ' const out={}; let c=0;\n' + + ' for(const key in v){\n' + + ' if(c++>=maxProps){ out.__truncated__=true; break; }\n' + + ' try{ out[key]=S(v[key], d-1); }catch(e){ out[key]="[Thrown]"; }\n' + + ' }\n' + + ' return out;\n' + + ' }catch(e){ return "[Unserializable]" }\n' + + ' }\n' + + ' return S(this, maxDepth);\n' + + '}', + arguments: [{ value: 3 }, { value: 100 }], + silent: true, + returnByValue: true, + }); + return resp?.result?.value ?? '[Unavailable]'; + } + return '[Unknown]'; + } catch (e) { + return '[SerializeError]'; + } + }; + for (const entry of collectedMessages) { if (messages.length >= maxMessages) { limitReached = true; @@ -265,6 +538,12 @@ class ConsoleTool extends BaseBrowserToolExecutor { if (entry.args && Array.isArray(entry.args)) { message.args = entry.args; + // Attempt deep serialization for better fidelity + const serialized: any[] = []; + for (const a of entry.args) { + serialized.push(await serializeArg(a)); + } + message.argsSerialized = serialized; } messages.push(message); @@ -293,20 +572,24 @@ class ConsoleTool extends BaseBrowserToolExecutor { // Clean up chrome.debugger.onEvent.removeListener(eventListener); - try { - await chrome.debugger.sendCommand({ tabId }, 'Runtime.disable'); - } catch (e) { - console.warn(`ConsoleTool: Error disabling Runtime for tab ${tabId}:`, e); - } + // 如果 buffer 模式正在使用这个 tab，不要关闭 Runtime/Log 域 + const keepDomainsEnabled = consoleBuffer.isCapturing(tabId); + if (!keepDomainsEnabled) { + try { + await cdpSessionManager.sendCommand(tabId, 'Runtime.disable'); + } catch (e) { + console.warn(`ConsoleTool: Error disabling Runtime for tab ${tabId}:`, e); + } - try { - await chrome.debugger.sendCommand({ tabId }, 'Log.disable'); - } catch (e) { - console.warn(`ConsoleTool: Error disabling Log for tab ${tabId}:`, e); + try { + await cdpSessionManager.sendCommand(tabId, 'Log.disable'); + } catch (e) { + console.warn(`ConsoleTool: Error disabling Log for tab ${tabId}:`, e); + } } try { - await chrome.debugger.detach({ tabId }); + await cdpSessionManager.detach(tabId, 'console'); } catch (e) { console.warn(`ConsoleTool: Error detaching debugger for tab ${tabId}:`, e); } @@ -332,6 +615,8 @@ class ConsoleTool extends BaseBrowserToolExecutor { messageCount: messages.length, exceptionCount: exceptions.length, messageLimitReached: limitReached, + droppedMessageCount: 0, + droppedExceptionCount: 0, }; } catch (error: any) { console.error(`ConsoleTool: Error capturing console messages for tab ${tabId}:`, error); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/dialog.ts b/app/chrome-extension/entrypoints/background/tools/browser/dialog.ts new file mode 100644 index 00000000..b30fca36 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/dialog.ts @@ -0,0 +1,54 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; + +interface HandleDialogParams { + action: 'accept' | 'dismiss'; + promptText?: string; +} + +/** + * Handle JavaScript dialogs (alert/confirm/prompt) via CDP Page.handleJavaScriptDialog + */ +class HandleDialogTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.HANDLE_DIALOG; + + async execute(args: HandleDialogParams): Promise { + const { action, promptText } = args || ({} as HandleDialogParams); + if (!action || (action !== 'accept' && action !== 'dismiss')) { + return createErrorResponse('action must be "accept" or "dismiss"'); + } + + try { + const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!activeTab?.id) return createErrorResponse('No active tab found'); + const tabId = activeTab.id!; + + // Use shared CDP session manager for safe attach/detach with refcount + await cdpSessionManager.withSession(tabId, 'dialog', async () => { + await cdpSessionManager.sendCommand(tabId, 'Page.enable'); + await cdpSessionManager.sendCommand(tabId, 'Page.handleJavaScriptDialog', { + accept: action === 'accept', + promptText: action === 'accept' ? promptText : undefined, + }); + }); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, action, promptText: promptText || null }), + }, + ], + isError: false, + }; + } catch (error) { + return createErrorResponse( + `Failed to handle dialog: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } +} + +export const handleDialogTool = new HandleDialogTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/download.ts b/app/chrome-extension/entrypoints/background/tools/browser/download.ts new file mode 100644 index 00000000..54779539 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/download.ts @@ -0,0 +1,123 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; + +interface HandleDownloadParams { + filenameContains?: string; + timeoutMs?: number; // default 60000 + waitForComplete?: boolean; // default true +} + +/** + * Tool: wait for a download and return info + */ +class HandleDownloadTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.HANDLE_DOWNLOAD as any; + + async execute(args: HandleDownloadParams): Promise { + const filenameContains = String(args?.filenameContains || '').trim(); + const waitForComplete = args?.waitForComplete !== false; + const timeoutMs = Math.max(1000, Math.min(Number(args?.timeoutMs ?? 60000), 300000)); + + try { + const result = await waitForDownload({ filenameContains, waitForComplete, timeoutMs }); + return { + content: [{ type: 'text', text: JSON.stringify({ success: true, download: result }) }], + isError: false, + }; + } catch (e: any) { + return createErrorResponse(`Handle download failed: ${e?.message || String(e)}`); + } + } +} + +async function waitForDownload(opts: { + filenameContains?: string; + waitForComplete: boolean; + timeoutMs: number; +}) { + const { filenameContains, waitForComplete, timeoutMs } = opts; + return new Promise((resolve, reject) => { + let timer: any = null; + const onError = (err: any) => { + cleanup(); + reject(err instanceof Error ? err : new Error(String(err))); + }; + const cleanup = () => { + try { + if (timer) clearTimeout(timer); + } catch {} + try { + chrome.downloads.onCreated.removeListener(onCreated); + } catch {} + try { + chrome.downloads.onChanged.removeListener(onChanged); + } catch {} + }; + const matches = (item: chrome.downloads.DownloadItem) => { + if (!filenameContains) return true; + const name = (item.filename || '').split(/[/\\]/).pop() || ''; + return name.includes(filenameContains) || (item.url || '').includes(filenameContains); + }; + const fulfill = async (item: chrome.downloads.DownloadItem) => { + // try to fill more details via downloads.search + try { + const [found] = await chrome.downloads.search({ id: item.id }); + const out = found || item; + cleanup(); + resolve({ + id: out.id, + filename: out.filename, + url: out.url, + mime: (out as any).mime || undefined, + fileSize: out.fileSize ?? out.totalBytes ?? undefined, + state: out.state, + danger: out.danger, + startTime: out.startTime, + endTime: (out as any).endTime || undefined, + exists: (out as any).exists, + }); + return; + } catch { + cleanup(); + resolve({ id: item.id, filename: item.filename, url: item.url, state: item.state }); + } + }; + const onCreated = (item: chrome.downloads.DownloadItem) => { + try { + if (!matches(item)) return; + if (!waitForComplete) { + fulfill(item); + } + } catch {} + }; + const onChanged = (delta: chrome.downloads.DownloadDelta) => { + try { + if (!delta || typeof delta.id !== 'number') return; + // pull item and check + chrome.downloads + .search({ id: delta.id }) + .then((arr) => { + const item = arr && arr[0]; + if (!item) return; + if (!matches(item)) return; + if (waitForComplete && item.state === 'complete') fulfill(item); + }) + .catch(() => {}); + } catch {} + }; + chrome.downloads.onCreated.addListener(onCreated); + chrome.downloads.onChanged.addListener(onChanged); + timer = setTimeout(() => onError(new Error('Download wait timed out')), timeoutMs); + // Try to find an already-running matching download + chrome.downloads + .search({ state: waitForComplete ? 'in_progress' : undefined }) + .then((arr) => { + const hit = (arr || []).find((d) => matches(d)); + if (hit && !waitForComplete) fulfill(hit); + }) + .catch(() => {}); + }); +} + +export const handleDownloadTool = new HandleDownloadTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/element-picker.ts b/app/chrome-extension/entrypoints/background/tools/browser/element-picker.ts new file mode 100644 index 00000000..76fe9ab6 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/element-picker.ts @@ -0,0 +1,557 @@ +/** + * Element Picker Tool + * + * Implements chrome_request_element_selection - a human-in-the-loop tool that allows + * users to manually select elements on the page when AI cannot reliably locate them. + */ + +import { createErrorResponse, type ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { BACKGROUND_MESSAGE_TYPES, TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { ERROR_MESSAGES } from '@/common/constants'; +import { + TOOL_NAMES, + type ElementPickerRequest, + type ElementPickerResult, + type ElementPickerResultItem, + type PickedElement, +} from 'chrome-mcp-shared'; + +// ============================================================ +// Types +// ============================================================ + +interface NormalizedRequest { + id: string; + name: string; + description?: string; +} + +interface ElementPickerToolParams { + requests: ElementPickerRequest[]; + timeoutMs?: number; + tabId?: number; + windowId?: number; +} + +interface PickerUiEvent { + type: string; + sessionId: string; + event: 'cancel' | 'confirm' | 'set_active_request' | 'clear_selection'; + requestId?: string; +} + +interface PickerFrameEvent { + type: string; + sessionId: string; + event: 'selected' | 'cancel'; + requestId?: string; + element?: Omit; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_TIMEOUT_MS = 3 * 60 * 1000; // 3 minutes +const MAX_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes +const MIN_TIMEOUT_MS = 10 * 1000; // 10 seconds + +// ============================================================ +// Utility Functions +// ============================================================ + +function toTrimmedString(value: unknown): string { + return typeof value === 'string' ? value.trim() : ''; +} + +function normalizeTimeoutMs(value: unknown): number { + if (value === undefined || value === null) return DEFAULT_TIMEOUT_MS; + const n = Number(value); + if (!Number.isFinite(n) || n <= 0) return DEFAULT_TIMEOUT_MS; + return Math.min(Math.max(Math.floor(n), MIN_TIMEOUT_MS), MAX_TIMEOUT_MS); +} + +function normalizeRequests(requests: ElementPickerRequest[]): NormalizedRequest[] { + const out: NormalizedRequest[] = []; + const seen = new Set(); + + for (let i = 0; i < requests.length; i++) { + const r = requests[i] || ({} as ElementPickerRequest); + const name = toTrimmedString(r.name); + if (!name) continue; + + // Generate or use provided ID, ensuring uniqueness + const baseId = toTrimmedString(r.id) || `req_${i + 1}`; + let id = baseId; + let suffix = 2; + while (seen.has(id)) { + id = `${baseId}_${suffix++}`; + } + seen.add(id); + + const description = toTrimmedString(r.description); + out.push({ id, name, description: description || undefined }); + } + + return out; +} + +function buildResultItems( + requests: NormalizedRequest[], + pickedById: Map, +): ElementPickerResultItem[] { + return requests.map((r) => ({ + id: r.id, + name: r.name, + element: pickedById.get(r.id) || null, + })); +} + +function listMissingRequestIds( + requests: NormalizedRequest[], + pickedById: Map, +): string[] { + const missing: string[] = []; + for (const r of requests) { + if (!pickedById.has(r.id)) missing.push(r.id); + } + return missing; +} + +// ============================================================ +// Element Picker Tool +// ============================================================ + +class ElementPickerTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.REQUEST_ELEMENT_SELECTION; + + /** + * Inject picker scripts into all frames of the tab. + */ + private async injectPickerScripts(tabId: number): Promise { + await chrome.scripting.executeScript({ + target: { tabId, allFrames: true }, + files: ['inject-scripts/element-picker.js'], + world: 'ISOLATED', + injectImmediately: false, + } as any); + } + + /** + * Call the picker API in all frames via scripting.executeScript. + */ + private async callPickerApi( + tabId: number, + method: 'startSession' | 'stopSession' | 'setActiveRequest', + payload: Record, + ): Promise { + await chrome.scripting.executeScript({ + target: { tabId, allFrames: true }, + world: 'ISOLATED', + injectImmediately: false, + func: (methodName: string, data: Record) => { + try { + const api = ( + globalThis as unknown as { + __mcpElementPicker?: Record) => void>; + } + ).__mcpElementPicker; + const fn = api && api[methodName]; + if (typeof fn === 'function') { + fn(data); + } + } catch { + // Best-effort + } + }, + args: [method, payload], + } as any); + } + + async execute(args: ElementPickerToolParams): Promise { + // Validate requests + const rawRequests = Array.isArray(args?.requests) ? args.requests : []; + if (rawRequests.length === 0) { + return createErrorResponse(`${ERROR_MESSAGES.INVALID_PARAMETERS}: requests[] is required`); + } + + const requests = normalizeRequests(rawRequests); + if (requests.length === 0) { + return createErrorResponse( + `${ERROR_MESSAGES.INVALID_PARAMETERS}: requests[] must contain at least one non-empty name`, + ); + } + + const timeoutMs = normalizeTimeoutMs(args?.timeoutMs); + const sessionId = `ep_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`; + const deadlineTs = Date.now() + timeoutMs; + + // Resolve tab + let tab: chrome.tabs.Tab; + try { + const explicit = await this.tryGetTab(args?.tabId); + tab = explicit || (await this.getActiveTabOrThrowInWindow(args?.windowId)); + } catch (error) { + return createErrorResponse( + `${ERROR_MESSAGES.TAB_NOT_FOUND}: ${error instanceof Error ? error.message : String(error)}`, + ); + } + if (!tab.id) { + return createErrorResponse(`${ERROR_MESSAGES.TAB_NOT_FOUND}: Active tab has no ID`); + } + const tabId = tab.id; + + // Focus the tab/window for user interaction + try { + await this.ensureFocus(tab, { activate: true, focusWindow: true }); + } catch { + // Best-effort: some environments disallow focusing + } + + // State tracking + const pickedById = new Map(); + let activeRequestId: string | null = requests[0]?.id || null; + let uiErrorMessage: string | null = null; + let uiAvailable = true; + + let finished = false; + let timer: ReturnType | null = null; + let resolveResult: ((result: ElementPickerResult) => void) | null = null; + + // Send UI update to content script + const sendUiUpdate = async (): Promise => { + if (!uiAvailable) return; + try { + const selections: Record = {}; + for (const r of requests) { + selections[r.id] = pickedById.get(r.id) || null; + } + await this.sendMessageToTab( + tabId, + { + action: TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_UPDATE, + sessionId, + activeRequestId, + selections, + deadlineTs, + errorMessage: uiErrorMessage, + }, + 0, // Top frame only for UI + ); + } catch { + uiAvailable = false; + } + }; + + // Set the active request and notify all frames + UI + const setActiveRequest = async (requestId: string | null): Promise => { + activeRequestId = requestId; + await this.callPickerApi(tabId, 'setActiveRequest', { + sessionId, + activeRequestId: requestId, + }); + await sendUiUpdate(); + }; + + // Finish the tool execution + const finish = async (final: { + success: boolean; + cancelled?: boolean; + timedOut?: boolean; + }): Promise => { + if (finished) return; + finished = true; + + if (timer !== null) { + clearTimeout(timer); + timer = null; + } + + chrome.runtime.onMessage.removeListener(onRuntimeMessage); + + // Cleanup: stop picker in all frames and hide UI + await Promise.allSettled([ + this.callPickerApi(tabId, 'stopSession', { sessionId }), + uiAvailable + ? this.sendMessageToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_HIDE, sessionId }, + 0, + ) + : Promise.resolve(), + ]); + + const missing = listMissingRequestIds(requests, pickedById); + const result: ElementPickerResult = { + success: final.success, + sessionId, + timeoutMs, + cancelled: final.cancelled, + timedOut: final.timedOut, + missingRequestIds: missing.length > 0 ? missing : undefined, + results: buildResultItems(requests, pickedById), + }; + + resolveResult?.(result); + }; + + // Handle messages from content scripts + const onRuntimeMessage = ( + message: unknown, + sender: chrome.runtime.MessageSender, + sendResponse: (response?: unknown) => void, + ): boolean | void => { + const senderTabId = sender?.tab?.id; + if (senderTabId !== tabId) return; + + const msg = message as Partial | undefined; + if (!msg || msg.sessionId !== sessionId) return; + + // Handle frame events (element selection) + if (msg.type === BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_FRAME_EVENT) { + if (msg.event === 'cancel') { + void finish({ success: false, cancelled: true }); + sendResponse?.({ success: true }); + return true; + } + + if (msg.event === 'selected') { + const requestId = toTrimmedString(msg.requestId); + const frameId = typeof sender.frameId === 'number' ? sender.frameId : 0; + + // Validate request ID + const reqExists = requestId && requests.some((r) => r.id === requestId); + if (!reqExists) { + sendResponse?.({ success: false, error: 'Unknown requestId' }); + return true; + } + + // Validate element data + const raw = (msg.element || {}) as Partial>; + const ref = toTrimmedString(raw.ref); + if (!ref) { + sendResponse?.({ success: false, error: 'Missing element.ref' }); + return true; + } + + // Build picked element with frameId + const selector = toTrimmedString(raw.selector); + const rect = raw.rect as PickedElement['rect'] | undefined; + const center = raw.center as PickedElement['center'] | undefined; + const picked: PickedElement = { + ref, + selector, + selectorType: 'css', + rect: rect && typeof rect === 'object' ? rect : { x: 0, y: 0, width: 0, height: 0 }, + center: center && typeof center === 'object' ? center : { x: 0, y: 0 }, + text: typeof raw.text === 'string' ? raw.text : undefined, + tagName: typeof raw.tagName === 'string' ? raw.tagName : undefined, + frameId, + }; + + pickedById.set(requestId, picked); + uiErrorMessage = null; + + // Auto-advance to next missing request + const missing = listMissingRequestIds(requests, pickedById); + const next = missing.length > 0 ? missing[0] : null; + + void (async () => { + try { + if (next) { + await setActiveRequest(next); + } else { + // All selected: update UI (user still needs to confirm) + await sendUiUpdate(); + // If UI is unavailable, auto-confirm + if (!uiAvailable) { + await finish({ success: true }); + } + } + } catch { + // Best-effort + } + })(); + + sendResponse?.({ success: true }); + return true; + } + } + + // Handle UI events (cancel, confirm, etc.) + if (msg.type === BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_UI_EVENT) { + if (msg.event === 'cancel') { + void finish({ success: false, cancelled: true }); + sendResponse?.({ success: true }); + return true; + } + + if (msg.event === 'confirm') { + const missing = listMissingRequestIds(requests, pickedById); + if (missing.length > 0) { + uiErrorMessage = `Please select all elements: missing ${missing.join(', ')}`; + void sendUiUpdate(); + sendResponse?.({ success: false, error: 'missing_selections', missing }); + return true; + } + void finish({ success: true }); + sendResponse?.({ success: true }); + return true; + } + + if (msg.event === 'set_active_request') { + const requestId = toTrimmedString(msg.requestId); + if (!requestId || !requests.some((r) => r.id === requestId)) { + sendResponse?.({ success: false, error: 'Unknown requestId' }); + return true; + } + void setActiveRequest(requestId); + sendResponse?.({ success: true }); + return true; + } + + if (msg.event === 'clear_selection') { + const requestId = toTrimmedString(msg.requestId); + if (!requestId || !requests.some((r) => r.id === requestId)) { + sendResponse?.({ success: false, error: 'Unknown requestId' }); + return true; + } + pickedById.delete(requestId); + uiErrorMessage = null; + void setActiveRequest(requestId); + sendResponse?.({ success: true }); + return true; + } + } + + return; + }; + + try { + // Step 1: Ensure UI content script is ready (ping + inject fallback) + const ensureUiReady = async (): Promise => { + // Try to ping UI content script with retries + const pingWithTimeout = async (timeoutMs = 500): Promise => { + try { + const resp = await Promise.race([ + this.sendMessageToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_PING }, + 0, + ), + new Promise((_, reject) => + setTimeout(() => reject(new Error('Ping timeout')), timeoutMs), + ), + ]); + return resp?.success === true; + } catch { + return false; + } + }; + + // First ping attempt (content script may already be loaded) + if (await pingWithTimeout()) return true; + + // Try to inject UI content script as fallback + // Try multiple possible paths (production vs dev builds) + const possiblePaths = ['content-scripts/element-picker.js', 'element-picker.js']; + + for (const path of possiblePaths) { + try { + await chrome.scripting.executeScript({ + target: { tabId, frameIds: [0] }, + files: [path], + injectImmediately: true, + } as any); + // Wait a bit for script to initialize + await new Promise((r) => setTimeout(r, 150)); + // Check if injection worked + if (await pingWithTimeout(300)) return true; + } catch (e) { + // Try next path + console.debug(`[ElementPicker] Path ${path} failed:`, e); + } + } + + // Final attempt with longer timeout (in case of slow page) + return pingWithTimeout(1000); + }; + + const uiReady = await ensureUiReady(); + if (!uiReady) { + console.error('[ElementPicker] UI not available after all attempts'); + return createErrorResponse( + `${ERROR_MESSAGES.TOOL_EXECUTION_FAILED}: Element Picker UI is not available. This may happen if: (1) The page blocks content scripts, (2) You're using dev mode - try restarting the dev server or use production build, (3) The page needs to be refreshed.`, + ); + } + + // Step 2: Show UI in top frame (must receive success:true) + try { + const showResp = await this.sendMessageToTab( + tabId, + { + action: TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_SHOW, + sessionId, + requests, + activeRequestId, + deadlineTs, + }, + 0, + ); + if (showResp?.success !== true) { + throw new Error('UI did not acknowledge show message'); + } + } catch (e) { + console.error('[ElementPicker] UI show failed:', e); + return createErrorResponse( + `${ERROR_MESSAGES.TOOL_EXECUTION_FAILED}: Failed to show Element Picker UI. Please refresh the page and try again.`, + ); + } + + // Step 3: Inject picker scripts and start selection engine in all frames + await this.injectPickerScripts(tabId); + await this.callPickerApi(tabId, 'startSession', { sessionId, activeRequestId }); + + // Register message listener + chrome.runtime.onMessage.addListener(onRuntimeMessage); + + // Create result promise + const resultPromise = new Promise((resolve) => { + resolveResult = resolve; + }); + + // Set timeout + timer = setTimeout(() => { + void finish({ success: false, timedOut: true }); + }, timeoutMs); + + // Initial UI update + void sendUiUpdate(); + + // Wait for result + const result = await resultPromise; + return { content: [{ type: 'text', text: JSON.stringify(result) }], isError: false }; + } catch (error) { + console.error('Error in element picker tool:', error); + // Cleanup on error + try { + await Promise.allSettled([ + this.callPickerApi(tabId, 'stopSession', { sessionId }), + this.sendMessageToTab( + tabId, + { action: TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_HIDE, sessionId }, + 0, + ), + ]); + } catch { + // Best-effort cleanup + } + return createErrorResponse( + `${ERROR_MESSAGES.TOOL_EXECUTION_FAILED}: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } +} + +export const elementPickerTool = new ElementPickerTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/file-upload.ts b/app/chrome-extension/entrypoints/background/tools/browser/file-upload.ts index 7e3caf12..25ed43dd 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/file-upload.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/file-upload.ts @@ -1,6 +1,7 @@ import { createErrorResponse, ToolResult } from '@/common/tool-handler'; import { BaseBrowserToolExecutor } from '../base-browser'; import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; interface FileUploadToolParams { selector: string; // CSS selector for the file input element @@ -9,6 +10,8 @@ interface FileUploadToolParams { base64Data?: string; // Base64 encoded file data fileName?: string; // Optional filename when using base64 or URL multiple?: boolean; // Whether to allow multiple files + tabId?: number; // Target existing tab id + windowId?: number; // When no tabId, pick active tab from this window } /** @@ -17,16 +20,8 @@ interface FileUploadToolParams { */ class FileUploadTool extends BaseBrowserToolExecutor { name = TOOL_NAMES.BROWSER.FILE_UPLOAD; - private activeDebuggers: Map = new Map(); - constructor() { super(); - // Clean up debuggers on tab removal - chrome.tabs.onRemoved.addListener((tabId) => { - if (this.activeDebuggers.has(tabId)) { - this.cleanupDebugger(tabId); - } - }); } /** @@ -43,20 +38,15 @@ class FileUploadTool extends BaseBrowserToolExecutor { } if (!filePath && !fileUrl && !base64Data) { - return createErrorResponse( - 'One of filePath, fileUrl, or base64Data must be provided', - ); + return createErrorResponse('One of filePath, fileUrl, or base64Data must be provided'); } - let tabId: number | undefined; - try { - // Get current tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); - if (!tabs[0]?.id) { - return createErrorResponse('No active tab found'); - } - tabId = tabs[0].id; + // Resolve tab + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); + if (!tab.id) return createErrorResponse('No active tab found'); + const tabId = tab.id; // Prepare file paths let files: string[] = []; @@ -78,75 +68,59 @@ class FileUploadTool extends BaseBrowserToolExecutor { files = [tempFilePath]; } - // Attach debugger to the tab - await this.attachDebugger(tabId); + // Use shared CDP session manager to attach/do work/detach safely + await cdpSessionManager.withSession(tabId, 'file-upload', async () => { + // Enable necessary CDP domains + await cdpSessionManager.sendCommand(tabId, 'DOM.enable', {}); + await cdpSessionManager.sendCommand(tabId, 'Runtime.enable', {}); - // Enable necessary CDP domains - await chrome.debugger.sendCommand({ tabId }, 'DOM.enable', {}); - await chrome.debugger.sendCommand({ tabId }, 'Runtime.enable', {}); + // Get the document + const { root } = (await cdpSessionManager.sendCommand(tabId, 'DOM.getDocument', { + depth: -1, + pierce: true, + })) as { root: { nodeId: number } }; - // Get the document - const { root } = await chrome.debugger.sendCommand( - { tabId }, - 'DOM.getDocument', - { depth: -1, pierce: true }, - ) as { root: { nodeId: number } }; - - // Find the file input element using the selector - const { nodeId } = await chrome.debugger.sendCommand( - { tabId }, - 'DOM.querySelector', - { + // Find the file input element using the selector + const { nodeId } = (await cdpSessionManager.sendCommand(tabId, 'DOM.querySelector', { nodeId: root.nodeId, selector: selector, - }, - ) as { nodeId: number }; + })) as { nodeId: number }; - if (!nodeId || nodeId === 0) { - throw new Error(`Element with selector "${selector}" not found`); - } + if (!nodeId || nodeId === 0) { + throw new Error(`Element with selector "${selector}" not found`); + } - // Verify it's actually a file input - const { node } = await chrome.debugger.sendCommand( - { tabId }, - 'DOM.describeNode', - { nodeId }, - ) as { node: { nodeName: string; attributes?: string[] } }; + // Verify it's actually a file input + const { node } = (await cdpSessionManager.sendCommand(tabId, 'DOM.describeNode', { + nodeId, + })) as { node: { nodeName: string; attributes?: string[] } }; - if (node.nodeName !== 'INPUT') { - throw new Error(`Element with selector "${selector}" is not an input element`); - } + if (node.nodeName !== 'INPUT') { + throw new Error(`Element with selector "${selector}" is not an input element`); + } - // Check if it's a file input by looking for type="file" in attributes - const attributes = node.attributes || []; - let isFileInput = false; - for (let i = 0; i < attributes.length; i += 2) { - if (attributes[i] === 'type' && attributes[i + 1] === 'file') { - isFileInput = true; - break; + // Check if it's a file input by looking for type="file" in attributes + const attributes = node.attributes || []; + let isFileInput = false; + for (let i = 0; i < attributes.length; i += 2) { + if (attributes[i] === 'type' && attributes[i + 1] === 'file') { + isFileInput = true; + break; + } } - } - if (!isFileInput) { - throw new Error(`Element with selector "${selector}" is not a file input (type="file")`); - } + if (!isFileInput) { + throw new Error(`Element with selector "${selector}" is not a file input (type="file")`); + } - // Set the files on the input element - // This is the key CDP command that Playwright and Puppeteer use - await chrome.debugger.sendCommand( - { tabId }, - 'DOM.setFileInputFiles', - { - nodeId: nodeId, - files: files, - }, - ); + // Set the files on the input element + await cdpSessionManager.sendCommand(tabId, 'DOM.setFileInputFiles', { + nodeId, + files, + }); - // Trigger change event to ensure the page reacts to the file upload - await chrome.debugger.sendCommand( - { tabId }, - 'Runtime.evaluate', - { + // Trigger change event to ensure the page reacts to the file upload + await cdpSessionManager.sendCommand(tabId, 'Runtime.evaluate', { expression: ` (function() { const element = document.querySelector('${selector.replace(/'/g, "\\'")}'); @@ -158,11 +132,8 @@ class FileUploadTool extends BaseBrowserToolExecutor { return false; })() `, - }, - ); - - // Clean up debugger - await this.detachDebugger(tabId); + }); + }); return { content: [ @@ -181,11 +152,8 @@ class FileUploadTool extends BaseBrowserToolExecutor { }; } catch (error) { console.error('Error in file upload operation:', error); - - // Clean up debugger if attached - if (tabId !== undefined && this.activeDebuggers.has(tabId)) { - await this.detachDebugger(tabId); - } + + // Session manager handles detach; nothing extra needed here return createErrorResponse( `Error uploading file: ${error instanceof Error ? error.message : String(error)}`, @@ -193,58 +161,7 @@ class FileUploadTool extends BaseBrowserToolExecutor { } } - /** - * Attach debugger to a tab - */ - private async attachDebugger(tabId: number): Promise { - // Check if debugger is already attached - const targets = await chrome.debugger.getTargets(); - const existingTarget = targets.find( - (t) => t.tabId === tabId && t.attached, - ); - - if (existingTarget) { - if (existingTarget.extensionId === chrome.runtime.id) { - // Our extension already attached - console.log('Debugger already attached by this extension'); - return; - } else { - throw new Error( - 'Debugger is already attached to this tab by another extension or DevTools', - ); - } - } - - // Attach debugger - await chrome.debugger.attach({ tabId }, '1.3'); - this.activeDebuggers.set(tabId, true); - console.log(`Debugger attached to tab ${tabId}`); - } - - /** - * Detach debugger from a tab - */ - private async detachDebugger(tabId: number): Promise { - if (!this.activeDebuggers.has(tabId)) { - return; - } - - try { - await chrome.debugger.detach({ tabId }); - console.log(`Debugger detached from tab ${tabId}`); - } catch (error) { - console.warn(`Error detaching debugger from tab ${tabId}:`, error); - } finally { - this.activeDebuggers.delete(tabId); - } - } - - /** - * Clean up debugger connection - */ - private cleanupDebugger(tabId: number): void { - this.activeDebuggers.delete(tabId); - } + // All debugger attach/detach is centrally managed by cdpSessionManager /** * Prepare file from URL or base64 data using native messaging host @@ -265,15 +182,20 @@ class FileUploadTool extends BaseBrowserToolExecutor { // Create listener for the response const handleMessage = (message: any) => { - if (message.type === 'file_operation_response' && - message.responseToRequestId === requestId) { + if ( + message.type === 'file_operation_response' && + message.responseToRequestId === requestId + ) { clearTimeout(timeout); chrome.runtime.onMessage.removeListener(handleMessage); - + if (message.payload?.success && message.payload?.filePath) { resolve(message.payload.filePath); } else { - console.error('Native host failed to prepare file:', message.error || message.payload?.error); + console.error( + 'Native host failed to prepare file:', + message.error || message.payload?.error, + ); resolve(null); } } @@ -283,26 +205,28 @@ class FileUploadTool extends BaseBrowserToolExecutor { chrome.runtime.onMessage.addListener(handleMessage); // Send message to background script to forward to native host - chrome.runtime.sendMessage({ - type: 'forward_to_native', - message: { - type: 'file_operation', - requestId: requestId, - payload: { - action: 'prepareFile', - fileUrl, - base64Data, - fileName, + chrome.runtime + .sendMessage({ + type: 'forward_to_native', + message: { + type: 'file_operation', + requestId: requestId, + payload: { + action: 'prepareFile', + fileUrl, + base64Data, + fileName, + }, }, - }, - }).catch((error) => { - console.error('Error sending message to background:', error); - clearTimeout(timeout); - chrome.runtime.onMessage.removeListener(handleMessage); - resolve(null); - }); + }) + .catch((error) => { + console.error('Error sending message to background:', error); + clearTimeout(timeout); + chrome.runtime.onMessage.removeListener(handleMessage); + resolve(null); + }); }); } } -export const fileUploadTool = new FileUploadTool(); \ No newline at end of file +export const fileUploadTool = new FileUploadTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/gif-auto-capture.ts b/app/chrome-extension/entrypoints/background/tools/browser/gif-auto-capture.ts new file mode 100644 index 00000000..0e3d8fbb --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/gif-auto-capture.ts @@ -0,0 +1,520 @@ +/** + * GIF Auto-Capture Hook System + * + * Provides automatic frame capture for GIF recording when browser actions succeed. + * Tools like chrome_computer and chrome_navigate can trigger frame captures + * after successful operations, creating smooth recordings of user interactions. + * + * Architecture: + * - Centralized capture manager with per-tab recording state + * - Hooks can be registered/unregistered per tab + * - Configurable capture delay for UI stabilization + * - Enhanced rendering overlays (click indicators, drag paths, labels) + */ + +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { OFFSCREEN_MESSAGE_TYPES, MessageTarget } from '@/common/message-types'; +import { offscreenManager } from '@/utils/offscreen-manager'; +import { createImageBitmapFromUrl } from '@/utils/image-utils'; +import { + pruneActionEventsInPlace, + renderGifEnhancedOverlays, + resolveCapturePlanForAction, + resolveGifEnhancedRenderingConfig, + type ActionEvent, + type ActionMetadata, + type ActionType, + type GifEnhancedRenderingConfig, + type ResolvedGifEnhancedRenderingConfig, +} from './gif-enhanced-renderer'; + +// Re-export types for consumers +export type { + ActionMetadata, + ActionType, + GifEnhancedRenderingConfig, +} from './gif-enhanced-renderer'; + +// ============================================================================ +// Constants +// ============================================================================ + +const CDP_SESSION_KEY = 'gif-auto-capture'; +const DEFAULT_CAPTURE_DELAY_MS = 150; +const DEFAULT_WIDTH = 800; +const DEFAULT_HEIGHT = 600; +const DEFAULT_FRAME_DELAY_CS = 20; // 20 centiseconds = 200ms per frame +const DEFAULT_MAX_COLORS = 256; + +// ============================================================================ +// Types +// ============================================================================ + +export interface AutoCaptureConfig { + width: number; + height: number; + maxColors: number; + frameDelayCs: number; + captureDelayMs: number; + maxFrames: number; + enhancedRendering?: GifEnhancedRenderingConfig; +} + +interface TabCaptureState { + tabId: number; + config: AutoCaptureConfig; + rendering: ResolvedGifEnhancedRenderingConfig; + frameCount: number; + startTime: number; + canvas: OffscreenCanvas; + ctx: OffscreenCanvasRenderingContext2D; + pendingCapture: Promise | null; + actions: ActionMetadata[]; + actionEvents: ActionEvent[]; + lastViewportWidth: number; + lastViewportHeight: number; +} + +// ============================================================================ +// State Management +// ============================================================================ + +const tabStates = new Map(); + +// ============================================================================ +// Utilities +// ============================================================================ + +function sleep(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +function normalizeActionMetadata(action: ActionMetadata, atMs: number): ActionMetadata { + const normalized: ActionMetadata = { + ...action, + timestampMs: atMs, + coordinateSpace: action.coordinateSpace ?? 'viewport', + }; + + // For drag, treat `coordinates` as end position (legacy) and also populate `endCoordinates` + if (normalized.type === 'drag') { + const end = normalized.endCoordinates ?? normalized.coordinates; + if (end) { + normalized.endCoordinates = end; + normalized.coordinates = end; + } + } + + return normalized; +} + +// ============================================================================ +// Offscreen Communication +// ============================================================================ + +async function sendToOffscreen( + type: string, + payload: Record = {}, +): Promise { + await offscreenManager.ensureOffscreenDocument(); + + const response = (await chrome.runtime.sendMessage({ + target: MessageTarget.Offscreen, + type, + ...payload, + })) as T | undefined; + + if (!response) { + throw new Error('No response from offscreen document'); + } + if (!response.success) { + throw new Error(response.error || 'Unknown offscreen error'); + } + + return response; +} + +// ============================================================================ +// Frame Capture +// ============================================================================ + +async function captureFrameData(tabId: number, state: TabCaptureState): Promise { + const width = state.config.width; + const height = state.config.height; + const ctx = state.ctx; + + // Get viewport metrics + const metrics: { layoutViewport?: { clientWidth: number; clientHeight: number } } = + await cdpSessionManager.sendCommand(tabId, 'Page.getLayoutMetrics', {}); + + const viewportWidth = metrics.layoutViewport?.clientWidth || width; + const viewportHeight = metrics.layoutViewport?.clientHeight || height; + + // Store viewport dimensions for coordinate projection + state.lastViewportWidth = viewportWidth; + state.lastViewportHeight = viewportHeight; + + // Capture screenshot + const screenshot: { data: string } = await cdpSessionManager.sendCommand( + tabId, + 'Page.captureScreenshot', + { + format: 'png', + clip: { + x: 0, + y: 0, + width: viewportWidth, + height: viewportHeight, + scale: 1, + }, + }, + ); + + const imageBitmap = await createImageBitmapFromUrl(`data:image/png;base64,${screenshot.data}`); + + // Scale to target dimensions + ctx.clearRect(0, 0, width, height); + ctx.drawImage(imageBitmap, 0, 0, width, height); + imageBitmap.close(); + + // Apply enhanced rendering overlays + if (state.rendering.enabled) { + const nowMs = Date.now(); + renderGifEnhancedOverlays({ + ctx, + outputWidth: width, + outputHeight: height, + viewportWidth, + viewportHeight, + nowMs, + events: state.actionEvents, + config: state.rendering, + }); + pruneActionEventsInPlace(state.actionEvents, nowMs, state.rendering); + } + + return ctx.getImageData(0, 0, width, height).data; +} + +// ============================================================================ +// Public API +// ============================================================================ + +/** + * Start auto-capture for a tab. This initializes the GIF encoder + * and prepares for automatic frame capture on tool actions. + */ +export async function startAutoCapture( + tabId: number, + config?: Partial, +): Promise<{ success: boolean; error?: string }> { + if (tabStates.has(tabId)) { + return { success: false, error: 'Auto-capture already active for this tab' }; + } + + const finalConfig: AutoCaptureConfig = { + width: config?.width ?? DEFAULT_WIDTH, + height: config?.height ?? DEFAULT_HEIGHT, + maxColors: config?.maxColors ?? DEFAULT_MAX_COLORS, + frameDelayCs: config?.frameDelayCs ?? DEFAULT_FRAME_DELAY_CS, + captureDelayMs: config?.captureDelayMs ?? DEFAULT_CAPTURE_DELAY_MS, + maxFrames: config?.maxFrames ?? 100, + enhancedRendering: config?.enhancedRendering, + }; + + try { + // Attach CDP session + await cdpSessionManager.attach(tabId, CDP_SESSION_KEY); + + // Reset offscreen encoder + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_RESET, {}); + + // Create canvas + if (typeof OffscreenCanvas === 'undefined') { + throw new Error('OffscreenCanvas not available'); + } + + const canvas = new OffscreenCanvas(finalConfig.width, finalConfig.height); + const ctx = canvas.getContext('2d'); + if (!ctx) { + throw new Error('Failed to get canvas context'); + } + + const state: TabCaptureState = { + tabId, + config: finalConfig, + rendering: resolveGifEnhancedRenderingConfig(finalConfig.enhancedRendering), + frameCount: 0, + startTime: Date.now(), + canvas, + ctx, + pendingCapture: null, + actions: [], + actionEvents: [], + lastViewportWidth: finalConfig.width, + lastViewportHeight: finalConfig.height, + }; + + tabStates.set(tabId, state); + + return { success: true }; + } catch (error) { + // Cleanup on failure + try { + await cdpSessionManager.detach(tabId, CDP_SESSION_KEY); + } catch { + // Ignore + } + + return { + success: false, + error: error instanceof Error ? error.message : String(error), + }; + } +} + +/** + * Stop auto-capture and finalize the GIF. + * Returns the GIF data for saving/downloading. + */ +export async function stopAutoCapture(tabId: number): Promise<{ + success: boolean; + gifData?: Uint8Array; + frameCount?: number; + durationMs?: number; + actions?: ActionMetadata[]; + error?: string; +}> { + const state = tabStates.get(tabId); + if (!state) { + return { success: false, error: 'No auto-capture active for this tab' }; + } + + try { + // Wait for any pending capture + if (state.pendingCapture) { + await state.pendingCapture; + } + + const frameCount = state.frameCount; + const durationMs = Date.now() - state.startTime; + const actions = [...state.actions]; + + if (frameCount === 0) { + return { + success: false, + error: 'No frames captured', + frameCount: 0, + durationMs, + actions, + }; + } + + // Finalize GIF + const response = await sendToOffscreen<{ + success: boolean; + gifData?: number[]; + byteLength?: number; + error?: string; + }>(OFFSCREEN_MESSAGE_TYPES.GIF_FINISH, {}); + + if (!response.gifData || response.gifData.length === 0) { + return { + success: false, + error: 'Failed to encode GIF', + frameCount, + durationMs, + actions, + }; + } + + return { + success: true, + gifData: new Uint8Array(response.gifData), + frameCount, + durationMs, + actions, + }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : String(error), + }; + } finally { + // Cleanup + tabStates.delete(tabId); + try { + await cdpSessionManager.detach(tabId, CDP_SESSION_KEY); + } catch { + // Ignore + } + } +} + +/** + * Check if auto-capture is active for a tab. + */ +export function isAutoCaptureActive(tabId: number): boolean { + return tabStates.has(tabId); +} + +/** + * Get current auto-capture status for a tab. + */ +export function getAutoCaptureStatus(tabId: number): { + active: boolean; + frameCount?: number; + durationMs?: number; + actionsCount?: number; + enhancedRenderingEnabled?: boolean; +} { + const state = tabStates.get(tabId); + if (!state) { + return { active: false }; + } + + return { + active: true, + frameCount: state.frameCount, + durationMs: Date.now() - state.startTime, + actionsCount: state.actions.length, + enhancedRenderingEnabled: state.rendering.enabled, + }; +} + +/** + * Trigger a frame capture after a successful action. + * This is the main hook that tools should call. + * + * @param tabId - The tab to capture + * @param action - Optional action metadata for overlay rendering + * @param immediate - If true, capture immediately without delay + */ +export async function captureFrameOnAction( + tabId: number, + action?: ActionMetadata, + immediate = false, +): Promise<{ success: boolean; frameNumber?: number; error?: string }> { + const state = tabStates.get(tabId); + if (!state) { + // No auto-capture active - silently succeed (tools shouldn't fail because recording isn't active) + return { success: true }; + } + + // Check frame limit + if (state.frameCount >= state.config.maxFrames) { + return { success: false, error: 'Max frame limit reached' }; + } + + // Wait for any pending capture to complete + if (state.pendingCapture) { + try { + await state.pendingCapture; + } catch { + // Ignore errors from previous capture + } + } + + // Verify state still exists (might have been stopped while awaiting) + const currentState = tabStates.get(tabId); + if (!currentState) { + return { success: true }; + } + + // Calculate delay for UI stabilization + const delayMs = immediate ? 0 : currentState.config.captureDelayMs; + + // Normalize and record action metadata + let normalizedAction: ActionMetadata | undefined; + if (action) { + const atMs = Date.now() + delayMs; + normalizedAction = normalizeActionMetadata(action, atMs); + currentState.actions.push(normalizedAction); + currentState.actionEvents.push({ action: normalizedAction, atMs }); + } + + // Determine capture plan (may involve multiple frames for click animations) + const plan = resolveCapturePlanForAction( + currentState.rendering, + normalizedAction, + currentState.config.frameDelayCs, + ); + + const capturePromise = (async () => { + if (delayMs > 0) await sleep(delayMs); + + for (let i = 0; i < plan.frames; i++) { + const activeState = tabStates.get(tabId); + if (!activeState) return; + + if (activeState.frameCount >= activeState.config.maxFrames) return; + + try { + const frameData = await captureFrameData(tabId, activeState); + + // Use animation delay for intermediate frames, regular delay for final frame + const delayCs = i < plan.frames - 1 ? plan.delayCs : activeState.config.frameDelayCs; + + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME, { + imageData: Array.from(frameData), + width: activeState.config.width, + height: activeState.config.height, + delay: delayCs, + maxColors: activeState.config.maxColors, + }); + + activeState.frameCount += 1; + } catch (error) { + console.error('[GIF Auto-Capture] Frame capture failed:', error); + return; + } + + // Wait between animation frames + if (i < plan.frames - 1 && plan.intervalMs > 0) { + await sleep(plan.intervalMs); + } + } + })(); + + state.pendingCapture = capturePromise; + + try { + await capturePromise; + return { success: true, frameNumber: state.frameCount }; + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : String(error), + }; + } finally { + // Clean up reference to avoid holding completed Promise + const currentState = tabStates.get(tabId); + if (currentState?.pendingCapture === capturePromise) { + currentState.pendingCapture = null; + } + } +} + +/** + * Capture an initial frame immediately (useful for recording start state). + */ +export async function captureInitialFrame( + tabId: number, +): Promise<{ success: boolean; error?: string }> { + return captureFrameOnAction(tabId, undefined, true); +} + +/** + * Clear all auto-capture state (useful for cleanup). + */ +export async function clearAllAutoCapture(): Promise { + const tabIds = Array.from(tabStates.keys()); + for (const tabId of tabIds) { + try { + await stopAutoCapture(tabId); + } catch { + // Ignore errors during cleanup + tabStates.delete(tabId); + } + } +} diff --git a/app/chrome-extension/entrypoints/background/tools/browser/gif-enhanced-renderer.ts b/app/chrome-extension/entrypoints/background/tools/browser/gif-enhanced-renderer.ts new file mode 100644 index 00000000..04cbd918 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/gif-enhanced-renderer.ts @@ -0,0 +1,834 @@ +/** + * GIF Enhanced Renderer + * + * Draws visual affordances (click indicators, drag paths, labels) onto a canvas + * before encoding frames. This keeps the offscreen document focused on encoding + * while the background capture pipeline handles compositing. + * + * Coordinates are expected to be in viewport CSS pixels. If a caller provides + * screenshot-space coordinates, it should convert them to viewport space first. + */ + +// ============================================================================ +// Types +// ============================================================================ + +export type ActionType = + | 'click' + | 'double_click' + | 'triple_click' + | 'right_click' + | 'drag' + | 'scroll' + | 'type' + | 'key' + | 'navigate' + | 'hover' + | 'fill' + | 'annotation' + | 'other'; + +export type CoordinateSpace = 'viewport' | 'screenshot'; + +export interface Point { + x: number; + y: number; +} + +export interface ActionMetadata { + type: ActionType; + coordinates?: Point; + startCoordinates?: Point; + endCoordinates?: Point; + text?: string; + url?: string; + ref?: string; + + // Enhanced rendering hints + label?: string; + coordinateSpace?: CoordinateSpace; + timestampMs?: number; +} + +export interface GifEnhancedRenderingConfig { + enabled?: boolean; + + clickIndicators?: { + enabled?: boolean; + color?: string; + fillColor?: string; + radiusPx?: number; + lineWidthPx?: number; + durationMs?: number; + // Capture-side animation hints (auto-capture mode only) + animationFrames?: number; + animationIntervalMs?: number; + animationFrameDelayCs?: number; + }; + + dragPaths?: { + enabled?: boolean; + color?: string; + lineWidthPx?: number; + durationMs?: number; + arrowSizePx?: number; + dash?: number[]; + startDotRadiusPx?: number; + endDotRadiusPx?: number; + }; + + labels?: { + enabled?: boolean; + mode?: 'action' | 'annotation' | 'both'; + showForClicks?: boolean; + font?: string; + maxLength?: number; + durationMs?: number; + backgroundColor?: string; + borderColor?: string; + textColor?: string; + paddingX?: number; + paddingY?: number; + radiusPx?: number; + offsetPx?: number; + }; +} + +// ============================================================================ +// Resolved Config Types +// ============================================================================ + +export interface ResolvedClickIndicatorConfig { + enabled: boolean; + color: string; + fillColor: string; + radiusPx: number; + lineWidthPx: number; + durationMs: number; + animationFrames: number; + animationIntervalMs: number; + animationFrameDelayCs: number; +} + +export interface ResolvedDragPathConfig { + enabled: boolean; + color: string; + lineWidthPx: number; + durationMs: number; + arrowSizePx: number; + dash: number[]; + startDotRadiusPx: number; + endDotRadiusPx: number; +} + +export interface ResolvedLabelsConfig { + enabled: boolean; + mode: 'action' | 'annotation' | 'both'; + showForClicks: boolean; + font: string; + maxLength: number; + durationMs: number; + backgroundColor: string; + borderColor: string; + textColor: string; + paddingX: number; + paddingY: number; + radiusPx: number; + offsetPx: number; +} + +export interface ResolvedGifEnhancedRenderingConfig { + enabled: boolean; + clickIndicators: ResolvedClickIndicatorConfig; + dragPaths: ResolvedDragPathConfig; + labels: ResolvedLabelsConfig; +} + +export interface ActionEvent { + action: ActionMetadata; + atMs: number; +} + +export interface CapturePlan { + frames: number; + intervalMs: number; + delayCs: number; +} + +export interface RenderGifEnhancedOverlaysParams { + ctx: OffscreenCanvasRenderingContext2D; + outputWidth: number; + outputHeight: number; + viewportWidth: number; + viewportHeight: number; + nowMs: number; + events: readonly ActionEvent[]; + config: ResolvedGifEnhancedRenderingConfig; +} + +// ============================================================================ +// Constants +// ============================================================================ + +const CLICK_ACTIONS: readonly ActionType[] = [ + 'click', + 'double_click', + 'triple_click', + 'right_click', +]; + +// ============================================================================ +// Utility Functions +// ============================================================================ + +function clamp(value: number, min: number, max: number): number { + return Math.min(max, Math.max(min, value)); +} + +function normalizePositiveNumber( + value: unknown, + fallback: number, + min: number, + max: number, +): number { + if (typeof value !== 'number' || !Number.isFinite(value)) return fallback; + return clamp(value, min, max); +} + +function normalizePositiveInt(value: unknown, fallback: number, min: number, max: number): number { + if (typeof value !== 'number' || !Number.isFinite(value)) return fallback; + return clamp(Math.floor(value), min, max); +} + +function normalizeDash(value: unknown, fallback: number[]): number[] { + if (!Array.isArray(value)) return fallback; + const nums = value.filter((n) => typeof n === 'number' && Number.isFinite(n) && n > 0); + return nums.length >= 2 ? (nums as number[]) : fallback; +} + +function easeOutCubic(t: number): number { + const x = clamp(t, 0, 1); + return 1 - Math.pow(1 - x, 3); +} + +function projectPoint( + point: Point, + viewportWidth: number, + viewportHeight: number, + outputWidth: number, + outputHeight: number, +): Point | null { + if ( + typeof point.x !== 'number' || + typeof point.y !== 'number' || + !Number.isFinite(point.x) || + !Number.isFinite(point.y) + ) { + return null; + } + + const vw = viewportWidth > 0 ? viewportWidth : outputWidth; + const vh = viewportHeight > 0 ? viewportHeight : outputHeight; + + return { + x: (point.x / vw) * outputWidth, + y: (point.y / vh) * outputHeight, + }; +} + +function buildRoundedRectPath( + ctx: OffscreenCanvasRenderingContext2D, + x: number, + y: number, + width: number, + height: number, + radius: number, +): void { + const r = Math.max(0, Math.min(radius, Math.min(width, height) / 2)); + const x2 = x + width; + const y2 = y + height; + + ctx.moveTo(x + r, y); + ctx.arcTo(x2, y, x2, y2, r); + ctx.arcTo(x2, y2, x, y2, r); + ctx.arcTo(x, y2, x, y, r); + ctx.arcTo(x, y, x2, y, r); +} + +function truncate(text: string, maxLength: number): string { + const trimmed = text.trim(); + if (trimmed.length <= maxLength) return trimmed; + return `${trimmed.slice(0, Math.max(0, maxLength - 1))}…`; +} + +// ============================================================================ +// Label Resolution +// ============================================================================ + +function resolveActionLabel(action: ActionMetadata, cfg: ResolvedLabelsConfig): string | null { + const explicit = typeof action.label === 'string' ? action.label.trim() : ''; + const isExplicit = explicit.length > 0; + + const mode = cfg.mode; + const canShowAction = mode === 'action' || mode === 'both'; + const canShowAnnotation = mode === 'annotation' || mode === 'both'; + + if ((action.type === 'annotation' || isExplicit) && canShowAnnotation) { + const labelText = explicit || (typeof action.text === 'string' ? action.text.trim() : ''); + return labelText.length > 0 ? truncate(labelText, cfg.maxLength) : null; + } + + if (!canShowAction) return null; + + switch (action.type) { + case 'click': + case 'double_click': + case 'triple_click': + case 'right_click': + if (!cfg.showForClicks) return null; + return action.type.replace('_', ' ').toUpperCase(); + case 'drag': + return 'DRAG'; + case 'scroll': + return 'SCROLL'; + case 'hover': + return 'HOVER'; + case 'navigate': { + if (!action.url) return 'NAVIGATE'; + try { + const host = new URL(action.url).hostname; + return host ? `→ ${host}` : 'NAVIGATE'; + } catch { + return 'NAVIGATE'; + } + } + case 'type': { + const content = typeof action.text === 'string' ? action.text : ''; + return content.trim().length > 0 ? `TYPE "${truncate(content, cfg.maxLength)}"` : 'TYPE'; + } + case 'key': { + const content = typeof action.text === 'string' ? action.text : ''; + return content.trim().length > 0 ? `KEY [${truncate(content, cfg.maxLength)}]` : 'KEY'; + } + case 'fill': { + const content = typeof action.text === 'string' ? action.text : ''; + return content.trim().length > 0 ? `FILL "${truncate(content, cfg.maxLength)}"` : 'FILL'; + } + default: + return null; + } +} + +function resolveAnchorPoint(action: ActionMetadata): Point | null { + if (action.type === 'drag') { + return action.endCoordinates || action.coordinates || action.startCoordinates || null; + } + return action.coordinates || action.endCoordinates || action.startCoordinates || null; +} + +// ============================================================================ +// Drawing Functions +// ============================================================================ + +function drawClickIndicator( + ctx: OffscreenCanvasRenderingContext2D, + x: number, + y: number, + progress: number, + type: ActionType, + cfg: ResolvedClickIndicatorConfig, +): void { + const t = clamp(progress, 0, 1); + const eased = easeOutCubic(t); + + const base = cfg.radiusPx; + const radius = base * (0.35 + 0.95 * eased); + const alpha = 1 - eased; + + ctx.save(); + ctx.globalAlpha = alpha; + + ctx.lineWidth = cfg.lineWidthPx; + ctx.strokeStyle = cfg.color; + ctx.fillStyle = cfg.fillColor; + + ctx.shadowColor = 'rgba(0, 0, 0, 0.25)'; + ctx.shadowBlur = 8; + + ctx.beginPath(); + ctx.arc(x, y, radius, 0, Math.PI * 2); + ctx.stroke(); + + ctx.shadowBlur = 0; + + if (type === 'double_click' || type === 'triple_click') { + ctx.globalAlpha = 1; + ctx.fillStyle = cfg.color; + ctx.font = `700 ${Math.max(10, Math.round(base * 0.6))}px system-ui, -apple-system, Segoe UI, Roboto, sans-serif`; + ctx.textAlign = 'center'; + ctx.textBaseline = 'middle'; + ctx.fillText(type === 'double_click' ? '2×' : '3×', x, y); + } else { + ctx.beginPath(); + ctx.arc(x, y, Math.max(2, base * 0.16), 0, Math.PI * 2); + ctx.fill(); + } + + ctx.restore(); +} + +function drawArrowHead( + ctx: OffscreenCanvasRenderingContext2D, + x1: number, + y1: number, + x2: number, + y2: number, + size: number, +): void { + const dx = x2 - x1; + const dy = y2 - y1; + const len = Math.hypot(dx, dy); + if (!Number.isFinite(len) || len < 1) return; + + const ux = dx / len; + const uy = dy / len; + const px = -uy; + const py = ux; + + const headLen = size; + const headWidth = size * 0.65; + + const backX = x2 - ux * headLen; + const backY = y2 - uy * headLen; + + ctx.beginPath(); + ctx.moveTo(x2, y2); + ctx.lineTo(backX + px * headWidth, backY + py * headWidth); + ctx.lineTo(backX - px * headWidth, backY - py * headWidth); + ctx.closePath(); + ctx.fill(); +} + +function drawDragPath( + ctx: OffscreenCanvasRenderingContext2D, + start: Point, + end: Point, + progress: number, + cfg: ResolvedDragPathConfig, +): void { + const t = clamp(progress, 0, 1); + const alpha = 1 - easeOutCubic(t); + + ctx.save(); + ctx.globalAlpha = alpha; + + ctx.strokeStyle = cfg.color; + ctx.fillStyle = cfg.color; + ctx.lineWidth = cfg.lineWidthPx; + ctx.lineCap = 'round'; + ctx.lineJoin = 'round'; + ctx.setLineDash(cfg.dash); + + ctx.shadowColor = 'rgba(0, 0, 0, 0.2)'; + ctx.shadowBlur = 6; + + ctx.beginPath(); + ctx.moveTo(start.x, start.y); + ctx.lineTo(end.x, end.y); + ctx.stroke(); + + ctx.setLineDash([]); + ctx.shadowBlur = 0; + + ctx.beginPath(); + ctx.arc(start.x, start.y, cfg.startDotRadiusPx, 0, Math.PI * 2); + ctx.fill(); + + ctx.beginPath(); + ctx.arc(end.x, end.y, cfg.endDotRadiusPx, 0, Math.PI * 2); + ctx.fill(); + + drawArrowHead(ctx, start.x, start.y, end.x, end.y, cfg.arrowSizePx); + + ctx.restore(); +} + +function drawLabelPill( + ctx: OffscreenCanvasRenderingContext2D, + text: string, + anchor: Point | null, + alpha: number, + cfg: ResolvedLabelsConfig, + outputWidth: number, + outputHeight: number, +): void { + ctx.save(); + ctx.globalAlpha = clamp(alpha, 0, 1); + + ctx.font = cfg.font; + ctx.textAlign = 'left'; + ctx.textBaseline = 'middle'; + + const metrics = ctx.measureText(text); + const ascent = Number.isFinite(metrics.actualBoundingBoxAscent) + ? metrics.actualBoundingBoxAscent + : 10; + const descent = Number.isFinite(metrics.actualBoundingBoxDescent) + ? metrics.actualBoundingBoxDescent + : 4; + const textHeight = ascent + descent; + const pillWidth = Math.ceil(metrics.width + cfg.paddingX * 2); + const pillHeight = Math.ceil(textHeight + cfg.paddingY * 2); + + const margin = 4; + const ax = anchor?.x ?? margin; + const ay = anchor?.y ?? margin; + + let x = ax + cfg.offsetPx; + let y = ay - pillHeight / 2; + + if (x + pillWidth > outputWidth - margin) x = ax - cfg.offsetPx - pillWidth; + if (y < margin) y = ay + cfg.offsetPx; + if (y + pillHeight > outputHeight - margin) y = outputHeight - margin - pillHeight; + + x = clamp(x, margin, Math.max(margin, outputWidth - margin - pillWidth)); + y = clamp(y, margin, Math.max(margin, outputHeight - margin - pillHeight)); + + ctx.fillStyle = cfg.backgroundColor; + ctx.strokeStyle = cfg.borderColor; + ctx.lineWidth = 1; + + ctx.beginPath(); + buildRoundedRectPath(ctx, x, y, pillWidth, pillHeight, cfg.radiusPx); + ctx.fill(); + ctx.stroke(); + + ctx.fillStyle = cfg.textColor; + ctx.fillText(text, x + cfg.paddingX, y + pillHeight / 2); + + ctx.restore(); +} + +// ============================================================================ +// Schema Input Normalization +// ============================================================================ + +/** + * External schema input type that supports both shorthand (boolean) and full config. + * This maps to what users pass via the MCP tool schema. + */ +interface SchemaEnhancedRenderingInput { + // Global toggle (Schema allows `true` to enable all defaults) + enabled?: boolean; + + // Sub-configs can be boolean (enable/disable) or object (custom config) + clickIndicators?: + | boolean + | { + enabled?: boolean; + // Schema aliases (from tools.ts) + color?: string; + radius?: number; // alias for radiusPx + animationDurationMs?: number; // alias for durationMs + animationFrames?: number; + animationIntervalMs?: number; + }; + + dragPaths?: + | boolean + | { + enabled?: boolean; + color?: string; + lineWidth?: number; // alias for lineWidthPx + lineDash?: number[]; // alias for dash + arrowSize?: number; // alias for arrowSizePx + }; + + labels?: + | boolean + | { + enabled?: boolean; + font?: string; + textColor?: string; + bgColor?: string; // alias for backgroundColor + padding?: number; // alias for paddingX/paddingY + borderRadius?: number; // alias for radiusPx + offset?: { x?: number; y?: number } | number; // alias for offsetPx + }; + + durationMs?: number; // global fallback duration for all overlays +} + +function normalizeSchemaInput(raw: unknown): GifEnhancedRenderingConfig | undefined { + // Handle `true` shorthand - enable with all defaults + if (raw === true) { + return { enabled: true }; + } + + // Handle `false` or falsy + if (!raw || typeof raw !== 'object') { + return undefined; + } + + const input = raw as SchemaEnhancedRenderingInput; + const result: GifEnhancedRenderingConfig = {}; + + // Global enabled + result.enabled = input.enabled ?? true; // If object passed, default to enabled + + // Global duration fallback + const globalDuration = typeof input.durationMs === 'number' ? input.durationMs : undefined; + + // Normalize clickIndicators + if (input.clickIndicators === false) { + result.clickIndicators = { enabled: false }; + } else if (input.clickIndicators === true) { + result.clickIndicators = { enabled: true }; + } else if (typeof input.clickIndicators === 'object') { + const ci = input.clickIndicators; + result.clickIndicators = { + enabled: ci.enabled ?? true, + color: ci.color, + radiusPx: ci.radius, + durationMs: ci.animationDurationMs ?? globalDuration, + animationFrames: ci.animationFrames, + animationIntervalMs: ci.animationIntervalMs, + }; + } + + // Normalize dragPaths + if (input.dragPaths === false) { + result.dragPaths = { enabled: false }; + } else if (input.dragPaths === true) { + result.dragPaths = { enabled: true }; + } else if (typeof input.dragPaths === 'object') { + const dp = input.dragPaths; + result.dragPaths = { + enabled: dp.enabled ?? true, + color: dp.color, + lineWidthPx: dp.lineWidth, + dash: dp.lineDash, + arrowSizePx: dp.arrowSize, + durationMs: globalDuration, + }; + } + + // Normalize labels + if (input.labels === false) { + result.labels = { enabled: false }; + } else if (input.labels === true) { + result.labels = { enabled: true }; + } else if (typeof input.labels === 'object') { + const lb = input.labels; + const offset = lb.offset; + const offsetPx = + typeof offset === 'number' ? offset : typeof offset === 'object' ? offset.x : undefined; + result.labels = { + enabled: lb.enabled ?? true, + font: lb.font, + textColor: lb.textColor, + backgroundColor: lb.bgColor, + paddingX: typeof lb.padding === 'number' ? lb.padding : undefined, + paddingY: typeof lb.padding === 'number' ? lb.padding : undefined, + radiusPx: lb.borderRadius, + offsetPx, + durationMs: globalDuration, + }; + } + + return result; +} + +// ============================================================================ +// Config Resolution +// ============================================================================ + +export function resolveGifEnhancedRenderingConfig( + input?: GifEnhancedRenderingConfig | unknown, +): ResolvedGifEnhancedRenderingConfig { + // Normalize schema input (handles `true`, boolean sub-configs, field aliases) + const normalized = normalizeSchemaInput(input) ?? (input as GifEnhancedRenderingConfig); + const enabled = normalized?.enabled ?? false; + + const clickIntervalMs = normalizePositiveInt( + normalized?.clickIndicators?.animationIntervalMs, + 80, + 20, + 500, + ); + const clickDelayCsFallback = Math.max(1, Math.round(clickIntervalMs / 10)); + + return { + enabled, + clickIndicators: { + enabled: normalized?.clickIndicators?.enabled ?? true, + color: normalized?.clickIndicators?.color ?? '#FF6A00', + fillColor: normalized?.clickIndicators?.fillColor ?? 'rgba(255, 106, 0, 0.18)', + radiusPx: normalizePositiveNumber(normalized?.clickIndicators?.radiusPx, 18, 4, 96), + lineWidthPx: normalizePositiveNumber(normalized?.clickIndicators?.lineWidthPx, 3, 1, 16), + durationMs: normalizePositiveInt(normalized?.clickIndicators?.durationMs, 520, 120, 5000), + animationFrames: normalizePositiveInt(normalized?.clickIndicators?.animationFrames, 3, 1, 8), + animationIntervalMs: clickIntervalMs, + animationFrameDelayCs: normalizePositiveInt( + normalized?.clickIndicators?.animationFrameDelayCs, + clickDelayCsFallback, + 1, + 100, + ), + }, + dragPaths: { + enabled: normalized?.dragPaths?.enabled ?? true, + color: normalized?.dragPaths?.color ?? '#FF2D55', + lineWidthPx: normalizePositiveNumber(normalized?.dragPaths?.lineWidthPx, 4, 1, 20), + durationMs: normalizePositiveInt(normalized?.dragPaths?.durationMs, 1000, 120, 8000), + arrowSizePx: normalizePositiveNumber(normalized?.dragPaths?.arrowSizePx, 10, 4, 40), + dash: normalizeDash(normalized?.dragPaths?.dash, [10, 8]), + startDotRadiusPx: normalizePositiveNumber(normalized?.dragPaths?.startDotRadiusPx, 4, 2, 24), + endDotRadiusPx: normalizePositiveNumber(normalized?.dragPaths?.endDotRadiusPx, 5, 2, 24), + }, + labels: { + enabled: normalized?.labels?.enabled ?? false, + mode: normalized?.labels?.mode ?? 'both', + showForClicks: normalized?.labels?.showForClicks ?? false, + font: + normalized?.labels?.font ?? + '600 13px system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif', + maxLength: normalizePositiveInt(normalized?.labels?.maxLength, 48, 8, 200), + durationMs: normalizePositiveInt(normalized?.labels?.durationMs, 1200, 120, 12000), + backgroundColor: normalized?.labels?.backgroundColor ?? 'rgba(0, 0, 0, 0.72)', + borderColor: normalized?.labels?.borderColor ?? 'rgba(255, 255, 255, 0.14)', + textColor: normalized?.labels?.textColor ?? '#FFFFFF', + paddingX: normalizePositiveNumber(normalized?.labels?.paddingX, 10, 2, 40), + paddingY: normalizePositiveNumber(normalized?.labels?.paddingY, 6, 2, 30), + radiusPx: normalizePositiveNumber(normalized?.labels?.radiusPx, 10, 0, 30), + offsetPx: normalizePositiveNumber(normalized?.labels?.offsetPx, 12, 0, 80), + }, + }; +} + +// ============================================================================ +// Capture Plan +// ============================================================================ + +export function resolveCapturePlanForAction( + config: ResolvedGifEnhancedRenderingConfig, + action: ActionMetadata | undefined, + defaultFrameDelayCs: number, +): CapturePlan { + const base: CapturePlan = { frames: 1, intervalMs: 0, delayCs: defaultFrameDelayCs }; + if (!config.enabled || !action) return base; + + if (config.clickIndicators.enabled && CLICK_ACTIONS.includes(action.type)) { + const frames = config.clickIndicators.animationFrames; + if (frames > 1) { + return { + frames, + intervalMs: config.clickIndicators.animationIntervalMs, + delayCs: config.clickIndicators.animationFrameDelayCs, + }; + } + } + + return base; +} + +// ============================================================================ +// Main Render Function +// ============================================================================ + +export function renderGifEnhancedOverlays(params: RenderGifEnhancedOverlaysParams): void { + const { ctx, outputWidth, outputHeight, viewportWidth, viewportHeight, nowMs, events, config } = + params; + + if (!config.enabled || events.length === 0) return; + + const clickCfg = config.clickIndicators; + const dragCfg = config.dragPaths; + const labelCfg = config.labels; + + for (const event of events) { + const ageMs = nowMs - event.atMs; + if (!Number.isFinite(ageMs) || ageMs < 0) continue; + + const action = event.action; + + if (clickCfg.enabled && CLICK_ACTIONS.includes(action.type)) { + const anchor = resolveAnchorPoint(action); + if (anchor) { + const p = projectPoint(anchor, viewportWidth, viewportHeight, outputWidth, outputHeight); + if (p) + drawClickIndicator(ctx, p.x, p.y, ageMs / clickCfg.durationMs, action.type, clickCfg); + } + } + + if (dragCfg.enabled && action.type === 'drag') { + const start = action.startCoordinates || null; + const end = action.endCoordinates || action.coordinates || null; + if (start && end) { + const p1 = projectPoint(start, viewportWidth, viewportHeight, outputWidth, outputHeight); + const p2 = projectPoint(end, viewportWidth, viewportHeight, outputWidth, outputHeight); + if (p1 && p2) drawDragPath(ctx, p1, p2, ageMs / dragCfg.durationMs, dragCfg); + } + } + + // Render labels: always show annotation actions, respect labelCfg.enabled for other actions + const isAnnotation = action.type === 'annotation' || typeof action.label === 'string'; + const shouldRenderLabel = labelCfg.enabled || isAnnotation; + + if (shouldRenderLabel) { + const text = resolveActionLabel(action, labelCfg); + if (text) { + const anchor = resolveAnchorPoint(action); + const p = anchor + ? projectPoint(anchor, viewportWidth, viewportHeight, outputWidth, outputHeight) + : null; + + const t = clamp(ageMs / labelCfg.durationMs, 0, 1); + const alpha = 1 - clamp((t - 0.75) / 0.25, 0, 1); + + drawLabelPill(ctx, text, p, alpha, labelCfg, outputWidth, outputHeight); + } + } + } +} + +// ============================================================================ +// Event Pruning +// ============================================================================ + +export function pruneActionEventsInPlace( + events: ActionEvent[], + nowMs: number, + config: ResolvedGifEnhancedRenderingConfig, +): void { + if (events.length === 0) return; + + // Check if any events have annotations (which are always rendered) + const hasAnnotations = events.some( + (e) => e.action.type === 'annotation' || typeof e.action.label === 'string', + ); + + let maxLifetimeMs = 0; + if (config.enabled) { + if (config.clickIndicators.enabled) + maxLifetimeMs = Math.max(maxLifetimeMs, config.clickIndicators.durationMs); + if (config.dragPaths.enabled) + maxLifetimeMs = Math.max(maxLifetimeMs, config.dragPaths.durationMs); + if (config.labels.enabled) maxLifetimeMs = Math.max(maxLifetimeMs, config.labels.durationMs); + } + + // Always account for label duration if there are annotations (they're always rendered) + if (hasAnnotations) { + maxLifetimeMs = Math.max(maxLifetimeMs, config.labels.durationMs); + } + + if (maxLifetimeMs <= 0) { + events.length = 0; + return; + } + + const cutoff = nowMs - maxLifetimeMs - 250; + let dropCount = 0; + while (dropCount < events.length && events[dropCount].atMs < cutoff) dropCount++; + if (dropCount > 0) events.splice(0, dropCount); +} diff --git a/app/chrome-extension/entrypoints/background/tools/browser/gif-recorder.ts b/app/chrome-extension/entrypoints/background/tools/browser/gif-recorder.ts new file mode 100644 index 00000000..594b4cad --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/gif-recorder.ts @@ -0,0 +1,1241 @@ +/** + * GIF Recorder Tool + * + * Records browser tab activity as an animated GIF. + * + * Features: + * - Two recording modes: + * 1. Fixed FPS mode (start): Captures frames at regular intervals + * 2. Auto-capture mode (auto_start): Captures frames on tool actions + * - Configurable frame rate, duration, and dimensions + * - Quality/size optimization options + * - CDP-based screenshot capture for background recording + * - Offscreen document encoding via gifenc + */ + +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { + MessageTarget, + OFFSCREEN_MESSAGE_TYPES, + OffscreenMessageType, +} from '@/common/message-types'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { offscreenManager } from '@/utils/offscreen-manager'; +import { createImageBitmapFromUrl } from '@/utils/image-utils'; +import { + startAutoCapture, + stopAutoCapture, + isAutoCaptureActive, + getAutoCaptureStatus, + captureFrameOnAction, + captureInitialFrame, + type ActionMetadata, + type GifEnhancedRenderingConfig, +} from './gif-auto-capture'; + +// ============================================================================ +// Constants +// ============================================================================ + +const DEFAULT_FPS = 5; +const DEFAULT_DURATION_MS = 5000; +const DEFAULT_MAX_FRAMES = 50; +const DEFAULT_WIDTH = 800; +const DEFAULT_HEIGHT = 600; +const DEFAULT_MAX_COLORS = 256; +const CDP_SESSION_KEY = 'gif-recorder'; + +// ============================================================================ +// Types +// ============================================================================ + +type GifRecorderAction = + | 'start' + | 'stop' + | 'status' + | 'auto_start' + | 'capture' + | 'clear' + | 'export'; + +interface GifRecorderParams { + action: GifRecorderAction; + tabId?: number; + fps?: number; + durationMs?: number; + maxFrames?: number; + width?: number; + height?: number; + maxColors?: number; + filename?: string; + // Auto-capture mode specific + captureDelayMs?: number; + frameDelayCs?: number; + enhancedRendering?: GifEnhancedRenderingConfig; + // Manual annotation for action="capture" + annotation?: string; + // Export action specific + download?: boolean; // true to download, false to upload via drag&drop + coordinates?: { x: number; y: number }; // target position for drag&drop upload + ref?: string; // element ref for drag&drop upload (alternative to coordinates) + selector?: string; // CSS selector for drag&drop upload (alternative to coordinates) +} + +interface RecordingState { + isRecording: boolean; + isStopping: boolean; + tabId: number; + width: number; + height: number; + fps: number; + durationMs: number; + frameIntervalMs: number; + frameDelayCs: number; + maxFrames: number; + maxColors: number; + frameCount: number; + startTime: number; + captureTimer: ReturnType | null; + captureInProgress: Promise | null; + canvas: OffscreenCanvas; + ctx: OffscreenCanvasRenderingContext2D; + filename?: string; +} + +interface GifResult { + success: boolean; + action: GifRecorderAction; + tabId?: number; + frameCount?: number; + durationMs?: number; + byteLength?: number; + downloadId?: number; + filename?: string; + fullPath?: string; + isRecording?: boolean; + mode?: 'fixed_fps' | 'auto_capture'; + actionsCount?: number; + error?: string; + // Clear action specific + clearedAutoCapture?: boolean; + clearedFixedFps?: boolean; + clearedCache?: boolean; + // Export action specific (drag&drop upload) + uploadTarget?: { + x: number; + y: number; + tagName?: string; + id?: string; + }; +} + +// ============================================================================ +// Recording State Management +// ============================================================================ + +let recordingState: RecordingState | null = null; +let stopPromise: Promise | null = null; + +// Auto-capture mode state +interface AutoCaptureMetadata { + tabId: number; + filename?: string; +} +let autoCaptureMetadata: AutoCaptureMetadata | null = null; + +// Last recorded GIF cache for export +interface ExportableGif { + gifData: Uint8Array; + width: number; + height: number; + frameCount: number; + durationMs: number; + tabId: number; + filename?: string; + actionsCount?: number; + mode: 'fixed_fps' | 'auto_capture'; + createdAt: number; +} +let lastRecordedGif: ExportableGif | null = null; + +// Maximum cache lifetime for exportable GIF (5 minutes) +const EXPORT_CACHE_LIFETIME_MS = 5 * 60 * 1000; + +// ============================================================================ +// Offscreen Document Communication +// ============================================================================ + +type OffscreenResponseBase = { success: boolean; error?: string }; + +async function sendToOffscreen( + type: OffscreenMessageType, + payload: Record = {}, +): Promise { + await offscreenManager.ensureOffscreenDocument(); + + let lastError: unknown; + for (let attempt = 1; attempt <= 3; attempt++) { + try { + const response = (await chrome.runtime.sendMessage({ + target: MessageTarget.Offscreen, + type, + ...payload, + })) as TResponse | undefined; + + if (!response) { + throw new Error('No response received from offscreen document'); + } + if (!response.success) { + throw new Error(response.error || 'Unknown offscreen error'); + } + + return response; + } catch (error) { + lastError = error; + if (attempt < 3) { + await new Promise((resolve) => setTimeout(resolve, 50 * attempt)); + continue; + } + throw error; + } + } + + throw lastError instanceof Error ? lastError : new Error(String(lastError)); +} + +// ============================================================================ +// Frame Capture +// ============================================================================ + +async function captureFrame( + tabId: number, + width: number, + height: number, + ctx: OffscreenCanvasRenderingContext2D, +): Promise { + // Get viewport metrics + const metrics: { layoutViewport?: { clientWidth: number; clientHeight: number } } = + await cdpSessionManager.sendCommand(tabId, 'Page.getLayoutMetrics', {}); + + const viewportWidth = metrics.layoutViewport?.clientWidth || width; + const viewportHeight = metrics.layoutViewport?.clientHeight || height; + + // Capture screenshot + const screenshot: { data: string } = await cdpSessionManager.sendCommand( + tabId, + 'Page.captureScreenshot', + { + format: 'png', + clip: { + x: 0, + y: 0, + width: viewportWidth, + height: viewportHeight, + scale: 1, + }, + }, + ); + + const imageBitmap = await createImageBitmapFromUrl(`data:image/png;base64,${screenshot.data}`); + + // Scale image to target dimensions + ctx.clearRect(0, 0, width, height); + ctx.drawImage(imageBitmap, 0, 0, width, height); + imageBitmap.close(); + + const imageData = ctx.getImageData(0, 0, width, height); + return imageData.data; +} + +async function captureAndEncodeFrame(state: RecordingState): Promise { + const frameData = await captureFrame(state.tabId, state.width, state.height, state.ctx); + + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME, { + imageData: Array.from(frameData), + width: state.width, + height: state.height, + delay: state.frameDelayCs, + maxColors: state.maxColors, + }); + + if (recordingState === state && state.isRecording && !state.isStopping) { + state.frameCount += 1; + } +} + +async function captureTick(state: RecordingState): Promise { + if (recordingState !== state || !state.isRecording || state.isStopping) { + return; + } + + const elapsed = Date.now() - state.startTime; + if (elapsed >= state.durationMs || state.frameCount >= state.maxFrames) { + await stopRecording(); + return; + } + + const startedAt = Date.now(); + state.captureInProgress = captureAndEncodeFrame(state); + + try { + await state.captureInProgress; + } catch (error) { + console.error('Frame capture error:', error); + } finally { + if (recordingState === state) { + state.captureInProgress = null; + } + } + + if (recordingState !== state || !state.isRecording || state.isStopping) { + return; + } + + const elapsedAfter = Date.now() - state.startTime; + if (elapsedAfter >= state.durationMs || state.frameCount >= state.maxFrames) { + await stopRecording(); + return; + } + + const delayMs = Math.max(0, state.frameIntervalMs - (Date.now() - startedAt)); + state.captureTimer = setTimeout(() => { + void captureTick(state).catch((error) => { + console.error('GIF recorder tick error:', error); + }); + }, delayMs); +} + +// ============================================================================ +// Recording Control +// ============================================================================ + +async function startRecording( + tabId: number, + fps: number, + durationMs: number, + maxFrames: number, + width: number, + height: number, + maxColors: number, + filename?: string, +): Promise { + if (stopPromise || recordingState?.isRecording || recordingState?.isStopping) { + return { + success: false, + action: 'start', + error: 'Recording already in progress', + }; + } + + try { + await cdpSessionManager.attach(tabId, CDP_SESSION_KEY); + } catch (error) { + return { + success: false, + action: 'start', + error: error instanceof Error ? error.message : String(error), + }; + } + + try { + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_RESET, {}); + + if (typeof OffscreenCanvas === 'undefined') { + throw new Error('OffscreenCanvas not available in this context'); + } + + const canvas = new OffscreenCanvas(width, height); + const ctx = canvas.getContext('2d'); + if (!ctx) { + throw new Error('Failed to get canvas context'); + } + + const frameIntervalMs = Math.round(1000 / fps); + const frameDelayCs = Math.max(1, Math.round(100 / fps)); + + const state: RecordingState = { + isRecording: true, + isStopping: false, + tabId, + width, + height, + fps, + durationMs, + frameIntervalMs, + frameDelayCs, + maxFrames, + maxColors, + frameCount: 0, + startTime: Date.now(), + captureTimer: null, + captureInProgress: null, + canvas, + ctx, + filename, + }; + + recordingState = state; + + // Capture first frame eagerly so start() fails fast if capture/encoding is broken + await captureAndEncodeFrame(state); + + state.captureTimer = setTimeout(() => { + void captureTick(state).catch((error) => { + console.error('GIF recorder tick error:', error); + }); + }, frameIntervalMs); + + return { + success: true, + action: 'start', + tabId, + isRecording: true, + }; + } catch (error) { + recordingState = null; + try { + await cdpSessionManager.detach(tabId, CDP_SESSION_KEY); + } catch { + // ignore + } + return { + success: false, + action: 'start', + error: error instanceof Error ? error.message : String(error), + }; + } +} + +async function stopRecording(): Promise { + if (stopPromise) { + return stopPromise; + } + + if (!recordingState || (!recordingState.isRecording && !recordingState.isStopping)) { + return { + success: false, + action: 'stop', + error: 'No recording in progress', + }; + } + + stopPromise = (async () => { + const state = recordingState!; + const tabId = state.tabId; + + // Stop capture timer + if (state.captureTimer) { + clearTimeout(state.captureTimer); + state.captureTimer = null; + } + + state.isStopping = true; + state.isRecording = false; + + try { + await state.captureInProgress; + } catch { + // ignore + } + + // Best-effort final frame capture to preserve end state + try { + const frameData = await captureFrame(state.tabId, state.width, state.height, state.ctx); + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME, { + imageData: Array.from(frameData), + width: state.width, + height: state.height, + delay: state.frameDelayCs, + maxColors: state.maxColors, + }); + state.frameCount += 1; + } catch (error) { + console.warn('GIF recorder: Final frame capture error (non-fatal):', error); + } + + const frameCount = state.frameCount; + const durationMs = Date.now() - state.startTime; + const filename = state.filename; + + try { + if (frameCount <= 0) { + try { + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_RESET, {}); + } catch { + // ignore + } + return { + success: false, + action: 'stop' as const, + tabId, + frameCount, + durationMs, + error: 'No frames captured', + }; + } + + const response = await sendToOffscreen<{ + success: boolean; + gifData?: number[]; + byteLength?: number; + }>(OFFSCREEN_MESSAGE_TYPES.GIF_FINISH, {}); + + if (!response.gifData || response.gifData.length === 0) { + return { + success: false, + action: 'stop' as const, + tabId, + frameCount, + durationMs, + error: 'No frames captured', + }; + } + + // Convert to Uint8Array and create blob + const gifBytes = new Uint8Array(response.gifData); + + // Cache for later export + lastRecordedGif = { + gifData: gifBytes, + width: state.width, + height: state.height, + frameCount, + durationMs, + tabId, + filename, + mode: 'fixed_fps', + createdAt: Date.now(), + }; + + const blob = new Blob([gifBytes], { type: 'image/gif' }); + const dataUrl = await blobToDataUrl(blob); + + // Save GIF file + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const outputFilename = filename?.replace(/[^a-z0-9_-]/gi, '_') || `recording_${timestamp}`; + const fullFilename = outputFilename.endsWith('.gif') + ? outputFilename + : `${outputFilename}.gif`; + + const downloadId = await chrome.downloads.download({ + url: dataUrl, + filename: fullFilename, + saveAs: false, + }); + + // Wait briefly to get download info + await new Promise((resolve) => setTimeout(resolve, 100)); + + let fullPath: string | undefined; + try { + const [downloadItem] = await chrome.downloads.search({ id: downloadId }); + fullPath = downloadItem?.filename; + } catch { + // Ignore path lookup errors + } + + return { + success: true, + action: 'stop' as const, + tabId, + frameCount, + durationMs, + byteLength: response.byteLength ?? gifBytes.byteLength, + downloadId, + filename: fullFilename, + fullPath, + }; + } catch (error) { + return { + success: false, + action: 'stop' as const, + error: error instanceof Error ? error.message : String(error), + }; + } finally { + try { + await cdpSessionManager.detach(tabId, CDP_SESSION_KEY); + } catch { + // ignore + } + recordingState = null; + } + })(); + + return await stopPromise.finally(() => { + stopPromise = null; + }); +} + +function getRecordingStatus(): GifResult { + if (!recordingState) { + return { + success: true, + action: 'status', + isRecording: false, + }; + } + + return { + success: true, + action: 'status', + isRecording: recordingState.isRecording, + tabId: recordingState.tabId, + frameCount: recordingState.frameCount, + durationMs: Date.now() - recordingState.startTime, + }; +} + +// ============================================================================ +// Utilities +// ============================================================================ + +function blobToDataUrl(blob: Blob): Promise { + return new Promise((resolve, reject) => { + const reader = new FileReader(); + reader.onload = () => resolve(reader.result as string); + reader.onerror = () => reject(new Error('Failed to read blob')); + reader.readAsDataURL(blob); + }); +} + +function normalizePositiveInt(value: unknown, fallback: number, max?: number): number { + if (typeof value !== 'number' || !Number.isFinite(value)) { + return fallback; + } + const result = Math.max(1, Math.floor(value)); + return max !== undefined ? Math.min(result, max) : result; +} + +// ============================================================================ +// Tool Implementation +// ============================================================================ + +class GifRecorderTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.GIF_RECORDER; + + async execute(args: GifRecorderParams): Promise { + const action = args.action; + const validActions = ['start', 'stop', 'status', 'auto_start', 'capture', 'clear', 'export']; + + if (!action || !validActions.includes(action)) { + return createErrorResponse( + `Parameter [action] is required and must be one of: ${validActions.join(', ')}`, + ); + } + + try { + switch (action) { + case 'start': { + // Fixed-FPS mode: captures frames at regular intervals + const tab = await this.resolveTargetTab(args.tabId); + if (!tab?.id) { + return createErrorResponse( + typeof args.tabId === 'number' + ? `Tab not found: ${args.tabId}` + : 'No active tab found', + ); + } + + if (this.isRestrictedUrl(tab.url)) { + return createErrorResponse( + 'Cannot record special browser pages or web store pages due to security restrictions.', + ); + } + + // Check if auto-capture is active + if (isAutoCaptureActive(tab.id)) { + return createErrorResponse( + 'Auto-capture mode is active for this tab. Use action="stop" to stop it first.', + ); + } + + const fps = normalizePositiveInt(args.fps, DEFAULT_FPS, 30); + const durationMs = normalizePositiveInt(args.durationMs, DEFAULT_DURATION_MS, 60000); + const maxFrames = normalizePositiveInt(args.maxFrames, DEFAULT_MAX_FRAMES, 300); + const width = normalizePositiveInt(args.width, DEFAULT_WIDTH, 1920); + const height = normalizePositiveInt(args.height, DEFAULT_HEIGHT, 1080); + const maxColors = normalizePositiveInt(args.maxColors, DEFAULT_MAX_COLORS, 256); + + const result = await startRecording( + tab.id, + fps, + durationMs, + maxFrames, + width, + height, + maxColors, + args.filename, + ); + + if (result.success) { + result.mode = 'fixed_fps'; + } + + return this.buildResponse(result); + } + + case 'auto_start': { + // Auto-capture mode: captures frames when tools succeed + const tab = await this.resolveTargetTab(args.tabId); + if (!tab?.id) { + return createErrorResponse( + typeof args.tabId === 'number' + ? `Tab not found: ${args.tabId}` + : 'No active tab found', + ); + } + + if (this.isRestrictedUrl(tab.url)) { + return createErrorResponse( + 'Cannot record special browser pages or web store pages due to security restrictions.', + ); + } + + // Check if fixed-FPS recording is active + if (recordingState?.isRecording && recordingState.tabId === tab.id) { + return createErrorResponse( + 'Fixed-FPS recording is active for this tab. Use action="stop" to stop it first.', + ); + } + + // Check if auto-capture is already active + if (isAutoCaptureActive(tab.id)) { + return createErrorResponse('Auto-capture is already active for this tab.'); + } + + const width = normalizePositiveInt(args.width, DEFAULT_WIDTH, 1920); + const height = normalizePositiveInt(args.height, DEFAULT_HEIGHT, 1080); + const maxColors = normalizePositiveInt(args.maxColors, DEFAULT_MAX_COLORS, 256); + const maxFrames = normalizePositiveInt(args.maxFrames, 100, 300); + const captureDelayMs = normalizePositiveInt(args.captureDelayMs, 150, 2000); + const frameDelayCs = normalizePositiveInt(args.frameDelayCs, 20, 100); + + const startResult = await startAutoCapture(tab.id, { + width, + height, + maxColors, + maxFrames, + captureDelayMs, + frameDelayCs, + enhancedRendering: args.enhancedRendering, + }); + + if (!startResult.success) { + return this.buildResponse({ + success: false, + action: 'auto_start', + tabId: tab.id, + error: startResult.error, + }); + } + + // Store metadata for stop + autoCaptureMetadata = { + tabId: tab.id, + filename: args.filename, + }; + + // Capture initial frame + await captureInitialFrame(tab.id); + + return this.buildResponse({ + success: true, + action: 'auto_start', + tabId: tab.id, + mode: 'auto_capture', + isRecording: true, + }); + } + + case 'capture': { + // Manual frame capture in auto mode + const tab = await this.resolveTargetTab(args.tabId); + if (!tab?.id) { + return createErrorResponse( + typeof args.tabId === 'number' + ? `Tab not found: ${args.tabId}` + : 'No active tab found', + ); + } + + if (!isAutoCaptureActive(tab.id)) { + return createErrorResponse( + 'Auto-capture is not active for this tab. Use action="auto_start" first.', + ); + } + + // Support optional annotation for manual captures + const annotation = + typeof args.annotation === 'string' && args.annotation.trim().length > 0 + ? args.annotation.trim() + : undefined; + + const action: ActionMetadata | undefined = annotation + ? { type: 'annotation', label: annotation } + : undefined; + + const captureResult = await captureFrameOnAction(tab.id, action, true); + + return this.buildResponse({ + success: captureResult.success, + action: 'capture', + tabId: tab.id, + frameCount: captureResult.frameNumber, + error: captureResult.error, + }); + } + + case 'stop': { + // Stop either mode + // Check auto-capture first + const autoTab = autoCaptureMetadata?.tabId; + if (autoTab !== undefined && isAutoCaptureActive(autoTab)) { + const stopResult = await stopAutoCapture(autoTab); + const filename = autoCaptureMetadata?.filename; + autoCaptureMetadata = null; + + if (!stopResult.success || !stopResult.gifData) { + return this.buildResponse({ + success: false, + action: 'stop', + tabId: autoTab, + mode: 'auto_capture', + frameCount: stopResult.frameCount, + durationMs: stopResult.durationMs, + actionsCount: stopResult.actions?.length, + error: stopResult.error || 'No GIF data generated', + }); + } + + // Cache for later export + lastRecordedGif = { + gifData: stopResult.gifData, + width: DEFAULT_WIDTH, // auto mode uses default dimensions + height: DEFAULT_HEIGHT, + frameCount: stopResult.frameCount ?? 0, + durationMs: stopResult.durationMs ?? 0, + tabId: autoTab, + filename, + actionsCount: stopResult.actions?.length, + mode: 'auto_capture', + createdAt: Date.now(), + }; + + // Save GIF file + const blob = new Blob([stopResult.gifData], { type: 'image/gif' }); + const dataUrl = await blobToDataUrl(blob); + + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const outputFilename = + filename?.replace(/[^a-z0-9_-]/gi, '_') || `recording_${timestamp}`; + const fullFilename = outputFilename.endsWith('.gif') + ? outputFilename + : `${outputFilename}.gif`; + + const downloadId = await chrome.downloads.download({ + url: dataUrl, + filename: fullFilename, + saveAs: false, + }); + + await new Promise((resolve) => setTimeout(resolve, 100)); + + let fullPath: string | undefined; + try { + const [downloadItem] = await chrome.downloads.search({ id: downloadId }); + fullPath = downloadItem?.filename; + } catch { + // Ignore + } + + return this.buildResponse({ + success: true, + action: 'stop', + tabId: autoTab, + mode: 'auto_capture', + frameCount: stopResult.frameCount, + durationMs: stopResult.durationMs, + byteLength: stopResult.gifData.byteLength, + actionsCount: stopResult.actions?.length, + downloadId, + filename: fullFilename, + fullPath, + }); + } + + // Fall back to fixed-FPS stop + const result = await stopRecording(); + if (result.success) { + result.mode = 'fixed_fps'; + } + return this.buildResponse(result); + } + + case 'status': { + // Check auto-capture status first + const autoTab = autoCaptureMetadata?.tabId; + if (autoTab !== undefined && isAutoCaptureActive(autoTab)) { + const status = getAutoCaptureStatus(autoTab); + return this.buildResponse({ + success: true, + action: 'status', + tabId: autoTab, + isRecording: status.active, + mode: 'auto_capture', + frameCount: status.frameCount, + durationMs: status.durationMs, + actionsCount: status.actionsCount, + }); + } + + // Fall back to fixed-FPS status + const result = getRecordingStatus(); + if (result.isRecording) { + result.mode = 'fixed_fps'; + } + return this.buildResponse(result); + } + + case 'clear': { + // Clear all recording state and cached GIF + let clearedAuto = false; + let clearedFixedFps = false; + let clearedCache = false; + + // Stop auto-capture if active + const autoTab = autoCaptureMetadata?.tabId; + if (autoTab !== undefined && isAutoCaptureActive(autoTab)) { + await stopAutoCapture(autoTab); + autoCaptureMetadata = null; + clearedAuto = true; + } + + // Stop fixed-FPS recording if active or stopping + if (recordingState) { + // Cancel timer and cleanup without waiting for finish + if (recordingState.captureTimer) { + clearTimeout(recordingState.captureTimer); + recordingState.captureTimer = null; + } + try { + await recordingState.captureInProgress; + } catch { + // ignore + } + try { + await cdpSessionManager.detach(recordingState.tabId, CDP_SESSION_KEY); + } catch { + // ignore + } + const wasRecording = recordingState.isRecording || recordingState.isStopping; + recordingState = null; + stopPromise = null; // Clear any pending stop promise + if (wasRecording) { + clearedFixedFps = true; + } + } + + // Reset offscreen encoder + try { + await sendToOffscreen(OFFSCREEN_MESSAGE_TYPES.GIF_RESET, {}); + } catch { + // ignore + } + + // Clear cached GIF + if (lastRecordedGif) { + lastRecordedGif = null; + clearedCache = true; + } + + return this.buildResponse({ + success: true, + action: 'clear', + clearedAutoCapture: clearedAuto, + clearedFixedFps, + clearedCache, + } as GifResult); + } + + case 'export': { + // Export the last recorded GIF (download or drag&drop upload) + + // Check if cache is valid + if (!lastRecordedGif) { + return createErrorResponse( + 'No recorded GIF available for export. Use action="stop" to finish a recording first.', + ); + } + + // Check cache expiration + if (Date.now() - lastRecordedGif.createdAt > EXPORT_CACHE_LIFETIME_MS) { + lastRecordedGif = null; + return createErrorResponse('Cached GIF has expired. Please record a new GIF.'); + } + + const download = args.download !== false; // Default to download + + if (download) { + // Download mode + const blob = new Blob([lastRecordedGif.gifData], { type: 'image/gif' }); + const dataUrl = await blobToDataUrl(blob); + + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const filename = args.filename ?? lastRecordedGif.filename; + const outputFilename = filename?.replace(/[^a-z0-9_-]/gi, '_') || `export_${timestamp}`; + const fullFilename = outputFilename.endsWith('.gif') + ? outputFilename + : `${outputFilename}.gif`; + + const downloadId = await chrome.downloads.download({ + url: dataUrl, + filename: fullFilename, + saveAs: false, + }); + + await new Promise((resolve) => setTimeout(resolve, 100)); + + let fullPath: string | undefined; + try { + const [downloadItem] = await chrome.downloads.search({ id: downloadId }); + fullPath = downloadItem?.filename; + } catch { + // Ignore + } + + return this.buildResponse({ + success: true, + action: 'export', + mode: lastRecordedGif.mode, + frameCount: lastRecordedGif.frameCount, + durationMs: lastRecordedGif.durationMs, + byteLength: lastRecordedGif.gifData.byteLength, + downloadId, + filename: fullFilename, + fullPath, + }); + } else { + // Drag&drop upload mode + const { coordinates, ref, selector } = args; + + if (!coordinates && !ref && !selector) { + return createErrorResponse( + 'For drag&drop upload, provide coordinates, ref, or selector to identify the drop target.', + ); + } + + // Resolve target tab + const tab = await this.resolveTargetTab(args.tabId); + if (!tab?.id) { + return createErrorResponse( + typeof args.tabId === 'number' + ? `Tab not found: ${args.tabId}` + : 'No active tab found', + ); + } + + // Security check + if (this.isRestrictedUrl(tab.url)) { + return createErrorResponse( + 'Cannot upload to special browser pages or web store pages.', + ); + } + + // Prepare GIF data as base64 + const gifBase64 = btoa( + Array.from(lastRecordedGif.gifData) + .map((b) => String.fromCharCode(b)) + .join(''), + ); + + // Resolve drop target coordinates + let targetX: number | undefined; + let targetY: number | undefined; + + if (ref) { + // Use the project's built-in ref resolution mechanism + try { + await this.injectContentScript(tab.id, [ + 'inject-scripts/accessibility-tree-helper.js', + ]); + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref, + }); + if (resolved?.success && resolved.center) { + targetX = resolved.center.x; + targetY = resolved.center.y; + } else { + return createErrorResponse(`Could not resolve ref: ${ref}`); + } + } catch (err) { + return createErrorResponse( + `Failed to resolve ref: ${err instanceof Error ? err.message : String(err)}`, + ); + } + } else if (selector) { + // Use executeScript to get element center coordinates by CSS selector + try { + const [result] = await chrome.scripting.executeScript({ + target: { tabId: tab.id }, + func: (cssSelector: string) => { + const el = document.querySelector(cssSelector); + if (!el) return null; + const rect = el.getBoundingClientRect(); + return { + x: rect.left + rect.width / 2, + y: rect.top + rect.height / 2, + }; + }, + args: [selector], + }); + + if (result?.result) { + targetX = result.result.x; + targetY = result.result.y; + } else { + return createErrorResponse(`Could not find element: ${selector}`); + } + } catch (err) { + return createErrorResponse( + `Failed to resolve selector: ${err instanceof Error ? err.message : String(err)}`, + ); + } + } else if (coordinates) { + targetX = coordinates.x; + targetY = coordinates.y; + } + + if (typeof targetX !== 'number' || typeof targetY !== 'number') { + return createErrorResponse('Invalid drop target coordinates.'); + } + + // Execute drag&drop upload + try { + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const filename = + args.filename ?? lastRecordedGif.filename ?? `recording_${timestamp}`; + const fullFilename = filename.endsWith('.gif') ? filename : `${filename}.gif`; + + const [result] = await chrome.scripting.executeScript({ + target: { tabId: tab.id }, + func: (base64Data: string, x: number, y: number, fname: string) => { + // Convert base64 to Blob + const byteChars = atob(base64Data); + const byteArray = new Uint8Array(byteChars.length); + for (let i = 0; i < byteChars.length; i++) { + byteArray[i] = byteChars.charCodeAt(i); + } + const blob = new Blob([byteArray], { type: 'image/gif' }); + const file = new File([blob], fname, { type: 'image/gif' }); + + // Find drop target element + const target = document.elementFromPoint(x, y); + if (!target) { + return { success: false, error: 'No element at drop coordinates' }; + } + + // Create DataTransfer with the file + const dt = new DataTransfer(); + dt.items.add(file); + + // Dispatch drag events + const events = ['dragenter', 'dragover', 'drop'] as const; + for (const eventType of events) { + const evt = new DragEvent(eventType, { + bubbles: true, + cancelable: true, + dataTransfer: dt, + clientX: x, + clientY: y, + }); + target.dispatchEvent(evt); + } + + return { + success: true, + targetTagName: target.tagName, + targetId: target.id || undefined, + }; + }, + args: [gifBase64, targetX, targetY, fullFilename], + }); + + if (!result?.result?.success) { + return createErrorResponse(result?.result?.error || 'Drag&drop upload failed'); + } + + return this.buildResponse({ + success: true, + action: 'export', + mode: lastRecordedGif.mode, + frameCount: lastRecordedGif.frameCount, + durationMs: lastRecordedGif.durationMs, + byteLength: lastRecordedGif.gifData.byteLength, + uploadTarget: { + x: targetX, + y: targetY, + tagName: result.result.targetTagName, + id: result.result.targetId, + }, + } as GifResult); + } catch (err) { + return createErrorResponse( + `Drag&drop upload failed: ${err instanceof Error ? err.message : String(err)}`, + ); + } + } + } + + default: + return createErrorResponse(`Unknown action: ${action}`); + } + } catch (error) { + console.error('GifRecorderTool.execute error:', error); + return createErrorResponse( + `GIF recorder error: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + private isRestrictedUrl(url?: string): boolean { + if (!url) return false; + return ( + url.startsWith('chrome://') || + url.startsWith('edge://') || + url.startsWith('https://chrome.google.com/webstore') || + url.startsWith('https://microsoftedge.microsoft.com/') + ); + } + + private async resolveTargetTab(tabId?: number): Promise { + if (typeof tabId === 'number') { + return this.tryGetTab(tabId); + } + try { + return await this.getActiveTabOrThrow(); + } catch { + return null; + } + } + + private buildResponse(result: GifResult): ToolResult { + return { + content: [{ type: 'text', text: JSON.stringify(result) }], + isError: !result.success, + }; + } +} + +export const gifRecorderTool = new GifRecorderTool(); + +// Re-export auto-capture utilities for use by other tools (e.g., chrome_computer, chrome_navigate) +export { + captureFrameOnAction, + isAutoCaptureActive, + type ActionMetadata, + type ActionType, +} from './gif-auto-capture'; diff --git a/app/chrome-extension/entrypoints/background/tools/browser/index.ts b/app/chrome-extension/entrypoints/background/tools/browser/index.ts index ccc655ee..629f74e2 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/index.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/index.ts @@ -1,15 +1,30 @@ -export { navigateTool, closeTabsTool, goBackOrForwardTool, switchTabTool } from './common'; +export { navigateTool, closeTabsTool, switchTabTool } from './common'; export { windowTool } from './window'; export { vectorSearchTabsContentTool as searchTabsContentTool } from './vector-search'; export { screenshotTool } from './screenshot'; export { webFetcherTool, getInteractiveElementsTool } from './web-fetcher'; export { clickTool, fillTool } from './interaction'; +export { elementPickerTool } from './element-picker'; export { networkRequestTool } from './network-request'; +export { networkCaptureTool } from './network-capture'; +// Legacy exports (for internal use by networkCaptureTool) export { networkDebuggerStartTool, networkDebuggerStopTool } from './network-capture-debugger'; export { networkCaptureStartTool, networkCaptureStopTool } from './network-capture-web-request'; export { keyboardTool } from './keyboard'; export { historyTool } from './history'; export { bookmarkSearchTool, bookmarkAddTool, bookmarkDeleteTool } from './bookmark'; export { injectScriptTool, sendCommandToInjectScriptTool } from './inject-script'; +export { javascriptTool } from './javascript'; export { consoleTool } from './console'; export { fileUploadTool } from './file-upload'; +export { readPageTool } from './read-page'; +export { computerTool } from './computer'; +export { handleDialogTool } from './dialog'; +export { handleDownloadTool } from './download'; +export { userscriptTool } from './userscript'; +export { + performanceStartTraceTool, + performanceStopTraceTool, + performanceAnalyzeInsightTool, +} from './performance'; +export { gifRecorderTool } from './gif-recorder'; diff --git a/app/chrome-extension/entrypoints/background/tools/browser/inject-script.ts b/app/chrome-extension/entrypoints/background/tools/browser/inject-script.ts index 4d4550ee..b3e73f8c 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/inject-script.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/inject-script.ts @@ -5,6 +5,9 @@ import { ExecutionWorld } from '@/common/constants'; interface InjectScriptParam { url?: string; + tabId?: number; + windowId?: number; + background?: boolean; } interface ScriptConfig { type: ExecutionWorld; @@ -22,14 +25,16 @@ class InjectScriptTool extends BaseBrowserToolExecutor { name = TOOL_NAMES.BROWSER.INJECT_SCRIPT; async execute(args: InjectScriptParam & ScriptConfig): Promise { try { - const { url, type, jsScript } = args; - let tab; + const { url, type, jsScript, tabId, windowId, background } = args; + let tab: chrome.tabs.Tab | undefined; if (!type || !jsScript) { return createErrorResponse('Param [type] and [jsScript] is required'); } - if (url) { + if (typeof tabId === 'number') { + tab = await chrome.tabs.get(tabId); + } else if (url) { // If URL is provided, check if it's already open console.log(`Checking if URL is already open: ${url}`); const allTabs = await chrome.tabs.query({}); @@ -49,15 +54,22 @@ class InjectScriptTool extends BaseBrowserToolExecutor { } else { // Create new tab with the URL console.log(`No existing tab found with URL: ${url}, creating new tab`); - tab = await chrome.tabs.create({ url, active: true }); + tab = await chrome.tabs.create({ + url, + active: background === true ? false : true, + windowId, + }); // Wait for page to load console.log('Waiting for page to load...'); await new Promise((resolve) => setTimeout(resolve, 3000)); } } else { - // Use active tab - const tabs = await chrome.tabs.query({ active: true }); + // Use active tab (prefer the specified window) + const tabs = + typeof windowId === 'number' + ? await chrome.tabs.query({ active: true, windowId }) + : await chrome.tabs.query({ active: true, currentWindow: true }); if (!tabs[0]) { return createErrorResponse('No active tab found'); } @@ -68,8 +80,11 @@ class InjectScriptTool extends BaseBrowserToolExecutor { return createErrorResponse('Tab has no ID'); } - // Make sure tab is active - await chrome.tabs.update(tab.id, { active: true }); + // Optionally bring tab/window to foreground based on background flag + if (background !== true) { + await chrome.tabs.update(tab.id, { active: true }); + await chrome.windows.update(tab.windowId, { focused: true }); + } const res = await handleInject(tab.id!, { ...args }); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/interaction.ts b/app/chrome-extension/entrypoints/background/tools/browser/interaction.ts index 12def52b..e9772635 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/interaction.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/interaction.ts @@ -10,10 +10,20 @@ interface Coordinates { } interface ClickToolParams { - selector?: string; // CSS selector for the element to click + selector?: string; // CSS selector or XPath for the element to click + selectorType?: 'css' | 'xpath'; // Type of selector (default: 'css') + ref?: string; // Element ref from accessibility tree (window.__claudeElementMap) coordinates?: Coordinates; // Coordinates to click at (x, y relative to viewport) waitForNavigation?: boolean; // Whether to wait for navigation to complete after click timeout?: number; // Timeout in milliseconds for waiting for the element or navigation + frameId?: number; // Target frame for ref/selector resolution + double?: boolean; // Perform double click when true + button?: 'left' | 'right' | 'middle'; + bubbles?: boolean; + cancelable?: boolean; + modifiers?: { altKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; shiftKey?: boolean }; + tabId?: number; // target existing tab id + windowId?: number; // when no tabId, pick active tab from this window } /** @@ -28,41 +38,96 @@ class ClickTool extends BaseBrowserToolExecutor { async execute(args: ClickToolParams): Promise { const { selector, + selectorType = 'css', coordinates, waitForNavigation = false, timeout = TIMEOUTS.DEFAULT_WAIT * 5, + frameId, + button, + bubbles, + cancelable, + modifiers, } = args; console.log(`Starting click operation with options:`, args); - if (!selector && !coordinates) { + if (!selector && !coordinates && !args.ref) { return createErrorResponse( - ERROR_MESSAGES.INVALID_PARAMETERS + ': Either selector or coordinates must be provided', + ERROR_MESSAGES.INVALID_PARAMETERS + ': Provide ref or selector or coordinates', ); } try { - // Get current tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); - if (!tabs[0]) { - return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND); - } - - const tab = tabs[0]; + // Resolve tab + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); if (!tab.id) { return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); } + let finalRef = args.ref; + let finalSelector = selector; + + // If selector is XPath, convert to ref first + if (selector && selectorType === 'xpath') { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + try { + const resolved = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector, + isXPath: true, + }, + frameId, + ); + if (resolved && resolved.success && resolved.ref) { + finalRef = resolved.ref; + finalSelector = undefined; // Use ref instead of selector + } else { + return createErrorResponse( + `Failed to resolve XPath selector: ${resolved?.error || 'unknown error'}`, + ); + } + } catch (error) { + return createErrorResponse( + `Error resolving XPath: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + await this.injectContentScript(tab.id, ['inject-scripts/click-helper.js']); // Send click message to content script - const result = await this.sendMessageToTab(tab.id, { - action: TOOL_MESSAGE_TYPES.CLICK_ELEMENT, - selector, - coordinates, - waitForNavigation, - timeout, - }); + const result = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.CLICK_ELEMENT, + selector: finalSelector, + coordinates, + ref: finalRef, + waitForNavigation, + timeout, + double: args.double === true, + button, + bubbles, + cancelable, + modifiers, + }, + frameId, + ); + + // Determine actual click method used + let clickMethod: string; + if (coordinates) { + clickMethod = 'coordinates'; + } else if (finalRef) { + clickMethod = 'ref'; + } else if (finalSelector) { + clickMethod = 'selector'; + } else { + clickMethod = 'unknown'; + } return { content: [ @@ -73,7 +138,7 @@ class ClickTool extends BaseBrowserToolExecutor { message: result.message || 'Click operation successful', elementInfo: result.elementInfo, navigationOccurred: result.navigationOccurred, - clickMethod: coordinates ? 'coordinates' : 'selector', + clickMethod, }), }, ], @@ -91,8 +156,14 @@ class ClickTool extends BaseBrowserToolExecutor { export const clickTool = new ClickTool(); interface FillToolParams { - selector: string; - value: string; + selector?: string; + selectorType?: 'css' | 'xpath'; // Type of selector (default: 'css') + ref?: string; // Element ref from accessibility tree + // Accept string | number | boolean for broader form input coverage + value: string | number | boolean; + frameId?: number; + tabId?: number; // target existing tab id + windowId?: number; // when no tabId, pick active tab from this window } /** @@ -105,12 +176,12 @@ class FillTool extends BaseBrowserToolExecutor { * Execute fill operation */ async execute(args: FillToolParams): Promise { - const { selector, value } = args; + const { selector, selectorType = 'css', ref, value, frameId } = args; console.log(`Starting fill operation with options:`, args); - if (!selector) { - return createErrorResponse(ERROR_MESSAGES.INVALID_PARAMETERS + ': Selector must be provided'); + if (!selector && !ref) { + return createErrorResponse(ERROR_MESSAGES.INVALID_PARAMETERS + ': Provide ref or selector'); } if (value === undefined || value === null) { @@ -118,27 +189,58 @@ class FillTool extends BaseBrowserToolExecutor { } try { - // Get current tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); - if (!tabs[0]) { - return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND); - } - - const tab = tabs[0]; + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); if (!tab.id) { return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); } + let finalRef = ref; + let finalSelector = selector; + + // If selector is XPath, convert to ref first + if (selector && selectorType === 'xpath') { + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + try { + const resolved = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector, + isXPath: true, + }, + frameId, + ); + if (resolved && resolved.success && resolved.ref) { + finalRef = resolved.ref; + finalSelector = undefined; // Use ref instead of selector + } else { + return createErrorResponse( + `Failed to resolve XPath selector: ${resolved?.error || 'unknown error'}`, + ); + } + } catch (error) { + return createErrorResponse( + `Error resolving XPath: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + await this.injectContentScript(tab.id, ['inject-scripts/fill-helper.js']); // Send fill message to content script - const result = await this.sendMessageToTab(tab.id, { - action: TOOL_MESSAGE_TYPES.FILL_ELEMENT, - selector, - value, - }); + const result = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.FILL_ELEMENT, + selector: finalSelector, + ref: finalRef, + value, + }, + frameId, + ); - if (result.error) { + if (result && result.error) { return createErrorResponse(result.error); } diff --git a/app/chrome-extension/entrypoints/background/tools/browser/javascript.ts b/app/chrome-extension/entrypoints/background/tools/browser/javascript.ts new file mode 100644 index 00000000..ad342c12 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/javascript.ts @@ -0,0 +1,525 @@ +/** + * JavaScript Tool - CDP Runtime.evaluate with fallback + * + * Execute JavaScript in the browser tab and return the result. + * - Primary: CDP Runtime.evaluate (supports awaitPromise + returnByValue) + * - Fallback: chrome.scripting.executeScript (when debugger is busy) + * + * Features: + * - Async code support (top-level await via async wrapper) + * - Output sanitization (sensitive data redaction) + * - Output truncation (configurable max bytes) + * - Timeout handling + * - Detailed error classification + */ + +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { + DEFAULT_MAX_OUTPUT_BYTES, + sanitizeAndLimitOutput, + sanitizeText, +} from '@/utils/output-sanitizer'; + +// ============================================================================ +// Constants +// ============================================================================ + +const DEFAULT_TIMEOUT_MS = 15_000; +const CDP_SESSION_KEY = 'javascript'; + +// ============================================================================ +// Types +// ============================================================================ + +type ExecutionEngine = 'cdp' | 'scripting'; + +type ErrorKind = + | 'debugger_conflict' + | 'timeout' + | 'syntax_error' + | 'runtime_error' + | 'cdp_error' + | 'scripting_error'; + +interface JavaScriptToolParams { + code: string; + tabId?: number; + timeoutMs?: number; + maxOutputBytes?: number; +} + +interface ExecutionError { + kind: ErrorKind; + message: string; + details?: { + url?: string; + lineNumber?: number; + columnNumber?: number; + }; +} + +interface ExecutionMetrics { + elapsedMs: number; +} + +interface JavaScriptToolResult { + success: boolean; + tabId: number; + engine: ExecutionEngine; + result?: string; + truncated?: boolean; + redacted?: boolean; + warnings?: string[]; + error?: ExecutionError; + metrics?: ExecutionMetrics; +} + +interface ExecutionOptions { + timeoutMs: number; + maxOutputBytes: number; +} + +// Discriminated union for execution results +type ExecutionSuccess = { + ok: true; + engine: ExecutionEngine; + output: string; + truncated: boolean; + redacted: boolean; +}; + +type ExecutionFailure = { + ok: false; + engine: ExecutionEngine; + error: ExecutionError; +}; + +type ExecutionResult = ExecutionSuccess | ExecutionFailure; + +// ============================================================================ +// Timeout Error +// ============================================================================ + +class TimeoutError extends Error { + constructor(timeoutMs: number) { + super(`Execution timed out after ${timeoutMs}ms`); + this.name = 'TimeoutError'; + } +} + +// ============================================================================ +// Utility Functions +// ============================================================================ + +function normalizePositiveInt(value: unknown, fallback: number): number { + if (typeof value !== 'number' || !Number.isFinite(value)) { + return fallback; + } + return Math.max(1, Math.floor(value)); +} + +function withTimeout(promise: Promise, timeoutMs: number): Promise { + return new Promise((resolve, reject) => { + const timer = setTimeout(() => { + reject(new TimeoutError(timeoutMs)); + }, timeoutMs); + + promise + .then(resolve) + .catch(reject) + .finally(() => clearTimeout(timer)); + }); +} + +function isTimeoutError(error: unknown): error is TimeoutError { + return error instanceof Error && error.name === 'TimeoutError'; +} + +function isDebuggerConflictError(error: unknown): boolean { + const message = error instanceof Error ? error.message : String(error); + return /Debugger is already attached|Another debugger is already attached|Cannot attach to this target/i.test( + message, + ); +} + +/** + * Wrap user code in an async IIFE to support top-level await and return statements. + */ +function wrapUserCode(code: string): string { + return `(async () => {\n${code}\n})()`; +} + +// ============================================================================ +// CDP Execution +// ============================================================================ + +interface CDPRemoteObject { + type?: string; + subtype?: string; + value?: unknown; + unserializableValue?: string; + description?: string; +} + +interface CDPExceptionDetails { + text?: string; + url?: string; + lineNumber?: number; + columnNumber?: number; + exception?: { + className?: string; + description?: string; + value?: string; + }; +} + +interface CDPEvaluateResult { + result?: CDPRemoteObject; + exceptionDetails?: CDPExceptionDetails; +} + +function extractReturnValue(remoteObject?: CDPRemoteObject): unknown { + if (!remoteObject) return undefined; + + if ('value' in remoteObject) return remoteObject.value; + if ('unserializableValue' in remoteObject) return remoteObject.unserializableValue; + if (typeof remoteObject.description === 'string') return remoteObject.description; + + return undefined; +} + +function parseExceptionDetails(details: CDPExceptionDetails): ExecutionError { + const exceptionClassName = details.exception?.className ?? ''; + const exceptionDescription = details.exception?.description ?? ''; + const exceptionValue = details.exception?.value ?? ''; + const text = details.text ?? ''; + + // Determine the raw error message + const rawMessage = + exceptionDescription || exceptionValue || text || 'JavaScript execution failed'; + + // Sanitize the message + const message = sanitizeText(rawMessage).text; + + // Classify the error kind + const isSyntaxError = exceptionClassName === 'SyntaxError' || /SyntaxError/i.test(rawMessage); + + return { + kind: isSyntaxError ? 'syntax_error' : 'runtime_error', + message, + details: { + url: details.url, + lineNumber: details.lineNumber, + columnNumber: details.columnNumber, + }, + }; +} + +async function executeViaCdp( + tabId: number, + code: string, + options: ExecutionOptions, +): Promise { + try { + const expression = wrapUserCode(code); + + const response = await withTimeout( + cdpSessionManager.withSession(tabId, CDP_SESSION_KEY, async () => { + return (await cdpSessionManager.sendCommand(tabId, 'Runtime.evaluate', { + expression, + returnByValue: true, + awaitPromise: true, + // CDP 内置超时（毫秒），与外层 withTimeout 双重保障 + timeout: options.timeoutMs, + })) as CDPEvaluateResult; + }), + // 外层超时稍长，给 CDP 一点余量处理超时响应 + options.timeoutMs + 1000, + ); + + // Check for exception + if (response?.exceptionDetails) { + return { + ok: false, + engine: 'cdp', + error: parseExceptionDetails(response.exceptionDetails), + }; + } + + // Extract and sanitize the result + const value = extractReturnValue(response?.result); + const sanitized = sanitizeAndLimitOutput(value, { maxBytes: options.maxOutputBytes }); + + return { + ok: true, + engine: 'cdp', + output: sanitized.text, + truncated: sanitized.truncated, + redacted: sanitized.redacted, + }; + } catch (error) { + if (isTimeoutError(error)) { + return { + ok: false, + engine: 'cdp', + error: { kind: 'timeout', message: error.message }, + }; + } + + if (isDebuggerConflictError(error)) { + const message = sanitizeText(error instanceof Error ? error.message : String(error)).text; + return { + ok: false, + engine: 'cdp', + error: { kind: 'debugger_conflict', message }, + }; + } + + const message = sanitizeText(error instanceof Error ? error.message : String(error)).text; + return { + ok: false, + engine: 'cdp', + error: { kind: 'cdp_error', message }, + }; + } +} + +// ============================================================================ +// chrome.scripting.executeScript Fallback +// ============================================================================ + +interface ScriptingExecutionResult { + ok: boolean; + value?: unknown; + error?: { + name?: string; + message?: string; + stack?: string; + }; +} + +async function executeViaScripting( + tabId: number, + code: string, + options: ExecutionOptions, +): Promise { + const innerExecute = async (): Promise => { + const results = await chrome.scripting.executeScript({ + target: { tabId }, + world: 'ISOLATED', + func: async (userCode: string): Promise => { + try { + // Use AsyncFunction constructor to support top-level await + + const AsyncFunction = Object.getPrototypeOf(async function () {}).constructor; + const fn = new AsyncFunction(userCode); + const value = await fn(); + return { ok: true, value }; + } catch (err: unknown) { + const error = err as Error; + return { + ok: false, + error: { + name: error?.name ?? undefined, + message: error?.message ?? String(err), + stack: error?.stack ?? undefined, + }, + }; + } + }, + args: [code], + }); + + // Extract the first result + const firstFrame = results?.[0]; + const result = (firstFrame as { result?: ScriptingExecutionResult })?.result; + + if (!result || typeof result !== 'object') { + return { + ok: false, + engine: 'scripting', + error: { kind: 'scripting_error', message: 'No result returned from executeScript' }, + }; + } + + if (!result.ok) { + const rawMessage = result.error?.message ?? 'JavaScript execution failed'; + const rawStack = result.error?.stack; + + const message = sanitizeText(rawMessage).text; + const sanitizedStack = rawStack ? sanitizeText(rawStack).text : undefined; + + const isSyntaxError = result.error?.name === 'SyntaxError' || /SyntaxError/i.test(rawMessage); + + return { + ok: false, + engine: 'scripting', + error: { + kind: isSyntaxError ? 'syntax_error' : 'runtime_error', + message: sanitizedStack ? `${message}\n${sanitizedStack}` : message, + }, + }; + } + + // Sanitize the successful result + const sanitized = sanitizeAndLimitOutput(result.value, { maxBytes: options.maxOutputBytes }); + + return { + ok: true, + engine: 'scripting', + output: sanitized.text, + truncated: sanitized.truncated, + redacted: sanitized.redacted, + }; + }; + + try { + return await withTimeout(innerExecute(), options.timeoutMs); + } catch (error) { + if (isTimeoutError(error)) { + return { + ok: false, + engine: 'scripting', + error: { kind: 'timeout', message: error.message }, + }; + } + + const message = sanitizeText(error instanceof Error ? error.message : String(error)).text; + return { + ok: false, + engine: 'scripting', + error: { kind: 'scripting_error', message }, + }; + } +} + +// ============================================================================ +// Tool Implementation +// ============================================================================ + +class JavaScriptTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.JAVASCRIPT; + + async execute(args: JavaScriptToolParams): Promise { + const startTime = performance.now(); + + try { + // Validate required parameter + const code = typeof args?.code === 'string' ? args.code.trim() : ''; + if (!code) { + return createErrorResponse('Parameter [code] is required'); + } + + // Resolve target tab + const tab = await this.resolveTargetTab(args.tabId); + if (!tab) { + return createErrorResponse( + typeof args.tabId === 'number' ? `Tab not found: ${args.tabId}` : 'No active tab found', + ); + } + + if (!tab.id) { + return createErrorResponse('Tab has no ID'); + } + const tabId = tab.id; + + // Normalize options + const options: ExecutionOptions = { + timeoutMs: normalizePositiveInt(args.timeoutMs, DEFAULT_TIMEOUT_MS), + maxOutputBytes: normalizePositiveInt(args.maxOutputBytes, DEFAULT_MAX_OUTPUT_BYTES), + }; + + const warnings: string[] = []; + + // Try CDP execution first + const cdpResult = await executeViaCdp(tabId, code, options); + + if (cdpResult.ok) { + return this.buildSuccessResponse(tabId, cdpResult, startTime); + } + + // If not a debugger conflict, return the CDP error + if (cdpResult.error.kind !== 'debugger_conflict') { + return this.buildErrorResponse(tabId, cdpResult, startTime); + } + + // Debugger conflict - fallback to scripting API + warnings.push( + 'Debugger is busy (DevTools or another extension attached). Falling back to chrome.scripting.executeScript (runs in ISOLATED world, not page context).', + ); + + const scriptingResult = await executeViaScripting(tabId, code, options); + + if (scriptingResult.ok) { + return this.buildSuccessResponse(tabId, scriptingResult, startTime, warnings); + } + + return this.buildErrorResponse(tabId, scriptingResult, startTime, warnings); + } catch (error) { + console.error('JavaScriptTool.execute error:', error); + return createErrorResponse( + `JavaScript tool error: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + private async resolveTargetTab(tabId?: number): Promise { + if (typeof tabId === 'number') { + return this.tryGetTab(tabId); + } + try { + return await this.getActiveTabOrThrow(); + } catch { + return null; + } + } + + private buildSuccessResponse( + tabId: number, + result: ExecutionSuccess, + startTime: number, + warnings?: string[], + ): ToolResult { + const payload: JavaScriptToolResult = { + success: true, + tabId, + engine: result.engine, + result: result.output, + truncated: result.truncated || undefined, + redacted: result.redacted || undefined, + warnings: warnings?.length ? warnings : undefined, + metrics: { elapsedMs: Math.round(performance.now() - startTime) }, + }; + + return { + content: [{ type: 'text', text: JSON.stringify(payload) }], + isError: false, + }; + } + + private buildErrorResponse( + tabId: number, + result: ExecutionFailure, + startTime: number, + warnings?: string[], + ): ToolResult { + const payload: JavaScriptToolResult = { + success: false, + tabId, + engine: result.engine, + error: result.error, + warnings: warnings?.length ? warnings : undefined, + metrics: { elapsedMs: Math.round(performance.now() - startTime) }, + }; + + return { + content: [{ type: 'text', text: JSON.stringify(payload) }], + isError: true, + }; + } +} + +export const javascriptTool = new JavaScriptTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/keyboard.ts b/app/chrome-extension/entrypoints/background/tools/browser/keyboard.ts index 5124f85c..3204d01d 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/keyboard.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/keyboard.ts @@ -6,8 +6,12 @@ import { TIMEOUTS, ERROR_MESSAGES } from '@/common/constants'; interface KeyboardToolParams { keys: string; // Required: string representing keys or key combinations to simulate (e.g., "Enter", "Ctrl+C") - selector?: string; // Optional: CSS selector for target element to send keyboard events to + selector?: string; // Optional: CSS selector or XPath for target element to send keyboard events to + selectorType?: 'css' | 'xpath'; // Type of selector (default: 'css') delay?: number; // Optional: delay between keystrokes in milliseconds + tabId?: number; // target existing tab id + windowId?: number; // when no tabId, pick active tab from this window + frameId?: number; // target frame id for iframe support } /** @@ -20,7 +24,7 @@ class KeyboardTool extends BaseBrowserToolExecutor { * Execute keyboard operation */ async execute(args: KeyboardToolParams): Promise { - const { keys, selector, delay = TIMEOUTS.KEYBOARD_DELAY } = args; + const { keys, selector, selectorType = 'css', delay = TIMEOUTS.KEYBOARD_DELAY } = args; console.log(`Starting keyboard operation with options:`, args); @@ -31,26 +35,86 @@ class KeyboardTool extends BaseBrowserToolExecutor { } try { - // Get current tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); - if (!tabs[0]) { - return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND); - } - - const tab = tabs[0]; + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); if (!tab.id) { return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); } - await this.injectContentScript(tab.id, ['inject-scripts/keyboard-helper.js']); + let finalSelector = selector; + let refForFocus: string | undefined = undefined; + + // Ensure helper is loaded for XPath or potential focus operations + await this.injectContentScript(tab.id, ['inject-scripts/accessibility-tree-helper.js']); + + // If selector is XPath, convert to ref then try to get CSS selector + if (selector && selectorType === 'xpath') { + try { + // First convert XPath to ref + const ensured = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector, + isXPath: true, + }); + if (!ensured || !ensured.success || !ensured.ref) { + return createErrorResponse( + `Failed to resolve XPath selector: ${ensured?.error || 'unknown error'}`, + ); + } + refForFocus = ensured.ref; + // Try to resolve ref to CSS selector + const resolved = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.RESOLVE_REF, + ref: ensured.ref, + }); + if (resolved && resolved.success && resolved.selector) { + finalSelector = resolved.selector; + refForFocus = undefined; // Prefer CSS selector if available + } + // If no CSS selector available, we'll use ref to focus below + } catch (error) { + return createErrorResponse( + `Error resolving XPath: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + // If we have a ref but no CSS selector, focus the element via helper + if (refForFocus) { + const focusResult = await this.sendMessageToTab(tab.id, { + action: 'focusByRef', + ref: refForFocus, + }); + if (focusResult && !focusResult.success) { + return createErrorResponse( + `Failed to focus element by ref: ${focusResult.error || 'unknown error'}`, + ); + } + // Clear selector so keyboard events go to the focused element + finalSelector = undefined; + } + + const frameIds = typeof args.frameId === 'number' ? [args.frameId] : undefined; + await this.injectContentScript( + tab.id, + ['inject-scripts/keyboard-helper.js'], + false, + 'ISOLATED', + false, + frameIds, + ); // Send keyboard simulation message to content script - const result = await this.sendMessageToTab(tab.id, { - action: TOOL_MESSAGE_TYPES.SIMULATE_KEYBOARD, - keys, - selector, - delay, - }); + const result = await this.sendMessageToTab( + tab.id, + { + action: TOOL_MESSAGE_TYPES.SIMULATE_KEYBOARD, + keys, + selector: finalSelector, + delay, + }, + args.frameId, + ); if (result.error) { return createErrorResponse(result.error); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/network-capture-debugger.ts b/app/chrome-extension/entrypoints/background/tools/browser/network-capture-debugger.ts index c6adc540..49cb973e 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/network-capture-debugger.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/network-capture-debugger.ts @@ -1,6 +1,8 @@ import { createErrorResponse, ToolResult } from '@/common/tool-handler'; import { BaseBrowserToolExecutor } from '../base-browser'; import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; +import { NETWORK_FILTERS } from '@/common/constants'; interface NetworkDebuggerStartToolParams { url?: string; // URL to navigate to or focus. If not provided, uses active tab. @@ -34,80 +36,6 @@ interface NetworkRequestInfo { [key: string]: any; // Allow other properties from debugger events } -// Static resource file extensions list -const STATIC_RESOURCE_EXTENSIONS = [ - '.png', - '.jpg', - '.jpeg', - '.gif', - '.bmp', - '.webp', - '.svg', - '.ico', - '.cur', - '.css', - '.woff', - '.woff2', - '.ttf', - '.eot', - '.otf', - '.mp3', - '.mp4', - '.avi', - '.mov', - '.webm', - '.ogg', - '.wav', - '.pdf', - '.zip', - '.rar', - '.7z', - '.iso', - '.dmg', - '.js', - '.jsx', - '.ts', - '.tsx', - '.map', // Source maps -]; - -// Ad and analytics domains list -const AD_ANALYTICS_DOMAINS = [ - 'google-analytics.com', - 'googletagmanager.com', - 'analytics.google.com', - 'doubleclick.net', - 'googlesyndication.com', - 'googleads.g.doubleclick.net', - 'facebook.com/tr', - 'connect.facebook.net', - 'bat.bing.com', - 'linkedin.com', // Often for tracking pixels/insights - 'analytics.twitter.com', - 'static.hotjar.com', - 'script.hotjar.com', - 'stats.g.doubleclick.net', - 'amazon-adsystem.com', - 'adservice.google.com', - 'pagead2.googlesyndication.com', - 'ads-twitter.com', - 'ads.yahoo.com', - 'adroll.com', - 'adnxs.com', - 'criteo.com', - 'quantserve.com', - 'scorecardresearch.com', - 'segment.io', - 'amplitude.com', - 'mixpanel.com', - 'optimizely.com', - 'crazyegg.com', - 'clicktale.net', - 'mouseflow.com', - 'fullstory.com', - 'clarity.ms', -]; - const DEBUGGER_PROTOCOL_VERSION = '1.3'; const MAX_RESPONSE_BODY_SIZE_BYTES = 1 * 1024 * 1024; // 1MB const DEFAULT_MAX_CAPTURE_TIME_MS = 3 * 60 * 1000; // 3 minutes @@ -218,35 +146,15 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { // Get tab information const tab = await chrome.tabs.get(tabId); - // Check if debugger is already attached - const targets = await chrome.debugger.getTargets(); - const existingTarget = targets.find( - (t) => t.tabId === tabId && t.attached && t.type === 'page', - ); - if (existingTarget && !existingTarget.extensionId) { - throw new Error( - `Debugger is already attached to tab ${tabId} by another tool (e.g., DevTools).`, - ); - } - - // Attach debugger - try { - await chrome.debugger.attach({ tabId }, DEBUGGER_PROTOCOL_VERSION); - } catch (error: any) { - if (error.message?.includes('Cannot attach to the target with an attached client')) { - throw new Error( - `Debugger is already attached to tab ${tabId}. This might be DevTools or another extension.`, - ); - } - throw error; - } + // Attach via shared manager (handles conflicts and refcount) + await cdpSessionManager.attach(tabId, 'network-capture'); // Enable network tracking try { - await chrome.debugger.sendCommand({ tabId }, 'Network.enable'); + await cdpSessionManager.sendCommand(tabId, 'Network.enable'); } catch (error: any) { - await chrome.debugger - .detach({ tabId }) + await cdpSessionManager + .detach(tabId, 'network-capture') .catch((e) => console.warn('Error detaching after failed enable:', e)); throw error; } @@ -290,8 +198,8 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { // Clean up resources if (this.captureData.has(tabId)) { - await chrome.debugger - .detach({ tabId }) + await cdpSessionManager + .detach(tabId, 'network-capture') .catch((e) => console.warn('Cleanup detach error:', e)); this.cleanupCapture(tabId); } @@ -385,92 +293,43 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { await this.stopCapture(tabId, true); // Pass a flag indicating it's an auto-stop } - // Static resource MIME types list (used when includeStatic is false) - private static STATIC_MIME_TYPES_TO_FILTER = [ - 'image/', // all image types (image/png, image/jpeg, etc.) - 'font/', // all font types (font/woff, font/ttf, etc.) - 'audio/', // all audio types - 'video/', // all video types - 'text/css', - // Note: text/javascript, application/javascript etc. are often filtered by extension. - // If script files need to be filtered by MIME type as well, add them here. - // 'application/javascript', - // 'application/x-javascript', - 'application/pdf', - 'application/zip', - 'application/octet-stream', // Often used for downloads or generic binary data - ]; - - // API-like response MIME types (these are generally NOT filtered, and we might want their bodies) - private static API_MIME_TYPES = [ - 'application/json', - 'application/xml', - 'text/xml', - // 'text/json' is not standard, but sometimes seen. 'application/json' is preferred. - 'text/plain', // Can be API response, handle with care. Often captured. - 'application/x-www-form-urlencoded', // Form submissions, can be API calls - 'application/graphql', - // Add other common API types if needed - ]; - + /** + * Check if URL should be filtered based on EXCLUDED_DOMAINS patterns. + * Uses full URL substring match to support patterns like 'facebook.com/tr'. + */ private shouldFilterRequestByUrl(url: string): boolean { - try { - const urlObj = new URL(url); - // Filter ad/analytics domains - if (AD_ANALYTICS_DOMAINS.some((domain) => urlObj.hostname.includes(domain))) { - // console.log(`NetworkDebuggerStartTool: Filtering ad/analytics domain: ${urlObj.hostname}`); - return true; - } - return false; - } catch (e) { - // Invalid URL? Log and don't filter. - console.error(`NetworkDebuggerStartTool: Error parsing URL for filtering: ${url}`, e); - return false; - } + const normalizedUrl = String(url || '').toLowerCase(); + if (!normalizedUrl) return false; + return NETWORK_FILTERS.EXCLUDED_DOMAINS.some((pattern) => normalizedUrl.includes(pattern)); } private shouldFilterRequestByExtension(url: string, includeStatic: boolean): boolean { - if (includeStatic) return false; // If including static, don't filter by extension + if (includeStatic) return false; try { const urlObj = new URL(url); const path = urlObj.pathname.toLowerCase(); - if (STATIC_RESOURCE_EXTENSIONS.some((ext) => path.endsWith(ext))) { - // console.log(`NetworkDebuggerStartTool: Filtering static resource by extension: ${path}`); - return true; - } - return false; - } catch (e) { - console.error( - `NetworkDebuggerStartTool: Error parsing URL for extension filtering: ${url}`, - e, - ); + return NETWORK_FILTERS.STATIC_RESOURCE_EXTENSIONS.some((ext) => path.endsWith(ext)); + } catch { return false; } } - // MIME type-based filtering, called after response is received private shouldFilterByMimeType(mimeType: string, includeStatic: boolean): boolean { - if (!mimeType) return false; // No MIME type, don't make a decision based on it here + if (!mimeType) return false; - // If API_MIME_TYPES contains this mimeType, we explicitly DON'T want to filter it by MIME. - if (NetworkDebuggerStartTool.API_MIME_TYPES.some((apiMime) => mimeType.startsWith(apiMime))) { + // Never filter API MIME types + if (NETWORK_FILTERS.API_MIME_TYPES.some((apiMime) => mimeType.startsWith(apiMime))) { return false; } - // If we are NOT including static files, then check against the list of static MIME types. + // Filter static MIME types when not including static resources if (!includeStatic) { - if ( - NetworkDebuggerStartTool.STATIC_MIME_TYPES_TO_FILTER.some((staticMime) => - mimeType.startsWith(staticMime), - ) - ) { - // console.log(`NetworkDebuggerStartTool: Filtering static resource by MIME type: ${mimeType}`); - return true; - } + return NETWORK_FILTERS.STATIC_MIME_TYPES_TO_FILTER.some((staticMime) => + mimeType.startsWith(staticMime), + ); } - // Default: don't filter by MIME type if no other rule matched return false; } @@ -614,7 +473,7 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { const mimeType = requestInfo.mimeType || ''; // Prioritize API MIME types for body capture - if (NetworkDebuggerStartTool.API_MIME_TYPES.some((type) => mimeType.startsWith(type))) { + if (NETWORK_FILTERS.API_MIME_TYPES.some((type) => mimeType.startsWith(type))) { return true; } @@ -630,7 +489,7 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { // unless it's a known non-API MIME type that slipped through (e.g. a script from a /api/ path) if ( mimeType && - NetworkDebuggerStartTool.STATIC_MIME_TYPES_TO_FILTER.some((staticMime) => + NETWORK_FILTERS.STATIC_MIME_TYPES_TO_FILTER.some((staticMime) => mimeType.startsWith(staticMime), ) ) { @@ -673,14 +532,8 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { const responseBodyPromise = (async () => { try { - // Check if debugger is still attached to this tabId - const attachedTabs = await chrome.debugger.getTargets(); - if (!attachedTabs.some((target) => target.tabId === tabId && target.attached)) { - // console.warn(`NetworkDebuggerStartTool: Debugger not attached to tab ${tabId} when trying to get response body for ${requestId}.`); - throw new Error(`Debugger not attached to tab ${tabId}`); - } - - const result = (await chrome.debugger.sendCommand({ tabId }, 'Network.getResponseBody', { + // Will attach temporarily if needed + const result = (await cdpSessionManager.sendCommand(tabId, 'Network.getResponseBody', { requestId, })) as { body: string; base64Encoded: boolean }; return result; @@ -734,33 +587,21 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { ); try { - // Detach debugger first to prevent further events. - // Check if debugger is attached before trying to send commands or detach - const attachedTargets = await chrome.debugger.getTargets(); - const isAttached = attachedTargets.some( - (target) => target.tabId === tabId && target.attached, - ); - - if (isAttached) { - try { - await chrome.debugger.sendCommand({ tabId }, 'Network.disable'); - } catch (e) { - console.warn( - `NetworkDebuggerStartTool: Error disabling network for tab ${tabId} (possibly already detached):`, - e, - ); - } - try { - await chrome.debugger.detach({ tabId }); - } catch (e) { - console.warn( - `NetworkDebuggerStartTool: Error detaching debugger for tab ${tabId} (possibly already detached):`, - e, - ); - } - } else { - console.log( - `NetworkDebuggerStartTool: Debugger was not attached to tab ${tabId} at stopCapture.`, + // Attempt to disable network and detach via manager; it will no-op if others own the session + try { + await cdpSessionManager.sendCommand(tabId, 'Network.disable'); + } catch (e) { + console.warn( + `NetworkDebuggerStartTool: Error disabling network for tab ${tabId} (possibly already detached):`, + e, + ); + } + try { + await cdpSessionManager.detach(tabId, 'network-capture'); + } catch (e) { + console.warn( + `NetworkDebuggerStartTool: Error detaching debugger for tab ${tabId} (possibly already detached):`, + e, ); } } catch (error: any) { @@ -1003,8 +844,8 @@ class NetworkDebuggerStartTool extends BaseBrowserToolExecutor { // If a tabId was involved and debugger might be attached, try to clean up. const tabIdToClean = tabToOperateOn?.id; if (tabIdToClean && this.captureData.has(tabIdToClean)) { - await chrome.debugger - .detach({ tabId: tabIdToClean }) + await cdpSessionManager + .detach(tabIdToClean, 'network-capture') .catch((e) => console.warn('Cleanup detach error:', e)); this.cleanupCapture(tabIdToClean); } diff --git a/app/chrome-extension/entrypoints/background/tools/browser/network-capture-web-request.ts b/app/chrome-extension/entrypoints/background/tools/browser/network-capture-web-request.ts index d37d2202..462808bf 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/network-capture-web-request.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/network-capture-web-request.ts @@ -202,31 +202,31 @@ class NetworkCaptureStartTool extends BaseBrowserToolExecutor { /** * Determine whether a request should be filtered (based on URL) + * Uses full URL substring match to support patterns like 'facebook.com/tr' */ private shouldFilterRequest(url: string, includeStatic: boolean): boolean { - try { - const urlObj = new URL(url); + const normalizedUrl = String(url || '').toLowerCase(); + if (!normalizedUrl) return false; - // Check if it's an ad or analytics domain - if (AD_ANALYTICS_DOMAINS.some((domain) => urlObj.hostname.includes(domain))) { - console.log(`NetworkCaptureV2: Filtering ad/analytics domain: ${urlObj.hostname}`); - return true; - } + // Check if it's an ad or analytics domain (full URL substring match) + if (AD_ANALYTICS_DOMAINS.some((pattern) => normalizedUrl.includes(pattern))) { + return true; + } - // If not including static resources, check extensions - if (!includeStatic) { + // If not including static resources, check extensions + if (!includeStatic) { + try { + const urlObj = new URL(url); const path = urlObj.pathname.toLowerCase(); if (STATIC_RESOURCE_EXTENSIONS.some((ext) => path.endsWith(ext))) { - console.log(`NetworkCaptureV2: Filtering static resource by extension: ${path}`); return true; } + } catch { + return false; } - - return false; - } catch (e) { - console.error('NetworkCaptureV2: Error filtering URL:', e); - return false; } + + return false; } /** @@ -345,9 +345,14 @@ class NetworkCaptureStartTool extends BaseBrowserToolExecutor { } /** - * Set up request listeners + * Set up request listeners (idempotent - won't add duplicate listeners) */ private setupListeners(): void { + // Skip if listeners are already set up + if (this.listeners.onBeforeRequest) { + return; + } + // Before request is sent this.listeners.onBeforeRequest = (details: chrome.webRequest.WebRequestBodyDetails) => { const captureInfo = this.captureData.get(details.tabId); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/network-capture.ts b/app/chrome-extension/entrypoints/background/tools/browser/network-capture.ts new file mode 100644 index 00000000..aebfd9fa --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/network-capture.ts @@ -0,0 +1,158 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { networkCaptureStartTool, networkCaptureStopTool } from './network-capture-web-request'; +import { networkDebuggerStartTool, networkDebuggerStopTool } from './network-capture-debugger'; + +type NetworkCaptureBackend = 'webRequest' | 'debugger'; + +interface NetworkCaptureToolParams { + action: 'start' | 'stop'; + needResponseBody?: boolean; + url?: string; + maxCaptureTime?: number; + inactivityTimeout?: number; + includeStatic?: boolean; +} + +/** + * Extract text content from ToolResult + */ +function getFirstText(result: ToolResult): string | undefined { + const first = result.content?.[0]; + return first && first.type === 'text' ? first.text : undefined; +} + +/** + * Decorate JSON result with additional fields + */ +function decorateJsonResult(result: ToolResult, extra: Record): ToolResult { + const text = getFirstText(result); + if (typeof text !== 'string') return result; + + try { + const parsed = JSON.parse(text); + if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) { + return { + ...result, + content: [{ type: 'text', text: JSON.stringify({ ...parsed, ...extra }) }], + }; + } + } catch { + // If the underlying tool didn't return JSON, keep it as-is + } + return result; +} + +/** + * Check if debugger-based capture is active + */ +function isDebuggerCaptureActive(): boolean { + const captureData = ( + networkDebuggerStartTool as unknown as { captureData?: Map } + ).captureData; + return captureData instanceof Map && captureData.size > 0; +} + +/** + * Check if webRequest-based capture is active + */ +function isWebRequestCaptureActive(): boolean { + return networkCaptureStartTool.captureData.size > 0; +} + +/** + * Unified Network Capture Tool + * + * Provides a single entry point for network capture, automatically selecting + * the appropriate backend based on the `needResponseBody` parameter: + * - needResponseBody=false (default): uses webRequest API (lightweight, no debugger conflict) + * - needResponseBody=true: uses Debugger API (captures response body, may conflict with DevTools) + */ +class NetworkCaptureTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.NETWORK_CAPTURE; + + async execute(args: NetworkCaptureToolParams): Promise { + const action = args?.action; + if (action !== 'start' && action !== 'stop') { + return createErrorResponse('Parameter [action] is required and must be one of: start, stop'); + } + + const wantBody = args?.needResponseBody === true; + const debuggerActive = isDebuggerCaptureActive(); + const webActive = isWebRequestCaptureActive(); + + if (action === 'start') { + return this.handleStart(args, wantBody, debuggerActive, webActive); + } + + return this.handleStop(args, debuggerActive, webActive); + } + + private async handleStart( + args: NetworkCaptureToolParams, + wantBody: boolean, + debuggerActive: boolean, + webActive: boolean, + ): Promise { + // Prevent any capture conflict (cross-mode or same-mode) + if (debuggerActive || webActive) { + const activeMode = debuggerActive ? 'debugger' : 'webRequest'; + return createErrorResponse( + `Network capture is already active in ${activeMode} mode. Stop it before starting a new capture.`, + ); + } + + const delegate = wantBody ? networkDebuggerStartTool : networkCaptureStartTool; + const backend: NetworkCaptureBackend = wantBody ? 'debugger' : 'webRequest'; + + const result = await delegate.execute({ + url: args.url, + maxCaptureTime: args.maxCaptureTime, + inactivityTimeout: args.inactivityTimeout, + includeStatic: args.includeStatic, + }); + + return decorateJsonResult(result, { backend, needResponseBody: wantBody }); + } + + private async handleStop( + args: NetworkCaptureToolParams, + debuggerActive: boolean, + webActive: boolean, + ): Promise { + // Determine which backend to stop + let backendToStop: NetworkCaptureBackend | null = null; + + // If user explicitly specified needResponseBody, try to stop that specific backend + if (args?.needResponseBody === true) { + backendToStop = debuggerActive ? 'debugger' : null; + } else if (args?.needResponseBody === false) { + backendToStop = webActive ? 'webRequest' : null; + } + + // If no explicit preference or the specified backend isn't active, auto-detect + if (!backendToStop) { + if (debuggerActive) { + backendToStop = 'debugger'; + } else if (webActive) { + backendToStop = 'webRequest'; + } + } + + if (!backendToStop) { + return createErrorResponse('No active network captures found in any tab.'); + } + + const delegateStop = + backendToStop === 'debugger' ? networkDebuggerStopTool : networkCaptureStopTool; + const result = await delegateStop.execute(); + + return decorateJsonResult(result, { + backend: backendToStop, + needResponseBody: backendToStop === 'debugger', + }); + } +} + +export const networkCaptureTool = new NetworkCaptureTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/network-request.ts b/app/chrome-extension/entrypoints/background/tools/browser/network-request.ts index 96ca1967..93b58cdb 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/network-request.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/network-request.ts @@ -11,6 +11,10 @@ interface NetworkRequestToolParams { headers?: Record; // User-provided headers body?: any; // User-provided body timeout?: number; // Timeout for the network request itself + // Optional multipart/form-data descriptor. When provided, overrides body and lets the helper build FormData. + // Shape: { fields?: Record, files?: Array<{ name: string, fileUrl?: string, filePath?: string, base64Data?: string, filename?: string, contentType?: string }> } + // Or a compact array: [ [name, fileSpec, filename?], ... ] where fileSpec can be 'url:...', 'file:/abs/path', 'base64:...' + formData?: any; } /** @@ -54,6 +58,7 @@ class NetworkRequestTool extends BaseBrowserToolExecutor { method: method, headers: headers, body: body, + formData: args.formData || null, timeout: timeout, }); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/performance.ts b/app/chrome-extension/entrypoints/background/tools/browser/performance.ts new file mode 100644 index 00000000..8fcb2578 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/performance.ts @@ -0,0 +1,545 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; + +type OwnerTag = 'performance'; + +interface StartTraceParams { + reload?: boolean; // whether to reload the page after starting trace + autoStop?: boolean; // whether to auto stop after a short duration + durationMs?: number; // custom duration when autoStop is true (default 5000) +} + +interface StopTraceParams { + saveToDownloads?: boolean; // save trace to Downloads as JSON (default true) + filenamePrefix?: string; // filename prefix (default 'performance_trace') +} + +interface AnalyzeInsightParams { + insightName?: string; // placeholder for future deep insights +} + +type DebuggeeEvent = (source: chrome.debugger.Debuggee, method: string, params?: any) => void; + +interface TraceSessionState { + recording: boolean; + events: any[]; + startedAt: number; + pageUrl?: string; + listener: DebuggeeEvent; + stopResolver?: (value: { completed: boolean }) => void; + stopPromise?: Promise<{ completed: boolean }>; +} + +const sessions = new Map(); +const LAST_RESULTS = new Map< + number, + { + events: any[]; + startedAt: number; + endedAt: number; + tabUrl: string; + saved?: { downloadId?: number; filename?: string; fullPath?: string }; + metrics?: Record; + } +>(); + +function tracingCategories(): string[] { + // Keep broadly consistent with other project + return [ + '-*', + 'blink.console', + 'blink.user_timing', + 'devtools.timeline', + 'disabled-by-default-devtools.screenshot', + 'disabled-by-default-devtools.timeline', + 'disabled-by-default-devtools.timeline.invalidationTracking', + 'disabled-by-default-devtools.timeline.frame', + 'disabled-by-default-devtools.timeline.stack', + 'disabled-by-default-v8.cpu_profiler', + 'disabled-by-default-v8.cpu_profiler.hires', + 'latencyInfo', + 'loading', + 'disabled-by-default-lighthouse', + 'v8.execute', + 'v8', + ]; +} + +async function enablePerformanceMetrics(tabId: number): Promise> { + try { + await cdpSessionManager.sendCommand(tabId, 'Performance.enable'); + const result = (await cdpSessionManager.sendCommand(tabId, 'Performance.getMetrics')) as { + metrics: Array<{ name: string; value: number }>; + }; + await cdpSessionManager.sendCommand(tabId, 'Performance.disable'); + const map: Record = {}; + for (const m of result.metrics || []) map[m.name] = m.value; + return map; + } catch (e) { + return {}; + } +} + +async function saveTraceToDownloads( + json: string, + filenamePrefix = 'performance_trace', +): Promise<{ downloadId?: number; filename?: string; fullPath?: string }> { + try { + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const filename = `${filenamePrefix}_${timestamp}.json`; + const dataUrl = `data:application/json;base64,${btoa(unescape(encodeURIComponent(json)))}`; + const downloadId = await chrome.downloads.download({ url: dataUrl, filename, saveAs: false }); + // Attempt to resolve full path + try { + await new Promise((r) => setTimeout(r, 120)); + const [item] = await chrome.downloads.search({ id: downloadId }); + return { downloadId, filename, fullPath: item?.filename }; + } catch { + return { downloadId, filename }; + } + } catch { + return {}; + } +} + +async function saveTraceToNativeTemp( + json: string, + filenamePrefix = 'performance_trace', +): Promise<{ filename?: string; fullPath?: string } | undefined> { + try { + const timestamp = new Date().toISOString().replace(/[:.]/g, '-'); + const filename = `${filenamePrefix}_${timestamp}.json`; + const base64 = btoa(unescape(encodeURIComponent(json))); + + const requestId = `trace-temp-${Date.now()}-${Math.random().toString(36).slice(2)}`; + const timeoutMs = 30000; + const resp = await new Promise((resolve, reject) => { + const timer = setTimeout(() => { + chrome.runtime.onMessage.removeListener(listener); + reject(new Error('Native temp save timed out')); + }, timeoutMs); + const listener = (message: any) => { + if ( + message && + message.type === 'file_operation_response' && + message.responseToRequestId === requestId + ) { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + resolve(message.payload); + } + }; + chrome.runtime.onMessage.addListener(listener); + chrome.runtime + .sendMessage({ + type: 'forward_to_native', + message: { + type: 'file_operation', + requestId, + payload: { + action: 'prepareFile', + base64Data: base64, + fileName: filename, + }, + }, + }) + .catch((err) => { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + reject(err); + }); + }); + + if (resp && resp.success && resp.filePath) { + return { filename, fullPath: resp.filePath }; + } + } catch { + // ignore, fallback will apply + } + return undefined; +} + +async function cleanupNativeTempFile(filePath: string): Promise { + if (!filePath) return; + try { + const requestId = `trace-clean-${Date.now()}-${Math.random().toString(36).slice(2)}`; + const timeoutMs = 10000; + await new Promise((resolve) => { + const timer = setTimeout(() => { + chrome.runtime.onMessage.removeListener(listener); + resolve(); // best-effort + }, timeoutMs); + const listener = (message: any) => { + if ( + message && + message.type === 'file_operation_response' && + message.responseToRequestId === requestId + ) { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + resolve(); + } + }; + chrome.runtime.onMessage.addListener(listener); + chrome.runtime + .sendMessage({ + type: 'forward_to_native', + message: { + type: 'file_operation', + requestId, + payload: { + action: 'cleanupFile', + filePath, + }, + }, + }) + .catch(() => { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + resolve(); + }); + }); + } catch { + // ignore + } +} + +function getOrCreateStopPromise(session: TraceSessionState): Promise<{ completed: boolean }> { + if (session.stopPromise) return session.stopPromise; + session.stopPromise = new Promise((resolve) => { + session.stopResolver = resolve; + }); + return session.stopPromise; +} + +/** + * Start performance trace + */ +class PerformanceStartTraceTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.PERFORMANCE_START_TRACE; + + async execute(args: StartTraceParams): Promise { + const { reload = false, autoStop = false, durationMs = 5000 } = args || {}; + + try { + const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!activeTab?.id) { + return createErrorResponse('No active tab found'); + } + const tabId = activeTab.id; + const existed = sessions.get(tabId); + if (existed?.recording) { + return { + content: [{ type: 'text', text: 'Error: a performance trace is already running.' }], + isError: false, + }; + } + + await cdpSessionManager.attach(tabId, 'performance'); + + const state: TraceSessionState = { + recording: true, + events: [], + startedAt: Date.now(), + pageUrl: activeTab.url || '', + listener: (source, method, params) => { + if (source.tabId !== tabId) return; + if (method === 'Tracing.dataCollected' && params?.value) { + try { + state.events.push(...(params.value as any[])); + } catch { + // ignore + } + } else if (method === 'Tracing.tracingComplete') { + state.recording = false; + state.stopResolver?.({ completed: true }); + } + }, + }; + chrome.debugger.onEvent.addListener(state.listener); + sessions.set(tabId, state); + + // Start tracing with categories + const cats = tracingCategories().join(','); + await cdpSessionManager.sendCommand(tabId, 'Tracing.start', { + categories: cats, + options: 'record-as-much-as-possible', + transferMode: 'ReportEvents', + }); + + if (reload) { + try { + await cdpSessionManager.sendCommand(tabId, 'Page.reload', { ignoreCache: true }); + } catch { + // best effort; ignore if fails + } + } + + if (autoStop) { + setTimeout( + async () => { + try { + await cdpSessionManager.sendCommand(tabId, 'Tracing.end'); + } catch { + // ignore + } + }, + Math.max(1000, Math.min(durationMs, 60000)), + ); + } + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + message: 'Performance trace is recording. Use performance_stop_trace to stop it.', + reload, + autoStop, + }), + }, + ], + isError: false, + }; + } catch (e: any) { + return createErrorResponse(`Failed to start performance trace: ${e?.message || e}`); + } + } +} + +/** + * Stop performance trace + */ +class PerformanceStopTraceTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.PERFORMANCE_STOP_TRACE; + + async execute(args: StopTraceParams): Promise { + const { saveToDownloads = true, filenamePrefix } = args || {}; + try { + const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!activeTab?.id) return createErrorResponse('No active tab found'); + const tabId = activeTab.id; + const session = sessions.get(tabId); + if (!session) { + return { + content: [ + { type: 'text', text: 'No performance trace session found for the current tab.' }, + ], + isError: false, + }; + } + + let stopResult: { completed: boolean } = { completed: false }; + if (session.recording) { + // End tracing and wait for completion signal + await cdpSessionManager.sendCommand(tabId, 'Tracing.end'); + await getOrCreateStopPromise(session); + stopResult = await session.stopPromise!; + } else { + // Already auto-stopped; proceed to finalize without waiting + stopResult = { completed: true }; + } + // Fetch metrics before detach + const metrics = await enablePerformanceMetrics(tabId); + + // Cleanup event listener and detach + try { + chrome.debugger.onEvent.removeListener(session.listener); + } catch { + // ignore + } + try { + await cdpSessionManager.detach(tabId, 'performance'); + } catch { + // ignore + } + + const endedAt = Date.now(); + const trace = { traceEvents: session.events }; + const json = JSON.stringify(trace); + + let saved: { downloadId?: number; filename?: string; fullPath?: string } | undefined; + if (saveToDownloads) { + saved = await saveTraceToDownloads(json, filenamePrefix || 'performance_trace'); + } else { + // Persist to native temp directory so that analysis can run without Downloads permission + const tempSaved = await saveTraceToNativeTemp(json, filenamePrefix || 'performance_trace'); + if (tempSaved) { + saved = { ...tempSaved } as any; + } + } + + LAST_RESULTS.set(tabId, { + events: session.events, + startedAt: session.startedAt, + endedAt, + tabUrl: session.pageUrl || '', + saved, + metrics, + }); + + sessions.delete(tabId); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + message: 'The performance trace has been stopped.', + eventCount: session.events.length, + saved, + metrics, + startedAt: session.startedAt, + endedAt, + durationMs: endedAt - session.startedAt, + url: session.pageUrl || '', + tracingCompleted: stopResult?.completed === true, + }), + }, + ], + isError: false, + }; + } catch (e: any) { + return createErrorResponse(`Failed to stop performance trace: ${e?.message || e}`); + } + } +} + +/** + * Analyze last trace (lightweight) + * Note: Deep insights require DevTools front-end trace engine on the native side; this is a + * pragmatic first step returning basic metrics and a quick event histogram. + */ +class PerformanceAnalyzeInsightTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.PERFORMANCE_ANALYZE_INSIGHT; + + async execute(args: AnalyzeInsightParams & { timeoutMs?: number }): Promise { + const { insightName } = args || {}; + try { + const [activeTab] = await chrome.tabs.query({ active: true, currentWindow: true }); + if (!activeTab?.id) return createErrorResponse('No active tab found'); + const tabId = activeTab.id; + const result = LAST_RESULTS.get(tabId); + if (!result) { + return { + content: [ + { + type: 'text', + text: 'No recorded traces found. Start and stop a performance trace first.', + }, + ], + isError: false, + }; + } + + // Prefer native-side deep analysis when we have a saved file path + const fullPath = (result.saved && (result.saved as any).fullPath) || undefined; + if (fullPath) { + try { + const requestId = `trace-analyze-${Date.now()}-${Math.random().toString(36).slice(2)}`; + const timeoutMs = Math.max(10000, Math.min((args as any)?.timeoutMs ?? 60000, 300000)); + const resp = await new Promise((resolve, reject) => { + const timer = setTimeout(() => { + chrome.runtime.onMessage.removeListener(listener); + reject(new Error('Native trace analysis timed out')); + }, timeoutMs); + const listener = (message: any) => { + if ( + message && + message.type === 'file_operation_response' && + message.responseToRequestId === requestId + ) { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + resolve(message.payload); + } + }; + chrome.runtime.onMessage.addListener(listener); + chrome.runtime + .sendMessage({ + type: 'forward_to_native', + message: { + type: 'file_operation', + requestId, + payload: { action: 'analyzeTrace', traceFilePath: fullPath, insightName }, + }, + }) + .catch((err) => { + clearTimeout(timer); + chrome.runtime.onMessage.removeListener(listener); + reject(err); + }); + }); + if (resp && resp.success) { + // Best-effort cleanup for temp files (Downloads paths are ignored by native cleaner) + await cleanupNativeTempFile(fullPath); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + url: result.tabUrl, + startedAt: result.startedAt, + endedAt: result.endedAt, + durationMs: result.endedAt - result.startedAt, + metrics: result.metrics || {}, + saved: result.saved, + summary: resp.summary, + insight: resp.insight, + }), + }, + ], + isError: false, + }; + } + // If native returned error, fall through to lightweight analysis + } catch (e) { + // Fallback to lightweight analysis below + } + } + + // Lightweight fallback (when no saved file path) + const counts = new Map(); + for (const ev of result.events.slice(0, 100000)) { + const n = typeof (ev as any)?.name === 'string' ? (ev as any).name : 'unknown'; + counts.set(n, (counts.get(n) || 0) + 1); + } + const top = [...counts.entries()] + .sort((a, b) => b[1] - a[1]) + .slice(0, 20) + .map(([name, count]) => ({ name, count })); + + return { + content: [ + { + type: 'text', + text: JSON.stringify({ + success: true, + info: 'Lightweight analysis (no saved file path). Native-side deep analysis unavailable.', + requestedInsight: insightName || null, + url: result.tabUrl, + startedAt: result.startedAt, + endedAt: result.endedAt, + durationMs: result.endedAt - result.startedAt, + metrics: result.metrics || {}, + topEventNames: top, + saved: result.saved, + }), + }, + ], + isError: false, + }; + } catch (e: any) { + return createErrorResponse(`Failed to analyze trace: ${e?.message || e}`); + } + } +} + +export const performanceStartTraceTool = new PerformanceStartTraceTool(); +export const performanceStopTraceTool = new PerformanceStopTraceTool(); +export const performanceAnalyzeInsightTool = new PerformanceAnalyzeInsightTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/read-page.ts b/app/chrome-extension/entrypoints/background/tools/browser/read-page.ts new file mode 100644 index 00000000..9895f743 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/read-page.ts @@ -0,0 +1,229 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import { ERROR_MESSAGES } from '@/common/constants'; +import { listMarkersForUrl } from '@/entrypoints/background/element-marker/element-marker-storage'; + +interface ReadPageStats { + processed: number; + included: number; + durationMs: number; +} + +interface ReadPageParams { + filter?: 'interactive'; // when omitted, return all visible elements + depth?: number; // maximum DOM depth to traverse (0 = root only) + refId?: string; // focus on subtree rooted at this refId + tabId?: number; // target existing tab id + windowId?: number; // when no tabId, pick active tab from this window +} + +class ReadPageTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.READ_PAGE; + + // Execute read page + async execute(args: ReadPageParams): Promise { + const { filter, depth, refId } = args || {}; + + // Validate refId parameter + const focusRefId = typeof refId === 'string' ? refId.trim() : ''; + if (refId !== undefined && !focusRefId) { + return createErrorResponse( + `${ERROR_MESSAGES.INVALID_PARAMETERS}: refId must be a non-empty string`, + ); + } + + // Validate depth parameter + const requestedDepth = depth === undefined ? undefined : Number(depth); + if (requestedDepth !== undefined && (!Number.isInteger(requestedDepth) || requestedDepth < 0)) { + return createErrorResponse( + `${ERROR_MESSAGES.INVALID_PARAMETERS}: depth must be a non-negative integer`, + ); + } + + // Track if user explicitly controlled the output (skip sparse heuristics) + const userControlled = requestedDepth !== undefined || !!focusRefId; + + try { + // Tip text returned to callers to guide next action + const standardTips = + "If the specific element you need is missing from the returned data, use the 'screenshot' tool to capture the current viewport and confirm the element's on-screen coordinates. Also note: 'markedElements' are user-marked elements and have the highest priority when choosing targets."; + + const explicit = await this.tryGetTab(args?.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args?.windowId)); + if (!tab.id) + return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND + ': Active tab has no ID'); + + // Load any user-marked elements for this URL (priority hints) + const currentUrl = String(tab.url || ''); + const userMarkers = currentUrl ? await listMarkersForUrl(currentUrl) : []; + + // Inject helper in ISOLATED world to enable chrome.runtime messaging + // Inject into all frames to support same-origin iframe operations + await this.injectContentScript( + tab.id, + ['inject-scripts/accessibility-tree-helper.js'], + false, + 'ISOLATED', + true, + ); + + // Ask content script to generate accessibility tree + const resp = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.GENERATE_ACCESSIBILITY_TREE, + filter: filter || null, + depth: requestedDepth, + refId: focusRefId || undefined, + }); + + // Evaluate tree result and decide whether to fallback + const treeOk = resp && resp.success === true; + const pageContent: string = + resp && typeof resp.pageContent === 'string' ? resp.pageContent : ''; + + // Extract stats from response + const stats: ReadPageStats | null = + treeOk && resp?.stats + ? { + processed: resp.stats.processed ?? 0, + included: resp.stats.included ?? 0, + durationMs: resp.stats.durationMs ?? 0, + } + : null; + + const lines = pageContent + ? pageContent.split('\n').filter((l: string) => l.trim().length > 0).length + : 0; + const refCount = Array.isArray(resp?.refMap) ? resp.refMap.length : 0; + + // Skip sparse heuristics when user explicitly controls output + const isSparse = !userControlled && lines < 10 && refCount < 3; + + // Build user-marked elements for inclusion + const markedElements = userMarkers.map((m) => ({ + name: m.name, + selector: m.selector, + selectorType: m.selectorType || 'css', + urlMatch: { type: m.matchType, origin: m.origin, path: m.path }, + source: 'marker', + priority: 'highest', + })); + + // Helper to convert elements array to pageContent format + const formatElementsAsPageContent = (elements: any[]): string => { + const out: string[] = []; + for (const e of elements || []) { + const type = typeof e?.type === 'string' && e.type ? e.type : 'element'; + const rawText = typeof e?.text === 'string' ? e.text.trim() : ''; + const text = + rawText.length > 0 + ? ` "${rawText.replace(/\s+/g, ' ').slice(0, 100).replace(/"/g, '\\"')}"` + : ''; + const selector = + typeof e?.selector === 'string' && e.selector ? ` selector="${e.selector}"` : ''; + const coords = + e?.coordinates && Number.isFinite(e.coordinates.x) && Number.isFinite(e.coordinates.y) + ? ` (x=${Math.round(e.coordinates.x)},y=${Math.round(e.coordinates.y)})` + : ''; + out.push(`- ${type}${text}${selector}${coords}`); + if (out.length >= 150) break; + } + return out.join('\n'); + }; + + // Unified base payload structure - consistent keys for stable contract + const basePayload: Record = { + success: true, + filter: filter || 'all', + pageContent, + tips: standardTips, + viewport: treeOk ? resp.viewport : { width: null, height: null, dpr: null }, + stats: stats || { processed: 0, included: 0, durationMs: 0 }, + refMapCount: refCount, + sparse: treeOk ? isSparse : false, + depth: requestedDepth ?? null, + focus: focusRefId ? { refId: focusRefId, found: treeOk } : null, + markedElements, + elements: [], + count: 0, + fallbackUsed: false, + fallbackSource: null, + reason: null, + }; + + // Normal path: return tree + if (treeOk && !isSparse) { + return { + content: [{ type: 'text', text: JSON.stringify(basePayload) }], + isError: false, + }; + } + + // When refId is explicitly provided, do not fallback (refs are frame-local and may expire) + if (focusRefId) { + return createErrorResponse(resp?.error || `refId "${focusRefId}" not found or expired`); + } + + // When user explicitly controls depth, do not override with fallback heuristics + if (requestedDepth !== undefined) { + return createErrorResponse(resp?.error || 'Failed to generate accessibility tree'); + } + + // Fallback path: try get_interactive_elements once + try { + await this.injectContentScript(tab.id, ['inject-scripts/interactive-elements-helper.js']); + const fallback = await this.sendMessageToTab(tab.id, { + action: TOOL_MESSAGE_TYPES.GET_INTERACTIVE_ELEMENTS, + includeCoordinates: true, + }); + + if (fallback && fallback.success && Array.isArray(fallback.elements)) { + const limited = fallback.elements.slice(0, 150); + // Merge user markers at the front, de-duplicated by selector + const markerEls = userMarkers.map((m) => ({ + type: 'marker', + selector: m.selector, + text: m.name, + selectorType: m.selectorType || 'css', + isInteractive: true, + source: 'marker', + priority: 'highest', + })); + const seen = new Set(markerEls.map((e) => e.selector)); + const merged = [...markerEls, ...limited.filter((e: any) => !seen.has(e.selector))]; + + basePayload.fallbackUsed = true; + basePayload.fallbackSource = 'get_interactive_elements'; + basePayload.reason = treeOk ? 'sparse_tree' : resp?.error || 'tree_failed'; + basePayload.elements = merged; + basePayload.count = fallback.elements.length; + if (!basePayload.pageContent) { + basePayload.pageContent = formatElementsAsPageContent(merged); + } + + return { + content: [{ type: 'text', text: JSON.stringify(basePayload) }], + isError: false, + }; + } + } catch (fallbackErr) { + console.warn('read_page fallback failed:', fallbackErr); + } + + // If we reach here, both tree (usable) and fallback failed + return createErrorResponse( + treeOk + ? 'Accessibility tree is too sparse and fallback failed' + : resp?.error || 'Failed to generate accessibility tree and fallback failed', + ); + } catch (error) { + console.error('Error in read page tool:', error); + return createErrorResponse( + `Error generating accessibility tree: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } +} + +export const readPageTool = new ReadPageTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/screenshot.ts b/app/chrome-extension/entrypoints/background/tools/browser/screenshot.ts index e989246d..bb492650 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/screenshot.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/screenshot.ts @@ -2,7 +2,6 @@ import { createErrorResponse, ToolResult } from '@/common/tool-handler'; import { BaseBrowserToolExecutor } from '../base-browser'; import { TOOL_NAMES } from 'chrome-mcp-shared'; import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; -import { TIMEOUTS, ERROR_MESSAGES } from '@/common/constants'; import { canvasToDataURL, createImageBitmapFromUrl, @@ -10,6 +9,7 @@ import { stitchImages, compressImage, } from '../../../../utils/image-utils'; +import { screenshotContextManager } from '@/utils/screenshot-context'; // Screenshot-specific constants const SCREENSHOT_CONSTANTS = { @@ -28,11 +28,27 @@ const SCREENSHOT_CONSTANTS = { readonly SCRIPT_INIT_DELAY: number; }; -SCREENSHOT_CONSTANTS["CAPTURE_STITCH_DELAY_MS"] = Math.max(1000 / chrome.tabs.MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND - SCREENSHOT_CONSTANTS.SCROLL_DELAY_MS, SCREENSHOT_CONSTANTS.CAPTURE_STITCH_DELAY_MS) +// Adjust CAPTURE_STITCH_DELAY_MS to respect Chrome's capture rate if available in runtime +// Some TS typings don't expose MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND; use a safe cast with a sane fallback. +const __MAX_CAP_RATE: number | undefined = (chrome.tabs as any) + ?.MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND; +if (typeof __MAX_CAP_RATE === 'number' && __MAX_CAP_RATE > 0) { + // Minimum interval between consecutive captureVisibleTab calls (ms) + const minIntervalMs = Math.ceil(1000 / __MAX_CAP_RATE); + // Our capture loop already waits SCROLL_DELAY_MS between scroll and capture; add any extra delay needed + const requiredExtraDelay = Math.max(0, minIntervalMs - SCREENSHOT_CONSTANTS.SCROLL_DELAY_MS); + SCREENSHOT_CONSTANTS.CAPTURE_STITCH_DELAY_MS = Math.max( + requiredExtraDelay, + SCREENSHOT_CONSTANTS.CAPTURE_STITCH_DELAY_MS, + ); +} interface ScreenshotToolParams { name: string; selector?: string; + tabId?: number; + background?: boolean; + windowId?: number; width?: number; height?: number; storeBase64?: boolean; @@ -41,6 +57,51 @@ interface ScreenshotToolParams { maxHeight?: number; // Maximum height to capture in pixels (for infinite scroll pages) } +/** Page details returned by screenshot-helper content script */ +interface ScreenshotPageDetails { + totalWidth: number; + totalHeight: number; + viewportWidth: number; + viewportHeight: number; + devicePixelRatio: number; + currentScrollX: number; + currentScrollY: number; +} + +const PAGE_DETAILS_REQUIRED_FIELDS: Array = [ + 'totalWidth', + 'totalHeight', + 'viewportWidth', + 'viewportHeight', + 'devicePixelRatio', + 'currentScrollX', + 'currentScrollY', +]; + +/** + * Validates and asserts that the response from content script contains valid page details + */ +function assertValidPageDetails(details: unknown): ScreenshotPageDetails { + if (!details || typeof details !== 'object') { + throw new Error( + 'Screenshot helper did not respond. The content script may not be injected or cannot run on this page.', + ); + } + + const candidate = details as Partial; + const invalidFields = PAGE_DETAILS_REQUIRED_FIELDS.filter( + (field) => typeof candidate[field] !== 'number' || !Number.isFinite(candidate[field]), + ); + + if (invalidFields.length > 0) { + throw new Error( + `Screenshot helper returned invalid page details (missing/invalid: ${invalidFields.join(', ')}).`, + ); + } + + return candidate as ScreenshotPageDetails; +} + /** * Tool for capturing screenshots of web pages */ @@ -61,12 +122,9 @@ class ScreenshotTool extends BaseBrowserToolExecutor { console.log(`Starting screenshot with options:`, args); - // Get current tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); - if (!tabs[0]) { - return createErrorResponse(ERROR_MESSAGES.TAB_NOT_FOUND); - } - const tab = tabs[0]; + // Resolve target tab (explicit or active) + const explicit = await this.tryGetTab(args.tabId); + const tab = explicit || (await this.getActiveTabOrThrowInWindow(args.windowId)); // Check URL restrictions if ( @@ -81,35 +139,117 @@ class ScreenshotTool extends BaseBrowserToolExecutor { } let finalImageDataUrl: string | undefined; + let finalImageWidthCss: number | undefined; + let finalImageHeightCss: number | undefined; const results: any = { base64: null, fileSaved: false }; - let originalScroll = { x: 0, y: 0 }; + let originalScroll: { x: number; y: number } | null = null; + let didPreparePage = false; + let pageDetails: ScreenshotPageDetails | undefined; try { - await this.injectContentScript(tab.id!, ['inject-scripts/screenshot-helper.js']); - // Wait for script initialization - await new Promise((resolve) => setTimeout(resolve, SCREENSHOT_CONSTANTS.SCRIPT_INIT_DELAY)); - // 1. Prepare page (hide scrollbars, potentially fixed elements) - await this.sendMessageToTab(tab.id!, { - action: TOOL_MESSAGE_TYPES.SCREENSHOT_PREPARE_PAGE_FOR_CAPTURE, - options: { fullPage }, - }); - - // Get initial page details, including original scroll position - const pageDetails = await this.sendMessageToTab(tab.id!, { - action: TOOL_MESSAGE_TYPES.SCREENSHOT_GET_PAGE_DETAILS, - }); - originalScroll = { x: pageDetails.currentScrollX, y: pageDetails.currentScrollY }; - - if (fullPage) { - this.logInfo('Capturing full page...'); - finalImageDataUrl = await this._captureFullPage(tab.id!, args, pageDetails); - } else if (selector) { - this.logInfo(`Capturing element: ${selector}`); - finalImageDataUrl = await this._captureElement(tab.id!, args, pageDetails.devicePixelRatio); - } else { - // Visible area only - this.logInfo('Capturing visible area...'); - finalImageDataUrl = await chrome.tabs.captureVisibleTab(tab.windowId, { format: 'png' }); + const background = args.background === true; + // CDP path: background=true with simple viewport capture (no fullPage, no selector) + const canUseCdpCapture = background && !fullPage && !selector; + + // === Path 1: CDP viewport capture (no content script needed) === + if (canUseCdpCapture) { + try { + const tabId = tab.id!; + const { cdpSessionManager } = await import('@/utils/cdp-session-manager'); + await cdpSessionManager.withSession(tabId, 'screenshot', async () => { + const metrics: any = await cdpSessionManager.sendCommand( + tabId, + 'Page.getLayoutMetrics', + {}, + ); + const viewport = metrics?.layoutViewport || + metrics?.visualViewport || { + clientWidth: 800, + clientHeight: 600, + pageX: 0, + pageY: 0, + }; + const shot: any = await cdpSessionManager.sendCommand(tabId, 'Page.captureScreenshot', { + format: 'png', + }); + const base64Data = typeof shot?.data === 'string' ? shot.data : ''; + if (!base64Data) { + throw new Error('CDP Page.captureScreenshot returned empty data'); + } + finalImageDataUrl = `data:image/png;base64,${base64Data}`; + finalImageWidthCss = Math.round(viewport.clientWidth || 800); + finalImageHeightCss = Math.round(viewport.clientHeight || 600); + }); + } catch (e) { + console.warn('CDP viewport capture failed, falling back to helper path:', e); + } + } + + // === Path 2: Helper-assisted capture (requires content script) === + if (!finalImageDataUrl) { + // Always inject helper when we need pageDetails + await this.injectContentScript(tab.id!, ['inject-scripts/screenshot-helper.js']); + await new Promise((resolve) => setTimeout(resolve, SCREENSHOT_CONSTANTS.SCRIPT_INIT_DELAY)); + + // Prepare page (hide scrollbars, handle fixed elements) + const prepareResp = await this.sendMessageToTab(tab.id!, { + action: TOOL_MESSAGE_TYPES.SCREENSHOT_PREPARE_PAGE_FOR_CAPTURE, + options: { fullPage }, + }); + if (!prepareResp || prepareResp.success !== true) { + throw new Error( + 'Screenshot helper did not acknowledge page preparation. The content script may not be injected or cannot run on this page.', + ); + } + didPreparePage = true; + + // Get page details with validation + const rawPageDetails = await this.sendMessageToTab(tab.id!, { + action: TOOL_MESSAGE_TYPES.SCREENSHOT_GET_PAGE_DETAILS, + }); + pageDetails = assertValidPageDetails(rawPageDetails); + originalScroll = { x: pageDetails.currentScrollX, y: pageDetails.currentScrollY }; + + if (fullPage) { + this.logInfo('Capturing full page...'); + finalImageDataUrl = await this._captureFullPage(tab.id!, args, pageDetails); + // Compute final CSS size + if (args.width && args.height) { + finalImageWidthCss = args.width; + finalImageHeightCss = args.height; + } else if (args.width && !args.height) { + finalImageWidthCss = args.width; + const ratio = pageDetails.totalHeight / pageDetails.totalWidth; + finalImageHeightCss = Math.round(args.width * ratio); + } else if (!args.width && args.height) { + finalImageHeightCss = args.height; + const ratio = pageDetails.totalWidth / pageDetails.totalHeight; + finalImageWidthCss = Math.round(args.height * ratio); + } else { + finalImageWidthCss = pageDetails.totalWidth; + finalImageHeightCss = pageDetails.totalHeight; + } + } else if (selector) { + this.logInfo(`Capturing element: ${selector}`); + finalImageDataUrl = await this._captureElement( + tab.id!, + args, + pageDetails.devicePixelRatio, + ); + if (args.width && args.height) { + finalImageWidthCss = args.width; + finalImageHeightCss = args.height; + } else { + finalImageWidthCss = pageDetails.viewportWidth; + finalImageHeightCss = pageDetails.viewportHeight; + } + } else { + // Visible area only + this.logInfo('Capturing visible area...'); + finalImageDataUrl = await chrome.tabs.captureVisibleTab(tab.windowId, { format: 'png' }); + finalImageWidthCss = pageDetails.viewportWidth; + finalImageHeightCss = pageDetails.viewportHeight; + } } if (!finalImageDataUrl) { @@ -117,6 +257,30 @@ class ScreenshotTool extends BaseBrowserToolExecutor { } // 2. Process output + // Update screenshot context for coordinate scaling by tools like chrome_computer + try { + if (typeof finalImageWidthCss === 'number' && typeof finalImageHeightCss === 'number') { + let hostname = ''; + try { + hostname = tab.url ? new URL(tab.url).hostname : ''; + } catch { + // ignore + } + // Use pageDetails if available, otherwise fall back to final image dimensions + const viewportWidth = pageDetails?.viewportWidth ?? finalImageWidthCss; + const viewportHeight = pageDetails?.viewportHeight ?? finalImageHeightCss; + screenshotContextManager.setContext(tab.id!, { + screenshotWidth: finalImageWidthCss, + screenshotHeight: finalImageHeightCss, + viewportWidth, + viewportHeight, + devicePixelRatio: pageDetails?.devicePixelRatio, + hostname, + }); + } + } catch (e) { + console.warn('Failed to set screenshot context:', e); + } if (storeBase64 === true) { // Compress image for base64 output to reduce size const compressed = await compressImage(finalImageDataUrl, { @@ -183,15 +347,21 @@ class ScreenshotTool extends BaseBrowserToolExecutor { `Screenshot error: ${error instanceof Error ? error.message : JSON.stringify(error)}`, ); } finally { - // 3. Reset page - try { - await this.sendMessageToTab(tab.id!, { - action: TOOL_MESSAGE_TYPES.SCREENSHOT_RESET_PAGE_AFTER_CAPTURE, - scrollX: originalScroll.x, - scrollY: originalScroll.y, - }); - } catch (err) { - console.warn('Failed to reset page, tab might have closed:', err); + // 3. Reset page only if we prepared it + if (didPreparePage) { + try { + // Only include scroll position if we successfully captured it + const resetMessage: Record = { + action: TOOL_MESSAGE_TYPES.SCREENSHOT_RESET_PAGE_AFTER_CAPTURE, + }; + if (originalScroll) { + resetMessage.scrollX = originalScroll.x; + resetMessage.scrollY = originalScroll.y; + } + await this.sendMessageToTab(tab.id!, resetMessage); + } catch (err) { + console.warn('Failed to reset page, tab might have closed:', err); + } } } diff --git a/app/chrome-extension/entrypoints/background/tools/browser/userscript.ts b/app/chrome-extension/entrypoints/background/tools/browser/userscript.ts new file mode 100644 index 00000000..dc89d553 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/browser/userscript.ts @@ -0,0 +1,758 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { BaseBrowserToolExecutor } from '../base-browser'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { ExecutionWorld, STORAGE_KEYS } from '@/common/constants'; +import { cdpSessionManager } from '@/utils/cdp-session-manager'; + +type UserscriptAction = + | 'create' + | 'list' + | 'get' + | 'enable' + | 'disable' + | 'update' + | 'remove' + | 'send_command' + | 'export'; + +interface UserscriptArgsBase { + action: UserscriptAction; + args?: any; +} + +interface CreateArgs { + script: string; + name?: string; + description?: string; + matches?: string[]; + excludes?: string[]; + persist?: boolean; // default true + runAt?: 'document_start' | 'document_end' | 'document_idle' | 'auto'; // default auto(document_idle) + world?: 'auto' | 'ISOLATED' | 'MAIN'; // default auto(ISOLATED) + allFrames?: boolean; // default true + mode?: 'auto' | 'css' | 'persistent' | 'once'; // default auto + dnrFallback?: boolean; // default true + tags?: string[]; +} + +type UpdateArgs = Partial> & { id: string; script?: string }; + +interface UserscriptRecord { + id: string; + name?: string; + description?: string; + script: string; + sourceType: 'JS' | 'CSS' | 'TM'; + matches: string[]; + excludes: string[]; + runAt: 'document_start' | 'document_end' | 'document_idle'; + world: 'ISOLATED' | 'MAIN'; + allFrames: boolean; + persist: boolean; + dnrFallback: boolean; + tags?: string[]; + enabled: boolean; + createdAt: number; + updatedAt: number; + installedBy?: string; + lastError?: string; + applyCount?: number; + lastAppliedAt?: number; + sha256?: string; + cspBlocked?: boolean; +} + +// In-memory tracking of active injections per tab +type ActiveInjection = { kind: 'css' | 'js'; world?: 'ISOLATED' | 'MAIN' }; +const activeInjections: Map> = new Map(); + +async function loadAllRecords(): Promise> { + const res = await chrome.storage.local.get([STORAGE_KEYS.USERSCRIPTS]); + return (res[STORAGE_KEYS.USERSCRIPTS] as Record) || {}; +} + +async function saveAllRecords(records: Record): Promise { + await chrome.storage.local.set({ [STORAGE_KEYS.USERSCRIPTS]: records }); +} + +// Simple FNV-1a hash for deterministic IDs +function fnv1a(str: string): string { + let h = 0x811c9dc5; + for (let i = 0; i < str.length; i++) { + h ^= str.charCodeAt(i); + h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24); + } + // Force to unsigned and hex + return (h >>> 0).toString(16); +} + +function now(): number { + return Date.now(); +} + +async function computeSHA256(input: string): Promise { + const enc = new TextEncoder().encode(input); + const digest = await crypto.subtle.digest('SHA-256', enc); + const bytes = Array.from(new Uint8Array(digest)); + return bytes.map((b) => b.toString(16).padStart(2, '0')).join(''); +} + +async function probeUnsafeEvalInMain(tabId: number): Promise { + try { + const res = await chrome.scripting.executeScript({ + target: { tabId, allFrames: false }, + world: ExecutionWorld.MAIN, + func: () => { + try { + // If page CSP blocks unsafe-eval, this will throw + return !!new Function('return 1')(); + } catch { + return false; + } + }, + }); + return Array.isArray(res) && res[0] && (res[0] as any).result === true; + } catch { + return false; + } +} + +// Basic TM header parser (subset) +function parseUserscriptMeta(source: string): { + meta: Record; + isTM: boolean; +} { + const meta: Record = {}; + const start = source.indexOf('==UserScript=='); + const end = source.indexOf('==/UserScript=='); + if (start !== -1 && end !== -1 && end > start) { + const block = source.slice(start, end).split(/\r?\n/); + for (const line of block) { + const m = line.match(/@([\w-]+)\s+(.+)/); + if (m) { + const k = m[1].trim(); + const v = m[2].trim(); + if (!meta[k]) meta[k] = []; + meta[k].push(v); + } + } + return { meta, isTM: true }; + } + return { meta: {}, isTM: false }; +} + +function pick(arr: T[] | undefined): T | undefined { + return arr && arr.length > 0 ? arr[0] : undefined; +} + +function deriveName(meta: Record, fallback?: string): string | undefined { + return pick(meta['name']) || fallback; +} + +function toBoolean(val: any, d: boolean): boolean { + return typeof val === 'boolean' ? val : d; +} + +// Very light CSS heuristic +function isLikelyCSS(source: string): boolean { + const trimmed = source.trim(); + if (trimmed.startsWith('/*') && trimmed.includes('==UserStyle')) return true; + if (/^[.#\w\-\s*,:>+~\n\r{}();'"%!@/]+$/.test(trimmed)) { + // no obvious JS keywords + if ( + !/(function|=>|var\s|let\s|const\s|document\.|window\.|\beval\b|new\s+Function)/.test(trimmed) + ) { + // has CSS braces and colons + const colon = (trimmed.match(/:/g) || []).length; + const brace = (trimmed.match(/[{}]/g) || []).length; + return colon > 0 && brace >= 2; + } + } + return false; +} + +function normalizeMatches(matches?: string[], currentUrl?: string): string[] { + if (matches && matches.length > 0) return matches; + if (!currentUrl) return ['']; + try { + const u = new URL(currentUrl); + const host = u.hostname; + const base = host.startsWith('www.') ? host.slice(4) : host; + return [`${u.protocol}//*.${base}/*`, `${u.protocol}//${host}/*`]; + } catch { + return ['']; + } +} + +// Simple URL match using chrome match patterns subset +function matchUrl(patterns: string[], url?: string): boolean { + if (!url) return false; + try { + const u = new URL(url); + for (const p of patterns) { + if (p === '') return true; + const m = p.match(/^(\*|https?:)\/\/([^/]+)\/(.*)$/); + if (!m) continue; + const proto = m[1]; + const host = m[2]; + const path = m[3]; + if (proto !== '*' && proto !== u.protocol.replace(':', '')) continue; + // host wildcard + const hostRegex = new RegExp( + '^' + + host + .split('.') + .map((h) => (h === '*' ? '[^.]+' : h.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&'))) + .join('\\.') + + '$', + ); + if (!hostRegex.test(u.hostname)) continue; + // path wildcard + const pathRegex = new RegExp( + '^' + path.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*') + '$', + ); + const testPath = (u.pathname + (u.search || '') + (u.hash || '')).replace(/^\//, ''); + if (pathRegex.test(testPath)) return true; + } + } catch { + return false; + } + return false; +} + +async function getActiveTab(): Promise { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + return tabs[0] || null; +} + +async function insertCssToTab(tabId: number, css: string, allFrames: boolean) { + await chrome.scripting.insertCSS({ target: { tabId, allFrames }, css }); +} + +async function removeCssFromTab(tabId: number, css: string, allFrames: boolean) { + try { + await chrome.scripting.removeCSS({ target: { tabId, allFrames }, css }); + } catch (e) { + // ignore if not present + } +} + +async function injectJsPersistent( + tabId: number, + code: string, + world: 'ISOLATED' | 'MAIN', + allFrames: boolean, +) { + if (world === ExecutionWorld.MAIN) { + // Ensure bridge is present in ISOLATED + await chrome.scripting.executeScript({ + target: { tabId, allFrames }, + files: ['inject-scripts/inject-bridge.js'], + world: ExecutionWorld.ISOLATED, + }); + // MAIN world code with command handler wrapper + const wrapped = `(() => { + try { + // Optional command API: window.__userscript_onCommand(action, payload) + window.addEventListener('chrome-mcp:execute', (ev) => { + const { action, payload, requestId } = ev.detail || {}; + try { + let result; + const handler = (window as any).__userscript_onCommand; + if (typeof handler === 'function') { + result = handler(action, payload); + } + window.dispatchEvent(new CustomEvent('chrome-mcp:response', { detail: { requestId, data: result } })); + } catch (err) { + window.dispatchEvent(new CustomEvent('chrome-mcp:response', { detail: { requestId, error: String(err && (err as any).message || err) } })); + } + }); + (new Function(${JSON.stringify(code)}))(); + } catch (e) { + console.warn('Userscript MAIN injection error:', e); + } + })();`; + await chrome.scripting.executeScript({ + target: { tabId, allFrames }, + func: (src) => { + try { + // Using Function constructor intentionally to evaluate user-provided script + new Function(src)(); + } catch (e) { + console.warn('Userscript MAIN wrapper execution error:', e); + } + }, + args: [wrapped], + world: ExecutionWorld.MAIN, + }); + } else { + // ISOLATED world code with message handler + await chrome.scripting.executeScript({ + target: { tabId, allFrames }, + func: (userCode) => { + try { + const handlerName = '__userscript_onCommand__'; + (chrome.runtime.onMessage as any).addListener( + (req: any, _sender: any, sendResponse: any) => { + if (!req || req.type !== 'userscript:command') return; + const { action, payload, scriptId } = req; + try { + const handler = (globalThis as any)[handlerName]; + let result; + if (typeof handler === 'function') { + result = handler(action, payload, scriptId); + } + sendResponse({ data: result }); + } catch (err) { + sendResponse({ error: String((err && (err as any).message) || err) }); + } + return true; + }, + ); + // Using Function constructor intentionally to evaluate user-provided script + new Function(userCode)(); + } catch (e) { + console.warn('Userscript ISOLATED injection error:', e); + } + }, + args: [code], + world: ExecutionWorld.ISOLATED, + }); + } +} + +function setActiveInjection(tabId: number, id: string, inj: ActiveInjection) { + let m = activeInjections.get(tabId); + if (!m) { + m = new Map(); + activeInjections.set(tabId, m); + } + m.set(id, inj); +} + +function clearActiveInjection(tabId: number, id: string) { + const m = activeInjections.get(tabId); + if (m) m.delete(id); +} + +async function reinjectForTab(tabId: number, url?: string) { + // Emergency global switch + const flag = (await chrome.storage.local.get([STORAGE_KEYS.USERSCRIPTS_DISABLED]))[ + STORAGE_KEYS.USERSCRIPTS_DISABLED + ]; + if (flag) return; + const all = await loadAllRecords(); + for (const rec of Object.values(all)) { + if (!rec.enabled || !rec.persist) continue; + if (!matchUrl(rec.matches, url)) continue; + try { + if (rec.sourceType === 'CSS') { + await insertCssToTab(tabId, rec.script, rec.allFrames); + setActiveInjection(tabId, rec.id, { kind: 'css' }); + } else { + // Probe CSP when targeting MAIN + if (rec.world === 'MAIN') { + const ok = await probeUnsafeEvalInMain(tabId); + if (!ok) { + rec.cspBlocked = true; + await injectJsPersistent(tabId, rec.script, 'ISOLATED', rec.allFrames); + setActiveInjection(tabId, rec.id, { kind: 'js', world: 'ISOLATED' }); + continue; + } + } + await injectJsPersistent(tabId, rec.script, rec.world, rec.allFrames); + setActiveInjection(tabId, rec.id, { kind: 'js', world: rec.world }); + } + } catch (e) { + console.warn('Reinject failed for tab', tabId, rec.id, e); + } + } +} + +// Tab update listener: re-apply enabled persistent scripts +chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => { + if (changeInfo.status === 'complete') { + reinjectForTab(tabId, tab.url).catch(() => {}); + } +}); + +// webNavigation based runAt mapping +chrome.webNavigation.onCommitted.addListener(async (details) => { + if (details.frameId !== 0) return; + const tab = await chrome.tabs.get(details.tabId).catch(() => null); + if (!tab) return; + const disabled = (await chrome.storage.local.get([STORAGE_KEYS.USERSCRIPTS_DISABLED]))[ + STORAGE_KEYS.USERSCRIPTS_DISABLED + ]; + if (disabled) return; + const all = await loadAllRecords(); + for (const rec of Object.values(all)) { + if (!rec.enabled || !rec.persist || rec.runAt !== 'document_start') continue; + if (!matchUrl(rec.matches, tab.url)) continue; + try { + if (rec.sourceType === 'CSS') await insertCssToTab(details.tabId, rec.script, rec.allFrames); + else await injectJsPersistent(details.tabId, rec.script, rec.world, rec.allFrames); + } catch { + // noop + } + } +}); + +chrome.webNavigation.onDOMContentLoaded.addListener(async (details) => { + if (details.frameId !== 0) return; + const tab = await chrome.tabs.get(details.tabId).catch(() => null); + if (!tab) return; + const disabled = (await chrome.storage.local.get([STORAGE_KEYS.USERSCRIPTS_DISABLED]))[ + STORAGE_KEYS.USERSCRIPTS_DISABLED + ]; + if (disabled) return; + const all = await loadAllRecords(); + for (const rec of Object.values(all)) { + if (!rec.enabled || !rec.persist || rec.runAt !== 'document_end') continue; + if (!matchUrl(rec.matches, tab.url)) continue; + try { + if (rec.sourceType === 'CSS') await insertCssToTab(details.tabId, rec.script, rec.allFrames); + else await injectJsPersistent(details.tabId, rec.script, rec.world, rec.allFrames); + } catch { + // noop + } + } +}); + +class UserscriptTool extends BaseBrowserToolExecutor { + name = TOOL_NAMES.BROWSER.USERSCRIPT; + + async execute(params: UserscriptArgsBase): Promise { + try { + const { action } = params; + const args = params.args || {}; + + switch (action) { + case 'create': + return await this.create(args as CreateArgs); + case 'list': + return await this.list(args); + case 'get': + return await this.get(args); + case 'enable': + return await this.enable(args, true); + case 'disable': + return await this.enable(args, false); + case 'update': + return await this.update(args as UpdateArgs); + case 'remove': + return await this.remove(args); + case 'send_command': + return await this.sendCommand(args); + case 'export': + return await this.exportAll(); + default: + return createErrorResponse(`Unknown action: ${String(action)}`); + } + } catch (error) { + console.error('Userscript tool error:', error); + return createErrorResponse( + `Userscript error: ${error instanceof Error ? error.message : String(error)}`, + ); + } + } + + private async create(args: CreateArgs): Promise { + const active = await getActiveTab(); + if (!active || !active.id) return createErrorResponse('No active tab found'); + const currentUrl = active.url; + + const emergency = (await chrome.storage.local.get([STORAGE_KEYS.USERSCRIPTS_DISABLED]))[ + STORAGE_KEYS.USERSCRIPTS_DISABLED + ]; + + const { meta, isTM } = parseUserscriptMeta(args.script); + const name = args.name || deriveName(meta, undefined); + const description = args.description || pick(meta['description']); + const matches = normalizeMatches(args.matches || meta['match'] || meta['include'], currentUrl); + const excludes = args.excludes || meta['exclude'] || []; + + const runAt: UserscriptRecord['runAt'] = + (args.runAt && args.runAt !== 'auto' ? args.runAt : (pick(meta['run-at']) as any)) || + 'document_idle'; + const requestedWorld = + (args.world && args.world !== 'auto' ? args.world : (pick(meta['inject-into']) as any)) || + 'ISOLATED'; + const allFrames = toBoolean(args.allFrames, true); + const persist = toBoolean(args.persist, true); + const dnrFallback = toBoolean(args.dnrFallback, true); + const mode = args.mode || 'auto'; + + const sourceType: UserscriptRecord['sourceType'] = isTM + ? 'TM' + : mode === 'css' || isLikelyCSS(args.script) + ? 'CSS' + : 'JS'; + + const sha256 = await computeSHA256(args.script).catch(() => undefined); + const id = `us_${fnv1a((name || '') + '|' + args.script)}`; + + const record: UserscriptRecord = { + id, + name, + description, + script: args.script, + sourceType, + matches, + excludes, + runAt, + world: requestedWorld === 'MAIN' ? 'MAIN' : 'ISOLATED', + allFrames, + persist, + dnrFallback, + tags: args.tags, + enabled: true, + createdAt: now(), + updatedAt: now(), + applyCount: 0, + sha256, + }; + + const all = await loadAllRecords(); + if (record.persist) { + all[id] = record; + await saveAllRecords(all); + } + + // Apply to current tab immediately if matches + let applied = false; + const fallbacks: string[] = []; + let cspBlocked = false; + const t0 = performance.now(); + try { + if (mode === 'once') { + // Once: CDP evaluate in page + await cdpSessionManager.withSession(active.id!, 'userscript_once', async () => { + const expression = `(function(){try{return (function(){${record.script}\n})()}catch(e){return {__error:String(e&&e.message||e)}}})()`; + const result: any = await cdpSessionManager.sendCommand(active.id!, 'Runtime.evaluate', { + expression, + returnByValue: true, + awaitPromise: true, + }); + if (result?.result?.value?.__error) { + throw new Error(result.result.value.__error); + } + }); + applied = true; + } else if (sourceType === 'CSS') { + await insertCssToTab(active.id!, record.script, record.allFrames); + setActiveInjection(active.id!, id, { kind: 'css' }); + applied = true; + } else { + // Probe CSP preflight when target MAIN + if (record.world === 'MAIN') { + const ok = await probeUnsafeEvalInMain(active.id!); + if (!ok) { + cspBlocked = true; + fallbacks.push('MAIN->ISOLATED'); + await injectJsPersistent(active.id!, record.script, 'ISOLATED', record.allFrames); + setActiveInjection(active.id!, id, { kind: 'js', world: 'ISOLATED' }); + applied = true; + } + } + if (!applied) { + await injectJsPersistent(active.id!, record.script, record.world, record.allFrames); + setActiveInjection(active.id!, id, { kind: 'js', world: record.world }); + applied = true; + } + } + } catch (e) { + if (record.persist) { + all[id].lastError = e instanceof Error ? e.message : String(e); + all[id].cspBlocked = cspBlocked; + await saveAllRecords(all); + } + } + + const result = { + id, + status: record.persist && all[id]?.lastError ? 'queued' : applied ? 'applied' : 'queued', + strategy: { + kind: + mode === 'once' + ? 'once_cdp' + : sourceType === 'CSS' + ? 'insertCSS' + : `persistent_${(record.persist ? all[id]?.world || record.world : record.world).toLowerCase()}`, + runAt: record.persist ? all[id]?.runAt || record.runAt : record.runAt, + world: record.persist ? all[id]?.world || record.world : record.world, + allFrames: record.persist ? (all[id]?.allFrames ?? record.allFrames) : record.allFrames, + fallbacksTried: fallbacks, + cspBlocked, + }, + warnings: emergency ? ['USERSCRIPTS_DISABLED is ON, injection skipped'] : [], + metrics: { injectMs: Math.round(performance.now() - t0) }, + }; + + return { + content: [{ type: 'text', text: JSON.stringify(result) }], + isError: false, + }; + } + + private async list(args: any): Promise { + const all = await loadAllRecords(); + const q = (args && args.query ? String(args.query).toLowerCase() : '').trim(); + const status = args && args.status ? String(args.status) : ''; + const domain = args && args.domain ? String(args.domain) : ''; + const items = Object.values(all) + .filter((r) => (status ? (status === 'enabled' ? r.enabled : !r.enabled) : true)) + .filter((r) => (domain ? matchUrl(r.matches, `https://${domain}/`) : true)) + .filter((r) => + q + ? (r.name || '').toLowerCase().includes(q) || + (r.description || '').toLowerCase().includes(q) + : true, + ) + .map((r) => ({ + id: r.id, + name: r.name, + status: r.enabled ? 'enabled' : 'disabled', + sourceType: r.sourceType, + matches: r.matches, + world: r.world, + runAt: r.runAt, + tags: r.tags || [], + lastError: r.lastError, + updatedAt: r.updatedAt, + applyCount: r.applyCount || 0, + lastAppliedAt: r.lastAppliedAt || null, + })); + return { + content: [{ type: 'text', text: JSON.stringify({ ok: true, items }) }], + isError: false, + }; + } + + private async get(args: any): Promise { + const { id } = args || {}; + if (!id) return createErrorResponse('id is required'); + const all = await loadAllRecords(); + const rec = all[id]; + if (!rec) return createErrorResponse('userscript not found'); + return { + content: [{ type: 'text', text: JSON.stringify({ ok: true, record: rec }) }], + isError: false, + }; + } + + private async enable(args: any, enabled: boolean): Promise { + const { id } = args || {}; + if (!id) return createErrorResponse('id is required'); + const all = await loadAllRecords(); + const rec = all[id]; + if (!rec) return createErrorResponse('userscript not found'); + rec.enabled = enabled; + rec.updatedAt = now(); + await saveAllRecords(all); + return { content: [{ type: 'text', text: JSON.stringify({ ok: true }) }], isError: false }; + } + + private async update(args: UpdateArgs): Promise { + const { id, ...rest } = args; + if (!id) return createErrorResponse('id is required'); + const all = await loadAllRecords(); + const rec = all[id]; + if (!rec) return createErrorResponse('userscript not found'); + + if (rest.name !== undefined) rec.name = rest.name; + if (rest.description !== undefined) rec.description = rest.description; + if (rest.matches) rec.matches = rest.matches; + if (rest.excludes) rec.excludes = rest.excludes; + if (rest.runAt && rest.runAt !== 'auto') rec.runAt = rest.runAt; + if (rest.world && rest.world !== 'auto') rec.world = rest.world as any; + if (typeof rest.allFrames === 'boolean') rec.allFrames = rest.allFrames; + if (typeof rest.persist === 'boolean') rec.persist = rest.persist; + if (typeof rest.dnrFallback === 'boolean') rec.dnrFallback = rest.dnrFallback; + if (rest.tags) rec.tags = rest.tags; + if (typeof rest.script === 'string') rec.script = rest.script; + rec.updatedAt = now(); + await saveAllRecords(all); + return { content: [{ type: 'text', text: JSON.stringify({ ok: true }) }], isError: false }; + } + + private async remove(args: any): Promise { + const { id } = args || {}; + if (!id) return createErrorResponse('id is required'); + const all = await loadAllRecords(); + const rec = all[id]; + if (!rec) return createErrorResponse('userscript not found'); + delete all[id]; + await saveAllRecords(all); + + // Attempt cleanup on active tab + const active = await getActiveTab(); + if (active && active.id) { + try { + if (rec.sourceType === 'CSS') { + await removeCssFromTab(active.id, rec.script, rec.allFrames); + } else { + // Send cleanup signal via bridge (MAIN) or ignore if isolated + chrome.tabs.sendMessage(active.id, { type: 'chrome-mcp:cleanup' }).catch(() => {}); + } + clearActiveInjection(active.id, rec.id); + } catch (err) { + console.warn('Userscript cleanup failed:', err); + } + } + + return { content: [{ type: 'text', text: JSON.stringify({ ok: true }) }], isError: false }; + } + + private async sendCommand(args: any): Promise { + const { id, payload, tabId } = args || {}; + if (!id) return createErrorResponse('id is required'); + const tab = tabId ? await chrome.tabs.get(tabId).catch(() => null) : await getActiveTab(); + if (!tab || !tab.id) return createErrorResponse('No active tab found'); + + const all = await loadAllRecords(); + const rec = all[id]; + if (!rec) return createErrorResponse('userscript not found'); + + try { + if (rec.world === 'MAIN') { + // Use bridge + const result = await chrome.tabs.sendMessage(tab.id, { + action: 'userscript:command', + payload, + targetWorld: 'MAIN', + }); + return { + content: [{ type: 'text', text: JSON.stringify({ ok: true, result }) }], + isError: false, + }; + } else { + // ISOLATED handler + const result = await chrome.tabs.sendMessage(tab.id, { + type: 'userscript:command', + action: 'userscript:command', + payload, + scriptId: id, + }); + return { + content: [{ type: 'text', text: JSON.stringify({ ok: true, result }) }], + isError: false, + }; + } + } catch (e) { + return createErrorResponse( + `send_command failed: ${e instanceof Error ? e.message : String(e)}`, + ); + } + } + + private async exportAll(): Promise { + const all = await loadAllRecords(); + return { + content: [{ type: 'text', text: JSON.stringify({ ok: true, data: all }) }], + isError: false, + }; + } +} + +export const userscriptTool = new UserscriptTool(); diff --git a/app/chrome-extension/entrypoints/background/tools/browser/web-fetcher.ts b/app/chrome-extension/entrypoints/background/tools/browser/web-fetcher.ts index 794e3887..88e3f6ee 100644 --- a/app/chrome-extension/entrypoints/background/tools/browser/web-fetcher.ts +++ b/app/chrome-extension/entrypoints/background/tools/browser/web-fetcher.ts @@ -8,6 +8,9 @@ interface WebFetcherToolParams { textContent?: boolean; // get the visible text content of the current page. default: true url?: string; // optional URL to fetch content from (if not provided, uses active tab) selector?: string; // optional CSS selector to get content from a specific element + tabId?: number; // target existing tab id + background?: boolean; // do not activate/focus + windowId?: number; // target window id to pick active tab or create tab } class WebFetcherTool extends BaseBrowserToolExecutor { @@ -22,6 +25,9 @@ class WebFetcherTool extends BaseBrowserToolExecutor { const textContent = htmlContent ? false : args.textContent !== false; // Default is true, unless htmlContent is true or textContent is explicitly set to false const url = args.url; const selector = args.selector; + const explicitTabId = args.tabId; + const background = args.background === true; + const windowId = args.windowId; console.log(`Starting web fetcher with options:`, { htmlContent, @@ -34,7 +40,9 @@ class WebFetcherTool extends BaseBrowserToolExecutor { // Get tab to fetch content from let tab; - if (url) { + if (typeof explicitTabId === 'number') { + tab = await chrome.tabs.get(explicitTabId); + } else if (url) { // If URL is provided, check if it's already open console.log(`Checking if URL is already open: ${url}`); const allTabs = await chrome.tabs.query({}); @@ -54,15 +62,18 @@ class WebFetcherTool extends BaseBrowserToolExecutor { } else { // Create new tab with the URL console.log(`No existing tab found with URL: ${url}, creating new tab`); - tab = await chrome.tabs.create({ url, active: true }); + tab = await chrome.tabs.create({ url, active: background ? false : true }); // Wait for page to load console.log('Waiting for page to load...'); await new Promise((resolve) => setTimeout(resolve, 3000)); } } else { - // Use active tab - const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + // Use active tab (prefer specified window) + const tabs = + typeof windowId === 'number' + ? await chrome.tabs.query({ active: true, windowId }) + : await chrome.tabs.query({ active: true, currentWindow: true }); if (!tabs[0]) { return createErrorResponse('No active tab found'); } @@ -73,8 +84,11 @@ class WebFetcherTool extends BaseBrowserToolExecutor { return createErrorResponse('Tab has no ID'); } - // Make sure tab is active - await chrome.tabs.update(tab.id, { active: true }); + // Optionally bring tab/window to foreground + if (!background) { + await chrome.tabs.update(tab.id, { active: true }); + await chrome.windows.update(tab.windowId, { focused: true }); + } // Prepare result object const result: any = { diff --git a/app/chrome-extension/entrypoints/background/tools/index.ts b/app/chrome-extension/entrypoints/background/tools/index.ts index df5595e4..26253385 100644 --- a/app/chrome-extension/entrypoints/background/tools/index.ts +++ b/app/chrome-extension/entrypoints/background/tools/index.ts @@ -1,9 +1,10 @@ import { createErrorResponse } from '@/common/tool-handler'; import { ERROR_MESSAGES } from '@/common/constants'; import * as browserTools from './browser'; +import { flowRunTool, listPublishedFlowsTool } from './record-replay'; -const tools = { ...browserTools }; -const toolsMap = new Map(Object.values(tools).map((tool) => [tool.name, tool])); +const tools = { ...browserTools, flowRunTool, listPublishedFlowsTool } as any; +const toolsMap = new Map(Object.values(tools).map((tool: any) => [tool.name, tool])); /** * Tool call parameter interface diff --git a/app/chrome-extension/entrypoints/background/tools/record-replay.ts b/app/chrome-extension/entrypoints/background/tools/record-replay.ts new file mode 100644 index 00000000..9f262869 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/tools/record-replay.ts @@ -0,0 +1,61 @@ +import { createErrorResponse, ToolResult } from '@/common/tool-handler'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { listPublished } from '../record-replay/flow-store'; +import { getFlow } from '../record-replay/flow-store'; +import { runFlow } from '../record-replay/flow-runner'; + +class FlowRunTool { + name = TOOL_NAMES.RECORD_REPLAY.FLOW_RUN; + async execute(args: any): Promise { + const { + flowId, + args: vars, + tabTarget, + refresh, + captureNetwork, + returnLogs, + timeoutMs, + startUrl, + } = args || {}; + if (!flowId) return createErrorResponse('flowId is required'); + const flow = await getFlow(flowId); + if (!flow) return createErrorResponse(`Flow not found: ${flowId}`); + const result = await runFlow(flow, { + tabTarget, + refresh, + captureNetwork, + returnLogs, + timeoutMs, + startUrl, + args: vars, + }); + return { + content: [ + { + type: 'text', + text: JSON.stringify(result), + }, + ], + isError: false, + }; + } +} + +class ListPublishedTool { + name = TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED; + async execute(): Promise { + const list = await listPublished(); + return { + content: [ + { + type: 'text', + text: JSON.stringify({ success: true, published: list }), + }, + ], + isError: false, + }; + } +} + +export const flowRunTool = new FlowRunTool(); +export const listPublishedFlowsTool = new ListPublishedTool(); diff --git a/app/chrome-extension/entrypoints/background/utils/sidepanel.ts b/app/chrome-extension/entrypoints/background/utils/sidepanel.ts new file mode 100644 index 00000000..aa03abde --- /dev/null +++ b/app/chrome-extension/entrypoints/background/utils/sidepanel.ts @@ -0,0 +1,59 @@ +/** + * Sidepanel Utilities + * + * Shared helpers for opening and managing the Chrome sidepanel from background modules. + * Used by web-editor, quick-panel, and other modules that need to trigger sidepanel navigation. + */ + +/** + * Best-effort open the sidepanel with AgentChat tab selected. + * + * @param tabId - Tab ID to associate with sidepanel + * @param windowId - Optional window ID for fallback when tab-level open fails + * @param sessionId - Optional session ID to navigate directly to chat view (deep-link) + * + * @remarks + * This function is intentionally resilient - it will not throw on failures. + * Sidepanel availability varies across Chrome versions and contexts. + */ +export async function openAgentChatSidepanel( + tabId: number, + windowId?: number, + sessionId?: string, +): Promise { + try { + // Build deep-link path with optional session navigation + let path = 'sidepanel.html?tab=agent-chat'; + if (sessionId) { + path += `&view=chat&sessionId=${encodeURIComponent(sessionId)}`; + } + + // Configure sidepanel options for this tab + + const sidePanel = chrome.sidePanel as any; + + if (sidePanel?.setOptions) { + await sidePanel.setOptions({ + tabId, + path, + enabled: true, + }); + } + + // Attempt to open the sidepanel + if (sidePanel?.open) { + try { + await sidePanel.open({ tabId }); + } catch { + // Fallback to window-level open if tab-level fails + // This handles cases where the tab is in a special state + if (typeof windowId === 'number') { + await sidePanel.open({ windowId }); + } + } + } + } catch { + // Best-effort: side panel may be unavailable in some Chrome versions/environments + // Intentionally suppress errors to avoid breaking calling code + } +} diff --git a/app/chrome-extension/entrypoints/background/web-editor/index.ts b/app/chrome-extension/entrypoints/background/web-editor/index.ts new file mode 100644 index 00000000..6643fa61 --- /dev/null +++ b/app/chrome-extension/entrypoints/background/web-editor/index.ts @@ -0,0 +1,1641 @@ +import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; +import { + WEB_EDITOR_V2_ACTIONS, + WEB_EDITOR_V1_ACTIONS, + type ElementChangeSummary, + type WebEditorApplyBatchPayload, + type WebEditorTxChangedPayload, + type WebEditorHighlightElementPayload, + type WebEditorRevertElementPayload, + type WebEditorCancelExecutionPayload, + type WebEditorCancelExecutionResponse, +} from '@/common/web-editor-types'; +import { openAgentChatSidepanel } from '../utils/sidepanel'; + +const CONTEXT_MENU_ID = 'web_editor_toggle'; +const COMMAND_KEY = 'toggle_web_editor'; +const DEFAULT_NATIVE_SERVER_PORT = 12306; + +/** Storage key prefix for TX change session data (per-tab isolation) */ +const WEB_EDITOR_TX_CHANGED_SESSION_KEY_PREFIX = 'web-editor-v2-tx-changed-'; +const WEB_EDITOR_SELECTION_SESSION_KEY_PREFIX = 'web-editor-v2-selection-'; + +/** Storage key prefix for excluded element keys (per-tab isolation, managed by sidepanel) */ +const WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX = 'web-editor-v2-excluded-keys-'; + +/** Storage key for AgentChat selected session ID */ +const STORAGE_KEY_SELECTED_SESSION = 'agent-selected-session-id'; + +// In-memory execution status cache (per requestId) +interface ExecutionStatusEntry { + status: string; + message?: string; + updatedAt: number; + result?: { success: boolean; summary?: string; error?: string }; +} +const executionStatusCache = new Map(); +const STATUS_CACHE_TTL = 5 * 60 * 1000; // 5 minutes + +function cleanupExpiredStatuses(): void { + const now = Date.now(); + for (const [key, entry] of executionStatusCache) { + if (now - entry.updatedAt > STATUS_CACHE_TTL) { + executionStatusCache.delete(key); + } + } +} + +function setExecutionStatus( + requestId: string, + status: string, + message?: string, + result?: ExecutionStatusEntry['result'], +): void { + executionStatusCache.set(requestId, { + status, + message, + updatedAt: Date.now(), + result, + }); + // Periodic cleanup + if (executionStatusCache.size > 100) { + cleanupExpiredStatuses(); + } +} + +function getExecutionStatus(requestId: string): ExecutionStatusEntry | undefined { + return executionStatusCache.get(requestId); +} + +// SSE connections for status updates (per sessionId) +const sseConnections = new Map(); + +/** + * Start SSE subscription for a session to receive status updates + */ +async function subscribeToSessionStatus( + sessionId: string, + requestId: string, + port: number, +): Promise { + // Close existing connection for this session if any + const existing = sseConnections.get(sessionId); + if (existing) { + existing.abort.abort(); + sseConnections.delete(sessionId); + } + + const abortController = new AbortController(); + sseConnections.set(sessionId, { abort: abortController, lastRequestId: requestId }); + + // Set initial status + setExecutionStatus(requestId, 'starting', 'Connecting to Agent...'); + + const sseUrl = `http://127.0.0.1:${port}/agent/chat/${encodeURIComponent(sessionId)}/stream`; + + try { + const response = await fetch(sseUrl, { + method: 'GET', + headers: { Accept: 'text/event-stream' }, + signal: abortController.signal, + }); + + if (!response.ok || !response.body) { + setExecutionStatus(requestId, 'running', 'Agent processing...'); + return; + } + + const reader = response.body.getReader(); + const decoder = new TextDecoder(); + let buffer = ''; + + setExecutionStatus(requestId, 'running', 'Agent processing...'); + + // Read SSE stream + + while (true) { + const { done, value } = await reader.read(); + if (done) break; + + buffer += decoder.decode(value, { stream: true }); + const lines = buffer.split('\n'); + buffer = lines.pop() ?? ''; + + for (const line of lines) { + if (line.startsWith('data:')) { + try { + const data = JSON.parse(line.slice(5).trim()); + handleSseEvent(requestId, data); + } catch { + // Ignore parse errors + } + } + } + } + } catch (err) { + if (err instanceof Error && err.name === 'AbortError') { + // Intentionally aborted, not an error + return; + } + // Connection error - mark as unknown but not failed (Agent may still be running) + const cached = getExecutionStatus(requestId); + if (cached && !['completed', 'failed', 'cancelled'].includes(cached.status)) { + setExecutionStatus(requestId, 'running', 'Agent processing (connection lost)...'); + } + } finally { + sseConnections.delete(sessionId); + } +} + +/** + * Handle SSE event from Agent stream + */ +function handleSseEvent(requestId: string, event: unknown): void { + if (!event || typeof event !== 'object') return; + const e = event as Record; + const type = e.type; + const data = e.data as Record | undefined; + + // Check if this event is for our request + const eventRequestId = data?.requestId as string | undefined; + if (eventRequestId && eventRequestId !== requestId) return; + + if (type === 'status' && data) { + const status = data.status as string; + const message = data.message as string | undefined; + + // Map Agent status to our status + // - 'ready' -> 'running' (ready is a running sub-state) + // - 'error' -> 'failed' (normalize server 'error' to UI 'failed') + let mappedStatus = status; + if (status === 'ready') mappedStatus = 'running'; + if (status === 'error') mappedStatus = 'failed'; + + setExecutionStatus(requestId, mappedStatus, message); + } else if (type === 'message' && data) { + // Update status to show we're receiving messages + const cached = getExecutionStatus(requestId); + if (cached && cached.status === 'starting') { + setExecutionStatus(requestId, 'running', 'Agent is working...'); + } + + // Check for completion indicators in message content + const role = data.role as string | undefined; + const isFinal = data.isFinal as boolean | undefined; + if (role === 'assistant' && isFinal) { + const content = data.content as string | undefined; + setExecutionStatus(requestId, 'completed', 'Completed', { + success: true, + summary: content?.slice(0, 200), + }); + } + } else if (type === 'error') { + const errorMsg = (e.error as string) || 'Unknown error'; + setExecutionStatus(requestId, 'failed', errorMsg, { + success: false, + error: errorMsg, + }); + } +} + +/** + * Web Editor version configuration + * - v1: Legacy inject-scripts/web-editor.js (IIFE, ~850 lines) + * - v2: New TypeScript-based web-editor-v2.js (WXT unlisted script) + * + * Set USE_WEB_EDITOR_V2 to true to enable v2. + * This flag allows gradual rollout and easy rollback. + */ +const USE_WEB_EDITOR_V2 = true; + +/** Script path for v1 (legacy) */ +const V1_SCRIPT_PATH = 'inject-scripts/web-editor.js'; + +/** Script path for v2 (WXT unlisted script output) */ +const V2_SCRIPT_PATH = 'web-editor-v2.js'; + +/** Script path for Phase 7 props agent (MAIN world) */ +const PROPS_AGENT_SCRIPT_PATH = 'inject-scripts/props-agent.js'; + +type WebEditorInstructionType = 'update_text' | 'update_style'; + +interface WebEditorFingerprint { + tag: string; + id?: string; + classes: string[]; + text?: string; +} + +/** Debug source from React/Vue fiber (file, line, component name) */ +interface DebugSource { + file: string; + line?: number; + column?: number; + componentName?: string; +} + +/** Style operation details (before/after diff) */ +interface StyleOperation { + type: 'update_style'; + before: Record; + after: Record; + removed: string[]; +} + +interface WebEditorApplyPayload { + pageUrl: string; + targetFile?: string; + fingerprint: WebEditorFingerprint; + techStackHint?: string[]; + instruction: { + type: WebEditorInstructionType; + description: string; + text?: string; + style?: Record; + }; + + // V2 extended fields (best-effort, optional) + selectorCandidates?: string[]; + debugSource?: DebugSource; + operation?: StyleOperation; +} + +function normalizeString(value: unknown): string { + return typeof value === 'string' ? value : ''; +} + +function normalizeStringArray(value: unknown): string[] { + if (!Array.isArray(value)) return []; + return value.map((item) => normalizeString(item)).filter(Boolean); +} + +function normalizeStyleMap(value: unknown): Record | undefined { + if (!value || typeof value !== 'object') return undefined; + const out: Record = {}; + for (const [k, v] of Object.entries(value as Record)) { + const key = normalizeString(k).trim(); + const val = normalizeString(v).trim(); + if (!key || !val) continue; + out[key] = val; + } + return Object.keys(out).length ? out : undefined; +} + +function normalizeStyleMapAllowEmpty(value: unknown): Record | undefined { + if (!value || typeof value !== 'object') return undefined; + const out: Record = {}; + for (const [k, v] of Object.entries(value as Record)) { + const key = normalizeString(k).trim(); + if (!key) continue; + // Allow empty values (represents removed styles) + out[key] = normalizeString(v).trim(); + } + return Object.keys(out).length ? out : undefined; +} + +function normalizeDebugSource(value: unknown): DebugSource | undefined { + if (!value || typeof value !== 'object') return undefined; + const obj = value as Record; + const file = normalizeString(obj.file).trim(); + if (!file) return undefined; + + const source: DebugSource = { file }; + const line = Number(obj.line); + if (Number.isFinite(line) && line > 0) source.line = line; + const column = Number(obj.column); + if (Number.isFinite(column) && column >= 0) source.column = column; + const componentName = normalizeString(obj.componentName).trim(); + if (componentName) source.componentName = componentName; + + return source; +} + +function normalizeOperation(value: unknown): StyleOperation | undefined { + if (!value || typeof value !== 'object') return undefined; + const obj = value as Record; + if (obj.type !== 'update_style') return undefined; + + const before = normalizeStyleMapAllowEmpty(obj.before); + const after = normalizeStyleMapAllowEmpty(obj.after); + const removed = normalizeStringArray(obj.removed); + + if (!before && !after && removed.length === 0) return undefined; + + return { + type: 'update_style', + before: before ?? {}, + after: after ?? {}, + removed, + }; +} + +function normalizeApplyPayload(raw: unknown): WebEditorApplyPayload { + const obj = (raw && typeof raw === 'object' ? raw : {}) as Record; + const pageUrl = normalizeString(obj.pageUrl).trim(); + const targetFile = normalizeString(obj.targetFile).trim() || undefined; + const techStackHint = normalizeStringArray(obj.techStackHint); + + const fingerprintRaw = ( + obj.fingerprint && typeof obj.fingerprint === 'object' ? obj.fingerprint : {} + ) as Record; + const fingerprint: WebEditorFingerprint = { + tag: normalizeString(fingerprintRaw.tag).trim() || 'unknown', + id: normalizeString(fingerprintRaw.id).trim() || undefined, + classes: normalizeStringArray(fingerprintRaw.classes), + text: normalizeString(fingerprintRaw.text).trim() || undefined, + }; + + const instructionRaw = ( + obj.instruction && typeof obj.instruction === 'object' ? obj.instruction : {} + ) as Record; + const type = normalizeString(instructionRaw.type).trim() as WebEditorInstructionType; + if (type !== 'update_text' && type !== 'update_style') { + throw new Error('Invalid instruction.type'); + } + + const instruction = { + type, + description: normalizeString(instructionRaw.description).trim() || '', + text: normalizeString(instructionRaw.text).trim() || undefined, + style: normalizeStyleMap(instructionRaw.style), + }; + + if (!pageUrl) { + throw new Error('pageUrl is required'); + } + if (!instruction.description) { + throw new Error('instruction.description is required'); + } + + // V2 extended fields (optional) + const selectorCandidates = normalizeStringArray(obj.selectorCandidates); + const debugSource = normalizeDebugSource(obj.debugSource); + const operation = normalizeOperation(obj.operation); + + return { + pageUrl, + targetFile, + fingerprint, + techStackHint: techStackHint.length ? techStackHint : undefined, + instruction, + selectorCandidates: selectorCandidates.length ? selectorCandidates : undefined, + debugSource, + operation, + }; +} + +/** + * Normalize and validate batch apply payload. + * Runtime validation for WebEditorApplyBatchPayload. + */ +function normalizeApplyBatchPayload(raw: unknown): WebEditorApplyBatchPayload { + const obj = (raw && typeof raw === 'object' ? raw : {}) as Record; + + const tabIdRaw = Number(obj.tabId); + const tabId = Number.isFinite(tabIdRaw) && tabIdRaw > 0 ? tabIdRaw : 0; + + const elements = Array.isArray(obj.elements) ? (obj.elements as ElementChangeSummary[]) : []; + + const excludedKeys = Array.isArray(obj.excludedKeys) + ? obj.excludedKeys.map((k) => normalizeString(k).trim()).filter((k): k is string => Boolean(k)) + : []; + + const pageUrl = normalizeString(obj.pageUrl).trim() || undefined; + + return { tabId, elements, excludedKeys, pageUrl }; +} + +/** + * Build a batch prompt for multiple element changes. + * Designed for AgentChat integration to apply multiple visual edits at once. + */ +function buildAgentPromptBatch(elements: readonly ElementChangeSummary[], pageUrl: string): string { + const lines: string[] = []; + + // Header + lines.push('You are a senior frontend engineer working in a local codebase.'); + lines.push( + 'Goal: persist a batch of visual edits from the browser into the source code with minimal changes.', + ); + lines.push(''); + + // Page context + lines.push(`Page URL: ${pageUrl}`); + lines.push(''); + + lines.push('## Batch Changes'); + lines.push(`Total elements: ${elements.length}`); + lines.push(''); + lines.push( + 'For each element, prefer "source" (file/line/component) when available; otherwise use selectors/fingerprint to locate it.', + ); + lines.push(''); + + // Element details + elements.forEach((element, index) => { + const title = element.fullLabel || element.label || element.elementKey; + lines.push(`### ${index + 1}. ${title}`); + lines.push(`- elementKey: ${element.elementKey}`); + lines.push(`- change type: ${element.type}`); + + // Debug source (high-confidence location) + const ds = element.debugSource ?? element.locator?.debugSource; + if (ds?.file) { + const loc = ds.line ? `${ds.file}:${ds.line}${ds.column ? `:${ds.column}` : ''}` : ds.file; + lines.push(`- source: ${loc}${ds.componentName ? ` (${ds.componentName})` : ''}`); + } + + // Locator hints for fallback + if (element.locator?.selectors?.length) { + lines.push('- selectors:'); + for (const sel of element.locator.selectors.slice(0, 5)) { + lines.push(` - ${sel}`); + } + } + if (element.locator?.fingerprint) { + lines.push(`- fingerprint: ${element.locator.fingerprint}`); + } + if (Array.isArray(element.locator?.path) && element.locator.path.length > 0) { + lines.push(`- path: ${JSON.stringify(element.locator.path)}`); + } + if (element.locator?.shadowHostChain?.length) { + lines.push(`- shadowHostChain: ${JSON.stringify(element.locator.shadowHostChain)}`); + } + lines.push(''); + + // Net effect details + const net = element.netEffect; + lines.push('#### Net Effect (apply these final values)'); + + if (net.textChange) { + lines.push('##### Text'); + lines.push(`- before: ${JSON.stringify(net.textChange.before)}`); + lines.push(`- after: ${JSON.stringify(net.textChange.after)}`); + lines.push(''); + } + + if (net.classChanges) { + lines.push('##### Classes'); + lines.push(`- before: ${net.classChanges.before.join(' ')}`); + lines.push(`- after: ${net.classChanges.after.join(' ')}`); + lines.push(''); + } + + if (net.styleChanges) { + lines.push('##### Styles (before → after)'); + const before = net.styleChanges.before ?? {}; + const after = net.styleChanges.after ?? {}; + const allKeys = new Set([...Object.keys(before), ...Object.keys(after)]); + for (const key of Array.from(allKeys).sort()) { + const beforeVal = before[key] ?? '(unset)'; + const afterRaw = Object.prototype.hasOwnProperty.call(after, key) ? after[key] : '(unset)'; + const afterVal = afterRaw === '' ? '(removed)' : afterRaw; + if (beforeVal !== afterVal) { + lines.push(`- ${key}: "${beforeVal}" → "${afterVal}"`); + } + } + lines.push(''); + } + + // Fallback message if no specific changes + if (!net.textChange && !net.classChanges && !net.styleChanges) { + lines.push( + '- No net effect details available; use locator hints to inspect the element in code.', + ); + lines.push(''); + } + }); + + // Instructions + lines.push('## How to Apply'); + lines.push('1. Use "source" when available to go directly to the component file.'); + lines.push('2. Otherwise, use selectors/fingerprint/path to locate the element in the codebase.'); + lines.push('3. Apply the net effect with minimal changes and correct styling conventions.'); + lines.push('4. Avoid generated/bundled outputs; update source files only.'); + lines.push(''); + + // Output format + lines.push('## Constraints'); + lines.push('- Make the smallest safe edit possible for each element'); + lines.push( + '- If Tailwind/CSS Modules/styled-components are used, update the correct styling source', + ); + lines.push('- Do not change unrelated behavior or formatting'); + lines.push(''); + + lines.push( + '## Output\nApply all the changes in the repo, then reply with a short summary of what file(s) you modified and the exact changes made.', + ); + + return lines.join('\n'); +} + +function buildAgentPrompt(payload: WebEditorApplyPayload): string { + const lines: string[] = []; + + // Header + lines.push('You are a senior frontend engineer working in a local codebase.'); + lines.push( + 'Goal: persist a visual edit from the browser into the source code with minimal changes.', + ); + lines.push(''); + + // Page context + lines.push(`Page URL: ${payload.pageUrl}`); + lines.push(''); + + // == Source Location (high-confidence if debugSource available) == + const ds = payload.debugSource; + if (ds?.file) { + lines.push('## Source Location (from React/Vue debug info)'); + const loc = ds.line ? `${ds.file}:${ds.line}${ds.column ? `:${ds.column}` : ''}` : ds.file; + lines.push(`- file: ${loc}`); + if (ds.componentName) lines.push(`- component: ${ds.componentName}`); + lines.push(''); + lines.push('This is high-confidence source location extracted from framework debug info.'); + lines.push('Start your search here. Only fall back to fingerprint if this file is invalid.'); + lines.push(''); + } else if (payload.targetFile) { + lines.push(`## Target File (best-effort): ${payload.targetFile}`); + lines.push( + 'If this path is invalid or points to node_modules, fall back to fingerprint search.', + ); + lines.push(''); + } + + // == Element Fingerprint == + lines.push('## Element Fingerprint'); + lines.push(`- tag: ${payload.fingerprint.tag}`); + if (payload.fingerprint.id) lines.push(`- id: ${payload.fingerprint.id}`); + if (payload.fingerprint.classes?.length) { + lines.push(`- classes: ${payload.fingerprint.classes.join(' ')}`); + } + if (payload.fingerprint.text) lines.push(`- text: ${payload.fingerprint.text}`); + lines.push(''); + + // == CSS Selectors (for precise matching) == + if (payload.selectorCandidates?.length) { + lines.push('## CSS Selectors (ordered by specificity)'); + for (const sel of payload.selectorCandidates.slice(0, 5)) { + lines.push(`- ${sel}`); + } + lines.push(''); + lines.push('Use these selectors to grep the codebase if file location is unavailable.'); + lines.push(''); + } + + // == Tech Stack == + if (payload.techStackHint?.length) { + lines.push(`## Tech Stack: ${payload.techStackHint.join(', ')}`); + lines.push(''); + } + + // == Requested Change == + lines.push('## Requested Change'); + lines.push(`- type: ${payload.instruction.type}`); + lines.push(`- description: ${payload.instruction.description}`); + + if (payload.instruction.type === 'update_text' && payload.instruction.text !== undefined) { + lines.push(`- new text: ${JSON.stringify(payload.instruction.text)}`); + } + + // For style updates, show detailed before/after diff if available + if (payload.instruction.type === 'update_style') { + const op = payload.operation; + if (op && (Object.keys(op.before).length > 0 || Object.keys(op.after).length > 0)) { + lines.push(''); + lines.push('### Style Changes (before → after)'); + const allKeys = new Set([...Object.keys(op.before), ...Object.keys(op.after)]); + for (const key of allKeys) { + const before = op.before[key] ?? '(unset)'; + const after = op.after[key] ?? '(removed)'; + if (before !== after) { + lines.push(` ${key}: "${before}" → "${after}"`); + } + } + if (op.removed.length > 0) { + lines.push(` [Removed]: ${op.removed.join(', ')}`); + } + } else if (payload.instruction.style) { + lines.push(`- style map: ${JSON.stringify(payload.instruction.style, null, 2)}`); + } + } + lines.push(''); + + // == Instructions == + lines.push('## How to Apply'); + if (ds?.file) { + lines.push(`1. Open ${ds.file}${ds.line ? ` around line ${ds.line}` : ''}`); + if (ds.componentName) { + lines.push(`2. Locate the "${ds.componentName}" component definition`); + } + lines.push( + `3. Find the element matching tag="${payload.fingerprint.tag}"${payload.fingerprint.classes?.length ? ` with classes including "${payload.fingerprint.classes[0]}"` : ''}`, + ); + lines.push('4. Apply the requested style/text change'); + } else if (payload.targetFile) { + lines.push(`1. Open ${payload.targetFile}`); + lines.push('2. Search for the element by matching fingerprint (tag, classes, text)'); + lines.push('3. If not found, use repo-wide search with selectors or class names'); + lines.push('4. Apply the requested change'); + } else { + lines.push('1. Use repo-wide search (rg) with class names or text from fingerprint'); + if (payload.selectorCandidates?.length) { + lines.push(`2. Try searching for: "${payload.selectorCandidates[0]}"`); + } + lines.push('3. Locate the component/template containing this element'); + lines.push('4. Apply the requested change'); + } + lines.push(''); + + // == Constraints == + lines.push('## Constraints'); + lines.push('- Make the smallest safe edit possible'); + if (payload.techStackHint?.includes('Tailwind')) { + lines.push('- Tailwind detected: prefer updating className over inline styles'); + } + if (payload.techStackHint?.includes('React') || payload.techStackHint?.includes('Vue')) { + lines.push('- Update the component source, not generated/bundled code'); + } + lines.push('- If CSS Modules or styled-components are used, update the correct styling source'); + lines.push('- Do not change unrelated behavior or formatting'); + lines.push(''); + + // == Output == + lines.push( + '## Output\nApply the change in the repo, then reply with a short summary of what file(s) you modified and the exact change made.', + ); + + return lines.join('\n'); +} + +async function ensureContextMenu(): Promise { + try { + if (!(chrome as any).contextMenus?.create) return; + try { + await chrome.contextMenus.remove(CONTEXT_MENU_ID); + } catch {} + await chrome.contextMenus.create({ + id: CONTEXT_MENU_ID, + title: '切换网页编辑模式', + contexts: ['all'], + }); + } catch (error) { + console.warn('[WebEditor] Failed to ensure context menu:', error); + } +} + +/** + * Get the appropriate action constants based on version + */ +function getActions() { + return USE_WEB_EDITOR_V2 ? WEB_EDITOR_V2_ACTIONS : WEB_EDITOR_V1_ACTIONS; +} + +/** + * Ensure the web editor script is injected into the tab + * Supports both v1 (legacy) and v2 (new) versions + * + * V1 and V2 use different action names to avoid conflicts: + * - V1: web_editor_ping, web_editor_toggle, etc. + * - V2: web_editor_ping_v2, web_editor_toggle_v2, etc. + */ +async function ensureEditorInjected(tabId: number): Promise { + const scriptPath = USE_WEB_EDITOR_V2 ? V2_SCRIPT_PATH : V1_SCRIPT_PATH; + const logPrefix = USE_WEB_EDITOR_V2 ? '[WebEditorV2]' : '[WebEditor]'; + const actions = getActions(); + + // Try to ping existing instance using version-specific action + try { + const pong: { status?: string; version?: number } = await chrome.tabs.sendMessage( + tabId, + { action: actions.PING }, + { frameId: 0 }, + ); + + if (pong?.status === 'pong') { + // Already injected with correct version + return; + } + } catch { + // No existing instance, fallthrough to inject + } + + // Inject the script + try { + await chrome.scripting.executeScript({ + target: { tabId }, + files: [scriptPath], + world: 'ISOLATED', + }); + console.log(`${logPrefix} Script injected successfully`); + } catch (error) { + console.warn(`${logPrefix} Failed to inject editor script:`, error); + } +} + +/** + * Inject props agent into MAIN world for Phase 7 Props editing + * Only inject for v2 editor + */ +async function ensurePropsAgentInjected(tabId: number): Promise { + if (!USE_WEB_EDITOR_V2) return; + + try { + await chrome.scripting.executeScript({ + target: { tabId }, + files: [PROPS_AGENT_SCRIPT_PATH], + world: 'MAIN', + }); + } catch (error) { + // Best-effort: some pages (chrome://, extensions, PDF) block injection + console.warn('[WebEditorV2] Failed to inject props agent:', error); + } +} + +/** + * Send cleanup event to props agent + */ +async function sendPropsAgentCleanup(tabId: number): Promise { + if (!USE_WEB_EDITOR_V2) return; + + try { + // Dispatch cleanup event in ISOLATED world + // CustomEvent crosses worlds and is observed by MAIN agent + await chrome.scripting.executeScript({ + target: { tabId }, + func: () => { + try { + window.dispatchEvent(new CustomEvent('web-editor-props:cleanup')); + } catch { + // ignore + } + }, + world: 'ISOLATED', + }); + } catch (error) { + // Best-effort cleanup; ignore failures if tab is gone or injection blocked + console.warn('[WebEditorV2] Failed to send props agent cleanup:', error); + } +} + +// ============================================================================= +// Phase 7.1.6: Early Injection for Props Agent +// ============================================================================= + +/** + * Content script ID prefix for early injection (document_start). + * Registered scripts persist across sessions and survive browser restarts. + */ +const PROPS_AGENT_EARLY_INJECTION_ID_PREFIX = 'mcp_we_props_early'; + +/** + * Result of early injection registration + */ +interface EarlyInjectionResult { + id: string; + host: string; + matches: string[]; + alreadyRegistered: boolean; +} + +/** + * Sanitize a string for use in content script ID + * Only allows alphanumeric, underscore, and hyphen + */ +function sanitizeContentScriptId(input: string): string { + const cleaned = String(input ?? '') + .toLowerCase() + .replace(/[^a-z0-9_-]+/g, '_') + .replace(/^_+|_+$/g, ''); + return cleaned.slice(0, 80) || 'site'; +} + +/** + * Build match patterns from tab URL for early injection. + * Returns patterns for the specific host only (not all URLs). + */ +function buildEarlyInjectionPatterns(tabUrl: string): { host: string; matches: string[] } { + let url: URL; + try { + url = new URL(tabUrl); + } catch { + throw new Error('Invalid tab URL'); + } + + if (url.protocol !== 'http:' && url.protocol !== 'https:') { + throw new Error(`Early injection only supports http/https pages (got ${url.protocol})`); + } + + const host = url.hostname.trim(); + if (!host) { + throw new Error('Unable to derive host from tab URL'); + } + + // Match all paths on this host for both http and https + return { host, matches: [`*://${host}/*`] }; +} + +/** + * Register props agent for early injection (document_start, MAIN world). + * This allows capturing React DevTools hook before React initializes. + * + * The registration is per-host and persists across sessions. + */ +async function registerPropsAgentEarlyInjection(tabUrl: string): Promise { + const { host, matches } = buildEarlyInjectionPatterns(tabUrl); + const id = `${PROPS_AGENT_EARLY_INJECTION_ID_PREFIX}_${sanitizeContentScriptId(host)}`; + + // Check if already registered (idempotent) + let alreadyRegistered = false; + try { + const existing = await chrome.scripting.getRegisteredContentScripts({ ids: [id] }); + alreadyRegistered = existing.some((s) => s.id === id); + } catch { + // API might not support getRegisteredContentScripts in all contexts + alreadyRegistered = false; + } + + if (!alreadyRegistered) { + await chrome.scripting.registerContentScripts([ + { + id, + js: [PROPS_AGENT_SCRIPT_PATH], + matches, + runAt: 'document_start', + world: 'MAIN', + allFrames: false, + persistAcrossSessions: true, + }, + ]); + console.log(`[WebEditorV2] Registered early injection for ${host}`); + } + + return { id, host, matches, alreadyRegistered }; +} + +async function toggleEditorInTab(tabId: number): Promise<{ active?: boolean }> { + await ensureEditorInjected(tabId); + const logPrefix = USE_WEB_EDITOR_V2 ? '[WebEditorV2]' : '[WebEditor]'; + const actions = getActions(); + + try { + const resp: { active?: boolean } = await chrome.tabs.sendMessage( + tabId, + { action: actions.TOGGLE }, + { frameId: 0 }, + ); + const active = typeof resp?.active === 'boolean' ? resp.active : undefined; + + // Phase 7: Inject props agent on start; cleanup on stop + if (active === true) { + await ensurePropsAgentInjected(tabId); + } else if (active === false) { + await sendPropsAgentCleanup(tabId); + } + + return { active }; + } catch (error) { + console.warn(`${logPrefix} Failed to toggle editor in tab:`, error); + return {}; + } +} + +async function getActiveTabId(): Promise { + try { + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + return typeof tabId === 'number' ? tabId : null; + } catch { + return null; + } +} + +export function initWebEditorListeners(): void { + ensureContextMenu().catch(() => {}); + + // Clean up session storage when tab is closed to avoid stale data + chrome.tabs.onRemoved.addListener((tabId) => { + try { + const keys = [ + `${WEB_EDITOR_TX_CHANGED_SESSION_KEY_PREFIX}${tabId}`, + `${WEB_EDITOR_SELECTION_SESSION_KEY_PREFIX}${tabId}`, + `${WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX}${tabId}`, + ]; + chrome.storage.session.remove(keys).catch(() => {}); + } catch {} + }); + + if ((chrome as any).contextMenus?.onClicked?.addListener) { + chrome.contextMenus.onClicked.addListener(async (info, tab) => { + try { + if (info.menuItemId !== CONTEXT_MENU_ID) return; + const tabId = tab?.id; + if (typeof tabId !== 'number') return; + await toggleEditorInTab(tabId); + } catch {} + }); + } + + chrome.commands.onCommand.addListener(async (command) => { + try { + if (command !== COMMAND_KEY) return; + const tabId = await getActiveTabId(); + if (typeof tabId !== 'number') return; + await toggleEditorInTab(tabId); + } catch {} + }); + + chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => { + try { + // Phase 7.1.6: Handle early injection registration request + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_PROPS_REGISTER_EARLY_INJECTION) { + (async () => { + const senderTab = (_sender as chrome.runtime.MessageSender)?.tab; + const senderTabId = senderTab?.id; + const senderTabUrl = senderTab?.url; + + if (typeof senderTabId !== 'number' || typeof senderTabUrl !== 'string') { + return sendResponse({ + success: false, + error: 'Sender tab information is required', + }); + } + + try { + const result = await registerPropsAgentEarlyInjection(senderTabUrl); + + // Respond first, then reload (to avoid message port closing during navigation) + sendResponse({ success: true, ...result }); + + // Small delay to ensure response is sent before navigation + await new Promise((resolve) => setTimeout(resolve, 50)); + + // Reload the tab so early injection takes effect + try { + await chrome.tabs.reload(senderTabId); + } catch { + // Best-effort: some tabs may block reload + } + } catch (err) { + sendResponse({ + success: false, + error: err instanceof Error ? err.message : String(err), + }); + } + })(); + return true; // Async response + } + + // ===================================================================== + // WEB_EDITOR_OPEN_SOURCE: Open component source file in VSCode + // ===================================================================== + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_OPEN_SOURCE) { + (async () => { + try { + const payload = message.payload as { debugSource?: unknown } | undefined; + const debugSource = payload?.debugSource; + + if (!debugSource || typeof debugSource !== 'object') { + return sendResponse({ success: false, error: 'debugSource is required' }); + } + + const rec = debugSource as Record; + const file = typeof rec.file === 'string' ? rec.file.trim() : ''; + if (!file) { + return sendResponse({ success: false, error: 'debugSource.file is required' }); + } + + // Read server port and selected project + const stored = await chrome.storage.local.get([ + 'nativeServerPort', + 'agent-selected-project-id', + ]); + const portRaw = stored.nativeServerPort; + const port = Number.isFinite(Number(portRaw)) + ? Number(portRaw) + : DEFAULT_NATIVE_SERVER_PORT; + const projectId = stored['agent-selected-project-id']; + + if (!projectId || typeof projectId !== 'string') { + return sendResponse({ + success: false, + error: 'No project selected. Please select a project in AgentChat first.', + }); + } + + // Prepare line/column + const lineRaw = Number(rec.line); + const columnRaw = Number(rec.column); + const line = Number.isFinite(lineRaw) && lineRaw > 0 ? lineRaw : undefined; + const column = Number.isFinite(columnRaw) && columnRaw > 0 ? columnRaw : undefined; + + // Call native-server to open file (server will validate project and path) + const openResp = await fetch( + `http://127.0.0.1:${port}/agent/projects/${encodeURIComponent(projectId)}/open-file`, + { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + filePath: file, + line, + column, + }), + }, + ); + + // Try to parse JSON response for detailed error + let result: { success: boolean; error?: string }; + try { + result = await openResp.json(); + } catch { + const text = await openResp.text().catch(() => ''); + result = { + success: false, + error: text || `HTTP ${openResp.status}`, + }; + } + + sendResponse(result); + } catch (err) { + sendResponse({ + success: false, + error: err instanceof Error ? err.message : String(err), + }); + } + })(); + return true; // Async response + } + + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_TOGGLE) { + getActiveTabId() + .then(async (tabId) => { + if (typeof tabId !== 'number') return sendResponse({ success: false }); + const result = await toggleEditorInTab(tabId); + sendResponse({ success: true, ...result }); + }) + .catch(() => sendResponse({ success: false })); + return true; + } + + // ======================================================================= + // Phase 1.5: Handle TX_CHANGED broadcast from web-editor + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_TX_CHANGED) { + (async () => { + const senderTabId = (_sender as chrome.runtime.MessageSender)?.tab?.id; + if (typeof senderTabId !== 'number') { + sendResponse({ success: false, error: 'Sender tabId is required' }); + return; + } + + const rawPayload = message.payload as WebEditorTxChangedPayload | undefined; + if (!rawPayload || typeof rawPayload !== 'object') { + sendResponse({ success: false, error: 'Invalid payload' }); + return; + } + + // Hydrate payload with tabId from sender + const payload: WebEditorTxChangedPayload = { ...rawPayload, tabId: senderTabId }; + const storageKey = `${WEB_EDITOR_TX_CHANGED_SESSION_KEY_PREFIX}${senderTabId}`; + + // Persist to session storage for cold-start recovery + // Remove keys on clear to avoid stale data (rollback still has edits, so keep it) + if (payload.action === 'clear') { + // Clear TX state and excluded keys together + const excludedKey = `${WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX}${senderTabId}`; + await chrome.storage.session.remove([storageKey, excludedKey]); + } else { + await chrome.storage.session.set({ [storageKey]: payload }); + } + + // Broadcast to sidepanel (best-effort, ignore errors if sidepanel is closed) + chrome.runtime + .sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_TX_CHANGED, + payload, + }) + .catch(() => { + // Ignore errors - sidepanel may be closed + }); + + sendResponse({ success: true }); + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + // ======================================================================= + // Selection sync: Handle SELECTION_CHANGED broadcast from web-editor + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_SELECTION_CHANGED) { + (async () => { + const senderTabId = (_sender as chrome.runtime.MessageSender)?.tab?.id; + if (typeof senderTabId !== 'number') { + sendResponse({ success: false, error: 'Sender tabId is required' }); + return; + } + + const rawPayload = message.payload as + | import('@/common/web-editor-types').WebEditorSelectionChangedPayload + | undefined; + if (!rawPayload || typeof rawPayload !== 'object') { + sendResponse({ success: false, error: 'Invalid payload' }); + return; + } + + // Hydrate payload with tabId from sender + const payload = { ...rawPayload, tabId: senderTabId }; + const storageKey = `${WEB_EDITOR_SELECTION_SESSION_KEY_PREFIX}${senderTabId}`; + + // Persist to session storage for cold-start recovery + // Remove key on deselection to avoid stale data + if (payload.selected === null) { + await chrome.storage.session.remove(storageKey); + } else { + await chrome.storage.session.set({ [storageKey]: payload }); + } + + // Broadcast to sidepanel (best-effort, ignore errors if sidepanel is closed) + chrome.runtime + .sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_SELECTION_CHANGED, + payload, + }) + .catch(() => { + // Ignore errors - sidepanel may be closed + }); + + sendResponse({ success: true }); + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + // ======================================================================= + // Clear selection: Handle CLEAR_SELECTION from sidepanel (after send) + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_CLEAR_SELECTION) { + (async () => { + const payload = message.payload as { tabId?: number } | undefined; + const targetTabId = payload?.tabId; + + if (typeof targetTabId !== 'number' || targetTabId <= 0) { + sendResponse({ success: false, error: 'Invalid tabId' }); + return; + } + + // Forward to content script (web-editor-v2) + try { + await chrome.tabs.sendMessage(targetTabId, { + action: WEB_EDITOR_V2_ACTIONS.CLEAR_SELECTION, + }); + sendResponse({ success: true }); + } catch (error) { + // Tab may be closed or web-editor not active - this is expected + sendResponse({ + success: false, + error: error instanceof Error ? error.message : 'Failed to send to tab', + }); + } + })().catch((error) => { + // Catch any unhandled errors in the async IIFE + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + // ======================================================================= + // Phase 1.5: Handle APPLY_BATCH from web-editor toolbar + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_APPLY_BATCH) { + const payload = normalizeApplyBatchPayload(message.payload); + (async () => { + const senderTabId = (_sender as chrome.runtime.MessageSender)?.tab?.id; + const senderWindowId = (_sender as chrome.runtime.MessageSender)?.tab?.windowId; + + // Read storage for server port and selected session + const stored = await chrome.storage.local.get([ + 'nativeServerPort', + STORAGE_KEY_SELECTED_SESSION, + ]); + + const portRaw = stored?.nativeServerPort; + const port = Number.isFinite(Number(portRaw)) + ? Number(portRaw) + : DEFAULT_NATIVE_SERVER_PORT; + + const sessionId = normalizeString(stored?.[STORAGE_KEY_SELECTED_SESSION]).trim(); + + // Best-effort: open AgentChat sidepanel so user can see the session + // Pass sessionId for deep linking directly to chat view + if (typeof senderTabId === 'number') { + openAgentChatSidepanel(senderTabId, senderWindowId, sessionId || undefined).catch( + () => {}, + ); + } + + if (!sessionId) { + // No session selected - sidepanel is already being opened (best-effort) + // User needs to select or create a session manually + sendResponse({ + success: false, + error: + 'No Agent session selected. Please select or create a session in AgentChat, then try Apply again.', + }); + return; + } + + // Hydrate payload with tabId + const hydratedPayload: WebEditorApplyBatchPayload = + typeof senderTabId === 'number' ? { ...payload, tabId: senderTabId } : payload; + + // Read excluded keys from session storage (per-tab, managed by sidepanel) + let sessionExcludedKeys: string[] = []; + if (typeof senderTabId === 'number') { + const excludedSessionKey = `${WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX}${senderTabId}`; + try { + if (chrome.storage?.session?.get) { + const stored = (await chrome.storage.session.get(excludedSessionKey)) as Record< + string, + unknown + >; + const raw = stored?.[excludedSessionKey]; + sessionExcludedKeys = Array.isArray(raw) + ? raw.map((k) => normalizeString(k).trim()).filter(Boolean) + : []; + } + } catch { + // Best-effort: ignore session storage failures + } + } + + // Filter out excluded elements (union: payload excludedKeys + session excludedKeys) + const excluded = new Set([...hydratedPayload.excludedKeys, ...sessionExcludedKeys]); + const elements = hydratedPayload.elements.filter((e) => !excluded.has(e.elementKey)); + if (elements.length === 0) { + sendResponse({ success: false, error: 'No elements selected to apply.' }); + return; + } + + // Build page URL from payload or sender tab + const pageUrl = + normalizeString(hydratedPayload.pageUrl).trim() || + normalizeString((_sender as chrome.runtime.MessageSender)?.tab?.url).trim() || + 'unknown'; + + // Build batch prompt and send to agent + const instruction = buildAgentPromptBatch(elements, pageUrl); + const url = `http://127.0.0.1:${port}/agent/chat/${encodeURIComponent(sessionId)}/act`; + + // Extract element labels for compact display + const elementLabels = elements.slice(0, 5).map((e) => e.label); + + const resp = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + instruction, + // Pass dbSessionId so backend loads session-level configuration (engine, model, options) + dbSessionId: sessionId, + // Display text for UI (compact representation) + displayText: `Apply ${elements.length} change${elements.length === 1 ? '' : 's'}`, + // Client metadata for special message rendering + clientMeta: { + kind: 'web_editor_apply_batch', + pageUrl, + elementCount: elements.length, + elementLabels, + }, + }), + }); + + if (!resp.ok) { + const text = await resp.text().catch(() => ''); + sendResponse({ + success: false, + error: text || `HTTP ${resp.status}`, + }); + return; + } + + const json: any = await resp.json().catch(() => ({})); + const requestId = json?.requestId as string | undefined; + + if (requestId) { + // Start SSE subscription for status updates (fire and forget) + subscribeToSessionStatus(sessionId, requestId, port).catch(() => {}); + } + + sendResponse({ success: true, requestId, sessionId }); + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + // ======================================================================= + // Phase 1.8: Handle HIGHLIGHT_ELEMENT from sidepanel chips hover + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_HIGHLIGHT_ELEMENT) { + const payload = message.payload as WebEditorHighlightElementPayload | undefined; + (async () => { + // Validate payload + const tabId = payload?.tabId; + if (typeof tabId !== 'number' || !Number.isFinite(tabId) || tabId <= 0) { + sendResponse({ success: false, error: 'Invalid tabId' }); + return; + } + + const mode = payload?.mode; + if (mode !== 'hover' && mode !== 'clear') { + sendResponse({ success: false, error: 'Invalid mode' }); + return; + } + + // Clear mode: forward directly without locator/selector validation + // This prevents overlay residue when sidepanel unmounts + if (mode === 'clear') { + try { + const response = await chrome.tabs.sendMessage(tabId, { + action: WEB_EDITOR_V2_ACTIONS.HIGHLIGHT_ELEMENT, + mode: 'clear', + }); + sendResponse({ success: true, response }); + } catch (error) { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + } + return; + } + + // Hover mode: validate and forward locator + const locator = payload?.locator; + if (!locator || typeof locator !== 'object') { + sendResponse({ success: false, error: 'Invalid locator' }); + return; + } + + // Extract best selector for fallback highlighting + const selectors = Array.isArray(locator.selectors) ? locator.selectors : []; + const primarySelector = selectors.find( + (s): s is string => typeof s === 'string' && s.trim().length > 0, + ); + + if (!primarySelector) { + sendResponse({ success: false, error: 'No valid selector in locator' }); + return; + } + + // Forward to web-editor content script + try { + const response = await chrome.tabs.sendMessage(tabId, { + action: WEB_EDITOR_V2_ACTIONS.HIGHLIGHT_ELEMENT, + locator, // Full locator for Shadow DOM/iframe support + selector: primarySelector, // Backward compatibility fallback + mode, + elementKey: payload.elementKey, + }); + + sendResponse({ success: true, response }); + } catch (error) { + // Content script might not be available + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + } + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + // ======================================================================= + // Phase 2: Handle REVERT_ELEMENT from sidepanel chips + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_REVERT_ELEMENT) { + const payload = message.payload as WebEditorRevertElementPayload | undefined; + (async () => { + // Validate payload + const tabId = payload?.tabId; + if (typeof tabId !== 'number' || !Number.isFinite(tabId) || tabId <= 0) { + sendResponse({ success: false, error: 'Invalid tabId' }); + return; + } + + const elementKey = payload?.elementKey; + if (typeof elementKey !== 'string' || !elementKey.trim()) { + sendResponse({ success: false, error: 'Invalid elementKey' }); + return; + } + + // Forward to web-editor content script (frameId: 0 for main frame only) + try { + const response = await chrome.tabs.sendMessage( + tabId, + { + action: WEB_EDITOR_V2_ACTIONS.REVERT_ELEMENT, + elementKey, + }, + { frameId: 0 }, + ); + + sendResponse({ success: true, ...response }); + } catch (error) { + // Content script might not be available + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + } + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_APPLY) { + const payload = normalizeApplyPayload(message.payload); + (async () => { + const senderTabId = (_sender as any)?.tab?.id; + const sessionId = + typeof senderTabId === 'number' ? `web-editor-${senderTabId}` : 'web-editor'; + + const stored = await chrome.storage.local.get([ + 'nativeServerPort', + 'agent-selected-project-id', + ]); + const portRaw = stored?.nativeServerPort; + const port = Number.isFinite(Number(portRaw)) + ? Number(portRaw) + : DEFAULT_NATIVE_SERVER_PORT; + + const projectId = normalizeString(stored?.['agent-selected-project-id']).trim() || ''; + + if (!projectId) { + return sendResponse({ + success: false, + error: + 'No Agent project selected. Open Side Panel → 智能助手 and select/create a project first.', + }); + } + + const instruction = buildAgentPrompt(payload); + const url = `http://127.0.0.1:${port}/agent/chat/${encodeURIComponent(sessionId)}/act`; + + const resp = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + instruction, + projectId, + }), + }); + + if (!resp.ok) { + const text = await resp.text().catch(() => ''); + return sendResponse({ + success: false, + error: text || `HTTP ${resp.status}`, + }); + } + + const json: any = await resp.json().catch(() => ({})); + const requestId = json?.requestId as string | undefined; + + if (requestId) { + // Start SSE subscription for status updates (fire and forget) + subscribeToSessionStatus(sessionId, requestId, port).catch(() => {}); + } + + return sendResponse({ success: true, requestId, sessionId }); + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + }); + return true; + } + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_STATUS_QUERY) { + const { requestId } = message; + if (!requestId || typeof requestId !== 'string') { + sendResponse({ success: false, error: 'requestId is required' }); + return false; + } + + const entry = getExecutionStatus(requestId); + if (!entry) { + // No status yet - likely still pending or not tracked + sendResponse({ success: true, status: 'pending', message: 'Waiting for status...' }); + } else { + sendResponse({ + success: true, + status: entry.status, + message: entry.message, + result: entry.result, + }); + } + return false; // Synchronous response + } + + // ======================================================================= + // Cancel Execution: Handle WEB_EDITOR_CANCEL_EXECUTION from toolbar/sidepanel + // ======================================================================= + if (message?.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_CANCEL_EXECUTION) { + const payload = message.payload as WebEditorCancelExecutionPayload | undefined; + (async () => { + // Validate payload + const sessionId = payload?.sessionId?.trim(); + const requestId = payload?.requestId?.trim(); + + if (!sessionId) { + sendResponse({ + success: false, + error: 'sessionId is required', + } as WebEditorCancelExecutionResponse); + return; + } + if (!requestId) { + sendResponse({ + success: false, + error: 'requestId is required', + } as WebEditorCancelExecutionResponse); + return; + } + + // Get server port + const stored = await chrome.storage.local.get(['nativeServerPort']); + const port = stored.nativeServerPort || DEFAULT_NATIVE_SERVER_PORT; + + try { + // Call cancel API + const cancelUrl = `http://127.0.0.1:${port}/agent/chat/${encodeURIComponent(sessionId)}/cancel/${encodeURIComponent(requestId)}`; + const response = await fetch(cancelUrl, { method: 'DELETE' }); + + if (!response.ok) { + const errorText = await response.text().catch(() => `HTTP ${response.status}`); + sendResponse({ + success: false, + error: errorText, + } as WebEditorCancelExecutionResponse); + return; + } + + // Update local execution status cache + setExecutionStatus(requestId, 'cancelled', 'Execution cancelled by user'); + + // Abort SSE connection for this session + const sseConnection = sseConnections.get(sessionId); + if (sseConnection && sseConnection.lastRequestId === requestId) { + sseConnection.abort.abort(); + sseConnections.delete(sessionId); + } + + sendResponse({ success: true } as WebEditorCancelExecutionResponse); + } catch (error) { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + } as WebEditorCancelExecutionResponse); + } + })().catch((error) => { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + } as WebEditorCancelExecutionResponse); + }); + return true; // Will respond asynchronously + } + } catch (error) { + sendResponse({ + success: false, + error: String(error instanceof Error ? error.message : error), + }); + } + return false; + }); +} diff --git a/app/chrome-extension/entrypoints/builder/App.vue b/app/chrome-extension/entrypoints/builder/App.vue new file mode 100644 index 00000000..0bfef5c5 --- /dev/null +++ b/app/chrome-extension/entrypoints/builder/App.vue @@ -0,0 +1,1262 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/builder/index.html b/app/chrome-extension/entrypoints/builder/index.html new file mode 100644 index 00000000..7afd432a --- /dev/null +++ b/app/chrome-extension/entrypoints/builder/index.html @@ -0,0 +1,13 @@ + + + + + + 工作流编辑器 + + + +
+ + + diff --git a/app/chrome-extension/entrypoints/builder/main.ts b/app/chrome-extension/entrypoints/builder/main.ts new file mode 100644 index 00000000..486851ff --- /dev/null +++ b/app/chrome-extension/entrypoints/builder/main.ts @@ -0,0 +1,7 @@ +import { createApp } from 'vue'; +import App from './App.vue'; + +// Tailwind first, then custom tokens +import '../styles/tailwind.css'; + +createApp(App).mount('#app'); diff --git a/app/chrome-extension/entrypoints/element-picker.content.ts b/app/chrome-extension/entrypoints/element-picker.content.ts new file mode 100644 index 00000000..72f1de95 --- /dev/null +++ b/app/chrome-extension/entrypoints/element-picker.content.ts @@ -0,0 +1,205 @@ +/** + * Element Picker Content Script + * + * Renders the Element Picker Panel UI (Quick Panel style) and forwards UI events + * to background while a chrome_request_element_selection session is active. + * + * This script only runs in the top frame and handles: + * - Displaying the element picker panel UI + * - Forwarding user actions (cancel, confirm, etc.) to background + * - Receiving state updates from background + */ + +import { + createElementPickerController, + type ElementPickerController, + type ElementPickerUiState, +} from '@/shared/element-picker'; +import { BACKGROUND_MESSAGE_TYPES, TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import type { PickedElement } from 'chrome-mcp-shared'; + +// ============================================================ +// Message Types +// ============================================================ + +interface UiShowMessage { + action: typeof TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_SHOW; + sessionId: string; + requests: Array<{ id: string; name: string; description?: string }>; + activeRequestId: string | null; + deadlineTs: number; +} + +interface UiUpdateMessage { + action: typeof TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_UPDATE; + sessionId: string; + activeRequestId: string | null; + selections: Record; + deadlineTs: number; + errorMessage: string | null; +} + +interface UiHideMessage { + action: typeof TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_HIDE; + sessionId: string; +} + +interface UiPingMessage { + action: typeof TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_PING; +} + +type PickerMessage = UiPingMessage | UiShowMessage | UiUpdateMessage | UiHideMessage; + +// ============================================================ +// Content Script Definition +// ============================================================ + +export default defineContentScript({ + matches: [''], + runAt: 'document_idle', + + main() { + // Only mount UI in the top frame + if (window.top !== window) return; + + let controller: ElementPickerController | null = null; + let currentSessionId: string | null = null; + + /** + * Ensure the controller is created and configured. + */ + function ensureController(): ElementPickerController { + if (controller) return controller; + + controller = createElementPickerController({ + onCancel: () => { + if (!currentSessionId) return; + void chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_UI_EVENT, + sessionId: currentSessionId, + event: 'cancel', + }); + }, + onConfirm: () => { + if (!currentSessionId) return; + void chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_UI_EVENT, + sessionId: currentSessionId, + event: 'confirm', + }); + }, + onSetActiveRequest: (requestId: string) => { + if (!currentSessionId) return; + void chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_UI_EVENT, + sessionId: currentSessionId, + event: 'set_active_request', + requestId, + }); + }, + onClearSelection: (requestId: string) => { + if (!currentSessionId) return; + void chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.ELEMENT_PICKER_UI_EVENT, + sessionId: currentSessionId, + event: 'clear_selection', + requestId, + }); + }, + }); + + return controller; + } + + /** + * Handle incoming messages from background. + */ + function handleMessage( + message: unknown, + _sender: chrome.runtime.MessageSender, + sendResponse: (response?: unknown) => void, + ): boolean | void { + const msg = message as PickerMessage | undefined; + if (!msg?.action) return false; + + // Respond to ping (used by background to check if UI script is ready) + if (msg.action === TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_PING) { + sendResponse({ success: true }); + return true; + } + + // Show the picker panel + if (msg.action === TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_SHOW) { + const showMsg = msg as UiShowMessage; + currentSessionId = typeof showMsg.sessionId === 'string' ? showMsg.sessionId : null; + + if (!currentSessionId) { + sendResponse({ success: false, error: 'Missing sessionId' }); + return true; + } + + const ctrl = ensureController(); + const initialState: ElementPickerUiState = { + sessionId: currentSessionId, + requests: Array.isArray(showMsg.requests) ? showMsg.requests : [], + activeRequestId: showMsg.activeRequestId ?? null, + selections: {}, + deadlineTs: typeof showMsg.deadlineTs === 'number' ? showMsg.deadlineTs : Date.now(), + errorMessage: null, + }; + ctrl.show(initialState); + sendResponse({ success: true }); + return true; + } + + // Update the picker panel state + if (msg.action === TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_UPDATE) { + const updateMsg = msg as UiUpdateMessage; + + if (!currentSessionId || updateMsg.sessionId !== currentSessionId) { + sendResponse({ success: false, error: 'Session mismatch' }); + return true; + } + + controller?.update({ + sessionId: currentSessionId, + activeRequestId: updateMsg.activeRequestId ?? null, + selections: updateMsg.selections || {}, + deadlineTs: updateMsg.deadlineTs, + errorMessage: updateMsg.errorMessage ?? null, + }); + sendResponse({ success: true }); + return true; + } + + // Hide the picker panel + if (msg.action === TOOL_MESSAGE_TYPES.ELEMENT_PICKER_UI_HIDE) { + const hideMsg = msg as UiHideMessage; + + // Best-effort hide even if session mismatches + if (currentSessionId && hideMsg.sessionId !== currentSessionId) { + // Log but don't fail + console.warn('[ElementPicker] Session mismatch on hide, hiding anyway'); + } + + controller?.hide(); + currentSessionId = null; + sendResponse({ success: true }); + return true; + } + + return false; + } + + // Register message listener + chrome.runtime.onMessage.addListener(handleMessage); + + // Cleanup on page unload + window.addEventListener('unload', () => { + chrome.runtime.onMessage.removeListener(handleMessage); + controller?.dispose(); + controller = null; + currentSessionId = null; + }); + }, +}); diff --git a/app/chrome-extension/entrypoints/offscreen/gif-encoder.ts b/app/chrome-extension/entrypoints/offscreen/gif-encoder.ts new file mode 100644 index 00000000..c3e4d52f --- /dev/null +++ b/app/chrome-extension/entrypoints/offscreen/gif-encoder.ts @@ -0,0 +1,201 @@ +/** + * GIF Encoder Module for Offscreen Document + * + * Handles GIF encoding using the gifenc library in the offscreen document context. + * This module provides frame-by-frame GIF encoding with palette quantization. + */ + +import { GIFEncoder, quantize, applyPalette } from 'gifenc'; +import { MessageTarget, OFFSCREEN_MESSAGE_TYPES } from '@/common/message-types'; + +// ============================================================================ +// Types +// ============================================================================ + +interface GifEncoderState { + encoder: ReturnType | null; + width: number; + height: number; + frameCount: number; + isInitialized: boolean; +} + +interface GifAddFrameMessage { + target: MessageTarget; + type: typeof OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME; + imageData: number[]; + width: number; + height: number; + delay: number; + maxColors?: number; +} + +interface GifFinishMessage { + target: MessageTarget; + type: typeof OFFSCREEN_MESSAGE_TYPES.GIF_FINISH; +} + +interface GifResetMessage { + target: MessageTarget; + type: typeof OFFSCREEN_MESSAGE_TYPES.GIF_RESET; +} + +type GifMessage = GifAddFrameMessage | GifFinishMessage | GifResetMessage; + +interface GifMessageResponse { + success: boolean; + error?: string; + frameCount?: number; + gifData?: number[]; + byteLength?: number; +} + +// ============================================================================ +// State +// ============================================================================ + +const state: GifEncoderState = { + encoder: null, + width: 0, + height: 0, + frameCount: 0, + isInitialized: false, +}; + +// ============================================================================ +// Handlers +// ============================================================================ + +function initializeEncoder(width: number, height: number): void { + state.encoder = GIFEncoder(); + state.width = width; + state.height = height; + state.frameCount = 0; + state.isInitialized = true; +} + +function addFrame( + imageData: Uint8ClampedArray, + width: number, + height: number, + delay: number, + maxColors: number = 256, +): void { + // Initialize encoder on first frame + if (!state.isInitialized || state.width !== width || state.height !== height) { + initializeEncoder(width, height); + } + + if (!state.encoder) { + throw new Error('GIF encoder not initialized'); + } + + // Quantize colors to create palette + const palette = quantize(imageData, maxColors, { format: 'rgb444' }); + + // Map pixels to palette indices + const indexedPixels = applyPalette(imageData, palette, 'rgb444'); + + // Write frame to encoder + state.encoder.writeFrame(indexedPixels, width, height, { + palette, + delay, + dispose: 2, // Restore to background color + }); + + state.frameCount++; +} + +function finishEncoding(): Uint8Array { + if (!state.encoder) { + throw new Error('GIF encoder not initialized'); + } + + state.encoder.finish(); + const bytes = state.encoder.bytes(); + + // Reset state after finishing + resetEncoder(); + + return bytes; +} + +function resetEncoder(): void { + if (state.encoder) { + state.encoder.reset(); + } + state.encoder = null; + state.width = 0; + state.height = 0; + state.frameCount = 0; + state.isInitialized = false; +} + +// ============================================================================ +// Message Handler +// ============================================================================ + +function isGifMessage(message: unknown): message is GifMessage { + if (!message || typeof message !== 'object') return false; + const msg = message as Record; + if (msg.target !== MessageTarget.Offscreen) return false; + + const gifTypes = [ + OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME, + OFFSCREEN_MESSAGE_TYPES.GIF_FINISH, + OFFSCREEN_MESSAGE_TYPES.GIF_RESET, + ]; + + return gifTypes.includes(msg.type as string); +} + +export function handleGifMessage( + message: unknown, + sendResponse: (response: GifMessageResponse) => void, +): boolean { + if (!isGifMessage(message)) { + return false; + } + + try { + switch (message.type) { + case OFFSCREEN_MESSAGE_TYPES.GIF_ADD_FRAME: { + const { imageData, width, height, delay, maxColors } = message; + const clampedData = new Uint8ClampedArray(imageData); + addFrame(clampedData, width, height, delay, maxColors); + sendResponse({ + success: true, + frameCount: state.frameCount, + }); + break; + } + + case OFFSCREEN_MESSAGE_TYPES.GIF_FINISH: { + const gifBytes = finishEncoding(); + sendResponse({ + success: true, + gifData: Array.from(gifBytes), + byteLength: gifBytes.byteLength, + }); + break; + } + + case OFFSCREEN_MESSAGE_TYPES.GIF_RESET: { + resetEncoder(); + sendResponse({ success: true }); + break; + } + + default: + sendResponse({ success: false, error: `Unknown GIF message type` }); + } + } catch (error) { + const errorMessage = error instanceof Error ? error.message : String(error); + console.error('GIF encoder error:', errorMessage); + sendResponse({ success: false, error: errorMessage }); + } + + return true; +} + +console.log('GIF encoder module loaded'); diff --git a/app/chrome-extension/entrypoints/offscreen/main.ts b/app/chrome-extension/entrypoints/offscreen/main.ts index 3f39e2a7..31aa5882 100644 --- a/app/chrome-extension/entrypoints/offscreen/main.ts +++ b/app/chrome-extension/entrypoints/offscreen/main.ts @@ -5,6 +5,11 @@ import { OFFSCREEN_MESSAGE_TYPES, BACKGROUND_MESSAGE_TYPES, } from '@/common/message-types'; +import { handleGifMessage } from './gif-encoder'; +import { initKeepalive } from './rr-keepalive'; + +// 初始化 RR V3 Keepalive +initKeepalive(); // Global semantic similarity engine instance let similarityEngine: SemanticSimilarityEngine | null = null; @@ -62,6 +67,11 @@ chrome.runtime.onMessage.addListener( return; } + // Handle GIF encoding messages first + if (handleGifMessage(message, sendResponse)) { + return true; + } + try { switch (message.type) { case SendMessageType.SimilarityEngineInit: diff --git a/app/chrome-extension/entrypoints/offscreen/rr-keepalive.ts b/app/chrome-extension/entrypoints/offscreen/rr-keepalive.ts new file mode 100644 index 00000000..0a58c634 --- /dev/null +++ b/app/chrome-extension/entrypoints/offscreen/rr-keepalive.ts @@ -0,0 +1,280 @@ +/** + * @fileoverview Offscreen Keepalive + * @description Keeps the MV3 service worker alive using an Offscreen Document + Port heartbeat. + * + * Architecture: + * - Offscreen connects to Background (Service Worker) via a named Port. + * - Offscreen sends periodic `keepalive.ping` messages while keepalive is enabled. + * - Background replies with `keepalive.pong` to confirm the channel is alive. + * + * Contract: + * - After `stop`, keepalive must fully stop: no ping loop, no Port, and no reconnection attempts. + * - After `start`, keepalive must (re)connect if needed and resume the ping loop. + */ + +import { + RR_V3_KEEPALIVE_PORT_NAME, + DEFAULT_KEEPALIVE_PING_INTERVAL_MS, + type KeepaliveMessage, +} from '@/common/rr-v3-keepalive-protocol'; + +// ==================== Runtime Control Protocol ==================== + +const KEEPALIVE_CONTROL_MESSAGE_TYPE = 'rr_v3_keepalive.control' as const; + +type KeepaliveControlCommand = 'start' | 'stop'; + +interface KeepaliveControlMessage { + type: typeof KEEPALIVE_CONTROL_MESSAGE_TYPE; + command: KeepaliveControlCommand; +} + +function isKeepaliveControlMessage(value: unknown): value is KeepaliveControlMessage { + if (!value || typeof value !== 'object') return false; + const v = value as Record; + if (v.type !== KEEPALIVE_CONTROL_MESSAGE_TYPE) return false; + return v.command === 'start' || v.command === 'stop'; +} + +// ==================== State ==================== + +let initialized = false; +let keepalivePort: chrome.runtime.Port | null = null; +let pingTimer: ReturnType | null = null; +/** Whether keepalive is desired (set by start/stop commands from Background) */ +let keepaliveDesired = false; +let reconnectTimer: ReturnType | null = null; + +// ==================== Type Guards ==================== + +/** + * Type guard for KeepaliveMessage. + */ +function isKeepaliveMessage(value: unknown): value is KeepaliveMessage { + if (!value || typeof value !== 'object') return false; + const v = value as Record; + + const type = v.type; + if ( + type !== 'keepalive.ping' && + type !== 'keepalive.pong' && + type !== 'keepalive.start' && + type !== 'keepalive.stop' + ) { + return false; + } + + return typeof v.timestamp === 'number' && Number.isFinite(v.timestamp); +} + +// ==================== Port Management ==================== + +/** + * Schedule a reconnect attempt to maintain the Port connection. + * Only reconnect while keepalive is desired. + */ +function scheduleReconnect(delayMs = 1000): void { + if (!initialized) return; + if (!keepaliveDesired) return; + if (reconnectTimer) return; + + reconnectTimer = setTimeout(() => { + reconnectTimer = null; + if (!initialized) return; + if (!keepaliveDesired) return; + if (!keepalivePort) { + console.log('[rr-keepalive] Attempting scheduled reconnect...'); + keepalivePort = connectToBackground(); + } + }, delayMs); +} + +/** + * Create a Port connection to Background. + */ +function connectToBackground(): chrome.runtime.Port | null { + if (typeof chrome === 'undefined' || !chrome.runtime?.connect) { + console.warn('[rr-keepalive] chrome.runtime.connect not available'); + return null; + } + + try { + const port = chrome.runtime.connect({ name: RR_V3_KEEPALIVE_PORT_NAME }); + + port.onMessage.addListener((msg: unknown) => { + if (!isKeepaliveMessage(msg)) return; + + if (msg.type === 'keepalive.start') { + console.log('[rr-keepalive] Received start command via Port'); + startPingLoop(); + } else if (msg.type === 'keepalive.stop') { + console.log('[rr-keepalive] Received stop command via Port'); + stopPingLoop(); + } else if (msg.type === 'keepalive.pong') { + // Background replied to our ping. + console.debug('[rr-keepalive] Received pong'); + } + }); + + port.onDisconnect.addListener(() => { + console.log('[rr-keepalive] Port disconnected'); + keepalivePort = null; + // Only reconnect if keepalive is still desired. + scheduleReconnect(1000); + }); + + console.log('[rr-keepalive] Connected to background'); + return port; + } catch (e) { + console.warn('[rr-keepalive] Failed to connect:', e); + return null; + } +} + +// ==================== Ping Loop ==================== + +/** + * Send a ping message to Background. + */ +function sendPing(): void { + if (!keepalivePort) { + keepalivePort = connectToBackground(); + } + + if (!keepalivePort) return; + + const msg: KeepaliveMessage = { + type: 'keepalive.ping', + timestamp: Date.now(), + }; + + try { + keepalivePort.postMessage(msg); + console.debug('[rr-keepalive] Sent ping'); + } catch (e) { + console.warn('[rr-keepalive] Failed to send ping:', e); + keepalivePort = null; + scheduleReconnect(1000); + } +} + +/** + * Start the ping loop. + */ +function startPingLoop(): void { + if (pingTimer) return; + + keepaliveDesired = true; + + // Ensure we have a Port connection. + if (!keepalivePort) { + keepalivePort = connectToBackground(); + } + + // Send one ping immediately. + sendPing(); + + // Start the interval timer. + pingTimer = setInterval(() => { + sendPing(); + }, DEFAULT_KEEPALIVE_PING_INTERVAL_MS); + + console.log( + `[rr-keepalive] Ping loop started (interval=${DEFAULT_KEEPALIVE_PING_INTERVAL_MS}ms)`, + ); +} + +/** + * Stop the ping loop. + * This must fully stop keepalive: no timer, no Port, and no reconnection attempts. + */ +function stopPingLoop(): void { + keepaliveDesired = false; + + if (pingTimer) { + clearInterval(pingTimer); + pingTimer = null; + } + + if (reconnectTimer) { + clearTimeout(reconnectTimer); + reconnectTimer = null; + } + + // Disconnect the Port to fully stop keepalive. + if (keepalivePort) { + try { + keepalivePort.disconnect(); + } catch { + // Ignore + } + keepalivePort = null; + } + + console.log('[rr-keepalive] Ping loop stopped'); +} + +// ==================== Public API ==================== + +/** + * Initialize keepalive control handlers. + * @description Registers the runtime control listener and waits for start/stop commands. + */ +export function initKeepalive(): void { + if (initialized) return; + initialized = true; + + // Check Chrome API availability. + if (typeof chrome === 'undefined' || !chrome.runtime?.onMessage) { + console.warn('[rr-keepalive] chrome.runtime.onMessage not available'); + return; + } + + // Listen for runtime control messages from Background. + // This allows Background to send start/stop even when Port is not connected. + chrome.runtime.onMessage.addListener((msg: unknown, _sender, sendResponse) => { + if (!isKeepaliveControlMessage(msg)) return; + + if (msg.command === 'start') { + console.log('[rr-keepalive] Received runtime start command'); + startPingLoop(); + } else { + console.log('[rr-keepalive] Received runtime stop command'); + stopPingLoop(); + } + + try { + sendResponse({ ok: true }); + } catch { + // Ignore + } + }); + + // Also establish initial Port connection for backwards compatibility. + if (chrome.runtime?.connect) { + keepalivePort = connectToBackground(); + } + + console.log('[rr-keepalive] Keepalive initialized'); +} + +/** + * Check whether keepalive is active. + */ +export function isKeepaliveActive(): boolean { + return keepaliveDesired && pingTimer !== null && keepalivePort !== null; +} + +/** + * Get the active port count (for debugging). + * @deprecated Use isKeepaliveActive() instead + */ +export function getActivePortCount(): number { + return keepalivePort ? 1 : 0; +} + +// Re-export for backwards compatibility +export { + RR_V3_KEEPALIVE_PORT_NAME, + type KeepaliveMessage, +} from '@/common/rr-v3-keepalive-protocol'; diff --git a/app/chrome-extension/entrypoints/options/App.vue b/app/chrome-extension/entrypoints/options/App.vue new file mode 100644 index 00000000..694f9cf1 --- /dev/null +++ b/app/chrome-extension/entrypoints/options/App.vue @@ -0,0 +1,398 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/Canvas.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/Canvas.vue new file mode 100644 index 00000000..1b580710 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/Canvas.vue @@ -0,0 +1,569 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/EdgePropertyPanel.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/EdgePropertyPanel.vue new file mode 100644 index 00000000..ea5cfd75 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/EdgePropertyPanel.vue @@ -0,0 +1,205 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/KeyValueEditor.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/KeyValueEditor.vue new file mode 100644 index 00000000..d3b3982e --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/KeyValueEditor.vue @@ -0,0 +1,80 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/PropertyPanel.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/PropertyPanel.vue new file mode 100644 index 00000000..1d04d652 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/PropertyPanel.vue @@ -0,0 +1,839 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/Sidebar.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/Sidebar.vue new file mode 100644 index 00000000..b52ea320 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/Sidebar.vue @@ -0,0 +1,372 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/TriggerPanel.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/TriggerPanel.vue new file mode 100644 index 00000000..4c0fa63e --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/TriggerPanel.vue @@ -0,0 +1,941 @@ +/** * @fileoverview Trigger Panel Component for Builder * @description * A floating panel for +managing V3 triggers in the Builder interface. * * Features: * - Lists all triggers for the current +flow * - Enable/disable toggle for all trigger types * - Create/edit/delete for panel-managed +triggers (interval, once) * - Manual trigger support for 'manual' type triggers * * Ownership model: +* - Node-managed triggers (ID prefix: trg_/sch_): Created by trigger node sync, read-only in panel * +- Panel-managed triggers (interval, once): Full CRUD in panel */ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeCard.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeCard.vue new file mode 100644 index 00000000..27846cf4 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeCard.vue @@ -0,0 +1,69 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeIf.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeIf.vue new file mode 100644 index 00000000..90f1d991 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/NodeIf.vue @@ -0,0 +1,107 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/node-util.ts b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/node-util.ts new file mode 100644 index 00000000..2ee52527 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/nodes/node-util.ts @@ -0,0 +1,119 @@ +// node-util.ts - shared UI helpers for node components +// Note: comments in English + +import type { NodeBase } from '@/entrypoints/background/record-replay/types'; +import { summarizeNode as summarize } from '../../model/transforms'; +import ILucideMousePointerClick from '~icons/lucide/mouse-pointer-click'; +import ILucideEdit3 from '~icons/lucide/edit-3'; +import ILucideKeyboard from '~icons/lucide/keyboard'; +import ILucideCompass from '~icons/lucide/compass'; +import ILucideGlobe from '~icons/lucide/globe'; +import ILucideFileCode2 from '~icons/lucide/file-code-2'; +import ILucideScan from '~icons/lucide/scan'; +import ILucideHourglass from '~icons/lucide/hourglass'; +import ILucideCheckCircle2 from '~icons/lucide/check-circle-2'; +import ILucideGitBranch from '~icons/lucide/git-branch'; +import ILucideRepeat from '~icons/lucide/repeat'; +import ILucideRefreshCcw from '~icons/lucide/refresh-ccw'; +import ILucideSquare from '~icons/lucide/square'; +import ILucideArrowLeftRight from '~icons/lucide/arrow-left-right'; +import ILucideX from '~icons/lucide/x'; +import ILucideZap from '~icons/lucide/zap'; +import ILucideCamera from '~icons/lucide/camera'; +import ILucideBell from '~icons/lucide/bell'; +import ILucideWrench from '~icons/lucide/wrench'; +import ILucideFrame from '~icons/lucide/frame'; +import ILucideDownload from '~icons/lucide/download'; +import ILucideArrowUpDown from '~icons/lucide/arrow-up-down'; +import ILucideMoveVertical from '~icons/lucide/move-vertical'; + +export function iconComp(t?: string) { + switch (t) { + case 'trigger': + return ILucideZap; + case 'click': + case 'dblclick': + return ILucideMousePointerClick; + case 'fill': + return ILucideEdit3; + case 'drag': + return ILucideArrowUpDown; + case 'scroll': + return ILucideMoveVertical; + case 'key': + return ILucideKeyboard; + case 'navigate': + return ILucideCompass; + case 'http': + return ILucideGlobe; + case 'script': + return ILucideFileCode2; + case 'screenshot': + return ILucideCamera; + case 'triggerEvent': + return ILucideBell; + case 'setAttribute': + return ILucideWrench; + case 'loopElements': + return ILucideRepeat; + case 'switchFrame': + return ILucideFrame; + case 'handleDownload': + return ILucideDownload; + case 'extract': + return ILucideScan; + case 'wait': + return ILucideHourglass; + case 'assert': + return ILucideCheckCircle2; + case 'if': + return ILucideGitBranch; + case 'foreach': + return ILucideRepeat; + case 'while': + return ILucideRefreshCcw; + case 'openTab': + return ILucideSquare; + case 'switchTab': + return ILucideArrowLeftRight; + case 'closeTab': + return ILucideX; + case 'delay': + return ILucideHourglass; + default: + return ILucideSquare; + } +} + +export function getTypeLabel(type?: string) { + const labels: Record = { + trigger: '触发器', + click: '点击', + fill: '填充', + navigate: '导航', + wait: '等待', + extract: '提取', + http: 'HTTP', + script: '脚本', + if: '条件', + foreach: '循环', + assert: '断言', + key: '键盘', + drag: '拖拽', + dblclick: '双击', + openTab: '打开标签', + switchTab: '切换标签', + closeTab: '关闭标签', + delay: '延迟', + scroll: '滚动', + while: '循环', + }; + return labels[String(type || '')] || type || ''; +} + +export function nodeSubtitle(node?: NodeBase | null): string { + if (!node) return ''; + const summary = summarize(node); + if (!summary) return node.type || ''; + return summary.length > 40 ? summary.slice(0, 40) + '...' : summary; +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyAssert.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyAssert.vue new file mode 100644 index 00000000..26924339 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyAssert.vue @@ -0,0 +1,50 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyClick.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyClick.vue new file mode 100644 index 00000000..5ae0c59d --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyClick.vue @@ -0,0 +1,15 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyCloseTab.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyCloseTab.vue new file mode 100644 index 00000000..2abde2a9 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyCloseTab.vue @@ -0,0 +1,38 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDelay.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDelay.vue new file mode 100644 index 00000000..d2a5a031 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDelay.vue @@ -0,0 +1,16 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDrag.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDrag.vue new file mode 100644 index 00000000..a8cf0359 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyDrag.vue @@ -0,0 +1,24 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExecuteFlow.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExecuteFlow.vue new file mode 100644 index 00000000..731819ae --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExecuteFlow.vue @@ -0,0 +1,61 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExtract.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExtract.vue new file mode 100644 index 00000000..d6badb9d --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyExtract.vue @@ -0,0 +1,37 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFill.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFill.vue new file mode 100644 index 00000000..f5f17686 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFill.vue @@ -0,0 +1,35 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyForeach.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyForeach.vue new file mode 100644 index 00000000..b2508f85 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyForeach.vue @@ -0,0 +1,43 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFormRenderer.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFormRenderer.vue new file mode 100644 index 00000000..062cfee5 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFormRenderer.vue @@ -0,0 +1,390 @@ + + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFromSpec.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFromSpec.vue new file mode 100644 index 00000000..3f9c5514 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyFromSpec.vue @@ -0,0 +1,36 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHandleDownload.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHandleDownload.vue new file mode 100644 index 00000000..6cec8c69 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHandleDownload.vue @@ -0,0 +1,34 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHttp.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHttp.vue new file mode 100644 index 00000000..5495cd75 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyHttp.vue @@ -0,0 +1,107 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyIf.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyIf.vue new file mode 100644 index 00000000..3ad26cc1 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyIf.vue @@ -0,0 +1,120 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyKey.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyKey.vue new file mode 100644 index 00000000..e558c694 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyKey.vue @@ -0,0 +1,20 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyLoopElements.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyLoopElements.vue new file mode 100644 index 00000000..3f92507c --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyLoopElements.vue @@ -0,0 +1,43 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyNavigate.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyNavigate.vue new file mode 100644 index 00000000..9d0ddeff --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyNavigate.vue @@ -0,0 +1,20 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyOpenTab.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyOpenTab.vue new file mode 100644 index 00000000..6fb9f822 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyOpenTab.vue @@ -0,0 +1,25 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScreenshot.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScreenshot.vue new file mode 100644 index 00000000..b4fcb7ce --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScreenshot.vue @@ -0,0 +1,33 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScript.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScript.vue new file mode 100644 index 00000000..e4c36296 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScript.vue @@ -0,0 +1,45 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScroll.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScroll.vue new file mode 100644 index 00000000..529eda9d --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyScroll.vue @@ -0,0 +1,99 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySetAttribute.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySetAttribute.vue new file mode 100644 index 00000000..828684fd --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySetAttribute.vue @@ -0,0 +1,34 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchFrame.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchFrame.vue new file mode 100644 index 00000000..7f128adf --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchFrame.vue @@ -0,0 +1,27 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchTab.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchTab.vue new file mode 100644 index 00000000..bdaab559 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertySwitchTab.vue @@ -0,0 +1,46 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTrigger.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTrigger.vue new file mode 100644 index 00000000..90fdf351 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTrigger.vue @@ -0,0 +1,226 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTriggerEvent.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTriggerEvent.vue new file mode 100644 index 00000000..34820a3c --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyTriggerEvent.vue @@ -0,0 +1,33 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWait.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWait.vue new file mode 100644 index 00000000..4c36c95d --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWait.vue @@ -0,0 +1,42 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWhile.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWhile.vue new file mode 100644 index 00000000..237927dd --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/PropertyWhile.vue @@ -0,0 +1,68 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/components/properties/SelectorEditor.vue b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/SelectorEditor.vue new file mode 100644 index 00000000..f988a8c3 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/components/properties/SelectorEditor.vue @@ -0,0 +1,119 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/form-widget-registry.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/form-widget-registry.ts new file mode 100644 index 00000000..41fb281a --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/form-widget-registry.ts @@ -0,0 +1,25 @@ +// form-widget-registry.ts — global widget registry for PropertyFormRenderer +import FieldExpression from '@/entrypoints/popup/components/builder/widgets/FieldExpression.vue'; +import FieldSelector from '@/entrypoints/popup/components/builder/widgets/FieldSelector.vue'; +import FieldDuration from '@/entrypoints/popup/components/builder/widgets/FieldDuration.vue'; +import FieldCode from '@/entrypoints/popup/components/builder/widgets/FieldCode.vue'; +import FieldKeySequence from '@/entrypoints/popup/components/builder/widgets/FieldKeySequence.vue'; +import FieldTargetLocator from '@/entrypoints/popup/components/builder/widgets/FieldTargetLocator.vue'; +import type { Component } from 'vue'; + +const REG = new Map(); + +export function registerDefaultWidgets() { + REG.set('expression', FieldExpression as unknown as Component); + REG.set('selector', FieldSelector as unknown as Component); + REG.set('duration', FieldDuration as unknown as Component); + REG.set('code', FieldCode as unknown as Component); + REG.set('keysequence', FieldKeySequence as unknown as Component); + // Structured TargetLocator based on a selector input + REG.set('targetlocator', FieldTargetLocator as unknown as Component); +} + +export function getWidget(name?: string): Component | null { + if (!name) return null; + return REG.get(name) || null; +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec-registry.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec-registry.ts new file mode 100644 index 00000000..521c5905 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec-registry.ts @@ -0,0 +1 @@ +export * from 'chrome-mcp-shared'; diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec.ts new file mode 100644 index 00000000..521c5905 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/node-spec.ts @@ -0,0 +1 @@ +export * from 'chrome-mcp-shared'; diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/node-specs-builtin.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/node-specs-builtin.ts new file mode 100644 index 00000000..521c5905 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/node-specs-builtin.ts @@ -0,0 +1 @@ +export * from 'chrome-mcp-shared'; diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/toast.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/toast.ts new file mode 100644 index 00000000..5e3889a1 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/toast.ts @@ -0,0 +1,14 @@ +// toast.ts - lightweight toast event bus for builder UI +// Usage: import { toast } and call toast('message', 'warn'|'error'|'info') + +export type ToastLevel = 'info' | 'warn' | 'error'; + +export function toast(message: string, level: ToastLevel = 'warn') { + try { + const ev = new CustomEvent('rr_toast', { detail: { message: String(message), level } }); + window.dispatchEvent(ev); + } catch { + // as a last resort + console[level === 'error' ? 'error' : level === 'warn' ? 'warn' : 'log']('[toast]', message); + } +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/transforms.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/transforms.ts new file mode 100644 index 00000000..368800a2 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/transforms.ts @@ -0,0 +1,147 @@ +import type { + Flow as FlowV2, + NodeBase, + Edge as EdgeV2, +} from '@/entrypoints/background/record-replay/types'; +import { + nodesToSteps as sharedNodesToSteps, + stepsToNodes as sharedStepsToNodes, + topoOrder as sharedTopoOrder, +} from 'chrome-mcp-shared'; +import { STEP_TYPES } from 'chrome-mcp-shared'; +import { EDGE_LABELS } from 'chrome-mcp-shared'; + +export function newId(prefix: string) { + return `${prefix}_${Math.random().toString(36).slice(2, 8)}`; +} + +export type NodeType = NodeBase['type']; + +export function defaultConfigFor(t: NodeType): any { + if ((t as any) === 'trigger') return { type: 'manual', description: '' }; + if (t === STEP_TYPES.CLICK || t === STEP_TYPES.FILL) + return { target: { candidates: [] }, value: t === STEP_TYPES.FILL ? '' : undefined }; + if (t === STEP_TYPES.IF) + return { branches: [{ id: newId('case'), name: '', expr: '' }], else: true }; + if (t === STEP_TYPES.NAVIGATE) return { url: '' }; + if (t === STEP_TYPES.WAIT) return { condition: { text: '', appear: true } }; + if (t === STEP_TYPES.ASSERT) return { assert: { exists: '' } }; + if (t === STEP_TYPES.KEY) return { keys: '' }; + if (t === STEP_TYPES.DELAY) return { ms: 1000 }; + if (t === STEP_TYPES.HTTP) return { method: 'GET', url: '', headers: {}, body: null, saveAs: '' }; + if (t === STEP_TYPES.EXTRACT) return { selector: '', attr: 'text', js: '', saveAs: '' }; + if (t === STEP_TYPES.SCREENSHOT) return { selector: '', fullPage: false, saveAs: 'shot' }; + if (t === STEP_TYPES.DRAG) + return { start: { candidates: [] }, end: { candidates: [] }, path: [] }; + if (t === STEP_TYPES.SCROLL) + return { mode: 'offset', offset: { x: 0, y: 300 }, target: { candidates: [] } }; + if (t === STEP_TYPES.TRIGGER_EVENT) + return { target: { candidates: [] }, event: 'input', bubbles: true, cancelable: false }; + if (t === STEP_TYPES.SET_ATTRIBUTE) return { target: { candidates: [] }, name: '', value: '' }; + if (t === STEP_TYPES.LOOP_ELEMENTS) + return { selector: '', saveAs: 'elements', itemVar: 'item', subflowId: '' }; + if (t === STEP_TYPES.SWITCH_FRAME) return { frame: { index: 0, urlContains: '' } }; + if (t === STEP_TYPES.HANDLE_DOWNLOAD) + return { filenameContains: '', waitForComplete: true, timeoutMs: 60000, saveAs: 'download' }; + if (t === STEP_TYPES.EXECUTE_FLOW) return { flowId: '', inline: true, args: {} }; + if (t === STEP_TYPES.OPEN_TAB) return { url: '', newWindow: false }; + if (t === STEP_TYPES.SWITCH_TAB) return { tabId: null, urlContains: '', titleContains: '' }; + if (t === STEP_TYPES.CLOSE_TAB) return { tabIds: [], url: '' }; + if (t === STEP_TYPES.SCRIPT) return { world: 'ISOLATED', code: '', saveAs: '', assign: {} }; + return {}; +} + +export function stepsToNodes(steps: any[]): NodeBase[] { + const base = sharedStepsToNodes(steps) as unknown as NodeBase[]; + // add simple UI positions + base.forEach((n, i) => { + (n as any).ui = (n as any).ui || { x: 200, y: 120 + i * 120 }; + }); + return base; +} + +export function topoOrder(nodes: NodeBase[], edges: EdgeV2[]): NodeBase[] { + const filtered = (edges || []).filter((e) => !e.label || e.label === EDGE_LABELS.DEFAULT); + return sharedTopoOrder(nodes as any, filtered as any) as any; +} + +export function nodesToSteps(nodes: NodeBase[], edges: EdgeV2[]): any[] { + // Exclude non-executable nodes like 'trigger' and cut edges from them + const execNodes = (nodes || []).filter((n) => n.type !== ('trigger' as any)); + const filtered = (edges || []).filter( + (e) => + (!e.label || e.label === EDGE_LABELS.DEFAULT) && !execNodes.every((n) => n.id !== e.from), + ); + return sharedNodesToSteps(execNodes as any, filtered as any); +} + +export function autoChainEdges(nodes: NodeBase[]): EdgeV2[] { + const arr: EdgeV2[] = []; + for (let i = 0; i < nodes.length - 1; i++) + arr.push({ + id: newId('e'), + from: nodes[i].id, + to: nodes[i + 1].id, + label: EDGE_LABELS.DEFAULT, + }); + return arr; +} + +export function summarizeNode(n?: NodeBase | null): string { + if (!n) return ''; + if (n.type === STEP_TYPES.CLICK || n.type === STEP_TYPES.FILL) + return n.config?.target?.candidates?.[0]?.value || '未配置选择器'; + if (n.type === STEP_TYPES.NAVIGATE) return n.config?.url || ''; + if (n.type === STEP_TYPES.KEY) return n.config?.keys || ''; + if (n.type === STEP_TYPES.DELAY) return `${Number(n.config?.ms || 0)}ms`; + if (n.type === STEP_TYPES.HTTP) return `${n.config?.method || 'GET'} ${n.config?.url || ''}`; + if (n.type === STEP_TYPES.EXTRACT) + return `${n.config?.selector || ''} -> ${n.config?.saveAs || ''}`; + if (n.type === STEP_TYPES.SCREENSHOT) + return n.config?.selector + ? `el(${n.config.selector}) -> ${n.config?.saveAs || ''}` + : `fullPage -> ${n.config?.saveAs || ''}`; + if (n.type === STEP_TYPES.TRIGGER_EVENT) + return `${n.config?.event || ''} ${n.config?.target?.candidates?.[0]?.value || ''}`; + if (n.type === STEP_TYPES.SET_ATTRIBUTE) + return `${n.config?.name || ''}=${n.config?.value ?? ''}`; + if (n.type === STEP_TYPES.LOOP_ELEMENTS) + return `${n.config?.selector || ''} as ${n.config?.itemVar || 'item'} -> ${n.config?.subflowId || ''}`; + if (n.type === STEP_TYPES.SWITCH_FRAME) + return n.config?.frame?.urlContains + ? `url~${n.config.frame.urlContains}` + : `index=${Number(n.config?.frame?.index ?? 0)}`; + if (n.type === STEP_TYPES.OPEN_TAB) return `open ${n.config?.url || ''}`; + if (n.type === STEP_TYPES.SWITCH_TAB) + return `switch ${n.config?.tabId || n.config?.urlContains || n.config?.titleContains || ''}`; + if (n.type === STEP_TYPES.CLOSE_TAB) return `close ${n.config?.url || ''}`; + if (n.type === STEP_TYPES.HANDLE_DOWNLOAD) return `download ${n.config?.filenameContains || ''}`; + if (n.type === STEP_TYPES.WAIT) return JSON.stringify(n.config?.condition || {}); + if (n.type === STEP_TYPES.ASSERT) return JSON.stringify(n.config?.assert || {}); + if (n.type === STEP_TYPES.IF) { + const cnt = Array.isArray(n.config?.branches) ? n.config.branches.length : 0; + return `if/else 分支数 ${cnt}${n.config?.else === false ? '' : ' + else'}`; + } + if (n.type === STEP_TYPES.SCRIPT) return (n.config?.code || '').slice(0, 30); + if (n.type === STEP_TYPES.DRAG) { + const a = n.config?.start?.candidates?.[0]?.value || ''; + const b = n.config?.end?.candidates?.[0]?.value || ''; + return a || b ? `${a} -> ${b}` : '拖拽'; + } + if (n.type === STEP_TYPES.SCROLL) { + const mode = n.config?.mode || 'offset'; + if (mode === 'offset' || mode === 'container') { + const x = Number(n.config?.offset?.x ?? 0); + const y = Number(n.config?.offset?.y ?? 0); + return `${mode} (${x}, ${y})`; + } + const sel = n.config?.target?.candidates?.[0]?.value || ''; + return sel ? `element ${sel}` : 'element'; + } + if (n.type === STEP_TYPES.EXECUTE_FLOW) return `exec ${n.config?.flowId || ''}`; + return ''; +} + +export function cloneFlow(flow: FlowV2): FlowV2 { + return JSON.parse(JSON.stringify(flow)); +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/ui-nodes.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/ui-nodes.ts new file mode 100644 index 00000000..20eea32f --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/ui-nodes.ts @@ -0,0 +1,172 @@ +// ui-nodes.ts — UI registry for builder nodes (sidebar, canvas, properties) +// Comments in English to explain intent. + +import { markRaw, type Component } from 'vue'; +import type { NodeBase, NodeType } from '@/entrypoints/background/record-replay/types'; +import { NODE_TYPES } from '@/common/node-types'; +import { defaultConfigFor as fallbackDefaultConfig } from '@/entrypoints/popup/components/builder/model/transforms'; +import { validateNode as fallbackValidateNode } from '@/entrypoints/popup/components/builder/model/validation'; +import { + listNodeSpecs, + getNodeSpec, +} from '@/entrypoints/popup/components/builder/model/node-spec-registry'; +import { STEP_TYPES } from 'chrome-mcp-shared'; + +// Canvas renderer components +import NodeCard from '@/entrypoints/popup/components/builder/components/nodes/NodeCard.vue'; +import NodeIf from '@/entrypoints/popup/components/builder/components/nodes/NodeIf.vue'; + +// Property components (per-node or shared) +import PropClick from '@/entrypoints/popup/components/builder/components/properties/PropertyClick.vue'; +import PropFill from '@/entrypoints/popup/components/builder/components/properties/PropertyFill.vue'; +import PropTriggerEvent from '@/entrypoints/popup/components/builder/components/properties/PropertyTriggerEvent.vue'; +import PropSetAttribute from '@/entrypoints/popup/components/builder/components/properties/PropertySetAttribute.vue'; +import PropDrag from '@/entrypoints/popup/components/builder/components/properties/PropertyDrag.vue'; +import PropScroll from '@/entrypoints/popup/components/builder/components/properties/PropertyScroll.vue'; +import PropNavigate from '@/entrypoints/popup/components/builder/components/properties/PropertyNavigate.vue'; +import PropertyFromSpec from '@/entrypoints/popup/components/builder/components/properties/PropertyFromSpec.vue'; +import { registerBuiltinSpecs } from '@/entrypoints/popup/components/builder/model/node-specs-builtin'; + +// Register builtin NodeSpecs at module init +registerBuiltinSpecs(); +import PropWait from '@/entrypoints/popup/components/builder/components/properties/PropertyWait.vue'; +import PropAssert from '@/entrypoints/popup/components/builder/components/properties/PropertyAssert.vue'; +import PropDelay from '@/entrypoints/popup/components/builder/components/properties/PropertyDelay.vue'; +import PropHttp from '@/entrypoints/popup/components/builder/components/properties/PropertyHttp.vue'; +import PropExtract from '@/entrypoints/popup/components/builder/components/properties/PropertyExtract.vue'; +import PropScreenshot from '@/entrypoints/popup/components/builder/components/properties/PropertyScreenshot.vue'; +import PropLoopElements from '@/entrypoints/popup/components/builder/components/properties/PropertyLoopElements.vue'; +import PropSwitchFrame from '@/entrypoints/popup/components/builder/components/properties/PropertySwitchFrame.vue'; +import PropHandleDownload from '@/entrypoints/popup/components/builder/components/properties/PropertyHandleDownload.vue'; +import PropExecuteFlow from '@/entrypoints/popup/components/builder/components/properties/PropertyExecuteFlow.vue'; +import PropOpenTab from '@/entrypoints/popup/components/builder/components/properties/PropertyOpenTab.vue'; +import PropSwitchTab from '@/entrypoints/popup/components/builder/components/properties/PropertySwitchTab.vue'; +import PropCloseTab from '@/entrypoints/popup/components/builder/components/properties/PropertyCloseTab.vue'; +import PropKey from '@/entrypoints/popup/components/builder/components/properties/PropertyKey.vue'; +import PropIf from '@/entrypoints/popup/components/builder/components/properties/PropertyIf.vue'; +import PropForeach from '@/entrypoints/popup/components/builder/components/properties/PropertyForeach.vue'; +import PropWhile from '@/entrypoints/popup/components/builder/components/properties/PropertyWhile.vue'; +import PropScript from '@/entrypoints/popup/components/builder/components/properties/PropertyScript.vue'; +import PropTrigger from '@/entrypoints/popup/components/builder/components/properties/PropertyTrigger.vue'; + +export type NodeCategory = 'Flow' | 'Actions' | 'Logic' | 'Tools' | 'Tabs' | 'Page'; + +export interface NodeUIConfig { + type: NodeType; + label: string; + category: NodeCategory; + iconClass: string; // reuse existing Sidebar.css color classes + canvas: Component; // canvas renderer + property: Component; // property renderer + docUrl?: string; + io?: { inputs?: number | 'any'; outputs?: number | 'any' }; + defaultConfig?: () => any; + validate?: (node: NodeBase) => string[]; +} + +// Registry contents generated from NodeSpec; use existing color/icon CSS classes +const baseCard = NodeCard as Component; + +function specToUi(spec: any): NodeUIConfig { + const canvas = spec.type === (STEP_TYPES.IF as any) ? (NodeIf as Component) : baseCard; + const outputs = Array.isArray(spec.ports?.outputs) ? spec.ports.outputs.length : 'any'; + return { + type: spec.type as any, + label: spec.display?.label || String(spec.type), + category: (spec.display?.category || 'Actions') as any, + iconClass: spec.display?.iconClass || 'icon-default', + // Mark component refs as raw to prevent them from being proxied/reactive by consumers + canvas: markRaw(canvas) as Component, + property: markRaw(PropertyFromSpec) as Component, + io: { inputs: spec.ports?.inputs ?? 1, outputs }, + defaultConfig: () => ({ ...(spec.defaults || {}) }), + validate: (node: NodeBase) => { + try { + const cfg = (node as any)?.config || {}; + return (getNodeSpec(node.type as any)?.validate?.(cfg) || []) as string[]; + } catch { + return []; + } + }, + } as any; +} + +export const NODE_UI_LIST: NodeUIConfig[] = listNodeSpecs().map(specToUi); + +const REGISTRY_MAP: Record = Object.fromEntries( + NODE_UI_LIST.map((n) => [n.type, n]), +); +export const NODE_UI_REGISTRY = REGISTRY_MAP as Record; + +export const NODE_CATEGORIES: NodeCategory[] = [ + 'Flow', + 'Actions', + 'Logic', + 'Tools', + 'Tabs', + 'Page', +]; + +export function listByCategory(): Record { + const out: Record = { + Flow: [], + Actions: [], + Logic: [], + Tools: [], + Tabs: [], + Page: [], + }; + for (const n of NODE_UI_LIST) out[n.category].push(n); + return out; +} + +export function canvasTypeKey(t: NodeType): string { + // Map to VueFlow node-types key, unique per node type + return `rr-${t}`; +} + +// Default config resolver with registry override +export function defaultConfigOf(t: NodeType): any { + // Prefer NodeSpec defaults + const spec = getNodeSpec(t as any); + if (spec?.defaults) return { ...spec.defaults }; + const item = (NODE_UI_REGISTRY as any)[t] as NodeUIConfig | undefined; + if (item?.defaultConfig) return item.defaultConfig(); + return fallbackDefaultConfig(t as any); +} + +// Validation via registry where present +export function validateNodeWithRegistry(n: NodeBase): string[] { + // Prefer NodeSpec validate + try { + const spec = getNodeSpec(n.type as any); + if (spec?.validate) return spec.validate((n as any).config || {}) || []; + } catch {} + const item = (NODE_UI_REGISTRY as any)[n.type] as NodeUIConfig | undefined; + if (item?.validate) { + try { + return item.validate(n) || []; + } catch {} + } + return fallbackValidateNode(n); +} + +// Allow external modules to register extra UI nodes +export function registerExtraUiNodes(list: NodeUIConfig[]) { + for (const n of list) { + (NODE_UI_LIST as any).push(n); + (REGISTRY_MAP as any)[n.type] = n; + } +} + +// IO constraints helper with sensible defaults for our graph +export function getIoConstraint(t: NodeType): { inputs: number | 'any'; outputs: number | 'any' } { + const item = (NODE_UI_REGISTRY as any)[t] as NodeUIConfig | undefined; + const io = item?.io || {}; + // Defaults: most nodes have single input; outputs unlimited unless otherwise defined + let inputs: number | 'any' = (io.inputs as any) ?? 1; + let outputs: number | 'any' = (io.outputs as any) ?? 'any'; + if ((t as any) === 'trigger') inputs = 0; + if ((t as any) === 'if') outputs = 'any'; + return { inputs, outputs }; +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/validation.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/validation.ts new file mode 100644 index 00000000..387467f2 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/validation.ts @@ -0,0 +1,127 @@ +import type { NodeBase } from '@/entrypoints/background/record-replay/types'; +import { STEP_TYPES } from 'chrome-mcp-shared'; + +export function validateNode(n: NodeBase): string[] { + const errs: string[] = []; + const c: any = n.config || {}; + + switch (n.type) { + case STEP_TYPES.CLICK: + case STEP_TYPES.DBLCLICK: + case 'fill': { + const hasCandidate = !!c?.target?.candidates?.length; + if (!hasCandidate) errs.push('缺少目标选择器候选'); + if (n.type === 'fill' && (!('value' in c) || c.value === undefined)) errs.push('缺少输入值'); + break; + } + case STEP_TYPES.WAIT: { + if (!c?.condition) errs.push('缺少等待条件'); + break; + } + case STEP_TYPES.ASSERT: { + if (!c?.assert) errs.push('缺少断言条件'); + break; + } + case STEP_TYPES.NAVIGATE: { + if (!c?.url) errs.push('缺少 URL'); + break; + } + case STEP_TYPES.HTTP: { + if (!c?.url) errs.push('HTTP: 缺少 URL'); + if (c?.assign && typeof c.assign === 'object') { + const pathRe = /^[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+|\[\d+\])*$/; + for (const v of Object.values(c.assign)) { + const s = String(v); + if (!pathRe.test(s)) errs.push(`Assign: 路径非法 ${s}`); + } + } + break; + } + case STEP_TYPES.HANDLE_DOWNLOAD: { + // filenameContains 可选 + break; + } + case STEP_TYPES.EXTRACT: { + if (!c?.saveAs) errs.push('Extract: 需填写保存变量名'); + if (!c?.selector && !c?.js) errs.push('Extract: 需提供 selector 或 js'); + break; + } + case STEP_TYPES.SWITCH_TAB: { + if (!c?.tabId && !c?.urlContains && !c?.titleContains) + errs.push('SwitchTab: 需提供 tabId 或 URL/标题包含'); + break; + } + case STEP_TYPES.SCREENSHOT: { + // selector 可空（全页/可视区），不强制 + break; + } + case STEP_TYPES.TRIGGER_EVENT: { + const hasCandidate = !!c?.target?.candidates?.length; + if (!hasCandidate) errs.push('缺少目标选择器候选'); + if (!String(c?.event || '').trim()) errs.push('需提供事件类型'); + break; + } + case STEP_TYPES.IF: { + const arr = Array.isArray(c?.branches) ? c.branches : []; + if (arr.length === 0) errs.push('需添加至少一个条件分支'); + for (let i = 0; i < arr.length; i++) { + if (!String(arr[i]?.expr || '').trim()) errs.push(`分支${i + 1}: 需填写条件表达式`); + } + break; + } + case STEP_TYPES.SET_ATTRIBUTE: { + const hasCandidate = !!c?.target?.candidates?.length; + if (!hasCandidate) errs.push('缺少目标选择器候选'); + if (!String(c?.name || '').trim()) errs.push('需提供属性名'); + break; + } + case STEP_TYPES.LOOP_ELEMENTS: { + if (!String(c?.selector || '').trim()) errs.push('需提供元素选择器'); + if (!String(c?.subflowId || '').trim()) errs.push('需提供子流 ID'); + break; + } + case STEP_TYPES.SWITCH_FRAME: { + // Both index/urlContains optional; empty means switch back to top frame + break; + } + case STEP_TYPES.EXECUTE_FLOW: { + if (!String(c?.flowId || '').trim()) errs.push('需选择要执行的工作流'); + break; + } + case STEP_TYPES.CLOSE_TAB: { + // 允许空（关闭当前标签页），不强制 + break; + } + case STEP_TYPES.SCRIPT: { + // 若配置了 saveAs/assign，应提供 code + const hasAssign = c?.assign && Object.keys(c.assign).length > 0; + if ((c?.saveAs || hasAssign) && !String(c?.code || '').trim()) + errs.push('Script: 配置了保存/映射但缺少代码'); + if (hasAssign) { + const pathRe = /^[A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+|\[\d+\])*$/; + for (const v of Object.values(c.assign || {})) { + const s = String(v); + if (!pathRe.test(s)) errs.push(`Assign: 路径非法 ${s}`); + } + } + break; + } + } + return errs; +} + +export function validateFlow(nodes: NodeBase[]): { + totalErrors: number; + nodeErrors: Record; +} { + const nodeErrors: Record = {}; + let totalErrors = 0; + for (const n of nodes) { + const e = validateNode(n); + if (e.length) { + nodeErrors[n.id] = e; + totalErrors += e.length; + } + } + return { totalErrors, nodeErrors }; +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/model/variables.ts b/app/chrome-extension/entrypoints/popup/components/builder/model/variables.ts new file mode 100644 index 00000000..f0b7c778 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/model/variables.ts @@ -0,0 +1,13 @@ +// variables.ts — Shared variable suggestion types for builder UI +export type VariableOrigin = 'global' | 'node'; + +export interface VariableOption { + key: string; + origin: VariableOrigin; + nodeId?: string; + nodeName?: string; +} + +export const VAR_TOKEN_OPEN = '{'; +export const VAR_TOKEN_CLOSE = '}'; +export const VAR_PLACEHOLDER = '{}'; diff --git a/app/chrome-extension/entrypoints/popup/components/builder/store/useBuilderStore.ts b/app/chrome-extension/entrypoints/popup/components/builder/store/useBuilderStore.ts new file mode 100644 index 00000000..05902ac1 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/store/useBuilderStore.ts @@ -0,0 +1,616 @@ +import { reactive, ref } from 'vue'; +import type { + Flow as FlowV2, + NodeBase, + Edge as EdgeV2, +} from '@/entrypoints/background/record-replay/types'; +import { + autoChainEdges, + cloneFlow, + newId, + stepsToNodes, + summarizeNode, + topoOrder, +} from '../model/transforms'; +import { defaultConfigOf, getIoConstraint } from '../model/ui-nodes'; +import { toast } from '../model/toast'; + +export function useBuilderStore(initial?: FlowV2 | null) { + const flowLocal = reactive({ id: '', name: '', version: 1, steps: [], variables: [] }); + const nodes = reactive([]); + const edges = reactive([]); + const activeNodeId = ref(null); + const activeEdgeId = ref(null); + const pendingFrom = ref(null); + const pendingLabel = ref('default'); + const paletteTypes = [ + 'trigger', + 'click', + 'drag', + 'scroll', + 'fill', + 'if', + 'foreach', + 'while', + 'key', + 'wait', + 'assert', + 'navigate', + 'script', + 'delay', + 'http', + 'extract', + 'screenshot', + 'triggerEvent', + 'setAttribute', + 'loopElements', + 'switchFrame', + 'handleDownload', + 'executeFlow', + 'openTab', + 'switchTab', + 'closeTab', + ] as NodeBase['type'][]; + + // --- history (undo/redo) --- + type Snapshot = { + flow: Pick; + nodes: NodeBase[]; + edges: EdgeV2[]; + }; + const HISTORY_MAX = 50; + const past: Snapshot[] = []; + const future: Snapshot[] = []; + function takeSnapshot(): Snapshot { + return { + flow: { name: flowLocal.name, description: flowLocal.description } as any, + nodes: JSON.parse(JSON.stringify(nodes)), + edges: JSON.parse(JSON.stringify(edges)), + }; + } + function applySnapshot(s: Snapshot) { + flowLocal.name = (s.flow as any).name || ''; + (flowLocal as any).description = (s.flow as any).description || ''; + nodes.splice(0, nodes.length, ...JSON.parse(JSON.stringify(s.nodes))); + edges.splice(0, edges.length, ...JSON.parse(JSON.stringify(s.edges))); + } + function recordChange() { + past.push(takeSnapshot()); + // clear redo stack on new change + future.length = 0; + if (past.length > HISTORY_MAX) past.splice(0, past.length - HISTORY_MAX); + } + function undo() { + if (past.length === 0) return; + const current = takeSnapshot(); + const prev = past.pop()!; + future.push(current); + applySnapshot(prev); + } + function redo() { + if (future.length === 0) return; + const current = takeSnapshot(); + const next = future.pop()!; + past.push(current); + applySnapshot(next); + } + + function layoutIfNeeded() { + const startX = 120, + startY = 80, + gapY = 120; + nodes.forEach((n, i) => { + if (!n.ui || isNaN(n.ui.x) || isNaN(n.ui.y)) n.ui = { x: startX, y: startY + i * gapY }; + }); + } + + function initFromFlow(flow: FlowV2) { + const deep = cloneFlow(flow); + Object.assign(flowLocal, deep); + // DAG is required - flow-store guarantees nodes/edges via normalization + // steps fallback removed (deprecated field no longer returned) + nodes.splice(0, nodes.length, ...(Array.isArray(deep.nodes) ? deep.nodes : [])); + edges.splice( + 0, + edges.length, + ...(Array.isArray(deep.edges) && deep.edges.length ? deep.edges : autoChainEdges(nodes)), + ); + layoutIfNeeded(); + activeNodeId.value = nodes[0]?.id || null; + activeEdgeId.value = null; + // reset history + past.length = 0; + future.length = 0; + past.push(takeSnapshot()); + } + + function selectNode(id: string | null) { + // When click on empty canvas, id can be null => deselect + if (id && pendingFrom.value && pendingFrom.value !== id) { + onConnect(pendingFrom.value, id, pendingLabel.value); + pendingFrom.value = null; + } + activeNodeId.value = id || null; + // selecting a node should clear edge selection + if (id) activeEdgeId.value = null; + } + + function selectEdge(id: string | null) { + activeEdgeId.value = id || null; + if (id) activeNodeId.value = null; + } + + function addNode(t: NodeBase['type']) { + const id = newId(t); + const n: NodeBase = { + id, + type: t, + name: '', + config: defaultConfigOf(t), + ui: { x: 200 + nodes.length * 24, y: 120 + nodes.length * 96 }, + }; + nodes.push(n); + if (nodes.length > 1) { + const prev = nodes[nodes.length - 2]; + edges.push({ id: newId('e'), from: prev.id, to: id, label: 'default' }); + } + activeNodeId.value = id; + recordChange(); + } + + function addNodeAt(t: NodeBase['type'], x: number, y: number) { + const id = newId(t); + const n: NodeBase = { + id, + type: t, + name: '', + config: defaultConfigOf(t), + ui: { x: Math.round(x), y: Math.round(y) }, + }; + nodes.push(n); + activeNodeId.value = id; + recordChange(); + } + + function duplicateNode(id: string) { + const src = nodes.find((n) => n.id === id); + if (!src) return; + const cp: NodeBase = JSON.parse(JSON.stringify(src)); + cp.id = newId(src.type); + cp.name = src.name ? `${src.name} Copy` : ''; + const baseX = cp.ui && typeof cp.ui.x === 'number' ? cp.ui.x : 200; + const baseY = cp.ui && typeof cp.ui.y === 'number' ? cp.ui.y : 120; + cp.ui = { x: baseX + 40, y: baseY + 40 }; + nodes.push(cp); + activeNodeId.value = cp.id; + recordChange(); + } + + function removeNode(id: string) { + const idx = nodes.findIndex((n) => n.id === id); + if (idx < 0) return; + nodes.splice(idx, 1); + for (let i = edges.length - 1; i >= 0; i--) { + const e = edges[i]; + if (e.from === id || e.to === id) edges.splice(i, 1); + } + // After removal, do not auto-select another node to avoid accidental batch deletes + activeNodeId.value = null; + activeEdgeId.value = null; + recordChange(); + } + + function removeEdge(id: string) { + const idx = edges.findIndex((e) => e.id === id); + if (idx < 0) return; + edges.splice(idx, 1); + if (activeEdgeId.value === id) activeEdgeId.value = null; + recordChange(); + } + + function setNodePosition(id: string, x: number, y: number) { + const n = nodes.find((n) => n.id === id); + if (!n) return; + n.ui = { x: Math.round(x), y: Math.round(y) }; + // 不计入历史栈，避免频繁记录；由用户触发操作（连接/新增/删除等）记录。 + } + + function connectFrom(id: string, label: string = 'default') { + pendingFrom.value = id; + pendingLabel.value = label; + } + + function onConnect(sourceId: string, targetId: string, label: string = 'default') { + // prevent self-loop + if (sourceId === targetId) { + toast('不能连接到自身', 'warn'); + return; + } + // IO constraints + try { + const src = nodes.find((n) => n.id === sourceId); + const dst = nodes.find((n) => n.id === targetId); + if (!src || !dst) return; + const srcIo = getIoConstraint(src.type as any); + const dstIo = getIoConstraint(dst.type as any); + // Inputs: respect numeric maximum; 'any' means unlimited + const incoming = edges.filter((e) => e.to === targetId).length; + if (dstIo.inputs !== 'any' && incoming >= (dstIo.inputs as number)) { + toast(`该节点最多允许 ${dstIo.inputs} 条入边`, 'warn'); + return; + } + // Outputs: respect numeric maximum when defined + if (srcIo.outputs !== 'any') { + const outgoing = edges.filter((e) => e.from === sourceId).length; + if (outgoing >= (srcIo.outputs as number)) { + toast(`该节点最多允许 ${srcIo.outputs} 条出边`, 'warn'); + return; + } + } + } catch {} + // 单一同标签出边：删除同源 + 同标签的已有边 + for (let i = edges.length - 1; i >= 0; i--) { + const e = edges[i]; + const lab = e.label || 'default'; + if (e.from === sourceId && lab === label) edges.splice(i, 1); + } + // avoid duplicate for same pair+label + if ( + edges.some( + (e) => e.from === sourceId && e.to === targetId && (e.label || 'default') === label, + ) + ) + return; + edges.push({ id: newId('e'), from: sourceId, to: targetId, label }); + recordChange(); + // auto select the newly created edge + try { + const last = edges[edges.length - 1]; + activeEdgeId.value = last?.id || null; + activeNodeId.value = null; + } catch {} + } + + /** + * Derive available variables for the property panel. + * - Includes declared flow variables (global) + * - Includes variables produced by preceding nodes (saveAs/assign/itemVar etc.) + * If currentId is provided, only nodes before it in topological order are considered. + */ + function listAvailableVariables(currentId?: string): Array<{ + key: string; + origin: 'global' | 'node'; + nodeId?: string; + nodeName?: string; + }> { + const result: Array<{ + key: string; + origin: 'global' | 'node'; + nodeId?: string; + nodeName?: string; + }> = []; + const seen = new Set(); + + // 1) Flow-declared variables + const declared = (flowLocal.variables || []) as Array<{ key: string }>; + for (const v of declared) { + const k = String(v?.key || '').trim(); + if (!k || seen.has(k)) continue; + seen.add(k); + result.push({ key: k, origin: 'global' }); + } + + // 2) Variables derived from previous nodes + const ordered = topoOrder(nodes as any, edges as any); + let cutoffIndex = + typeof currentId === 'string' ? ordered.findIndex((n) => n.id === currentId) : -1; + if (cutoffIndex < 0) cutoffIndex = ordered.length; // include all if not found + const prevNodes = ordered.slice(0, cutoffIndex); + for (const n of prevNodes) { + const cfg: any = (n as any).config || {}; + const nodeName = String((n as any).name || n.id || 'node'); + const pushVar = (k: string) => { + const key = String(k || '').trim(); + if (!key || seen.has(key)) return; + seen.add(key); + result.push({ key, origin: 'node', nodeId: n.id, nodeName }); + }; + // Generic saveAs + if (typeof cfg.saveAs === 'string') pushVar(cfg.saveAs); + // assign mapping (keys are variable names) + if (cfg.assign && typeof cfg.assign === 'object') { + for (const k of Object.keys(cfg.assign)) pushVar(k); + } + // loop elements: list var + item var + if ((n as any).type === 'loopElements') { + if (typeof cfg.saveAs === 'string') pushVar(cfg.saveAs); + if (typeof cfg.itemVar === 'string') pushVar(cfg.itemVar); + } + } + + return result; + } + + function importFromSteps() { + const arr = stepsToNodes(flowLocal.steps || []); + nodes.splice(0, nodes.length, ...arr); + edges.splice(0, edges.length, ...autoChainEdges(arr)); + layoutIfNeeded(); + recordChange(); + } + + // --- subflow management --- + const currentSubflowId = ref(null); + function ensureSubflows() { + if (!flowLocal.subflows) (flowLocal as any).subflows = {} as any; + } + function listSubflowIds(): string[] { + ensureSubflows(); + return Object.keys((flowLocal as any).subflows || {}); + } + function addSubflow(id: string) { + ensureSubflows(); + const sf = (flowLocal as any).subflows as any; + if (!id || sf[id]) return; + sf[id] = { nodes: [], edges: [] }; + recordChange(); + } + function removeSubflow(id: string) { + ensureSubflows(); + const sf = (flowLocal as any).subflows as any; + if (!sf[id]) return; + delete sf[id]; + if (currentSubflowId.value === id) switchToMain(); + recordChange(); + } + function flushCurrent() { + if (!currentSubflowId.value) { + // write back main + (flowLocal as any).nodes = JSON.parse(JSON.stringify(nodes)); + (flowLocal as any).edges = JSON.parse(JSON.stringify(edges)); + return; + } + ensureSubflows(); + (flowLocal as any).subflows[currentSubflowId.value] = { + nodes: JSON.parse(JSON.stringify(nodes)), + edges: JSON.parse(JSON.stringify(edges)), + }; + } + function switchToMain() { + flushCurrent(); + currentSubflowId.value = null; + nodes.splice(0, nodes.length, ...JSON.parse(JSON.stringify((flowLocal.nodes || []) as any))); + edges.splice(0, edges.length, ...JSON.parse(JSON.stringify((flowLocal.edges || []) as any))); + layoutIfNeeded(); + } + function switchToSubflow(id: string) { + flushCurrent(); + currentSubflowId.value = id; + ensureSubflows(); + const sf = (flowLocal as any).subflows[id] || { nodes: [], edges: [] }; + nodes.splice(0, nodes.length, ...JSON.parse(JSON.stringify(sf.nodes || []))); + edges.splice(0, edges.length, ...JSON.parse(JSON.stringify(sf.edges || []))); + layoutIfNeeded(); + } + const isEditingMain = () => currentSubflowId.value == null; + + /** + * Export flow for saving. This properly handles subflow editing: + * 1. Flushes current canvas state back to flowLocal + * 2. Returns a deep copy to avoid reference issues + * + * IMPORTANT: Always use this method for saving instead of directly + * accessing store.nodes/edges, which may contain subflow data. + * + * NOTE: flow.steps is no longer written here. The storage layer (flow-store.ts) + * will strip steps on save. Only nodes/edges are the source of truth. + */ + function exportFlowForSave(): FlowV2 { + // Step 1: Flush current canvas state to flowLocal + flushCurrent(); + + // Step 2: Return deep copy to prevent mutation + return JSON.parse(JSON.stringify(flowLocal)); + } + + function summarize(id?: string) { + const n = nodes.find((x) => x.id === id); + return summarizeNode(n || null); + } + + // 备用布局：分层 + 重心排序（不依赖外部库） + function layoutFallback() { + const idMap = new Map(); + nodes.forEach((n) => idMap.set(n.id, n)); + + // Build graph using all edges (include branches like case:/else/onError) + const inEdges = new Map(); + const outEdges = new Map(); + for (const n of nodes) { + inEdges.set(n.id, []); + outEdges.set(n.id, []); + } + for (const e of edges) { + if (!idMap.has(e.from) || !idMap.has(e.to)) continue; + inEdges.get(e.to)!.push(e); + outEdges.get(e.from)!.push(e); + } + + // Kahn topo with all edges; fall back to original order on cycles + const indeg = new Map(); + nodes.forEach((n) => indeg.set(n.id, inEdges.get(n.id)!.length)); + const q: string[] = []; + // Prefer trigger and existing left-most nodes first for stability + const roots = nodes + .filter((n) => (indeg.get(n.id) || 0) === 0) + .sort( + (a, b) => + (a.type === ('trigger' as any) ? -1 : 0) - (b.type === ('trigger' as any) ? -1 : 0), + ); + roots.forEach((r) => q.push(r.id)); + const topo: string[] = []; + const indegMut = new Map(indeg); + while (q.length) { + const v = q.shift()!; + topo.push(v); + for (const e of outEdges.get(v) || []) { + const d = (indegMut.get(e.to) || 0) - 1; + indegMut.set(e.to, d); + if (d === 0) q.push(e.to); + } + } + if (topo.length < nodes.length) { + // Graph may contain cycles; append remaining nodes in original order + for (const n of nodes) if (!topo.includes(n.id)) topo.push(n.id); + } + + // Level assignment: level = max(parent.level + 1) + const level = new Map(); + for (const id of topo) { + const parents = inEdges.get(id) || []; + let lv = 0; + for (const e of parents) lv = Math.max(lv, (level.get(e.from) || 0) + 1); + // Ensure trigger stays at level 0 + const node = idMap.get(id)!; + if ((node.type as any) === 'trigger') lv = 0; + level.set(id, lv); + } + + // Group nodes by level + const maxLevel = Math.max(0, ...Array.from(level.values())); + const layers: string[][] = Array.from({ length: maxLevel + 1 }, () => []); + for (const id of topo) layers[level.get(id) || 0].push(id); + + // Barycenter/median ordering per layer based on parent y-index + const yIndex = new Map(); + // initialize first layer stable order + layers[0].forEach((id, i) => yIndex.set(id, i)); + for (let lv = 1; lv < layers.length; lv++) { + const arr = layers[lv]; + const scored = arr.map((id) => { + const ps = inEdges.get(id) || []; + const parentIdx = ps + .map((e) => yIndex.get(e.from)) + .filter((v): v is number => typeof v === 'number'); + const score = parentIdx.length + ? parentIdx.reduce((a, b) => a + b, 0) / parentIdx.length + : 1e9; + return { id, score }; + }); + scored.sort((a, b) => a.score - b.score); + scored.forEach((s, i) => yIndex.set(s.id, i)); + layers[lv] = scored.map((s) => s.id); + } + + // Place nodes + const startX = 120; + const startY = 80; + const stepX = 280; // tighter than 300 to reduce wide gaps + const stepY = 110; + for (let lv = 0; lv < layers.length; lv++) { + const arr = layers[lv]; + for (let i = 0; i < arr.length; i++) { + const id = arr[i]; + const n = idMap.get(id)!; + n.ui = { x: startX + lv * stepX, y: startY + i * stepY } as any; + } + } + recordChange(); + } + + // 自动排版（ELK 优先）： + // - 动态引入 elkjs，避免常驻体积 + // - 失败则回退到 layoutFallback() + async function layoutAuto() { + try { + // Dynamic import of bundled build to avoid 'web-worker' resolution issues + const mod: any = await import('elkjs/lib/elk.bundled.js'); + const ELK = mod.default || mod.ELK || mod; + const elk = new ELK(); + + // Estimate node sizes (px). Keep close to actual NodeCard dimensions. + const estimateSize = (n: NodeBase) => { + const baseW = 280; + let baseH = 72; + if ((n.type as any) === 'if') baseH = 110; + return { width: baseW, height: baseH }; + }; + + const children = nodes.map((n) => ({ id: n.id, ...estimateSize(n) })); + const elkEdges = edges + .filter((e) => nodes.some((n) => n.id === e.from) && nodes.some((n) => n.id === e.to)) + .map((e) => ({ id: e.id, sources: [e.from], targets: [e.to] })); + + const graph = { + id: 'root', + layoutOptions: { + 'elk.algorithm': 'layered', + 'elk.direction': 'RIGHT', + 'elk.layered.spacing.nodeNodeBetweenLayers': '80', + 'elk.spacing.nodeNode': '40', + 'elk.layered.crossingMinimization.strategy': 'LAYER_SWEEP', + }, + children, + edges: elkEdges, + } as any; + + const res = await elk.layout(graph); + const pos = new Map(); + for (const c of res.children || []) { + pos.set(String(c.id), { x: Math.round(c.x || 0), y: Math.round(c.y || 0) }); + } + // anchor + const startX = 120; + const startY = 80; + for (const n of nodes) { + const p = pos.get(n.id); + if (p) n.ui = { x: startX + p.x, y: startY + p.y } as any; + } + recordChange(); + } catch (e) { + // Fallback without dependency + try { + layoutFallback(); + toast('ELK 自动布局不可用，已使用备用布局', 'warn'); + } catch {} + } + } + + if (initial) initFromFlow(initial); + + return { + flowLocal, + nodes, + edges, + activeNodeId, + activeEdgeId, + pendingFrom, + pendingLabel, + currentSubflowId, + paletteTypes, + undo, + redo, + initFromFlow, + selectNode, + selectEdge, + addNode, + duplicateNode, + removeNode, + removeEdge, + setNodePosition, + addNodeAt, + connectFrom, + onConnect, + listAvailableVariables, + listSubflowIds, + addSubflow, + removeSubflow, + switchToMain, + switchToSubflow, + isEditingMain, + importFromSteps, + exportFlowForSave, + summarize, + layoutAuto, + }; +} diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldCode.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldCode.vue new file mode 100644 index 00000000..24a0c793 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldCode.vue @@ -0,0 +1,31 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldDuration.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldDuration.vue new file mode 100644 index 00000000..2b95aa87 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldDuration.vue @@ -0,0 +1,49 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldExpression.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldExpression.vue new file mode 100644 index 00000000..6fa3276d --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldExpression.vue @@ -0,0 +1,42 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldKeySequence.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldKeySequence.vue new file mode 100644 index 00000000..9f9dccbd --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldKeySequence.vue @@ -0,0 +1,20 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldSelector.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldSelector.vue new file mode 100644 index 00000000..d06c9716 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldSelector.vue @@ -0,0 +1,94 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldTargetLocator.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldTargetLocator.vue new file mode 100644 index 00000000..c5f21ade --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/FieldTargetLocator.vue @@ -0,0 +1,85 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/builder/widgets/VarInput.vue b/app/chrome-extension/entrypoints/popup/components/builder/widgets/VarInput.vue new file mode 100644 index 00000000..da3489a5 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/builder/widgets/VarInput.vue @@ -0,0 +1,248 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/EditIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/EditIcon.vue new file mode 100644 index 00000000..3d5627aa --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/EditIcon.vue @@ -0,0 +1,26 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/MarkerIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/MarkerIcon.vue new file mode 100644 index 00000000..1dc321d1 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/MarkerIcon.vue @@ -0,0 +1,27 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/RecordIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/RecordIcon.vue new file mode 100644 index 00000000..df97c625 --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/RecordIcon.vue @@ -0,0 +1,17 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/RefreshIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/RefreshIcon.vue new file mode 100644 index 00000000..8ab4738c --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/RefreshIcon.vue @@ -0,0 +1,26 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/StopIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/StopIcon.vue new file mode 100644 index 00000000..57e1bb3f --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/StopIcon.vue @@ -0,0 +1,15 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/WorkflowIcon.vue b/app/chrome-extension/entrypoints/popup/components/icons/WorkflowIcon.vue new file mode 100644 index 00000000..b64a152a --- /dev/null +++ b/app/chrome-extension/entrypoints/popup/components/icons/WorkflowIcon.vue @@ -0,0 +1,26 @@ + + + diff --git a/app/chrome-extension/entrypoints/popup/components/icons/index.ts b/app/chrome-extension/entrypoints/popup/components/icons/index.ts index 8c6ed3b7..e86a5ac6 100644 --- a/app/chrome-extension/entrypoints/popup/components/icons/index.ts +++ b/app/chrome-extension/entrypoints/popup/components/icons/index.ts @@ -5,3 +5,9 @@ export { default as TrashIcon } from './TrashIcon.vue'; export { default as CheckIcon } from './CheckIcon.vue'; export { default as TabIcon } from './TabIcon.vue'; export { default as VectorIcon } from './VectorIcon.vue'; +export { default as RecordIcon } from './RecordIcon.vue'; +export { default as StopIcon } from './StopIcon.vue'; +export { default as WorkflowIcon } from './WorkflowIcon.vue'; +export { default as RefreshIcon } from './RefreshIcon.vue'; +export { default as EditIcon } from './EditIcon.vue'; +export { default as MarkerIcon } from './MarkerIcon.vue'; diff --git a/app/chrome-extension/entrypoints/popup/main.ts b/app/chrome-extension/entrypoints/popup/main.ts index f8c23e47..a3e42f67 100644 --- a/app/chrome-extension/entrypoints/popup/main.ts +++ b/app/chrome-extension/entrypoints/popup/main.ts @@ -1,5 +1,16 @@ import { createApp } from 'vue'; +import { NativeMessageType } from 'chrome-mcp-shared'; import './style.css'; +// 引入AgentChat主题样式 +import '../sidepanel/styles/agent-chat.css'; +import { preloadAgentTheme } from '../sidepanel/composables/useAgentTheme'; import App from './App.vue'; -createApp(App).mount('#app'); +// 在Vue挂载前预加载主题，防止主题闪烁 +preloadAgentTheme().then(() => { + // Trigger ensure native connection (fire-and-forget, don't block UI mounting) + void chrome.runtime.sendMessage({ type: NativeMessageType.ENSURE_NATIVE }).catch(() => { + // Silent failure - background will handle reconnection + }); + createApp(App).mount('#app'); +}); diff --git a/app/chrome-extension/entrypoints/quick-panel.content.ts b/app/chrome-extension/entrypoints/quick-panel.content.ts new file mode 100644 index 00000000..c25fd723 --- /dev/null +++ b/app/chrome-extension/entrypoints/quick-panel.content.ts @@ -0,0 +1,115 @@ +/** + * Quick Panel Content Script + * + * This content script manages the Quick Panel AI Chat feature on web pages. + * It responds to: + * - Background messages (toggle_quick_panel from keyboard shortcut) + * - Direct programmatic calls + * + * The Quick Panel provides a floating AI chat interface that: + * - Uses Shadow DOM for style isolation + * - Streams AI responses in real-time + * - Supports keyboard shortcuts (Enter to send, Esc to close) + * - Collects page context (URL, selection) automatically + */ + +import { createQuickPanelController, type QuickPanelController } from '@/shared/quick-panel'; + +export default defineContentScript({ + matches: [''], + runAt: 'document_idle', + + main() { + console.log('[QuickPanelContentScript] Content script loaded on:', window.location.href); + let controller: QuickPanelController | null = null; + + /** + * Ensure controller is initialized (lazy initialization) + */ + function ensureController(): QuickPanelController { + if (!controller) { + controller = createQuickPanelController({ + title: 'Agent', + subtitle: 'Quick Panel', + placeholder: 'Ask about this page...', + }); + } + return controller; + } + + /** + * Handle messages from background script + */ + function handleMessage( + message: unknown, + _sender: chrome.runtime.MessageSender, + sendResponse: (response?: unknown) => void, + ): boolean | void { + const msg = message as { action?: string } | undefined; + + if (msg?.action === 'toggle_quick_panel') { + console.log('[QuickPanelContentScript] Received toggle_quick_panel message'); + try { + const ctrl = ensureController(); + ctrl.toggle(); + const visible = ctrl.isVisible(); + console.log('[QuickPanelContentScript] Toggle completed, visible:', visible); + sendResponse({ success: true, visible }); + } catch (err) { + console.error('[QuickPanelContentScript] Toggle error:', err); + sendResponse({ success: false, error: String(err) }); + } + return true; // Async response + } + + if (msg?.action === 'show_quick_panel') { + try { + const ctrl = ensureController(); + ctrl.show(); + sendResponse({ success: true }); + } catch (err) { + console.error('[QuickPanelContentScript] Show error:', err); + sendResponse({ success: false, error: String(err) }); + } + return true; + } + + if (msg?.action === 'hide_quick_panel') { + try { + if (controller) { + controller.hide(); + } + sendResponse({ success: true }); + } catch (err) { + console.error('[QuickPanelContentScript] Hide error:', err); + sendResponse({ success: false, error: String(err) }); + } + return true; + } + + if (msg?.action === 'get_quick_panel_status') { + sendResponse({ + success: true, + visible: controller?.isVisible() ?? false, + initialized: controller !== null, + }); + return true; + } + + // Not handled + return false; + } + + // Register message listener + chrome.runtime.onMessage.addListener(handleMessage); + + // Cleanup on page unload + window.addEventListener('unload', () => { + chrome.runtime.onMessage.removeListener(handleMessage); + if (controller) { + controller.dispose(); + controller = null; + } + }); + }, +}); diff --git a/app/chrome-extension/entrypoints/shared/composables/index.ts b/app/chrome-extension/entrypoints/shared/composables/index.ts new file mode 100644 index 00000000..a52c408a --- /dev/null +++ b/app/chrome-extension/entrypoints/shared/composables/index.ts @@ -0,0 +1,11 @@ +/** + * @fileoverview Shared UI Composables + * @description Composables shared between multiple UI entrypoints (Sidepanel, Builder, Popup, etc.) + * + * Note: These composables are for UI-only use. Do not import them in background scripts + * as they depend on Vue and will bloat the service worker bundle. + */ + +// RR V3 RPC Client +export { useRRV3Rpc } from './useRRV3Rpc'; +export type { UseRRV3Rpc, UseRRV3RpcOptions, RpcRequestOptions } from './useRRV3Rpc'; diff --git a/app/chrome-extension/entrypoints/shared/composables/useRRV3Rpc.ts b/app/chrome-extension/entrypoints/shared/composables/useRRV3Rpc.ts new file mode 100644 index 00000000..3d527f99 --- /dev/null +++ b/app/chrome-extension/entrypoints/shared/composables/useRRV3Rpc.ts @@ -0,0 +1,504 @@ +/** + * @fileoverview RR V3 Port-RPC Client Composable (Shared) + * @description RPC client for UI components to connect with Background Service Worker + * + * This composable is shared between Sidepanel, Builder, and other UI entrypoints. + * + * Responsibilities: + * - Connect to background via chrome.runtime.Port + * - Provide request/response RPC calls (with timeout and cancellation) + * - Support event stream subscription + * - Auto-reconnect with exponential backoff + * + * Design considerations: + * - MV3 service worker may be terminated due to idle, causing Port disconnect + * - Implement idempotent reconnection and subscription recovery + */ + +import { computed, onUnmounted, ref, shallowRef, type ComputedRef, type Ref } from 'vue'; + +import type { JsonObject, JsonValue } from '@/entrypoints/background/record-replay-v3/domain/json'; +import type { RunEvent } from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { RunId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import { + RR_V3_PORT_NAME, + createRpcRequest, + isRpcEvent, + isRpcResponse, + type RpcMethod, +} from '@/entrypoints/background/record-replay-v3/engine/transport/rpc'; + +// ==================== Types ==================== + +/** RPC request options */ +export interface RpcRequestOptions { + /** Timeout in milliseconds, 0 means no timeout */ + timeoutMs?: number; + /** Abort signal for cancellation */ + signal?: AbortSignal; +} + +/** Composable configuration */ +export interface UseRRV3RpcOptions { + /** Default request timeout (ms) */ + requestTimeoutMs?: number; + /** Maximum reconnect attempts */ + maxReconnectAttempts?: number; + /** Base delay for reconnection (ms) */ + baseReconnectDelayMs?: number; + /** Auto-connect on initialization */ + autoConnect?: boolean; + /** Connection state change callback */ + onConnectionChange?: (connected: boolean) => void; + /** Error callback */ + onError?: (error: string) => void; +} + +/** Event listener function */ +type EventListener = (event: RunEvent) => void; + +/** Pending request entry */ +interface PendingRequest { + method: RpcMethod; + resolve: (value: JsonValue) => void; + reject: (error: Error) => void; + timeoutId: ReturnType | null; + /** AbortSignal reference for cleanup */ + signal?: AbortSignal; + /** Abort handler for cleanup */ + abortHandler?: () => void; +} + +/** Composable return type */ +export interface UseRRV3Rpc { + // Connection state + connected: Ref; + connecting: Ref; + reconnecting: Ref; + reconnectAttempts: Ref; + lastError: Ref; + isReady: ComputedRef; + + // Diagnostics + pendingCount: Ref; + subscribedRunIds: Ref>; + + // Connection lifecycle + connect: () => Promise; + disconnect: (reason?: string) => void; + ensureConnected: () => Promise; + + // RPC calls + request: ( + method: RpcMethod, + params?: JsonObject, + options?: RpcRequestOptions, + ) => Promise; + + // Event subscription + subscribe: (runId?: RunId | null) => Promise; + unsubscribe: (runId?: RunId | null) => Promise; + onEvent: (listener: EventListener) => () => void; +} + +// ==================== Helpers ==================== + +function toErrorMessage(error: unknown): string { + return error instanceof Error ? error.message : String(error); +} + +function isRunEvent(value: unknown): value is RunEvent { + if (typeof value !== 'object' || value === null) return false; + const obj = value as Record; + return ( + typeof obj.runId === 'string' && + typeof obj.type === 'string' && + typeof obj.seq === 'number' && + typeof obj.ts === 'number' + ); +} + +// ==================== Composable ==================== + +/** + * RR V3 Port-RPC client + */ +export function useRRV3Rpc(options: UseRRV3RpcOptions = {}): UseRRV3Rpc { + // Configuration + const DEFAULT_TIMEOUT_MS = options.requestTimeoutMs ?? 12_000; + const MAX_RECONNECT_ATTEMPTS = options.maxReconnectAttempts ?? 8; + const BASE_RECONNECT_DELAY_MS = options.baseReconnectDelayMs ?? 500; + + // Reactive state + const connected = ref(false); + const connecting = ref(false); + const reconnecting = ref(false); + const reconnectAttempts = ref(0); + const lastError = ref(null); + const pendingCount = ref(0); + const subscribedRunIds = ref>([]); + + // Internal state (non-reactive) + const port = shallowRef(null); + const pendingRequests = new Map(); + const eventListeners = new Set(); + const desiredSubscriptions = new Set(); + let connectPromise: Promise | null = null; + let reconnectTimer: ReturnType | null = null; + let manualDisconnect = false; + + // Computed + const isReady = computed(() => connected.value && port.value !== null); + + // ==================== Internal Methods ==================== + + function setError(message: string | null): void { + lastError.value = message; + if (message) options.onError?.(message); + } + + function setConnected(next: boolean): void { + if (connected.value === next) return; + connected.value = next; + options.onConnectionChange?.(next); + } + + function syncSubscriptionsSnapshot(): void { + const arr = Array.from(desiredSubscriptions.values()); + arr.sort((a, b) => { + // Both null - equal + if (a === null && b === null) return 0; + // null comes first + if (a === null) return -1; + if (b === null) return 1; + return String(a).localeCompare(String(b)); + }); + subscribedRunIds.value = arr; + } + + /** + * Clean up a pending request entry (timeout, abort listener) + */ + function cleanupPendingRequest(entry: PendingRequest): void { + if (entry.timeoutId) { + clearTimeout(entry.timeoutId); + entry.timeoutId = null; + } + if (entry.signal && entry.abortHandler) { + try { + entry.signal.removeEventListener('abort', entry.abortHandler); + } catch { + // Ignore - signal may be invalid + } + } + } + + function rejectAllPending(reason: string): void { + const error = new Error(reason); + for (const [requestId, entry] of pendingRequests) { + cleanupPendingRequest(entry); + entry.reject(error); + pendingRequests.delete(requestId); + } + pendingCount.value = 0; + } + + async function rehydrateSubscriptions(): Promise { + if (!isReady.value || desiredSubscriptions.size === 0) return; + + for (const runId of desiredSubscriptions) { + try { + const params: JsonObject = runId === null ? {} : { runId }; + await request('rr_v3.subscribe', params).catch(() => { + // Best-effort, ignore errors + }); + } catch { + // Ignore + } + } + } + + function scheduleReconnect(): void { + if (manualDisconnect || reconnectTimer) return; + + if (reconnectAttempts.value >= MAX_RECONNECT_ATTEMPTS) { + reconnecting.value = false; + setError('RR V3 RPC: max reconnect attempts reached'); + return; + } + + reconnecting.value = true; + const delay = BASE_RECONNECT_DELAY_MS * Math.pow(2, reconnectAttempts.value); + + reconnectTimer = setTimeout(() => { + reconnectTimer = null; + reconnectAttempts.value += 1; + void connect().then((ok) => { + if (!ok) scheduleReconnect(); + }); + }, delay); + } + + // ==================== Port Handlers ==================== + + function handlePortDisconnect(): void { + // Capture disconnect reason for debugging + const disconnectReason = chrome.runtime.lastError?.message; + const reason = disconnectReason + ? `RR V3 RPC disconnected: ${disconnectReason}` + : 'RR V3 RPC disconnected'; + + port.value = null; + setConnected(false); + connecting.value = false; + rejectAllPending(reason); + + // Update lastError for UI visibility (only on unexpected disconnect) + if (!manualDisconnect) { + setError(reason); + scheduleReconnect(); + } + } + + function handlePortMessage(msg: unknown): void { + // Handle RPC response + if (isRpcResponse(msg)) { + const entry = pendingRequests.get(msg.requestId); + if (!entry) return; + + pendingRequests.delete(msg.requestId); + pendingCount.value = pendingRequests.size; + + // Clean up timeout and abort listener + cleanupPendingRequest(entry); + + if (msg.ok) { + entry.resolve(msg.result as JsonValue); + } else { + entry.reject(new Error(msg.error || `RPC error: ${entry.method}`)); + } + return; + } + + // Handle event push + if (isRpcEvent(msg)) { + const event = msg.event; + if (!isRunEvent(event)) return; + + for (const listener of eventListeners) { + try { + listener(event); + } catch (e) { + console.error('[useRRV3Rpc] Event listener error:', e); + } + } + } + } + + // ==================== Public Methods ==================== + + async function connect(): Promise { + if (isReady.value) return true; + if (connectPromise) return connectPromise; + + connectPromise = (async () => { + manualDisconnect = false; + connecting.value = true; + setError(null); + + try { + if (typeof chrome === 'undefined' || !chrome.runtime?.connect) { + setError('chrome.runtime.connect not available'); + return false; + } + + const p = chrome.runtime.connect({ name: RR_V3_PORT_NAME }); + port.value = p; + + // Reset reconnect state + reconnectAttempts.value = 0; + reconnecting.value = false; + if (reconnectTimer) { + clearTimeout(reconnectTimer); + reconnectTimer = null; + } + + p.onMessage.addListener(handlePortMessage); + p.onDisconnect.addListener(handlePortDisconnect); + + setConnected(true); + + // Restore subscriptions + void rehydrateSubscriptions(); + + return true; + } catch (error) { + setError(`Connection failed: ${toErrorMessage(error)}`); + return false; + } finally { + connecting.value = false; + connectPromise = null; + } + })(); + + return connectPromise; + } + + function disconnect(reason?: string): void { + manualDisconnect = true; + + if (reconnectTimer) { + clearTimeout(reconnectTimer); + reconnectTimer = null; + } + reconnecting.value = false; + + const p = port.value; + port.value = null; + setConnected(false); + connecting.value = false; + + rejectAllPending(reason || 'RR V3 RPC: client disconnected'); + + if (p) { + try { + p.onMessage.removeListener(handlePortMessage); + p.onDisconnect.removeListener(handlePortDisconnect); + p.disconnect(); + } catch { + // Ignore + } + } + } + + async function ensureConnected(): Promise { + if (isReady.value) return true; + return connect(); + } + + async function request( + method: RpcMethod, + params?: JsonObject, + reqOptions: RpcRequestOptions = {}, + ): Promise { + const ready = await ensureConnected(); + const p = port.value; + + if (!ready || !p) { + throw new Error('RR V3 RPC: not connected'); + } + + const timeoutMs = reqOptions.timeoutMs ?? DEFAULT_TIMEOUT_MS; + const { signal } = reqOptions; + + if (signal?.aborted) { + throw new Error('RPC request already aborted'); + } + + const req = createRpcRequest(method, params); + + return new Promise((resolve, reject) => { + const entry: PendingRequest = { + method, + resolve: resolve as (value: JsonValue) => void, + reject, + timeoutId: null, + signal, + }; + + // Helper to complete request with cleanup + const complete = (fn: () => void) => { + pendingRequests.delete(req.requestId); + pendingCount.value = pendingRequests.size; + cleanupPendingRequest(entry); + fn(); + }; + + // Timeout handling + if (timeoutMs > 0) { + entry.timeoutId = setTimeout(() => { + complete(() => reject(new Error(`RPC timeout (${timeoutMs}ms): ${method}`))); + }, timeoutMs); + } + + // Abort handling + if (signal) { + const onAbort = () => { + complete(() => reject(new Error('RPC request aborted'))); + }; + entry.abortHandler = onAbort; + signal.addEventListener('abort', onAbort, { once: true }); + } + + pendingRequests.set(req.requestId, entry); + pendingCount.value = pendingRequests.size; + + try { + p.postMessage(req); + } catch (e) { + complete(() => reject(new Error(`Failed to send RPC request: ${toErrorMessage(e)}`))); + } + }); + } + + async function subscribe(runId: RunId | null = null): Promise { + desiredSubscriptions.add(runId); + syncSubscriptionsSnapshot(); + + try { + const params: JsonObject = runId === null ? {} : { runId }; + await request('rr_v3.subscribe', params); + return true; + } catch (error) { + setError(toErrorMessage(error)); + return false; + } + } + + async function unsubscribe(runId: RunId | null = null): Promise { + desiredSubscriptions.delete(runId); + syncSubscriptionsSnapshot(); + + try { + const params: JsonObject = runId === null ? {} : { runId }; + await request('rr_v3.unsubscribe', params); + return true; + } catch (error) { + setError(toErrorMessage(error)); + return false; + } + } + + function onEvent(listener: EventListener): () => void { + eventListeners.add(listener); + return () => eventListeners.delete(listener); + } + + // ==================== Lifecycle ==================== + + onUnmounted(() => { + disconnect('Component unmounted'); + }); + + if (options.autoConnect) { + void ensureConnected(); + } + + return { + connected, + connecting, + reconnecting, + reconnectAttempts, + lastError, + isReady, + pendingCount, + subscribedRunIds, + connect, + disconnect, + ensureConnected, + request, + subscribe, + unsubscribe, + onEvent, + }; +} diff --git a/app/chrome-extension/entrypoints/shared/utils/index.ts b/app/chrome-extension/entrypoints/shared/utils/index.ts new file mode 100644 index 00000000..522adcd9 --- /dev/null +++ b/app/chrome-extension/entrypoints/shared/utils/index.ts @@ -0,0 +1,14 @@ +/** + * @fileoverview Shared Utilities Index + * @description Utility functions shared between UI entrypoints + */ + +// Flow conversion utilities +export { + flowV2ToV3ForRpc, + flowV3ToV2ForBuilder, + isFlowV3, + isFlowV2, + extractFlowCandidates, + type FlowConversionResult, +} from './rr-flow-convert'; diff --git a/app/chrome-extension/entrypoints/shared/utils/rr-flow-convert.ts b/app/chrome-extension/entrypoints/shared/utils/rr-flow-convert.ts new file mode 100644 index 00000000..338a8566 --- /dev/null +++ b/app/chrome-extension/entrypoints/shared/utils/rr-flow-convert.ts @@ -0,0 +1,141 @@ +/** + * @fileoverview V2/V3 Flow 双向转换工具 + * @description 桥接 Builder V2 Flow 类型与 V3 RPC FlowV3 类型 + * + * 设计说明: + * - Builder store 目前仍使用 V2 类型 (type, version, steps) + * - RPC 层使用 V3 类型 (kind, schemaVersion, entryNodeId) + * - 本模块提供 UI 层的类型转换，封装底层转换器 + */ + +import type { Flow as FlowV2 } from '@/entrypoints/background/record-replay/types'; +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3/domain/flow'; +import { + convertFlowV2ToV3, + convertFlowV3ToV2, +} from '@/entrypoints/background/record-replay-v3/storage/import/v2-to-v3'; + +// ==================== Types ==================== + +export interface FlowConversionResult { + flow: T; + warnings: string[]; +} + +// ==================== V2 -> V3 (for RPC calls) ==================== + +/** + * 将 V2 Flow 转换为 V3 格式，用于 RPC 保存 + * @param flowV2 Builder store 中的 V2 Flow + * @returns V3 Flow 和警告信息 + * @throws 转换失败时抛出错误 + */ +export function flowV2ToV3ForRpc(flowV2: FlowV2): FlowConversionResult { + const result = convertFlowV2ToV3(flowV2 as unknown as Parameters[0]); + + if (!result.success || !result.data) { + const errorMsg = + result.errors.length > 0 ? result.errors.join('; ') : 'Unknown conversion error'; + throw new Error(`V2→V3 conversion failed: ${errorMsg}`); + } + + return { + flow: result.data, + warnings: result.warnings, + }; +} + +// ==================== V3 -> V2 (for Builder display) ==================== + +/** + * 将 V3 Flow 转换为 V2 格式，用于 Builder 显示和编辑 + * @param flowV3 从 RPC 获取的 V3 Flow + * @returns V2 Flow 和警告信息 + * @throws 转换失败时抛出错误 + */ +export function flowV3ToV2ForBuilder(flowV3: FlowV3): FlowConversionResult { + const result = convertFlowV3ToV2(flowV3); + + if (!result.success || !result.data) { + const errorMsg = + result.errors.length > 0 ? result.errors.join('; ') : 'Unknown conversion error'; + throw new Error(`V3→V2 conversion failed: ${errorMsg}`); + } + + return { + flow: result.data as unknown as FlowV2, + warnings: result.warnings, + }; +} + +// ==================== Type Guards ==================== + +/** + * 判断是否为 V3 Flow + * @description 用于导入时判断 JSON 格式 + */ +export function isFlowV3(value: unknown): value is FlowV3 { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + return false; + } + + const obj = value as Record; + return ( + obj.schemaVersion === 3 && + typeof obj.id === 'string' && + typeof obj.name === 'string' && + typeof obj.entryNodeId === 'string' && + Array.isArray(obj.nodes) + ); +} + +/** + * 判断是否为 V2 Flow + * @description 用于导入时判断 JSON 格式 + */ +export function isFlowV2(value: unknown): value is FlowV2 { + if (!value || typeof value !== 'object' || Array.isArray(value)) { + return false; + } + + const obj = value as Record; + return ( + typeof obj.id === 'string' && + typeof obj.name === 'string' && + // V2 有 version 字段（数字），且没有 schemaVersion + typeof obj.version === 'number' && + obj.schemaVersion === undefined && + // V2 可能有 steps 或 nodes + (Array.isArray(obj.steps) || Array.isArray(obj.nodes)) + ); +} + +// ==================== Import Helpers ==================== + +/** + * 从导入的 JSON 中提取 Flow 候选列表 + * @description 支持单个 Flow、Flow 数组、或 { flows: Flow[] } 格式 + */ +export function extractFlowCandidates(parsed: unknown): unknown[] { + // 数组格式 + if (Array.isArray(parsed)) { + return parsed; + } + + // 对象格式 + if (parsed && typeof parsed === 'object') { + const obj = parsed as Record; + + // { flows: [...] } 格式 + if (Array.isArray(obj.flows)) { + return obj.flows; + } + + // 单个 Flow 对象 + if (obj.id && (Array.isArray(obj.steps) || Array.isArray(obj.nodes))) { + return [obj]; + } + } + + return []; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/App.vue b/app/chrome-extension/entrypoints/sidepanel/App.vue new file mode 100644 index 00000000..9b59e369 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/App.vue @@ -0,0 +1,1368 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/AgentChat.vue b/app/chrome-extension/entrypoints/sidepanel/components/AgentChat.vue new file mode 100644 index 00000000..2a115991 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/AgentChat.vue @@ -0,0 +1,1401 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/SidepanelNavigator.vue b/app/chrome-extension/entrypoints/sidepanel/components/SidepanelNavigator.vue new file mode 100644 index 00000000..68916364 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/SidepanelNavigator.vue @@ -0,0 +1,441 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentChatShell.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentChatShell.vue new file mode 100644 index 00000000..a6618606 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentChatShell.vue @@ -0,0 +1,229 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentComposer.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentComposer.vue new file mode 100644 index 00000000..826e4909 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent-chat/AgentComposer.vue @@ -0,0 +1,731 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/CliSettings.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/CliSettings.vue new file mode 100644 index 00000000..70095e92 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/CliSettings.vue @@ -0,0 +1,130 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/ConnectionStatus.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/ConnectionStatus.vue new file mode 100644 index 00000000..7f686c88 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/ConnectionStatus.vue @@ -0,0 +1,41 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageItem.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageItem.vue new file mode 100644 index 00000000..cf0e0686 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageItem.vue @@ -0,0 +1,39 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageList.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageList.vue new file mode 100644 index 00000000..d470cef4 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/MessageList.vue @@ -0,0 +1,19 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectCreateForm.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectCreateForm.vue new file mode 100644 index 00000000..bfb8ab34 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectCreateForm.vue @@ -0,0 +1,81 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectSelector.vue b/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectSelector.vue new file mode 100644 index 00000000..8f37cdb6 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/ProjectSelector.vue @@ -0,0 +1,97 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/agent/index.ts b/app/chrome-extension/entrypoints/sidepanel/components/agent/index.ts new file mode 100644 index 00000000..880152b1 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/agent/index.ts @@ -0,0 +1,12 @@ +/** + * Agent Chat Components + * Export all sub-components for the agent chat feature. + */ +export { default as ConnectionStatus } from './ConnectionStatus.vue'; +export { default as ProjectSelector } from './ProjectSelector.vue'; +export { default as ProjectCreateForm } from './ProjectCreateForm.vue'; +export { default as CliSettings } from './CliSettings.vue'; +export { default as MessageList } from './MessageList.vue'; +export { default as MessageItem } from './MessageItem.vue'; +export { default as ChatInput } from './ChatInput.vue'; +export { default as AttachmentPreview } from './AttachmentPreview.vue'; diff --git a/app/chrome-extension/entrypoints/sidepanel/components/rr-v3/DebuggerPanel.vue b/app/chrome-extension/entrypoints/sidepanel/components/rr-v3/DebuggerPanel.vue new file mode 100644 index 00000000..7ba302ee --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/rr-v3/DebuggerPanel.vue @@ -0,0 +1,377 @@ + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowListItem.vue b/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowListItem.vue new file mode 100644 index 00000000..b994609f --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowListItem.vue @@ -0,0 +1,371 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowsView.vue b/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowsView.vue new file mode 100644 index 00000000..21e69d56 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/workflows/WorkflowsView.vue @@ -0,0 +1,747 @@ + + + + + diff --git a/app/chrome-extension/entrypoints/sidepanel/components/workflows/index.ts b/app/chrome-extension/entrypoints/sidepanel/components/workflows/index.ts new file mode 100644 index 00000000..b37c75ae --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/components/workflows/index.ts @@ -0,0 +1,2 @@ +export { default as WorkflowsView } from './WorkflowsView.vue'; +export { default as WorkflowListItem } from './WorkflowListItem.vue'; diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/index.ts b/app/chrome-extension/entrypoints/sidepanel/composables/index.ts new file mode 100644 index 00000000..c66aa7e6 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/index.ts @@ -0,0 +1,65 @@ +/** + * Agent Chat Composables + * Export all composables for agent chat functionality. + */ +export { useAgentServer } from './useAgentServer'; +export { useAgentChat } from './useAgentChat'; +export { useAgentProjects } from './useAgentProjects'; +export { useAgentSessions } from './useAgentSessions'; +export { useAttachments, type AttachmentWithPreview } from './useAttachments'; +export { useAgentTheme, preloadAgentTheme, THEME_LABELS } from './useAgentTheme'; +export { useAgentThreads, AGENT_SERVER_PORT_KEY } from './useAgentThreads'; +export { useWebEditorTxState, WEB_EDITOR_TX_STATE_INJECTION_KEY } from './useWebEditorTxState'; +export { useAgentChatViewRoute } from './useAgentChatViewRoute'; + +export type { UseAgentServerOptions } from './useAgentServer'; +export type { UseAgentChatOptions } from './useAgentChat'; +export type { UseAgentProjectsOptions } from './useAgentProjects'; +export type { UseAgentSessionsOptions } from './useAgentSessions'; +export type { AgentThemeId, UseAgentTheme } from './useAgentTheme'; +export type { + AgentThread, + TimelineItem, + ToolPresentation, + ToolKind, + ToolSeverity, + AgentThreadState, + UseAgentThreadsOptions, + ThreadHeader, + WebEditorApplyMeta, +} from './useAgentThreads'; +export type { UseWebEditorTxStateOptions, WebEditorTxStateReturn } from './useWebEditorTxState'; +export type { + AgentChatView, + AgentChatRouteState, + UseAgentChatViewRouteOptions, + UseAgentChatViewRoute, +} from './useAgentChatViewRoute'; + +// RR V3 Composables +export { useRRV3Rpc } from './useRRV3Rpc'; +export { useRRV3Debugger } from './useRRV3Debugger'; +export type { UseRRV3Rpc, UseRRV3RpcOptions, RpcRequestOptions } from './useRRV3Rpc'; +export type { UseRRV3Debugger, UseRRV3DebuggerOptions } from './useRRV3Debugger'; + +// Textarea Auto-Resize +export { useTextareaAutoResize } from './useTextareaAutoResize'; +export type { + UseTextareaAutoResizeOptions, + UseTextareaAutoResizeReturn, +} from './useTextareaAutoResize'; + +// Fake Caret (comet tail animation) +export { useFakeCaret } from './useFakeCaret'; +export type { UseFakeCaretOptions, UseFakeCaretReturn, FakeCaretTrailPoint } from './useFakeCaret'; + +// Open Project Preference +export { useOpenProjectPreference } from './useOpenProjectPreference'; +export type { + UseOpenProjectPreferenceOptions, + UseOpenProjectPreference, +} from './useOpenProjectPreference'; + +// Agent Input Preferences (fake caret, etc.) +export { useAgentInputPreferences } from './useAgentInputPreferences'; +export type { UseAgentInputPreferences } from './useAgentInputPreferences'; diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChat.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChat.ts new file mode 100644 index 00000000..51cae91a --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChat.ts @@ -0,0 +1,504 @@ +/** + * Composable for managing Agent Chat state and messages. + * Handles message sending, receiving, and cancellation. + */ +import { ref, computed } from 'vue'; +import type { + AgentMessage, + AgentActRequest, + AgentActRequestClientMeta, + AgentAttachment, + RealtimeEvent, + AgentStatusEvent, + AgentCliPreference, + AgentUsageStats, +} from 'chrome-mcp-shared'; + +/** + * Request lifecycle state. + * - 'idle': No active request + * - 'starting': Request accepted, waiting for engine initialization + * - 'ready': Engine initialized, preparing to run + * - 'running': Engine actively processing (may emit tool_use/tool_result) + * - 'completed': Request finished successfully + * - 'cancelled': Request was cancelled by user + * - 'error': Request failed with error + */ +export type RequestState = 'idle' | AgentStatusEvent['status']; + +export interface UseAgentChatOptions { + getServerPort: () => number | null; + getSessionId: () => string; + ensureServer: () => Promise; + openEventSource: () => void; +} + +export function useAgentChat(options: UseAgentChatOptions) { + // State + const messages = ref([]); + const input = ref(''); + const sending = ref(false); + /** + * Message-level streaming state. + * True when receiving delta updates for assistant/tool messages. + * Note: This is separate from requestState - a request can be 'running' + * even when isStreaming is false (e.g., during tool execution). + */ + const isStreaming = ref(false); + /** + * Request lifecycle state driven by status events. + * Use this (via isRequestActive) for UI elements like stop button, + * loading indicators, and running badges. + */ + const requestState = ref('idle'); + const errorMessage = ref(null); + const currentRequestId = ref(null); + const cancelling = ref(false); + const attachments = ref([]); + const lastUsage = ref(null); + + // Computed + const canSend = computed(() => { + return input.value.trim().length > 0 && !sending.value; + }); + + /** + * Whether there is an active request in progress. + * Use this for UI elements like stop button, loading indicators, and running badges. + */ + const isRequestActive = computed(() => { + return ( + requestState.value === 'starting' || + requestState.value === 'ready' || + requestState.value === 'running' + ); + }); + + /** + * Check if an incoming event belongs to a different active request. + * Used to filter out stale events from previous requests. + */ + function isDifferentActiveRequest(incomingRequestId?: string): boolean { + const incoming = incomingRequestId?.trim(); + const current = currentRequestId.value?.trim(); + // No incoming ID or no current ID means we can't determine - don't filter + if (!incoming || !current) return false; + // Same request ID - don't filter + if (incoming === current) return false; + // Different request ID while we have an active request - filter it out + return isRequestActive.value; + } + + /** + * Handle incoming realtime events. + * Events are filtered by sessionId to prevent cross-session state pollution + * when user switches sessions while SSE connection is still active. + */ + function handleRealtimeEvent(event: RealtimeEvent): void { + const currentSessionId = options.getSessionId(); + + switch (event.type) { + case 'message': + // Guard: only handle messages for the current session + if (event.data.sessionId !== currentSessionId) { + return; + } + handleMessageEvent(event.data); + break; + case 'status': + // Guard: only handle status for the current session + if (event.data.sessionId !== currentSessionId) { + return; + } + handleStatusEvent(event.data); + break; + case 'error': + // Error events may not have sessionId, but if they do, filter + if (event.data?.sessionId && event.data.sessionId !== currentSessionId) { + return; + } + // Filter out errors from different active requests + if (isDifferentActiveRequest(event.data?.requestId)) { + return; + } + errorMessage.value = event.error; + isStreaming.value = false; + requestState.value = 'error'; + // Clear requestId if it matches the error event's requestId (or unconditionally if no requestId in error) + if (!event.data?.requestId || event.data.requestId === currentRequestId.value) { + currentRequestId.value = null; + } + break; + case 'connected': + console.log('[AgentChat] Connected to session:', event.data.sessionId); + break; + case 'heartbeat': + // Heartbeat received, connection is alive + break; + case 'usage': + // Guard: only accept usage for the current session + if (event.data?.sessionId && event.data.sessionId !== currentSessionId) { + return; + } + lastUsage.value = event.data; + break; + } + } + + // Handle message events + function handleMessageEvent(msg: AgentMessage): void { + // For user messages from server, replace local optimistic message + // Server echoes user message with real id/metadata, but we want to keep our display text + // (which doesn't include injected context like web editor selection) + if (msg.role === 'user' && msg.requestId) { + const optimisticIndex = messages.value.findIndex( + (m) => m.role === 'user' && m.requestId === msg.requestId && m.id.startsWith('temp-'), + ); + if (optimisticIndex >= 0) { + // Replace optimistic message: keep display content, update id and metadata + const optimistic = messages.value[optimisticIndex]; + messages.value[optimisticIndex] = { + ...msg, + // Preserve the display content (user's raw input without injected context) + content: optimistic.content, + // Prefer server metadata, fallback to optimistic metadata (for chip rendering) + metadata: msg.metadata ?? optimistic.metadata, + }; + return; + } + } + + // Check if this message belongs to a different active request + // Note: We still save the message to messages array (for auditing/replay), + // but skip state updates if it's from a stale request + const msgRequestId = msg.requestId?.trim() || undefined; + const isStaleForState = isDifferentActiveRequest(msgRequestId); + + const existingIndex = messages.value.findIndex((m) => m.id === msg.id); + + if (existingIndex >= 0) { + // Update existing message (streaming update) + messages.value[existingIndex] = msg; + } else { + // Add new message - always save, even if stale for state + messages.value.push(msg); + } + + // Skip state updates for messages from different active requests + if (isStaleForState) { + return; + } + + // Track requestId from messages (handles cases where status events were missed) + if (msgRequestId && msgRequestId !== currentRequestId.value) { + currentRequestId.value = msgRequestId; + } + + // Update message-level streaming state (delta updates) + // Note: This does NOT affect requestState - tool_use with isStreaming=false + // should not stop the overall request, only indicate this message is complete + if (msg.role === 'assistant' || msg.role === 'tool') { + isStreaming.value = msg.isStreaming === true && !msg.isFinal; + + // If we're receiving model/tool output but requestState hasn't progressed to 'running', + // update it. This handles: + // 1. Edge case where status events were missed due to SSE timing + // 2. User enters AgentChat mid-request (e.g., from Quick Panel/toolbar trigger) + // 3. SSE reconnection after temporary disconnect + if ( + requestState.value === 'idle' || + requestState.value === 'starting' || + requestState.value === 'ready' + ) { + requestState.value = 'running'; + } + } + } + + // Handle status events + function handleStatusEvent(status: AgentStatusEvent): void { + const statusRequestId = status.requestId?.trim() || undefined; + + // Filter out status events from different active requests + if (isDifferentActiveRequest(statusRequestId)) { + return; + } + + // Track requestId from status events + if (statusRequestId && statusRequestId !== currentRequestId.value) { + currentRequestId.value = statusRequestId; + } + + // Update request lifecycle state (driven by status events only) + requestState.value = status.status; + + switch (status.status) { + case 'starting': + case 'ready': + case 'running': + // Request is active - no additional state changes needed + break; + case 'completed': + case 'error': + case 'cancelled': + // Request finished - clear message streaming and requestId + isStreaming.value = false; + // Reset cancelling state (in case we were waiting for SSE confirmation) + cancelling.value = false; + if (!statusRequestId || statusRequestId === currentRequestId.value) { + currentRequestId.value = null; + } + break; + } + } + + // Send message + async function send( + chatOptions: { + cliPreference?: string; + model?: string; + projectId?: string; + projectRoot?: string; + dbSessionId?: string; + /** + * Optional instruction to send instead of input.value. + * When provided, this is used as the actual instruction sent to the server, + * while input.value is still used for UI display in the optimistic message. + * This is useful for injecting context (e.g., web editor selection) into the prompt + * without showing it in the chat UI. + */ + instruction?: string; + /** + * Optional compact display text stored in the user message metadata. + * When provided, the UI can render a special header (e.g., a chip) instead + * of the raw prompt content. + */ + displayText?: string; + /** + * Optional client metadata to persist with the user message. + * Used for special UI rendering (e.g., web editor apply/selection chips). + */ + clientMeta?: AgentActRequestClientMeta; + } = {}, + ): Promise { + // User-visible content is always the user's raw input + const userText = input.value.trim(); + // Actual instruction sent to server can be overridden (e.g., with context prepended) + const instructionText = chatOptions.instruction?.trim() || userText; + + if (!userText) return; + + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + const sessionId = options.getSessionId(); + + if (!ready || !serverPort) { + errorMessage.value = 'Agent server is not available.'; + return; + } + + // Ensure SSE is connected before sending + options.openEventSource(); + + // Generate requestId on client side for optimistic message matching + // Server will use this requestId when echoing user message via SSE + const requestId = crypto.randomUUID(); + + // Create optimistic user message for immediate feedback + // Note: Use userText for UI, not instructionText (which may contain injected context) + const tempMessageId = `temp-${Date.now()}`; + const optimisticMessage: AgentMessage = { + id: tempMessageId, + sessionId: sessionId, + role: 'user', + content: userText, + messageType: 'chat', + requestId, // Include requestId so we can match with server-echoed message + createdAt: new Date().toISOString(), + // Include metadata for immediate chip rendering (before server echo) + metadata: + chatOptions.displayText || chatOptions.clientMeta + ? { + displayText: chatOptions.displayText?.trim(), + clientMeta: chatOptions.clientMeta, + } + : undefined, + }; + + // Add user message immediately + messages.value.push(optimisticMessage); + + const payload: AgentActRequest = { + // Use instructionText which may include injected context (e.g., web editor selection) + instruction: instructionText, + requestId, // Send requestId to server so it can be used in SSE events + // Optional metadata for special UI rendering (stored with the user message) + displayText: chatOptions.displayText?.trim() || undefined, + clientMeta: chatOptions.clientMeta, + cliPreference: chatOptions.cliPreference + ? (chatOptions.cliPreference as AgentCliPreference) + : undefined, + model: chatOptions.model?.trim() || undefined, + projectId: chatOptions.projectId || undefined, + projectRoot: chatOptions.projectRoot?.trim() || undefined, + dbSessionId: chatOptions.dbSessionId || undefined, + attachments: attachments.value.length > 0 ? attachments.value : undefined, + }; + + sending.value = true; + // Initialize request lifecycle state - request begins once we dispatch /act + requestState.value = 'starting'; + currentRequestId.value = requestId; + // Reset message-level streaming; it will be driven by message.isStreaming deltas + isStreaming.value = false; + errorMessage.value = null; + + // Clear input immediately for better UX + const savedInput = input.value; + input.value = ''; + const savedAttachments = [...attachments.value]; + attachments.value = []; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/chat/${encodeURIComponent(sessionId)}/act`; + + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const result = await response.json().catch(() => ({})); + + // Guard: only update state if we're still on the same session + // This prevents cross-session state pollution when user switches during request + const currentSessionId = options.getSessionId(); + if (currentSessionId !== sessionId) { + // Session changed during request - discard result silently + // The optimistic message will be cleared when messages are reloaded + isStreaming.value = false; + requestState.value = 'idle'; + currentRequestId.value = null; + return; + } + + // Update currentRequestId from response (should match our client-generated one) + // This is used for cancel functionality + if (result.requestId) { + currentRequestId.value = result.requestId; + } else { + // Fallback: use our client-generated requestId + currentRequestId.value = requestId; + } + } catch (error: unknown) { + // Guard: only handle error if still on same session + const currentSessionId = options.getSessionId(); + if (currentSessionId !== sessionId) { + isStreaming.value = false; + requestState.value = 'idle'; + currentRequestId.value = null; + return; + } + + console.error('Failed to send agent act request:', error); + errorMessage.value = + error instanceof Error ? error.message : 'Failed to send request to agent server.'; + // Restore input on error + input.value = savedInput; + attachments.value = savedAttachments; + // Remove optimistic message on error + const msgIndex = messages.value.findIndex((m) => m.id === tempMessageId); + if (msgIndex >= 0) { + messages.value.splice(msgIndex, 1); + } + isStreaming.value = false; + requestState.value = 'idle'; + currentRequestId.value = null; + } finally { + sending.value = false; + } + } + + // Cancel current request + async function cancelCurrentRequest(): Promise { + if (!currentRequestId.value) return; + + const serverPort = options.getServerPort(); + const sessionId = options.getSessionId(); + + if (!serverPort) return; + + cancelling.value = true; + try { + const url = `http://127.0.0.1:${serverPort}/agent/chat/${encodeURIComponent(sessionId)}/cancel/${encodeURIComponent(currentRequestId.value)}`; + + const response = await fetch(url, { method: 'DELETE' }); + const data = await response.json().catch(() => null); + + // Check if cancel was successful + // Backend returns { success: boolean, message?: string } + const isSuccess = response.ok && data?.success !== false; + + if (!isSuccess) { + // Cancel failed - show error but keep request state intact + // so user can try again or wait for natural completion + const errorMsg = data?.message || `Failed to cancel request (HTTP ${response.status})`; + console.error('Cancel request failed:', errorMsg); + errorMessage.value = errorMsg; + return; + } + + // Cancel request sent successfully + // Note: We intentionally do NOT clear currentRequestId/requestState here + // The actual state cleanup will happen when we receive the 'cancelled' status event via SSE + // This ensures UI stays consistent with backend state and avoids race conditions + // Keep cancelling=true so UI shows "Stopping..." until SSE confirms + // cancelling will be reset when handleStatusEvent receives 'cancelled' status + } catch (error) { + console.error('Failed to cancel request:', error); + errorMessage.value = error instanceof Error ? error.message : 'Failed to cancel request'; + // Only reset cancelling on error, not on success + cancelling.value = false; + } + } + + // Clear messages + function clearMessages(): void { + messages.value = []; + } + + // Set messages (for loading history) + function setMessages(newMessages: AgentMessage[]): void { + messages.value = newMessages; + } + + return { + // State + messages, + input, + sending, + isStreaming, + requestState, + errorMessage, + currentRequestId, + cancelling, + attachments, + lastUsage, + + // Computed + canSend, + isRequestActive, + + // Methods + handleRealtimeEvent, + send, + cancelCurrentRequest, + clearMessages, + setMessages, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChatViewRoute.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChatViewRoute.ts new file mode 100644 index 00000000..ba22c679 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentChatViewRoute.ts @@ -0,0 +1,234 @@ +/** + * Composable for managing AgentChat view routing. + * + * Handles navigation between 'sessions' (list) and 'chat' (conversation) views + * without requiring vue-router. Supports URL parameters for deep linking. + * + * URL Parameters: + * - `view`: 'sessions' | 'chat' (default: 'sessions') + * - `sessionId`: Session ID to open directly in chat view + * + * Example URLs: + * - `sidepanel.html?tab=agent-chat` → sessions list + * - `sidepanel.html?tab=agent-chat&view=chat&sessionId=xxx` → direct to chat + */ +import { ref, computed } from 'vue'; + +// ============================================================================= +// Types +// ============================================================================= + +/** Available view modes */ +export type AgentChatView = 'sessions' | 'chat'; + +/** Route state */ +export interface AgentChatRouteState { + view: AgentChatView; + sessionId: string | null; +} + +/** Options for useAgentChatViewRoute */ +export interface UseAgentChatViewRouteOptions { + /** + * Callback when route changes. + * Called after internal state is updated. + */ + onRouteChange?: (state: AgentChatRouteState) => void; +} + +// ============================================================================= +// Constants +// ============================================================================= + +const DEFAULT_VIEW: AgentChatView = 'sessions'; +const URL_PARAM_VIEW = 'view'; +const URL_PARAM_SESSION_ID = 'sessionId'; + +// ============================================================================= +// Helpers +// ============================================================================= + +/** + * Parse view from URL parameter. + * Returns default if invalid. + */ +function parseView(value: string | null): AgentChatView { + if (value === 'sessions' || value === 'chat') { + return value; + } + return DEFAULT_VIEW; +} + +/** + * Update URL parameters without page reload. + * Preserves existing parameters (like `tab`). + */ +function updateUrlParams(view: AgentChatView, sessionId: string | null): void { + try { + const url = new URL(window.location.href); + + // Update view param + if (view === DEFAULT_VIEW) { + url.searchParams.delete(URL_PARAM_VIEW); + } else { + url.searchParams.set(URL_PARAM_VIEW, view); + } + + // Update sessionId param + if (sessionId) { + url.searchParams.set(URL_PARAM_SESSION_ID, sessionId); + } else { + url.searchParams.delete(URL_PARAM_SESSION_ID); + } + + // Update URL without reload + window.history.replaceState({}, '', url.toString()); + } catch { + // Ignore URL update errors (e.g., in non-browser environment) + } +} + +// ============================================================================= +// Composable +// ============================================================================= + +export function useAgentChatViewRoute(options: UseAgentChatViewRouteOptions = {}) { + // ========================================================================== + // State + // ========================================================================== + + const currentView = ref(DEFAULT_VIEW); + const currentSessionId = ref(null); + + // ========================================================================== + // Computed + // ========================================================================== + + /** Whether currently showing sessions list */ + const isSessionsView = computed(() => currentView.value === 'sessions'); + + /** Whether currently showing chat conversation */ + const isChatView = computed(() => currentView.value === 'chat'); + + /** Current route state */ + const routeState = computed(() => ({ + view: currentView.value, + sessionId: currentSessionId.value, + })); + + // ========================================================================== + // Actions + // ========================================================================== + + /** + * Navigate to sessions list view. + * Clears sessionId from URL. + */ + function goToSessions(): void { + currentView.value = 'sessions'; + // Don't clear sessionId internally - it's used to highlight selected session + updateUrlParams('sessions', null); + options.onRouteChange?.(routeState.value); + } + + /** + * Navigate to chat view for a specific session. + * @param sessionId - Session ID to open + */ + function goToChat(sessionId: string): void { + if (!sessionId) { + console.warn('[useAgentChatViewRoute] goToChat called without sessionId'); + return; + } + + currentView.value = 'chat'; + currentSessionId.value = sessionId; + updateUrlParams('chat', sessionId); + options.onRouteChange?.(routeState.value); + } + + /** + * Initialize route from URL parameters. + * Should be called on mount. + * @returns Initial route state + */ + function initFromUrl(): AgentChatRouteState { + try { + const params = new URLSearchParams(window.location.search); + const viewParam = params.get(URL_PARAM_VIEW); + const sessionIdParam = params.get(URL_PARAM_SESSION_ID); + + const view = parseView(viewParam); + const sessionId = sessionIdParam?.trim() || null; + + // If view=chat but no sessionId, fall back to sessions + if (view === 'chat' && !sessionId) { + currentView.value = 'sessions'; + currentSessionId.value = null; + } else { + currentView.value = view; + currentSessionId.value = sessionId; + } + } catch { + // Use defaults on error + currentView.value = DEFAULT_VIEW; + currentSessionId.value = null; + } + + return routeState.value; + } + + /** + * Update session ID without changing view. + * Updates URL based on current view and sessionId: + * - In chat view: always update URL with sessionId + * - In sessions view with null sessionId: clear sessionId from URL (cleanup) + */ + function setSessionId(sessionId: string | null): void { + currentSessionId.value = sessionId; + + if (currentView.value === 'chat') { + // In chat view, always sync URL with current sessionId + updateUrlParams('chat', sessionId); + } else if (sessionId === null) { + // In sessions view, clear any stale sessionId from URL + // This handles edge cases like deleting the last session + updateUrlParams('sessions', null); + } + } + + // ========================================================================== + // Lifecycle + // ========================================================================== + + // Note: We don't call initFromUrl() here because AgentChat.vue needs to + // call it after loading sessions (to verify sessionId exists). + // Caller is responsible for calling initFromUrl() at the right time. + + // ========================================================================== + // Return + // ========================================================================== + + return { + // State + currentView, + currentSessionId, + + // Computed + isSessionsView, + isChatView, + routeState, + + // Actions + goToSessions, + goToChat, + initFromUrl, + setSessionId, + }; +} + +// ============================================================================= +// Type Export +// ============================================================================= + +export type UseAgentChatViewRoute = ReturnType; diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentInputPreferences.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentInputPreferences.ts new file mode 100644 index 00000000..2a8c42aa --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentInputPreferences.ts @@ -0,0 +1,88 @@ +/** + * Composable for user-facing input preferences in AgentChat. + * Preferences are persisted in chrome.storage.local. + */ +import { ref, type Ref } from 'vue'; + +// ============================================================================= +// Constants +// ============================================================================= + +const STORAGE_KEY_FAKE_CARET = 'agent-chat-fake-caret-enabled'; + +// ============================================================================= +// Types +// ============================================================================= + +export interface UseAgentInputPreferences { + /** Whether the fake caret + comet trail is enabled (opt-in). Default: false */ + fakeCaretEnabled: Ref; + /** Whether preferences have been loaded from storage */ + ready: Ref; + /** Load preferences from chrome.storage.local (call on mount) */ + init: () => Promise; + /** Persist and update fake caret preference */ + setFakeCaretEnabled: (enabled: boolean) => Promise; +} + +// ============================================================================= +// Composable +// ============================================================================= + +/** + * Composable for managing user input preferences. + * + * Features: + * - Fake caret toggle (opt-in, default off) + * - Persistence via chrome.storage.local + * - Graceful fallback when storage is unavailable + */ +export function useAgentInputPreferences(): UseAgentInputPreferences { + const fakeCaretEnabled = ref(false); + const ready = ref(false); + + /** + * Load preferences from chrome.storage.local. + * Should be called during component mount. + */ + async function init(): Promise { + try { + if (typeof chrome === 'undefined' || !chrome.storage?.local) { + ready.value = true; + return; + } + + const result = await chrome.storage.local.get(STORAGE_KEY_FAKE_CARET); + const stored = result[STORAGE_KEY_FAKE_CARET]; + + if (typeof stored === 'boolean') { + fakeCaretEnabled.value = stored; + } + } catch (error) { + console.error('[useAgentInputPreferences] Failed to load preferences:', error); + } finally { + ready.value = true; + } + } + + /** + * Update and persist the fake caret preference. + */ + async function setFakeCaretEnabled(enabled: boolean): Promise { + fakeCaretEnabled.value = enabled; + + try { + if (typeof chrome === 'undefined' || !chrome.storage?.local) return; + await chrome.storage.local.set({ [STORAGE_KEY_FAKE_CARET]: enabled }); + } catch (error) { + console.error('[useAgentInputPreferences] Failed to save fake caret preference:', error); + } + } + + return { + fakeCaretEnabled, + ready, + init, + setFakeCaretEnabled, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentProjects.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentProjects.ts new file mode 100644 index 00000000..bd11989a --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentProjects.ts @@ -0,0 +1,573 @@ +/** + * Composable for managing Agent Projects. + * Handles project CRUD, selection, and persistence. + */ +import { ref, computed, watch } from 'vue'; +import type { AgentProject, AgentStoredMessage } from 'chrome-mcp-shared'; + +const STORAGE_KEY_SELECTED_PROJECT = 'agent-selected-project-id'; + +interface PathValidationResult { + valid: boolean; + absolute: string; + exists: boolean; + needsCreation: boolean; + error?: string; +} + +/** + * Normalize path for comparison (handle trailing slashes and separators). + */ +function normalizePathForComparison(path: string): string { + // Remove trailing slashes and normalize separators + return path + .trim() + .replace(/[/\\]+$/, '') + .replace(/\\/g, '/') + .toLowerCase(); +} + +export interface UseAgentProjectsOptions { + getServerPort: () => number | null; + ensureServer: () => Promise; + onHistoryLoaded?: (messages: AgentStoredMessage[]) => void; +} + +export function useAgentProjects(options: UseAgentProjectsOptions) { + // State + const projects = ref([]); + const selectedProjectId = ref(''); + const isLoadingProjects = ref(false); + const showCreateProject = ref(false); + const newProjectName = ref(''); + const newProjectRootPath = ref(''); + const isCreatingProject = ref(false); + const projectError = ref(null); + + // Computed + const selectedProject = computed(() => { + return projects.value.find((p) => p.id === selectedProjectId.value) || null; + }); + + const canCreateProject = computed(() => { + return newProjectName.value.trim().length > 0 && newProjectRootPath.value.trim().length > 0; + }); + + // Load selected project from storage + async function loadSelectedProjectId(): Promise { + try { + const result = await chrome.storage.local.get(STORAGE_KEY_SELECTED_PROJECT); + if (result[STORAGE_KEY_SELECTED_PROJECT]) { + selectedProjectId.value = result[STORAGE_KEY_SELECTED_PROJECT]; + } + } catch (error) { + console.error('Failed to load selected project ID:', error); + } + } + + // Save selected project to storage + async function saveSelectedProjectId(): Promise { + try { + await chrome.storage.local.set({ + [STORAGE_KEY_SELECTED_PROJECT]: selectedProjectId.value, + }); + } catch (error) { + console.error('Failed to save selected project ID:', error); + } + } + + // Fetch projects from server + async function fetchProjects(): Promise { + const serverPort = options.getServerPort(); + if (!serverPort) return; + + isLoadingProjects.value = true; + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects`; + const response = await fetch(url); + if (response.ok) { + const data = await response.json(); + projects.value = data.projects || []; + } + } catch (error) { + console.error('Failed to fetch projects:', error); + } finally { + isLoadingProjects.value = false; + } + } + + // Refresh projects + async function refreshProjects(): Promise { + const ready = await options.ensureServer(); + if (!ready) return; + await fetchProjects(); + } + + // Track pending history load with nonce to prevent A→B→A race conditions + let historyLoadNonce = 0; + + /** + * Load chat history for a project with race-condition protection. + * Uses a nonce to handle A→B→A scenarios. + */ + async function loadChatHistory(projectId: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !projectId) return; + + // Increment nonce - any subsequent load will invalidate this one + const myNonce = ++historyLoadNonce; + + const isStillValid = (): boolean => { + return myNonce === historyLoadNonce && selectedProjectId.value === projectId; + }; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/chat/${encodeURIComponent(projectId)}/messages?limit=100`; + const response = await fetch(url); + + if (!isStillValid()) return; + + if (response.ok) { + const result = await response.json(); + + if (!isStillValid()) return; + + // Server returns { success, data: messages[], totalCount, pagination } + const stored = result.data || []; + options.onHistoryLoaded?.(stored); + } + } catch (error) { + console.error('Failed to load chat history:', error); + } + } + + // Validate path before creating project + async function validatePath(rootPath: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort) return null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects/validate-path`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ rootPath }), + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `Validation failed: HTTP ${response.status}`); + } + + return await response.json(); + } catch (error) { + console.error('Failed to validate path:', error); + return null; + } + } + + // Create project + async function createProject(): Promise { + const name = newProjectName.value.trim(); + const rootPath = newProjectRootPath.value.trim(); + if (!name || !rootPath) return null; + + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort) { + projectError.value = 'Agent server is not available.'; + return null; + } + + isCreatingProject.value = true; + projectError.value = null; + + try { + // Step 1: Validate the path + const validation = await validatePath(rootPath); + if (!validation) { + projectError.value = 'Failed to validate path'; + return null; + } + + if (!validation.valid) { + projectError.value = validation.error || 'Invalid path'; + return null; + } + + // Step 2: If directory doesn't exist, ask user for confirmation + let allowCreate = false; + if (validation.needsCreation) { + const confirmed = confirm( + `目录 "${validation.absolute}" 不存在，是否创建？\n\nThe directory "${validation.absolute}" does not exist. Create it?`, + ); + if (!confirmed) { + return null; + } + allowCreate = true; + } + + // Step 3: Create the project + const url = `http://127.0.0.1:${serverPort}/agent/projects`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ name, rootPath, allowCreate }), + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const payload = await response.json(); + const project = payload?.project as AgentProject | undefined; + + if (project?.id) { + // Update local state + const others = projects.value.filter((p) => p.id !== project.id); + projects.value = [...others, project]; + selectedProjectId.value = project.id; + await saveSelectedProjectId(); + await loadChatHistory(project.id); + + // Clear form + newProjectName.value = ''; + newProjectRootPath.value = ''; + showCreateProject.value = false; + + return project; + } else { + projectError.value = 'Project created but response is invalid.'; + return null; + } + } catch (error: unknown) { + console.error('Failed to create project:', error); + projectError.value = error instanceof Error ? error.message : 'Failed to create project.'; + return null; + } finally { + isCreatingProject.value = false; + } + } + + // Toggle create project form + function toggleCreateProject(): void { + showCreateProject.value = !showCreateProject.value; + if (!showCreateProject.value) { + newProjectName.value = ''; + newProjectRootPath.value = ''; + projectError.value = null; + } + } + + // Get default project root path for a project name + async function getDefaultProjectRoot(projectName: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !projectName.trim()) return null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects/default-root`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ projectName: projectName.trim() }), + }); + if (response.ok) { + const data = await response.json(); + return data.path || null; + } + return null; + } catch (error) { + console.error('Failed to get default project root:', error); + return null; + } + } + + // Open directory picker dialog + async function pickDirectory(): Promise { + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort) { + projectError.value = 'Server not available'; + return null; + } + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects/pick-directory`; + const response = await fetch(url, { method: 'POST' }); + + // Handle HTTP errors (e.g., 404 means server version mismatch) + if (!response.ok) { + if (response.status === 404) { + projectError.value = + 'Directory picker not available. Please rebuild and restart the native server.'; + } else { + projectError.value = `Server error: HTTP ${response.status}`; + } + return null; + } + + const data = await response.json(); + + if (data.success && data.path) { + return data.path; + } else if (data.cancelled) { + return null; // User cancelled, not an error + } else { + projectError.value = data.error || 'Failed to open directory picker'; + return null; + } + } catch (error) { + console.error('Failed to open directory picker:', error); + projectError.value = 'Failed to open directory picker'; + return null; + } + } + + // Ensure default project exists (auto-create if no projects) + async function ensureDefaultProject(): Promise { + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort) return null; + + try { + // First fetch current projects + await fetchProjects(); + + // If there are already projects, no need to create default + if (projects.value.length > 0) { + return null; + } + + // Get default workspace directory from server + const defaultRootUrl = `http://127.0.0.1:${serverPort}/agent/projects/default-root`; + const defaultRootResponse = await fetch(defaultRootUrl, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ projectName: 'default' }), + }); + const defaultRootData = await defaultRootResponse.json(); + const defaultRoot = defaultRootData.path; + + if (!defaultRoot) { + console.error('Failed to get default project root'); + return null; + } + + // Create default project + const createUrl = `http://127.0.0.1:${serverPort}/agent/projects`; + const createResponse = await fetch(createUrl, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + name: 'Default', + rootPath: defaultRoot, + allowCreate: true, + }), + }); + + if (!createResponse.ok) { + const text = await createResponse.text().catch(() => ''); + console.error('Failed to create default project:', text); + return null; + } + + const payload = await createResponse.json(); + const project = payload?.project as AgentProject | undefined; + + if (project?.id) { + projects.value = [project]; + selectedProjectId.value = project.id; + await saveSelectedProjectId(); + return project; + } + + return null; + } catch (error) { + console.error('Failed to ensure default project:', error); + return null; + } + } + + // Create project from a directory path (used when user picks a directory) + async function createProjectFromPath( + rootPath: string, + name: string, + ): Promise { + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort) { + projectError.value = 'Agent server is not available.'; + return null; + } + + projectError.value = null; + + try { + // Validate the path first + const validation = await validatePath(rootPath); + if (!validation) { + projectError.value = 'Failed to validate path'; + return null; + } + + if (!validation.valid) { + projectError.value = validation.error || 'Invalid path'; + return null; + } + + // Check if project with same path already exists + const normalizedPath = normalizePathForComparison(validation.absolute); + const existingProject = projects.value.find( + (p) => normalizePathForComparison(p.rootPath) === normalizedPath, + ); + + if (existingProject) { + // Project already exists - select it instead of creating a new one + const shouldSwitch = confirm( + `目录 "${validation.absolute}" 已存在对应的项目：${existingProject.name}\n\n` + + `是否切换到该项目？\n\n` + + `A project already exists for "${validation.absolute}": ${existingProject.name}\n` + + `Switch to that project?`, + ); + if (shouldSwitch) { + selectedProjectId.value = existingProject.id; + await saveSelectedProjectId(); + await loadChatHistory(existingProject.id); + return existingProject; + } + // User declined to switch, return null to indicate no action taken + return null; + } + + // If directory doesn't exist, ask user for confirmation + let allowCreate = false; + if (validation.needsCreation) { + const confirmed = confirm( + `目录 "${validation.absolute}" 不存在，是否创建？\n\nThe directory "${validation.absolute}" does not exist. Create it?`, + ); + if (!confirmed) { + return null; + } + allowCreate = true; + } + + // Create the project + const url = `http://127.0.0.1:${serverPort}/agent/projects`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ name, rootPath, allowCreate }), + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const payload = await response.json(); + const project = payload?.project as AgentProject | undefined; + + if (project?.id) { + // Update local state + const others = projects.value.filter((p) => p.id !== project.id); + projects.value = [...others, project]; + selectedProjectId.value = project.id; + await saveSelectedProjectId(); + await loadChatHistory(project.id); + + return project; + } else { + projectError.value = 'Project created but response is invalid.'; + return null; + } + } catch (error: unknown) { + console.error('Failed to create project from path:', error); + projectError.value = error instanceof Error ? error.message : 'Failed to create project.'; + return null; + } + } + + // Handle project change + async function handleProjectChanged(): Promise { + await saveSelectedProjectId(); + if (selectedProjectId.value) { + await loadChatHistory(selectedProjectId.value); + } + } + + // Save project preference (CLI, model, useCcr, enableChromeMcp) + async function saveProjectPreference( + cli?: string, + model?: string, + useCcr?: boolean, + enableChromeMcp?: boolean, + ): Promise { + const project = selectedProject.value; + const serverPort = options.getServerPort(); + if (!project || !serverPort) return; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + id: project.id, + name: project.name, + rootPath: project.rootPath, + // Normalize and allow empty string (means "Auto/Default") + preferredCli: cli?.trim() ?? project.preferredCli, + selectedModel: model?.trim() ?? project.selectedModel, + useCcr: useCcr ?? project.useCcr, + enableChromeMcp: enableChromeMcp ?? project.enableChromeMcp, + }), + }); + + // Update local project state if successful + if (response.ok) { + const payload = await response.json(); + const updatedProject = payload?.project as AgentProject | undefined; + if (updatedProject?.id) { + const index = projects.value.findIndex((p) => p.id === updatedProject.id); + if (index !== -1) { + projects.value[index] = updatedProject; + } + } + } + } catch (error) { + console.error('Failed to save project preference:', error); + } + } + + return { + // State + projects, + selectedProjectId, + isLoadingProjects, + showCreateProject, + newProjectName, + newProjectRootPath, + isCreatingProject, + projectError, + + // Computed + selectedProject, + canCreateProject, + + // Methods + loadSelectedProjectId, + saveSelectedProjectId, + fetchProjects, + refreshProjects, + loadChatHistory, + createProject, + toggleCreateProject, + handleProjectChanged, + saveProjectPreference, + getDefaultProjectRoot, + pickDirectory, + ensureDefaultProject, + createProjectFromPath, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentServer.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentServer.ts new file mode 100644 index 00000000..0c2cfca8 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentServer.ts @@ -0,0 +1,276 @@ +/** + * Composable for managing Agent Server connection state. + * Handles native host connection, server status, and SSE stream. + */ +import { ref, computed, onUnmounted } from 'vue'; +import { NativeMessageType } from 'chrome-mcp-shared'; +import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; +import type { AgentEngineInfo, RealtimeEvent } from 'chrome-mcp-shared'; + +interface ServerStatus { + isRunning: boolean; + port?: number; + lastUpdated: number; +} + +export interface UseAgentServerOptions { + /** + * Get the session ID for SSE routing. + * Must be provided by caller (typically DB session ID). + */ + getSessionId?: () => string; + onMessage?: (event: RealtimeEvent) => void; + onError?: (error: string) => void; +} + +export function useAgentServer(options: UseAgentServerOptions = {}) { + // State + const serverPort = ref(null); + const nativeConnected = ref(false); + const serverStatus = ref(null); + const connecting = ref(false); + const engines = ref([]); + const eventSource = ref(null); + + // Reconnection state + let reconnectAttempts = 0; + const MAX_RECONNECT_ATTEMPTS = 5; + const BASE_RECONNECT_DELAY = 1000; + + // Track which sessionId the current SSE connection is subscribed to + let currentStreamSessionId: string | null = null; + + // Computed + const isServerReady = computed(() => { + return nativeConnected.value && serverStatus.value?.isRunning && serverPort.value !== null; + }); + + // Check native host connection using existing message type + async function checkNativeHost(): Promise { + try { + const response = await chrome.runtime.sendMessage({ + type: NativeMessageType.PING_NATIVE, + }); + nativeConnected.value = response?.connected ?? false; + return nativeConnected.value; + } catch (error) { + console.error('Failed to check native host:', error); + nativeConnected.value = false; + return false; + } + } + + /** + * Start native host connection. + * @param forceConnect - If true, use CONNECT_NATIVE (re-enables auto-connect). + * If false, use ENSURE_NATIVE (respects current auto-connect setting). + */ + async function startNativeHost(forceConnect = false): Promise { + try { + const response = await chrome.runtime.sendMessage({ + type: forceConnect ? NativeMessageType.CONNECT_NATIVE : NativeMessageType.ENSURE_NATIVE, + }); + // Handle both response formats: { connected: boolean } and { success: boolean } + nativeConnected.value = + typeof response?.connected === 'boolean' + ? response.connected + : (response?.success ?? false); + return nativeConnected.value; + } catch (error) { + console.error('Failed to start native host:', error); + nativeConnected.value = false; + return false; + } + } + + // Get server status using existing message type + async function getServerStatus(): Promise { + try { + const response = await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.GET_SERVER_STATUS, + }); + if (response?.serverStatus) { + serverStatus.value = response.serverStatus; + if (response.serverStatus.port) { + serverPort.value = response.serverStatus.port; + } + // Also update native connected status from response + if (typeof response.connected === 'boolean') { + nativeConnected.value = response.connected; + } + return response.serverStatus; + } + return null; + } catch (error) { + console.error('Failed to get server status:', error); + return null; + } + } + + interface EnsureNativeServerOptions { + /** If true, use CONNECT_NATIVE to re-enable auto-connect */ + forceConnect?: boolean; + } + + // Ensure native server is ready + async function ensureNativeServer(opts: EnsureNativeServerOptions = {}): Promise { + const { forceConnect = false } = opts; + connecting.value = true; + try { + // Step 1: Check native host connection + let connected = await checkNativeHost(); + if (!connected) { + // Try to start native host + connected = await startNativeHost(forceConnect); + if (!connected) { + console.error('Failed to connect to native host'); + return false; + } + // Wait for connection to stabilize + await new Promise((resolve) => setTimeout(resolve, 500)); + } + + // Step 2: Get server status + const status = await getServerStatus(); + if (!status?.isRunning || !status.port) { + console.error('Server not running or port not available', status); + return false; + } + + // Step 3: Fetch engines + await fetchEngines(); + + return true; + } finally { + connecting.value = false; + } + } + + // Fetch available engines + async function fetchEngines(): Promise { + if (!serverPort.value) return; + try { + const url = `http://127.0.0.1:${serverPort.value}/agent/engines`; + const response = await fetch(url); + if (response.ok) { + const data = await response.json(); + engines.value = data.engines || []; + } + } catch (error) { + console.error('Failed to fetch engines:', error); + } + } + + // Check if SSE is connected + function isEventSourceConnected(): boolean { + return eventSource.value !== null && eventSource.value.readyState === EventSource.OPEN; + } + + // Open SSE connection (skip if already connected to same session) + function openEventSource(): void { + const targetSessionId = options.getSessionId?.()?.trim() ?? ''; + if (!serverPort.value || !targetSessionId) return; + + // Skip if already connected to the same session + if (isEventSourceConnected() && currentStreamSessionId === targetSessionId) { + console.log('[AgentServer] SSE already connected to session, skipping reconnect'); + return; + } + + // Close existing connection before subscribing to a new session + closeEventSource(); + + currentStreamSessionId = targetSessionId; + const url = `http://127.0.0.1:${serverPort.value}/agent/chat/${encodeURIComponent(targetSessionId)}/stream`; + const es = new EventSource(url); + + es.onopen = () => { + console.log('[AgentServer] SSE connection opened'); + reconnectAttempts = 0; + }; + + es.onmessage = (event) => { + try { + const parsed = JSON.parse(event.data) as RealtimeEvent; + options.onMessage?.(parsed); + } catch (err) { + console.error('[AgentServer] Failed to parse SSE message:', err); + } + }; + + es.onerror = (error) => { + console.error('[AgentServer] SSE error:', error); + es.close(); + eventSource.value = null; + + // Attempt reconnection with exponential backoff + if (reconnectAttempts < MAX_RECONNECT_ATTEMPTS) { + const delay = BASE_RECONNECT_DELAY * Math.pow(2, reconnectAttempts); + reconnectAttempts++; + console.log(`[AgentServer] Reconnecting in ${delay}ms (attempt ${reconnectAttempts})`); + setTimeout(() => { + if (isServerReady.value) { + openEventSource(); + } + }, delay); + } else { + options.onError?.('SSE connection failed after multiple attempts'); + } + }; + + eventSource.value = es; + } + + // Close SSE connection + function closeEventSource(): void { + if (eventSource.value) { + eventSource.value.close(); + eventSource.value = null; + } + currentStreamSessionId = null; + } + + // Reconnect to server (explicit user action, re-enables auto-connect) + async function reconnect(): Promise { + closeEventSource(); + reconnectAttempts = 0; + // Explicit user reconnect: force connect to re-enable auto-connect in background + await ensureNativeServer({ forceConnect: true }); + if (isServerReady.value) { + openEventSource(); + } + } + + // Initialize + async function initialize(): Promise { + await ensureNativeServer(); + // Note: SSE connection is now opened explicitly when session is ready + } + + // Cleanup on unmount + onUnmounted(() => { + closeEventSource(); + }); + + return { + // State + serverPort, + nativeConnected, + serverStatus, + connecting, + engines, + eventSource, + + // Computed + isServerReady, + + // Methods + ensureNativeServer, + fetchEngines, + openEventSource, + closeEventSource, + isEventSourceConnected, + reconnect, + initialize, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentSessions.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentSessions.ts new file mode 100644 index 00000000..4a3274f9 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentSessions.ts @@ -0,0 +1,537 @@ +/** + * Composable for managing Agent Sessions. + * Sessions represent independent conversations within a project. + * Each session has its own engine configuration, chat history, and resume state. + */ +import { ref, computed, watch } from 'vue'; +import type { + AgentSession, + AgentCliPreference, + CreateAgentSessionInput, + UpdateAgentSessionInput, + AgentStoredMessage, + AgentManagementInfo, +} from 'chrome-mcp-shared'; + +const STORAGE_KEY_SELECTED_SESSION = 'agent-selected-session-id'; + +export interface UseAgentSessionsOptions { + getServerPort: () => number | null; + ensureServer: () => Promise; + onSessionChanged?: (sessionId: string) => void; + onHistoryLoaded?: (messages: AgentStoredMessage[]) => void; +} + +export function useAgentSessions(options: UseAgentSessionsOptions) { + // State + const sessions = ref([]); + const allSessions = ref([]); // All sessions across all projects + const selectedSessionId = ref(''); + const isLoadingSessions = ref(false); + const isLoadingAllSessions = ref(false); + const isCreatingSession = ref(false); + const sessionError = ref(null); + + // Computed + const selectedSession = computed(() => { + return sessions.value.find((s) => s.id === selectedSessionId.value) || null; + }); + + const hasSessions = computed(() => sessions.value.length > 0); + + // Load selected session from storage + async function loadSelectedSessionId(): Promise { + try { + const result = await chrome.storage.local.get(STORAGE_KEY_SELECTED_SESSION); + if (result[STORAGE_KEY_SELECTED_SESSION]) { + selectedSessionId.value = result[STORAGE_KEY_SELECTED_SESSION]; + } + } catch (error) { + console.error('Failed to load selected session ID:', error); + } + } + + // Save selected session to storage + async function saveSelectedSessionId(): Promise { + try { + await chrome.storage.local.set({ + [STORAGE_KEY_SELECTED_SESSION]: selectedSessionId.value, + }); + } catch (error) { + console.error('Failed to save selected session ID:', error); + } + } + + // Track pending session fetch with nonce to prevent A→B→A race conditions + let fetchSessionsNonce = 0; + + /** + * Fetch sessions for a project with race-condition protection. + * Uses a nonce to handle A→B→A scenarios. + */ + async function fetchSessions(projectId: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !projectId) return; + + // Increment nonce - any subsequent fetch will invalidate this one + const myNonce = ++fetchSessionsNonce; + + const isStillValid = (): boolean => { + return myNonce === fetchSessionsNonce; + }; + + isLoadingSessions.value = true; + sessionError.value = null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects/${encodeURIComponent(projectId)}/sessions`; + const response = await fetch(url); + + if (!isStillValid()) return; + + if (response.ok) { + const data = await response.json(); + + if (!isStillValid()) return; + + sessions.value = data.sessions || []; + + // If we have sessions but no selection, select the most recent one + if (sessions.value.length > 0 && !selectedSessionId.value) { + selectedSessionId.value = sessions.value[0].id; + await saveSelectedSessionId(); + } + } else { + const text = await response.text().catch(() => ''); + sessionError.value = text || `HTTP ${response.status}`; + } + } catch (error) { + console.error('Failed to fetch sessions:', error); + sessionError.value = error instanceof Error ? error.message : 'Failed to fetch sessions'; + } finally { + isLoadingSessions.value = false; + } + } + + // Track pending all sessions fetch with nonce + let fetchAllSessionsNonce = 0; + + /** + * Fetch all sessions across all projects. + * Used for the global sessions list view. + */ + async function fetchAllSessions(): Promise { + const serverPort = options.getServerPort(); + if (!serverPort) return; + + const myNonce = ++fetchAllSessionsNonce; + + const isStillValid = (): boolean => { + return myNonce === fetchAllSessionsNonce; + }; + + isLoadingAllSessions.value = true; + sessionError.value = null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions`; + const response = await fetch(url); + + if (!isStillValid()) return; + + if (response.ok) { + const data = await response.json(); + + if (!isStillValid()) return; + + allSessions.value = data.sessions || []; + } else { + const text = await response.text().catch(() => ''); + sessionError.value = text || `HTTP ${response.status}`; + } + } catch (error) { + console.error('Failed to fetch all sessions:', error); + sessionError.value = error instanceof Error ? error.message : 'Failed to fetch sessions'; + } finally { + isLoadingAllSessions.value = false; + } + } + + // Track pending create session with nonce to prevent cross-project pollution + let createSessionNonce = 0; + + /** + * Create a new session with race-condition protection. + * Uses a nonce to prevent cross-project state pollution when user switches + * projects during session creation. + */ + async function createSession( + projectId: string, + input: CreateAgentSessionInput, + ): Promise { + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort) { + sessionError.value = 'Server not available'; + return null; + } + + // Increment nonce - any subsequent create will invalidate this one + const myNonce = ++createSessionNonce; + + isCreatingSession.value = true; + sessionError.value = null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/projects/${encodeURIComponent(projectId)}/sessions`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(input), + }); + + // Guard: check if this is still the expected create operation + if (myNonce !== createSessionNonce) { + // A newer create was initiated - discard this result + return null; + } + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const data = await response.json(); + + // Re-check after json parsing + if (myNonce !== createSessionNonce) { + return null; + } + + const session = data.session as AgentSession | undefined; + + if (session?.id) { + // Add to local list and select it + sessions.value = [session, ...sessions.value]; + // Also add to allSessions (at front, as it's the newest) + allSessions.value = [session, ...allSessions.value.filter((s) => s.id !== session.id)]; + selectedSessionId.value = session.id; + await saveSelectedSessionId(); + options.onSessionChanged?.(session.id); + return session; + } + + sessionError.value = 'Session created but response is invalid'; + return null; + } catch (error) { + // Guard: only handle error if still valid + if (myNonce !== createSessionNonce) { + return null; + } + console.error('Failed to create session:', error); + sessionError.value = error instanceof Error ? error.message : 'Failed to create session'; + return null; + } finally { + isCreatingSession.value = false; + } + } + + // Get a session by ID + async function getSession(sessionId: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !sessionId) return null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions/${encodeURIComponent(sessionId)}`; + const response = await fetch(url); + if (response.ok) { + const data = await response.json(); + return data.session || null; + } + return null; + } catch (error) { + console.error('Failed to get session:', error); + return null; + } + } + + // Update a session + async function updateSession( + sessionId: string, + updates: UpdateAgentSessionInput, + ): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !sessionId) return null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions/${encodeURIComponent(sessionId)}`; + const response = await fetch(url, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(updates), + }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const data = await response.json(); + const session = data.session as AgentSession | undefined; + + if (session?.id) { + // Update local list + const index = sessions.value.findIndex((s) => s.id === session.id); + if (index !== -1) { + sessions.value[index] = session; + } + // Also update allSessions (in-place to preserve order) + const allIndex = allSessions.value.findIndex((s) => s.id === session.id); + if (allIndex !== -1) { + allSessions.value[allIndex] = session; + } + return session; + } + + return null; + } catch (error) { + console.error('Failed to update session:', error); + sessionError.value = error instanceof Error ? error.message : 'Failed to update session'; + return null; + } + } + + // Delete a session + async function deleteSession(sessionId: string): Promise { + const serverPort = options.getServerPort(); + if (!serverPort || !sessionId) return false; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions/${encodeURIComponent(sessionId)}`; + const response = await fetch(url, { method: 'DELETE' }); + + if (response.ok || response.status === 204) { + // Remove from local list + sessions.value = sessions.value.filter((s) => s.id !== sessionId); + // Also remove from allSessions + allSessions.value = allSessions.value.filter((s) => s.id !== sessionId); + + // If deleted session was selected, select another one + if (selectedSessionId.value === sessionId) { + selectedSessionId.value = sessions.value[0]?.id || ''; + await saveSelectedSessionId(); + if (selectedSessionId.value) { + options.onSessionChanged?.(selectedSessionId.value); + } + } + return true; + } + + return false; + } catch (error) { + console.error('Failed to delete session:', error); + return false; + } + } + + // Select a session + async function selectSession(sessionId: string): Promise { + if (selectedSessionId.value === sessionId) return; + + selectedSessionId.value = sessionId; + await saveSelectedSessionId(); + options.onSessionChanged?.(sessionId); + } + + // Create a default session for a project if none exist + async function ensureDefaultSession( + projectId: string, + engineName: AgentCliPreference = 'claude', + ): Promise { + await fetchSessions(projectId); + + // If sessions exist, select the first one if none selected + if (sessions.value.length > 0) { + if ( + !selectedSessionId.value || + !sessions.value.find((s) => s.id === selectedSessionId.value) + ) { + await selectSession(sessions.value[0].id); + } + return selectedSession.value; + } + + // Create default session + return createSession(projectId, { + engineName, + name: 'Default Session', + }); + } + + // Rename a session + async function renameSession(sessionId: string, name: string): Promise { + const result = await updateSession(sessionId, { name }); + return result !== null; + } + + // Reset a session conversation (delete messages + clear engineSessionId) + async function resetConversation(sessionId: string): Promise<{ + deletedMessages: number; + clearedEngineSessionId: boolean; + session: AgentSession | null; + } | null> { + const ready = await options.ensureServer(); + const serverPort = options.getServerPort(); + if (!ready || !serverPort || !sessionId) { + sessionError.value = 'Server not available'; + return null; + } + + sessionError.value = null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions/${encodeURIComponent(sessionId)}/reset`; + const response = await fetch(url, { method: 'POST' }); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const data = await response.json(); + const session = data.session as AgentSession | null; + + // Update local session state + if (session?.id) { + const index = sessions.value.findIndex((s) => s.id === session.id); + if (index !== -1) { + sessions.value[index] = session; + } + } + + return { + deletedMessages: typeof data.deletedMessages === 'number' ? data.deletedMessages : 0, + clearedEngineSessionId: data.clearedEngineSessionId === true, + session, + }; + } catch (error) { + console.error('Failed to reset conversation:', error); + sessionError.value = error instanceof Error ? error.message : 'Failed to reset conversation'; + return null; + } + } + + // Fetch Claude SDK management info for a session + async function fetchClaudeInfo(sessionId: string): Promise<{ + managementInfo: AgentManagementInfo | null; + sessionId: string; + engineName: string; + } | null> { + const serverPort = options.getServerPort(); + if (!serverPort || !sessionId) return null; + + try { + const url = `http://127.0.0.1:${serverPort}/agent/sessions/${encodeURIComponent(sessionId)}/claude-info`; + const response = await fetch(url); + + if (!response.ok) { + const text = await response.text().catch(() => ''); + throw new Error(text || `HTTP ${response.status}`); + } + + const data = await response.json(); + return { + managementInfo: data.managementInfo ?? null, + sessionId: data.sessionId ?? sessionId, + engineName: data.engineName ?? '', + }; + } catch (error) { + console.error('Failed to fetch Claude info:', error); + return null; + } + } + + // Clear sessions when project changes + function clearSessions(): void { + sessions.value = []; + selectedSessionId.value = ''; + } + + /** + * Update session preview and updatedAt locally (without server call). + * Used when sending a message to update the display immediately. + * Always updates updatedAt so the session moves to the top of the list. + * @param sessionId - The session to update + * @param preview - The preview text (user's raw input) + * @param previewMeta - Optional structured metadata for special rendering (e.g., web editor apply chip) + */ + function updateSessionPreview( + sessionId: string, + preview: string, + previewMeta?: AgentSession['previewMeta'], + ): void { + // Truncate to 50 chars with ellipsis + const maxLen = 50; + const trimmed = preview.trim().replace(/\s+/g, ' '); + const truncated = trimmed.length > maxLen ? trimmed.slice(0, maxLen - 1) + '…' : trimmed; + + // Always update updatedAt to move session to top of list + const now = new Date().toISOString(); + + // Update in current project sessions + const index = sessions.value.findIndex((s) => s.id === sessionId); + if (index !== -1) { + sessions.value[index] = { + ...sessions.value[index], + // Only update preview if not already set + preview: sessions.value[index].preview || truncated, + previewMeta: sessions.value[index].previewMeta || previewMeta, + // Always update timestamp so session moves to top + updatedAt: now, + }; + } + + // Also update in allSessions for global list view + const allIndex = allSessions.value.findIndex((s) => s.id === sessionId); + if (allIndex !== -1) { + allSessions.value[allIndex] = { + ...allSessions.value[allIndex], + preview: allSessions.value[allIndex].preview || truncated, + previewMeta: allSessions.value[allIndex].previewMeta || previewMeta, + updatedAt: now, + }; + } + } + + return { + // State + sessions, + allSessions, + selectedSessionId, + isLoadingSessions, + isLoadingAllSessions, + isCreatingSession, + sessionError, + + // Computed + selectedSession, + hasSessions, + + // Methods + loadSelectedSessionId, + saveSelectedSessionId, + fetchSessions, + fetchAllSessions, + createSession, + getSession, + updateSession, + deleteSession, + selectSession, + ensureDefaultSession, + renameSession, + resetConversation, + fetchClaudeInfo, + clearSessions, + updateSessionPreview, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentTheme.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentTheme.ts new file mode 100644 index 00000000..7cd10234 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentTheme.ts @@ -0,0 +1,171 @@ +/** + * Composable for managing AgentChat theme. + * Handles theme persistence and application. + */ +import { ref, type Ref } from 'vue'; + +/** Available theme identifiers */ +export type AgentThemeId = + | 'warm-editorial' + | 'blueprint-architect' + | 'zen-journal' + | 'neo-pop' + | 'dark-console' + | 'swiss-grid'; + +/** Storage key for persisting theme preference */ +const STORAGE_KEY_THEME = 'agentTheme'; + +/** Default theme when none is set */ +const DEFAULT_THEME: AgentThemeId = 'warm-editorial'; + +/** Valid theme IDs for validation */ +const VALID_THEMES: AgentThemeId[] = [ + 'warm-editorial', + 'blueprint-architect', + 'zen-journal', + 'neo-pop', + 'dark-console', + 'swiss-grid', +]; + +/** Theme display names for UI */ +export const THEME_LABELS: Record = { + 'warm-editorial': 'Editorial', + 'blueprint-architect': 'Blueprint', + 'zen-journal': 'Zen', + 'neo-pop': 'Neo-Pop', + 'dark-console': 'Console', + 'swiss-grid': 'Swiss', +}; + +export interface UseAgentTheme { + /** Current theme ID */ + theme: Ref; + /** Whether theme has been loaded from storage */ + ready: Ref; + /** Set and persist a new theme */ + setTheme: (id: AgentThemeId) => Promise; + /** Load theme from storage (call on mount) */ + initTheme: () => Promise; + /** Apply theme to a DOM element */ + applyTo: (el: HTMLElement) => void; + /** Get the preloaded theme from document (set by main.ts) */ + getPreloadedTheme: () => AgentThemeId; +} + +/** + * Check if a string is a valid theme ID + */ +function isValidTheme(value: unknown): value is AgentThemeId { + return typeof value === 'string' && VALID_THEMES.includes(value as AgentThemeId); +} + +/** + * Get theme from document element (preloaded by main.ts) + */ +function getThemeFromDocument(): AgentThemeId { + const value = document.documentElement.dataset.agentTheme; + return isValidTheme(value) ? value : DEFAULT_THEME; +} + +/** + * Composable for managing AgentChat theme + */ +export function useAgentTheme(): UseAgentTheme { + // Initialize with preloaded theme (or default) + const theme = ref(getThemeFromDocument()); + const ready = ref(false); + + /** + * Load theme from chrome.storage.local + */ + async function initTheme(): Promise { + try { + const result = await chrome.storage.local.get(STORAGE_KEY_THEME); + const stored = result[STORAGE_KEY_THEME]; + + if (isValidTheme(stored)) { + theme.value = stored; + } else { + // Use preloaded or default + theme.value = getThemeFromDocument(); + } + } catch (error) { + console.error('[useAgentTheme] Failed to load theme:', error); + theme.value = getThemeFromDocument(); + } finally { + ready.value = true; + } + } + + /** + * Set and persist a new theme + */ + async function setTheme(id: AgentThemeId): Promise { + if (!isValidTheme(id)) { + console.warn('[useAgentTheme] Invalid theme ID:', id); + return; + } + + // Update immediately for responsive UI + theme.value = id; + + // Also update document element for consistency + document.documentElement.dataset.agentTheme = id; + + // Persist to storage + try { + await chrome.storage.local.set({ [STORAGE_KEY_THEME]: id }); + } catch (error) { + console.error('[useAgentTheme] Failed to save theme:', error); + } + } + + /** + * Apply theme to a DOM element + */ + function applyTo(el: HTMLElement): void { + el.dataset.agentTheme = theme.value; + } + + /** + * Get the preloaded theme from document + */ + function getPreloadedTheme(): AgentThemeId { + return getThemeFromDocument(); + } + + return { + theme, + ready, + setTheme, + initTheme, + applyTo, + getPreloadedTheme, + }; +} + +/** + * Preload theme before Vue mounts (call in main.ts) + * This prevents theme flashing on page load. + */ +export async function preloadAgentTheme(): Promise { + let themeId: AgentThemeId = DEFAULT_THEME; + + try { + const result = await chrome.storage.local.get(STORAGE_KEY_THEME); + const stored = result[STORAGE_KEY_THEME]; + + if (isValidTheme(stored)) { + themeId = stored; + } + } catch (error) { + console.error('[preloadAgentTheme] Failed to load theme:', error); + } + + // Set on document element for immediate application + document.documentElement.dataset.agentTheme = themeId; + + return themeId; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAgentThreads.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentThreads.ts new file mode 100644 index 00000000..1b164690 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAgentThreads.ts @@ -0,0 +1,733 @@ +/** + * Composable for grouping messages into conversation threads. + * Transforms flat AgentMessage[] into structured AgentThread[] for UI rendering. + */ +import { computed, type InjectionKey, type Ref } from 'vue'; +import type { + AgentMessage, + AgentMessageAttachmentMetadata, + AttachmentMetadata, +} from 'chrome-mcp-shared'; +import type { RequestState } from './useAgentChat'; + +/** + * Injection key for agent server port. + * Provided by AgentChat.vue for child components to access attachment URLs. + */ +export const AGENT_SERVER_PORT_KEY: InjectionKey> = Symbol('agentServerPort'); + +/** Thread state */ +export type AgentThreadState = + | 'idle' + | 'starting' + | 'running' + | 'completed' + | 'error' + | 'cancelled'; + +/** Tool kinds for presentation */ +export type ToolKind = 'grep' | 'read' | 'edit' | 'run' | 'plan' | 'generic'; + +/** Tool severity for styling */ +export type ToolSeverity = 'info' | 'success' | 'warning' | 'error'; + +/** Diff statistics for edit operations */ +export interface DiffStats { + addedLines?: number; + deletedLines?: number; + totalLines?: number; +} + +/** Structured tool presentation */ +export interface ToolPresentation { + kind: ToolKind; + label: string; + title: string; + subtitle?: string; + details?: string; + files?: string[]; + /** File path for single-file operations */ + filePath?: string; + /** Diff statistics for edit/write operations */ + diffStats?: DiffStats; + command?: string; + /** Command description from bash tool */ + commandDescription?: string; + query?: string; + /** Search pattern for grep/glob */ + pattern?: string; + /** Search path */ + searchPath?: string; + engine?: string; + severity: ToolSeverity; + phase: 'use' | 'result'; + raw: { content: string; metadata?: Record }; +} + +/** Timeline item types */ +export type TimelineItem = + | { + kind: 'user_prompt'; + id: string; + requestId?: string; + createdAt: string; + messageId: string; + text: string; + attachments: AttachmentMetadata[]; + } + | { + kind: 'assistant_text'; + id: string; + requestId?: string; + createdAt: string; + messageId: string; + text: string; + isStreaming: boolean; + } + | { + kind: 'tool_use'; + id: string; + requestId?: string; + createdAt: string; + messageId: string; + tool: ToolPresentation; + isStreaming: boolean; + } + | { + kind: 'tool_result'; + id: string; + requestId?: string; + createdAt: string; + messageId: string; + tool: ToolPresentation; + isError: boolean; + } + | { + kind: 'status'; + id: string; + requestId?: string; + createdAt: string; + status: string; + text?: string; + }; + +/** Client metadata for web editor apply messages */ +export interface WebEditorApplyMeta { + kind: 'web_editor_apply_batch' | 'web_editor_apply_single'; + pageUrl?: string; + elementCount?: number; + elementLabels?: string[]; +} + +/** Thread header data for special message types */ +export interface ThreadHeader { + /** Display text (compact representation) */ + displayText?: string; + /** Full prompt content for hover display */ + fullContent: string; + /** Web editor apply metadata */ + webEditorApply?: WebEditorApplyMeta; +} + +/** A grouped conversation thread */ +export interface AgentThread { + id: string; + requestId?: string; + title: string; + createdAt: string; + state: AgentThreadState; + items: TimelineItem[]; + /** Attachments from the user prompt (for display in thread header) */ + attachments: AttachmentMetadata[]; + /** Thread header data for special message rendering */ + header?: ThreadHeader; +} + +/** Options for useAgentThreads */ +export interface UseAgentThreadsOptions { + messages: Ref; + /** Request lifecycle state (replaces isStreaming for thread state calculation) */ + requestState: Ref; + currentRequestId: Ref; +} + +/** + * Normalize a string for comparison + */ +function normalize(s: string | undefined): string { + return (s ?? '').toLowerCase().trim(); +} + +/** + * Get first string from multiple candidates + */ +function firstString(...args: unknown[]): string | undefined { + for (const arg of args) { + if (typeof arg === 'string' && arg.trim()) { + return arg.trim(); + } + } + return undefined; +} + +/** + * Extract text after a prefix (e.g., "Running: ") + */ +function extractAfterPrefix(content: string, prefix: string): string | undefined { + const idx = content.indexOf(prefix); + if (idx === -1) return undefined; + return content.slice(idx + prefix.length).trim(); +} + +/** + * Summarize content to one line + */ +function summarizeOneLine(content: string): string { + const line = content.split('\n')[0]?.trim() ?? ''; + return line.length > 60 ? line.slice(0, 57) + '...' : line; +} + +/** + * Title case a string + */ +function titleCase(s: string): string { + return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase(); +} + +/** + * Extract file name from path + */ +function getFileName(filePath: string): string { + return filePath.split('/').pop() || filePath; +} + +/** + * Build diff stats from metadata + */ +function buildDiffStats(meta: Record): DiffStats | undefined { + const addedLines = typeof meta.addedLines === 'number' ? meta.addedLines : undefined; + const deletedLines = typeof meta.deletedLines === 'number' ? meta.deletedLines : undefined; + const totalLines = typeof meta.totalLines === 'number' ? meta.totalLines : undefined; + + if (addedLines !== undefined || deletedLines !== undefined || totalLines !== undefined) { + return { addedLines, deletedLines, totalLines }; + } + return undefined; +} + +/** + * Present a tool message as ToolPresentation + */ +function presentTool(msg: AgentMessage): ToolPresentation { + const meta = (msg.metadata ?? {}) as Record; + const phase = msg.messageType === 'tool_use' ? 'use' : 'result'; + const engine = msg.cliSource; + + const toolName = + firstString(meta.toolName as string, meta.tool_name as string) ?? + (typeof engine === 'string' ? engine : undefined) ?? + 'tool'; + + const isError = + meta.is_error === true || + meta.isError === true || + (typeof msg.content === 'string' && msg.content.trimStart().startsWith('Error:')); + + // Extract common metadata fields + const filePath = firstString(meta.filePath as string); + const command = firstString(meta.command as string); + const commandDescription = firstString(meta.commandDescription as string); + const pattern = firstString(meta.pattern as string); + const searchPath = firstString(meta.searchPath as string); + const diffStats = buildDiffStats(meta); + + // Rule 1: Plan / TodoWrite + if ( + meta.planPhase || + normalize(toolName) === 'plan' || + normalize(toolName) === 'todo_write' || + normalize(toolName) === 'todowrite' + ) { + const todoCount = typeof meta.todoCount === 'number' ? meta.todoCount : undefined; + return { + kind: 'plan', + label: 'Plan', + title: todoCount ? `${todoCount} tasks` : summarizeOneLine(msg.content) || 'Plan update', + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 2: Edit tool with file path and diff stats + if ( + normalize(toolName).includes('edit') || + normalize(toolName) === 'apply_patch' || + normalize(toolName) === 'patch_file' + ) { + const fileName = filePath ? getFileName(filePath) : undefined; + return { + kind: 'edit', + label: 'Edit', + title: fileName || filePath || 'File', + filePath, + diffStats, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'success', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 3: Write/Create tool + if (normalize(toolName).includes('write') || normalize(toolName) === 'create_file') { + const fileName = filePath ? getFileName(filePath) : undefined; + return { + kind: 'edit', + label: 'Write', + title: fileName || filePath || 'File', + filePath, + diffStats, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'success', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 4: File summary (Codex file_change -> metadata.files) + const files = Array.isArray(meta.files) + ? (meta.files as string[]).filter((x) => typeof x === 'string') + : []; + if (files.length > 0) { + const title = files.length === 1 ? getFileName(files[0]) : `${files.length} files`; + return { + kind: 'edit', + label: 'Edit', + title, + subtitle: files.length > 1 ? files.slice(0, 3).map(getFileName).join(', ') : undefined, + files, + filePath: files.length === 1 ? files[0] : undefined, + diffStats, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'success', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 5: Command (Bash/shell) + if ( + normalize(toolName) === 'bash' || + normalize(toolName).includes('shell') || + typeof command === 'string' || + msg.content.startsWith('Running:') || + msg.content.startsWith('Ran:') + ) { + const extractedCommand = + command ?? + extractAfterPrefix(msg.content, 'Running:') ?? + extractAfterPrefix(msg.content, 'Ran:') ?? + undefined; + + const details = + firstString(meta.output as string) ?? (phase === 'result' ? msg.content : undefined); + + return { + kind: 'run', + label: 'Run', + title: commandDescription || extractedCommand?.trim() || 'Command', + subtitle: commandDescription && extractedCommand ? extractedCommand.trim() : undefined, + command: extractedCommand?.trim(), + commandDescription, + details, + engine, + severity: isError ? 'error' : phase === 'result' ? 'success' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 6: Grep/Search with pattern + if (normalize(toolName) === 'grep' || normalize(toolName).includes('search') || pattern) { + const queryFromContent = extractAfterPrefix(msg.content, 'Searching:'); + const displayPattern = pattern || queryFromContent?.trim(); + return { + kind: 'grep', + label: 'Grep', + title: displayPattern || 'Search', + pattern: displayPattern, + searchPath, + query: displayPattern, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 7: Glob with pattern + if (normalize(toolName) === 'glob' || normalize(toolName) === 'glob_files') { + return { + kind: 'grep', + label: 'Glob', + title: pattern || 'Pattern search', + pattern, + searchPath, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 8: Read tool + if (normalize(toolName).includes('read') || filePath) { + const fileName = filePath ? getFileName(filePath) : undefined; + return { + kind: 'read', + label: 'Read', + title: fileName || filePath || 'File', + filePath, + engine, + severity: isError ? 'error' : phase === 'result' ? 'success' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Rule 9: Read / Edit by action (fallback for content-based detection) + const action = firstString(meta.action as string); + const fileFromContent = extractAfterPrefix(msg.content, 'Operating on:')?.trim(); + const inferredKind = + action === 'Read' + ? 'read' + : action === 'Edited' || action === 'Created' || action === 'Deleted' + ? 'edit' + : null; + + if (fileFromContent || inferredKind) { + const kind: ToolKind = inferredKind ?? 'read'; + return { + kind, + label: kind === 'read' ? 'Read' : 'Edit', + title: fileFromContent ? getFileName(fileFromContent) : toolName, + filePath: fileFromContent, + diffStats: kind === 'edit' ? diffStats : undefined, + engine, + severity: isError ? 'error' : phase === 'result' ? 'success' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; + } + + // Fallback: generic tool + return { + kind: 'generic', + label: titleCase(toolName), + title: summarizeOneLine(msg.content) || `Using ${toolName}`, + details: phase === 'result' ? msg.content : undefined, + engine, + severity: isError ? 'error' : 'info', + phase, + raw: { content: msg.content, metadata: meta }, + }; +} + +/** + * Type guard for AttachmentMetadata. + * Validates that an unknown value conforms to the AttachmentMetadata interface. + * Includes semantic validation (non-empty strings, valid numbers). + */ +function isAttachmentMetadata(value: unknown): value is AttachmentMetadata { + if (!value || typeof value !== 'object') return false; + const v = value as Record; + const index = v.index; + const sizeBytes = v.sizeBytes; + return ( + v.version === 1 && + v.kind === 'image' && + typeof v.projectId === 'string' && + (v.projectId as string).trim().length > 0 && + typeof v.messageId === 'string' && + (v.messageId as string).trim().length > 0 && + typeof index === 'number' && + Number.isInteger(index) && + index >= 0 && + typeof v.filename === 'string' && + (v.filename as string).trim().length > 0 && + typeof v.urlPath === 'string' && + (v.urlPath as string).trim().length > 0 && + typeof v.mimeType === 'string' && + (v.mimeType as string).trim().length > 0 && + typeof sizeBytes === 'number' && + Number.isFinite(sizeBytes) && + sizeBytes >= 0 && + typeof v.originalName === 'string' && + (v.originalName as string).trim().length > 0 && + typeof v.createdAt === 'string' && + (v.createdAt as string).trim().length > 0 + ); +} + +/** + * Extract validated attachments from a message's metadata. + * Returns sorted by index for consistent display order. + */ +function getMessageAttachments(msg: AgentMessage): AttachmentMetadata[] { + const meta = (msg.metadata ?? {}) as AgentMessageAttachmentMetadata; + const attachments = meta.attachments; + if (!Array.isArray(attachments)) return []; + return attachments.filter(isAttachmentMetadata).sort((a, b) => a.index - b.index); +} + +/** + * Map a message to a timeline item + */ +function mapMessageToTimelineItem(msg: AgentMessage): TimelineItem | null { + const createdAt = msg.createdAt; + const requestId = msg.requestId?.trim() || undefined; + + // User chat messages are displayed in thread header (title + attachments), + // so we don't create timeline items for them to avoid duplicate display. + if (msg.role === 'user' && msg.messageType === 'chat') { + return null; + } + + if (msg.role === 'assistant' && msg.messageType === 'chat') { + return { + kind: 'assistant_text', + id: msg.id, + requestId, + createdAt, + messageId: msg.id, + text: msg.content, + isStreaming: msg.isStreaming === true && !msg.isFinal, + }; + } + + if (msg.role === 'tool' && msg.messageType === 'tool_use') { + return { + kind: 'tool_use', + id: msg.id, + requestId, + createdAt, + messageId: msg.id, + tool: presentTool(msg), + isStreaming: msg.isStreaming === true && !msg.isFinal, + }; + } + + if (msg.role === 'tool' && msg.messageType === 'tool_result') { + const tool = presentTool(msg); + return { + kind: 'tool_result', + id: msg.id, + requestId, + createdAt, + messageId: msg.id, + tool, + isError: tool.severity === 'error', + }; + } + + // Status messages + if (msg.messageType === 'status' || msg.role === 'system') { + return { + kind: 'status', + id: `status:${requestId ?? 'legacy'}:${msg.id}`, + requestId, + createdAt, + status: 'ready', + text: msg.content, + }; + } + + return null; +} + +/** + * Build threads from messages + */ +function buildThreads( + messages: AgentMessage[], + requestState: RequestState, + currentRequestId: string | null, +): AgentThread[] { + // Sort messages by createdAt + const sortedMessages = [...messages].sort((a, b) => a.createdAt.localeCompare(b.createdAt)); + + // Group messages by requestId or legacy grouping + let legacyCounter = 0; + let currentLegacyKey: string | null = null; + + const groups = new Map< + string, + { + key: string; + requestId?: string; + firstAt: string; + title?: string; + items: TimelineItem[]; + attachments: AttachmentMetadata[]; + /** Thread header for special message types */ + header?: ThreadHeader; + } + >(); + + function ensureGroup(key: string, requestId: string | undefined, createdAt: string) { + if (!groups.has(key)) { + groups.set(key, { key, requestId, firstAt: createdAt, items: [], attachments: [] }); + } + return groups.get(key)!; + } + + for (const msg of sortedMessages) { + const rid = msg.requestId?.trim() || undefined; + + // Determine group key + let key: string; + if (rid) { + key = `rid:${rid}`; + } else { + if (msg.role === 'user') { + currentLegacyKey = `legacy:${legacyCounter++}`; + } + key = currentLegacyKey ?? 'legacy:orphan'; + } + + const group = ensureGroup(key, rid, msg.createdAt); + + // Title, attachments, and header: first user chat message in group wins + if (!group.title && msg.role === 'user' && msg.messageType === 'chat') { + const fullContent = msg.content.trim(); + const attachments = getMessageAttachments(msg); + const meta = (msg.metadata ?? {}) as Record; + + // Extract client metadata for special message types (with runtime validation) + const rawClientMeta = meta.clientMeta; + const rawDisplayText = meta.displayText; + + // Validate clientMeta structure + const clientMeta: WebEditorApplyMeta | undefined = + rawClientMeta && + typeof rawClientMeta === 'object' && + 'kind' in rawClientMeta && + typeof (rawClientMeta as Record).kind === 'string' && + ((rawClientMeta as Record).kind === 'web_editor_apply_batch' || + (rawClientMeta as Record).kind === 'web_editor_apply_single') + ? (rawClientMeta as WebEditorApplyMeta) + : undefined; + + const displayText = typeof rawDisplayText === 'string' ? rawDisplayText : undefined; + + // Store attachments for thread header display + if (attachments.length > 0) { + group.attachments = attachments; + } + + // Build thread header for special message types + if (clientMeta?.kind?.startsWith('web_editor_apply')) { + group.header = { + displayText: displayText || `Apply ${clientMeta.elementCount ?? 0} changes`, + fullContent, + webEditorApply: clientMeta, + }; + // Use display text as title for web editor apply messages + group.title = displayText || `Apply ${clientMeta.elementCount ?? 0} changes`; + } else if (fullContent) { + group.title = fullContent; + } else { + // Image-only message - use attachment count as title + group.title = + attachments.length > 0 + ? `Sent ${attachments.length} image${attachments.length === 1 ? '' : 's'}` + : 'Untitled request'; + } + + group.firstAt = msg.createdAt; + } + + // Map message to timeline item + const item = mapMessageToTimelineItem(msg); + if (item) group.items.push(item); + + // Update earliest timestamp + if (msg.createdAt < group.firstAt) group.firstAt = msg.createdAt; + } + + // Convert groups to threads + const threads: AgentThread[] = []; + + for (const g of groups.values()) { + const requestId = g.requestId; + + // Determine thread state based on requestState (not isStreaming) + // This ensures the thread shows as running even during tool execution + const isActiveRequest = + requestState === 'starting' || requestState === 'ready' || requestState === 'running'; + + let state: AgentThreadState = 'completed'; + if (isActiveRequest && currentRequestId && requestId === currentRequestId) { + // Map requestState to thread state + state = requestState === 'running' ? 'running' : 'starting'; + } else if (g.items.some((item) => item.kind === 'status')) { + state = 'idle'; + } + + // Sort items by createdAt + const items = [...g.items].sort((a, b) => a.createdAt.localeCompare(b.createdAt)); + + // Add status item for active requests + // Use stable ID without Date.now() to prevent component remount on each render + if (state === 'running' || state === 'starting') { + const statusText = state === 'running' ? 'Working...' : 'Starting...'; + items.push({ + kind: 'status', + id: `status:streaming:${requestId ?? 'current'}`, + requestId, + createdAt: new Date().toISOString(), + status: state, + text: statusText, + }); + } + + threads.push({ + id: g.key, + requestId, + title: g.title ?? 'Untitled request', + createdAt: g.firstAt, + state, + items, + attachments: g.attachments, + header: g.header, + }); + } + + // Sort threads by createdAt + return threads.sort((a, b) => a.createdAt.localeCompare(b.createdAt)); +} + +/** + * Composable for managing agent threads + */ +export function useAgentThreads(options: UseAgentThreadsOptions) { + const threads = computed(() => { + return buildThreads( + options.messages.value, + options.requestState.value, + options.currentRequestId.value, + ); + }); + + return { + threads, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useAttachments.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useAttachments.ts new file mode 100644 index 00000000..b6e1cea2 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useAttachments.ts @@ -0,0 +1,257 @@ +/** + * Composable for managing file attachments. + * Handles file selection, drag-drop, paste, conversion, preview, and removal. + */ +import { ref, computed } from 'vue'; +import type { AgentAttachment } from 'chrome-mcp-shared'; + +const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB +const MAX_ATTACHMENTS = 10; // Maximum number of attachments + +// Allowed image MIME types (exclude SVG for security) +const ALLOWED_IMAGE_TYPES = new Set([ + 'image/png', + 'image/jpeg', + 'image/jpg', + 'image/gif', + 'image/webp', +]); + +/** + * Extended attachment type with preview URL support. + */ +export interface AttachmentWithPreview extends AgentAttachment { + /** Data URL for image preview (data:xxx;base64,...) */ + previewUrl?: string; +} + +export function useAttachments() { + const attachments = ref([]); + const fileInputRef = ref(null); + const error = ref(null); + const isDragOver = ref(false); + + // Computed: check if we have any image attachments + const hasImages = computed(() => attachments.value.some((a) => a.type === 'image')); + + // Computed: check if we can add more attachments + const canAddMore = computed(() => attachments.value.length < MAX_ATTACHMENTS); + + /** + * Open file picker for image selection. + */ + function openFilePicker(): void { + fileInputRef.value?.click(); + } + + /** + * Convert file to base64 string. + */ + function fileToBase64(file: File): Promise { + return new Promise((resolve, reject) => { + const reader = new FileReader(); + reader.onload = () => { + const result = reader.result as string; + // Remove data:xxx;base64, prefix + const base64 = result.split(',')[1]; + resolve(base64); + }; + reader.onerror = () => reject(reader.error); + reader.readAsDataURL(file); + }); + } + + /** + * Generate preview URL for image attachments. + */ + function getPreviewUrl(attachment: AttachmentWithPreview): string { + if (attachment.previewUrl) { + return attachment.previewUrl; + } + // Generate data URL from base64 + return `data:${attachment.mimeType};base64,${attachment.dataBase64}`; + } + + /** + * Process files and add them as attachments. + * This is the core method used by file input, drag-drop, and paste handlers. + */ + async function handleFiles(files: File[]): Promise { + error.value = null; + + // Filter to only allowed image types (exclude SVG for security) + const imageFiles = files.filter((file) => ALLOWED_IMAGE_TYPES.has(file.type)); + if (imageFiles.length === 0) { + error.value = 'Only PNG, JPEG, GIF, and WebP images are supported.'; + return; + } + + // Check attachment limit + const remaining = MAX_ATTACHMENTS - attachments.value.length; + if (remaining <= 0) { + error.value = `Maximum ${MAX_ATTACHMENTS} attachments allowed.`; + return; + } + + const filesToProcess = imageFiles.slice(0, remaining); + if (filesToProcess.length < imageFiles.length) { + error.value = `Only ${remaining} more attachment(s) allowed. Some files were skipped.`; + } + + for (const file of filesToProcess) { + // Validate file size + if (file.size > MAX_FILE_SIZE) { + error.value = `File "${file.name}" is too large. Maximum size is 10MB.`; + continue; + } + + try { + const base64 = await fileToBase64(file); + const previewUrl = `data:${file.type};base64,${base64}`; + + attachments.value.push({ + type: 'image', + name: file.name, + mimeType: file.type || 'image/png', + dataBase64: base64, + previewUrl, + }); + } catch (err) { + console.error('Failed to read file:', err); + error.value = `Failed to read file "${file.name}".`; + } + } + } + + /** + * Handle file selection from input element. + */ + async function handleFileSelect(event: Event): Promise { + const input = event.target as HTMLInputElement; + const files = input.files; + if (!files || files.length === 0) return; + + await handleFiles(Array.from(files)); + + // Clear input to allow selecting the same file again + input.value = ''; + } + + /** + * Handle drag over event - update visual state. + */ + function handleDragOver(event: DragEvent): void { + event.preventDefault(); + event.stopPropagation(); + isDragOver.value = true; + } + + /** + * Handle drag leave event - reset visual state. + */ + function handleDragLeave(event: DragEvent): void { + event.preventDefault(); + event.stopPropagation(); + isDragOver.value = false; + } + + /** + * Handle drop event - process dropped files. + */ + async function handleDrop(event: DragEvent): Promise { + event.preventDefault(); + event.stopPropagation(); + isDragOver.value = false; + + const files = event.dataTransfer?.files; + if (!files || files.length === 0) return; + + await handleFiles(Array.from(files)); + } + + /** + * Handle paste event - extract and process pasted images. + */ + async function handlePaste(event: ClipboardEvent): Promise { + const items = event.clipboardData?.items; + if (!items) return; + + const imageFiles: File[] = []; + for (const item of items) { + // Only allow specific image types (exclude SVG for security) + if (ALLOWED_IMAGE_TYPES.has(item.type)) { + const file = item.getAsFile(); + if (file) { + // Generate a name for pasted images (they don't have one) + const ext = item.type.split('/')[1] || 'png'; + const namedFile = new File([file], `pasted-image-${Date.now()}.${ext}`, { + type: file.type, + }); + imageFiles.push(namedFile); + } + } + } + + if (imageFiles.length > 0) { + // Prevent default paste behavior for images + event.preventDefault(); + await handleFiles(imageFiles); + } + // Let text paste through normally + } + + /** + * Remove attachment by index. + */ + function removeAttachment(index: number): void { + attachments.value.splice(index, 1); + error.value = null; + } + + /** + * Clear all attachments. + */ + function clearAttachments(): void { + attachments.value = []; + error.value = null; + } + + /** + * Get attachments for sending (strips preview URLs). + */ + function getAttachments(): AgentAttachment[] | undefined { + if (attachments.value.length === 0) return undefined; + + return attachments.value.map(({ type, name, mimeType, dataBase64 }) => ({ + type, + name, + mimeType, + dataBase64, + })); + } + + return { + // State + attachments, + fileInputRef, + error, + isDragOver, + + // Computed + hasImages, + canAddMore, + + // Methods + openFilePicker, + handleFileSelect, + handleFiles, + handleDragOver, + handleDragLeave, + handleDrop, + handlePaste, + removeAttachment, + clearAttachments, + getAttachments, + getPreviewUrl, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useFakeCaret.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useFakeCaret.ts new file mode 100644 index 00000000..3f26ada1 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useFakeCaret.ts @@ -0,0 +1,614 @@ +/** + * Composable for rendering a "fake" caret overlay on top of a textarea. + * + * Implementation notes: + * - We do NOT intercept input; we only compute caret coordinates. + * - A hidden "mirror" element is used to measure caret position reliably with wrapping. + * - The actual textarea input/IME/selection behavior is preserved. + * - When calculation is unreliable (IME/selection/error), we fall back to native caret. + */ +import { + computed, + onUnmounted, + ref, + watch, + type CSSProperties, + type ComputedRef, + type Ref, +} from 'vue'; + +// ============================================================================= +// Types +// ============================================================================= + +export interface FakeCaretTrailPoint { + x: number; + y: number; + alpha: number; +} + +export interface UseFakeCaretOptions { + /** Reference to the textarea element */ + textareaRef: Ref; + /** + * Feature flag for enabling the fake caret. + * When false, the composable will report showFakeCaret=false + * and the caller should display the native caret. + */ + enabled?: Ref; +} + +export interface UseFakeCaretReturn { + /** Style for the overlay container (position: absolute, inset: 0) */ + overlayStyle: ComputedRef; + /** Whether to show the fake caret (false when degraded) */ + showFakeCaret: ComputedRef; + /** Current X position of caret (animated) */ + caretX: Ref; + /** Current Y position of caret (animated) */ + caretY: Ref; + /** Trail points for comet tail effect */ + trail: Ref; + /** Manually trigger position update */ + updatePosition: () => void; +} + +// ============================================================================= +// Constants +// ============================================================================= + +const MAX_TRAIL_POINTS = 24; +const TRAIL_DECAY = 0.86; +const TRAIL_MIN_ALPHA = 0.06; +const TRAIL_MIN_DISTANCE_PX = 0.35; +const SMOOTHING = 0.35; +const SNAP_DISTANCE_PX = 0.2; + +// ============================================================================= +// Helpers +// ============================================================================= + +function isFiniteNumber(v: unknown): v is number { + return typeof v === 'number' && Number.isFinite(v); +} + +function clamp(v: number, min: number, max: number): number { + return Math.min(max, Math.max(min, v)); +} + +// ============================================================================= +// Main Composable +// ============================================================================= + +export function useFakeCaret(options: UseFakeCaretOptions): UseFakeCaretReturn { + // Default to disabled (opt-in) for safer rollout + const enabled = options.enabled ?? ref(false); + + // Position state (animated values) + const caretX = ref(0); + const caretY = ref(0); + const trail = ref([]); + + // Internal state + const isFocused = ref(false); + const isComposing = ref(false); + const hasSelection = ref(false); + const hasValidMeasurement = ref(false); + const prefersReducedMotion = ref(false); + + // Target position (raw measurement) + let targetX = 0; + let targetY = 0; + + // Animation state + let scheduled = false; + let rafId: number | null = null; + + // Mirror element for measurement + let mirrorEl: HTMLDivElement | null = null; + let lastMirrorKey = ''; + + // Resize observer + let resizeObserver: ResizeObserver | null = null; + + // Trail tracking + let lastTrailX = 0; + let lastTrailY = 0; + + // Disposed flag to prevent operations after unmount + let disposed = false; + + // --------------------------------------------------------------------------- + // Computed Properties + // --------------------------------------------------------------------------- + + const overlayStyle = computed(() => ({ + position: 'absolute', + inset: 0, + pointerEvents: 'none', + overflow: 'hidden', + })); + + const showFakeCaret = computed(() => { + if (!enabled.value) return false; + const el = options.textareaRef.value; + if (!el) return false; + if (!isFocused.value) return false; + if (isComposing.value) return false; + if (hasSelection.value) return false; + return hasValidMeasurement.value; + }); + + // --------------------------------------------------------------------------- + // Mirror Element Management + // --------------------------------------------------------------------------- + + function ensureMirror(): HTMLDivElement | null { + if (disposed) return null; + if (mirrorEl) return mirrorEl; + if (typeof document === 'undefined' || !document.body) return null; + + const el = document.createElement('div'); + el.setAttribute('data-ac-fake-caret-mirror', 'true'); + el.style.position = 'fixed'; + el.style.top = '0'; + el.style.left = '-10000px'; + el.style.visibility = 'hidden'; + el.style.pointerEvents = 'none'; + el.style.whiteSpace = 'pre-wrap'; + el.style.wordBreak = 'break-word'; + el.style.overflowWrap = 'break-word'; + el.style.overflow = 'auto'; + el.style.contain = 'layout style paint'; + el.style.border = '0'; + el.style.background = 'transparent'; + + document.body.appendChild(el); + mirrorEl = el; + return mirrorEl; + } + + function syncMirrorStyle(textarea: HTMLTextAreaElement, mirror: HTMLDivElement): void { + const cs = window.getComputedStyle(textarea); + + // clientWidth includes padding but excludes scrollbar + const width = `${textarea.clientWidth}px`; + const height = `${textarea.clientHeight}px`; + const tabSize = cs.getPropertyValue('tab-size'); + + // Build cache key to avoid unnecessary style updates + const key = [ + width, + height, + cs.font, + cs.padding, + cs.letterSpacing, + cs.lineHeight, + cs.textTransform, + cs.textIndent, + cs.textAlign, + cs.direction, + tabSize, + ].join('|'); + + if (key === lastMirrorKey) return; + lastMirrorKey = key; + + mirror.style.boxSizing = 'border-box'; + mirror.style.width = width; + mirror.style.height = height; + mirror.style.padding = cs.padding; + mirror.style.font = cs.font; + mirror.style.letterSpacing = cs.letterSpacing; + mirror.style.lineHeight = cs.lineHeight; + mirror.style.textTransform = cs.textTransform; + mirror.style.textIndent = cs.textIndent; + mirror.style.textAlign = cs.textAlign; + mirror.style.direction = cs.direction; + + if (tabSize) { + mirror.style.setProperty('tab-size', tabSize); + } + } + + // --------------------------------------------------------------------------- + // Caret Position Measurement + // --------------------------------------------------------------------------- + + function measureCaret(textarea: HTMLTextAreaElement): { x: number; y: number } | null { + const start = textarea.selectionStart; + const end = textarea.selectionEnd; + + if (!isFiniteNumber(start) || !isFiniteNumber(end)) { + hasSelection.value = false; + return null; + } + + hasSelection.value = start !== end; + if (hasSelection.value) return null; + if (isComposing.value) return null; + if (textarea.clientWidth <= 0 || textarea.clientHeight <= 0) return null; + + const mirror = ensureMirror(); + if (!mirror) return null; + + syncMirrorStyle(textarea, mirror); + + // Keep mirror scroll in sync + mirror.scrollTop = textarea.scrollTop; + mirror.scrollLeft = textarea.scrollLeft; + + // Build mirror DOM: [beforeText][marker] + mirror.innerHTML = ''; + const beforeText = textarea.value.slice(0, start); + mirror.appendChild(document.createTextNode(beforeText)); + + const marker = document.createElement('span'); + marker.textContent = '\u200b'; // Zero-width space + marker.style.display = 'inline-block'; + marker.style.width = '1px'; + marker.style.height = '1em'; + mirror.appendChild(marker); + + const markerRect = marker.getBoundingClientRect(); + const mirrorRect = mirror.getBoundingClientRect(); + + const x = markerRect.left - mirrorRect.left; + const y = markerRect.top - mirrorRect.top; + + if (!isFiniteNumber(x) || !isFiniteNumber(y)) return null; + + // Clamp to textarea viewport + const clampedX = clamp(x, 0, textarea.clientWidth + 2); + const clampedY = clamp(y, 0, textarea.clientHeight + 2); + + // If wildly off, treat as invalid + if (Math.abs(clampedX - x) > 20 || Math.abs(clampedY - y) > 20) { + return null; + } + + return { x: clampedX, y: clampedY }; + } + + // --------------------------------------------------------------------------- + // Position Updates + // --------------------------------------------------------------------------- + + function applyTarget(x: number, y: number): void { + const positionChanged = targetX !== x || targetY !== y; + targetX = x; + targetY = y; + + // Skip animation if reduced motion preferred + if (prefersReducedMotion.value) { + caretX.value = x; + caretY.value = y; + trail.value = []; + lastTrailX = x; + lastTrailY = y; + return; + } + + // Restart RAF if position changed (may have been stopped when idle) + if (positionChanged && showFakeCaret.value) { + startLoop(); + } + } + + function updateNow(): void { + const textarea = options.textareaRef.value; + if (!textarea) { + hasValidMeasurement.value = false; + return; + } + + // Only measure when we intend to show the fake caret + if (!enabled.value || !isFocused.value || isComposing.value) { + hasValidMeasurement.value = false; + return; + } + + const pos = measureCaret(textarea); + if (!pos) { + hasValidMeasurement.value = false; + return; + } + + hasValidMeasurement.value = true; + applyTarget(pos.x, pos.y); + } + + function scheduleUpdate(): void { + if (disposed) return; + if (scheduled) return; + scheduled = true; + requestAnimationFrame(() => { + scheduled = false; + if (!disposed) { + updateNow(); + } + }); + } + + function updatePosition(): void { + scheduleUpdate(); + } + + // --------------------------------------------------------------------------- + // Animation Loop + // --------------------------------------------------------------------------- + + function tick(): void { + if (!showFakeCaret.value) return; + if (prefersReducedMotion.value) return; + + // Smooth caret position + const dx = targetX - caretX.value; + const dy = targetY - caretY.value; + + // Check if caret has snapped to target + const isSnapped = Math.abs(dx) < SNAP_DISTANCE_PX && Math.abs(dy) < SNAP_DISTANCE_PX; + + if (isSnapped) { + caretX.value = targetX; + caretY.value = targetY; + } else { + caretX.value = caretX.value + dx * SMOOTHING; + caretY.value = caretY.value + dy * SMOOTHING; + } + + // Update trail (comet tail effect) + const currentTrail = trail.value; + const nextTrail: FakeCaretTrailPoint[] = []; + + // Fade existing points + for (const p of currentTrail) { + const alpha = p.alpha * TRAIL_DECAY; + if (alpha >= TRAIL_MIN_ALPHA) { + nextTrail.push({ ...p, alpha }); + } + } + + // Add new point if moved enough + const moved = + Math.abs(caretX.value - lastTrailX) + Math.abs(caretY.value - lastTrailY) > + TRAIL_MIN_DISTANCE_PX; + + if (moved) { + nextTrail.push({ x: caretX.value, y: caretY.value, alpha: 1 }); + lastTrailX = caretX.value; + lastTrailY = caretY.value; + } + + // Only update trail ref if content changed (avoid triggering watchers) + // Note: must compare alpha too, otherwise fade animation won't work + const trailChanged = + nextTrail.length !== currentTrail.length || + nextTrail.some( + (p, i) => + p.x !== currentTrail[i]?.x || + p.y !== currentTrail[i]?.y || + Math.abs(p.alpha - (currentTrail[i]?.alpha ?? 0)) > 0.001, + ); + + if (trailChanged) { + // Keep only the last N points + if (nextTrail.length > MAX_TRAIL_POINTS) { + trail.value = nextTrail.slice(nextTrail.length - MAX_TRAIL_POINTS); + } else { + trail.value = nextTrail; + } + } + + // Stop RAF when idle: snapped to target and trail has fully faded + if (isSnapped && nextTrail.length === 0) { + stopLoop(); + } + } + + function startLoop(): void { + if (disposed) return; + if (rafId !== null) return; + const loop = () => { + if (disposed) { + rafId = null; + return; + } + rafId = requestAnimationFrame(loop); + tick(); + }; + rafId = requestAnimationFrame(loop); + } + + function stopLoop(): void { + if (rafId !== null) { + cancelAnimationFrame(rafId); + rafId = null; + } + } + + // --------------------------------------------------------------------------- + // Reduced Motion Preference + // --------------------------------------------------------------------------- + + let media: MediaQueryList | null = null; + let onMediaChange: ((e: MediaQueryListEvent) => void) | null = null; + + if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') { + media = window.matchMedia('(prefers-reduced-motion: reduce)'); + prefersReducedMotion.value = media.matches; + onMediaChange = (e: MediaQueryListEvent) => { + prefersReducedMotion.value = e.matches; + trail.value = []; + scheduleUpdate(); + }; + try { + media.addEventListener('change', onMediaChange); + } catch { + // Safari < 14 fallback + media.addListener(onMediaChange as EventListener); + } + } + + // --------------------------------------------------------------------------- + // Textarea Event Binding + // --------------------------------------------------------------------------- + + watch( + () => options.textareaRef.value, + (el, _prev, onCleanup) => { + if (!el) return; + + const handleFocus = () => { + isFocused.value = true; + scheduleUpdate(); + }; + const handleBlur = () => { + isFocused.value = false; + hasValidMeasurement.value = false; + stopLoop(); + trail.value = []; + }; + const handleInput = () => scheduleUpdate(); + const handleKey = () => scheduleUpdate(); + const handleMouse = () => scheduleUpdate(); + const handleScroll = () => scheduleUpdate(); + const handleSelect = () => scheduleUpdate(); + const handleCompositionStart = () => { + isComposing.value = true; + scheduleUpdate(); + }; + const handleCompositionEnd = () => { + isComposing.value = false; + scheduleUpdate(); + }; + + el.addEventListener('focus', handleFocus); + el.addEventListener('blur', handleBlur); + el.addEventListener('input', handleInput); + el.addEventListener('keydown', handleKey); + el.addEventListener('keyup', handleKey); + el.addEventListener('click', handleMouse); + el.addEventListener('mouseup', handleMouse); + el.addEventListener('scroll', handleScroll, { passive: true }); + el.addEventListener('select', handleSelect); + el.addEventListener('compositionstart', handleCompositionStart); + el.addEventListener('compositionend', handleCompositionEnd); + + // Initialize focus state + isFocused.value = typeof document !== 'undefined' && document.activeElement === el; + + // Observe size changes + if (typeof ResizeObserver !== 'undefined') { + resizeObserver?.disconnect(); + resizeObserver = new ResizeObserver(() => scheduleUpdate()); + resizeObserver.observe(el); + } + + // Initial measurement + scheduleUpdate(); + + onCleanup(() => { + el.removeEventListener('focus', handleFocus); + el.removeEventListener('blur', handleBlur); + el.removeEventListener('input', handleInput); + el.removeEventListener('keydown', handleKey); + el.removeEventListener('keyup', handleKey); + el.removeEventListener('click', handleMouse); + el.removeEventListener('mouseup', handleMouse); + el.removeEventListener('scroll', handleScroll); + el.removeEventListener('select', handleSelect); + el.removeEventListener('compositionstart', handleCompositionStart); + el.removeEventListener('compositionend', handleCompositionEnd); + resizeObserver?.disconnect(); + resizeObserver = null; + }); + }, + { immediate: true }, + ); + + // --------------------------------------------------------------------------- + // Watchers for State Changes + // --------------------------------------------------------------------------- + + watch( + prefersReducedMotion, + (reduced) => { + if (reduced) { + stopLoop(); + trail.value = []; + scheduleUpdate(); + return; + } + if (showFakeCaret.value) { + startLoop(); + } + }, + { immediate: true }, + ); + + watch( + showFakeCaret, + (show) => { + if (!show) { + stopLoop(); + trail.value = []; + return; + } + + // Start animation when showing + scheduleUpdate(); + if (!prefersReducedMotion.value) { + startLoop(); + } + }, + { immediate: true }, + ); + + watch( + enabled, + (v) => { + if (!v) { + stopLoop(); + trail.value = []; + hasValidMeasurement.value = false; + } else { + scheduleUpdate(); + } + }, + { immediate: true }, + ); + + // --------------------------------------------------------------------------- + // Cleanup + // --------------------------------------------------------------------------- + + onUnmounted(() => { + disposed = true; + stopLoop(); + resizeObserver?.disconnect(); + resizeObserver = null; + + if (mirrorEl && mirrorEl.parentNode) { + mirrorEl.parentNode.removeChild(mirrorEl); + } + mirrorEl = null; + + if (media && onMediaChange) { + try { + media.removeEventListener('change', onMediaChange); + } catch { + media.removeListener(onMediaChange as EventListener); + } + } + }); + + return { + overlayStyle, + showFakeCaret, + caretX, + caretY, + trail, + updatePosition, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useFloatingDrag.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useFloatingDrag.ts new file mode 100644 index 00000000..e1a76bd3 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useFloatingDrag.ts @@ -0,0 +1,178 @@ +/** + * Vue composable for floating drag functionality. + * Wraps the installFloatingDrag utility for use in Vue components. + */ + +import { ref, onMounted, onUnmounted, type Ref } from 'vue'; +import { + installFloatingDrag, + type FloatingPosition, +} from '@/entrypoints/web-editor-v2/ui/floating-drag'; + +const STORAGE_KEY = 'sidepanel_navigator_position'; + +export interface UseFloatingDragOptions { + /** Storage key for position persistence */ + storageKey?: string; + /** Margin from viewport edges in pixels */ + clampMargin?: number; + /** Threshold for distinguishing click vs drag (ms) */ + clickThresholdMs?: number; + /** Movement threshold for drag activation (px) */ + moveThresholdPx?: number; + /** Default position calculator (called when no saved position exists) */ + getDefaultPosition?: () => FloatingPosition; +} + +export interface UseFloatingDragReturn { + /** Current position (reactive) */ + position: Ref; + /** Whether dragging is in progress */ + isDragging: Ref; + /** Reset position to default */ + resetToDefault: () => void; + /** Computed style object for binding */ + positionStyle: Ref<{ left: string; top: string }>; +} + +/** + * Calculate default position (bottom-right corner with margin) + */ +function getDefaultBottomRightPosition( + buttonSize: number = 40, + margin: number = 12, +): FloatingPosition { + return { + left: window.innerWidth - buttonSize - margin, + top: window.innerHeight - buttonSize - margin, + }; +} + +/** + * Load position from chrome.storage.local + */ +async function loadPosition(storageKey: string): Promise { + try { + const result = await chrome.storage.local.get(storageKey); + const saved = result[storageKey]; + if ( + saved && + typeof saved.left === 'number' && + typeof saved.top === 'number' && + Number.isFinite(saved.left) && + Number.isFinite(saved.top) + ) { + return saved as FloatingPosition; + } + } catch (e) { + console.warn('Failed to load navigator position:', e); + } + return null; +} + +/** + * Save position to chrome.storage.local + */ +async function savePosition(storageKey: string, position: FloatingPosition): Promise { + try { + await chrome.storage.local.set({ [storageKey]: position }); + } catch (e) { + console.warn('Failed to save navigator position:', e); + } +} + +/** + * Vue composable for making an element draggable with position persistence. + */ +export function useFloatingDrag( + handleRef: Ref, + targetRef: Ref, + options: UseFloatingDragOptions = {}, +): UseFloatingDragReturn { + const { + storageKey = STORAGE_KEY, + clampMargin = 12, + clickThresholdMs = 150, + moveThresholdPx = 5, + getDefaultPosition = () => getDefaultBottomRightPosition(40, clampMargin), + } = options; + + const position = ref(getDefaultPosition()); + const isDragging = ref(false); + const positionStyle = ref({ left: `${position.value.left}px`, top: `${position.value.top}px` }); + + let cleanup: (() => void) | null = null; + + function updatePositionStyle(): void { + positionStyle.value = { + left: `${position.value.left}px`, + top: `${position.value.top}px`, + }; + } + + function resetToDefault(): void { + position.value = getDefaultPosition(); + updatePositionStyle(); + savePosition(storageKey, position.value); + } + + async function initPosition(): Promise { + const saved = await loadPosition(storageKey); + if (saved) { + // Validate position is within current viewport + const maxLeft = window.innerWidth - 40 - clampMargin; + const maxTop = window.innerHeight - 40 - clampMargin; + position.value = { + left: Math.min(Math.max(clampMargin, saved.left), maxLeft), + top: Math.min(Math.max(clampMargin, saved.top), maxTop), + }; + } else { + position.value = getDefaultPosition(); + } + updatePositionStyle(); + } + + onMounted(async () => { + await initPosition(); + + // Wait for refs to be available + await new Promise((resolve) => setTimeout(resolve, 0)); + + if (!handleRef.value || !targetRef.value) { + console.warn('useFloatingDrag: handleRef or targetRef is null'); + return; + } + + cleanup = installFloatingDrag({ + handleEl: handleRef.value, + targetEl: targetRef.value, + onPositionChange: (pos) => { + position.value = pos; + updatePositionStyle(); + savePosition(storageKey, pos); + }, + clampMargin, + clickThresholdMs, + moveThresholdPx, + }); + + // Monitor dragging state via data attribute + const observer = new MutationObserver(() => { + isDragging.value = handleRef.value?.dataset.dragging === 'true'; + }); + if (handleRef.value) { + observer.observe(handleRef.value, { attributes: true, attributeFilter: ['data-dragging'] }); + } + }); + + onUnmounted(() => { + cleanup?.(); + }); + + return { + position, + isDragging, + resetToDefault, + positionStyle, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useOpenProjectPreference.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useOpenProjectPreference.ts new file mode 100644 index 00000000..07aa11e8 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useOpenProjectPreference.ts @@ -0,0 +1,137 @@ +/** + * Composable for managing user preference for opening project directory. + * Stores the default target (vscode/terminal) in chrome.storage.local. + */ +import { ref, type Ref } from 'vue'; +import type { OpenProjectTarget, OpenProjectResponse } from 'chrome-mcp-shared'; + +// Storage key for default open target +const STORAGE_KEY = 'agent-open-project-default'; + +export interface UseOpenProjectPreferenceOptions { + /** + * Server port for API calls. + * Should be provided from useAgentServer. + */ + getServerPort: () => number | null; +} + +export interface UseOpenProjectPreference { + /** Current default target (null if not set) */ + defaultTarget: Ref; + /** Loading state */ + loading: Ref; + /** Load default target from storage */ + loadDefaultTarget: () => Promise; + /** Save default target to storage */ + saveDefaultTarget: (target: OpenProjectTarget) => Promise; + /** Open project by session ID */ + openBySession: (sessionId: string, target: OpenProjectTarget) => Promise; + /** Open project by project ID */ + openByProject: (projectId: string, target: OpenProjectTarget) => Promise; +} + +export function useOpenProjectPreference( + options: UseOpenProjectPreferenceOptions, +): UseOpenProjectPreference { + const defaultTarget = ref(null); + const loading = ref(false); + + /** + * Load default target from chrome.storage.local. + */ + async function loadDefaultTarget(): Promise { + try { + const result = await chrome.storage.local.get(STORAGE_KEY); + const stored = result[STORAGE_KEY]; + if (stored === 'vscode' || stored === 'terminal') { + defaultTarget.value = stored; + } + } catch (error) { + console.error('[OpenProjectPreference] Failed to load default target:', error); + } + } + + /** + * Save default target to chrome.storage.local. + */ + async function saveDefaultTarget(target: OpenProjectTarget): Promise { + try { + await chrome.storage.local.set({ [STORAGE_KEY]: target }); + defaultTarget.value = target; + } catch (error) { + console.error('[OpenProjectPreference] Failed to save default target:', error); + } + } + + /** + * Open project directory by session ID. + */ + async function openBySession( + sessionId: string, + target: OpenProjectTarget, + ): Promise { + const port = options.getServerPort(); + if (!port) { + return { success: false, error: 'Server not connected' }; + } + + loading.value = true; + try { + const url = `http://127.0.0.1:${port}/agent/sessions/${encodeURIComponent(sessionId)}/open`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ target }), + }); + + const data = (await response.json()) as OpenProjectResponse; + return data; + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return { success: false, error: message }; + } finally { + loading.value = false; + } + } + + /** + * Open project directory by project ID. + */ + async function openByProject( + projectId: string, + target: OpenProjectTarget, + ): Promise { + const port = options.getServerPort(); + if (!port) { + return { success: false, error: 'Server not connected' }; + } + + loading.value = true; + try { + const url = `http://127.0.0.1:${port}/agent/projects/${encodeURIComponent(projectId)}/open`; + const response = await fetch(url, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ target }), + }); + + const data = (await response.json()) as OpenProjectResponse; + return data; + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return { success: false, error: message }; + } finally { + loading.value = false; + } + } + + return { + defaultTarget, + loading, + loadDefaultTarget, + saveDefaultTarget, + openBySession, + openByProject, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Debugger.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Debugger.ts new file mode 100644 index 00000000..f1442e1d --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Debugger.ts @@ -0,0 +1,383 @@ +/** + * @fileoverview RR V3 Debugger Composable + * @description Debugger state management, wraps all DebuggerCommand operations + * + * Responsibilities: + * - Send all debug commands via rr_v3.debug RPC method + * - Maintain reactive DebuggerState + * - Provide consistent error handling and response normalization + */ + +import { computed, onUnmounted, ref, type ComputedRef, type Ref } from 'vue'; + +import type { + DebuggerCommand, + DebuggerResponse, + DebuggerState, +} from '@/entrypoints/background/record-replay-v3/domain/debug'; +import type { NodeId, RunId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import type { JsonObject, JsonValue } from '@/entrypoints/background/record-replay-v3/domain/json'; +import type { RunEvent } from '@/entrypoints/background/record-replay-v3/domain/events'; + +import { useRRV3Rpc, type UseRRV3Rpc } from './useRRV3Rpc'; + +// ==================== Types ==================== + +/** Composable configuration */ +export interface UseRRV3DebuggerOptions { + /** Shared RPC client instance, creates new if not provided */ + rpc?: UseRRV3Rpc; + /** Current runId resolver for command defaults */ + getRunId?: () => RunId | null; + /** State update callback */ + onStateChange?: (state: DebuggerState) => void; + /** Error callback */ + onError?: (error: string) => void; + /** + * Auto-refresh DebuggerState when relevant events are received. + * Only effective when attached to a run. + * Events: run.paused, run.resumed, node.started + */ + autoRefreshOnEvents?: boolean; +} + +/** Composable return type */ +export interface UseRRV3Debugger { + /** RPC client instance */ + rpc: UseRRV3Rpc; + + // State + state: Ref; + lastError: Ref; + busy: Ref; + + // Derived state + currentRunId: ComputedRef; + isAttached: ComputedRef; + isPaused: ComputedRef; + + // Connection control + attach: (runId?: RunId) => Promise; + detach: (runId?: RunId) => Promise; + + // Execution control + pause: (runId?: RunId) => Promise; + resume: (runId?: RunId) => Promise; + stepOver: (runId?: RunId) => Promise; + + // Breakpoint management + setBreakpoints: (nodeIds: NodeId[], runId?: RunId) => Promise; + addBreakpoint: (nodeId: NodeId, runId?: RunId) => Promise; + removeBreakpoint: (nodeId: NodeId, runId?: RunId) => Promise; + + // State query + getState: (runId?: RunId) => Promise; + + // Variable operations + getVar: (name: string, runId?: RunId) => Promise; + setVar: (name: string, value: JsonValue, runId?: RunId) => Promise; +} + +// ==================== Helpers ==================== + +function toErrorMessage(error: unknown): string { + return error instanceof Error ? error.message : String(error); +} + +/** + * Validate breakpoint structure + */ +function isValidBreakpoint(value: unknown): boolean { + if (typeof value !== 'object' || value === null) return false; + const bp = value as Record; + return typeof bp.nodeId === 'string' && typeof bp.enabled === 'boolean'; +} + +/** + * Validate DebuggerState structure + */ +function isValidDebuggerState(value: unknown): value is DebuggerState { + if (typeof value !== 'object' || value === null) return false; + const obj = value as Record; + return ( + typeof obj.runId === 'string' && + (obj.status === 'attached' || obj.status === 'detached') && + (obj.execution === 'running' || obj.execution === 'paused') && + Array.isArray(obj.breakpoints) && + obj.breakpoints.every(isValidBreakpoint) + ); +} + +/** + * Normalize RPC response to DebuggerResponse + */ +function normalizeResponse(raw: JsonValue): DebuggerResponse { + if (typeof raw !== 'object' || raw === null) { + return { ok: false, error: 'Invalid response format' }; + } + + const obj = raw as Record; + + if (obj.ok === true) { + const responseState = obj.state; + // Validate state if present + if (responseState !== undefined && !isValidDebuggerState(responseState)) { + return { ok: false, error: 'Invalid DebuggerState in response' }; + } + return { + ok: true, + state: responseState as DebuggerState | undefined, + value: obj.value as JsonValue | undefined, + }; + } + + if (obj.ok === false) { + return { + ok: false, + error: typeof obj.error === 'string' ? obj.error : 'Unknown error', + }; + } + + return { ok: false, error: 'Response missing ok field' }; +} + +// ==================== Composable ==================== + +/** Events that trigger state refresh */ +const STATE_REFRESH_EVENTS = new Set(['run.paused', 'run.resumed', 'node.started']); + +/** + * RR V3 Debugger client + */ +export function useRRV3Debugger(options: UseRRV3DebuggerOptions = {}): UseRRV3Debugger { + // RPC client (use provided or create new) + const rpc = options.rpc ?? useRRV3Rpc(); + + // State + const state = ref(null); + const lastError = ref(null); + const busy = ref(false); + + // Derived state + const currentRunId = computed(() => { + // Prefer external resolver + const fromGetter = options.getRunId?.(); + if (fromGetter) return fromGetter; + // Fallback to current state + return state.value?.runId ?? null; + }); + + const isAttached = computed(() => state.value?.status === 'attached'); + const isPaused = computed(() => state.value?.execution === 'paused'); + + // ==================== Internal Methods ==================== + + function setError(message: string | null): void { + lastError.value = message; + if (message) options.onError?.(message); + } + + function updateState(next?: DebuggerState): void { + if (!next) return; + state.value = next; + options.onStateChange?.(next); + } + + function resolveRunId(explicit?: RunId): RunId | null { + if (explicit) return explicit; + return currentRunId.value; + } + + /** + * Send debug command + */ + async function send(cmd: DebuggerCommand): Promise { + busy.value = true; + try { + const raw = await rpc.request('rr_v3.debug', cmd as unknown as JsonObject); + const response = normalizeResponse(raw); + + if (response.ok) { + setError(null); + if (response.state) { + updateState(response.state); + } + } else { + setError(response.error); + } + + return response; + } catch (error) { + const message = toErrorMessage(error); + setError(message); + return { ok: false, error: message }; + } finally { + busy.value = false; + } + } + + /** + * Create error response for missing runId + */ + function missingRunIdError(commandType: string): DebuggerResponse { + const message = `${commandType} requires runId`; + setError(message); + return { ok: false, error: message }; + } + + // ==================== Public Methods ==================== + + async function attach(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.attach'); + return send({ type: 'debug.attach', runId: resolved }); + } + + async function detach(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.detach'); + return send({ type: 'debug.detach', runId: resolved }); + } + + async function pause(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.pause'); + return send({ type: 'debug.pause', runId: resolved }); + } + + async function resume(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.resume'); + return send({ type: 'debug.resume', runId: resolved }); + } + + async function stepOver(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.stepOver'); + return send({ type: 'debug.stepOver', runId: resolved }); + } + + async function setBreakpoints(nodeIds: NodeId[], runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.setBreakpoints'); + return send({ type: 'debug.setBreakpoints', runId: resolved, nodeIds }); + } + + async function addBreakpoint(nodeId: NodeId, runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.addBreakpoint'); + return send({ type: 'debug.addBreakpoint', runId: resolved, nodeId }); + } + + async function removeBreakpoint(nodeId: NodeId, runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.removeBreakpoint'); + return send({ type: 'debug.removeBreakpoint', runId: resolved, nodeId }); + } + + async function getState(runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.getState'); + return send({ type: 'debug.getState', runId: resolved }); + } + + async function getVar(name: string, runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.getVar'); + return send({ type: 'debug.getVar', runId: resolved, name }); + } + + async function setVar(name: string, value: JsonValue, runId?: RunId): Promise { + const resolved = resolveRunId(runId); + if (!resolved) return missingRunIdError('debug.setVar'); + return send({ type: 'debug.setVar', runId: resolved, name, value }); + } + + // ==================== Event Auto-Refresh ==================== + + // State refresh scheduling (debounced) + let refreshScheduled = false; + let refreshTimer: ReturnType | null = null; + + /** + * Schedule a debounced state refresh + * Uses microtask to coalesce multiple events in the same tick + */ + function scheduleRefresh(): void { + if (refreshScheduled) return; + refreshScheduled = true; + + // Clear any existing timer + if (refreshTimer) { + clearTimeout(refreshTimer); + refreshTimer = null; + } + + // Use microtask for same-tick debouncing + queueMicrotask(async () => { + refreshScheduled = false; + // Don't update busy state for auto-refresh to avoid UI flicker + try { + const resolved = currentRunId.value; + if (!resolved || !isAttached.value) return; + const raw = await rpc.request('rr_v3.debug', { + type: 'debug.getState', + runId: resolved, + } as unknown as JsonObject); + const response = normalizeResponse(raw); + if (response.ok && response.state) { + updateState(response.state); + } + } catch { + // Ignore errors in auto-refresh + } + }); + } + + /** + * Handle incoming events for auto-refresh + */ + function handleEvent(event: RunEvent): void { + // Only refresh if attached and event is for current run + if (!isAttached.value) return; + if (event.runId !== currentRunId.value) return; + if (!STATE_REFRESH_EVENTS.has(event.type)) return; + + scheduleRefresh(); + } + + // Setup event listener if autoRefreshOnEvents is enabled + let unsubscribeEvents: (() => void) | null = null; + if (options.autoRefreshOnEvents) { + unsubscribeEvents = rpc.onEvent(handleEvent); + } + + // Cleanup on unmount + onUnmounted(() => { + unsubscribeEvents?.(); + if (refreshTimer) { + clearTimeout(refreshTimer); + } + }); + + return { + rpc, + state, + lastError, + busy, + currentRunId, + isAttached, + isPaused, + attach, + detach, + pause, + resume, + stepOver, + setBreakpoints, + addBreakpoint, + removeBreakpoint, + getState, + getVar, + setVar, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Rpc.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Rpc.ts new file mode 100644 index 00000000..ebc81fee --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useRRV3Rpc.ts @@ -0,0 +1,11 @@ +/** + * @fileoverview Re-export shared useRRV3Rpc composable + * @description This file re-exports the shared composable for backward compatibility + */ + +export { + useRRV3Rpc, + type UseRRV3Rpc, + type UseRRV3RpcOptions, + type RpcRequestOptions, +} from '@/entrypoints/shared/composables/useRRV3Rpc'; diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useTextareaAutoResize.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useTextareaAutoResize.ts new file mode 100644 index 00000000..40d8851c --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useTextareaAutoResize.ts @@ -0,0 +1,163 @@ +/** + * Composable for textarea auto-resize functionality. + * Automatically adjusts textarea height based on content while respecting min/max constraints. + */ +import { ref, watch, nextTick, onMounted, onUnmounted, type Ref } from 'vue'; + +export interface UseTextareaAutoResizeOptions { + /** Ref to the textarea element */ + textareaRef: Ref; + /** Ref to the textarea value (for watching changes) */ + value: Ref; + /** Minimum height in pixels */ + minHeight?: number; + /** Maximum height in pixels */ + maxHeight?: number; +} + +export interface UseTextareaAutoResizeReturn { + /** Current calculated height */ + height: Ref; + /** Whether content exceeds max height (textarea is overflowing) */ + isOverflowing: Ref; + /** Manually trigger height recalculation */ + recalculate: () => void; +} + +const DEFAULT_MIN_HEIGHT = 50; +const DEFAULT_MAX_HEIGHT = 200; + +/** + * Composable for auto-resizing textarea based on content. + * + * Features: + * - Automatically adjusts height on input + * - Respects min/max height constraints + * - Handles width changes (line wrapping affects height) + * - Uses requestAnimationFrame for performance + */ +export function useTextareaAutoResize( + options: UseTextareaAutoResizeOptions, +): UseTextareaAutoResizeReturn { + const { + textareaRef, + value, + minHeight = DEFAULT_MIN_HEIGHT, + maxHeight = DEFAULT_MAX_HEIGHT, + } = options; + + const height = ref(minHeight); + const isOverflowing = ref(false); + + let scheduled = false; + let resizeObserver: ResizeObserver | null = null; + let lastWidth = 0; + + /** + * Calculate textarea height based on content. + * Only updates the reactive `height` and `isOverflowing` refs. + * The actual DOM height is controlled via :style binding in the template. + */ + function recalculate(): void { + const el = textareaRef.value; + if (!el) return; + + // Temporarily set height to 'auto' to get accurate scrollHeight + // Save current height to minimize visual flicker + const currentHeight = el.style.height; + el.style.height = 'auto'; + + const contentHeight = el.scrollHeight; + const clampedHeight = Math.min(maxHeight, Math.max(minHeight, contentHeight)); + + // Restore height immediately (the actual height is controlled by Vue binding) + el.style.height = currentHeight; + + // Update reactive state + height.value = clampedHeight; + // Add small tolerance (1px) to account for rounding + isOverflowing.value = contentHeight > maxHeight + 1; + } + + /** + * Schedule height recalculation using requestAnimationFrame. + * Batches multiple calls within the same frame for performance. + */ + function scheduleRecalculate(): void { + if (scheduled) return; + scheduled = true; + requestAnimationFrame(() => { + scheduled = false; + recalculate(); + }); + } + + // Watch value changes + watch( + value, + async () => { + await nextTick(); + scheduleRecalculate(); + }, + { flush: 'post' }, + ); + + // Watch textarea ref changes (in case it's replaced) + watch( + textareaRef, + async (newEl, oldEl) => { + // Cleanup old observer + if (resizeObserver && oldEl) { + resizeObserver.unobserve(oldEl); + } + + if (!newEl) return; + + await nextTick(); + scheduleRecalculate(); + + // Setup new observer for width changes + if (resizeObserver) { + lastWidth = newEl.offsetWidth; + resizeObserver.observe(newEl); + } + }, + { immediate: true }, + ); + + onMounted(() => { + const el = textareaRef.value; + if (!el) return; + + // Initial calculation + scheduleRecalculate(); + + // Setup ResizeObserver for width changes + // Width changes affect line wrapping, which affects scrollHeight + if (typeof ResizeObserver !== 'undefined') { + lastWidth = el.offsetWidth; + resizeObserver = new ResizeObserver(() => { + const current = textareaRef.value; + if (!current) return; + + const currentWidth = current.offsetWidth; + if (currentWidth !== lastWidth) { + lastWidth = currentWidth; + scheduleRecalculate(); + } + }); + resizeObserver.observe(el); + } + }); + + onUnmounted(() => { + resizeObserver?.disconnect(); + resizeObserver = null; + }); + + return { + height, + isOverflowing, + recalculate, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useWebEditorTxState.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useWebEditorTxState.ts new file mode 100644 index 00000000..120dd9d8 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useWebEditorTxState.ts @@ -0,0 +1,679 @@ +/** + * Composable for managing Web Editor TX (Transaction) state in Sidepanel. + * + * Responsibilities: + * - Listen to WEB_EDITOR_TX_CHANGED messages from background + * - Persist and recover state from chrome.storage.session + * - Manage excluded element keys for selective Apply + * - Provide reactive state for AgentChat chips UI + * + * Architecture: + * - The composable should be initialized ONCE at the AgentChat.vue level + * - It is then provided via Vue's provide/inject to child components + * - This prevents duplicate event listener registration + */ +import { computed, onMounted, onUnmounted, ref, type InjectionKey } from 'vue'; +import { BACKGROUND_MESSAGE_TYPES } from '@/common/message-types'; +import type { + ElementChangeSummary, + SelectedElementSummary, + WebEditorElementKey, + WebEditorSelectionChangedPayload, + WebEditorTxChangedPayload, + WebEditorTxChangeAction, +} from '@/common/web-editor-types'; + +// ============================================================================= +// Constants +// ============================================================================= + +const WEB_EDITOR_TX_CHANGED_SESSION_KEY_PREFIX = 'web-editor-v2-tx-changed-'; +const WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX = 'web-editor-v2-excluded-keys-'; +const WEB_EDITOR_SELECTION_SESSION_KEY_PREFIX = 'web-editor-v2-selection-'; + +const VALID_TX_ACTIONS = new Set([ + 'push', + 'merge', + 'undo', + 'redo', + 'clear', + 'rollback', +]); + +// ============================================================================= +// Internal Helpers +// ============================================================================= + +function isValidTabId(value: unknown): value is number { + return typeof value === 'number' && Number.isFinite(value) && value > 0; +} + +function buildTxSessionKey(tabId: number): string { + return `${WEB_EDITOR_TX_CHANGED_SESSION_KEY_PREFIX}${tabId}`; +} + +function buildExcludedKeysSessionKey(tabId: number): string { + return `${WEB_EDITOR_EXCLUDED_KEYS_SESSION_KEY_PREFIX}${tabId}`; +} + +function buildSelectionSessionKey(tabId: number): string { + return `${WEB_EDITOR_SELECTION_SESSION_KEY_PREFIX}${tabId}`; +} + +/** + * Normalize and validate selection changed payload from storage or message. + * Returns null if the payload is invalid. + */ +function normalizeSelectionPayload(raw: unknown): WebEditorSelectionChangedPayload | null { + if (!raw || typeof raw !== 'object') return null; + const obj = raw as Record; + + const tabId = Number(obj.tabId); + if (!Number.isFinite(tabId) || tabId <= 0) return null; + + // Selected can be null (deselection) or an object + const selectedRaw = obj.selected; + let selected: SelectedElementSummary | null = null; + + if (selectedRaw && typeof selectedRaw === 'object') { + const sel = selectedRaw as Record; + const elementKey = typeof sel.elementKey === 'string' ? sel.elementKey.trim() : ''; + if (!elementKey) return null; // Invalid selection + + selected = { + elementKey, + locator: sel.locator as SelectedElementSummary['locator'], + label: typeof sel.label === 'string' ? sel.label : '', + fullLabel: typeof sel.fullLabel === 'string' ? sel.fullLabel : '', + tagName: typeof sel.tagName === 'string' ? sel.tagName : '', + updatedAt: typeof sel.updatedAt === 'number' ? sel.updatedAt : Date.now(), + }; + } + + return { + tabId, + selected, + pageUrl: typeof obj.pageUrl === 'string' ? obj.pageUrl : undefined, + }; +} + +/** + * Normalize and validate TX changed payload from storage or message. + * Returns null if the payload is invalid. + */ +function normalizeTxChangedPayload(raw: unknown): WebEditorTxChangedPayload | null { + if (!raw || typeof raw !== 'object') return null; + const obj = raw as Record; + + const tabId = Number(obj.tabId); + if (!Number.isFinite(tabId) || tabId <= 0) return null; + + const actionRaw = typeof obj.action === 'string' ? obj.action : ''; + if (!VALID_TX_ACTIONS.has(actionRaw as WebEditorTxChangeAction)) return null; + const action = actionRaw as WebEditorTxChangeAction; + + // Filter elements to ensure minimal validity (elementKey must be a non-empty string) + const rawElements = Array.isArray(obj.elements) ? obj.elements : []; + const elements = rawElements.filter( + (e): e is ElementChangeSummary => + e && + typeof e === 'object' && + typeof (e as any).elementKey === 'string' && + (e as any).elementKey, + ); + + const undoCountRaw = Number(obj.undoCount); + const redoCountRaw = Number(obj.redoCount); + const undoCount = Number.isFinite(undoCountRaw) && undoCountRaw >= 0 ? undoCountRaw : 0; + const redoCount = Number.isFinite(redoCountRaw) && redoCountRaw >= 0 ? redoCountRaw : 0; + + const hasApplicableChanges = Boolean(obj.hasApplicableChanges); + const pageUrl = typeof obj.pageUrl === 'string' ? obj.pageUrl : undefined; + + return { + tabId, + action, + elements, + undoCount, + redoCount, + hasApplicableChanges, + pageUrl, + }; +} + +/** + * Normalize and deduplicate excluded keys array from storage. + * Filters out invalid entries and removes duplicates. + */ +function normalizeExcludedKeys(raw: unknown): WebEditorElementKey[] { + if (!Array.isArray(raw)) return []; + + const result: WebEditorElementKey[] = []; + const seen = new Set(); + + for (const item of raw) { + const key = String(item ?? '').trim(); + if (!key || seen.has(key)) continue; + seen.add(key); + result.push(key); + } + + return result; +} + +/** + * Persist excluded keys to session storage (per-tab). + * Best-effort: silently ignores failures. + */ +async function persistExcludedKeys( + tabId: number, + keys: readonly WebEditorElementKey[], +): Promise { + if (!isValidTabId(tabId)) return; + + try { + if (typeof chrome === 'undefined' || !chrome.storage?.session?.set) return; + const storageKey = buildExcludedKeysSessionKey(tabId); + await chrome.storage.session.set({ [storageKey]: [...keys] }); + } catch (error) { + console.error('[useWebEditorTxState] Failed to persist excluded keys:', error); + } +} + +/** + * Default implementation for getting active tab ID. + */ +async function getActiveTabIdDefault(): Promise { + try { + if (typeof chrome === 'undefined' || !chrome.tabs?.query) return null; + const tabs = await chrome.tabs.query({ active: true, currentWindow: true }); + const tabId = tabs?.[0]?.id; + return typeof tabId === 'number' ? tabId : null; + } catch { + return null; + } +} + +/** + * Get current window ID for filtering tab activation events. + * This prevents processing tab switches from other Chrome windows. + */ +async function getCurrentWindowId(): Promise { + try { + if (typeof chrome === 'undefined' || !chrome.windows?.getCurrent) return null; + const win = await chrome.windows.getCurrent(); + return typeof win?.id === 'number' ? win.id : null; + } catch { + return null; + } +} + +// ============================================================================= +// Public API +// ============================================================================= + +export interface UseWebEditorTxStateOptions { + /** + * Optional override for resolving the "current tab" in sidepanel. + * Defaults to chrome.tabs.query({ active: true, currentWindow: true }). + */ + getActiveTabId?: () => Promise; + /** + * If provided, skips querying the active tab on mount. + */ + initialTabId?: number | null; +} + +export function useWebEditorTxState(options: UseWebEditorTxStateOptions = {}) { + // ========================================================================== + // State + // ========================================================================== + + /** Current tab ID being tracked */ + const tabId = ref( + isValidTabId(options.initialTabId) ? options.initialTabId : null, + ); + + /** Current TX state from web-editor */ + const txState = ref(null); + + /** Currently selected element (for context, may not have edits) */ + const selectedElement = ref(null); + + /** Page URL from selection (may differ from txState.pageUrl if selection is newer) */ + const selectionPageUrl = ref(null); + + /** Excluded element keys (user-deselected elements) */ + const excludedKeys = ref([]); + + // ========================================================================== + // Computed + // ========================================================================== + + /** All elements from TX state */ + const allElements = computed(() => txState.value?.elements ?? []); + + /** Set of excluded keys for O(1) lookup */ + const excludedKeySet = computed(() => new Set(excludedKeys.value)); + + /** Elements that will be applied (not excluded) */ + const applicableElements = computed(() => { + const set = excludedKeySet.value; + return allElements.value.filter((e) => !set.has(e.elementKey)); + }); + + /** Elements that are excluded by user */ + const excludedElements = computed(() => { + const set = excludedKeySet.value; + return allElements.value.filter((e) => set.has(e.elementKey)); + }); + + /** Whether there are applicable changes to send to Agent */ + const hasChanges = computed(() => applicableElements.value.length > 0); + + /** Whether there is a selected element */ + const hasSelection = computed(() => selectedElement.value !== null); + + /** + * Whether the selected element is also in the edits list. + * Used to decide if we need a separate "selection-only" chip. + */ + const isSelectionInEdits = computed(() => { + const sel = selectedElement.value; + if (!sel) return false; + return allElements.value.some((e) => e.elementKey === sel.elementKey); + }); + + /** Whether to show the web editor section (has edits OR has selection) */ + const hasContent = computed( + () => hasChanges.value || hasSelection.value || allElements.value.length > 0, + ); + + // ========================================================================== + // Actions + // ========================================================================== + + /** + * Toggle an element's excluded state. + * Automatically persists to session storage. + */ + function toggleExclude(elementKey: WebEditorElementKey): void { + const key = String(elementKey ?? '').trim(); + if (!key) return; + + const current = excludedKeys.value; + const idx = current.indexOf(key); + if (idx >= 0) { + // Remove from excluded list + excludedKeys.value = [...current.slice(0, idx), ...current.slice(idx + 1)]; + } else { + // Add to excluded list + excludedKeys.value = [...current, key]; + } + + // Persist to session storage + if (isValidTabId(tabId.value)) { + void persistExcludedKeys(tabId.value, excludedKeys.value); + } + } + + /** + * Clear all excluded elements. + * Automatically persists to session storage. + */ + function clearExcluded(): void { + excludedKeys.value = []; + + // Persist to session storage + if (isValidTabId(tabId.value)) { + void persistExcludedKeys(tabId.value, excludedKeys.value); + } + } + + /** + * Remove excluded keys that no longer exist in the current TX state. + * This prevents stale keys when elements are undone/cleared. + */ + function pruneStaleExcludedKeys(elements: readonly ElementChangeSummary[] | null): void { + if (!elements || !isValidTabId(tabId.value)) return; + + const validKeys = new Set(elements.map((e) => e.elementKey)); + const prunedKeys = excludedKeys.value.filter((k) => validKeys.has(k)); + + // Only update if there are stale keys to remove + if (prunedKeys.length === excludedKeys.value.length) return; + + excludedKeys.value = prunedKeys; + void persistExcludedKeys(tabId.value, prunedKeys); + } + + /** Sequence counter to prevent stale async updates */ + let refreshSeq = 0; + + /** + * Refresh TX state from session storage for a specific tab. + * Also restores excluded keys from storage. + * On tab change, immediately clears state to prevent cross-tab pollution. + */ + async function refreshFromStorage(targetTabId: number): Promise { + if (!isValidTabId(targetTabId)) { + tabId.value = null; + txState.value = null; + excludedKeys.value = []; + selectedElement.value = null; + selectionPageUrl.value = null; + return; + } + + // On tab change, immediately clear state to prevent UI showing stale data + const isTabChange = tabId.value !== targetTabId; + if (isTabChange) { + txState.value = null; + excludedKeys.value = []; + selectedElement.value = null; + selectionPageUrl.value = null; + } + tabId.value = targetTabId; + + const seq = ++refreshSeq; + const txKey = buildTxSessionKey(targetTabId); + const excludedKey = buildExcludedKeysSessionKey(targetTabId); + const selectionKey = buildSelectionSessionKey(targetTabId); + + try { + if (typeof chrome === 'undefined' || !chrome.storage?.session?.get) { + txState.value = null; + excludedKeys.value = []; + selectedElement.value = null; + selectionPageUrl.value = null; + return; + } + + // Fetch TX state, excluded keys, and selection in one call + const result = (await chrome.storage.session.get([ + txKey, + excludedKey, + selectionKey, + ])) as Record; + + // Check for stale async response + if (seq !== refreshSeq) return; + + // Update TX state + const nextTxState = normalizeTxChangedPayload(result?.[txKey]); + txState.value = nextTxState; + + // Restore excluded keys from storage + excludedKeys.value = normalizeExcludedKeys(result?.[excludedKey]); + + // Restore selection from storage + const nextSelection = normalizeSelectionPayload(result?.[selectionKey]); + selectedElement.value = nextSelection?.selected ?? null; + selectionPageUrl.value = nextSelection?.pageUrl ?? null; + + // Prune stale excluded keys based on current elements + pruneStaleExcludedKeys(nextTxState?.elements ?? null); + } catch (error) { + console.error('[useWebEditorTxState] Failed to refresh from session storage:', error); + // On error, ensure clean state to prevent showing stale data + txState.value = null; + excludedKeys.value = []; + selectedElement.value = null; + selectionPageUrl.value = null; + } + } + + // ========================================================================== + // Message Listeners + // ========================================================================== + + /** + * Handle runtime messages from background. + */ + const onRuntimeMessage = ( + message: unknown, + _sender: chrome.runtime.MessageSender, + _sendResponse: (response?: unknown) => void, + ): void => { + const msg = + message && typeof message === 'object' ? (message as Record) : null; + if (!msg) return; + + // Handle TX changed messages + if (msg.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_TX_CHANGED) { + const next = normalizeTxChangedPayload(msg.payload); + if (!next) return; + + // Only process messages for the current tab + if (!isValidTabId(tabId.value)) return; + if (next.tabId !== tabId.value) return; + + txState.value = next; + + // Prune excluded keys that no longer exist (e.g., after undo/clear) + pruneStaleExcludedKeys(next.elements); + return; + } + + // Handle selection changed messages + if (msg.type === BACKGROUND_MESSAGE_TYPES.WEB_EDITOR_SELECTION_CHANGED) { + const next = normalizeSelectionPayload(msg.payload); + if (!next) return; + + // Only process messages for the current tab + if (!isValidTabId(tabId.value)) return; + if (next.tabId !== tabId.value) return; + + selectedElement.value = next.selected; + // Store pageUrl from selection for context building + selectionPageUrl.value = next.pageUrl ?? null; + return; + } + }; + + /** + * Handle session storage changes (fallback for cold start). + * Only handles TX state changes; excluded keys are managed explicitly. + */ + const onSessionChanged = (changes: { [key: string]: chrome.storage.StorageChange }): void => { + if (!isValidTabId(tabId.value)) return; + const txKey = buildTxSessionKey(tabId.value); + + const change = changes?.[txKey]; + if (!change) return; + + if (change.newValue === undefined) { + txState.value = null; + // Clear excluded keys when TX state is cleared + pruneStaleExcludedKeys([]); + return; + } + + const next = normalizeTxChangedPayload(change.newValue); + txState.value = next; + + // Prune stale excluded keys + pruneStaleExcludedKeys(next?.elements ?? []); + }; + + /** Cleanup function for storage listener */ + let removeStorageListener: (() => void) | null = null; + + /** Cleanup function for tab activated listener */ + let removeTabActivatedListener: (() => void) | null = null; + + /** Cached window ID to filter tab activation events from other windows */ + let currentWindowId: number | null = null; + + /** + * Handle tab activation events. + * Updates tabId and loads TX state when user switches to a different tab. + * + * Note: currentWindowId filtering is best-effort. If getCurrentWindowId() fails, + * events from all windows will be processed (acceptable fallback behavior). + */ + const onTabActivated = (activeInfo: chrome.tabs.TabActiveInfo): void => { + try { + // Ignore events from other windows (best-effort filter) + if (currentWindowId !== null && activeInfo.windowId !== currentWindowId) return; + + const nextTabId = activeInfo.tabId; + if (!isValidTabId(nextTabId)) return; + + // Skip if already tracking this tab + if (nextTabId === tabId.value) return; + + // Load TX state for the newly activated tab + void refreshFromStorage(nextTabId); + } catch (error) { + console.error('[useWebEditorTxState] Failed to handle tab activation:', error); + } + }; + + // ========================================================================== + // Lifecycle + // ========================================================================== + + onMounted(async () => { + // Register runtime message listener + try { + if (typeof chrome !== 'undefined' && chrome.runtime?.onMessage?.addListener) { + chrome.runtime.onMessage.addListener(onRuntimeMessage); + } + } catch (error) { + console.error('Failed to register WebEditor TX runtime listener:', error); + } + + // Register session storage listener + try { + if (typeof chrome !== 'undefined' && chrome.storage?.session?.onChanged?.addListener) { + // Prefer session-specific listener if available + chrome.storage.session.onChanged.addListener(onSessionChanged); + removeStorageListener = () => { + try { + chrome.storage.session.onChanged.removeListener(onSessionChanged); + } catch {} + }; + } else if (typeof chrome !== 'undefined' && chrome.storage?.onChanged?.addListener) { + // Fallback to generic storage listener with area filter + const onChanged = ( + changes: { [key: string]: chrome.storage.StorageChange }, + areaName: chrome.storage.AreaName, + ) => { + if (areaName !== 'session') return; + onSessionChanged(changes); + }; + + chrome.storage.onChanged.addListener(onChanged); + removeStorageListener = () => { + try { + chrome.storage.onChanged.removeListener(onChanged); + } catch {} + }; + } + } catch (error) { + console.error('Failed to register WebEditor TX storage listener:', error); + } + + // Cache current window ID for filtering tab activation events + currentWindowId = await getCurrentWindowId(); + + // Register tab activation listener to track tab switches + try { + if (typeof chrome !== 'undefined' && chrome.tabs?.onActivated?.addListener) { + chrome.tabs.onActivated.addListener(onTabActivated); + removeTabActivatedListener = () => { + try { + chrome.tabs.onActivated.removeListener(onTabActivated); + } catch {} + }; + } + } catch (error) { + console.error('[useWebEditorTxState] Failed to register tab activation listener:', error); + } + + // Initialize tab ID if not provided + const getActiveTabId = options.getActiveTabId ?? getActiveTabIdDefault; + + if (!isValidTabId(tabId.value)) { + const active = await getActiveTabId().catch(() => null); + if (isValidTabId(active)) { + tabId.value = active; + } + } + + // Load initial state from storage + if (isValidTabId(tabId.value)) { + await refreshFromStorage(tabId.value); + } + }); + + onUnmounted(() => { + // Clean up runtime message listener + try { + if (typeof chrome !== 'undefined' && chrome.runtime?.onMessage?.removeListener) { + chrome.runtime.onMessage.removeListener(onRuntimeMessage); + } + } catch {} + + // Clean up storage listener + removeStorageListener?.(); + removeStorageListener = null; + + // Clean up tab activation listener + removeTabActivatedListener?.(); + removeTabActivatedListener = null; + }); + + // ========================================================================== + // Return + // ========================================================================== + + return { + // State + tabId, + txState, + excludedKeys, + selectedElement, + selectionPageUrl, + + // UI State (computed) + allElements, + hasChanges, + hasSelection, + isSelectionInEdits, + hasContent, + applicableElements, + excludedElements, + + // Actions + toggleExclude, + clearExcluded, + refreshFromStorage, + }; +} + +// ============================================================================= +// Type Exports & Injection Key +// ============================================================================= + +/** + * Return type of useWebEditorTxState composable. + * Used for type-safe provide/inject. + */ +export type WebEditorTxStateReturn = ReturnType; + +/** + * Injection key for providing WebEditorTxState to child components. + * Use this with Vue's provide/inject pattern to avoid duplicate listener registration. + * + * @example + * // In AgentChat.vue (parent) + * const webEditorTx = useWebEditorTxState(); + * provide(WEB_EDITOR_TX_STATE_INJECTION_KEY, webEditorTx); + * + * // In WebEditorChanges.vue (child) + * const tx = inject(WEB_EDITOR_TX_STATE_INJECTION_KEY); + */ +export const WEB_EDITOR_TX_STATE_INJECTION_KEY: InjectionKey = + Symbol('web-editor-tx-state'); diff --git a/app/chrome-extension/entrypoints/sidepanel/composables/useWorkflowsV3.ts b/app/chrome-extension/entrypoints/sidepanel/composables/useWorkflowsV3.ts new file mode 100644 index 00000000..68e174b4 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/composables/useWorkflowsV3.ts @@ -0,0 +1,364 @@ +/** + * @fileoverview V3 Workflows Data Layer Composable + * @description Provides V3 workflows data management for Sidepanel UI + * + * This composable wraps the V3 RPC client and provides: + * - Flow listing, running, and deletion + * - Run listing and event subscription + * - Trigger management + * - Data mapping from V3 types to UI types + */ + +import { onMounted, onUnmounted, ref, type Ref } from 'vue'; + +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3/domain/flow'; +import type { RunRecordV3 } from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { TriggerSpec } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { FlowId, RunId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import { useRRV3Rpc } from './useRRV3Rpc'; + +// ==================== UI Types ==================== + +/** Flow type for UI display (compatible with existing WorkflowsView) */ +export interface FlowLite { + id: string; + name: string; + description?: string; + meta?: { + domain?: string; + tags?: string[]; + bindings?: Array<{ + kind?: string; // V3 uses 'kind' + type?: string; // V2 uses 'type' + value: string; + }>; + }; +} + +/** Run type for UI display (compatible with existing WorkflowsView) */ +export interface RunLite { + id: string; + flowId: string; + startedAt: string; + finishedAt?: string; + /** + * Terminal success status: true=succeeded, false=failed/canceled, undefined=in progress + * UI should check `isInProgress` first to distinguish in-progress from failed + */ + success?: boolean; + /** Whether the run is still in progress (queued/running/paused) */ + isInProgress: boolean; + status: RunRecordV3['status']; + entries: unknown[]; +} + +/** Trigger type for UI display */ +export interface TriggerLite { + id: string; + type: string; // UI uses 'type', V3 uses 'kind' + kind: string; // V3 uses 'kind' + flowId: string; + enabled?: boolean; + match?: Array<{ kind: string; value: string }>; // For URL triggers + [key: string]: unknown; +} + +// ==================== Mappers ==================== + +/** Convert V3 FlowV3 to UI FlowLite */ +function mapFlowV3ToLite(flow: FlowV3): FlowLite { + return { + id: flow.id, + name: flow.name, + description: flow.description, + meta: { + tags: flow.meta?.tags, + bindings: flow.meta?.bindings?.map((b) => ({ + kind: b.kind, + type: b.kind, // For V2 compatibility + value: b.value, + })), + }, + }; +} + +/** Convert V3 RunRecordV3 to UI RunLite */ +function mapRunV3ToLite(run: RunRecordV3): RunLite { + // Determine if run is in progress + const inProgressStatuses = ['queued', 'running', 'paused']; + const isInProgress = inProgressStatuses.includes(run.status); + + // Map V3 status to success boolean for terminal states only + let success: boolean | undefined; + if (run.status === 'succeeded') success = true; + else if (run.status === 'failed' || run.status === 'canceled') success = false; + // For in-progress states, success remains undefined + + return { + id: run.id, + flowId: run.flowId, + startedAt: run.startedAt + ? new Date(run.startedAt).toISOString() + : new Date(run.createdAt).toISOString(), + finishedAt: run.finishedAt ? new Date(run.finishedAt).toISOString() : undefined, + success, + isInProgress, + status: run.status, + entries: [], // V3 doesn't have entries in RunRecord, use getEvents for details + }; +} + +/** Convert V3 TriggerSpec to UI TriggerLite */ +function mapTriggerV3ToLite(trigger: TriggerSpec): TriggerLite { + return { + ...trigger, + type: trigger.kind, // Map 'kind' to 'type' for UI compatibility + kind: trigger.kind, + } as TriggerLite; +} + +// ==================== Composable ==================== + +export interface UseWorkflowsV3Options { + /** Auto-refresh interval in ms (0 = disabled) */ + autoRefreshMs?: number; + /** Auto-connect on mount */ + autoConnect?: boolean; +} + +export interface UseWorkflowsV3Return { + // Connection state + connected: Ref; + loading: Ref; + error: Ref; + + // Data + flows: Ref; + runs: Ref; + triggers: Ref; + + // Actions + refresh: () => Promise; + refreshFlows: () => Promise; + refreshRuns: () => Promise; + refreshTriggers: () => Promise; + runFlow: (flowId: string) => Promise<{ runId: string } | null>; + deleteFlow: (flowId: string) => Promise; + exportFlow: (flowId: string) => Promise; + deleteTrigger: (triggerId: string) => Promise; + + // V3-specific + getFlowById: (flowId: string) => Promise; + getRunEvents: (runId: string) => Promise; +} + +/** + * V3 Workflows data layer composable + */ +export function useWorkflowsV3(options: UseWorkflowsV3Options = {}): UseWorkflowsV3Return { + const { autoRefreshMs = 0, autoConnect = true } = options; + + // RPC client + const rpc = useRRV3Rpc({ autoConnect }); + + // State + const loading = ref(false); + const error = ref(null); + const flows = ref([]); + const runs = ref([]); + const triggers = ref([]); + + // Auto-refresh timer + let refreshTimer: ReturnType | null = null; + // Event subscription cleanup function + let eventUnsubscribe: (() => void) | null = null; + + // ==================== Actions ==================== + + async function refreshFlows(): Promise { + try { + const result = (await rpc.request('rr_v3.listFlows')) as FlowV3[] | null; + flows.value = (result || []).map(mapFlowV3ToLite); + } catch (e) { + console.warn('[useWorkflowsV3] Failed to refresh flows:', e); + error.value = e instanceof Error ? e.message : String(e); + } + } + + async function refreshRuns(): Promise { + try { + const result = (await rpc.request('rr_v3.listRuns')) as RunRecordV3[] | null; + // Sort by createdAt descending (newest first) + const sorted = (result || []).slice().sort((a, b) => b.createdAt - a.createdAt); + runs.value = sorted.map(mapRunV3ToLite); + } catch (e) { + console.warn('[useWorkflowsV3] Failed to refresh runs:', e); + error.value = e instanceof Error ? e.message : String(e); + } + } + + async function refreshTriggers(): Promise { + try { + const result = (await rpc.request('rr_v3.listTriggers')) as TriggerSpec[] | null; + triggers.value = (result || []).map(mapTriggerV3ToLite); + } catch (e) { + console.warn('[useWorkflowsV3] Failed to refresh triggers:', e); + error.value = e instanceof Error ? e.message : String(e); + } + } + + async function refresh(): Promise { + loading.value = true; + error.value = null; + try { + await Promise.all([refreshFlows(), refreshRuns(), refreshTriggers()]); + } finally { + loading.value = false; + } + } + + async function runFlow(flowId: string): Promise<{ runId: string } | null> { + try { + const result = (await rpc.request('rr_v3.enqueueRun', { + flowId: flowId as FlowId, + })) as { runId: RunId; position: number } | null; + // Refresh runs to show the new run + void refreshRuns(); + return result ? { runId: result.runId } : null; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to run flow:', e); + error.value = e instanceof Error ? e.message : String(e); + return null; + } + } + + async function deleteFlow(flowId: string): Promise { + try { + await rpc.request('rr_v3.deleteFlow', { flowId: flowId as FlowId }); + // Refresh flows after deletion + void refreshFlows(); + return true; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to delete flow:', e); + error.value = e instanceof Error ? e.message : String(e); + return false; + } + } + + async function exportFlow(flowId: string): Promise { + try { + const result = (await rpc.request('rr_v3.getFlow', { + flowId: flowId as FlowId, + })) as FlowV3 | null; + return result; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to export flow:', e); + error.value = e instanceof Error ? e.message : String(e); + return null; + } + } + + async function deleteTrigger(triggerId: string): Promise { + try { + await rpc.request('rr_v3.deleteTrigger', { triggerId }); + // Refresh triggers after deletion + void refreshTriggers(); + return true; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to delete trigger:', e); + error.value = e instanceof Error ? e.message : String(e); + return false; + } + } + + async function getFlowById(flowId: string): Promise { + try { + return (await rpc.request('rr_v3.getFlow', { + flowId: flowId as FlowId, + })) as FlowV3 | null; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to get flow:', e); + return null; + } + } + + async function getRunEvents(runId: string): Promise { + try { + return (await rpc.request('rr_v3.getEvents', { + runId: runId as RunId, + })) as unknown[]; + } catch (e) { + console.warn('[useWorkflowsV3] Failed to get run events:', e); + return []; + } + } + + // ==================== Lifecycle ==================== + + onMounted(async () => { + if (autoConnect) { + await rpc.ensureConnected(); + await refresh(); + } + + // Setup auto-refresh + if (autoRefreshMs > 0) { + refreshTimer = setInterval(() => { + void refresh(); + }, autoRefreshMs); + } + + // Subscribe to all run events for real-time updates + void rpc.subscribe(null); + eventUnsubscribe = rpc.onEvent((event) => { + // Refresh runs when run status changes + const runStatusEvents = [ + 'run.queued', + 'run.started', + 'run.succeeded', + 'run.failed', + 'run.canceled', + 'run.paused', + 'run.resumed', + 'run.recovered', + ]; + if (runStatusEvents.includes(event.type)) { + void refreshRuns(); + } + }); + }); + + onUnmounted(() => { + // Cleanup auto-refresh timer + if (refreshTimer) { + clearInterval(refreshTimer); + refreshTimer = null; + } + // Cleanup event subscription + if (eventUnsubscribe) { + eventUnsubscribe(); + eventUnsubscribe = null; + } + // Unsubscribe from run events + void rpc.unsubscribe(null); + }); + + return { + connected: rpc.connected, + loading, + error, + flows, + runs, + triggers, + refresh, + refreshFlows, + refreshRuns, + refreshTriggers, + runFlow, + deleteFlow, + exportFlow, + deleteTrigger, + getFlowById, + getRunEvents, + }; +} diff --git a/app/chrome-extension/entrypoints/sidepanel/index.html b/app/chrome-extension/entrypoints/sidepanel/index.html new file mode 100644 index 00000000..b0adef4e --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/index.html @@ -0,0 +1,13 @@ + + + + + + 工作流管理 + + + +
+ + + diff --git a/app/chrome-extension/entrypoints/sidepanel/main.ts b/app/chrome-extension/entrypoints/sidepanel/main.ts new file mode 100644 index 00000000..b61c8470 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/main.ts @@ -0,0 +1,30 @@ +import { createApp } from 'vue'; +import { NativeMessageType } from 'chrome-mcp-shared'; +import App from './App.vue'; + +// Tailwind first, then custom tokens +import '../styles/tailwind.css'; +// AgentChat theme tokens +import './styles/agent-chat.css'; + +import { preloadAgentTheme } from './composables'; + +/** + * Initialize and mount the Vue app. + * Preloads theme before mounting to prevent flash. + */ +async function init(): Promise { + // Preload theme from storage and apply to document + // This happens before Vue mounts, preventing theme flash + await preloadAgentTheme(); + + // Trigger ensure native connection (fire-and-forget, don't block UI mounting) + void chrome.runtime.sendMessage({ type: NativeMessageType.ENSURE_NATIVE }).catch(() => { + // Silent failure - background will handle reconnection + }); + + // Mount Vue app + createApp(App).mount('#app'); +} + +init(); diff --git a/app/chrome-extension/entrypoints/sidepanel/styles/agent-chat.css b/app/chrome-extension/entrypoints/sidepanel/styles/agent-chat.css new file mode 100644 index 00000000..6d60eb74 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/styles/agent-chat.css @@ -0,0 +1,836 @@ +/** + * AgentChat Theme System + * + * This file defines the CSS variable tokens for the AgentChat component. + * All components must only use these tokens - never hardcode colors. + * + * Themes: + * - warm-editorial (default): Warm, editorial style from agent-ux.html + * - blueprint-architect: Blueprint grid with technical aesthetic + * - zen-journal: Calm journal / graphite accent (Muji style) + * - neo-pop: Thick borders + hard shadow (Brutalist) + * - dark-console: Dark terminal/console style + * - swiss-grid: High-contrast brutalist/swiss style + */ + +@layer base { + .agent-theme { + /* ======================================== + Font Stacks (system font fallbacks) + ======================================== */ + --ac-font-sans: + 'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, + 'Apple Color Emoji', 'Segoe UI Emoji'; + --ac-font-serif: 'Newsreader', ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif; + --ac-font-mono: + 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', + 'Courier New', monospace; + --ac-font-grotesk: + 'Space Grotesk', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial; + + /* Semantic font tokens */ + --ac-font-body: var(--ac-font-sans); + --ac-font-heading: var(--ac-font-serif); + --ac-font-code: var(--ac-font-mono); + + /* ======================================== + Geometry (Shape & Spacing) + ======================================== */ + --ac-border-width: 1px; + --ac-border-width-strong: 2px; + --ac-radius-container: 0px; + --ac-radius-card: 12px; + --ac-radius-inner: 8px; + --ac-radius-button: 8px; + + /* Motion */ + --ac-motion-fast: 120ms; + --ac-motion-normal: 180ms; + + /* Timeline sizing */ + --ac-timeline-line-width: 1px; + --ac-timeline-node-size: 8px; + --ac-timeline-indent: 24px; + + /* Scrollbar sizing */ + --ac-scrollbar-size: 4px; + + /* ======================================== + WARM EDITORIAL (Default Theme) + ======================================== */ + + /* Background */ + --ac-bg: #fdfcf8; + --ac-bg-pattern: none; + --ac-bg-pattern-size: 16px 16px; + + /* Header */ + --ac-header-bg: rgba(253, 252, 248, 0.95); + --ac-header-border: rgba(245, 245, 244, 0.5); + + /* Surfaces */ + --ac-surface: #ffffff; + --ac-surface-muted: #f2f0eb; + --ac-surface-inset: #f2f0eb; + + /* Text */ + --ac-text: #1a1a1a; + --ac-text-muted: #6e6e6e; + --ac-text-subtle: #a8a29e; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #a8a29e; + + /* Borders */ + --ac-border: #e7e5e4; + --ac-border-strong: #d6d3d1; + + /* Hover states */ + --ac-hover-bg: #f5f5f4; + --ac-hover-bg-subtle: #fafaf9; + + /* Accent (terracotta) */ + --ac-accent: #d97757; + --ac-accent-hover: #c4664a; + --ac-accent-subtle: rgba(217, 119, 87, 0.12); + --ac-accent-contrast: #ffffff; + --ac-accent-2: var(--ac-accent); + + /* Links */ + --ac-link: var(--ac-accent); + --ac-link-hover: var(--ac-accent-hover); + + /* Selection */ + --ac-selection-bg: #ffedd5; + --ac-selection-text: #7c2d12; + + /* Shadows */ + --ac-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.08); + --ac-shadow-float: 0 4px 20px -2px rgba(0, 0, 0, 0.05); + + /* Focus */ + --ac-focus-ring: rgba(214, 211, 209, 0.9); + + /* Timeline */ + --ac-timeline-line: #e7e5e4; + --ac-timeline-node: #d6d3d1; + --ac-timeline-node-hover: #a8a29e; + --ac-timeline-node-active: var(--ac-accent); + --ac-timeline-node-active-border: var(--ac-accent); + --ac-timeline-node-tool: #94a3b8; + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(217, 119, 87, 0.25), 0 0 12px rgba(217, 119, 87, 0.2); + + /* Chips/Pills */ + --ac-chip-bg: #f2f0eb; + --ac-chip-text: #1a1a1a; + --ac-chip-border: #e7e5e4; + + /* Code blocks */ + --ac-code-bg: #ffffff; + --ac-code-text: #1a1a1a; + --ac-code-border: #e7e5e4; + + /* Diff colors */ + --ac-diff-add-bg: rgba(240, 253, 244, 0.6); + --ac-diff-add-text: #15803d; + --ac-diff-add-border: #4ade80; + --ac-diff-del-bg: rgba(254, 242, 242, 0.6); + --ac-diff-del-text: #b91c1c; + --ac-diff-del-border: #fca5a5; + + /* Status colors */ + --ac-success: #22c55e; + --ac-warning: #f59e0b; + --ac-danger: #ef4444; + + /* Scrollbar */ + --ac-scrollbar-thumb: #e5e5e5; + --ac-scrollbar-thumb-hover: #d4d4d4; + } + + /* ======================================== + WARM EDITORIAL (Explicit for clarity) + ======================================== */ + .agent-theme[data-agent-theme='warm-editorial'] { + --ac-font-body: var(--ac-font-sans); + --ac-font-heading: var(--ac-font-serif); + --ac-font-code: var(--ac-font-mono); + + --ac-bg: #fdfcf8; + --ac-bg-pattern: none; + --ac-header-bg: rgba(253, 252, 248, 0.95); + --ac-header-border: rgba(245, 245, 244, 0.5); + --ac-surface: #ffffff; + --ac-surface-muted: #f2f0eb; + --ac-text: #1a1a1a; + --ac-text-muted: #6e6e6e; + --ac-text-subtle: #a8a29e; + --ac-border: #e7e5e4; + --ac-accent: #d97757; + --ac-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.08); + --ac-radius-card: 12px; + --ac-border-width: 1px; + } + + /* ======================================== + BLUEPRINT ARCHITECT + ======================================== */ + .agent-theme[data-agent-theme='blueprint-architect'] { + --ac-font-body: var(--ac-font-grotesk); + --ac-font-heading: var(--ac-font-grotesk); + --ac-font-code: var(--ac-font-mono); + + --ac-bg: #f7fbff; + --ac-bg-pattern: + linear-gradient(to right, rgba(37, 99, 235, 0.14) 1px, transparent 1px), + linear-gradient(to bottom, rgba(37, 99, 235, 0.14) 1px, transparent 1px); + --ac-bg-pattern-size: 24px 24px; + + --ac-header-bg: rgba(247, 251, 255, 0.86); + --ac-header-border: rgba(37, 99, 235, 0.25); + + --ac-surface: rgba(255, 255, 255, 0.92); + --ac-surface-muted: rgba(239, 246, 255, 0.9); + --ac-surface-inset: rgba(239, 246, 255, 0.9); + + --ac-text: #0b1220; + --ac-text-muted: #1f2a44; + --ac-text-subtle: #475569; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #64748b; + + --ac-border: rgba(37, 99, 235, 0.25); + --ac-border-strong: rgba(37, 99, 235, 0.45); + + --ac-hover-bg: rgba(37, 99, 235, 0.08); + --ac-hover-bg-subtle: rgba(37, 99, 235, 0.05); + + --ac-accent: #2563eb; + --ac-accent-hover: #1d4ed8; + --ac-accent-subtle: rgba(37, 99, 235, 0.12); + --ac-accent-contrast: #ffffff; + + --ac-accent-2: #0ea5e9; + --ac-link: var(--ac-accent); + --ac-link-hover: var(--ac-accent-hover); + + --ac-selection-bg: rgba(37, 99, 235, 0.16); + --ac-selection-text: #0b1220; + + --ac-shadow-card: 0 1px 3px rgba(2, 6, 23, 0.12); + --ac-shadow-float: 0 10px 28px -10px rgba(2, 6, 23, 0.22); + --ac-focus-ring: rgba(37, 99, 235, 0.4); + + --ac-timeline-line: rgba(37, 99, 235, 0.35); + --ac-timeline-node: rgba(37, 99, 235, 0.35); + --ac-timeline-node-hover: rgba(37, 99, 235, 0.55); + --ac-timeline-node-active: var(--ac-accent); + --ac-timeline-node-active-border: var(--ac-accent); + --ac-timeline-node-tool: rgba(37, 99, 235, 0.5); + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(37, 99, 235, 0.25), 0 0 12px rgba(37, 99, 235, 0.2); + + --ac-chip-bg: rgba(239, 246, 255, 0.9); + --ac-chip-text: #0b1220; + --ac-chip-border: rgba(37, 99, 235, 0.25); + + --ac-code-bg: rgba(255, 255, 255, 0.92); + --ac-code-text: #0b1220; + --ac-code-border: rgba(37, 99, 235, 0.25); + + --ac-diff-add-bg: rgba(34, 197, 94, 0.12); + --ac-diff-add-text: #15803d; + --ac-diff-add-border: rgba(34, 197, 94, 0.4); + --ac-diff-del-bg: rgba(239, 68, 68, 0.12); + --ac-diff-del-text: #b91c1c; + --ac-diff-del-border: rgba(239, 68, 68, 0.4); + + --ac-scrollbar-thumb: rgba(37, 99, 235, 0.2); + --ac-scrollbar-thumb-hover: rgba(37, 99, 235, 0.35); + } + + /* ======================================== + ZEN JOURNAL + ======================================== */ + .agent-theme[data-agent-theme='zen-journal'] { + --ac-font-body: var(--ac-font-serif); + --ac-font-heading: var(--ac-font-serif); + --ac-font-code: var(--ac-font-mono); + + --ac-bg: #fafaf9; + --ac-bg-pattern: linear-gradient(to bottom, rgba(120, 113, 108, 0.07) 1px, transparent 1px); + --ac-bg-pattern-size: 100% 28px; + + --ac-header-bg: rgba(250, 250, 249, 0.92); + --ac-header-border: rgba(231, 229, 228, 0.9); + + --ac-surface: rgba(255, 255, 255, 0.92); + --ac-surface-muted: rgba(245, 245, 244, 0.92); + --ac-surface-inset: rgba(245, 245, 244, 0.92); + + --ac-text: #1c1917; + --ac-text-muted: #44403c; + --ac-text-subtle: #78716c; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #a8a29e; + + --ac-border: #e7e5e4; + --ac-border-strong: #d6d3d1; + + --ac-hover-bg: rgba(120, 113, 108, 0.08); + --ac-hover-bg-subtle: rgba(120, 113, 108, 0.05); + + --ac-accent: #57534e; + --ac-accent-hover: #44403c; + --ac-accent-subtle: rgba(87, 83, 78, 0.12); + --ac-accent-contrast: #ffffff; + --ac-accent-2: var(--ac-accent); + + --ac-link: var(--ac-accent); + --ac-link-hover: var(--ac-accent-hover); + + --ac-selection-bg: rgba(87, 83, 78, 0.18); + --ac-selection-text: #1c1917; + + --ac-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.06); + --ac-shadow-float: 0 14px 34px -18px rgba(0, 0, 0, 0.18); + --ac-focus-ring: rgba(87, 83, 78, 0.35); + + --ac-timeline-line: #e7e5e4; + --ac-timeline-node: #d6d3d1; + --ac-timeline-node-hover: #a8a29e; + --ac-timeline-node-active: var(--ac-accent); + --ac-timeline-node-active-border: var(--ac-accent); + --ac-timeline-node-tool: #94a3b8; + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(87, 83, 78, 0.25), 0 0 12px rgba(87, 83, 78, 0.2); + + --ac-chip-bg: rgba(245, 245, 244, 0.92); + --ac-chip-text: #1c1917; + --ac-chip-border: #e7e5e4; + + --ac-code-bg: rgba(255, 255, 255, 0.92); + --ac-code-text: #1c1917; + --ac-code-border: #e7e5e4; + + --ac-diff-add-bg: rgba(34, 197, 94, 0.1); + --ac-diff-add-text: #15803d; + --ac-diff-add-border: rgba(34, 197, 94, 0.35); + --ac-diff-del-bg: rgba(239, 68, 68, 0.1); + --ac-diff-del-text: #b91c1c; + --ac-diff-del-border: rgba(239, 68, 68, 0.35); + + --ac-scrollbar-thumb: rgba(120, 113, 108, 0.15); + --ac-scrollbar-thumb-hover: rgba(120, 113, 108, 0.25); + } + + /* ======================================== + NEO POP + ======================================== */ + .agent-theme[data-agent-theme='neo-pop'] { + --ac-font-body: var(--ac-font-sans); + --ac-font-heading: var(--ac-font-grotesk); + --ac-font-code: var(--ac-font-mono); + + --ac-border-width: 4px; + --ac-border-width-strong: 4px; + --ac-radius-card: 0px; + --ac-radius-inner: 0px; + --ac-radius-button: 0px; + + --ac-bg: #fff7ed; + --ac-bg-pattern: radial-gradient(rgba(17, 24, 39, 0.12) 1px, transparent 1px); + --ac-bg-pattern-size: 18px 18px; + + --ac-header-bg: rgba(255, 247, 237, 0.92); + --ac-header-border: #111827; + + --ac-surface: #ffffff; + --ac-surface-muted: #ffedd5; + --ac-surface-inset: #ffffff; + + --ac-text: #111827; + --ac-text-muted: #374151; + --ac-text-subtle: #6b7280; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #9ca3af; + + --ac-border: #111827; + --ac-border-strong: #111827; + + --ac-hover-bg: rgba(17, 24, 39, 0.06); + --ac-hover-bg-subtle: rgba(17, 24, 39, 0.04); + + --ac-accent: #ff3d7f; + --ac-accent-hover: #ff1f6a; + --ac-accent-subtle: rgba(255, 61, 127, 0.14); + --ac-accent-contrast: #ffffff; + + --ac-accent-2: #22d3ee; + --ac-link: var(--ac-accent-2); + --ac-link-hover: #06b6d4; + + --ac-selection-bg: rgba(255, 61, 127, 0.25); + --ac-selection-text: #111827; + + --ac-shadow-card: 6px 6px 0 0 var(--ac-border); + --ac-shadow-float: 8px 8px 0 0 var(--ac-border); + --ac-focus-ring: rgba(17, 24, 39, 0.35); + + --ac-timeline-line-width: 4px; + --ac-timeline-line: #111827; + --ac-timeline-node: #111827; + --ac-timeline-node-hover: #374151; + --ac-timeline-node-active: var(--ac-accent); + --ac-timeline-node-active-border: #111827; + --ac-timeline-node-tool: #6b7280; + --ac-timeline-node-pulse-shadow: 0 0 0 2px rgba(17, 24, 39, 1); + + --ac-chip-bg: #ffffff; + --ac-chip-text: #111827; + --ac-chip-border: #111827; + + --ac-code-bg: #ffffff; + --ac-code-text: #111827; + --ac-code-border: #111827; + + --ac-diff-add-bg: rgba(34, 197, 94, 0.18); + --ac-diff-add-text: #15803d; + --ac-diff-add-border: #111827; + --ac-diff-del-bg: rgba(239, 68, 68, 0.18); + --ac-diff-del-text: #b91c1c; + --ac-diff-del-border: #111827; + + --ac-scrollbar-thumb: rgba(17, 24, 39, 0.25); + --ac-scrollbar-thumb-hover: rgba(17, 24, 39, 0.4); + } + + /* ======================================== + DARK CONSOLE + ======================================== */ + .agent-theme[data-agent-theme='dark-console'] { + --ac-font-body: var(--ac-font-mono); + --ac-font-heading: var(--ac-font-mono); + --ac-font-code: var(--ac-font-mono); + + --ac-bg: #0f1117; + --ac-bg-pattern: none; + --ac-bg-pattern-size: 16px 16px; + + --ac-header-bg: #0f1117; + --ac-header-border: #1f2937; + + --ac-surface: #0f1117; + --ac-surface-muted: #0a0c10; + --ac-surface-inset: #1a1d26; + + --ac-text: #e5e7eb; + --ac-text-muted: #9ca3af; + --ac-text-subtle: #6b7280; + --ac-text-inverse: #0a0c10; + --ac-text-placeholder: #4b5563; + + --ac-border: #1f2937; + --ac-border-strong: #374151; + + --ac-hover-bg: rgba(255, 255, 255, 0.06); + --ac-hover-bg-subtle: rgba(255, 255, 255, 0.04); + + --ac-accent: #c084fc; + --ac-accent-hover: #d8b4fe; + --ac-accent-subtle: rgba(192, 132, 252, 0.14); + --ac-accent-contrast: #0a0c10; + + --ac-accent-2: #60a5fa; + --ac-link: var(--ac-accent-2); + --ac-link-hover: #93c5fd; + + --ac-selection-bg: rgba(192, 132, 252, 0.25); + --ac-selection-text: #ffffff; + + --ac-shadow-card: none; + --ac-shadow-float: none; + --ac-focus-ring: rgba(192, 132, 252, 0.35); + + --ac-timeline-line-width: 2px; + --ac-timeline-line: #1f2937; + --ac-timeline-node: #374151; + --ac-timeline-node-hover: #6b7280; + --ac-timeline-node-active: var(--ac-accent); + --ac-timeline-node-active-border: var(--ac-accent); + --ac-timeline-node-tool: #64748b; + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(192, 132, 252, 0.35), 0 0 14px rgba(192, 132, 252, 0.25); + + --ac-chip-bg: rgba(255, 255, 255, 0.06); + --ac-chip-text: #e5e7eb; + --ac-chip-border: rgba(255, 255, 255, 0.1); + + --ac-code-bg: #0a0c10; + --ac-code-text: #e5e7eb; + --ac-code-border: #1f2937; + + --ac-diff-add-bg: rgba(74, 222, 128, 0.1); + --ac-diff-add-text: #4ade80; + --ac-diff-add-border: rgba(74, 222, 128, 0.35); + + --ac-diff-del-bg: rgba(248, 113, 113, 0.1); + --ac-diff-del-text: #f87171; + --ac-diff-del-border: rgba(248, 113, 113, 0.35); + + --ac-scrollbar-thumb: rgba(255, 255, 255, 0.12); + --ac-scrollbar-thumb-hover: rgba(255, 255, 255, 0.22); + } + + /* ======================================== + SWISS GRID + ======================================== */ + .agent-theme[data-agent-theme='swiss-grid'] { + --ac-font-body: var(--ac-font-grotesk); + --ac-font-heading: var(--ac-font-grotesk); + --ac-font-code: var(--ac-font-mono); + + --ac-bg: #ffffff; + --ac-bg-pattern: radial-gradient(#e5e7eb 1px, transparent 1px); + --ac-bg-pattern-size: 16px 16px; + + --ac-header-bg: #ffffff; + --ac-header-border: #000000; + + --ac-surface: #ffffff; + --ac-surface-muted: #f3f4f6; + --ac-surface-inset: #ffffff; + + --ac-text: #000000; + --ac-text-muted: #374151; + --ac-text-subtle: #6b7280; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #9ca3af; + + --ac-border: #000000; + --ac-border-strong: #000000; + + --ac-hover-bg: #f3f4f6; + --ac-hover-bg-subtle: #f9fafb; + + --ac-accent: #000000; + --ac-accent-hover: #111827; + --ac-accent-subtle: rgba(0, 0, 0, 0.06); + --ac-accent-contrast: #ffffff; + --ac-accent-2: #000000; + + --ac-link: #000000; + --ac-link-hover: #111827; + + --ac-selection-bg: #000000; + --ac-selection-text: #ffffff; + + --ac-border-width: 2px; + --ac-border-width-strong: 2px; + --ac-radius-card: 0px; + --ac-radius-inner: 0px; + --ac-radius-button: 0px; + + --ac-shadow-card: 4px 4px 0 0 rgba(0, 0, 0, 1); + --ac-shadow-float: 4px 4px 0 0 rgba(0, 0, 0, 1); + --ac-focus-ring: rgba(0, 0, 0, 0.5); + + --ac-timeline-line-width: 2px; + --ac-timeline-line: #000000; + --ac-timeline-node: #000000; + --ac-timeline-node-hover: #111827; + --ac-timeline-node-active: #000000; + --ac-timeline-node-active-border: #000000; + --ac-timeline-node-tool: #4b5563; + --ac-timeline-node-pulse-shadow: 0 0 0 2px rgba(0, 0, 0, 1); + + --ac-chip-bg: #ffffff; + --ac-chip-text: #000000; + --ac-chip-border: #000000; + + --ac-code-bg: #ffffff; + --ac-code-text: #000000; + --ac-code-border: #000000; + + --ac-diff-add-bg: #000000; + --ac-diff-add-text: #ffffff; + --ac-diff-add-border: #000000; + + --ac-diff-del-bg: #f3f4f6; + --ac-diff-del-text: #6b7280; + --ac-diff-del-border: #000000; + + --ac-scrollbar-thumb: rgba(0, 0, 0, 0.25); + --ac-scrollbar-thumb-hover: rgba(0, 0, 0, 0.4); + } + + /* ======================================== + Base Styles (apply to .agent-theme) + ======================================== */ + .agent-theme { + color: var(--ac-text); + background: var(--ac-bg); + background-image: var(--ac-bg-pattern); + background-size: var(--ac-bg-pattern-size); + font-family: var(--ac-font-body); + } + + .agent-theme ::selection { + background: var(--ac-selection-bg); + color: var(--ac-selection-text); + } + + /* ======================================== + Scrollbar Styles + ======================================== */ + .agent-theme .ac-scroll { + scrollbar-width: thin; + scrollbar-color: var(--ac-scrollbar-thumb) transparent; + } + + .agent-theme .ac-scroll::-webkit-scrollbar { + width: var(--ac-scrollbar-size); + height: var(--ac-scrollbar-size); + } + + .agent-theme .ac-scroll::-webkit-scrollbar-track { + background: transparent; + } + + .agent-theme .ac-scroll::-webkit-scrollbar-thumb { + background-color: var(--ac-scrollbar-thumb); + border-radius: 999px; + } + + .agent-theme .ac-scroll::-webkit-scrollbar-thumb:hover { + background-color: var(--ac-scrollbar-thumb-hover); + } + + /* Hide scrollbar but keep functionality */ + .agent-theme .ac-scroll-hidden { + scrollbar-width: none; + -ms-overflow-style: none; + } + + .agent-theme .ac-scroll-hidden::-webkit-scrollbar { + display: none; + } + + /* ======================================== + Utility Classes + ======================================== */ + + /* Focus ring */ + .agent-theme .ac-focus-ring:focus-visible { + outline: none; + box-shadow: 0 0 0 2px var(--ac-focus-ring); + } + + /* Hover utilities */ + .agent-theme .ac-hover-bg:hover { + background-color: var(--ac-hover-bg); + } + + .agent-theme .ac-hover-text:hover { + color: var(--ac-text); + } + + .agent-theme .ac-hover-link:hover { + color: var(--ac-link); + } + + .agent-theme .ac-hover-accent:hover { + color: var(--ac-accent); + } + + /* Button/interactive element base */ + .agent-theme .ac-btn { + cursor: pointer; + transition: + background-color var(--ac-motion-fast), + color var(--ac-motion-fast); + } + + .agent-theme .ac-btn:hover { + background-color: var(--ac-hover-bg); + } + + /* Menu item */ + .agent-theme .ac-menu-item { + cursor: pointer; + transition: background-color var(--ac-motion-fast); + } + + .agent-theme .ac-menu-item:hover { + background-color: var(--ac-hover-bg); + } + + /* Chip/pill hover */ + .agent-theme .ac-chip-hover:hover { + color: var(--ac-link); + } + + /* Pulse animation for streaming indicator */ + @keyframes ac-pulse { + 0%, + 100% { + opacity: 1; + } + 50% { + opacity: 0.5; + } + } + + .agent-theme .ac-pulse { + animation: ac-pulse 1.5s cubic-bezier(0.4, 0, 0.6, 1) infinite; + } + + /* Respect reduced motion preference */ + @media (prefers-reduced-motion: reduce) { + .agent-theme .ac-pulse { + animation: none; + } + } + + /* ============================================================ + Loading Animation - Shimmer Text & Scribble Icon + ============================================================ */ + + /* 文案 shimmer 渐变动画 - 光从左到右扫过效果 */ + .agent-theme .text-shimmer { + display: inline-block; + background: linear-gradient( + 90deg, + var(--ac-accent, #d97757) 0%, + var(--ac-accent, #d97757) 40%, + #ffe0d0 50%, + var(--ac-accent, #d97757) 60%, + var(--ac-accent, #d97757) 100% + ); + background-size: 250% 100%; + background-repeat: no-repeat; + color: transparent; + -webkit-background-clip: text; + background-clip: text; + -webkit-text-fill-color: transparent; + animation: ac-shimmer 1.8s ease-in-out infinite; + } + + @keyframes ac-shimmer { + 0% { + background-position: 100% 50%; + } + 100% { + background-position: 0% 50%; + } + } + + /* 螺旋图标 - 笔迹重绘动画 */ + .agent-theme .loading-scribble path { + stroke-dasharray: 300; + stroke-dashoffset: 300; + animation: ac-scribble-draw 2s ease-in-out infinite; + } + + .agent-theme .loading-scribble { + animation: ac-slight-rotate 8s linear infinite; + } + + @keyframes ac-scribble-draw { + 0% { + stroke-dashoffset: 300; + } + 50% { + stroke-dashoffset: 0; + } + 100% { + stroke-dashoffset: -300; + } + } + + @keyframes ac-slight-rotate { + 0% { + transform: rotate(0deg); + } + 100% { + transform: rotate(360deg); + } + } + + /* Respect reduced motion preference for loading animations */ + @media (prefers-reduced-motion: reduce) { + .agent-theme .text-shimmer { + animation: none; + background: none; + color: var(--ac-accent); + } + + .agent-theme .loading-scribble, + .agent-theme .loading-scribble path { + animation: none; + } + + .agent-theme .loading-scribble path { + stroke-dashoffset: 0; + } + } + + /* ============================================================ + Tooltip System - CSS-only tooltips using data-tooltip attribute + ============================================================ */ + .agent-theme [data-tooltip] { + position: relative; + } + + .agent-theme [data-tooltip]::after { + content: attr(data-tooltip); + position: absolute; + bottom: calc(100% + 6px); + left: 50%; + transform: translateX(-50%); + padding: 4px 8px; + font-size: 11px; + font-family: var(--ac-font-sans); + font-weight: 400; + line-height: 1.3; + white-space: nowrap; + color: var(--ac-text-inverse); + background-color: var(--ac-text); + border-radius: var(--ac-radius-button); + opacity: 0; + visibility: hidden; + transition: + opacity 150ms ease, + visibility 150ms ease; + pointer-events: none; + z-index: 99999; + } + + .agent-theme [data-tooltip]:hover::after { + opacity: 1; + visibility: visible; + } + + /* Tooltip arrow */ + .agent-theme [data-tooltip]::before { + content: ''; + position: absolute; + bottom: calc(100% + 2px); + left: 50%; + transform: translateX(-50%); + border: 4px solid transparent; + border-top-color: var(--ac-text); + opacity: 0; + visibility: hidden; + transition: + opacity 150ms ease, + visibility 150ms ease; + pointer-events: none; + z-index: 99999; + } + + .agent-theme [data-tooltip]:hover::before { + opacity: 1; + visibility: visible; + } +} diff --git a/app/chrome-extension/entrypoints/sidepanel/utils/loading-texts.ts b/app/chrome-extension/entrypoints/sidepanel/utils/loading-texts.ts new file mode 100644 index 00000000..4b6c0d27 --- /dev/null +++ b/app/chrome-extension/entrypoints/sidepanel/utils/loading-texts.ts @@ -0,0 +1,60 @@ +/** + * 随机 Loading 文案 + * 用于 TimelineStatusStep 组件展示趣味等待提示 + */ + +const loadingTexts = [ + // 必选神梗 + '本来应该从从容容游刃有余', + '现在是匆匆忙忙连滚带爬', + '我知道你很急，但是先别急', + '在知识的海洋里狗刨', + '让子弹再飞一会儿', + '正在为您手搓答案', + '浪浪山小妖怪集结中', + '别催，已经在写了（新建文件夹）', + '正在汗流浃背地思考中', + 'CPU 都要给我干烧了', + // 生活气息 + '村咖慢焙，精华需要时间', + '知识煎饼翻面中', + '敬自己一杯，马上好', + '正在把灵感放入烤箱', + '让答案再泡一会儿', + '情绪价值拉满中', + '正在为您编织语言的毛衣', + // 脑洞大开 + '神经元蹦迪中', + '熬夜的猫头鹰在思考', + '给答案上色中', + '正在疯狂翻阅知识库', + '大脑马戏团开演', + '正在把 0 和 1 捏在一起', + '正在憋个大招', + '放大镜有点起雾，擦擦', + '试图理解这个离谱的需求', + // 玄幻 + '正在施法，莫打扰', + '唤醒硅基朋友', + '正在连接赛博空间的智慧', + '道友请留步，正在推演', + '穿越知识黑洞', + '正在反向解析人类意图', + '水晶球有点模糊，拍两下', + // 职场 + '代码跑得比记者还快', + '主理人已上线，请稍候', + '快马加鞭赶来中', + '正在光速搬运知识', + '拼图最后一块', + '答案即将杀青', + '发射倒计时', + '目标锁定中', +]; + +/** + * 获取随机 Loading 文案 + */ +export function getRandomLoadingText(): string { + return loadingTexts[Math.floor(Math.random() * loadingTexts.length)]; +} diff --git a/app/chrome-extension/entrypoints/styles/tailwind.css b/app/chrome-extension/entrypoints/styles/tailwind.css new file mode 100644 index 00000000..7ddba5cb --- /dev/null +++ b/app/chrome-extension/entrypoints/styles/tailwind.css @@ -0,0 +1,151 @@ +@import 'tailwindcss'; + +/* App background and card helpers */ +@layer base { + html, + body, + #app { + height: 100%; + } + body { + @apply bg-slate-50 text-slate-800; + } + + /* Record&Replay builder design tokens */ + .rr-theme { + --rr-bg: #f8fafc; + --rr-topbar: rgba(255, 255, 255, 0.9); + --rr-card: #ffffff; + --rr-elevated: #ffffff; + --rr-border: #e5e7eb; + --rr-subtle: #f3f4f6; + --rr-text: #0f172a; + --rr-text-weak: #475569; + --rr-muted: #64748b; + --rr-brand: #7c3aed; + --rr-brand-strong: #5b21b6; + --rr-accent: #0ea5e9; + --rr-success: #10b981; + --rr-warn: #f59e0b; + --rr-danger: #ef4444; + --rr-dot: rgba(2, 6, 23, 0.08); + } + .rr-theme[data-theme='dark'] { + --rr-bg: #0b1020; + --rr-topbar: rgba(12, 15, 24, 0.8); + --rr-card: #0f1528; + --rr-elevated: #121a33; + --rr-border: rgba(255, 255, 255, 0.08); + --rr-subtle: rgba(255, 255, 255, 0.04); + --rr-text: #e5e7eb; + --rr-text-weak: #cbd5e1; + --rr-muted: #94a3b8; + --rr-brand: #a78bfa; + --rr-brand-strong: #7c3aed; + --rr-accent: #38bdf8; + --rr-success: #34d399; + --rr-warn: #fbbf24; + --rr-danger: #f87171; + --rr-dot: rgba(226, 232, 240, 0.08); + } +} + +@layer components { + .card { + @apply rounded-xl shadow-md border; + background: var(--rr-card); + border-color: var(--rr-border); + } + /* Generic buttons used across builder */ + .btn { + @apply inline-flex items-center justify-center rounded-lg px-3 py-2 text-sm font-medium transition; + background: var(--rr-card); + color: var(--rr-text); + border: 1px solid var(--rr-border); + } + .btn:hover { + @apply shadow-sm; + background: var(--rr-subtle); + } + .btn[disabled] { + @apply opacity-60 cursor-not-allowed; + } + .btn.primary { + color: #fff; + background: var(--rr-brand-strong); + border-color: var(--rr-brand-strong); + } + .btn.primary:hover { + filter: brightness(1.05); + } + .btn.ghost { + background: transparent; + border-color: transparent; + } + + .mini { + @apply inline-flex items-center justify-center rounded-md px-2 py-1 text-xs font-medium; + background: var(--rr-card); + color: var(--rr-text); + border: 1px solid var(--rr-border); + } + .mini:hover { + background: var(--rr-subtle); + } + .mini.danger { + background: color-mix(in oklab, var(--rr-danger) 8%, transparent); + border-color: color-mix(in oklab, var(--rr-danger) 24%, var(--rr-border)); + color: var(--rr-text); + } + + .input { + @apply w-full px-3 py-2 rounded-lg text-sm; + background: var(--rr-card); + color: var(--rr-text); + border: 1px solid var(--rr-border); + outline: none; + } + .input:focus { + box-shadow: 0 0 0 3px color-mix(in oklab, var(--rr-brand) 26%, transparent); + border-color: var(--rr-brand); + } + .select { + @apply w-full px-3 py-2 rounded-lg text-sm; + background: var(--rr-card); + color: var(--rr-text); + border: 1px solid var(--rr-border); + outline: none; + } + .textarea { + @apply w-full rounded-lg text-sm; + padding: 10px 12px; + background: var(--rr-card); + color: var(--rr-text); + border: 1px solid var(--rr-border); + outline: none; + } + .label { + @apply text-sm; + color: var(--rr-muted); + } + .badge { + @apply inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium; + } + .badge-purple { + background: color-mix(in oklab, var(--rr-brand) 14%, transparent); + color: var(--rr-brand); + } + + /* Builder topbar */ + .rr-topbar { + height: 56px; + border-bottom: 1px solid var(--rr-border); + background: var(--rr-topbar); + } + + /* Dot grid background utility for canvas container */ + .rr-dot-grid { + background-image: radial-gradient(var(--rr-dot) 1px, transparent 1px); + background-size: 20px 20px; + } +} diff --git a/app/chrome-extension/entrypoints/web-editor-v2.ts b/app/chrome-extension/entrypoints/web-editor-v2.ts new file mode 100644 index 00000000..4d1757d1 --- /dev/null +++ b/app/chrome-extension/entrypoints/web-editor-v2.ts @@ -0,0 +1,47 @@ +/** + * Web Editor V2 - Inject Script Entry Point + * + * This is the main entry point for the visual editor, injected into web pages + * via chrome.scripting.executeScript from the background script. + * + * Architecture: + * - Uses WXT's defineUnlistedScript for TypeScript compilation + * - Exposes API on window.__MCP_WEB_EDITOR_V2__ + * - Communicates with background via chrome.runtime.onMessage + * + * Module structure: + * - web-editor-v2/constants.ts - Configuration values + * - web-editor-v2/utils/disposables.ts - Resource cleanup + * - web-editor-v2/ui/shadow-host.ts - Shadow DOM isolation + * - web-editor-v2/core/editor.ts - Main orchestrator + * - web-editor-v2/core/message-listener.ts - Background communication + * + * Build output: .output/chrome-mv3/web-editor-v2.js + */ + +import { WEB_EDITOR_V2_LOG_PREFIX } from './web-editor-v2/constants'; +import { createWebEditorV2 } from './web-editor-v2/core/editor'; +import { installMessageListener } from './web-editor-v2/core/message-listener'; + +export default defineUnlistedScript(() => { + // Phase 1: Only support top frame + // Phase 4 will add iframe support via content injection + if (window !== window.top) { + return; + } + + // Singleton guard: prevent multiple instances + if (window.__MCP_WEB_EDITOR_V2__) { + console.log(`${WEB_EDITOR_V2_LOG_PREFIX} Already installed, skipping initialization`); + return; + } + + // Create and expose the API + const api = createWebEditorV2(); + window.__MCP_WEB_EDITOR_V2__ = api; + + // Install message listener for background communication + installMessageListener(api); + + console.log(`${WEB_EDITOR_V2_LOG_PREFIX} Installed successfully`); +}); diff --git a/app/chrome-extension/entrypoints/web-editor-v2/attr-ui-refactor.md b/app/chrome-extension/entrypoints/web-editor-v2/attr-ui-refactor.md new file mode 100644 index 00000000..6f7a79af --- /dev/null +++ b/app/chrome-extension/entrypoints/web-editor-v2/attr-ui-refactor.md @@ -0,0 +1,383 @@ +# Property Panel UI 重构计划 + +## 背景 + +当前属性面板的 UI 实现与设计稿 `attr-ui.html` 存在较大差异。本文档详细规划了重构任务，按照优先级从高到低排列，目标是让属性面板的视觉效果和交互体验与设计稿一致。 + +### 参考文件 + +- **设计稿**：`/attr-ui.html` +- **当前样式**：`ui/shadow-host.ts` +- **面板结构**：`ui/property-panel/property-panel.ts` +- **控件组件**：`ui/property-panel/controls/*.ts` + +--- + +## 前置任务（已完成） + +### 0.1 最小化 Bug 修复 ✅ + +**问题**：toolbar 和属性面板最小化时，只是背景消失了，里面的内容实际上还在 + +**根因**：CSS 中 `display: flex/inline-flex` 覆盖了 `[hidden]` 属性的默认 `display: none` + +**解决方案**： + +- [x] 在 `shadow-host.ts` 末尾添加全局 `[hidden] { display: none !important; }` 规则 + +### 0.2 输入框优化 ✅ + +**问题**： + +1. 输入框显示 placeholder 而非真实值 +2. Number 类型输入框不支持键盘上下键调整 + +**解决方案**： + +- [x] 创建 `ui/property-panel/controls/number-stepping.ts` 工具模块 + - 支持 ArrowUp/ArrowDown 键盘步进 + - 支持 Shift (10x)、Alt (0.1x) 修饰键 + - 支持多种 CSS 单位 (px, %, rem, em, vh, vw, vmin, vmax) +- [x] 修改所有 control 显示真实值（inline 优先，fallback 到 computed） +- [x] 为所有数值输入框添加 keyboard stepping 支持： + - `size-control.ts` - Width/Height + - `spacing-control.ts` - Margin/Padding + - `position-control.ts` - Top/Right/Bottom/Left/Z-Index + - `layout-control.ts` - Gap + - `typography-control.ts` - Font Size/Line Height + - `appearance-control.ts` - Opacity/Border Radius/Border Width + +--- + +## 阶段一：基础视觉系统对齐 ✅ 已完成 + +### 1.1 颜色方案重构 ✅ + +**目标**：将颜色系统从当前的灰色调整为设计稿的白底+灰输入框风格 + +| 属性 | 旧值 | 新值 | 状态 | +| ------------ | ----------------- | --------------------------------- | ---- | +| 面板背景 | `#f8f8f8` | `#ffffff` | ✅ | +| 输入框背景 | `#f0f0f0` | `#f3f3f3` | ✅ | +| 输入框 hover | `#e8e8e8` (bg) | `border #e0e0e0` (inset) | ✅ | +| 输入框 focus | `box-shadow` 外圈 | `inset 2px border #3b82f6` + 白底 | ✅ | +| 边框色 | `#e8e8e8` | `#e5e5e5` | ✅ | + +**完成的任务**： + +- [x] 更新 CSS 变量定义 (`shadow-host.ts:56-97`) +- [x] 修改输入框 hover/focus 样式为 inset border 模式 +- [x] 面板背景改为纯白 + +### 1.2 字体与字号调整 ✅ + +| 属性 | 旧值 | 新值 | 状态 | +| ------------ | -------- | ------------------------- | ---- | +| 面板基础字号 | `13px` | `11px` | ✅ | +| 标签字号 | `11px` | `10px` | ✅ | +| 输入框字号 | `12px` | `11px` | ✅ | +| 字体家族 | 系统字体 | Inter + 系统字体 fallback | ✅ | + +**完成的任务**： + +- [x] 添加 Inter 字体声明（使用系统字体 fallback） +- [x] 调整面板、标签、输入框的字号 +- [x] 移除标签的大写样式 + +### 1.3 间距与边距调整 ✅ + +| 属性 | 旧值 | 新值 | 状态 | +| ------------- | ----------- | ---------- | ---- | +| 面板宽度 | `320px` | `280px` | ✅ | +| Header 内边距 | `10px 14px` | `8px 12px` | ✅ | +| Body gap | `10px` | `12px` | ✅ | + +**完成的任务**： + +- [x] 调整 `.we-panel`, `.we-prop-body`, `.we-field-group` 的 padding/gap +- [x] 调整 header 的 padding + +### 1.4 圆角与阴影 ✅ + +| 属性 | 旧值 | 新值 | 状态 | +| ---------- | ----------- | ------------------ | ---- | +| 面板阴影 | `0 1px 2px` | Tailwind shadow-xl | ✅ | +| 输入框圆角 | `6px` | `4px` | ✅ | +| Tab 阴影 | 无 | `shadow-sm` | ✅ | + +**完成的任务**： + +- [x] 增强面板阴影效果（双层阴影模拟 shadow-xl） +- [x] 调整输入框圆角为 4px +- [x] 为激活的 Tab 添加阴影 + +### 1.5 Group/Section 样式重构 ✅ + +| 属性 | 旧样式 | 新样式 | 状态 | +| ------------ | ----------- | ----------- | ---- | +| Group 边框 | 卡片边框 | 无边框 | ✅ | +| Section 分隔 | 无 | 顶部分隔线 | ✅ | +| Header 样式 | 粗体 + 大字 | 11px + #333 | ✅ | + +**完成的任务**： + +- [x] 移除 `.we-group` 的边框和背景 +- [x] 添加 Section 间的分隔线 (`border-top`) +- [x] 调整 Group header 样式 + +--- + +## 阶段二：输入容器组件重构 ✅ 基础完成 + +### 2.1 建立输入容器系统 ✅ + +**背景**：设计稿的输入框不是单体 input，而是一个容器系统，支持： + +- 前缀（prefix）：标签、图标 +- 后缀（suffix）：单位、图标 +- 容器驱动的 hover/focus 样式 + +**当前结构**： + +```html +
+ Width + +
+``` + +**目标结构**： + +```html +
+ Position +
+ + X + + + px + +
+
+``` + +**已完成**： + +- [x] 在 `shadow-host.ts` 中定义 `.we-input-container` 样式 +- [x] 定义 `.we-input-container__prefix` 和 `.we-input-container__suffix` 样式 +- [x] 创建 `ui/property-panel/components/input-container.ts` 组件 +- [x] 将 hover/focus 样式移到容器级别（使用 `:focus-within`） + +### 2.2 更新各 Control 使用新容器 ✅ 已完成 + +**需要更新的控件**： + +- [x] `size-control.ts` - Width/Height（2列布局 + W/H 前缀 + 动态单位后缀） +- [x] `spacing-control.ts` - Margin/Padding（重构为 2x2 网格 + 方向图标 + 动态单位后缀） +- [x] `position-control.ts` - Top/Right/Bottom/Left/Z-Index（T/R/B/L 前缀 + 动态单位后缀） +- [x] `layout-control.ts` - Gap（图标前缀 + 动态单位后缀） +- [x] `typography-control.ts` - Font Size/Line Height（动态单位后缀，line-height 智能显示） +- [ ] `appearance-control.ts` - Opacity/Border Radius/Border Width（待实施） + +**已完成的共享模块**： + +- [x] 创建 `css-helpers.ts` 共享模块（extractUnitSuffix, hasExplicitUnit, normalizeLength） +- [x] 所有控件使用共享 helper，消除重复代码 + +--- + +## 阶段三：Section 结构重构（待实施） + +### 3.1 Tab 信息架构调整 + +**当前**：4 个 Tab（Design/CSS/Props/DOM） +**设计稿**：2 个 Tab（Design/CSS） + +**方案选择**： + +- **方案 A**：保留 4 个 Tab，调整为溢出菜单 +- **方案 B**：将 Props/DOM 移到其他入口 +- **方案 C**：保持 4 个 Tab，调整样式适应 + +**任务**： + +- [ ] 确定 Tab 数量的产品决策 +- [ ] 实现选定方案 + +--- + +## 阶段四：功能组件实现（待实施） + +### 4.1 Flow 布局图标组 ✅ 已完成 + +**设计稿位置**：`attr-ui.html:133-156` +**功能**：4 个图标按钮控制 `flex-direction` + +``` +[→] Row +[↓] Column +[←] Row Reverse +[↑] Column Reverse +``` + +**已完成**： + +- [x] 创建 `ui/property-panel/components/icon-button-group.ts` 通用组件 +- [x] 在 `shadow-host.ts` 中添加 `.we-icon-button-group` 样式 +- [x] 在 `layout-control.ts` 中用图标组替换 Direction select +- [x] 添加对应的 SVG 箭头图标（row/column/row-reverse/column-reverse） + +### 4.2 Alignment 九宫格 ✅ 已完成 + +**设计稿位置**：`attr-ui.html:166-208` +**功能**：3x3 网格控制 `justify-content` + `align-items` + +``` +[↖][↑][↗] +[←][·][→] +[↙][↓][↘] +``` + +**已完成**： + +- [x] 创建 `ui/property-panel/components/alignment-grid.ts` 组件 +- [x] 在 `shadow-host.ts` 中添加 `.we-alignment-grid` 样式 +- [x] 替换 `layout-control.ts` 中的 Justify/Align select +- [x] 使用 `beginMultiStyle` 实现两个属性的原子提交 + +### 4.3 修复 Color Picker ✅ 部分完成 + +**当前问题**： + +- `showPicker()` 无 try/catch，可能抛错 +- alpha 通道被丢弃 +- token 值 `var(--xxx)` 显示不正确 + +**已完成**： + +- [x] 添加 `showPicker()` 的错误处理（try/catch + fallback to click） +- [x] 改进 `var()` 值的解析和显示（通过 placeholder 传入 computed value） + +**待实施**： + +- [ ] 支持 alpha 通道（RGBA/HSLA）- 需要引入第三方 color picker +- [ ] 考虑引入第三方 color picker（如 `@simonwep/pickr`） + +--- + +## 阶段五：新功能模块（待实施） + +### 5.1 Shadow & Blur 控制 + +**设计稿位置**：`attr-ui.html:396-425` +**功能**： + +- 启用/禁用开关 +- 类型选择（Drop shadow/Inner shadow/Layer Blur/Backdrop Blur） +- 可见性控制 + +**CSS 属性**： + +- `box-shadow` +- `filter: blur()` +- `backdrop-filter: blur()` + +**任务**： + +- [x] 创建 `ui/property-panel/controls/effects-control.ts` +- [x] 实现 `box-shadow` 值解析和编辑 +- [x] 实现 `filter` 值解析和编辑 +- [x] 实现 `backdrop-filter` 值解析和编辑 +- [x] 添加类型切换 UI +- [ ] 添加启用/禁用开关（可选，后续实现） + +### 5.2 渐变编辑器 + +**设计稿位置**：`attr-ui.html:269-325` +**功能**： + +- Linear/Radial 渐变类型 +- 颜色停止点（color stops） +- 角度控制 +- 翻转按钮 + +**CSS 属性**： + +- `background-image: linear-gradient(...)` +- `background-image: radial-gradient(...)` + +**任务**： + +- [x] 创建 `ui/property-panel/controls/gradient-control.ts` +- [x] 实现渐变值解析（CSS gradient → 数据结构） +- [x] 实现角度/位置输入 +- [x] 实现 2 个颜色停止点的编辑 +- [x] 集成到 property-panel（作为独立的 Gradient 控制组） +- [ ] 实现渐变预览 slider（可选，后续优化） +- [ ] 实现 color stop 添加/删除/拖拽（可选，后续优化） + +### 5.3 Token/变量 Pill 显示 + +**设计稿位置**：`attr-ui.html:374-384` +**功能**：当值为 CSS 变量时，显示为可点击的 pill + +**任务**： + +- [ ] 检测 `var(--xxx)` 值 +- [ ] 渲染为 pill 样式 +- [ ] 点击打开 token picker + +--- + +## 阶段六：代码质量（贯穿始终） + +### 6.1 样式系统统一 + +- [x] 所有颜色使用 CSS 变量（阶段一完成） +- [ ] 所有尺寸使用一致的 token +- [ ] 移除 inline style，统一到 `shadow-host.ts` + +### 6.2 组件复用 + +- [ ] 提取通用组件到 `ui/property-panel/components/` +- [ ] 统一事件处理模式 +- [ ] 统一 disabled/enabled 状态处理 + +### 6.3 类型安全 + +- [ ] 所有组件使用 TypeScript 严格类型 +- [ ] 定义清晰的接口和类型 +- [ ] 移除 any 类型断言 + +--- + +## 实施进度 + +| 阶段 | 任务 | 状态 | 备注 | +| ---- | ------------------ | ------- | -------------------------------------------- | +| 0.1 | 最小化 Bug 修复 | ✅ | 添加全局 `[hidden]` 规则 | +| 0.2 | 输入框优化 | ✅ | number-stepping + 真实值显示 | +| 1.1 | 颜色方案重构 | ✅ | 白底 + 灰输入框 + inset focus | +| 1.2 | 字体与字号调整 | ✅ | 11px 基准 + Inter 字体 | +| 1.3 | 间距与边距调整 | ✅ | 更紧凑的布局 | +| 1.4 | 圆角与阴影 | ✅ | shadow-xl + 4px 圆角 | +| 1.5 | Group/Section 样式 | ✅ | 分隔线风格 | +| 2.1 | 输入容器系统 | ✅ | 组件 + CSS 样式 | +| 2.2 | 更新 Controls | ✅ | 所有主要控件已迁移，共享 css-helpers.ts | +| 3.1 | Tab 信息架构 | 待实施 | | +| 4.1 | Flow 图标组 | ✅ | icon-button-group.ts + 集成到 layout-control | +| 4.2 | Alignment 九宫格 | ✅ | alignment-grid.ts + 集成到 layout-control | +| 4.3 | 修复 Color Picker | ✅ 部分 | showPicker 异常处理 + var() 解析 | +| 5.1 | Shadow & Blur | ✅ | effects-control.ts + 集成到 property-panel | +| 5.2 | 渐变编辑器 | ✅ | gradient-control.ts + 集成到 property-panel | +| 5.3 | Token Pill | 待实施 | | + +--- + +## 注意事项 + +1. **渐进式实施**：每个 Phase 完成后应可独立测试和发布 +2. **保持向后兼容**：重构过程中不应破坏现有功能 +3. **设计决策记录**：遇到设计稿与实际需求冲突时，记录决策原因 +4. **性能考虑**：新增组件需考虑渲染性能，避免不必要的 DOM 操作 diff --git a/app/chrome-extension/entrypoints/web-editor-v2/constants.ts b/app/chrome-extension/entrypoints/web-editor-v2/constants.ts new file mode 100644 index 00000000..ea9b86e9 --- /dev/null +++ b/app/chrome-extension/entrypoints/web-editor-v2/constants.ts @@ -0,0 +1,124 @@ +/** + * Web Editor V2 Constants + * + * Centralized configuration values for the visual editor. + * All magic strings/numbers should be defined here. + */ + +/** Editor version number */ +export const WEB_EDITOR_V2_VERSION = 2 as const; + +/** Log prefix for console messages */ +export const WEB_EDITOR_V2_LOG_PREFIX = '[WebEditorV2]' as const; + +// ============================================================================= +// DOM Element IDs +// ============================================================================= + +/** Shadow host element ID */ +export const WEB_EDITOR_V2_HOST_ID = '__mcp_web_editor_v2_host__'; + +/** Overlay container ID (for Canvas and visual feedback) */ +export const WEB_EDITOR_V2_OVERLAY_ID = '__mcp_web_editor_v2_overlay__'; + +/** UI container ID (for panels and controls) */ +export const WEB_EDITOR_V2_UI_ID = '__mcp_web_editor_v2_ui__'; + +// ============================================================================= +// Styling +// ============================================================================= + +/** Maximum z-index to ensure editor is always on top */ +export const WEB_EDITOR_V2_Z_INDEX = 2147483647; + +/** Default panel width */ +export const WEB_EDITOR_V2_PANEL_WIDTH = 320; + +// ============================================================================= +// Colors (Design System) +// ============================================================================= + +export const WEB_EDITOR_V2_COLORS = { + /** Hover highlight color */ + hover: '#3b82f6', // blue-500 + /** Selected element color */ + selected: '#22c55e', // green-500 + /** Selection box border */ + selectionBorder: '#6366f1', // indigo-500 + /** Drag ghost color */ + dragGhost: 'rgba(99, 102, 241, 0.3)', + /** Insertion line color */ + insertionLine: '#f59e0b', // amber-500 + /** Alignment guide line color (snap guides) */ + guideLine: '#ec4899', // pink-500 + /** Distance label background (Phase 4.3) */ + distanceLabelBg: 'rgba(15, 23, 42, 0.92)', // slate-900 @ 92% + /** Distance label border (Phase 4.3) */ + distanceLabelBorder: 'rgba(51, 65, 85, 0.5)', // slate-600 @ 50% + /** Distance label text (Phase 4.3) */ + distanceLabelText: 'rgba(255, 255, 255, 0.98)', +} as const; + +// ============================================================================= +// Drag Reorder (Phase 2.4-2.6) +// ============================================================================= + +/** Minimum pointer movement (px) to start dragging */ +export const WEB_EDITOR_V2_DRAG_THRESHOLD_PX = 5; + +/** Hysteresis (px) for stable before/after decision to avoid flip-flop */ +export const WEB_EDITOR_V2_DRAG_HYSTERESIS_PX = 6; + +/** Max elements to inspect per hit-test (elementsFromPoint) */ +export const WEB_EDITOR_V2_DRAG_MAX_HIT_ELEMENTS = 8; + +/** Insertion indicator line width in CSS pixels */ +export const WEB_EDITOR_V2_INSERTION_LINE_WIDTH = 3; + +// ============================================================================= +// Snapping & Alignment Guides (Phase 4.2) +// ============================================================================= + +/** Snap threshold in CSS pixels - distance at which snapping activates */ +export const WEB_EDITOR_V2_SNAP_THRESHOLD_PX = 6; + +/** Hysteresis in CSS pixels - keeps snap stable near boundary to prevent flicker */ +export const WEB_EDITOR_V2_SNAP_HYSTERESIS_PX = 2; + +/** Maximum sibling elements to consider for snapping (nearest first) */ +export const WEB_EDITOR_V2_SNAP_MAX_ANCHOR_ELEMENTS = 30; + +/** Maximum siblings to scan before applying distance filter */ +export const WEB_EDITOR_V2_SNAP_MAX_SIBLINGS_SCAN = 300; + +/** Alignment guide line width in CSS pixels */ +export const WEB_EDITOR_V2_GUIDE_LINE_WIDTH = 1; + +// ============================================================================= +// Distance Labels (Phase 4.3) +// ============================================================================= + +/** Minimum distance (px) to display a label - hides 0 and sub-pixel gaps */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_MIN_PX = 1; + +/** Measurement line width in CSS pixels */ +export const WEB_EDITOR_V2_DISTANCE_LINE_WIDTH = 1; + +/** Tick size at the ends of measurement lines (CSS pixels) */ +export const WEB_EDITOR_V2_DISTANCE_TICK_SIZE = 4; + +/** Font used for distance label pills */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_FONT = + '600 11px system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif'; + +/** Horizontal padding inside distance label pill (CSS pixels) */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_PADDING_X = 6; + +/** Vertical padding inside distance label pill (CSS pixels) */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_PADDING_Y = 3; + +/** Border radius for distance label pill (CSS pixels) */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_RADIUS = 4; + +/** Offset from the measurement line to place the pill (CSS pixels) */ +export const WEB_EDITOR_V2_DISTANCE_LABEL_OFFSET = 8; diff --git a/app/chrome-extension/entrypoints/web-editor-v2/core/css-compare.ts b/app/chrome-extension/entrypoints/web-editor-v2/core/css-compare.ts new file mode 100644 index 00000000..666a5a10 --- /dev/null +++ b/app/chrome-extension/entrypoints/web-editor-v2/core/css-compare.ts @@ -0,0 +1,327 @@ +/** + * CSS Compare Utilities (Phase 4.8) + * + * Provides robust CSS value comparison for HMR consistency verification. + * + * Design goals: + * - Compare computed style values (format-agnostic: "1rem" vs "16px" both resolve to same computed value) + * - Handle numeric tolerance for px-based values and transform matrices + * - Provide detailed diff information for UI feedback + * + * Why computed styles? + * - Editor mutates live DOM via inline styles for immediate preview + * - Agent may persist changes via classes/CSS modules/Tailwind, not inline styles + * - Comparing computed values avoids false mismatches from authoring format differences + */ + +// ============================================================================= +// Types +// ============================================================================= + +/** Detailed diff for a single CSS property */ +export interface ComputedDiffItem { + /** CSS property name */ + readonly property: string; + /** Expected value (from baseline) */ + readonly expected: string; + /** Actual value (from current DOM) */ + readonly actual: string; + /** Whether values match */ + readonly match: boolean; + /** How comparison was determined */ + readonly reason?: 'exact' | 'px_epsilon' | 'matrix_epsilon' | 'string'; +} + +/** Result of comparing two computed style maps */ +export interface CompareComputedResult { + /** Overall match status */ + readonly matches: boolean; + /** Per-property diff details */ + readonly diffs: readonly ComputedDiffItem[]; +} + +/** Options for CSS value comparison */ +export interface CompareComputedOptions { + /** + * Epsilon for px-based numeric comparison. + * Defaults to 0.5 to tolerate sub-pixel jitter from rounding. + */ + readonly pxEpsilon?: number; + /** + * Epsilon for matrix()/matrix3d() numeric comparison. + * Defaults to 1e-3 for floating-point precision tolerance. + */ + readonly matrixEpsilon?: number; +} + +// ============================================================================= +// Constants +// ============================================================================= + +const DEFAULT_PX_EPSILON = 0.5; +const DEFAULT_MATRIX_EPSILON = 1e-3; + +// Regex patterns (defined once for performance) +const PX_VALUE_REGEX = /(-?\d*\.?\d+(?:e[+-]?\d+)?)px/gi; +const MATRIX_NUMBER_REGEX = /-?\d*\.?\d+(?:e[+-]?\d+)?/gi; + +// ============================================================================= +// Public API +// ============================================================================= + +/** + * Normalize text content for robust comparison. + * Collapses whitespace and trims edges. + */ +export function normalizeText(text: string): string { + return String(text ?? '') + .replace(/\s+/g, ' ') + .trim(); +} + +/** + * Read computed style values for specified CSS properties. + * + * @param element - Target element + * @param properties - CSS property names to read + * @returns Map of property name to computed value (normalized) + */ +export function readComputedMap( + element: Element, + properties: readonly string[], +): Record { + const result: Record = {}; + + // Deduplicate and filter empty property names + const uniqueProps: string[] = []; + const seen = new Set(); + for (const raw of properties) { + const prop = String(raw ?? '').trim(); + if (!prop || seen.has(prop)) continue; + seen.add(prop); + uniqueProps.push(prop); + } + + // Safely get computed style declaration + let computed: CSSStyleDeclaration | null = null; + try { + computed = window.getComputedStyle(element); + } catch { + // Element may not be attached to DOM or other edge cases + computed = null; + } + + // Read each property + for (const property of uniqueProps) { + let value = ''; + try { + value = computed?.getPropertyValue(property) ?? ''; + } catch { + value = ''; + } + result[property] = normalizeCssValue(value); + } + + return result; +} + +/** + * Compare two computed style maps with numeric tolerance. + * + * Comparison strategy: + * 1. Exact string match → pass + * 2. matrix()/matrix3d() numeric tolerance → pass if within epsilon + * 3. px-based numeric tolerance → pass if same shape and within epsilon + * 4. Otherwise → fail + * + * @param expected - Baseline computed values + * @param actual - Current computed values + * @param options - Comparison options + * @returns Comparison result with per-property diffs + */ +export function compareComputed( + expected: Readonly>, + actual: Readonly>, + options: CompareComputedOptions = {}, +): CompareComputedResult { + const pxEps = Number.isFinite(options.pxEpsilon) ? options.pxEpsilon! : DEFAULT_PX_EPSILON; + const matrixEps = Number.isFinite(options.matrixEpsilon) + ? options.matrixEpsilon! + : DEFAULT_MATRIX_EPSILON; + + const diffs: ComputedDiffItem[] = []; + + for (const property of Object.keys(expected)) { + const exp = normalizeCssValue(expected[property] ?? ''); + const act = normalizeCssValue(actual[property] ?? ''); + + const { match, reason } = compareSingleValue(exp, act, pxEps, matrixEps); + diffs.push({ property, expected: exp, actual: act, match, reason }); + } + + const matches = diffs.every((d) => d.match); + return { matches, diffs }; +} + +// ============================================================================= +// Internal Helpers +// ============================================================================= + +/** + * Normalize a CSS value string for consistent comparison. + * Collapses whitespace and normalizes spacing around punctuation. + */ +function normalizeCssValue(raw: string): string { + return String(raw ?? '') + .replace(/\s+/g, ' ') // Collapse whitespace + .replace(/,\s+/g, ',') // Remove space after commas + .replace(/\(\s+/g, '(') // Remove space after open paren + .replace(/\s+\)/g, ')') // Remove space before close paren + .trim(); +} + +/** + * Check if two numbers are approximately equal within epsilon. + */ +function approximatelyEqual(a: number, b: number, epsilon: number): boolean { + return Math.abs(a - b) <= epsilon; +} + +/** + * Check if value looks like a CSS matrix transform. + */ +function isMatrixValue(value: string): boolean { + const lower = value.toLowerCase(); + return lower.startsWith('matrix(') || lower.startsWith('matrix3d('); +} + +/** + * Extract numeric components from a matrix() or matrix3d() value. + * Returns null if not a valid matrix or contains invalid numbers. + */ +function extractMatrixNumbers(value: string): number[] | null { + if (!isMatrixValue(value)) return null; + + const matches = value.match(MATRIX_NUMBER_REGEX); + if (!matches || matches.length === 0) return null; + + const nums: number[] = []; + for (const m of matches) { + const n = Number(m); + if (!Number.isFinite(n)) return null; + nums.push(n); + } + + return nums.length > 0 ? nums : null; +} + +/** + * Extract px numeric values from a CSS value string. + * Returns null if no px values found or contains invalid numbers. + */ +function extractPxNumbers(value: string): number[] | null { + const nums: number[] = []; + + // Reset regex state (global flag requires this) + PX_VALUE_REGEX.lastIndex = 0; + + let match: RegExpExecArray | null; + while ((match = PX_VALUE_REGEX.exec(value)) !== null) { + const n = Number(match[1]); + if (!Number.isFinite(n)) return null; + nums.push(n); + } + + return nums.length > 0 ? nums : null; +} + +/** + * Get the "shape" of a px-based value by replacing numeric values with placeholders. + * Used to ensure we're comparing structurally similar values. + */ +function pxValueShape(value: string): string { + // Reset regex state + PX_VALUE_REGEX.lastIndex = 0; + return normalizeCssValue(value).replace(PX_VALUE_REGEX, '#px'); +} + +/** + * Compare two matrix values with numeric tolerance. + */ +function compareMatrixWithEpsilon(expected: string, actual: string, epsilon: number): boolean { + const expNums = extractMatrixNumbers(expected); + const actNums = extractMatrixNumbers(actual); + + if (!expNums || !actNums) return false; + if (expNums.length !== actNums.length) return false; + + // Ensure both are same type (matrix vs matrix3d) + const expKind = expected.toLowerCase().startsWith('matrix3d(') ? 'matrix3d' : 'matrix'; + const actKind = actual.toLowerCase().startsWith('matrix3d(') ? 'matrix3d' : 'matrix'; + if (expKind !== actKind) return false; + + // Compare each component with epsilon + for (let i = 0; i < expNums.length; i++) { + if (!approximatelyEqual(expNums[i]!, actNums[i]!, epsilon)) return false; + } + + return true; +} + +/** + * Compare two px-based values with numeric tolerance. + */ +function comparePxWithEpsilon(expected: string, actual: string, epsilon: number): boolean { + const expNums = extractPxNumbers(expected); + const actNums = extractPxNumbers(actual); + + if (!expNums || !actNums) return false; + if (expNums.length !== actNums.length) return false; + + // Ensure values have same structure (e.g., "10px 20px" vs "10px 20px", not "10px" vs "10px solid") + if (pxValueShape(expected) !== pxValueShape(actual)) return false; + + // Compare each px value with epsilon + for (let i = 0; i < expNums.length; i++) { + if (!approximatelyEqual(expNums[i]!, actNums[i]!, epsilon)) return false; + } + + return true; +} + +/** + * Compare a single CSS value pair with all available strategies. + */ +function compareSingleValue( + expected: string, + actual: string, + pxEpsilon: number, + matrixEpsilon: number, +): { match: boolean; reason: ComputedDiffItem['reason'] } { + // 1. Exact string match (fastest path) + if (expected === actual) { + return { match: true, reason: 'exact' }; + } + + // 2. Matrix tolerance comparison + if (isMatrixValue(expected) && isMatrixValue(actual)) { + if (compareMatrixWithEpsilon(expected, actual, matrixEpsilon)) { + return { match: true, reason: 'matrix_epsilon' }; + } + } + + // 3. Px tolerance comparison + const expHasPx = PX_VALUE_REGEX.test(expected); + PX_VALUE_REGEX.lastIndex = 0; // Reset after test + const actHasPx = PX_VALUE_REGEX.test(actual); + PX_VALUE_REGEX.lastIndex = 0; // Reset after test + + if (expHasPx && actHasPx) { + if (comparePxWithEpsilon(expected, actual, pxEpsilon)) { + return { match: true, reason: 'px_epsilon' }; + } + } + + // 4. No match + return { match: false, reason: 'string' }; +} diff --git a/app/chrome-extension/entrypoints/web-editor-v2/core/cssom-styles-collector.ts b/app/chrome-extension/entrypoints/web-editor-v2/core/cssom-styles-collector.ts new file mode 100644 index 00000000..09053b01 --- /dev/null +++ b/app/chrome-extension/entrypoints/web-editor-v2/core/cssom-styles-collector.ts @@ -0,0 +1,1552 @@ +/** + * CSSOM Styles Collector (Phase 4.6) + * + * Provides CSS rule collection and cascade computation using CSSOM. + * Used for the CSS panel's style source tracking feature. + * + * Design goals: + * - Collect matched CSS rules for an element via CSSOM + * - Compute cascade (specificity + source order + !important) + * - Track inherited styles from ancestor elements + * - Handle Shadow DOM stylesheets + * - Produce UI-ready snapshot for rendering + * + * Limitations (CSSOM-only approach): + * - No reliable file:line info (only href/label available) + * - @container/@scope rules are not evaluated + * - @layer ordering is approximated via source order + */ + +// ============================================================================= +// Public Types (UI-ready snapshot) +// ============================================================================= + +export type Specificity = readonly [inline: number, ids: number, classes: number, types: number]; + +export type DeclStatus = 'active' | 'overridden'; + +export interface CssRuleSource { + url?: string; + label: string; +} + +export interface CssDeclView { + id: string; + name: string; + value: string; + important: boolean; + affects: readonly string[]; + status: DeclStatus; +} + +export interface CssRuleView { + id: string; + origin: 'inline' | 'rule'; + selector: string; + matchedSelector?: string; + specificity?: Specificity; + source?: CssRuleSource; + order: number; + decls: CssDeclView[]; +} + +export interface CssSectionView { + kind: 'inline' | 'matched' | 'inherited'; + title: string; + inheritedFrom?: { label: string }; + rules: CssRuleView[]; +} + +export interface CssPanelSnapshot { + target: { + label: string; + root: 'document' | 'shadow'; + }; + warnings: string[]; + stats: { + roots: number; + styleSheets: number; + rulesScanned: number; + matchedRules: number; + }; + sections: CssSectionView[]; +} + +// ============================================================================= +// Internal Types (cascade + collection) +// ============================================================================= + +interface DeclCandidate { + id: string; + important: boolean; + specificity: Specificity; + sourceOrder: readonly [sheetIndex: number, ruleOrder: number, declIndex: number]; + property: string; + value: string; + affects: readonly string[]; + ownerRuleId: string; + ownerElementId: number; +} + +interface FlatStyleRule { + sheetIndex: number; + order: number; + selectorText: string; + style: CSSStyleDeclaration; + source: CssRuleSource; +} + +interface RuleIndex { + root: Document | ShadowRoot; + rootId: number; + flatRules: FlatStyleRule[]; + warnings: string[]; + stats: { styleSheets: number; rulesScanned: number }; +} + +interface CollectElementOptions { + includeInline: boolean; + declFilter: (decl: { property: string; affects: readonly string[] }) => boolean; +} + +interface CollectedElementRules { + element: Element; + elementId: number; + root: Document | ShadowRoot; + rootType: 'document' | 'shadow'; + inlineRule: CssRuleView | null; + matchedRules: CssRuleView[]; + candidates: DeclCandidate[]; + warnings: string[]; + stats: { matchedRules: number }; +} + +// ============================================================================= +// Specificity (Selectors Level 4) +// ============================================================================= + +const ZERO_SPEC: Specificity = [0, 0, 0, 0] as const; + +export function compareSpecificity(a: Specificity, b: Specificity): number { + for (let i = 0; i < 4; i++) { + if (a[i] !== b[i]) return a[i] > b[i] ? 1 : -1; + } + return 0; +} + +function splitSelectorList(input: string): string[] { + const out: string[] = []; + let start = 0; + let depthParen = 0; + let depthBrack = 0; + let quote: "'" | '"' | null = null; + + for (let i = 0; i < input.length; i++) { + const ch = input[i]; + + if (quote) { + if (ch === '\\') { + i += 1; + continue; + } + if (ch === quote) quote = null; + continue; + } + + if (ch === '"' || ch === "'") { + quote = ch; + continue; + } + + if (ch === '\\') { + i += 1; + continue; + } + + if (ch === '[') depthBrack += 1; + else if (ch === ']' && depthBrack > 0) depthBrack -= 1; + else if (ch === '(') depthParen += 1; + else if (ch === ')' && depthParen > 0) depthParen -= 1; + + if (ch === ',' && depthParen === 0 && depthBrack === 0) { + const part = input.slice(start, i).trim(); + if (part) out.push(part); + start = i + 1; + } + } + + const tail = input.slice(start).trim(); + if (tail) out.push(tail); + return out; +} + +function maxSpecificity(list: readonly Specificity[]): Specificity { + let best: Specificity = ZERO_SPEC; + for (const s of list) if (compareSpecificity(s, best) > 0) best = s; + return best; +} + +function computeSelectorSpecificity(selector: string): Specificity { + let ids = 0; + let classes = 0; + let types = 0; + + let expectType = true; + + for (let i = 0; i < selector.length; i++) { + const ch = selector[i]; + + if (ch === '\\') { + i += 1; + continue; + } + + if (ch === '[') { + classes += 1; + i = consumeBracket(selector, i); + expectType = false; + continue; + } + + if (isCombinatorOrWhitespace(selector, i)) { + i = consumeWhitespaceAndCombinators(selector, i); + expectType = true; + continue; + } + + if (ch === '#') { + ids += 1; + i = consumeIdent(selector, i + 1) - 1; + expectType = false; + continue; + } + + if (ch === '.') { + classes += 1; + i = consumeIdent(selector, i + 1) - 1; + expectType = false; + continue; + } + + if (ch === ':') { + const isPseudoEl = selector[i + 1] === ':'; + if (isPseudoEl) { + types += 1; + const nameStart = i + 2; + const nameEnd = consumeIdent(selector, nameStart); + const name = selector.slice(nameStart, nameEnd).toLowerCase(); + i = nameEnd - 1; + + if (selector[i + 1] === '(' && name === 'slotted') { + const { content, endIndex } = consumeParenFunction(selector, i + 1); + const maxArg = maxSpecificity(splitSelectorList(content).map(computeSelectorSpecificity)); + ids += maxArg[1]; + classes += maxArg[2]; + types += maxArg[3]; + i = endIndex; + } + + expectType = false; + continue; + } + + const nameStart = i + 1; + const nameEnd = consumeIdent(selector, nameStart); + const name = selector.slice(nameStart, nameEnd).toLowerCase(); + + if (LEGACY_PSEUDO_ELEMENTS.has(name)) { + types += 1; + i = nameEnd - 1; + expectType = false; + continue; + } + + if (selector[nameEnd] === '(') { + const { content, endIndex } = consumeParenFunction(selector, nameEnd); + i = endIndex; + + if (name === 'where') { + expectType = false; + continue; + } + + if (name === 'is' || name === 'not' || name === 'has') { + const maxArg = maxSpecificity(splitSelectorList(content).map(computeSelectorSpecificity)); + ids += maxArg[1]; + classes += maxArg[2]; + types += maxArg[3]; + expectType = false; + continue; + } + + if (name === 'nth-child' || name === 'nth-last-child') { + classes += 1; + const ofSelectors = extractNthOfSelectorList(content); + if (ofSelectors) { + const maxArg = maxSpecificity( + splitSelectorList(ofSelectors).map(computeSelectorSpecificity), + ); + ids += maxArg[1]; + classes += maxArg[2]; + types += maxArg[3]; + } + expectType = false; + continue; + } + + // Other functional pseudo-classes count as class specificity (+1). + classes += 1; + expectType = false; + continue; + } + + classes += 1; + i = nameEnd - 1; + expectType = false; + continue; + } + + if (expectType) { + if (ch === '*') { + expectType = false; + continue; + } + if (isIdentStart(ch)) { + types += 1; + i = consumeIdent(selector, i + 1) - 1; + expectType = false; + continue; + } + } + } + + return [0, ids, classes, types] as const; +} + +/** + * For a selector list, returns the matched selector with max specificity among matches. + */ +function computeMatchedRuleSpecificity( + element: Element, + selectorText: string, +): { matchedSelector: string; specificity: Specificity } | null { + const selectors = splitSelectorList(selectorText); + let bestSel: string | null = null; + let bestSpec: Specificity = ZERO_SPEC; + + for (const sel of selectors) { + try { + if (!element.matches(sel)) continue; + const spec = computeSelectorSpecificity(sel); + if (!bestSel || compareSpecificity(spec, bestSpec) > 0) { + bestSel = sel; + bestSpec = spec; + } + } catch { + // Invalid selector for matches() (e.g. pseudo-elements) => ignore. + } + } + + return bestSel ? { matchedSelector: bestSel, specificity: bestSpec } : null; +} + +const LEGACY_PSEUDO_ELEMENTS = new Set([ + 'before', + 'after', + 'first-line', + 'first-letter', + 'selection', + 'backdrop', + 'placeholder', +]); + +function isIdentStart(ch: string): boolean { + return /[a-zA-Z_]/.test(ch) || ch.charCodeAt(0) >= 0x80; +} + +function consumeIdent(s: string, start: number): number { + let i = start; + for (; i < s.length; i++) { + const ch = s[i]; + if (ch === '\\') { + i += 1; + continue; + } + if (/[a-zA-Z0-9_-]/.test(ch) || ch.charCodeAt(0) >= 0x80) continue; + break; + } + return i; +} + +function consumeBracket(s: string, openIndex: number): number { + let depth = 1; + let quote: "'" | '"' | null = null; + + for (let i = openIndex + 1; i < s.length; i++) { + const ch = s[i]; + if (quote) { + if (ch === '\\') { + i += 1; + continue; + } + if (ch === quote) quote = null; + continue; + } + if (ch === '"' || ch === "'") { + quote = ch; + continue; + } + if (ch === '\\') { + i += 1; + continue; + } + if (ch === '[') depth += 1; + else if (ch === ']') { + depth -= 1; + if (depth === 0) return i; + } + } + return s.length - 1; +} + +function consumeParenFunction( + s: string, + openParenIndex: number, +): { content: string; endIndex: number } { + let depth = 1; + let quote: "'" | '"' | null = null; + + for (let i = openParenIndex + 1; i < s.length; i++) { + const ch = s[i]; + if (quote) { + if (ch === '\\') { + i += 1; + continue; + } + if (ch === quote) quote = null; + continue; + } + if (ch === '"' || ch === "'") { + quote = ch; + continue; + } + if (ch === '\\') { + i += 1; + continue; + } + if (ch === '[') i = consumeBracket(s, i); + else if (ch === '(') depth += 1; + else if (ch === ')') { + depth -= 1; + if (depth === 0) return { content: s.slice(openParenIndex + 1, i), endIndex: i }; + } + } + return { content: s.slice(openParenIndex + 1), endIndex: s.length - 1 }; +} + +function isCombinatorOrWhitespace(s: string, i: number): boolean { + const ch = s[i]; + return /\s/.test(ch) || ch === '>' || ch === '+' || ch === '~' || ch === '|'; +} + +function consumeWhitespaceAndCombinators(s: string, i: number): number { + let j = i; + while (j < s.length && /\s/.test(s[j])) j++; + if (s[j] === '|' && s[j + 1] === '|') return j + 1; + if (s[j] === '>' || s[j] === '+' || s[j] === '~' || s[j] === '|') return j; + return j - 1; +} + +function extractNthOfSelectorList(content: string): string | null { + let depthParen = 0; + let depthBrack = 0; + let quote: "'" | '"' | null = null; + + for (let i = 0; i < content.length; i++) { + const ch = content[i]; + + if (quote) { + if (ch === '\\') { + i += 1; + continue; + } + if (ch === quote) quote = null; + continue; + } + + if (ch === '"' || ch === "'") { + quote = ch; + continue; + } + + if (ch === '\\') { + i += 1; + continue; + } + + if (ch === '[') depthBrack += 1; + else if (ch === ']' && depthBrack > 0) depthBrack -= 1; + else if (ch === '(') depthParen += 1; + else if (ch === ')' && depthParen > 0) depthParen -= 1; + + if (depthParen === 0 && depthBrack === 0) { + if (isOfTokenAt(content, i)) return content.slice(i + 2).trimStart(); + } + } + + return null; +} + +function isOfTokenAt(s: string, i: number): boolean { + if (s[i] !== 'o' || s[i + 1] !== 'f') return false; + const prev = s[i - 1]; + const next = s[i + 2]; + const prevOk = prev === undefined || /\s/.test(prev); + const nextOk = next === undefined || /\s/.test(next); + return prevOk && nextOk; +} + +// ============================================================================= +// Inherited properties +// ============================================================================= + +export const INHERITED_PROPERTIES = new Set([ + // Color & appearance + 'color', + 'color-scheme', + 'caret-color', + 'accent-color', + + // Typography / fonts + 'font', + 'font-family', + 'font-feature-settings', + 'font-kerning', + 'font-language-override', + 'font-optical-sizing', + 'font-palette', + 'font-size', + 'font-size-adjust', + 'font-stretch', + 'font-style', + 'font-synthesis', + 'font-synthesis-small-caps', + 'font-synthesis-style', + 'font-synthesis-weight', + 'font-variant', + 'font-variant-alternates', + 'font-variant-caps', + 'font-variant-east-asian', + 'font-variant-emoji', + 'font-variant-ligatures', + 'font-variant-numeric', + 'font-variant-position', + 'font-variation-settings', + 'font-weight', + 'letter-spacing', + 'line-height', + 'text-rendering', + 'text-size-adjust', + 'text-transform', + 'text-indent', + 'text-align', + 'text-align-last', + 'text-justify', + 'text-shadow', + 'text-emphasis-color', + 'text-emphasis-position', + 'text-emphasis-style', + 'text-underline-position', + 'tab-size', + 'white-space', + 'word-break', + 'overflow-wrap', + 'word-spacing', + 'hyphens', + 'line-break', + + // Writing / bidi + 'direction', + 'unicode-bidi', + 'writing-mode', + 'text-orientation', + 'text-combine-upright', + + // Lists + 'list-style', + 'list-style-image', + 'list-style-position', + 'list-style-type', + + // Tables + 'border-collapse', + 'border-spacing', + 'caption-side', + 'empty-cells', + + // Visibility / interaction + 'cursor', + 'visibility', + 'pointer-events', + 'user-select', + + // Quotes & pagination + 'quotes', + 'orphans', + 'widows', + + // SVG + 'fill', + 'fill-opacity', + 'fill-rule', + 'stroke', + 'stroke-width', + 'stroke-linecap', + 'stroke-linejoin', + 'stroke-miterlimit', + 'stroke-dasharray', + 'stroke-dashoffset', + 'stroke-opacity', + 'paint-order', + 'shape-rendering', + 'image-rendering', + 'color-interpolation', + 'color-interpolation-filters', + 'color-rendering', + 'dominant-baseline', + 'alignment-baseline', + 'baseline-shift', + 'text-anchor', + 'stop-color', + 'stop-opacity', + 'flood-color', + 'flood-opacity', + 'lighting-color', + 'marker', + 'marker-start', + 'marker-mid', + 'marker-end', +]); + +export function isInheritableProperty(property: string): boolean { + const p = String(property || '').trim(); + if (!p) return false; + if (p.startsWith('--')) return true; + return INHERITED_PROPERTIES.has(p.toLowerCase()); +} + +// ============================================================================= +// Shorthand expansion +// ============================================================================= + +export const SHORTHAND_TO_LONGHANDS: Record = { + // Spacing + margin: ['margin-top', 'margin-right', 'margin-bottom', 'margin-left'], + padding: ['padding-top', 'padding-right', 'padding-bottom', 'padding-left'], + inset: ['top', 'right', 'bottom', 'left'], + + // Border + border: [ + 'border-top-width', + 'border-right-width', + 'border-bottom-width', + 'border-left-width', + 'border-top-style', + 'border-right-style', + 'border-bottom-style', + 'border-left-style', + 'border-top-color', + 'border-right-color', + 'border-bottom-color', + 'border-left-color', + ], + 'border-width': [ + 'border-top-width', + 'border-right-width', + 'border-bottom-width', + 'border-left-width', + ], + 'border-style': [ + 'border-top-style', + 'border-right-style', + 'border-bottom-style', + 'border-left-style', + ], + 'border-color': [ + 'border-top-color', + 'border-right-color', + 'border-bottom-color', + 'border-left-color', + ], + + 'border-top': ['border-top-width', 'border-top-style', 'border-top-color'], + 'border-right': ['border-right-width', 'border-right-style', 'border-right-color'], + 'border-bottom': ['border-bottom-width', 'border-bottom-style', 'border-bottom-color'], + 'border-left': ['border-left-width', 'border-left-style', 'border-left-color'], + + 'border-radius': [ + 'border-top-left-radius', + 'border-top-right-radius', + 'border-bottom-right-radius', + 'border-bottom-left-radius', + ], + + outline: ['outline-color', 'outline-style', 'outline-width'], + + // Background + background: [ + 'background-attachment', + 'background-clip', + 'background-color', + 'background-image', + 'background-origin', + 'background-position', + 'background-repeat', + 'background-size', + ], + + // Font + font: [ + 'font-style', + 'font-variant', + 'font-weight', + 'font-stretch', + 'font-size', + 'line-height', + 'font-family', + ], + + // Flexbox + flex: ['flex-grow', 'flex-shrink', 'flex-basis'], + 'flex-flow': ['flex-direction', 'flex-wrap'], + + // Alignment + 'place-content': ['align-content', 'justify-content'], + 'place-items': ['align-items', 'justify-items'], + 'place-self': ['align-self', 'justify-self'], + + // Gaps + gap: ['row-gap', 'column-gap'], + 'grid-gap': ['row-gap', 'column-gap'], + + // Overflow + overflow: ['overflow-x', 'overflow-y'], + + // Grid + 'grid-area': ['grid-row-start', 'grid-column-start', 'grid-row-end', 'grid-column-end'], + 'grid-row': ['grid-row-start', 'grid-row-end'], + 'grid-column': ['grid-column-start', 'grid-column-end'], + 'grid-template': ['grid-template-rows', 'grid-template-columns', 'grid-template-areas'], + + // Text + 'text-emphasis': ['text-emphasis-style', 'text-emphasis-color'], + 'text-decoration': [ + 'text-decoration-line', + 'text-decoration-style', + 'text-decoration-color', + 'text-decoration-thickness', + ], + + // Animations / transitions + transition: [ + 'transition-property', + 'transition-duration', + 'transition-timing-function', + 'transition-delay', + ], + animation: [ + 'animation-name', + 'animation-duration', + 'animation-timing-function', + 'animation-delay', + 'animation-iteration-count', + 'animation-direction', + 'animation-fill-mode', + 'animation-play-state', + ], + + // Multi-column + columns: ['column-width', 'column-count'], + 'column-rule': ['column-rule-width', 'column-rule-style', 'column-rule-color'], + + // Lists + 'list-style': ['list-style-position', 'list-style-image', 'list-style-type'], +}; + +export function expandToLonghands(property: string): readonly string[] { + const raw = String(property || '').trim(); + if (!raw) return []; + if (raw.startsWith('--')) return [raw]; + const p = raw.toLowerCase(); + return SHORTHAND_TO_LONGHANDS[p] ?? [p]; +} + +function normalizePropertyName(property: string): string { + const raw = String(property || '').trim(); + if (!raw) return ''; + if (raw.startsWith('--')) return raw; + return raw.toLowerCase(); +} + +// ============================================================================= +// Cascade / override +// ============================================================================= + +function compareSourceOrder( + a: readonly [number, number, number], + b: readonly [number, number, number], +): number { + if (a[0] !== b[0]) return a[0] > b[0] ? 1 : -1; + if (a[1] !== b[1]) return a[1] > b[1] ? 1 : -1; + if (a[2] !== b[2]) return a[2] > b[2] ? 1 : -1; + return 0; +} + +function compareCascade(a: DeclCandidate, b: DeclCandidate): number { + if (a.important !== b.important) return a.important ? 1 : -1; + const spec = compareSpecificity(a.specificity, b.specificity); + if (spec !== 0) return spec; + return compareSourceOrder(a.sourceOrder, b.sourceOrder); +} + +function computeOverrides(candidates: readonly DeclCandidate[]): { + winners: Map; + declStatus: Map; +} { + const winners = new Map(); + + for (const cand of candidates) { + for (const longhand of cand.affects) { + const cur = winners.get(longhand); + if (!cur || compareCascade(cand, cur) > 0) winners.set(longhand, cand); + } + } + + const declStatus = new Map(); + for (const cand of candidates) declStatus.set(cand.id, 'overridden'); + for (const [, winner] of winners) declStatus.set(winner.id, 'active'); + + return { winners, declStatus }; +} + +// ============================================================================= +// CSSOM Rule Index +// ============================================================================= + +const CONTAINER_RULE = (globalThis as unknown as { CSSRule?: { CONTAINER_RULE?: number } }).CSSRule + ?.CONTAINER_RULE; +const SCOPE_RULE = (globalThis as unknown as { CSSRule?: { SCOPE_RULE?: number } }).CSSRule + ?.SCOPE_RULE; + +function isSheetApplicable(sheet: CSSStyleSheet): boolean { + if ((sheet as { disabled?: boolean }).disabled) return false; + + try { + const mediaText = sheet.media?.mediaText?.trim() ?? ''; + if (!mediaText || mediaText.toLowerCase() === 'all') return true; + return window.matchMedia(mediaText).matches; + } catch { + return true; + } +} + +function describeStyleSheet(sheet: CSSStyleSheet, fallbackIndex: number): CssRuleSource { + const href = typeof sheet.href === 'string' ? sheet.href : undefined; + + if (href) { + const file = href.split('/').pop()?.split('?')[0] ?? href; + return { url: href, label: file }; + } + + const ownerNode = sheet.ownerNode as Node | null | undefined; + if (ownerNode && ownerNode.nodeType === Node.ELEMENT_NODE) { + const el = ownerNode as Element; + if (el.tagName === 'STYLE') return { label: ` diff --git a/app/chrome-extension/entrypoints/welcome/index.html b/app/chrome-extension/entrypoints/welcome/index.html new file mode 100644 index 00000000..e6bdf5e5 --- /dev/null +++ b/app/chrome-extension/entrypoints/welcome/index.html @@ -0,0 +1,13 @@ + + + + + + Welcome to Chrome MCP Server + + + +
+ + + diff --git a/app/chrome-extension/entrypoints/welcome/main.ts b/app/chrome-extension/entrypoints/welcome/main.ts new file mode 100644 index 00000000..486851ff --- /dev/null +++ b/app/chrome-extension/entrypoints/welcome/main.ts @@ -0,0 +1,7 @@ +import { createApp } from 'vue'; +import App from './App.vue'; + +// Tailwind first, then custom tokens +import '../styles/tailwind.css'; + +createApp(App).mount('#app'); diff --git a/app/chrome-extension/env.d.ts b/app/chrome-extension/env.d.ts new file mode 100644 index 00000000..f386e507 --- /dev/null +++ b/app/chrome-extension/env.d.ts @@ -0,0 +1,8 @@ +/// +declare module '*.vue' { + import type { DefineComponent } from 'vue'; + type Props = Record; + type RawBindings = Record; + const component: DefineComponent; + export default component; +} diff --git a/app/chrome-extension/eslint.config.js b/app/chrome-extension/eslint.config.js index e53f13ed..352348b9 100644 --- a/app/chrome-extension/eslint.config.js +++ b/app/chrome-extension/eslint.config.js @@ -34,13 +34,19 @@ export default defineConfig([ js.configs.recommended, { files: ['**/*.{js,mjs,cjs,ts,vue}'], - languageOptions: { globals: globals.browser }, + languageOptions: { + globals: { + ...globals.browser, + chrome: 'readonly', + }, + }, }, ...tseslint.configs.recommended, { rules: { '@typescript-eslint/no-explicit-any': 'off', '@typescript-eslint/no-unused-vars': 'off', + 'no-empty': 'off', }, }, pluginVue.configs['flat/essential'], diff --git a/app/chrome-extension/inject-scripts/accessibility-tree-helper.js b/app/chrome-extension/inject-scripts/accessibility-tree-helper.js new file mode 100644 index 00000000..b812a4f7 --- /dev/null +++ b/app/chrome-extension/inject-scripts/accessibility-tree-helper.js @@ -0,0 +1,1855 @@ +/* eslint-disable */ +// accessibility-tree-helper.js +// Injected script to generate an accessibility-like tree of the visible page +// Elements receive stable refs (ref_*) via WeakRef mapping for later reference. + +(function () { + if (window.__ACCESSIBILITY_TREE_HELPER_INITIALIZED__) return; + window.__ACCESSIBILITY_TREE_HELPER_INITIALIZED__ = true; + + // Traversal and output limits to ensure stability on very large/complex pages + const MAX_DEPTH = 30; // maximum DOM depth to traverse + const MAX_NODES = 4000; // hard limit to avoid long blocking on huge DOMs + const MAX_LINE_LABEL = 100; // max characters for a single label in output + const REF_MAP_LIMIT = 1000; // limit size of the ref map to keep payload small + + // Keep a weak map from ref id to elements + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + + /** + * Infer ARIA-like role from element + * @param {Element} el + * @returns {string} + */ + function inferRole(el) { + const role = el.getAttribute('role'); + if (role) return role; + const tag = el.tagName.toLowerCase(); + const type = el.getAttribute('type') || ''; + const map = { + a: 'link', + button: 'button', + input: + type === 'submit' || type === 'button' + ? 'button' + : type === 'checkbox' + ? 'checkbox' + : type === 'radio' + ? 'radio' + : type === 'file' + ? 'button' + : 'textbox', + select: 'combobox', + textarea: 'textbox', + h1: 'heading', + h2: 'heading', + h3: 'heading', + h4: 'heading', + h5: 'heading', + h6: 'heading', + img: 'image', + nav: 'navigation', + main: 'main', + header: 'banner', + footer: 'contentinfo', + section: 'region', + article: 'article', + aside: 'complementary', + form: 'form', + table: 'table', + ul: 'list', + ol: 'list', + li: 'listitem', + label: 'label', + }; + return map[tag] || 'generic'; + } + + /** + * Derive readable label for element + * @param {Element} el + * @returns {string} + */ + function inferLabel(el) { + const tag = el.tagName.toLowerCase(); + if (tag === 'select') { + const sel = /** @type {HTMLSelectElement} */ (el); + const opt = sel.querySelector('option[selected]') || sel.options[sel.selectedIndex]; + if (opt && opt.textContent) return opt.textContent.trim(); + } + const aria = el.getAttribute('aria-label'); + if (aria && aria.trim()) return aria.trim(); + const placeholder = el.getAttribute('placeholder'); + if (placeholder && placeholder.trim()) return placeholder.trim(); + const title = el.getAttribute('title'); + if (title && title.trim()) return title.trim(); + const alt = el.getAttribute('alt'); + if (alt && alt.trim()) return alt.trim(); + if (/** @type {HTMLElement} */ (el).id) { + const lab = document.querySelector(`label[for="${/** @type {HTMLElement} */ (el).id}"]`); + if (lab && lab.textContent && lab.textContent.trim()) return lab.textContent.trim(); + } + if (tag === 'input') { + const input = /** @type {HTMLInputElement} */ (el); + const type = input.getAttribute('type') || ''; + const val = input.getAttribute('value'); + if (type === 'submit' && val && val.trim()) return val.trim(); + if (input.value && input.value.length < 50 && input.value.trim()) return input.value.trim(); + } + if (['button', 'a', 'summary'].includes(tag)) { + let text = ''; + for (let i = 0; i < el.childNodes.length; i++) { + const n = el.childNodes[i]; + if (n.nodeType === Node.TEXT_NODE) text += n.textContent || ''; + } + if (text.trim()) return text.trim(); + } + if (/^h[1-6]$/.test(tag)) { + const t = el.textContent; + if (t && t.trim()) return t.trim().substring(0, MAX_LINE_LABEL); + } + if (tag === 'img') { + const src = el.getAttribute('src'); + if (src) { + const file = src.split('/').pop()?.split('?')[0]; + return `Image: ${file}`; + } + } + let agg = ''; + for (let i = 0; i < el.childNodes.length; i++) { + const n = el.childNodes[i]; + if (n.nodeType === Node.TEXT_NODE) agg += n.textContent || ''; + } + if (agg && agg.trim() && agg.trim().length >= 3) { + const v = agg.trim(); + return v.length > 50 ? v.substring(0, 50) + '...' : v; + } + return ''; + } + + /** + * Check if element is visible in DOM + * @param {Element} el + */ + function isVisible(el) { + const cs = window.getComputedStyle(/** @type {HTMLElement} */ (el)); + if (cs.display === 'none' || cs.visibility === 'hidden' || cs.opacity === '0') return false; + const he = /** @type {HTMLElement} */ (el); + return he.offsetWidth > 0 && he.offsetHeight > 0; + } + + /** + * Whether the element is interactive + * @param {Element} el + */ + function isInteractive(el) { + // Native interactive tags + const tag = el.tagName.toLowerCase(); + if (['a', 'button', 'input', 'select', 'textarea', 'details', 'summary'].includes(tag)) + return true; + + // Generic interactive hints + if (el.getAttribute('onclick') != null) return true; + if ( + el.getAttribute('tabindex') != null && + String(el.getAttribute('tabindex')).trim() !== '' && + !String(el.getAttribute('tabindex')).trim().startsWith('-') + ) + return true; + if (el.getAttribute('contenteditable') === 'true') return true; + + // ARIA roles commonly used by custom elements + const role = (el.getAttribute && el.getAttribute('role')) || ''; + const interactiveRoles = new Set([ + 'button', + 'link', + 'checkbox', + 'radio', + 'switch', + 'slider', + 'option', + 'menuitem', + 'textbox', + 'searchbox', + 'combobox', + 'spinbutton', + 'tab', + 'treeitem', + ]); + if (role && interactiveRoles.has(role.toLowerCase())) return true; + + // Shadow host case: treat host as interactive if its open shadow root contains + // an interactive control (textarea/input/select/button/a or contenteditable). + try { + const anyEl = /** @type {any} */ (el); + const sr = anyEl && anyEl.shadowRoot ? anyEl.shadowRoot : null; + if (sr) { + const inner = sr.querySelector( + 'input, textarea, select, button, a[href], [contenteditable="true"], [role="button"], [role="link"], [role="textbox"], [role="combobox"], [role="searchbox"], [role="menuitem"], [role="option"], [role="switch"], [role="radio"], [role="checkbox"], [role="tab"], [role="slider"]', + ); + if (inner) return true; + } + } catch (_) { + /* ignore */ + } + return false; + } + + /** + * Structural containers useful to include + * @param {Element} el + */ + function isStructural(el) { + const tag = el.tagName.toLowerCase(); + if ( + [ + 'h1', + 'h2', + 'h3', + 'h4', + 'h5', + 'h6', + 'nav', + 'main', + 'header', + 'footer', + 'section', + 'article', + 'aside', + ].includes(tag) + ) + return true; + return el.getAttribute('role') != null; + } + + /** + * Form-ish containers to keep + * @param {Element} el + */ + function isFormishContainer(el) { + const tag = el.tagName.toLowerCase(); + const role = (el.getAttribute && el.getAttribute('role')) || ''; + const id = /** @type {HTMLElement} */ (el).id || ''; + // Normalize className for HTML/SVG elements + let cls = ''; + try { + const attr = el.getAttribute && el.getAttribute('class'); + if (typeof attr === 'string') cls = attr; + else { + const cn = /** @type {any} */ (el).className; + if (typeof cn === 'string') cls = cn; + else if (cn && typeof cn.baseVal === 'string') cls = cn.baseVal; + } + } catch (e) { + /* ignore */ + } + return ( + role === 'search' || + role === 'form' || + role === 'group' || + role === 'toolbar' || + role === 'navigation' || + tag === 'form' || + tag === 'fieldset' || + tag === 'nav' || + tag === 'legend' || + id.includes('search') || + cls.includes('search') || + id.includes('form') || + cls.includes('form') || + id.includes('menu') || + cls.includes('menu') || + id.includes('nav') || + cls.includes('nav') + ); + } + + // Utility: query CSS across open shadow roots (best-effort) + function querySelectorDeepFirst(selector) { + try { + // Fast path + const direct = document.querySelector(selector); + if (direct) return direct; + } catch (_) {} + const visited = new Set(); + const stack = [document.documentElement]; + while (stack.length) { + const node = stack.pop(); + if (!node || visited.has(node)) continue; + visited.add(node); + try { + const root = /** @type {any} */ (node).shadowRoot || (node.nodeType === 9 ? node : null); + if (root) { + try { + const hit = root.querySelector(selector); + if (hit) return hit; + } catch (_) {} + } + } catch (_) {} + // Traverse DOM and shadow roots + try { + const children = /** @type {Element} */ (node).children || []; + for (let i = 0; i < children.length; i++) stack.push(children[i]); + const sr = /** @type {any} */ (node).shadowRoot; + if (sr && sr.children) { + for (let i = 0; i < sr.children.length; i++) stack.push(sr.children[i]); + } + } catch (_) {} + } + return null; + } + + /** + * Query CSS selector and return match info including uniqueness check. + * @param {string} selector - CSS selector to query + * @param {boolean} allowMultiple - If true, skip uniqueness check and return first match + * @returns {{element: Element | null, matchCount: number, error?: string}} + * Note: matchCount is capped at 2 (where 2 means "2 or more") for performance + */ + function querySelectorWithUniquenessCheck(selector, allowMultiple = false) { + const seen = new Set(); + let firstMatch = null; + let matchCount = 0; + + const recordMatch = (el) => { + if (!(el instanceof Element) || seen.has(el)) return false; + seen.add(el); + matchCount++; + if (!firstMatch) firstMatch = el; + // Short-circuit if: + // - allowMultiple is true and we found first match (no need to continue) + // - allowMultiple is false and we found multiple matches + if (allowMultiple && firstMatch) return true; + if (!allowMultiple && matchCount >= 2) return true; + return false; + }; + + // Query in main document + let selectorError = null; + try { + const directMatches = document.querySelectorAll(selector); + for (let i = 0; i < directMatches.length; i++) { + if (recordMatch(directMatches[i])) { + // Early exit: either found first match (allowMultiple) or found multiple (not allowed) + return { element: firstMatch, matchCount: allowMultiple ? 1 : 2 }; + } + } + } catch (e) { + selectorError = e; + } + + if (selectorError) { + return { + element: null, + matchCount: 0, + error: `Invalid CSS selector "${selector}": ${selectorError.message || selectorError}`, + }; + } + + // If allowMultiple and we already have a match, return immediately + if (allowMultiple && firstMatch) { + return { element: firstMatch, matchCount: 1 }; + } + + // Query in shadow DOMs + const visited = new Set(); + const stack = [document.documentElement]; + while (stack.length) { + const node = stack.pop(); + if (!node || visited.has(node)) continue; + visited.add(node); + + try { + const shadowRoot = /** @type {any} */ (node).shadowRoot; + if (shadowRoot) { + try { + const shadowMatches = shadowRoot.querySelectorAll(selector); + for (let i = 0; i < shadowMatches.length; i++) { + if (recordMatch(shadowMatches[i])) { + // Early exit: either found first match (allowMultiple) or found multiple (not allowed) + return { element: firstMatch, matchCount: allowMultiple ? 1 : 2 }; + } + } + } catch (e) { + return { + element: null, + matchCount: 0, + error: `Invalid CSS selector "${selector}": ${e.message || e}`, + }; + } + + // Add shadow root children to stack + try { + const shadowChildren = shadowRoot.children || []; + for (let i = 0; i < shadowChildren.length; i++) { + stack.push(shadowChildren[i]); + } + } catch (_) {} + } + } catch (_) {} + + // Add regular children to stack + try { + const children = /** @type {Element} */ (node).children || []; + for (let i = 0; i < children.length; i++) { + stack.push(children[i]); + } + } catch (_) {} + } + + return { element: firstMatch, matchCount: Math.min(matchCount, 2) }; + } + + /** + * Query XPath selector and return match info including uniqueness check. + * @param {string} selector - XPath selector to query + * @param {boolean} allowMultiple - If true, skip uniqueness check and return first match + * @returns {{element: Element | null, matchCount: number, error?: string}} + * Note: matchCount is capped at 2 (where 2 means "2 or more") for performance + */ + function queryXPathWithUniquenessCheck(selector, allowMultiple = false) { + if (!selector) { + return { element: null, matchCount: 0 }; + } + + try { + if (allowMultiple) { + // When multiple matches are allowed, use ANY_UNORDERED_NODE_TYPE for performance + // This returns just the first match without evaluating the entire result set + const result = document.evaluate( + selector, + document, + null, + XPathResult.ANY_UNORDERED_NODE_TYPE, + null, + ); + const firstMatch = + result.singleNodeValue instanceof Element + ? /** @type {Element} */ (result.singleNodeValue) + : null; + return { element: firstMatch, matchCount: firstMatch ? 1 : 0 }; + } else { + // When uniqueness is required, use ORDERED_NODE_SNAPSHOT_TYPE to count matches + const snapshot = document.evaluate( + selector, + document, + null, + XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, + null, + ); + const totalMatches = snapshot.snapshotLength; + // Cap at 2 for performance (2 means "2 or more") + const matchCount = Math.min(totalMatches, 2); + const firstMatch = + totalMatches > 0 && snapshot.snapshotItem(0) instanceof Element + ? /** @type {Element} */ (snapshot.snapshotItem(0)) + : null; + return { element: firstMatch, matchCount }; + } + } catch (e) { + return { + element: null, + matchCount: 0, + error: `Invalid XPath "${selector}": ${e.message || e}`, + }; + } + } + + /** + * Whether to include element in tree under config + * @param {Element} el + * @param {{filter?: 'all'|'interactive'}} cfg + */ + function shouldInclude(el, cfg) { + const tag = el.tagName.toLowerCase(); + if (['script', 'style', 'meta', 'link', 'title', 'noscript'].includes(tag)) return false; + if (el.getAttribute('aria-hidden') === 'true') return false; + if (!isVisible(el)) return false; + if (cfg.filter !== 'all') { + const r = /** @type {HTMLElement} */ (el).getBoundingClientRect(); + if ( + !(r.top < window.innerHeight && r.bottom > 0 && r.left < window.innerWidth && r.right > 0) + ) + return false; + } + if (cfg.filter === 'interactive') return isInteractive(el); + if (isInteractive(el)) return true; + if (isStructural(el)) return true; + if (inferLabel(el).length > 0) return true; + return isFormishContainer(el); + } + + /** + * Generate a fairly stable CSS selector + * @param {Element} el + * @returns {string} + */ + function generateSelector(el) { + if (!(el instanceof Element)) return ''; + if (/** @type {HTMLElement} */ (el).id) { + const idSel = `#${CSS.escape(/** @type {HTMLElement} */ (el).id)}`; + if (document.querySelectorAll(idSel).length === 1) return idSel; + } + for (const attr of ['data-testid', 'data-cy', 'name']) { + const attrValue = el.getAttribute(attr); + if (attrValue) { + const s = `[${attr}="${CSS.escape(attrValue)}"]`; + if (document.querySelectorAll(s).length === 1) return s; + } + } + let path = ''; + let current = el; + while (current && current.nodeType === Node.ELEMENT_NODE && current.tagName !== 'BODY') { + let selector = current.tagName.toLowerCase(); + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter( + (child) => child.tagName === current.tagName, + ); + if (siblings.length > 1) { + const index = siblings.indexOf(current) + 1; + selector += `:nth-of-type(${index})`; + } + } + path = path ? `${selector} > ${path}` : selector; + current = parent; + } + return path ? `body > ${path}` : 'body'; + } + + /** + * Traverse DOM and build pageContent lines; collect ref map for interactive nodes. + * @param {Element} el + * @param {number} depth + * @param {{filter?: 'all'|'interactive', maxDepth?: number}} cfg + * @param {string[]} out + * @param {Array<{ref:string, selector:string, rect:{x:number,y:number,width:number,height:number}}>} refMap + */ + function traverse(el, depth, cfg, out, refMap, state) { + const maxDepth = cfg && typeof cfg.maxDepth === 'number' ? cfg.maxDepth : MAX_DEPTH; + if (depth > maxDepth || !el || !el.tagName) return; + if (state.processed >= MAX_NODES) return; + if (state.visited.has(el)) return; + state.visited.add(el); + const include = shouldInclude(el, cfg) || depth === 0; + if (include) { + const role = inferRole(el); + let label = inferLabel(el); + let refId = null; + for (const k in window.__claudeElementMap) { + if (window.__claudeElementMap[k].deref && window.__claudeElementMap[k].deref() === el) { + refId = k; + break; + } + } + if (!refId) { + refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + } + const rect = /** @type {HTMLElement} */ (el).getBoundingClientRect(); + const cx = Math.round(rect.left + rect.width / 2); + const cy = Math.round(rect.top + rect.height / 2); + let line = `${' '.repeat(depth)}- ${role}`; + if (label) { + label = label.replace(/\s+/g, ' ').substring(0, MAX_LINE_LABEL); + line += ` "${label.replace(/"/g, '\\"')}"`; + } + line += ` [ref=${refId}] (x=${cx},y=${cy})`; + if (/** @type {HTMLElement} */ (el).id) line += ` id="${/** @type {HTMLElement} */ (el).id}"`; + const href = el.getAttribute('href'); + if (href) line += ` href="${href}"`; + const type = el.getAttribute('type'); + if (type) line += ` type="${type}"`; + const placeholder = el.getAttribute('placeholder'); + if (placeholder) line += ` placeholder="${placeholder}"`; + // Surface disabled/pointer-events for better agent judgement + try { + const disabled = el.hasAttribute('disabled') || el.getAttribute('aria-disabled') === 'true'; + if (disabled) line += ` disabled`; + const cs = window.getComputedStyle(/** @type {HTMLElement} */ (el)); + if (cs && cs.pointerEvents === 'none') line += ` pe=none`; + } catch (_) { + /* ignore style issues */ + } + out.push(line); + state.included++; + state.processed++; + + // Only collect ref mapping for interactive elements to limit cost + if (isInteractive(el) && refMap.length < REF_MAP_LIMIT) { + refMap.push({ + ref: /** @type {string} */ (refId), + selector: generateSelector(el), + rect: { + x: rect.x, + y: rect.y, + width: rect.width, + height: rect.height, + }, + }); + } + } + if (state.processed >= MAX_NODES) return; + // Traverse light DOM children + if (/** @type {HTMLElement} */ (el).children && depth < maxDepth) { + const children = /** @type {HTMLElement} */ (el).children; + for (let i = 0; i < children.length; i++) { + if (state.processed >= MAX_NODES) break; + traverse(children[i], include ? depth + 1 : depth, cfg, out, refMap, state); + } + } + // Traverse shadow DOM roots (limited by maxDepth and MAX_NODES) + try { + const anyEl = /** @type {any} */ (el); + if (anyEl && anyEl.shadowRoot && depth < maxDepth) { + const srChildren = anyEl.shadowRoot.children || []; + for (let i = 0; i < srChildren.length; i++) { + if (state.processed >= MAX_NODES) break; + traverse(srChildren[i], include ? depth + 1 : depth, cfg, out, refMap, state); + } + } + } catch (_) { + /* ignore shadow errors */ + } + } + + /** + * Generate tree and return + * @param {'all'|'interactive'|null} filter + * @param {{maxDepth?: number, refId?: string}|undefined} options + */ + function __generateAccessibilityTree(filter, options) { + try { + const start = performance && performance.now ? performance.now() : Date.now(); + const out = []; + const cfg = { filter: filter || undefined }; + + // Clamp maxDepth to MAX_DEPTH to keep costs bounded + if (options && Number.isFinite(options.maxDepth)) { + const d = Math.max(0, Math.floor(Number(options.maxDepth))); + cfg.maxDepth = Math.min(d, MAX_DEPTH); + } + + const refMap = []; + const state = { processed: 0, included: 0, visited: new WeakSet() }; + + // Determine root element (body or refId-specified element) + let focus = null; + let root = document.body; + if (options && options.refId) { + const refIdStr = String(options.refId || '').trim(); + if (refIdStr) { + const el = resolveRef(refIdStr); + if (!el || !(el instanceof Element)) { + return { error: `ref "${refIdStr}" not found or expired` }; + } + root = el; + focus = { refId: refIdStr }; + } + } + + if (root) traverse(root, 0, cfg, out, refMap, state); + for (const k in window.__claudeElementMap) { + if (!window.__claudeElementMap[k].deref || !window.__claudeElementMap[k].deref()) + delete window.__claudeElementMap[k]; + } + const pageContent = out + .filter((line) => !/^\s*- generic \[ref=ref_\d+\]$/.test(line)) + .join('\n'); + const end = performance && performance.now ? performance.now() : Date.now(); + return { + pageContent, + focus, + viewport: { + width: window.innerWidth, + height: window.innerHeight, + dpr: window.devicePixelRatio || 1, + }, + stats: { + processed: state.processed, + included: state.included, + durationMs: Math.round(end - start), + }, + refMap, + }; + } catch (err) { + throw new Error( + 'Error generating accessibility tree: ' + + (err && err.message ? err.message : 'Unknown error'), + ); + } + } + + // Expose API on window + window.__generateAccessibilityTree = __generateAccessibilityTree; + + // ============================================================================ + // Hover for Ref (DOM Fallback Support) + // ============================================================================ + + async function handleHoverForRef(ref) { + if (!ref) return { success: false, error: 'ref is required' }; + const el = resolveRef(ref); + if (el) { + dispatchHoverEvents(el); + return { success: true, target: summarizeElement(el) }; + } + return await forwardHoverRefToChildren(ref); + } + + function resolveRef(ref) { + const map = window.__claudeElementMap || {}; + const weak = map[ref]; + return weak && typeof weak.deref === 'function' ? weak.deref() : null; + } + + function dispatchHoverEvents(el) { + const rect = el.getBoundingClientRect(); + const center = { + x: Math.round(rect.left + rect.width / 2), + y: Math.round(rect.top + rect.height / 2), + }; + ['mousemove', 'mouseover', 'mouseenter'].forEach((type) => { + el.dispatchEvent( + new MouseEvent(type, { + bubbles: true, + cancelable: true, + clientX: center.x, + clientY: center.y, + view: window, + }), + ); + }); + } + + function summarizeElement(el) { + return { + tagName: el.tagName, + id: el.id || '', + className: el.className || '', + text: (el.textContent || '').trim().slice(0, 100), + }; + } + + function forwardHoverRefToChildren(ref) { + return new Promise((resolve) => { + const frames = Array.from(document.querySelectorAll('iframe, frame')); + if (!frames.length) { + resolve({ success: false, error: `ref "${ref}" not found` }); + return; + } + const reqId = `hover_ref_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; + const listener = (ev) => { + const data = ev?.data; + if (!data || data.type !== 'rr-bridge-hover-ref-result' || data.reqId !== reqId) return; + window.removeEventListener('message', listener, true); + resolve(data.result); + }; + window.addEventListener('message', listener, true); + setTimeout(() => { + window.removeEventListener('message', listener, true); + resolve({ success: false, error: `ref "${ref}" not found in child frames` }); + }, 1500); + for (const frame of frames) { + try { + frame.contentWindow?.postMessage({ type: 'rr-bridge-hover-ref', reqId, ref }, '*'); + } catch {} + } + }); + } + + // Chrome message bridge for ping and tree generation + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + try { + if (request && request.action === 'chrome_read_page_ping') { + sendResponse({ status: 'pong' }); + return false; + } + if (request && request.action === 'rr_overlay') { + try { + const cmd = request.cmd || 'init'; + let root = document.getElementById('__rr_overlay_root'); + if (!root) { + root = document.createElement('div'); + root.id = '__rr_overlay_root'; + Object.assign(root.style, { + position: 'fixed', + right: '8px', + bottom: '8px', + zIndex: 2_147_483_647, + maxWidth: '40vw', + maxHeight: '40vh', + overflow: 'auto', + background: 'rgba(0,0,0,0.6)', + color: '#fff', + fontFamily: + 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace', + fontSize: '12px', + padding: '8px', + borderRadius: '6px', + boxShadow: '0 2px 8px rgba(0,0,0,0.3)', + }); + const title = document.createElement('div'); + title.textContent = 'Record-Replay 运行日志'; + Object.assign(title.style, { fontWeight: 'bold', marginBottom: '6px' }); + const body = document.createElement('div'); + body.id = '__rr_overlay_body'; + root.appendChild(title); + root.appendChild(body); + document.documentElement.appendChild(root); + } + const body = document.getElementById('__rr_overlay_body'); + if (cmd === 'append' && body) { + const line = document.createElement('div'); + line.textContent = String(request.text || ''); + body.appendChild(line); + body.scrollTop = body.scrollHeight; + } + if (cmd === 'done' && root) { + root.style.opacity = '0.5'; + } + sendResponse({ success: true }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + // Element picker: start a temporary overlay to let user pick an element + if (request && request.action === 'rr_picker_start') { + try { + // state + const state = { active: true }; + const hostId = '__rr_picker_host__'; + let host = document.getElementById(hostId); + if (host) host.remove(); + host = document.createElement('div'); + host.id = hostId; + Object.assign(host.style, { + position: 'fixed', + inset: '0', + zIndex: 2147483646, + cursor: 'crosshair', + background: 'rgba(0,0,0,0.0)', + }); + const box = document.createElement('div'); + Object.assign(box.style, { + position: 'fixed', + border: '2px solid #3b82f6', + background: 'rgba(59,130,246,0.15)', + pointerEvents: 'none', + }); + const tip = document.createElement('div'); + tip.textContent = '点击选取元素（Esc 取消）'; + Object.assign(tip.style, { + position: 'fixed', + top: '10px', + left: '10px', + background: 'rgba(0,0,0,0.7)', + color: '#fff', + padding: '6px 10px', + borderRadius: '6px', + fontSize: '12px', + fontFamily: 'system-ui,-apple-system,Segoe UI,Roboto,Arial', + }); + host.appendChild(box); + host.appendChild(tip); + document.documentElement.appendChild(host); + + const cleanup = () => { + try { + host.remove(); + } catch {} + try { + document.removeEventListener('mousemove', onMove, true); + } catch {} + try { + document.removeEventListener('click', onClick, true); + } catch {} + try { + document.removeEventListener('keydown', onKey, true); + } catch {} + state.active = false; + }; + + const onMove = (e) => { + if (!state.active) return; + const el = e.target instanceof Element ? e.target : null; + if (!el) return; + try { + const r = el.getBoundingClientRect(); + Object.assign(box.style, { + left: `${Math.round(r.left)}px`, + top: `${Math.round(r.top)}px`, + width: `${Math.round(Math.max(0, r.width))}px`, + height: `${Math.round(Math.max(0, r.height))}px`, + display: r.width > 0 && r.height > 0 ? 'block' : 'none', + }); + } catch {} + }; + const uniqueClassSelector = (node) => { + try { + const classes = Array.from(node.classList || []).filter( + (c) => c && /^[a-zA-Z0-9_-]+$/.test(c), + ); + for (const cls of classes) { + const sel = `.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + const tag = node.tagName ? node.tagName.toLowerCase() : ''; + for (const cls of classes) { + const sel = `${tag}.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + for (let i = 0; i < Math.min(classes.length, 3); i++) { + for (let j = i + 1; j < Math.min(classes.length, 3); j++) { + const sel = `.${CSS.escape(classes[i])}.${CSS.escape(classes[j])}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + } + } catch {} + return ''; + }; + const computeCandidates = (el) => { + const cands = []; + // css by id / class / short path + if (el.id) { + const idSel = `#${CSS.escape(el.id)}`; + if (document.querySelectorAll(idSel).length === 1) + cands.push({ type: 'css', value: idSel }); + } + const classSel = uniqueClassSelector(el); + if (classSel) cands.push({ type: 'css', value: classSel }); + // data-* and name + for (const attr of ['data-testid', 'data-cy', 'name']) { + const val = el.getAttribute(attr); + if (val) { + const s = `[${attr}="${CSS.escape(val)}"]`; + if (document.querySelectorAll(s).length === 1) + cands.push({ type: 'attr', value: s }); + } + } + // aria + const aria = el.getAttribute && el.getAttribute('aria-label'); + if (aria) cands.push({ type: 'aria', value: `textbox[name=${aria}]` }); + // text for clickable + const tag = (el.tagName || '').toLowerCase(); + if (['button', 'a', 'summary'].includes(tag)) { + const text = (el.textContent || '').trim(); + if (text) cands.push({ type: 'text', value: text.substring(0, 64) }); + } + // fallback path selector + const gen = (node) => { + if (!(node instanceof Element)) return ''; + let path = ''; + let current = node; + while ( + current && + current.nodeType === Node.ELEMENT_NODE && + current.tagName !== 'BODY' + ) { + let sel = current.tagName.toLowerCase(); + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter( + (child) => child.tagName === current.tagName, + ); + if (siblings.length > 1) { + const index = siblings.indexOf(current) + 1; + sel += `:nth-of-type(${index})`; + } + } + path = path ? `${sel} > ${path}` : sel; + current = parent; + } + return path ? `body > ${path}` : 'body'; + }; + const pathSel = gen(el); + if (pathSel) cands.push({ type: 'css', value: pathSel }); + return cands; + }; + const onClick = (e) => { + if (!state.active) return; + e.preventDefault(); + e.stopPropagation(); + const el = e.target instanceof Element ? e.target : null; + if (!el) { + cleanup(); + sendResponse({ success: false, error: 'no element' }); + return true; + } + // create ref + try { + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + } catch {} + let refId = null; + try { + for (const k in window.__claudeElementMap) { + if ( + window.__claudeElementMap[k].deref && + window.__claudeElementMap[k].deref() === el + ) { + refId = k; + break; + } + } + if (!refId) { + refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + } + } catch {} + const cands = computeCandidates(el); + cleanup(); + sendResponse({ success: true, ref: refId, candidates: cands }); + return true; + }; + const onKey = (e) => { + if (e.key === 'Escape') { + cleanup(); + sendResponse({ success: false, cancelled: true }); + } + }; + document.addEventListener('mousemove', onMove, true); + document.addEventListener('click', onClick, true); + document.addEventListener('keydown', onKey, true); + return true; // async + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'rr_picker_stop') { + try { + const host = document.getElementById('__rr_picker_host__'); + if (host) host.remove(); + sendResponse({ success: true }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'generateAccessibilityTree') { + const result = __generateAccessibilityTree(request.filter || null, { + maxDepth: request.depth, + refId: request.refId, + }); + if (result && result.error) { + sendResponse({ success: false, error: result.error }); + return true; + } + sendResponse({ success: true, ...result }); + return true; + } + if (request && request.action === 'ensureRefForSelector') { + try { + // Composite selector support: "frameSelector |> innerSelector" + const maybeSel = String(request.selector || '').trim(); + const allowMultiple = !!request.allowMultiple; + if (maybeSel.includes('|>')) { + try { + const parts = maybeSel + .split('|>') + .map((s) => s.trim()) + .filter(Boolean); + if (parts.length >= 2) { + const frameSel = parts[0]; + const innerSel = parts.slice(1).join(' |> '); + // Find target frame element in current document + let frameEl = null; + try { + frameEl = querySelectorDeepFirst(frameSel) || document.querySelector(frameSel); + } catch {} + if ( + !frameEl || + !(frameEl instanceof HTMLIFrameElement || frameEl instanceof HTMLFrameElement) + ) { + sendResponse({ + success: false, + error: `Composite frame selector not found: ${frameSel}`, + }); + return true; + } + const cw = frameEl.contentWindow; + if (!cw) { + sendResponse({ + success: false, + error: 'Unable to obtain contentWindow of target frame', + }); + return true; + } + // Bridge to child frame via postMessage with timeout + const reqId = `rrc_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; + const BRIDGE_TIMEOUT_MS = 5000; // 5 second timeout for iframe bridge + let responded = false; + let timeoutHandle = null; + + const cleanup = () => { + window.removeEventListener('message', listener, true); + if (timeoutHandle) { + clearTimeout(timeoutHandle); + timeoutHandle = null; + } + }; + + const listener = (ev) => { + try { + const data = ev && ev.data; + if ( + !data || + data.type !== 'rr-bridge-ensure-ref-result' || + data.reqId !== reqId + ) + return; + // Validate source is the expected frame (security check) + if (ev.source !== cw) return; + + if (responded) return; // Already timed out + responded = true; + cleanup(); + + if (data.success) { + sendResponse({ + success: true, + ref: data.ref, + center: data.center, + href: data.href, + }); + } else { + sendResponse({ success: false, error: data.error || 'child failed' }); + } + } catch (e) { + if (!responded) { + responded = true; + cleanup(); + sendResponse({ + success: false, + error: String(e && e.message ? e.message : e), + }); + } + } + }; + + // Set up timeout to prevent infinite wait + timeoutHandle = setTimeout(() => { + if (!responded) { + responded = true; + cleanup(); + sendResponse({ + success: false, + error: `iframe bridge timeout after ${BRIDGE_TIMEOUT_MS}ms`, + }); + } + }, BRIDGE_TIMEOUT_MS); + + window.addEventListener('message', listener, true); + cw.postMessage( + { + type: 'rr-bridge-ensure-ref', + reqId, + selector: innerSel, + useText: !!request.useText, + isXPath: !!request.isXPath, + tagName: String(request.tagName || ''), + allowMultiple: !!request.allowMultiple, + }, + '*', + ); + return true; // async response via message bridge + } + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + // Support CSS selector, XPath, or visible text search + const useText = !!request.useText; + const textQuery = String(request.text || '').trim(); + const sel = String(request.selector || '').trim(); + const isXPath = !!request.isXPath; + const limitTag = String(request.tagName || '') + .trim() + .toUpperCase(); + let el = null; + if (useText && textQuery) { + const normalize = (s) => + String(s || '') + .replace(/\s+/g, ' ') + .trim() + .toLowerCase(); + const query = normalize(textQuery); + const bigrams = (s) => { + const arr = []; + for (let i = 0; i < s.length - 1; i++) arr.push(s.slice(i, i + 2)); + return arr; + }; + const dice = (a, b) => { + if (!a || !b) return 0; + const A = bigrams(a); + const B = bigrams(b); + if (A.length === 0 || B.length === 0) return 0; + let inter = 0; + const map = new Map(); + for (const t of A) map.set(t, (map.get(t) || 0) + 1); + for (const t of B) { + const c = map.get(t) || 0; + if (c > 0) { + inter++; + map.set(t, c - 1); + } + } + return (2 * inter) / (A.length + B.length); + }; + let best = { el: null, score: 0 }; + // Deep traversal including shadow roots + const stack = [document.documentElement]; + let visited = 0; + while (stack.length) { + const node = /** @type {any} */ (stack.pop()); + if (!node || !(node instanceof Element)) continue; + try { + if (limitTag && String(node.tagName || '').toUpperCase() !== limitTag) { + // still traverse into children/shadow for performance? yes + } else { + const cs = window.getComputedStyle(node); + if (cs.display === 'none' || cs.visibility === 'hidden' || cs.opacity === '0') { + /* skip hidden */ + } else { + const rect = /** @type {HTMLElement} */ (node).getBoundingClientRect(); + if (rect.width > 0 && rect.height > 0) { + const txt = normalize(node.textContent || ''); + if (txt) { + if (txt.includes(query)) { + el = /** @type {Element} */ (node); + break; + } + const sc = dice(txt, query); + if (sc > best.score) + best = { el: /** @type {Element} */ (node), score: sc }; + } + } + } + } + } catch {} + // push children and shadow children + try { + const children = node.children || []; + for (let i = 0; i < children.length; i++) stack.push(children[i]); + } catch {} + try { + const sr = node.shadowRoot; + if (sr && sr.children) { + for (let i = 0; i < sr.children.length; i++) stack.push(sr.children[i]); + } + } catch {} + if (++visited > 8000) break; + } + if (!el && best.el && best.score >= 0.6) el = best.el; + } else if (isXPath) { + if (!sel) { + sendResponse({ success: false, error: 'selector is required' }); + return true; + } + const result = queryXPathWithUniquenessCheck(sel, allowMultiple); + if (result.error) { + sendResponse({ success: false, error: result.error }); + return true; + } + if (result.matchCount === 0) { + sendResponse({ success: false, error: `selector not found: ${sel}` }); + return true; + } + if (!allowMultiple && result.matchCount > 1) { + sendResponse({ + success: false, + error: `Selector "${sel}" matched multiple elements. Please refine the selector to match only one element.`, + }); + return true; + } + el = result.element; + } else { + if (!sel) { + sendResponse({ success: false, error: 'selector is required' }); + return true; + } + const result = querySelectorWithUniquenessCheck(sel, allowMultiple); + if (result.error) { + sendResponse({ success: false, error: result.error }); + return true; + } + if (result.matchCount === 0) { + sendResponse({ success: false, error: `selector not found: ${sel}` }); + return true; + } + if (!allowMultiple && result.matchCount > 1) { + sendResponse({ + success: false, + error: `Selector "${sel}" matched multiple elements. Please refine the selector to match only one element.`, + }); + return true; + } + el = result.element; + } + if (!el) { + sendResponse({ success: false, error: `selector not found: ${sel}` }); + return true; + } + let refId = null; + for (const k in window.__claudeElementMap) { + if (window.__claudeElementMap[k].deref && window.__claudeElementMap[k].deref() === el) { + refId = k; + break; + } + } + if (!refId) { + refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + } + const rect = /** @type {HTMLElement} */ (el).getBoundingClientRect(); + sendResponse({ + success: true, + ref: refId, + center: { + x: Math.round(rect.left + rect.width / 2), + y: Math.round(rect.top + rect.height / 2), + }, + }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'dispatchHoverForRef') { + handleHoverForRef(String(request.ref || '').trim()) + .then((result) => sendResponse(result)) + .catch((error) => + sendResponse({ success: false, error: error?.message || String(error) }), + ); + return true; + } + if (request && request.action === 'getAttributeForSelector') { + try { + const sel = String(request.selector || '').trim(); + const name = String(request.name || '').trim(); + if (!sel || !name) { + sendResponse({ success: false, error: 'selector and name are required' }); + return true; + } + const el = document.querySelector(sel) || querySelectorDeepFirst(sel); + if (!el) { + sendResponse({ success: false, error: `selector not found: ${sel}` }); + return true; + } + let value = null; + if (name === 'text' || name === 'textContent') { + value = (el.textContent || '').trim(); + } else if (name === 'value') { + try { + value = /** @type {HTMLInputElement} */ (el).value ?? null; + } catch (_) { + value = el.getAttribute('value'); + } + } else { + value = el.getAttribute(name); + } + sendResponse({ success: true, value }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'collectVariables') { + try { + let vars = Array.isArray(request.variables) ? request.variables : []; + if ((!vars || vars.length === 0) && request.payload) { + try { + const p = JSON.parse(String(request.payload || '{}')); + if (Array.isArray(p.variables)) vars = p.variables; + } catch {} + } + const useOverlay = request.useOverlay !== false; // default true + const values = {}; + if (!useOverlay) { + for (const v of vars) { + const key = String(v && v.key ? v.key : ''); + if (!key) continue; + const label = v.label || key; + const def = v.default || ''; + const promptText = `请输入参数 ${label} (${key})`; + let val = window.prompt(promptText, def); + if (typeof val !== 'string') val = def; + values[key] = val; + } + sendResponse({ success: true, values }); + return true; + } + // Build overlay form + const hostId = '__rr_var_overlay__'; + let host = document.getElementById(hostId); + if (host) host.remove(); + host = document.createElement('div'); + host.id = hostId; + Object.assign(host.style, { + position: 'fixed', + inset: '0', + background: 'rgba(0,0,0,0.35)', + zIndex: 2147483646, + display: 'flex', + alignItems: 'center', + justifyContent: 'center', + }); + const panel = document.createElement('div'); + Object.assign(panel.style, { + background: '#fff', + borderRadius: '8px', + width: 'min(520px, 96vw)', + maxHeight: '80vh', + overflow: 'auto', + boxShadow: '0 8px 24px rgba(0,0,0,0.2)', + padding: '16px', + fontFamily: 'system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif', + }); + const title = document.createElement('div'); + title.textContent = '请输入回放参数'; + Object.assign(title.style, { fontSize: '16px', fontWeight: '600', marginBottom: '12px' }); + const form = document.createElement('form'); + for (const v of vars) { + const row = document.createElement('div'); + Object.assign(row.style, { marginBottom: '10px' }); + const label = document.createElement('label'); + label.textContent = `${v.label || v.key}${v.sensitive ? ' (敏感)' : ''}`; + Object.assign(label.style, { + display: 'block', + marginBottom: '6px', + fontWeight: '500', + }); + const input = document.createElement('input'); + input.type = v.sensitive ? 'password' : 'text'; + input.name = String(v.key); + input.value = String(v.default || ''); + Object.assign(input.style, { + width: '100%', + boxSizing: 'border-box', + padding: '8px 10px', + border: '1px solid #d0d7de', + borderRadius: '6px', + outline: 'none', + }); + row.appendChild(label); + row.appendChild(input); + form.appendChild(row); + } + const actions = document.createElement('div'); + Object.assign(actions.style, { display: 'flex', gap: '8px', marginTop: '12px' }); + const ok = document.createElement('button'); + ok.type = 'submit'; + ok.textContent = '确定'; + Object.assign(ok.style, { + background: '#0969da', + color: '#fff', + border: 'none', + padding: '8px 16px', + borderRadius: '6px', + cursor: 'pointer', + }); + const cancel = document.createElement('button'); + cancel.type = 'button'; + cancel.textContent = '取消'; + Object.assign(cancel.style, { + background: '#f3f4f6', + color: '#111', + border: '1px solid #d0d7de', + padding: '8px 16px', + borderRadius: '6px', + cursor: 'pointer', + }); + actions.appendChild(ok); + actions.appendChild(cancel); + panel.appendChild(title); + panel.appendChild(form); + panel.appendChild(actions); + host.appendChild(panel); + document.documentElement.appendChild(host); + + const cleanup = () => { + try { + host.remove(); + } catch {} + }; + cancel.onclick = () => { + cleanup(); + sendResponse({ success: false, cancelled: true }); + }; + form.onsubmit = (e) => { + e.preventDefault(); + for (const v of vars) { + const el = form.querySelector(`input[name="${CSS.escape(String(v.key))}"]`); + if (el) values[v.key] = /** @type {HTMLInputElement} */ (el).value; + } + cleanup(); + sendResponse({ success: true, values }); + }; + return true; // async + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'resolveRef') { + const ref = request.ref; + try { + const map = window.__claudeElementMap; + const weak = map && map[ref]; + const el = weak && typeof weak.deref === 'function' ? weak.deref() : null; + if (!el || !(el instanceof Element)) { + sendResponse({ success: false, error: `ref "${ref}" not found or expired` }); + return true; + } + const rect = /** @type {HTMLElement} */ (el).getBoundingClientRect(); + sendResponse({ + success: true, + rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height }, + center: { + x: Math.round(rect.left + rect.width / 2), + y: Math.round(rect.top + rect.height / 2), + }, + selector: (function () { + // Simple selector generation inline to avoid duplication + const generateSelector = function (node) { + if (!(node instanceof Element)) return ''; + if (node.id) { + const idSel = `#${CSS.escape(node.id)}`; + if (document.querySelectorAll(idSel).length === 1) return idSel; + } + // prefer unique class selectors if available + try { + const classes = Array.from(node.classList || []).filter( + (c) => c && /^[a-zA-Z0-9_-]+$/.test(c), + ); + for (const cls of classes) { + const sel = `.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + const tag = node.tagName ? node.tagName.toLowerCase() : ''; + for (const cls of classes) { + const sel = `${tag}.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + for (let i = 0; i < Math.min(classes.length, 3); i++) { + for (let j = i + 1; j < Math.min(classes.length, 3); j++) { + const sel = `.${CSS.escape(classes[i])}.${CSS.escape(classes[j])}`; + if (document.querySelectorAll(sel).length === 1) return sel; + } + } + } catch {} + for (const attr of ['data-testid', 'data-cy', 'name']) { + const val = node.getAttribute(attr); + if (val) { + const s = `[${attr}="${CSS.escape(val)}"]`; + if (document.querySelectorAll(s).length === 1) return s; + } + } + let path = ''; + let current = node; + while ( + current && + current.nodeType === Node.ELEMENT_NODE && + current.tagName !== 'BODY' + ) { + let sel = current.tagName.toLowerCase(); + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter( + (c) => c.tagName === current.tagName, + ); + if (siblings.length > 1) { + const idx = siblings.indexOf(current) + 1; + sel += `:nth-of-type(${idx})`; + } + } + path = path ? `${sel} > ${path}` : sel; + current = parent; + } + return path ? `body > ${path}` : 'body'; + }; + return generateSelector(el); + })(), + }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'verifyFingerprint') { + try { + const ref = String(request.ref || '').trim(); + const fingerprint = String(request.fingerprint || '').trim(); + if (!ref || !fingerprint) { + sendResponse({ success: false, error: 'ref and fingerprint are required' }); + return true; + } + const map = window.__claudeElementMap; + const weak = map && map[ref]; + const el = weak && typeof weak.deref === 'function' ? weak.deref() : null; + if (!el || !(el instanceof Element)) { + sendResponse({ success: false, error: `ref "${ref}" not found or expired` }); + return true; + } + // 验证指纹：解析存储的指纹并与当前元素对比 + const parts = fingerprint.split('|'); + const storedTag = parts[0] || 'unknown'; + const currentTag = el.tagName ? String(el.tagName).toLowerCase() : 'unknown'; + // Tag 必须匹配 + if (storedTag !== currentTag) { + sendResponse({ success: true, match: false }); + return true; + } + // 如果存储的指纹有 id，当前元素必须有相同的 id + const storedIdPart = parts.find((p) => p.startsWith('id=')); + if (storedIdPart) { + const storedId = storedIdPart.slice(3); + const currentId = el.id ? String(el.id).trim() : ''; + if (storedId !== currentId) { + sendResponse({ success: true, match: false }); + return true; + } + } + sendResponse({ success: true, match: true }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + if (request && request.action === 'focusByRef') { + try { + const ref = String(request.ref || ''); + const map = window.__claudeElementMap || {}; + const weak = map[ref]; + const el = weak && typeof weak.deref === 'function' ? weak.deref() : null; + if (!el || !(el instanceof Element)) { + sendResponse({ success: false, error: `ref "${ref}" not found or expired` }); + return true; + } + try { + /** @type {HTMLElement} */ (el).scrollIntoView({ + behavior: 'instant', + block: 'center', + inline: 'nearest', + }); + } catch {} + try { + /** @type {HTMLElement} */ (el).focus && /** @type {HTMLElement} */ (el).focus(); + } catch {} + sendResponse({ success: true }); + return true; + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + } + } catch (e) { + sendResponse({ success: false, error: e && e.message ? e.message : String(e) }); + return true; + } + return false; + }); + + console.log('Accessibility tree helper script loaded'); + // Cross-frame bridge: child listens for ensure-ref requests from parent (composite selector) + try { + window.addEventListener( + 'message', + (ev) => { + try { + const data = ev && ev.data; + // Handle hover-ref bridge requests from parent frame + if (data && data.type === 'rr-bridge-hover-ref') { + handleHoverForRef(data.ref) + .then((result) => { + ev.source?.postMessage( + { type: 'rr-bridge-hover-ref-result', reqId: data.reqId, result }, + '*', + ); + }) + .catch((error) => { + ev.source?.postMessage( + { + type: 'rr-bridge-hover-ref-result', + reqId: data.reqId, + result: { success: false, error: error?.message || String(error) }, + }, + '*', + ); + }); + return; + } + if (!data || data.type !== 'rr-bridge-ensure-ref') return; + const { reqId, selector, useText, isXPath, tagName } = data || {}; + const respond = (payload) => { + try { + ev.source && + ev.source.postMessage( + { type: 'rr-bridge-ensure-ref-result', reqId, ...payload }, + '*', + ); + } catch {} + }; + try { + const sel = String(selector || '').trim(); + const limitTag = String(tagName || '') + .trim() + .toUpperCase(); + let el = null; + if (useText && sel) { + const normalize = (s) => + String(s || '') + .replace(/\s+/g, ' ') + .trim() + .toLowerCase(); + const query = normalize(sel); + const bigrams = (s) => { + const arr = []; + for (let i = 0; i < s.length - 1; i++) arr.push(s.slice(i, i + 2)); + return arr; + }; + const dice = (a, b) => { + if (!a || !b) return 0; + const A = bigrams(a), + B = bigrams(b); + if (!A.length || !B.length) return 0; + let inter = 0; + const m = new Map(); + for (const t of A) m.set(t, (m.get(t) || 0) + 1); + for (const t of B) { + const c = m.get(t) || 0; + if (c > 0) { + inter++; + m.set(t, c - 1); + } + } + return (2 * inter) / (A.length + B.length); + }; + let best = { el: null, score: 0 }; + const stack = [document.documentElement]; + while (stack.length) { + const node = stack.pop(); + if (!node || !(node instanceof Element)) continue; + try { + if (limitTag && String(node.tagName || '').toUpperCase() !== limitTag) { + } else { + const cs = window.getComputedStyle(node); + if (cs.display !== 'none' && cs.visibility !== 'hidden' && cs.opacity !== '0') { + const rect = node.getBoundingClientRect(); + if (rect.width > 0 && rect.height > 0) { + const txt = normalize(node.textContent || ''); + if (txt) { + if (txt.includes(query)) { + el = node; + break; + } + const sc = dice(txt, query); + if (sc > best.score) best = { el: node, score: sc }; + } + } + } + } + } catch {} + try { + const children = node.children || []; + for (let i = 0; i < children.length; i++) stack.push(children[i]); + const sr = node.shadowRoot; + if (sr && sr.children) + for (let i = 0; i < sr.children.length; i++) stack.push(sr.children[i]); + } catch {} + } + if (!el && best.el) el = best.el; + } else if (isXPath) { + if (!sel) { + respond({ success: false, error: 'selector is required' }); + return; + } + const allowMultiple = !!data.allowMultiple; + const result = queryXPathWithUniquenessCheck(sel, allowMultiple); + if (result.error) { + respond({ success: false, error: result.error }); + return; + } + if (result.matchCount === 0) { + respond({ success: false, error: `Selector "${sel}" not found in child frame` }); + return; + } + if (!allowMultiple && result.matchCount > 1) { + respond({ + success: false, + error: `Selector "${sel}" matched multiple elements inside frame. Please refine the selector to match only one element.`, + }); + return; + } + el = result.element; + } else { + if (!sel) { + respond({ success: false, error: 'selector is required' }); + return; + } + const allowMultiple = !!data.allowMultiple; + const result = querySelectorWithUniquenessCheck(sel, allowMultiple); + if (result.error) { + respond({ success: false, error: result.error }); + return; + } + if (result.matchCount === 0) { + respond({ success: false, error: `Selector "${sel}" not found in child frame` }); + return; + } + if (!allowMultiple && result.matchCount > 1) { + respond({ + success: false, + error: `Selector "${sel}" matched multiple elements inside frame. Please refine the selector to match only one element.`, + }); + return; + } + el = result.element; + } + if (!el || !(el instanceof Element)) { + respond({ success: false, error: 'Element not found in child frame' }); + return; + } + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + let refId = null; + for (const k in window.__claudeElementMap) { + const w = window.__claudeElementMap[k]; + if (w && typeof w.deref === 'function' && w.deref && w.deref() === el) { + refId = k; + break; + } + } + if (!refId) { + refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + } + const rect = el.getBoundingClientRect(); + respond({ + success: true, + ref: refId, + center: { + x: Math.round(rect.left + rect.width / 2), + y: Math.round(rect.top + rect.height / 2), + }, + href: String(location && location.href ? location.href : ''), + }); + } catch (e) { + respond({ success: false, error: String(e && e.message ? e.message : e) }); + } + } catch {} + }, + true, + ); + } catch {} +})(); diff --git a/app/chrome-extension/inject-scripts/click-helper.js b/app/chrome-extension/inject-scripts/click-helper.js index f5ee600e..4b95de3f 100644 --- a/app/chrome-extension/inject-scripts/click-helper.js +++ b/app/chrome-extension/inject-scripts/click-helper.js @@ -21,13 +21,65 @@ if (window.__CLICK_HELPER_INITIALIZED__) { waitForNavigation = false, timeout = 5000, coordinates = null, + ref = null, + double = false, + options = {}, ) { try { let element = null; let elementInfo = null; let clickX, clickY; - if (coordinates && typeof coordinates.x === 'number' && typeof coordinates.y === 'number') { + if (ref && typeof ref === 'string') { + // Resolve element from weak map + let target = null; + try { + const map = window.__claudeElementMap; + const weak = map && map[ref]; + target = weak && typeof weak.deref === 'function' ? weak.deref() : null; + } catch (e) { + // ignore + } + + if (!target || !(target instanceof Element)) { + return { + error: `Element ref "${ref}" not found. Please call chrome_read_page first and ensure the ref is still valid.`, + }; + } + + element = target; + element.scrollIntoView({ behavior: 'auto', block: 'center', inline: 'center' }); + await new Promise((resolve) => setTimeout(resolve, 80)); + + const rect = element.getBoundingClientRect(); + clickX = rect.left + rect.width / 2; + clickY = rect.top + rect.height / 2; + elementInfo = { + tagName: element.tagName, + id: element.id, + className: element.className, + text: element.textContent?.trim().substring(0, 100) || '', + href: element.href || null, + type: element.type || null, + isVisible: true, + rect: { + x: rect.x, + y: rect.y, + width: rect.width, + height: rect.height, + top: rect.top, + right: rect.right, + bottom: rect.bottom, + left: rect.left, + }, + clickMethod: 'ref', + ref, + }; + } else if ( + coordinates && + typeof coordinates.x === 'number' && + typeof coordinates.y === 'number' + ) { clickX = coordinates.x; clickY = coordinates.y; @@ -125,10 +177,18 @@ if (window.__CLICK_HELPER_INITIALIZED__) { }); } - if (element && elementInfo.clickMethod === 'selector') { - element.click(); + if ( + element && + (elementInfo.clickMethod === 'selector' || elementInfo.clickMethod === 'ref') + ) { + if (double) { + dispatchClickSequence(element, clickX, clickY, options, true); + } else { + dispatchClickSequence(element, clickX, clickY, options, false); + } } else { - simulateClick(clickX, clickY); + if (double) simulateDoubleClick(clickX, clickY, options); + else simulateClick(clickX, clickY, options); } // Wait for navigation if needed @@ -155,21 +215,90 @@ if (window.__CLICK_HELPER_INITIALIZED__) { * @param {number} x - X coordinate relative to the viewport * @param {number} y - Y coordinate relative to the viewport */ - function simulateClick(x, y) { - const clickEvent = new MouseEvent('click', { - view: window, - bubbles: true, - cancelable: true, - clientX: x, - clientY: y, - }); + function simulateClick(x, y, options = {}) { + const element = document.elementFromPoint(x, y); + if (!element) return; + dispatchClickSequence(element, x, y, options, false); + } + /** + * Simulate a double click sequence at specific coordinates + */ + function simulateDoubleClick(x, y, options = {}) { const element = document.elementFromPoint(x, y); + if (!element) return; + dispatchClickSequence(element, x, y, options, true); + } - if (element) { - element.dispatchEvent(clickEvent); - } else { - document.dispatchEvent(clickEvent); + /** + * Simulate double click using element when available + */ + function simulateDomDoubleClick(element, x, y, options) { + dispatchClickSequence(element, x, y, options, true); + } + + function normalizeMouseOpts(x, y, options = {}) { + const bubbles = options.bubbles !== false; // default true + const cancelable = options.cancelable !== false; // default true + const altKey = !!(options.modifiers && options.modifiers.altKey); + const ctrlKey = !!(options.modifiers && options.modifiers.ctrlKey); + const metaKey = !!(options.modifiers && options.modifiers.metaKey); + const shiftKey = !!(options.modifiers && options.modifiers.shiftKey); + const btn = String(options.button || 'left'); + const button = btn === 'right' ? 2 : btn === 'middle' ? 1 : 0; + const buttons = btn === 'right' ? 2 : btn === 'middle' ? 4 : 1; + return { + bubbles, + cancelable, + altKey, + ctrlKey, + metaKey, + shiftKey, + button, + buttons, + clientX: x, + clientY: y, + view: window, + }; + } + + function dispatchClickSequence(element, x, y, options = {}, isDouble = false) { + const base = normalizeMouseOpts(x, y, options); + const down = new MouseEvent('mousedown', base); + const up = new MouseEvent('mouseup', base); + const click = new MouseEvent('click', base); + try { + element.dispatchEvent(down); + } catch {} + try { + element.dispatchEvent(up); + } catch {} + try { + element.dispatchEvent(click); + } catch {} + if (base.button === 2) { + // right button contextmenu + const ctx = new MouseEvent('contextmenu', base); + try { + element.dispatchEvent(ctx); + } catch {} + } + if (isDouble) { + // second sequence + dblclick + setTimeout(() => { + try { + element.dispatchEvent(new MouseEvent('mousedown', base)); + } catch {} + try { + element.dispatchEvent(new MouseEvent('mouseup', base)); + } catch {} + try { + element.dispatchEvent(new MouseEvent('click', base)); + } catch {} + try { + element.dispatchEvent(new MouseEvent('dblclick', base)); + } catch {} + }, 30); } } @@ -217,6 +346,14 @@ if (window.__CLICK_HELPER_INITIALIZED__) { request.waitForNavigation, request.timeout, request.coordinates, + request.ref, + !!request.double, + { + button: request.button, + bubbles: request.bubbles, + cancelable: request.cancelable, + modifiers: request.modifiers, + }, ) .then(sendResponse) .catch((error) => { diff --git a/app/chrome-extension/inject-scripts/dom-observer.js b/app/chrome-extension/inject-scripts/dom-observer.js new file mode 100644 index 00000000..c323f0d3 --- /dev/null +++ b/app/chrome-extension/inject-scripts/dom-observer.js @@ -0,0 +1,87 @@ +/* eslint-disable */ +// dom-observer.js - observe DOM for triggers and notify background +(function () { + if (window.__RR_DOM_OBSERVER__) return; + window.__RR_DOM_OBSERVER__ = true; + + const active = { triggers: [], hits: new Map() }; + + function now() { + return Date.now(); + } + + function applyTriggers(list) { + try { + active.triggers = Array.isArray(list) ? list.slice() : []; + active.hits.clear(); + checkAll(); + } catch (e) {} + } + + function checkAll() { + try { + for (const t of active.triggers) { + maybeFire(t); + } + } catch (e) {} + } + + function maybeFire(t) { + try { + const appear = t.appear !== false; // default true + const sel = String(t.selector || '').trim(); + if (!sel) return; + const exists = !!document.querySelector(sel); + const key = t.id; + const last = active.hits.get(key) || 0; + const debounce = Math.max(0, Number(t.debounceMs ?? 800)); + if (now() - last < debounce) return; + const should = appear ? exists : !exists; + if (should) { + active.hits.set(key, now()); + chrome.runtime.sendMessage({ + action: 'dom_trigger_fired', + triggerId: t.id, + url: location.href, + }); + if (t.once !== false) removeTrigger(t.id); + } + } catch (e) {} + } + + function removeTrigger(id) { + try { + active.triggers = active.triggers.filter((x) => x.id !== id); + } catch (e) {} + } + + const mo = new MutationObserver(() => { + checkAll(); + }); + try { + mo.observe(document.documentElement || document, { + childList: true, + subtree: true, + attributes: false, + characterData: false, + }); + } catch (e) {} + + chrome.runtime.onMessage.addListener((req, _sender, sendResponse) => { + try { + if (req && req.action === 'dom_observer_ping') { + sendResponse({ status: 'pong' }); + return false; + } + if (req && req.action === 'set_dom_triggers') { + applyTriggers(req.triggers || []); + sendResponse({ success: true, count: active.triggers.length }); + return true; + } + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + return false; + }); +})(); diff --git a/app/chrome-extension/inject-scripts/element-marker.js b/app/chrome-extension/inject-scripts/element-marker.js new file mode 100644 index 00000000..ccc837c2 --- /dev/null +++ b/app/chrome-extension/inject-scripts/element-marker.js @@ -0,0 +1,2802 @@ +/* eslint-disable */ +(function () { + if (window.__ELEMENT_MARKER_INSTALLED__) return; + window.__ELEMENT_MARKER_INSTALLED__ = true; + + const IS_MAIN = window === window.top; + + // ============================================================================ + // Utility Functions + // ============================================================================ + + function sleep(ms) { + return new Promise((resolve) => setTimeout(resolve, ms)); + } + + // ============================================================================ + // Constants & Configuration + // ============================================================================ + + const CONFIG = { + DEFAULTS: { + PREFS: { + preferId: true, + preferStableAttr: true, + preferClass: true, + }, + SELECTOR_TYPE: 'css', + LIST_MODE: false, + }, + Z_INDEX: { + OVERLAY: 2147483646, + HIGHLIGHTER: 2147483645, + RECTS: 2147483644, + }, + COLORS: { + PRIMARY: '#2563eb', + SUCCESS: '#10b981', + WARNING: '#f59e0b', + DANGER: '#ef4444', + HOVER: '#10b981', + VERIFY: '#3b82f6', + }, + }; + + // ============================================================================ + // Panel Host Module - Shadow DOM Management + // ============================================================================ + + const PanelHost = (() => { + let hostElement = null; + let shadowRoot = null; + + const PANEL_STYLES = ` + * { + box-sizing: border-box; + margin: 0; + padding: 0; + } + + .em-panel { + width: 400px; + background: #ffffff; + border-radius: 12px; + box-shadow: 0 10px 40px rgba(0, 0, 0, 0.15); + font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; + padding: 20px; + transition: opacity 150ms ease; + } + + + /* Header */ + .em-header { + display: flex; + align-items: center; + justify-content: space-between; + margin-bottom: 20px; + user-select: none; + } + + .em-title { + font-size: 20px; + font-weight: 500; + color: #262626; + } + + .em-header-actions { + display: flex; + gap: 4px; + align-items: center; + } + + .em-icon-btn { + width: 32px; + height: 32px; + display: flex; + align-items: center; + justify-content: center; + border: none; + background: transparent; + color: #a3a3a3; + cursor: pointer; + transition: color 150ms ease; + padding: 0; + } + + .em-icon-btn:hover { + color: #525252; + } + + .em-icon-btn svg { + width: 20px; + height: 20px; + stroke-width: 2; + } + + /* Controls Row */ + .em-controls { + display: flex; + gap: 8px; + margin-bottom: 12px; + } + + .em-select-wrapper { + flex: 1; + position: relative; + } + + .em-select { + width: 100%; + height: 44px; + padding: 0 40px 0 16px; + background: #f5f5f5; + color: #262626; + font-size: 15px; + border: none; + border-radius: 10px; + appearance: none; + cursor: pointer; + outline: none; + font-family: inherit; + font-weight: 400; + } + + .em-select-wrapper::after { + content: ''; + position: absolute; + right: 16px; + top: 50%; + transform: translateY(-50%); + width: 0; + height: 0; + border-left: 5px solid transparent; + border-right: 5px solid transparent; + border-top: 6px solid #737373; + pointer-events: none; + } + + .em-square-btn { + width: 44px; + height: 44px; + display: flex; + align-items: center; + justify-content: center; + background: #f5f5f5; + border: none; + border-radius: 10px; + cursor: pointer; + transition: background 150ms ease; + padding: 0; + } + + .em-square-btn:hover { + background: #e5e5e5; + } + + .em-square-btn.active { + background: #2563eb; + } + + .em-square-btn.active svg { + color: #ffffff; + } + + .em-square-btn svg { + width: 18px; + height: 18px; + color: #525252; + stroke-width: 2; + } + + /* Selector Display */ + .em-selector-display { + display: flex; + align-items: center; + gap: 10px; + height: 44px; + padding: 0 12px 0 16px; + background: #f5f5f5; + border-radius: 10px; + margin-bottom: 16px; + } + + .em-selector-display svg { + width: 18px; + height: 18px; + color: #a3a3a3; + flex-shrink: 0; + stroke-width: 2; + } + + .em-selector-text { + flex: 1; + font-size: 14px; + color: #525252; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + user-select: text; + } + + .em-selector-nav { + display: flex; + gap: 2px; + } + + .em-nav-btn { + width: 28px; + height: 28px; + display: flex; + align-items: center; + justify-content: center; + border: none; + background: transparent; + cursor: pointer; + transition: background 150ms ease; + border-radius: 6px; + padding: 0; + } + + .em-nav-btn:hover { + background: #e5e5e5; + } + + .em-nav-btn svg { + width: 16px; + height: 16px; + color: #525252; + stroke-width: 2; + } + + /* Tabs */ + .em-tabs { + display: inline-flex; + gap: 2px; + padding: 2px; + background: #f5f5f5; + border-radius: 8px; + margin-bottom: 16px; + } + + .em-tab { + padding: 6px 16px; + font-size: 12px; + font-weight: 500; + color: #737373; + background: transparent; + border: none; + border-radius: 6px; + cursor: pointer; + transition: all 150ms ease; + } + + .em-tab:hover { + color: #404040; + } + + .em-tab.active { + color: #262626; + background: #ffffff; + box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1); + } + + /* Content */ + .em-content { + margin-bottom: 0; + } + + #__em_tab_settings { + max-height: min(60vh, 480px); + overflow-y: auto; + scrollbar-width: none; /* Firefox */ + -ms-overflow-style: none; /* IE and Edge */ + } + + #__em_tab_settings::-webkit-scrollbar { + display: none; /* Chrome, Safari, Opera */ + } + + .em-section-title { + font-size: 13px; + color: #737373; + margin-bottom: 16px; + font-weight: 400; + } + + .em-attributes { + display: flex; + flex-direction: column; + gap: 12px; + } + + .em-attribute { + display: flex; + flex-direction: column; + gap: 6px; + } + + .em-attribute-label { + font-size: 12px; + color: #a3a3a3; + font-weight: 400; + } + + .em-attribute-value { + display: flex; + align-items: center; + gap: 10px; + min-height: 44px; + padding: 0 12px 0 16px; + background: #f5f5f5; + border-radius: 10px; + } + + .em-attribute-value.editable { + padding: 0 16px; + } + + .em-attribute-value svg { + width: 18px; + height: 18px; + stroke-width: 2; + cursor: pointer; + transition: color 150ms ease; + flex-shrink: 0; + } + + .em-attribute-value svg.copy-icon { + color: #a3a3a3; + } + + .em-attribute-value svg.copy-icon:hover { + color: #525252; + } + + .em-attribute-value svg.copy-icon.disabled { + color: #d4d4d4; + cursor: default; + } + + .em-attribute-text { + flex: 1; + font-size: 14px; + color: #404040; + user-select: text; + } + + .em-attribute-text.empty { + color: #a3a3a3; + } + + .em-input { + flex: 1; + border: none; + background: transparent; + font-size: 14px; + color: #404040; + font-family: inherit; + outline: none; + padding: 0; + height: 44px; + } + + .em-input::placeholder { + color: #a3a3a3; + } + + /* Settings Panel */ + .em-settings { + display: flex; + flex-direction: column; + gap: 16px; + } + + .em-settings-group { + display: flex; + flex-direction: column; + gap: 8px; + } + + .em-settings-label { + font-size: 12px; + font-weight: 500; + color: #737373; + } + + .em-checkbox-group { + display: flex; + flex-direction: column; + gap: 10px; + } + + .em-checkbox-label { + display: flex; + align-items: center; + gap: 8px; + font-size: 14px; + color: #404040; + cursor: pointer; + } + + .em-checkbox-label input[type="checkbox"] { + width: 18px; + height: 18px; + cursor: pointer; + margin: 0; + } + + /* Action Buttons */ + .em-actions { + display: flex; + gap: 8px; + margin-top: 20px; + } + + .em-btn { + flex: 1; + height: 40px; + border: none; + border-radius: 8px; + font-size: 14px; + font-weight: 600; + cursor: pointer; + transition: all 150ms ease; + } + + .em-btn-primary { + background: #2563eb; + color: #ffffff; + } + + .em-btn-primary:hover { + background: #1d4ed8; + transform: translateY(-1px); + box-shadow: 0 4px 12px rgba(37, 99, 235, 0.3); + } + + .em-btn-success { + background: #10b981; + color: #ffffff; + } + + .em-btn-success:hover { + background: #059669; + transform: translateY(-1px); + box-shadow: 0 4px 12px rgba(16, 185, 129, 0.3); + } + + .em-btn-ghost { + background: #f5f5f5; + color: #404040; + } + + .em-btn-ghost:hover { + background: #e5e5e5; + } + + /* Footer */ + .em-footer { + font-size: 12px; + color: #a3a3a3; + text-align: center; + margin-top: 16px; + } + + .em-footer kbd { + display: inline-block; + padding: 2px 6px; + background: #f5f5f5; + border-radius: 4px; + font-family: monospace; + font-size: 11px; + color: #737373; + } + + /* Status */ + .em-status { + font-size: 13px; + padding: 10px 12px; + border-radius: 8px; + margin-bottom: 12px; + display: flex; + align-items: center; + gap: 6px; + } + + .em-status.idle { + display: none; + } + + .em-status.running { + background: rgba(37, 99, 235, 0.1); + color: #2563eb; + } + + .em-status.success { + background: rgba(16, 185, 129, 0.1); + color: #10b981; + } + + .em-status.failure { + background: rgba(239, 68, 68, 0.1); + color: #ef4444; + } + + /* Grid Layout */ + .em-grid { + display: grid; + grid-template-columns: repeat(2, 1fr); + gap: 12px; + } + + .em-field { + display: flex; + flex-direction: column; + gap: 6px; + } + + .em-field-label { + font-size: 12px; + color: #a3a3a3; + } + + .em-field-input { + height: 40px; + padding: 0 12px; + background: #f5f5f5; + border: none; + border-radius: 8px; + font-size: 14px; + color: #404040; + font-family: inherit; + outline: none; + } + + .em-field-input:focus { + background: #e5e5e5; + } + + /* Details/Accordion */ + .em-details { + margin-top: 12px; + padding-top: 12px; + border-top: 1px solid #f5f5f5; + } + + .em-details summary { + cursor: pointer; + font-size: 13px; + font-weight: 600; + color: #737373; + padding: 8px 0; + user-select: none; + list-style: none; + } + + .em-details summary::-webkit-details-marker { + display: none; + } + + .em-details summary:hover { + color: #404040; + } + + .em-details[open] summary { + margin-bottom: 12px; + } + + /* Dragging state */ + body[data-em-dragging] { + user-select: none !important; + cursor: grabbing !important; + } + + body[data-em-dragging] * { + cursor: grabbing !important; + } + + /* SVG Icons */ + svg { + fill: none; + stroke: currentColor; + } + + .em-drag-handle { + cursor: grab; + } + + .em-drag-handle:active { + cursor: grabbing; + } + `; + + const PANEL_TEMPLATE = ` +
+ +
+

元素标注

+
+ +
+
+ + +
+
+ +
+ + +
+ + +
+ + + + Click an element to select +
+ + +
+
+ + +
+ + +
+ + +
+ + +
+

#1 Element

+ +
+
+
name
+
+ +
+
+ +
+
selector
+
+ + + + - +
+
+
+ +

Selector Preferences

+
+
+ + + +
+
+ +
+ +
+ +
+ + +
+
+ + + + + +
+ Click or press Space to select an element +
+
+ `; + + function mount() { + if (hostElement) return { host: hostElement, shadow: shadowRoot }; + + hostElement = document.createElement('div'); + hostElement.id = '__element_marker_overlay'; + Object.assign(hostElement.style, { + position: 'fixed', + top: '24px', + right: '24px', + zIndex: String(CONFIG.Z_INDEX.OVERLAY), + pointerEvents: 'none', + }); + + shadowRoot = hostElement.attachShadow({ mode: 'open' }); + shadowRoot.innerHTML = `${PANEL_TEMPLATE}`; + + hostElement.querySelector = (...args) => shadowRoot.querySelector(...args); + hostElement.querySelectorAll = (...args) => shadowRoot.querySelectorAll(...args); + + const panel = shadowRoot.querySelector('.em-panel'); + if (panel) { + panel.style.pointerEvents = 'auto'; + } + + document.documentElement.appendChild(hostElement); + return { host: hostElement, shadow: shadowRoot }; + } + + function unmount() { + if (hostElement?.parentNode) { + hostElement.parentNode.removeChild(hostElement); + } + hostElement = null; + shadowRoot = null; + } + + function getHost() { + return hostElement; + } + + function getShadow() { + return shadowRoot; + } + + return { + mount, + unmount, + getHost, + getShadow, + }; + })(); + + // ============================================================================ + // State Store Module - Centralized State Management + // ============================================================================ + + const StateStore = (() => { + const state = { + selectorType: CONFIG.DEFAULTS.SELECTOR_TYPE, + listMode: CONFIG.DEFAULTS.LIST_MODE, + prefs: { ...CONFIG.DEFAULTS.PREFS }, + activeTab: 'attributes', + validation: { + status: 'idle', + message: '', + }, + validationHistory: [], // Last 5 validation results + }; + + const listeners = new Set(); + + function init() { + return state; + } + + function get(key) { + return key ? state[key] : state; + } + + function set(partial) { + const changed = {}; + + Object.keys(partial).forEach((key) => { + if (JSON.stringify(state[key]) !== JSON.stringify(partial[key])) { + changed[key] = true; + state[key] = partial[key]; + } + }); + + if (Object.keys(changed).length === 0) return; + + if (changed.validation) { + updateValidationUI(); + } + if (changed.activeTab) { + updateTabUI(); + } + if (changed.listMode) { + updateListModeUI(); + } + if (changed.validationHistory) { + updateValidationHistoryUI(); + } + + notifyListeners(); + } + + function subscribe(callback) { + listeners.add(callback); + return () => listeners.delete(callback); + } + + function notifyListeners() { + listeners.forEach((cb) => { + try { + cb(state); + } catch (err) { + console.error('[StateStore] Listener error:', err); + } + }); + } + + function updateValidationUI() { + const statusEl = PanelHost.getShadow()?.getElementById('__em_status'); + if (!statusEl) return; + + const { status, message } = state.validation; + statusEl.className = `em-status ${status}`; + statusEl.textContent = message; + } + + function updateListModeUI() { + const shadow = PanelHost.getShadow(); + if (!shadow) return; + + const btn = shadow.getElementById('__em_toggle_list'); + if (!btn) return; + + if (state.listMode) { + btn.classList.add('active'); + } else { + btn.classList.remove('active'); + } + } + + function updateTabUI() { + const shadow = PanelHost.getShadow(); + if (!shadow) return; + + const tabs = shadow.querySelectorAll('.em-tab'); + tabs.forEach((tab) => { + if (tab.dataset.tab === state.activeTab) { + tab.classList.add('active'); + } else { + tab.classList.remove('active'); + } + }); + + const attrContent = shadow.getElementById('__em_tab_attributes'); + const executeContent = shadow.getElementById('__em_tab_execute'); + + if (attrContent) + attrContent.style.display = state.activeTab === 'attributes' ? 'block' : 'none'; + if (executeContent) + executeContent.style.display = state.activeTab === 'execute' ? 'block' : 'none'; + + // Sync interaction mode when tab changes + syncInteractionMode(); + } + + function updateValidationHistoryUI() { + const shadow = PanelHost.getShadow(); + if (!shadow) return; + + const historyContainer = shadow.getElementById('__em_execution_history'); + const historyList = shadow.getElementById('__em_history_list'); + if (!historyContainer || !historyList) return; + + if (state.validationHistory.length === 0) { + historyContainer.style.display = 'none'; + return; + } + + historyContainer.style.display = 'block'; + historyList.innerHTML = state.validationHistory + .slice(-5) + .reverse() + .map((entry) => { + const icon = entry.success ? '✓' : '✗'; + const color = entry.success ? '#10b981' : '#ef4444'; + const timestamp = new Date(entry.timestamp).toLocaleTimeString(); + return `
+ ${icon} + ${entry.action} + ${timestamp} +
`; + }) + .join(''); + } + + return { + init, + get, + set, + subscribe, + }; + })(); + + // ============================================================================ + // Drag Controller Module + // ============================================================================ + + const DragController = (() => { + let dragging = false; + let startPos = { x: 0, y: 0 }; + let startOffset = { top: 0, right: 0 }; + + function init(handleElement) { + if (!handleElement) return; + handleElement.addEventListener('mousedown', onDragStart); + } + + function onDragStart(event) { + event.preventDefault(); + dragging = true; + + const host = PanelHost.getHost(); + if (!host) return; + + startPos = { x: event.clientX, y: event.clientY }; + startOffset = { + top: parseInt(host.style.top) || 0, + right: parseInt(host.style.right) || 0, + }; + + document.addEventListener('mousemove', onDragMove, { capture: true, passive: false }); + document.addEventListener('mouseup', onDragEnd, { capture: true, passive: false }); + document.body.setAttribute('data-em-dragging', 'true'); + } + + function onDragMove(event) { + if (!dragging) return; + event.preventDefault(); + event.stopPropagation(); + + const host = PanelHost.getHost(); + if (!host) return; + + const deltaX = event.clientX - startPos.x; + const deltaY = event.clientY - startPos.y; + + const newTop = Math.max(8, startOffset.top + deltaY); + const newRight = Math.max(8, startOffset.right - deltaX); + + host.style.top = `${newTop}px`; + host.style.right = `${newRight}px`; + } + + function onDragEnd(event) { + if (!dragging) return; + event.preventDefault(); + event.stopPropagation(); + + dragging = false; + document.removeEventListener('mousemove', onDragMove, { capture: true }); + document.removeEventListener('mouseup', onDragEnd, { capture: true }); + document.body.removeAttribute('data-em-dragging'); + } + + function destroy() { + if (dragging) { + onDragEnd(new MouseEvent('mouseup')); + } + } + + return { init, destroy }; + })(); + + // [继续下一部分...] + // ============================================================================ + // Selector Engine - Heuristic Selector Generation + // ============================================================================ + + function generateSelector(el) { + if (!(el instanceof Element)) return ''; + + const prefs = StateStore.get('prefs'); + + if (prefs.preferId && el.id) { + const idSel = `#${CSS.escape(el.id)}`; + if (isDeepSelectorUnique(idSel, el)) return idSel; + } + + if (prefs.preferStableAttr) { + const attrNames = [ + 'data-testid', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + 'title', + 'alt', + 'aria-label', + ]; + const tag = el.tagName.toLowerCase(); + + for (const attr of attrNames) { + const v = el.getAttribute(attr); + if (!v) continue; + const attrSel = `[${attr}="${CSS.escape(v)}"]`; + const testSel = /^(input|textarea|select)$/i.test(tag) ? `${tag}${attrSel}` : attrSel; + if (isDeepSelectorUnique(testSel, el)) return testSel; + } + } + + if (prefs.preferClass) { + try { + const classes = Array.from(el.classList || []).filter( + (c) => c && /^[a-zA-Z0-9_-]+$/.test(c), + ); + const tag = el.tagName.toLowerCase(); + + for (const cls of classes) { + const sel = `.${CSS.escape(cls)}`; + if (isDeepSelectorUnique(sel, el)) return sel; + } + + for (const cls of classes) { + const sel = `${tag}.${CSS.escape(cls)}`; + if (isDeepSelectorUnique(sel, el)) return sel; + } + + for (let i = 0; i < Math.min(classes.length, 3); i++) { + for (let j = i + 1; j < Math.min(classes.length, 3); j++) { + const sel = `.${CSS.escape(classes[i])}.${CSS.escape(classes[j])}`; + if (isDeepSelectorUnique(sel, el)) return sel; + } + } + } catch {} + } + + if (prefs.preferStableAttr) { + try { + let cur = el; + const anchorAttrs = [ + 'id', + 'data-testid', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + ]; + + // Detect shadow DOM boundary + const root = el.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + const boundary = isShadowElement ? root.host : document.body; + + while (cur && cur !== boundary) { + if (cur.id) { + const anchor = `#${CSS.escape(cur.id)}`; + if (isDeepSelectorUnique(anchor, cur)) { + const rel = buildPathFromAncestor(cur, el); + const composed = rel ? `${anchor} ${rel}` : anchor; + if (isDeepSelectorUnique(composed, el)) return composed; + } + } + + for (const attr of anchorAttrs) { + const val = cur.getAttribute(attr); + if (!val) continue; + const aSel = `[${attr}="${CSS.escape(val)}"]`; + if (isDeepSelectorUnique(aSel, cur)) { + const rel = buildPathFromAncestor(cur, el); + const composed = rel ? `${aSel} ${rel}` : aSel; + if (isDeepSelectorUnique(composed, el)) return composed; + } + } + cur = cur.parentElement; + } + } catch {} + } + + return buildFullPath(el); + } + + function buildPathFromAncestor(ancestor, target) { + const segs = []; + let cur = target; + + // Detect if we're inside shadow DOM + const root = target.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + const boundary = isShadowElement ? root.host : document.body; + + while (cur && cur !== ancestor && cur !== boundary) { + let seg = cur.tagName.toLowerCase(); + const parent = cur.parentElement; + + if (parent) { + const siblings = Array.from(parent.children).filter((c) => c.tagName === cur.tagName); + if (siblings.length > 1) { + seg += `:nth-of-type(${siblings.indexOf(cur) + 1})`; + } + } + + segs.unshift(seg); + cur = parent; + + // Stop if we've reached the shadow root host + if (isShadowElement && cur === boundary) { + break; + } + } + + return segs.join(' > '); + } + + function buildFullPath(el) { + let path = ''; + let current = el; + + // Detect if the element is inside a shadow DOM + const root = el.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + + // Determine the boundary where we should stop traversing + const boundary = isShadowElement ? root.host : document.body; + + while (current && current.nodeType === Node.ELEMENT_NODE && current !== boundary) { + let sel = current.tagName.toLowerCase(); + const parent = current.parentElement; + + if (parent) { + const siblings = Array.from(parent.children).filter((c) => c.tagName === current.tagName); + if (siblings.length > 1) { + sel += `:nth-of-type(${siblings.indexOf(current) + 1})`; + } + } + + path = path ? `${sel} > ${path}` : sel; + current = parent; + + // Stop if we've reached the shadow root host + if (isShadowElement && current === boundary) { + break; + } + } + + // For shadow DOM elements, don't prepend "body >" + // The selector should be relative within the shadow tree + if (isShadowElement) { + return path || el.tagName.toLowerCase(); + } + + // For light DOM elements, keep the original behavior + return path ? `body > ${path}` : 'body'; + } + + function generateXPath(el) { + if (!(el instanceof Element)) return ''; + if (el.id) return `//*[@id="${el.id}"]`; + + const segs = []; + let cur = el; + + while (cur && cur.nodeType === 1 && cur !== document.documentElement) { + const tag = cur.tagName.toLowerCase(); + + if (cur.id) { + segs.unshift(`//*[@id="${cur.id}"]`); + break; + } + + let i = 1; + let sib = cur; + while ((sib = sib.previousElementSibling)) { + if (sib.tagName.toLowerCase() === tag) i++; + } + + segs.unshift(`${tag}[${i}]`); + cur = cur.parentElement; + } + + return segs[0]?.startsWith('//*') ? segs.join('/') : '//' + segs.join('/'); + } + + function generateListSelector(target) { + const list = computeElementList(target); + const selected = list?.[0] || target; + const parent = selected.parentElement; + + if (!parent) return generateSelector(target); + + const parentSel = generateSelector(parent); + const childRel = generateSelectorWithinRoot(selected, parent); + + return parentSel && childRel ? `${parentSel} ${childRel}` : generateSelector(target); + } + + function generateSelectorWithinRoot(el, root) { + if (!(el instanceof Element)) return ''; + + const tag = el.tagName.toLowerCase(); + + // Use isDeepSelectorUnique for ID to support shadow DOM elements + if (el.id) { + const idSel = `#${CSS.escape(el.id)}`; + if (isDeepSelectorUnique(idSel, el)) return idSel; + } + + const attrNames = [ + 'data-testid', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + 'title', + 'alt', + 'aria-label', + ]; + + // Use isDeepSelectorUnique for attributes to support shadow DOM elements + for (const attr of attrNames) { + const v = el.getAttribute(attr); + if (!v) continue; + const aSel = `[${attr}="${CSS.escape(v)}"]`; + const testSel = /^(input|textarea|select)$/i.test(tag) ? `${tag}${aSel}` : aSel; + if (isDeepSelectorUnique(testSel, el)) return testSel; + } + + try { + const classes = Array.from(el.classList || []).filter((c) => c && /^[a-zA-Z0-9_-]+$/.test(c)); + + // Use isDeepSelectorUnique for classes to support shadow DOM elements + for (const cls of classes) { + const sel = `.${CSS.escape(cls)}`; + if (isDeepSelectorUnique(sel, el)) return sel; + } + + for (const cls of classes) { + const sel = `${tag}.${CSS.escape(cls)}`; + if (isDeepSelectorUnique(sel, el)) return sel; + } + } catch {} + + return buildPathFromAncestor(root, el); + } + + function getAccessibleName(el) { + try { + const labelledby = el.getAttribute('aria-labelledby'); + if (labelledby) { + const labelEl = document.getElementById(labelledby); + if (labelEl) return (labelEl.textContent || '').trim(); + } + + const ariaLabel = el.getAttribute('aria-label'); + if (ariaLabel) return ariaLabel.trim(); + + if (el.id) { + const label = document.querySelector(`label[for="${el.id}"]`); + if (label) return (label.textContent || '').trim(); + } + + const parentLabel = el.closest('label'); + if (parentLabel) return (parentLabel.textContent || '').trim(); + + return ( + el.getAttribute('placeholder') || + el.getAttribute('value') || + el.textContent || + '' + ).trim(); + } catch { + return ''; + } + } + + // ============================================================================ + // List Mode Utilities + // ============================================================================ + + function getAllSiblings(el, selector) { + const siblings = [el]; + const validate = (element) => { + const isSameTag = el.tagName === element.tagName; + let ok = isSameTag; + if (selector) { + try { + ok = ok && !!element.querySelector(selector); + } catch {} + } + return ok; + }; + + let next = el; + let prev = el; + let elementIndex = 1; + + while ((prev = prev?.previousElementSibling)) { + if (validate(prev)) { + elementIndex += 1; + siblings.unshift(prev); + } + } + + while ((next = next?.nextElementSibling)) { + if (validate(next)) siblings.push(next); + } + + return { elements: siblings, index: elementIndex }; + } + + function getElementList(el, maxDepth = 50, paths = []) { + if (maxDepth === 0 || !el || el.tagName === 'BODY') return null; + + let selector = el.tagName.toLowerCase(); + const { elements, index } = getAllSiblings(el, paths.join(' > ')); + let siblings = elements; + + if (index !== 1) selector += `:nth-of-type(${index})`; + paths.unshift(selector); + + if (siblings.length === 1) { + siblings = getElementList(el.parentElement, maxDepth - 1, paths); + } + + return siblings; + } + + function computeElementList(target) { + try { + return getElementList(target) || [target]; + } catch { + return [target]; + } + } + + // ============================================================================ + // Deep Query (Shadow DOM Support) + // ============================================================================ + + function* walkAllNodesDeep(root) { + const stack = [root]; + let count = 0; + const MAX = 10000; + + while (stack.length) { + const node = stack.pop(); + if (!node || ++count > MAX) continue; + + // Skip overlay elements to prevent panel self-highlighting + if (isOverlayElement(node)) { + continue; + } + + yield node; + + try { + if (node.children) { + const children = Array.from(node.children); + for (let i = children.length - 1; i >= 0; i--) { + stack.push(children[i]); + } + } + + if (node.shadowRoot?.children) { + const srChildren = Array.from(node.shadowRoot.children); + for (let i = srChildren.length - 1; i >= 0; i--) { + stack.push(srChildren[i]); + } + } + } catch {} + } + } + + function queryAllDeep(selector) { + const results = []; + for (const node of walkAllNodesDeep(document)) { + if (!(node instanceof Element)) continue; + try { + if (node.matches(selector)) results.push(node); + } catch {} + } + return results; + } + + /** + * Check if a selector uniquely identifies the target element across the entire DOM tree, + * including shadow DOM boundaries. + * + * This function uses queryAllDeep to traverse both light DOM and shadow DOM, + * ensuring that selectors work correctly for elements inside shadow roots. + * + * @param {string} selector - The CSS selector to test + * @param {Element} target - The target element that should be uniquely identified + * @returns {boolean} True if the selector matches exactly one element and it's the target + */ + function isDeepSelectorUnique(selector, target) { + if (!selector || !(target instanceof Element)) return false; + try { + const matches = queryAllDeep(selector); + return matches.length === 1 && matches[0] === target; + } catch (error) { + return false; + } + } + + function evaluateXPathAll(xpath) { + try { + const arr = []; + const res = document.evaluate( + xpath, + document, + null, + XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, + null, + ); + + for (let i = 0; i < res.snapshotLength; i++) { + const n = res.snapshotItem(i); + // Filter out overlay elements to prevent panel self-highlighting + if (n?.nodeType === 1 && !isOverlayElement(n)) { + arr.push(n); + } + } + return arr; + } catch { + return []; + } + } + + // ============================================================================ + // Highlighter & Rects Management + // ============================================================================ + + const STATE = { + active: false, + hoverEl: null, + selectedEl: null, + box: null, + highlighter: null, + listenersAttached: false, + rectsHost: null, + hoveredList: [], + verifyRectsActive: false, // Track if verify rects are showing + // Performance optimization: rAF throttling for hover + hoverRafId: null, + lastHoverTarget: null, + // DOM pooling for rect elements + rectPool: [], + rectPoolUsed: 0, + }; + + function ensureHighlighter() { + if (STATE.highlighter) return STATE.highlighter; + + const hl = document.createElement('div'); + hl.id = '__element_marker_highlight'; + Object.assign(hl.style, { + position: 'fixed', + zIndex: String(CONFIG.Z_INDEX.HIGHLIGHTER), + pointerEvents: 'none', + border: `2px solid ${CONFIG.COLORS.HOVER}`, + borderRadius: '4px', + boxShadow: `0 0 0 2px ${CONFIG.COLORS.HOVER}33`, + transition: 'all 100ms ease-out', + }); + + document.documentElement.appendChild(hl); + STATE.highlighter = hl; + return hl; + } + + function ensureRectsHost() { + if (STATE.rectsHost) return STATE.rectsHost; + + const host = document.createElement('div'); + host.id = '__element_marker_rects'; + Object.assign(host.style, { + position: 'fixed', + zIndex: String(CONFIG.Z_INDEX.RECTS), + pointerEvents: 'none', + inset: '0', + }); + + document.documentElement.appendChild(host); + STATE.rectsHost = host; + return host; + } + + function moveHighlighterTo(el) { + const hl = ensureHighlighter(); + const r = el.getBoundingClientRect(); + hl.style.left = `${r.left}px`; + hl.style.top = `${r.top}px`; + hl.style.width = `${r.width}px`; + hl.style.height = `${r.height}px`; + hl.style.display = 'block'; + } + + function clearHighlighter() { + if (STATE.highlighter) STATE.highlighter.style.display = 'none'; + // Only clear hover rects, not verify rects + if (!STATE.verifyRectsActive) { + clearRects(); + } + } + + function clearRects() { + // Hide all pooled rect boxes instead of destroying them + const used = STATE.rectPoolUsed || 0; + for (let i = 0; i < used; i++) { + const box = STATE.rectPool[i]; + if (box) box.style.display = 'none'; + } + STATE.rectPoolUsed = 0; + STATE.verifyRectsActive = false; + // Invalidate lastHoverTarget so next hover will redraw even on same element + STATE.lastHoverTarget = null; + } + + /** + * Get or create a rect box from the pool + * @param {HTMLElement} host - The container element + * @param {number} index - The pool index + * @returns {HTMLDivElement} The rect box element + */ + function getOrCreateRectBox(host, index) { + let box = STATE.rectPool[index]; + if (!box) { + box = document.createElement('div'); + Object.assign(box.style, { + position: 'fixed', + pointerEvents: 'none', + borderRadius: '4px', + transition: 'all 100ms ease-out', + display: 'none', + }); + STATE.rectPool[index] = box; + } + // Ensure the box is attached to the host + if (!box.isConnected) { + host.appendChild(box); + } + return box; + } + + // Maximum rect pool size to prevent memory bloat + const MAX_RECT_POOL_SIZE = 100; + + /** + * Draw rect boxes with pooling optimization + * @param {Array<{x: number, y: number, width: number, height: number}>} rects - Rect data + * @param {Object} options - Drawing options + * @param {boolean} options.isVerify - Whether this is a verify highlight (affects verifyRectsActive) + */ + function drawRectBoxes( + rects, + { color = CONFIG.COLORS.HOVER, dashed = true, offsetX = 0, offsetY = 0, isVerify = false } = {}, + ) { + const host = ensureRectsHost(); + const prevUsed = STATE.rectPoolUsed || 0; + // Limit rect count to prevent memory bloat + const count = Math.min(Array.isArray(rects) ? rects.length : 0, MAX_RECT_POOL_SIZE); + + // Update or show rect boxes + for (let i = 0; i < count; i++) { + const r = rects[i]; + if (!r) continue; + + const x = Number.isFinite(r.left) ? r.left : Number.isFinite(r.x) ? r.x : 0; + const y = Number.isFinite(r.top) ? r.top : Number.isFinite(r.y) ? r.y : 0; + const w = Number.isFinite(r.width) ? r.width : 0; + const h = Number.isFinite(r.height) ? r.height : 0; + + const box = getOrCreateRectBox(host, i); + Object.assign(box.style, { + left: `${offsetX + x}px`, + top: `${offsetY + y}px`, + width: `${w}px`, + height: `${h}px`, + border: `2px ${dashed ? 'dashed' : 'solid'} ${color}`, + boxShadow: `0 0 0 2px ${color}22`, + display: 'block', + }); + } + + // Hide excess boxes from previous render + for (let i = count; i < prevUsed; i++) { + const box = STATE.rectPool[i]; + if (box) box.style.display = 'none'; + } + + STATE.rectPoolUsed = count; + // Reset verifyRectsActive for hover operations (so clearHighlighter works correctly) + // Only set to true when isVerify is explicitly true + STATE.verifyRectsActive = isVerify; + } + + function drawRects(elements, color = CONFIG.COLORS.HOVER, dashed = true, isVerify = false) { + const rects = elements.map((el) => { + const r = el.getBoundingClientRect(); + return { x: r.left, y: r.top, width: r.width, height: r.height }; + }); + drawRectBoxes(rects, { color, dashed, isVerify }); + } + + // ============================================================================ + // Interaction Logic + // ============================================================================ + + function isInsidePanel(target) { + const shadow = PanelHost.getShadow(); + return !!shadow && target instanceof Node && shadow.contains(target); + } + + /** + * Check if a node belongs to the element marker overlay (panel host or its shadow DOM) + * This is used to filter out overlay elements from query results to prevent self-highlighting + * + * @param {Node} node - The node to check + * @returns {boolean} True if the node is part of the overlay + */ + function isOverlayElement(node) { + if (!(node instanceof Node)) return false; + + const host = PanelHost.getHost(); + if (!host) return false; + + // Check if node is the panel host itself + if (node === host) return true; + + // Check if node is within the shadow DOM of the panel host + const root = typeof node.getRootNode === 'function' ? node.getRootNode() : null; + return root instanceof ShadowRoot && root.host === host; + } + + /** + * Filter out overlay elements from an array of elements + * This ensures that panel components are never included in highlight/verification results + * + * @param {Array} elements - Array of elements to filter + * @returns {Array} Filtered array without overlay elements + */ + function filterOverlayElements(elements) { + if (!Array.isArray(elements)) return []; + return elements.filter((node) => !isOverlayElement(node)); + } + + /** + * Get the effective event target for page element selection, considering shadow DOM boundaries. + * + * This function resolves the real target element from a pointer event by walking the + * composed path (if available) to find the innermost page element, skipping overlay elements. + * + * Background: + * - When events bubble up from inside shadow DOM, they get "retargeted" at shadow boundaries + * - By the time a window-level listener receives the event, ev.target points to the shadow host + * - composedPath() exposes the original event path before retargeting + * - This allows us to select elements inside shadow DOM (e.g., internals) + * + * IMPORTANT: This function should only be called AFTER verifying the event is not from + * overlay UI (panel buttons, etc). Otherwise it will filter out overlay elements and break + * panel interactions. + * + * @param {Event} ev - The pointer event (mousemove, click, etc.) + * @returns {Element|null} The innermost non-overlay page element, or null if none found + */ + function getDeepPageTarget(ev) { + if (!ev) return null; + + // Try to walk the composed path to find the innermost non-overlay element + try { + const path = typeof ev.composedPath === 'function' ? ev.composedPath() : null; + if (Array.isArray(path) && path.length > 0) { + // Walk from innermost to outermost, find the first real page element + for (const node of path) { + if (node instanceof Element && !isOverlayElement(node)) { + return node; + } + } + } + } catch (error) { + // composedPath() may throw in some edge cases (e.g., detached nodes) + // Fall through to use ev.target + } + + // Fallback: use ev.target if composedPath is unavailable or all nodes were filtered + const fallback = ev.target instanceof Element ? ev.target : null; + // If fallback is overlay, return null (caller should handle this case) + if (fallback && !isOverlayElement(fallback)) { + return fallback; + } + return null; + } + + // Store pending hover event for rAF processing + let pendingHoverEvent = null; + + /** + * Process mouse move event - the actual hover update logic + * Separated from onMouseMove for rAF throttling + */ + function processMouseMove(ev) { + if (!STATE.active) return; + + const rawTarget = ev?.target; + if (!(rawTarget instanceof Element)) { + STATE.hoverEl = null; + STATE.lastHoverTarget = null; + clearHighlighter(); + return; + } + + const host = PanelHost.getHost(); + if ((host && rawTarget === host) || isInsidePanel(rawTarget)) { + STATE.hoverEl = null; + STATE.lastHoverTarget = null; + clearHighlighter(); + return; + } + + const target = getDeepPageTarget(ev) || rawTarget; + STATE.hoverEl = target; + + // Get current listMode + let listMode = false; + try { + listMode = !!StateStore.get('listMode'); + } catch {} + + // Skip update if target and mode haven't changed + const last = STATE.lastHoverTarget; + if (last && last.element === target && last.listMode === listMode) { + return; + } + STATE.lastHoverTarget = { element: target, listMode }; + + if (!IS_MAIN) { + try { + const list = listMode ? computeElementList(target) || [target] : [target]; + const rects = list.map((el) => { + const r = el.getBoundingClientRect(); + return { x: r.left, y: r.top, width: r.width, height: r.height }; + }); + + // Performance: Don't generate selector on hover (defer to click) + window.top.postMessage({ type: 'em_hover', rects }, '*'); + } catch {} + return; + } + + if (listMode) { + STATE.hoveredList = computeElementList(target) || [target]; + drawRects(STATE.hoveredList); + } else { + moveHighlighterTo(target); + } + } + + /** + * Mouse move handler with rAF throttling + * Ensures hover updates are batched to animation frame rate + */ + function onMouseMove(ev) { + if (!STATE.active) return; + + // Store the latest event + pendingHoverEvent = ev; + + // Skip if already scheduled + if (STATE.hoverRafId != null) return; + + // Schedule processing on next animation frame + STATE.hoverRafId = requestAnimationFrame(() => { + STATE.hoverRafId = null; + const latest = pendingHoverEvent; + pendingHoverEvent = null; + if (!latest) return; + processMouseMove(latest); + }); + } + + // ============================================================================ + // Event Listeners Management + // ============================================================================ + + function attachPointerListeners() { + if (STATE.listenersAttached) return; + window.addEventListener('mousemove', onMouseMove, true); + window.addEventListener('click', onClick, true); + STATE.listenersAttached = true; + } + + function detachPointerListeners() { + if (!STATE.listenersAttached) return; + window.removeEventListener('mousemove', onMouseMove, true); + window.removeEventListener('click', onClick, true); + STATE.listenersAttached = false; + } + + function attachKeyboardListener() { + window.addEventListener('keydown', onKeyDown, true); + } + + function detachKeyboardListener() { + window.removeEventListener('keydown', onKeyDown, true); + } + + function syncInteractionMode() { + if (!STATE.active) return; + const activeTab = StateStore.get('activeTab'); + if (activeTab === 'execute') { + // In execute mode, detach pointer listeners to allow real interactions + // but keep keyboard listener for Esc key + detachPointerListeners(); + // Only clear the hover highlighter, not the verification rects + if (STATE.highlighter) STATE.highlighter.style.display = 'none'; + } else { + // In attributes mode, attach all listeners for element selection + attachPointerListeners(); + } + } + + // ============================================================================ + // Event Handlers + // ============================================================================ + + function onClick(ev) { + if (!STATE.active) return; + + // First, use the raw ev.target to check for overlay UI + // This ensures panel buttons and other UI elements remain interactive + const rawTarget = ev.target; + const host = PanelHost.getHost(); + + // Check if raw target is the panel host itself or inside the shadow DOM + // IMPORTANT: Return early WITHOUT preventDefault to allow overlay button clicks + if ((host && rawTarget === host) || isInsidePanel(rawTarget)) { + return; + } + + // Now we know it's a page element, prevent default and get deep target + ev.preventDefault(); + ev.stopPropagation(); + + if (!(rawTarget instanceof Element)) return; + + // Get the deep target (considering shadow DOM) after confirming it's not overlay + const target = getDeepPageTarget(ev) || rawTarget; + + if (!IS_MAIN) { + try { + const selectorType = StateStore.get('selectorType'); + const listMode = StateStore.get('listMode'); + + const sel = + selectorType === 'xpath' + ? generateXPath(target) + : listMode + ? generateListSelector(target) + : generateSelector(target); + + window.top.postMessage({ type: 'em_click', innerSel: sel }, '*'); + } catch {} + return; + } + + setSelection(target); + } + + function onKeyDown(e) { + if (!STATE.active) return; + + // Check if the focused element is inside the panel - if so, don't handle selection keys + if (isInsidePanel(e.target)) { + // Key event is from panel, don't interfere + if (e.key !== 'Escape') return; // Still allow Escape to close + } + + // In execute mode, only handle Escape to close - don't intercept other keys + // This allows real page interactions (typing, scrolling, etc.) + const activeTab = StateStore.get('activeTab'); + if (activeTab === 'execute') { + if (e.key === 'Escape') { + e.preventDefault(); + stop(); + } + return; // Don't intercept Space/Arrow keys in execute mode + } + + if (e.key === 'Escape') { + e.preventDefault(); + stop(); + } else if (e.key === ' ' || e.code === 'Space') { + e.preventDefault(); + const t = STATE.hoverEl || STATE.selectedEl; + if (t) setSelection(t); + } else if (e.key === 'ArrowUp') { + e.preventDefault(); + const base = STATE.selectedEl || STATE.hoverEl; + if (base?.parentElement) setSelection(base.parentElement); + } else if (e.key === 'ArrowDown') { + e.preventDefault(); + const base = STATE.selectedEl || STATE.hoverEl; + if (base?.firstElementChild) setSelection(base.firstElementChild); + } + } + + function setSelection(el) { + if (!(el instanceof Element)) return; + + STATE.selectedEl = el; + + const selectorType = StateStore.get('selectorType'); + const listMode = StateStore.get('listMode'); + + const sel = + selectorType === 'xpath' + ? generateXPath(el) + : listMode + ? generateListSelector(el) + : generateSelector(el); + + const name = getAccessibleName(el) || el.tagName.toLowerCase(); + + const selectorText = STATE.box?.querySelector('#__em_selector'); + const inputName = STATE.box?.querySelector('#__em_name'); + const selectorDisplay = STATE.box?.querySelector('#__em_selector_text'); + + if (selectorText) selectorText.textContent = sel; + if (selectorDisplay) selectorDisplay.textContent = sel; + if (inputName && !inputName.value) inputName.value = name; + + moveHighlighterTo(el); + } + + // ============================================================================ + // Validation Logic + // ============================================================================ + + /** + * Verify selector by highlighting only (non-destructive) + */ + async function verifyHighlightOnly() { + try { + const selector = STATE.box?.querySelector('#__em_selector')?.textContent?.trim(); + if (!selector) return; + + StateStore.set({ + validation: { status: 'running', message: 'Verifying selector...' }, + }); + + const selectorType = StateStore.get('selectorType'); + const listMode = StateStore.get('listMode'); + const effectiveType = listMode ? 'css' : selectorType; + + // Query for matches + const matches = + effectiveType === 'xpath' ? evaluateXPathAll(selector) : queryAllDeep(selector); + + // Additional defense: filter out any overlay elements that might have slipped through + const filteredMatches = filterOverlayElements(matches); + + if (!filteredMatches || filteredMatches.length === 0) { + StateStore.set({ + validation: { status: 'failure', message: 'No elements found' }, + }); + return; + } + + // Scroll first match into view + const primaryMatch = filteredMatches[0]; + if (primaryMatch) { + primaryMatch.scrollIntoView({ + block: 'center', + inline: 'center', + behavior: 'smooth', + }); + } + + await sleep(200); + + // Highlight matches with isVerify=true to prevent clearing on hover + drawRects(filteredMatches, CONFIG.COLORS.VERIFY, false, true); + + StateStore.set({ + validation: { + status: 'success', + message: `Found ${filteredMatches.length} element${filteredMatches.length > 1 ? 's' : ''}`, + }, + }); + + // Auto-clear highlight after 2 seconds + setTimeout(() => { + clearRects(); + StateStore.set({ + validation: { status: 'idle', message: '' }, + }); + }, 2000); + } catch (error) { + console.error('[verifyHighlightOnly] error:', error); + StateStore.set({ + validation: { status: 'failure', message: error.message || 'Verification failed' }, + }); + } + } + + /** + * Execute action on selector (destructive) + */ + async function verifySelectorNow() { + try { + const selector = STATE.box?.querySelector('#__em_selector')?.textContent?.trim(); + if (!selector) return; + + StateStore.set({ + validation: { status: 'running', message: 'Executing action...' }, + }); + + const selectorType = StateStore.get('selectorType'); + const listMode = StateStore.get('listMode'); + + const effectiveType = listMode ? 'css' : selectorType; + + const matches = + effectiveType === 'xpath' ? evaluateXPathAll(selector) : queryAllDeep(selector); + + // Additional defense: filter out any overlay elements that might have slipped through + const filteredMatches = filterOverlayElements(matches); + + if (!filteredMatches || filteredMatches.length === 0) { + StateStore.set({ + validation: { status: 'failure', message: 'No elements found' }, + }); + return; + } + + drawRects(filteredMatches, CONFIG.COLORS.VERIFY, false); + + const action = STATE.box?.querySelector('#__em_action')?.value || 'hover'; + + const payload = { + type: 'element_marker_validate', + selector, + selectorType: effectiveType, + action, + listMode, + }; + + // Action-specific parameters with validation + if (action === 'type_text') { + const actionText = String( + STATE.box?.querySelector('#__em_action_text')?.value || '', + ).trim(); + if (!actionText) { + StateStore.set({ + validation: { status: 'failure', message: 'Text is required for type_text' }, + }); + return; + } + payload.text = actionText; + } + + if (action === 'press_keys') { + const actionKeys = String( + STATE.box?.querySelector('#__em_action_keys')?.value || '', + ).trim(); + if (!actionKeys) { + StateStore.set({ + validation: { status: 'failure', message: 'Keys are required for press_keys' }, + }); + return; + } + payload.keys = actionKeys; + } + + if (action === 'scroll') { + const direction = STATE.box?.querySelector('#__em_scroll_direction')?.value || 'down'; + const rawAmount = Number(STATE.box?.querySelector('#__em_scroll_distance')?.value); + // Clamp to 1-10 range (backend expects ticks, not pixels) + const amount = Math.max( + 1, + Math.min(Math.round(Number.isFinite(rawAmount) ? rawAmount : 3), 10), + ); + payload.scrollDirection = direction; + payload.scrollAmount = amount; + } + + if (['left_click', 'double_click', 'right_click'].includes(action)) { + payload.modifiers = { + altKey: !!STATE.box?.querySelector('#__em_mod_alt')?.checked, + ctrlKey: !!STATE.box?.querySelector('#__em_mod_ctrl')?.checked, + metaKey: !!STATE.box?.querySelector('#__em_mod_meta')?.checked, + shiftKey: !!STATE.box?.querySelector('#__em_mod_shift')?.checked, + }; + payload.button = STATE.box?.querySelector('#__em_btn')?.value || 'left'; + payload.waitForNavigation = !!STATE.box?.querySelector('#__em_wait_nav')?.checked; + payload.timeoutMs = Number(STATE.box?.querySelector('#__em_nav_timeout')?.value) || 3000; + } + + const res = await chrome.runtime.sendMessage(payload); + + const success = !!res?.tool?.ok; + const newEntry = { + action, + success, + timestamp: Date.now(), + matchCount: filteredMatches.length, + }; + const history = [...(StateStore.get('validationHistory') || []), newEntry].slice(-5); + + if (res?.tool?.ok) { + StateStore.set({ + validation: { + status: 'success', + message: `✓ 验证成功 (匹配 ${filteredMatches.length} 个元素)`, + }, + validationHistory: history, + }); + } else { + StateStore.set({ + validation: { + status: 'failure', + message: res?.tool?.error || '验证失败', + }, + validationHistory: history, + }); + } + } catch (err) { + const newEntry = { + action: STATE.box?.querySelector('#__em_action')?.value || 'hover', + success: false, + timestamp: Date.now(), + matchCount: 0, + }; + const history = [...(StateStore.get('validationHistory') || []), newEntry].slice(-5); + + StateStore.set({ + validation: { + status: 'failure', + message: `错误: ${err.message}`, + }, + validationHistory: history, + }); + } + } + + /** + * Highlight selector from external request (popup/background) + * Supports composite iframe selectors: "frameSelector |> innerSelector" + */ + async function highlightSelectorExternal({ selector, selectorType = 'css', listMode = false }) { + const normalized = String(selector || '').trim(); + if (!normalized) { + return { success: false, error: 'selector is required' }; + } + + try { + // Handle composite iframe selector + if (normalized.includes('|>')) { + const parts = normalized + .split('|>') + .map((s) => s.trim()) + .filter(Boolean); + + if (parts.length >= 2) { + const frameSel = parts[0]; + const innerSel = parts.slice(1).join(' |> '); + + // Find frame element + let frameEl = null; + try { + frameEl = querySelectorDeepFirst(frameSel) || document.querySelector(frameSel); + } catch {} + + if ( + !frameEl || + !(frameEl instanceof HTMLIFrameElement || frameEl instanceof HTMLFrameElement) + ) { + return { success: false, error: `Frame element not found: ${frameSel}` }; + } + + const cw = frameEl.contentWindow; + if (!cw) { + return { success: false, error: 'Unable to access frame contentWindow' }; + } + + // Forward highlight request to iframe + return new Promise((resolve) => { + const reqId = `em_highlight_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; + const listener = (ev) => { + try { + const data = ev?.data; + if (!data || data.type !== 'em-highlight-result' || data.reqId !== reqId) return; + window.removeEventListener('message', listener, true); + resolve(data.result); + } catch {} + }; + + window.addEventListener('message', listener, true); + setTimeout(() => { + window.removeEventListener('message', listener, true); + resolve({ success: false, error: 'Frame highlight timeout' }); + }, 3000); + + cw.postMessage( + { + type: 'em-highlight-request', + reqId, + selector: innerSel, + selectorType, + listMode, + }, + '*', + ); + }); + } + } + + // Handle normal selector (non-iframe) + const effectiveType = listMode ? 'css' : selectorType; + const matches = + effectiveType === 'xpath' ? evaluateXPathAll(normalized) : queryAllDeep(normalized); + + // Additional defense: filter out any overlay elements that might have slipped through + const filteredMatches = filterOverlayElements(matches); + + if (!filteredMatches || filteredMatches.length === 0) { + return { success: false, error: 'No elements found for selector' }; + } + + // Scroll first match into view + const primaryMatch = filteredMatches[0]; + if (primaryMatch) { + primaryMatch.scrollIntoView({ + block: 'center', + inline: 'center', + behavior: 'smooth', + }); + } + + await sleep(150); + + // Draw highlight rectangles + drawRects(filteredMatches, CONFIG.COLORS.VERIFY, false); + + // Auto-clear after 2 seconds + setTimeout(() => { + clearRects(); + }, 2000); + + return { success: true, count: filteredMatches.length }; + } catch (error) { + return { success: false, error: error.message || String(error) }; + } + } + + function copySelectorNow() { + try { + const sel = STATE.box?.querySelector('#__em_selector')?.textContent?.trim(); + if (!sel) return; + navigator.clipboard?.writeText(sel).catch(() => {}); + + StateStore.set({ + validation: { status: 'success', message: '✓ 已复制到剪贴板' }, + }); + + setTimeout(() => { + StateStore.set({ validation: { status: 'idle', message: '' } }); + }, 2000); + } catch {} + } + + async function save() { + try { + const name = STATE.box?.querySelector('#__em_name')?.value?.trim(); + const selector = STATE.box?.querySelector('#__em_selector')?.textContent?.trim(); + + if (!selector) return; + + const url = location.href; + let selectorType = StateStore.get('selectorType'); + const listMode = StateStore.get('listMode'); + + if (listMode && selectorType === 'xpath') { + selectorType = 'css'; + } + + await chrome.runtime.sendMessage({ + type: 'element_marker_save', + marker: { + url, + name: name || selector, + selector, + selectorType, + listMode, + }, + }); + } catch {} + + stop(); + } + + // ============================================================================ + // Lifecycle Management + // ============================================================================ + + function start() { + if (STATE.active) return; + STATE.active = true; + + if (IS_MAIN) { + const { host } = PanelHost.mount(); + STATE.box = host; + StateStore.init(); + bindControls(); + } + + ensureHighlighter(); + ensureRectsHost(); + + attachPointerListeners(); + attachKeyboardListener(); + syncInteractionMode(); + } + + function stop() { + STATE.active = false; + + detachPointerListeners(); + detachKeyboardListener(); + + // Cancel pending rAF + if (STATE.hoverRafId != null) { + cancelAnimationFrame(STATE.hoverRafId); + STATE.hoverRafId = null; + } + pendingHoverEvent = null; + + try { + STATE.highlighter?.remove(); + STATE.rectsHost?.remove(); + PanelHost.unmount(); + DragController.destroy(); + } catch {} + + STATE.highlighter = null; + STATE.rectsHost = null; + STATE.box = null; + STATE.hoveredList = []; + STATE.hoverEl = null; + STATE.selectedEl = null; + STATE.lastHoverTarget = null; + STATE.verifyRectsActive = false; + + // Clear rect pool to release DOM references + STATE.rectPool.length = 0; + STATE.rectPoolUsed = 0; + } + + // ============================================================================ + // Controls Binding + // ============================================================================ + + function bindControls() { + const host = STATE.box; + if (!host) return; + + // Close/Cancel + host.querySelector('#__em_close')?.addEventListener('click', stop); + host.querySelector('#__em_cancel')?.addEventListener('click', stop); + + // Save + host.querySelector('#__em_save')?.addEventListener('click', save); + + // Verify (highlight only) & Execute (real action) + host.querySelector('#__em_verify')?.addEventListener('click', verifyHighlightOnly); + host.querySelector('#__em_execute')?.addEventListener('click', verifySelectorNow); + + // Copy + host.querySelector('#__em_copy')?.addEventListener('click', copySelectorNow); + host.querySelector('#__em_copy_selector')?.addEventListener('click', copySelectorNow); + + // Action change handler - show/hide action-specific options + host.querySelector('#__em_action')?.addEventListener('change', (e) => { + updateActionSpecificUI(e.target.value); + }); + + // Selector type + host.querySelector('#__em_selector_type')?.addEventListener('change', (e) => { + const newType = e.target.value; + const listMode = StateStore.get('listMode'); + + // If switching to XPath while in list mode, disable list mode + if (newType === 'xpath' && listMode) { + StateStore.set({ selectorType: newType, listMode: false }); + } else { + StateStore.set({ selectorType: newType }); + } + + // Regenerate selector for the currently selected element + if (STATE.selectedEl) { + setSelection(STATE.selectedEl); + } + // Note: If no selectedEl (e.g., iframe selections or manual input), + // preserve existing selector text instead of clearing it + }); + + // List mode toggle + host.querySelector('#__em_toggle_list')?.addEventListener('click', (e) => { + const listMode = StateStore.get('listMode'); + const newListMode = !listMode; + + // If enabling list mode, force CSS selector type + if (newListMode) { + StateStore.set({ listMode: true, selectorType: 'css' }); + const selectorTypeSelect = host.querySelector('#__em_selector_type'); + if (selectorTypeSelect) selectorTypeSelect.value = 'css'; + } else { + StateStore.set({ listMode: false }); + } + + // Update button active state + const btn = e.currentTarget; + if (btn) { + if (newListMode) { + btn.classList.add('active'); + } else { + btn.classList.remove('active'); + } + } + + // Regenerate selector for the currently selected element + if (STATE.selectedEl) { + setSelection(STATE.selectedEl); + } + + clearHighlighter(); + }); + + // Tab toggle (switch between Attributes and Execute) + host.querySelector('#__em_toggle_tab')?.addEventListener('click', () => { + const currentTab = StateStore.get('activeTab'); + StateStore.set({ activeTab: currentTab === 'attributes' ? 'execute' : 'attributes' }); + }); + + // Tab switching + const tabs = host.querySelectorAll('.em-tab'); + tabs.forEach((tab) => { + tab.addEventListener('click', () => { + StateStore.set({ activeTab: tab.dataset.tab }); + }); + }); + + // Navigation buttons + host.querySelector('#__em_nav_up')?.addEventListener('click', () => { + const base = STATE.selectedEl || STATE.hoverEl; + if (base?.parentElement) setSelection(base.parentElement); + }); + + host.querySelector('#__em_nav_down')?.addEventListener('click', () => { + const base = STATE.selectedEl || STATE.hoverEl; + if (base?.firstElementChild) setSelection(base.firstElementChild); + }); + + // Preferences + host.querySelector('#__em_pref_id')?.addEventListener('change', (e) => { + const prefs = { ...StateStore.get('prefs'), preferId: !!e.target.checked }; + StateStore.set({ prefs }); + }); + host.querySelector('#__em_pref_attr')?.addEventListener('change', (e) => { + const prefs = { ...StateStore.get('prefs'), preferStableAttr: !!e.target.checked }; + StateStore.set({ prefs }); + }); + host.querySelector('#__em_pref_class')?.addEventListener('change', (e) => { + const prefs = { ...StateStore.get('prefs'), preferClass: !!e.target.checked }; + StateStore.set({ prefs }); + }); + + // Drag - use entire header as drag handle + const dragHandle = host.querySelector('#__em_drag_handle'); + if (dragHandle) { + DragController.init(dragHandle); + } + + syncUIWithState(); + } + + function updateActionSpecificUI(action) { + const host = STATE.box; + if (!host) return; + + // Hide all action-specific groups + const textGroup = host.querySelector('#__em_action_text_group'); + const keysGroup = host.querySelector('#__em_action_keys_group'); + const scrollOptions = host.querySelector('#__em_scroll_options'); + const clickOptions = host.querySelector('#__em_click_options'); + + if (textGroup) textGroup.style.display = 'none'; + if (keysGroup) keysGroup.style.display = 'none'; + if (scrollOptions) scrollOptions.style.display = 'none'; + if (clickOptions) clickOptions.style.display = 'none'; + + // Show relevant options based on action + if (action === 'type_text') { + if (textGroup) textGroup.style.display = 'block'; + } else if (action === 'press_keys') { + if (keysGroup) keysGroup.style.display = 'block'; + } else if (action === 'scroll') { + if (scrollOptions) scrollOptions.style.display = 'block'; + } else if (['left_click', 'double_click', 'right_click'].includes(action)) { + if (clickOptions) clickOptions.style.display = 'block'; + + // For right_click, button selector is not relevant (always 'right') + // Hide the button field for right_click + const buttonField = host.querySelector('#__em_btn')?.closest('.em-field'); + if (buttonField) { + buttonField.style.display = action === 'right_click' ? 'none' : 'block'; + } + } + // hover: no extra options needed + } + + function syncUIWithState() { + const host = STATE.box; + if (!host) return; + + const state = StateStore.get(); + + const typeSelect = host.querySelector('#__em_selector_type'); + if (typeSelect) typeSelect.value = state.selectorType; + + // Initialize list mode button state + const listModeBtn = host.querySelector('#__em_toggle_list'); + if (listModeBtn) { + if (state.listMode) { + listModeBtn.classList.add('active'); + } else { + listModeBtn.classList.remove('active'); + } + } + + const prefId = host.querySelector('#__em_pref_id'); + const prefAttr = host.querySelector('#__em_pref_attr'); + const prefClass = host.querySelector('#__em_pref_class'); + if (prefId) prefId.checked = state.prefs.preferId; + if (prefAttr) prefAttr.checked = state.prefs.preferStableAttr; + if (prefClass) prefClass.checked = state.prefs.preferClass; + + // Initialize action-specific UI + const actionSelect = host.querySelector('#__em_action'); + if (actionSelect) { + updateActionSpecificUI(actionSelect.value); + } + } + + // ============================================================================ + // Cross-Frame Bridge + // ============================================================================ + + // Register window message listener in all frames (not just main) + // to support cross-frame highlighting from popup validation + window.addEventListener( + 'message', + (ev) => { + try { + const data = ev?.data; + if (!data) return; + + // Handle iframe highlight request (works even when overlay is inactive) + if (data.type === 'em-highlight-request') { + highlightSelectorExternal({ + selector: data.selector, + selectorType: data.selectorType || 'css', + listMode: !!data.listMode, + }) + .then((result) => { + window.parent.postMessage( + { + type: 'em-highlight-result', + reqId: data.reqId, + result, + }, + '*', + ); + }) + .catch((error) => { + window.parent.postMessage( + { + type: 'em-highlight-result', + reqId: data.reqId, + result: { success: false, error: error?.message || String(error) }, + }, + '*', + ); + }); + return; + } + + // Following messages only relevant when overlay is active + if (!STATE.active) return; + + // Only main frame handles these overlay-related messages + if (!IS_MAIN) return; + + const iframes = Array.from(document.querySelectorAll('iframe')); + const host = iframes.find((f) => { + try { + return f.contentWindow === ev.source; + } catch { + return false; + } + }); + + if (!host) return; + + const base = host.getBoundingClientRect(); + + if (data.type === 'em_hover' && Array.isArray(data.rects)) { + // Use pooled rect boxes for better performance + drawRectBoxes(data.rects, { + offsetX: base.left, + offsetY: base.top, + color: CONFIG.COLORS.HOVER, + dashed: true, + }); + } else if (data.type === 'em_click' && data.innerSel) { + const frameSel = generateSelector(host); + const composite = frameSel ? `${frameSel} |> ${data.innerSel}` : data.innerSel; + const selectorText = STATE.box?.querySelector('#__em_selector'); + const selectorDisplay = STATE.box?.querySelector('#__em_selector_text'); + if (selectorText) selectorText.textContent = composite; + if (selectorDisplay) selectorDisplay.textContent = composite; + } + } catch {} + }, + true, + ); + + // ============================================================================ + // Message Handlers + // ============================================================================ + + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + if (request?.action === 'element_marker_start') { + start(); + sendResponse({ ok: true }); + return true; + } else if (request?.action === 'element_marker_ping') { + sendResponse({ status: 'pong' }); + return false; + } else if (request?.action === 'element_marker_highlight') { + highlightSelectorExternal({ + selector: request.selector, + selectorType: request.selectorType, + listMode: !!request.listMode, + }) + .then((result) => sendResponse(result)) + .catch((error) => sendResponse({ success: false, error: error?.message || String(error) })); + return true; + } + return false; + }); +})(); diff --git a/app/chrome-extension/inject-scripts/element-picker.js b/app/chrome-extension/inject-scripts/element-picker.js new file mode 100644 index 00000000..45fdfbde --- /dev/null +++ b/app/chrome-extension/inject-scripts/element-picker.js @@ -0,0 +1,679 @@ +/* eslint-disable */ +/** + * Element Picker Inject Script + * + * Injected script to let the user manually pick elements for chrome_request_element_selection. + * - Writes refs into window.__claudeElementMap (compatible with accessibility-tree-helper.js) + * - Generates stable CSS selectors (prefers id/data-testid/etc.) + * - Supports iframe picking by reporting selection via chrome.runtime.sendMessage (background reads sender.frameId) + */ + +(function () { + 'use strict'; + + // Prevent double initialization + if (window.__MCP_ELEMENT_PICKER_INITIALIZED__) return; + window.__MCP_ELEMENT_PICKER_INITIALIZED__ = true; + + // ============================================================ + // Constants + // ============================================================ + + const UI_HOST_ID = '__mcp_element_picker_host__'; + const HIGHLIGHT_ID = '__mcp_element_picker_highlight__'; + const MAX_TEXT_LEN = 160; + + // Highlight colors matching Editorial accent (terracotta) + const HIGHLIGHT_COLOR = '#d97757'; + const HIGHLIGHT_BG = 'rgba(217, 119, 87, 0.08)'; + const HIGHLIGHT_BORDER = 'rgba(217, 119, 87, 0.4)'; + + // ============================================================ + // State + // ============================================================ + + const STATE = { + active: false, + sessionId: null, + activeRequestId: null, + listenersAttached: false, + hoverRafId: null, + pendingHoverEvent: null, + lastHoverEl: null, + highlighter: null, + }; + + // ============================================================ + // CSS Escape Helper + // ============================================================ + + function cssEscape(value) { + try { + if (window.CSS && typeof window.CSS.escape === 'function') { + return window.CSS.escape(value); + } + } catch { + // Fallback + } + return String(value).replace(/[^a-zA-Z0-9_-]/g, (c) => `\\${c}`); + } + + // ============================================================ + // UI Detection Helpers + // ============================================================ + + function getUiHost() { + try { + return document.getElementById(UI_HOST_ID); + } catch { + return null; + } + } + + function isOverlayElement(node) { + if (!(node instanceof Node)) return false; + const host = getUiHost(); + if (!host) return false; + if (node === host) return true; + const root = typeof node.getRootNode === 'function' ? node.getRootNode() : null; + return root instanceof ShadowRoot && root.host === host; + } + + function isEventFromUi(ev) { + if (!ev) return false; + try { + if (typeof ev.composedPath === 'function') { + const path = ev.composedPath(); + if (Array.isArray(path)) { + return path.some((n) => isOverlayElement(n)); + } + } + } catch { + // Fallback + } + return isOverlayElement(ev.target); + } + + /** + * Get the deepest page target from an event, handling Shadow DOM. + */ + function getDeepPageTarget(ev) { + if (!ev) return null; + try { + const path = typeof ev.composedPath === 'function' ? ev.composedPath() : null; + if (Array.isArray(path) && path.length > 0) { + for (const node of path) { + if (node instanceof Element && !isOverlayElement(node)) { + return node; + } + } + } + } catch { + // Fallback + } + const fallback = ev.target instanceof Element ? ev.target : null; + if (fallback && !isOverlayElement(fallback)) { + return fallback; + } + return null; + } + + // ============================================================ + // Highlighter + // ============================================================ + + function ensureHighlighter() { + if (STATE.highlighter && STATE.highlighter.isConnected) { + return STATE.highlighter; + } + + // Remove any existing highlighter + try { + const existing = document.getElementById(HIGHLIGHT_ID); + if (existing) existing.remove(); + } catch { + // Best effort + } + + const hl = document.createElement('div'); + hl.id = HIGHLIGHT_ID; + Object.assign(hl.style, { + position: 'fixed', + left: '0px', + top: '0px', + width: '0px', + height: '0px', + border: `2px solid ${HIGHLIGHT_COLOR}`, + borderRadius: '4px', + boxShadow: `0 0 0 1px ${HIGHLIGHT_BORDER}`, + background: HIGHLIGHT_BG, + pointerEvents: 'none', + zIndex: '2147483647', + display: 'none', + transition: 'transform 60ms linear, width 60ms linear, height 60ms linear', + }); + + try { + (document.documentElement || document.body).appendChild(hl); + } catch { + // Best effort + } + + STATE.highlighter = hl; + return hl; + } + + function clearHighlighter() { + const hl = STATE.highlighter; + if (!hl) return; + try { + hl.style.display = 'none'; + } catch { + // Best effort + } + } + + function moveHighlighterTo(el) { + const hl = ensureHighlighter(); + if (!hl || !(el instanceof Element)) return; + + let rect; + try { + rect = el.getBoundingClientRect(); + } catch { + clearHighlighter(); + return; + } + + if (!rect || rect.width <= 0 || rect.height <= 0) { + clearHighlighter(); + return; + } + + try { + hl.style.display = 'block'; + hl.style.transform = `translate(${Math.round(rect.left)}px, ${Math.round(rect.top)}px)`; + hl.style.width = `${Math.round(rect.width)}px`; + hl.style.height = `${Math.round(rect.height)}px`; + } catch { + // Best effort + } + } + + // ============================================================ + // Selector Uniqueness Check (Optimized) + // ============================================================ + + /** + * Check if element is inside a Shadow DOM. + */ + function isInShadowDom(el) { + try { + const root = el.getRootNode(); + return root instanceof ShadowRoot; + } catch { + return false; + } + } + + /** + * Fast uniqueness check using native querySelectorAll. + * For Shadow DOM elements, queries within their shadow root only. + */ + function isSelectorUnique(selector, target) { + if (!selector || !(target instanceof Element)) return false; + + try { + // For elements not in Shadow DOM, use fast native query + if (!isInShadowDom(target)) { + const matches = document.querySelectorAll(selector); + return matches.length === 1 && matches[0] === target; + } + + // For Shadow DOM elements, query within their root + const root = target.getRootNode(); + if (root instanceof ShadowRoot) { + const matches = root.querySelectorAll(selector); + return matches.length === 1 && matches[0] === target; + } + + return false; + } catch { + return false; + } + } + + // ============================================================ + // Selector Generation (Stable & Unique) + // ============================================================ + + function buildPathFromAncestor(ancestor, target) { + const segs = []; + let cur = target; + + const root = target.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + const boundary = isShadowElement ? root.host : document.body; + + while (cur && cur !== ancestor && cur !== boundary) { + let seg = cur.tagName.toLowerCase(); + const parent = cur.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter((c) => c.tagName === cur.tagName); + if (siblings.length > 1) { + seg += `:nth-of-type(${siblings.indexOf(cur) + 1})`; + } + } + segs.unshift(seg); + cur = parent; + if (isShadowElement && cur === boundary) break; + } + + return segs.join(' > '); + } + + function buildFullPath(el) { + let path = ''; + let current = el; + + const root = el.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + const boundary = isShadowElement ? root.host : document.body; + + while (current && current.nodeType === Node.ELEMENT_NODE && current !== boundary) { + let sel = current.tagName.toLowerCase(); + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter((c) => c.tagName === current.tagName); + if (siblings.length > 1) { + sel += `:nth-of-type(${siblings.indexOf(current) + 1})`; + } + } + path = path ? `${sel} > ${path}` : sel; + current = parent; + if (isShadowElement && current === boundary) break; + } + + if (isShadowElement) return path || el.tagName.toLowerCase(); + return path ? `body > ${path}` : 'body'; + } + + /** + * Generate a stable CSS selector for an element. + * Prioritizes: id > data-testid/data-test/etc > anchor + relative path > full path + */ + function generateSelector(el) { + if (!(el instanceof Element)) return ''; + + // Prefer unique IDs + try { + if (el.id) { + const idSel = `#${cssEscape(el.id)}`; + if (isSelectorUnique(idSel, el)) return idSel; + } + } catch { + // Continue + } + + // Prefer stable test attributes + try { + const attrNames = [ + 'data-testid', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + 'aria-label', + 'title', + 'alt', + ]; + const tag = el.tagName.toLowerCase(); + for (const attr of attrNames) { + const v = el.getAttribute(attr); + if (!v) continue; + const attrSel = `[${attr}="${cssEscape(v)}"]`; + const testSel = /^(input|textarea|select)$/i.test(tag) ? `${tag}${attrSel}` : attrSel; + if (isSelectorUnique(testSel, el)) return testSel; + } + } catch { + // Continue + } + + // Anchor + relative path + try { + let cur = el; + const anchorAttrs = [ + 'id', + 'data-testid', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + ]; + + const root = el.getRootNode(); + const isShadowElement = root instanceof ShadowRoot; + const boundary = isShadowElement ? root.host : document.body; + + while (cur && cur !== boundary) { + if (cur.id) { + const anchor = `#${cssEscape(cur.id)}`; + if (isSelectorUnique(anchor, cur)) { + const rel = buildPathFromAncestor(cur, el); + const composed = rel ? `${anchor} ${rel}` : anchor; + if (isSelectorUnique(composed, el)) return composed; + } + } + + for (const attr of anchorAttrs) { + const val = cur.getAttribute(attr); + if (!val) continue; + const aSel = `[${attr}="${cssEscape(val)}"]`; + if (isSelectorUnique(aSel, cur)) { + const rel = buildPathFromAncestor(cur, el); + const composed = rel ? `${aSel} ${rel}` : aSel; + if (isSelectorUnique(composed, el)) return composed; + } + } + + cur = cur.parentElement; + } + } catch { + // Continue + } + + // Fallback to full path + return buildFullPath(el); + } + + // ============================================================ + // Text Summarization + // ============================================================ + + function summarizeText(el) { + if (!(el instanceof Element)) return ''; + try { + const aria = el.getAttribute('aria-label'); + if (aria && aria.trim()) return aria.trim().slice(0, MAX_TEXT_LEN); + const placeholder = el.getAttribute('placeholder'); + if (placeholder && placeholder.trim()) return placeholder.trim().slice(0, MAX_TEXT_LEN); + const title = el.getAttribute('title'); + if (title && title.trim()) return title.trim().slice(0, MAX_TEXT_LEN); + const alt = el.getAttribute('alt'); + if (alt && alt.trim()) return alt.trim().slice(0, MAX_TEXT_LEN); + } catch { + // Continue + } + try { + const t = (el.textContent || '').trim().replace(/\s+/g, ' '); + return t ? t.slice(0, MAX_TEXT_LEN) : ''; + } catch { + return ''; + } + } + + // ============================================================ + // Ref Management (Compatible with accessibility-tree-helper.js) + // ============================================================ + + function ensureRefForElement(el) { + try { + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + } catch { + // Best effort + } + + // Check if element already has a ref + let refId = null; + try { + for (const k in window.__claudeElementMap) { + const w = window.__claudeElementMap[k]; + if (w && w.deref && w.deref() === el) { + refId = k; + break; + } + } + } catch { + // Continue + } + + // Create new ref if needed + if (!refId) { + try { + refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + } catch { + // Continue + } + } + + return refId || ''; + } + + // ============================================================ + // Communication + // ============================================================ + + function sendFrameEvent(payload) { + try { + chrome.runtime.sendMessage(payload); + } catch { + // Best effort + } + } + + // ============================================================ + // Event Handlers + // ============================================================ + + function processMouseMove(ev) { + if (!STATE.active) return; + + // Skip if event is from our UI + if (isEventFromUi(ev)) { + STATE.lastHoverEl = null; + clearHighlighter(); + return; + } + + const target = getDeepPageTarget(ev); + if (!target) { + STATE.lastHoverEl = null; + clearHighlighter(); + return; + } + + // Skip if same element + if (STATE.lastHoverEl === target) return; + STATE.lastHoverEl = target; + moveHighlighterTo(target); + } + + function onMouseMove(ev) { + if (!STATE.active) return; + STATE.pendingHoverEvent = ev; + if (STATE.hoverRafId != null) return; + STATE.hoverRafId = requestAnimationFrame(() => { + STATE.hoverRafId = null; + const latest = STATE.pendingHoverEvent; + STATE.pendingHoverEvent = null; + if (!latest) return; + processMouseMove(latest); + }); + } + + function onClick(ev) { + if (!STATE.active) return; + + // Allow UI interactions without interference + if (isEventFromUi(ev)) return; + + const rawTarget = ev.target instanceof Element ? ev.target : null; + if (!rawTarget) return; + + // Require an active request id so background can map the selection + if (!STATE.sessionId || !STATE.activeRequestId) return; + + ev.preventDefault(); + ev.stopPropagation(); + + const target = getDeepPageTarget(ev) || rawTarget; + if (!(target instanceof Element)) return; + + const ref = ensureRefForElement(target); + const selector = generateSelector(target); + let rect; + try { + rect = target.getBoundingClientRect(); + } catch { + rect = { x: 0, y: 0, width: 0, height: 0, left: 0, top: 0 }; + } + + const center = { + x: Math.round(rect.left + rect.width / 2), + y: Math.round(rect.top + rect.height / 2), + }; + + sendFrameEvent({ + type: 'element_picker_frame_event', + sessionId: STATE.sessionId, + event: 'selected', + requestId: STATE.activeRequestId, + element: { + ref, + selector, + selectorType: 'css', + rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height }, + center, + text: summarizeText(target), + tagName: target.tagName ? String(target.tagName).toLowerCase() : '', + }, + }); + } + + function onKeyDown(ev) { + if (!STATE.active) return; + if (ev && ev.key === 'Escape') { + if (isEventFromUi(ev)) return; + ev.preventDefault(); + ev.stopPropagation(); + if (STATE.sessionId) { + sendFrameEvent({ + type: 'element_picker_frame_event', + sessionId: STATE.sessionId, + event: 'cancel', + }); + } + } + } + + // ============================================================ + // Listener Management + // ============================================================ + + function attachListeners() { + if (STATE.listenersAttached) return; + window.addEventListener('mousemove', onMouseMove, true); + window.addEventListener('click', onClick, true); + window.addEventListener('keydown', onKeyDown, true); + STATE.listenersAttached = true; + } + + function detachListeners() { + if (!STATE.listenersAttached) return; + window.removeEventListener('mousemove', onMouseMove, true); + window.removeEventListener('click', onClick, true); + window.removeEventListener('keydown', onKeyDown, true); + STATE.listenersAttached = false; + } + + // ============================================================ + // Session Management API + // ============================================================ + + function startSession(payload) { + const sessionId = payload && payload.sessionId ? String(payload.sessionId) : ''; + if (!sessionId) return; + + STATE.active = true; + STATE.sessionId = sessionId; + STATE.activeRequestId = + payload && payload.activeRequestId ? String(payload.activeRequestId) : null; + ensureHighlighter(); + attachListeners(); + } + + function stopSession(payload) { + const sessionId = payload && payload.sessionId ? String(payload.sessionId) : ''; + // Only stop if session matches or no specific session requested + if (sessionId && STATE.sessionId && sessionId !== STATE.sessionId) return; + + STATE.active = false; + STATE.sessionId = null; + STATE.activeRequestId = null; + STATE.lastHoverEl = null; + detachListeners(); + clearHighlighter(); + + // Remove highlighter element + try { + const hl = STATE.highlighter; + if (hl && hl.remove) hl.remove(); + } catch { + // Best effort + } + STATE.highlighter = null; + } + + function setActiveRequest(payload) { + const sessionId = payload && payload.sessionId ? String(payload.sessionId) : ''; + if (sessionId && STATE.sessionId && sessionId !== STATE.sessionId) return; + STATE.activeRequestId = + payload && payload.activeRequestId ? String(payload.activeRequestId) : null; + } + + // ============================================================ + // Expose API for Background Script + // ============================================================ + + window.__mcpElementPicker = { + startSession, + stopSession, + setActiveRequest, + }; + + // ============================================================ + // Message Listener (for direct communication) + // ============================================================ + + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + try { + if (request && request.action === 'chrome_request_element_selection_ping') { + sendResponse({ status: 'pong' }); + return false; + } + if (request && request.action === 'elementPickerStart') { + startSession(request); + sendResponse({ success: true }); + return false; + } + if (request && request.action === 'elementPickerStop') { + stopSession(request); + sendResponse({ success: true }); + return false; + } + if (request && request.action === 'elementPickerSetActiveRequest') { + setActiveRequest(request); + sendResponse({ success: true }); + return false; + } + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return false; + } + return false; + }); +})(); diff --git a/app/chrome-extension/inject-scripts/fill-helper.js b/app/chrome-extension/inject-scripts/fill-helper.js index 7c2ed85e..1d8663fe 100644 --- a/app/chrome-extension/inject-scripts/fill-helper.js +++ b/app/chrome-extension/inject-scripts/fill-helper.js @@ -12,13 +12,31 @@ if (window.__FILL_HELPER_INITIALIZED__) { * @param {string} value - Value to fill into the element * @returns {Promise} - Result of the fill operation */ - async function fillElement(selector, value) { + async function fillElement(selector, value, ref = null) { try { // Find the element - const element = document.querySelector(selector); + let element = null; + if (ref && typeof ref === 'string') { + try { + const map = window.__claudeElementMap; + const weak = map && map[ref]; + element = weak && typeof weak.deref === 'function' ? weak.deref() : null; + } catch (e) { + // ignore + } + if (!element || !(element instanceof Element)) { + return { + error: `Element ref "${ref}" not found. Please call chrome_read_page first and ensure the ref is still valid.`, + }; + } + } else { + element = document.querySelector(selector); + } if (!element) { return { - error: `Element with selector "${selector}" not found`, + error: selector + ? `Element with selector "${selector}" not found` + : `Element for ref not found`, }; } @@ -52,6 +70,7 @@ if (window.__FILL_HELPER_INITIALIZED__) { // Check if element is an input, textarea, or select const validTags = ['INPUT', 'TEXTAREA', 'SELECT']; + // Keep a permissive list to allow type-specific branches below to handle behavior const validInputTypes = [ 'text', 'email', @@ -66,16 +85,59 @@ if (window.__FILL_HELPER_INITIALIZED__) { 'time', 'week', 'color', + 'checkbox', + 'radio', + 'range', ]; if (!validTags.includes(element.tagName)) { - return { - error: `Element with selector "${selector}" is not a fillable element (must be INPUT, TEXTAREA, or SELECT)`, - elementInfo, - }; + // If the element is a custom element with open shadow root, try to find a fillable inner control + try { + const anyEl = /** @type {any} */ (element); + const sr = anyEl && anyEl.shadowRoot ? anyEl.shadowRoot : null; + if (sr) { + // Search common fillable targets inside shadow root (breadth-first) + const queue = Array.from(sr.children || []); + const isFillable = (el) => + !!el && + (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT'); + while (queue.length) { + const cur = queue.shift(); + if (!cur) continue; + if (isFillable(cur)) { + element = cur; + break; + } + try { + const children = cur.children || []; + for (let i = 0; i < children.length; i++) queue.push(children[i]); + const innerSr = /** @type {any} */ (cur).shadowRoot; + if (innerSr && innerSr.children) { + for (let i = 0; i < innerSr.children.length; i++) queue.push(innerSr.children[i]); + } + } catch (_) {} + } + if (!validTags.includes(element.tagName)) { + return { + error: `Element with selector "${selector}" is not a fillable element (must be INPUT, TEXTAREA, or SELECT)`, + elementInfo, + }; + } + } else { + return { + error: `Element with selector "${selector}" is not a fillable element (must be INPUT, TEXTAREA, or SELECT)`, + elementInfo, + }; + } + } catch (_) { + return { + error: `Element with selector "${selector}" is not a fillable element (must be INPUT, TEXTAREA, or SELECT)`, + elementInfo, + }; + } } - // For input elements, check if the type is valid + // For input elements, check if the type is valid (allow type-specific branches below) if ( element.tagName === 'INPUT' && !validInputTypes.includes(element.type) && @@ -94,6 +156,92 @@ if (window.__FILL_HELPER_INITIALIZED__) { // Focus the element element.focus(); + // Type-specific handling for tricky inputs first + if (element.tagName === 'INPUT' && element.type === 'checkbox') { + // Accept boolean or string-like boolean + let checkedVal; + if (typeof value === 'boolean') { + checkedVal = value; + } else if (typeof value === 'string') { + const v = value.trim().toLowerCase(); + if (['true', '1', 'yes', 'on'].includes(v)) checkedVal = true; + else if (['false', '0', 'no', 'off'].includes(v)) checkedVal = false; + } + if (typeof checkedVal !== 'boolean') { + return { + error: + 'Checkbox requires a boolean (true/false) or a boolean-like string ("true"/"false"/"on"/"off").', + elementInfo, + }; + } + const previous = element.checked; + element.checked = checkedVal; + element.focus(); + element.dispatchEvent(new Event('input', { bubbles: true })); + element.dispatchEvent(new Event('change', { bubbles: true })); + element.blur(); + return { + success: true, + message: `Checkbox set to ${element.checked}`, + elementInfo: { ...elementInfo, checked: element.checked, previousChecked: previous }, + }; + } + + if (element.tagName === 'INPUT' && element.type === 'radio') { + // For radios, the selector/ref should target the specific input to select + const previous = element.checked; + element.checked = true; + element.focus(); + element.dispatchEvent(new Event('input', { bubbles: true })); + element.dispatchEvent(new Event('change', { bubbles: true })); + element.blur(); + return { + success: true, + message: 'Radio selected', + elementInfo: { + ...elementInfo, + checked: element.checked, + previousChecked: previous, + name: element.name || null, + }, + }; + } + + if (element.tagName === 'INPUT' && element.type === 'range') { + const numericValue = typeof value === 'number' ? value : Number(value); + if (Number.isNaN(numericValue)) { + return { error: 'Range input requires a numeric value', elementInfo }; + } + const previous = element.value; + element.value = String(numericValue); + element.focus(); + element.dispatchEvent(new Event('input', { bubbles: true })); + element.dispatchEvent(new Event('change', { bubbles: true })); + element.blur(); + return { + success: true, + message: `Set range to ${element.value} (min: ${element.min}, max: ${element.max})`, + elementInfo: { ...elementInfo, value: element.value }, + }; + } + + if (element.tagName === 'INPUT' && element.type === 'number') { + if (value !== '' && value !== null && value !== undefined && Number.isNaN(Number(value))) { + return { error: 'Number input requires a numeric value', elementInfo }; + } + const previous = element.value; + element.value = String(value ?? ''); + element.focus(); + element.dispatchEvent(new Event('input', { bubbles: true })); + element.dispatchEvent(new Event('change', { bubbles: true })); + element.blur(); + return { + success: true, + message: `Set number input to ${element.value} (previous: ${previous})`, + elementInfo: { ...elementInfo, value: element.value }, + }; + } + // Fill the element based on its type if (element.tagName === 'SELECT') { // For select elements, find the option with matching value or text @@ -117,15 +265,12 @@ if (window.__FILL_HELPER_INITIALIZED__) { element.dispatchEvent(new Event('change', { bubbles: true })); } else { // For input and textarea elements - - // Clear the current value + // Clear the current value then set new value element.value = ''; element.dispatchEvent(new Event('input', { bubbles: true })); - // Set the new value - element.value = value; + element.value = String(value); - // Trigger input and change events element.dispatchEvent(new Event('input', { bubbles: true })); element.dispatchEvent(new Event('change', { bubbles: true })); } @@ -189,7 +334,7 @@ if (window.__FILL_HELPER_INITIALIZED__) { // Listen for messages from the extension chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { if (request.action === 'fillElement') { - fillElement(request.selector, request.value) + fillElement(request.selector, request.value, request.ref) .then(sendResponse) .catch((error) => { sendResponse({ diff --git a/app/chrome-extension/inject-scripts/interactive-elements-helper.js b/app/chrome-extension/inject-scripts/interactive-elements-helper.js index cbb4e3cf..681b057a 100644 --- a/app/chrome-extension/inject-scripts/interactive-elements-helper.js +++ b/app/chrome-extension/inject-scripts/interactive-elements-helper.js @@ -34,17 +34,56 @@ 'input:not([type="button"]):not([type="submit"]):not([type="checkbox"]):not([type="radio"])', checkbox: 'input[type="checkbox"], [role="checkbox"]', radio: 'input[type="radio"], [role="radio"]', - textarea: 'textarea', - select: 'select', + textarea: 'textarea, [role="textbox"], [role="searchbox"]', + select: 'select, [role="combobox"]', tab: '[role="tab"]', // Generic interactive elements: combines tabindex, common roles, and explicit handlers. // This is the key to finding custom-built interactive components. - interactive: `[onclick], [tabindex]:not([tabindex^="-"]), [role="menuitem"], [role="slider"], [role="option"], [role="treeitem"]`, + interactive: `[onclick], [tabindex]:not([tabindex^="-"]), [role="menuitem"], [role="slider"], [role="option"], [role="treeitem"], [role="switch"]`, }; // A combined selector for ANY interactive element, used in the fallback logic. const ANY_INTERACTIVE_SELECTOR = Object.values(ELEMENT_CONFIG).join(', '); + // Query helpers that pierce open shadow roots. These are used only in fallback paths or + // when a selector is explicitly provided, to keep costs bounded. + function* walkAllNodesDeep(root) { + const stack = [root]; + const MAX = 12000; // safety bound + let count = 0; + while (stack.length) { + const node = stack.pop(); + if (!node) continue; + if (++count > MAX) break; + yield node; + const anyNode = /** @type {any} */ (node); + try { + const children = node.children ? Array.from(node.children) : []; + for (let i = children.length - 1; i >= 0; i--) stack.push(children[i]); + const sr = anyNode && anyNode.shadowRoot ? anyNode.shadowRoot : null; + if (sr && sr.children) { + const srChildren = Array.from(sr.children); + for (let i = srChildren.length - 1; i >= 0; i--) stack.push(srChildren[i]); + } + } catch (_) { + /* ignore */ + } + } + } + + function querySelectorAllDeep(selector, root = document) { + const results = []; + for (const node of walkAllNodesDeep(root)) { + if (!(node instanceof Element)) continue; + try { + if (node.matches && node.matches(selector)) results.push(node); + } catch (_) { + /* ignore invalid selectors for given node */ + } + } + return results; + } + // --- Core Helper Functions --- /** @@ -221,7 +260,7 @@ .join(', '); if (!selectorsToFind) return []; - const targetElements = Array.from(document.querySelectorAll(selectorsToFind)); + const targetElements = querySelectorAllDeep(selectorsToFind); const uniqueElements = new Set(targetElements); const results = []; @@ -325,7 +364,7 @@ let elements; if (request.selector) { // If a selector is provided, bypass the text-based logic and use a direct query. - const foundEls = Array.from(document.querySelectorAll(request.selector)); + const foundEls = querySelectorAllDeep(request.selector); elements = foundEls.map((el) => createElementInfo( el, diff --git a/app/chrome-extension/inject-scripts/network-helper.js b/app/chrome-extension/inject-scripts/network-helper.js index afa295b3..2b2addf7 100644 --- a/app/chrome-extension/inject-scripts/network-helper.js +++ b/app/chrome-extension/inject-scripts/network-helper.js @@ -20,7 +20,14 @@ if (window.__NETWORK_CAPTURE_HELPER_INITIALIZED__) { * @param {number} timeout - Timeout in milliseconds (default: 30000) * @returns {Promise} - The response data */ - async function replayNetworkRequest(url, method, headers, body, timeout = 30000) { + async function replayNetworkRequest( + url, + method, + headers, + body, + timeout = 30000, + formDataDescriptor = null, + ) { try { // Create fetch options const options = { @@ -31,8 +38,139 @@ if (window.__NETWORK_CAPTURE_HELPER_INITIALIZED__) { cache: 'no-cache', }; - // Add body for non-GET requests - if (method !== 'GET' && method !== 'HEAD' && body !== undefined) { + // Helper: convert base64 to Blob + const base64ToBlob = (base64, contentType = 'application/octet-stream') => { + try { + const decodedString = atob(base64); + const len = decodedString.length; + const bytes = new Uint8Array(len); + for (let i = 0; i < len; i++) bytes[i] = decodedString.charCodeAt(i); + return new Blob([bytes], { type: contentType }); + } catch (e) { + return new Blob([]); + } + }; + + // Helper: request native to read filePath into base64 + const readFileBase64 = (path) => + new Promise((resolve) => { + const requestId = `net-helper-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`; + const timeoutId = setTimeout(() => { + cleanup(); + resolve(null); + }, 30000); + function onMessage(msg) { + if ( + msg && + msg.type === 'file_operation_response' && + msg.responseToRequestId === requestId + ) { + cleanup(); + const p = msg.payload || {}; + if (p.success && p.base64Data) + resolve({ base64: p.base64Data, fileName: p.fileName }); + else resolve(null); + } + } + function cleanup() { + clearTimeout(timeoutId); + chrome.runtime.onMessage.removeListener(onMessage); + } + chrome.runtime.onMessage.addListener(onMessage); + chrome.runtime + .sendMessage({ + type: 'forward_to_native', + message: { + type: 'file_operation', + requestId, + payload: { action: 'readBase64File', filePath: path }, + }, + }) + .catch(() => { + cleanup(); + resolve(null); + }); + }); + + // Build multipart/form-data if descriptor is provided + if (method !== 'GET' && method !== 'HEAD' && formDataDescriptor) { + const fd = new FormData(); + try { + if (Array.isArray(formDataDescriptor)) { + for (const item of formDataDescriptor) { + if (!Array.isArray(item) || item.length < 2) continue; + const name = String(item[0] || 'file'); + const spec = String(item[1] || ''); + const filenameHint = item[2] ? String(item[2]) : undefined; + if (/^(https?:\/\/|url:)/i.test(spec)) { + const url = spec.replace(/^url:/i, ''); + const resp = await fetch(url); + const blob = await resp.blob(); + const fn = + filenameHint || url.split('?')[0].split('#')[0].split('/').pop() || 'file'; + fd.append(name, blob, fn); + } else if (/^base64:/i.test(spec)) { + const b64 = spec.replace(/^base64:/i, ''); + const blob = base64ToBlob(b64); + fd.append(name, blob, filenameHint || 'file'); + } else if (/^file:/i.test(spec)) { + const p = spec.replace(/^file:/i, ''); + const res = await readFileBase64(p); + if (res && res.base64) { + const blob = base64ToBlob(res.base64); + fd.append(name, blob, filenameHint || res.fileName || 'file'); + } + } else { + // treat as string field + fd.append(name, spec); + } + } + } else if (typeof formDataDescriptor === 'object') { + const fds = formDataDescriptor; + const fields = fds.fields || {}; + const files = Array.isArray(fds.files) ? fds.files : []; + for (const [k, v] of Object.entries(fields)) fd.append(String(k), String(v)); + for (const file of files) { + const name = String(file.name || 'file'); + if (file.fileUrl) { + const resp = await fetch(String(file.fileUrl)); + const blob = await resp.blob(); + const fn = + file.filename || + String(file.fileUrl).split('?')[0].split('#')[0].split('/').pop() || + 'file'; + fd.append(name, blob, fn); + } else if (file.base64Data) { + const blob = base64ToBlob( + String(file.base64Data), + String(file.contentType || 'application/octet-stream'), + ); + fd.append(name, blob, file.filename || 'file'); + } else if (file.filePath) { + const res = await readFileBase64(String(file.filePath)); + if (res && res.base64) { + const blob = base64ToBlob( + res.base64, + String(file.contentType || 'application/octet-stream'), + ); + fd.append(name, blob, file.filename || res.fileName || 'file'); + } + } + } + } + } catch (e) { + console.warn('Failed to construct FormData:', e); + } + // Let browser set the correct multipart boundary + try { + if (options.headers) { + delete options.headers['content-type']; + delete options.headers['Content-Type']; + } + } catch {} + options.body = fd; + } else if (method !== 'GET' && method !== 'HEAD' && body !== undefined) { + // Fallback to raw body options.body = body; } @@ -115,6 +253,7 @@ if (window.__NETWORK_CAPTURE_HELPER_INITIALIZED__) { request.headers, request.body, request.timeout, + request.formData, ) .then(sendResponse) .catch((error) => { diff --git a/app/chrome-extension/inject-scripts/props-agent.js b/app/chrome-extension/inject-scripts/props-agent.js new file mode 100644 index 00000000..17227633 --- /dev/null +++ b/app/chrome-extension/inject-scripts/props-agent.js @@ -0,0 +1,2393 @@ +/* eslint-disable */ +// @ts-nocheck +/** + * Props Agent - MAIN World Script + * + * Runtime hacking agent for React/Vue Props editing. + * Communicates with ISOLATED world via CustomEvent. + * + * Architecture: + * - Transport: CustomEvent-based request/response + * - Locator: Simplified ElementLocator resolution + * - ReactAdapter: DevTools Hook detection/injection + overrideProps + * - VueAdapter: __vueParentComponent + $forceUpdate + * - Serializer: Safe Props serialization with type preservation + * - Handlers: Request operation dispatch + * + * @module props-agent + */ +(() => { + 'use strict'; + + // ============================================================================= + // Constants & Guards + // ============================================================================= + + const GLOBAL_KEY = '__MCP_WEB_EDITOR_PROPS_AGENT__'; + if (window[GLOBAL_KEY]) return; + + const PROTOCOL_VERSION = 1; + const LOG_PREFIX = '[PropsAgent]'; + + const EVENT_NAME = Object.freeze({ + REQUEST: 'web-editor-props:request', + RESPONSE: 'web-editor-props:response', + CLEANUP: 'web-editor-props:cleanup', + }); + + const REACT_HOOK_NAME = '__REACT_DEVTOOLS_GLOBAL_HOOK__'; + + /** @type {'READY' | 'HOOK_PRESENT_NO_RENDERERS' | 'RENDERERS_NO_EDITING' | 'HOOK_MISSING'} */ + const HOOK_STATUS = Object.freeze({ + READY: 'READY', + HOOK_PRESENT_NO_RENDERERS: 'HOOK_PRESENT_NO_RENDERERS', + RENDERERS_NO_EDITING: 'RENDERERS_NO_EDITING', + HOOK_MISSING: 'HOOK_MISSING', + }); + + const SERIALIZE_LIMITS = Object.freeze({ + maxDepth: 4, + maxEntries: 100, + maxArrayLength: 50, + maxStringLength: 1500, + }); + + // ============================================================================= + // Utilities + // ============================================================================= + + function isObject(value) { + return value !== null && typeof value === 'object'; + } + + function safeString(value) { + try { + if (typeof value === 'string') return value; + if (value === null || value === undefined) return ''; + return String(value); + } catch { + return ''; + } + } + + function logWarn(...args) { + try { + console.warn(LOG_PREFIX, ...args); + } catch { + // Silently ignore + } + } + + // ============================================================================= + // Transport Layer + // ============================================================================= + + const Transport = { + dispatchResponse(detail) { + try { + window.dispatchEvent(new CustomEvent(EVENT_NAME.RESPONSE, { detail })); + } catch (err) { + logWarn('Failed to dispatch response:', err); + } + }, + + createResponse(requestId, success, data, error) { + const response = { + v: PROTOCOL_VERSION, + requestId, + success: Boolean(success), + }; + if (data !== undefined) response.data = data; + if (error !== undefined) response.error = safeString(error); + return response; + }, + + normalizeRequest(detail) { + if (!isObject(detail)) return null; + if (detail.v !== PROTOCOL_VERSION) return null; + + const requestId = typeof detail.requestId === 'string' ? detail.requestId : ''; + const op = typeof detail.op === 'string' ? detail.op : ''; + if (!requestId || !op) return null; + + return { + v: PROTOCOL_VERSION, + requestId, + op, + locator: detail.locator, + payload: detail.payload, + }; + }, + }; + + // ============================================================================= + // Locator - Element Resolution + // ============================================================================= + + const Locator = { + safeQuerySelector(root, selector) { + try { + if (!root || typeof selector !== 'string' || !selector.trim()) return null; + return root.querySelector(selector); + } catch { + return null; + } + }, + + safeQuerySelectorAll(root, selector) { + try { + if (!root || typeof selector !== 'string' || !selector.trim()) return []; + return Array.from(root.querySelectorAll(selector)); + } catch { + return []; + } + }, + + isSelectorUnique(root, selector) { + return this.safeQuerySelectorAll(root, selector).length === 1; + }, + + computeFingerprint(element) { + try { + const parts = []; + const tag = element?.tagName ? String(element.tagName).toLowerCase() : 'unknown'; + parts.push(tag); + const id = element?.id ? String(element.id).trim() : ''; + if (id) parts.push(`id=${id}`); + return parts.join('|'); + } catch { + return ''; + } + }, + + verifyFingerprint(element, fingerprint) { + try { + const current = this.computeFingerprint(element); + const storedParts = safeString(fingerprint).split('|'); + const currentParts = current.split('|'); + + // Tag must match + if (storedParts[0] !== currentParts[0]) return false; + + // If stored has id, current must have same id + const storedId = storedParts.find((p) => p.startsWith('id=')); + const currentId = currentParts.find((p) => p.startsWith('id=')); + if (storedId && storedId !== currentId) return false; + + return true; + } catch { + return false; + } + }, + + normalizeStringArray(value) { + if (!Array.isArray(value)) return []; + return value.map((v) => safeString(v).trim()).filter(Boolean); + }, + + /** + * Resolve ElementLocator to DOM element + * Simplified version for MAIN world (no iframe support yet) + */ + locate(locator, rootDocument = document) { + try { + if (!isObject(locator)) return null; + + let queryRoot = rootDocument; + + // Traverse Shadow DOM host chain + const shadowHostChain = this.normalizeStringArray(locator.shadowHostChain); + for (const hostSelector of shadowHostChain) { + if (!this.isSelectorUnique(queryRoot, hostSelector)) return null; + const host = this.safeQuerySelector(queryRoot, hostSelector); + if (!host) return null; + const shadowRoot = host.shadowRoot; + if (!shadowRoot) return null; + queryRoot = shadowRoot; + } + + // Try each selector candidate + const selectors = this.normalizeStringArray(locator.selectors); + for (const selector of selectors) { + if (!this.isSelectorUnique(queryRoot, selector)) continue; + const element = this.safeQuerySelector(queryRoot, selector); + if (!element) continue; + + // Verify fingerprint if provided + const fp = safeString(locator.fingerprint); + if (fp && !this.verifyFingerprint(element, fp)) continue; + + return element; + } + } catch { + // Best-effort + } + return null; + }, + }; + + // ============================================================================= + // React Adapter + // ============================================================================= + + const ReactAdapter = { + /** Store original values for reset (fiber -> { renderer, originals: Map }) */ + overrideStore: typeof WeakMap === 'function' ? new WeakMap() : null, + + /** Flag to avoid repeated hook installation attempts */ + hookInstallAttempted: false, + + getHook() { + try { + return window[REACT_HOOK_NAME] || null; + } catch { + return null; + } + }, + + /** + * Install minimal DevTools hook if missing. + * Note: This only helps if React hasn't initialized yet. + * Only attempts once per session to avoid repeated pollution. + */ + installMinimalHook() { + // Only attempt once per session + if (this.hookInstallAttempted) { + return { installed: false, hook: this.getHook(), skipped: true }; + } + this.hookInstallAttempted = true; + try { + const existing = window[REACT_HOOK_NAME]; + if (existing && typeof existing.inject === 'function') { + return { installed: false, hook: existing }; + } + + const listeners = Object.create(null); + + const hook = { + renderers: new Map(), + supportsFiber: true, + + inject(renderer) { + try { + const id = this.renderers.size + 1; + this.renderers.set(id, renderer); + this.emit('renderer', { id, renderer }); + return id; + } catch { + return 0; + } + }, + + // Required lifecycle callbacks (no-ops) + onCommitFiberRoot() {}, + onCommitFiberUnmount() {}, + onPostCommitFiberRoot() {}, + setStrictMode() {}, + checkDCE() {}, + + // Event emitter + on(event, fn) { + if (typeof event !== 'string' || typeof fn !== 'function') return; + if (!listeners[event]) listeners[event] = new Set(); + listeners[event].add(fn); + }, + + off(event, fn) { + if (typeof event !== 'string' || typeof fn !== 'function') return; + listeners[event]?.delete(fn); + }, + + emit(event, data) { + const set = listeners[event]; + if (!set) return; + for (const fn of Array.from(set)) { + try { + fn(data); + } catch { + // Listener errors must not break the hook + } + } + }, + + sub(event, fn) { + this.on(event, fn); + return () => this.off(event, fn); + }, + }; + + window[REACT_HOOK_NAME] = hook; + return { installed: true, hook }; + } catch (err) { + return { installed: false, hook: null, error: err }; + } + }, + + /** + * Normalize hook.renderers to array format + */ + normalizeRenderers(hook) { + const result = []; + if (!hook) return result; + + try { + const renderers = hook.renderers; + if (renderers instanceof Map) { + for (const [id, renderer] of renderers.entries()) { + result.push({ id, renderer }); + } + } else if (renderers && typeof renderers === 'object') { + for (const [id, renderer] of Object.entries(renderers)) { + result.push({ id, renderer }); + } + } + } catch { + // Best-effort + } + return result; + }, + + /** + * Detect Hook status (4 states) + */ + detectStatus() { + const hook = this.getHook(); + + if (!hook || typeof hook.inject !== 'function') { + return { + hookStatus: HOOK_STATUS.HOOK_MISSING, + hook: null, + renderers: [], + editableRenderers: [], + }; + } + + const renderers = this.normalizeRenderers(hook); + if (!renderers.length) { + return { + hookStatus: HOOK_STATUS.HOOK_PRESENT_NO_RENDERERS, + hook, + renderers, + editableRenderers: [], + }; + } + + const editableRenderers = renderers.filter( + (r) => r?.renderer && typeof r.renderer.overrideProps === 'function', + ); + + if (editableRenderers.length) { + return { + hookStatus: HOOK_STATUS.READY, + hook, + renderers, + editableRenderers, + }; + } + + return { + hookStatus: HOOK_STATUS.RENDERERS_NO_EDITING, + hook, + renderers, + editableRenderers: [], + }; + }, + + /** + * Get React version from renderer or global. + * Prioritizes specific renderer version for multi-renderer scenarios. + * + * @param {object} hookInfo - Result from detectStatus() + * @param {object} [specificRenderer] - Specific renderer to prefer (from resolveFiberWithRenderer) + * @returns {string | undefined} + */ + getVersion(hookInfo, specificRenderer) { + try { + // Priority 1: Specific renderer version (for multi-renderer scenarios) + if (specificRenderer) { + const version = specificRenderer.version; + if (typeof version === 'string' && version.trim()) { + return version.trim(); + } + } + + // Priority 2: Any renderer with version + const renderers = hookInfo?.renderers || []; + for (const item of renderers) { + const version = item?.renderer?.version; + if (typeof version === 'string' && version.trim()) { + return version.trim(); + } + } + + // Priority 3: Global React object (if exposed) + if (typeof window !== 'undefined' && window.React?.version) { + return String(window.React.version).trim(); + } + } catch { + // Best-effort + } + return undefined; + }, + + /** + * Find React fiber from DOM node + */ + findFiberFromDOM(node) { + try { + if (!node || typeof node !== 'object') return null; + const keys = Object.keys(node); + for (const key of keys) { + if (key.startsWith('__reactFiber$') || key.startsWith('__reactInternalInstance$')) { + return node[key]; + } + } + } catch { + // Best-effort + } + return null; + }, + + /** + * Check if fiber tag is a component (Function/Class/ForwardRef etc.) + */ + isComponentTag(tag) { + // 0=FunctionComponent, 1=ClassComponent, 2=IndeterminateComponent, + // 11=ForwardRef, 14=MemoComponent, 15=SimpleMemoComponent + return tag === 0 || tag === 1 || tag === 2 || tag === 11 || tag === 14 || tag === 15; + }, + + /** + * Find nearest component fiber by walking up the fiber tree + */ + findNearestComponentFiber(fiber) { + try { + let current = fiber; + for (let i = 0; i < 60 && current; i++) { + if (this.isComponentTag(current.tag)) return current; + current = current.return; + } + } catch { + // Best-effort + } + return null; + }, + + /** + * Get component display name from fiber + */ + getComponentName(fiber) { + try { + const type = fiber?.type || fiber?.elementType; + if (!type) return 'Anonymous'; + if (typeof type === 'string') return type; + return safeString(type.displayName || type.name) || 'Anonymous'; + } catch { + return 'Anonymous'; + } + }, + + /** + * Extract debug source from React Fiber. + * Walks up the fiber tree checking _debugSource and _debugOwner._debugSource. + * + * @param {object} fiber - React Fiber node + * @returns {{ file: string, line?: number, column?: number, componentName?: string } | null} + */ + getDebugSource(fiber) { + try { + let current = fiber; + for (let i = 0; i < 40 && current; i++) { + if (!isObject(current)) break; + + // Try direct _debugSource first + const src = isObject(current._debugSource) ? current._debugSource : null; + if (src) { + const file = safeString(src.fileName).trim(); + if (file) { + return this.buildDebugSourceResult(file, src.lineNumber, src.columnNumber, current); + } + } + + // Fallback to _debugOwner._debugSource + const owner = isObject(current._debugOwner) ? current._debugOwner : null; + const ownerSrc = owner && isObject(owner._debugSource) ? owner._debugSource : null; + if (ownerSrc) { + const ownerFile = safeString(ownerSrc.fileName).trim(); + if (ownerFile) { + return this.buildDebugSourceResult( + ownerFile, + ownerSrc.lineNumber, + ownerSrc.columnNumber, + owner, + ); + } + } + + current = current.return; + } + } catch { + // Best-effort extraction + } + return null; + }, + + /** + * Build debug source result with validated line/column values. + * @private + */ + buildDebugSourceResult(file, lineNumber, columnNumber, fiberForName) { + const line = Number(lineNumber); + const column = Number(columnNumber); + return { + file, + line: Number.isFinite(line) && line > 0 ? line : undefined, + column: Number.isFinite(column) && column > 0 ? column : undefined, + componentName: this.getComponentName(fiberForName), + }; + }, + + /** + * Resolve fiber using renderer.findFiberByHostInstance when available + */ + resolveFiberWithRenderer(element, hookInfo) { + // Prefer renderer API (returns renderer-owned fiber suitable for overrideProps) + try { + const renderers = hookInfo?.renderers || []; + for (const item of renderers) { + const renderer = item?.renderer; + if (!renderer || typeof renderer.findFiberByHostInstance !== 'function') continue; + try { + const fiber = renderer.findFiberByHostInstance(element); + if (fiber) return { fiber, renderer }; + } catch { + // Try next renderer + } + } + } catch { + // Best-effort + } + + // Fallback: DOM-attached fiber reference + const fallback = this.findFiberFromDOM(element); + return { fiber: fallback, renderer: null }; + }, + + /** + * Record original value for reset + */ + recordOriginal(fiber, renderer, path, existed, value) { + if (!this.overrideStore || !fiber) return; + + try { + const key = JSON.stringify(path); + let store = this.overrideStore.get(fiber); + + if (!store) { + store = { renderer: renderer || null, originals: new Map() }; + this.overrideStore.set(fiber, store); + + // Also store by alternate to improve reset hit rate + if (fiber.alternate && typeof fiber.alternate === 'object') { + this.overrideStore.set(fiber.alternate, store); + } + } + + if (!store.originals.has(key)) { + store.originals.set(key, { path, existed, value }); + } + + if (!store.renderer && renderer) { + store.renderer = renderer; + } + } catch { + // Best-effort + } + }, + + /** + * Get stored originals for fiber + */ + getOriginals(fiber) { + if (!this.overrideStore || !fiber) return null; + return this.overrideStore.get(fiber) || null; + }, + + /** + * Clear stored originals for fiber + */ + clearOriginals(fiber) { + if (!this.overrideStore || !fiber) return; + const store = this.overrideStore.get(fiber); + if (store?.originals) store.originals.clear(); + }, + }; + + // ============================================================================= + // Vue Adapter + // ============================================================================= + + const VueAdapter = { + /** Store original values for reset (instance -> Map) */ + overrideStore: typeof WeakMap === 'function' ? new WeakMap() : null, + + /** + * Find Vue 3 component instance from DOM node + */ + findInstanceFromDOM(node) { + try { + if (!node || typeof node !== 'object') return null; + return node.__vueParentComponent || null; + } catch { + return null; + } + }, + + /** + * Get component name from instance + */ + getComponentName(instance) { + try { + const type = instance?.type; + return safeString(type?.name || type?.__name) || 'Anonymous'; + } catch { + return 'Anonymous'; + } + }, + + /** + * Check if instance appears to be from dev build + */ + isDevBuild(instance) { + try { + const type = instance?.type; + const file = type?.__file; + return typeof file === 'string' && !!file.trim(); + } catch { + return false; + } + }, + + /** + * Parse Vue inspector location attribute value. + * Format: "src/components/Foo.vue:23:7" or "C:\path\file.vue:10:5" (Windows) + * + * Uses trailing regex to safely handle Windows paths with drive letters. + * + * @param {string} value - The data-v-inspector attribute value + * @returns {{ file: string, line?: number, column?: number } | null} + */ + parseVInspector(value) { + if (typeof value !== 'string') return null; + const raw = value.trim(); + if (!raw) return null; + + // Match only trailing :line or :line:column to avoid Windows drive letter issues + const match = raw.match(/:([\d]+)(?::([\d]+))?$/); + if (!match) { + // No line info, return file only + return { file: raw }; + } + + const file = raw.slice(0, match.index).trim(); + if (!file) return null; + + const line = Number.parseInt(match[1], 10); + const column = match[2] ? Number.parseInt(match[2], 10) : undefined; + + return { + file, + line: Number.isFinite(line) && line > 0 ? line : undefined, + column: Number.isFinite(column) && column > 0 ? column : undefined, + }; + }, + + /** + * Walk up DOM tree to find data-v-inspector attribute. + * This attribute is injected by @vitejs/plugin-vue-inspector. + * + * @param {Element} element - Starting DOM element + * @param {number} [maxDepth=15] - Maximum depth to traverse + * @returns {{ file: string, line?: number, column?: number } | null} + */ + findInspectorLocation(element, maxDepth = 15) { + try { + let node = element; + for (let depth = 0; depth < maxDepth && node; depth++) { + if (typeof node.getAttribute === 'function') { + const attr = node.getAttribute('data-v-inspector'); + if (attr) { + const parsed = this.parseVInspector(attr); + if (parsed?.file) return parsed; + } + } + node = node.parentElement; + } + } catch { + // Best-effort extraction + } + return null; + }, + + /** + * Get Vue component debug source. + * Priority: data-v-inspector (has line/column) > type.__file (file only) + * + * @param {object} instance - Vue component instance + * @param {Element} targetElement - DOM element for inspector lookup + * @returns {{ file: string, line?: number, column?: number, componentName?: string } | null} + */ + getDebugSource(instance, targetElement) { + try { + // Priority 1: data-v-inspector attribute (has precise line/column) + const inspector = this.findInspectorLocation(targetElement); + if (inspector?.file) { + return { + file: inspector.file, + line: inspector.line, + column: inspector.column, + componentName: this.getComponentName(instance), + }; + } + + // Priority 2: type.__file (file only, no line/column) + const typeFile = instance?.type?.__file; + if (typeof typeFile === 'string') { + const file = typeFile.trim(); + if (file) { + return { + file, + componentName: this.getComponentName(instance), + }; + } + } + } catch { + // Best-effort extraction + } + return null; + }, + + /** + * Get Vue 3 version from instance. + * Note: This adapter only supports Vue 3 (via __vueParentComponent). + * + * @param {object} instance - Vue 3 component instance + * @returns {string | undefined} + */ + getVersion(instance) { + try { + // Vue 3: Get version from app context + const appVersion = instance?.appContext?.app?.version; + if (typeof appVersion === 'string' && appVersion.trim()) { + return appVersion.trim(); + } + } catch { + // Best-effort + } + return undefined; + }, + + /** + * Get writable props container (vnode.props or instance.props) + * @deprecated Use getWriteContainers for better targeting + */ + getPropsContainer(instance) { + try { + const vnodeProps = instance?.vnode?.props; + if (vnodeProps && typeof vnodeProps === 'object') return vnodeProps; + } catch { + // ignore + } + + try { + const props = instance?.props; + if (props && typeof props === 'object') return props; + } catch { + // ignore + } + + return null; + }, + + /** + * Check if a key is a declared prop (vs fallthrough attr). + * Uses component type definition and runtime props object. + */ + isDeclaredProp(instance, key) { + // Check type.props definition first + try { + const opts = instance?.type?.props; + if (Array.isArray(opts)) return opts.includes(key); + if (isObject(opts)) return Object.prototype.hasOwnProperty.call(opts, key); + } catch { + // ignore + } + + // Fallback: if key exists in instance.props, treat as declared + try { + const props = instance?.props; + if (isObject(props)) { + return Object.prototype.hasOwnProperty.call(props, key); + } + } catch { + // ignore + } + + return false; + }, + + /** + * Get write container candidates for a prop kind ('props' | 'attrs'). + * Returns array of containers to try in order. + */ + getWriteContainers(instance, kind) { + const containers = []; + const seen = typeof Set === 'function' ? new Set() : null; + + const addContainer = (obj) => { + if (!obj || typeof obj !== 'object') return; + if (seen) { + if (seen.has(obj)) return; + seen.add(obj); + } + containers.push(obj); + }; + + if (!instance || typeof instance !== 'object') return containers; + + // Primary container based on kind + if (kind === 'attrs') { + try { + addContainer(instance.attrs); + } catch { + // ignore + } + } else { + try { + addContainer(instance.props); + } catch { + // ignore + } + } + + // Fallback: vnode.props (often more writable) + try { + addContainer(instance?.vnode?.props); + } catch { + // ignore + } + + return containers; + }, + + /** + * Get logical root for reading a prop kind. + */ + getReadRoot(instance, kind) { + if (kind === 'attrs') { + try { + if (isObject(instance?.attrs)) return instance.attrs; + } catch { + // ignore + } + } else { + try { + if (isObject(instance?.props)) return instance.props; + } catch { + // ignore + } + } + + // Fallback + try { + if (isObject(instance?.vnode?.props)) return instance.vnode.props; + } catch { + // ignore + } + + return null; + }, + + /** + * Get raw vnode props object + */ + getVNodeProps(instance) { + try { + const p = instance?.vnode?.props; + return isObject(p) ? p : null; + } catch { + return null; + } + }, + + /** + * Apply new raw props via instance.next + instance.update() so Vue runs its internal + * updateProps/updateSlots pipeline (closest to a parent-driven props update). + * This is the correct way to trigger Vue3 props update. + */ + applyNextProps(instance, nextRawProps) { + try { + const vnode = instance?.vnode; + if (!vnode || typeof vnode !== 'object') return false; + + // Vue3 PatchFlags.FULL_PROPS = 16 + const FULL_PROPS = 16; + const prevFlag = typeof vnode.patchFlag === 'number' ? vnode.patchFlag : 0; + const patchFlag = prevFlag >= 0 ? prevFlag | FULL_PROPS : FULL_PROPS; + + // Create next vnode with updated props + const nextVNode = Object.assign({}, vnode, { + props: nextRawProps, + patchFlag, + dynamicProps: null, + component: instance, + }); + + instance.next = nextVNode; + + // Trigger update + if (instance && typeof instance.update === 'function') { + instance.update(); + return true; + } + + const proxy = instance?.proxy; + if (proxy && typeof proxy.$forceUpdate === 'function') { + proxy.$forceUpdate(); + return true; + } + } catch { + // ignore + } + return false; + }, + + /** + * Trigger Vue re-render (fallback, may not work for props changes) + */ + forceUpdate(instance) { + try { + const proxy = instance?.proxy; + if (proxy && typeof proxy.$forceUpdate === 'function') { + proxy.$forceUpdate(); + return true; + } + } catch { + // ignore + } + + try { + if (instance && typeof instance.update === 'function') { + instance.update(); + return true; + } + } catch { + // ignore + } + + return false; + }, + + /** + * Immutable update helper for nested props + */ + copyWithSet(root, path, value) { + if (!Array.isArray(path) || path.length === 0) return value; + + const seg = path[0]; + const rest = path.slice(1); + const isIndex = typeof seg === 'number'; + + let base = root; + if ( + base === null || + base === undefined || + (typeof base !== 'object' && !Array.isArray(base)) + ) { + base = isIndex ? [] : {}; + } + + const clone = Array.isArray(base) ? base.slice() : { ...base }; + clone[seg] = this.copyWithSet(clone[seg], rest, value); + return clone; + }, + + /** + * Record original value for reset + * @param {object} instance - Vue component instance + * @param {Array} path - Prop path + * @param {boolean} existed - Whether the prop existed before + * @param {*} value - Original value + * @param {'props'|'attrs'} [targetKind] - Target container kind (for accurate reset) + */ + recordOriginal(instance, path, existed, value, targetKind) { + if (!this.overrideStore || !instance) return; + + try { + const key = JSON.stringify(path); + let store = this.overrideStore.get(instance); + + if (!store) { + store = new Map(); + this.overrideStore.set(instance, store); + } + + if (!store.has(key)) { + store.set(key, { path, existed, value, targetKind }); + } + } catch { + // Best-effort + } + }, + + /** + * Get stored originals for instance + */ + getOriginals(instance) { + if (!this.overrideStore || !instance) return null; + return this.overrideStore.get(instance) || null; + }, + + /** + * Clear stored originals for instance + */ + clearOriginals(instance) { + if (!this.overrideStore || !instance) return; + const store = this.overrideStore.get(instance); + if (store) store.clear(); + }, + }; + + // ============================================================================= + // Framework Detector + // ============================================================================= + + const FrameworkDetector = { + /** + * Detect framework for element (walks up DOM tree) + */ + detect(element, maxDepth = 15) { + let node = element; + + for (let depth = 0; depth < maxDepth && node; depth++) { + // React first (more common) + const fiber = ReactAdapter.findFiberFromDOM(node); + if (fiber) { + return { framework: 'react', node, data: fiber }; + } + + // Vue 3 + const vue = VueAdapter.findInstanceFromDOM(node); + if (vue) { + return { framework: 'vue', node, data: vue }; + } + + node = node.parentElement; + } + + return { framework: 'unknown', node: null, data: null }; + }, + }; + + // ============================================================================= + // Serializer + // ============================================================================= + + const Serializer = { + /** + * Check if value is a React element + */ + isReactElement(value) { + try { + if (!value || typeof value !== 'object') return false; + const t = value.$$typeof; + if (!t) return false; + + if (typeof Symbol === 'function' && Symbol.for) { + return ( + t === Symbol.for('react.element') || + t === Symbol.for('react.transitional.element') || + t === Symbol.for('react.portal') + ); + } + + // Fallback heuristic + return !!(value.type && value.props); + } catch { + return false; + } + }, + + /** + * Get React element display string + */ + reactElementDisplay(value) { + try { + const type = value?.type; + if (typeof type === 'string') return `<${type} />`; + if (typeof type === 'function') { + return `<${safeString(type.displayName || type.name) || 'Anonymous'} />`; + } + if (type && typeof type === 'object') { + const name = safeString(type.displayName || type.name) || 'Anonymous'; + return `<${name} />`; + } + } catch { + // ignore + } + return ''; + }, + + /** + * Check if value is an editable primitive + */ + isEditablePrimitive(value) { + if (value === null || value === undefined) return true; + const t = typeof value; + if (t === 'string' || t === 'boolean') return true; + if (t === 'number') return Number.isFinite(value); + return false; + }, + + /** + * Create serialization context for cycle detection + */ + createContext() { + return { + seen: typeof WeakMap === 'function' ? new WeakMap() : null, + nextId: 1, + }; + }, + + /** + * Serialize a value with type information + */ + serializeValue(value, ctx, depth = 0) { + try { + if (value === null) return { kind: 'null' }; + if (value === undefined) return { kind: 'undefined' }; + + const t = typeof value; + + if (t === 'string') { + if (value.length > SERIALIZE_LIMITS.maxStringLength) { + return { + kind: 'string', + value: value.slice(0, SERIALIZE_LIMITS.maxStringLength), + truncated: true, + length: value.length, + }; + } + return { kind: 'string', value }; + } + + if (t === 'number') { + if (Number.isFinite(value)) return { kind: 'number', value }; + if (Number.isNaN(value)) return { kind: 'number', special: 'NaN' }; + return { kind: 'number', special: value > 0 ? 'Infinity' : '-Infinity' }; + } + + if (t === 'boolean') return { kind: 'boolean', value }; + if (t === 'bigint') return { kind: 'bigint', value: value.toString() }; + if (t === 'symbol') return { kind: 'symbol', description: safeString(value) }; + if (t === 'function') + return { kind: 'function', name: safeString(value.name) || undefined }; + + // Object types + if (this.isReactElement(value)) { + return { kind: 'react_element', display: this.reactElementDisplay(value) }; + } + + if (typeof Element !== 'undefined' && value instanceof Element) { + return { + kind: 'dom_element', + tagName: safeString(value.tagName).toLowerCase(), + id: safeString(value.id) || undefined, + className: safeString(value.className) || undefined, + }; + } + + if (value instanceof Date) { + let iso = ''; + try { + iso = value.toISOString(); + } catch { + iso = safeString(value); + } + return { kind: 'date', value: iso }; + } + + if (value instanceof RegExp) { + return { kind: 'regexp', source: value.source, flags: value.flags }; + } + + if (value instanceof Error) { + return { + kind: 'error', + name: safeString(value.name) || 'Error', + message: safeString(value.message), + }; + } + + // Depth limit + if (depth >= SERIALIZE_LIMITS.maxDepth) { + return { + kind: 'max_depth', + type: Object.prototype.toString.call(value), + preview: safeString(value), + }; + } + + // Circular reference detection + if (ctx?.seen) { + const existingId = ctx.seen.get(value); + if (existingId) return { kind: 'circular', refId: existingId }; + ctx.seen.set(value, ctx.nextId++); + } + + // Array + if (Array.isArray(value)) { + const max = Math.min(value.length, SERIALIZE_LIMITS.maxArrayLength); + const items = []; + for (let i = 0; i < max; i++) { + items.push(this.serializeValue(value[i], ctx, depth + 1)); + } + return { + kind: 'array', + length: value.length, + truncated: value.length > max, + items, + }; + } + + // Map + if (value instanceof Map) { + const entries = []; + let count = 0; + for (const [k, v] of value.entries()) { + if (count >= SERIALIZE_LIMITS.maxEntries) break; + entries.push({ + key: this.serializeValue(k, ctx, depth + 1), + value: this.serializeValue(v, ctx, depth + 1), + }); + count++; + } + return { + kind: 'map', + size: value.size, + truncated: value.size > count, + entries, + }; + } + + // Set + if (value instanceof Set) { + const items = []; + let count = 0; + for (const v of value.values()) { + if (count >= SERIALIZE_LIMITS.maxEntries) break; + items.push(this.serializeValue(v, ctx, depth + 1)); + count++; + } + return { + kind: 'set', + size: value.size, + truncated: value.size > count, + items, + }; + } + + // Plain object + const constructorName = value?.constructor?.name; + const name = typeof constructorName === 'string' ? constructorName : undefined; + const keys = Object.keys(value); + const limitedKeys = keys.slice(0, SERIALIZE_LIMITS.maxEntries); + const entries = limitedKeys.map((k) => ({ + key: k, + value: this.serializeValue(value[k], ctx, depth + 1), + })); + + return { + kind: 'object', + name: name !== 'Object' ? name : undefined, + truncated: keys.length > limitedKeys.length, + entries, + }; + } catch (err) { + return { kind: 'unknown', type: typeof value, preview: safeString(err) }; + } + }, + + /** + * Serialize props object to structured format + * @param {object} props - Props object to serialize + * @param {Record>} [enumValuesByKey] - Optional enum values by prop key + */ + serializeProps(props, enumValuesByKey) { + const ctx = this.createContext(); + const entries = []; + const enumMap = isObject(enumValuesByKey) ? enumValuesByKey : null; + + if (!props || (typeof props !== 'object' && typeof props !== 'function')) { + return { kind: 'props', entries: [] }; + } + + const keys = Object.keys(props); + const limited = keys.slice(0, SERIALIZE_LIMITS.maxEntries); + + for (const key of limited) { + let raw; + try { + raw = props[key]; + } catch { + raw = undefined; + } + + const entry = { + key, + editable: this.isEditablePrimitive(raw), + value: this.serializeValue(raw, ctx, 0), + }; + + // Attach enum values if available + const enumValues = enumMap ? enumMap[key] : null; + if (Array.isArray(enumValues) && enumValues.length > 0) { + entry.enumValues = enumValues.slice(0, EnumIntrospection.MAX_ENUM_VALUES); + } + + entries.push(entry); + } + + const result = { kind: 'props', entries }; + if (keys.length > limited.length) result.truncated = true; + return result; + }, + }; + + // ============================================================================= + // Enum Introspection (Best-effort) + // ============================================================================= + + /** + * Best-effort enum value extraction from React/Vue runtime metadata. + * + * React: Relies on __docgenInfo (Storybook/react-docgen output) + * Vue: Relies on explicit values/validator.values in props options + */ + const EnumIntrospection = { + MAX_ENUM_VALUES: 50, + + /** + * Normalize a raw enum value to primitive + */ + normalizeEnumValue(raw) { + if (raw === null || raw === undefined) return null; + + if (typeof raw === 'boolean') return raw; + if (typeof raw === 'number') return Number.isFinite(raw) ? raw : null; + + const s = safeString(raw).trim(); + if (!s) return null; + + // Strip surrounding quotes: "'primary'" -> "primary" + const m = s.match(/^(['"])(.*)\1$/); + const unquoted = m ? m[2] : s; + + if (unquoted === 'true') return true; + if (unquoted === 'false') return false; + + if (/^-?(?:\d+|\d*\.\d+)$/.test(unquoted)) { + const n = Number(unquoted); + if (Number.isFinite(n)) return n; + } + + return unquoted; + }, + + /** + * Normalize array of enum values, deduplicate + */ + normalizeEnumList(list) { + if (!Array.isArray(list)) return []; + const out = []; + const seen = new Set(); + + for (const item of list) { + const v = this.normalizeEnumValue(item); + if (v === null) continue; + const key = + typeof v === 'string' ? `s:${v}` : typeof v === 'number' ? `n:${v}` : `b:${v ? 1 : 0}`; + if (seen.has(key)) continue; + seen.add(key); + out.push(v); + if (out.length >= this.MAX_ENUM_VALUES) break; + } + + return out; + }, + + /** + * Extract enum values from React docgen prop info + * (e.g., from Storybook's __docgenInfo) + */ + extractDocgenEnumValues(propInfo) { + if (!isObject(propInfo)) return []; + + // Check type.name === 'enum' with type.value array + const t = propInfo.type; + if (isObject(t) && t.name === 'enum' && Array.isArray(t.value)) { + const rawList = t.value.map((item) => + isObject(item) && 'value' in item ? item.value : item, + ); + return this.normalizeEnumList(rawList); + } + + // Check tsType for TypeScript enums + const ts = propInfo.tsType; + if (isObject(ts) && ts.name === 'union' && Array.isArray(ts.elements)) { + const rawList = ts.elements.map((el) => + isObject(el) && 'value' in el ? el.value : el.name, + ); + return this.normalizeEnumList(rawList); + } + + return []; + }, + + /** + * Get enum values map for React component + */ + getReactEnumValues(componentFiber) { + try { + const type = componentFiber?.type || componentFiber?.elementType; + if (!type) return {}; + + const docgen = type.__docgenInfo; + if (!isObject(docgen) || !isObject(docgen.props)) return {}; + + const result = {}; + for (const [key, info] of Object.entries(docgen.props)) { + const values = this.extractDocgenEnumValues(info); + if (values.length > 0) result[key] = values; + } + return result; + } catch { + return {}; + } + }, + + /** + * Extract enum values from Vue prop option + */ + extractVuePropEnumValues(propOption) { + if (!isObject(propOption)) return []; + + // Check explicit values array + if (Array.isArray(propOption.values)) { + return this.normalizeEnumList(propOption.values); + } + + // Check validator with values/allowedValues + const validator = propOption.validator; + if (validator && Array.isArray(validator.values)) { + return this.normalizeEnumList(validator.values); + } + if (validator && Array.isArray(validator.allowedValues)) { + return this.normalizeEnumList(validator.allowedValues); + } + + return []; + }, + + /** + * Get enum values map for Vue component + */ + getVueEnumValues(instance) { + try { + const propsOptions = instance?.type?.props; + if (!isObject(propsOptions)) return {}; + + const result = {}; + for (const [key, opt] of Object.entries(propsOptions)) { + const values = this.extractVuePropEnumValues(opt); + if (values.length > 0) result[key] = values; + } + return result; + } catch { + return {}; + } + }, + }; + + // ============================================================================= + // Value Access Helpers + // ============================================================================= + + function getValueAtPath(root, path) { + let current = root; + + for (let i = 0; i < path.length; i++) { + const seg = path[i]; + if (!isObject(current) && !Array.isArray(current)) { + return { ok: false, existed: false, value: undefined }; + } + + const has = Object.prototype.hasOwnProperty.call(current, seg); + current = current[seg]; + + if (!has && i === path.length - 1) { + return { ok: true, existed: false, value: undefined }; + } + } + + return { ok: true, existed: true, value: current }; + } + + // Dangerous keys that could cause prototype pollution or unexpected behavior + const DANGEROUS_KEYS = new Set([ + '__proto__', + 'constructor', + 'prototype', + '__defineGetter__', + '__defineSetter__', + '__lookupGetter__', + '__lookupSetter__', + ]); + + function isDangerousKey(key) { + return typeof key === 'string' && DANGEROUS_KEYS.has(key); + } + + function normalizePropPath(value) { + if (!Array.isArray(value) || value.length === 0 || value.length > 32) return null; + + const result = []; + for (const seg of value) { + if (typeof seg === 'string') { + const s = seg.trim(); + if (!s) return null; + // Reject dangerous keys to prevent prototype pollution + if (isDangerousKey(s)) return null; + result.push(s); + } else if (typeof seg === 'number' && Number.isInteger(seg) && seg >= 0 && seg <= 1e6) { + result.push(seg); + } else { + return null; + } + } + return result; + } + + function decodeIncomingValue(raw) { + // Bridge encodes undefined as { $we: 'undefined' } + if (isObject(raw) && raw.$we === 'undefined') return undefined; + return raw; + } + + // ============================================================================= + // Capabilities Builder + // ============================================================================= + + function makeCapabilities(init) { + return { + canRead: Boolean(init?.canRead), + canWrite: Boolean(init?.canWrite), + canWriteHooks: Boolean(init?.canWriteHooks), + }; + } + + function buildResponseData(init) { + const data = {}; + if (init?.hookStatus) data.hookStatus = init.hookStatus; + if (typeof init?.needsRefresh === 'boolean') data.needsRefresh = init.needsRefresh; + if (init?.framework) data.framework = init.framework; + if (init?.frameworkVersion) data.frameworkVersion = init.frameworkVersion; + if (init?.componentName) data.componentName = init.componentName; + if (init?.debugSource) data.debugSource = init.debugSource; + if (init?.props) data.props = init.props; + if (init?.capabilities) data.capabilities = init.capabilities; + if (init?.meta) data.meta = init.meta; + return data; + } + + // ============================================================================= + // Request Handlers + // ============================================================================= + + const Handlers = { + resolveTarget(locator) { + if (!locator) return null; + const el = Locator.locate(locator, document); + // Return element if connected to DOM; otherwise return null + return el?.isConnected ? el : null; + }, + + /** + * Handle 'probe' operation - Detect capabilities without reading props + */ + handleProbe(req) { + // Check initial hook status + const preStatus = ReactAdapter.detectStatus(); + const initialHookStatus = preStatus.hookStatus; + + // Try to install hook if missing (only helps if React hasn't initialized) + if (initialHookStatus === HOOK_STATUS.HOOK_MISSING) { + ReactAdapter.installMinimalHook(); + } + + const hookInfo = ReactAdapter.detectStatus(); + // Report original status if hook was missing (so UI knows refresh is needed) + const hookStatus = + initialHookStatus === HOOK_STATUS.HOOK_MISSING + ? HOOK_STATUS.HOOK_MISSING + : hookInfo.hookStatus; + + const target = this.resolveTarget(req.locator); + const fw = target ? FrameworkDetector.detect(target) : { framework: 'unknown', data: null }; + + let componentName; + let debugSource; + let canRead = false; + let canWrite = false; + let needsRefresh = false; + + let frameworkVersion; + + if (fw.framework === 'react') { + const fiberInfo = ReactAdapter.resolveFiberWithRenderer(target, hookInfo); + const componentFiber = fiberInfo.fiber + ? ReactAdapter.findNearestComponentFiber(fiberInfo.fiber) + : null; + + componentName = componentFiber ? ReactAdapter.getComponentName(componentFiber) : undefined; + // Extract debug source from component fiber or raw fiber + const sourceFiber = componentFiber || fiberInfo.fiber; + debugSource = sourceFiber ? ReactAdapter.getDebugSource(sourceFiber) : undefined; + // Pass specific renderer to prioritize its version in multi-renderer scenarios + frameworkVersion = ReactAdapter.getVersion(hookInfo, fiberInfo.renderer); + canRead = Boolean(componentFiber); + canWrite = hookStatus === HOOK_STATUS.READY && Boolean(componentFiber); + needsRefresh = canRead && hookStatus !== HOOK_STATUS.READY; + } else if (fw.framework === 'vue') { + const instance = fw.data; + componentName = VueAdapter.getComponentName(instance); + debugSource = instance ? VueAdapter.getDebugSource(instance, target) : undefined; + frameworkVersion = VueAdapter.getVersion(instance); + canRead = Boolean(instance); + canWrite = Boolean(instance) && VueAdapter.isDevBuild(instance); + needsRefresh = false; + } + + const data = buildResponseData({ + hookStatus, + framework: fw.framework, + frameworkVersion, + componentName, + debugSource, + capabilities: makeCapabilities({ canRead, canWrite, canWriteHooks: false }), + needsRefresh, + }); + + return Transport.createResponse(req.requestId, true, data); + }, + + /** + * Handle 'read' operation - Read component props + */ + handleRead(req) { + const target = this.resolveTarget(req.locator); + if (!target) { + return Transport.createResponse( + req.requestId, + false, + undefined, + 'Target element not found', + ); + } + + const preStatus = ReactAdapter.detectStatus(); + if (preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING) { + ReactAdapter.installMinimalHook(); + } + + const hookInfo = ReactAdapter.detectStatus(); + const hookStatus = + preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING + ? HOOK_STATUS.HOOK_MISSING + : hookInfo.hookStatus; + + const fw = FrameworkDetector.detect(target); + + if (fw.framework === 'react') { + const fiberInfo = ReactAdapter.resolveFiberWithRenderer(target, hookInfo); + const componentFiber = fiberInfo.fiber + ? ReactAdapter.findNearestComponentFiber(fiberInfo.fiber) + : null; + + // Extract debug source even if component fiber not found + const sourceFiber = componentFiber || fiberInfo.fiber; + const debugSource = sourceFiber ? ReactAdapter.getDebugSource(sourceFiber) : undefined; + // Pass specific renderer to prioritize its version in multi-renderer scenarios + const frameworkVersion = ReactAdapter.getVersion(hookInfo, fiberInfo.renderer); + + if (!componentFiber) { + const data = buildResponseData({ + hookStatus, + framework: 'react', + frameworkVersion, + debugSource, + capabilities: makeCapabilities({ canRead: false, canWrite: false }), + needsRefresh: false, + }); + return Transport.createResponse( + req.requestId, + false, + data, + 'React component fiber not found', + ); + } + + const props = componentFiber.memoizedProps; + const enumValuesByKey = EnumIntrospection.getReactEnumValues(componentFiber); + const serialized = Serializer.serializeProps(props, enumValuesByKey); + const componentName = ReactAdapter.getComponentName(componentFiber); + const canWrite = hookStatus === HOOK_STATUS.READY; + const needsRefresh = hookStatus !== HOOK_STATUS.READY; + + const data = buildResponseData({ + hookStatus, + framework: 'react', + frameworkVersion, + componentName, + debugSource, + props: serialized, + capabilities: makeCapabilities({ canRead: true, canWrite, canWriteHooks: false }), + needsRefresh, + }); + + return Transport.createResponse(req.requestId, true, data); + } + + if (fw.framework === 'vue') { + const instance = fw.data; + const frameworkVersion = VueAdapter.getVersion(instance); + + if (!instance) { + const data = buildResponseData({ + hookStatus, + framework: 'vue', + frameworkVersion, + capabilities: makeCapabilities({ canRead: false, canWrite: false }), + needsRefresh: false, + }); + return Transport.createResponse( + req.requestId, + false, + data, + 'Vue component instance not found', + ); + } + + const componentName = VueAdapter.getComponentName(instance); + const debugSource = VueAdapter.getDebugSource(instance, target); + + // Read both props and attrs + let rootProps = null; + let rootAttrs = null; + try { + rootProps = instance.props; + } catch { + rootProps = null; + } + try { + rootAttrs = instance.attrs; + } catch { + rootAttrs = null; + } + + // Serialize props with enum introspection + const enumValuesByKey = EnumIntrospection.getVueEnumValues(instance); + const serializedProps = Serializer.serializeProps(rootProps, enumValuesByKey); + const serializedAttrs = Serializer.serializeProps(rootAttrs, null); + + // Merge entries with source annotation + const mergedEntries = []; + if (Array.isArray(serializedProps.entries)) { + for (const entry of serializedProps.entries) { + mergedEntries.push({ ...entry, source: 'props' }); + } + } + if (Array.isArray(serializedAttrs.entries)) { + for (const entry of serializedAttrs.entries) { + mergedEntries.push({ ...entry, source: 'attrs' }); + } + } + + const serialized = { + kind: 'props', + entries: mergedEntries, + }; + if (serializedProps.truncated || serializedAttrs.truncated) { + serialized.truncated = true; + } + + const canWrite = VueAdapter.isDevBuild(instance); + + const data = buildResponseData({ + hookStatus, + framework: 'vue', + frameworkVersion, + componentName, + debugSource, + props: serialized, + capabilities: makeCapabilities({ canRead: true, canWrite, canWriteHooks: false }), + needsRefresh: false, + }); + + return Transport.createResponse(req.requestId, true, data); + } + + // Unknown framework + const data = buildResponseData({ + hookStatus, + framework: 'unknown', + capabilities: makeCapabilities({ canRead: false, canWrite: false }), + needsRefresh: false, + }); + + return Transport.createResponse(req.requestId, false, data, 'Not a React/Vue component'); + }, + + /** + * Handle 'write' operation - Modify component props + */ + handleWrite(req) { + const target = this.resolveTarget(req.locator); + if (!target) { + return Transport.createResponse( + req.requestId, + false, + undefined, + 'Target element not found', + ); + } + + const path = normalizePropPath(req.payload?.propPath); + if (!path) { + return Transport.createResponse(req.requestId, false, undefined, 'Invalid propPath'); + } + + const rawValue = req.payload?.propValue; + const value = decodeIncomingValue(rawValue); + if (!Serializer.isEditablePrimitive(value)) { + return Transport.createResponse( + req.requestId, + false, + undefined, + 'Only primitive prop values are supported', + ); + } + + const preStatus = ReactAdapter.detectStatus(); + if (preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING) { + ReactAdapter.installMinimalHook(); + } + + const hookInfo = ReactAdapter.detectStatus(); + const hookStatus = + preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING + ? HOOK_STATUS.HOOK_MISSING + : hookInfo.hookStatus; + + const fw = FrameworkDetector.detect(target); + + if (fw.framework === 'react') { + const fiberInfo = ReactAdapter.resolveFiberWithRenderer(target, hookInfo); + const componentFiber = fiberInfo.fiber + ? ReactAdapter.findNearestComponentFiber(fiberInfo.fiber) + : null; + + const componentName = componentFiber + ? ReactAdapter.getComponentName(componentFiber) + : undefined; + const canRead = Boolean(componentFiber); + const canWrite = hookStatus === HOOK_STATUS.READY && Boolean(componentFiber); + const needsRefresh = canRead && hookStatus !== HOOK_STATUS.READY; + + const base = buildResponseData({ + hookStatus, + framework: 'react', + componentName, + capabilities: makeCapabilities({ canRead, canWrite, canWriteHooks: false }), + needsRefresh, + }); + + if (!componentFiber) { + return Transport.createResponse( + req.requestId, + false, + base, + 'React component fiber not found', + ); + } + + if (hookStatus !== HOOK_STATUS.READY) { + return Transport.createResponse( + req.requestId, + false, + base, + 'React DevTools editing API unavailable. Use a Development build and refresh the page.', + ); + } + + // Check current value for editability and record original + const props = componentFiber.memoizedProps; + const read = getValueAtPath(props, path); + if (read.ok && read.existed && !Serializer.isEditablePrimitive(read.value)) { + return Transport.createResponse( + req.requestId, + false, + base, + 'Target prop is not a primitive (read-only)', + ); + } + + // Try renderers with overrideProps + const candidates = (hookInfo.editableRenderers || []) + .map((r) => r.renderer) + .filter(Boolean); + const preferred = + fiberInfo.renderer && typeof fiberInfo.renderer.overrideProps === 'function' + ? fiberInfo.renderer + : null; + const ordered = preferred + ? [preferred, ...candidates.filter((r) => r !== preferred)] + : candidates; + + let usedRenderer = null; + let lastErr = null; + + for (const renderer of ordered) { + try { + renderer.overrideProps(componentFiber, path, value); + usedRenderer = renderer; + break; + } catch (err) { + lastErr = err; + } + } + + if (!usedRenderer) { + base.meta = { write: { method: 'overrideProps', error: safeString(lastErr) } }; + return Transport.createResponse( + req.requestId, + false, + base, + 'Failed to write props via overrideProps', + ); + } + + ReactAdapter.recordOriginal(componentFiber, usedRenderer, path, read.existed, read.value); + base.meta = { write: { method: 'overrideProps' } }; + + return Transport.createResponse(req.requestId, true, base); + } + + if (fw.framework === 'vue') { + const instance = fw.data; + const componentName = VueAdapter.getComponentName(instance); + const canRead = Boolean(instance); + const canWrite = Boolean(instance) && VueAdapter.isDevBuild(instance); + + const base = buildResponseData({ + hookStatus, + framework: 'vue', + componentName, + capabilities: makeCapabilities({ canRead, canWrite, canWriteHooks: false }), + needsRefresh: false, + }); + + if (!instance) { + return Transport.createResponse( + req.requestId, + false, + base, + 'Vue component instance not found', + ); + } + + if (!VueAdapter.isDevBuild(instance)) { + return Transport.createResponse( + req.requestId, + false, + base, + 'Vue dev metadata missing. Use a Development build.', + ); + } + + // Vue props keys must be strings at top level + if (typeof path[0] !== 'string') { + return Transport.createResponse( + req.requestId, + false, + base, + 'Vue propPath must start with a string key', + ); + } + + const propName = path[0]; + const subPath = path.slice(1); + + // Infer target kind based on whether key is declared prop + const targetKind = VueAdapter.isDeclaredProp(instance, propName) ? 'props' : 'attrs'; + + // Check current value from logical root + const readRoot = VueAdapter.getReadRoot(instance, targetKind) || {}; + const read = getValueAtPath(readRoot, path); + if (read.ok && read.existed && !Serializer.isEditablePrimitive(read.value)) { + return Transport.createResponse( + req.requestId, + false, + base, + 'Target prop is not a primitive (read-only)', + ); + } + + // Build next vnode props (the correct way to update Vue3 props) + const currentRawProps = VueAdapter.getVNodeProps(instance) || {}; + const nextRawProps = { ...currentRawProps }; + + try { + if (subPath.length === 0) { + nextRawProps[propName] = value; + } else { + const prev = nextRawProps[propName]; + nextRawProps[propName] = VueAdapter.copyWithSet(prev, subPath, value); + } + } catch (err) { + base.meta = { + write: { method: 'vueNextVNode', target: targetKind, error: safeString(err) }, + }; + return Transport.createResponse( + req.requestId, + false, + base, + 'Failed to build Vue props patch', + ); + } + + // Apply via instance.next + update() to trigger Vue's internal updateProps pipeline + if (!VueAdapter.applyNextProps(instance, nextRawProps)) { + base.meta = { + write: { method: 'vueNextVNode', target: targetKind, error: 'No update method' }, + }; + return Transport.createResponse( + req.requestId, + false, + base, + 'Vue update method not available', + ); + } + + // Record original for reset only after successful write (include targetKind for accurate reset) + VueAdapter.recordOriginal(instance, path, read.existed, read.value, targetKind); + + base.meta = { write: { method: 'vueNextVNode', target: targetKind } }; + return Transport.createResponse(req.requestId, true, base); + } + + return Transport.createResponse(req.requestId, false, undefined, 'Not a React/Vue component'); + }, + + /** + * Handle 'reset' operation - Restore original props values + */ + handleReset(req) { + const target = this.resolveTarget(req.locator); + if (!target) { + return Transport.createResponse( + req.requestId, + false, + undefined, + 'Target element not found', + ); + } + + const preStatus = ReactAdapter.detectStatus(); + if (preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING) { + ReactAdapter.installMinimalHook(); + } + + const hookInfo = ReactAdapter.detectStatus(); + const hookStatus = + preStatus.hookStatus === HOOK_STATUS.HOOK_MISSING + ? HOOK_STATUS.HOOK_MISSING + : hookInfo.hookStatus; + + const fw = FrameworkDetector.detect(target); + + if (fw.framework === 'react') { + const fiberInfo = ReactAdapter.resolveFiberWithRenderer(target, hookInfo); + const componentFiber = fiberInfo.fiber + ? ReactAdapter.findNearestComponentFiber(fiberInfo.fiber) + : null; + + const componentName = componentFiber + ? ReactAdapter.getComponentName(componentFiber) + : undefined; + const canRead = Boolean(componentFiber); + const canWrite = hookStatus === HOOK_STATUS.READY && Boolean(componentFiber); + const needsRefresh = canRead && hookStatus !== HOOK_STATUS.READY; + + const base = buildResponseData({ + hookStatus, + framework: 'react', + componentName, + capabilities: makeCapabilities({ canRead, canWrite, canWriteHooks: false }), + needsRefresh, + }); + + if (!componentFiber) { + return Transport.createResponse( + req.requestId, + false, + base, + 'React component fiber not found', + ); + } + + const store = ReactAdapter.getOriginals(componentFiber); + if (!store?.originals?.size) { + base.meta = { reset: { method: 'refresh', reason: 'noOverrides' } }; + base.needsRefresh = true; + return Transport.createResponse(req.requestId, true, base); + } + + if (hookStatus !== HOOK_STATUS.READY) { + base.meta = { reset: { method: 'refresh', reason: 'hookNotReady' } }; + base.needsRefresh = true; + return Transport.createResponse(req.requestId, true, base); + } + + const renderer = store.renderer; + if (!renderer || typeof renderer.overrideProps !== 'function') { + base.meta = { reset: { method: 'refresh', reason: 'missingRenderer' } }; + base.needsRefresh = true; + return Transport.createResponse(req.requestId, true, base); + } + + let reverted = 0; + for (const entry of store.originals.values()) { + try { + renderer.overrideProps(componentFiber, entry.path, entry.value); + reverted++; + } catch { + // Continue reverting others + } + } + + ReactAdapter.clearOriginals(componentFiber); + base.meta = { reset: { method: 'overrideProps', reverted } }; + + return Transport.createResponse(req.requestId, true, base); + } + + if (fw.framework === 'vue') { + const instance = fw.data; + const componentName = VueAdapter.getComponentName(instance); + const canRead = Boolean(instance); + const canWrite = Boolean(instance) && VueAdapter.isDevBuild(instance); + + const base = buildResponseData({ + hookStatus, + framework: 'vue', + componentName, + capabilities: makeCapabilities({ canRead, canWrite, canWriteHooks: false }), + needsRefresh: false, + }); + + if (!instance) { + return Transport.createResponse( + req.requestId, + false, + base, + 'Vue component instance not found', + ); + } + + const store = VueAdapter.getOriginals(instance); + if (!store?.size) { + base.meta = { reset: { method: 'refresh', reason: 'noOverrides' } }; + base.needsRefresh = true; + return Transport.createResponse(req.requestId, true, base); + } + + // Build next vnode props with all originals restored + const currentRawProps = VueAdapter.getVNodeProps(instance) || {}; + const nextRawProps = { ...currentRawProps }; + + let reverted = 0; + for (const entry of store.values()) { + const path = entry.path; + if (!Array.isArray(path) || typeof path[0] !== 'string') continue; + + const propName = path[0]; + const subPath = path.slice(1); + + try { + if (subPath.length === 0) { + if (entry.existed) { + nextRawProps[propName] = entry.value; + } else { + delete nextRawProps[propName]; + } + } else { + const prev = nextRawProps[propName]; + nextRawProps[propName] = VueAdapter.copyWithSet(prev, subPath, entry.value); + } + reverted++; + } catch { + // Continue with other entries + } + } + + // Apply via instance.next + update() to trigger Vue's internal updateProps pipeline + if (!VueAdapter.applyNextProps(instance, nextRawProps)) { + base.meta = { reset: { method: 'refresh', reason: 'noUpdate' } }; + base.needsRefresh = true; + return Transport.createResponse(req.requestId, true, base); + } + + VueAdapter.clearOriginals(instance); + base.meta = { reset: { method: 'vueNextVNode', reverted } }; + + return Transport.createResponse(req.requestId, true, base); + } + + return Transport.createResponse(req.requestId, false, undefined, 'Not a React/Vue component'); + }, + + /** + * Handle 'cleanup' operation - Dispose agent + */ + handleCleanup(req) { + const resp = Transport.createResponse(req.requestId, true, { + meta: { cleanup: { ok: true } }, + }); + Lifecycle.dispose('request'); + return resp; + }, + + /** + * Route request to appropriate handler + */ + handle(req) { + switch (req.op) { + case 'probe': + return this.handleProbe(req); + case 'read': + return this.handleRead(req); + case 'write': + return this.handleWrite(req); + case 'reset': + return this.handleReset(req); + case 'cleanup': + return this.handleCleanup(req); + default: + return Transport.createResponse( + req.requestId, + false, + undefined, + `Unsupported op: ${safeString(req.op)}`, + ); + } + }, + }; + + // ============================================================================= + // Lifecycle Management + // ============================================================================= + + const Lifecycle = { + disposed: false, + + onRequestEvent(event) { + try { + if (Lifecycle.disposed) return; + + const detail = event?.detail; + const req = Transport.normalizeRequest(detail); + if (!req) return; + + const resp = Handlers.handle(req); + Transport.dispatchResponse(resp); + } catch (err) { + try { + const requestId = event?.detail?.requestId; + if (typeof requestId === 'string' && requestId) { + Transport.dispatchResponse( + Transport.createResponse(requestId, false, undefined, safeString(err)), + ); + } + } catch { + // ignore + } + } + }, + + onCleanupEvent() { + Lifecycle.dispose('external-event'); + }, + + dispose(reason) { + if (this.disposed) return; + this.disposed = true; + + try { + window.removeEventListener(EVENT_NAME.REQUEST, this.onRequestEvent, true); + window.removeEventListener(EVENT_NAME.CLEANUP, this.onCleanupEvent, true); + } catch { + // ignore + } + + try { + delete window[GLOBAL_KEY]; + } catch { + // ignore + } + + if (reason) { + logWarn('Disposed:', reason); + } + }, + + init() { + // Use capture phase to avoid page stopPropagation interfering + window.addEventListener(EVENT_NAME.REQUEST, this.onRequestEvent, true); + window.addEventListener(EVENT_NAME.CLEANUP, this.onCleanupEvent, true); + + window[GLOBAL_KEY] = { + version: PROTOCOL_VERSION, + dispose: () => this.dispose('manual'), + }; + + // Early injection: install minimal hook before React loads (document_start) + // This is critical for capturing React renderers that initialize early + if (document.readyState === 'loading') { + try { + const status = ReactAdapter.detectStatus(); + if (status.hookStatus === HOOK_STATUS.HOOK_MISSING) { + ReactAdapter.installMinimalHook(); + logWarn('Installed minimal hook during early injection'); + } + } catch (err) { + // Best-effort: early injection may fail in some environments + logWarn('Early hook injection failed:', err); + } + } + }, + }; + + // Initialize + Lifecycle.init(); +})(); diff --git a/app/chrome-extension/inject-scripts/recorder.js b/app/chrome-extension/inject-scripts/recorder.js new file mode 100644 index 00000000..8c334f7b --- /dev/null +++ b/app/chrome-extension/inject-scripts/recorder.js @@ -0,0 +1,1950 @@ +/* eslint-disable */ +// recorder.js - content script for recording user interactions into steps + +(function () { + if (window.__RR_RECORDER_INSTALLED__) return; + window.__RR_RECORDER_INSTALLED__ = true; + + // ================================================================ + // 1) CONFIG + STATELESS HELPERS (namespaced) + // ================================================================ + const CONFIG = { + // Increase debounce to improve step merging for slow/DOM-replacing inputs + INPUT_DEBOUNCE_MS: 800, + BATCH_SEND_MS: 100, + SCROLL_DEBOUNCE_MS: 350, + SENSITIVE_INPUT_TYPES: new Set(['password']), + UI_MAX_STEPS: 30, + // Maximum time to hold flush while user is typing (prevents unbounded batch accumulation) + MAX_TYPING_HOLD_MS: 1500, + }; + // Cross-frame event channel + const FRAME_EVENT = 'rr_iframe_event'; + + // Memoization caches for selector computations during recording + const __cacheUnique = new WeakMap(); + const __cachePath = new WeakMap(); + + const SelectorEngine = { + buildTarget(el) { + const candidates = []; + const attrNames = ['data-testid', 'data-testId', 'data-test', 'data-qa', 'data-cy']; + for (const an of attrNames) { + const v = el.getAttribute && el.getAttribute(an); + if (v) candidates.push({ type: 'attr', value: `[${an}="${CSS.escape(v)}"]` }); + } + const classSel = this._uniqueClassSelector(el); + if (classSel) candidates.push({ type: 'css', value: classSel }); + const css = this._generateSelector(el); + if (css) candidates.push({ type: 'css', value: css }); + const name = el.getAttribute && el.getAttribute('name'); + if (name) candidates.push({ type: 'attr', value: `[name="${CSS.escape(name)}"]` }); + const title = el.getAttribute && el.getAttribute('title'); + if (title) candidates.push({ type: 'attr', value: `[title="${CSS.escape(title)}"]` }); + const alt = el.getAttribute && el.getAttribute('alt'); + if (alt) candidates.push({ type: 'attr', value: `[alt="${CSS.escape(alt)}"]` }); + const aria = el.getAttribute && el.getAttribute('aria-label'); + const role = el.getAttribute && el.getAttribute('role'); + if (aria) { + if (role) candidates.push({ type: 'aria', value: `${role}[name=${aria}]` }); + else candidates.push({ type: 'aria', value: `textbox[name=${aria}]` }); + } + const tag = el.tagName?.toLowerCase?.() || ''; + if (['button', 'a', 'summary'].includes(tag)) { + const text = (el.textContent || '').trim(); + if (text) candidates.push({ type: 'text', value: text.substring(0, 64) }); + } + const selector = SelectorEngine._choosePrimary(el, candidates); + return { selector, candidates, tag }; + }, + + _choosePrimary(el, candidates) { + if (el.id && document.querySelectorAll(`#${CSS.escape(el.id)}`).length === 1) { + return `#${CSS.escape(el.id)}`; + } + const priority = ['attr', 'css']; + for (const p of priority) { + const c = candidates.find((c) => c.type === p); + if (c) { + try { + const tag = el.tagName ? el.tagName.toLowerCase() : ''; + if (p === 'attr' && (tag === 'input' || tag === 'textarea' || tag === 'select')) { + const val = String(c.value || '').trim(); + if (val.startsWith('[')) return `${tag}${val}`; + } + } catch {} + return c.value; + } + } + if (candidates.length) return candidates[0].value; + return SelectorEngine._generateSelector(el) || ''; + }, + + _uniqueClassSelector(el) { + if (__cacheUnique.has(el)) return __cacheUnique.get(el); + let result = ''; + try { + const classes = Array.from(el.classList || []).filter( + (c) => c && /^[a-zA-Z0-9_-]+$/.test(c), + ); + for (const cls of classes) { + const sel = `.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) { + result = sel; + break; + } + } + if (!result) { + const tag = el.tagName ? el.tagName.toLowerCase() : ''; + for (const cls of classes) { + const sel = `${tag}.${CSS.escape(cls)}`; + if (document.querySelectorAll(sel).length === 1) { + result = sel; + break; + } + } + } + if (!result) { + for (let i = 0; i < Math.min(classes.length, 3) && !result; i++) { + for (let j = i + 1; j < Math.min(classes.length, 3); j++) { + const sel = `.${CSS.escape(classes[i])}.${CSS.escape(classes[j])}`; + if (document.querySelectorAll(sel).length === 1) { + result = sel; + break; + } + } + } + } + } catch {} + __cacheUnique.set(el, result); + return result; + }, + + _generateSelector(el) { + if (!(el instanceof Element)) return ''; + if (__cachePath.has(el)) return __cachePath.get(el); + if (el.id) { + const idSel = `#${CSS.escape(el.id)}`; + if (document.querySelectorAll(idSel).length === 1) return idSel; + } + for (const attr of ['data-testid', 'data-cy', 'name']) { + const attrValue = el.getAttribute(attr); + if (attrValue) { + const s = `[${attr}="${CSS.escape(attrValue)}"]`; + if (document.querySelectorAll(s).length === 1) return s; + } + } + let path = ''; + let current = el; + while (current && current.nodeType === Node.ELEMENT_NODE && current.tagName !== 'BODY') { + let selector = current.tagName.toLowerCase(); + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter( + (child) => child.tagName === current.tagName, + ); + if (siblings.length > 1) { + const index = siblings.indexOf(current) + 1; + selector += `:nth-of-type(${index})`; + } + } + path = path ? `${selector} > ${path}` : selector; + current = parent; + } + const res = path ? `body > ${path}` : 'body'; + __cachePath.set(el, res); + return res; + }, + }; + // Extend SelectorEngine with a shared ref helper (attached after declaration) + SelectorEngine._ensureGlobalRef = function (el) { + try { + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + for (const k in window.__claudeElementMap) { + const w = window.__claudeElementMap[k]; + if (w && typeof w.deref === 'function' && w.deref() === el) return k; + } + const id = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[id] = new WeakRef(el); + return id; + } catch { + return null; + } + }; + + // ================================================================ + // 2) UI CLASS (injected via constructor) + // ================================================================ + class UI { + constructor(recorder) { + this.recorder = recorder; + this._box = null; + // Timeline elements state + this._timeline = null; + this._count = 0; + this._timelineBox = null; + this._collapsed = false; + } + ensure() { + const rec = this.recorder; + if (window !== window.top) return; + let root = document.getElementById('__rr_rec_overlay'); + if (root) return; + root = document.createElement('div'); + root.id = '__rr_rec_overlay'; + Object.assign(root.style, { + position: 'fixed', + top: '10px', + right: '10px', + zIndex: 2147483646, + fontFamily: 'system-ui,-apple-system,Segoe UI,Roboto,Arial', + }); + root.innerHTML = ` +
+ 录制中 + + + + + +
`; + document.documentElement.appendChild(root); + // Build timeline container just below the panel + const timeline = document.createElement('div'); + timeline.id = '__rr_rec_timeline'; + Object.assign(timeline.style, { + marginTop: '8px', + width: '360px', + maxHeight: '220px', + overflow: 'auto', + background: 'rgba(17,24,39,0.85)', + color: '#F9FAFB', + border: '1px solid rgba(255,255,255,0.2)', + borderRadius: '8px', + boxShadow: '0 4px 16px rgba(0,0,0,0.18)', + padding: '8px 10px', + fontSize: '12px', + lineHeight: '1.4', + }); + const header = document.createElement('div'); + header.textContent = '已录制步骤'; + header.style.opacity = '0.8'; + header.style.marginBottom = '4px'; + const list = document.createElement('ol'); + list.id = '__rr_rec_timeline_list'; + list.style.listStyle = 'none'; + list.style.margin = '0'; + list.style.padding = '0'; + list.style.display = 'flex'; + list.style.flexDirection = 'column'; + list.style.gap = '4px'; + timeline.appendChild(header); + timeline.appendChild(list); + root.appendChild(timeline); + this._timeline = list; + this._timelineBox = timeline; + const btnPause = root.querySelector('#__rr_pause'); + const btnStop = root.querySelector('#__rr_stop'); + const hideChk = root.querySelector('#__rr_hide_values'); + const highlightChk = root.querySelector('#__rr_enable_highlight'); + const btnToggle = root.querySelector('#__rr_toggle_timeline'); + hideChk.checked = !!rec.hideInputValues; + hideChk.addEventListener('change', () => (rec.hideInputValues = hideChk.checked)); + highlightChk.checked = !!rec.highlightEnabled; + highlightChk.addEventListener('change', () => { + rec.highlightEnabled = !!highlightChk.checked; + rec._updateHoverListener(); + }); + if (btnToggle) { + btnToggle.addEventListener('click', () => { + this._collapsed = !this._collapsed; + if (this._timelineBox) + this._timelineBox.style.display = this._collapsed ? 'none' : 'block'; + btnToggle.textContent = this._collapsed ? '展开' : '折叠'; + }); + } + btnPause.addEventListener('click', () => { + if (!rec.isPaused) rec.pause(); + else rec.resume(); + }); + btnStop.addEventListener('click', () => { + chrome.runtime.sendMessage({ type: 'rr_stop_recording' }); + }); + this._box = document.createElement('div'); + Object.assign(this._box.style, { + position: 'fixed', + border: '2px solid rgba(59,130,246,0.9)', + borderRadius: '4px', + background: 'rgba(59,130,246,0.15)', + pointerEvents: 'none', + zIndex: 2147483645, + }); + document.documentElement.appendChild(this._box); + if (rec.highlightEnabled) + document.addEventListener('mousemove', rec._onMouseMove, { capture: true, passive: true }); + this.updateStatus(); + } + remove() { + if (window === window.top) { + const root = document.getElementById('__rr_rec_overlay'); + if (root) root.remove(); + if (this._box) this._box.remove(); + this._timeline = null; + this._timelineBox = null; + } + } + updateStatus() { + const badge = document.getElementById('__rr_badge'); + const pauseBtn = document.getElementById('__rr_pause'); + if (badge) badge.textContent = this.recorder.isPaused ? '已暂停' : '录制中'; + if (pauseBtn) pauseBtn.textContent = this.recorder.isPaused ? '继续' : '暂停'; + } + + // Reset the timeline list content + resetTimeline() { + this._count = 0; + const list = this._timeline || document.getElementById('__rr_rec_timeline_list') || null; + if (list) list.innerHTML = ''; + } + + // Append a new recorded step into the timeline UI + appendStep(step) { + const list = this._timeline || document.getElementById('__rr_rec_timeline_list') || null; + if (!list) return; + this._count += 1; + const item = document.createElement('li'); + const text = this._formatStepText(step, this._count); + item.setAttribute('data-step-id', step.id || ''); + item.style.display = 'flex'; + item.style.alignItems = 'flex-start'; + item.style.gap = '6px'; + item.innerHTML = ` + ${this._count}. + ${text} + `; + list.appendChild(item); + while (list.children.length > CONFIG.UI_MAX_STEPS) { + list.removeChild(list.firstChild); + } + const container = list.parentElement; + if (container) container.scrollTop = container.scrollHeight; + } + + /** + * Apply a full timeline update from background. + * Steps can be upserted in place (same id, updated fields) during fill debouncing. + * Uses smart diffing to minimize DOM operations while ensuring fill values are accurate. + */ + applyTimelineUpdate(steps) { + try { + if (window !== window.top) return; + const list = Array.isArray(steps) ? steps : []; + const total = list.length; + // Ensure UI exists + if (!this._timeline) this.ensure(); + if (!this._timeline) return; + if (total === 0) { + this.resetTimeline(); + return; + } + + // Calculate the window of steps to display (last N steps) + const windowStart = Math.max(0, total - CONFIG.UI_MAX_STEPS); + const windowSteps = list.slice(windowStart); + + // Get current displayed step IDs + const currentItems = this._timeline.children; + const currentIds = []; + for (let i = 0; i < currentItems.length; i++) { + currentIds.push(currentItems[i].getAttribute('data-step-id') || ''); + } + + // Check if we need a full rebuild or can do incremental update + const newIds = windowSteps.map((s) => s.id || ''); + const needsRebuild = + currentIds.length !== newIds.length || currentIds.some((id, i) => id !== newIds[i]); + + if (needsRebuild) { + // Full rebuild: either structure changed or it's simpler to rebuild + this.resetTimeline(); + for (let i = 0; i < windowSteps.length; i++) { + this._appendStepWithIndex(windowSteps[i], windowStart + i + 1); + } + } else { + // Incremental update: same steps, just update values + for (let i = 0; i < windowSteps.length; i++) { + const step = windowSteps[i]; + const item = currentItems[i]; + if (item) { + // Update the text content for this step + const textSpan = item.querySelector('span:last-child'); + if (textSpan) { + const newText = this._formatStepText(step, windowStart + i + 1); + if (textSpan.textContent !== newText) { + textSpan.textContent = newText; + } + } + } + } + } + this._count = total; + } catch {} + } + + /** + * Internal method to append a step with a specific display index. + * Used by applyTimelineUpdate for proper numbering. + */ + _appendStepWithIndex(step, displayIndex) { + const list = this._timeline || document.getElementById('__rr_rec_timeline_list') || null; + if (!list) return; + const item = document.createElement('li'); + const text = this._formatStepText(step, displayIndex); + item.setAttribute('data-step-id', step.id || ''); + item.style.display = 'flex'; + item.style.alignItems = 'flex-start'; + item.style.gap = '6px'; + item.innerHTML = ` + ${displayIndex}. + ${text} + `; + list.appendChild(item); + const container = list.parentElement; + if (container) container.scrollTop = container.scrollHeight; + } + + // Create a short, human-readable text for a recorded step + _formatStepText(step, _idx) { + try { + if (!step || typeof step !== 'object') return '未知步骤'; + const t = step.type; + const sel = step.target && step.target.selector ? step.target.selector : ''; + if (t === 'click' || t === 'dblclick') { + return `${t === 'dblclick' ? '双击' : '点击'}: ${sel || '(document)'}`; + } + if (t === 'fill') { + const val = step.value; + const shown = typeof val === 'string' && val.length > 0 ? val : String(val); + return `输入: ${sel} = ${shown}`; + } + if (t === 'scroll') { + const mode = step.mode === 'container' ? '容器' : '页面'; + const off = step.offset || {}; + return `滚动(${mode}): y=${off.y ?? 0}, x=${off.x ?? 0}`; + } + if (t === 'openTab') return `打开标签页: ${step.url || ''}`; + if (t === 'switchTab') return `切换标签页: 包含 ${step.urlContains || ''}`; + if (t === 'switchFrame') + return `切换Frame: 包含 ${step.frame && step.frame.urlContains ? step.frame.urlContains : ''}`; + if (t === 'waitFor') return `等待: ${sel || step.until || ''}`; + return `${t}`; + } catch (_) { + return '步骤'; + } + } + } + + // ================================================================ + // 3) MAIN CLASS: ContentRecorder (stateful) + // ================================================================ + class ContentRecorder { + constructor() { + // State + this.isRecording = false; + this.isPaused = false; + this.hideInputValues = false; + this.highlightEnabled = true; + this.hoverRAF = 0; + this.frameSwitchPushed = false; + this.batch = []; + this.batchTimer = null; + this.scrollTimer = null; + + // Local, content-side buffer for batching/merging steps during recording. + // Not the authoritative Flow (background holds the real one). + this.sessionBuffer = this._createSessionBuffer(); + // lastFill tracks the most recent fill step for debounce/merge + // el: DOM element reference for reading final value on finalize + this.lastFill = { step: null, ts: 0, el: null }; + // Input activity tracking for flush gate (separate from merge state) + // Updated by both local input and iframe upsert messages + this._lastInputActivityTs = 0; + // Flush gate: tracks when a typing burst started to enforce MAX_TYPING_HOLD_MS + this._typingBurstStartTs = 0; + // Force flush timer: ensures MAX_TYPING_HOLD_MS is a hard upper bound + // This timer is NOT reset on each input, only cleared on actual flush + this._forceFlushTimer = null; + // Recording-time element identity map (not persisted) + this.el2ref = new WeakMap(); + this.refCounter = 0; + + // Bind handlers + this._onClick = this._onClick.bind(this); + this._onInput = this._onInput.bind(this); + this._onDocInput = this._onDocInput.bind(this); + this._onChange = this._onChange.bind(this); + this._onMouseMove = this._onMouseMove.bind(this); + this._onScroll = this._onScroll.bind(this); + this._onFocusIn = this._onFocusIn.bind(this); + this._onFocusOut = this._onFocusOut.bind(this); + this._onKeyDown = this._onKeyDown.bind(this); + this._onKeyUp = this._onKeyUp.bind(this); + this._onWindowMessage = this._onWindowMessage.bind(this); + // Page lifecycle handlers for best-effort flush on navigation/close + this._onPageHide = this._onPageHide.bind(this); + this._onVisibilityChange = this._onVisibilityChange.bind(this); + this.ui = new UI(this); + this._scrollPending = null; + + // Focus tracking for per-element input listening + this._focusedEl = null; + // Keyboard state for combo recording + this._pressed = new Set(); + this._lastKeyTs = 0; + // Map to avoid duplicate switchFrame per iframe source (keyed by frame selector) + this._frameSwitchMap = new Set(); + } + + // Lifecycle + start(flowMeta) { + // Idempotent start: if already recording (and not paused), just ensure UI and listeners + if (this.isRecording && !this.isPaused) { + this.ui.ensure(); + this._updateHoverListener(); + return; + } + // If paused, treat start as resume to avoid resetting local buffer/UI timeline + if (this.isPaused) { + this.resume(); + return; + } + this._reset(flowMeta || {}); + this.isRecording = true; + this.isPaused = false; + this._attach(); + this.ui.ensure(); + this.ui.resetTimeline(); + } + + /** + * Stop recording and flush all pending data. + * This is the reliable stop that ensures no data is lost. + * Waits for background to acknowledge receipt of all data before returning. + * @returns {Promise<{ack: boolean, steps: number, variables: number}>} + */ + async stop() { + if (!this.isRecording) { + return { ack: true, steps: 0, variables: 0 }; + } + + this.isRecording = false; + // Stop should clear paused state so detach fully cleans up (and barrier works consistently) + this.isPaused = false; + + // Step 1: Finalize pending click (dblclick detector) + this._finalizePendingClick(); + + // Step 2: Finalize any pending input (draft mode) + this._finalizePendingInput(); + + // Step 3: Finalize any pending scroll + this._finalizePendingScroll(); + + // Step 4: In iframes, ensure the top-frame aggregator has processed our final postMessages + // before we ACK the background stop (prevents missing iframe steps) + let topSyncOk = true; + if (window !== window.top) { + topSyncOk = await this._syncStopBarrierToTop(); + } + + // Step 5: Clear timers BEFORE flush (prevent race conditions) + if (this.batchTimer) clearTimeout(this.batchTimer); + this.batchTimer = null; + if (this.scrollTimer) clearTimeout(this.scrollTimer); + this.scrollTimer = null; + if (this.hoverRAF) cancelAnimationFrame(this.hoverRAF); + this.hoverRAF = 0; + + // Step 6: Flush any remaining batched steps and WAIT for ack + const stepsCount = this.batch.length; + let stepsAck = true; + if (stepsCount > 0) { + stepsAck = await this._flush(); + } + + // Step 7: Send all collected variables and WAIT for ack + const variablesCount = this.sessionBuffer.variables?.length || 0; + let variablesAck = true; + if (variablesCount > 0) { + variablesAck = await this._sendVariables(); + } + + // Step 8: Detach listeners and clean up UI + this._detach(); + this.ui.remove(); + + // Step 9: Reset state + this.lastFill = { step: null, ts: 0, el: null }; + this._lastInputActivityTs = 0; + this._typingBurstStartTs = 0; + if (this._forceFlushTimer) { + clearTimeout(this._forceFlushTimer); + this._forceFlushTimer = null; + } + this.sessionBuffer.steps = []; + + // Return acknowledgment with stats + // ack is true only if all sends were acknowledged + return { + ack: stepsAck && variablesAck && topSyncOk, + steps: stepsCount, + variables: variablesCount, + }; + } + + /** + * Finalize a pending click that hasn't been emitted yet. + * The dblclick detector holds single clicks temporarily to detect double-clicks. + * This ensures stop/pause flush includes the last single click. + */ + _finalizePendingClick() { + try { + if (this._pendingClickTimer) clearTimeout(this._pendingClickTimer); + } catch {} + this._pendingClickTimer = null; + + try { + if (this._pendingClick) this._pushStep(this._pendingClick); + } catch {} + this._pendingClick = null; + } + + /** + * Finalize any pending input that hasn't been flushed yet. + * This ensures the last input value is captured before stop/pause/navigation. + * Uses lastFill.el (DOM reference) to read the current value. + */ + _finalizePendingInput() { + const last = this.lastFill; + if (!last || !last.step) return; + + // Commit the latest value from the DOM element + try { + const el = last.el; + if (el) { + const freshValue = this._getElementValue(el, last.step.value); + if (freshValue !== last.step.value) { + last.step.value = freshValue; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + } + } + } catch { + // Element may no longer exist, that's OK - we keep the last known value + } + + // Enqueue for upsert to ensure background gets the final value + try { + this._enqueueForUpsert(last.step); + } catch {} + + // Reset state + this.lastFill = { step: null, ts: 0, el: null }; + this._typingBurstStartTs = 0; + } + + /** + * Get the current value from an element, handling sensitive fields and contenteditable. + * @param {Element} el - The element to read from + * @param {string} existingValue - The existing recorded value (may be a variable placeholder) + * @returns {string} The value to record + */ + _getElementValue(el, existingValue) { + if (!el) return existingValue || ''; + + const isContentEditable = + el.nodeType === 1 && /** @type {HTMLElement} */ (el).isContentEditable === true; + + // If existing value is already a variable placeholder, preserve it + // Use strict pattern to avoid false positives for user input like "{abc}" + const existing = typeof existingValue === 'string' ? existingValue : ''; + const varPlaceholderPattern = + /^\{(?:var_[a-z0-9]{4}|file_[a-z0-9]{4}|[a-zA-Z_][a-zA-Z0-9_]*)\}$/; + if (varPlaceholderPattern.test(existing)) { + return existing; + } + + // Check if this is a sensitive field + const isSensitive = + this.hideInputValues || + (!isContentEditable && + CONFIG.SENSITIVE_INPUT_TYPES.has( + ((el.getAttribute && el.getAttribute('type')) || '').toLowerCase(), + )); + + if (isSensitive) { + // Return existing variable or create new one (should already exist from initial capture) + return existing; + } + + // Read fresh value from DOM + try { + if (isContentEditable) { + return /** @type {HTMLElement} */ (el).innerText || ''; + } + if ( + el instanceof HTMLInputElement || + el instanceof HTMLTextAreaElement || + el instanceof HTMLSelectElement + ) { + return el.value || ''; + } + } catch {} + + return existing || ''; + } + + /** + * Finalize any pending scroll that hasn't been committed yet. + * Converts the pending scroll data into a proper scroll step. + */ + _finalizePendingScroll() { + if (!this._scrollPending) return; + + const pending = this._scrollPending; + this._scrollPending = null; + + const { isDoc, target, top, left } = pending; + + // Try merge with last step (same logic as _onScroll timer callback) + const steps = this.sessionBuffer.steps; + const last = steps.length ? steps[steps.length - 1] : null; + if (last && last.type === 'scroll') { + const sameDoc = isDoc && !last.target && last.mode === 'offset'; + const sameEl = + !isDoc && + last.target && + last.target.selector && + target && + last.target.selector === target.selector && + last.mode === 'container'; + if (sameDoc || sameEl) { + last.offset = { y: top, x: left }; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + return; + } + } + + // Create new scroll step + if (isDoc) { + this._pushStep({ + type: 'scroll', + mode: 'offset', + offset: { y: top, x: left }, + screenshotOnFail: false, + }); + } else { + this._pushStep({ + type: 'scroll', + mode: 'container', + target: target, + offset: { y: top, x: left }, + screenshotOnFail: false, + }); + } + } + + /** + * Send all collected variables to background. + * @returns {Promise} - Resolves when background acknowledges receipt + */ + async _sendVariables() { + if (!this.sessionBuffer.variables || this.sessionBuffer.variables.length === 0) { + return true; + } + return this._send({ kind: 'variables', variables: this.sessionBuffer.variables }); + } + + /** + * Pause recording. Flushes pending data before pausing. + */ + pause() { + if (!this.isRecording || this.isPaused) return; + + // Finalize pending data before pausing + this._finalizePendingClick(); + this._finalizePendingInput(); + this._finalizePendingScroll(); + + // Flush batched steps + if (this.batch.length > 0) { + this._flush(); + } + + // Clear timers + if (this.batchTimer) clearTimeout(this.batchTimer); + this.batchTimer = null; + if (this.scrollTimer) clearTimeout(this.scrollTimer); + this.scrollTimer = null; + + this.isPaused = true; + this._detach(); + this.ui.updateStatus(); + } + + /** + * Resume recording after pause. + */ + resume() { + if (!this.isPaused) return; + + this.isRecording = true; + this.isPaused = false; + this._attach(); + this.ui.ensure(); + this.ui.updateStatus(); + } + + // DOM listeners + _attach() { + document.addEventListener('click', this._onClick, true); + // Use focusin/out to attach input listener only to focused element + document.addEventListener('focusin', this._onFocusIn, true); + document.addEventListener('focusout', this._onFocusOut, true); + // Document-level input capture to support Shadow DOM (custom elements) + // Use capture phase + composedPath to find inner editable control + document.addEventListener('input', this._onDocInput, true); + document.addEventListener('change', this._onChange, true); + // capture-phase scroll to catch non-bubbling events on any container (passive to avoid jank) + document.addEventListener('scroll', this._onScroll, { capture: true, passive: true }); + // Keyboard: record Enter and modifier combos + document.addEventListener('keydown', this._onKeyDown, true); + document.addEventListener('keyup', this._onKeyUp, true); + // Page lifecycle: best-effort flush on navigation/close + window.addEventListener('pagehide', this._onPageHide, true); + document.addEventListener('visibilitychange', this._onVisibilityChange, true); + // Cross-frame: top window aggregates iframe-recorded steps + if (window === window.top) window.addEventListener('message', this._onWindowMessage, true); + this._updateHoverListener(); + } + + _detach() { + document.removeEventListener('click', this._onClick, true); + document.removeEventListener('focusin', this._onFocusIn, true); + document.removeEventListener('focusout', this._onFocusOut, true); + document.removeEventListener('input', this._onDocInput, true); + document.removeEventListener('change', this._onChange, true); + document.removeEventListener('scroll', this._onScroll, { capture: true }); + document.removeEventListener('keydown', this._onKeyDown, true); + document.removeEventListener('keyup', this._onKeyUp, true); + window.removeEventListener('pagehide', this._onPageHide, true); + document.removeEventListener('visibilitychange', this._onVisibilityChange, true); + document.removeEventListener('mousemove', this._onMouseMove, { capture: true }); + // Keep top-frame aggregator alive during pause; stop() clears isPaused and will remove it + if (window === window.top && !this.isPaused) + window.removeEventListener('message', this._onWindowMessage, true); + // Detach per-element input listener if any + if (this._focusedEl) this._focusedEl.removeEventListener('input', this._onInput, true); + this._focusedEl = null; + // Best-effort cleanup for timers/raf when detaching + if (this.batchTimer) clearTimeout(this.batchTimer); + this.batchTimer = null; + if (this.scrollTimer) clearTimeout(this.scrollTimer); + this.scrollTimer = null; + if (this.hoverRAF) cancelAnimationFrame(this.hoverRAF); + this.hoverRAF = 0; + // Clear pending click state (stop/pause flush it before detach) + if (this._pendingClickTimer) { + clearTimeout(this._pendingClickTimer); + } + this._pendingClickTimer = null; + this._pendingClick = null; + } + + _updateHoverListener() { + if (window !== window.top) return; + document.removeEventListener('mousemove', this._onMouseMove, { capture: true }); + if (this.isRecording && !this.isPaused && this.highlightEnabled) { + document.addEventListener('mousemove', this._onMouseMove, { capture: true, passive: true }); + } + } + + // Flow helpers (content-side buffer only) + _createSessionBuffer() { + const nowIso = new Date().toISOString(); + return { + id: `flow_${Date.now()}`, + name: '未命名录制', + version: 1, + steps: [], + variables: [], + meta: { createdAt: nowIso, updatedAt: nowIso }, + }; + } + + _reset(meta) { + this.sessionBuffer = this._createSessionBuffer(); + try { + if (meta && typeof meta === 'object') { + if (meta.id) this.sessionBuffer.id = String(meta.id); + if (meta.name) this.sessionBuffer.name = String(meta.name); + if (meta.description) this.sessionBuffer.description = String(meta.description); + } + } catch {} + this.lastFill = { step: null, ts: 0, el: null }; + this._lastInputActivityTs = 0; + this._typingBurstStartTs = 0; + if (this._forceFlushTimer) { + clearTimeout(this._forceFlushTimer); + this._forceFlushTimer = null; + } + this.frameSwitchPushed = false; + } + + /** + * Update input activity timestamp (used for flush gate). + * Called on local input and iframe upsert messages. + */ + _updateInputActivity() { + const now = Date.now(); + const prevActivityTs = this._lastInputActivityTs || 0; + this._lastInputActivityTs = now; + // Start a new burst if previous one expired (or this is first input) + if (!this._typingBurstStartTs || now - prevActivityTs > CONFIG.INPUT_DEBOUNCE_MS) { + this._typingBurstStartTs = now; + // Start force flush timer (hard upper bound for MAX_TYPING_HOLD_MS) + this._startForceFlushTimer(); + } + } + + /** + * Start the force flush timer. + * This timer ensures MAX_TYPING_HOLD_MS is a hard upper bound. + * Unlike batchTimer, this timer is NOT reset on each input. + */ + _startForceFlushTimer() { + // Don't restart if already running + if (this._forceFlushTimer) return; + this._forceFlushTimer = setTimeout(() => { + this._forceFlushTimer = null; + // Force flush regardless of current input state + if (this.batch.length > 0) { + this._flush(); + } + }, CONFIG.MAX_TYPING_HOLD_MS); + } + + /** + * Clear the force flush timer (called on actual flush). + */ + _clearForceFlushTimer() { + if (this._forceFlushTimer) { + clearTimeout(this._forceFlushTimer); + this._forceFlushTimer = null; + } + this._typingBurstStartTs = 0; + } + + /** + * Unified commit and flush logic. + * Called at commit points: focusout, Enter key, pagehide, visibilitychange. + * @param {Object} options + * @param {boolean} [options.bestEffort=false] - If true, don't await (for unload events) + */ + _commitAndFlush(options = {}) { + if (!this.isRecording || this.isPaused) return; + + try { + this._finalizePendingInput(); + this._finalizePendingScroll(); + } catch {} + + // Reset flush gate to allow immediate flush + this._lastInputActivityTs = 0; + this._typingBurstStartTs = 0; + this._clearForceFlushTimer(); + + // Flush (best-effort for unload events) + try { + if (this.batch.length > 0) this._flush(); + } catch {} + try { + const variablesCount = this.sessionBuffer.variables?.length || 0; + if (variablesCount > 0) this._sendVariables(); + } catch {} + + // If in iframe, ask top to flush too + this._requestTopFlush(); + } + + _pushStep(step) { + step.id = step.id || `step_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`; + // In iframes, forward to top for aggregation (compute frame selector there) + if (window !== window.top) { + try { + const payload = { + kind: 'iframeStep', + href: String(location && location.href ? location.href : ''), + step, + }; + window.top.postMessage({ type: FRAME_EVENT, payload }, '*'); + return; // Do not push locally in subframe + } catch {} + } + // Top window: optionally insert a switchFrame if this step originated from an iframe message + this.sessionBuffer.steps.push(step); + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + this.batch.push(step); + + // Track input activity for fill steps (to enforce flush gate) + if (step && step.type === 'fill') { + this._updateInputActivity(); + } + + this._scheduleFlush(); + } + + /** + * Calculate the appropriate flush delay based on typing activity. + * During active typing, delay flush to avoid sending incomplete values. + * Note: MAX_TYPING_HOLD_MS is enforced by _forceFlushTimer, not here. + * @returns {number} Delay in milliseconds before next flush + */ + _getFlushDelayMs() { + const now = Date.now(); + const lastInputTs = this._lastInputActivityTs || 0; + + // If no recent input activity, use default batch delay + if (!lastInputTs || now - lastInputTs >= CONFIG.INPUT_DEBOUNCE_MS) { + return CONFIG.BATCH_SEND_MS; + } + + // Wait for input debounce to complete + const notBefore = lastInputTs + CONFIG.INPUT_DEBOUNCE_MS; + const delay = Math.max(CONFIG.BATCH_SEND_MS, notBefore - now); + + return delay; + } + + /** + * Schedule a batch flush with appropriate delay. + * Respects typing gate to avoid flushing incomplete fill values. + */ + _scheduleFlush() { + if (this.batchTimer) { + clearTimeout(this.batchTimer); + } + const delay = this._getFlushDelayMs(); + this.batchTimer = setTimeout(() => { + this.batchTimer = null; + this._flush(); + }, delay); + } + + /** + * Request top frame to immediately flush its aggregated buffer. + * Used by iframes on commit points (focusout, navigation) to ensure + * their updates are sent to background promptly. + */ + _requestTopFlush() { + if (window === window.top) return; + try { + const payload = { + kind: 'iframeFlush', + href: String(location && location.href ? location.href : ''), + }; + window.top.postMessage({ type: FRAME_EVENT, payload }, '*'); + } catch {} + } + + /** + * Iframe -> top stop barrier sync. + * Ensures the top frame has processed all prior iframe postMessages (steps/upserts) + * before this iframe responds to background STOP. + * @returns {Promise} + */ + _syncStopBarrierToTop() { + if (window === window.top) return Promise.resolve(true); + const id = `sb_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`; + const href = String(location && location.href ? location.href : ''); + const timeoutMs = 400; + + return new Promise((resolve) => { + let done = false; + const cleanup = (ok) => { + if (done) return; + done = true; + try { + window.removeEventListener('message', onMessage, true); + } catch {} + try { + clearTimeout(t); + } catch {} + resolve(!!ok); + }; + + const onMessage = (ev) => { + try { + if (ev.source !== window.top) return; + const d = ev && ev.data; + if (!d || d.type !== FRAME_EVENT || !d.payload) return; + const p = d.payload || {}; + if (p.kind !== 'iframeStopBarrierAck' || p.id !== id) return; + cleanup(true); + } catch {} + }; + + const t = setTimeout(() => cleanup(false), timeoutMs); + try { + window.addEventListener('message', onMessage, true); + window.top.postMessage( + { type: FRAME_EVENT, payload: { kind: 'iframeStopBarrier', id, href } }, + '*', + ); + } catch { + cleanup(false); + } + }); + } + + /** + * Best-effort drain and flush on page navigation/close. + * Called by pagehide/visibilitychange handlers. + * Does not await - unload events are time-constrained. + */ + _bestEffortDrainAndFlush() { + if (!this.isRecording || this.isPaused) return; + + // Flush pending single click (dblclick detector) before we may be unloaded + this._finalizePendingClick(); + + // Cancel timers (unload may not wait for them) + try { + if (this.batchTimer) clearTimeout(this.batchTimer); + this.batchTimer = null; + if (this.scrollTimer) clearTimeout(this.scrollTimer); + this.scrollTimer = null; + } catch {} + + // Use unified commit and flush + this._commitAndFlush({ bestEffort: true }); + } + + /** + * Handle pagehide event - best-effort flush before navigation/close. + */ + _onPageHide() { + this._bestEffortDrainAndFlush(); + } + + /** + * Handle visibilitychange event - flush when page becomes hidden. + * This catches some cases that pagehide misses (e.g., tab switch before navigation). + */ + _onVisibilityChange() { + try { + if (document.visibilityState === 'hidden') { + this._bestEffortDrainAndFlush(); + } + } catch {} + } + + /** + * Flush batched steps to background. + * @returns {Promise} - Resolves when background acknowledges receipt + */ + async _flush() { + if (!this.batch.length) return true; + + // Clear force flush timer since we're flushing now + this._clearForceFlushTimer(); + + const steps = this.batch.map((s) => { + // sanitize internal fields before sending to background + const { _recordingRef, ...rest } = s || {}; + return rest; + }); + this.batch.length = 0; + return this._send({ kind: 'steps', steps }); + } + + /** + * Send payload to background and wait for acknowledgment. + * @param {Object} payload - The payload to send + * @returns {Promise} - Resolves true if background acknowledged, false otherwise + */ + _send(payload) { + return new Promise((resolve) => { + try { + chrome.runtime.sendMessage({ type: 'rr_recorder_event', payload }, (response) => { + // Check for runtime error (e.g., no receiver) + if (chrome.runtime.lastError) { + console.warn('Recorder: send failed', chrome.runtime.lastError.message); + resolve(false); + return; + } + resolve(response && response.ok); + }); + } catch (e) { + console.warn('Recorder: send exception', e); + resolve(false); + } + }); + } + + _addVariable(key, sensitive, defVal) { + if (!this.sessionBuffer.variables) this.sessionBuffer.variables = []; + if (this.sessionBuffer.variables.find((v) => v.key === key)) return; + this.sessionBuffer.variables.push({ key, sensitive: !!sensitive, default: defVal || '' }); + } + + // Handlers + // Pending click state for dblclick detection + _pendingClick = null; + _pendingClickTimer = null; + _DBLCLICK_THRESHOLD_MS = 300; + + _onClick(e) { + if (!this.isRecording || this.isPaused) return; + const el = e.target instanceof Element ? e.target : null; + if (!el) return; + try { + if (el instanceof HTMLInputElement) { + const t = (el.getAttribute && el.getAttribute('type')) || ''; + const tt = String(t).toLowerCase(); + if (tt === 'checkbox' || tt === 'radio') return; // avoid duplicate with change + } + const overlay = document.getElementById('__rr_rec_overlay'); + if (overlay && (el === overlay || (el.closest && el.closest('#__rr_rec_overlay')))) return; + const a = el.closest && el.closest('a[href]'); + const href = a && a.getAttribute && a.getAttribute('href'); + const tgt = a && a.getAttribute && a.getAttribute('target'); + if (a && href && tgt && tgt.toLowerCase() === '_blank') { + try { + const abs = new URL(href, location.href).href; + this._pushStep({ type: 'openTab', url: abs }); + this._pushStep({ type: 'switchTab', urlContains: abs }); + return; + } catch (_) { + this._pushStep({ type: 'openTab', url: href }); + this._pushStep({ type: 'switchTab', urlContains: href }); + return; + } + } + } catch {} + + const target = SelectorEngine.buildTarget(el); + try { + const gref = SelectorEngine._ensureGlobalRef && SelectorEngine._ensureGlobalRef(el); + if (gref) target.ref = gref; + } catch {} + + // Double-click detection: if e.detail >= 2 means this is the second click of a dblclick + if (e.detail >= 2) { + // Cancel pending single click and record dblclick instead + if (this._pendingClickTimer) { + clearTimeout(this._pendingClickTimer); + this._pendingClickTimer = null; + } + this._pendingClick = null; + this._pushStep({ + type: 'dblclick', + target, + screenshotOnFail: true, + }); + return; + } + + // Single click: wait briefly to see if it becomes a dblclick + // Cancel any previous pending click first + if (this._pendingClickTimer) { + clearTimeout(this._pendingClickTimer); + // Flush previous pending click before starting new one + if (this._pendingClick) { + this._pushStep(this._pendingClick); + } + } + + this._pendingClick = { + type: 'click', + target, + screenshotOnFail: true, + }; + + this._pendingClickTimer = setTimeout(() => { + if (this._pendingClick) { + this._pushStep(this._pendingClick); + this._pendingClick = null; + } + this._pendingClickTimer = null; + }, this._DBLCLICK_THRESHOLD_MS); + } + + // Per-element input handler (attached on focusin for native inputs/textarea/contenteditable) + _onInput(e) { + if (!this.isRecording || this.isPaused) return; + // Avoid mid-composition spam (IME): handle final committed value + try { + if (e && typeof e.isComposing === 'boolean' && e.isComposing) return; + } catch {} + const target = e.target; + // Support input/textarea and contenteditable elements + const el = + target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement + ? target + : target && + target.nodeType === 1 && + /** @type {HTMLElement} */ (target).isContentEditable === true + ? /** @type {HTMLElement} */ (target) + : null; + if (!el) return; + this._handleInputForElement(el); + } + + // Document-level input handler: supports composed events from Shadow DOM (custom elements) + _onDocInput(e) { + if (!this.isRecording || this.isPaused) return; + try { + if (e && typeof e.isComposing === 'boolean' && e.isComposing) return; + } catch {} + // Avoid double handling when per-element listener already attached to same element + if (this._focusedEl && e.target === this._focusedEl) return; + // Find the innermost editable element from composedPath + const path = typeof e.composedPath === 'function' ? e.composedPath() : []; + let el = null; + for (let i = 0; i < path.length; i++) { + const n = path[i]; + if (n instanceof HTMLInputElement || n instanceof HTMLTextAreaElement) { + el = n; + break; + } + // Also check for contenteditable + if (n && n.nodeType === 1 && /** @type {HTMLElement} */ (n).isContentEditable === true) { + el = /** @type {HTMLElement} */ (n); + break; + } + } + // As a fallback, walk down activeElement chain (deep active element via shadow roots) + if (!el) { + try { + let ae = document.activeElement; + let guard = 0; + while (ae && guard++ < 10) { + if (ae instanceof HTMLInputElement || ae instanceof HTMLTextAreaElement) { + el = ae; + break; + } + // Check contenteditable in shadow DOM traversal + if ( + ae && + ae.nodeType === 1 && + /** @type {HTMLElement} */ (ae).isContentEditable === true + ) { + el = /** @type {HTMLElement} */ (ae); + break; + } + const anyAe = ae; + if (anyAe && anyAe.shadowRoot && anyAe.shadowRoot.activeElement) { + ae = anyAe.shadowRoot.activeElement; + continue; + } + break; + } + } catch {} + } + if (!el) return; + this._handleInputForElement(el); + } + + // Shared input processing logic (debounce/merge/sensitivity) + // Uses Draft/Upsert model: updates are re-enqueued to ensure background gets final value + _handleInputForElement(el) { + try { + const t = (el.getAttribute && el.getAttribute('type')) || ''; + const tt = String(t).toLowerCase(); + if (tt === 'checkbox' || tt === 'radio' || tt === 'file') return; + } catch {} + const elRef = this._getElRef(el); + const target = SelectorEngine.buildTarget(el); + + // Check if element is contenteditable + const isContentEditable = + el.nodeType === 1 && /** @type {HTMLElement} */ (el).isContentEditable === true; + + const isSensitive = + this.hideInputValues || + (!isContentEditable && + CONFIG.SENSITIVE_INPUT_TYPES.has( + ((el.getAttribute && el.getAttribute('type')) || '').toLowerCase(), + )); + + // Get value: use .value for input/textarea, .innerText for contenteditable + let value = isContentEditable + ? /** @type {HTMLElement} */ (el).innerText || '' + : el.value || ''; + if (isSensitive) { + const varKey = el.name ? el.name : `var_${Math.random().toString(36).slice(2, 6)}`; + this._addVariable(varKey, true, ''); + value = `{${varKey}}`; + } + const nowTs = Date.now(); + const last = this.lastFill.step; + const sameRef = !!(last && last._recordingRef === elRef); + const sameSelector = !!( + last && + last.target && + last.target.selector && + target && + target.selector && + last.target.selector === target.selector + ); + const within = nowTs - this.lastFill.ts <= CONFIG.INPUT_DEBOUNCE_MS; + if ((sameRef || sameSelector) && within) { + // Update existing step's value + this.lastFill.step.value = value; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + this.lastFill.ts = nowTs; + this.lastFill.el = el; // Keep DOM reference updated for finalize + // Keep flush gate aligned to the latest keystroke + this._updateInputActivity(); + // Re-enqueue the updated step for upsert (ensures background gets final value) + this._enqueueForUpsert(this.lastFill.step); + return; + } + const newStep = { type: 'fill', target, value, screenshotOnFail: true }; + newStep._recordingRef = elRef; + this._pushStep(newStep); + this.lastFill = { step: newStep, ts: nowTs, el: el }; + } + + /** + * Enqueue a step for upsert - if step with same id exists in batch, update it. + * This ensures the background receives the final value for fill steps. + * In iframes, forwards to top window to maintain selector composition consistency. + */ + _enqueueForUpsert(step) { + if (!step || !step.id) return; + + // In iframes, forward upsert updates to top so we don't lose composed selectors. + // The top window aggregates iframe steps and computes "frame |> inner" selectors. + // If iframe sends directly to background, it would overwrite the composed selector. + if (window !== window.top) { + try { + const payload = { + kind: 'iframeStepUpsert', + href: String(location && location.href ? location.href : ''), + step, + }; + window.top.postMessage({ type: FRAME_EVENT, payload }, '*'); + } catch {} + return; + } + + // Check if step already in batch + const existingIdx = this.batch.findIndex((s) => s.id === step.id); + if (existingIdx >= 0) { + // Update existing entry in batch + this.batch[existingIdx] = step; + } else { + // Add to batch (step was already flushed, so we need to send update) + this.batch.push(step); + } + + // Schedule flush with appropriate delay (respects typing gate) + this._scheduleFlush(); + } + + _onChange(e) { + if (!this.isRecording || this.isPaused) return; + const el = e.target; + if (el instanceof HTMLSelectElement) { + const val = el.value; + const nowTs = Date.now(); + const elRef = this._getElRef(el); + const sameRef = !!(this.lastFill.step && this.lastFill.step._recordingRef === elRef); + const within = nowTs - this.lastFill.ts <= CONFIG.INPUT_DEBOUNCE_MS; + if (sameRef && within) { + this.lastFill.step.value = val; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + this.lastFill.ts = nowTs; + this.lastFill.el = el; // Keep DOM reference updated + // Re-enqueue for upsert + this._enqueueForUpsert(this.lastFill.step); + return; + } + const target = SelectorEngine.buildTarget(el); + try { + const gref = SelectorEngine._ensureGlobalRef && SelectorEngine._ensureGlobalRef(el); + if (gref) target.ref = gref; + } catch {} + const st = { type: 'fill', target, value: val, screenshotOnFail: true }; + st._recordingRef = elRef; + this._pushStep(st); + this.lastFill = { step: st, ts: nowTs, el: el }; + return; + } + if (el instanceof HTMLInputElement) { + const t = (el.getAttribute && el.getAttribute('type')) || ''; + const tt = String(t).toLowerCase(); + const target = SelectorEngine.buildTarget(el); + try { + const gref = SelectorEngine._ensureGlobalRef && SelectorEngine._ensureGlobalRef(el); + if (gref) target.ref = gref; + } catch {} + const elRef = this._getElRef(el); + if (tt === 'checkbox') { + const st = { type: 'fill', target, value: !!el.checked, screenshotOnFail: true }; + st._recordingRef = elRef; + this._pushStep(st); + return; + } + if (tt === 'radio') { + const st = { type: 'fill', target, value: true, screenshotOnFail: true }; + st._recordingRef = elRef; + this._pushStep(st); + return; + } + if (tt === 'file') { + const varKey = el.name ? el.name : `file_${Math.random().toString(36).slice(2, 6)}`; + this._addVariable(varKey, false, ''); + this._pushStep({ type: 'fill', target, value: `{${varKey}}`, screenshotOnFail: true }); + return; + } + } + } + + _getElRef(el) { + try { + let ref = this.el2ref.get(el); + if (ref) return ref; + ref = `ref_${++this.refCounter}`; + this.el2ref.set(el, ref); + return ref; + } catch { + // Fallback to timestamp-based ref if WeakMap fails (should not happen) + return `ref_${Date.now()}`; + } + } + + // UI handled by injected UI class + + _onFocusIn(e) { + if (!this.isRecording || this.isPaused) return; + const el = e.target; + const isEditable = + el instanceof HTMLInputElement || + el instanceof HTMLTextAreaElement || + (el && el.nodeType === 1 && /** @type {HTMLElement} */ (el).isContentEditable === true); + if (!isEditable) return; + if (this._focusedEl && this._focusedEl !== el) + this._focusedEl.removeEventListener('input', this._onInput, true); + el.addEventListener('input', this._onInput, true); + this._focusedEl = el; + } + + _onFocusOut(e) { + const el = e.target; + if (!el) return; + if (this._focusedEl === el) { + // Commit point: leaving an input field - finalize and flush pending input + // This ensures we don't lose values when user tabs away or clicks elsewhere + this._commitAndFlush(); + el.removeEventListener('input', this._onInput, true); + this._focusedEl = null; + } + } + + _onMouseMove(e) { + if (!this.highlightEnabled || !this.ui._box || !this.isRecording || this.isPaused) return; + if (this.hoverRAF) return; + const el = e.target instanceof Element ? e.target : null; + if (!el) return; + this.hoverRAF = requestAnimationFrame(() => { + try { + const r = el.getBoundingClientRect(); + Object.assign(this.ui._box.style, { + left: `${Math.round(r.left)}px`, + top: `${Math.round(r.top)}px`, + width: `${Math.round(Math.max(0, r.width))}px`, + height: `${Math.round(Math.max(0, r.height))}px`, + display: r.width > 0 && r.height > 0 ? 'block' : 'none', + }); + } catch {} + this.hoverRAF = 0; + }); + } + + _onScroll(e) { + if (!this.isRecording || this.isPaused) return; + try { + const overlay = document.getElementById('__rr_rec_overlay'); + if (overlay) { + // Use composedPath for shadow DOM compatibility, fallback to target + const path = typeof e.composedPath === 'function' ? e.composedPath() : [e.target]; + for (const element of path) { + // If the event path contains our overlay, ignore this scroll event + if (element === overlay) { + return; + } + } + } + } catch { + // ignore + } + // Determine scroll source and positions + const isDoc = e.target === document; + const el = isDoc ? document.documentElement : e.target instanceof Element ? e.target : null; + if (!el) return; + let top = 0, + left = 0; + try { + if (isDoc) { + top = + typeof window.scrollY === 'number' + ? window.scrollY + : document.documentElement.scrollTop || 0; + left = + typeof window.scrollX === 'number' + ? window.scrollX + : document.documentElement.scrollLeft || 0; + } else { + top = el.scrollTop || 0; + left = el.scrollLeft || 0; + } + } catch {} + const target = isDoc ? null : SelectorEngine.buildTarget(el); + // Debounce/coalesce + this._scrollPending = { isDoc, target, top, left }; + if (this.scrollTimer) { + clearTimeout(this.scrollTimer); + } + this.scrollTimer = setTimeout(() => { + this.scrollTimer = null; + const pending = this._scrollPending; + this._scrollPending = null; + if (!pending) return; + const { isDoc: pDoc, target: pTarget, top: pTop, left: pLeft } = pending; + // Try merge with last step + const steps = this.sessionBuffer.steps; + const last = steps.length ? steps[steps.length - 1] : null; + if (last && last.type === 'scroll') { + const sameDoc = pDoc && !last.target && last.mode === 'offset'; + const sameEl = + !pDoc && + last.target && + last.target.selector && + pTarget && + last.target.selector === pTarget.selector && + last.mode === 'container'; + if (sameDoc || sameEl) { + last.offset = { y: pTop, x: pLeft }; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + return; + } + } + // New scroll step + if (pDoc) { + this._pushStep({ + type: 'scroll', + mode: 'offset', + offset: { y: pTop, x: pLeft }, + screenshotOnFail: false, + }); + } else { + this._pushStep({ + type: 'scroll', + mode: 'container', + target: pTarget, + offset: { y: pTop, x: pLeft }, + screenshotOnFail: false, + }); + } + }, CONFIG.SCROLL_DEBOUNCE_MS); + } + + // Minimal key recorder: record Enter and modifier combos; avoid plain typing + _onKeyDown(e) { + if (!this.isRecording || this.isPaused) return; + try { + // Ignore autorepeat to prevent spam + if (e.repeat) return; + const key = String(e.key || '').toLowerCase(); + const isModifier = key === 'shift' || key === 'control' || key === 'meta' || key === 'alt'; + const isEditable = + e.target instanceof HTMLInputElement || + e.target instanceof HTMLTextAreaElement || + (e.target && + e.target.nodeType === 1 && + /** @type {HTMLElement} */ (e.target).isContentEditable === true); + const enterKey = key === 'enter'; + + // Track pressed modifiers + if (isModifier) this._pressed.add(key); + + // Handle Enter in editable contexts (including contenteditable) + if (isEditable && enterKey) { + // Commit point: Enter may trigger form submission/navigation + // Record explicit key action with target first + const target = SelectorEngine.buildTarget(/** @type {Element} */ (e.target)); + const combo = this._formatKeysCombo(e, 'Enter'); + this._pushStep({ type: 'key', keys: combo, target, screenshotOnFail: false }); + + // Then commit and flush (form submit may navigate away) + this._commitAndFlush(); + + this._lastKeyTs = Date.now(); + return; + } + + // For non-text fields: record modifier combos and special keys + const special = enterKey || key === 'escape' || key === 'tab'; + if (special || e.ctrlKey || e.metaKey || e.altKey || e.shiftKey) { + const comboName = this._formatKeysCombo(e, e.key); + this._pushStep({ type: 'key', keys: comboName, screenshotOnFail: false }); + this._lastKeyTs = Date.now(); + } + } catch {} + } + + _onKeyUp(e) { + const key = String(e.key || '').toLowerCase(); + if (key === 'shift' || key === 'control' || key === 'meta' || key === 'alt') + this._pressed.delete(key); + } + + _formatKeysCombo(e, mainKey) { + const parts = []; + if (e.ctrlKey) parts.push('Ctrl'); + if (e.altKey) parts.push('Alt'); + if (e.shiftKey) parts.push('Shift'); + if (e.metaKey) parts.push('Meta'); + const mk = String(mainKey || '').trim(); + // Normalize common names to match keyboard-helper parsing + const norm = (s) => { + const k = s.toLowerCase(); + if (k === 'escape') return 'Esc'; + if (k === ' ') return 'Space'; + if (k.length === 1) return k.toUpperCase(); + return s; + }; + parts.push(norm(mk)); + return parts.join('+'); + } + + // Top-level aggregator: receives iframe events and merges into session + _onWindowMessage(ev) { + try { + const d = ev && ev.data; + if (!d || d.type !== FRAME_EVENT || !d.payload) return; + + // Security: validate message source is from a known iframe in our page + // ev.source must match contentWindow of an iframe element we control + let frameEl = null; + try { + const frames = document.querySelectorAll('iframe,frame'); + for (let i = 0; i < frames.length; i++) { + const f = frames[i]; + if (f && f.contentWindow === ev.source) { + frameEl = f; + break; + } + } + } catch {} + + // Reject messages not from a recognized iframe in our document + if (!frameEl) { + // Message source is not from a child iframe we control - ignore + return; + } + + // Additional origin check: only accept from same origin or about:blank iframes + // (cross-origin iframes legitimately send from their origin) + try { + const selfOrigin = window.location.origin; + const msgOrigin = ev.origin; + // Allow same-origin, null (for sandboxed iframes), or if iframe src is same-origin + const frameSrc = frameEl.getAttribute('src') || ''; + let iframeSameOrigin = false; + try { + if (!frameSrc || frameSrc === 'about:blank') { + iframeSameOrigin = true; + } else { + const frameUrl = new URL(frameSrc, selfOrigin); + iframeSameOrigin = frameUrl.origin === selfOrigin; + } + } catch { + // Invalid URL - assume cross-origin + } + // If iframe is same-origin, message origin should match + if (iframeSameOrigin && msgOrigin !== selfOrigin && msgOrigin !== 'null') { + return; // Origin mismatch for same-origin iframe - suspicious + } + } catch {} + + const payload = d.payload || {}; + const kind = payload.kind; + + // Stop barrier sync: ACK back to the iframe so it can finish stop only after + // its final postMessages have been processed by the top aggregator + if (kind === 'iframeStopBarrier') { + try { + const id = payload.id; + if (id && ev.source && typeof ev.source.postMessage === 'function') { + ev.source.postMessage( + { type: FRAME_EVENT, payload: { kind: 'iframeStopBarrierAck', id } }, + '*', + ); + } + } catch {} + return; + } + + // Handle iframe flush request: immediately flush top's aggregated buffer + if (kind === 'iframeFlush') { + this._lastInputActivityTs = 0; + this._typingBurstStartTs = 0; + this._clearForceFlushTimer(); + if (this.batchTimer) clearTimeout(this.batchTimer); + this.batchTimer = null; + if (this.batch.length > 0) this._flush(); + return; + } + + const { step, href } = payload; + if (!step || typeof step !== 'object') return; + + // Compose frame selector for iframe steps + const frameTarget = SelectorEngine.buildTarget(frameEl); + const frameSel = frameTarget?.selector || ''; + + // For upsert: find existing step in session and update it + if (kind === 'iframeStepUpsert') { + // Update input activity for iframe fills (enables flush gate for iframe input) + if (step.type === 'fill') { + this._updateInputActivity(); + } + + // Find step by id in session buffer and update its value + const existingIdx = this.sessionBuffer.steps.findIndex((s) => s.id === step.id); + if (existingIdx >= 0) { + // Update value but preserve the composed selector + this.sessionBuffer.steps[existingIdx].value = step.value; + this.sessionBuffer.meta.updatedAt = new Date().toISOString(); + // Also update in batch if present + const batchIdx = this.batch.findIndex((s) => s.id === step.id); + if (batchIdx >= 0) { + this.batch[batchIdx].value = step.value; + } else { + // Step was already flushed, add updated version to batch + const updatedStep = { ...this.sessionBuffer.steps[existingIdx] }; + this.batch.push(updatedStep); + } + this._scheduleFlush(); + } + return; + } + + // Regular iframe step: compose composite selector and push + if (step.target) { + const inner = String(step.target.selector || '').trim(); + if (frameSel && inner) { + const composite = `${frameSel} |> ${inner}`; + step.target.selector = composite; + if (Array.isArray(step.target.candidates)) { + step.target.candidates.unshift({ type: 'css', value: composite }); + } + } + } + this._pushStep(step); + } catch {} + } + } + + // ================================================================ + // 3) SINGLETON + MESSAGE HANDLERS + // ================================================================ + let recorderInstance = null; + function getRecorder() { + if (!recorderInstance) recorderInstance = new ContentRecorder(); + return recorderInstance; + } + + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + try { + if (!request || !request.action) return false; + if (request.action === 'rr_timeline_update') { + const rec = getRecorder(); + // Only respond to timeline updates when recording is active + if (!rec.isRecording) { + sendResponse({ ok: true, ignored: true }); + return true; + } + // Replace entire timeline to avoid divergence across tabs + const steps = Array.isArray(request.steps) ? request.steps : []; + rec.ui.applyTimelineUpdate(steps); + sendResponse({ ok: true }); + return true; + } + if (request.action === 'rr_recorder_control') { + const rec = getRecorder(); + const cmd = request.cmd; + if (cmd === 'start') { + rec.start(request.meta || {}); + sendResponse({ success: true }); + return true; + } + if (cmd === 'pause') { + rec.pause(); + sendResponse({ success: true }); + return true; + } + if (cmd === 'resume') { + rec.resume(); + sendResponse({ success: true }); + return true; + } + if (cmd === 'stop') { + // Stop is now async - flush all data and wait for ack before responding + rec + .stop() + .then((result) => { + sendResponse({ success: true, ack: result.ack, stats: result }); + }) + .catch((err) => { + sendResponse({ success: false, ack: false, error: String(err) }); + }); + return true; // Keep channel open for async response + } + sendResponse({ success: false, error: 'Unknown command' }); + return true; + } + // Handle direct stop message with ack (sent by recorder-manager) + if (request.action === 'stop' && request.requireAck) { + const rec = getRecorder(); + rec + .stop() + .then((result) => { + sendResponse({ ack: result.ack, stats: result }); + }) + .catch(() => { + sendResponse({ ack: false }); + }); + return true; + } + if (request.action === 'rr_recorder_ping') { + sendResponse({ status: 'pong' }); + return false; + } + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + return false; + }); + + console.log('Record & Replay recorder.js loaded'); +})(); diff --git a/app/chrome-extension/inject-scripts/wait-helper.js b/app/chrome-extension/inject-scripts/wait-helper.js new file mode 100644 index 00000000..77ffb110 --- /dev/null +++ b/app/chrome-extension/inject-scripts/wait-helper.js @@ -0,0 +1,234 @@ +/* eslint-disable */ +// wait-helper.js +// Listen for text appearance/disappearance in the current document using MutationObserver. +// Returns a stable ref (compatible with accessibility-tree-helper) for the first matching element. + +(function () { + if (window.__WAIT_HELPER_INITIALIZED__) return; + window.__WAIT_HELPER_INITIALIZED__ = true; + + // Ensure ref mapping infra exists (compatible with accessibility-tree-helper.js) + if (!window.__claudeElementMap) window.__claudeElementMap = {}; + if (!window.__claudeRefCounter) window.__claudeRefCounter = 0; + + function isVisible(el) { + try { + if (!(el instanceof Element)) return false; + const style = getComputedStyle(el); + if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') + return false; + const rect = el.getBoundingClientRect(); + if (rect.width <= 0 || rect.height <= 0) return false; + return true; + } catch { + return false; + } + } + + function normalize(str) { + return String(str || '') + .replace(/\s+/g, ' ') + .trim() + .toLowerCase(); + } + + function matchesText(el, needle) { + const t = normalize(needle); + if (!t) return false; + try { + if (!isVisible(el)) return false; + const aria = el.getAttribute('aria-label'); + if (aria && normalize(aria).includes(t)) return true; + const title = el.getAttribute('title'); + if (title && normalize(title).includes(t)) return true; + const alt = el.getAttribute('alt'); + if (alt && normalize(alt).includes(t)) return true; + const placeholder = el.getAttribute('placeholder'); + if (placeholder && normalize(placeholder).includes(t)) return true; + // input/textarea value + if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) { + const value = el.value || el.getAttribute('value'); + if (value && normalize(value).includes(t)) return true; + } + const text = el.innerText || el.textContent || ''; + if (normalize(text).includes(t)) return true; + } catch {} + return false; + } + + function findElementByText(text) { + // Fast path: query common interactive elements first + const prioritized = Array.from( + document.querySelectorAll('a,button,input,textarea,select,label,summary,[role]'), + ); + for (const el of prioritized) if (matchesText(el, text)) return el; + + // Fallback: broader scan with cap to avoid blocking on huge pages + const walker = document.createTreeWalker( + document.body || document.documentElement, + NodeFilter.SHOW_ELEMENT, + ); + let count = 0; + while (walker.nextNode()) { + const el = /** @type {Element} */ (walker.currentNode); + if (matchesText(el, text)) return el; + if (++count > 5000) break; // Hard cap to avoid long scans + } + return null; + } + + function ensureRefForElement(el) { + // Try to reuse an existing ref + for (const k in window.__claudeElementMap) { + const weak = window.__claudeElementMap[k]; + if (weak && typeof weak.deref === 'function' && weak.deref() === el) return k; + } + const refId = `ref_${++window.__claudeRefCounter}`; + window.__claudeElementMap[refId] = new WeakRef(el); + return refId; + } + + function centerOf(el) { + const r = el.getBoundingClientRect(); + return { x: Math.round(r.left + r.width / 2), y: Math.round(r.top + r.height / 2) }; + } + + function waitFor({ text, appear = true, timeout = 5000 }) { + return new Promise((resolve) => { + const start = Date.now(); + let resolved = false; + + const check = () => { + try { + const match = findElementByText(text); + if (appear) { + if (match) { + const ref = ensureRefForElement(match); + const center = centerOf(match); + done({ success: true, matched: { ref, center }, tookMs: Date.now() - start }); + } + } else { + // wait for disappearance + if (!match) { + done({ success: true, matched: null, tookMs: Date.now() - start }); + } + } + } catch {} + }; + + const done = (result) => { + if (resolved) return; + resolved = true; + obs && obs.disconnect(); + clearTimeout(timer); + resolve(result); + }; + + const obs = new MutationObserver(() => check()); + try { + obs.observe(document.documentElement || document.body, { + subtree: true, + childList: true, + characterData: true, + attributes: true, + }); + } catch {} + + // Initial check + check(); + const timer = setTimeout( + () => { + done({ success: false, reason: 'timeout', tookMs: Date.now() - start }); + }, + Math.max(0, timeout), + ); + }); + } + + function waitForSelector({ selector, visible = true, timeout = 5000 }) { + return new Promise((resolve) => { + const start = Date.now(); + let resolved = false; + + const isMatch = () => { + try { + const el = document.querySelector(selector); + if (!el) return null; + if (!visible) return el; + return isVisible(el) ? el : null; + } catch { + return null; + } + }; + + const done = (result) => { + if (resolved) return; + resolved = true; + obs && obs.disconnect(); + clearTimeout(timer); + resolve(result); + }; + + const check = () => { + const el = isMatch(); + if (el) { + const ref = ensureRefForElement(el); + const center = centerOf(el); + done({ success: true, matched: { ref, center }, tookMs: Date.now() - start }); + } + }; + + const obs = new MutationObserver(check); + try { + obs.observe(document.documentElement || document.body, { + subtree: true, + childList: true, + characterData: true, + attributes: true, + }); + } catch {} + + // initial check + check(); + const timer = setTimeout( + () => done({ success: false, reason: 'timeout', tookMs: Date.now() - start }), + Math.max(0, timeout), + ); + }); + } + + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + try { + if (request && request.action === 'wait_helper_ping') { + sendResponse({ status: 'pong' }); + return false; + } + if (request && request.action === 'waitForText') { + const text = String(request.text || '').trim(); + const appear = request.appear !== false; // default true + const timeout = Number(request.timeout || 5000); + if (!text) { + sendResponse({ success: false, error: 'text is required' }); + return true; + } + waitFor({ text, appear, timeout }).then((res) => sendResponse(res)); + return true; // async + } + if (request && request.action === 'waitForSelector') { + const selector = String(request.selector || '').trim(); + const visible = request.visible !== false; // default true + const timeout = Number(request.timeout || 5000); + if (!selector) { + sendResponse({ success: false, error: 'selector is required' }); + return true; + } + waitForSelector({ selector, visible, timeout }).then((res) => sendResponse(res)); + return true; // async + } + } catch (e) { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + return true; + } + return false; + }); +})(); diff --git a/app/chrome-extension/inject-scripts/web-editor.js b/app/chrome-extension/inject-scripts/web-editor.js new file mode 100644 index 00000000..286c0131 --- /dev/null +++ b/app/chrome-extension/inject-scripts/web-editor.js @@ -0,0 +1,848 @@ +/* eslint-disable */ + +(() => { + const GLOBAL_KEY = '__MCP_WEB_EDITOR__'; + if (window[GLOBAL_KEY]) return; + + const IS_MAIN = window === window.top; + const COLORS = { + hover: '#3b82f6', // blue-500 + selected: '#22c55e', // green-500 + backdrop: 'rgba(15, 23, 42, 0.15)', // slate-900 @ 15% + }; + + const clamp = (v, min, max) => Math.min(max, Math.max(min, v)); + + const normalizeTextSnippet = (value, maxLen) => { + return String(value || '') + .replace(/\s+/g, ' ') + .trim() + .slice(0, maxLen || 80); + }; + + const containsPoint = (rect, x, y) => { + if (!rect) return false; + return x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom; + }; + + const getElementLabel = (el) => { + if (!(el instanceof Element)) return ''; + const tag = String(el.tagName || '').toLowerCase(); + const id = el.id ? `#${el.id}` : ''; + const classes = + el.classList && el.classList.length + ? `.${Array.from(el.classList).slice(0, 3).join('.')}` + : ''; + return `${tag}${id}${classes}`; + }; + + const detectTailwind = (classes) => { + try { + const patterns = [ + /^bg-/, + /^text-/, + /^p[trblxy]?-/, + /^m[trblxy]?-/, + /^flex$/, + /^grid$/, + /^items-/, + /^justify-/, + /^gap-/, + /^rounded/, + /^shadow/, + /^border/, + ]; + for (const cls of classes || []) { + if (patterns.some((p) => p.test(cls))) return true; + } + } catch {} + return false; + }; + + const findReactFileFromFiber = (fiber) => { + try { + let current = fiber; + for (let i = 0; i < 40 && current; i++) { + const src = current._debugSource; + if (src && src.fileName && typeof src.fileName === 'string') return src.fileName; + const owner = current._debugOwner; + const ownerSrc = owner && owner._debugSource; + if (ownerSrc && ownerSrc.fileName && typeof ownerSrc.fileName === 'string') + return ownerSrc.fileName; + current = current.return; + } + } catch {} + return ''; + }; + + const findReactSourceFile = (el) => { + try { + let node = el; + for (let depth = 0; depth < 15 && node; depth++) { + const keys = Object.keys(node); + for (const k of keys) { + if (k.startsWith('__reactFiber$') || k.startsWith('__reactInternalInstance$')) { + const fiber = node[k]; + const found = findReactFileFromFiber(fiber); + if (found) return found; + } + } + node = node.parentElement; + } + } catch {} + return ''; + }; + + const findVueSourceFile = (el) => { + try { + let node = el; + for (let depth = 0; depth < 15 && node; depth++) { + const inst = node.__vueParentComponent; + if (inst && inst.type && inst.type.__file) return String(inst.type.__file); + node = node.parentElement; + } + } catch {} + return ''; + }; + + const resolveTargetFile = (el) => { + try { + let node = el; + for (let depth = 0; depth < 20 && node; depth++) { + const reactFile = findReactSourceFile(node); + if (reactFile && !reactFile.includes('node_modules')) return reactFile; + const vueFile = findVueSourceFile(node); + if (vueFile && !vueFile.includes('node_modules')) return vueFile; + node = node.parentElement; + } + } catch {} + return ''; + }; + + const findMeaningfulElement = (el, clientX, clientY) => { + try { + let current = el instanceof Element ? el : null; + for (let i = 0; i < 8 && current; i++) { + const tag = String(current.tagName || '').toUpperCase(); + if (tag === 'HTML' || tag === 'BODY') { + const deeper = document.elementFromPoint(clientX, clientY); + if (deeper && deeper !== current && deeper instanceof Element) { + current = deeper; + continue; + } + return current; + } + + let style; + try { + style = window.getComputedStyle(current); + } catch { + return current; + } + + const bg = String(style.backgroundColor || '').toLowerCase(); + const isTransparentBg = bg === 'transparent' || bg === 'rgba(0, 0, 0, 0)'; + const borderWidth = [ + style.borderTopWidth, + style.borderRightWidth, + style.borderBottomWidth, + style.borderLeftWidth, + ] + .map((x) => String(x || '0px')) + .join(','); + const hasBorder = borderWidth !== '0px,0px,0px,0px'; + + if (!isTransparentBg || hasBorder) return current; + + const rect = current.getBoundingClientRect(); + if (!rect || rect.width <= 0 || rect.height <= 0) return current; + + let bestChild = null; + let bestArea = Infinity; + const children = Array.from(current.children || []); + for (const child of children) { + if (!(child instanceof Element)) continue; + const r = child.getBoundingClientRect(); + if (!r || r.width <= 0 || r.height <= 0) continue; + if (!containsPoint(r, clientX, clientY)) continue; + const area = r.width * r.height; + if (area < bestArea) { + bestArea = area; + bestChild = child; + } + } + + if (!bestChild) return current; + + const childRect = bestChild.getBoundingClientRect(); + const sameSize = + Math.abs(rect.width - childRect.width) < 2 && + Math.abs(rect.height - childRect.height) < 2; + if (!sameSize) return current; + + current = bestChild; + } + } catch {} + return el instanceof Element ? el : null; + }; + + const createToastHost = () => { + const host = document.createElement('div'); + Object.assign(host.style, { + position: 'fixed', + left: '12px', + bottom: '12px', + zIndex: 2147483647, + display: 'flex', + flexDirection: 'column', + gap: '8px', + pointerEvents: 'none', + }); + return host; + }; + + const showToast = (state, message, kind) => { + try { + if (!state.toastHost) return; + const item = document.createElement('div'); + const bg = + kind === 'error' + ? 'rgba(220, 38, 38, 0.92)' + : kind === 'success' + ? 'rgba(22, 163, 74, 0.92)' + : 'rgba(15, 23, 42, 0.92)'; + Object.assign(item.style, { + background: bg, + color: '#fff', + padding: '8px 10px', + borderRadius: '10px', + fontSize: '12px', + fontFamily: 'system-ui,-apple-system,Segoe UI,Roboto,Arial', + boxShadow: '0 6px 18px rgba(0,0,0,0.22)', + maxWidth: '340px', + lineHeight: '1.35', + }); + item.textContent = String(message || ''); + state.toastHost.appendChild(item); + setTimeout(() => { + try { + item.remove(); + } catch {} + }, 2800); + } catch {} + }; + + const buildStyleMapFromInput = (raw) => { + const out = {}; + const text = String(raw || '').trim(); + if (!text) return out; + const parts = text + .split(';') + .map((s) => s.trim()) + .filter(Boolean); + for (const part of parts) { + const idx = part.indexOf(':'); + if (idx <= 0) continue; + const key = part.slice(0, idx).trim(); + const value = part.slice(idx + 1).trim(); + if (!key || !value) continue; + out[key] = value; + } + return out; + }; + + const applyInlineStyleMap = (el, styles) => { + try { + if (!(el instanceof Element)) return; + const entries = Object.entries(styles || {}); + for (const [key, value] of entries) { + if (!key || !value) continue; + try { + el.style.setProperty(key, value); + } catch {} + } + } catch {} + }; + + const state = { + active: false, + root: null, + canvas: null, + ctx: null, + raf: 0, + dpr: 1, + viewport: { w: 0, h: 0 }, + hoveredEl: null, + selectedEl: null, + hoverRect: null, + selectedRect: null, + toolbar: null, + toastHost: null, + inputText: '', + inputStyle: '', + lastPointer: { x: 0, y: 0 }, + }; + + const ensureCanvas = () => { + if (!state.canvas || !state.ctx) return; + const dpr = window.devicePixelRatio || 1; + const w = Math.max(1, window.innerWidth || document.documentElement.clientWidth || 1); + const h = Math.max(1, window.innerHeight || document.documentElement.clientHeight || 1); + if (state.viewport.w === w && state.viewport.h === h && Math.abs(state.dpr - dpr) < 0.01) + return; + state.dpr = dpr; + state.viewport = { w, h }; + state.canvas.width = Math.round(w * dpr); + state.canvas.height = Math.round(h * dpr); + state.canvas.style.width = `${w}px`; + state.canvas.style.height = `${h}px`; + state.ctx.setTransform(dpr, 0, 0, dpr, 0, 0); + }; + + const drawRect = (rect, color, dashed) => { + if (!rect || !state.ctx) return; + const ctx = state.ctx; + const x = Math.round(rect.left) + 0.5; + const y = Math.round(rect.top) + 0.5; + const w = Math.max(0, Math.round(rect.width)); + const h = Math.max(0, Math.round(rect.height)); + if (w <= 0 || h <= 0) return; + ctx.save(); + ctx.lineWidth = 2; + ctx.strokeStyle = color; + ctx.fillStyle = `${color}22`; + if (dashed) ctx.setLineDash([6, 4]); + ctx.beginPath(); + ctx.rect(x, y, w, h); + ctx.fill(); + ctx.stroke(); + ctx.restore(); + }; + + const draw = () => { + if (!state.active || !state.ctx) return; + ensureCanvas(); + const ctx = state.ctx; + ctx.clearRect(0, 0, state.viewport.w, state.viewport.h); + + // Keep selected rect fresh in case HMR/layout changes. + try { + if (state.selectedEl && state.selectedEl instanceof Element) { + state.selectedRect = state.selectedEl.getBoundingClientRect(); + } + } catch {} + try { + if (state.hoveredEl && state.hoveredEl instanceof Element) { + state.hoverRect = state.hoveredEl.getBoundingClientRect(); + } + } catch {} + + drawRect(state.hoverRect, COLORS.hover, true); + drawRect(state.selectedRect, COLORS.selected, false); + + // Keep toolbar anchored to the selected element. + positionToolbar(); + }; + + const tick = () => { + if (!state.active) return; + draw(); + state.raf = requestAnimationFrame(tick); + }; + + const isInToolbar = (target) => { + try { + if (!target || !(target instanceof Node)) return false; + if (!state.toolbar) return false; + return state.toolbar.contains(target); + } catch { + return false; + } + }; + + const updateHover = (el, clientX, clientY) => { + const picked = findMeaningfulElement(el, clientX, clientY); + state.hoveredEl = picked; + try { + state.hoverRect = picked ? picked.getBoundingClientRect() : null; + } catch { + state.hoverRect = null; + } + }; + + const positionToolbar = () => { + try { + if (!state.toolbar || !state.selectedRect) return; + const pad = 10; + const maxW = 420; + const rect = state.selectedRect; + const preferredLeft = clamp( + Math.round(rect.left), + pad, + Math.max(pad, window.innerWidth - maxW - pad), + ); + const preferredTop = Math.round(rect.top - 12); + const top = preferredTop < 80 ? Math.round(rect.bottom + 12) : preferredTop; + Object.assign(state.toolbar.style, { + left: `${preferredLeft}px`, + top: `${clamp(top, pad, Math.max(pad, window.innerHeight - 180))}px`, + }); + } catch {} + }; + + const updateToolbarHeader = () => { + try { + if (!state.toolbar) return; + const label = state.toolbar.querySelector('[data-role="label"]'); + if (!label) return; + label.textContent = state.selectedEl ? getElementLabel(state.selectedEl) : 'No selection'; + } catch {} + }; + + const buildApplyPayload = (instruction) => { + const el = state.selectedEl; + const tag = el && el.tagName ? String(el.tagName || '').toLowerCase() : 'unknown'; + const id = el && el.id ? String(el.id) : undefined; + const classes = el && el.classList ? Array.from(el.classList).slice(0, 24) : []; + const text = normalizeTextSnippet(el ? el.textContent : '', 96); + const fingerprint = { tag, id, classes, text }; + const targetFile = el ? resolveTargetFile(el) : ''; + const hints = []; + try { + if (el) { + const r = findReactSourceFile(el); + const v = findVueSourceFile(el); + if (r) hints.push('React'); + if (v) hints.push('Vue'); + } + if (detectTailwind(classes)) hints.push('Tailwind'); + } catch {} + return { + pageUrl: String(location && location.href ? location.href : ''), + targetFile: targetFile || undefined, + fingerprint, + techStackHint: hints.length ? hints : undefined, + instruction, + }; + }; + + const onMouseMove = (e) => { + if (!state.active) return; + if (isInToolbar(e.target)) return; + state.lastPointer = { x: e.clientX, y: e.clientY }; + const el = e.target instanceof Element ? e.target : null; + if (!el) return; + updateHover(el, e.clientX, e.clientY); + }; + + const onClick = (e) => { + if (!state.active) return; + if (isInToolbar(e.target)) return; + try { + e.preventDefault(); + e.stopPropagation(); + } catch {} + const el = state.hoveredEl; + if (!el) return; + state.selectedEl = el; + try { + state.selectedRect = el.getBoundingClientRect(); + } catch { + state.selectedRect = null; + } + updateToolbarHeader(); + positionToolbar(); + }; + + const intercept = (e) => { + if (!state.active) return; + if (isInToolbar(e.target)) return; + // Allow scroll/wheel to keep navigation usable in edit mode. + if (e.type === 'wheel') return; + try { + e.preventDefault(); + e.stopPropagation(); + } catch {} + }; + + const onKeyDown = (e) => { + if (!state.active) return; + if (isInToolbar(e.target)) return; + if (e.key === 'Escape') { + try { + e.preventDefault(); + e.stopPropagation(); + } catch {} + stop(); + return; + } + }; + + const buildToolbar = () => { + const box = document.createElement('div'); + state.toolbar = box; + Object.assign(box.style, { + position: 'fixed', + left: '12px', + top: '12px', + zIndex: 2147483647, + pointerEvents: 'auto', + width: 'min(420px, calc(100vw - 24px))', + background: 'rgba(255,255,255,0.96)', + border: '1px solid rgba(148, 163, 184, 0.6)', + borderRadius: '12px', + boxShadow: '0 10px 30px rgba(0,0,0,0.18)', + fontFamily: 'system-ui,-apple-system,Segoe UI,Roboto,Arial', + color: '#0f172a', + overflow: 'hidden', + }); + + const header = document.createElement('div'); + Object.assign(header.style, { + display: 'flex', + alignItems: 'center', + justifyContent: 'space-between', + gap: '10px', + padding: '10px 12px', + background: 'rgba(248,250,252,0.9)', + borderBottom: '1px solid rgba(148, 163, 184, 0.35)', + }); + const label = document.createElement('div'); + label.setAttribute('data-role', 'label'); + Object.assign(label.style, { + fontSize: '12px', + fontWeight: '600', + whiteSpace: 'nowrap', + overflow: 'hidden', + textOverflow: 'ellipsis', + maxWidth: '280px', + }); + label.textContent = 'Select an element'; + + const btnExit = document.createElement('button'); + btnExit.textContent = 'Exit (Esc)'; + Object.assign(btnExit.style, { + fontSize: '12px', + padding: '6px 10px', + borderRadius: '10px', + border: '1px solid rgba(148,163,184,0.6)', + background: '#fff', + cursor: 'pointer', + }); + btnExit.addEventListener('click', () => stop()); + + header.appendChild(label); + header.appendChild(btnExit); + + const body = document.createElement('div'); + Object.assign(body.style, { + padding: '10px 12px 12px', + display: 'flex', + flexDirection: 'column', + gap: '10px', + }); + + const mkRow = (titleText) => { + const row = document.createElement('div'); + Object.assign(row.style, { + display: 'flex', + flexDirection: 'column', + gap: '6px', + }); + const title = document.createElement('div'); + title.textContent = titleText; + Object.assign(title.style, { fontSize: '12px', fontWeight: '600', color: '#334155' }); + row.appendChild(title); + return { row, title }; + }; + + const mkActions = () => { + const actions = document.createElement('div'); + Object.assign(actions.style, { + display: 'flex', + gap: '8px', + alignItems: 'center', + flexWrap: 'wrap', + }); + return actions; + }; + + const mkButton = (text, variant) => { + const btn = document.createElement('button'); + btn.textContent = text; + const bg = variant === 'primary' ? '#0f172a' : '#fff'; + const color = variant === 'primary' ? '#fff' : '#0f172a'; + Object.assign(btn.style, { + fontSize: '12px', + padding: '7px 10px', + borderRadius: '10px', + border: '1px solid rgba(148,163,184,0.6)', + background: bg, + color, + cursor: 'pointer', + }); + return btn; + }; + + // Text edit + const textRow = mkRow('Text'); + const textInput = document.createElement('input'); + textInput.type = 'text'; + textInput.placeholder = 'New text…'; + Object.assign(textInput.style, { + width: '100%', + padding: '8px 10px', + borderRadius: '10px', + border: '1px solid rgba(148,163,184,0.6)', + fontSize: '12px', + outline: 'none', + }); + textInput.addEventListener('input', () => { + state.inputText = textInput.value; + }); + const textActions = mkActions(); + const btnApplyText = mkButton('Apply (DOM)', 'secondary'); + btnApplyText.addEventListener('click', () => { + if (!state.selectedEl) return showToast(state, 'No selection', 'error'); + const v = String(state.inputText || '').trim(); + if (!v) return showToast(state, 'Text is empty', 'error'); + try { + state.selectedEl.textContent = v; + showToast(state, 'Text applied (DOM)', 'success'); + } catch { + showToast(state, 'Failed to apply text', 'error'); + } + }); + const btnSyncText = mkButton('Sync to Code', 'primary'); + btnSyncText.addEventListener('click', async () => { + if (!state.selectedEl) return showToast(state, 'No selection', 'error'); + const v = String(state.inputText || '').trim(); + if (!v) return showToast(state, 'Text is empty', 'error'); + const payload = buildApplyPayload({ + type: 'update_text', + description: `Set the element text to: ${JSON.stringify(v)}`, + text: v, + }); + try { + const resp = await chrome.runtime.sendMessage({ type: 'web_editor_apply', payload }); + if (resp && resp.success) { + showToast(state, `Agent accepted (requestId=${resp.requestId || 'n/a'})`, 'success'); + } else { + showToast(state, resp?.error || 'Agent request failed', 'error'); + } + } catch (err) { + showToast(state, String(err && err.message ? err.message : err), 'error'); + } + }); + textActions.appendChild(btnApplyText); + textActions.appendChild(btnSyncText); + textRow.row.appendChild(textInput); + textRow.row.appendChild(textActions); + + // Style edit + const styleRow = mkRow('Style (CSS declarations)'); + const styleInput = document.createElement('input'); + styleInput.type = 'text'; + styleInput.placeholder = 'e.g. background-color: #f3f4f6; padding: 12px'; + Object.assign(styleInput.style, { + width: '100%', + padding: '8px 10px', + borderRadius: '10px', + border: '1px solid rgba(148,163,184,0.6)', + fontSize: '12px', + outline: 'none', + }); + styleInput.addEventListener('input', () => { + state.inputStyle = styleInput.value; + }); + const styleActions = mkActions(); + const btnApplyStyle = mkButton('Apply (DOM)', 'secondary'); + btnApplyStyle.addEventListener('click', () => { + if (!state.selectedEl) return showToast(state, 'No selection', 'error'); + const map = buildStyleMapFromInput(state.inputStyle); + const keys = Object.keys(map); + if (!keys.length) return showToast(state, 'No valid declarations', 'error'); + applyInlineStyleMap(state.selectedEl, map); + showToast(state, 'Style applied (DOM)', 'success'); + }); + const btnSyncStyle = mkButton('Sync to Code', 'primary'); + btnSyncStyle.addEventListener('click', async () => { + if (!state.selectedEl) return showToast(state, 'No selection', 'error'); + const map = buildStyleMapFromInput(state.inputStyle); + const keys = Object.keys(map); + if (!keys.length) return showToast(state, 'No valid declarations', 'error'); + const decl = keys.map((k) => `${k}: ${map[k]}`).join('; '); + const payload = buildApplyPayload({ + type: 'update_style', + description: `Apply CSS declarations: ${decl}`, + style: map, + }); + try { + const resp = await chrome.runtime.sendMessage({ type: 'web_editor_apply', payload }); + if (resp && resp.success) { + showToast(state, `Agent accepted (requestId=${resp.requestId || 'n/a'})`, 'success'); + } else { + showToast(state, resp?.error || 'Agent request failed', 'error'); + } + } catch (err) { + showToast(state, String(err && err.message ? err.message : err), 'error'); + } + }); + styleActions.appendChild(btnApplyStyle); + styleActions.appendChild(btnSyncStyle); + styleRow.row.appendChild(styleInput); + styleRow.row.appendChild(styleActions); + + body.appendChild(textRow.row); + body.appendChild(styleRow.row); + box.appendChild(header); + box.appendChild(body); + return box; + }; + + const start = () => { + if (!IS_MAIN) return; + if (state.active) return; + state.active = true; + + const root = document.createElement('div'); + state.root = root; + root.id = '__mcp_web_editor_root'; + Object.assign(root.style, { + position: 'fixed', + inset: '0', + zIndex: 2147483647, + pointerEvents: 'none', + }); + + const canvas = document.createElement('canvas'); + state.canvas = canvas; + Object.assign(canvas.style, { + position: 'fixed', + inset: '0', + width: '100%', + height: '100%', + pointerEvents: 'none', + }); + root.appendChild(canvas); + + try { + const ctx = canvas.getContext('2d'); + state.ctx = ctx; + } catch { + state.ctx = null; + } + + const toolbar = buildToolbar(); + root.appendChild(toolbar); + + const toastHost = createToastHost(); + state.toastHost = toastHost; + root.appendChild(toastHost); + + document.documentElement.appendChild(root); + + document.addEventListener('mousemove', onMouseMove, { capture: true, passive: true }); + document.addEventListener('click', onClick, true); + document.addEventListener('mousedown', intercept, true); + document.addEventListener('mouseup', intercept, true); + document.addEventListener('dblclick', intercept, true); + document.addEventListener('contextmenu', intercept, true); + document.addEventListener('submit', intercept, true); + document.addEventListener('keydown', onKeyDown, true); + + // Visual cue + showToast(state, 'Web Editor: ON (Esc to exit)', 'info'); + + // Start RAF + state.raf = requestAnimationFrame(tick); + }; + + const stop = () => { + if (!IS_MAIN) return; + if (!state.active) return; + state.active = false; + + try { + if (state.raf) cancelAnimationFrame(state.raf); + } catch {} + state.raf = 0; + + try { + document.removeEventListener('mousemove', onMouseMove, true); + document.removeEventListener('click', onClick, true); + document.removeEventListener('mousedown', intercept, true); + document.removeEventListener('mouseup', intercept, true); + document.removeEventListener('dblclick', intercept, true); + document.removeEventListener('contextmenu', intercept, true); + document.removeEventListener('submit', intercept, true); + document.removeEventListener('keydown', onKeyDown, true); + } catch {} + + try { + state.root && state.root.remove(); + } catch {} + + state.root = null; + state.canvas = null; + state.ctx = null; + state.hoveredEl = null; + state.selectedEl = null; + state.hoverRect = null; + state.selectedRect = null; + state.toolbar = null; + state.toastHost = null; + state.inputText = ''; + state.inputStyle = ''; + }; + + const toggle = () => { + if (!IS_MAIN) return false; + if (state.active) { + stop(); + return false; + } + start(); + return true; + }; + + // Expose minimal API for debugging + window[GLOBAL_KEY] = { + start, + stop, + toggle, + getState: () => ({ active: state.active }), + }; + + // Message handler (background -> tab) + chrome.runtime.onMessage.addListener((request, _sender, sendResponse) => { + try { + if (!IS_MAIN) return false; + if (request && request.action === 'web_editor_ping') { + sendResponse({ status: 'pong' }); + return false; + } + if (request && request.action === 'web_editor_toggle') { + const active = toggle(); + sendResponse({ active }); + return true; + } + if (request && request.action === 'web_editor_start') { + start(); + sendResponse({ active: true }); + return true; + } + if (request && request.action === 'web_editor_stop') { + stop(); + sendResponse({ active: false }); + return true; + } + } catch (e) { + try { + sendResponse({ success: false, error: String(e && e.message ? e.message : e) }); + } catch {} + return true; + } + return false; + }); +})(); diff --git a/app/chrome-extension/inject-scripts/web-fetcher-helper.js b/app/chrome-extension/inject-scripts/web-fetcher-helper.js index 69d16c04..92313742 100644 --- a/app/chrome-extension/inject-scripts/web-fetcher-helper.js +++ b/app/chrome-extension/inject-scripts/web-fetcher-helper.js @@ -2878,6 +2878,32 @@ if (window.__WEB_FETCHER_HELPER_INITIALIZED__) { return allIframeText.trim(); } + /** + * Check if an element is visible in the DOM. + * This mirrors the visibility check used by other helpers. + * @param {Element} el + * @returns {boolean} + */ + function isElementVisible(el) { + if (!el || !el.isConnected) return false; + try { + const style = window.getComputedStyle(el); + if ( + style.display === 'none' || + style.visibility === 'hidden' || + parseFloat(style.opacity) === 0 + ) { + return false; + } + } catch (_) { + // If getComputedStyle fails (e.g., detached node), treat as not visible + return false; + } + + const rect = el.getBoundingClientRect(); + return rect.width > 0 || rect.height > 0 || el.tagName === 'A'; + } + /** * Check if iframe is same origin * @param {HTMLIFrameElement} iframe - The iframe to check diff --git a/app/chrome-extension/package.json b/app/chrome-extension/package.json index bbb9f26f..6796560d 100644 --- a/app/chrome-extension/package.json +++ b/app/chrome-extension/package.json @@ -3,7 +3,7 @@ "description": "a chrome extension to use your own chrome as a mcp server", "author": "hangye", "private": true, - "version": "0.0.6", + "version": "1.0.0", "type": "module", "scripts": { "dev": "wxt", @@ -17,22 +17,39 @@ "lint": "npx eslint .", "lint:fix": "npx eslint . --fix", "format": "npx prettier --write .", - "format:check": "npx prettier --check ." + "format:check": "npx prettier --check .", + "test": "vitest run", + "test:watch": "vitest" }, "dependencies": { "@modelcontextprotocol/sdk": "^1.11.0", + "@vue-flow/background": "^1.3.2", + "@vue-flow/controls": "^1.1.3", + "@vue-flow/core": "^1.47.0", + "@vue-flow/minimap": "^1.5.4", "@xenova/transformers": "^2.17.2", "chrome-mcp-shared": "workspace:*", "date-fns": "^4.1.0", + "elkjs": "^0.11.0", + "gifenc": "^1.0.3", "hnswlib-wasm-static": "0.8.5", + "markstream-vue": "0.0.3-beta.5", "vue": "^3.5.13", "zod": "^3.24.4" }, "devDependencies": { + "@iconify-json/lucide": "^1.1.0", + "@tailwindcss/vite": "^4.0.0", "@types/chrome": "^0.0.318", "@wxt-dev/module-vue": "^1.0.2", "dotenv": "^16.5.0", + "fake-indexeddb": "^6.2.5", + "jsdom": "^26.0.0", + "tailwindcss": "^4.0.0", + "unplugin-icons": "^0.19.0", + "unplugin-vue-components": "^0.27.5", "vite-plugin-static-copy": "^3.0.0", + "vitest": "^2.1.8", "vue-tsc": "^2.2.8", "wxt": "^0.20.0" } diff --git a/app/chrome-extension/public/icon/128.png b/app/chrome-extension/public/icon/128.png index a1ba291e..8addcc36 100644 Binary files a/app/chrome-extension/public/icon/128.png and b/app/chrome-extension/public/icon/128.png differ diff --git a/app/chrome-extension/public/icon/16.png b/app/chrome-extension/public/icon/16.png index a1ba291e..8addcc36 100644 Binary files a/app/chrome-extension/public/icon/16.png and b/app/chrome-extension/public/icon/16.png differ diff --git a/app/chrome-extension/public/icon/32.png b/app/chrome-extension/public/icon/32.png index a1ba291e..8addcc36 100644 Binary files a/app/chrome-extension/public/icon/32.png and b/app/chrome-extension/public/icon/32.png differ diff --git a/app/chrome-extension/public/icon/48.png b/app/chrome-extension/public/icon/48.png index a1ba291e..8addcc36 100644 Binary files a/app/chrome-extension/public/icon/48.png and b/app/chrome-extension/public/icon/48.png differ diff --git a/app/chrome-extension/public/icon/96.png b/app/chrome-extension/public/icon/96.png index a1ba291e..8addcc36 100644 Binary files a/app/chrome-extension/public/icon/96.png and b/app/chrome-extension/public/icon/96.png differ diff --git a/app/chrome-extension/shared/element-picker/controller.ts b/app/chrome-extension/shared/element-picker/controller.ts new file mode 100644 index 00000000..8ba9792f --- /dev/null +++ b/app/chrome-extension/shared/element-picker/controller.ts @@ -0,0 +1,797 @@ +/** + * Element Picker Controller + * + * Creates and manages the Element Picker Panel UI, which displays: + * - List of element requests from the AI + * - Current selection status for each request + * - Countdown timer + * - Cancel/Confirm actions + */ + +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import { + mountQuickPanelShadowHost, + type QuickPanelShadowHostElements, + type QuickPanelShadowHostManager, +} from '@/shared/quick-panel/ui'; +import type { PickedElement } from 'chrome-mcp-shared'; + +// ============================================================ +// Types +// ============================================================ + +export interface ElementPickerControllerOptions { + /** Custom host element ID */ + hostId?: string; + /** Custom z-index */ + zIndex?: number; + /** Called when user clicks Cancel */ + onCancel?: () => void; + /** Called when user clicks Confirm */ + onConfirm?: () => void; + /** Called when user switches to a different request */ + onSetActiveRequest?: (requestId: string) => void; + /** Called when user clears a selection */ + onClearSelection?: (requestId: string) => void; +} + +export interface ElementPickerController { + /** Show the panel with initial state */ + show: (state: ElementPickerUiState) => void; + /** Update the panel state */ + update: (patch: ElementPickerUiPatch) => void; + /** Hide and clean up the panel */ + hide: () => void; + /** Check if the panel is currently visible */ + isVisible: () => boolean; + /** Dispose and clean up all resources */ + dispose: () => void; +} + +export interface ElementPickerUiRequest { + id: string; + name: string; + description?: string; +} + +export interface ElementPickerUiState { + sessionId: string; + requests: ElementPickerUiRequest[]; + activeRequestId: string | null; + selections: Record; + deadlineTs: number; + errorMessage: string | null; +} + +export type ElementPickerUiPatch = Partial> & { + sessionId: string; +}; + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_HOST_ID = '__mcp_element_picker_host__'; +const DEFAULT_Z_INDEX = 2147483647; + +// ============================================================ +// Styles (Quick Panel compatible) +// ============================================================ + +const ELEMENT_PICKER_STYLES = /* css */ ` + /* Overlay positioning - bottom-right corner */ + .ep-overlay { + position: fixed; + inset: 0; + display: flex; + align-items: flex-end; + justify-content: flex-end; + padding: 16px; + pointer-events: none; + } + + /* Panel sizing */ + .ep-panel { + width: min(480px, calc(100vw - 32px)); + max-height: min(600px, calc(100vh - 32px)); + pointer-events: auto; + } + + /* Countdown badge */ + .ep-countdown { + font-family: var(--ac-font-code); + font-size: 12px; + color: var(--ac-text-muted); + padding: 4px 10px; + border-radius: 999px; + border: 1px solid var(--qp-glass-divider); + background: color-mix(in srgb, var(--qp-glass-input-bg) 80%, transparent); + user-select: none; + white-space: nowrap; + } + + .ep-countdown--warning { + color: var(--ac-warning); + border-color: color-mix(in srgb, var(--ac-warning) 40%, var(--qp-glass-divider)); + } + + .ep-countdown--danger { + color: var(--ac-danger); + border-color: color-mix(in srgb, var(--ac-danger) 40%, var(--qp-glass-divider)); + animation: ep-pulse 1s ease-in-out infinite; + } + + @keyframes ep-pulse { + 0%, 100% { opacity: 1; } + 50% { opacity: 0.6; } + } + + /* Hint text */ + .ep-hint { + margin: 0 0 10px 0; + font-size: 12px; + color: var(--ac-text-muted); + } + + /* Error banner */ + .ep-error { + margin: 0 0 10px 0; + padding: 8px 10px; + border-radius: var(--ac-radius-card); + border: 1px solid color-mix(in srgb, var(--ac-danger) 55%, var(--ac-border)); + background: color-mix(in srgb, var(--ac-danger) 10%, transparent); + color: color-mix(in srgb, var(--ac-danger) 85%, var(--ac-text)); + font-size: 12px; + } + + /* Request list */ + .ep-list { + display: flex; + flex-direction: column; + gap: 10px; + } + + /* Request item card */ + .ep-item { + border-radius: var(--ac-radius-card); + border: var(--ac-border-width) solid var(--ac-border); + box-shadow: var(--ac-shadow-card); + background: var(--ac-surface); + padding: 10px 12px; + transition: border-color var(--ac-motion-fast), box-shadow var(--ac-motion-fast); + } + + .ep-item--active { + border-color: color-mix(in srgb, var(--ac-accent) 55%, var(--ac-border)); + box-shadow: + 0 0 0 2px color-mix(in srgb, var(--ac-accent-subtle) 65%, transparent), + var(--ac-shadow-card); + } + + /* Item header */ + .ep-item-header { + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + } + + .ep-item-title { + min-width: 0; + font-weight: 600; + font-size: 13px; + color: var(--ac-text); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + } + + /* Status badge */ + .ep-badge { + flex: none; + font-size: 11px; + padding: 2px 8px; + border-radius: 999px; + border: 1px solid var(--qp-glass-divider); + color: var(--ac-text-muted); + background: color-mix(in srgb, var(--ac-surface-muted) 65%, transparent); + user-select: none; + } + + .ep-badge--selected { + border-color: color-mix(in srgb, var(--ac-success) 55%, var(--qp-glass-divider)); + color: color-mix(in srgb, var(--ac-success) 85%, var(--ac-text)); + background: color-mix(in srgb, var(--ac-success) 10%, transparent); + } + + .ep-badge--picking { + border-color: color-mix(in srgb, var(--ac-accent) 55%, var(--qp-glass-divider)); + color: var(--ac-accent); + background: color-mix(in srgb, var(--ac-accent) 10%, transparent); + animation: ep-pulse 1.5s ease-in-out infinite; + } + + /* Description text */ + .ep-desc { + margin-top: 6px; + font-size: 12px; + color: var(--ac-text-muted); + white-space: pre-wrap; + } + + /* Picked element info */ + .ep-picked { + margin-top: 8px; + font-size: 12px; + color: var(--ac-text); + display: flex; + flex-direction: column; + gap: 4px; + padding: 8px; + border-radius: var(--ac-radius-inner); + background: var(--ac-surface-muted); + } + + .ep-picked-text { + font-weight: 500; + word-break: break-word; + } + + .ep-picked-meta { + display: flex; + flex-wrap: wrap; + gap: 6px; + font-size: 11px; + } + + .ep-picked code { + font-family: var(--ac-font-code); + font-size: 10px; + color: var(--ac-text-muted); + padding: 2px 4px; + border-radius: 4px; + background: rgba(0, 0, 0, 0.05); + word-break: break-all; + } + + /* Action buttons row */ + .ep-actions { + margin-top: 8px; + display: flex; + gap: 8px; + } + + /* Footer */ + .ep-footer { + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + } + + .ep-footer-left { + font-size: 11px; + color: var(--ac-text-muted); + } + + .ep-footer-right { + display: flex; + gap: 8px; + } +`; + +// ============================================================ +// Utility Functions +// ============================================================ + +function formatCountdown(deadlineTs: number): { + text: string; + level: 'normal' | 'warning' | 'danger'; +} { + const remainingMs = Math.max(0, deadlineTs - Date.now()); + const totalSeconds = Math.floor(remainingMs / 1000); + const minutes = Math.floor(totalSeconds / 60); + const seconds = totalSeconds % 60; + const text = `${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`; + + // Warning at 1 minute, danger at 30 seconds + let level: 'normal' | 'warning' | 'danger' = 'normal'; + if (totalSeconds <= 30) { + level = 'danger'; + } else if (totalSeconds <= 60) { + level = 'warning'; + } + + return { text, level }; +} + +function truncate(text: string, max = 80): string { + const t = String(text || '') + .trim() + .replace(/\s+/g, ' '); + if (t.length <= max) return t; + return `${t.slice(0, Math.max(0, max - 1))}...`; +} + +// ============================================================ +// Controller Factory +// ============================================================ + +export function createElementPickerController( + options: ElementPickerControllerOptions = {}, +): ElementPickerController { + let disposed = false; + + let shadowHost: QuickPanelShadowHostManager | null = null; + let elements: QuickPanelShadowHostElements | null = null; + let disposer: Disposer | null = null; + let state: ElementPickerUiState | null = null; + + // DOM refs + let overlayEl: HTMLDivElement | null = null; + let panelEl: HTMLDivElement | null = null; + let countdownEl: HTMLSpanElement | null = null; + let errorEl: HTMLDivElement | null = null; + let listEl: HTMLDivElement | null = null; + let confirmBtn: HTMLButtonElement | null = null; + let cancelBtn: HTMLButtonElement | null = null; + let progressEl: HTMLSpanElement | null = null; + let timerId: ReturnType | null = null; + + // Cached item elements for incremental updates + interface ItemElements { + container: HTMLDivElement; + badge: HTMLDivElement; + pickedContainer: HTMLDivElement | null; + pickBtn: HTMLButtonElement; + clearBtn: HTMLButtonElement; + } + const itemElementsMap = new Map(); + + const hostId = options.hostId ?? DEFAULT_HOST_ID; + const zIndex = options.zIndex ?? DEFAULT_Z_INDEX; + + function ensureMounted(): void { + if (shadowHost && elements) return; + + shadowHost = mountQuickPanelShadowHost({ hostId, zIndex }); + elements = shadowHost.getElements(); + if (!elements) throw new Error('Failed to mount Element Picker shadow host'); + + const localDisposer = new Disposer(); + disposer = localDisposer; + + // Inject local styles + const styleEl = document.createElement('style'); + styleEl.textContent = ELEMENT_PICKER_STYLES; + elements.shadowRoot.append(styleEl); + localDisposer.add(() => styleEl.remove()); + + // Build UI structure + overlayEl = document.createElement('div'); + overlayEl.className = 'ep-overlay'; + + panelEl = document.createElement('div'); + panelEl.className = 'qp-panel qp-liquid-shimmer ep-panel'; + panelEl.setAttribute('role', 'dialog'); + panelEl.setAttribute('aria-modal', 'false'); + panelEl.setAttribute('aria-label', 'Element Picker'); + + // Header + const headerEl = document.createElement('div'); + headerEl.className = 'qp-header'; + + const headerLeft = document.createElement('div'); + headerLeft.className = 'qp-header-left'; + + const brand = document.createElement('div'); + brand.className = 'qp-brand'; + brand.textContent = '\u{1F446}'; // Pointing up emoji + + const title = document.createElement('div'); + title.className = 'qp-title'; + + const titleName = document.createElement('div'); + titleName.className = 'qp-title-name'; + titleName.textContent = 'Element Picker'; + + const titleSub = document.createElement('div'); + titleSub.className = 'qp-title-sub'; + titleSub.textContent = 'Click on the requested elements'; + + title.append(titleName, titleSub); + headerLeft.append(brand, title); + + const headerRight = document.createElement('div'); + headerRight.className = 'qp-header-right'; + + countdownEl = document.createElement('span'); + countdownEl.className = 'ep-countdown'; + countdownEl.textContent = '03:00'; + + headerRight.append(countdownEl); + headerEl.append(headerLeft, headerRight); + + // Content + const contentEl = document.createElement('div'); + contentEl.className = 'qp-content ac-scroll'; + + const hintEl = document.createElement('div'); + hintEl.className = 'ep-hint'; + hintEl.textContent = 'Click on each element the AI needs. Press Esc to cancel.'; + + errorEl = document.createElement('div'); + errorEl.className = 'ep-error'; + errorEl.hidden = true; + + listEl = document.createElement('div'); + listEl.className = 'ep-list'; + + contentEl.append(hintEl, errorEl, listEl); + + // Footer + const footerEl = document.createElement('div'); + footerEl.className = 'qp-composer'; + + const footerInner = document.createElement('div'); + footerInner.className = 'ep-footer'; + + const footerLeft = document.createElement('div'); + footerLeft.className = 'ep-footer-left'; + + progressEl = document.createElement('span'); + progressEl.textContent = '0/0 selected'; + footerLeft.append(progressEl); + + const footerRight = document.createElement('div'); + footerRight.className = 'ep-footer-right'; + + cancelBtn = document.createElement('button'); + cancelBtn.type = 'button'; + cancelBtn.className = 'qp-btn ac-btn ac-focus-ring'; + cancelBtn.textContent = 'Cancel'; + + confirmBtn = document.createElement('button'); + confirmBtn.type = 'button'; + confirmBtn.className = 'qp-btn ac-btn ac-focus-ring qp-btn--primary'; + confirmBtn.textContent = 'Confirm'; + + footerRight.append(cancelBtn, confirmBtn); + footerInner.append(footerLeft, footerRight); + footerEl.append(footerInner); + + panelEl.append(headerEl, contentEl, footerEl); + overlayEl.append(panelEl); + elements.root.append(overlayEl); + localDisposer.add(() => overlayEl?.remove()); + + // Event listeners + localDisposer.listen(cancelBtn, 'click', () => options.onCancel?.()); + localDisposer.listen(confirmBtn, 'click', () => options.onConfirm?.()); + + // Esc key to cancel - use capture phase on shadowRoot to intercept before Quick Panel stops propagation + const handleEscKey = (e: Event) => { + if (e instanceof KeyboardEvent && e.key === 'Escape') { + e.preventDefault(); + e.stopPropagation(); + options.onCancel?.(); + } + }; + elements.shadowRoot.addEventListener('keydown', handleEscKey, { capture: true }); + localDisposer.add(() => + elements?.shadowRoot.removeEventListener('keydown', handleEscKey, { capture: true }), + ); + } + + function clearTimer(): void { + if (timerId !== null) { + clearInterval(timerId); + timerId = null; + } + } + + /** + * Render only the countdown timer (called frequently by interval). + */ + function renderCountdown(): void { + if (!state || !countdownEl) return; + const countdown = formatCountdown(state.deadlineTs); + countdownEl.textContent = countdown.text; + countdownEl.className = `ep-countdown${countdown.level !== 'normal' ? ` ep-countdown--${countdown.level}` : ''}`; + } + + /** + * Create a picked element info container. + */ + function createPickedInfoEl(picked: PickedElement): HTMLDivElement { + const pickedEl = document.createElement('div'); + pickedEl.className = 'ep-picked'; + + if (picked.text) { + const textEl = document.createElement('div'); + textEl.className = 'ep-picked-text'; + textEl.textContent = `"${truncate(picked.text, 80)}"`; + pickedEl.append(textEl); + } + + const metaEl = document.createElement('div'); + metaEl.className = 'ep-picked-meta'; + + const tagCode = document.createElement('code'); + tagCode.textContent = picked.tagName || 'element'; + metaEl.append(tagCode); + + const refCode = document.createElement('code'); + refCode.textContent = `ref=${picked.ref}`; + metaEl.append(refCode); + + if (picked.frameId > 0) { + const frameCode = document.createElement('code'); + frameCode.textContent = `frame=${picked.frameId}`; + metaEl.append(frameCode); + } + + pickedEl.append(metaEl); + + const selectorEl = document.createElement('div'); + const selectorCode = document.createElement('code'); + selectorCode.textContent = truncate(picked.selector || '', 100); + selectorEl.append(selectorCode); + pickedEl.append(selectorEl); + + return pickedEl; + } + + /** + * Create a single request item element. + */ + function createItemEl(req: ElementPickerUiRequest): ItemElements { + const item = document.createElement('div'); + item.className = 'ep-item'; + item.dataset.requestId = req.id; + + // Header row + const header = document.createElement('div'); + header.className = 'ep-item-header'; + + const titleEl = document.createElement('div'); + titleEl.className = 'ep-item-title'; + titleEl.textContent = req.name; + + const badge = document.createElement('div'); + badge.className = 'ep-badge'; + badge.textContent = 'Pending'; + + header.append(titleEl, badge); + item.append(header); + + // Description (static, only added once) + if (req.description) { + const desc = document.createElement('div'); + desc.className = 'ep-desc'; + desc.textContent = req.description; + item.append(desc); + } + + // Action buttons + const actions = document.createElement('div'); + actions.className = 'ep-actions'; + + const pickBtn = document.createElement('button'); + pickBtn.type = 'button'; + pickBtn.className = 'qp-btn ac-btn ac-focus-ring'; + pickBtn.textContent = 'Pick'; + pickBtn.addEventListener('click', () => options.onSetActiveRequest?.(req.id)); + + const clearBtn = document.createElement('button'); + clearBtn.type = 'button'; + clearBtn.className = 'qp-btn ac-btn ac-focus-ring'; + clearBtn.textContent = 'Clear'; + clearBtn.disabled = true; + clearBtn.addEventListener('click', () => options.onClearSelection?.(req.id)); + + actions.append(pickBtn, clearBtn); + item.append(actions); + + return { container: item, badge, pickedContainer: null, pickBtn, clearBtn }; + } + + /** + * Update a single item's display state. + */ + function updateItemEl( + itemEls: ItemElements, + req: ElementPickerUiRequest, + picked: PickedElement | null, + isActive: boolean, + ): void { + const { container, badge, pickBtn, clearBtn } = itemEls; + + // Update active state + container.classList.toggle('ep-item--active', isActive); + + // Update badge + if (picked) { + badge.className = 'ep-badge ep-badge--selected'; + badge.textContent = 'Selected'; + } else if (isActive) { + badge.className = 'ep-badge ep-badge--picking'; + badge.textContent = 'Picking...'; + } else { + badge.className = 'ep-badge'; + badge.textContent = 'Pending'; + } + + // Update pick button + pickBtn.textContent = isActive ? 'Picking...' : 'Pick'; + pickBtn.disabled = isActive; + + // Update clear button + clearBtn.disabled = !picked; + + // Handle picked info container + const actionsEl = container.querySelector('.ep-actions'); + if (picked) { + if (!itemEls.pickedContainer) { + // Create and insert picked info before actions + const pickedEl = createPickedInfoEl(picked); + actionsEl?.parentNode?.insertBefore(pickedEl, actionsEl); + itemEls.pickedContainer = pickedEl; + } else { + // Update existing picked info + const newPickedEl = createPickedInfoEl(picked); + itemEls.pickedContainer.replaceWith(newPickedEl); + itemEls.pickedContainer = newPickedEl; + } + } else if (itemEls.pickedContainer) { + // Remove picked info + itemEls.pickedContainer.remove(); + itemEls.pickedContainer = null; + } + } + + /** + * Build the list initially or rebuild if requests changed. + */ + function buildList(): void { + if (!state || !listEl) return; + + // Clear existing items and cache + listEl.innerHTML = ''; + itemElementsMap.clear(); + + for (const req of state.requests) { + const itemEls = createItemEl(req); + itemElementsMap.set(req.id, itemEls); + listEl.append(itemEls.container); + } + } + + /** + * Full render - updates all dynamic parts. + */ + function render(): void { + if (!state || !listEl || !countdownEl || !confirmBtn || !errorEl || !progressEl) return; + + // Countdown (always update) + renderCountdown(); + + // Error banner + const err = state.errorMessage ? state.errorMessage.trim() : ''; + if (err) { + errorEl.hidden = false; + errorEl.textContent = err; + } else { + errorEl.hidden = true; + errorEl.textContent = ''; + } + + // Rebuild list if requests changed (rare case) + const needsRebuild = + itemElementsMap.size !== state.requests.length || + state.requests.some((r) => !itemElementsMap.has(r.id)); + if (needsRebuild) { + buildList(); + } + + // Count selected and update items + let selectedCount = 0; + for (const req of state.requests) { + const picked = state.selections[req.id] || null; + const isActive = state.activeRequestId === req.id; + if (picked) selectedCount++; + + const itemEls = itemElementsMap.get(req.id); + if (itemEls) { + updateItemEl(itemEls, req, picked, isActive); + } + } + + // Progress text + progressEl.textContent = `${selectedCount}/${state.requests.length} selected`; + + // Confirm button state + const allSelected = selectedCount === state.requests.length; + confirmBtn.disabled = !allSelected; + confirmBtn.textContent = allSelected + ? 'Confirm' + : `Confirm (${selectedCount}/${state.requests.length})`; + } + + function show(next: ElementPickerUiState): void { + if (disposed) return; + ensureMounted(); + + state = next; + render(); + + clearTimer(); + // Timer only updates countdown, not the full list + timerId = setInterval(() => { + if (disposed || !state) return; + renderCountdown(); + }, 250); + } + + function update(patch: ElementPickerUiPatch): void { + if (disposed) return; + if (!state || state.sessionId !== patch.sessionId) { + // If we don't have matching state yet, ignore update + return; + } + + state = { + ...state, + ...patch, + sessionId: state.sessionId, // Keep stable + requests: patch.requests ?? state.requests, + activeRequestId: patch.activeRequestId ?? state.activeRequestId, + selections: patch.selections ?? state.selections, + deadlineTs: patch.deadlineTs ?? state.deadlineTs, + errorMessage: patch.errorMessage ?? state.errorMessage, + }; + render(); + } + + function hide(): void { + clearTimer(); + state = null; + itemElementsMap.clear(); + + try { + disposer?.dispose(); + } finally { + disposer = null; + } + + overlayEl = null; + panelEl = null; + countdownEl = null; + errorEl = null; + listEl = null; + confirmBtn = null; + cancelBtn = null; + progressEl = null; + + try { + shadowHost?.dispose(); + } finally { + shadowHost = null; + elements = null; + } + } + + function dispose(): void { + if (disposed) return; + disposed = true; + hide(); + } + + return { + show, + update, + hide, + isVisible: () => !!shadowHost && !!elements, + dispose, + }; +} diff --git a/app/chrome-extension/shared/element-picker/index.ts b/app/chrome-extension/shared/element-picker/index.ts new file mode 100644 index 00000000..08d17f83 --- /dev/null +++ b/app/chrome-extension/shared/element-picker/index.ts @@ -0,0 +1,14 @@ +/** + * Element Picker (UI) + * + * A Quick Panel-styled floating panel used by chrome_request_element_selection. + */ + +export { createElementPickerController } from './controller'; +export type { + ElementPickerController, + ElementPickerControllerOptions, + ElementPickerUiState, + ElementPickerUiRequest, + ElementPickerUiPatch, +} from './controller'; diff --git a/app/chrome-extension/shared/quick-panel/core/agent-bridge.ts b/app/chrome-extension/shared/quick-panel/core/agent-bridge.ts new file mode 100644 index 00000000..c1f4fd66 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/core/agent-bridge.ts @@ -0,0 +1,400 @@ +/** + * Quick Panel Agent Bridge + * + * Client-side bridge for Quick Panel (content script) to communicate with + * the background agent handler. Provides a clean API for sending messages + * to AI and receiving streaming responses. + * + * Features: + * - Event buffering for handling race conditions + * - Request lifecycle management + * - Memory-bounded event storage + * - Automatic cleanup on terminal events + * + * @example + * ```typescript + * const bridge = new QuickPanelAgentBridge(); + * + * // Send a message and subscribe to events + * const result = await bridge.sendToAI({ instruction: 'Hello' }); + * if (result.success) { + * const unsubscribe = bridge.onRequestEvent(result.requestId, (event) => { + * console.log('Received event:', event); + * }); + * } + * + * // Cleanup when done + * bridge.dispose(); + * ``` + */ + +import type { RealtimeEvent } from 'chrome-mcp-shared'; + +import { + BACKGROUND_MESSAGE_TYPES, + TOOL_MESSAGE_TYPES, + type QuickPanelAIEventMessage, + type QuickPanelCancelAIResponse, + type QuickPanelSendToAIPayload, + type QuickPanelSendToAIResponse, +} from '@/common/message-types'; + +// ============================================================ +// Types +// ============================================================ + +/** + * Callback function for receiving RealtimeEvents. + */ +export type RequestEventListener = (event: RealtimeEvent) => void; + +/** + * Configuration options for the agent bridge. + */ +export interface AgentBridgeOptions { + /** Maximum number of events to buffer per request (default: 200) */ + maxBufferedEvents?: number; +} + +// ============================================================ +// Constants +// ============================================================ + +const LOG_PREFIX = '[QuickPanelAgentBridge]'; +const DEFAULT_MAX_BUFFERED_EVENTS = 200; + +/** Delay before cleaning up request state after terminal event (allows late subscribers) */ +const TERMINAL_CLEANUP_DELAY_MS = 30000; + +// ============================================================ +// Implementation +// ============================================================ + +/** + * Bridge for Quick Panel to communicate with the background agent handler. + * + * Responsibilities: + * 1. Send instructions to AI via background + * 2. Receive and dispatch streaming events + * 3. Buffer events for late-subscribing listeners + * 4. Manage request lifecycle and cleanup + */ +export class QuickPanelAgentBridge { + /** Listeners organized by requestId */ + private readonly listenersByRequestId = new Map>(); + + /** Event buffer for handling race conditions where events arrive before listeners */ + private readonly bufferByRequestId = new Map(); + + /** Pending cleanup timers for delayed terminal cleanup */ + private readonly cleanupTimers = new Map>(); + + /** Maximum events to buffer per request */ + private readonly maxBufferedEvents: number; + + /** Message handler bound to this instance */ + private readonly boundMessageHandler: (message: unknown) => void; + + /** Disposed state flag */ + private disposed = false; + + constructor(options?: AgentBridgeOptions) { + this.maxBufferedEvents = options?.maxBufferedEvents ?? DEFAULT_MAX_BUFFERED_EVENTS; + this.boundMessageHandler = this.handleMessage.bind(this); + + // Register message listener + chrome.runtime.onMessage.addListener(this.boundMessageHandler); + } + + /** + * Clean up all resources and unregister listeners. + * Should be called when Quick Panel is closing. + */ + dispose(): void { + if (this.disposed) return; + this.disposed = true; + + chrome.runtime.onMessage.removeListener(this.boundMessageHandler); + this.listenersByRequestId.clear(); + this.bufferByRequestId.clear(); + + // Clear all pending cleanup timers + for (const timer of this.cleanupTimers.values()) { + clearTimeout(timer); + } + this.cleanupTimers.clear(); + } + + /** + * Check if the bridge has been disposed. + */ + isDisposed(): boolean { + return this.disposed; + } + + /** + * Subscribe to RealtimeEvents for a specific requestId. + * + * @param requestId - The request ID to subscribe to + * @param listener - Callback function for events + * @returns Unsubscribe function + * + * @remarks + * Events that arrived before subscription are flushed immediately. + * This handles the race condition where background sends events + * before the UI has finished setting up listeners. + */ + onRequestEvent(requestId: string, listener: RequestEventListener): () => void { + if (this.disposed) { + console.warn(`${LOG_PREFIX} Cannot subscribe - bridge is disposed`); + return () => {}; + } + + const id = requestId.trim(); + if (!id) { + console.warn(`${LOG_PREFIX} Invalid requestId`); + return () => {}; + } + + // Add listener to set + let listeners = this.listenersByRequestId.get(id); + if (!listeners) { + listeners = new Set(); + this.listenersByRequestId.set(id, listeners); + } + listeners.add(listener); + + // Flush any buffered events to this listener + const buffer = this.bufferByRequestId.get(id); + if (buffer && buffer.length > 0) { + for (const event of buffer) { + this.safeInvokeListener(listener, event); + } + // Clear buffer after flushing + this.bufferByRequestId.delete(id); + } + + // Return unsubscribe function + return () => { + const set = this.listenersByRequestId.get(id); + if (!set) return; + + set.delete(listener); + if (set.size === 0) { + this.listenersByRequestId.delete(id); + } + }; + } + + /** + * Send a new instruction to the selected AgentChat session. + * + * The background layer will: + * 1. Read the selected session ID + * 2. Open SSE subscription + * 3. POST /act to start the request + * 4. Stream events back via QUICK_PANEL_AI_EVENT + * + * @param payload - The instruction and optional context + * @returns Promise resolving to success with requestId/sessionId, or failure with error + */ + async sendToAI(payload: QuickPanelSendToAIPayload): Promise { + if (this.disposed) { + return { success: false, error: 'Bridge is disposed' }; + } + + try { + const response = await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_SEND_TO_AI, + payload, + }); + + return response as QuickPanelSendToAIResponse; + } catch (err) { + const msg = err instanceof Error ? err.message : String(err); + return { success: false, error: msg || 'Failed to send message' }; + } + } + + /** + * Cancel an active AI request. + * + * @param requestId - The request ID to cancel + * @param sessionId - Optional session ID for fallback (useful if background state was lost) + * @returns Promise resolving to success or failure + * + * @remarks + * Prefer passing sessionId when available for resilience against + * MV3 Service Worker restarts that may clear background state. + */ + async cancelRequest(requestId: string, sessionId?: string): Promise { + if (this.disposed) { + return { success: false, error: 'Bridge is disposed' }; + } + + try { + const response = await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_CANCEL_AI, + payload: { requestId, sessionId }, + }); + + return response as QuickPanelCancelAIResponse; + } catch (err) { + const msg = err instanceof Error ? err.message : String(err); + return { success: false, error: msg || 'Failed to cancel request' }; + } + } + + /** + * Check if there are active listeners for a request. + * Useful for determining if UI is still interested in events. + */ + hasListeners(requestId: string): boolean { + const listeners = this.listenersByRequestId.get(requestId); + return listeners !== undefined && listeners.size > 0; + } + + /** + * Get the number of active requests being tracked. + * Useful for debugging and monitoring. + */ + getActiveRequestCount(): number { + return this.listenersByRequestId.size + this.bufferByRequestId.size; + } + + // ============================================================ + // Private Methods + // ============================================================ + + /** + * Handle incoming messages from background. + */ + private handleMessage(message: unknown): void { + if (this.disposed) return; + + const msg = message as Partial | undefined; + if (!msg || msg.action !== TOOL_MESSAGE_TYPES.QUICK_PANEL_AI_EVENT) { + return; + } + + const requestId = typeof msg.requestId === 'string' ? msg.requestId : ''; + const event = msg.event as RealtimeEvent | undefined; + + if (!requestId || !event) return; + + // Dispatch to listeners or buffer + const listeners = this.listenersByRequestId.get(requestId); + if (listeners && listeners.size > 0) { + for (const listener of listeners) { + this.safeInvokeListener(listener, event); + } + } else { + // No listeners yet - buffer the event + this.bufferEvent(requestId, event); + } + + // Schedule delayed cleanup on terminal status + // This allows late subscribers to still receive the final state + if (this.isTerminalEvent(event, requestId)) { + this.scheduleDelayedCleanup(requestId); + } + } + + /** + * Safely invoke a listener, catching and logging any errors. + */ + private safeInvokeListener(listener: RequestEventListener, event: RealtimeEvent): void { + try { + listener(event); + } catch (err) { + console.warn(`${LOG_PREFIX} Listener error:`, err); + } + } + + /** + * Buffer an event for a request that doesn't have listeners yet. + */ + private bufferEvent(requestId: string, event: RealtimeEvent): void { + let buffer = this.bufferByRequestId.get(requestId); + if (!buffer) { + buffer = []; + this.bufferByRequestId.set(requestId, buffer); + } + + buffer.push(event); + + // Bound memory by removing oldest events + if (buffer.length > this.maxBufferedEvents) { + buffer.splice(0, buffer.length - this.maxBufferedEvents); + } + } + + /** + * Check if an event represents a terminal state for the request. + * + * Terminal events include: + * - status events with terminal status (completed, error, cancelled) + * - error events (type: 'error') + */ + private isTerminalEvent(event: RealtimeEvent, requestId: string): boolean { + // Error events are always terminal + if (event.type === 'error') { + return true; + } + + // Status events with terminal status + if (event.type === 'status') { + const data = event.data; + if (data?.requestId !== requestId) return false; + + const status = data.status; + return status === 'completed' || status === 'error' || status === 'cancelled'; + } + + return false; + } + + /** + * Clean up all state associated with a request. + * Called after delay to allow late subscribers to receive terminal events. + */ + private cleanupRequest(requestId: string): void { + // Clear any pending timer first + const existingTimer = this.cleanupTimers.get(requestId); + if (existingTimer) { + clearTimeout(existingTimer); + this.cleanupTimers.delete(requestId); + } + + this.bufferByRequestId.delete(requestId); + this.listenersByRequestId.delete(requestId); + } + + /** + * Schedule delayed cleanup for a request after terminal event. + * This allows late subscribers to still receive the terminal event. + */ + private scheduleDelayedCleanup(requestId: string): void { + // Don't schedule if already scheduled + if (this.cleanupTimers.has(requestId)) return; + + const timer = setTimeout(() => { + this.cleanupTimers.delete(requestId); + this.cleanupRequest(requestId); + }, TERMINAL_CLEANUP_DELAY_MS); + + this.cleanupTimers.set(requestId, timer); + } +} + +// ============================================================ +// Singleton Export (Optional) +// ============================================================ + +/** + * Create a new agent bridge instance. + * Prefer creating a single instance per Quick Panel lifecycle. + */ +export function createAgentBridge(options?: AgentBridgeOptions): QuickPanelAgentBridge { + return new QuickPanelAgentBridge(options); +} diff --git a/app/chrome-extension/shared/quick-panel/core/search-engine.ts b/app/chrome-extension/shared/quick-panel/core/search-engine.ts new file mode 100644 index 00000000..2e2cb236 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/core/search-engine.ts @@ -0,0 +1,598 @@ +/** + * Quick Panel Search Engine + * + * Aggregates results from multiple SearchProviders. + * + * Responsibilities: + * - Provider registry (add/remove/list) + * - Scope-based provider selection (including "all") + * - Result aggregation + sorting + caps + * - Debounced scheduling with cancellation + * - Short-lived LRU caching to avoid repeat work + */ + +import LRUCache from '@/utils/lru-cache'; +import { + normalizeQuickPanelScope, + normalizeSearchQuery, + type QuickPanelScope, + type SearchProvider, + type SearchProviderContext, + type SearchQuery, + type SearchResult, +} from './types'; + +// ============================================================ +// Types +// ============================================================ + +export interface SearchEngineOptions { + /** Initial providers to register */ + providers?: readonly SearchProvider[]; + /** Debounce delay in ms. Default: 120 */ + debounceMs?: number; + /** Cache size. Default: 200 */ + cacheSize?: number; + /** Cache TTL in ms. Default: 2000 */ + cacheTtlMs?: number; + /** Per-provider result limit. Default: 8 */ + perProviderLimit?: number; + /** Total result limit. Default: 20 */ + totalLimit?: number; +} + +export interface SearchEngineRequest { + scope: QuickPanelScope; + query: string; + limit?: number; +} + +export interface SearchProviderError { + providerId: string; + error: string; +} + +export interface SearchEngineResponse { + /** Unique request identifier */ + requestId: number; + /** Original request parameters */ + request: { + scope: QuickPanelScope; + query: SearchQuery; + limit: number; + }; + /** Aggregated and sorted results */ + results: SearchResult[]; + /** Errors from individual providers */ + providerErrors: SearchProviderError[]; + /** Whether the request was cancelled */ + cancelled: boolean; + /** Whether results came from cache */ + fromCache: boolean; + /** Time elapsed in ms */ + elapsedMs: number; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_DEBOUNCE_MS = 120; +const DEFAULT_CACHE_SIZE = 200; +const DEFAULT_CACHE_TTL_MS = 2000; +const DEFAULT_PER_PROVIDER_LIMIT = 8; +const DEFAULT_TOTAL_LIMIT = 20; + +// ============================================================ +// Helpers +// ============================================================ + +interface CacheEntry { + createdAt: number; + response: SearchEngineResponse; +} + +function normalizeInt(value: unknown, fallback: number): number { + const num = typeof value === 'number' ? value : Number.NaN; + if (!Number.isFinite(num)) return fallback; + return Math.max(0, Math.floor(num)); +} + +function safeErrorMessage(err: unknown): string { + if (err instanceof Error) return err.message || String(err); + return String(err); +} + +function coerceScore(value: unknown): number { + const num = typeof value === 'number' ? value : Number(value); + return Number.isFinite(num) ? num : 0; +} + +// ============================================================ +// SearchEngine Class +// ============================================================ + +export class SearchEngine { + private readonly providersById = new Map(); + private readonly cache: LRUCache; + + private readonly debounceMs: number; + private readonly cacheTtlMs: number; + private readonly perProviderLimit: number; + private readonly totalLimit: number; + + private disposed = false; + private seq = 0; + private latestRequestId = 0; + private activeAbort: AbortController | null = null; + + private scheduled: { + requestId: number; + request: SearchEngineRequest; + abort: AbortController; + timer: ReturnType; + resolve: (value: SearchEngineResponse) => void; + } | null = null; + + constructor(options: SearchEngineOptions = {}) { + this.debounceMs = normalizeInt(options.debounceMs, DEFAULT_DEBOUNCE_MS); + this.cacheTtlMs = normalizeInt(options.cacheTtlMs, DEFAULT_CACHE_TTL_MS); + this.perProviderLimit = normalizeInt(options.perProviderLimit, DEFAULT_PER_PROVIDER_LIMIT); + this.totalLimit = normalizeInt(options.totalLimit, DEFAULT_TOTAL_LIMIT); + this.cache = new LRUCache( + normalizeInt(options.cacheSize, DEFAULT_CACHE_SIZE), + ); + + // Register initial providers + for (const provider of options.providers ?? []) { + this.registerProvider(provider); + } + } + + // -------------------------------------------------------- + // Provider Management + // -------------------------------------------------------- + + /** + * Register a search provider. + * If a provider with the same ID exists, it will be replaced. + */ + registerProvider(provider: SearchProvider): void { + if (this.disposed) return; + + const id = String(provider?.id ?? '').trim(); + if (!id) return; + + // Dispose existing provider with same ID + const existing = this.providersById.get(id); + if (existing && existing !== provider) { + try { + existing.dispose?.(); + } catch { + // Best-effort + } + } + + this.providersById.set(id, provider); + // Clear cache when providers change + this.cache.clear(); + } + + /** + * Unregister a provider by ID. + */ + unregisterProvider(providerId: string): void { + if (this.disposed) return; + + const id = String(providerId ?? '').trim(); + if (!id) return; + + const existing = this.providersById.get(id); + if (!existing) return; + + this.providersById.delete(id); + this.cache.clear(); + + try { + existing.dispose?.(); + } catch { + // Best-effort + } + } + + /** + * List all registered providers. + */ + listProviders(): SearchProvider[] { + return [...this.providersById.values()]; + } + + // -------------------------------------------------------- + // Lifecycle + // -------------------------------------------------------- + + /** + * Dispose the engine and all providers. + */ + dispose(): void { + if (this.disposed) return; + this.disposed = true; + + // Cancel scheduled search + if (this.scheduled) { + clearTimeout(this.scheduled.timer); + this.scheduled.abort.abort(); + this.scheduled.resolve( + this.createCancelledResponse(this.scheduled.requestId, this.scheduled.request), + ); + this.scheduled = null; + } + + // Cancel active search + if (this.activeAbort) { + this.activeAbort.abort(); + this.activeAbort = null; + } + + // Dispose all providers + for (const provider of this.providersById.values()) { + try { + provider.dispose?.(); + } catch { + // Best-effort + } + } + + this.providersById.clear(); + this.cache.clear(); + } + + /** + * Cancel any active or scheduled search. + */ + cancelActive(): void { + if (this.scheduled) { + clearTimeout(this.scheduled.timer); + this.scheduled.abort.abort(); + this.scheduled.resolve( + this.createCancelledResponse(this.scheduled.requestId, this.scheduled.request), + ); + this.scheduled = null; + } + this.activeAbort?.abort(); + } + + // -------------------------------------------------------- + // Search Methods + // -------------------------------------------------------- + + /** + * Schedule a search with debouncing. + * Cancels any pending search and returns the result after the debounce delay. + */ + schedule(request: SearchEngineRequest): Promise { + if (this.disposed) { + return Promise.resolve(this.createCancelledResponse(0, request)); + } + + // Cancel any pending scheduled search + if (this.scheduled) { + clearTimeout(this.scheduled.timer); + this.scheduled.abort.abort(); + this.scheduled.resolve( + this.createCancelledResponse(this.scheduled.requestId, this.scheduled.request), + ); + this.scheduled = null; + } + + // Cancel any active search + if (this.activeAbort) { + this.activeAbort.abort(); + this.activeAbort = null; + } + + const requestId = ++this.seq; + this.latestRequestId = requestId; + const abort = new AbortController(); + + return new Promise((resolve) => { + const timer = setTimeout(() => { + this.scheduled = null; + this.activeAbort = abort; + + void this.execute(requestId, request, abort.signal) + .then(resolve) + .catch((err) => { + resolve(this.createEngineErrorResponse(requestId, request, abort.signal, err)); + }); + }, this.debounceMs); + + this.scheduled = { requestId, request, abort, timer, resolve }; + }); + } + + /** + * Execute a search immediately without debouncing. + * Cancels any pending or active search. + */ + async search(request: SearchEngineRequest): Promise { + if (this.disposed) { + return this.createCancelledResponse(0, request); + } + + // Cancel scheduled search + if (this.scheduled) { + clearTimeout(this.scheduled.timer); + this.scheduled.abort.abort(); + this.scheduled.resolve( + this.createCancelledResponse(this.scheduled.requestId, this.scheduled.request), + ); + this.scheduled = null; + } + + // Cancel active search + if (this.activeAbort) { + this.activeAbort.abort(); + this.activeAbort = null; + } + + const requestId = ++this.seq; + this.latestRequestId = requestId; + const abort = new AbortController(); + this.activeAbort = abort; + + try { + return await this.execute(requestId, request, abort.signal); + } catch (err) { + return this.createEngineErrorResponse(requestId, request, abort.signal, err); + } + } + + // -------------------------------------------------------- + // Internal Methods + // -------------------------------------------------------- + + private createCancelledResponse( + requestId: number, + request: SearchEngineRequest, + ): SearchEngineResponse { + const scope = normalizeQuickPanelScope(request?.scope); + const query = normalizeSearchQuery(request?.query ?? ''); + const limit = normalizeInt(request?.limit, this.totalLimit); + + return { + requestId, + request: { scope, query, limit }, + results: [], + providerErrors: [], + cancelled: true, + fromCache: false, + elapsedMs: 0, + }; + } + + private createEngineErrorResponse( + requestId: number, + request: SearchEngineRequest, + signal: AbortSignal, + err: unknown, + ): SearchEngineResponse { + const scope = normalizeQuickPanelScope(request?.scope); + const query = normalizeSearchQuery(request?.query ?? ''); + const limit = normalizeInt(request?.limit, this.totalLimit); + const cancelled = signal.aborted || requestId !== this.latestRequestId; + + return { + requestId, + request: { scope, query, limit }, + results: [], + providerErrors: [{ providerId: 'engine', error: safeErrorMessage(err) }], + cancelled, + fromCache: false, + elapsedMs: 0, + }; + } + + /** + * Get providers that should handle the given scope. + */ + private getProvidersForScope(scope: QuickPanelScope): SearchProvider[] { + const providers = [...this.providersById.values()]; + + if (scope === 'all') { + // Include providers that opt into 'all' meta-scope + return providers.filter((p) => (p.includeInAll ?? true) === true); + } + + // Match providers that explicitly list this scope + return providers.filter((p) => Array.isArray(p.scopes) && p.scopes.includes(scope)); + } + + /** + * Build cache key from request parameters. + */ + private buildCacheKey( + scope: QuickPanelScope, + query: SearchQuery, + limit: number, + providers: SearchProvider[], + ): string { + const providerSig = providers + .map((p) => p.id) + .filter(Boolean) + .sort() + .join(','); + return `${scope}::${query.text}::${limit}::${providerSig}`; + } + + /** + * Try to get a valid cached response. + */ + private tryGetCached(key: string, now: number): SearchEngineResponse | null { + if (this.cacheTtlMs <= 0) return null; + + const entry = this.cache.get(key); + if (!entry) return null; + if (now - entry.createdAt > this.cacheTtlMs) return null; + + return entry.response; + } + + /** + * Store a response in the cache. + */ + private setCached(key: string, response: SearchEngineResponse): void { + if (this.cacheTtlMs <= 0) return; + this.cache.set(key, { createdAt: Date.now(), response }); + } + + /** + * Execute the search against matching providers. + */ + private async execute( + requestId: number, + request: SearchEngineRequest, + signal: AbortSignal, + ): Promise { + const startedAt = Date.now(); + + const scope = normalizeQuickPanelScope(request?.scope); + const query = normalizeSearchQuery(request?.query ?? ''); + const limit = normalizeInt(request?.limit, this.totalLimit); + + const providers = this.getProvidersForScope(scope); + const cacheKey = this.buildCacheKey(scope, query, limit, providers); + + // Try cache first + const cached = this.tryGetCached(cacheKey, startedAt); + if (cached) { + return { + ...cached, + requestId, + request: { scope, query, limit }, + cancelled: signal.aborted || requestId !== this.latestRequestId, + fromCache: true, + elapsedMs: Date.now() - startedAt, + }; + } + + // Filter providers based on empty query support + const eligibleProviders = + query.text.length === 0 ? providers.filter((p) => p.supportsEmptyQuery === true) : providers; + + // Build priority map for tie-breaking + const priorityById = new Map(); + for (const p of eligibleProviders) { + priorityById.set(p.id, typeof p.priority === 'number' ? p.priority : 0); + } + + const providerErrors: SearchProviderError[] = []; + const results: SearchResult[] = []; + + const perProviderCap = Math.min(limit, this.perProviderLimit); + const now = startedAt; + + // Execute all providers in parallel + const outcomes = await Promise.all( + eligibleProviders.map(async (provider) => { + if (signal.aborted) { + return { + provider, + results: [] as SearchResult[], + error: undefined as string | undefined, + }; + } + + // Calculate provider-specific limit + const providerMax = + typeof provider.maxResults === 'number' && Number.isFinite(provider.maxResults) + ? Math.max(0, Math.floor(provider.maxResults)) + : perProviderCap; + const providerLimit = Math.min(perProviderCap, providerMax); + + const ctx: SearchProviderContext = { + requestedScope: scope, + query, + limit: providerLimit, + signal, + now, + }; + + try { + const providerResults = await provider.search(ctx); + const safeList = Array.isArray(providerResults) ? providerResults : []; + + // Normalize results + const normalized = safeList.slice(0, providerLimit).map((item, index) => { + const id = + typeof item?.id === 'string' && item.id ? item.id : `${provider.id}_${index}`; + return { + ...(item as SearchResult), + id, + provider: provider.id, + score: coerceScore((item as SearchResult).score), + }; + }); + + return { provider, results: normalized, error: undefined as string | undefined }; + } catch (err) { + return { provider, results: [] as SearchResult[], error: safeErrorMessage(err) }; + } + }), + ); + + // Collect results and errors + for (const out of outcomes) { + results.push(...out.results); + if (out.error) { + providerErrors.push({ providerId: out.provider.id, error: out.error }); + } + } + + // Sort by score (desc), then by priority (desc), then by title (asc) + results.sort((a, b) => { + const scoreDelta = coerceScore(b.score) - coerceScore(a.score); + if (scoreDelta !== 0) return scoreDelta; + + const priA = priorityById.get(a.provider) ?? 0; + const priB = priorityById.get(b.provider) ?? 0; + if (priA !== priB) return priB - priA; + + return String(a.title ?? '').localeCompare(String(b.title ?? '')); + }); + + // Apply total limit + const sliced = results.slice(0, limit); + const cancelled = signal.aborted || requestId !== this.latestRequestId; + + // Filter out abort-related errors when cancelled to avoid UI noise + const filteredErrors = cancelled + ? providerErrors.filter( + (e) => + !e.error.toLowerCase().includes('abort') && !e.error.toLowerCase().includes('cancel'), + ) + : providerErrors; + + const response: SearchEngineResponse = { + requestId, + request: { scope, query, limit }, + results: sliced, + providerErrors: filteredErrors, + cancelled, + fromCache: false, + elapsedMs: Date.now() - startedAt, + }; + + // Cache successful non-cancelled response + if (!cancelled) { + this.setCached(cacheKey, response); + } + + // Clean up active abort reference + if (this.activeAbort?.signal === signal) { + this.activeAbort = null; + } + + return response; + } +} diff --git a/app/chrome-extension/shared/quick-panel/core/types.ts b/app/chrome-extension/shared/quick-panel/core/types.ts new file mode 100644 index 00000000..07f4ced4 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/core/types.ts @@ -0,0 +1,349 @@ +/** + * Quick Panel Core Types + * + * Shared contracts for the Quick Panel search and UI layers. + * Framework-agnostic and safe to import from both UI and core modules. + */ + +// ============================================================ +// Scope Types +// ============================================================ + +/** + * Available search scopes in Quick Panel + */ +export type QuickPanelScope = 'all' | 'tabs' | 'bookmarks' | 'history' | 'content' | 'commands'; + +/** + * Scope definition with display properties + */ +export interface QuickPanelScopeDefinition { + id: QuickPanelScope; + label: string; + icon: string; + /** + * Scope prefix for search input recognition. + * - Space-terminated prefixes: "t ", "b ", "h ", "c " + * - Command mode prefix: ">" + * - null for 'all' scope (no prefix) + */ + prefix: string | null; +} + +/** Default scope when no prefix is detected */ +export const DEFAULT_SCOPE: QuickPanelScope = 'all'; + +/** Scope definitions following PRD spec */ +export const QUICK_PANEL_SCOPES: Readonly> = { + all: { id: 'all', label: 'All', icon: '\u2318', prefix: null }, + tabs: { id: 'tabs', label: 'Tabs', icon: '\uD83D\uDDC2\uFE0F', prefix: 't ' }, + bookmarks: { id: 'bookmarks', label: 'Bookmarks', icon: '\u2B50', prefix: 'b ' }, + history: { id: 'history', label: 'History', icon: '\uD83D\uDD50', prefix: 'h ' }, + content: { id: 'content', label: 'Content', icon: '\uD83D\uDCC4', prefix: 'c ' }, + commands: { id: 'commands', label: 'Commands', icon: '>', prefix: '>' }, +} as const; + +/** + * Type guard for QuickPanelScope + */ +export function isQuickPanelScope(value: unknown): value is QuickPanelScope { + return typeof value === 'string' && value in QUICK_PANEL_SCOPES; +} + +/** + * Normalize a value to a valid QuickPanelScope + */ +export function normalizeQuickPanelScope( + value: unknown, + fallback: QuickPanelScope = DEFAULT_SCOPE, +): QuickPanelScope { + return isQuickPanelScope(value) ? value : fallback; +} + +// ============================================================ +// Scope Prefix Parsing +// ============================================================ + +/** + * Result of parsing a scope-prefixed query string + */ +export interface ParsedScopeQuery { + /** Original input string */ + raw: string; + /** Detected or default scope */ + scope: QuickPanelScope; + /** Query string with prefix removed */ + query: string; + /** Whether a scope prefix was recognized and consumed */ + consumedPrefix: boolean; +} + +/** + * Parse a scope-prefixed input string following PRD conventions: + * - `>foo` -> scope=commands, query="foo" + * - `t foo` -> scope=tabs, query="foo" + * - `b foo` -> scope=bookmarks, query="foo" + * - `h foo` -> scope=history, query="foo" + * - `c foo` -> scope=content, query="foo" + * + * Only checks the beginning of the string (after trimming leading whitespace). + */ +export function parseScopePrefixedQuery( + rawInput: string, + defaultScope: QuickPanelScope = DEFAULT_SCOPE, +): ParsedScopeQuery { + const raw = typeof rawInput === 'string' ? rawInput : ''; + const leadingTrimmed = raw.replace(/^\s+/, ''); + + // Check for command mode prefix (>) + if (leadingTrimmed.startsWith('>')) { + return { + raw, + scope: 'commands', + query: leadingTrimmed.slice(1).trimStart(), + consumedPrefix: true, + }; + } + + // Check for space-terminated scope prefixes (t, b, h, c) + const match = leadingTrimmed.match(/^([tbhc])\s+(.*)$/s); + if (match) { + const prefix = match[1]; + const rest = (match[2] ?? '').trimStart(); + + const scopeMap: Record = { + t: 'tabs', + b: 'bookmarks', + h: 'history', + c: 'content', + }; + + const scope = scopeMap[prefix] ?? defaultScope; + + return { raw, scope, query: rest, consumedPrefix: true }; + } + + // No prefix detected + return { raw, scope: defaultScope, query: raw.trim(), consumedPrefix: false }; +} + +// ============================================================ +// Search Results +// ============================================================ + +/** + * Icon type - can be an emoji string or a DOM node + */ +export type QuickPanelIcon = string | Node; + +/** + * Search result from a provider + */ +export interface SearchResult { + /** Unique identifier within the provider */ + id: string; + /** Provider that generated this result */ + provider: string; + /** Display title */ + title: string; + /** Optional subtitle/description */ + subtitle?: string; + /** Icon (emoji or DOM node) */ + icon?: QuickPanelIcon; + /** Provider-specific data */ + data: TData; + /** Relevance score (higher is better) */ + score: number; +} + +// ============================================================ +// Actions +// ============================================================ + +/** + * Visual tone for actions + */ +export type ActionTone = 'default' | 'danger'; + +/** + * Context passed to action execution + */ +export interface ActionContext { + /** The search result being acted upon */ + result: SearchResult; + /** + * Optional open mode hint for navigation actions. + * Providers can ignore if not applicable. + */ + openMode?: 'current_tab' | 'new_tab' | 'background_tab'; +} + +/** + * An action that can be performed on a search result + */ +export interface Action { + /** Unique identifier */ + id: string; + /** Display title */ + title: string; + /** Optional subtitle */ + subtitle?: string; + /** Icon */ + icon?: QuickPanelIcon; + /** Visual tone */ + tone?: ActionTone; + /** + * Hotkey hint for UI display (e.g., "Enter", "Cmd+Enter"). + * Controller remains source of truth for actual keybindings. + */ + hotkeyHint?: string; + /** Check if action is available for given context */ + isAvailable?: (ctx: ActionContext) => boolean; + /** Execute the action */ + execute: (ctx: ActionContext) => void | Promise; +} + +// ============================================================ +// Search Query +// ============================================================ + +/** + * Normalized search query passed to providers. + */ +export interface SearchQuery { + /** Original, unmodified query string */ + raw: string; + /** + * Normalized query used for matching/caching: + * - trimmed + * - collapsed whitespace + * - lowercased + */ + text: string; + /** Tokenized representation of `text` */ + tokens: string[]; +} + +/** + * Normalize a raw query string to SearchQuery format. + */ +export function normalizeSearchQuery(raw: string): SearchQuery { + const input = typeof raw === 'string' ? raw : ''; + const trimmed = input.trim(); + const text = trimmed.replace(/\s+/g, ' ').toLowerCase(); + const tokens = text ? text.split(' ').filter(Boolean) : []; + return { raw: input, text, tokens }; +} + +// ============================================================ +// Providers +// ============================================================ + +/** + * Context passed to provider.search method. + */ +export interface SearchProviderContext { + /** The scope selected by the user (may be 'all'). */ + requestedScope: QuickPanelScope; + /** Normalized query info */ + query: SearchQuery; + /** Max results requested for this provider */ + limit: number; + /** Abort signal for cancellation */ + signal: AbortSignal; + /** Timestamp (ms) for consistent scoring */ + now: number; +} + +/** + * Search provider interface. + * + * Providers are responsible for: + * - Searching a specific data source + * - Ranking results with a score + * - Providing actions for results + */ +export interface SearchProvider { + /** Unique provider identifier */ + id: string; + /** Display name */ + name: string; + /** Provider icon */ + icon: string; + + /** + * Scopes this provider can handle. + * + * Note: 'all' is a meta-scope and should not usually be listed here. + * The SearchEngine will include providers in 'all' based on includeInAll. + */ + scopes: readonly QuickPanelScope[]; + + /** + * Whether this provider participates in the 'all' meta-scope. + * Default: true + */ + includeInAll?: boolean; + + /** + * Provider priority used as a tie-breaker when scores are equal (higher wins). + * Default: 0 + */ + priority?: number; + + /** + * Provider-level hard cap for returned items (optional). + * The SearchEngine may apply additional caps. + */ + maxResults?: number; + + /** + * Whether the provider wants to run for empty queries. + * Default: false + */ + supportsEmptyQuery?: boolean; + + /** + * Search for results matching the query. + * + * @param ctx - Search context with query, limit, signal, etc. + * @returns Promise of search results + */ + search: (ctx: SearchProviderContext) => Promise[]>; + + /** + * Get available actions for a result. + * + * @param item - The search result to get actions for + * @returns Array of available actions + */ + getActions: (item: SearchResult) => Action[]; + + /** + * Optional cleanup hook for releasing resources. + * Called when provider is unregistered or engine is disposed. + */ + dispose?: () => void; +} + +// ============================================================ +// Panel View Types +// ============================================================ + +/** + * Available views in Quick Panel + */ +export type QuickPanelView = 'search' | 'chat'; + +/** + * Panel state + */ +export interface QuickPanelState { + view: QuickPanelView; + scope: QuickPanelScope; + query: string; + results: SearchResult[]; + selectedIndex: number; + isLoading: boolean; + errorMessage: string | null; +} diff --git a/app/chrome-extension/shared/quick-panel/index.ts b/app/chrome-extension/shared/quick-panel/index.ts new file mode 100644 index 00000000..88383bf0 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/index.ts @@ -0,0 +1,340 @@ +/** + * Quick Panel Entry Point + * + * This module provides the main controller for Quick Panel functionality. + * It orchestrates: + * - Shadow DOM host management + * - AI Chat panel lifecycle + * - Agent bridge communication + * - Keyboard shortcut handling (external) + * + * Usage in content script: + * ```typescript + * import { createQuickPanelController } from './quick-panel'; + * + * const controller = createQuickPanelController(); + * + * // Show panel (e.g., on keyboard shortcut) + * controller.show(); + * + * // Hide panel + * controller.hide(); + * + * // Toggle visibility + * controller.toggle(); + * + * // Cleanup on unload + * controller.dispose(); + * ``` + */ + +import { createAgentBridge, type QuickPanelAgentBridge } from './core/agent-bridge'; +import { + mountQuickPanelShadowHost, + mountQuickPanelAiChatPanel, + type QuickPanelShadowHostManager, + type QuickPanelAiChatPanelManager, +} from './ui'; + +// ============================================================ +// Types +// ============================================================ + +export interface QuickPanelControllerOptions { + /** Custom host element ID for Shadow DOM. Default: '__mcp_quick_panel_host__' */ + hostId?: string; + /** Custom z-index for overlay. Default: 2147483647 (highest possible) */ + zIndex?: number; + /** Panel title. Default: 'Agent' */ + title?: string; + /** Panel subtitle. Default: 'Quick Panel' */ + subtitle?: string; + /** Input placeholder. Default: 'Ask the agent...' */ + placeholder?: string; +} + +export interface QuickPanelController { + /** Show the Quick Panel (creates if not exists) */ + show: () => void; + /** Hide the Quick Panel (disposes UI but keeps bridge alive) */ + hide: () => void; + /** Toggle Quick Panel visibility */ + toggle: () => void; + /** Check if panel is currently visible */ + isVisible: () => boolean; + /** Fully dispose all resources */ + dispose: () => void; +} + +// ============================================================ +// Constants +// ============================================================ + +const LOG_PREFIX = '[QuickPanelController]'; + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Create a Quick Panel controller instance. + * + * The controller manages the full lifecycle of the Quick Panel UI, + * including Shadow DOM isolation, AI chat interface, and background + * communication. + * + * @example + * ```typescript + * // In content script + * const quickPanel = createQuickPanelController(); + * + * // Listen for keyboard shortcut (e.g., Cmd+Shift+K) + * document.addEventListener('keydown', (e) => { + * if (e.metaKey && e.shiftKey && e.key === 'k') { + * e.preventDefault(); + * quickPanel.toggle(); + * } + * }); + * + * // Cleanup on extension unload + * window.addEventListener('unload', () => { + * quickPanel.dispose(); + * }); + * ``` + */ +export function createQuickPanelController( + options: QuickPanelControllerOptions = {}, +): QuickPanelController { + let disposed = false; + + // Shared agent bridge (persists across show/hide cycles) + let agentBridge: QuickPanelAgentBridge | null = null; + + // UI components (created on show, disposed on hide) + let shadowHost: QuickPanelShadowHostManager | null = null; + let chatPanel: QuickPanelAiChatPanelManager | null = null; + + /** + * Ensure agent bridge is initialized + */ + function ensureBridge(): QuickPanelAgentBridge { + if (!agentBridge || agentBridge.isDisposed()) { + agentBridge = createAgentBridge(); + } + return agentBridge; + } + + /** + * Dispose current UI (keeps bridge alive for potential reuse) + */ + function disposeUI(): void { + if (chatPanel) { + try { + chatPanel.dispose(); + } catch (err) { + console.warn(`${LOG_PREFIX} Error disposing chat panel:`, err); + } + chatPanel = null; + } + + if (shadowHost) { + try { + shadowHost.dispose(); + } catch (err) { + console.warn(`${LOG_PREFIX} Error disposing shadow host:`, err); + } + shadowHost = null; + } + } + + /** + * Show the Quick Panel + */ + function show(): void { + if (disposed) { + console.warn(`${LOG_PREFIX} Cannot show - controller is disposed`); + return; + } + + // Already visible + if (chatPanel && shadowHost?.getElements()) { + chatPanel.focusInput(); + return; + } + + // Clean up any stale UI + disposeUI(); + + // Create shadow host + shadowHost = mountQuickPanelShadowHost({ + hostId: options.hostId, + zIndex: options.zIndex, + }); + + const elements = shadowHost.getElements(); + if (!elements) { + console.error(`${LOG_PREFIX} Failed to create shadow host elements`); + disposeUI(); + return; + } + + // Ensure bridge is ready + const bridge = ensureBridge(); + + // Create chat panel + chatPanel = mountQuickPanelAiChatPanel({ + mount: elements.root, + agentBridge: bridge, + title: options.title, + subtitle: options.subtitle, + placeholder: options.placeholder, + autoFocus: true, + onRequestClose: () => hide(), + }); + } + + /** + * Hide the Quick Panel + */ + function hide(): void { + if (disposed) return; + disposeUI(); + } + + /** + * Toggle Quick Panel visibility + */ + function toggle(): void { + if (disposed) return; + + if (isVisible()) { + hide(); + } else { + show(); + } + } + + /** + * Check if panel is currently visible + */ + function isVisible(): boolean { + return chatPanel !== null && shadowHost?.getElements() !== null; + } + + /** + * Fully dispose all resources + */ + function dispose(): void { + if (disposed) return; + disposed = true; + + disposeUI(); + + if (agentBridge) { + try { + agentBridge.dispose(); + } catch (err) { + console.warn(`${LOG_PREFIX} Error disposing agent bridge:`, err); + } + agentBridge = null; + } + } + + return { + show, + hide, + toggle, + isVisible, + dispose, + }; +} + +// ============================================================ +// Re-exports for convenience +// ============================================================ + +// Core types +export { + DEFAULT_SCOPE, + QUICK_PANEL_SCOPES, + normalizeQuickPanelScope, + parseScopePrefixedQuery, + normalizeSearchQuery, +} from './core/types'; + +export type { + QuickPanelScope, + QuickPanelScopeDefinition, + QuickPanelView, + ParsedScopeQuery, + QuickPanelIcon, + SearchResult, + ActionTone, + ActionContext, + Action, + SearchQuery, + SearchProviderContext, + SearchProvider, + QuickPanelState, +} from './core/types'; + +// Agent bridge +export { createAgentBridge } from './core/agent-bridge'; +export type { + QuickPanelAgentBridge, + RequestEventListener, + AgentBridgeOptions, +} from './core/agent-bridge'; + +// UI Components +export { + // Shadow host + mountQuickPanelShadowHost, + // Panel shell (unified container) + mountQuickPanelShell, + // AI Chat + mountQuickPanelAiChatPanel, + createQuickPanelMessageRenderer, + // Search UI + createSearchInput, + createQuickEntries, + // Styles + QUICK_PANEL_STYLES, +} from './ui'; + +export type { + // Shadow host + QuickPanelShadowHostElements, + QuickPanelShadowHostManager, + QuickPanelShadowHostOptions, + // Panel shell + QuickPanelShellElements, + QuickPanelShellManager, + QuickPanelShellOptions, + // AI Chat + QuickPanelAiChatPanelManager, + QuickPanelAiChatPanelOptions, + QuickPanelAiChatPanelState, + QuickPanelMessageRenderer, + QuickPanelMessageRendererOptions, + // Search input + SearchInputManager, + SearchInputOptions, + SearchInputState, + // Quick entries + QuickEntriesManager, + QuickEntriesOptions, +} from './ui'; + +// Search Engine +export { SearchEngine } from './core/search-engine'; +export type { + SearchEngineOptions, + SearchEngineRequest, + SearchEngineResponse, + SearchProviderError, +} from './core/search-engine'; + +// Search Providers +export { createTabsProvider } from './providers'; +export type { TabsProviderOptions, TabsSearchResultData } from './providers'; diff --git a/app/chrome-extension/shared/quick-panel/providers/index.ts b/app/chrome-extension/shared/quick-panel/providers/index.ts new file mode 100644 index 00000000..6b3e7880 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/providers/index.ts @@ -0,0 +1,11 @@ +/** + * Quick Panel Search Providers + * + * Exports all search providers for Quick Panel. + */ + +export { + createTabsProvider, + type TabsProviderOptions, + type TabsSearchResultData, +} from './tabs-provider'; diff --git a/app/chrome-extension/shared/quick-panel/providers/tabs-provider.ts b/app/chrome-extension/shared/quick-panel/providers/tabs-provider.ts new file mode 100644 index 00000000..d0c5db83 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/providers/tabs-provider.ts @@ -0,0 +1,450 @@ +/** + * Tabs Search Provider (Quick Panel) + * + * Searches open browser tabs via background service worker bridge. + * Runs in content script Quick Panel UI - delegates tab operations + * to the background service worker via chrome.runtime messaging. + */ + +import { + BACKGROUND_MESSAGE_TYPES, + type QuickPanelActivateTabResponse, + type QuickPanelCloseTabResponse, + type QuickPanelTabSummary, + type QuickPanelTabsQueryResponse, +} from '@/common/message-types'; +import type { Action, SearchProvider, SearchProviderContext, SearchResult } from '../core/types'; + +// ============================================================ +// Types +// ============================================================ + +/** + * Data associated with a tab search result. + */ +export interface TabsSearchResultData { + tabId: number; + windowId: number; + url: string; + title: string; + favIconUrl?: string; + pinned: boolean; + active: boolean; +} + +export interface TabsProviderOptions { + /** Provider ID. Default: 'tabs' */ + id?: string; + /** Display name. Default: 'Tabs' */ + name?: string; + /** Icon. Default: '🗂️' */ + icon?: string; + /** Include tabs from all windows. Default: true */ + includeAllWindows?: boolean; +} + +// ============================================================ +// Tabs Client (Background Bridge) +// ============================================================ + +interface TabsSnapshot { + tabs: QuickPanelTabSummary[]; + currentTabId: number | null; + currentWindowId: number | null; +} + +interface TabsClient { + listTabs: (options: { includeAllWindows: boolean; signal: AbortSignal }) => Promise; + activateTab: (tabId: number, windowId?: number) => Promise; + closeTab: (tabId: number) => Promise; +} + +function createRuntimeTabsClient(): TabsClient { + async function listTabs(options: { + includeAllWindows: boolean; + signal: AbortSignal; + }): Promise { + if (typeof chrome === 'undefined' || !chrome.runtime?.sendMessage) { + throw new Error('chrome.runtime.sendMessage is not available'); + } + if (options.signal.aborted) { + throw new Error('aborted'); + } + + const resp = (await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TABS_QUERY, + payload: { includeAllWindows: options.includeAllWindows }, + })) as QuickPanelTabsQueryResponse; + + if (!resp || resp.success !== true) { + const err = (resp as { error?: unknown })?.error; + throw new Error(typeof err === 'string' ? err : 'Failed to query tabs'); + } + + return { + tabs: resp.tabs, + currentTabId: resp.currentTabId, + currentWindowId: resp.currentWindowId, + }; + } + + async function activateTab(tabId: number, windowId?: number): Promise { + if (typeof chrome === 'undefined' || !chrome.runtime?.sendMessage) { + throw new Error('chrome.runtime.sendMessage is not available'); + } + + const resp = (await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_ACTIVATE, + payload: { tabId, windowId }, + })) as QuickPanelActivateTabResponse; + + if (!resp || resp.success !== true) { + const err = (resp as { error?: unknown })?.error; + throw new Error(typeof err === 'string' ? err : 'Failed to activate tab'); + } + } + + async function closeTab(tabId: number): Promise { + if (typeof chrome === 'undefined' || !chrome.runtime?.sendMessage) { + throw new Error('chrome.runtime.sendMessage is not available'); + } + + const resp = (await chrome.runtime.sendMessage({ + type: BACKGROUND_MESSAGE_TYPES.QUICK_PANEL_TAB_CLOSE, + payload: { tabId }, + })) as QuickPanelCloseTabResponse; + + if (!resp || resp.success !== true) { + const err = (resp as { error?: unknown })?.error; + throw new Error(typeof err === 'string' ? err : 'Failed to close tab'); + } + } + + return { listTabs, activateTab, closeTab }; +} + +// ============================================================ +// Scoring Helpers +// ============================================================ + +function normalizeText(value: unknown): string { + return String(value ?? '') + .trim() + .toLowerCase() + .replace(/\s+/g, ' '); +} + +function normalizeUrl(value: unknown): string { + const raw = String(value ?? '').trim(); + if (!raw) return ''; + + // Remove protocol and www prefix for cleaner matching + let text = raw.replace(/^https?:\/\//i, '').replace(/^www\./i, ''); + + // Attempt URL decode + try { + text = decodeURIComponent(text); + } catch { + // Best-effort + } + + return normalizeText(text); +} + +/** + * Check if needle is a subsequence of haystack. + */ +function isSubsequence(needle: string, haystack: string): boolean { + if (!needle) return true; + let i = 0; + for (const ch of haystack) { + if (ch === needle[i]) i++; + if (i >= needle.length) return true; + } + return false; +} + +/** Minimum token length for subsequence matching (to avoid over-matching) */ +const MIN_SUBSEQUENCE_TOKEN_LENGTH = 3; + +/** + * Check if character is a word boundary. + */ +function isBoundaryChar(ch: string): boolean { + return ( + ch === '' || + ch === ' ' || + ch === '/' || + ch === '-' || + ch === '_' || + ch === '.' || + ch === ':' || + ch === '#' || + ch === '?' || + ch === '&' + ); +} + +/** + * Score a single token against a haystack string. + * Returns 0 if no match, higher values for better matches. + */ +function scoreToken(haystack: string, token: string): number { + if (!haystack || !token) return 0; + + // Exact match + if (haystack === token) return 1; + + // Prefix match + if (haystack.startsWith(token)) return 0.95; + + // Substring match + const idx = haystack.indexOf(token); + if (idx >= 0) { + const prev = idx > 0 ? haystack[idx - 1] : ''; + const boundaryBoost = isBoundaryChar(prev) ? 0.15 : 0; + const positionPenalty = idx / Math.max(1, haystack.length); + return Math.max(0.55, 0.8 + boundaryBoost - positionPenalty * 0.2); + } + + // Subsequence match (fuzzy) - only for tokens >= MIN_SUBSEQUENCE_TOKEN_LENGTH + if (token.length >= MIN_SUBSEQUENCE_TOKEN_LENGTH && isSubsequence(token, haystack)) { + return 0.4; + } + + return 0; +} + +/** + * Compute overall score for a tab based on query tokens. + * Each token can match in EITHER title OR url (cross-field matching). + */ +function computeTabScore( + tab: QuickPanelTabSummary, + queryTokens: readonly string[], + currentWindowId: number | null, + currentTabId: number | null, +): number { + if (queryTokens.length === 0) return 0; + + const normalizedTitle = normalizeText(tab.title); + const normalizedUrl = normalizeUrl(tab.url); + + // For each token, take the best score from title or url + let totalScore = 0; + for (const token of queryTokens) { + const titleTokenScore = scoreToken(normalizedTitle, token); + const urlTokenScore = scoreToken(normalizedUrl, token); + const bestScore = Math.max(titleTokenScore, urlTokenScore); + + // If token doesn't match either field, reject this tab + if (bestScore <= 0) return 0; + + // Weight title matches higher than url matches (title: 0.75, url: 0.25) + const weightedScore = titleTokenScore * 0.75 + urlTokenScore * 0.25; + totalScore += weightedScore; + } + + const base = (totalScore / queryTokens.length) * 100; + if (base <= 0) return 0; + + // Boost for context relevance + let boost = 0; + if (typeof currentWindowId === 'number' && tab.windowId === currentWindowId) { + boost += 10; + } + if (typeof currentTabId === 'number' && tab.tabId === currentTabId) { + boost += 15; + } else if (tab.active) { + boost += 6; + } + if (tab.pinned) boost += 4; + if (tab.audible) boost += 2; + + return base + boost; +} + +/** + * Sort tabs by score with tie-breaking rules. + */ +function sortTabs( + a: { tab: QuickPanelTabSummary; score: number }, + b: { tab: QuickPanelTabSummary; score: number }, + currentWindowId: number | null, + currentTabId: number | null, +): number { + // Primary: score descending + if (b.score !== a.score) return b.score - a.score; + + // Tie-breaker 1: current tab first + const aIsCurrentTab = typeof currentTabId === 'number' && a.tab.tabId === currentTabId; + const bIsCurrentTab = typeof currentTabId === 'number' && b.tab.tabId === currentTabId; + if (aIsCurrentTab !== bIsCurrentTab) return aIsCurrentTab ? -1 : 1; + + // Tie-breaker 2: current window first + const aIsCurrentWin = typeof currentWindowId === 'number' && a.tab.windowId === currentWindowId; + const bIsCurrentWin = typeof currentWindowId === 'number' && b.tab.windowId === currentWindowId; + if (aIsCurrentWin !== bIsCurrentWin) return aIsCurrentWin ? -1 : 1; + + // Tie-breaker 3: pinned first + if (a.tab.pinned !== b.tab.pinned) return a.tab.pinned ? -1 : 1; + + // Tie-breaker 4: active first + if (a.tab.active !== b.tab.active) return a.tab.active ? -1 : 1; + + // Tie-breaker 5: tab index + return a.tab.index - b.tab.index; +} + +// ============================================================ +// Provider Factory +// ============================================================ + +/** + * Create a Tabs search provider for Quick Panel. + * + * @example + * ```typescript + * const tabsProvider = createTabsProvider(); + * searchEngine.registerProvider(tabsProvider); + * ``` + */ +export function createTabsProvider( + options: TabsProviderOptions = {}, +): SearchProvider { + const id = options.id?.trim() || 'tabs'; + const name = options.name?.trim() || 'Tabs'; + const icon = options.icon?.trim() || '\uD83D\uDDC2\uFE0F'; // 🗂️ + const includeAllWindows = options.includeAllWindows ?? true; + + const client: TabsClient = createRuntimeTabsClient(); + + /** + * Get actions available for a tab result. + */ + function getActions(item: SearchResult): Action[] { + const tabId = item.data.tabId; + const windowId = item.data.windowId; + + return [ + { + id: 'tabs.activate', + title: 'Switch to tab', + hotkeyHint: 'Enter', + execute: async () => { + await client.activateTab(tabId, windowId); + }, + }, + { + id: 'tabs.close', + title: 'Close tab', + tone: 'danger', + execute: async () => { + await client.closeTab(tabId); + }, + }, + ]; + } + + /** + * Search for tabs matching the query. + */ + async function search(ctx: SearchProviderContext): Promise[]> { + if (ctx.signal.aborted) return []; + + const snapshot = await client.listTabs({ includeAllWindows, signal: ctx.signal }); + if (ctx.signal.aborted) return []; + + const tokens = ctx.query.tokens; + const limit = ctx.limit; + + const scored: Array<{ tab: QuickPanelTabSummary; score: number }> = []; + + for (const tab of snapshot.tabs) { + // Skip invalid tabs + if (typeof tab.tabId !== 'number' || tab.tabId <= 0) continue; + + // Empty query: show all tabs with recency-based scoring + if (tokens.length === 0) { + let score = 0; + if (typeof snapshot.currentTabId === 'number' && tab.tabId === snapshot.currentTabId) { + score += 100; + } + if ( + typeof snapshot.currentWindowId === 'number' && + tab.windowId === snapshot.currentWindowId + ) { + score += 30; + } + if (tab.active) score += 20; + if (tab.pinned) score += 10; + + // Use lastAccessed for recency (more recent = higher score) + const lastAccessed = tab.lastAccessed; + if (typeof lastAccessed === 'number' && Number.isFinite(lastAccessed) && lastAccessed > 0) { + // Normalize recency: more recent tabs get higher bonus (up to 15 points) + // Clamp ageMs to prevent negative values from future timestamps + const ageMs = Math.max(0, ctx.now - lastAccessed); + // Decay over 1 hour, clamp bonus to [0, 15] + const recencyBonus = Math.max(0, Math.min(15, 15 - ageMs / (1000 * 60 * 60))); + score += recencyBonus; + } else { + // Fallback to index if lastAccessed not available + score += Math.max(0, 5 - tab.index * 0.05); + } + + scored.push({ tab, score }); + continue; + } + + // Query-based scoring + const score = computeTabScore(tab, tokens, snapshot.currentWindowId, snapshot.currentTabId); + if (score > 0) { + scored.push({ tab, score }); + } + } + + // Sort and limit + scored.sort((a, b) => sortTabs(a, b, snapshot.currentWindowId, snapshot.currentTabId)); + const top = scored.slice(0, limit); + + // Convert to SearchResult format + return top.map(({ tab, score }) => { + const title = tab.title?.trim() || tab.url || 'Untitled'; + const url = tab.url?.trim() || ''; + + const data: TabsSearchResultData = { + tabId: tab.tabId, + windowId: tab.windowId, + title, + url, + favIconUrl: tab.favIconUrl, + pinned: tab.pinned, + active: tab.active, + }; + + return { + id: String(tab.tabId), + provider: id, + title, + subtitle: url, + icon, + data, + score, + }; + }); + } + + return { + id, + name, + icon, + scopes: ['tabs'], + includeInAll: true, + priority: 50, // High priority for tab switching + maxResults: 50, + supportsEmptyQuery: true, + search, + getActions, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/ai-chat-panel.ts b/app/chrome-extension/shared/quick-panel/ui/ai-chat-panel.ts new file mode 100644 index 00000000..fae39bcd --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/ai-chat-panel.ts @@ -0,0 +1,956 @@ +/** + * Quick Panel AI Chat Panel + * + * A complete AI chat interface for Quick Panel, featuring: + * - Streaming message display with real-time updates + * - Liquid Glass design with AgentChat token compatibility + * - Full keyboard navigation (Enter to send, Esc to close) + * - Request lifecycle management (send, cancel, cleanup) + * - Auto-context collection (page URL, text selection) + * + * This component is framework-agnostic and renders directly to Shadow DOM + * for optimal isolation and performance in content script context. + */ + +import type { + AgentMessage, + AgentStatusEvent, + AgentUsageStats, + RealtimeEvent, +} from 'chrome-mcp-shared'; + +import type { QuickPanelAIContext, QuickPanelSendToAIPayload } from '@/common/message-types'; +import type { QuickPanelAgentBridge } from '../core/agent-bridge'; +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import { + createQuickPanelMessageRenderer, + type QuickPanelMessageRenderer, +} from './message-renderer'; + +// ============================================================ +// Types +// ============================================================ + +export interface QuickPanelAiChatPanelOptions { + /** Shadow DOM mount point (typically `elements.root` from shadow-host.ts) */ + mount: HTMLElement; + /** Agent bridge for background communication */ + agentBridge: QuickPanelAgentBridge; + + /** Header title. Default: "Agent" */ + title?: string; + /** Header subtitle. Default: "Quick Panel" */ + subtitle?: string; + /** Input placeholder. Default: "Ask the agent..." */ + placeholder?: string; + /** Auto-focus textarea on mount. Default: true */ + autoFocus?: boolean; + + /** Optional context provider for enhanced AI understanding */ + getContext?: () => QuickPanelAIContext | null | Promise; + + /** Called when user requests to close the panel */ + onRequestClose?: () => void; +} + +export interface QuickPanelAiChatPanelState { + sending: boolean; + streaming: boolean; + cancelling: boolean; + currentRequestId: string | null; + sessionId: string | null; + lastStatus: AgentStatusEvent['status'] | null; + lastUsage: AgentUsageStats | null; + errorMessage: string | null; +} + +export interface QuickPanelAiChatPanelManager { + getState: () => QuickPanelAiChatPanelState; + focusInput: () => void; + clearMessages: () => void; + close: () => void; + dispose: () => void; +} + +// ============================================================ +// Constants +// ============================================================ + +const LOG_PREFIX = '[QuickPanelAiChatPanel]'; + +const DEFAULT_TITLE = 'Agent'; +const DEFAULT_SUBTITLE = 'Quick Panel'; +const DEFAULT_PLACEHOLDER = 'Ask the agent...'; + +/** Max chars for selected text context to avoid payload bloat */ +const MAX_SELECTED_TEXT_CHARS = 3000; +/** Max chars for error message display */ +const MAX_ERROR_DISPLAY_CHARS = 600; + +const TEXTAREA_MIN_HEIGHT_PX = 42; +const TEXTAREA_MAX_HEIGHT_PX = 160; + +/** Auto-hide duration for success/warning banners */ +const BANNER_AUTO_HIDE_MS = 2400; + +// SVG Icons +const ICON_CLOSE = ``; +const ICON_SEND = ``; +const ICON_STOP = ``; + +// ============================================================ +// Utility Functions +// ============================================================ + +function isNonEmptyString(value: unknown): value is string { + return typeof value === 'string' && value.trim().length > 0; +} + +function truncateText(text: string, maxChars: number): string { + const trimmed = text.trim(); + if (trimmed.length <= maxChars) return trimmed; + return `${trimmed.slice(0, Math.max(0, maxChars - 1)).trimEnd()}\u2026`; +} + +function safeFocus(element: HTMLElement): void { + try { + element.focus(); + } catch { + // Best-effort focus + } +} + +function isTerminalStatus(status: AgentStatusEvent['status']): boolean { + return status === 'completed' || status === 'error' || status === 'cancelled'; +} + +/** + * Collect default context from the current page + */ +function collectDefaultContext(): QuickPanelAIContext { + const context: QuickPanelAIContext = { + pageUrl: globalThis.location?.href, + }; + + try { + const selection = globalThis.getSelection?.(); + const selectedText = selection?.toString()?.trim() ?? ''; + if (selectedText) { + context.selectedText = truncateText(selectedText, MAX_SELECTED_TEXT_CHARS); + } + } catch { + // Ignore selection access errors + } + + return context; +} + +/** + * Build a local user message for optimistic rendering + */ +function buildLocalUserMessage( + sessionId: string, + requestId: string, + instruction: string, +): AgentMessage { + return { + id: `local-user:${requestId}`, + sessionId, + role: 'user', + content: instruction, + messageType: 'chat', + requestId, + isStreaming: false, + isFinal: true, + createdAt: new Date().toISOString(), + }; +} + +/** + * Format usage stats for display + */ +function formatUsageStats(usage: AgentUsageStats | null): string | null { + if (!usage) return null; + + const parts: string[] = []; + + const inputTokens = Number.isFinite(usage.inputTokens) ? usage.inputTokens : 0; + const outputTokens = Number.isFinite(usage.outputTokens) ? usage.outputTokens : 0; + parts.push(`in ${inputTokens}`, `out ${outputTokens}`); + + if (Number.isFinite(usage.durationMs) && usage.durationMs > 0) { + const seconds = Math.max(1, Math.round(usage.durationMs / 1000)); + parts.push(`${seconds}s`); + } + + if (Number.isFinite(usage.totalCostUsd) && usage.totalCostUsd > 0) { + parts.push(`$${usage.totalCostUsd.toFixed(4)}`); + } + + return parts.join(' \u2022 '); +} + +// ============================================================ +// DOM Builder Functions +// ============================================================ + +interface PanelDOMElements { + overlay: HTMLDivElement; + panel: HTMLDivElement; + titleSubEl: HTMLDivElement; + streamIndicator: HTMLDivElement; + streamText: HTMLSpanElement; + closeBtn: HTMLButtonElement; + contentEl: HTMLDivElement; + emptyEl: HTMLDivElement; + messagesEl: HTMLDivElement; + banner: HTMLDivElement; + textarea: HTMLTextAreaElement; + /** Unified action button: send/stop */ + actionBtn: HTMLButtonElement; +} + +function buildPanelDOM(options: QuickPanelAiChatPanelOptions): PanelDOMElements { + const title = options.title?.trim() || DEFAULT_TITLE; + const subtitle = options.subtitle?.trim() || DEFAULT_SUBTITLE; + const placeholder = options.placeholder?.trim() || DEFAULT_PLACEHOLDER; + + // Overlay (click outside to close) + const overlay = document.createElement('div'); + overlay.className = 'qp-overlay'; + overlay.setAttribute('data-mcp-quick-panel-ai-chat', 'true'); + + // Panel container + const panel = document.createElement('div'); + panel.className = 'qp-panel'; + panel.setAttribute('role', 'dialog'); + panel.setAttribute('aria-modal', 'true'); + panel.setAttribute('aria-label', title); + + // ---- Header ---- + const header = document.createElement('div'); + header.className = 'qp-header'; + + const headerLeft = document.createElement('div'); + headerLeft.className = 'qp-header-left'; + + const brand = document.createElement('div'); + brand.className = 'qp-brand'; + brand.textContent = '\u2726'; // Star symbol + + const titleWrap = document.createElement('div'); + titleWrap.className = 'qp-title'; + + const titleNameEl = document.createElement('div'); + titleNameEl.className = 'qp-title-name'; + titleNameEl.textContent = title; + + const titleSubEl = document.createElement('div'); + titleSubEl.className = 'qp-title-sub'; + titleSubEl.textContent = subtitle; + + titleWrap.append(titleNameEl, titleSubEl); + headerLeft.append(brand, titleWrap); + + const headerRight = document.createElement('div'); + headerRight.className = 'qp-header-right'; + + const streamIndicator = document.createElement('div'); + streamIndicator.className = 'qp-stream-indicator'; + streamIndicator.hidden = true; + + const streamDot = document.createElement('span'); + streamDot.className = 'qp-stream-dot ac-pulse'; + + const streamText = document.createElement('span'); + streamText.textContent = 'Streaming'; + + streamIndicator.append(streamDot, streamText); + + const closeBtn = document.createElement('button'); + closeBtn.type = 'button'; + closeBtn.className = 'qp-icon-btn ac-focus-ring'; + closeBtn.innerHTML = ICON_CLOSE; + closeBtn.setAttribute('aria-label', 'Close Quick Panel'); + + headerRight.append(streamIndicator, closeBtn); + header.append(headerLeft, headerRight); + + // ---- Content ---- + const contentEl = document.createElement('div'); + contentEl.className = 'qp-content ac-scroll'; + + const emptyEl = document.createElement('div'); + emptyEl.className = 'qp-empty'; + + const emptyIcon = document.createElement('div'); + emptyIcon.className = 'qp-empty-icon'; + emptyIcon.textContent = '\u2726'; + + const emptyText = document.createElement('div'); + emptyText.className = 'qp-empty-text'; + emptyText.textContent = 'Ask about this page. Streaming replies appear here.'; + + emptyEl.append(emptyIcon, emptyText); + + const messagesEl = document.createElement('div'); + messagesEl.className = 'qp-messages'; + + contentEl.append(emptyEl, messagesEl); + + // ---- Composer ---- + const composer = document.createElement('div'); + composer.className = 'qp-composer'; + + const banner = document.createElement('div'); + banner.className = 'qp-status'; + banner.hidden = true; + + const textarea = document.createElement('textarea'); + textarea.className = 'qp-textarea ac-focus-ring'; + textarea.placeholder = placeholder; + textarea.rows = 1; + + const actions = document.createElement('div'); + actions.className = 'qp-actions'; + + const actionsLeft = document.createElement('div'); + actionsLeft.className = 'qp-actions-left'; + + // Keyboard hints + const hints = [ + { key: 'Enter', label: 'Send' }, + { key: 'Shift+Enter', label: 'New line' }, + { key: 'Esc', label: 'Close' }, + ]; + + for (const hint of hints) { + const keyEl = document.createElement('span'); + keyEl.className = 'qp-kbd'; + keyEl.textContent = hint.key; + + const labelEl = document.createElement('span'); + labelEl.textContent = hint.label; + + actionsLeft.append(keyEl, labelEl); + } + + const actionsRight = document.createElement('div'); + actionsRight.className = 'qp-actions-right'; + + // Unified action button: shows send icon normally, stop icon when loading + const actionBtn = document.createElement('button'); + actionBtn.type = 'button'; + actionBtn.className = 'qp-icon-btn qp-icon-btn--action qp-icon-btn--primary ac-focus-ring'; + actionBtn.innerHTML = ICON_SEND; + actionBtn.setAttribute('aria-label', 'Send message'); + actionBtn.dataset.action = 'send'; + + actionsRight.append(actionBtn); + actions.append(actionsLeft, actionsRight); + composer.append(banner, textarea, actions); + + // Assemble + panel.append(header, contentEl, composer); + overlay.append(panel); + + return { + overlay, + panel, + titleSubEl, + streamIndicator, + streamText, + closeBtn, + contentEl, + emptyEl, + messagesEl, + banner, + textarea, + actionBtn, + }; +} + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Mount the Quick Panel AI Chat interface. + * + * @example + * ```typescript + * const chatPanel = mountQuickPanelAiChatPanel({ + * mount: shadowHostElements.root, + * agentBridge, + * onRequestClose: () => quickPanel.hide(), + * }); + * + * // Later: clean up + * chatPanel.dispose(); + * ``` + */ +export function mountQuickPanelAiChatPanel( + options: QuickPanelAiChatPanelOptions, +): QuickPanelAiChatPanelManager { + const disposer = new Disposer(); + + const mount = options.mount; + const agentBridge = options.agentBridge; + const defaultSubtitle = options.subtitle?.trim() || DEFAULT_SUBTITLE; + + // Clean up any existing panel in same mount (crash recovery) + try { + const existing = mount.querySelector?.('[data-mcp-quick-panel-ai-chat="true"]'); + if (existing instanceof HTMLElement) { + existing.remove(); + } + } catch { + // Ignore cleanup errors + } + + // -------------------------------------------------------- + // State Management + // -------------------------------------------------------- + + let disposed = false; + let requestUnsubscribe: (() => void) | null = null; + let bannerTimer: ReturnType | null = null; + + let state: QuickPanelAiChatPanelState = { + sending: false, + streaming: false, + cancelling: false, + currentRequestId: null, + sessionId: null, + lastStatus: null, + lastUsage: null, + errorMessage: null, + }; + + // -------------------------------------------------------- + // DOM Setup + // -------------------------------------------------------- + + const dom = buildPanelDOM(options); + mount.append(dom.overlay); + disposer.add(() => dom.overlay.remove()); + + // Message renderer + const renderer: QuickPanelMessageRenderer = createQuickPanelMessageRenderer({ + container: dom.messagesEl, + scrollContainer: dom.contentEl, + autoScroll: true, + autoScrollThresholdPx: 96, + }); + disposer.add(() => renderer.dispose()); + + // -------------------------------------------------------- + // Banner Management + // -------------------------------------------------------- + + function clearBannerTimer(): void { + if (bannerTimer) { + clearTimeout(bannerTimer); + bannerTimer = null; + } + } + + function hideBanner(): void { + clearBannerTimer(); + dom.banner.hidden = true; + dom.banner.className = 'qp-status'; + dom.banner.textContent = ''; + } + + function showBanner( + tone: 'info' | 'success' | 'warning' | 'error', + message: string, + autoHideMs?: number, + ): void { + clearBannerTimer(); + dom.banner.hidden = false; + dom.banner.className = 'qp-status'; + + if (tone === 'error') dom.banner.classList.add('qp-status--error'); + if (tone === 'success') dom.banner.classList.add('qp-status--success'); + if (tone === 'warning') dom.banner.classList.add('qp-status--warning'); + + dom.banner.textContent = message; + + if (autoHideMs && autoHideMs > 0) { + bannerTimer = setTimeout(hideBanner, autoHideMs); + } + } + + // -------------------------------------------------------- + // Textarea Auto-resize + // -------------------------------------------------------- + + function resizeTextarea(): void { + try { + dom.textarea.style.height = 'auto'; + const targetHeight = Math.min( + TEXTAREA_MAX_HEIGHT_PX, + Math.max(TEXTAREA_MIN_HEIGHT_PX, dom.textarea.scrollHeight), + ); + dom.textarea.style.height = `${targetHeight}px`; + } catch { + // Ignore resize errors + } + } + + // -------------------------------------------------------- + // UI Rendering + // -------------------------------------------------------- + + function renderEmptyState(): void { + const hasMessages = renderer.getMessageCount() > 0; + dom.emptyEl.hidden = hasMessages; + dom.messagesEl.hidden = !hasMessages; + } + + function renderHeaderSubtitle(): void { + if (state.errorMessage) { + dom.titleSubEl.textContent = 'Error'; + return; + } + if (state.streaming) { + dom.titleSubEl.textContent = 'Streaming\u2026'; + return; + } + if (state.sending) { + dom.titleSubEl.textContent = 'Sending\u2026'; + return; + } + + const usageText = formatUsageStats(state.lastUsage); + dom.titleSubEl.textContent = usageText ? `Last: ${usageText}` : defaultSubtitle; + } + + function renderControls(): void { + const inputText = dom.textarea.value.trim(); + const isLoading = state.sending || state.streaming || state.cancelling; + const canSend = inputText.length > 0 && !isLoading; + const canCancel = state.currentRequestId !== null && !state.cancelling; + + // Update action button state and appearance + if (isLoading) { + // Show stop icon when loading/streaming + dom.actionBtn.innerHTML = ICON_STOP; + dom.actionBtn.setAttribute('aria-label', 'Stop request'); + dom.actionBtn.dataset.action = 'stop'; + dom.actionBtn.disabled = !canCancel; + dom.actionBtn.classList.remove('qp-icon-btn--primary'); + dom.actionBtn.classList.add('qp-icon-btn--danger'); + } else { + // Show send icon when idle + dom.actionBtn.innerHTML = ICON_SEND; + dom.actionBtn.setAttribute('aria-label', 'Send message'); + dom.actionBtn.dataset.action = 'send'; + dom.actionBtn.disabled = !canSend; + dom.actionBtn.classList.remove('qp-icon-btn--danger'); + dom.actionBtn.classList.add('qp-icon-btn--primary'); + } + + // Stream indicator + dom.streamIndicator.hidden = !isLoading; + if (state.cancelling) { + dom.streamText.textContent = 'Cancelling'; + } else if (state.sending) { + dom.streamText.textContent = 'Sending'; + } else { + dom.streamText.textContent = 'Streaming'; + } + + // Allow typing while streaming; disable only during send/cancel + dom.textarea.disabled = state.sending || state.cancelling; + + renderHeaderSubtitle(); + renderEmptyState(); + } + + function setState(patch: Partial): void { + state = { ...state, ...patch }; + renderControls(); + } + + // -------------------------------------------------------- + // Subscription Management + // -------------------------------------------------------- + + function cleanupActiveSubscription(): void { + if (requestUnsubscribe) { + try { + requestUnsubscribe(); + } catch { + // Ignore cleanup errors + } + requestUnsubscribe = null; + } + } + + // -------------------------------------------------------- + // Context Resolution + // -------------------------------------------------------- + + async function resolveContext(): Promise { + // Try custom context provider + try { + if (options.getContext) { + const provided = await options.getContext(); + if (provided && typeof provided === 'object') { + return provided; + } + } + } catch (err) { + console.warn(`${LOG_PREFIX} getContext failed:`, err); + } + + // Fallback to default context + const fallback = collectDefaultContext(); + + // Don't send empty context + if (!isNonEmptyString(fallback.pageUrl) && !isNonEmptyString(fallback.selectedText)) { + return undefined; + } + + return fallback; + } + + // -------------------------------------------------------- + // Request Lifecycle + // -------------------------------------------------------- + + async function sendCurrentInput(): Promise { + if (disposed) return; + if (state.sending || state.streaming || state.cancelling) return; + + const instruction = dom.textarea.value.trim(); + if (!instruction) return; + + // Clear previous errors + setState({ errorMessage: null, lastUsage: null, lastStatus: null }); + hideBanner(); + + // Save input for restoration on failure + const savedInput = dom.textarea.value; + dom.textarea.value = ''; + resizeTextarea(); + + setState({ sending: true }); + + // Resolve context + const context = await resolveContext(); + if (disposed) return; + + const payload: QuickPanelSendToAIPayload = { + instruction, + context: context ?? undefined, + }; + + // Send to agent + const result = await agentBridge.sendToAI(payload); + if (disposed) return; + + if (!result.success) { + // Restore input on failure + dom.textarea.value = savedInput; + resizeTextarea(); + + const errorMsg = truncateText(result.error, MAX_ERROR_DISPLAY_CHARS); + setState({ sending: false, errorMessage: errorMsg }); + showBanner('error', errorMsg); + return; + } + + // Optimistic user message rendering + // Note: Server will also echo user message; we render locally for instant feedback + // and skip server-echoed user messages in handleRequestEvent + renderer.upsert(buildLocalUserMessage(result.sessionId, result.requestId, instruction)); + renderer.scrollToBottom(); + + setState({ + sending: false, + streaming: true, + currentRequestId: result.requestId, + sessionId: result.sessionId, + lastStatus: 'starting', + }); + + // Subscribe to events + cleanupActiveSubscription(); + requestUnsubscribe = agentBridge.onRequestEvent(result.requestId, (event) => { + if (disposed) return; + handleRequestEvent(event); + }); + } + + async function cancelCurrentRequest(): Promise { + if (disposed) return; + if (!state.currentRequestId) return; + if (state.cancelling) return; + + const requestId = state.currentRequestId; + const sessionId = state.sessionId || undefined; + + setState({ cancelling: true }); + + const result = await agentBridge.cancelRequest(requestId, sessionId); + if (disposed) return; + + if (!result.success) { + const errorMsg = truncateText(result.error, MAX_ERROR_DISPLAY_CHARS); + setState({ cancelling: false, errorMessage: errorMsg }); + showBanner('error', errorMsg); + return; + } + + // Cancellation completion will be driven by the 'cancelled' status event + setState({ cancelling: false }); + } + + function handleTerminal(status: AgentStatusEvent['status'], message?: string): void { + cleanupActiveSubscription(); + + setState({ + streaming: false, + sending: false, + cancelling: false, + currentRequestId: null, + sessionId: null, + lastStatus: status, + }); + + if (status === 'completed') { + const usageText = formatUsageStats(state.lastUsage); + const bannerMsg = usageText ? `Completed \u2022 ${usageText}` : 'Completed'; + showBanner('success', bannerMsg, BANNER_AUTO_HIDE_MS); + return; + } + + if (status === 'cancelled') { + showBanner('warning', 'Cancelled', BANNER_AUTO_HIDE_MS); + return; + } + + if (status === 'error') { + const errorMsg = truncateText( + message || state.errorMessage || 'Request failed', + MAX_ERROR_DISPLAY_CHARS, + ); + setState({ errorMessage: errorMsg }); + showBanner('error', errorMsg); + } + } + + /** + * Handle incoming RealtimeEvent with runtime guards for malformed data. + */ + function handleRequestEvent(event: RealtimeEvent): void { + if (disposed) return; + + // Runtime guard: validate event structure + if (!event || typeof event !== 'object' || !('type' in event)) { + console.warn(`${LOG_PREFIX} Invalid event structure:`, event); + return; + } + + try { + switch (event.type) { + case 'message': { + const msg = event.data; + + // Runtime guard: validate message structure + if (!msg || typeof msg !== 'object' || typeof msg.id !== 'string') { + console.warn(`${LOG_PREFIX} Invalid message data:`, msg); + return; + } + + // For user messages from server, replace local optimistic message + // This preserves server-side metadata (cliSource, etc.) + if (msg.role === 'user') { + const localUserId = `local-user:${msg.requestId}`; + renderer.remove(localUserId); + } + + renderer.upsert(msg); + + if (msg.isStreaming === true && !msg.isFinal) { + setState({ streaming: true }); + } + return; + } + + case 'status': { + const statusData = event.data; + + // Runtime guard: validate status data + if ( + !statusData || + typeof statusData !== 'object' || + typeof statusData.status !== 'string' + ) { + console.warn(`${LOG_PREFIX} Invalid status data:`, statusData); + return; + } + + setState({ lastStatus: statusData.status }); + + if ( + statusData.status === 'starting' || + statusData.status === 'ready' || + statusData.status === 'running' + ) { + setState({ streaming: true }); + return; + } + + if (isTerminalStatus(statusData.status)) { + handleTerminal(statusData.status, statusData.message); + } + return; + } + + case 'usage': { + setState({ lastUsage: event.data }); + return; + } + + case 'error': { + const errorMsg = truncateText(event.error || 'Unknown error', MAX_ERROR_DISPLAY_CHARS); + setState({ errorMessage: errorMsg }); + showBanner('error', errorMsg); + + cleanupActiveSubscription(); + setState({ + streaming: false, + sending: false, + cancelling: false, + currentRequestId: null, + sessionId: null, + lastStatus: 'error', + }); + return; + } + + case 'connected': + case 'heartbeat': { + // These events are typically filtered by background, but handle exhaustively + return; + } + } + } catch (err) { + // Catch any unexpected errors to prevent UI crash + console.warn(`${LOG_PREFIX} Error handling event:`, err, event); + } + } + + // -------------------------------------------------------- + // Event Handlers + // -------------------------------------------------------- + + disposer.listen(dom.overlay, 'click', (ev: MouseEvent) => { + if (disposed) return; + // Close on backdrop click + if (ev.target === dom.overlay) { + close(); + } + }); + + disposer.listen(dom.closeBtn, 'click', () => close()); + + // Unified action button handler: send or stop based on current state + disposer.listen(dom.actionBtn, 'click', () => { + if (disposed) return; + const action = dom.actionBtn.dataset.action; + if (action === 'stop') { + void cancelCurrentRequest(); + } else { + void sendCurrentInput(); + } + }); + + disposer.listen(dom.textarea, 'input', () => { + if (disposed) return; + resizeTextarea(); + renderControls(); + }); + + disposer.listen(dom.textarea, 'keydown', (ev: KeyboardEvent) => { + if (disposed) return; + + // Esc closes the panel + if (ev.key === 'Escape' && !ev.isComposing) { + ev.preventDefault(); + close(); + return; + } + + // Enter sends, Shift+Enter inserts newline + if (ev.key === 'Enter' && !ev.shiftKey && !ev.isComposing) { + ev.preventDefault(); + void sendCurrentInput(); + } + }); + + // -------------------------------------------------------- + // Public API + // -------------------------------------------------------- + + function focusInput(): void { + if (disposed) return; + safeFocus(dom.textarea); + } + + function clearMessages(): void { + if (disposed) return; + renderer.clear(); + hideBanner(); + setState({ lastUsage: null, lastStatus: null, errorMessage: null }); + } + + function close(): void { + if (disposed) return; + + // Best-effort cancel on close + if (state.currentRequestId) { + void cancelCurrentRequest(); + } + + try { + options.onRequestClose?.(); + } catch (err) { + console.warn(`${LOG_PREFIX} onRequestClose failed:`, err); + } + + dispose(); + } + + function dispose(): void { + if (disposed) return; + disposed = true; + + cleanupActiveSubscription(); + clearBannerTimer(); + disposer.dispose(); + } + + // -------------------------------------------------------- + // Initialization + // -------------------------------------------------------- + + resizeTextarea(); + renderControls(); + + if (options.autoFocus !== false) { + focusInput(); + } + + return { + getState: () => ({ ...state }), + focusInput, + clearMessages, + close, + dispose, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/index.ts b/app/chrome-extension/shared/quick-panel/ui/index.ts new file mode 100644 index 00000000..199ad4af --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/index.ts @@ -0,0 +1,69 @@ +/** + * Quick Panel UI Module Index + * + * Exports all UI components for the Quick Panel feature. + */ + +// ============================================================ +// Shell (unified container for search + chat views) +// ============================================================ + +export { + mountQuickPanelShell, + type QuickPanelShellElements, + type QuickPanelShellManager, + type QuickPanelShellOptions, +} from './panel-shell'; + +// ============================================================ +// Shadow DOM host +// ============================================================ + +export { + mountQuickPanelShadowHost, + type QuickPanelShadowHostElements, + type QuickPanelShadowHostManager, + type QuickPanelShadowHostOptions, +} from './shadow-host'; + +// ============================================================ +// Search UI Components +// ============================================================ + +export { + createSearchInput, + type SearchInputManager, + type SearchInputOptions, + type SearchInputState, +} from './search-input'; + +export { + createQuickEntries, + type QuickEntriesManager, + type QuickEntriesOptions, +} from './quick-entries'; + +// ============================================================ +// AI Chat Components +// ============================================================ + +export { + createQuickPanelMessageRenderer, + type QuickPanelMessageRenderer, + type QuickPanelMessageRendererOptions, +} from './message-renderer'; + +export { createMarkdownRenderer, type MarkdownRendererInstance } from './markdown-renderer'; + +export { + mountQuickPanelAiChatPanel, + type QuickPanelAiChatPanelManager, + type QuickPanelAiChatPanelOptions, + type QuickPanelAiChatPanelState, +} from './ai-chat-panel'; + +// ============================================================ +// Styles +// ============================================================ + +export { QUICK_PANEL_STYLES } from './styles'; diff --git a/app/chrome-extension/shared/quick-panel/ui/markdown-renderer.ts b/app/chrome-extension/shared/quick-panel/ui/markdown-renderer.ts new file mode 100644 index 00000000..da6c3d00 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/markdown-renderer.ts @@ -0,0 +1,60 @@ +/** + * Quick Panel Markdown Renderer + * + * Simple markdown renderer for Quick Panel. + * Currently uses plain text rendering - markdown support to be added later + * when proper Vue/content-script integration is resolved. + */ + +// ============================================================ +// Types +// ============================================================ + +export interface MarkdownRendererInstance { + /** Update the markdown content */ + setContent: (content: string, isStreaming?: boolean) => void; + /** Get current content */ + getContent: () => string; + /** Dispose resources */ + dispose: () => void; +} + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Create a markdown renderer instance that mounts to a container element. + * Currently renders as plain text - markdown support pending. + * + * @param container - The DOM element to render content into + * @returns Markdown renderer instance with setContent and dispose methods + */ +export function createMarkdownRenderer(container: HTMLElement): MarkdownRendererInstance { + let currentContent = ''; + + // Create a wrapper div for content + const contentEl = document.createElement('div'); + contentEl.className = 'qp-markdown-content'; + container.appendChild(contentEl); + + return { + setContent(newContent: string, _streaming = false) { + currentContent = newContent; + // For now, render as plain text with basic whitespace preservation + contentEl.textContent = newContent; + }, + + getContent() { + return currentContent; + }, + + dispose() { + try { + contentEl.remove(); + } catch { + // Best-effort cleanup + } + }, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/message-renderer.ts b/app/chrome-extension/shared/quick-panel/ui/message-renderer.ts new file mode 100644 index 00000000..8a828839 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/message-renderer.ts @@ -0,0 +1,449 @@ +/** + * Quick Panel Message Renderer + * + * Renders AgentChat-compatible messages for the Quick Panel AI Chat UI. + * Features: + * - Markdown rendering for assistant messages via markstream-vue + * - XSS-safe rendering for user messages (textContent only) + * - Streaming message support (in-place updates via message id) + * - Auto-scroll with proximity detection + * - Memory-efficient DOM recycling + */ + +import type { AgentMessage, AgentRole } from 'chrome-mcp-shared'; +import { createMarkdownRenderer, type MarkdownRendererInstance } from './markdown-renderer'; + +// ============================================================ +// Types +// ============================================================ + +export interface QuickPanelMessageRendererOptions { + /** Container element for message nodes (typically `.qp-messages`) */ + container: HTMLElement; + /** Scroll container for auto-scroll heuristics (typically `.qp-content`) */ + scrollContainer?: HTMLElement | null; + /** Auto-scroll on new/updated messages when user is near bottom. Default: true */ + autoScroll?: boolean; + /** Pixel threshold for "near bottom" detection. Default: 96 */ + autoScrollThresholdPx?: number; +} + +export interface QuickPanelMessageRenderer { + /** Insert or update a message by id */ + upsert: (message: AgentMessage) => void; + /** Remove a message by id */ + remove: (messageId: string) => void; + /** Clear all messages */ + clear: () => void; + /** Replace all messages with a new array */ + setMessages: (messages: AgentMessage[]) => void; + /** Get current message count */ + getMessageCount: () => number; + /** Force scroll to bottom */ + scrollToBottom: () => void; + /** Clean up resources */ + dispose: () => void; +} + +// ============================================================ +// Internal Types +// ============================================================ + +/** DOM elements for a single message entry */ +interface MessageEntry { + wrapper: HTMLDivElement; + bubble: HTMLDivElement; + textEl: HTMLDivElement; + metaEl: HTMLDivElement; + metaLeftEl: HTMLDivElement; + streamDotEl: HTMLSpanElement; + timeEl: HTMLSpanElement; + metaRightEl: HTMLSpanElement; + requestIdEl: HTMLElement; + /** Markdown renderer for assistant messages */ + markdownRenderer: MarkdownRendererInstance | null; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_AUTO_SCROLL_THRESHOLD_PX = 96; + +/** Maximum length for truncated request ID display */ +const REQUEST_ID_DISPLAY_LENGTH = 10; + +// ============================================================ +// Utility Functions +// ============================================================ + +function isNonEmptyString(value: unknown): value is string { + return typeof value === 'string' && value.trim().length > 0; +} + +function joinClasses(...parts: Array): string { + return parts.filter(Boolean).join(' '); +} + +function formatMessageTime(isoString: string): string { + const date = new Date(isoString); + if (Number.isNaN(date.getTime())) return ''; + + try { + return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }); + } catch { + return ''; + } +} + +function isStreamingMessage(message: AgentMessage): boolean { + return message.isStreaming === true && message.isFinal !== true; +} + +function getWrapperClassName(role: AgentRole): string { + return role === 'user' ? 'qp-msg qp-msg--user' : 'qp-msg qp-msg--assistant'; +} + +function getBubbleClassName(role: AgentRole): string { + return joinClasses('qp-bubble', role === 'user' && 'qp-bubble--user'); +} + +function formatRequestIdForDisplay(requestId: string): { short: string; full: string } { + const full = requestId.trim(); + const short = + full.length <= REQUEST_ID_DISPLAY_LENGTH ? full : full.slice(0, REQUEST_ID_DISPLAY_LENGTH); + return { short, full }; +} + +/** + * Get a label prefix for special message types + */ +function getMessageTypeLabel(message: AgentMessage): string | null { + if (message.role === 'tool') return 'Tool'; + if (message.role === 'system') return 'System'; + if (message.messageType === 'tool_use') return 'Tool'; + if (message.messageType === 'tool_result') return 'Result'; + return null; +} + +// ============================================================ +// DOM Creation Helpers +// ============================================================ + +function createMetaLeftElement(): { + container: HTMLDivElement; + streamDot: HTMLSpanElement; + time: HTMLSpanElement; +} { + const container = document.createElement('div'); + Object.assign(container.style, { + display: 'inline-flex', + alignItems: 'center', + gap: '6px', + minWidth: '0', + }); + + const streamDot = document.createElement('span'); + streamDot.className = 'qp-msg-stream-dot ac-pulse'; + streamDot.hidden = true; + + const time = document.createElement('span'); + + container.append(streamDot, time); + + return { container, streamDot, time }; +} + +function createMetaRightElement(): { container: HTMLSpanElement; requestId: HTMLElement } { + const container = document.createElement('span'); + container.hidden = true; + + const requestId = document.createElement('code'); + + container.append(requestId); + + return { container, requestId }; +} + +function createMessageEntry(messageId: string, message: AgentMessage): MessageEntry { + const wrapper = document.createElement('div'); + wrapper.className = getWrapperClassName(message.role); + wrapper.dataset.messageId = messageId; + wrapper.dataset.role = message.role; + wrapper.dataset.messageType = message.messageType; + + const bubble = document.createElement('div'); + bubble.className = getBubbleClassName(message.role); + + const textEl = document.createElement('div'); + textEl.className = 'qp-msg-text'; + + const metaEl = document.createElement('div'); + metaEl.className = 'qp-msg-meta'; + + const metaLeft = createMetaLeftElement(); + const metaRight = createMetaRightElement(); + + metaEl.append(metaLeft.container, metaRight.container); + bubble.append(textEl, metaEl); + wrapper.append(bubble); + + // Create markdown renderer for assistant messages + let markdownRenderer: MarkdownRendererInstance | null = null; + if (message.role === 'assistant') { + markdownRenderer = createMarkdownRenderer(textEl); + } + + return { + wrapper, + bubble, + textEl, + metaEl, + metaLeftEl: metaLeft.container, + streamDotEl: metaLeft.streamDot, + timeEl: metaLeft.time, + metaRightEl: metaRight.container, + requestIdEl: metaRight.requestId, + markdownRenderer, + }; +} + +// ============================================================ +// Entry Update Logic +// ============================================================ + +function updateMessageEntry(entry: MessageEntry, messageId: string, message: AgentMessage): void { + // Update wrapper classes and data attributes + const wrapperClass = getWrapperClassName(message.role); + if (entry.wrapper.className !== wrapperClass) { + entry.wrapper.className = wrapperClass; + } + + entry.wrapper.dataset.role = message.role; + entry.wrapper.dataset.messageType = message.messageType; + entry.wrapper.dataset.messageId = messageId; + + // Update bubble class + const bubbleClass = getBubbleClassName(message.role); + if (entry.bubble.className !== bubbleClass) { + entry.bubble.className = bubbleClass; + } + + // Update content based on message role + const textContent = message.content ?? ''; + + if (message.role === 'assistant' && entry.markdownRenderer) { + // Use markdown renderer for assistant messages + entry.markdownRenderer.setContent(textContent, isStreamingMessage(message)); + } else { + // Use plain text for user messages (XSS-safe) + if (entry.textEl.textContent !== textContent) { + entry.textEl.textContent = textContent; + } + } + + // Update time display + const typeLabel = getMessageTypeLabel(message); + const timeText = formatMessageTime(message.createdAt) || '\u2014'; // em dash for empty + entry.timeEl.textContent = typeLabel ? `${typeLabel} \u2022 ${timeText}` : timeText; + + // Update streaming indicator + entry.streamDotEl.hidden = !isStreamingMessage(message); + + // Update request ID display + const rawRequestId = isNonEmptyString(message.requestId) ? message.requestId.trim() : ''; + if (rawRequestId) { + const formatted = formatRequestIdForDisplay(rawRequestId); + entry.requestIdEl.textContent = formatted.short; + entry.requestIdEl.title = formatted.full; + entry.metaRightEl.hidden = false; + } else { + entry.requestIdEl.textContent = ''; + entry.requestIdEl.title = ''; + entry.metaRightEl.hidden = true; + } +} + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Create a message renderer instance for the Quick Panel AI Chat. + * + * @example + * ```typescript + * const renderer = createQuickPanelMessageRenderer({ + * container: messagesEl, + * scrollContainer: contentEl, + * }); + * + * // Render streaming message + * renderer.upsert(message); + * + * // Clean up + * renderer.dispose(); + * ``` + */ +export function createQuickPanelMessageRenderer( + options: QuickPanelMessageRendererOptions, +): QuickPanelMessageRenderer { + const container = options.container; + const scrollContainer = options.scrollContainer ?? null; + const autoScroll = options.autoScroll ?? true; + const thresholdPx = options.autoScrollThresholdPx ?? DEFAULT_AUTO_SCROLL_THRESHOLD_PX; + + /** Map of messageId -> DOM entry */ + const entries = new Map(); + + let disposed = false; + + // -------------------------------------------------------- + // Scroll Management + // -------------------------------------------------------- + + function isNearBottom(): boolean { + if (!scrollContainer) return true; + + const { scrollHeight, scrollTop, clientHeight } = scrollContainer; + const distanceFromBottom = scrollHeight - scrollTop - clientHeight; + return distanceFromBottom <= thresholdPx; + } + + function scrollToBottom(): void { + if (!scrollContainer) return; + + try { + scrollContainer.scrollTo({ top: scrollContainer.scrollHeight }); + } catch { + // Fallback for older browsers + scrollContainer.scrollTop = scrollContainer.scrollHeight; + } + } + + // -------------------------------------------------------- + // Core Operations + // -------------------------------------------------------- + + function upsert(message: AgentMessage): void { + if (disposed) return; + + const messageId = message.id?.trim(); + if (!messageId) return; + + const shouldAutoScroll = autoScroll && isNearBottom(); + + let entry = entries.get(messageId); + if (!entry) { + entry = createMessageEntry(messageId, message); + entries.set(messageId, entry); + container.append(entry.wrapper); + } + + updateMessageEntry(entry, messageId, message); + + if (shouldAutoScroll) { + scrollToBottom(); + } + } + + function remove(messageId: string): void { + if (disposed) return; + + const id = messageId?.trim(); + if (!id) return; + + const entry = entries.get(id); + if (!entry) return; + + entries.delete(id); + + // Dispose markdown renderer if exists + if (entry.markdownRenderer) { + entry.markdownRenderer.dispose(); + } + + try { + entry.wrapper.remove(); + } catch { + // Fallback for edge cases + entry.wrapper.parentElement?.removeChild(entry.wrapper); + } + } + + function clear(): void { + if (disposed) return; + + // Dispose all markdown renderers + for (const entry of entries.values()) { + if (entry.markdownRenderer) { + entry.markdownRenderer.dispose(); + } + } + + entries.clear(); + container.textContent = ''; + } + + function setMessages(messages: AgentMessage[]): void { + if (disposed) return; + + // Dispose all existing markdown renderers + for (const entry of entries.values()) { + if (entry.markdownRenderer) { + entry.markdownRenderer.dispose(); + } + } + + // Clear existing state + entries.clear(); + container.textContent = ''; + + // Render all messages + for (const msg of messages) { + const id = msg.id?.trim(); + if (!id) continue; + + const entry = createMessageEntry(id, msg); + entries.set(id, entry); + updateMessageEntry(entry, id, msg); + container.append(entry.wrapper); + } + + // Scroll to bottom after batch render + scrollToBottom(); + } + + function getMessageCount(): number { + return entries.size; + } + + function dispose(): void { + if (disposed) return; + disposed = true; + + // Dispose all markdown renderers + for (const entry of entries.values()) { + if (entry.markdownRenderer) { + entry.markdownRenderer.dispose(); + } + } + + entries.clear(); + container.textContent = ''; + } + + // -------------------------------------------------------- + // Public API + // -------------------------------------------------------- + + return { + upsert, + remove, + clear, + setMessages, + getMessageCount, + scrollToBottom, + dispose, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/panel-shell.ts b/app/chrome-extension/shared/quick-panel/ui/panel-shell.ts new file mode 100644 index 00000000..56a2fc76 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/panel-shell.ts @@ -0,0 +1,314 @@ +/** + * Quick Panel Shell + * + * A unified panel container that hosts multiple views: + * - `search`: the launcher/search UI (Phase 1+) + * - `chat`: AI Chat view (existing capability) + * + * The shell owns the overlay + glass panel layout and provides isolated + * mount points per-view for header/content/footer sections. + */ + +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import type { QuickPanelView } from '../core/types'; + +// SVG Icons +const ICON_CLOSE = ``; + +// ============================================================ +// Types +// ============================================================ + +export interface QuickPanelShellElements { + /** Overlay backdrop */ + overlay: HTMLDivElement; + /** Main panel container */ + panel: HTMLDivElement; + + /** Header section */ + header: HTMLDivElement; + headerLeft: HTMLDivElement; + headerRight: HTMLDivElement; + closeBtn: HTMLButtonElement; + + /** View-specific header mounts */ + headerSearchMount: HTMLDivElement; + headerChatMount: HTMLDivElement; + headerRightSearchMount: HTMLDivElement; + headerRightChatMount: HTMLDivElement; + + /** Content section */ + content: HTMLDivElement; + contentSearchMount: HTMLDivElement; + contentChatMount: HTMLDivElement; + + /** Footer section */ + footer: HTMLDivElement; + footerSearchMount: HTMLDivElement; + footerChatMount: HTMLDivElement; +} + +export interface QuickPanelShellOptions { + /** Shadow DOM mount point (typically `elements.root` from shadow-host.ts) */ + mount: HTMLElement; + /** Default view on mount. Default: `search` */ + defaultView?: QuickPanelView; + /** Accessible label for the dialog. Default: "Quick Panel" */ + ariaLabel?: string; + /** Close when clicking the backdrop. Default: true */ + closeOnBackdropClick?: boolean; + /** Called when close is requested (button/backdrop/api) */ + onRequestClose?: (reason: 'button' | 'backdrop' | 'api') => void; + /** Called after view changes */ + onViewChange?: (view: QuickPanelView) => void; +} + +export interface QuickPanelShellManager { + /** Get shell elements (null if disposed) */ + getElements: () => QuickPanelShellElements | null; + /** Get current view */ + getView: () => QuickPanelView; + /** Switch to a different view */ + setView: (view: QuickPanelView) => void; + /** Request panel close */ + requestClose: (reason?: 'button' | 'backdrop' | 'api') => void; + /** Clean up resources */ + dispose: () => void; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_ARIA_LABEL = 'Quick Panel'; +const DEFAULT_VIEW: QuickPanelView = 'search'; + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Mount the Quick Panel shell. + * + * @example + * ```typescript + * const shell = mountQuickPanelShell({ + * mount: shadowHostElements.root, + * defaultView: 'search', + * onRequestClose: () => quickPanel.hide(), + * }); + * + * // Get mount points for search view + * const elements = shell.getElements(); + * if (elements) { + * // Mount search input to elements.headerSearchMount + * // Mount results to elements.contentSearchMount + * } + * + * // Switch to chat view + * shell.setView('chat'); + * + * // Cleanup + * shell.dispose(); + * ``` + */ +export function mountQuickPanelShell(options: QuickPanelShellOptions): QuickPanelShellManager { + const disposer = new Disposer(); + const mount = options.mount; + const closeOnBackdropClick = options.closeOnBackdropClick ?? true; + + let disposed = false; + let elements: QuickPanelShellElements | null = null; + let currentView: QuickPanelView = options.defaultView ?? DEFAULT_VIEW; + + // Best-effort cleanup (crash recovery / duplicate mounts) + try { + const existing = mount.querySelector?.('[data-mcp-quick-panel-shell="true"]'); + if (existing instanceof HTMLElement) { + existing.remove(); + } + } catch { + // Ignore cleanup errors + } + + // -------------------------------------------------------- + // DOM Construction + // -------------------------------------------------------- + + const overlay = document.createElement('div'); + overlay.className = 'qp-overlay'; + overlay.setAttribute('data-mcp-quick-panel-shell', 'true'); + + const panel = document.createElement('div'); + panel.className = 'qp-panel'; + panel.setAttribute('role', 'dialog'); + panel.setAttribute('aria-modal', 'true'); + panel.setAttribute('aria-label', options.ariaLabel?.trim() || DEFAULT_ARIA_LABEL); + panel.dataset.qpView = currentView; + + // Header + const header = document.createElement('div'); + header.className = 'qp-header'; + + const headerLeft = document.createElement('div'); + headerLeft.className = 'qp-header-left'; + + const headerSearchMount = document.createElement('div'); + headerSearchMount.className = 'qp-header-mount qp-header-mount--search'; + + const headerChatMount = document.createElement('div'); + headerChatMount.className = 'qp-header-mount qp-header-mount--chat'; + + headerLeft.append(headerSearchMount, headerChatMount); + + const headerRight = document.createElement('div'); + headerRight.className = 'qp-header-right'; + + const headerRightSearchMount = document.createElement('div'); + headerRightSearchMount.className = 'qp-header-right-mount qp-header-right-mount--search'; + + const headerRightChatMount = document.createElement('div'); + headerRightChatMount.className = 'qp-header-right-mount qp-header-right-mount--chat'; + + const closeBtn = document.createElement('button'); + closeBtn.type = 'button'; + closeBtn.className = 'qp-icon-btn ac-focus-ring'; + closeBtn.innerHTML = ICON_CLOSE; + closeBtn.setAttribute('aria-label', 'Close Quick Panel'); + + headerRight.append(headerRightSearchMount, headerRightChatMount, closeBtn); + header.append(headerLeft, headerRight); + + // Content + const content = document.createElement('div'); + content.className = 'qp-content ac-scroll'; + + const contentSearchMount = document.createElement('div'); + contentSearchMount.className = 'qp-content-mount qp-content-mount--search'; + + const contentChatMount = document.createElement('div'); + contentChatMount.className = 'qp-content-mount qp-content-mount--chat'; + + content.append(contentSearchMount, contentChatMount); + + // Footer (reuse `.qp-composer` for consistent glass divider/padding) + const footer = document.createElement('div'); + footer.className = 'qp-composer'; + + const footerSearchMount = document.createElement('div'); + footerSearchMount.className = 'qp-footer-mount qp-footer-mount--search'; + + const footerChatMount = document.createElement('div'); + footerChatMount.className = 'qp-footer-mount qp-footer-mount--chat'; + + footer.append(footerSearchMount, footerChatMount); + + // Assemble + panel.append(header, content, footer); + overlay.append(panel); + mount.append(overlay); + disposer.add(() => overlay.remove()); + + elements = { + overlay, + panel, + header, + headerLeft, + headerRight, + closeBtn, + headerSearchMount, + headerChatMount, + headerRightSearchMount, + headerRightChatMount, + content, + contentSearchMount, + contentChatMount, + footer, + footerSearchMount, + footerChatMount, + }; + + // -------------------------------------------------------- + // View Switching + // -------------------------------------------------------- + + function renderView(view: QuickPanelView): void { + if (!elements) return; + + elements.panel.dataset.qpView = view; + + // Search view visibility + const isSearch = view === 'search'; + elements.headerSearchMount.hidden = !isSearch; + elements.headerRightSearchMount.hidden = !isSearch; + elements.contentSearchMount.hidden = !isSearch; + elements.footerSearchMount.hidden = !isSearch; + + // Chat view visibility + const isChat = view === 'chat'; + elements.headerChatMount.hidden = !isChat; + elements.headerRightChatMount.hidden = !isChat; + elements.contentChatMount.hidden = !isChat; + elements.footerChatMount.hidden = !isChat; + } + + function setView(view: QuickPanelView): void { + if (disposed) return; + if (view !== 'search' && view !== 'chat') return; + if (view === currentView) return; + + currentView = view; + renderView(currentView); + + try { + options.onViewChange?.(currentView); + } catch { + // Best-effort callback + } + } + + // Apply initial visibility + renderView(currentView); + + // -------------------------------------------------------- + // Close Handling + // -------------------------------------------------------- + + function requestClose(reason: 'button' | 'backdrop' | 'api' = 'api'): void { + if (disposed) return; + + try { + options.onRequestClose?.(reason); + } catch { + // Best-effort: caller owns lifecycle + } + } + + disposer.listen(closeBtn, 'click', () => requestClose('button')); + + if (closeOnBackdropClick) { + disposer.listen(overlay, 'click', (ev: MouseEvent) => { + if (disposed) return; + if (ev.target === overlay) { + requestClose('backdrop'); + } + }); + } + + // -------------------------------------------------------- + // Public API + // -------------------------------------------------------- + + return { + getElements: () => elements, + getView: () => currentView, + setView, + requestClose, + dispose: () => { + if (disposed) return; + disposed = true; + elements = null; + disposer.dispose(); + }, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/quick-entries.ts b/app/chrome-extension/shared/quick-panel/ui/quick-entries.ts new file mode 100644 index 00000000..5d68f59e --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/quick-entries.ts @@ -0,0 +1,178 @@ +/** + * Quick Panel Quick Entries + * + * Four-grid shortcuts for quickly switching scopes: + * - Tabs / Bookmarks / History / Commands + * + * Following PRD spec for Quick Panel entry UI. + */ + +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import { QUICK_PANEL_SCOPES, normalizeQuickPanelScope, type QuickPanelScope } from '../core/types'; + +// ============================================================ +// Types +// ============================================================ + +export interface QuickEntriesOptions { + /** Container to mount quick entries */ + container: HTMLElement; + /** + * Scopes to render as quick entries. + * Default: tabs/bookmarks/history/commands + */ + scopes?: readonly QuickPanelScope[]; + /** Called when an entry is selected */ + onSelect: (scope: QuickPanelScope) => void; +} + +export interface QuickEntriesManager { + /** Root DOM element */ + root: HTMLDivElement; + /** Set the active (highlighted) scope */ + setActiveScope: (scope: QuickPanelScope | null) => void; + /** Enable/disable a specific entry */ + setDisabled: (scope: QuickPanelScope, disabled: boolean) => void; + /** Show/hide the quick entries grid */ + setVisible: (visible: boolean) => void; + /** Clean up resources */ + dispose: () => void; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_SCOPES: QuickPanelScope[] = ['tabs', 'bookmarks', 'history', 'commands']; + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Create Quick Panel quick entries component. + * + * @example + * ```typescript + * const quickEntries = createQuickEntries({ + * container: contentSearchMount, + * onSelect: (scope) => { + * searchInput.setScope(scope); + * controller.search(scope, ''); + * }, + * }); + * + * // Highlight active scope + * quickEntries.setActiveScope('tabs'); + * + * // Cleanup + * quickEntries.dispose(); + * ``` + */ +export function createQuickEntries(options: QuickEntriesOptions): QuickEntriesManager { + const disposer = new Disposer(); + let disposed = false; + + const scopes = (options.scopes?.length ? [...options.scopes] : DEFAULT_SCOPES).map((s) => + normalizeQuickPanelScope(s), + ); + + // -------------------------------------------------------- + // DOM Construction + // -------------------------------------------------------- + + const root = document.createElement('div'); + root.className = 'qp-entries'; + options.container.append(root); + disposer.add(() => root.remove()); + + const buttonsByScope = new Map(); + + function createEntry(scope: QuickPanelScope): HTMLButtonElement { + const def = QUICK_PANEL_SCOPES[scope]; + + const btn = document.createElement('button'); + btn.type = 'button'; + btn.className = 'qp-entry ac-btn ac-focus-ring'; + btn.dataset.scope = scope; + btn.dataset.active = 'false'; + btn.setAttribute('aria-label', `Switch scope to ${def.label}`); + + const icon = document.createElement('div'); + icon.className = 'qp-entry__icon'; + icon.textContent = def.icon; + + const label = document.createElement('div'); + label.className = 'qp-entry__label'; + label.textContent = def.label; + + const prefix = document.createElement('div'); + prefix.className = 'qp-entry__prefix'; + prefix.textContent = def.prefix ? def.prefix.trim() : ''; + prefix.hidden = !def.prefix; + + btn.append(icon, label, prefix); + + disposer.listen(btn, 'click', () => { + if (disposed) return; + options.onSelect(scope); + }); + + return btn; + } + + // Build entries + for (const scope of scopes) { + // Only render known scopes and avoid 'all' in quick entries + if (!(scope in QUICK_PANEL_SCOPES) || scope === 'all') continue; + + const btn = createEntry(scope); + buttonsByScope.set(scope, btn); + root.append(btn); + } + + // -------------------------------------------------------- + // State Management + // -------------------------------------------------------- + + function setActiveScope(scope: QuickPanelScope | null): void { + if (disposed) return; + + const active = scope ? normalizeQuickPanelScope(scope) : null; + for (const [id, btn] of buttonsByScope) { + btn.dataset.active = active === id ? 'true' : 'false'; + } + } + + function setDisabled(scope: QuickPanelScope, disabled: boolean): void { + if (disposed) return; + + const id = normalizeQuickPanelScope(scope); + const btn = buttonsByScope.get(id); + if (!btn) return; + + btn.disabled = disabled; + } + + function setVisible(visible: boolean): void { + if (disposed) return; + root.hidden = !visible; + } + + // -------------------------------------------------------- + // Public API + // -------------------------------------------------------- + + return { + root, + setActiveScope, + setDisabled, + setVisible, + dispose: () => { + if (disposed) return; + disposed = true; + buttonsByScope.clear(); + disposer.dispose(); + }, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/search-input.ts b/app/chrome-extension/shared/quick-panel/ui/search-input.ts new file mode 100644 index 00000000..82bf2a49 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/search-input.ts @@ -0,0 +1,386 @@ +/** + * Quick Panel Search Input + * + * A scope-aware search input component with: + * - PRD-defined scope prefixes (t/b/h/c/>) + * - Scope chip for visual indication and cycling + * - XSS-safe rendering (textContent/value only) + * - IME composition handling + * - Disposer-based cleanup + */ + +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import { + DEFAULT_SCOPE, + QUICK_PANEL_SCOPES, + normalizeQuickPanelScope, + parseScopePrefixedQuery, + type QuickPanelScope, +} from '../core/types'; + +// ============================================================ +// Types +// ============================================================ + +export interface SearchInputState { + scope: QuickPanelScope; + query: string; +} + +export interface SearchInputOptions { + /** Container to mount the search input */ + container: HTMLElement; + /** Initial scope. Default: 'all' */ + initialScope?: QuickPanelScope; + /** Initial query string */ + initialQuery?: string; + /** Input placeholder. Default: 'Search...' */ + placeholder?: string; + /** Auto-focus on mount. Default: true */ + autoFocus?: boolean; + /** + * Available scopes for cycling. + * Default: all known scopes + */ + availableScopes?: readonly QuickPanelScope[]; + + /** Called when state changes (scope or query) */ + onChange?: (state: SearchInputState) => void; + /** Called when scope changes */ + onScopeChange?: (scope: QuickPanelScope) => void; + /** Called when query changes */ + onQueryChange?: (query: string) => void; + /** Called when clear button is clicked */ + onClear?: () => void; +} + +export interface SearchInputManager { + /** Root DOM element */ + root: HTMLDivElement; + /** Input element */ + input: HTMLInputElement; + /** Get current state */ + getState: () => SearchInputState; + /** Set scope programmatically */ + setScope: (scope: QuickPanelScope, options?: { emit?: boolean }) => void; + /** Set query programmatically */ + setQuery: (query: string, options?: { emit?: boolean }) => void; + /** Clear the input */ + clear: (options?: { emit?: boolean }) => void; + /** Focus the input */ + focus: () => void; + /** Clean up resources */ + dispose: () => void; +} + +// ============================================================ +// Helpers +// ============================================================ + +function isNonEmptyString(value: unknown): value is string { + return typeof value === 'string' && value.trim().length > 0; +} + +function safeFocus(el: HTMLElement): void { + try { + el.focus(); + } catch { + // Best-effort + } +} + +function buildScopeCycleList(input: readonly QuickPanelScope[] | undefined): QuickPanelScope[] { + const defaultList: QuickPanelScope[] = [ + 'all', + 'tabs', + 'bookmarks', + 'history', + 'content', + 'commands', + ]; + const list = (input?.length ? [...input] : defaultList).map((s) => normalizeQuickPanelScope(s)); + + // Ensure 'all' exists as a stable fallback + if (!list.includes('all')) { + list.unshift('all'); + } + + // De-duplicate while preserving order + const seen = new Set(); + return list.filter((s) => { + if (seen.has(s)) return false; + seen.add(s); + return true; + }); +} + +// ============================================================ +// Main Factory +// ============================================================ + +/** + * Create a Quick Panel search input component. + * + * @example + * ```typescript + * const searchInput = createSearchInput({ + * container: headerSearchMount, + * initialScope: 'all', + * onChange: ({ scope, query }) => { + * controller.search(scope, query); + * }, + * }); + * + * // Programmatically set scope + * searchInput.setScope('tabs'); + * + * // Cleanup + * searchInput.dispose(); + * ``` + */ +export function createSearchInput(options: SearchInputOptions): SearchInputManager { + const disposer = new Disposer(); + const scopes = buildScopeCycleList(options.availableScopes); + + let disposed = false; + let isComposing = false; + + let state: SearchInputState = { + scope: normalizeQuickPanelScope(options.initialScope, DEFAULT_SCOPE), + query: (options.initialQuery ?? '').trim(), + }; + + // -------------------------------------------------------- + // DOM Construction + // -------------------------------------------------------- + + const root = document.createElement('div'); + root.className = 'qp-search'; + + const brand = document.createElement('div'); + brand.className = 'qp-brand'; + brand.textContent = '\u2726'; // Star symbol + + const scopeBtn = document.createElement('button'); + scopeBtn.type = 'button'; + scopeBtn.className = 'qp-scope-chip ac-btn ac-focus-ring'; + scopeBtn.setAttribute('aria-label', 'Switch search scope'); + + const input = document.createElement('input'); + input.type = 'text'; + input.className = 'qp-search-input ac-focus-ring'; + input.placeholder = options.placeholder?.trim() || 'Search\u2026'; + input.setAttribute('autocomplete', 'off'); + input.setAttribute('spellcheck', 'false'); + input.setAttribute('aria-label', 'Quick Panel search'); + + const clearBtn = document.createElement('button'); + clearBtn.type = 'button'; + clearBtn.className = 'qp-icon-btn ac-btn ac-focus-ring'; + clearBtn.textContent = '\u00D7'; // × + clearBtn.setAttribute('aria-label', 'Clear search'); + + root.append(brand, scopeBtn, input, clearBtn); + options.container.append(root); + disposer.add(() => root.remove()); + + // -------------------------------------------------------- + // Rendering + // -------------------------------------------------------- + + function renderScopeChip(): void { + const def = QUICK_PANEL_SCOPES[state.scope]; + const prefixHint = def.prefix ? def.prefix.trim() : ''; + + scopeBtn.textContent = ''; + + const iconEl = document.createElement('span'); + iconEl.className = 'qp-scope-chip__icon'; + iconEl.textContent = def.icon; + + const labelEl = document.createElement('span'); + labelEl.className = 'qp-scope-chip__label'; + labelEl.textContent = def.label; + + scopeBtn.append(iconEl, labelEl); + + if (prefixHint) { + const prefixEl = document.createElement('span'); + prefixEl.className = 'qp-scope-chip__prefix'; + prefixEl.textContent = prefixHint; + scopeBtn.append(prefixEl); + } + } + + function renderClearButton(): void { + clearBtn.hidden = !isNonEmptyString(input.value); + } + + function render(): void { + renderScopeChip(); + renderClearButton(); + } + + // -------------------------------------------------------- + // State Change Emission + // -------------------------------------------------------- + + function emit(): void { + try { + options.onChange?.({ ...state }); + } catch { + // Best-effort + } + try { + options.onScopeChange?.(state.scope); + } catch { + // Best-effort + } + try { + options.onQueryChange?.(state.query); + } catch { + // Best-effort + } + } + + // -------------------------------------------------------- + // State Mutators + // -------------------------------------------------------- + + function setScope(next: QuickPanelScope, opts: { emit?: boolean } = {}): void { + if (disposed) return; + + const normalized = normalizeQuickPanelScope(next, DEFAULT_SCOPE); + if (state.scope === normalized) return; + + // Only allow scopes in the cycle list + if (!scopes.includes(normalized)) return; + + state = { ...state, scope: normalized }; + render(); + + if (opts.emit !== false) emit(); + } + + function setQuery(nextQuery: string, opts: { emit?: boolean } = {}): void { + if (disposed) return; + + const q = (nextQuery ?? '').trim(); + if (state.query === q && input.value === q) { + render(); + return; + } + + state = { ...state, query: q }; + input.value = q; + render(); + + if (opts.emit !== false) emit(); + } + + function clear(opts: { emit?: boolean } = {}): void { + if (disposed) return; + + setQuery('', { emit: false }); + + try { + options.onClear?.(); + } catch { + // Best-effort + } + + if (opts.emit !== false) emit(); + } + + // -------------------------------------------------------- + // Prefix Parsing + // -------------------------------------------------------- + + function applyPrefixParsing(): void { + if (disposed) return; + if (isComposing) return; + + const parsed = parseScopePrefixedQuery(input.value, state.scope); + + if (parsed.consumedPrefix) { + // Apply scope change if available + if (scopes.includes(parsed.scope) && parsed.scope !== state.scope) { + setScope(parsed.scope, { emit: false }); + } + + // Consume the prefix from the visible input + if (input.value !== parsed.query) { + input.value = parsed.query; + // Move caret to end after rewrite for predictable UX + try { + input.setSelectionRange(input.value.length, input.value.length); + } catch { + // Ignore + } + } + } + + // Always update query state from current input value + setQuery(input.value, { emit: false }); + emit(); + } + + // -------------------------------------------------------- + // Event Handlers + // -------------------------------------------------------- + + disposer.listen(input, 'compositionstart', () => { + isComposing = true; + }); + + disposer.listen(input, 'compositionend', () => { + isComposing = false; + applyPrefixParsing(); + }); + + disposer.listen(input, 'input', () => { + applyPrefixParsing(); + }); + + disposer.listen(clearBtn, 'click', () => { + clear(); + safeFocus(input); + }); + + disposer.listen(scopeBtn, 'click', () => { + const idx = scopes.indexOf(state.scope); + const next = scopes[(idx >= 0 ? idx + 1 : 0) % scopes.length] ?? 'all'; + setScope(next); + safeFocus(input); + }); + + // -------------------------------------------------------- + // Initialization + // -------------------------------------------------------- + + input.value = state.query; + render(); + + if (options.autoFocus !== false) { + safeFocus(input); + } + + // -------------------------------------------------------- + // Public API + // -------------------------------------------------------- + + return { + root, + input, + getState: () => ({ ...state }), + setScope, + setQuery, + clear, + focus: () => safeFocus(input), + dispose: () => { + if (disposed) return; + disposed = true; + disposer.dispose(); + }, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/shadow-host.ts b/app/chrome-extension/shared/quick-panel/ui/shadow-host.ts new file mode 100644 index 00000000..9973c927 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/shadow-host.ts @@ -0,0 +1,386 @@ +/** + * Quick Panel Shadow Host + * + * Creates an isolated Shadow DOM container for the Quick Panel AI Chat UI. + * This module runs in a content script context and provides: + * + * - Style isolation via Shadow DOM (no CSS bleed in/out) + * - Event isolation (UI events don't bubble to the host page) + * - Theme synchronization with AgentChat (via chrome.storage) + * + * Architecture: + * - Host element attached to documentElement with highest z-index + * - Shadow root contains styles + UI container + * - Theme is synced from chrome.storage.local['agentTheme'] + */ + +import { Disposer } from '@/entrypoints/web-editor-v2/utils/disposables'; +import { QUICK_PANEL_STYLES } from './styles'; + +// ============================================================ +// Types +// ============================================================ + +/** + * Elements exposed by the shadow host for UI mounting. + */ +export interface QuickPanelShadowHostElements { + /** The host element attached to the document */ + host: HTMLElement; + /** The shadow root */ + shadowRoot: ShadowRoot; + /** Container for UI elements (pointer-events: none by default) */ + uiRoot: HTMLElement; + /** Theme root element (class="agent-theme qp-root") */ + root: HTMLElement; +} + +/** + * Manager interface for the shadow host. + */ +export interface QuickPanelShadowHostManager { + /** Get the current elements (null if disposed) */ + getElements: () => QuickPanelShadowHostElements | null; + /** Check if a node belongs to this shadow host */ + isOverlayElement: (node: unknown) => boolean; + /** Check if an event originated from within the shadow host */ + isEventFromUi: (event: Event) => boolean; + /** Clean up and remove the shadow host */ + dispose: () => void; +} + +/** + * Options for mounting the shadow host. + */ +export interface QuickPanelShadowHostOptions { + /** Custom host element ID (default: __mcp_quick_panel_host__) */ + hostId?: string; + /** Custom z-index (default: 2147483647 - highest possible) */ + zIndex?: number; +} + +// ============================================================ +// Constants +// ============================================================ + +const DEFAULT_HOST_ID = '__mcp_quick_panel_host__'; +const UI_CONTAINER_ID = '__mcp_quick_panel_ui__'; +const ROOT_ID = '__mcp_quick_panel_root__'; + +/** Highest possible z-index to ensure Quick Panel is on top */ +const DEFAULT_Z_INDEX = 2147483647; + +/** Storage key for AgentChat theme (owned by sidepanel) */ +const THEME_STORAGE_KEY = 'agentTheme'; + +/** Default theme if none is set */ +const DEFAULT_THEME_ID = 'warm-editorial'; + +/** Dark theme ID for dark mode */ +const DARK_THEME_ID = 'dark-console'; + +/** Valid theme IDs (subset supported by Quick Panel) */ +const VALID_THEME_IDS = new Set([ + 'warm-editorial', + 'blueprint-architect', + 'zen-journal', + 'neo-pop', + 'dark-console', + 'swiss-grid', +]); + +/** Light theme IDs that should switch to dark in dark mode */ +const LIGHT_THEME_IDS = new Set([ + 'warm-editorial', + 'blueprint-architect', + 'zen-journal', + 'neo-pop', + 'swiss-grid', +]); + +/** Events to stop from propagating to the host page */ +const BLOCKED_EVENT_TYPES = [ + // Pointer events + 'pointerdown', + 'pointerup', + 'pointermove', + 'pointerenter', + 'pointerleave', + 'pointercancel', + // Mouse events + 'mousedown', + 'mouseup', + 'mousemove', + 'mouseenter', + 'mouseleave', + 'click', + 'dblclick', + 'contextmenu', + // Keyboard events + 'keydown', + 'keyup', + 'keypress', + // Touch events + 'touchstart', + 'touchmove', + 'touchend', + 'touchcancel', + // Scroll events + 'wheel', + // Form events + 'focus', + 'blur', + 'input', + 'change', +] as const; + +// ============================================================ +// Utility Functions +// ============================================================ + +/** + * Set a CSS property with !important to override page styles. + */ +function setImportantStyle(element: HTMLElement, property: string, value: string): void { + element.style.setProperty(property, value, 'important'); +} + +/** + * Normalize and validate a theme ID. + */ +function normalizeThemeId(value: unknown): string { + if (typeof value !== 'string') return DEFAULT_THEME_ID; + const trimmed = value.trim(); + return VALID_THEME_IDS.has(trimmed) ? trimmed : DEFAULT_THEME_ID; +} + +/** + * Check if system prefers dark mode. + */ +function systemPrefersDark(): boolean { + try { + return globalThis.matchMedia?.('(prefers-color-scheme: dark)').matches ?? false; + } catch { + return false; + } +} + +/** + * Get effective theme ID considering system dark mode preference. + * If system is in dark mode and the theme is a light theme, switch to dark-console. + */ +function getEffectiveThemeId(baseThemeId: string): string { + if (systemPrefersDark() && LIGHT_THEME_IDS.has(baseThemeId)) { + return DARK_THEME_ID; + } + return baseThemeId; +} + +/** + * Read the stored theme ID from chrome.storage. + */ +async function readStoredThemeId(): Promise { + try { + if (!chrome?.storage?.local) return DEFAULT_THEME_ID; + const result = await chrome.storage.local.get(THEME_STORAGE_KEY); + return normalizeThemeId(result[THEME_STORAGE_KEY]); + } catch { + return DEFAULT_THEME_ID; + } +} + +/** + * Apply a theme ID to the root element, considering system dark mode preference. + */ +function applyThemeId(root: HTMLElement, themeId: string): void { + const normalizedTheme = normalizeThemeId(themeId); + const effectiveTheme = getEffectiveThemeId(normalizedTheme); + root.dataset.agentTheme = effectiveTheme; +} + +// ============================================================ +// Main Export +// ============================================================ + +/** + * Mount the Quick Panel Shadow DOM host. + * + * @param options - Configuration options + * @returns Manager interface for the shadow host + * + * @example + * ```typescript + * const shadowHost = mountQuickPanelShadowHost(); + * const elements = shadowHost.getElements(); + * + * if (elements) { + * // Mount UI into elements.root + * mountQuickPanelAiChatPanel({ + * mount: elements.root, + * agentBridge, + * }); + * } + * + * // Cleanup when done + * shadowHost.dispose(); + * ``` + */ +export function mountQuickPanelShadowHost( + options: QuickPanelShadowHostOptions = {}, +): QuickPanelShadowHostManager { + const disposer = new Disposer(); + let elements: QuickPanelShadowHostElements | null = null; + + const hostId = options.hostId ?? DEFAULT_HOST_ID; + const zIndex = options.zIndex ?? DEFAULT_Z_INDEX; + + // Clean up any existing host (from previous instance or crash recovery) + const existing = document.getElementById(hostId); + if (existing) { + try { + existing.remove(); + } catch { + // Best-effort cleanup + } + } + + // Create host element + const host = document.createElement('div'); + host.id = hostId; + host.setAttribute('data-mcp-quick-panel', 'true'); + + // Apply styles with !important to override page styles + setImportantStyle(host, 'position', 'fixed'); + setImportantStyle(host, 'inset', '0'); + setImportantStyle(host, 'z-index', String(zIndex)); + setImportantStyle(host, 'pointer-events', 'none'); + setImportantStyle(host, 'contain', 'layout style paint'); + setImportantStyle(host, 'isolation', 'isolate'); + + // Create shadow root + const shadowRoot = host.attachShadow({ mode: 'open' }); + + // Inject styles + const styleEl = document.createElement('style'); + styleEl.textContent = QUICK_PANEL_STYLES; + shadowRoot.append(styleEl); + + // Create UI container + const uiRoot = document.createElement('div'); + uiRoot.id = UI_CONTAINER_ID; + setImportantStyle(uiRoot, 'position', 'fixed'); + setImportantStyle(uiRoot, 'inset', '0'); + setImportantStyle(uiRoot, 'pointer-events', 'none'); + shadowRoot.append(uiRoot); + + // Create theme root (where UI components mount) + const root = document.createElement('div'); + root.id = ROOT_ID; + root.className = 'agent-theme qp-root'; + + // Apply theme synchronously BEFORE mounting to avoid flash + // Use system dark mode preference as initial hint + const initialTheme = getEffectiveThemeId(DEFAULT_THEME_ID); + root.dataset.agentTheme = initialTheme; + + uiRoot.append(root); + + // Mount to document + const mountPoint = document.documentElement ?? document.body; + mountPoint.append(host); + disposer.add(() => host.remove()); + + elements = { host, shadowRoot, uiRoot, root }; + + // Event isolation: stop UI events from bubbling to the page + const stopPropagation = (event: Event): void => { + event.stopPropagation(); + }; + + for (const eventType of BLOCKED_EVENT_TYPES) { + disposer.listen(root, eventType, stopPropagation); + } + + // Async update with stored theme (if different from initial) + void (async () => { + const themeId = await readStoredThemeId(); + applyThemeId(root, themeId); + })(); + + // System dark mode change listener + // Re-apply theme when system color scheme changes + let currentStoredThemeId = DEFAULT_THEME_ID; + + // Track the stored theme ID + void (async () => { + currentStoredThemeId = await readStoredThemeId(); + })(); + + // Theme change listener + const handleStorageChange = ( + changes: Record, + areaName: string, + ): void => { + if (areaName !== 'local') return; + const change = changes[THEME_STORAGE_KEY]; + if (!change) return; + // Update tracked theme ID and apply + currentStoredThemeId = normalizeThemeId(change.newValue); + applyThemeId(root, currentStoredThemeId); + }; + + try { + chrome?.storage?.onChanged?.addListener(handleStorageChange); + disposer.add(() => chrome?.storage?.onChanged?.removeListener(handleStorageChange)); + } catch { + // Best-effort: theme sync is optional + } + + try { + const darkModeMediaQuery = globalThis.matchMedia?.('(prefers-color-scheme: dark)'); + if (darkModeMediaQuery) { + const handleDarkModeChange = (): void => { + applyThemeId(root, currentStoredThemeId); + }; + + // Use addEventListener for modern browsers + if (typeof darkModeMediaQuery.addEventListener === 'function') { + darkModeMediaQuery.addEventListener('change', handleDarkModeChange); + disposer.add(() => darkModeMediaQuery.removeEventListener('change', handleDarkModeChange)); + } + } + } catch { + // Best-effort: dark mode detection is optional + } + + // Helper to check if a node belongs to this shadow host + const isOverlayElement = (node: unknown): boolean => { + if (!(node instanceof Node)) return false; + if (node === host) return true; + + const rootNode = typeof node.getRootNode === 'function' ? node.getRootNode() : null; + return rootNode instanceof ShadowRoot && rootNode.host === host; + }; + + // Helper to check if an event originated from within the shadow host + const isEventFromUi = (event: Event): boolean => { + try { + if (typeof event.composedPath === 'function') { + return event.composedPath().some((el) => isOverlayElement(el)); + } + } catch { + // Fallback to checking target + } + return isOverlayElement(event.target); + }; + + return { + getElements: () => elements, + isOverlayElement, + isEventFromUi, + dispose: () => { + elements = null; + disposer.dispose(); + }, + }; +} diff --git a/app/chrome-extension/shared/quick-panel/ui/styles.ts b/app/chrome-extension/shared/quick-panel/ui/styles.ts new file mode 100644 index 00000000..3e7dc648 --- /dev/null +++ b/app/chrome-extension/shared/quick-panel/ui/styles.ts @@ -0,0 +1,1010 @@ +/** + * Quick Panel AI Chat Styles + * + * This stylesheet is injected into the Quick Panel's Shadow DOM (content script). + * It intentionally reuses AgentChat token names (--ac-*) to maintain visual consistency + * with the sidepanel AgentChat component. + * + * Design System: + * - Source of truth: app/chrome-extension/entrypoints/sidepanel/styles/agent-chat.css + * - This file extracts a minimal token + utility subset for content script use + * - Liquid Glass styling follows quick-panel-prd.md V6 spec + * + * Note: Content Script Shadow DOM cannot directly import sidepanel CSS (not web_accessible). + * We maintain a synced subset here to balance visual consistency with bundle size. + */ + +export const QUICK_PANEL_STYLES = /* css */ ` + /* ============================================================ + * Reset & Box Sizing + * ============================================================ */ + + :host { + all: initial; + } + + *, + *::before, + *::after { + box-sizing: border-box; + } + + [hidden] { + display: none !important; + } + + /* ============================================================ + * Root Container & Theme Tokens + * Subset of AgentChat tokens for Quick Panel use + * ============================================================ */ + + .qp-root { + position: fixed; + inset: 0; + pointer-events: none; + font-family: var(--ac-font-body, ui-sans-serif, system-ui); + color: var(--ac-text, #111827); + line-height: 1.4; + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; + } + + .qp-root.agent-theme { + /* =========================================== + * Font Stacks + * =========================================== */ + --ac-font-sans: + 'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, + 'Apple Color Emoji', 'Segoe UI Emoji'; + --ac-font-serif: 'Newsreader', ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif; + --ac-font-mono: + 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', + 'Courier New', monospace; + --ac-font-grotesk: + 'Space Grotesk', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial; + + --ac-font-body: var(--ac-font-sans); + --ac-font-heading: var(--ac-font-serif); + --ac-font-code: var(--ac-font-mono); + + /* =========================================== + * Geometry & Spacing + * =========================================== */ + --ac-border-width: 1px; + --ac-border-width-strong: 2px; + --ac-radius-container: 0px; + --ac-radius-card: 12px; + --ac-radius-inner: 8px; + --ac-radius-button: 8px; + + /* =========================================== + * Motion + * =========================================== */ + --ac-motion-fast: 120ms; + --ac-motion-normal: 180ms; + + /* =========================================== + * Warm Editorial Theme (Default) + * =========================================== */ + --ac-bg: transparent; + --ac-bg-pattern: none; + --ac-bg-pattern-size: 16px 16px; + + --ac-header-bg: rgba(253, 252, 248, 0.95); + --ac-header-border: rgba(245, 245, 244, 0.5); + + --ac-surface: #ffffff; + --ac-surface-muted: #f2f0eb; + --ac-surface-inset: #f2f0eb; + + --ac-text: #1a1a1a; + --ac-text-muted: #6e6e6e; + --ac-text-subtle: #a8a29e; + --ac-text-inverse: #ffffff; + --ac-text-placeholder: #a8a29e; + + --ac-border: #e7e5e4; + --ac-border-strong: #d6d3d1; + + --ac-hover-bg: #f5f5f4; + --ac-hover-bg-subtle: #fafaf9; + + --ac-accent: #d97757; + --ac-accent-hover: #c4664a; + --ac-accent-subtle: rgba(217, 119, 87, 0.12); + --ac-accent-contrast: #ffffff; + + --ac-link: var(--ac-accent); + --ac-link-hover: var(--ac-accent-hover); + + --ac-selection-bg: #ffedd5; + --ac-selection-text: #7c2d12; + + --ac-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.08); + --ac-shadow-float: 0 4px 20px -2px rgba(0, 0, 0, 0.05); + + --ac-focus-ring: rgba(214, 211, 209, 0.9); + + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(217, 119, 87, 0.25), 0 0 12px rgba(217, 119, 87, 0.2); + + /* Status Colors */ + --ac-success: #22c55e; + --ac-warning: #f59e0b; + --ac-danger: #ef4444; + + /* Scrollbar */ + --ac-scrollbar-size: 4px; + --ac-scrollbar-thumb: rgba(0, 0, 0, 0.25); + --ac-scrollbar-thumb-hover: rgba(0, 0, 0, 0.4); + + /* =========================================== + * Quick Panel Solid Tokens (Editorial Style) + * No glassmorphism - solid backgrounds for clarity + * =========================================== */ + --qp-panel-bg: var(--ac-surface); + --qp-panel-border: var(--ac-border); + --qp-panel-shadow: var(--ac-shadow-card), 0 25px 50px -12px rgba(0, 0, 0, 0.15); + --qp-divider: var(--ac-border); + --qp-input-bg: var(--ac-surface); + --qp-input-border: var(--ac-border); + } + + /* =========================================== + * Dark Console Theme + * =========================================== */ + .qp-root.agent-theme[data-agent-theme='dark-console'] { + --ac-font-body: var(--ac-font-mono); + --ac-font-heading: var(--ac-font-mono); + --ac-font-code: var(--ac-font-mono); + + --ac-surface: #0f1117; + --ac-surface-muted: #0a0c10; + --ac-surface-inset: #1a1d26; + + --ac-text: #e5e7eb; + --ac-text-muted: #9ca3af; + --ac-text-subtle: #6b7280; + --ac-text-inverse: #0a0c10; + --ac-text-placeholder: #4b5563; + + --ac-border: #1f2937; + --ac-border-strong: #374151; + + --ac-hover-bg: rgba(255, 255, 255, 0.06); + --ac-hover-bg-subtle: rgba(255, 255, 255, 0.04); + + --ac-accent: #d97757; + --ac-accent-hover: #e8956f; + --ac-accent-subtle: rgba(217, 119, 87, 0.18); + --ac-accent-contrast: #ffffff; + + --ac-focus-ring: rgba(217, 119, 87, 0.4); + --ac-timeline-node-pulse-shadow: + 0 0 0 2px rgba(217, 119, 87, 0.35), 0 0 14px rgba(217, 119, 87, 0.25); + + --ac-scrollbar-thumb: rgba(255, 255, 255, 0.12); + --ac-scrollbar-thumb-hover: rgba(255, 255, 255, 0.22); + + --qp-panel-bg: var(--ac-surface); + --qp-panel-border: var(--ac-border); + --qp-panel-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.4); + --qp-divider: var(--ac-border); + --qp-input-bg: var(--ac-surface-inset); + --qp-input-border: var(--ac-border); + } + + .qp-root ::selection { + background: var(--ac-selection-bg); + color: var(--ac-selection-text); + } + + /* ============================================================ + * Utility Classes (AgentChat Subset) + * ============================================================ */ + + /* Scrollbar Styling */ + .qp-root .ac-scroll { + scrollbar-width: thin; + scrollbar-color: var(--ac-scrollbar-thumb) transparent; + } + + .qp-root .ac-scroll::-webkit-scrollbar { + width: var(--ac-scrollbar-size); + height: var(--ac-scrollbar-size); + } + + .qp-root .ac-scroll::-webkit-scrollbar-track { + background: transparent; + } + + .qp-root .ac-scroll::-webkit-scrollbar-thumb { + background-color: var(--ac-scrollbar-thumb); + border-radius: 999px; + } + + .qp-root .ac-scroll::-webkit-scrollbar-thumb:hover { + background-color: var(--ac-scrollbar-thumb-hover); + } + + /* Focus Ring */ + .qp-root .ac-focus-ring:focus-visible { + outline: none; + box-shadow: 0 0 0 2px var(--ac-focus-ring); + } + + /* Button Base */ + .qp-root .ac-btn { + transition: + background-color var(--ac-motion-fast), + color var(--ac-motion-fast); + } + + .qp-root .ac-btn:hover { + background-color: var(--ac-hover-bg); + } + + /* Pulse Animation (Streaming Indicator) */ + @keyframes ac-pulse { + 0%, 100% { + opacity: 1; + } + 50% { + opacity: 0.5; + } + } + + .qp-root .ac-pulse { + animation: ac-pulse 1.5s cubic-bezier(0.4, 0, 0.6, 1) infinite; + } + + @media (prefers-reduced-motion: reduce) { + .qp-root .ac-pulse { + animation: none; + } + } + + /* Text Shimmer (Streaming Status) */ + .qp-root .text-shimmer { + background: linear-gradient( + 90deg, + var(--ac-accent, #d97757) 0%, + var(--ac-accent-hover, #ffcab0) 50%, + var(--ac-accent, #d97757) 100% + ); + background-size: 200% auto; + color: transparent; + -webkit-background-clip: text; + background-clip: text; + animation: ac-shimmer 3s linear infinite; + } + + @keyframes ac-shimmer { + to { + background-position: 200% center; + } + } + + /* ============================================================ + * Liquid Glass Panel (PRD V6) + * ============================================================ */ + + .qp-overlay { + position: fixed; + inset: 0; + display: flex; + align-items: center; + justify-content: center; + padding: 24px; + pointer-events: auto; + } + + .qp-panel { + width: min(760px, calc(100vw - 48px)); + max-height: min(720px, calc(100vh - 48px)); + display: flex; + flex-direction: column; + border-radius: 24px; + overflow: hidden; + pointer-events: auto; + + background: var(--qp-panel-bg); + border: var(--ac-border-width) solid var(--qp-panel-border); + box-shadow: var(--qp-panel-shadow); + } + + /* ============================================================ + * AI Chat Layout Components + * ============================================================ */ + + /* Header */ + .qp-header { + display: flex; + align-items: center; + justify-content: space-between; + gap: 12px; + padding: 14px 16px; + border-bottom: var(--ac-border-width) solid var(--qp-divider); + } + + .qp-header-left { + min-width: 0; + display: flex; + align-items: center; + gap: 10px; + } + + .qp-brand { + width: 34px; + height: 34px; + border-radius: var(--ac-radius-inner); + display: flex; + align-items: center; + justify-content: center; + background: var(--ac-accent-subtle); + color: var(--ac-accent); + font-size: 24px; + } + + .qp-title { + display: flex; + flex-direction: column; + gap: 2px; + min-width: 0; + } + + .qp-title-name { + font-weight: 700; + font-size: 13px; + letter-spacing: 0.2px; + color: var(--ac-text); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + } + + .qp-title-sub { + font-size: 11px; + color: var(--ac-text-muted); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; + } + + .qp-header-right { + display: flex; + align-items: center; + gap: 10px; + flex: none; + } + + .qp-stream-indicator { + display: inline-flex; + align-items: center; + gap: 6px; + font-size: 11px; + color: var(--ac-text-muted); + user-select: none; + } + + .qp-stream-dot { + width: 8px; + height: 8px; + border-radius: 999px; + background: var(--ac-accent); + box-shadow: var(--ac-timeline-node-pulse-shadow); + } + + /* Buttons */ + .qp-btn { + display: inline-flex; + align-items: center; + justify-content: center; + gap: 8px; + border: var(--ac-border-width) solid var(--qp-divider); + background: var(--ac-hover-bg); + color: var(--ac-text); + border-radius: var(--ac-radius-button); + padding: 8px 10px; + font-size: 11px; + cursor: pointer; + user-select: none; + font-family: inherit; + transition: background-color var(--ac-motion-fast); + } + + .qp-btn:hover:not(:disabled) { + background: var(--ac-hover-bg-subtle); + } + + .qp-btn:disabled { + cursor: not-allowed; + opacity: 0.6; + } + + .qp-btn--primary { + background: var(--ac-accent); + border-color: var(--ac-accent); + color: var(--ac-accent-contrast); + } + + .qp-btn--primary:hover:not(:disabled) { + background: var(--ac-accent-hover); + } + + .qp-btn--danger { + background: var(--ac-danger); + border-color: var(--ac-danger); + color: #ffffff; + } + + /* Content Area */ + .qp-content { + flex: 1; + overflow: auto; + padding: 14px; + min-height: 0; + } + + .qp-messages { + display: flex; + flex-direction: column; + gap: 10px; + } + + /* Message Bubbles */ + .qp-msg { + display: flex; + gap: 10px; + } + + .qp-msg--user { + justify-content: flex-end; + } + + .qp-msg--assistant { + justify-content: flex-start; + } + + .qp-bubble { + max-width: 90%; + border-radius: var(--ac-radius-card); + border: var(--ac-border-width) solid var(--ac-border); + box-shadow: var(--ac-shadow-card); + padding: 10px 12px; + background: var(--ac-surface); + } + + .qp-bubble--user { + background: color-mix(in srgb, var(--ac-accent-subtle) 80%, transparent); + border-color: color-mix(in srgb, var(--ac-border) 70%, transparent); + } + + .qp-msg-text { + font-size: 13px; + white-space: pre-wrap; + word-break: break-word; + color: var(--ac-text); + } + + .qp-msg-meta { + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + margin-top: 6px; + font-size: 10px; + color: var(--ac-text-subtle); + } + + .qp-msg-meta code { + font-family: var(--ac-font-code); + font-size: 10px; + } + + .qp-msg-stream-dot { + width: 8px; + height: 8px; + border-radius: 999px; + background: var(--ac-accent); + box-shadow: var(--ac-timeline-node-pulse-shadow); + flex: none; + } + + /* Status Indicators */ + .qp-status { + display: flex; + align-items: center; + justify-content: center; + gap: 8px; + padding: 8px 10px; + border-radius: 999px; + border: var(--ac-border-width) solid var(--ac-border); + background: var(--ac-surface-muted); + color: var(--ac-text-muted); + font-size: 11px; + user-select: none; + align-self: center; + } + + .qp-status--error { + border-color: color-mix(in srgb, var(--ac-danger) 55%, var(--ac-border)); + color: var(--ac-danger); + background: color-mix(in srgb, var(--ac-danger) 12%, transparent); + } + + .qp-status--success { + border-color: color-mix(in srgb, var(--ac-success) 55%, var(--ac-border)); + color: color-mix(in srgb, var(--ac-success) 85%, var(--ac-text)); + background: color-mix(in srgb, var(--ac-success) 10%, transparent); + } + + .qp-status--warning { + border-color: color-mix(in srgb, var(--ac-warning) 55%, var(--ac-border)); + color: color-mix(in srgb, var(--ac-warning) 85%, var(--ac-text)); + background: color-mix(in srgb, var(--ac-warning) 10%, transparent); + } + + /* Composer */ + .qp-composer { + padding: 12px 14px; + border-top: 1px solid var(--qp-divider); + display: flex; + flex-direction: column; + gap: 10px; + } + + .qp-textarea { + width: 100%; + min-height: 42px; + max-height: 160px; + resize: none; + padding: 10px 10px; + border-radius: var(--ac-radius-card); + border: 1px solid var(--qp-input-border); + background: var(--qp-input-bg); + color: var(--ac-text); + font-family: var(--ac-font-body); + font-size: 13px; + line-height: 1.35; + outline: none; + } + + .qp-textarea::placeholder { + color: var(--ac-text-placeholder); + } + + .qp-actions { + display: flex; + align-items: center; + justify-content: space-between; + gap: 10px; + } + + .qp-actions-left { + display: flex; + align-items: center; + gap: 10px; + font-size: 11px; + color: var(--ac-text-subtle); + user-select: none; + } + + .qp-actions-right { + display: flex; + align-items: center; + gap: 8px; + } + + .qp-kbd { + display: inline-flex; + align-items: center; + gap: 6px; + border: var(--ac-border-width) solid var(--qp-divider); + background: var(--ac-surface-muted); + padding: 4px 8px; + border-radius: 999px; + font-family: var(--ac-font-code); + font-size: 10px; + color: var(--ac-text-muted); + } + + /* Empty State */ + .qp-empty { + display: flex; + flex-direction: column; + align-items: center; + justify-content: center; + gap: 12px; + padding: 40px 20px; + text-align: center; + color: var(--ac-text-muted); + } + + .qp-empty-icon { + font-size: 32px; + opacity: 0.6; + } + + .qp-empty-text { + font-size: 13px; + line-height: 1.5; + } + + /* ============================================================ + * Search UI (Phase 1) + * ============================================================ */ + + /* Search Input Container */ + .qp-search { + min-width: 0; + width: 100%; + display: flex; + align-items: center; + gap: 10px; + } + + /* Scope Chip */ + .qp-scope-chip { + display: inline-flex; + align-items: center; + gap: 6px; + border: 1px solid var(--qp-divider); + background: rgba(255, 255, 255, 0.12); + border-radius: 999px; + padding: 6px 10px; + color: var(--ac-text); + font-family: var(--ac-font-body); + font-size: 12px; + cursor: pointer; + user-select: none; + flex: none; + transition: background-color var(--ac-motion-fast); + } + + .qp-scope-chip:hover { + background: rgba(255, 255, 255, 0.18); + } + + .qp-scope-chip__icon { + font-size: 12px; + line-height: 1; + } + + .qp-scope-chip__label { + font-weight: 600; + letter-spacing: 0.2px; + white-space: nowrap; + } + + .qp-scope-chip__prefix { + font-family: var(--ac-font-code); + font-size: 10px; + padding: 2px 6px; + border-radius: 999px; + border: 1px solid var(--qp-divider); + background: rgba(255, 255, 255, 0.1); + color: var(--ac-text-muted); + } + + /* Search Input */ + .qp-search-input { + flex: 1; + min-width: 0; + height: 38px; + padding: 0 12px; + border-radius: var(--ac-radius-card); + border: 1px solid var(--qp-input-border); + background: var(--qp-input-bg); + color: var(--ac-text); + font-family: var(--ac-font-body); + font-size: 14px; + line-height: 1.2; + outline: none; + transition: border-color var(--ac-motion-fast); + } + + .qp-search-input:focus { + border-color: var(--ac-accent); + } + + .qp-search-input::placeholder { + color: var(--ac-text-placeholder); + } + + /* Icon Button (Clear, Close, Action, etc.) */ + .qp-icon-btn { + width: 28px; + height: 28px; + display: inline-flex; + align-items: center; + justify-content: center; + border: var(--ac-border-width) solid var(--qp-divider); + background: transparent; + color: var(--ac-text-muted); + border-radius: var(--ac-radius-button); + cursor: pointer; + user-select: none; + flex: none; + transition: background-color var(--ac-motion-fast), color var(--ac-motion-fast), border-color var(--ac-motion-fast); + } + + .qp-icon-btn:hover:not(:disabled) { + background: var(--ac-hover-bg); + color: var(--ac-text); + } + + .qp-icon-btn:disabled { + cursor: not-allowed; + opacity: 0.5; + } + + .qp-icon-btn svg { + width: 16px; + height: 16px; + } + + /* Action button variant (send/stop) */ + .qp-icon-btn--action { + width: 32px; + height: 32px; + } + + .qp-icon-btn--action svg { + width: 16px; + height: 16px; + } + + .qp-icon-btn--primary { + background: var(--ac-accent); + border-color: var(--ac-accent); + color: var(--ac-accent-contrast); + } + + .qp-icon-btn--primary:hover:not(:disabled) { + background: var(--ac-accent-hover); + border-color: var(--ac-accent-hover); + color: var(--ac-accent-contrast); + } + + .qp-icon-btn--danger { + background: var(--ac-danger); + border-color: var(--ac-danger); + color: #ffffff; + } + + .qp-icon-btn--danger:hover:not(:disabled) { + background: color-mix(in srgb, var(--ac-danger) 85%, #000); + color: #ffffff; + } + + /* Quick Entries Grid */ + .qp-entries { + display: grid; + grid-template-columns: repeat(4, minmax(0, 1fr)); + gap: 10px; + padding: 10px 2px; + } + + .qp-entry { + border: var(--ac-border-width) solid var(--qp-divider); + background: var(--ac-surface); + border-radius: var(--ac-radius-card); + padding: 14px 10px; + cursor: pointer; + user-select: none; + color: var(--ac-text); + font-family: var(--ac-font-body); + display: flex; + flex-direction: column; + align-items: center; + gap: 8px; + transition: + background-color var(--ac-motion-fast), + border-color var(--ac-motion-fast), + box-shadow var(--ac-motion-fast); + } + + .qp-entry:hover { + background: var(--ac-hover-bg); + box-shadow: var(--ac-shadow-card); + } + + .qp-entry:active { + box-shadow: none; + } + + .qp-entry:disabled { + cursor: not-allowed; + opacity: 0.5; + } + + .qp-entry[data-active='true'] { + border-color: var(--ac-accent); + background: var(--ac-accent-subtle); + } + + .qp-entry__icon { + width: 40px; + height: 40px; + border-radius: var(--ac-radius-inner); + display: flex; + align-items: center; + justify-content: center; + background: var(--ac-surface-muted); + border: var(--ac-border-width) solid var(--qp-divider); + font-size: 16px; + } + + .qp-entry__label { + font-weight: 600; + font-size: 12px; + letter-spacing: 0.2px; + } + + .qp-entry__prefix { + font-family: var(--ac-font-code); + font-size: 10px; + color: var(--ac-text-muted); + border: var(--ac-border-width) solid var(--qp-divider); + border-radius: 999px; + padding: 2px 8px; + background: var(--ac-surface-muted); + } + + /* View Mount Points */ + .qp-header-mount, + .qp-header-right-mount, + .qp-content-mount, + .qp-footer-mount { + display: contents; + } + + .qp-header-mount[hidden], + .qp-header-right-mount[hidden], + .qp-content-mount[hidden], + .qp-footer-mount[hidden] { + display: none; + } + + /* Footer Hints */ + .qp-footer-hints { + display: flex; + align-items: center; + justify-content: center; + gap: 16px; + padding: 8px 0; + font-size: 11px; + color: var(--ac-text-muted); + } + + .qp-footer-hint { + display: inline-flex; + align-items: center; + gap: 6px; + } + + /* ============================================================ + * Markdown Content Styles (for markstream-vue) + * ============================================================ */ + + .qp-markdown-content { + font-size: 13px; + line-height: 1.5; + color: var(--ac-text); + } + + .qp-markdown-content pre { + background-color: var(--ac-surface-muted); + border: var(--ac-border-width) solid var(--ac-border); + border-radius: var(--ac-radius-inner); + padding: 12px; + overflow-x: auto; + margin: 0.5em 0; + } + + .qp-markdown-content code { + font-family: var(--ac-font-code); + font-size: 0.875em; + color: var(--ac-text); + } + + .qp-markdown-content :not(pre) > code { + background-color: var(--ac-surface-muted); + padding: 0.125em 0.25em; + border-radius: 4px; + } + + .qp-markdown-content p { + margin: 0.5em 0; + } + + .qp-markdown-content p:first-child { + margin-top: 0; + } + + .qp-markdown-content p:last-child { + margin-bottom: 0; + } + + .qp-markdown-content ul, + .qp-markdown-content ol { + margin: 0.5em 0; + padding-left: 1.5em; + } + + .qp-markdown-content li { + margin: 0.25em 0; + } + + .qp-markdown-content h1, + .qp-markdown-content h2, + .qp-markdown-content h3, + .qp-markdown-content h4, + .qp-markdown-content h5, + .qp-markdown-content h6 { + margin: 0.75em 0 0.5em; + font-weight: 600; + line-height: 1.3; + } + + .qp-markdown-content h1 { font-size: 1.5em; } + .qp-markdown-content h2 { font-size: 1.3em; } + .qp-markdown-content h3 { font-size: 1.15em; } + .qp-markdown-content h4 { font-size: 1em; } + + .qp-markdown-content blockquote { + border-left: 3px solid var(--ac-border-strong); + padding-left: 1em; + margin: 0.5em 0; + color: var(--ac-text-muted); + } + + .qp-markdown-content a { + color: var(--ac-link); + text-decoration: underline; + } + + .qp-markdown-content a:hover { + color: var(--ac-link-hover); + } + + .qp-markdown-content table { + border-collapse: collapse; + margin: 0.5em 0; + width: 100%; + font-size: 0.9em; + } + + .qp-markdown-content th, + .qp-markdown-content td { + border: var(--ac-border-width) solid var(--ac-border); + padding: 0.5em; + text-align: left; + } + + .qp-markdown-content th { + background-color: var(--ac-surface-muted); + font-weight: 600; + } + + .qp-markdown-content hr { + border: none; + border-top: var(--ac-border-width) solid var(--ac-border); + margin: 1em 0; + } + + .qp-markdown-content img { + max-width: 100%; + height: auto; + border-radius: var(--ac-radius-inner); + } + + .qp-markdown-content strong { + font-weight: 600; + } + + .qp-markdown-content em { + font-style: italic; + } +`; diff --git a/app/chrome-extension/shared/selector/dom-path.ts b/app/chrome-extension/shared/selector/dom-path.ts new file mode 100644 index 00000000..f05984dd --- /dev/null +++ b/app/chrome-extension/shared/selector/dom-path.ts @@ -0,0 +1,175 @@ +/** + * DOM Path - DOM 路径计算和定位 + * + * DOM 路径是元素在 DOM 树中的索引路径，用于： + * - 元素位置追踪 + * - 选择器失效后的快速恢复 + * - 元素比较和验证 + */ + +// ============================================================================= +// Types +// ============================================================================= + +/** + * DOM 路径：从根到目标元素的子元素索引数组 + * + * @example + * ``` + * [0, 2, 1] 表示: + * root + * └─ children[0] + * └─ children[2] + * └─ children[1] <- 目标元素 + * ``` + */ +export type DomPath = number[]; + +// ============================================================================= +// Core Functions +// ============================================================================= + +/** + * 计算元素在 DOM 树中的路径 + * + * 从目标元素向上遍历到根节点（Document 或 ShadowRoot）， + * 记录每一层在父元素 children 中的索引。 + * + * @example + * ```ts + * const path = computeDomPath(button); + * // => [0, 2, 1] - 从 body/shadowRoot 开始的路径 + * ``` + */ +export function computeDomPath(element: Element): DomPath { + const path: DomPath = []; + let current: Element | null = element; + + while (current) { + const parent: Element | null = current.parentElement; + + if (parent) { + // 正常父元素 + const siblings = Array.from(parent.children); + const index = siblings.indexOf(current); + if (index >= 0) { + path.unshift(index); + } + current = parent; + continue; + } + + // 检查是否是 ShadowRoot 或 Document 的直接子元素 + const parentNode = current.parentNode; + if (parentNode instanceof ShadowRoot || parentNode instanceof Document) { + const children = Array.from(parentNode.children); + const index = children.indexOf(current); + if (index >= 0) { + path.unshift(index); + } + } + + // 到达根节点，停止遍历 + break; + } + + return path; +} + +/** + * 根据 DOM 路径定位元素 + * + * @param root - 查询根节点（Document 或 ShadowRoot） + * @param path - DOM 路径 + * @returns 找到的元素，如果路径无效则返回 null + * + * @example + * ```ts + * const element = locateByDomPath(document, [0, 2, 1]); + * // => 返回 body > children[0] > children[2] > children[1] + * ``` + */ +export function locateByDomPath(root: Document | ShadowRoot, path: DomPath): Element | null { + if (path.length === 0) { + return null; + } + + let current: Element | null = root.children[path[0]] ?? null; + + for (let i = 1; i < path.length && current; i++) { + const index = path[i]; + current = current.children[index] ?? null; + } + + return current; +} + +/** + * 比较两个 DOM 路径 + * + * @returns 包含是否相同和公共前缀长度的结果 + * + * @example + * ```ts + * const result = compareDomPaths([0, 2, 1], [0, 2, 3]); + * // => { same: false, commonPrefixLength: 2 } + * ``` + */ +export function compareDomPaths( + a: DomPath, + b: DomPath, +): { same: boolean; commonPrefixLength: number } { + const minLen = Math.min(a.length, b.length); + let commonPrefixLength = 0; + + for (let i = 0; i < minLen; i++) { + if (a[i] === b[i]) { + commonPrefixLength++; + } else { + break; + } + } + + const same = a.length === b.length && commonPrefixLength === a.length; + + return { same, commonPrefixLength }; +} + +/** + * 检查路径 A 是否是路径 B 的祖先 + * + * @example + * ```ts + * isAncestorPath([0, 2], [0, 2, 1]); // true + * isAncestorPath([0, 2, 1], [0, 2]); // false + * ``` + */ +export function isAncestorPath(ancestor: DomPath, descendant: DomPath): boolean { + if (ancestor.length >= descendant.length) { + return false; + } + + for (let i = 0; i < ancestor.length; i++) { + if (ancestor[i] !== descendant[i]) { + return false; + } + } + + return true; +} + +/** + * 获取从祖先路径到后代路径的相对路径 + * + * @example + * ```ts + * getRelativePath([0, 2], [0, 2, 1, 3]); // [1, 3] + * ``` + */ +export function getRelativePath(ancestor: DomPath, descendant: DomPath): DomPath | null { + if (!isAncestorPath(ancestor, descendant)) { + return null; + } + + return descendant.slice(ancestor.length); +} diff --git a/app/chrome-extension/shared/selector/fingerprint.ts b/app/chrome-extension/shared/selector/fingerprint.ts new file mode 100644 index 00000000..c5ec62d8 --- /dev/null +++ b/app/chrome-extension/shared/selector/fingerprint.ts @@ -0,0 +1,243 @@ +/** + * Element Fingerprint - 元素指纹生成和验证 + * + * 指纹用于元素的模糊匹配和验证，特别是在以下场景： + * - 选择器匹配到元素后，验证是否是期望的元素 + * - HMR 后元素恢复 + * - 防止"相同选择器不同元素"的误匹配 + */ + +// ============================================================================= +// Constants +// ============================================================================= + +const FINGERPRINT_TEXT_MAX_LENGTH = 32; +const FINGERPRINT_MAX_CLASSES = 8; +const FINGERPRINT_SEPARATOR = '|'; + +// ============================================================================= +// Types +// ============================================================================= + +export interface ElementFingerprint { + tag: string; + id?: string; + classes?: string[]; + text?: string; + raw: string; +} + +export interface FingerprintOptions { + textMaxLength?: number; + maxClasses?: number; +} + +// ============================================================================= +// Internal Helpers +// ============================================================================= + +/** + * 标准化文本内容：合并空白字符并截取 + */ +function normalizeText(text: string, maxLength: number): string { + return text.replace(/\s+/g, ' ').trim().slice(0, maxLength); +} + +// ============================================================================= +// Core Functions +// ============================================================================= + +/** + * 为 DOM 元素计算结构化指纹 + * + * 指纹格式: `tag|id=xxx|class=a.b.c|text=xxx` + * + * @example + * ```ts + * const fp = computeFingerprint(buttonElement); + * // => "button|id=submit-btn|class=btn.primary|text=Submit" + * ``` + */ +export function computeFingerprint(element: Element, options?: FingerprintOptions): string { + const textMaxLength = options?.textMaxLength ?? FINGERPRINT_TEXT_MAX_LENGTH; + const maxClasses = options?.maxClasses ?? FINGERPRINT_MAX_CLASSES; + + const parts: string[] = []; + + // 1. Tag name (必须) + const tag = element.tagName?.toLowerCase() ?? 'unknown'; + parts.push(tag); + + // 2. ID (如果存在) + const id = element.id?.trim(); + if (id) { + parts.push(`id=${id}`); + } + + // 3. Class names (最多 maxClasses 个) + const classes = Array.from(element.classList).slice(0, maxClasses); + if (classes.length > 0) { + parts.push(`class=${classes.join('.')}`); + } + + // 4. Text content hint (标准化后截取) + const text = normalizeText(element.textContent ?? '', textMaxLength); + if (text) { + parts.push(`text=${text}`); + } + + return parts.join(FINGERPRINT_SEPARATOR); +} + +/** + * 解析指纹字符串为结构化对象 + * + * @example + * ```ts + * const fp = parseFingerprint("button|id=submit|class=btn.primary|text=Submit"); + * // => { tag: "button", id: "submit", classes: ["btn", "primary"], text: "Submit", raw: "..." } + * ``` + */ +export function parseFingerprint(fingerprint: string): ElementFingerprint { + const parts = fingerprint.split(FINGERPRINT_SEPARATOR); + const result: ElementFingerprint = { + tag: parts[0] ?? 'unknown', + raw: fingerprint, + }; + + for (let i = 1; i < parts.length; i++) { + const part = parts[i]; + if (part.startsWith('id=')) { + result.id = part.slice(3); + } else if (part.startsWith('class=')) { + result.classes = part.slice(6).split('.'); + } else if (part.startsWith('text=')) { + result.text = part.slice(5); + } + } + + return result; +} + +/** + * 验证元素是否匹配给定的指纹 + * + * 验证规则： + * - tag 必须完全匹配 + * - 如果存储的指纹有 id，当前元素的 id 必须匹配 + * - class 和 text 不强制匹配（用于计算相似度） + * + * @example + * ```ts + * const stored = computeFingerprint(element); + * // ... 页面变化后 + * const stillMatches = verifyFingerprint(element, stored); + * ``` + */ +export function verifyFingerprint(element: Element, fingerprint: string): boolean { + const stored = parseFingerprint(fingerprint); + const currentTag = element.tagName?.toLowerCase() ?? 'unknown'; + + // Tag 必须匹配 + if (stored.tag !== currentTag) { + return false; + } + + // 如果存储的指纹有 id，当前元素必须有相同的 id + if (stored.id) { + const currentId = element.id?.trim(); + if (stored.id !== currentId) { + return false; + } + } + + return true; +} + +/** + * 计算两个指纹之间的相似度 + * + * @returns 相似度分数 0-1，1 表示完全匹配 + * + * @example + * ```ts + * const score = fingerprintSimilarity(fpA, fpB); + * if (score > 0.8) { + * // 高度相似，可能是同一个元素 + * } + * ``` + */ +export function fingerprintSimilarity(a: string, b: string): number { + const fpA = parseFingerprint(a); + const fpB = parseFingerprint(b); + + let score = 0; + let weights = 0; + + // Tag 匹配 (权重 0.4) + const tagWeight = 0.4; + weights += tagWeight; + if (fpA.tag === fpB.tag) { + score += tagWeight; + } else { + // Tag 不匹配，直接返回 0 + return 0; + } + + // ID 匹配 (权重 0.3) + const idWeight = 0.3; + if (fpA.id || fpB.id) { + weights += idWeight; + if (fpA.id === fpB.id) { + score += idWeight; + } + } + + // Class 匹配 (权重 0.2) - 使用 Jaccard 相似度 + const classWeight = 0.2; + if ((fpA.classes?.length ?? 0) > 0 || (fpB.classes?.length ?? 0) > 0) { + weights += classWeight; + const setA = new Set(fpA.classes ?? []); + const setB = new Set(fpB.classes ?? []); + const intersection = [...setA].filter((c) => setB.has(c)).length; + const union = new Set([...(fpA.classes ?? []), ...(fpB.classes ?? [])]).size; + if (union > 0) { + score += classWeight * (intersection / union); + } + } + + // Text 匹配 (权重 0.1) - 简单包含检查 + const textWeight = 0.1; + if (fpA.text || fpB.text) { + weights += textWeight; + if (fpA.text && fpB.text) { + // 检查是否有重叠 + const textA = fpA.text.toLowerCase(); + const textB = fpB.text.toLowerCase(); + if (textA === textB) { + score += textWeight; + } else if (textA.includes(textB) || textB.includes(textA)) { + score += textWeight * 0.5; + } + } + } + + return weights > 0 ? score / weights : 0; +} + +/** + * 检查两个指纹是否表示同一个元素 + * + * 基于相似度阈值判断，默认阈值 0.7 + */ +export function fingerprintMatches( + a: string, + b: string, + threshold = 0.7, +): { match: boolean; score: number } { + const score = fingerprintSimilarity(a, b); + return { + match: score >= threshold, + score, + }; +} diff --git a/app/chrome-extension/shared/selector/generator.ts b/app/chrome-extension/shared/selector/generator.ts new file mode 100644 index 00000000..4524d60f --- /dev/null +++ b/app/chrome-extension/shared/selector/generator.ts @@ -0,0 +1,358 @@ +/** + * Selector Generator - 选择器生成器 + * 为 DOM 元素生成多个候选选择器 + */ + +import type { + NonEmptyArray, + NormalizedSelectorGenerationOptions, + SelectorCandidate, + SelectorGenerationOptions, + SelectorStrategy, + SelectorStrategyContext, + SelectorTarget, + ExtendedSelectorTarget, +} from './types'; +import { compareSelectorCandidates, withStability } from './stability'; +import { DEFAULT_SELECTOR_STRATEGIES } from './strategies'; +import { computeDomPath } from './dom-path'; +import { computeFingerprint } from './fingerprint'; + +const DEFAULT_MAX_CANDIDATES = 8; +const DEFAULT_TEXT_MAX_LENGTH = 64; + +const DEFAULT_TEXT_TAGS = ['button', 'a', 'summary'] as const; + +const DEFAULT_TESTID_ATTRS = [ + 'data-testid', + 'data-test-id', + 'data-testId', + 'data-test', + 'data-qa', + 'data-cy', + 'name', + 'title', + 'alt', +] as const; + +function clampInt(value: number, min: number, max: number): number { + if (!Number.isFinite(value)) return min; + return Math.min(max, Math.max(min, Math.floor(value))); +} + +/** + * 标准化选择器生成选项 + */ +export function normalizeSelectorGenerationOptions( + options: SelectorGenerationOptions | undefined, +): NormalizedSelectorGenerationOptions { + return { + maxCandidates: clampInt(options?.maxCandidates ?? DEFAULT_MAX_CANDIDATES, 1, 50), + includeText: options?.includeText ?? true, + includeAria: options?.includeAria ?? true, + includeCssUnique: options?.includeCssUnique ?? true, + includeCssPath: options?.includeCssPath ?? true, + testIdAttributes: options?.testIdAttributes ?? DEFAULT_TESTID_ATTRS, + textMaxLength: clampInt(options?.textMaxLength ?? DEFAULT_TEXT_MAX_LENGTH, 1, 256), + textTags: options?.textTags ?? DEFAULT_TEXT_TAGS, + }; +} + +/** + * CSS 字符串转义 + * Uses native CSS.escape when available; otherwise falls back to a spec-inspired polyfill. + */ +export function cssEscape(value: string): string { + if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') return CSS.escape(value); + + const str = String(value); + const len = str.length; + if (len === 0) return ''; + + let result = ''; + const firstCodeUnit = str.charCodeAt(0); + + for (let i = 0; i < len; i++) { + const codeUnit = str.charCodeAt(i); + + if (codeUnit === 0x0000) { + result += '\uFFFD'; + continue; + } + + if ( + (codeUnit >= 0x0001 && codeUnit <= 0x001f) || + codeUnit === 0x007f || + (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) || + (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && firstCodeUnit === 0x002d) + ) { + result += `\\${codeUnit.toString(16)} `; + continue; + } + + if (i === 0 && len === 1 && codeUnit === 0x002d) { + result += `\\${str.charAt(i)}`; + continue; + } + + const isAsciiAlnum = + (codeUnit >= 0x0030 && codeUnit <= 0x0039) || + (codeUnit >= 0x0041 && codeUnit <= 0x005a) || + (codeUnit >= 0x0061 && codeUnit <= 0x007a); + + const isSafe = isAsciiAlnum || codeUnit === 0x002d || codeUnit === 0x005f; + + if (isSafe) result += str.charAt(i); + else result += `\\${str.charAt(i)}`; + } + + return result; +} + +function getQueryRoot(element: Element): ParentNode { + const root = element.getRootNode?.(); + if (root instanceof ShadowRoot) return root; + if (typeof document !== 'undefined') return document; + throw new Error('Selector generator requires a DOM-like environment'); +} + +function safeQueryAll(root: ParentNode, selector: string): ReadonlyArray { + try { + return Array.from(root.querySelectorAll(selector)); + } catch { + return []; + } +} + +function isUnique(root: ParentNode, selector: string): boolean { + try { + return root.querySelectorAll(selector).length === 1; + } catch { + return false; + } +} + +function candidateKey(c: SelectorCandidate): string { + switch (c.type) { + case 'text': + return `text:${c.value}:${c.tagNameHint ?? ''}:${c.match ?? ''}`; + case 'aria': + return `aria:${c.role ?? ''}:${c.name ?? ''}:${c.value}`; + default: + return `${c.type}:${c.value}`; + } +} + +export interface GenerateSelectorTargetOptions extends SelectorGenerationOptions { + root?: ParentNode; + strategies?: ReadonlyArray; +} + +/** + * 为 DOM 元素生成选择器目标 + */ +export function generateSelectorTarget( + element: Element, + options: GenerateSelectorTargetOptions = {}, +): SelectorTarget { + const normalized = normalizeSelectorGenerationOptions(options); + const root = options.root ?? getQueryRoot(element); + + const helpers = { + cssEscape, + isUnique: (selector: string) => isUnique(root, selector), + safeQueryAll: (selector: string) => safeQueryAll(root, selector), + }; + + const ctx: SelectorStrategyContext = { + element, + root, + options: normalized, + helpers, + }; + + const strategies = options.strategies ?? DEFAULT_SELECTOR_STRATEGIES; + + const raw: SelectorCandidate[] = []; + for (const strategy of strategies) { + const produced = strategy.generate(ctx); + for (const c0 of produced) { + raw.push({ + ...c0, + source: c0.source ?? 'generated', + strategy: c0.strategy ?? strategy.id, + }); + } + } + + // Dedupe (keep first occurrence) + const seen = new Set(); + const deduped: SelectorCandidate[] = []; + for (const c of raw) { + const key = candidateKey(c); + if (seen.has(key)) continue; + seen.add(key); + deduped.push(withStability(c)); + } + + // If strategies produced nothing (shouldn't happen), create a minimal fallback. + if (deduped.length === 0) { + const fallback: SelectorCandidate = withStability({ + type: 'css', + value: 'body', + source: 'generated', + strategy: 'fallback', + }); + const candidates: NonEmptyArray = [fallback]; + return { + selector: fallback.value, + candidates, + tagName: element.tagName?.toLowerCase?.() ?? undefined, + }; + } + + // Sort and truncate + const sorted = [...deduped].sort(compareSelectorCandidates).slice(0, normalized.maxCandidates); + + // Primary selector should be directly usable by locator (prefer CSS/attr) + const primary = sorted.find((c) => c.type === 'css' || c.type === 'attr') ?? sorted[0]; + + const reordered = (() => { + const idx = sorted.indexOf(primary); + if (idx <= 0) return sorted; + return [primary, ...sorted.slice(0, idx), ...sorted.slice(idx + 1)]; + })(); + + const tagName = element.tagName?.toLowerCase?.() ?? undefined; + + return { + selector: primary.value, + candidates: reordered as NonEmptyArray, + tagName, + }; +} + +// ============================================================================= +// Extended Selector Target (Phase 1.2) +// ============================================================================= + +function safeMatches(element: Element, selector: string): boolean { + try { + return element.matches(selector); + } catch { + return false; + } +} + +/** + * Pick the best selector for a shadow host element. + * Prefers unique CSS/attr selectors from the generated candidates. + */ +function pickShadowHostSelector( + host: Element, + hostRoot: ParentNode, + options: GenerateSelectorTargetOptions, +): string | null { + const hostTarget = generateSelectorTarget(host, { ...options, root: hostRoot }); + + let fallback: string | null = null; + + // Try to find a unique selector from candidates + for (const candidate of hostTarget.candidates) { + if (candidate.type !== 'css' && candidate.type !== 'attr') continue; + + const selector = String(candidate.value || '').trim(); + if (!selector) continue; + + // Verify the selector actually matches the host + if (!safeMatches(host, selector)) continue; + + // Check uniqueness in the host's root + if (isUnique(hostRoot, selector)) { + return selector; + } + + // Keep first matching selector as fallback + if (!fallback) { + fallback = selector; + } + } + + // Try the primary selector + const primary = typeof hostTarget.selector === 'string' ? hostTarget.selector.trim() : ''; + if (primary && safeMatches(host, primary)) { + return primary; + } + + return fallback; +} + +/** + * Compute shadow host selector chain (outer -> inner). + * + * Returns an empty array when: + * - Element is not inside Shadow DOM + * - A host selector cannot be generated for any boundary + */ +function computeShadowHostChain( + element: Element, + options: GenerateSelectorTargetOptions, +): string[] { + const chain: string[] = []; + let current: Element = element; + + while (true) { + const rootNode = current.getRootNode?.(); + if (!(rootNode instanceof ShadowRoot)) { + break; + } + + const host = rootNode.host; + if (!(host instanceof Element)) { + break; + } + + const hostRoot = getQueryRoot(host); + const hostSelector = pickShadowHostSelector(host, hostRoot, options); + + if (!hostSelector) { + // Cannot generate selector for this host, return empty chain + return []; + } + + chain.unshift(hostSelector); + current = host; + } + + return chain; +} + +/** + * Generate selector target with additional metadata (Phase 1.2). + * + * This function generates a complete ElementLocator-like structure including: + * - fingerprint: for fuzzy element matching + * - domPath: for fast element recovery + * - shadowHostChain: for Shadow DOM traversal + * + * @example + * ```ts + * const target = generateExtendedSelectorTarget(buttonElement); + * // target.fingerprint = "button|id=submit|class=btn.primary" + * // target.domPath = [0, 2, 1] + * // target.shadowHostChain = ["my-component"] or [] + * ``` + */ +export function generateExtendedSelectorTarget( + element: Element, + options: GenerateSelectorTargetOptions = {}, +): ExtendedSelectorTarget { + const base = generateSelectorTarget(element, options); + + return { + ...base, + fingerprint: computeFingerprint(element), + domPath: computeDomPath(element), + shadowHostChain: computeShadowHostChain(element, options), + }; +} diff --git a/app/chrome-extension/shared/selector/index.ts b/app/chrome-extension/shared/selector/index.ts new file mode 100644 index 00000000..b5b0ca3e --- /dev/null +++ b/app/chrome-extension/shared/selector/index.ts @@ -0,0 +1,77 @@ +/** + * Selector Engine - Unified selector generation and element location + * + * Modules: + * - types: Type definitions + * - stability: Stability scoring + * - strategies: Selector generation strategies + * - generator: Selector target generation + * - locator: Element location + * - fingerprint: Element fingerprinting (Phase 1.2) + * - dom-path: DOM path computation (Phase 1.2) + * - shadow-dom: Shadow DOM utilities (Phase 1.2) + */ + +// Type exports +export * from './types'; + +// Stability scoring +export { computeSelectorStability, withStability, compareSelectorCandidates } from './stability'; + +// Selector strategies +export { DEFAULT_SELECTOR_STRATEGIES } from './strategies'; +export { anchorRelpathStrategy } from './strategies/anchor-relpath'; +export { ariaStrategy } from './strategies/aria'; +export { cssPathStrategy } from './strategies/css-path'; +export { cssUniqueStrategy } from './strategies/css-unique'; +export { testIdStrategy } from './strategies/testid'; +export { textStrategy } from './strategies/text'; + +// Selector generation +export { + generateSelectorTarget, + generateExtendedSelectorTarget, + normalizeSelectorGenerationOptions, + cssEscape, + type GenerateSelectorTargetOptions, +} from './generator'; + +// Element location +export { + SelectorLocator, + createChromeSelectorLocator, + createChromeSelectorLocatorTransport, + type SelectorLocatorTransport, +} from './locator'; + +// Fingerprint utilities (Phase 1.2) +export { + computeFingerprint, + parseFingerprint, + verifyFingerprint, + fingerprintSimilarity, + fingerprintMatches, + type ElementFingerprint, + type FingerprintOptions, +} from './fingerprint'; + +// DOM path utilities (Phase 1.2) +export { + computeDomPath, + locateByDomPath, + compareDomPaths, + isAncestorPath, + getRelativePath, + type DomPath, +} from './dom-path'; + +// Shadow DOM utilities (Phase 1.2) +export { + traverseShadowDom, + traverseShadowDomWithDetails, + queryInShadowDom, + queryAllInShadowDom, + isUniqueInShadowDom, + type ShadowTraversalResult, + type ShadowTraversalFailureReason, +} from './shadow-dom'; diff --git a/app/chrome-extension/shared/selector/locator.ts b/app/chrome-extension/shared/selector/locator.ts new file mode 100644 index 00000000..366da77c --- /dev/null +++ b/app/chrome-extension/shared/selector/locator.ts @@ -0,0 +1,544 @@ +/** + * Selector Locator - 元素定位器 + * 使用选择器候选列表定位 DOM 元素 + */ + +import { TOOL_MESSAGE_TYPES } from '../../common/message-types'; +import { + composeCompositeSelector, + isCompositeSelector, + splitCompositeSelector, + type LocatedElement, + type Point, + type SelectorCandidate, + type SelectorLocateOptions, + type SelectorTarget, +} from './types'; +import { compareSelectorCandidates, withStability } from './stability'; + +// ================================ +// 消息类型定义 +// ================================ + +interface EnsureRefForSelectorRequest { + action: typeof TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR; + selector?: string; + useText?: boolean; + text?: string; + isXPath?: boolean; + tagName?: string; + allowMultiple?: boolean; +} + +type EnsureRefForSelectorResponse = + | { success: true; ref: string; center: Point; href?: string } + | { success: false; error?: string; cancelled?: boolean }; + +interface ResolveRefRequest { + action: typeof TOOL_MESSAGE_TYPES.RESOLVE_REF; + ref: string; +} + +type ResolveRefResponse = + | { + success: true; + center: Point; + rect?: { x: number; y: number; width: number; height: number }; + selector?: string; + } + | { success: false; error?: string }; + +interface VerifyFingerprintRequest { + action: typeof TOOL_MESSAGE_TYPES.VERIFY_FINGERPRINT; + ref: string; + fingerprint: string; +} + +type VerifyFingerprintResponse = + | { success: true; match: boolean } + | { success: false; error?: string }; + +// ================================ +// 传输层接口 +// ================================ + +export interface SelectorLocatorTransport { + sendMessage: ( + tabId: number, + message: unknown, + options?: { frameId?: number }, + ) => Promise; + getAllFrames?: (tabId: number) => Promise>; +} + +// ================================ +// 工具函数 +// ================================ + +function isRecord(value: unknown): value is Record { + return typeof value === 'object' && value !== null; +} + +function isPoint(value: unknown): value is Point { + if (!isRecord(value)) return false; + return ( + typeof value.x === 'number' && + Number.isFinite(value.x) && + typeof value.y === 'number' && + Number.isFinite(value.y) + ); +} + +function parseEnsureRefResponse(value: unknown): EnsureRefForSelectorResponse | null { + if (!isRecord(value) || typeof value.success !== 'boolean') return null; + + if (value.success) { + if (typeof value.ref !== 'string' || !isPoint(value.center)) return null; + const href = typeof value.href === 'string' ? value.href : undefined; + return { success: true, ref: value.ref, center: value.center, href }; + } + + const error = typeof value.error === 'string' ? value.error : undefined; + const cancelled = typeof value.cancelled === 'boolean' ? value.cancelled : undefined; + return { success: false, error, cancelled }; +} + +function parseResolveRefResponse(value: unknown): ResolveRefResponse | null { + if (!isRecord(value) || typeof value.success !== 'boolean') return null; + + if (value.success) { + if (!isPoint(value.center)) return null; + + const rect = + isRecord(value.rect) && + typeof value.rect.x === 'number' && + typeof value.rect.y === 'number' && + typeof value.rect.width === 'number' && + typeof value.rect.height === 'number' + ? { + x: value.rect.x, + y: value.rect.y, + width: value.rect.width, + height: value.rect.height, + } + : undefined; + + const selector = typeof value.selector === 'string' ? value.selector : undefined; + return { success: true, center: value.center, rect, selector }; + } + + const error = typeof value.error === 'string' ? value.error : undefined; + return { success: false, error }; +} + +function parseVerifyFingerprintResponse(value: unknown): VerifyFingerprintResponse | null { + if (!isRecord(value) || typeof value.success !== 'boolean') return null; + + if (value.success) { + if (typeof value.match !== 'boolean') return null; + return { success: true, match: value.match }; + } + + const error = typeof value.error === 'string' ? value.error : undefined; + return { success: false, error }; +} + +function deriveFrameSelector(target: SelectorTarget): string | undefined { + if (typeof target.selector === 'string') { + const parts = splitCompositeSelector(target.selector); + if (parts) return parts.frameSelector; + } + for (const c of target.candidates) { + const parts = splitCompositeSelector(c.value); + if (parts) return parts.frameSelector; + } + return undefined; +} + +function deriveTagNameHint( + target: SelectorTarget, + candidate: SelectorCandidate | undefined, +): string | undefined { + if (candidate?.type === 'text' && candidate.tagNameHint) return candidate.tagNameHint; + return target.tagName; +} + +function parseAriaExpr(expr: string): { role?: string; name?: string } { + const v = String(expr || '').trim(); + const m = v.match(/^(\w+)\s*\[\s*name\s*=\s*([^\]]+)\s*\]$/); + if (!m) return {}; + const role = m[1]?.trim(); + const rawName = m[2]?.trim(); + const name = rawName ? rawName.replace(/^['"]|['"]$/g, '') : undefined; + return { role: role || undefined, name: name || undefined }; +} + +function uniqStrings(items: ReadonlyArray): string[] { + const seen = new Set(); + const out: string[] = []; + for (const s of items) { + const v = s.trim(); + if (!v) continue; + if (seen.has(v)) continue; + seen.add(v); + out.push(v); + } + return out; +} + +function ariaToCssSelectors(role: string | undefined, name: string | undefined): string[] { + if (!name || !name.trim()) return []; + const cleanRole = role?.trim(); + const cleanName = name.trim(); + const qName = JSON.stringify(cleanName); + + const out: string[] = []; + + if (cleanRole) out.push(`[role=${JSON.stringify(cleanRole)}][aria-label=${qName}]`); + + if (cleanRole === 'textbox') { + out.unshift( + `input[aria-label=${qName}]`, + `textarea[aria-label=${qName}]`, + `[role="textbox"][aria-label=${qName}]`, + ); + } else if (cleanRole === 'button') { + out.unshift(`button[aria-label=${qName}]`, `[role="button"][aria-label=${qName}]`); + } else if (cleanRole === 'link') { + out.unshift(`a[aria-label=${qName}]`, `[role="link"][aria-label=${qName}]`); + } + + out.push(`[aria-label=${qName}]`); + return uniqStrings(out); +} + +// ================================ +// SelectorLocator 类 +// ================================ + +export class SelectorLocator { + constructor(private readonly transport: SelectorLocatorTransport) {} + + private async mapHrefToFrameId( + tabId: number, + href: string | undefined, + ): Promise { + if (!href || !this.transport.getAllFrames) return undefined; + try { + const frames = await this.transport.getAllFrames(tabId); + const match = frames.find((f) => f.url === href); + return match?.frameId; + } catch { + return undefined; + } + } + + private async ensureRef( + tabId: number, + request: EnsureRefForSelectorRequest, + frameId: number | undefined, + ): Promise<{ ref: string; center: Point; href?: string } | null> { + const selector = request.selector ?? ''; + const responseRaw = await this.transport.sendMessage( + tabId, + request, + isCompositeSelector(selector) ? undefined : { frameId }, + ); + const parsed = parseEnsureRefResponse(responseRaw); + if (!parsed || !parsed.success) return null; + return { ref: parsed.ref, center: parsed.center, href: parsed.href }; + } + + private async resolveRef( + tabId: number, + ref: string, + frameId: number | undefined, + ): Promise { + const msg = { action: TOOL_MESSAGE_TYPES.RESOLVE_REF, ref } satisfies ResolveRefRequest; + const responseRaw = await this.transport.sendMessage(tabId, msg, { frameId }); + const parsed = parseResolveRefResponse(responseRaw); + if (!parsed || !parsed.success) return null; + return { ref, center: parsed.center, frameId, resolvedBy: 'ref' }; + } + + /** + * 验证元素是否匹配给定的指纹 + */ + private async verifyElementFingerprint( + tabId: number, + ref: string, + fingerprint: string, + frameId: number | undefined, + ): Promise { + const msg = { + action: TOOL_MESSAGE_TYPES.VERIFY_FINGERPRINT, + ref, + fingerprint, + } satisfies VerifyFingerprintRequest; + + try { + const responseRaw = await this.transport.sendMessage(tabId, msg, { frameId }); + const parsed = parseVerifyFingerprintResponse(responseRaw); + if (!parsed || !parsed.success) return false; + return parsed.match; + } catch { + return false; + } + } + + /** + * 定位元素 + */ + async locate( + tabId: number, + target: SelectorTarget, + options: SelectorLocateOptions = {}, + ): Promise { + const frameSelector = deriveFrameSelector(target); + const allowMultiple = options.allowMultiple ?? false; + + // 提取指纹验证配置 + const fingerprintToVerify = + options.verifyFingerprint === true && typeof target.fingerprint === 'string' + ? target.fingerprint.trim() + : undefined; + + // 优先尝试 ref + if (options.preferRef && target.ref) { + const byRef = await this.resolveRef(tabId, target.ref, options.frameId); + if (byRef) return byRef; + } + + // 1) Fast path: try target.selector first (assumed CSS / composite CSS) + if (typeof target.selector === 'string' && target.selector.trim()) { + const sel = target.selector.trim(); + const ensured = await this.ensureRef( + tabId, + { action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, selector: sel, allowMultiple }, + options.frameId, + ); + if (ensured) { + const mappedFrameId = await this.mapHrefToFrameId(tabId, ensured.href); + const resolvedFrameId = mappedFrameId ?? options.frameId; + + // 指纹验证：不匹配则跳过，继续尝试其他候选 + const fingerprintOk = + !fingerprintToVerify || + (await this.verifyElementFingerprint( + tabId, + ensured.ref, + fingerprintToVerify, + resolvedFrameId, + )); + + if (fingerprintOk) { + return { + ref: ensured.ref, + center: ensured.center, + frameId: resolvedFrameId, + resolvedBy: 'css', + selectorUsed: sel, + }; + } + // 指纹不匹配，继续尝试候选选择器 + } + } + + // 2) Candidate ordering (stability + weight). Keep text last by type priority. + const candidates = [...target.candidates].map(withStability).sort(compareSelectorCandidates); + + for (const candidate of candidates) { + const resolved = await this.tryCandidate( + tabId, + target, + candidate, + frameSelector, + options.frameId, + allowMultiple, + ); + if (!resolved) continue; + + // 指纹验证 + if (fingerprintToVerify) { + const isMatch = await this.verifyElementFingerprint( + tabId, + resolved.ref, + fingerprintToVerify, + resolved.frameId ?? options.frameId, + ); + if (!isMatch) continue; + } + + return resolved; + } + + // 3) Ref fallback + if (target.ref) { + const byRef = await this.resolveRef(tabId, target.ref, options.frameId); + if (byRef) return byRef; + } + + return null; + } + + private async tryCandidate( + tabId: number, + target: SelectorTarget, + candidate: SelectorCandidate, + frameSelector: string | undefined, + frameId: number | undefined, + allowMultiple: boolean, + ): Promise { + const tagName = deriveTagNameHint(target, candidate); + + if (candidate.type === 'css' || candidate.type === 'attr') { + const selectorToTry = + frameSelector && !isCompositeSelector(candidate.value) + ? composeCompositeSelector(frameSelector, candidate.value) + : candidate.value; + + const ensured = await this.ensureRef( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: selectorToTry, + allowMultiple, + }, + frameId, + ); + if (!ensured) return null; + + const mappedFrameId = await this.mapHrefToFrameId(tabId, ensured.href); + return { + ref: ensured.ref, + center: ensured.center, + frameId: mappedFrameId ?? frameId, + resolvedBy: candidate.type, + selectorUsed: selectorToTry, + }; + } + + if (candidate.type === 'xpath') { + const selectorToTry = + frameSelector && !isCompositeSelector(candidate.value) + ? composeCompositeSelector(frameSelector, candidate.value) + : candidate.value; + + const ensured = await this.ensureRef( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: selectorToTry, + isXPath: true, + allowMultiple, + }, + frameId, + ); + if (!ensured) return null; + + const mappedFrameId = await this.mapHrefToFrameId(tabId, ensured.href); + return { + ref: ensured.ref, + center: ensured.center, + frameId: mappedFrameId ?? frameId, + resolvedBy: 'xpath', + selectorUsed: selectorToTry, + }; + } + + if (candidate.type === 'aria') { + const parsed = parseAriaExpr(candidate.value); + const role = candidate.role ?? parsed.role; + const name = candidate.name ?? parsed.name; + const selectors = ariaToCssSelectors(role, name); + + for (const cssSel of selectors) { + const selectorToTry = frameSelector + ? composeCompositeSelector(frameSelector, cssSel) + : cssSel; + const ensured = await this.ensureRef( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: selectorToTry, + allowMultiple, + }, + frameId, + ); + if (!ensured) continue; + + const mappedFrameId = await this.mapHrefToFrameId(tabId, ensured.href); + return { + ref: ensured.ref, + center: ensured.center, + frameId: mappedFrameId ?? frameId, + resolvedBy: 'aria', + selectorUsed: selectorToTry, + }; + } + return null; + } + + // text + const textValue = candidate.value.trim(); + if (!textValue) return null; + + // NOTE: In composite mode, the helper expects the inner "selector" string to carry the text query. + const compositeSelector = frameSelector + ? composeCompositeSelector(frameSelector, textValue) + : undefined; + + const ensured = await this.ensureRef( + tabId, + { + action: TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR, + selector: compositeSelector, // for iframe-text: becomes " |> " + useText: true, + text: frameSelector ? undefined : textValue, // non-iframe: use request.text + tagName: tagName ?? '', + allowMultiple, + }, + frameId, + ); + + if (!ensured) return null; + + const mappedFrameId = await this.mapHrefToFrameId(tabId, ensured.href); + return { + ref: ensured.ref, + center: ensured.center, + frameId: mappedFrameId ?? frameId, + resolvedBy: 'text', + selectorUsed: frameSelector ? compositeSelector : textValue, + }; + } +} + +// ================================ +// 工厂函数 +// ================================ + +/** + * 创建 Chrome 扩展的传输层 + */ +export function createChromeSelectorLocatorTransport(): SelectorLocatorTransport { + return { + sendMessage: async (tabId, message, options) => { + if (options && typeof options.frameId === 'number') { + return await chrome.tabs.sendMessage(tabId, message, { frameId: options.frameId }); + } + return await chrome.tabs.sendMessage(tabId, message); + }, + getAllFrames: async (tabId) => { + const frames = await chrome.webNavigation.getAllFrames({ tabId }); + return (frames ?? []).map((f) => ({ frameId: f.frameId, url: f.url ?? '' })); + }, + }; +} + +/** + * 创建 Chrome 扩展的选择器定位器 + */ +export function createChromeSelectorLocator(): SelectorLocator { + return new SelectorLocator(createChromeSelectorLocatorTransport()); +} diff --git a/app/chrome-extension/shared/selector/shadow-dom.ts b/app/chrome-extension/shared/selector/shadow-dom.ts new file mode 100644 index 00000000..85e0fa05 --- /dev/null +++ b/app/chrome-extension/shared/selector/shadow-dom.ts @@ -0,0 +1,291 @@ +/** + * Shadow DOM Utilities - Chain traversal and scoped querying. + * + * This module provides utilities for traversing Shadow DOM boundaries + * and querying elements within shadow roots. + * + * Design principles: + * - This module only handles traversal and querying, NOT selector generation + * - Selector generation for shadow hosts belongs in generator.ts to avoid circular deps + * - All operations require unique selector matches for safety + */ + +// ============================================================================= +// Types +// ============================================================================= + +/** Possible failure reasons during shadow DOM traversal */ +export type ShadowTraversalFailureReason = + | 'empty_chain' + | 'no_root' + | 'invalid_selector' + | 'no_match' + | 'multiple_matches' + | 'no_shadow_root'; + +/** + * Result of shadow DOM traversal with detailed error information + */ +export interface ShadowTraversalResult { + success: boolean; + shadowRoot: ShadowRoot | null; + /** Index of the first failing selector in the chain (-1 if no chain processing occurred) */ + failedAt: number; + /** Reason for failure if not successful */ + reason?: ShadowTraversalFailureReason; +} + +// ============================================================================= +// Internal Helpers +// ============================================================================= + +function getDefaultRoot(): Document | null { + if (typeof document !== 'undefined') { + return document; + } + return null; +} + +function safeQuerySelector(root: Document | ShadowRoot, selector: string): Element | null { + try { + return root.querySelector(selector); + } catch { + return null; + } +} + +function safeQuerySelectorAll( + root: Document | ShadowRoot, + selector: string, +): NodeListOf | null { + try { + return root.querySelectorAll(selector); + } catch { + return null; + } +} + +/** + * Query result with match count for detailed error reporting + */ +interface QueryResult { + element: Element | null; + matchCount: number; + isValid: boolean; +} + +function queryWithDetails(root: Document | ShadowRoot, selector: string): QueryResult { + const elements = safeQuerySelectorAll(root, selector); + if (elements === null) { + return { element: null, matchCount: 0, isValid: false }; + } + return { + element: elements.length > 0 ? elements[0] : null, + matchCount: elements.length, + isValid: true, + }; +} + +function isUnique(root: Document | ShadowRoot, selector: string): boolean { + const result = queryWithDetails(root, selector); + return result.isValid && result.matchCount === 1; +} + +// ============================================================================= +// Core Functions +// ============================================================================= + +/** + * Traverse a Shadow DOM host selector chain and return detailed result. + * + * @param hostChain - Shadow host selectors ordered from outermost to innermost + * @param root - Starting query root (defaults to document) + * @returns Detailed traversal result with success status and error info + * + * @example + * ```ts + * const result = traverseShadowDomWithDetails( + * ['my-component', 'inner-component'], + * document + * ); + * if (result.success) { + * // query within result.shadowRoot + * } + * ``` + */ +export function traverseShadowDomWithDetails( + hostChain: ReadonlyArray, + root?: Document | ShadowRoot, +): ShadowTraversalResult { + // Empty chain means no shadow boundary + if (!Array.isArray(hostChain) || hostChain.length === 0) { + return { success: false, shadowRoot: null, failedAt: -1, reason: 'empty_chain' }; + } + + const initialRoot = root ?? getDefaultRoot(); + if (!initialRoot) { + return { success: false, shadowRoot: null, failedAt: -1, reason: 'no_root' }; + } + + let queryRoot: Document | ShadowRoot = initialRoot; + + for (let i = 0; i < hostChain.length; i++) { + const rawSelector = hostChain[i]; + const hostSelector = typeof rawSelector === 'string' ? rawSelector.trim() : ''; + + if (!hostSelector) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'invalid_selector' }; + } + + // Use queryWithDetails for precise error reporting + const queryResult = queryWithDetails(queryRoot, hostSelector); + + if (!queryResult.isValid) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'invalid_selector' }; + } + + if (queryResult.matchCount === 0) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'no_match' }; + } + + if (queryResult.matchCount > 1) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'multiple_matches' }; + } + + const host = queryResult.element; + if (!host) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'no_match' }; + } + + // Only open shadow roots are accessible via .shadowRoot + const shadowRoot = host.shadowRoot; + if (!shadowRoot) { + return { success: false, shadowRoot: null, failedAt: i, reason: 'no_shadow_root' }; + } + + queryRoot = shadowRoot; + } + + if (queryRoot instanceof ShadowRoot) { + return { success: true, shadowRoot: queryRoot, failedAt: -1 }; + } + + return { + success: false, + shadowRoot: null, + failedAt: hostChain.length - 1, + reason: 'no_shadow_root', + }; +} + +/** + * Traverse a Shadow DOM host selector chain and return the innermost ShadowRoot. + * + * This is the simplified version of traverseShadowDomWithDetails. + * + * @param hostChain - Shadow host selectors ordered from outermost to innermost + * @param root - Starting query root (defaults to document) + * @returns The innermost ShadowRoot, or null if traversal fails or chain is empty + * + * @example + * ```ts + * const shadowRoot = traverseShadowDom(['my-component', 'inner-component']); + * if (shadowRoot) { + * const button = shadowRoot.querySelector('button'); + * } + * ``` + */ +export function traverseShadowDom( + hostChain: ReadonlyArray, + root?: Document | ShadowRoot, +): ShadowRoot | null { + const result = traverseShadowDomWithDetails(hostChain, root); + return result.shadowRoot; +} + +/** + * Query an element within the innermost ShadowRoot resolved by a host chain. + * + * @param selector - CSS selector to query within the resolved ShadowRoot + * @param hostChain - Shadow host selectors ordered from outermost to innermost + * @param root - Starting query root (defaults to document) + * @returns The first matched element, or null if traversal fails or no match + * + * @example + * ```ts + * const button = queryInShadowDom( + * 'button.submit', + * ['my-component', 'form-wrapper'] + * ); + * ``` + */ +export function queryInShadowDom( + selector: string, + hostChain: ReadonlyArray, + root?: Document | ShadowRoot, +): Element | null { + const sel = typeof selector === 'string' ? selector.trim() : ''; + if (!sel) { + return null; + } + + const shadowRoot = traverseShadowDom(hostChain, root); + if (!shadowRoot) { + return null; + } + + return safeQuerySelector(shadowRoot, sel); +} + +/** + * Query all matching elements within the innermost ShadowRoot resolved by a host chain. + * + * @param selector - CSS selector to query within the resolved ShadowRoot + * @param hostChain - Shadow host selectors ordered from outermost to innermost + * @param root - Starting query root (defaults to document) + * @returns Array of matched elements, or empty array if traversal fails + */ +export function queryAllInShadowDom( + selector: string, + hostChain: ReadonlyArray, + root?: Document | ShadowRoot, +): Element[] { + const sel = typeof selector === 'string' ? selector.trim() : ''; + if (!sel) { + return []; + } + + const shadowRoot = traverseShadowDom(hostChain, root); + if (!shadowRoot) { + return []; + } + + const elements = safeQuerySelectorAll(shadowRoot, sel); + return elements ? Array.from(elements) : []; +} + +/** + * Check if a selector uniquely matches an element within the shadow chain. + * + * @param selector - CSS selector to check + * @param hostChain - Shadow host selectors ordered from outermost to innermost + * @param root - Starting query root (defaults to document) + * @returns true if selector matches exactly one element + */ +export function isUniqueInShadowDom( + selector: string, + hostChain: ReadonlyArray, + root?: Document | ShadowRoot, +): boolean { + const sel = typeof selector === 'string' ? selector.trim() : ''; + if (!sel) { + return false; + } + + const shadowRoot = traverseShadowDom(hostChain, root); + if (!shadowRoot) { + return false; + } + + return isUnique(shadowRoot, sel); +} diff --git a/app/chrome-extension/shared/selector/stability.ts b/app/chrome-extension/shared/selector/stability.ts new file mode 100644 index 00000000..f5ecc285 --- /dev/null +++ b/app/chrome-extension/shared/selector/stability.ts @@ -0,0 +1,197 @@ +/** + * Selector Stability - 选择器稳定性评估 + */ + +import type { + SelectorCandidate, + SelectorStability, + SelectorStabilitySignals, + SelectorType, +} from './types'; +import { splitCompositeSelector } from './types'; + +const TESTID_ATTR_NAMES = [ + 'data-testid', + 'data-test-id', + 'data-test', + 'data-qa', + 'data-cy', +] as const; + +function clamp01(n: number): number { + if (!Number.isFinite(n)) return 0; + return Math.min(1, Math.max(0, n)); +} + +function mergeSignals( + a: SelectorStabilitySignals, + b: SelectorStabilitySignals, +): SelectorStabilitySignals { + return { + usesId: a.usesId || b.usesId || undefined, + usesTestId: a.usesTestId || b.usesTestId || undefined, + usesAria: a.usesAria || b.usesAria || undefined, + usesText: a.usesText || b.usesText || undefined, + usesNthOfType: a.usesNthOfType || b.usesNthOfType || undefined, + usesAttributes: a.usesAttributes || b.usesAttributes || undefined, + usesClass: a.usesClass || b.usesClass || undefined, + }; +} + +function analyzeCssLike(selector: string): SelectorStabilitySignals { + const s = String(selector || ''); + const usesNthOfType = /:nth-of-type\(/i.test(s); + const usesAttributes = /\[[^\]]+\]/.test(s); + const usesAria = /\[\s*aria-[^=]+\s*=|\[\s*role\s*=|\brole\s*=\s*/i.test(s); + + // Avoid counting `#` inside attribute values (e.g. href="#...") by requiring a token-ish pattern. + const usesId = /(^|[\s>+~])#[^\s>+~.:#[]+/.test(s); + const usesClass = /(^|[\s>+~])\.[^\s>+~.:#[]+/.test(s); + + const lower = s.toLowerCase(); + const usesTestId = TESTID_ATTR_NAMES.some((a) => lower.includes(`[${a}`)); + + return { + usesId: usesId || undefined, + usesTestId: usesTestId || undefined, + usesAria: usesAria || undefined, + usesNthOfType: usesNthOfType || undefined, + usesAttributes: usesAttributes || undefined, + usesClass: usesClass || undefined, + }; +} + +function baseScoreForCssSignals(signals: SelectorStabilitySignals): number { + if (signals.usesTestId) return 0.95; + if (signals.usesId) return 0.9; + if (signals.usesAria) return 0.8; + if (signals.usesAttributes) return 0.75; + if (signals.usesClass) return 0.65; + return 0.5; +} + +function lengthPenalty(value: string): number { + const len = value.length; + if (len <= 60) return 0; + if (len <= 120) return 0.05; + if (len <= 200) return 0.1; + return 0.18; +} + +/** + * 计算选择器稳定性评分 + */ +export function computeSelectorStability(candidate: SelectorCandidate): SelectorStability { + if (candidate.type === 'css' || candidate.type === 'attr') { + const composite = splitCompositeSelector(candidate.value); + if (composite) { + const a = analyzeCssLike(composite.frameSelector); + const b = analyzeCssLike(composite.innerSelector); + const merged = mergeSignals(a, b); + + let score = baseScoreForCssSignals(merged); + score -= 0.05; // iframe coupling penalty + if (merged.usesNthOfType) score -= 0.2; + score -= lengthPenalty(candidate.value); + + return { score: clamp01(score), signals: merged, note: 'composite' }; + } + + const signals = analyzeCssLike(candidate.value); + let score = baseScoreForCssSignals(signals); + if (signals.usesNthOfType) score -= 0.2; + score -= lengthPenalty(candidate.value); + + return { score: clamp01(score), signals }; + } + + if (candidate.type === 'xpath') { + const s = String(candidate.value || ''); + const signals: SelectorStabilitySignals = { + usesAttributes: /@[\w-]+\s*=/.test(s) || undefined, + usesId: /@id\s*=/.test(s) || undefined, + usesTestId: /@data-testid\s*=/.test(s) || undefined, + }; + + let score = 0.42; + if (signals.usesTestId) score = 0.85; + else if (signals.usesId) score = 0.75; + else if (signals.usesAttributes) score = 0.55; + + score -= lengthPenalty(s); + return { score: clamp01(score), signals }; + } + + if (candidate.type === 'aria') { + const hasName = typeof candidate.name === 'string' && candidate.name.trim().length > 0; + const hasRole = typeof candidate.role === 'string' && candidate.role.trim().length > 0; + + const signals: SelectorStabilitySignals = { usesAria: true }; + let score = hasName && hasRole ? 0.8 : hasName ? 0.72 : 0.6; + score -= lengthPenalty(candidate.value); + + return { score: clamp01(score), signals }; + } + + // text + const text = String(candidate.value || '').trim(); + const signals: SelectorStabilitySignals = { usesText: true }; + let score = 0.35; + + // Very short texts tend to be ambiguous; very long texts are unstable. + if (text.length >= 6 && text.length <= 48) score = 0.45; + if (text.length > 80) score = 0.3; + + return { score: clamp01(score), signals }; +} + +/** + * 为选择器候选添加稳定性评分 + */ +export function withStability(candidate: SelectorCandidate): SelectorCandidate { + if (candidate.stability) return candidate; + return { ...candidate, stability: computeSelectorStability(candidate) }; +} + +function typePriority(type: SelectorType): number { + switch (type) { + case 'attr': + return 5; + case 'css': + return 4; + case 'aria': + return 3; + case 'xpath': + return 2; + case 'text': + return 1; + default: + return 0; + } +} + +/** + * 比较两个选择器候选的优先级 + * 返回负数表示 a 优先，正数表示 b 优先 + */ +export function compareSelectorCandidates(a: SelectorCandidate, b: SelectorCandidate): number { + // 1. 用户指定的权重优先 + const aw = a.weight ?? 0; + const bw = b.weight ?? 0; + if (aw !== bw) return bw - aw; + + // 2. 稳定性评分 + const as = a.stability?.score ?? computeSelectorStability(a).score; + const bs = b.stability?.score ?? computeSelectorStability(b).score; + if (as !== bs) return bs - as; + + // 3. 类型优先级 + const ap = typePriority(a.type); + const bp = typePriority(b.type); + if (ap !== bp) return bp - ap; + + // 4. 长度（越短越好） + const alen = String(a.value || '').length; + const blen = String(b.value || '').length; + return alen - blen; +} diff --git a/app/chrome-extension/shared/selector/strategies/anchor-relpath.ts b/app/chrome-extension/shared/selector/strategies/anchor-relpath.ts new file mode 100644 index 00000000..5c7f62a3 --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/anchor-relpath.ts @@ -0,0 +1,242 @@ +/** + * Anchor + Relative Path Strategy + * + * This strategy generates selectors by finding a stable ancestor "anchor" + * (element with unique id or data-testid/data-qa/etc.) and building a + * relative path from that anchor to the target element. + * + * Use case: When the target element itself has no unique identifiers, + * but a nearby ancestor does. + * + * Example output: '[data-testid="card"] div > span:nth-of-type(2) > button' + * (anchor selector + descendant combinator + relative path with child combinators) + */ + +import type { SelectorCandidate, SelectorStrategy, SelectorStrategyContext } from '../types'; + +// ============================================================================= +// Constants +// ============================================================================= + +/** Maximum ancestor depth to search for an anchor */ +const MAX_ANCHOR_DEPTH = 20; + +/** Data attributes eligible for anchor selection (stable, test-friendly) */ +const ANCHOR_DATA_ATTRS = [ + 'data-testid', + 'data-test-id', + 'data-test', + 'data-qa', + 'data-cy', +] as const; + +/** + * Weight penalty for anchor-relpath candidates. + * This ensures they rank lower than direct selectors (id, testid, class) + * but higher than pure text selectors. + */ +const ANCHOR_RELPATH_WEIGHT = -10; + +// ============================================================================= +// Internal Helpers +// ============================================================================= + +function safeQuerySelector(root: ParentNode, selector: string): Element | null { + try { + return root.querySelector(selector); + } catch { + return null; + } +} + +/** + * Get siblings from the appropriate parent context + */ +function getSiblings(element: Element): Element[] { + const parent = element.parentElement; + if (parent) { + return Array.from(parent.children); + } + + const parentNode = element.parentNode; + if (parentNode instanceof ShadowRoot || parentNode instanceof Document) { + return Array.from(parentNode.children); + } + + return []; +} + +/** + * Try to build a unique anchor selector for an element. + * Only uses stable identifiers: id or ANCHOR_DATA_ATTRS. + */ +function tryAnchorSelector(element: Element, ctx: SelectorStrategyContext): string | null { + const { helpers } = ctx; + const tag = element.tagName.toLowerCase(); + + // Try ID first (highest priority) + const id = element.id?.trim(); + if (id) { + const idSelector = `#${helpers.cssEscape(id)}`; + if (helpers.isUnique(idSelector)) { + return idSelector; + } + } + + // Try stable data attributes + for (const attr of ANCHOR_DATA_ATTRS) { + const value = element.getAttribute(attr)?.trim(); + if (!value) continue; + + const escaped = helpers.cssEscape(value); + + // Try attribute-only selector + const attrOnly = `[${attr}="${escaped}"]`; + if (helpers.isUnique(attrOnly)) { + return attrOnly; + } + + // Try with tag prefix for disambiguation + const withTag = `${tag}${attrOnly}`; + if (helpers.isUnique(withTag)) { + return withTag; + } + } + + return null; +} + +/** + * Build a relative path selector from an ancestor to a target element. + * Uses tag names with :nth-of-type() for disambiguation. + * + * @returns Selector string like "div > span:nth-of-type(2) > button", or null if failed + */ +function buildRelativePathSelector( + ancestor: Element, + target: Element, + root: Document | ShadowRoot, +): string | null { + const segments: string[] = []; + let current: Element | null = target; + + for (let depth = 0; current && current !== ancestor && depth < MAX_ANCHOR_DEPTH; depth++) { + const tag = current.tagName.toLowerCase(); + let segment = tag; + + // Calculate nth-of-type index if there are siblings with same tag + const siblings = getSiblings(current); + const sameTagSiblings = siblings.filter((s) => s.tagName === current!.tagName); + + if (sameTagSiblings.length > 1) { + const index = sameTagSiblings.indexOf(current) + 1; + segment += `:nth-of-type(${index})`; + } + + segments.unshift(segment); + + // Move to parent + const parentEl: Element | null = current.parentElement; + if (!parentEl) { + // Check if we've reached the root boundary + const parentNode = current.parentNode; + if (parentNode === root) break; + break; + } + + current = parentEl; + } + + // Verify we reached the ancestor + if (current !== ancestor) { + return null; + } + + return segments.length > 0 ? segments.join(' > ') : null; +} + +/** + * Build an "anchor + relative path" selector for an element. + * + * Algorithm: + * 1. Walk up from target's parent, looking for an anchor + * 2. For each potential anchor, build the relative path + * 3. Verify the composed selector uniquely matches the target + */ +function buildAnchorRelPathSelector(element: Element, ctx: SelectorStrategyContext): string | null { + const { root } = ctx; + + // Ensure root is a valid query context + if (!(root instanceof Document || root instanceof ShadowRoot)) { + return null; + } + + let current: Element | null = element.parentElement; + + for (let depth = 0; current && depth < MAX_ANCHOR_DEPTH; depth++) { + // Skip document root elements + const tagUpper = current.tagName.toUpperCase(); + if (tagUpper === 'HTML' || tagUpper === 'BODY') { + break; + } + + // Try to use this element as an anchor + const anchor = tryAnchorSelector(current, ctx); + if (!anchor) { + current = current.parentElement; + continue; + } + + // Build relative path from anchor to target + const relativePath = buildRelativePathSelector(current, element, root); + if (!relativePath) { + current = current.parentElement; + continue; + } + + // Compose the full selector + const composed = `${anchor} ${relativePath}`; + + // Verify uniqueness + if (!ctx.helpers.isUnique(composed)) { + current = current.parentElement; + continue; + } + + // Final verification: ensure we match the exact element + const found = safeQuerySelector(root, composed); + if (found === element) { + return composed; + } + + current = current.parentElement; + } + + return null; +} + +// ============================================================================= +// Strategy Export +// ============================================================================= + +export const anchorRelpathStrategy: SelectorStrategy = { + id: 'anchor-relpath', + + generate(ctx: SelectorStrategyContext): ReadonlyArray { + const selector = buildAnchorRelPathSelector(ctx.element, ctx); + + if (!selector) { + return []; + } + + return [ + { + type: 'css', + value: selector, + weight: ANCHOR_RELPATH_WEIGHT, + source: 'generated', + strategy: 'anchor-relpath', + }, + ]; + }, +}; diff --git a/app/chrome-extension/shared/selector/strategies/aria.ts b/app/chrome-extension/shared/selector/strategies/aria.ts new file mode 100644 index 00000000..0af43f42 --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/aria.ts @@ -0,0 +1,78 @@ +/** + * ARIA Strategy - 基于无障碍属性的选择器策略 + * 使用 aria-label, role 等属性生成选择器 + */ + +import type { SelectorCandidate, SelectorStrategy } from '../types'; + +function guessRoleByTag(tag: string): string | undefined { + if (tag === 'input' || tag === 'textarea') return 'textbox'; + if (tag === 'button') return 'button'; + if (tag === 'a') return 'link'; + return undefined; +} + +function uniqStrings(items: ReadonlyArray): string[] { + const seen = new Set(); + const out: string[] = []; + for (const s of items) { + const v = s.trim(); + if (!v) continue; + if (seen.has(v)) continue; + seen.add(v); + out.push(v); + } + return out; +} + +export const ariaStrategy: SelectorStrategy = { + id: 'aria', + generate(ctx) { + if (!ctx.options.includeAria) return []; + + const { element, helpers } = ctx; + const out: SelectorCandidate[] = []; + + const name = element.getAttribute('aria-label')?.trim(); + if (!name) return out; + + const tag = element.tagName?.toLowerCase?.() ?? ''; + const role = element.getAttribute('role')?.trim() || guessRoleByTag(tag); + + const qName = JSON.stringify(name); + const selectors: string[] = []; + + if (role) selectors.push(`[role=${JSON.stringify(role)}][aria-label=${qName}]`); + selectors.push(`[aria-label=${qName}]`); + + if (role === 'textbox') { + selectors.unshift( + `input[aria-label=${qName}]`, + `textarea[aria-label=${qName}]`, + `[role="textbox"][aria-label=${qName}]`, + ); + } else if (role === 'button') { + selectors.unshift(`button[aria-label=${qName}]`, `[role="button"][aria-label=${qName}]`); + } else if (role === 'link') { + selectors.unshift(`a[aria-label=${qName}]`, `[role="link"][aria-label=${qName}]`); + } + + for (const sel of uniqStrings(selectors)) { + if (helpers.isUnique(sel)) { + out.push({ type: 'attr', value: sel, source: 'generated', strategy: 'aria' }); + } + } + + // Structured aria candidate for UI/debugging (locator can translate it too). + out.push({ + type: 'aria', + value: `${role ?? 'element'}[name=${JSON.stringify(name)}]`, + role, + name, + source: 'generated', + strategy: 'aria', + }); + + return out; + }, +}; diff --git a/app/chrome-extension/shared/selector/strategies/css-path.ts b/app/chrome-extension/shared/selector/strategies/css-path.ts new file mode 100644 index 00000000..eb2769a4 --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/css-path.ts @@ -0,0 +1,46 @@ +/** + * CSS Path Strategy - 基于 DOM 路径的选择器策略 + * 使用 nth-of-type 生成完整的 CSS 路径 + */ + +import type { SelectorCandidate, SelectorStrategy } from '../types'; + +export const cssPathStrategy: SelectorStrategy = { + id: 'css-path', + generate(ctx) { + if (!ctx.options.includeCssPath) return []; + + const { element } = ctx; + + const segments: string[] = []; + let current: Element | null = element; + + while (current) { + const tag = current.tagName?.toLowerCase?.() ?? ''; + if (!tag) break; + + let segment = tag; + + const parent = current.parentElement; + if (parent) { + const siblings = Array.from(parent.children).filter((c) => c.tagName === current!.tagName); + if (siblings.length > 1) { + const index = siblings.indexOf(current) + 1; + if (index > 0) segment += `:nth-of-type(${index})`; + } + } + + segments.unshift(segment); + + if (tag === 'body') break; + current = parent; + } + + const selector = segments.length ? segments.join(' > ') : 'body'; + + const out: SelectorCandidate[] = [ + { type: 'css', value: selector, source: 'generated', strategy: 'css-path' }, + ]; + return out; + }, +}; diff --git a/app/chrome-extension/shared/selector/strategies/css-unique.ts b/app/chrome-extension/shared/selector/strategies/css-unique.ts new file mode 100644 index 00000000..9f3b0cfa --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/css-unique.ts @@ -0,0 +1,94 @@ +/** + * CSS Unique Strategy - 基于唯一 ID 或 class 组合的选择器策略 + */ + +import type { SelectorCandidate, SelectorStrategy } from '../types'; + +const MAX_CLASS_COUNT = 24; +const MAX_COMBO_CLASSES = 8; +const MAX_CANDIDATES = 6; + +function isValidClassToken(token: string): boolean { + return /^[a-zA-Z0-9_-]+$/.test(token); +} + +export const cssUniqueStrategy: SelectorStrategy = { + id: 'css-unique', + generate(ctx) { + if (!ctx.options.includeCssUnique) return []; + + const { element, helpers } = ctx; + const out: SelectorCandidate[] = []; + + const tag = element.tagName?.toLowerCase?.() ?? ''; + + // 1) Unique ID selector + const id = element.id?.trim(); + if (id) { + const sel = `#${helpers.cssEscape(id)}`; + if (helpers.isUnique(sel)) { + out.push({ type: 'css', value: sel, source: 'generated', strategy: 'css-unique' }); + } + } + + if (out.length >= MAX_CANDIDATES) return out; + + // 2) Unique class selectors + const classList = Array.from(element.classList || []) + .map((c) => String(c).trim()) + .filter((c) => c.length > 0 && isValidClassToken(c)) + .slice(0, MAX_CLASS_COUNT); + + for (const cls of classList) { + if (out.length >= MAX_CANDIDATES) break; + const sel = `.${helpers.cssEscape(cls)}`; + if (helpers.isUnique(sel)) { + out.push({ type: 'css', value: sel, source: 'generated', strategy: 'css-unique' }); + } + } + + if (tag) { + for (const cls of classList) { + if (out.length >= MAX_CANDIDATES) break; + const sel = `${tag}.${helpers.cssEscape(cls)}`; + if (helpers.isUnique(sel)) { + out.push({ type: 'css', value: sel, source: 'generated', strategy: 'css-unique' }); + } + } + } + + if (out.length >= MAX_CANDIDATES) return out; + + // 3) Class combinations (depth 2/3), limited to avoid heavy queries. + const comboSource = classList.slice(0, MAX_COMBO_CLASSES).map((c) => helpers.cssEscape(c)); + + const tryPush = (selector: string): void => { + if (out.length >= MAX_CANDIDATES) return; + if (!helpers.isUnique(selector)) return; + out.push({ type: 'css', value: selector, source: 'generated', strategy: 'css-unique' }); + }; + + const tryPushWithTag = (selector: string): void => { + tryPush(selector); + if (tag) tryPush(`${tag}${selector}`); + }; + + // Depth 2 + for (let i = 0; i < comboSource.length && out.length < MAX_CANDIDATES; i++) { + for (let j = i + 1; j < comboSource.length && out.length < MAX_CANDIDATES; j++) { + tryPushWithTag(`.${comboSource[i]}.${comboSource[j]}`); + } + } + + // Depth 3 + for (let i = 0; i < comboSource.length && out.length < MAX_CANDIDATES; i++) { + for (let j = i + 1; j < comboSource.length && out.length < MAX_CANDIDATES; j++) { + for (let k = j + 1; k < comboSource.length && out.length < MAX_CANDIDATES; k++) { + tryPushWithTag(`.${comboSource[i]}.${comboSource[j]}.${comboSource[k]}`); + } + } + } + + return out; + }, +}; diff --git a/app/chrome-extension/shared/selector/strategies/index.ts b/app/chrome-extension/shared/selector/strategies/index.ts new file mode 100644 index 00000000..9c033094 --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/index.ts @@ -0,0 +1,41 @@ +/** + * Selector Strategies - Strategy exports and default configuration + */ + +import type { SelectorStrategy } from '../types'; +import { anchorRelpathStrategy } from './anchor-relpath'; +import { ariaStrategy } from './aria'; +import { cssPathStrategy } from './css-path'; +import { cssUniqueStrategy } from './css-unique'; +import { testIdStrategy } from './testid'; +import { textStrategy } from './text'; + +/** + * Default selector strategy list (ordered by priority). + * + * Strategy order: + * 1. testid - Stable test attributes (data-testid, name, title, alt) + * 2. aria - Accessibility attributes (aria-label, role) + * 3. css-unique - Unique CSS selectors (id, class combinations) + * 4. css-path - Structural path selector (nth-of-type) + * 5. anchor-relpath - Anchor + relative path (fallback for elements without unique attrs) + * 6. text - Text content selector (lowest priority) + * + * Note: Final candidate order is determined by stability scoring, + * but strategy order affects which candidates are generated first. + */ +export const DEFAULT_SELECTOR_STRATEGIES: ReadonlyArray = [ + testIdStrategy, + ariaStrategy, + cssUniqueStrategy, + cssPathStrategy, + anchorRelpathStrategy, + textStrategy, +]; + +export { anchorRelpathStrategy } from './anchor-relpath'; +export { ariaStrategy } from './aria'; +export { cssPathStrategy } from './css-path'; +export { cssUniqueStrategy } from './css-unique'; +export { testIdStrategy } from './testid'; +export { textStrategy } from './text'; diff --git a/app/chrome-extension/shared/selector/strategies/testid.ts b/app/chrome-extension/shared/selector/strategies/testid.ts new file mode 100644 index 00000000..c5217b2f --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/testid.ts @@ -0,0 +1,124 @@ +/** + * TestID Strategy - Attribute-based selector strategy + * + * Generates selectors based on stable attributes like data-testid, data-cy, + * as well as semantic attributes like name, title, and alt. + */ + +import type { SelectorCandidate, SelectorStrategy } from '../types'; + +// ============================================================================= +// Constants +// ============================================================================= + +/** Tags that commonly use form-related attributes */ +const FORM_ELEMENT_TAGS = new Set(['input', 'textarea', 'select', 'button']); + +/** Tags that commonly use the 'alt' attribute */ +const ALT_ATTRIBUTE_TAGS = new Set(['img', 'area']); + +/** Tags that commonly use the 'title' attribute (most elements can have it) */ +const TITLE_ATTRIBUTE_TAGS = new Set(['img', 'a', 'abbr', 'iframe', 'link']); + +/** + * Mapping of attributes to their preferred tag prefixes. + * When an attribute-only selector is not unique, we try tag-prefixed form + * only for elements where that attribute is semantically meaningful. + */ +const ATTR_TAG_PREFERENCES: Record> = { + name: FORM_ELEMENT_TAGS, + alt: ALT_ATTRIBUTE_TAGS, + title: TITLE_ATTRIBUTE_TAGS, +}; + +// ============================================================================= +// Helpers +// ============================================================================= + +function makeAttrSelector(attr: string, value: string, cssEscape: (v: string) => string): string { + return `[${attr}="${cssEscape(value)}"]`; +} + +/** + * Determine if tag prefix should be tried for disambiguation. + * + * Rules: + * - data-* attributes: try for form elements only + * - name: try for form elements (input, textarea, select, button) + * - alt: try for img, area, input[type=image] + * - title: try for common elements that use title semantically + * - Default: try for any tag + */ +function shouldTryTagPrefix(attr: string, tag: string, element: Element): boolean { + if (!tag) return false; + + // For data-* test attributes, use form element heuristic + if (attr.startsWith('data-')) { + return FORM_ELEMENT_TAGS.has(tag); + } + + // For semantic attributes, check the preference mapping + const preferredTags = ATTR_TAG_PREFERENCES[attr]; + if (preferredTags) { + if (preferredTags.has(tag)) return true; + + // Special case: input[type=image] also uses alt + if (attr === 'alt' && tag === 'input') { + const type = element.getAttribute('type'); + return type === 'image'; + } + + return false; + } + + // Default: try tag prefix for any element + return true; +} + +// ============================================================================= +// Strategy Export +// ============================================================================= + +export const testIdStrategy: SelectorStrategy = { + id: 'testid', + + generate(ctx) { + const { element, options, helpers } = ctx; + const out: SelectorCandidate[] = []; + const tag = element.tagName?.toLowerCase?.() ?? ''; + + for (const attr of options.testIdAttributes) { + const raw = element.getAttribute(attr); + const value = raw?.trim(); + if (!value) continue; + + const attrOnly = makeAttrSelector(attr, value, helpers.cssEscape); + + // Try attribute-only selector first + if (helpers.isUnique(attrOnly)) { + out.push({ + type: 'attr', + value: attrOnly, + source: 'generated', + strategy: 'testid', + }); + continue; + } + + // Try tag-prefixed form if appropriate for this attribute/element combo + if (shouldTryTagPrefix(attr, tag, element)) { + const withTag = `${tag}${attrOnly}`; + if (helpers.isUnique(withTag)) { + out.push({ + type: 'attr', + value: withTag, + source: 'generated', + strategy: 'testid', + }); + } + } + } + + return out; + }, +}; diff --git a/app/chrome-extension/shared/selector/strategies/text.ts b/app/chrome-extension/shared/selector/strategies/text.ts new file mode 100644 index 00000000..6fee145c --- /dev/null +++ b/app/chrome-extension/shared/selector/strategies/text.ts @@ -0,0 +1,50 @@ +/** + * Text Strategy - Text content based selector strategy + * + * This is the lowest priority fallback strategy. Text selectors are less + * stable than attribute-based or structural selectors because text content + * is more likely to change (i18n, dynamic content, etc.). + */ + +import type { SelectorCandidate, SelectorStrategy } from '../types'; + +/** + * Weight penalty for text selectors. + * This ensures text selectors rank after all other strategies including anchor-relpath. + * anchor-relpath uses -10, so text uses -20 to rank lower. + */ +const TEXT_STRATEGY_WEIGHT = -20; + +function normalizeText(value: string): string { + return String(value || '') + .replace(/\s+/g, ' ') + .trim(); +} + +export const textStrategy: SelectorStrategy = { + id: 'text', + + generate(ctx) { + if (!ctx.options.includeText) return []; + + const { element, options } = ctx; + const tag = element.tagName?.toLowerCase?.() ?? ''; + if (!tag || !options.textTags.includes(tag)) return []; + + const raw = element.textContent || ''; + const text = normalizeText(raw).slice(0, options.textMaxLength); + if (!text) return []; + + return [ + { + type: 'text', + value: text, + match: 'contains', + tagNameHint: tag, + weight: TEXT_STRATEGY_WEIGHT, + source: 'generated', + strategy: 'text', + }, + ]; + }, +}; diff --git a/app/chrome-extension/shared/selector/types.ts b/app/chrome-extension/shared/selector/types.ts new file mode 100644 index 00000000..4dd6caf2 --- /dev/null +++ b/app/chrome-extension/shared/selector/types.ts @@ -0,0 +1,227 @@ +/** + * Shared selector engine types. + * + * Goals: + * - JSON-serializable (store in flows / send across message boundary) + * - Reusable from both content scripts and background + * + * Composite selector format: + * " |> " + * This is kept for backward compatibility with the existing recorder and + * accessibility-tree helper. + */ + +export type NonEmptyArray = [T, ...T[]]; + +export interface Point { + x: number; + y: number; +} + +export type SelectorType = 'css' | 'xpath' | 'attr' | 'aria' | 'text'; +export type SelectorCandidateSource = 'recorded' | 'user' | 'generated'; + +export interface SelectorStabilitySignals { + usesId?: boolean; + usesTestId?: boolean; + usesAria?: boolean; + usesText?: boolean; + usesNthOfType?: boolean; + usesAttributes?: boolean; + usesClass?: boolean; +} + +export interface SelectorStability { + /** Stability score in range [0, 1]. Higher is more stable. */ + score: number; + signals?: SelectorStabilitySignals; + note?: string; +} + +export interface SelectorCandidateBase { + type: SelectorType; + /** + * Primary representation: + * - css/attr: CSS selector string + * - xpath: XPath expression string + * - text: visible text query string + * - aria: human-readable expression for debugging/UI + */ + value: string; + /** Optional user-adjustable priority. Higher wins when ordering candidates. */ + weight?: number; + /** Where this candidate came from. */ + source?: SelectorCandidateSource; + /** Strategy identifier that produced this candidate. */ + strategy?: string; + /** Optional computed stability. */ + stability?: SelectorStability; +} + +export type TextMatchMode = 'exact' | 'contains'; + +export type SelectorCandidate = + | (SelectorCandidateBase & { type: 'css' | 'attr' }) + | (SelectorCandidateBase & { type: 'xpath' }) + | (SelectorCandidateBase & { type: 'text'; match?: TextMatchMode; tagNameHint?: string }) + | (SelectorCandidateBase & { type: 'aria'; role?: string; name?: string }); + +export interface SelectorTarget { + /** + * Optional primary selector string. + * This is the fast path for locating (usually CSS). May be composite. + */ + selector?: string; + /** Ordered candidates; must be non-empty. */ + candidates: NonEmptyArray; + /** Optional tag name hint used for text search. */ + tagName?: string; + /** Optional ephemeral element ref, when available. */ + ref?: string; + + // -------------------------------- + // Extended Locator Metadata (Phase 1.2) + // -------------------------------- + // These fields are generated and carried across message/storage boundaries, + // but the background-side SelectorLocator may not fully use them until + // Phase 2 wires the DOM-side protocol (fingerprint verification, shadow traversal). + + /** + * Structural fingerprint for fuzzy element matching. + * Format: "tag|id=xxx|class=a.b.c|text=xxx" + */ + fingerprint?: string; + + /** + * Child-index path relative to the current root (Document/ShadowRoot). + * Used for fast element recovery when selectors fail. + */ + domPath?: number[]; + + /** + * Shadow host selector chain (outer -> inner). + * When present, selectors/domPath are relative to the innermost ShadowRoot. + */ + shadowHostChain?: string[]; +} + +/** + * SelectorTarget with required extended locator metadata. + * + * Use this type when all extended fields must be present (e.g., for reliable + * cross-session persistence or HMR recovery). + * + * Note: Phase 1.2 only guarantees generation/transport; behavioral enforcement + * (fingerprint verification, shadow traversal) depends on Phase 2 integration. + */ +export interface ExtendedSelectorTarget extends SelectorTarget { + fingerprint: string; + domPath: number[]; + /** May be empty array if element is not inside Shadow DOM */ + shadowHostChain: string[]; +} + +export interface LocatedElement { + ref: string; + center: Point; + /** Resolved frameId in the tab (when inside an iframe). */ + frameId?: number; + resolvedBy: 'ref' | SelectorType; + selectorUsed?: string; +} + +export interface SelectorLocateOptions { + /** Frame context for non-composite selectors (default: top frame). */ + frameId?: number; + /** Whether to try resolving `target.ref` before selectors. */ + preferRef?: boolean; + /** Forwarded to helper uniqueness checks. */ + allowMultiple?: boolean; + /** + * Whether to verify target.fingerprint when available. + * + * Note: Phase 1.2 exposes this option but may not fully enforce it until + * the DOM-side protocol is wired (Phase 2). + */ + verifyFingerprint?: boolean; +} + +// ================================ +// Composite Selector Utilities +// ================================ + +export const COMPOSITE_SELECTOR_SEPARATOR = '|>' as const; + +export interface CompositeSelectorParts { + frameSelector: string; + innerSelector: string; +} + +export function splitCompositeSelector(selector: string): CompositeSelectorParts | null { + if (typeof selector !== 'string') return null; + + const parts = selector + .split(COMPOSITE_SELECTOR_SEPARATOR) + .map((s) => s.trim()) + .filter(Boolean); + + if (parts.length < 2) return null; + + return { + frameSelector: parts[0], + innerSelector: parts.slice(1).join(` ${COMPOSITE_SELECTOR_SEPARATOR} `), + }; +} + +export function isCompositeSelector(selector: string): boolean { + return splitCompositeSelector(selector) !== null; +} + +export function composeCompositeSelector(frameSelector: string, innerSelector: string): string { + return `${String(frameSelector).trim()} ${COMPOSITE_SELECTOR_SEPARATOR} ${String(innerSelector).trim()}`.trim(); +} + +// ================================ +// Strategy Pattern Types +// ================================ + +export interface NormalizedSelectorGenerationOptions { + maxCandidates: number; + includeText: boolean; + includeAria: boolean; + includeCssUnique: boolean; + includeCssPath: boolean; + testIdAttributes: ReadonlyArray; + textMaxLength: number; + textTags: ReadonlyArray; +} + +export interface SelectorGenerationOptions { + maxCandidates?: number; + includeText?: boolean; + includeAria?: boolean; + includeCssUnique?: boolean; + includeCssPath?: boolean; + testIdAttributes?: ReadonlyArray; + textMaxLength?: number; + textTags?: ReadonlyArray; +} + +export interface SelectorStrategyHelpers { + cssEscape: (value: string) => string; + isUnique: (selector: string) => boolean; + safeQueryAll: (selector: string) => ReadonlyArray; +} + +export interface SelectorStrategyContext { + element: Element; + root: ParentNode; + options: NormalizedSelectorGenerationOptions; + helpers: SelectorStrategyHelpers; +} + +export interface SelectorStrategy { + /** Stable id used for debugging/analytics. */ + id: string; + generate: (ctx: SelectorStrategyContext) => ReadonlyArray; +} diff --git a/app/chrome-extension/tailwind.config.ts b/app/chrome-extension/tailwind.config.ts new file mode 100644 index 00000000..06d35c1a --- /dev/null +++ b/app/chrome-extension/tailwind.config.ts @@ -0,0 +1,24 @@ +import type { Config } from 'tailwindcss'; + +// Tailwind v4 config (TypeScript). The Vite plugin `@tailwindcss/vite` +// will auto-detect and load this file. No `content` field is required in v4. +export default { + theme: { + extend: { + colors: { + brand: { + DEFAULT: '#7C3AED', + dark: '#5B21B6', + light: '#A78BFA', + }, + }, + boxShadow: { + card: '0 6px 20px rgba(0,0,0,0.08)', + }, + borderRadius: { + xl: '12px', + }, + }, + }, + plugins: [], +} satisfies Config; diff --git a/app/chrome-extension/tests/__mocks__/hnswlib-wasm-static.ts b/app/chrome-extension/tests/__mocks__/hnswlib-wasm-static.ts new file mode 100644 index 00000000..0c903e2a --- /dev/null +++ b/app/chrome-extension/tests/__mocks__/hnswlib-wasm-static.ts @@ -0,0 +1,23 @@ +/** + * @fileoverview Mock for hnswlib-wasm-static + * @description Provides a stub for vector database in test environment + */ + +export const HierarchicalNSW = class MockHierarchicalNSW { + constructor() {} + initIndex() {} + addPoint() {} + searchKnn() { + return { neighbors: [], distances: [] }; + } + getCurrentCount() { + return 0; + } + resizeIndex() {} + getPoint() { + return []; + } + markDelete() {} +}; + +export default { HierarchicalNSW }; diff --git a/app/chrome-extension/tests/record-replay-v3/command-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/command-trigger.test.ts new file mode 100644 index 00000000..1ceb018b --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/command-trigger.test.ts @@ -0,0 +1,330 @@ +/** + * @fileoverview Command Trigger Handler 测试 (P4-04) + * @description + * Tests for: + * - Command event handling + * - Listener lifecycle + * - CommandKey mapping + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createCommandTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/command-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface CommandsMock { + onCommand: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emitCommand: (command: string, tab?: { id?: number; url?: string }) => void; +} + +function createCommandsMock(): CommandsMock { + const listeners = new Set<(command: string, tab?: { id?: number; url?: string }) => void>(); + + const onCommand = { + addListener: vi.fn((cb: (command: string, tab?: { id?: number; url?: string }) => void) => { + listeners.add(cb); + }), + removeListener: vi.fn((cb: (command: string, tab?: { id?: number; url?: string }) => void) => { + listeners.delete(cb); + }), + }; + + return { + onCommand, + emitCommand: (command, tab) => { + for (const cb of listeners) cb(command, tab); + }, + }; +} + +// ==================== Command Trigger Tests ==================== + +describe('V3 CommandTriggerHandler', () => { + let commandsMock: CommandsMock; + + beforeEach(() => { + commandsMock = createCommandsMock(); + (globalThis.chrome as unknown as { commands: unknown }).commands = { + onCommand: commandsMock.onCommand, + }; + }); + + describe('Command handling', () => { + it('fires on matching command', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'run-flow-1', + }; + + await handler.install(trigger); + + commandsMock.emitCommand('run-flow-1', { id: 123, url: 'https://example.com' }); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: 123, + sourceUrl: 'https://example.com', + }); + }); + + it('ignores non-matching command', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'run-flow-1', + }; + + await handler.install(trigger); + + commandsMock.emitCommand('run-flow-2'); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('handles command without tab info', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'run-flow-1', + }; + + await handler.install(trigger); + + commandsMock.emitCommand('run-flow-1'); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: undefined, + sourceUrl: undefined, + }); + }); + }); + + describe('Multiple triggers', () => { + it('handles multiple command triggers', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'cmd-1', + }; + + const t2: TriggerSpecByKind<'command'> = { + id: 't2' as never, + kind: 'command', + enabled: true, + flowId: 'flow-2' as never, + commandKey: 'cmd-2', + }; + + await handler.install(t1); + await handler.install(t2); + + commandsMock.emitCommand('cmd-1'); + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', expect.anything()); + + commandsMock.emitCommand('cmd-2'); + expect(fireCallback.onFire).toHaveBeenCalledWith('t2', expect.anything()); + }); + + it('overwrites when same commandKey used', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const warnFn = vi.fn(); + const handler = createCommandTriggerHandlerFactory({ + logger: { ...createSilentLogger(), warn: warnFn }, + })(fireCallback); + + const t1: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'same-cmd', + }; + + const t2: TriggerSpecByKind<'command'> = { + id: 't2' as never, + kind: 'command', + enabled: true, + flowId: 'flow-2' as never, + commandKey: 'same-cmd', + }; + + await handler.install(t1); + await handler.install(t2); + + // Should warn about overwriting + expect(warnFn).toHaveBeenCalled(); + + // Only t2 should be called + commandsMock.emitCommand('same-cmd'); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + expect(fireCallback.onFire).toHaveBeenCalledWith('t2', expect.anything()); + + // t1 should be removed from installed + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); + + describe('Listener lifecycle', () => { + it('registers listener on first install', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'cmd-1', + }; + + await handler.install(trigger); + + expect(commandsMock.onCommand.addListener).toHaveBeenCalledTimes(1); + }); + + it('removes listener when all triggers uninstalled', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'cmd-1', + }; + + const t2: TriggerSpecByKind<'command'> = { + id: 't2' as never, + kind: 'command', + enabled: true, + flowId: 'flow-2' as never, + commandKey: 'cmd-2', + }; + + await handler.install(t1); + await handler.install(t2); + + await handler.uninstall('t1'); + expect(commandsMock.onCommand.removeListener).not.toHaveBeenCalled(); + + await handler.uninstall('t2'); + expect(commandsMock.onCommand.removeListener).toHaveBeenCalledTimes(1); + }); + + it('removes listener on uninstallAll', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'cmd-1', + }; + + await handler.install(trigger); + await handler.uninstallAll(); + + expect(commandsMock.onCommand.removeListener).toHaveBeenCalledTimes(1); + }); + }); + + describe('getInstalledIds', () => { + it('returns installed trigger IDs', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCommandTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'command'> = { + id: 't1' as never, + kind: 'command', + enabled: true, + flowId: 'flow-1' as never, + commandKey: 'cmd-1', + }; + + const t2: TriggerSpecByKind<'command'> = { + id: 't2' as never, + kind: 'command', + enabled: true, + flowId: 'flow-2' as never, + commandKey: 'cmd-2', + }; + + await handler.install(t1); + await handler.install(t2); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + + await handler.uninstall('t1'); + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/context-menu-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/context-menu-trigger.test.ts new file mode 100644 index 00000000..07507076 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/context-menu-trigger.test.ts @@ -0,0 +1,410 @@ +/** + * @fileoverview ContextMenu Trigger Handler 测试 (P4-05) + * @description + * Tests for: + * - Menu item creation and removal + * - Click event handling + * - Listener lifecycle + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createContextMenuTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/context-menu-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface ContextMenusMock { + create: ReturnType; + remove: ReturnType; + onClicked: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emitClicked: ( + info: { menuItemId: string | number; pageUrl?: string }, + tab?: { id?: number; url?: string }, + ) => void; + createdItems: Map; +} + +function createContextMenusMock(): ContextMenusMock { + const listeners = new Set< + ( + info: { menuItemId: string | number; pageUrl?: string }, + tab?: { id?: number; url?: string }, + ) => void + >(); + const createdItems = new Map(); + + const create = vi.fn( + (props: { id: string; title: string; contexts: string[] }, callback?: () => void) => { + createdItems.set(props.id, { title: props.title, contexts: props.contexts }); + if (callback) { + // Simulate async callback + setTimeout(() => callback(), 0); + } + return props.id; + }, + ); + + const remove = vi.fn((menuItemId: string, callback?: () => void) => { + createdItems.delete(menuItemId); + if (callback) { + setTimeout(() => callback(), 0); + } + }); + + const onClicked = { + addListener: vi.fn( + ( + cb: ( + info: { menuItemId: string | number; pageUrl?: string }, + tab?: { id?: number; url?: string }, + ) => void, + ) => { + listeners.add(cb); + }, + ), + removeListener: vi.fn( + ( + cb: ( + info: { menuItemId: string | number; pageUrl?: string }, + tab?: { id?: number; url?: string }, + ) => void, + ) => { + listeners.delete(cb); + }, + ), + }; + + return { + create, + remove, + onClicked, + emitClicked: (info, tab) => { + for (const cb of listeners) cb(info, tab); + }, + createdItems, + }; +} + +function setupContextMenusMock(): ContextMenusMock { + const mock = createContextMenusMock(); + (globalThis.chrome as unknown as { contextMenus: unknown }).contextMenus = { + create: mock.create, + remove: mock.remove, + onClicked: mock.onClicked, + }; + // Clear lastError + (globalThis.chrome.runtime as { lastError?: { message: string } }).lastError = undefined; + return mock; +} + +// ==================== ContextMenu Trigger Tests ==================== + +describe('V3 ContextMenuTriggerHandler', () => { + let contextMenusMock: ContextMenusMock; + + beforeEach(() => { + contextMenusMock = setupContextMenusMock(); + }); + + describe('Menu item creation', () => { + it('creates menu item on install', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + contexts: ['page', 'selection'], + }; + + await handler.install(trigger); + + expect(contextMenusMock.create).toHaveBeenCalledWith( + { + id: 'rr_v3_t1', + title: 'Run My Flow', + contexts: ['page', 'selection'], + }, + expect.any(Function), + ); + }); + + it('uses default contexts when not specified', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + }; + + await handler.install(trigger); + + expect(contextMenusMock.create).toHaveBeenCalledWith( + expect.objectContaining({ + contexts: ['page'], + }), + expect.any(Function), + ); + }); + }); + + describe('Click handling', () => { + it('fires on menu item click', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + }; + + await handler.install(trigger); + + contextMenusMock.emitClicked( + { menuItemId: 'rr_v3_t1', pageUrl: 'https://example.com/page' }, + { id: 123, url: 'https://example.com/page' }, + ); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: 123, + sourceUrl: 'https://example.com/page', + }); + }); + + it('ignores click on non-matching menu item', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + }; + + await handler.install(trigger); + + contextMenusMock.emitClicked({ menuItemId: 'other_menu_item' }); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('uses tab url when pageUrl not available', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + }; + + await handler.install(trigger); + + contextMenusMock.emitClicked( + { menuItemId: 'rr_v3_t1' }, + { id: 123, url: 'https://example.com' }, + ); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: 123, + sourceUrl: 'https://example.com', + }); + }); + }); + + describe('Menu item removal', () => { + it('removes menu item on uninstall', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run My Flow', + }; + + await handler.install(trigger); + await handler.uninstall('t1'); + + expect(contextMenusMock.remove).toHaveBeenCalledWith('rr_v3_t1', expect.any(Function)); + }); + + it('removes all menu items on uninstallAll', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Flow 1', + }; + + const t2: TriggerSpecByKind<'contextMenu'> = { + id: 't2' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-2' as never, + title: 'Flow 2', + }; + + await handler.install(t1); + await handler.install(t2); + await handler.uninstallAll(); + + expect(contextMenusMock.remove).toHaveBeenCalledTimes(2); + }); + }); + + describe('Listener lifecycle', () => { + it('registers listener on first install', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Run', + }; + + await handler.install(trigger); + + expect(contextMenusMock.onClicked.addListener).toHaveBeenCalledTimes(1); + }); + + it('removes listener when all triggers uninstalled', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Flow 1', + }; + + const t2: TriggerSpecByKind<'contextMenu'> = { + id: 't2' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-2' as never, + title: 'Flow 2', + }; + + await handler.install(t1); + await handler.install(t2); + + await handler.uninstall('t1'); + expect(contextMenusMock.onClicked.removeListener).not.toHaveBeenCalled(); + + await handler.uninstall('t2'); + expect(contextMenusMock.onClicked.removeListener).toHaveBeenCalledTimes(1); + }); + }); + + describe('getInstalledIds', () => { + it('returns installed trigger IDs', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createContextMenuTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'contextMenu'> = { + id: 't1' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-1' as never, + title: 'Flow 1', + }; + + const t2: TriggerSpecByKind<'contextMenu'> = { + id: 't2' as never, + kind: 'contextMenu', + enabled: true, + flowId: 'flow-2' as never, + title: 'Flow 2', + }; + + await handler.install(t1); + await handler.install(t2); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + + await handler.uninstall('t1'); + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/cron-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/cron-trigger.test.ts new file mode 100644 index 00000000..bba6153e --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/cron-trigger.test.ts @@ -0,0 +1,513 @@ +/** + * @fileoverview Cron Trigger Handler 测试 (P4-07) + * @description + * Tests for: + * - Alarm scheduling on install + * - Firing and rescheduling on alarm + * - Timezone validation + * - Listener lifecycle + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createCronTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/cron-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface AlarmsMock { + create: ReturnType; + clear: ReturnType; + getAll: ReturnType; + onAlarm: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emit: (name: string) => void; + createdAlarms: Map; +} + +function createAlarmsMock(): AlarmsMock { + const listeners = new Set<(alarm: { name: string }) => void>(); + const createdAlarms = new Map(); + + const onAlarm = { + addListener: vi.fn((cb: (alarm: { name: string }) => void) => listeners.add(cb)), + removeListener: vi.fn((cb: (alarm: { name: string }) => void) => listeners.delete(cb)), + }; + + const create = vi.fn((name: string, info: { when?: number }) => { + createdAlarms.set(name, info); + return undefined; + }); + + const clear = vi.fn((name: string) => { + createdAlarms.delete(name); + return true; + }); + + const getAll = vi.fn(async () => + Array.from(createdAlarms.entries()).map(([name, info]) => ({ + name, + scheduledTime: info.when ?? 0, + })), + ); + + return { + create, + clear, + getAll, + onAlarm, + emit: (name) => { + for (const cb of listeners) cb({ name }); + }, + createdAlarms, + }; +} + +// ==================== Cron Trigger Tests ==================== + +describe('V3 CronTriggerHandler', () => { + let alarms: AlarmsMock; + + beforeEach(() => { + alarms = createAlarmsMock(); + (globalThis.chrome as unknown as { alarms: unknown }).alarms = { + create: alarms.create, + clear: alarms.clear, + getAll: alarms.getAll, + onAlarm: alarms.onAlarm, + }; + }); + + describe('Installation and scheduling', () => { + it('schedules alarm on install', async () => { + const nowMs = 1_700_000_000_000; + const now = vi.fn(() => nowMs); + const computeNext = vi.fn(async ({ fromMs }: { fromMs: number }) => fromMs + 60_000); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now, + computeNextFireAtMs: computeNext, + })(fireCallback); + + const trigger: TriggerSpecByKind<'cron'> = { + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', + timezone: 'UTC', + }; + + await handler.install(trigger); + + expect(alarms.onAlarm.addListener).toHaveBeenCalledTimes(1); + expect(alarms.create).toHaveBeenCalledWith('rr_v3_cron_t1', { when: nowMs + 60_000 }); + expect(computeNext).toHaveBeenCalledWith({ + cron: '0 9 * * *', + timezone: 'UTC', + fromMs: nowMs, + }); + }); + + it('passes timezone to computeNextFireAtMs', async () => { + const computeNext = vi.fn(async ({ fromMs }: { fromMs: number }) => fromMs + 60_000); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: computeNext, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', + timezone: 'Asia/Shanghai', + }); + + expect(computeNext).toHaveBeenCalledWith( + expect.objectContaining({ + timezone: 'Asia/Shanghai', + }), + ); + }); + }); + + describe('Alarm firing', () => { + it('fires callback on alarm and reschedules', async () => { + const nowMs = 1_700_000_000_000; + const now = vi.fn(() => nowMs); + const computeNext = vi.fn(async ({ fromMs }: { fromMs: number }) => fromMs + 60_000); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now, + computeNextFireAtMs: computeNext, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', + }); + + alarms.emit('rr_v3_cron_t1'); + await new Promise((r) => setTimeout(r, 0)); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: undefined, + sourceUrl: undefined, + }); + + // Should reschedule + expect(alarms.create).toHaveBeenCalledTimes(2); + }); + + it('ignores unrelated alarms', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + alarms.emit('other_alarm'); + await new Promise((r) => setTimeout(r, 0)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('ignores alarm for uninstalled trigger', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + await handler.uninstall('t1'); + + alarms.emit('rr_v3_cron_t1'); + await new Promise((r) => setTimeout(r, 0)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); + + describe('Uninstallation', () => { + it('clears alarm on uninstall', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + await handler.uninstall('t1'); + + expect(alarms.clear).toHaveBeenCalledWith('rr_v3_cron_t1'); + }); + + it('stops listening when all triggers uninstalled', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + await handler.uninstall('t1'); + + expect(alarms.onAlarm.removeListener).toHaveBeenCalledTimes(1); + }); + + it('uninstallAll clears all cron alarms', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + await handler.install({ + id: 't2' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-2' as never, + cron: '0 * * * *', + }); + + await handler.uninstallAll(); + + expect(alarms.clear).toHaveBeenCalledWith('rr_v3_cron_t1'); + expect(alarms.clear).toHaveBeenCalledWith('rr_v3_cron_t2'); + expect(alarms.onAlarm.removeListener).toHaveBeenCalledTimes(1); + }); + }); + + describe('Timezone computation', () => { + it('computes different next fire times for different timezones', async () => { + // Use default computeNextFireAtMs (built-in parser with timezone support) + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + // Don't override computeNextFireAtMs to test actual implementation + })(fireCallback); + + // Install with UTC timezone + await handler.install({ + id: 'utc' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', // 9:00 AM every day + timezone: 'UTC', + }); + + const utcAlarm = alarms.createdAlarms.get('rr_v3_cron_utc'); + expect(utcAlarm?.when).toBeDefined(); + const utcFireTime = utcAlarm!.when!; + + // Uninstall and reinstall with different timezone + await handler.uninstall('utc'); + + await handler.install({ + id: 'shanghai' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', // 9:00 AM every day (in Asia/Shanghai) + timezone: 'Asia/Shanghai', + }); + + const shanghaiAlarm = alarms.createdAlarms.get('rr_v3_cron_shanghai'); + expect(shanghaiAlarm?.when).toBeDefined(); + const shanghaiFireTime = shanghaiAlarm!.when!; + + // Asia/Shanghai is UTC+8, so 9:00 AM Shanghai = 1:00 AM UTC + // The fire times should differ by 8 hours (28800000 ms) + const diff = Math.abs(utcFireTime - shanghaiFireTime); + + // Allow for some variance due to DST and date boundaries + // The key assertion is that they're NOT equal + expect(utcFireTime).not.toBe(shanghaiFireTime); + // Should be close to 8 hours difference (within 1 day variance for date boundary cases) + expect(diff).toBeLessThanOrEqual(24 * 60 * 60 * 1000); // max 1 day difference + }); + + it('computes correctly at fixed point in time', async () => { + // Fix time to a known point: 2024-01-15 00:00:00 UTC (a Monday) + const fixedNow = Date.UTC(2024, 0, 15, 0, 0, 0); + const now = vi.fn(() => fixedNow); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now, + // Use default computeNextFireAtMs + })(fireCallback); + + // Cron: 0 9 * * * = 9:00 AM every day in UTC + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', + timezone: 'UTC', + }); + + const alarm = alarms.createdAlarms.get('rr_v3_cron_t1'); + expect(alarm?.when).toBeDefined(); + + // Expected: 2024-01-15 09:00:00 UTC + const expected = Date.UTC(2024, 0, 15, 9, 0, 0); + expect(alarm!.when).toBe(expected); + }); + }); + + describe('Validation', () => { + it('rejects invalid timezone', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await expect( + handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * * *', + timezone: 'Invalid/Zone', + }), + ).rejects.toThrow('Invalid timezone'); + }); + + it('rejects empty cron expression', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await expect( + handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: ' ', + }), + ).rejects.toThrow('cron must be a non-empty string'); + }); + + it('rejects invalid cron step (*/0 infinite loop prevention)', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + // Use default computeNextFireAtMs to test built-in parser + })(fireCallback); + + await expect( + handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/0 * * * *', // Invalid: step of 0 + }), + ).rejects.toThrow('step must be >= 1'); + }); + + it('rejects negative step values', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + })(fireCallback); + + await expect( + handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/-5 * * * *', // Invalid: negative step + }), + ).rejects.toThrow('step must be >= 1'); + }); + + it('rejects cron with wrong number of fields', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + })(fireCallback); + + await expect( + handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '0 9 * *', // Only 4 fields + }), + ).rejects.toThrow('expected 5 fields'); + }); + }); + + describe('getInstalledIds', () => { + it('returns installed trigger IDs', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createCronTriggerHandlerFactory({ + logger: createSilentLogger(), + now: () => 0, + computeNextFireAtMs: () => 60_000, + })(fireCallback); + + await handler.install({ + id: 't1' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-1' as never, + cron: '*/5 * * * *', + }); + + await handler.install({ + id: 't2' as never, + kind: 'cron', + enabled: true, + flowId: 'flow-2' as never, + cron: '0 * * * *', + }); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + + await handler.uninstall('t1'); + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/debugger.contract.test.ts b/app/chrome-extension/tests/record-replay-v3/debugger.contract.test.ts new file mode 100644 index 00000000..bbd79a9e --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/debugger.contract.test.ts @@ -0,0 +1,559 @@ +/** + * @fileoverview Record-Replay V3 Debugger Contracts + * @description Verifies DebugController behavior via command handling + state changes + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; +import { z } from 'zod'; + +import type { + EdgeV3, + FlowV3, + NodeV3, + RunEvent, + RunRecordV3, + NodeDefinition, + NodeExecutionResult, + DebuggerState, +} from '@/entrypoints/background/record-replay-v3'; + +import { + EDGE_LABELS, + FLOW_SCHEMA_VERSION, + RUN_SCHEMA_VERSION, + InMemoryEventsBus, + PluginRegistry, + RR_ERROR_CODES, + createNotImplementedStoragePort, + createRRError, + createRunRunnerFactory, + resetBreakpointRegistry, + DebugController, + createRunnerRegistry, +} from '@/entrypoints/background/record-replay-v3'; + +import type { + RunId, + PersistentVarRecord, + PersistentVarsStore, + RunsStore, + FlowsStore, +} from '@/entrypoints/background/record-replay-v3'; + +// ==================== Test Helpers ==================== + +type TestNodeConfig = { + action: 'succeed' | 'fail' | 'slow'; + delayMs?: number; +}; + +function createTestNodeDefinition( + callsByNodeId: Map, + resolvers: Map void>, +): NodeDefinition<'test', TestNodeConfig> { + return { + kind: 'test', + schema: z + .object({ + action: z.enum(['succeed', 'fail', 'slow']), + delayMs: z.number().optional(), + }) + .passthrough(), + execute: async (ctx, node): Promise => { + const prev = callsByNodeId.get(ctx.nodeId) ?? 0; + callsByNodeId.set(ctx.nodeId, prev + 1); + + const cfg = node.config as unknown as TestNodeConfig; + + if (cfg.action === 'slow') { + // Wait for external resolution + await new Promise((resolve) => { + resolvers.set(ctx.nodeId, resolve); + }); + } + + if (cfg.action === 'fail') { + return { + status: 'failed', + error: createRRError(RR_ERROR_CODES.TOOL_ERROR, `test failure (${ctx.nodeId})`), + }; + } + + return { status: 'succeeded' }; + }, + }; +} + +function createFlow(entryNodeId: string, nodes: NodeV3[], edges: EdgeV3[]): FlowV3 { + const iso = new Date(0).toISOString(); + return { + schemaVersion: FLOW_SCHEMA_VERSION, + id: 'flow-debug', + name: 'debug contract flow', + createdAt: iso, + updatedAt: iso, + entryNodeId, + nodes, + edges, + }; +} + +function createInMemoryRunsStore(): { store: RunsStore; byId: Map } { + const byId = new Map(); + const store: RunsStore = { + list: async () => Array.from(byId.values()), + get: async (id) => byId.get(id) ?? null, + save: async (record) => { + byId.set(record.id, record); + }, + patch: async (id, patch) => { + const existing = byId.get(id); + if (!existing) { + throw createRRError(RR_ERROR_CODES.INTERNAL, `Run "${id}" not found`); + } + byId.set(id, { + ...existing, + ...patch, + id: existing.id, + schemaVersion: existing.schemaVersion, + updatedAt: Date.now(), + }); + }, + }; + return { store, byId }; +} + +function createInMemoryFlowsStore(): { store: FlowsStore; byId: Map } { + const byId = new Map(); + const store: FlowsStore = { + list: async () => Array.from(byId.values()), + get: async (id) => byId.get(id) ?? null, + save: async (flow) => { + byId.set(flow.id, flow); + }, + delete: async (id) => { + byId.delete(id); + }, + }; + return { store, byId }; +} + +function createInMemoryPersistentVarsStore(): PersistentVarsStore { + const byKey = new Map(); + return { + get: async (key) => byKey.get(key as string) as PersistentVarRecord | undefined, + set: async (key, value) => { + const prev = byKey.get(key as string); + const record: PersistentVarRecord = { + key, + value, + updatedAt: Date.now(), + version: (prev?.version ?? 0) + 1, + }; + byKey.set(key as string, record); + return record; + }, + delete: async (key) => { + byKey.delete(key as string); + }, + list: async (prefix) => { + const all = Array.from(byKey.values()); + if (!prefix) return all; + return all.filter((r) => r.key.startsWith(prefix)); + }, + }; +} + +// ==================== Tests ==================== + +describe('V3 Debugger contracts', () => { + beforeEach(() => { + resetBreakpointRegistry(); + }); + + afterEach(() => { + vi.useRealTimers(); + vi.restoreAllMocks(); + }); + + describe('attach/detach', () => { + it('attach returns state with attached status', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + const { store: flows, byId: flowsById } = createInMemoryFlowsStore(); + + const flow = createFlow('A', [{ id: 'A', kind: 'test', config: { action: 'succeed' } }], []); + flowsById.set(flow.id, flow); + + // Create a run record + const runId = 'run-attach'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: flow.id, + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + storage.flows = flows; + storage.persistentVars = createInMemoryPersistentVarsStore(); + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + const response = await controller.handle({ type: 'debug.attach', runId }); + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.status).toBe('attached'); + expect(response.state.runId).toBe(runId); + } + + controller.stop(); + }); + + it('detach returns state with detached status', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-detach'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + // First attach + await controller.handle({ type: 'debug.attach', runId }); + + // Then detach + const response = await controller.handle({ type: 'debug.detach', runId }); + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.status).toBe('detached'); + } + + controller.stop(); + }); + }); + + describe('breakpoints', () => { + it('setBreakpoints updates breakpoint list', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-bp'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + await controller.handle({ type: 'debug.attach', runId }); + + const response = await controller.handle({ + type: 'debug.setBreakpoints', + runId, + nodeIds: ['A', 'B', 'C'], + }); + + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.breakpoints.map((bp) => bp.nodeId)).toEqual(['A', 'B', 'C']); + } + + controller.stop(); + }); + + it('addBreakpoint adds to existing list', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-bp-add'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + await controller.handle({ type: 'debug.setBreakpoints', runId, nodeIds: ['A'] }); + const response = await controller.handle({ type: 'debug.addBreakpoint', runId, nodeId: 'B' }); + + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.breakpoints.map((bp) => bp.nodeId)).toContain('A'); + expect(response.state.breakpoints.map((bp) => bp.nodeId)).toContain('B'); + } + + controller.stop(); + }); + + it('removeBreakpoint removes from list', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-bp-remove'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + await controller.handle({ type: 'debug.setBreakpoints', runId, nodeIds: ['A', 'B'] }); + const response = await controller.handle({ + type: 'debug.removeBreakpoint', + runId, + nodeId: 'A', + }); + + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.breakpoints.map((bp) => bp.nodeId)).toEqual(['B']); + } + + controller.stop(); + }); + }); + + describe('getState', () => { + it('returns current debug state', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-getstate'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'paused', + createdAt: Date.now(), + updatedAt: Date.now(), + currentNodeId: 'A', + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + const response = await controller.handle({ type: 'debug.getState', runId }); + + expect(response.ok).toBe(true); + if (response.ok && response.state) { + expect(response.state.runId).toBe(runId); + expect(response.state.execution).toBe('paused'); + expect(response.state.currentNodeId).toBe('A'); + } + + controller.stop(); + }); + }); + + describe('variables', () => { + it('getVar returns variable value from active runner', async () => { + const calls = new Map(); + const resolvers = new Map void>(); + const plugins = new PluginRegistry(); + plugins.registerNode(createTestNodeDefinition(calls, resolvers)); + + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + const { store: flows, byId: flowsById } = createInMemoryFlowsStore(); + + const flow = createFlow('A', [{ id: 'A', kind: 'test', config: { action: 'slow' } }], []); + flowsById.set(flow.id, flow); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + storage.flows = flows; + storage.persistentVars = createInMemoryPersistentVarsStore(); + + const runners = createRunnerRegistry(); + const factory = createRunRunnerFactory({ storage, events: bus, plugins }); + + const runId = 'run-getvar'; + const runner = factory.create(runId, { flow, tabId: 1, args: { myVar: 'hello' } }); + runners.register(runId, runner); + + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + // Start the runner (it will wait on node A) + const startPromise = runner.start(); + + // Wait a bit for the runner to start + await new Promise((r) => setTimeout(r, 10)); + + // Get variable + const response = await controller.handle({ type: 'debug.getVar', runId, name: 'myVar' }); + + expect(response.ok).toBe(true); + if (response.ok) { + expect(response.value).toBe('hello'); + } + + // Clean up - resolve the slow node + resolvers.get('A')?.(); + await startPromise; + + controller.stop(); + }); + + it('setVar updates variable in active runner', async () => { + const calls = new Map(); + const resolvers = new Map void>(); + const plugins = new PluginRegistry(); + plugins.registerNode(createTestNodeDefinition(calls, resolvers)); + + const bus = new InMemoryEventsBus(); + const { store: runs } = createInMemoryRunsStore(); + const { store: flows, byId: flowsById } = createInMemoryFlowsStore(); + + const flow = createFlow('A', [{ id: 'A', kind: 'test', config: { action: 'slow' } }], []); + flowsById.set(flow.id, flow); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + storage.flows = flows; + storage.persistentVars = createInMemoryPersistentVarsStore(); + + const runners = createRunnerRegistry(); + const factory = createRunRunnerFactory({ storage, events: bus, plugins }); + + const runId = 'run-setvar'; + const runner = factory.create(runId, { flow, tabId: 1 }); + runners.register(runId, runner); + + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + // Start the runner + const startPromise = runner.start(); + await new Promise((r) => setTimeout(r, 10)); + + // Set variable + const setResponse = await controller.handle({ + type: 'debug.setVar', + runId, + name: 'newVar', + value: 42, + }); + expect(setResponse.ok).toBe(true); + + // Get variable back + const getResponse = await controller.handle({ type: 'debug.getVar', runId, name: 'newVar' }); + expect(getResponse.ok).toBe(true); + if (getResponse.ok) { + expect(getResponse.value).toBe(42); + } + + // Clean up + resolvers.get('A')?.(); + await startPromise; + + controller.stop(); + }); + }); + + describe('state subscription', () => { + it('subscribe receives state changes', async () => { + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const runId = 'run-subscribe'; + runsById.set(runId, { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + }); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + + const runners = createRunnerRegistry(); + const controller = new DebugController({ storage, events: bus, runners }); + controller.start(); + + const receivedStates: DebuggerState[] = []; + controller.subscribe((state) => receivedStates.push(state), { runId }); + + // Attach to trigger state notification + await controller.handle({ type: 'debug.attach', runId }); + + expect(receivedStates.length).toBeGreaterThan(0); + expect(receivedStates[0].runId).toBe(runId); + expect(receivedStates[0].status).toBe('attached'); + + controller.stop(); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/dom-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/dom-trigger.test.ts new file mode 100644 index 00000000..0a50c618 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/dom-trigger.test.ts @@ -0,0 +1,504 @@ +/** + * @fileoverview DOM Trigger Handler 测试 (P4-06) + * @description + * Tests for: + * - Syncing triggers to tabs (inject + set_dom_triggers) + * - Handling dom_trigger_fired messages + * - Re-syncing on navigation completion + * - Listener lifecycle + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import { CONTENT_MESSAGE_TYPES, TOOL_MESSAGE_TYPES } from '@/common/message-types'; +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createDomTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/dom-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface RuntimeOnMessageMock { + onMessage: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emit: (message: unknown, sender?: Partial) => void; +} + +function createRuntimeOnMessageMock(): RuntimeOnMessageMock { + const listeners = new Set< + ( + message: unknown, + sender: chrome.runtime.MessageSender, + sendResponse: (response?: unknown) => void, + ) => boolean | void + >(); + + const onMessage = { + addListener: vi.fn((cb) => { + listeners.add(cb); + }), + removeListener: vi.fn((cb) => { + listeners.delete(cb); + }), + }; + + return { + onMessage, + emit: (message, sender) => { + for (const cb of listeners) { + cb(message, sender as chrome.runtime.MessageSender, vi.fn()); + } + }, + }; +} + +interface WebNavigationMock { + onCompleted: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emitCompleted: (details: { tabId: number; frameId: number; url: string }) => void; +} + +function createWebNavigationMock(): WebNavigationMock { + const listeners = new Set<(details: unknown) => void>(); + + const onCompleted = { + addListener: vi.fn((cb: (details: unknown) => void) => { + listeners.add(cb); + }), + removeListener: vi.fn((cb: (details: unknown) => void) => { + listeners.delete(cb); + }), + }; + + return { + onCompleted, + emitCompleted: (details) => { + for (const cb of listeners) cb(details); + }, + }; +} + +// ==================== DOM Trigger Tests ==================== + +describe('V3 DomTriggerHandler', () => { + let runtimeMock: RuntimeOnMessageMock; + let webNav: WebNavigationMock; + + beforeEach(() => { + runtimeMock = createRuntimeOnMessageMock(); + webNav = createWebNavigationMock(); + + (globalThis.chrome as unknown as { runtime: unknown }).runtime = { + ...(globalThis.chrome as unknown as { runtime: object }).runtime, + onMessage: runtimeMock.onMessage, + }; + + (globalThis.chrome as unknown as { webNavigation: unknown }).webNavigation = { + onCompleted: webNav.onCompleted, + }; + + (globalThis.chrome as unknown as { scripting: unknown }).scripting = { + executeScript: vi.fn().mockResolvedValue([]), + }; + + (globalThis.chrome as unknown as { tabs: unknown }).tabs = { + query: vi.fn().mockResolvedValue([]), + sendMessage: vi.fn().mockResolvedValue({}), + }; + }); + + describe('Installation and sync', () => { + it('injects dom-observer and pushes triggers on install', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([ + { id: 1, url: 'https://example.com' }, + { id: 2, url: 'chrome://extensions' }, // Should be skipped + ]); + + (globalThis.chrome.tabs.sendMessage as ReturnType).mockImplementation( + async (_tabId: number, msg: { action?: string; triggers?: unknown[] }) => { + if (msg.action === CONTENT_MESSAGE_TYPES.DOM_OBSERVER_PING) { + throw new Error('no observer'); // Simulate not injected + } + if (msg.action === TOOL_MESSAGE_TYPES.SET_DOM_TRIGGERS) { + return { success: true, count: Array.isArray(msg.triggers) ? msg.triggers.length : 0 }; + } + return undefined; + }, + ); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'dom'> = { + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#submit-button', + }; + + await handler.install(trigger); + + // Listeners should be registered + expect(runtimeMock.onMessage.addListener).toHaveBeenCalledTimes(1); + expect(webNav.onCompleted.addListener).toHaveBeenCalledTimes(1); + + // Should inject script to injectable tab only + expect(globalThis.chrome.scripting.executeScript).toHaveBeenCalledWith( + expect.objectContaining({ + target: { tabId: 1 }, + files: ['inject-scripts/dom-observer.js'], + world: 'ISOLATED', + }), + ); + + // Should not inject to chrome:// URL + const executeScriptCalls = ( + globalThis.chrome.scripting.executeScript as ReturnType + ).mock.calls; + expect(executeScriptCalls.every((c) => c[0].target.tabId !== 2)).toBe(true); + + // Should send triggers + const sendCalls = (globalThis.chrome.tabs.sendMessage as ReturnType).mock.calls; + const setCalls = sendCalls.filter( + (c) => c[1]?.action === TOOL_MESSAGE_TYPES.SET_DOM_TRIGGERS, + ); + + expect(setCalls.length).toBeGreaterThan(0); + expect(setCalls[0][1]).toEqual({ + action: TOOL_MESSAGE_TYPES.SET_DOM_TRIGGERS, + triggers: [ + { + id: 't1', + selector: '#submit-button', + appear: true, + once: true, + debounceMs: 800, + }, + ], + }); + }); + + it('uses custom debounceMs when specified', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([ + { id: 1, url: 'https://example.com' }, + ]); + + (globalThis.chrome.tabs.sendMessage as ReturnType).mockImplementation( + async (_tabId: number, msg: { action?: string }) => { + if (msg.action === CONTENT_MESSAGE_TYPES.DOM_OBSERVER_PING) { + return { status: 'pong' }; // Already injected + } + return { success: true }; + }, + ); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'dom'> = { + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#btn', + debounceMs: 2000, + once: false, + appear: false, + }; + + await handler.install(trigger); + + const sendCalls = (globalThis.chrome.tabs.sendMessage as ReturnType).mock.calls; + const setCalls = sendCalls.filter( + (c) => c[1]?.action === TOOL_MESSAGE_TYPES.SET_DOM_TRIGGERS, + ); + + expect(setCalls[0][1].triggers[0]).toMatchObject({ + debounceMs: 2000, + once: false, + appear: false, + }); + }); + }); + + describe('Message handling', () => { + it('fires when receiving dom_trigger_fired for installed trigger', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'dom'> = { + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }; + + await handler.install(trigger); + + runtimeMock.emit( + { + action: TOOL_MESSAGE_TYPES.DOM_TRIGGER_FIRED, + triggerId: 't1', + url: 'https://example.com/page', + }, + { tab: { id: 123, url: 'https://example.com/page' } as chrome.tabs.Tab }, + ); + + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: 123, + sourceUrl: 'https://example.com/page', + }); + }); + + it('ignores dom_trigger_fired for unknown trigger', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'dom'> = { + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }; + + await handler.install(trigger); + + runtimeMock.emit( + { + action: TOOL_MESSAGE_TYPES.DOM_TRIGGER_FIRED, + triggerId: 'unknown', + url: 'https://example.com/page', + }, + { tab: { id: 123 } as chrome.tabs.Tab }, + ); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('ignores non-dom_trigger_fired messages', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + + runtimeMock.emit({ action: 'some_other_action', data: 'test' }, {}); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); + + describe('Navigation handling', () => { + it('re-syncs on main-frame navigation completion', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + (globalThis.chrome.tabs.sendMessage as ReturnType).mockImplementation( + async (_tabId: number, msg: { action?: string }) => { + if (msg.action === CONTENT_MESSAGE_TYPES.DOM_OBSERVER_PING) { + throw new Error('no observer'); + } + return { ok: true }; + }, + ); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + + // Clear previous calls + (globalThis.chrome.scripting.executeScript as ReturnType).mockClear(); + + // Emit navigation completed + webNav.emitCompleted({ tabId: 5, frameId: 0, url: 'https://example.com' }); + await new Promise((r) => setTimeout(r, 0)); + + expect(globalThis.chrome.scripting.executeScript).toHaveBeenCalledWith( + expect.objectContaining({ + target: { tabId: 5 }, + files: ['inject-scripts/dom-observer.js'], + world: 'ISOLATED', + }), + ); + }); + + it('ignores subframe navigation', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + + (globalThis.chrome.scripting.executeScript as ReturnType).mockClear(); + + // Emit subframe navigation + webNav.emitCompleted({ tabId: 5, frameId: 1, url: 'https://example.com' }); + await new Promise((r) => setTimeout(r, 0)); + + expect(globalThis.chrome.scripting.executeScript).not.toHaveBeenCalled(); + }); + + it('ignores non-injectable URLs on navigation', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + + (globalThis.chrome.scripting.executeScript as ReturnType).mockClear(); + + // Emit navigation to chrome:// URL + webNav.emitCompleted({ tabId: 5, frameId: 0, url: 'chrome://extensions' }); + await new Promise((r) => setTimeout(r, 0)); + + expect(globalThis.chrome.scripting.executeScript).not.toHaveBeenCalled(); + }); + }); + + describe('Lifecycle', () => { + it('stops listening when last trigger uninstalled', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + + await handler.uninstall('t1'); + + expect(runtimeMock.onMessage.removeListener).toHaveBeenCalledTimes(1); + expect(webNav.onCompleted.removeListener).toHaveBeenCalledTimes(1); + expect(handler.getInstalledIds()).toEqual([]); + }); + + it('uninstallAll clears all and stops listening', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + await handler.install({ + id: 't2' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-2' as never, + selector: '#y', + }); + + await handler.uninstallAll(); + + expect(runtimeMock.onMessage.removeListener).toHaveBeenCalledTimes(1); + expect(webNav.onCompleted.removeListener).toHaveBeenCalledTimes(1); + expect(handler.getInstalledIds()).toEqual([]); + }); + }); + + describe('getInstalledIds', () => { + it('returns installed trigger IDs', async () => { + (globalThis.chrome.tabs.query as ReturnType).mockResolvedValue([]); + + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createDomTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-1' as never, + selector: '#x', + }); + await handler.install({ + id: 't2' as never, + kind: 'dom', + enabled: true, + flowId: 'flow-2' as never, + selector: '#y', + }); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + + await handler.uninstall('t1'); + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/e2e.integration.test.ts b/app/chrome-extension/tests/record-replay-v3/e2e.integration.test.ts new file mode 100644 index 00000000..b4bb4ce9 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/e2e.integration.test.ts @@ -0,0 +1,479 @@ +/** + * @fileoverview Record-Replay V3 service-level E2E 集成测试 + * @description + * 验证完整的 V3 流程：RPC → enqueue → schedule → run → complete + * + * 测试使用： + * - 真实 IndexedDB 存储（fake-indexeddb） + * - service-level RPC（直接调用内部 handler，避免 Port mock） + */ + +import { afterEach, beforeEach, describe, expect, it } from 'vitest'; + +import type { FlowV3, RunEvent, RunRecordV3 } from '@/entrypoints/background/record-replay-v3'; +import { + FLOW_SCHEMA_VERSION, + RUN_SCHEMA_VERSION, + closeRrV3Db, + deleteRrV3Db, + resetBreakpointRegistry, + recoverFromCrash, +} from '@/entrypoints/background/record-replay-v3'; + +import { createV3E2EHarness, type V3E2EHarness, type RpcClient } from './v3-e2e-harness'; + +// ==================== Test Fixtures ==================== + +/** + * 创建测试用 Flow + */ +function createTestFlow( + id: string, + nodeConfig: { action: 'succeed' | 'fail' } = { action: 'succeed' }, +): FlowV3 { + const iso = new Date(0).toISOString(); + return { + schemaVersion: FLOW_SCHEMA_VERSION, + id, + name: `E2E Flow ${id}`, + createdAt: iso, + updatedAt: iso, + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: nodeConfig }], + edges: [], + }; +} + +/** + * 创建测试用 RunRecord + */ +function createRunRecord( + runId: string, + flowId: string, + status: RunRecordV3['status'], +): RunRecordV3 { + const t0 = Date.now(); + return { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId, + status, + createdAt: t0, + updatedAt: t0, + startedAt: status === 'running' ? t0 : undefined, + attempt: 0, + maxAttempts: 1, + nextSeq: 0, + }; +} + +/** + * 提取事件类型列表 + */ +function eventTypes(events: RunEvent[], runId: string): string[] { + return events.filter((e) => e.runId === runId).map((e) => e.type); +} + +// ==================== E2E Tests ==================== + +describe('V3 service-level E2E', () => { + let h: V3E2EHarness; + let client: RpcClient; + + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + resetBreakpointRegistry(); + + h = createV3E2EHarness(); + client = h.createClient(); + }); + + afterEach(async () => { + await h.dispose(); + }); + + describe('Happy path', () => { + it('enqueueRun → schedule → runner → succeeded', async () => { + // 准备 Flow + const flow = createTestFlow('flow-happy'); + await h.storage.flows.save(flow); + + // Enqueue run + const result = await client.call<{ runId: string; position: number }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + expect(result.runId).toBeDefined(); + expect(result.position).toBeGreaterThanOrEqual(1); + + // 等待完成 + const run = await h.waitForTerminal(result.runId); + expect(run.status).toBe('succeeded'); + + // 等待队列项被移除 + await h.waitForQueueItemGone(result.runId); + + // 验证事件序列 + const events = await h.listEvents(result.runId); + const types = eventTypes(events, result.runId); + + expect(types).toContain('run.queued'); + expect(types).toContain('run.started'); + expect(types).toContain('node.queued'); + expect(types).toContain('node.started'); + expect(types).toContain('node.succeeded'); + expect(types).toContain('run.succeeded'); + + // 验证事件顺序 + expect(types.indexOf('run.queued')).toBeLessThan(types.indexOf('run.started')); + expect(types.indexOf('run.started')).toBeLessThan(types.indexOf('run.succeeded')); + }); + + it('failed node leads to run.failed', async () => { + const flow = createTestFlow('flow-fail', { action: 'fail' }); + await h.storage.flows.save(flow); + + const result = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + + const run = await h.waitForTerminal(result.runId); + expect(run.status).toBe('failed'); + expect(run.error).toBeDefined(); + + await h.waitForQueueItemGone(result.runId); + + const events = await h.listEvents(result.runId); + const types = eventTypes(events, result.runId); + + expect(types).toContain('run.failed'); + expect(types).toContain('node.failed'); + }); + }); + + describe('Event streaming', () => { + it('subscribe → receive rr_v3.event messages', async () => { + const flow = createTestFlow('flow-stream'); + await h.storage.flows.save(flow); + + // 订阅所有 Run + await client.call('rr_v3.subscribe'); + + // 入队 + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + + await h.waitForTerminal(runId); + await h.waitForQueueItemGone(runId); + + // 验证流式推送的事件 + const streamed = client.getStreamedEvents().filter((e) => e.runId === runId); + const streamedTypes = streamed.map((e) => e.type); + + expect(streamedTypes).toContain('run.queued'); + expect(streamedTypes).toContain('run.started'); + expect(streamedTypes).toContain('run.succeeded'); + }); + + it('subscribe with runId filter only receives events for that run', async () => { + const flow1 = createTestFlow('flow-1'); + const flow2 = createTestFlow('flow-2'); + await h.storage.flows.save(flow1); + await h.storage.flows.save(flow2); + + // 先入队 run1 + const { runId: runId1 } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow1.id, + }); + await h.waitForTerminal(runId1); + + // 订阅只接收 runId1 的事件（但 runId1 已完成） + await client.call('rr_v3.subscribe', { runId: runId1 }); + client.clearMessages(); + + // 入队 run2 + const { runId: runId2 } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow2.id, + }); + await h.waitForTerminal(runId2); + + // 应该不收到 run2 的事件 + const streamedForRun2 = client.getStreamedEvents().filter((e) => e.runId === runId2); + expect(streamedForRun2).toHaveLength(0); + }); + }); + + describe('Control plane', () => { + it('pause/resume: pauseRun marks queue paused, resumeRun completes succeeded', async () => { + const flow = createTestFlow('flow-control'); + await h.storage.flows.save(flow); + + // 入队时启用 pauseOnStart + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + debug: { pauseOnStart: true }, + }); + + // 等待 run.paused 事件 + await h.waitForEvent(runId, (e) => e.type === 'run.paused'); + + // 暂停 queue item + await client.call('rr_v3.pauseRun', { runId }); + const pausedItem = await h.storage.queue.get(runId); + expect(pausedItem?.status).toBe('paused'); + + // 恢复 + await client.call('rr_v3.resumeRun', { runId }); + + // 等待完成 + const run = await h.waitForTerminal(runId); + expect(run.status).toBe('succeeded'); + await h.waitForQueueItemGone(runId); + }); + + it('cancel: cancelRun transitions run to canceled', async () => { + const flow = createTestFlow('flow-cancel'); + await h.storage.flows.save(flow); + + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + debug: { pauseOnStart: true }, + }); + + await h.waitForEvent(runId, (e) => e.type === 'run.paused'); + + // 先暂停 queue item + await client.call('rr_v3.pauseRun', { runId }); + + // 取消 + await client.call('rr_v3.cancelRun', { runId, reason: 'E2E cancel test' }); + + const run = await h.waitForTerminal(runId); + expect(run.status).toBe('canceled'); + await h.waitForQueueItemGone(runId); + }); + + it('cancel queued run removes it from queue', async () => { + // 创建一个新的 harness，不自动启动 scheduler + await h.dispose(); + h = createV3E2EHarness({ autoStartScheduler: false }); + client = h.createClient(); + + const flow = createTestFlow('flow-cancel-queued'); + await h.storage.flows.save(flow); + + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + + // 队列中应该有这个 item + let item = await h.storage.queue.get(runId); + expect(item?.status).toBe('queued'); + + // 取消 + await client.call('rr_v3.cancelRun', { runId }); + + // Queue item should be removed (queue.get returns null when not found) + item = await h.storage.queue.get(runId); + expect(item).toBeNull(); + + // Run 状态应该是 canceled + const run = await h.storage.runs.get(runId); + expect(run?.status).toBe('canceled'); + }); + }); + + describe('Recovery', () => { + it('orphan running lease is requeued and run can complete', async () => { + // 停止当前 harness，创建新的不启动 scheduler + await h.dispose(); + h = createV3E2EHarness({ autoStartScheduler: false, ownerId: 'owner-new' }); + client = h.createClient(); + + const flow = createTestFlow('flow-recovery'); + await h.storage.flows.save(flow); + + const runId = 'run-orphan'; + await h.storage.runs.save(createRunRecord(runId, flow.id, 'running')); + + // 创建 orphan 队列项（旧 owner 持有） + await h.storage.queue.enqueue({ id: runId, flowId: flow.id, priority: 0 }); + await h.storage.queue.markRunning(runId, 'owner-old', Date.now()); + + // 执行恢复 + const recovery = await recoverFromCrash({ + storage: h.storage, + events: h.events, + ownerId: h.ownerId, + now: () => Date.now(), + logger: { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} }, + }); + + expect(recovery.requeuedRunning).toContain(runId); + + // 队列项应该回到 queued 状态 + const queueItemAfter = await h.storage.queue.get(runId); + expect(queueItemAfter?.status).toBe('queued'); + expect(queueItemAfter?.lease).toBeUndefined(); + + // 应该有 run.recovered 事件 + const events = await h.listEvents(runId); + expect(events.some((e) => e.type === 'run.recovered')).toBe(true); + + // 启动 scheduler，Run 应该能继续执行 + h.scheduler.start(); + + const run = await h.waitForTerminal(runId); + expect(run.status).toBe('succeeded'); + await h.waitForQueueItemGone(runId); + }); + + it('adopts orphan paused items', async () => { + await h.dispose(); + h = createV3E2EHarness({ autoStartScheduler: false, ownerId: 'owner-new' }); + client = h.createClient(); + + const flow = createTestFlow('flow-adopt'); + await h.storage.flows.save(flow); + + const runId = 'run-paused-orphan'; + await h.storage.runs.save(createRunRecord(runId, flow.id, 'paused')); + + await h.storage.queue.enqueue({ id: runId, flowId: flow.id, priority: 0 }); + await h.storage.queue.markPaused(runId, 'owner-old', Date.now()); + + const recovery = await recoverFromCrash({ + storage: h.storage, + events: h.events, + ownerId: h.ownerId, + now: () => Date.now(), + logger: { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} }, + }); + + expect(recovery.adoptedPaused).toContain(runId); + + // 队列项应该仍是 paused，但 owner 换成新的 + const queueItem = await h.storage.queue.get(runId); + expect(queueItem?.status).toBe('paused'); + expect(queueItem?.lease?.ownerId).toBe(h.ownerId); + }); + + it('cleans terminal runs left in queue', async () => { + await h.dispose(); + h = createV3E2EHarness({ autoStartScheduler: false, ownerId: 'owner-new' }); + client = h.createClient(); + + const flow = createTestFlow('flow-clean'); + await h.storage.flows.save(flow); + + const runId = 'run-completed-orphan'; + await h.storage.runs.save(createRunRecord(runId, flow.id, 'succeeded')); + + // 模拟崩溃场景：Run 完成但队列项未清理 + await h.storage.queue.enqueue({ id: runId, flowId: flow.id, priority: 0 }); + await h.storage.queue.markRunning(runId, 'owner-old', Date.now()); + + const recovery = await recoverFromCrash({ + storage: h.storage, + events: h.events, + ownerId: h.ownerId, + now: () => Date.now(), + logger: { debug: () => {}, info: () => {}, warn: () => {}, error: () => {} }, + }); + + expect(recovery.cleanedTerminal).toContain(runId); + + // 队列应该为空 + const remaining = await h.storage.queue.list(); + expect(remaining).toHaveLength(0); + }); + }); + + describe('Query APIs', () => { + it('getRun returns run record', async () => { + const flow = createTestFlow('flow-get'); + await h.storage.flows.save(flow); + + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + + await h.waitForTerminal(runId); + + const run = await client.call('rr_v3.getRun', { runId }); + expect(run).not.toBeNull(); + expect(run?.id).toBe(runId); + expect(run?.status).toBe('succeeded'); + }); + + it('listRuns returns all runs', async () => { + const flow = createTestFlow('flow-list'); + await h.storage.flows.save(flow); + + const { runId: runId1 } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + await h.waitForTerminal(runId1); + + const { runId: runId2 } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + await h.waitForTerminal(runId2); + + const runs = await client.call('rr_v3.listRuns'); + expect(runs.length).toBeGreaterThanOrEqual(2); + expect(runs.some((r) => r.id === runId1)).toBe(true); + expect(runs.some((r) => r.id === runId2)).toBe(true); + }); + + it('getEvents returns run events', async () => { + const flow = createTestFlow('flow-events'); + await h.storage.flows.save(flow); + + const { runId } = await client.call<{ runId: string }>('rr_v3.enqueueRun', { + flowId: flow.id, + }); + await h.waitForTerminal(runId); + + const events = await client.call('rr_v3.getEvents', { runId }); + expect(events.length).toBeGreaterThan(0); + expect(events.some((e) => e.type === 'run.queued')).toBe(true); + expect(events.some((e) => e.type === 'run.succeeded')).toBe(true); + }); + + it('listQueue returns queue items', async () => { + await h.dispose(); + h = createV3E2EHarness({ autoStartScheduler: false }); + client = h.createClient(); + + const flow = createTestFlow('flow-queue'); + await h.storage.flows.save(flow); + + await client.call('rr_v3.enqueueRun', { flowId: flow.id }); + await client.call('rr_v3.enqueueRun', { flowId: flow.id }); + + const queue = await client.call('rr_v3.listQueue'); + expect(queue.length).toBeGreaterThanOrEqual(2); + }); + }); + + describe('Error handling', () => { + it('enqueueRun with non-existent flow throws error', async () => { + await expect( + client.call('rr_v3.enqueueRun', { flowId: 'non-existent-flow' }), + ).rejects.toThrow(); + }); + + it('getRun with non-existent runId returns null', async () => { + const run = await client.call('rr_v3.getRun', { + runId: 'non-existent-run', + }); + expect(run).toBeNull(); + }); + + it('pauseRun with invalid runId throws error', async () => { + await expect(client.call('rr_v3.pauseRun', { runId: 'invalid-run' })).rejects.toThrow(); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/events.contract.test.ts b/app/chrome-extension/tests/record-replay-v3/events.contract.test.ts new file mode 100644 index 00000000..426c642c --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/events.contract.test.ts @@ -0,0 +1,330 @@ +/** + * @fileoverview Record-Replay V3 Events Contracts + * @description + * Verifies the persistence + transport contracts for: + * - EventsStore (IndexedDB-backed): atomic seq allocation via RunRecordV3.nextSeq + * - StorageBackedEventsBus: persistence-before-broadcast semantics + * + * Note: These tests assume `RunRecordV3.nextSeq` is initialized to 1 (1-based seq). + */ + +import { beforeEach, describe, expect, it } from 'vitest'; + +import type { + RunEvent, + RunEventInput, + RunRecordV3, +} from '@/entrypoints/background/record-replay-v3'; + +import { + RUN_SCHEMA_VERSION, + RR_ERROR_CODES, + StorageBackedEventsBus, + createEventsStore, + createRunsStore, + closeRrV3Db, + deleteRrV3Db, + RR_V3_STORES, + withTransaction, +} from '@/entrypoints/background/record-replay-v3'; + +/** + * Create a valid RunRecordV3 for testing + */ +function createRunRecord(runId: string, overrides: Partial = {}): RunRecordV3 { + const now = Date.now(); + return { + schemaVersion: RUN_SCHEMA_VERSION, + id: runId, + flowId: 'flow-1', + status: 'running', + createdAt: now, + updatedAt: now, + attempt: 0, + maxAttempts: 1, + nextSeq: 1, + ...overrides, + }; +} + +/** + * Create a valid RunEventInput for testing + */ +function createEventInput(runId: string, overrides: Partial = {}): RunEventInput { + return { + runId, + type: 'run.resumed', + ...overrides, + } as RunEventInput; +} + +/** + * Directly insert an event into the events store (bypasses append logic) + * Used for testing list() with out-of-order data + */ +async function putEventRaw(event: RunEvent): Promise { + await withTransaction(RR_V3_STORES.EVENTS, 'readwrite', async (stores) => { + const store = stores[RR_V3_STORES.EVENTS]; + await new Promise((resolve, reject) => { + const request = store.add(event); + request.onsuccess = () => resolve(); + request.onerror = () => reject(request.error); + }); + }); +} + +describe('V3 Events contracts', () => { + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + }); + + describe('EventsStore', () => { + it('seq is monotonic and contiguous for a run', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + + const e1 = await events.append(createEventInput('run-1')); + const e2 = await events.append(createEventInput('run-1')); + const e3 = await events.append(createEventInput('run-1')); + + expect([e1.seq, e2.seq, e3.seq]).toEqual([1, 2, 3]); + }); + + it('append is atomic: event.seq matches pre-append nextSeq and nextSeq increments on success', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 10 })); + + const appended = await events.append(createEventInput('run-1')); + expect(appended.seq).toBe(10); + + const runAfter = await runs.get('run-1'); + expect(runAfter).not.toBeNull(); + expect(runAfter!.nextSeq).toBe(appended.seq + 1); + + const list = await events.list('run-1'); + expect(list.map((e) => e.seq)).toContain(10); + }); + + it('throws RRError when appending to a missing run', async () => { + const events = createEventsStore(); + + await expect(events.append(createEventInput('missing-run'))).rejects.toMatchObject({ + code: RR_ERROR_CODES.INTERNAL, + }); + }); + + it('list returns events ordered by seq ascending (even if inserted out-of-order)', async () => { + const events = createEventsStore(); + const runId = 'run-1'; + const now = Date.now(); + + // Insert events out of order to verify sorting + await putEventRaw({ runId, type: 'run.resumed', seq: 5, ts: now } as RunEvent); + await putEventRaw({ runId, type: 'run.resumed', seq: 2, ts: now } as RunEvent); + await putEventRaw({ runId, type: 'run.resumed', seq: 9, ts: now } as RunEvent); + + const list = await events.list(runId); + expect(list.map((e) => e.seq)).toEqual([2, 5, 9]); + }); + + it('list supports fromSeq (inclusive)', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + for (let i = 0; i < 5; i++) { + await events.append(createEventInput('run-1')); + } + + const list = await events.list('run-1', { fromSeq: 3 }); + expect(list.map((e) => e.seq)).toEqual([3, 4, 5]); + }); + + it('list supports limit', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + for (let i = 0; i < 5; i++) { + await events.append(createEventInput('run-1')); + } + + const list = await events.list('run-1', { limit: 2 }); + expect(list.map((e) => e.seq)).toEqual([1, 2]); + + const listFrom = await events.list('run-1', { fromSeq: 2, limit: 2 }); + expect(listFrom.map((e) => e.seq)).toEqual([2, 3]); + + const empty = await events.list('run-1', { limit: 0 }); + expect(empty).toEqual([]); + }); + + it('seq allocation remains correct under concurrent appends', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + + // Fire multiple appends concurrently + const appended = await Promise.all( + Array.from({ length: 20 }, () => events.append(createEventInput('run-1'))), + ); + + const seqs = appended.map((e) => e.seq).sort((a, b) => a - b); + expect(seqs).toEqual(Array.from({ length: 20 }, (_, i) => i + 1)); + + const runAfter = await runs.get('run-1'); + expect(runAfter!.nextSeq).toBe(21); + }); + + it('list does not mix events from different runs', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + await runs.save(createRunRecord('run-2', { nextSeq: 1 })); + + await events.append(createEventInput('run-1')); + await events.append(createEventInput('run-2')); + await events.append(createEventInput('run-1')); + + const run1Events = await events.list('run-1'); + const run2Events = await events.list('run-2'); + + expect(run1Events.every((e) => e.runId === 'run-1')).toBe(true); + expect(run2Events.every((e) => e.runId === 'run-2')).toBe(true); + expect(run1Events.map((e) => e.seq)).toEqual([1, 2]); + expect(run2Events.map((e) => e.seq)).toEqual([1]); + }); + + it('throws INVARIANT_VIOLATION when nextSeq is invalid', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + + // Test with negative nextSeq + await runs.save(createRunRecord('run-neg', { nextSeq: -1 })); + await expect(events.append(createEventInput('run-neg'))).rejects.toMatchObject({ + code: RR_ERROR_CODES.INVARIANT_VIOLATION, + }); + + // Test with non-integer nextSeq (NaN) + await runs.save(createRunRecord('run-nan', { nextSeq: NaN })); + await expect(events.append(createEventInput('run-nan'))).rejects.toMatchObject({ + code: RR_ERROR_CODES.INVARIANT_VIOLATION, + }); + }); + }); + + describe('StorageBackedEventsBus', () => { + it('broadcasts after commit: when listener runs, data is already durable', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + + const bus = new StorageBackedEventsBus(events); + + const received: RunEvent[] = []; + let seenRunNextSeq: number | null = null; + let seenListSeqs: number[] | null = null; + + const listenerDone = new Promise((resolve, reject) => { + bus.subscribe((event) => { + received.push(event); + void Promise.all([runs.get(event.runId), events.list(event.runId)]) + .then(([run, list]) => { + seenRunNextSeq = run?.nextSeq ?? null; + seenListSeqs = list.map((e) => e.seq); + resolve(); + }) + .catch(reject); + }); + }); + + const appended = await bus.append(createEventInput('run-1')); + + // Contract: by the time append resolves, the event is already broadcast + expect(received).toHaveLength(1); + expect(received[0]).toMatchObject({ runId: 'run-1', seq: appended.seq }); + + await listenerDone; + expect(seenRunNextSeq).toBe(appended.seq + 1); + expect(seenListSeqs).toContain(appended.seq); + }); + + it('applies runId filter for subscriptions', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + await runs.save(createRunRecord('run-2', { nextSeq: 1 })); + + const bus = new StorageBackedEventsBus(events); + + const all: RunEvent[] = []; + const onlyRun1: RunEvent[] = []; + const onlyRun2: RunEvent[] = []; + + bus.subscribe((e) => all.push(e)); + bus.subscribe((e) => onlyRun1.push(e), { runId: 'run-1' }); + bus.subscribe((e) => onlyRun2.push(e), { runId: 'run-2' }); + + await bus.append(createEventInput('run-1')); + await bus.append(createEventInput('run-2')); + + expect(all.map((e) => e.runId)).toEqual(['run-1', 'run-2']); + expect(onlyRun1.map((e) => e.runId)).toEqual(['run-1']); + expect(onlyRun2.map((e) => e.runId)).toEqual(['run-2']); + }); + + it('unsubscribe stops further broadcasts', async () => { + const runs = createRunsStore(); + const events = createEventsStore(); + await runs.save(createRunRecord('run-1', { nextSeq: 1 })); + + const bus = new StorageBackedEventsBus(events); + const received: RunEvent[] = []; + const unsub = bus.subscribe((e) => received.push(e)); + + await bus.append(createEventInput('run-1')); + expect(received).toHaveLength(1); + + unsub(); + await bus.append(createEventInput('run-1')); + + // Should not receive second event after unsubscribe + expect(received).toHaveLength(1); + }); + }); + + describe('Crash recovery', () => { + it('continues seq after a simulated restart', async () => { + const runs1 = createRunsStore(); + const events1 = createEventsStore(); + + await runs1.save(createRunRecord('run-1', { nextSeq: 1 })); + + await events1.append(createEventInput('run-1')); + await events1.append(createEventInput('run-1')); + await events1.append(createEventInput('run-1')); + + // Simulate a service worker restart (drop cached IDB connection) + closeRrV3Db(); + + const runs2 = createRunsStore(); + const events2 = createEventsStore(); + + const e4 = await events2.append(createEventInput('run-1')); + expect(e4.seq).toBe(4); + + const list = await events2.list('run-1'); + expect(list.map((e) => e.seq)).toEqual([1, 2, 3, 4]); + + const run = await runs2.get('run-1'); + expect(run!.nextSeq).toBe(5); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/interval-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/interval-trigger.test.ts new file mode 100644 index 00000000..8789a151 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/interval-trigger.test.ts @@ -0,0 +1,243 @@ +/** + * @fileoverview Interval Trigger Handler Tests + * @description 测试 interval 触发器的安装、卸载和触发行为 + */ + +import { describe, it, expect, beforeEach, vi } from 'vitest'; +import type { TriggerId, FlowId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createIntervalTriggerHandler } from '@/entrypoints/background/record-replay-v3/engine/triggers/interval-trigger'; + +// ==================== Test Utilities ==================== + +function createMockLogger() { + return { + debug: vi.fn(), + info: vi.fn(), + warn: vi.fn(), + error: vi.fn(), + }; +} + +function createMockFireCallback(): TriggerFireCallback & { calls: Array<{ triggerId: string }> } { + const calls: Array<{ triggerId: string }> = []; + return { + calls, + onFire: vi.fn(async (triggerId) => { + calls.push({ triggerId }); + }), + }; +} + +function createIntervalTriggerSpec( + overrides: Partial> = {}, +): TriggerSpecByKind<'interval'> { + return { + id: 'interval-trigger-1' as TriggerId, + kind: 'interval', + flowId: 'flow-1' as FlowId, + enabled: true, + periodMinutes: 5, + ...overrides, + }; +} + +// ==================== Mock chrome.alarms ==================== + +let alarmListeners: Array<(alarm: chrome.alarms.Alarm) => void> = []; +let createdAlarms: Map = new Map(); + +function setupMockChromeAlarms() { + alarmListeners = []; + createdAlarms = new Map(); + + const alarms = { + create: vi.fn((name: string, info: { periodInMinutes?: number; delayInMinutes?: number }) => { + createdAlarms.set(name, info); + return Promise.resolve(); + }), + clear: vi.fn((name: string) => { + createdAlarms.delete(name); + return Promise.resolve(true); + }), + getAll: vi.fn(() => { + return Promise.resolve( + Array.from(createdAlarms.entries()).map(([name]) => ({ name, scheduledTime: 0 })), + ); + }), + onAlarm: { + addListener: vi.fn((listener: (alarm: chrome.alarms.Alarm) => void) => { + alarmListeners.push(listener); + }), + removeListener: vi.fn((listener: (alarm: chrome.alarms.Alarm) => void) => { + alarmListeners = alarmListeners.filter((l) => l !== listener); + }), + }, + }; + + (globalThis as unknown as { chrome: { alarms: typeof alarms } }).chrome = { alarms }; + + return alarms; +} + +function simulateAlarmFire(name: string) { + for (const listener of alarmListeners) { + listener({ name, scheduledTime: Date.now() }); + } +} + +// ==================== Tests ==================== + +describe('IntervalTriggerHandler', () => { + let mockAlarms: ReturnType; + let mockLogger: ReturnType; + let fireCallback: ReturnType; + + beforeEach(() => { + vi.clearAllMocks(); + mockAlarms = setupMockChromeAlarms(); + mockLogger = createMockLogger(); + fireCallback = createMockFireCallback(); + }); + + describe('install', () => { + it('creates repeating alarm with correct periodInMinutes', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec({ periodMinutes: 10 }); + + await handler.install(trigger); + + expect(mockAlarms.create).toHaveBeenCalledWith( + 'rr_v3_interval_interval-trigger-1', + expect.objectContaining({ + periodInMinutes: 10, + delayInMinutes: 10, + }), + ); + }); + + it('adds alarm listener on first install', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + + expect(mockAlarms.onAlarm.addListener).not.toHaveBeenCalled(); + + await handler.install(createIntervalTriggerSpec()); + + expect(mockAlarms.onAlarm.addListener).toHaveBeenCalledTimes(1); + }); + + it('registers trigger ID', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec(); + + await handler.install(trigger); + + expect(handler.getInstalledIds()).toContain(trigger.id); + }); + + it('throws error for invalid periodMinutes', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + + await expect( + handler.install(createIntervalTriggerSpec({ periodMinutes: 0 })), + ).rejects.toThrow('periodMinutes must be >= 1'); + + await expect( + handler.install(createIntervalTriggerSpec({ periodMinutes: -5 })), + ).rejects.toThrow('periodMinutes must be >= 1'); + + await expect( + handler.install(createIntervalTriggerSpec({ periodMinutes: NaN as number })), + ).rejects.toThrow('periodMinutes must be a finite number'); + }); + }); + + describe('uninstall', () => { + it('clears alarm and removes trigger from installed list', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec(); + + await handler.install(trigger); + expect(handler.getInstalledIds()).toContain(trigger.id); + + await handler.uninstall(trigger.id); + + expect(mockAlarms.clear).toHaveBeenCalledWith('rr_v3_interval_interval-trigger-1'); + expect(handler.getInstalledIds()).not.toContain(trigger.id); + }); + + it('removes alarm listener when last trigger is uninstalled', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec(); + + await handler.install(trigger); + await handler.uninstall(trigger.id); + + expect(mockAlarms.onAlarm.removeListener).toHaveBeenCalled(); + }); + }); + + describe('uninstallAll', () => { + it('clears all interval alarms', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + + await handler.install(createIntervalTriggerSpec({ id: 'trigger-1' as TriggerId })); + await handler.install(createIntervalTriggerSpec({ id: 'trigger-2' as TriggerId })); + + await handler.uninstallAll(); + + expect(handler.getInstalledIds()).toHaveLength(0); + expect(mockAlarms.onAlarm.removeListener).toHaveBeenCalled(); + }); + }); + + describe('alarm handling', () => { + it('fires callback when alarm triggers', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec(); + + await handler.install(trigger); + + // Simulate alarm fire + simulateAlarmFire('rr_v3_interval_interval-trigger-1'); + + // Wait for async callback + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).toHaveBeenCalledWith( + trigger.id, + expect.objectContaining({ + sourceTabId: undefined, + sourceUrl: undefined, + }), + ); + }); + + it('ignores alarms from other handlers', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + await handler.install(createIntervalTriggerSpec()); + + // Simulate alarm from different handler + simulateAlarmFire('rr_v3_cron_some-other-trigger'); + + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('ignores alarms for uninstalled triggers', async () => { + const handler = createIntervalTriggerHandler(fireCallback, { logger: mockLogger }); + const trigger = createIntervalTriggerSpec(); + + await handler.install(trigger); + await handler.uninstall(trigger.id); + + simulateAlarmFire('rr_v3_interval_interval-trigger-1'); + + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/manual-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/manual-trigger.test.ts new file mode 100644 index 00000000..23874d42 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/manual-trigger.test.ts @@ -0,0 +1,152 @@ +/** + * @fileoverview Manual Trigger Handler 测试 (P4-08) + * @description + * Tests for: + * - Basic install/uninstall operations + * - getInstalledIds tracking + */ + +import { describe, expect, it, vi } from 'vitest'; + +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createManualTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/manual-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +// ==================== Manual Trigger Tests ==================== + +describe('V3 ManualTriggerHandler', () => { + describe('Installation', () => { + it('installs trigger', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'manual'> = { + id: 't1' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-1' as never, + }; + + await handler.install(trigger); + + expect(handler.getInstalledIds()).toEqual(['t1']); + }); + + it('installs multiple triggers', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-1' as never, + }); + + await handler.install({ + id: 't2' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-2' as never, + }); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + }); + }); + + describe('Uninstallation', () => { + it('uninstalls trigger', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-1' as never, + }); + + await handler.uninstall('t1'); + + expect(handler.getInstalledIds()).toEqual([]); + }); + + it('uninstallAll clears all triggers', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-1' as never, + }); + + await handler.install({ + id: 't2' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-2' as never, + }); + + await handler.uninstallAll(); + + expect(handler.getInstalledIds()).toEqual([]); + }); + }); + + describe('getInstalledIds', () => { + it('returns empty array when no triggers installed', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + expect(handler.getInstalledIds()).toEqual([]); + }); + + it('tracks partial uninstall', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createManualTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + await handler.install({ + id: 't1' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-1' as never, + }); + + await handler.install({ + id: 't2' as never, + kind: 'manual', + enabled: true, + flowId: 'flow-2' as never, + }); + + await handler.uninstall('t1'); + + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/once-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/once-trigger.test.ts new file mode 100644 index 00000000..03adbd03 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/once-trigger.test.ts @@ -0,0 +1,326 @@ +/** + * @fileoverview Once Trigger Handler Tests + * @description 测试 once 触发器的安装、卸载、触发和自动禁用行为 + */ + +import { describe, it, expect, beforeEach, vi } from 'vitest'; +import type { TriggerId, FlowId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createOnceTriggerHandler } from '@/entrypoints/background/record-replay-v3/engine/triggers/once-trigger'; + +// ==================== Test Utilities ==================== + +function createMockLogger() { + return { + debug: vi.fn(), + info: vi.fn(), + warn: vi.fn(), + error: vi.fn(), + }; +} + +function createMockFireCallback(): TriggerFireCallback & { calls: Array<{ triggerId: string }> } { + const calls: Array<{ triggerId: string }> = []; + return { + calls, + onFire: vi.fn(async (triggerId) => { + calls.push({ triggerId }); + }), + }; +} + +function createOnceTriggerSpec( + overrides: Partial> = {}, +): TriggerSpecByKind<'once'> { + return { + id: 'once-trigger-1' as TriggerId, + kind: 'once', + flowId: 'flow-1' as FlowId, + enabled: true, + whenMs: Date.now() + 60000, // 1 minute from now + ...overrides, + }; +} + +// ==================== Mock chrome.alarms ==================== + +let alarmListeners: Array<(alarm: chrome.alarms.Alarm) => void> = []; +let createdAlarms: Map = new Map(); + +function setupMockChromeAlarms() { + alarmListeners = []; + createdAlarms = new Map(); + + const alarms = { + create: vi.fn((name: string, info: { when?: number }) => { + createdAlarms.set(name, info); + return Promise.resolve(); + }), + clear: vi.fn((name: string) => { + createdAlarms.delete(name); + return Promise.resolve(true); + }), + getAll: vi.fn(() => { + return Promise.resolve( + Array.from(createdAlarms.entries()).map(([name, info]) => ({ + name, + scheduledTime: info.when ?? 0, + })), + ); + }), + onAlarm: { + addListener: vi.fn((listener: (alarm: chrome.alarms.Alarm) => void) => { + alarmListeners.push(listener); + }), + removeListener: vi.fn((listener: (alarm: chrome.alarms.Alarm) => void) => { + alarmListeners = alarmListeners.filter((l) => l !== listener); + }), + }, + }; + + (globalThis as unknown as { chrome: { alarms: typeof alarms } }).chrome = { alarms }; + + return alarms; +} + +function simulateAlarmFire(name: string) { + for (const listener of alarmListeners) { + listener({ name, scheduledTime: Date.now() }); + } +} + +// ==================== Tests ==================== + +describe('OnceTriggerHandler', () => { + let mockAlarms: ReturnType; + let mockLogger: ReturnType; + let fireCallback: ReturnType; + let disabledTriggers: Set; + let mockDisableTrigger: (triggerId: TriggerId) => Promise; + + beforeEach(() => { + vi.clearAllMocks(); + mockAlarms = setupMockChromeAlarms(); + mockLogger = createMockLogger(); + fireCallback = createMockFireCallback(); + disabledTriggers = new Set(); + mockDisableTrigger = vi.fn(async (triggerId: TriggerId) => { + disabledTriggers.add(triggerId); + }); + }); + + describe('install', () => { + it('creates one-shot alarm with correct when timestamp', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const futureTime = Date.now() + 300000; // 5 minutes + const trigger = createOnceTriggerSpec({ whenMs: futureTime }); + + await handler.install(trigger); + + expect(mockAlarms.create).toHaveBeenCalledWith( + 'rr_v3_once_once-trigger-1', + expect.objectContaining({ when: futureTime }), + ); + }); + + it('adds alarm listener on first install', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + + expect(mockAlarms.onAlarm.addListener).not.toHaveBeenCalled(); + + await handler.install(createOnceTriggerSpec()); + + expect(mockAlarms.onAlarm.addListener).toHaveBeenCalledTimes(1); + }); + + it('registers trigger ID', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + + expect(handler.getInstalledIds()).toContain(trigger.id); + }); + + it('throws error for invalid whenMs', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + + await expect( + handler.install(createOnceTriggerSpec({ whenMs: NaN as number })), + ).rejects.toThrow('whenMs must be a finite number'); + + await expect( + handler.install(createOnceTriggerSpec({ whenMs: Infinity as number })), + ).rejects.toThrow('whenMs must be a finite number'); + }); + + it('floors whenMs to integer', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec({ whenMs: 1234567890123.999 }); + + await handler.install(trigger); + + expect(mockAlarms.create).toHaveBeenCalledWith( + expect.any(String), + expect.objectContaining({ when: 1234567890123 }), + ); + }); + }); + + describe('uninstall', () => { + it('clears alarm and removes trigger from installed list', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + expect(handler.getInstalledIds()).toContain(trigger.id); + + await handler.uninstall(trigger.id); + + expect(mockAlarms.clear).toHaveBeenCalledWith('rr_v3_once_once-trigger-1'); + expect(handler.getInstalledIds()).not.toContain(trigger.id); + }); + + it('removes alarm listener when last trigger is uninstalled', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + await handler.uninstall(trigger.id); + + expect(mockAlarms.onAlarm.removeListener).toHaveBeenCalled(); + }); + }); + + describe('uninstallAll', () => { + it('clears all once alarms', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + + await handler.install(createOnceTriggerSpec({ id: 'trigger-1' as TriggerId })); + await handler.install(createOnceTriggerSpec({ id: 'trigger-2' as TriggerId })); + + await handler.uninstallAll(); + + expect(handler.getInstalledIds()).toHaveLength(0); + expect(mockAlarms.onAlarm.removeListener).toHaveBeenCalled(); + }); + }); + + describe('alarm handling', () => { + it('fires callback when alarm triggers', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + + // Simulate alarm fire + simulateAlarmFire('rr_v3_once_once-trigger-1'); + + // Wait for async callback + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).toHaveBeenCalledWith( + trigger.id, + expect.objectContaining({ + sourceTabId: undefined, + sourceUrl: undefined, + }), + ); + }); + + it('disables trigger after firing', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + simulateAlarmFire('rr_v3_once_once-trigger-1'); + + // Wait for async callback + await new Promise((resolve) => setTimeout(resolve, 50)); + + expect(mockDisableTrigger).toHaveBeenCalledWith(trigger.id); + expect(disabledTriggers.has(trigger.id)).toBe(true); + }); + + it('uninstalls trigger after firing', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + expect(handler.getInstalledIds()).toContain(trigger.id); + + simulateAlarmFire('rr_v3_once_once-trigger-1'); + + // Wait for async cleanup + await new Promise((resolve) => setTimeout(resolve, 50)); + + expect(handler.getInstalledIds()).not.toContain(trigger.id); + }); + + it('ignores alarms from other handlers', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + await handler.install(createOnceTriggerSpec()); + + // Simulate alarm from different handler + simulateAlarmFire('rr_v3_interval_some-other-trigger'); + + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('ignores alarms for uninstalled triggers', async () => { + const handler = createOnceTriggerHandler(fireCallback, { + logger: mockLogger, + disableTrigger: mockDisableTrigger, + }); + const trigger = createOnceTriggerSpec(); + + await handler.install(trigger); + await handler.uninstall(trigger.id); + + simulateAlarmFire('rr_v3_once_once-trigger-1'); + + await new Promise((resolve) => setTimeout(resolve, 10)); + + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/queue.contract.test.ts b/app/chrome-extension/tests/record-replay-v3/queue.contract.test.ts new file mode 100644 index 00000000..c00f0a2c --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/queue.contract.test.ts @@ -0,0 +1,525 @@ +/** + * @fileoverview Record-Replay V3 Queue Contracts + * @description + * Verifies the persistence + atomic claim contracts for RunQueue: + * - Basic CRUD operations (enqueue, get, list) + * - Atomic claimNext with priority DESC + createdAt ASC (FIFO) ordering + * - Lease management (markRunning, markPaused, markDone) + * - Concurrent claim behavior + */ + +import { beforeEach, describe, expect, it } from 'vitest'; + +import { + DEFAULT_QUEUE_CONFIG, + type RunQueueItem, +} from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; + +import { + createQueueStore, + closeRrV3Db, + deleteRrV3Db, +} from '@/entrypoints/background/record-replay-v3'; + +describe('V3 Queue contracts', () => { + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + }); + + describe('Basic CRUD', () => { + it('enqueue creates a queued item with correct defaults', async () => { + const queue = createQueueStore(); + + const item = await queue.enqueue({ + id: 'run-1', + flowId: 'flow-1', + priority: 5, + }); + + expect(item).toMatchObject({ + id: 'run-1', + flowId: 'flow-1', + priority: 5, + status: 'queued', + attempt: 0, + }); + expect(item.createdAt).toBeGreaterThan(0); + expect(item.updatedAt).toBeGreaterThan(0); + }); + + it('get retrieves an enqueued item', async () => { + const queue = createQueueStore(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + + const retrieved = await queue.get('run-1'); + expect(retrieved).not.toBeNull(); + expect(retrieved!.id).toBe('run-1'); + }); + + it('get returns null for non-existent item', async () => { + const queue = createQueueStore(); + + const retrieved = await queue.get('non-existent'); + expect(retrieved).toBeNull(); + }); + + it('list returns all items when no filter', async () => { + const queue = createQueueStore(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 2 }); + + const items = await queue.list(); + expect(items).toHaveLength(2); + }); + + it('list filters by status', async () => { + const queue = createQueueStore(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 2 }); + await queue.markRunning('run-1', 'owner-1', Date.now()); + + const queued = await queue.list('queued'); + const running = await queue.list('running'); + + expect(queued).toHaveLength(1); + expect(queued[0].id).toBe('run-2'); + expect(running).toHaveLength(1); + expect(running[0].id).toBe('run-1'); + }); + }); + + describe('Atomic claimNext', () => { + it('returns null when queue is empty', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + const claimed = await queue.claimNext('owner-1', now); + expect(claimed).toBeNull(); + }); + + it('claims the highest priority item first', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + // Enqueue with different priorities (lower number = lower priority) + await queue.enqueue({ id: 'low', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'high', flowId: 'flow-1', priority: 10 }); + await queue.enqueue({ id: 'medium', flowId: 'flow-1', priority: 5 }); + + const claimed = await queue.claimNext('owner-1', now); + expect(claimed).not.toBeNull(); + expect(claimed!.id).toBe('high'); + expect(claimed!.status).toBe('running'); + expect(claimed!.priority).toBe(10); + }); + + it('claims FIFO within same priority (earlier createdAt first)', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + // Enqueue items with same priority + // Small delays ensure different createdAt timestamps + await queue.enqueue({ id: 'first', flowId: 'flow-1', priority: 5 }); + await new Promise((r) => setTimeout(r, 5)); + await queue.enqueue({ id: 'second', flowId: 'flow-1', priority: 5 }); + await new Promise((r) => setTimeout(r, 5)); + await queue.enqueue({ id: 'third', flowId: 'flow-1', priority: 5 }); + + // First claim should get 'first' + const claim1 = await queue.claimNext('owner-1', now); + expect(claim1!.id).toBe('first'); + + // Second claim should get 'second' + const claim2 = await queue.claimNext('owner-1', now); + expect(claim2!.id).toBe('second'); + + // Third claim should get 'third' + const claim3 = await queue.claimNext('owner-1', now); + expect(claim3!.id).toBe('third'); + + // Fourth claim should return null + const claim4 = await queue.claimNext('owner-1', now); + expect(claim4).toBeNull(); + }); + + it('atomically updates item to running with lease', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + + const claimed = await queue.claimNext('owner-1', now); + + expect(claimed).toMatchObject({ + id: 'run-1', + status: 'running', + attempt: 1, + lease: { + ownerId: 'owner-1', + }, + }); + expect(claimed!.lease!.expiresAt).toBeGreaterThan(now); + expect(claimed!.updatedAt).toBeGreaterThanOrEqual(now); + }); + + it('persists the claimed item as running in the store', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + const claimed = await queue.claimNext('owner-1', now); + expect(claimed).not.toBeNull(); + + // Verify persistence via get() + const stored = await queue.get('run-1'); + expect(stored).toMatchObject({ + id: 'run-1', + status: 'running', + attempt: 1, + lease: { ownerId: 'owner-1' }, + }); + }); + + it('increments attempt on each claim', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + + // First claim + let claimed = await queue.claimNext('owner-1', now); + expect(claimed!.attempt).toBe(1); + + // Re-queue by marking as queued (simulating retry) + await queue.markDone('run-1', now); + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + + // Second claim + claimed = await queue.claimNext('owner-2', now); + expect(claimed!.attempt).toBe(1); // New enqueue resets attempt + }); + + it('throws on invalid ownerId', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await expect(queue.claimNext('', now)).rejects.toThrow('ownerId is required'); + }); + + it('throws on invalid now timestamp', async () => { + const queue = createQueueStore(); + + await expect(queue.claimNext('owner-1', NaN)).rejects.toThrow('Invalid now'); + await expect(queue.claimNext('owner-1', Infinity)).rejects.toThrow('Invalid now'); + }); + + it('concurrent claims do not return the same item', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + // Enqueue multiple items + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-3', flowId: 'flow-1', priority: 1 }); + + // Claim concurrently + const claims = await Promise.all([ + queue.claimNext('owner-1', now), + queue.claimNext('owner-2', now), + queue.claimNext('owner-3', now), + ]); + + // Filter out nulls + const claimed = claims.filter((c): c is RunQueueItem => c !== null); + expect(claimed).toHaveLength(3); + + // All claimed items should have unique IDs + const ids = claimed.map((c) => c.id); + expect(new Set(ids).size).toBe(3); + + // All should be running + expect(claimed.every((c) => c.status === 'running')).toBe(true); + }); + + it('skips non-queued items', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 10 }); + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 5 }); + + // Mark the higher priority one as running + await queue.markRunning('run-1', 'owner-1', now); + + // claimNext should skip run-1 and return run-2 + const claimed = await queue.claimNext('owner-2', now); + expect(claimed!.id).toBe('run-2'); + }); + }); + + describe('Status transitions', () => { + it('markRunning updates status and creates lease', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.markRunning('run-1', 'owner-1', now); + + const item = await queue.get('run-1'); + expect(item!.status).toBe('running'); + expect(item!.lease).toMatchObject({ + ownerId: 'owner-1', + }); + expect(item!.attempt).toBe(1); + }); + + it('markPaused updates status while keeping lease', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.markRunning('run-1', 'owner-1', now); + await queue.markPaused('run-1', 'owner-1', now + 1000); + + const item = await queue.get('run-1'); + expect(item!.status).toBe('paused'); + expect(item!.lease!.ownerId).toBe('owner-1'); + }); + + it('markDone removes item from queue', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.markDone('run-1', now); + + const item = await queue.get('run-1'); + expect(item).toBeNull(); + }); + + it('cancel removes item from queue', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.cancel('run-1', now, 'User cancelled'); + + const item = await queue.get('run-1'); + expect(item).toBeNull(); + }); + + it('markRunning throws for non-existent item', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await expect(queue.markRunning('non-existent', 'owner-1', now)).rejects.toThrow( + 'Queue item "non-existent" not found', + ); + }); + + it('markPaused throws for non-existent item', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await expect(queue.markPaused('non-existent', 'owner-1', now)).rejects.toThrow( + 'Queue item "non-existent" not found', + ); + }); + }); + + describe('Lease heartbeat', () => { + it('renews leases for running and paused items owned by ownerId', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + const t1 = t0 + 1_234; + + await queue.enqueue({ id: 'run-running', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-paused', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-other', flowId: 'flow-1', priority: 1 }); + + await queue.markRunning('run-running', 'owner-1', t0); + await queue.markPaused('run-paused', 'owner-1', t0); + await queue.markRunning('run-other', 'owner-2', t0); + + const otherBefore = await queue.get('run-other'); + const otherExpiresAtBefore = otherBefore!.lease!.expiresAt; + + await queue.heartbeat('owner-1', t1); + + const running = await queue.get('run-running'); + const paused = await queue.get('run-paused'); + const otherAfter = await queue.get('run-other'); + + // Owner-1's items should have renewed leases + expect(running!.lease!.expiresAt).toBe(t1 + DEFAULT_QUEUE_CONFIG.leaseTtlMs); + expect(paused!.lease!.expiresAt).toBe(t1 + DEFAULT_QUEUE_CONFIG.leaseTtlMs); + // Owner-2's item should be unchanged + expect(otherAfter!.lease!.expiresAt).toBe(otherExpiresAtBefore); + }); + + it('is a no-op when the owner has no leased items', async () => { + const queue = createQueueStore(); + await expect(queue.heartbeat('owner-1', 1_700_000_000_000)).resolves.toBeUndefined(); + }); + + it('throws on invalid ownerId', async () => { + const queue = createQueueStore(); + await expect(queue.heartbeat('', Date.now())).rejects.toThrow('ownerId is required'); + }); + + it('throws on invalid now timestamp', async () => { + const queue = createQueueStore(); + await expect(queue.heartbeat('owner-1', NaN)).rejects.toThrow('Invalid now'); + }); + }); + + describe('Lease reclamation', () => { + it('requeues an expired running item and clears the lease', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.markRunning('run-1', 'owner-1', t0); + + const expiresAt = t0 + DEFAULT_QUEUE_CONFIG.leaseTtlMs; + + // Not expired when expiresAt === now (expiry is strictly < now) + expect(await queue.reclaimExpiredLeases(expiresAt)).toEqual([]); + + // Expired when expiresAt < now + expect(await queue.reclaimExpiredLeases(expiresAt + 1)).toEqual(['run-1']); + + const item = await queue.get('run-1'); + expect(item).toMatchObject({ id: 'run-1', status: 'queued', attempt: 1 }); + expect(item!.lease).toBeUndefined(); + }); + + it('requeues an expired paused item and keeps attempt count', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 1 }); + // markPaused doesn't increment attempt (only markRunning/claimNext does) + await queue.markPaused('run-2', 'owner-1', t0); + + const expiresAt = t0 + DEFAULT_QUEUE_CONFIG.leaseTtlMs; + + expect(await queue.reclaimExpiredLeases(expiresAt + 1)).toEqual(['run-2']); + + const item = await queue.get('run-2'); + expect(item).toMatchObject({ id: 'run-2', status: 'queued', attempt: 0 }); + expect(item!.lease).toBeUndefined(); + }); + + it('reclaims multiple expired items in one call', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-2', flowId: 'flow-1', priority: 1 }); + await queue.enqueue({ id: 'run-3', flowId: 'flow-1', priority: 1 }); + + await queue.markRunning('run-1', 'owner-1', t0); + await queue.markPaused('run-2', 'owner-1', t0); + // run-3 stays queued (no lease) + + const expiresAt = t0 + DEFAULT_QUEUE_CONFIG.leaseTtlMs; + const reclaimed = await queue.reclaimExpiredLeases(expiresAt + 1); + + expect(reclaimed.sort()).toEqual(['run-1', 'run-2']); + + // All should be back to queued + const run1 = await queue.get('run-1'); + const run2 = await queue.get('run-2'); + const run3 = await queue.get('run-3'); + + expect(run1!.status).toBe('queued'); + expect(run2!.status).toBe('queued'); + expect(run3!.status).toBe('queued'); + }); + + it('returns empty array when no items are expired', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + await queue.markRunning('run-1', 'owner-1', now); + + // Check before expiration + const reclaimed = await queue.reclaimExpiredLeases(now); + expect(reclaimed).toEqual([]); + }); + + it('throws on invalid now timestamp', async () => { + const queue = createQueueStore(); + await expect(queue.reclaimExpiredLeases(NaN)).rejects.toThrow('Invalid now'); + }); + + it('reclaimed item can be claimed again with incremented attempt', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-1', flowId: 'flow-1', priority: 1 }); + + // First claim: attempt becomes 1 + const claim1 = await queue.claimNext('owner-1', t0); + expect(claim1!.attempt).toBe(1); + + // Simulate lease expiration and reclaim + const expiresAt = t0 + DEFAULT_QUEUE_CONFIG.leaseTtlMs; + await queue.reclaimExpiredLeases(expiresAt + 1); + + // Verify item is back to queued with attempt preserved + const afterReclaim = await queue.get('run-1'); + expect(afterReclaim!.status).toBe('queued'); + expect(afterReclaim!.attempt).toBe(1); + + // Second claim: attempt becomes 2 + const claim2 = await queue.claimNext('owner-2', expiresAt + 100); + expect(claim2!.id).toBe('run-1'); + expect(claim2!.attempt).toBe(2); + }); + }); + + describe('Priority ordering edge cases', () => { + it('handles negative priorities', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'neg', flowId: 'flow-1', priority: -5 }); + await queue.enqueue({ id: 'zero', flowId: 'flow-1', priority: 0 }); + await queue.enqueue({ id: 'pos', flowId: 'flow-1', priority: 5 }); + + const claim1 = await queue.claimNext('owner-1', now); + expect(claim1!.id).toBe('pos'); // Highest priority first + + const claim2 = await queue.claimNext('owner-1', now); + expect(claim2!.id).toBe('zero'); + + const claim3 = await queue.claimNext('owner-1', now); + expect(claim3!.id).toBe('neg'); + }); + + it('handles large priority values', async () => { + const queue = createQueueStore(); + const now = Date.now(); + + await queue.enqueue({ id: 'max', flowId: 'flow-1', priority: Number.MAX_SAFE_INTEGER }); + await queue.enqueue({ id: 'min', flowId: 'flow-1', priority: Number.MIN_SAFE_INTEGER }); + await queue.enqueue({ id: 'mid', flowId: 'flow-1', priority: 0 }); + + const claim1 = await queue.claimNext('owner-1', now); + expect(claim1!.id).toBe('max'); + + const claim2 = await queue.claimNext('owner-1', now); + expect(claim2!.id).toBe('mid'); + + const claim3 = await queue.claimNext('owner-1', now); + expect(claim3!.id).toBe('min'); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/recovery.test.ts b/app/chrome-extension/tests/record-replay-v3/recovery.test.ts new file mode 100644 index 00000000..fa4131f0 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/recovery.test.ts @@ -0,0 +1,425 @@ +/** + * @fileoverview 崩溃恢复测试 (P3-06) + * @description + * Tests for: + * - recoverOrphanLeases (queue-level) + * - RecoveryCoordinator (orchestration) + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { + RunRecordV3, + RunEvent, +} from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { StoragePort } from '@/entrypoints/background/record-replay-v3/engine/storage/storage-port'; +import type { EventsBus } from '@/entrypoints/background/record-replay-v3/engine/transport/events-bus'; +import type { RunQueueItem } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { DEFAULT_QUEUE_CONFIG } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { + createQueueStore, + closeRrV3Db, + deleteRrV3Db, +} from '@/entrypoints/background/record-replay-v3'; +import { recoverFromCrash } from '@/entrypoints/background/record-replay-v3/engine/recovery/recovery-coordinator'; + +// ==================== Queue-level Tests ==================== + +describe('recoverOrphanLeases', () => { + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + }); + + it('requeues orphan running items and adopts orphan paused items', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + const t1 = t0 + 1234; + + await queue.enqueue({ id: 'run-running' as any, flowId: 'flow-1' as any, priority: 1 }); + await queue.enqueue({ id: 'run-paused' as any, flowId: 'flow-1' as any, priority: 1 }); + + await queue.markRunning('run-running' as any, 'old-owner', t0); + await queue.markPaused('run-paused' as any, 'old-owner', t0); + + const recovered = await queue.recoverOrphanLeases('new-owner', t1); + + expect(recovered).toEqual({ + requeuedRunning: [{ runId: 'run-running', prevOwnerId: 'old-owner' }], + adoptedPaused: [{ runId: 'run-paused', prevOwnerId: 'old-owner' }], + }); + + const runningAfter = await queue.get('run-running' as any); + expect(runningAfter).toMatchObject({ id: 'run-running', status: 'queued', attempt: 1 }); + expect(runningAfter!.lease).toBeUndefined(); + + const pausedAfter = await queue.get('run-paused' as any); + expect(pausedAfter).toMatchObject({ + id: 'run-paused', + status: 'paused', + attempt: 0, + lease: { ownerId: 'new-owner' }, + }); + expect(pausedAfter!.lease!.expiresAt).toBe(t1 + DEFAULT_QUEUE_CONFIG.leaseTtlMs); + }); + + it('skips items already owned by the current ownerId', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-running' as any, flowId: 'flow-1' as any, priority: 1 }); + await queue.enqueue({ id: 'run-paused' as any, flowId: 'flow-1' as any, priority: 1 }); + + await queue.markRunning('run-running' as any, 'owner-1', t0); + await queue.markPaused('run-paused' as any, 'owner-1', t0); + + const recovered = await queue.recoverOrphanLeases('owner-1', t0 + 1); + expect(recovered).toEqual({ requeuedRunning: [], adoptedPaused: [] }); + + const runningAfter = await queue.get('run-running' as any); + expect(runningAfter).toMatchObject({ + id: 'run-running', + status: 'running', + lease: { ownerId: 'owner-1' }, + }); + + const pausedAfter = await queue.get('run-paused' as any); + expect(pausedAfter).toMatchObject({ + id: 'run-paused', + status: 'paused', + lease: { ownerId: 'owner-1' }, + }); + }); + + it('handles items without lease (defensive)', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + // Enqueue and claim, but the item will have lease + await queue.enqueue({ id: 'run-1' as any, flowId: 'flow-1' as any }); + + // Directly mark as running (with lease) + await queue.markRunning('run-1' as any, 'old-owner', t0); + + // Recover with new owner + const recovered = await queue.recoverOrphanLeases('new-owner', t0 + 1); + expect(recovered.requeuedRunning).toHaveLength(1); + expect(recovered.requeuedRunning[0].runId).toBe('run-1'); + }); + + it('preserves attempt count during recovery', async () => { + const queue = createQueueStore(); + const t0 = 1_700_000_000_000; + + await queue.enqueue({ id: 'run-1' as any, flowId: 'flow-1' as any }); + + // Simulate multiple claim cycles + await queue.claimNext('owner-1', t0); // attempt becomes 1 + // Simulate crash by recovering with new owner + await queue.recoverOrphanLeases('owner-2', t0 + 1); + + const item = await queue.get('run-1' as any); + expect(item?.status).toBe('queued'); + expect(item?.attempt).toBe(1); // Preserved, not reset + + // Next claim will increment + const claimed = await queue.claimNext('owner-2', t0 + 2); + expect(claimed?.attempt).toBe(2); + }); + + it('rejects empty ownerId', async () => { + const queue = createQueueStore(); + await expect(queue.recoverOrphanLeases('', Date.now())).rejects.toThrow('ownerId is required'); + }); + + it('rejects invalid now', async () => { + const queue = createQueueStore(); + await expect(queue.recoverOrphanLeases('owner', NaN)).rejects.toThrow('Invalid now'); + await expect(queue.recoverOrphanLeases('owner', Infinity)).rejects.toThrow('Invalid now'); + }); +}); + +// ==================== RecoveryCoordinator Tests ==================== + +describe('RecoveryCoordinator', () => { + function createMockStorage(): StoragePort & { + _queueMap: Map; + _runsMap: Map; + } { + const queueMap = new Map(); + const runsMap = new Map(); + + const queue = { + list: vi.fn(async () => Array.from(queueMap.values())), + get: vi.fn(async (runId: string) => queueMap.get(runId) ?? null), + markDone: vi.fn(async (runId: string) => { + queueMap.delete(runId); + }), + recoverOrphanLeases: vi.fn(async (ownerId: string, now: number) => { + const requeuedRunning: Array<{ runId: string; prevOwnerId?: string }> = []; + const adoptedPaused: Array<{ runId: string; prevOwnerId?: string }> = []; + + for (const [runId, item] of queueMap) { + if (item.status === 'running') { + const isOrphan = !item.lease || item.lease.ownerId !== ownerId; + if (isOrphan) { + const prevOwnerId = item.lease?.ownerId; + item.status = 'queued'; + item.updatedAt = now; + delete (item as any).lease; + requeuedRunning.push({ runId, ...(prevOwnerId ? { prevOwnerId } : {}) }); + } + } else if (item.status === 'paused') { + const isOrphan = !item.lease || item.lease.ownerId !== ownerId; + if (isOrphan) { + const prevOwnerId = item.lease?.ownerId; + item.updatedAt = now; + item.lease = { ownerId, expiresAt: now + 15_000 }; + adoptedPaused.push({ runId, ...(prevOwnerId ? { prevOwnerId } : {}) }); + } + } + } + + return { requeuedRunning, adoptedPaused }; + }), + }; + + const runs = { + get: vi.fn(async (id: string) => runsMap.get(id) ?? null), + patch: vi.fn(async (id: string, patch: Partial) => { + const existing = runsMap.get(id); + if (existing) { + runsMap.set(id, { ...existing, ...patch }); + } + }), + }; + + return { + flows: {} as any, + runs: runs as any, + events: {} as any, + queue: queue as any, + persistentVars: {} as any, + triggers: {} as any, + _queueMap: queueMap, + _runsMap: runsMap, + }; + } + + function createMockEventsBus(): EventsBus & { _events: RunEvent[] } { + const events: RunEvent[] = []; + return { + subscribe: vi.fn(() => () => {}), + append: vi.fn(async (event: any) => { + const fullEvent = { ...event, ts: event.ts ?? Date.now(), seq: events.length + 1 }; + events.push(fullEvent); + return fullEvent; + }), + list: vi.fn(async () => []), + _events: events, + } as EventsBus & { _events: RunEvent[] }; + } + + function createRunRecord(id: string, status: string): RunRecordV3 { + return { + schemaVersion: 3, + id: id as any, + flowId: 'flow-1' as any, + status: status as any, + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 1, + maxAttempts: 3, + nextSeq: 0, + }; + } + + function createQueueItem(id: string, status: string, ownerId?: string): RunQueueItem { + return { + id: id as any, + flowId: 'flow-1' as any, + status: status as any, + createdAt: Date.now(), + updatedAt: Date.now(), + priority: 0, + attempt: 1, + maxAttempts: 3, + lease: ownerId ? { ownerId, expiresAt: Date.now() + 15_000 } : undefined, + }; + } + + it('requeues orphan running and emits run.recovered event', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + const fixedNow = 1_700_000_000_000; + + // Setup: running item with old owner + storage._queueMap.set('run-1', createQueueItem('run-1', 'running', 'old-owner')); + storage._runsMap.set('run-1', createRunRecord('run-1', 'running')); + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'new-owner', + now: () => fixedNow, + }); + + expect(result.requeuedRunning).toEqual(['run-1']); + expect(result.adoptedPaused).toEqual([]); + expect(result.cleanedTerminal).toEqual([]); + + // Check RunRecord was patched + expect(storage.runs.patch).toHaveBeenCalledWith('run-1', { + status: 'queued', + updatedAt: fixedNow, + }); + + // Check event was emitted + expect(events._events).toHaveLength(1); + expect(events._events[0]).toMatchObject({ + runId: 'run-1', + type: 'run.recovered', + reason: 'sw_restart', + fromStatus: 'running', + toStatus: 'queued', + prevOwnerId: 'old-owner', + }); + }); + + it('adopts orphan paused without emitting event', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + const fixedNow = 1_700_000_000_000; + + // Setup: paused item with old owner + storage._queueMap.set('run-1', createQueueItem('run-1', 'paused', 'old-owner')); + storage._runsMap.set('run-1', createRunRecord('run-1', 'paused')); + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'new-owner', + now: () => fixedNow, + }); + + expect(result.requeuedRunning).toEqual([]); + expect(result.adoptedPaused).toEqual(['run-1']); + expect(result.cleanedTerminal).toEqual([]); + + // No event for adopted paused (they stay paused) + expect(events._events).toHaveLength(0); + }); + + it('cleans terminal runs from queue', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + + // Setup: terminal run still in queue (crash between runner finish and scheduler markDone) + storage._queueMap.set('run-1', createQueueItem('run-1', 'running', 'old-owner')); + storage._runsMap.set('run-1', createRunRecord('run-1', 'succeeded')); + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'new-owner', + now: () => Date.now(), + }); + + expect(result.cleanedTerminal).toEqual(['run-1']); + expect(storage.queue.markDone).toHaveBeenCalledWith('run-1', expect.any(Number)); + }); + + it('cleans queue items without RunRecord', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + + // Setup: queue item without RunRecord (orphan) + storage._queueMap.set('run-orphan', createQueueItem('run-orphan', 'queued')); + // Note: no corresponding RunRecord + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'new-owner', + now: () => Date.now(), + }); + + expect(result.cleanedTerminal).toEqual(['run-orphan']); + }); + + it('skips items already owned by current ownerId', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + + // Setup: running item with current owner + storage._queueMap.set('run-1', createQueueItem('run-1', 'running', 'current-owner')); + storage._runsMap.set('run-1', createRunRecord('run-1', 'running')); + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'current-owner', + now: () => Date.now(), + }); + + expect(result.requeuedRunning).toEqual([]); + expect(result.adoptedPaused).toEqual([]); + expect(result.cleanedTerminal).toEqual([]); + expect(events._events).toHaveLength(0); + }); + + it('handles mixed recovery scenario', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + const fixedNow = 1_700_000_000_000; + + // Setup: various scenarios + storage._queueMap.set( + 'run-running-orphan', + createQueueItem('run-running-orphan', 'running', 'old-owner'), + ); + storage._runsMap.set('run-running-orphan', createRunRecord('run-running-orphan', 'running')); + + storage._queueMap.set( + 'run-paused-orphan', + createQueueItem('run-paused-orphan', 'paused', 'old-owner'), + ); + storage._runsMap.set('run-paused-orphan', createRunRecord('run-paused-orphan', 'paused')); + + storage._queueMap.set('run-terminal', createQueueItem('run-terminal', 'running', 'old-owner')); + storage._runsMap.set('run-terminal', createRunRecord('run-terminal', 'failed')); + + storage._queueMap.set( + 'run-current-owner', + createQueueItem('run-current-owner', 'running', 'new-owner'), + ); + storage._runsMap.set('run-current-owner', createRunRecord('run-current-owner', 'running')); + + const result = await recoverFromCrash({ + storage, + events, + ownerId: 'new-owner', + now: () => fixedNow, + }); + + expect(result.cleanedTerminal).toContain('run-terminal'); + expect(result.requeuedRunning).toContain('run-running-orphan'); + expect(result.adoptedPaused).toContain('run-paused-orphan'); + // Current owner items are not affected + expect(result.requeuedRunning).not.toContain('run-current-owner'); + }); + + it('throws if ownerId is empty', async () => { + const storage = createMockStorage(); + const events = createMockEventsBus(); + + await expect( + recoverFromCrash({ + storage, + events, + ownerId: '', + now: () => Date.now(), + }), + ).rejects.toThrow('ownerId is required'); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/rpc-api.test.ts b/app/chrome-extension/tests/record-replay-v3/rpc-api.test.ts new file mode 100644 index 00000000..3e263903 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/rpc-api.test.ts @@ -0,0 +1,1190 @@ +/* eslint-disable @typescript-eslint/no-unsafe-function-type */ +/** + * @fileoverview Record-Replay V3 RPC API Tests + * @description + * Tests for the queue management RPC APIs: + * - rr_v3.enqueueRun + * - rr_v3.listQueue + * - rr_v3.cancelQueueItem + * + * Tests for Flow CRUD RPC APIs: + * - rr_v3.saveFlow + * - rr_v3.deleteFlow + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3/domain/flow'; +import type { RunRecordV3 } from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { StoragePort } from '@/entrypoints/background/record-replay-v3/engine/storage/storage-port'; +import type { EventsBus } from '@/entrypoints/background/record-replay-v3/engine/transport/events-bus'; +import type { RunScheduler } from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; +import type { RunQueueItem } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { RpcServer } from '@/entrypoints/background/record-replay-v3/engine/transport/rpc-server'; + +// ==================== Test Utilities ==================== + +function createMockStorage(): StoragePort { + const flowsMap = new Map(); + const runsMap = new Map(); + const queueMap = new Map(); + const eventsLog: Array<{ runId: string; type: string }> = []; + + return { + flows: { + list: vi.fn(async () => Array.from(flowsMap.values())), + get: vi.fn(async (id: string) => flowsMap.get(id) ?? null), + save: vi.fn(async (flow: FlowV3) => { + flowsMap.set(flow.id, flow); + }), + delete: vi.fn(async (id: string) => { + flowsMap.delete(id); + }), + }, + runs: { + list: vi.fn(async () => Array.from(runsMap.values())), + get: vi.fn(async (id: string) => runsMap.get(id) ?? null), + save: vi.fn(async (record: RunRecordV3) => { + runsMap.set(record.id, record); + }), + patch: vi.fn(async (id: string, patch: Partial) => { + const existing = runsMap.get(id); + if (existing) { + runsMap.set(id, { ...existing, ...patch }); + } + }), + }, + events: { + append: vi.fn(async (event: { runId: string; type: string }) => { + eventsLog.push(event); + return { ...event, ts: Date.now(), seq: eventsLog.length }; + }), + list: vi.fn(async () => eventsLog), + }, + queue: { + enqueue: vi.fn(async (input) => { + const now = Date.now(); + const item: RunQueueItem = { + ...input, + priority: input.priority ?? 0, + maxAttempts: input.maxAttempts ?? 1, + status: 'queued', + createdAt: now, + updatedAt: now, + attempt: 0, + }; + queueMap.set(input.id, item); + return item; + }), + claimNext: vi.fn(async () => null), + heartbeat: vi.fn(async () => {}), + reclaimExpiredLeases: vi.fn(async () => []), + markRunning: vi.fn(async () => {}), + markPaused: vi.fn(async () => {}), + markDone: vi.fn(async () => {}), + cancel: vi.fn(async (runId: string) => { + queueMap.delete(runId); + }), + get: vi.fn(async (runId: string) => queueMap.get(runId) ?? null), + list: vi.fn(async (status?: string) => { + const items = Array.from(queueMap.values()); + if (status) { + return items.filter((item) => item.status === status); + } + return items; + }), + }, + persistentVars: { + get: vi.fn(async () => undefined), + set: vi.fn(async () => ({ key: '', value: null, updatedAt: 0 })), + delete: vi.fn(async () => {}), + list: vi.fn(async () => []), + }, + triggers: { + list: vi.fn(async () => []), + get: vi.fn(async () => null), + save: vi.fn(async () => {}), + delete: vi.fn(async () => {}), + }, + // Expose internal maps for assertions + _internal: { flowsMap, runsMap, queueMap, eventsLog }, + } as unknown as StoragePort & { + _internal: { + flowsMap: Map; + runsMap: Map; + queueMap: Map; + eventsLog: Array<{ runId: string; type: string }>; + }; + }; +} + +function createMockEventsBus(): EventsBus { + const subscribers: Array<(event: unknown) => void> = []; + return { + subscribe: vi.fn((callback: (event: unknown) => void) => { + subscribers.push(callback); + return () => { + const idx = subscribers.indexOf(callback); + if (idx >= 0) subscribers.splice(idx, 1); + }; + }), + append: vi.fn(async (event) => { + const fullEvent = { ...event, ts: Date.now(), seq: 1 }; + subscribers.forEach((cb) => cb(fullEvent)); + return fullEvent as ReturnType extends Promise ? T : never; + }), + list: vi.fn(async () => []), + } as EventsBus; +} + +function createMockScheduler(): RunScheduler { + return { + start: vi.fn(), + stop: vi.fn(), + kick: vi.fn(async () => {}), + getState: vi.fn(() => ({ + started: false, + ownerId: 'test-owner', + maxParallelRuns: 3, + activeRunIds: [], + })), + dispose: vi.fn(), + }; +} + +function createTestFlow(id: string, options: { withNodes?: boolean } = {}): FlowV3 { + const now = new Date().toISOString(); + const nodes = + options.withNodes !== false + ? [ + { id: 'node-start', kind: 'test', config: {} }, + { id: 'node-end', kind: 'test', config: {} }, + ] + : []; + return { + schemaVersion: 3, + id: id as FlowV3['id'], + name: `Test Flow ${id}`, + entryNodeId: 'node-start' as FlowV3['entryNodeId'], + nodes: nodes as FlowV3['nodes'], + edges: [{ id: 'edge-1', from: 'node-start', to: 'node-end' }] as FlowV3['edges'], + variables: [], + createdAt: now, + updatedAt: now, + }; +} + +// Helper type for accessing internal maps in mock storage +interface MockStorageInternal { + flowsMap: Map; + runsMap: Map; + queueMap: Map; + eventsLog: Array<{ runId: string; type: string }>; +} + +// Access _internal property with type safety +function getInternal(storage: StoragePort): MockStorageInternal { + return (storage as unknown as { _internal: MockStorageInternal })._internal; +} + +// ==================== Tests ==================== + +describe('V3 RPC Queue Management APIs', () => { + let storage: ReturnType; + let events: EventsBus; + let scheduler: RunScheduler; + let server: RpcServer; + let runIdCounter: number; + let fixedNow: number; + + beforeEach(() => { + storage = createMockStorage(); + events = createMockEventsBus(); + scheduler = createMockScheduler(); + runIdCounter = 0; + fixedNow = 1_700_000_000_000; + + server = new RpcServer({ + storage, + events, + scheduler, + generateRunId: () => `run-${++runIdCounter}`, + now: () => fixedNow, + }); + }); + + describe('rr_v3.enqueueRun', () => { + it('creates run record, enqueues, emits event, and kicks scheduler', async () => { + // Setup: add a flow + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Act: call enqueueRun via handleRequest + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.enqueueRun', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + // Assert: run record created + expect(storage.runs.save).toHaveBeenCalledTimes(1); + const savedRun = (storage.runs.save as ReturnType).mock.calls[0][0]; + expect(savedRun).toMatchObject({ + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + attempt: 0, + maxAttempts: 1, + }); + + // Assert: enqueued + expect(storage.queue.enqueue).toHaveBeenCalledTimes(1); + + // Assert: event emitted via EventsBus + expect(events.append).toHaveBeenCalledWith( + expect.objectContaining({ + runId: 'run-1', + type: 'run.queued', + flowId: 'flow-1', + }), + ); + + // Assert: scheduler kicked + expect(scheduler.kick).toHaveBeenCalledTimes(1); + + // Assert: result + expect(result).toMatchObject({ + runId: 'run-1', + position: 1, + }); + }); + + it('throws if flowId is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.enqueueRun', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flowId is required'); + }); + + it('throws if flow does not exist', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.enqueueRun', params: { flowId: 'non-existent' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Flow "non-existent" not found'); + }); + + it('respects custom priority and maxAttempts', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-1', priority: 10, maxAttempts: 3 }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ); + + expect(storage.queue.enqueue).toHaveBeenCalledWith( + expect.objectContaining({ + priority: 10, + maxAttempts: 3, + }), + ); + }); + + it('passes args and debug config', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + const args = { url: 'https://example.com' }; + const debug = { pauseOnStart: true, breakpoints: ['node-1'] }; + + await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-1', args, debug }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ); + + expect(storage.runs.save).toHaveBeenCalledWith( + expect.objectContaining({ + args, + debug, + }), + ); + }); + + it('rejects NaN priority', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-1', priority: NaN }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('priority must be a finite number'); + }); + + it('rejects Infinity maxAttempts', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-1', maxAttempts: Infinity }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('maxAttempts must be a finite number'); + }); + + it('rejects maxAttempts < 1', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-1', maxAttempts: 0 }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('maxAttempts must be >= 1'); + }); + + it('persists startNodeId in RunRecord when provided', async () => { + // Setup: add a flow with multiple nodes + const flow = createTestFlow('flow-start-node'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Act: enqueue with startNodeId + const targetNodeId = flow.nodes[0].id; // Use the first node + await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-start-node', startNodeId: targetNodeId }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ); + + // Assert: RunRecord should have startNodeId + const runsMap = getInternal(storage).runsMap; + expect(runsMap.size).toBe(1); + const runRecord = Array.from(runsMap.values())[0]; + expect(runRecord.startNodeId).toBe(targetNodeId); + }); + + it('throws if startNodeId does not exist in flow', async () => { + // Setup: add a flow + const flow = createTestFlow('flow-invalid-start'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Act & Assert + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.enqueueRun', + params: { flowId: 'flow-invalid-start', startNodeId: 'non-existent-node' }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('startNodeId "non-existent-node" not found in flow'); + }); + }); + + describe('rr_v3.listQueue', () => { + it('returns all queue items sorted by priority DESC and createdAt ASC', async () => { + // Setup: add items with different priorities and times + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + priority: 5, + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + }); + getInternal(storage).queueMap.set('run-2', { + id: 'run-2', + flowId: 'flow-1', + status: 'queued', + priority: 10, + createdAt: 2000, + updatedAt: 2000, + attempt: 0, + maxAttempts: 1, + }); + getInternal(storage).queueMap.set('run-3', { + id: 'run-3', + flowId: 'flow-1', + status: 'queued', + priority: 10, + createdAt: 1500, + updatedAt: 1500, + attempt: 0, + maxAttempts: 1, + }); + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.listQueue', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as RunQueueItem[]; + + // run-3 (priority 10, earlier) > run-2 (priority 10, later) > run-1 (priority 5) + expect(result.map((r) => r.id)).toEqual(['run-3', 'run-2', 'run-1']); + }); + + it('filters by status', async () => { + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + }); + getInternal(storage).queueMap.set('run-2', { + id: 'run-2', + flowId: 'flow-1', + status: 'running', + priority: 0, + createdAt: 2000, + updatedAt: 2000, + attempt: 1, + maxAttempts: 1, + }); + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.listQueue', params: { status: 'queued' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as RunQueueItem[]; + + expect(result).toHaveLength(1); + expect(result[0].id).toBe('run-1'); + }); + + it('rejects invalid status', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.listQueue', params: { status: 'invalid' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('status must be one of: queued, running, paused'); + }); + }); + + describe('rr_v3.cancelQueueItem', () => { + it('cancels queue item, patches run, and emits event', async () => { + // Setup + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + }); + getInternal(storage).runsMap.set('run-1', { + schemaVersion: 3, + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + nextSeq: 0, + }); + + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.cancelQueueItem', params: { runId: 'run-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + // Assert: queue.cancel called + expect(storage.queue.cancel).toHaveBeenCalledWith('run-1', fixedNow, undefined); + + // Assert: run patched + expect(storage.runs.patch).toHaveBeenCalledWith('run-1', { + status: 'canceled', + updatedAt: fixedNow, + finishedAt: fixedNow, + }); + + // Assert: event emitted via EventsBus + expect(events.append).toHaveBeenCalledWith( + expect.objectContaining({ + runId: 'run-1', + type: 'run.canceled', + }), + ); + + // Assert: result + expect(result).toMatchObject({ ok: true, runId: 'run-1' }); + }); + + it('throws if runId is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.cancelQueueItem', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('runId is required'); + }); + + it('throws if queue item does not exist', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.cancelQueueItem', + params: { runId: 'non-existent' }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Queue item "non-existent" not found'); + }); + + it('throws if queue item is not queued', async () => { + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'running', + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 1, + maxAttempts: 1, + }); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.cancelQueueItem', params: { runId: 'run-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Cannot cancel queue item "run-1" with status "running"'); + }); + + it('includes reason in cancel event', async () => { + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + }); + + await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.cancelQueueItem', + params: { runId: 'run-1', reason: 'User requested cancellation' }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ); + + expect(storage.queue.cancel).toHaveBeenCalledWith( + 'run-1', + fixedNow, + 'User requested cancellation', + ); + expect(events.append).toHaveBeenCalledWith( + expect.objectContaining({ + reason: 'User requested cancellation', + }), + ); + }); + }); +}); + +describe('V3 RPC Flow CRUD APIs', () => { + let storage: ReturnType; + let events: EventsBus; + let scheduler: RunScheduler; + let server: RpcServer; + let fixedNow: number; + + beforeEach(() => { + storage = createMockStorage(); + events = createMockEventsBus(); + scheduler = createMockScheduler(); + fixedNow = 1_700_000_000_000; + + server = new RpcServer({ + storage, + events, + scheduler, + now: () => fixedNow, + }); + }); + + describe('rr_v3.saveFlow', () => { + it('saves a new flow with all required fields', async () => { + const flowInput = { + name: 'My New Flow', + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'click', config: { selector: '#btn' } }, + { id: 'node-2', kind: 'delay', config: { ms: 1000 } }, + ], + edges: [{ id: 'e1', from: 'node-1', to: 'node-2' }], + }; + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.saveFlow', params: { flow: flowInput }, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as FlowV3; + + // Assert: flow saved + expect(storage.flows.save).toHaveBeenCalledTimes(1); + + // Assert: returned flow has all fields + expect(result.schemaVersion).toBe(3); + expect(result.id).toMatch(/^flow_\d+_[a-z0-9]+$/); + expect(result.name).toBe('My New Flow'); + expect(result.entryNodeId).toBe('node-1'); + expect(result.nodes).toHaveLength(2); + expect(result.edges).toHaveLength(1); + expect(result.createdAt).toBeDefined(); + expect(result.updatedAt).toBeDefined(); + }); + + it('updates an existing flow', async () => { + // Setup: add existing flow with a past timestamp + const existing = createTestFlow('flow-1'); + const pastDate = new Date(Date.now() - 100000).toISOString(); // 100 seconds ago + existing.createdAt = pastDate; + existing.updatedAt = pastDate; + getInternal(storage).flowsMap.set(existing.id, existing); + + const flowInput = { + id: 'flow-1', + name: 'Updated Flow', + entryNodeId: 'node-start', + nodes: [{ id: 'node-start', kind: 'navigate', config: { url: 'https://example.com' } }], + edges: [], + createdAt: existing.createdAt, // Preserve original createdAt + }; + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.saveFlow', params: { flow: flowInput }, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as FlowV3; + + // Assert: flow updated + expect(result.id).toBe('flow-1'); + expect(result.name).toBe('Updated Flow'); + expect(result.createdAt).toBe(existing.createdAt); + expect(result.updatedAt).not.toBe(existing.updatedAt); + }); + + it('preserves createdAt when updating without providing it', async () => { + // Setup: add existing flow with a past timestamp + const existing = createTestFlow('flow-1'); + const pastDate = new Date(Date.now() - 100000).toISOString(); + existing.createdAt = pastDate; + existing.updatedAt = pastDate; + getInternal(storage).flowsMap.set(existing.id, existing); + + // Update without providing createdAt - should inherit from existing + const flowInput = { + id: 'flow-1', + name: 'Updated Without CreatedAt', + entryNodeId: 'node-start', + nodes: [{ id: 'node-start', kind: 'test', config: {} }], + edges: [], + // Note: createdAt is NOT provided + }; + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.saveFlow', params: { flow: flowInput }, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as FlowV3; + + // Assert: createdAt is inherited from existing flow + expect(result.createdAt).toBe(existing.createdAt); + expect(result.updatedAt).not.toBe(existing.updatedAt); + }); + + it('throws if flow is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.saveFlow', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flow is required'); + }); + + it('throws if name is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flow.name is required'); + }); + + it('throws if entryNodeId is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flow.entryNodeId is required'); + }); + + it('throws if entryNodeId does not exist in nodes', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'non-existent', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Entry node "non-existent" does not exist in flow'); + }); + + it('throws if edge references non-existent source node', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + edges: [{ id: 'e1', from: 'non-existent', to: 'node-1' }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Edge "e1" references non-existent source node "non-existent"'); + }); + + it('throws if edge references non-existent target node', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + edges: [{ id: 'e1', from: 'node-1', to: 'non-existent' }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Edge "e1" references non-existent target node "non-existent"'); + }); + + it('validates node structure', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [{ id: 'node-1' }], // missing kind + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flow.nodes[0].kind is required'); + }); + + it('generates edge ID if not provided', async () => { + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'test', config: {} }, + { id: 'node-2', kind: 'test', config: {} }, + ], + edges: [{ from: 'node-1', to: 'node-2' }], // no id + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + )) as FlowV3; + + expect(result.edges[0].id).toMatch(/^edge_0_[a-z0-9]+$/); + }); + + it('saves flow with optional fields', async () => { + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + description: 'A test flow', + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'test', config: {}, name: 'Start Node', disabled: false }, + ], + edges: [], + // 符合 VariableDefinition 类型：name 必填，description/default/label 可选 + variables: [ + { name: 'url', description: 'Target URL', default: 'https://example.com' }, + ], + // 符合 FlowPolicy 类型 + policy: { runTimeoutMs: 30000, defaultNodePolicy: { onError: { kind: 'stop' } } }, + meta: { tags: ['test', 'demo'] }, + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + )) as FlowV3; + + expect(result.description).toBe('A test flow'); + expect(result.variables).toHaveLength(1); + expect(result.policy).toEqual({ + runTimeoutMs: 30000, + defaultNodePolicy: { onError: { kind: 'stop' } }, + }); + expect(result.meta).toEqual({ tags: ['test', 'demo'] }); + expect(result.nodes[0].name).toBe('Start Node'); + }); + + it('throws if variable is missing name', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + variables: [{ description: 'Missing name field' }], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flow.variables[0].name is required'); + }); + + it('throws if duplicate variable names', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'test', config: {} }], + variables: [ + { name: 'myVar' }, + { name: 'myVar' }, // duplicate + ], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Duplicate variable name: "myVar"'); + }); + + it('throws if duplicate node IDs', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'test', config: {} }, + { id: 'node-1', kind: 'test', config: {} }, // duplicate + ], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Duplicate node ID: "node-1"'); + }); + + it('throws if duplicate edge IDs', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { + method: 'rr_v3.saveFlow', + params: { + flow: { + name: 'Test', + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'test', config: {} }, + { id: 'node-2', kind: 'test', config: {} }, + ], + edges: [ + { id: 'e1', from: 'node-1', to: 'node-2' }, + { id: 'e1', from: 'node-2', to: 'node-1' }, // duplicate + ], + }, + }, + requestId: 'req-1', + }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Duplicate edge ID: "e1"'); + }); + }); + + describe('rr_v3.deleteFlow', () => { + it('deletes an existing flow', async () => { + // Setup: add flow + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + expect(storage.flows.delete).toHaveBeenCalledWith('flow-1'); + expect(result).toEqual({ ok: true, flowId: 'flow-1' }); + }); + + it('throws if flowId is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flowId is required'); + }); + + it('throws if flow does not exist', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'non-existent' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Flow "non-existent" not found'); + }); + + it('throws if flow has linked triggers', async () => { + // Setup: add flow and trigger + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Mock triggers.list to return a trigger linked to this flow + (storage.triggers.list as ReturnType).mockResolvedValue([ + { id: 'trigger-1', kind: 'manual', flowId: 'flow-1', enabled: true }, + ]); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Cannot delete flow "flow-1": it has 1 linked trigger(s): trigger-1'); + }); + + it('throws if flow has multiple linked triggers', async () => { + // Setup + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + (storage.triggers.list as ReturnType).mockResolvedValue([ + { id: 'trigger-1', kind: 'manual', flowId: 'flow-1', enabled: true }, + { id: 'trigger-2', kind: 'cron', flowId: 'flow-1', enabled: true, cron: '0 * * * *' }, + ]); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow( + 'Cannot delete flow "flow-1": it has 2 linked trigger(s): trigger-1, trigger-2', + ); + }); + + it('throws if flow has queued runs', async () => { + // Setup + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Add queued run + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 0, + maxAttempts: 1, + }); + + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('Cannot delete flow "flow-1": it has 1 queued run(s): run-1'); + }); + + it('allows deletion when runs are running (not queued)', async () => { + // Setup + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + // Add running run (not queued) - should NOT block deletion + getInternal(storage).queueMap.set('run-1', { + id: 'run-1', + flowId: 'flow-1', + status: 'running', // running, not queued + priority: 0, + createdAt: 1000, + updatedAt: 1000, + attempt: 1, + maxAttempts: 1, + }); + + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.deleteFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + expect(result).toEqual({ ok: true, flowId: 'flow-1' }); + }); + }); + + describe('rr_v3.getFlow', () => { + it('returns flow by id', async () => { + const flow = createTestFlow('flow-1'); + getInternal(storage).flowsMap.set(flow.id, flow); + + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.getFlow', params: { flowId: 'flow-1' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + expect(result).toEqual(flow); + }); + + it('returns null for non-existent flow', async () => { + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.getFlow', params: { flowId: 'non-existent' }, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + expect(result).toBeNull(); + }); + + it('throws if flowId is missing', async () => { + await expect( + (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.getFlow', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ), + ).rejects.toThrow('flowId is required'); + }); + }); + + describe('rr_v3.listFlows', () => { + it('returns all flows', async () => { + const flow1 = createTestFlow('flow-1'); + const flow2 = createTestFlow('flow-2'); + getInternal(storage).flowsMap.set(flow1.id, flow1); + getInternal(storage).flowsMap.set(flow2.id, flow2); + + const result = (await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.listFlows', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + )) as FlowV3[]; + + expect(result).toHaveLength(2); + expect(result.map((f) => f.id).sort()).toEqual(['flow-1', 'flow-2']); + }); + + it('returns empty array when no flows exist', async () => { + const result = await (server as unknown as { handleRequest: Function }).handleRequest( + { method: 'rr_v3.listFlows', params: {}, requestId: 'req-1' }, + { subscriptions: new Set() }, + ); + + expect(result).toEqual([]); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/runner.onError.contract.test.ts b/app/chrome-extension/tests/record-replay-v3/runner.onError.contract.test.ts new file mode 100644 index 00000000..54486818 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/runner.onError.contract.test.ts @@ -0,0 +1,463 @@ +/** + * @fileoverview Record-Replay V3 RunRunner onError Contracts + * @description Verifies RunRunner onError behavior via event stream + final Run status. + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; +import { z } from 'zod'; + +import type { + EdgeV3, + FlowV3, + NodeV3, + RunEvent, + RunRecordV3, + RunRunner, + NodeDefinition, + NodeExecutionResult, +} from '@/entrypoints/background/record-replay-v3'; + +import { + EDGE_LABELS, + FLOW_SCHEMA_VERSION, + InMemoryEventsBus, + PluginRegistry, + RR_ERROR_CODES, + createNotImplementedStoragePort, + createRRError, + createRunRunnerFactory, + resetBreakpointRegistry, +} from '@/entrypoints/background/record-replay-v3'; + +import type { + RunId, + PersistentVarRecord, + PersistentVarsStore, + RunsStore, +} from '@/entrypoints/background/record-replay-v3'; + +// ==================== Test Helpers ==================== + +type TestNodeConfig = { + action: 'succeed' | 'fail' | 'flaky'; + failTimes?: number; + errorCode?: string; +}; + +/** + * Create a test node definition that can succeed, fail, or be flaky + */ +function createTestNodeDefinition( + callsByNodeId: Map, +): NodeDefinition<'test', TestNodeConfig> { + return { + kind: 'test', + schema: z + .object({ + action: z.enum(['succeed', 'fail', 'flaky']), + failTimes: z.number().int().min(0).optional(), + errorCode: z.string().optional(), + }) + .passthrough(), + execute: async (ctx, node): Promise => { + const prev = callsByNodeId.get(ctx.nodeId) ?? 0; + const cur = prev + 1; + callsByNodeId.set(ctx.nodeId, cur); + + const cfg = node.config as unknown as TestNodeConfig; + const error = createRRError( + (cfg.errorCode ?? RR_ERROR_CODES.TOOL_ERROR) as typeof RR_ERROR_CODES.TOOL_ERROR, + `test failure (${ctx.nodeId})`, + ); + + if (cfg.action === 'succeed') return { status: 'succeeded' }; + if (cfg.action === 'fail') return { status: 'failed', error }; + + // flaky: fail for the first `failTimes` calls + const failTimes = Math.max(0, cfg.failTimes ?? 0); + if (cur <= failTimes) return { status: 'failed', error }; + return { status: 'succeeded' }; + }, + }; +} + +/** + * Create a test flow + */ +function createFlow(entryNodeId: string, nodes: NodeV3[], edges: EdgeV3[]): FlowV3 { + const iso = new Date(0).toISOString(); + return { + schemaVersion: FLOW_SCHEMA_VERSION, + id: 'flow-onerror', + name: 'onError contract flow', + createdAt: iso, + updatedAt: iso, + entryNodeId, + nodes, + edges, + }; +} + +/** + * Create an in-memory RunsStore for testing + */ +function createInMemoryRunsStore(): { store: RunsStore; byId: Map } { + const byId = new Map(); + const store: RunsStore = { + list: async () => Array.from(byId.values()), + get: async (id) => byId.get(id) ?? null, + save: async (record) => { + byId.set(record.id, record); + }, + patch: async (id, patch) => { + const existing = byId.get(id); + if (!existing) { + throw createRRError(RR_ERROR_CODES.INTERNAL, `Run "${id}" not found`); + } + byId.set(id, { + ...existing, + ...patch, + id: existing.id, + schemaVersion: existing.schemaVersion, + updatedAt: Date.now(), + }); + }, + }; + return { store, byId }; +} + +/** + * Create an in-memory PersistentVarsStore for testing + */ +function createInMemoryPersistentVarsStore(): PersistentVarsStore { + const byKey = new Map(); + return { + get: async (key) => byKey.get(key as string) as PersistentVarRecord | undefined, + set: async (key, value) => { + const prev = byKey.get(key as string); + const record: PersistentVarRecord = { + key, + value, + updatedAt: Date.now(), + version: (prev?.version ?? 0) + 1, + }; + byKey.set(key as string, record); + return record; + }, + delete: async (key) => { + byKey.delete(key as string); + }, + list: async (prefix) => { + const all = Array.from(byKey.values()); + if (!prefix) return all; + return all.filter((r) => r.key.startsWith(prefix)); + }, + }; +} + +/** + * Extract node IDs from node.started events + */ +function startedNodeIds(events: RunEvent[]): string[] { + return events + .filter((e) => e.type === 'node.started') + .map((e) => (e as Extract).nodeId); +} + +/** + * Extract node.failed events for a specific node + */ +function nodeFailedEvents( + events: RunEvent[], + nodeId: string, +): Array> { + return events.filter( + (e): e is Extract => + e.type === 'node.failed' && e.nodeId === nodeId, + ); +} + +/** + * List events from InMemoryEventsBus + */ +async function listEvents(bus: InMemoryEventsBus, runId: RunId): Promise { + return bus.list({ runId }); +} + +/** + * Create a complete runner context for testing + */ +function createRunnerContext( + runId: RunId, + flow: FlowV3, +): { + runner: RunRunner; + bus: InMemoryEventsBus; + runsById: Map; + calls: Map; +} { + const calls = new Map(); + const plugins = new PluginRegistry(); + plugins.registerNode(createTestNodeDefinition(calls)); + + const bus = new InMemoryEventsBus(); + const { store: runs, byId: runsById } = createInMemoryRunsStore(); + + const storage = createNotImplementedStoragePort(); + storage.runs = runs; + storage.persistentVars = createInMemoryPersistentVarsStore(); + + const factory = createRunRunnerFactory({ storage, events: bus, plugins }); + const runner = factory.create(runId, { flow, tabId: 1 }); + + return { runner, bus, runsById, calls }; +} + +// ==================== Tests ==================== + +describe('V3 RunRunner onError contracts', () => { + beforeEach(() => { + resetBreakpointRegistry(); + }); + + afterEach(() => { + vi.useRealTimers(); + vi.restoreAllMocks(); + }); + + it('stop: node failure ends run as failed', async () => { + const runId = 'run-stop'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'fail' }, + policy: { onError: { kind: 'stop' } }, + }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + ], + [{ id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('failed'); + expect(runsById.get(runId)?.status).toBe('failed'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('stop'); + expect(startedNodeIds(events)).toEqual(['A']); + }); + + it('continue: node failure continues to next node', async () => { + const runId = 'run-continue'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'fail' }, + policy: { onError: { kind: 'continue' } }, + }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + ], + [{ id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('succeeded'); + expect(runsById.get(runId)?.status).toBe('succeeded'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('continue'); + expect(startedNodeIds(events)).toEqual(['A', 'B']); + }); + + it('goto edgeLabel: node failure jumps to ON_ERROR edge target', async () => { + const runId = 'run-goto-edge'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'fail' }, + policy: { + onError: { kind: 'goto', target: { kind: 'edgeLabel', label: EDGE_LABELS.ON_ERROR } }, + }, + }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + { id: 'C', kind: 'test', config: { action: 'succeed' } }, + ], + [ + { id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }, + { id: 'e2', from: 'A', to: 'C', label: EDGE_LABELS.ON_ERROR }, + ], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('succeeded'); + expect(runsById.get(runId)?.status).toBe('succeeded'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('goto'); + expect(startedNodeIds(events)).toEqual(['A', 'C']); + }); + + it('goto nodeId: node failure jumps to specified node', async () => { + const runId = 'run-goto-node'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'fail' }, + policy: { onError: { kind: 'goto', target: { kind: 'node', nodeId: 'C' } } }, + }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + { id: 'C', kind: 'test', config: { action: 'succeed' } }, + ], + [{ id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('succeeded'); + expect(runsById.get(runId)?.status).toBe('succeeded'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('goto'); + expect(startedNodeIds(events)).toEqual(['A', 'C']); + }); + + it('retry: retries the configured number of times and can succeed', async () => { + const runId = 'run-retry-succeed'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'flaky', failTimes: 2 }, + policy: { onError: { kind: 'retry' }, retry: { retries: 2, intervalMs: 0 } }, + }, + ], + [], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('succeeded'); + expect(runsById.get(runId)?.status).toBe('succeeded'); + + const events = await listEvents(bus, runId); + const started = events.filter((e) => e.type === 'node.started') as Array< + Extract + >; + expect(started.map((e) => e.attempt)).toEqual([1, 2, 3]); + + const failed = nodeFailedEvents(events, 'A'); + expect(failed.map((e) => e.decision)).toEqual(['retry', 'retry']); + }); + + it('retry: uses backoff and fails after retries are exhausted', async () => { + const runId = 'run-retry-fail'; + const flow = createFlow( + 'A', + [ + { + id: 'A', + kind: 'test', + config: { action: 'fail' }, + policy: { + onError: { kind: 'retry' }, + retry: { retries: 2, intervalMs: 100, backoff: 'linear' }, + }, + }, + ], + [], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + + vi.useFakeTimers(); + const setTimeoutSpy = vi.spyOn(globalThis, 'setTimeout'); + + const startPromise = runner.start(); + await vi.runAllTimersAsync(); + const result = await startPromise; + + expect(result.status).toBe('failed'); + expect(runsById.get(runId)?.status).toBe('failed'); + + const delays = setTimeoutSpy.mock.calls + .map((call) => call[1]) + .filter((ms): ms is number => typeof ms === 'number' && ms > 0); + // Linear backoff: 100, 200 + expect(delays).toContain(100); + expect(delays).toContain(200); + + const events = await listEvents(bus, runId); + const started = events.filter((e) => e.type === 'node.started') as Array< + Extract + >; + expect(started.map((e) => e.attempt)).toEqual([1, 2, 3]); + + const failed = nodeFailedEvents(events, 'A'); + expect(failed).toHaveLength(3); + // Last retry should still be 'retry' as that's the decision made before checking max attempts + expect(failed.map((e) => e.decision)).toEqual(['retry', 'retry', 'retry']); + }); + + it('default: without onError policy, uses ON_ERROR edge when present', async () => { + const runId = 'run-default-goto'; + const flow = createFlow( + 'A', + [ + { id: 'A', kind: 'test', config: { action: 'fail' } }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + { id: 'C', kind: 'test', config: { action: 'succeed' } }, + ], + [ + { id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }, + { id: 'e2', from: 'A', to: 'C', label: EDGE_LABELS.ON_ERROR }, + ], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('succeeded'); + expect(runsById.get(runId)?.status).toBe('succeeded'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('goto'); + expect(startedNodeIds(events)).toEqual(['A', 'C']); + }); + + it('default: without onError policy and without ON_ERROR edge, stops', async () => { + const runId = 'run-default-stop'; + const flow = createFlow( + 'A', + [ + { id: 'A', kind: 'test', config: { action: 'fail' } }, + { id: 'B', kind: 'test', config: { action: 'succeed' } }, + ], + [{ id: 'e1', from: 'A', to: 'B', label: EDGE_LABELS.DEFAULT }], + ); + + const { runner, bus, runsById } = createRunnerContext(runId, flow); + const result = await runner.start(); + expect(result.status).toBe('failed'); + expect(runsById.get(runId)?.status).toBe('failed'); + + const events = await listEvents(bus, runId); + expect(nodeFailedEvents(events, 'A')[0].decision).toBe('stop'); + expect(startedNodeIds(events)).toEqual(['A']); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/scheduler-integration.test.ts b/app/chrome-extension/tests/record-replay-v3/scheduler-integration.test.ts new file mode 100644 index 00000000..6016d2cb --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/scheduler-integration.test.ts @@ -0,0 +1,633 @@ +/** + * @fileoverview 并行调度集成测试 (P3-07) + * @description + * End-to-end tests for Scheduler + Queue + LeaseManager + Recovery + * Uses real IndexedDB storage (fake-indexeddb) to verify integration. + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { RunId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import type { RunRecordV3 } from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { RunQueueItem } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { DEFAULT_QUEUE_CONFIG } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { + createLeaseManager, + generateOwnerId, +} from '@/entrypoints/background/record-replay-v3/engine/queue/leasing'; +import { + createRunScheduler, + type RunExecutor, +} from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; +import { InMemoryKeepaliveController } from '@/entrypoints/background/record-replay-v3/engine/keepalive/offscreen-keepalive'; +import { + createQueueStore, + createRunsStore, + closeRrV3Db, + deleteRrV3Db, +} from '@/entrypoints/background/record-replay-v3'; +import { recoverFromCrash } from '@/entrypoints/background/record-replay-v3/engine/recovery/recovery-coordinator'; + +// ==================== Test Utilities ==================== + +function createMockEventsBus() { + const events: unknown[] = []; + return { + subscribe: vi.fn(() => () => {}), + append: vi.fn(async (event: unknown) => { + const fullEvent = { ...(event as object), ts: Date.now(), seq: events.length + 1 }; + events.push(fullEvent); + return fullEvent; + }), + list: vi.fn(async () => []), + _events: events, + }; +} + +function createMockStorage( + queueStore: ReturnType, + runsStore: ReturnType, +) { + return { + flows: {} as any, + runs: runsStore, + events: {} as any, + queue: queueStore, + persistentVars: {} as any, + triggers: {} as any, + }; +} + +function createRunRecord(id: string, status: string): RunRecordV3 { + return { + schemaVersion: 3, + id: id as RunId, + flowId: 'flow-1' as any, + status: status as any, + createdAt: Date.now(), + updatedAt: Date.now(), + attempt: 0, + maxAttempts: 3, + nextSeq: 0, + }; +} + +// ==================== Integration Tests ==================== + +describe('V3 Scheduler Integration', () => { + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + }); + + describe('End-to-end scheduling', () => { + it('scheduler claims from real queue, executes, and marks done', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + const executed: string[] = []; + const executor: RunExecutor = async (item) => { + executed.push(item.id); + // Simulate short execution + await new Promise((resolve) => setTimeout(resolve, 10)); + }; + + // Enqueue items + await queue.enqueue({ id: 'run-1' as any, flowId: 'flow-1' as any, priority: 0 }); + await queue.enqueue({ id: 'run-2' as any, flowId: 'flow-1' as any, priority: 0 }); + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 1 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + // Wait for execution + await new Promise((resolve) => setTimeout(resolve, 100)); + + scheduler.stop(); + + // Both runs should be executed + expect(executed).toContain('run-1'); + expect(executed).toContain('run-2'); + + // Queue should be empty + const remaining = await queue.list(); + expect(remaining).toHaveLength(0); + }); + + it('respects maxParallelRuns with real queue', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + let concurrentCount = 0; + let maxConcurrent = 0; + const executionTimes: Map = new Map(); + + const executor: RunExecutor = async (item) => { + concurrentCount++; + maxConcurrent = Math.max(maxConcurrent, concurrentCount); + executionTimes.set(item.id, { start: Date.now() }); + + await new Promise((resolve) => setTimeout(resolve, 50)); + + executionTimes.get(item.id)!.end = Date.now(); + concurrentCount--; + }; + + // Enqueue 5 items + for (let i = 0; i < 5; i++) { + await queue.enqueue({ id: `run-${i}` as any, flowId: 'flow-1' as any, priority: 0 }); + } + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 2 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 10, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + // Wait for all executions + await new Promise((resolve) => setTimeout(resolve, 500)); + + scheduler.stop(); + + // Max concurrent should not exceed 2 + expect(maxConcurrent).toBeLessThanOrEqual(2); + + // All runs should complete + expect(executionTimes.size).toBe(5); + }); + + it('maintains FIFO within same priority', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + const executionOrder: string[] = []; + const executor: RunExecutor = async (item) => { + executionOrder.push(item.id); + await new Promise((resolve) => setTimeout(resolve, 10)); + }; + + // Enqueue in order with same priority + await queue.enqueue({ id: 'run-1' as any, flowId: 'flow-1' as any, priority: 0 }); + await new Promise((resolve) => setTimeout(resolve, 5)); // Ensure different createdAt + await queue.enqueue({ id: 'run-2' as any, flowId: 'flow-1' as any, priority: 0 }); + await new Promise((resolve) => setTimeout(resolve, 5)); + await queue.enqueue({ id: 'run-3' as any, flowId: 'flow-1' as any, priority: 0 }); + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 1 }, // Serial execution + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + await new Promise((resolve) => setTimeout(resolve, 200)); + + scheduler.stop(); + + // Should execute in FIFO order + expect(executionOrder).toEqual(['run-1', 'run-2', 'run-3']); + }); + + it('higher priority runs first', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + const executionOrder: string[] = []; + const executor: RunExecutor = async (item) => { + executionOrder.push(item.id); + await new Promise((resolve) => setTimeout(resolve, 10)); + }; + + // Enqueue with different priorities (low first) + await queue.enqueue({ id: 'run-low' as any, flowId: 'flow-1' as any, priority: 0 }); + await queue.enqueue({ id: 'run-high' as any, flowId: 'flow-1' as any, priority: 10 }); + await queue.enqueue({ id: 'run-medium' as any, flowId: 'flow-1' as any, priority: 5 }); + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 1 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + await new Promise((resolve) => setTimeout(resolve, 200)); + + scheduler.stop(); + + // Should execute in priority order (high -> medium -> low) + expect(executionOrder).toEqual(['run-high', 'run-medium', 'run-low']); + }); + }); + + describe('Lease management', () => { + it('heartbeat keeps leases alive during long runs', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const config = { + ...DEFAULT_QUEUE_CONFIG, + leaseTtlMs: 100, // Short TTL for testing + heartbeatIntervalMs: 30, // Frequent heartbeat + }; + const leaseManager = createLeaseManager(queue, config); + const ownerId = generateOwnerId(); + + let runningItem: RunQueueItem | null = null; + const executor: RunExecutor = async (item) => { + runningItem = item; + // Run longer than TTL + await new Promise((resolve) => setTimeout(resolve, 200)); + }; + + await queue.enqueue({ id: 'long-run' as any, flowId: 'flow-1' as any }); + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...config, maxParallelRuns: 1 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + // Wait for run to be claimed + await new Promise((resolve) => setTimeout(resolve, 50)); + expect(runningItem).not.toBeNull(); + + // Check that lease is being renewed + const itemMidRun = await queue.get('long-run' as any); + expect(itemMidRun?.status).toBe('running'); + expect(itemMidRun?.lease?.ownerId).toBe(ownerId); + + // Wait for completion + await new Promise((resolve) => setTimeout(resolve, 200)); + + scheduler.stop(); + + // Run should complete successfully + const remaining = await queue.list(); + expect(remaining).toHaveLength(0); + }); + + it('expired leases are reclaimed by periodic scan', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + + // Note: markRunning uses DEFAULT_LEASE_TTL_MS (15s) internally. + // To simulate an expired lease, we pass a past time that makes + // expiresAt (pastTime + 15s) be in the past relative to now. + const pastTime = Date.now() - DEFAULT_QUEUE_CONFIG.leaseTtlMs - 100; // expired 100ms ago + await queue.enqueue({ id: 'orphan-run' as any, flowId: 'flow-1' as any }); + await queue.markRunning('orphan-run' as any, 'dead-owner', pastTime); + + // Verify lease exists and is expired + const expiredItem = await queue.get('orphan-run' as any); + expect(expiredItem?.status).toBe('running'); + expect(expiredItem?.lease?.expiresAt).toBe(pastTime + DEFAULT_QUEUE_CONFIG.leaseTtlMs); + expect(expiredItem?.lease?.expiresAt).toBeLessThan(Date.now()); + + // Manually trigger reclaim to simulate what scheduler does periodically + const reclaimedIds = await leaseManager.reclaimExpiredLeases(Date.now()); + expect(reclaimedIds).toContain('orphan-run'); + + // Now queue item should be back to queued + const reclaimedItem = await queue.get('orphan-run' as any); + expect(reclaimedItem?.status).toBe('queued'); + + // New scheduler should pick it up + const ownerId = generateOwnerId(); + const executed: string[] = []; + const executor: RunExecutor = async (item) => { + executed.push(item.id); + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 1 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + await new Promise((resolve) => setTimeout(resolve, 100)); + + scheduler.stop(); + + // Orphan run should be executed + expect(executed).toContain('orphan-run'); + }); + }); + + describe('Crash recovery simulation', () => { + it('recovers orphan running items after restart', async () => { + const queue = createQueueStore(); + const runsStore = createRunsStore(); + const events = createMockEventsBus(); + + // Simulate crash scenario: run was running when SW died + await queue.enqueue({ id: 'crashed-run' as any, flowId: 'flow-1' as any }); + await queue.markRunning('crashed-run' as any, 'old-sw-owner', Date.now()); + await runsStore.save(createRunRecord('crashed-run', 'running')); + + // Simulate restart with new owner + const newOwnerId = generateOwnerId(); + const storage = createMockStorage(queue, runsStore); + + const result = await recoverFromCrash({ + storage, + events: events as any, + ownerId: newOwnerId, + now: () => Date.now(), + }); + + // Run should be requeued + expect(result.requeuedRunning).toContain('crashed-run'); + + // Queue item should be back to queued + const item = await queue.get('crashed-run' as any); + expect(item?.status).toBe('queued'); + expect(item?.lease).toBeUndefined(); + + // RunRecord should be updated + const run = await runsStore.get('crashed-run' as any); + expect(run?.status).toBe('queued'); + + // Event should be emitted + expect(events._events.some((e: any) => e.type === 'run.recovered')).toBe(true); + }); + + it('adopts orphan paused items after restart', async () => { + const queue = createQueueStore(); + const runsStore = createRunsStore(); + const events = createMockEventsBus(); + + // Simulate crash scenario: run was paused when SW died + await queue.enqueue({ id: 'paused-run' as any, flowId: 'flow-1' as any }); + await queue.markPaused('paused-run' as any, 'old-sw-owner', Date.now()); + await runsStore.save(createRunRecord('paused-run', 'paused')); + + // Simulate restart with new owner + const newOwnerId = generateOwnerId(); + const storage = createMockStorage(queue, runsStore); + + const result = await recoverFromCrash({ + storage, + events: events as any, + ownerId: newOwnerId, + now: () => Date.now(), + }); + + // Run should be adopted (stays paused) + expect(result.adoptedPaused).toContain('paused-run'); + + // Queue item should still be paused with new owner + const item = await queue.get('paused-run' as any); + expect(item?.status).toBe('paused'); + expect(item?.lease?.ownerId).toBe(newOwnerId); + }); + + it('preserves attempt count across recovery', async () => { + const queue = createQueueStore(); + const runsStore = createRunsStore(); + const events = createMockEventsBus(); + + // Simulate a run that has already been attempted + await queue.enqueue({ id: 'retried-run' as any, flowId: 'flow-1' as any }); + await queue.claimNext('old-owner', Date.now()); // attempt becomes 1 + await runsStore.save({ ...createRunRecord('retried-run', 'running'), attempt: 1 }); + + // Simulate restart + const newOwnerId = generateOwnerId(); + const storage = createMockStorage(queue, runsStore); + + await recoverFromCrash({ + storage, + events: events as any, + ownerId: newOwnerId, + now: () => Date.now(), + }); + + // Queue item should preserve attempt count + const item = await queue.get('retried-run' as any); + expect(item?.status).toBe('queued'); + expect(item?.attempt).toBe(1); // Not reset + + // Next claim will increment + const claimed = await queue.claimNext(newOwnerId, Date.now()); + expect(claimed?.attempt).toBe(2); + }); + + it('cleans terminal runs left in queue due to crash', async () => { + const queue = createQueueStore(); + const runsStore = createRunsStore(); + const events = createMockEventsBus(); + + // Simulate crash scenario: run completed but queue item wasn't removed + await queue.enqueue({ id: 'completed-run' as any, flowId: 'flow-1' as any }); + await queue.markRunning('completed-run' as any, 'old-owner', Date.now()); + await runsStore.save(createRunRecord('completed-run', 'succeeded')); + + // Simulate restart + const newOwnerId = generateOwnerId(); + const storage = createMockStorage(queue, runsStore); + + const result = await recoverFromCrash({ + storage, + events: events as any, + ownerId: newOwnerId, + now: () => Date.now(), + }); + + // Run should be cleaned + expect(result.cleanedTerminal).toContain('completed-run'); + + // Queue should be empty + const remaining = await queue.list(); + expect(remaining).toHaveLength(0); + }); + + it('recovery then scheduler works correctly', async () => { + const queue = createQueueStore(); + const runsStore = createRunsStore(); + const events = createMockEventsBus(); + const keepalive = new InMemoryKeepaliveController(); + + // Simulate crash scenario + await queue.enqueue({ id: 'recover-run' as any, flowId: 'flow-1' as any }); + await queue.markRunning('recover-run' as any, 'old-owner', Date.now()); + await runsStore.save(createRunRecord('recover-run', 'running')); + + // Recovery + const newOwnerId = generateOwnerId(); + const storage = createMockStorage(queue, runsStore); + + await recoverFromCrash({ + storage, + events: events as any, + ownerId: newOwnerId, + now: () => Date.now(), + }); + + // Now start scheduler + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const executed: string[] = []; + const executor: RunExecutor = async (item) => { + executed.push(item.id); + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 1 }, + ownerId: newOwnerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + await new Promise((resolve) => setTimeout(resolve, 100)); + scheduler.stop(); + + // Recovered run should be executed + expect(executed).toContain('recover-run'); + }); + }); + + describe('Concurrency', () => { + it('handles multiple concurrent enqueue/claim cycles', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + const executed = new Set(); + const executor: RunExecutor = async (item) => { + executed.add(item.id); + await new Promise((resolve) => setTimeout(resolve, 20)); + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 3 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 10, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + // Concurrent enqueues while scheduler is running + const enqueuePromises = []; + for (let i = 0; i < 10; i++) { + enqueuePromises.push( + queue + .enqueue({ + id: `run-${i}` as any, + flowId: 'flow-1' as any, + priority: Math.random() * 10, + }) + .then(() => scheduler.kick()), + ); + } + + await Promise.all(enqueuePromises); + + // Wait for all to complete + await new Promise((resolve) => setTimeout(resolve, 500)); + + scheduler.stop(); + + // All runs should be executed exactly once + expect(executed.size).toBe(10); + }); + + it('no double execution under concurrent kicks', async () => { + const queue = createQueueStore(); + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(queue, DEFAULT_QUEUE_CONFIG); + const ownerId = generateOwnerId(); + + const executionCounts = new Map(); + const executor: RunExecutor = async (item) => { + executionCounts.set(item.id, (executionCounts.get(item.id) ?? 0) + 1); + await new Promise((resolve) => setTimeout(resolve, 50)); + }; + + // Pre-enqueue + for (let i = 0; i < 5; i++) { + await queue.enqueue({ id: `run-${i}` as any, flowId: 'flow-1' as any }); + } + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive, + config: { ...DEFAULT_QUEUE_CONFIG, maxParallelRuns: 2 }, + ownerId, + execute: executor, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + }); + + scheduler.start(); + + // Hammer with concurrent kicks + const kickPromises = []; + for (let i = 0; i < 20; i++) { + kickPromises.push(scheduler.kick()); + } + await Promise.all(kickPromises); + + // Wait for completion + await new Promise((resolve) => setTimeout(resolve, 500)); + + scheduler.stop(); + + // Each run should execute exactly once + for (const [runId, count] of executionCounts) { + expect(count, `${runId} executed ${count} times`).toBe(1); + } + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/scheduler.test.ts b/app/chrome-extension/tests/record-replay-v3/scheduler.test.ts new file mode 100644 index 00000000..def17ae8 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/scheduler.test.ts @@ -0,0 +1,564 @@ +/** + * @fileoverview Record-Replay V3 Scheduler Unit Tests + * @description + * Verifies maxParallelRuns enforcement and basic orchestration behavior: + * - Never exceeds configured parallelism + * - Automatically backfills when a run completes + * - Reclaim interval is respected + */ + +import { describe, expect, it } from 'vitest'; + +import type { + RunQueueConfig, + RunQueueItem, +} from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import type { LeaseManager } from '@/entrypoints/background/record-replay-v3/engine/queue/leasing'; +import { + createRunScheduler, + type RunExecutor, +} from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; + +// ==================== Test Utilities ==================== + +interface Deferred { + promise: Promise; + resolve: (value: T) => void; + reject: (reason?: unknown) => void; +} + +function createDeferred(): Deferred { + let resolve!: (value: T) => void; + let reject!: (reason?: unknown) => void; + const promise = new Promise((res, rej) => { + resolve = res; + reject = rej; + }); + return { promise, resolve, reject }; +} + +function makeClaimedItem(id: string): RunQueueItem { + return { + id, + flowId: 'flow-1', + status: 'running', + createdAt: 1, + updatedAt: 1, + priority: 0, + attempt: 1, + maxAttempts: 1, + }; +} + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +// Keepalive mocks +type KeepaliveLike = { acquire(tag: string): () => void }; + +const noopKeepalive: KeepaliveLike = { + acquire: () => () => {}, +}; + +function createKeepaliveProbe(): { + keepalive: KeepaliveLike; + acquiredTags: string[]; + releasedCount: () => number; +} { + const acquiredTags: string[] = []; + let released = 0; + + const keepalive: KeepaliveLike = { + acquire: (tag: string) => { + acquiredTags.push(tag); + let done = false; + return () => { + if (done) return; + done = true; + released += 1; + }; + }, + }; + + return { keepalive, acquiredTags, releasedCount: () => released }; +} + +// ==================== Tests ==================== + +describe('V3 RunScheduler', () => { + describe('maxParallelRuns enforcement', () => { + it('enforces maxParallelRuns and backfills when a run finishes', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 2, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const ownerId = 'owner-1'; + const fixedNow = 1_700_000_000_000; + + const items: RunQueueItem[] = [ + makeClaimedItem('run-1'), + makeClaimedItem('run-2'), + makeClaimedItem('run-3'), + ]; + + let claimCalls = 0; + const thirdClaimHappened = createDeferred(); + const doneIds: string[] = []; + + const queue = { + claimNext: async () => { + claimCalls += 1; + if (claimCalls === 3) thirdClaimHappened.resolve(undefined); + return items.shift() ?? null; + }, + markDone: async (runId: string) => { + doneIds.push(runId); + }, + }; + + const started: string[] = []; + const runDeferreds = new Map>(); + const run3Started = createDeferred(); + + const execute: RunExecutor = async (item) => { + started.push(item.id); + const d = createDeferred(); + runDeferreds.set(item.id, d); + if (item.id === 'run-3') run3Started.resolve(undefined); + return d.promise; + }; + + let heartbeatStarted = 0; + let heartbeatStopped = 0; + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => { + heartbeatStarted += 1; + }, + stopHeartbeat: () => { + heartbeatStopped += 1; + }, + reclaimExpiredLeases: async () => [], + }; + + const keepaliveProbe = createKeepaliveProbe(); + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: keepaliveProbe.keepalive, + config, + ownerId, + execute, + now: () => fixedNow, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + + // Verify keepalive was acquired on start + expect(keepaliveProbe.acquiredTags).toEqual(['scheduler']); + + await scheduler.kick(); + + expect(heartbeatStarted).toBe(1); + expect(started).toEqual(['run-1', 'run-2']); + expect(claimCalls).toBe(2); + expect(scheduler.getState().activeRunIds.sort()).toEqual(['run-1', 'run-2']); + + // Complete one run and expect an automatic backfill (run-3) + runDeferreds.get('run-1')!.resolve(undefined); + + await thirdClaimHappened.promise; + await run3Started.promise; + + expect(claimCalls).toBe(3); + expect(started).toEqual(['run-1', 'run-2', 'run-3']); + expect(doneIds).toContain('run-1'); + expect(scheduler.getState().activeRunIds.sort()).toEqual(['run-2', 'run-3']); + + // Drain remaining runs for a clean shutdown + runDeferreds.get('run-2')!.resolve(undefined); + runDeferreds.get('run-3')!.resolve(undefined); + await scheduler.kick(); + + scheduler.stop(); + expect(heartbeatStopped).toBe(1); + + // Verify keepalive was released on stop + expect(keepaliveProbe.releasedCount()).toBe(1); + }); + + it('does not claim when maxParallelRuns is 0', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 0, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + let claimCalls = 0; + const queue = { + claimNext: async () => { + claimCalls += 1; + return null; + }, + markDone: async () => {}, + }; + + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async () => [], + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: noopKeepalive, + config, + ownerId: 'owner-1', + execute: async () => {}, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + await scheduler.kick(); + + expect(claimCalls).toBe(0); + scheduler.stop(); + }); + + it('stops claiming when queue is empty', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 5, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const items: RunQueueItem[] = [makeClaimedItem('run-1'), makeClaimedItem('run-2')]; + + let claimCalls = 0; + const queue = { + claimNext: async () => { + claimCalls += 1; + return items.shift() ?? null; + }, + markDone: async () => {}, + }; + + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async () => [], + }; + + const runDeferreds = new Map>(); + const execute: RunExecutor = async (item) => { + const d = createDeferred(); + runDeferreds.set(item.id, d); + return d.promise; + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: noopKeepalive, + config, + ownerId: 'owner-1', + execute, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + await scheduler.kick(); + + // Should have claimed all available items (2) then stopped when queue returned null + // Note: claimNext is called until it returns null to fill all slots up to maxParallelRuns + expect(claimCalls).toBeGreaterThanOrEqual(3); // At least: 2 successful + 1 null + expect(scheduler.getState().activeRunIds.sort()).toEqual(['run-1', 'run-2']); + + runDeferreds.get('run-1')!.resolve(undefined); + runDeferreds.get('run-2')!.resolve(undefined); + scheduler.stop(); + }); + }); + + describe('lease reclamation', () => { + it('reclaims expired leases at the configured interval', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 0, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + let t = 1000; + + const reclaimCalls: number[] = []; + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async (now) => { + reclaimCalls.push(now); + return []; + }, + }; + + const queue = { + claimNext: async () => null, + markDone: async () => {}, + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: noopKeepalive, + config, + ownerId: 'owner-1', + execute: async () => {}, + now: () => t, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 100 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + await scheduler.kick(); + expect(reclaimCalls).toEqual([1000]); + + // Not enough time has passed + t = 1099; + await scheduler.kick(); + expect(reclaimCalls).toEqual([1000]); + + // Now enough time has passed + t = 1100; + await scheduler.kick(); + expect(reclaimCalls).toEqual([1000, 1100]); + + scheduler.stop(); + }); + + it('does not reclaim when reclaimIntervalMs is 0', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 0, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const reclaimCalls: number[] = []; + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async (now) => { + reclaimCalls.push(now); + return []; + }, + }; + + const queue = { + claimNext: async () => null, + markDone: async () => {}, + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: noopKeepalive, + config, + ownerId: 'owner-1', + execute: async () => {}, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + await scheduler.kick(); + await scheduler.kick(); + await scheduler.kick(); + + expect(reclaimCalls).toEqual([]); + scheduler.stop(); + }); + }); + + describe('error handling', () => { + it('throws if ownerId is empty', () => { + const config: RunQueueConfig = { + maxParallelRuns: 1, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + expect(() => + createRunScheduler({ + queue: { claimNext: async () => null, markDone: async () => {} }, + leaseManager: { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async () => [], + }, + keepalive: noopKeepalive, + config, + ownerId: '', + execute: async () => {}, + }), + ).toThrow('ownerId is required'); + }); + + it('continues scheduling when executor throws', async () => { + const config: RunQueueConfig = { + maxParallelRuns: 1, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const items: RunQueueItem[] = [makeClaimedItem('run-1'), makeClaimedItem('run-2')]; + + let claimCalls = 0; + const doneIds: string[] = []; + const queue = { + claimNext: async () => { + claimCalls += 1; + return items.shift() ?? null; + }, + markDone: async (runId: string) => { + doneIds.push(runId); + }, + }; + + const leaseManager: Pick< + LeaseManager, + 'startHeartbeat' | 'stopHeartbeat' | 'reclaimExpiredLeases' + > = { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async () => [], + }; + + let executeCount = 0; + const run2Started = createDeferred(); + const execute: RunExecutor = async (item) => { + executeCount += 1; + if (item.id === 'run-1') { + throw new Error('Simulated failure'); + } + run2Started.resolve(undefined); + }; + + const scheduler = createRunScheduler({ + queue, + leaseManager, + keepalive: noopKeepalive, + config, + ownerId: 'owner-1', + execute, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger: createSilentLogger(), + }); + + scheduler.start(); + await scheduler.kick(); + + // Wait for run-2 to start (backfill after run-1 failure) + await run2Started.promise; + + expect(executeCount).toBe(2); + expect(doneIds).toContain('run-1'); + + scheduler.stop(); + }); + }); + + describe('state inspection', () => { + it('getState returns correct information', () => { + const config: RunQueueConfig = { + maxParallelRuns: 3, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const scheduler = createRunScheduler({ + queue: { claimNext: async () => null, markDone: async () => {} }, + leaseManager: { + startHeartbeat: () => {}, + stopHeartbeat: () => {}, + reclaimExpiredLeases: async () => [], + }, + keepalive: noopKeepalive, + config, + ownerId: 'test-owner', + execute: async () => {}, + logger: createSilentLogger(), + }); + + const state = scheduler.getState(); + expect(state.started).toBe(false); + expect(state.ownerId).toBe('test-owner'); + expect(state.maxParallelRuns).toBe(3); + expect(state.activeRunIds).toEqual([]); + + scheduler.start(); + expect(scheduler.getState().started).toBe(true); + + scheduler.stop(); + expect(scheduler.getState().started).toBe(false); + }); + + it('dispose stops the scheduler and clears state', () => { + const config: RunQueueConfig = { + maxParallelRuns: 1, + leaseTtlMs: 15_000, + heartbeatIntervalMs: 5_000, + }; + + const keepaliveProbe = createKeepaliveProbe(); + let heartbeatStopped = 0; + const scheduler = createRunScheduler({ + queue: { claimNext: async () => null, markDone: async () => {} }, + leaseManager: { + startHeartbeat: () => {}, + stopHeartbeat: () => { + heartbeatStopped += 1; + }, + reclaimExpiredLeases: async () => [], + }, + keepalive: keepaliveProbe.keepalive, + config, + ownerId: 'test-owner', + execute: async () => {}, + logger: createSilentLogger(), + }); + + scheduler.start(); + scheduler.dispose(); + + expect(scheduler.getState().started).toBe(false); + expect(heartbeatStopped).toBe(1); + expect(keepaliveProbe.releasedCount()).toBe(1); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/spec-smoke.test.ts b/app/chrome-extension/tests/record-replay-v3/spec-smoke.test.ts new file mode 100644 index 00000000..37e02efd --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/spec-smoke.test.ts @@ -0,0 +1,388 @@ +/** + * @fileoverview V3 Spec Smoke Test + * @description 验证 V3 类型定义和常量可正常导入使用 + */ + +import { describe, it, expect, beforeEach } from 'vitest'; + +// ==================== Domain Types ==================== +import { + // JSON types + type JsonValue, + type JsonObject, + type UnixMillis, + + // ID types + type FlowId, + type NodeId, + type RunId, + EDGE_LABELS, + + // Error types + RR_ERROR_CODES, + type RRError, + createRRError, + + // Policy types + type TimeoutPolicy, + type RetryPolicy, + type OnErrorPolicy, + type NodePolicy, + mergeNodePolicy, + + // Variable types + type PersistentVariableName, + isPersistentVariable, + parseVariablePointer, + + // Flow types + FLOW_SCHEMA_VERSION, + type FlowV3, + type NodeV3, + type EdgeV3, + findNodeById, + + // Event types + type RunEvent, + type RunStatus, + type Unsubscribe, + RUN_SCHEMA_VERSION, + type RunRecordV3, + isTerminalStatus, + isActiveStatus, + + // Debug types + type DebuggerState, + type DebuggerCommand, + createInitialDebuggerState, + + // Trigger types + type TriggerKind, + type TriggerSpec, + isTriggerEnabled, +} from '@/entrypoints/background/record-replay-v3'; + +describe('V3 Domain Types', () => { + describe('Constants', () => { + it('should export EDGE_LABELS', () => { + expect(EDGE_LABELS).toBeDefined(); + expect(EDGE_LABELS.DEFAULT).toBe('default'); + expect(EDGE_LABELS.ON_ERROR).toBe('onError'); + expect(EDGE_LABELS.TRUE).toBe('true'); + expect(EDGE_LABELS.FALSE).toBe('false'); + }); + + it('should export RR_ERROR_CODES', () => { + expect(RR_ERROR_CODES).toBeDefined(); + expect(RR_ERROR_CODES.TIMEOUT).toBe('TIMEOUT'); + expect(RR_ERROR_CODES.VALIDATION_ERROR).toBe('VALIDATION_ERROR'); + expect(RR_ERROR_CODES.DAG_CYCLE).toBe('DAG_CYCLE'); + }); + + it('should export schema versions', () => { + expect(FLOW_SCHEMA_VERSION).toBe(3); + expect(RUN_SCHEMA_VERSION).toBe(3); + }); + }); + + describe('Error utilities', () => { + it('should create RRError', () => { + const error = createRRError(RR_ERROR_CODES.TIMEOUT, 'Operation timed out', { + retryable: true, + data: { timeout: 5000 }, + }); + + expect(error.code).toBe('TIMEOUT'); + expect(error.message).toBe('Operation timed out'); + expect(error.retryable).toBe(true); + expect(error.data).toEqual({ timeout: 5000 }); + }); + + it('should support error chaining', () => { + const cause = createRRError(RR_ERROR_CODES.NETWORK_REQUEST_FAILED, 'Network error'); + const error = createRRError(RR_ERROR_CODES.TOOL_ERROR, 'Tool failed', { cause }); + + expect(error.cause).toBeDefined(); + expect(error.cause?.code).toBe('NETWORK_REQUEST_FAILED'); + }); + }); + + describe('Policy utilities', () => { + it('should merge node policies', () => { + const flowDefault: NodePolicy = { + timeout: { ms: 30000 }, + retry: { retries: 3, intervalMs: 1000 }, + }; + + const nodePolicy: NodePolicy = { + timeout: { ms: 60000 }, + }; + + const merged = mergeNodePolicy(flowDefault, nodePolicy); + + expect(merged.timeout?.ms).toBe(60000); // Node overrides + expect(merged.retry?.retries).toBe(3); // Flow default + }); + + it('should handle undefined policies', () => { + expect(mergeNodePolicy(undefined, undefined)).toEqual({}); + expect(mergeNodePolicy({ timeout: { ms: 5000 } }, undefined)).toEqual({ + timeout: { ms: 5000 }, + }); + }); + }); + + describe('Variable utilities', () => { + it('should detect persistent variables', () => { + expect(isPersistentVariable('$user')).toBe(true); + expect(isPersistentVariable('$config.theme')).toBe(true); + expect(isPersistentVariable('normalVar')).toBe(false); + }); + + it('should parse variable pointers', () => { + const ptr1 = parseVariablePointer('$user.name'); + expect(ptr1?.scope).toBe('persistent'); + expect(ptr1?.name).toBe('$user'); + expect(ptr1?.path).toEqual(['name']); + + const ptr2 = parseVariablePointer('localVar'); + expect(ptr2?.scope).toBe('run'); + expect(ptr2?.name).toBe('localVar'); + }); + }); + + describe('Flow utilities', () => { + const mockFlow: FlowV3 = { + schemaVersion: FLOW_SCHEMA_VERSION, + id: 'flow-1', + name: 'Test Flow', + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + entryNodeId: 'node-1', + nodes: [ + { id: 'node-1', kind: 'click', config: {} }, + { id: 'node-2', kind: 'fill', config: {} }, + ], + edges: [{ id: 'edge-1', from: 'node-1', to: 'node-2' }], + }; + + it('should find node by id', () => { + const node = findNodeById(mockFlow, 'node-1'); + expect(node).toBeDefined(); + expect(node?.kind).toBe('click'); + + expect(findNodeById(mockFlow, 'non-existent')).toBeUndefined(); + }); + }); + + describe('Event utilities', () => { + it('should check terminal status', () => { + expect(isTerminalStatus('succeeded')).toBe(true); + expect(isTerminalStatus('failed')).toBe(true); + expect(isTerminalStatus('canceled')).toBe(true); + expect(isTerminalStatus('running')).toBe(false); + expect(isTerminalStatus('queued')).toBe(false); + }); + + it('should check active status', () => { + expect(isActiveStatus('running')).toBe(true); + expect(isActiveStatus('paused')).toBe(true); + expect(isActiveStatus('succeeded')).toBe(false); + expect(isActiveStatus('queued')).toBe(false); + }); + }); + + describe('Debug utilities', () => { + it('should create initial debugger state', () => { + const state = createInitialDebuggerState('run-1'); + + expect(state.runId).toBe('run-1'); + expect(state.status).toBe('detached'); + expect(state.execution).toBe('running'); + expect(state.breakpoints).toEqual([]); + expect(state.stepMode).toBe('none'); + }); + }); + + describe('Trigger utilities', () => { + it('should check trigger enabled', () => { + const enabledTrigger: TriggerSpec = { + id: 'trigger-1', + kind: 'manual', + enabled: true, + flowId: 'flow-1', + }; + + const disabledTrigger: TriggerSpec = { + id: 'trigger-2', + kind: 'manual', + enabled: false, + flowId: 'flow-1', + }; + + expect(isTriggerEnabled(enabledTrigger)).toBe(true); + expect(isTriggerEnabled(disabledTrigger)).toBe(false); + }); + }); +}); + +// ==================== Engine Types ==================== +import { + // Kernel + type ExecutionKernel, + type RunStartRequest, + createNotImplementedKernel, + + // Queue + type RunQueue, + type RunQueueItem, + DEFAULT_QUEUE_CONFIG, + createNotImplementedQueue, + + // Plugins + type NodeDefinition, + type PluginRegistry, + getPluginRegistry, + resetPluginRegistry, + + // Transport + RR_V3_PORT_NAME, + type RpcMessage, + createRpcRequest, + InMemoryEventsBus, +} from '@/entrypoints/background/record-replay-v3'; + +describe('V3 Engine Types', () => { + describe('Kernel', () => { + it('should create not-implemented kernel', () => { + const kernel = createNotImplementedKernel(); + expect(kernel).toBeDefined(); + expect(() => kernel.onEvent(() => {})).toThrow('not implemented'); + }); + }); + + describe('Queue', () => { + it('should export default queue config', () => { + expect(DEFAULT_QUEUE_CONFIG).toBeDefined(); + expect(DEFAULT_QUEUE_CONFIG.maxParallelRuns).toBe(3); + expect(DEFAULT_QUEUE_CONFIG.leaseTtlMs).toBe(15000); + }); + + it('should create not-implemented queue', () => { + const queue = createNotImplementedQueue(); + expect(queue).toBeDefined(); + }); + }); + + describe('Plugin Registry', () => { + beforeEach(() => { + resetPluginRegistry(); + }); + + it('should get global registry', () => { + const registry = getPluginRegistry(); + expect(registry).toBeDefined(); + expect(registry.listNodeKinds()).toEqual([]); + }); + + it('should register and retrieve nodes', () => { + const registry = getPluginRegistry(); + + const mockNodeDef: NodeDefinition = { + kind: 'test-node', + schema: { parse: (x: unknown) => x } as NodeDefinition['schema'], + execute: async () => ({ status: 'succeeded' }), + }; + + registry.registerNode(mockNodeDef); + expect(registry.hasNode('test-node')).toBe(true); + expect(registry.getNode('test-node')).toBe(mockNodeDef); + }); + }); + + describe('Transport', () => { + it('should export port name', () => { + expect(RR_V3_PORT_NAME).toBe('rr_v3'); + }); + + it('should create RPC request', () => { + const req = createRpcRequest('rr_v3.listRuns', { limit: 10 }); + + expect(req.type).toBe('rr_v3.request'); + expect(req.method).toBe('rr_v3.listRuns'); + expect(req.params).toEqual({ limit: 10 }); + expect(req.requestId).toBeDefined(); + }); + }); + + describe('EventsBus (InMemory)', () => { + it('should append and list events', async () => { + const bus = new InMemoryEventsBus(); + + const event = await bus.append({ + runId: 'run-1', + type: 'run.started', + flowId: 'flow-1', + tabId: 1, + }); + + expect(event.seq).toBe(1); + expect(event.ts).toBeDefined(); + + const events = await bus.list({ runId: 'run-1' }); + expect(events).toHaveLength(1); + expect(events[0].type).toBe('run.started'); + }); + + it('should support subscriptions', async () => { + const bus = new InMemoryEventsBus(); + const received: RunEvent[] = []; + + const unsub = bus.subscribe((event) => received.push(event)); + + await bus.append({ runId: 'run-1', type: 'run.queued', flowId: 'flow-1' }); + + expect(received).toHaveLength(1); + + unsub(); + + await bus.append({ runId: 'run-1', type: 'run.started', flowId: 'flow-1', tabId: 1 }); + + // Should not receive after unsubscribe + expect(received).toHaveLength(1); + }); + }); +}); + +// ==================== Storage Types ==================== +import { + RR_V3_DB_NAME, + RR_V3_DB_VERSION, + RR_V3_STORES, +} from '@/entrypoints/background/record-replay-v3'; + +describe('V3 Storage Constants', () => { + it('should export database constants', () => { + expect(RR_V3_DB_NAME).toBe('rr_v3'); + expect(RR_V3_DB_VERSION).toBe(1); + }); + + it('should export store names', () => { + expect(RR_V3_STORES.FLOWS).toBe('flows'); + expect(RR_V3_STORES.RUNS).toBe('runs'); + expect(RR_V3_STORES.EVENTS).toBe('events'); + expect(RR_V3_STORES.QUEUE).toBe('queue'); + expect(RR_V3_STORES.PERSISTENT_VARS).toBe('persistent_vars'); + expect(RR_V3_STORES.TRIGGERS).toBe('triggers'); + }); +}); + +// ==================== Version ==================== +import { RR_V3_VERSION, IS_RR_V3 } from '@/entrypoints/background/record-replay-v3'; + +describe('V3 Version', () => { + it('should export version info', () => { + expect(RR_V3_VERSION).toBe('3.0.0'); + expect(IS_RR_V3).toBe(true); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/trigger-manager.test.ts b/app/chrome-extension/tests/record-replay-v3/trigger-manager.test.ts new file mode 100644 index 00000000..ecc8e4ee --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/trigger-manager.test.ts @@ -0,0 +1,876 @@ +/** + * @fileoverview TriggerManager 测试 (P4-02) + * @description + * Tests for: + * - TriggerManager lifecycle (start/stop/refresh) + * - Handler installation/uninstallation + * - Trigger firing and enqueueRun + * - Storm protection (cooldown, maxQueued) + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3/domain/flow'; +import type { RunRecordV3 } from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { + TriggerKind, + TriggerSpec, +} from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { RunQueueItem } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import type { StoragePort } from '@/entrypoints/background/record-replay-v3/engine/storage/storage-port'; +import type { EventsBus } from '@/entrypoints/background/record-replay-v3/engine/transport/events-bus'; +import type { RunScheduler } from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; +import type { + TriggerFireCallback, + TriggerHandler, + TriggerHandlerFactory, +} from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createTriggerManager } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-manager'; + +// ==================== Test Utilities ==================== + +function createTestFlow(id: string): FlowV3 { + return { + schemaVersion: 3, + id, + name: 'Test Flow', + createdAt: new Date(0).toISOString(), + updatedAt: new Date(0).toISOString(), + entryNodeId: 'node-1', + nodes: [{ id: 'node-1', kind: 'noop', config: {} }], + edges: [], + }; +} + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface TestHandler { + factory: TriggerHandlerFactory; + handler: TriggerHandler; + installed: Map; + fire: (triggerId: string, ctx: { sourceTabId?: number; sourceUrl?: string }) => Promise; +} + +function createTestHandler(kind: TriggerKind): TestHandler { + const installed = new Map(); + let callback: TriggerFireCallback | null = null; + + const handler: TriggerHandler = { + kind, + install: vi.fn(async (trigger: TriggerSpec) => { + installed.set(trigger.id, trigger); + }), + uninstall: vi.fn(async (triggerId: string) => { + installed.delete(triggerId); + }), + uninstallAll: vi.fn(async () => { + installed.clear(); + }), + getInstalledIds: vi.fn(() => Array.from(installed.keys())), + }; + + const factory: TriggerHandlerFactory = (fireCallback) => { + callback = fireCallback; + return handler; + }; + + const fire = async (triggerId: string, ctx: { sourceTabId?: number; sourceUrl?: string }) => { + if (!callback) { + throw new Error('fireCallback not initialized'); + } + await callback.onFire(triggerId, ctx); + }; + + return { factory, handler, installed, fire }; +} + +// ==================== TriggerManager Tests ==================== + +describe('V3 TriggerManager', () => { + let time: number; + let runIdCounter: number; + + let triggersList: TriggerSpec[]; + let flowsMap: Map; + let runsMap: Map; + let queueMap: Map; + + let storage: Pick; + let events: Pick; + let scheduler: Pick; + + beforeEach(() => { + time = 1_700_000_000_000; + runIdCounter = 0; + + triggersList = []; + flowsMap = new Map(); + runsMap = new Map(); + queueMap = new Map(); + + storage = { + triggers: { + list: vi.fn(async () => triggersList), + get: vi.fn(async (id: string) => triggersList.find((t) => t.id === id) ?? null), + save: vi.fn(async (spec: TriggerSpec) => { + const idx = triggersList.findIndex((t) => t.id === spec.id); + if (idx >= 0) triggersList[idx] = spec; + else triggersList.push(spec); + }), + delete: vi.fn(async (id: string) => { + triggersList = triggersList.filter((t) => t.id !== id); + }), + }, + flows: { + list: vi.fn(async () => Array.from(flowsMap.values())), + get: vi.fn(async (id: string) => flowsMap.get(id) ?? null), + save: vi.fn(async (flow: FlowV3) => { + flowsMap.set(flow.id, flow); + }), + delete: vi.fn(async (id: string) => { + flowsMap.delete(id); + }), + }, + runs: { + list: vi.fn(async () => Array.from(runsMap.values())), + get: vi.fn(async (id: string) => runsMap.get(id) ?? null), + save: vi.fn(async (record: RunRecordV3) => { + runsMap.set(record.id, record); + }), + patch: vi.fn(async (id: string, patch: Partial) => { + const existing = runsMap.get(id); + if (existing) runsMap.set(id, { ...existing, ...patch }); + }), + }, + queue: { + enqueue: vi.fn(async (input) => { + const now = time; + const item: RunQueueItem = { + ...input, + priority: input.priority ?? 0, + maxAttempts: input.maxAttempts ?? 1, + status: 'queued', + createdAt: now, + updatedAt: now, + attempt: 0, + }; + queueMap.set(item.id, item); + return item; + }), + list: vi.fn(async (status?: string) => { + const items = Array.from(queueMap.values()); + if (status) return items.filter((i) => i.status === status); + return items; + }), + } as unknown as StoragePort['queue'], + } as Pick; + + events = { + append: vi.fn(async (event) => ({ ...event, ts: time, seq: 1 }) as unknown), + }; + + scheduler = { + kick: vi.fn(async () => {}), + }; + }); + + describe('Lifecycle', () => { + it('installs enabled triggers on start', async () => { + const { factory, handler, installed } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + { + id: 't2', + kind: 'command', + enabled: false, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await manager.start(); + + expect(handler.uninstallAll).toHaveBeenCalledTimes(1); + expect(handler.install).toHaveBeenCalledTimes(1); + expect(Array.from(installed.keys())).toEqual(['t1']); + }); + + it('stop uninstalls all triggers', async () => { + const { factory, handler, installed } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await manager.start(); + expect(installed.size).toBe(1); + + await manager.stop(); + expect(handler.uninstallAll).toHaveBeenCalledTimes(2); // once in start, once in stop + expect(installed.size).toBe(0); + }); + + it('refresh resets installations when triggers change', async () => { + const { factory, handler, installed } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await manager.start(); + expect(Array.from(installed.keys())).toEqual(['t1']); + + // Disable trigger + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: false, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + await manager.refresh(); + + expect(handler.uninstallAll).toHaveBeenCalledTimes(2); + expect(installed.size).toBe(0); + }); + + it('getState returns correct state', async () => { + const { factory } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + expect(manager.getState()).toEqual({ + started: false, + installedTriggerIds: [], + }); + + await manager.start(); + + expect(manager.getState()).toEqual({ + started: true, + installedTriggerIds: ['t1'], + }); + }); + }); + + describe('Trigger firing', () => { + it('enqueues a run on fire and records trigger context', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + args: { foo: 'bar' }, + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + await fire('t1', { sourceTabId: 123, sourceUrl: 'https://example.com' }); + + expect(storage.runs.save).toHaveBeenCalledTimes(1); + const savedRun = (storage.runs.save as ReturnType).mock + .calls[0][0] as RunRecordV3; + expect(savedRun).toMatchObject({ + id: 'run-1', + flowId: 'flow-1', + status: 'queued', + args: { foo: 'bar' }, + trigger: { + triggerId: 't1', + kind: 'command', + firedAt: time, + sourceTabId: 123, + sourceUrl: 'https://example.com', + }, + }); + + expect(scheduler.kick).toHaveBeenCalled(); + }); + + it('ignores fire for non-installed trigger', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = []; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + await fire('unknown-trigger', {}); + + expect(storage.runs.save).not.toHaveBeenCalled(); + }); + + it('ignores fire when manager is stopped', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + await manager.stop(); + + await fire('t1', {}); + + expect(storage.runs.save).not.toHaveBeenCalled(); + }); + }); + + describe('Storm protection - cooldown', () => { + it('applies per-trigger cooldown', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { cooldownMs: 500 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // First fire - should succeed + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Second fire within cooldown - should be dropped + time += 200; + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Third fire after cooldown - should succeed + time += 600; // total 800ms > 500ms cooldown + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + + it('cooldown is per-trigger', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd1', + } as TriggerSpec, + { + id: 't2', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd2', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { cooldownMs: 500 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // Fire t1 + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Fire t2 immediately - should succeed (different trigger) + await fire('t2', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + + // Fire t1 again within cooldown - should be dropped + time += 100; + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + }); + + describe('Storm protection - maxQueued', () => { + it('applies global maxQueued cap', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { maxQueued: 1 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // First fire - should succeed + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Second fire - should be dropped (maxQueued reached) + time += 1; + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + }); + + it('maxQueued cap allows more fires when queue drains', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { maxQueued: 1 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // First fire - should succeed + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Simulate queue drain + queueMap.clear(); + time += 1; + + // Fire again - should succeed + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + }); + + describe('Multiple handler types', () => { + it('handles multiple trigger kinds', async () => { + const commandHandler = createTestHandler('command'); + const urlHandler = createTestHandler('url'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + { + id: 't2', + kind: 'url', + enabled: true, + flowId: 'flow-1', + match: [{ kind: 'domain', value: 'example.com' }], + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { + command: commandHandler.factory, + url: urlHandler.factory, + }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + expect(commandHandler.installed.size).toBe(1); + expect(urlHandler.installed.size).toBe(1); + + // Fire both + await commandHandler.fire('t1', {}); + await urlHandler.fire('t2', { sourceUrl: 'https://example.com' }); + + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + }); + + describe('Error handling', () => { + it('continues after handler install failure', async () => { + const { factory, installed } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd1', + } as TriggerSpec, + { + id: 't2', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd2', + } as TriggerSpec, + ]; + + // Make first install fail + let callCount = 0; + const originalFactory: TriggerHandlerFactory = (fireCallback) => { + const handler = factory(fireCallback); + const originalInstall = handler.install; + handler.install = vi.fn(async (trigger: TriggerSpec) => { + callCount++; + if (callCount === 1) { + throw new Error('Install failed'); + } + return originalInstall(trigger); + }); + return handler; + }; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: originalFactory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await manager.start(); + + // Only t2 should be installed + expect(installed.size).toBe(1); + expect(installed.has('t2')).toBe(true); + }); + + it('refresh throws when not started', async () => { + const { factory } = createTestHandler('command'); + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await expect(manager.refresh()).rejects.toThrow('TriggerManager is not started'); + }); + + it('continues after uninstallAll failure during refresh', async () => { + const { factory, installed } = createTestHandler('command'); + + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + let uninstallCallCount = 0; + const originalFactory: TriggerHandlerFactory = (fireCallback) => { + const handler = factory(fireCallback); + handler.uninstallAll = vi.fn(async () => { + uninstallCallCount++; + if (uninstallCallCount === 2) { + throw new Error('UninstallAll failed'); + } + installed.clear(); + }); + return handler; + }; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: originalFactory }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + + await manager.start(); + + // Add new trigger + triggersList.push({ + id: 't2', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd2', + } as TriggerSpec); + + // Refresh should continue despite uninstallAll failure + await manager.refresh(); + expect(installed.size).toBe(2); + }); + + it('cooldown rollback on enqueueRun failure', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + // Make enqueue fail + let enqueueCallCount = 0; + (storage.queue.enqueue as ReturnType).mockImplementation(async () => { + enqueueCallCount++; + if (enqueueCallCount === 1) { + throw new Error('Enqueue failed'); + } + const now = time; + const item: RunQueueItem = { + id: `run-${runIdCounter}`, + flowId: 'flow-1', + priority: 0, + maxAttempts: 1, + status: 'queued', + createdAt: now, + updatedAt: now, + attempt: 0, + }; + queueMap.set(item.id, item); + return item; + }); + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { cooldownMs: 500 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // First fire fails, cooldown should be rolled back + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Immediate retry should succeed (cooldown was rolled back) + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + }); + + describe('maxQueued does not affect cooldown', () => { + it('does not set cooldown when dropped due to maxQueued', async () => { + const { factory, fire } = createTestHandler('command'); + + flowsMap.set('flow-1', createTestFlow('flow-1')); + triggersList = [ + { + id: 't1', + kind: 'command', + enabled: true, + flowId: 'flow-1', + commandKey: 'cmd', + } as TriggerSpec, + ]; + + const manager = createTriggerManager({ + storage, + events, + scheduler, + handlerFactories: { command: factory }, + storm: { cooldownMs: 500, maxQueued: 1 }, + now: () => time, + generateRunId: () => `run-${++runIdCounter}`, + logger: createSilentLogger(), + }); + await manager.start(); + + // First fire succeeds + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Second fire dropped due to maxQueued (but cooldown should still be set) + time += 100; + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // Clear queue, but within cooldown - should still be dropped + queueMap.clear(); + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(1); + + // After cooldown - should succeed + time += 500; + await fire('t1', {}); + expect(storage.runs.save).toHaveBeenCalledTimes(2); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/triggers.test.ts b/app/chrome-extension/tests/record-replay-v3/triggers.test.ts new file mode 100644 index 00000000..4f31f88d --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/triggers.test.ts @@ -0,0 +1,276 @@ +/** + * @fileoverview 触发器测试 (P4-01) + * @description + * Tests for: + * - TriggerStore CRUD operations + * - TriggerSpec type validation + */ + +import { beforeEach, describe, expect, it } from 'vitest'; + +import type { TriggerSpec } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import { + createTriggersStore, + closeRrV3Db, + deleteRrV3Db, +} from '@/entrypoints/background/record-replay-v3'; + +// ==================== Test Utilities ==================== + +function createUrlTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'url', + enabled: true, + flowId: flowId as any, + match: [{ kind: 'domain', value: 'example.com' }], + }; +} + +function createCronTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'cron', + enabled: true, + flowId: flowId as any, + cron: '0 9 * * *', // Every day at 9am + timezone: 'UTC', + }; +} + +function createCommandTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'command', + enabled: true, + flowId: flowId as any, + commandKey: 'run-flow-1', + }; +} + +function createContextMenuTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'contextMenu', + enabled: true, + flowId: flowId as any, + title: 'Run Flow', + contexts: ['page', 'selection'], + }; +} + +function createDomTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'dom', + enabled: true, + flowId: flowId as any, + selector: '#submit-button', + appear: true, + once: false, + debounceMs: 1000, + }; +} + +function createManualTrigger(id: string, flowId: string): TriggerSpec { + return { + id: id as any, + kind: 'manual', + enabled: true, + flowId: flowId as any, + }; +} + +// ==================== TriggerStore Tests ==================== + +describe('TriggerStore CRUD', () => { + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + }); + + describe('Basic CRUD', () => { + it('save and get a trigger', async () => { + const store = createTriggersStore(); + const trigger = createUrlTrigger('trigger-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('trigger-1' as any); + + expect(retrieved).not.toBeNull(); + expect(retrieved).toMatchObject({ + id: 'trigger-1', + kind: 'url', + enabled: true, + flowId: 'flow-1', + match: [{ kind: 'domain', value: 'example.com' }], + }); + }); + + it('get returns null for non-existent trigger', async () => { + const store = createTriggersStore(); + + const retrieved = await store.get('non-existent' as any); + + expect(retrieved).toBeNull(); + }); + + it('list returns all triggers', async () => { + const store = createTriggersStore(); + + await store.save(createUrlTrigger('trigger-1', 'flow-1')); + await store.save(createCronTrigger('trigger-2', 'flow-2')); + await store.save(createCommandTrigger('trigger-3', 'flow-3')); + + const triggers = await store.list(); + + expect(triggers).toHaveLength(3); + expect(triggers.map((t) => t.id)).toContain('trigger-1'); + expect(triggers.map((t) => t.id)).toContain('trigger-2'); + expect(triggers.map((t) => t.id)).toContain('trigger-3'); + }); + + it('list returns empty array when no triggers', async () => { + const store = createTriggersStore(); + + const triggers = await store.list(); + + expect(triggers).toHaveLength(0); + }); + + it('save updates existing trigger', async () => { + const store = createTriggersStore(); + + await store.save(createUrlTrigger('trigger-1', 'flow-1')); + + // Update + const updated: TriggerSpec = { + id: 'trigger-1' as any, + kind: 'url', + enabled: false, // Changed + flowId: 'flow-1' as any, + match: [{ kind: 'url', value: 'https://example.com/new' }], // Changed + }; + await store.save(updated); + + const retrieved = await store.get('trigger-1' as any); + expect(retrieved).toMatchObject({ + id: 'trigger-1', + enabled: false, + match: [{ kind: 'url', value: 'https://example.com/new' }], + }); + }); + + it('delete removes a trigger', async () => { + const store = createTriggersStore(); + + await store.save(createUrlTrigger('trigger-1', 'flow-1')); + await store.delete('trigger-1' as any); + + const retrieved = await store.get('trigger-1' as any); + expect(retrieved).toBeNull(); + }); + + it('delete is idempotent for non-existent trigger', async () => { + const store = createTriggersStore(); + + // Should not throw + await expect(store.delete('non-existent' as any)).resolves.toBeUndefined(); + }); + }); + + describe('All trigger kinds', () => { + it('stores and retrieves URL trigger', async () => { + const store = createTriggersStore(); + const trigger = createUrlTrigger('url-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('url-1' as any); + + expect(retrieved?.kind).toBe('url'); + expect((retrieved as any).match).toEqual([{ kind: 'domain', value: 'example.com' }]); + }); + + it('stores and retrieves cron trigger', async () => { + const store = createTriggersStore(); + const trigger = createCronTrigger('cron-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('cron-1' as any); + + expect(retrieved?.kind).toBe('cron'); + expect((retrieved as any).cron).toBe('0 9 * * *'); + expect((retrieved as any).timezone).toBe('UTC'); + }); + + it('stores and retrieves command trigger', async () => { + const store = createTriggersStore(); + const trigger = createCommandTrigger('cmd-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('cmd-1' as any); + + expect(retrieved?.kind).toBe('command'); + expect((retrieved as any).commandKey).toBe('run-flow-1'); + }); + + it('stores and retrieves contextMenu trigger', async () => { + const store = createTriggersStore(); + const trigger = createContextMenuTrigger('ctx-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('ctx-1' as any); + + expect(retrieved?.kind).toBe('contextMenu'); + expect((retrieved as any).title).toBe('Run Flow'); + expect((retrieved as any).contexts).toEqual(['page', 'selection']); + }); + + it('stores and retrieves DOM trigger', async () => { + const store = createTriggersStore(); + const trigger = createDomTrigger('dom-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('dom-1' as any); + + expect(retrieved?.kind).toBe('dom'); + expect((retrieved as any).selector).toBe('#submit-button'); + expect((retrieved as any).appear).toBe(true); + expect((retrieved as any).once).toBe(false); + expect((retrieved as any).debounceMs).toBe(1000); + }); + + it('stores and retrieves manual trigger', async () => { + const store = createTriggersStore(); + const trigger = createManualTrigger('manual-1', 'flow-1'); + + await store.save(trigger); + const retrieved = await store.get('manual-1' as any); + + expect(retrieved?.kind).toBe('manual'); + }); + }); + + describe('Trigger with args', () => { + it('stores and retrieves trigger with args', async () => { + const store = createTriggersStore(); + const trigger: TriggerSpec = { + ...createUrlTrigger('trigger-1', 'flow-1'), + args: { + mode: 'production', + retryCount: 3, + tags: ['important', 'automated'], + }, + }; + + await store.save(trigger); + const retrieved = await store.get('trigger-1' as any); + + expect(retrieved?.args).toEqual({ + mode: 'production', + retryCount: 3, + tags: ['important', 'automated'], + }); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/url-trigger.test.ts b/app/chrome-extension/tests/record-replay-v3/url-trigger.test.ts new file mode 100644 index 00000000..d5515e4d --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/url-trigger.test.ts @@ -0,0 +1,475 @@ +/** + * @fileoverview URL Trigger Handler 测试 (P4-03) + * @description + * Tests for: + * - URL matching semantics (domain, path, url prefix) + * - Listener lifecycle (add/remove on install/uninstall) + * - Edge cases (subframe, invalid URL) + */ + +import { beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { TriggerSpecByKind } from '@/entrypoints/background/record-replay-v3/domain/triggers'; +import type { TriggerFireCallback } from '@/entrypoints/background/record-replay-v3/engine/triggers/trigger-handler'; +import { createUrlTriggerHandlerFactory } from '@/entrypoints/background/record-replay-v3/engine/triggers/url-trigger'; + +// ==================== Test Utilities ==================== + +function createSilentLogger(): Pick { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +interface WebNavigationMock { + onCompleted: { + addListener: ReturnType; + removeListener: ReturnType; + }; + emitCompleted: (details: { tabId: number; frameId: number; url: string }) => void; +} + +function createWebNavigationMock(): WebNavigationMock { + const listeners = new Set<(details: unknown) => void>(); + + const onCompleted = { + addListener: vi.fn((cb: (details: unknown) => void) => { + listeners.add(cb); + }), + removeListener: vi.fn((cb: (details: unknown) => void) => { + listeners.delete(cb); + }), + }; + + return { + onCompleted, + emitCompleted: (details) => { + for (const cb of listeners) cb(details); + }, + }; +} + +// ==================== URL Trigger Tests ==================== + +describe('V3 UrlTriggerHandler', () => { + let webNav: WebNavigationMock; + + beforeEach(() => { + webNav = createWebNavigationMock(); + (globalThis.chrome as unknown as { webNavigation: unknown }).webNavigation = { + onCompleted: webNav.onCompleted, + }; + }); + + describe('Domain matching', () => { + it('matches exact domain', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'example.com' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/page' }); + expect(fireCallback.onFire).toHaveBeenCalledWith('t1', { + sourceTabId: 1, + sourceUrl: 'https://example.com/page', + }); + }); + + it('matches subdomain', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'example.com' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://www.example.com/a' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://sub.sub.example.com/b' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(2); + }); + + it('avoids substring false-positives', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'example.com' }], + }; + + await handler.install(trigger); + + // Should NOT match - domain contains "example.com" as substring but is not example.com or subdomain + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://notexample.com/a' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com.evil.com/a' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('handles domain with leading/trailing dots', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: '..example.com..' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/page' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + }); + }); + + describe('Path matching', () => { + it('matches path prefix', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'path', value: '/foo' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://any.com/foo/bar' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://any.com/foobar' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(2); + }); + + it('does not match non-matching path', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'path', value: '/foo' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://any.com/bar' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + + it('normalizes path without leading slash', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'path', value: 'foo' }], // No leading slash + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://any.com/foo/bar' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + }); + }); + + describe('URL prefix matching', () => { + it('matches full URL prefix', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'url', value: 'https://example.com/a' }], + }; + + await handler.install(trigger); + + // Matches prefix with query/hash + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/a?x=1#hash' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + + // Matches prefix with additional path + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/a/b/c' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(2); + }); + + it('does not match non-matching URL', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'url', value: 'https://example.com/a' }], + }; + + await handler.install(trigger); + + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/b' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); + + describe('Multiple rules (OR logic)', () => { + it('fires if any rule matches', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [ + { kind: 'domain', value: 'example.com' }, + { kind: 'path', value: '/special' }, + ], + }; + + await handler.install(trigger); + + // Match by domain + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://example.com/any' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(1); + + // Match by path on different domain + webNav.emitCompleted({ tabId: 1, frameId: 0, url: 'https://other.com/special/page' }); + expect(fireCallback.onFire).toHaveBeenCalledTimes(2); + }); + }); + + describe('Frame filtering', () => { + it('ignores subframe navigations', async () => { + const fireCallback: TriggerFireCallback = { + onFire: vi.fn(async () => {}), + }; + + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const trigger: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'example.com' }], + }; + + await handler.install(trigger); + + // frameId !== 0 should be ignored + webNav.emitCompleted({ tabId: 1, frameId: 1, url: 'https://example.com/' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + + webNav.emitCompleted({ tabId: 1, frameId: 99, url: 'https://example.com/' }); + expect(fireCallback.onFire).not.toHaveBeenCalled(); + }); + }); + + describe('Listener lifecycle', () => { + it('registers single listener on first install', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'a.com' }], + }; + + const t2: TriggerSpecByKind<'url'> = { + id: 't2' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'b.com' }], + }; + + await handler.install(t1); + await handler.install(t2); + + // Only one listener should be added + expect(webNav.onCompleted.addListener).toHaveBeenCalledTimes(1); + }); + + it('removes listener when all triggers uninstalled', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'a.com' }], + }; + + const t2: TriggerSpecByKind<'url'> = { + id: 't2' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'b.com' }], + }; + + await handler.install(t1); + await handler.install(t2); + + await handler.uninstall('t1'); + expect(webNav.onCompleted.removeListener).not.toHaveBeenCalled(); + + await handler.uninstall('t2'); + expect(webNav.onCompleted.removeListener).toHaveBeenCalledTimes(1); + }); + + it('removes listener on uninstallAll', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'example.com' }], + }; + + await handler.install(t1); + await handler.uninstallAll(); + + expect(webNav.onCompleted.removeListener).toHaveBeenCalledTimes(1); + }); + }); + + describe('getInstalledIds', () => { + it('returns installed trigger IDs', async () => { + const fireCallback: TriggerFireCallback = { onFire: vi.fn(async () => {}) }; + const handler = createUrlTriggerHandlerFactory({ logger: createSilentLogger() })( + fireCallback, + ); + + const t1: TriggerSpecByKind<'url'> = { + id: 't1' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'a.com' }], + }; + + const t2: TriggerSpecByKind<'url'> = { + id: 't2' as never, + kind: 'url', + enabled: true, + flowId: 'flow-1' as never, + match: [{ kind: 'domain', value: 'b.com' }], + }; + + await handler.install(t1); + await handler.install(t2); + + expect(handler.getInstalledIds().sort()).toEqual(['t1', 't2']); + + await handler.uninstall('t1'); + expect(handler.getInstalledIds()).toEqual(['t2']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/v2-action-adapter.test.ts b/app/chrome-extension/tests/record-replay-v3/v2-action-adapter.test.ts new file mode 100644 index 00000000..e80f0ed7 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/v2-action-adapter.test.ts @@ -0,0 +1,542 @@ +/** + * @fileoverview V2 Action Adapter unit tests + * @description Tests for adaptV2ActionHandlerToV3NodeDefinition + * + * Coverage: + * - varsPatch generation (set/delete) + * - nextLabel mapping + * - Error code mapping + * - Tab/frame state vars + * - paused/control directive handling + * - Output capture + */ + +import { describe, expect, it, vi } from 'vitest'; + +import type { + ActionExecutionContext, + ActionExecutionResult, + ActionHandler, +} from '@/entrypoints/background/record-replay/actions/types'; +import type { + NodeExecutionContext, + NodeExecutionResult, +} from '@/entrypoints/background/record-replay-v3/engine/plugins/types'; +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3/domain/flow'; +import type { RunId, NodeId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import { RR_ERROR_CODES } from '@/entrypoints/background/record-replay-v3/domain/errors'; +import { FLOW_SCHEMA_VERSION } from '@/entrypoints/background/record-replay-v3/domain/flow'; + +import { adaptV2ActionHandlerToV3NodeDefinition } from '@/entrypoints/background/record-replay-v3/engine/plugins/v2-action-adapter'; + +// ==================== Test Fixtures ==================== + +function createMockV3Context(overrides: Partial = {}): NodeExecutionContext { + const flow: FlowV3 = { + schemaVersion: FLOW_SCHEMA_VERSION, + id: 'test-flow', + name: 'Test Flow', + createdAt: new Date(0).toISOString(), + updatedAt: new Date(0).toISOString(), + entryNodeId: 'node-1', + nodes: [], + edges: [], + }; + + return { + runId: 'run-1' as RunId, + flow, + nodeId: 'node-1' as NodeId, + tabId: 1, + vars: {}, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { + screenshot: vi.fn().mockResolvedValue({ ok: true, base64: 'mock-base64' }), + }, + persistent: { + get: vi.fn().mockResolvedValue(undefined), + set: vi.fn().mockResolvedValue(undefined), + delete: vi.fn().mockResolvedValue(undefined), + }, + ...overrides, + }; +} + +function createMockNode(id = 'node-1', config: Record = {}) { + return { + id: id as NodeId, + kind: 'test' as const, + config, + }; +} + +type TestActionType = 'test'; + +function createMockHandler( + runFn: ( + ctx: ActionExecutionContext, + action: unknown, + ) => Promise>, +): ActionHandler { + return { + type: 'test' as TestActionType, + run: runFn, + }; +} + +// ==================== Tests ==================== + +describe('adaptV2ActionHandlerToV3NodeDefinition', () => { + describe('Basic execution', () => { + it('returns succeeded for successful V2 handler', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + }); + + it('maps V2 failed status to V3 failed', async () => { + const handler = createMockHandler(async () => ({ + status: 'failed', + error: { code: 'TIMEOUT', message: 'Timed out' }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.TIMEOUT); + expect(result.error?.message).toBe('Timed out'); + }); + + it('handles V2 handler throwing exception', async () => { + const handler = createMockHandler(async () => { + throw new Error('Unexpected error'); + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.INTERNAL); + expect(result.error?.message).toContain('Unexpected error'); + }); + }); + + describe('varsPatch generation', () => { + it('generates set patch for new variable', async () => { + const handler = createMockHandler(async (ctx) => { + ctx.vars['newVar'] = 'value'; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ vars: {} }); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ op: 'set', name: 'newVar', value: 'value' }); + }); + + it('generates set patch for modified variable', async () => { + const handler = createMockHandler(async (ctx) => { + ctx.vars['existing'] = 'modified'; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ vars: { existing: 'original' } }); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ op: 'set', name: 'existing', value: 'modified' }); + }); + + it('generates delete patch for removed variable', async () => { + const handler = createMockHandler(async (ctx) => { + delete ctx.vars['toDelete']; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ vars: { toDelete: 'value' } }); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ op: 'delete', name: 'toDelete' }); + }); + + it('handles deep object changes', async () => { + const handler = createMockHandler(async (ctx) => { + ctx.vars['obj'] = { nested: { value: 42 } }; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ vars: { obj: { nested: { value: 1 } } } }); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ + op: 'set', + name: 'obj', + value: { nested: { value: 42 } }, + }); + }); + + it('does not generate patch when vars unchanged', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ vars: { existing: 'value' } }); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toBeUndefined(); + }); + }); + + describe('nextLabel mapping', () => { + it('maps nextLabel to chooseNext result', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + nextLabel: 'true', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'true' }); + }); + + it('does not set next when no nextLabel', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toBeUndefined(); + }); + }); + + describe('Error code mapping', () => { + const errorCodes: Array<{ v2Code: string; v3Code: string }> = [ + { v2Code: 'VALIDATION_ERROR', v3Code: RR_ERROR_CODES.VALIDATION_ERROR }, + { v2Code: 'TIMEOUT', v3Code: RR_ERROR_CODES.TIMEOUT }, + { v2Code: 'TAB_NOT_FOUND', v3Code: RR_ERROR_CODES.TAB_NOT_FOUND }, + { v2Code: 'FRAME_NOT_FOUND', v3Code: RR_ERROR_CODES.FRAME_NOT_FOUND }, + { v2Code: 'TARGET_NOT_FOUND', v3Code: RR_ERROR_CODES.TARGET_NOT_FOUND }, + { v2Code: 'ELEMENT_NOT_VISIBLE', v3Code: RR_ERROR_CODES.ELEMENT_NOT_VISIBLE }, + { v2Code: 'NAVIGATION_FAILED', v3Code: RR_ERROR_CODES.NAVIGATION_FAILED }, + { v2Code: 'NETWORK_REQUEST_FAILED', v3Code: RR_ERROR_CODES.NETWORK_REQUEST_FAILED }, + { v2Code: 'SCRIPT_FAILED', v3Code: RR_ERROR_CODES.SCRIPT_FAILED }, + { v2Code: 'DOWNLOAD_FAILED', v3Code: RR_ERROR_CODES.TOOL_ERROR }, + { v2Code: 'ASSERTION_FAILED', v3Code: RR_ERROR_CODES.TOOL_ERROR }, + { v2Code: 'UNKNOWN', v3Code: RR_ERROR_CODES.INTERNAL }, + ]; + + errorCodes.forEach(({ v2Code, v3Code }) => { + it(`maps V2 ${v2Code} to V3 ${v3Code}`, async () => { + const handler = createMockHandler(async () => ({ + status: 'failed', + error: { code: v2Code as any, message: 'Test error' }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(v3Code); + }); + }); + }); + + describe('Tab/frame state vars', () => { + it('persists newTabId as __rr_v2__tabId', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + newTabId: 42, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ + op: 'set', + name: '__rr_v2__tabId', + value: 42, + }); + }); + + it('persists ctx.frameId as __rr_v2__frameId', async () => { + const handler = createMockHandler(async (ctx) => { + ctx.frameId = 5; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.varsPatch).toContainEqual({ + op: 'set', + name: '__rr_v2__frameId', + value: 5, + }); + }); + + it('reads tabId from __rr_v2__tabId var', async () => { + let capturedTabId: number | undefined; + const handler = createMockHandler(async (ctx) => { + capturedTabId = ctx.tabId; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ + tabId: 1, + vars: { __rr_v2__tabId: 99 }, + }); + const node = createMockNode(); + + await nodeDef.execute(ctx, node as any); + + expect(capturedTabId).toBe(99); + }); + + it('reads frameId from __rr_v2__frameId var', async () => { + let capturedFrameId: number | undefined; + const handler = createMockHandler(async (ctx) => { + capturedFrameId = ctx.frameId; + return { status: 'success' }; + }); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context({ + vars: { __rr_v2__frameId: 7 }, + }); + const node = createMockNode(); + + await nodeDef.execute(ctx, node as any); + + expect(capturedFrameId).toBe(7); + }); + + it('supports custom state var names', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + newTabId: 42, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler, { + stateVars: { tabIdVar: 'custom_tab', frameIdVar: 'custom_frame' }, + }); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.varsPatch).toContainEqual({ + op: 'set', + name: 'custom_tab', + value: 42, + }); + }); + }); + + describe('Unsupported V2 behaviors', () => { + it('returns failed for paused status', async () => { + const handler = createMockHandler(async () => ({ + status: 'paused', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.RUN_PAUSED); + }); + + it('returns failed for control directive (foreach)', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + control: { + kind: 'foreach' as const, + listVar: 'items', + itemVar: 'item', + subflowId: 'subflow-1', + }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.UNSUPPORTED_NODE); + expect(result.error?.message).toContain('foreach'); + }); + + it('returns failed for control directive (while)', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + control: { + kind: 'while' as const, + condition: { left: 'a', op: '==', right: 'b' }, + subflowId: 'subflow-1', + maxIterations: 10, + }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.UNSUPPORTED_NODE); + expect(result.error?.message).toContain('while'); + }); + }); + + describe('Output capture', () => { + it('captures output in outputs map', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + output: { extracted: 'data' }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode('extract-node'); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.outputs).toEqual({ + 'extract-node': { extracted: 'data' }, + }); + }); + + it('respects includeOutput: false option', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + output: { extracted: 'data' }, + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler, { + includeOutput: false, + }); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.outputs).toBeUndefined(); + }); + + it('does not include outputs when no output', async () => { + const handler = createMockHandler(async () => ({ + status: 'success', + })); + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.outputs).toBeUndefined(); + }); + }); + + describe('Validation', () => { + it('calls handler validate and returns error on failure', async () => { + const handler: ActionHandler = { + type: 'test' as TestActionType, + validate: () => ({ ok: false, errors: ['Invalid config'] }), + run: async () => ({ status: 'success' }), + }; + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('failed'); + expect(result.error?.code).toBe(RR_ERROR_CODES.VALIDATION_ERROR); + expect(result.error?.message).toContain('Invalid config'); + }); + + it('proceeds with execution when validation passes', async () => { + const handler: ActionHandler = { + type: 'test' as TestActionType, + validate: () => ({ ok: true }), + run: async () => ({ status: 'success' }), + }; + + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(handler); + const ctx = createMockV3Context(); + const node = createMockNode(); + + const result = await nodeDef.execute(ctx, node as any); + + expect(result.status).toBe('succeeded'); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/v2-adapter-integration.test.ts b/app/chrome-extension/tests/record-replay-v3/v2-adapter-integration.test.ts new file mode 100644 index 00000000..54ca8be8 --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/v2-adapter-integration.test.ts @@ -0,0 +1,509 @@ +/** + * @fileoverview V2 Action Adapter integration tests + * @description Tests the full flow of V2 handlers through V3 runner + * + * This test uses real V2 handlers (like 'if') to verify: + * - Handler registration works + * - V3 runner can execute V2 handlers + * - Edge following based on nextLabel + * - Event emission for adapted nodes + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { FlowV3 } from '@/entrypoints/background/record-replay-v3'; +import { + FLOW_SCHEMA_VERSION, + RUN_SCHEMA_VERSION, + closeRrV3Db, + deleteRrV3Db, + resetBreakpointRegistry, +} from '@/entrypoints/background/record-replay-v3'; + +import { PluginRegistry } from '@/entrypoints/background/record-replay-v3/engine/plugins/registry'; +import { ifHandler } from '@/entrypoints/background/record-replay/actions/handlers/control-flow'; +import { delayHandler } from '@/entrypoints/background/record-replay/actions/handlers/delay'; +import { adaptV2ActionHandlerToV3NodeDefinition } from '@/entrypoints/background/record-replay-v3/engine/plugins/v2-action-adapter'; +import { createV3E2EHarness, type V3E2EHarness, type RpcClient } from './v3-e2e-harness'; + +// ==================== Test Fixtures ==================== + +/** + * Create a Flow that uses the 'if' node with branching + */ +function createIfBranchingFlow(id: string, conditionVar: string): FlowV3 { + const iso = new Date(0).toISOString(); + return { + schemaVersion: FLOW_SCHEMA_VERSION, + id, + name: `If Branching Flow ${id}`, + createdAt: iso, + updatedAt: iso, + entryNodeId: 'if-node', + nodes: [ + { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'truthy', + value: { kind: 'var', ref: { name: conditionVar } }, + }, + trueLabel: 'true', + falseLabel: 'false', + }, + }, + { + id: 'true-node', + kind: 'test', + config: { action: 'succeed', outputs: { result: 'true-path' } }, + }, + { + id: 'false-node', + kind: 'test', + config: { action: 'succeed', outputs: { result: 'false-path' } }, + }, + ], + edges: [ + { id: 'e1', from: 'if-node', to: 'true-node', label: 'true' }, + { id: 'e2', from: 'if-node', to: 'false-node', label: 'false' }, + ], + }; +} + +/** + * Create a simple delay flow to test timing-based handlers + */ +function createDelayFlow(id: string, delayMs: number): FlowV3 { + const iso = new Date(0).toISOString(); + return { + schemaVersion: FLOW_SCHEMA_VERSION, + id, + name: `Delay Flow ${id}`, + createdAt: iso, + updatedAt: iso, + entryNodeId: 'delay-node', + nodes: [ + { + id: 'delay-node', + kind: 'delay', + config: { ms: delayMs }, + }, + ], + edges: [], + }; +} + +// ==================== Custom Harness with V2 Handlers ==================== + +/** + * Extended harness that registers real V2 handlers + */ +function createV2IntegrationHarness(): V3E2EHarness { + // First create base harness (which registers 'test' node) + const harness = createV3E2EHarness({ autoStartScheduler: false }); + + // Register V2 handlers via adapter + // Note: We need to access the internal plugins registry + // For this test, we'll directly register to the runner factory's plugins + return harness; +} + +// ==================== Tests ==================== + +describe('V2 Action Adapter Integration', () => { + let h: V3E2EHarness; + let client: RpcClient; + let plugins: PluginRegistry; + + beforeEach(async () => { + await deleteRrV3Db(); + closeRrV3Db(); + resetBreakpointRegistry(); + + // Create harness without auto-starting scheduler + h = createV3E2EHarness({ autoStartScheduler: false }); + client = h.createClient(); + + // Create a separate plugin registry for testing + plugins = new PluginRegistry(); + }); + + afterEach(async () => { + await h.dispose(); + }); + + describe('if handler through adapter', () => { + it('adapts if handler to V3 NodeDefinition', () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + expect(nodeDef.kind).toBe('if'); + expect(typeof nodeDef.execute).toBe('function'); + }); + + it('registers if handler in PluginRegistry', () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + plugins.registerNode(nodeDef as any); + + expect(plugins.hasNode('if')).toBe(true); + expect(plugins.getNode('if')).toBeDefined(); + }); + + it('evaluates truthy condition and returns true label', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { flag: true }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'flag' } } }, + trueLabel: 'yes', + falseLabel: 'no', + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'yes' }); + }); + + it('evaluates falsy condition and returns false label', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { flag: false }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'flag' } } }, + trueLabel: 'yes', + falseLabel: 'no', + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'no' }); + }); + + it('handles compare condition (eq)', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { value: 42 }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'compare', + left: { kind: 'var', ref: { name: 'value' } }, + op: 'eq', + right: 42, + }, + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'true' }); + }); + + it('handles branches mode', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { status: 'pending' }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'branches', + branches: [ + { + label: 'completed', + condition: { + kind: 'compare', + left: { kind: 'var', ref: { name: 'status' } }, + op: 'eq', + right: 'done', + }, + }, + { + label: 'in-progress', + condition: { + kind: 'compare', + left: { kind: 'var', ref: { name: 'status' } }, + op: 'eq', + right: 'pending', + }, + }, + ], + elseLabel: 'unknown', + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + + expect(result.status).toBe('succeeded'); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'in-progress' }); + }); + }); + + describe('delay handler through adapter', () => { + it('adapts delay handler and executes', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(delayHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'delay-node', + tabId: 1, + vars: {}, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'delay-node', + kind: 'delay', + config: { sleep: 10 }, // delay handler uses 'sleep' param + }; + + const startTime = Date.now(); + const result = await nodeDef.execute(mockCtx as any, node as any); + const elapsed = Date.now() - startTime; + + expect(result.status).toBe('succeeded'); + expect(elapsed).toBeGreaterThanOrEqual(9); // Allow some tolerance + }); + + it('supports variable-based delay', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(delayHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'delay-node', + tabId: 1, + vars: { waitTime: 15 }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'delay-node', + kind: 'delay', + config: { + sleep: { kind: 'var', ref: { name: 'waitTime' } }, + }, + }; + + const startTime = Date.now(); + const result = await nodeDef.execute(mockCtx as any, node as any); + const elapsed = Date.now() - startTime; + + expect(result.status).toBe('succeeded'); + expect(elapsed).toBeGreaterThanOrEqual(14); + }); + }); + + describe('Complex conditions', () => { + it('handles AND condition', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { a: true, b: true }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'and', + conditions: [ + { kind: 'truthy', value: { kind: 'var', ref: { name: 'a' } } }, + { kind: 'truthy', value: { kind: 'var', ref: { name: 'b' } } }, + ], + }, + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'true' }); + }); + + it('handles OR condition', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { a: false, b: true }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'or', + conditions: [ + { kind: 'truthy', value: { kind: 'var', ref: { name: 'a' } } }, + { kind: 'truthy', value: { kind: 'var', ref: { name: 'b' } } }, + ], + }, + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'true' }); + }); + + it('handles NOT condition', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { flag: false }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'not', + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'flag' } } }, + }, + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + expect(result.next).toEqual({ kind: 'edgeLabel', label: 'true' }); + }); + + it('handles string comparison operators', async () => { + const nodeDef = adaptV2ActionHandlerToV3NodeDefinition(ifHandler); + + const testCases = [ + { op: 'contains', value: 'hello world', right: 'world', expected: true }, + { op: 'containsI', value: 'Hello World', right: 'WORLD', expected: true }, + { op: 'startsWith', value: 'hello world', right: 'hello', expected: true }, + { op: 'endsWith', value: 'hello world', right: 'world', expected: true }, + { op: 'regex', value: 'test123', right: '\\d+', expected: true }, + ]; + + for (const { op, value, right, expected } of testCases) { + const mockCtx = { + runId: 'run-1', + flow: { policy: {} } as any, + nodeId: 'if-node', + tabId: 1, + vars: { str: value }, + log: vi.fn(), + chooseNext: (label: string) => ({ kind: 'edgeLabel' as const, label }), + artifacts: { screenshot: vi.fn() }, + persistent: { get: vi.fn(), set: vi.fn(), delete: vi.fn() }, + }; + + const node = { + id: 'if-node', + kind: 'if', + config: { + mode: 'binary', + condition: { + kind: 'compare', + left: { kind: 'var', ref: { name: 'str' } }, + op, + right, + }, + }, + }; + + const result = await nodeDef.execute(mockCtx as any, node as any); + const expectedLabel = expected ? 'true' : 'false'; + expect(result.next).toEqual({ kind: 'edgeLabel', label: expectedLabel }); + } + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/v2-to-v3-conversion.test.ts b/app/chrome-extension/tests/record-replay-v3/v2-to-v3-conversion.test.ts new file mode 100644 index 00000000..aa2b31ac --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/v2-to-v3-conversion.test.ts @@ -0,0 +1,344 @@ +/** + * @fileoverview V2 to V3 Flow Conversion Tests + * @description 测试 V2→V3 转换逻辑，特别是 entryNodeId 计算 + */ + +import { describe, it, expect } from 'vitest'; +import { + convertFlowV2ToV3, + convertFlowV3ToV2, +} from '@/entrypoints/background/record-replay-v3/storage/import/v2-to-v3'; + +// ==================== Test Helpers ==================== + +function createV2Flow(overrides: Partial[0]> = {}) { + return { + id: 'test-flow', + name: 'Test Flow', + version: 2, + nodes: [], + edges: [], + ...overrides, + }; +} + +// ==================== entryNodeId Calculation Tests ==================== + +describe('convertFlowV2ToV3 - entryNodeId calculation', () => { + describe('basic scenarios', () => { + it('selects the only executable node as entry', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [{ id: 'nav-1', type: 'navigate' }], + edges: [], + }), + ); + + expect(result.success).toBe(true); + expect(result.data?.entryNodeId).toBe('nav-1'); + expect(result.warnings).toHaveLength(0); + }); + + it('selects node with inDegree=0 as entry', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-1', type: 'navigate' }, + { id: 'click-1', type: 'click' }, + ], + edges: [{ id: 'e1', from: 'nav-1', to: 'click-1' }], + }), + ); + + expect(result.success).toBe(true); + expect(result.data?.entryNodeId).toBe('nav-1'); + }); + }); + + describe('trigger node handling', () => { + it('ignores trigger node when selecting entry', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'trigger-1', type: 'trigger' }, + { id: 'nav-1', type: 'navigate' }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + expect(result.data?.entryNodeId).toBe('nav-1'); + }); + + it('ignores edges from trigger node when calculating inDegree', () => { + // Scenario: trigger → navigate → click + // Without this fix, navigate would have inDegree=1 and not be selected + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'trigger-1', type: 'trigger' }, + { id: 'nav-1', type: 'navigate' }, + { id: 'click-1', type: 'click' }, + ], + edges: [ + { id: 'e1', from: 'trigger-1', to: 'nav-1' }, + { id: 'e2', from: 'nav-1', to: 'click-1' }, + ], + }), + ); + + expect(result.success).toBe(true); + // navigate should be entry because trigger edges are ignored + expect(result.data?.entryNodeId).toBe('nav-1'); + }); + + it('returns error when only trigger nodes exist', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [{ id: 'trigger-1', type: 'trigger' }], + edges: [], + }), + ); + + expect(result.success).toBe(false); + expect(result.errors).toContain('Could not determine entry node. No valid root node found.'); + }); + }); + + describe('multiple root nodes - stable selection', () => { + it('warns and selects by UI coordinates (leftmost, then topmost)', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-b', type: 'navigate', ui: { x: 200, y: 100 } }, + { id: 'nav-a', type: 'navigate', ui: { x: 100, y: 200 } }, + { id: 'nav-c', type: 'navigate', ui: { x: 100, y: 100 } }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // nav-c has smallest x, and smallest y at that x + expect(result.data?.entryNodeId).toBe('nav-c'); + expect(result.warnings.length).toBeGreaterThan(0); + expect(result.warnings.some((w) => w.includes('Multiple inDegree=0'))).toBe(true); + expect(result.warnings.some((w) => w.includes('ui(x=100, y=100)'))).toBe(true); + }); + + it('selects by ID when no UI coordinates available', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-b', type: 'navigate' }, + { id: 'nav-a', type: 'navigate' }, + { id: 'nav-c', type: 'navigate' }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // nav-a comes first alphabetically + expect(result.data?.entryNodeId).toBe('nav-a'); + expect(result.warnings.some((w) => w.includes('by id'))).toBe(true); + }); + + it('uses UI for nodes that have it, ignoring nodes without UI', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-a', type: 'navigate' }, // no UI + { id: 'nav-b', type: 'navigate', ui: { x: 50, y: 50 } }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // nav-b has UI coordinates, so it's preferred + expect(result.data?.entryNodeId).toBe('nav-b'); + }); + }); + + describe('cycle detection', () => { + it('falls back using stable selection when graph has cycle (no inDegree=0)', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-1', type: 'navigate' }, + { id: 'click-1', type: 'click' }, + ], + edges: [ + { id: 'e1', from: 'nav-1', to: 'click-1' }, + { id: 'e2', from: 'click-1', to: 'nav-1' }, + ], + }), + ); + + expect(result.success).toBe(true); + expect(result.data?.entryNodeId).toBeTruthy(); + expect(result.warnings.some((w) => w.includes('cycles'))).toBe(true); + }); + + it('uses stable selection (by id) for cycle fallback', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'z-node', type: 'navigate' }, + { id: 'a-node', type: 'click' }, + ], + edges: [ + { id: 'e1', from: 'z-node', to: 'a-node' }, + { id: 'e2', from: 'a-node', to: 'z-node' }, + ], + }), + ); + + expect(result.success).toBe(true); + // Should select 'a-node' as it comes first alphabetically + expect(result.data?.entryNodeId).toBe('a-node'); + expect(result.warnings.some((w) => w.includes('by id'))).toBe(true); + }); + + it('uses stable selection (by UI) for cycle fallback when UI available', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'a-node', type: 'navigate', ui: { x: 200, y: 100 } }, + { id: 'z-node', type: 'click', ui: { x: 100, y: 100 } }, + ], + edges: [ + { id: 'e1', from: 'a-node', to: 'z-node' }, + { id: 'e2', from: 'z-node', to: 'a-node' }, + ], + }), + ); + + expect(result.success).toBe(true); + // Should select 'z-node' as it has smaller x coordinate + expect(result.data?.entryNodeId).toBe('z-node'); + expect(result.warnings.some((w) => w.includes('ui(x=100'))).toBe(true); + }); + }); + + describe('UI coordinate edge cases', () => { + it('treats NaN coordinates as invalid UI', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-a', type: 'navigate', ui: { x: NaN, y: 100 } }, + { id: 'nav-b', type: 'navigate' }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // Both nodes have no valid UI, should use ID sorting + expect(result.data?.entryNodeId).toBe('nav-a'); + expect(result.warnings.some((w) => w.includes('by id'))).toBe(true); + }); + + it('treats Infinity coordinates as invalid UI', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-a', type: 'navigate', ui: { x: Infinity, y: 100 } }, + { id: 'nav-b', type: 'navigate', ui: { x: 50, y: 50 } }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // Only nav-b has valid UI + expect(result.data?.entryNodeId).toBe('nav-b'); + }); + + it('uses id as tie-breaker when UI coordinates are equal', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [ + { id: 'nav-z', type: 'navigate', ui: { x: 100, y: 100 } }, + { id: 'nav-a', type: 'navigate', ui: { x: 100, y: 100 } }, + ], + edges: [], + }), + ); + + expect(result.success).toBe(true); + // Same coordinates, should use ID as tie-breaker + expect(result.data?.entryNodeId).toBe('nav-a'); + }); + }); + + describe('empty and error cases', () => { + it('returns error when no nodes exist', () => { + const result = convertFlowV2ToV3( + createV2Flow({ + nodes: [], + edges: [], + }), + ); + + expect(result.success).toBe(false); + expect(result.errors).toContain('V2 Flow has no nodes'); + }); + }); +}); + +// ==================== Roundtrip Tests ==================== + +describe('V2 <-> V3 roundtrip conversion', () => { + it('preserves basic flow structure through roundtrip', () => { + const original = createV2Flow({ + name: 'Roundtrip Test', + description: 'Test description', + nodes: [ + { id: 'nav-1', type: 'navigate', config: { url: 'https://example.com' } }, + { id: 'click-1', type: 'click', config: { selector: '#btn' } }, + ], + edges: [{ id: 'e1', from: 'nav-1', to: 'click-1' }], + }); + + const toV3 = convertFlowV2ToV3(original); + expect(toV3.success).toBe(true); + + const backToV2 = convertFlowV3ToV2(toV3.data!); + expect(backToV2.success).toBe(true); + + // Check structure preserved + expect(backToV2.data?.name).toBe(original.name); + expect(backToV2.data?.description).toBe(original.description); + expect(backToV2.data?.nodes).toHaveLength(2); + expect(backToV2.data?.edges).toHaveLength(1); + }); + + it('preserves node configs through roundtrip', () => { + const original = createV2Flow({ + nodes: [ + { + id: 'nav-1', + type: 'navigate', + name: 'Go to site', + disabled: true, + config: { url: 'https://example.com', waitUntil: 'load' }, + ui: { x: 100, y: 200 }, + }, + ], + edges: [], + }); + + const toV3 = convertFlowV2ToV3(original); + const backToV2 = convertFlowV3ToV2(toV3.data!); + + const node = backToV2.data?.nodes?.[0]; + expect(node?.type).toBe('navigate'); + expect(node?.name).toBe('Go to site'); + expect(node?.disabled).toBe(true); + expect(node?.config).toEqual({ url: 'https://example.com', waitUntil: 'load' }); + expect(node?.ui).toEqual({ x: 100, y: 200 }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay-v3/v3-e2e-harness.ts b/app/chrome-extension/tests/record-replay-v3/v3-e2e-harness.ts new file mode 100644 index 00000000..8ee8cfef --- /dev/null +++ b/app/chrome-extension/tests/record-replay-v3/v3-e2e-harness.ts @@ -0,0 +1,585 @@ +/** + * @fileoverview Record-Replay V3 service-level E2E test harness + * @description + * Assembles a complete V3 runtime (IndexedDB storage + scheduler + runner) + * and drives it through RpcServer.handleRequest() to avoid Port mocking complexity. + * + * Design notes: + * - Service-level testing: calls internal handler directly, not through Port + * - Event streaming: reuses RpcServer.broadcastEvent subscription filtering logic + * - waitForTerminal: uses EventsBus subscription to wait for terminal events, avoiding kick() race + * + * WARNING: This harness accesses RpcServer private members (connections/handleRequest/broadcastEvent) + * via type casting. If RpcServer changes to use ES private fields (#private), these tests will break. + * All such access is centralized in getRpcServerInternals() for easier maintenance. + */ + +import { vi } from 'vitest'; +import { z } from 'zod'; + +import type { JsonObject } from '@/entrypoints/background/record-replay-v3/domain/json'; +import type { RunId } from '@/entrypoints/background/record-replay-v3/domain/ids'; +import type { + RunEvent, + RunRecordV3, +} from '@/entrypoints/background/record-replay-v3/domain/events'; +import type { + RunQueueConfig, + RunQueueItem, +} from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import type { StoragePort } from '@/entrypoints/background/record-replay-v3/engine/storage/storage-port'; +import type { EventsBus } from '@/entrypoints/background/record-replay-v3/engine/transport/events-bus'; +import type { + RunScheduler, + RunExecutor, +} from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; +import type { + NodeDefinition, + NodeExecutionResult, +} from '@/entrypoints/background/record-replay-v3/engine/plugins/types'; + +import { createStoragePort, closeRrV3Db } from '@/entrypoints/background/record-replay-v3'; + +import { StorageBackedEventsBus } from '@/entrypoints/background/record-replay-v3/engine/transport/events-bus'; +import { DEFAULT_QUEUE_CONFIG } from '@/entrypoints/background/record-replay-v3/engine/queue/queue'; +import { createLeaseManager } from '@/entrypoints/background/record-replay-v3/engine/queue/leasing'; +import { createRunScheduler } from '@/entrypoints/background/record-replay-v3/engine/queue/scheduler'; +import { InMemoryKeepaliveController } from '@/entrypoints/background/record-replay-v3/engine/keepalive/offscreen-keepalive'; +import { PluginRegistry } from '@/entrypoints/background/record-replay-v3/engine/plugins/registry'; +import { + createRunRunnerFactory, + type RunRunnerFactory, +} from '@/entrypoints/background/record-replay-v3/engine/kernel/runner'; +import { + createRunnerRegistry, + type RunnerRegistry, +} from '@/entrypoints/background/record-replay-v3/engine/kernel/debug-controller'; +import { createNotImplementedArtifactService } from '@/entrypoints/background/record-replay-v3/engine/kernel/artifacts'; +import { RpcServer } from '@/entrypoints/background/record-replay-v3/engine/transport/rpc-server'; +import { + RR_ERROR_CODES, + createRRError, +} from '@/entrypoints/background/record-replay-v3/domain/errors'; +import { isTerminalStatus } from '@/entrypoints/background/record-replay-v3/domain/events'; + +// ==================== Types ==================== + +type Logger = Pick; + +interface TestNodeConfig { + action: 'succeed' | 'fail'; + outputs?: JsonObject; + delayMs?: number; +} + +/** + * E2E Harness 配置选项 + */ +export interface V3E2EHarnessOptions { + /** Owner ID（标识调度器实例） */ + ownerId?: string; + /** 调度器配置覆盖 */ + schedulerConfig?: Partial; + /** 是否自动启动调度器（默认 true） */ + autoStartScheduler?: boolean; + /** 时间源（用于测试注入） */ + now?: () => number; + /** 日志器 */ + logger?: Logger; +} + +/** + * RPC 客户端接口 + */ +export interface RpcClient { + /** 收到的所有消息 */ + readonly messages: unknown[]; + /** 调用 RPC 方法 */ + call(method: string, params?: JsonObject): Promise; + /** 清空消息 */ + clearMessages(): void; + /** 获取流式推送的事件 */ + getStreamedEvents(): RunEvent[]; +} + +/** + * E2E Harness 接口 + */ +export interface V3E2EHarness { + readonly ownerId: string; + readonly storage: StoragePort; + readonly events: EventsBus; + readonly scheduler: RunScheduler; + readonly runners: RunnerRegistry; + readonly rpcServer: RpcServer; + + /** 创建 RPC 客户端 */ + createClient(): RpcClient; + + /** 等待特定事件 */ + waitForEvent( + runId: RunId, + predicate: (event: RunEvent) => boolean, + opts?: { timeoutMs?: number }, + ): Promise; + + /** 等待 Run 到达终态 */ + waitForTerminal(runId: RunId, opts?: { timeoutMs?: number }): Promise; + + /** 等待队列项被移除 */ + waitForQueueItemGone(runId: RunId, opts?: { timeoutMs?: number }): Promise; + + /** 列出 Run 的所有事件 */ + listEvents(runId: RunId): Promise; + + /** 销毁 harness，释放资源 */ + dispose(): Promise; +} + +// ==================== RpcServer Test Internals ==================== + +/** + * RpcServer internal access interface for testing. + * Centralizes all private member access to make maintenance easier. + */ +interface RpcServerInternals { + connections: Map; + handleRequest(req: unknown, conn: RpcConnection): Promise; + broadcastEvent(event: RunEvent): void; +} + +interface RpcConnection { + port: chrome.runtime.Port; + subscriptions: Set; +} + +/** + * Get RpcServer internals for testing. + * WARNING: This accesses private members via type casting. + */ +function getRpcServerInternals(server: RpcServer): RpcServerInternals { + const s = server as unknown as { + connections: Map; + handleRequest: (req: unknown, conn: RpcConnection) => Promise; + broadcastEvent: (event: RunEvent) => void; + }; + return { + connections: s.connections, + handleRequest: s.handleRequest.bind(s), + broadcastEvent: s.broadcastEvent.bind(s), + }; +} + +// ==================== Utilities ==================== + +function createSilentLogger(): Logger { + return { + debug: () => {}, + info: () => {}, + warn: () => {}, + error: () => {}, + }; +} + +function sleep(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)); +} + +/** + * 创建测试用 Node 定义 + * @description 一个简单的测试节点，支持成功/失败/延迟 + */ +function createTestNodeDefinition(): NodeDefinition<'test', TestNodeConfig> { + return { + kind: 'test', + schema: z + .object({ + action: z.enum(['succeed', 'fail']), + outputs: z.record(z.any()).optional(), + delayMs: z.number().optional(), + }) + .passthrough() as z.ZodType, + execute: async (_ctx, node): Promise => { + const cfg = node.config as unknown as TestNodeConfig; + + // 模拟延迟 + if (cfg.delayMs && cfg.delayMs > 0) { + await sleep(cfg.delayMs); + } + + if (cfg.action === 'fail') { + return { + status: 'failed', + error: createRRError(RR_ERROR_CODES.TOOL_ERROR, 'Test node intentionally failed'), + }; + } + + return { + status: 'succeeded', + ...(cfg.outputs ? { outputs: cfg.outputs } : {}), + }; + }, + }; +} + +// ==================== Factory ==================== + +/** + * 创建 V3 E2E 测试 harness + * @description 组装完整的 V3 runtime 用于集成测试 + */ +export function createV3E2EHarness(options: V3E2EHarnessOptions = {}): V3E2EHarness { + const logger = options.logger ?? createSilentLogger(); + const now = options.now ?? (() => Date.now()); + const ownerId = options.ownerId ?? 'e2e-owner'; + + // 1) Storage + const storage = createStoragePort(); + + // 2) EventsBus + const events = new StorageBackedEventsBus(storage.events); + + // 3) Plugins - 注册测试节点 + const plugins = new PluginRegistry(); + plugins.registerNode(createTestNodeDefinition()); + + // 4) RunnerRegistry + const runners = createRunnerRegistry(); + + // 5) RunRunnerFactory + const runnerFactory = createRunRunnerFactory({ + storage, + events, + plugins, + now, + artifactService: createNotImplementedArtifactService(), + }); + + // 6) RunExecutor - 连接 scheduler 和 runner + const execute: RunExecutor = createE2EExecutor({ + storage, + events, + runnerFactory, + runners, + now, + logger, + }); + + // 7) Scheduler 配置 + const config: RunQueueConfig = { + ...DEFAULT_QUEUE_CONFIG, + maxParallelRuns: 1, + ...options.schedulerConfig, + }; + + // 8) Keepalive + LeaseManager + Scheduler + const keepalive = new InMemoryKeepaliveController(); + const leaseManager = createLeaseManager(storage.queue, config); + + const scheduler = createRunScheduler({ + queue: storage.queue, + leaseManager, + keepalive, + config, + ownerId, + execute, + now, + tuning: { pollIntervalMs: 0, reclaimIntervalMs: 0 }, + logger, + }); + + // 9) RpcServer + const rpcServer = new RpcServer({ + storage, + events, + scheduler, + runners, + now, + }); + + // Get internals via centralized helper + const rpcInternals = getRpcServerInternals(rpcServer); + + // 10) Forward EventsBus events to RpcServer.broadcastEvent + const unsubscribeForward = events.subscribe((event) => { + try { + rpcInternals.broadcastEvent(event); + } catch (e) { + logger.warn('[V3E2EHarness] broadcastEvent failed:', e); + } + }); + + // 11) Start scheduler if configured + if (options.autoStartScheduler ?? true) { + scheduler.start(); + } + + // Client management + let clientSeq = 0; + let requestSeq = 0; + const clientConnIds = new Set(); + + function createClient(): RpcClient { + const connId = `e2e-conn-${++clientSeq}`; + const messages: unknown[] = []; + + const port = { + postMessage: (msg: unknown) => { + messages.push(msg); + }, + disconnect: vi.fn(), + } as unknown as chrome.runtime.Port; + + const connection: RpcConnection = { + port, + subscriptions: new Set(), + }; + + // Inject into RpcServer internals so broadcastEvent() can push to this client + rpcInternals.connections.set(connId, connection); + clientConnIds.add(connId); + + return { + messages, + call: async (method: string, params?: JsonObject): Promise => { + const req = { + type: 'rr_v3.request' as const, + requestId: `e2e-req-${++requestSeq}`, + method, + ...(params ? { params } : {}), + }; + return rpcInternals.handleRequest(req, connection); + }, + clearMessages: () => { + messages.splice(0, messages.length); + }, + getStreamedEvents: () => { + return messages + .filter( + (m): m is { type: 'rr_v3.event'; event: RunEvent } => + typeof m === 'object' && + m !== null && + (m as { type?: string }).type === 'rr_v3.event', + ) + .map((m) => m.event); + }, + }; + } + + async function waitForEvent( + runId: RunId, + predicate: (event: RunEvent) => boolean, + opts?: { timeoutMs?: number }, + ): Promise { + const timeoutMs = opts?.timeoutMs ?? 5_000; + + // Fast-path: 检查已持久化的事件 + try { + const existing = await storage.events.list(runId); + const found = existing.find(predicate); + if (found) return found; + } catch { + // ignore and fall back to subscription + } + + return new Promise((resolve, reject) => { + const timer = setTimeout(() => { + unsubscribe(); + reject(new Error(`Timed out waiting for event (runId=${runId})`)); + }, timeoutMs); + + const unsubscribe = events.subscribe( + (event) => { + if (!predicate(event)) return; + clearTimeout(timer); + unsubscribe(); + resolve(event); + }, + { runId }, + ); + }); + } + + async function waitForTerminal( + runId: RunId, + opts?: { timeoutMs?: number }, + ): Promise { + const timeoutMs = opts?.timeoutMs ?? 10_000; + + // 先检查当前状态 + const initial = await storage.runs.get(runId); + if (!initial) { + throw new Error(`Run "${runId}" not found`); + } + if (isTerminalStatus(initial.status)) { + return initial; + } + + // 等待终态事件 + await waitForEvent( + runId, + (e) => e.type === 'run.succeeded' || e.type === 'run.failed' || e.type === 'run.canceled', + { timeoutMs }, + ); + + const done = await storage.runs.get(runId); + if (!done) { + throw new Error(`Run "${runId}" not found after terminal event`); + } + return done; + } + + async function waitForQueueItemGone(runId: RunId, opts?: { timeoutMs?: number }): Promise { + const timeoutMs = opts?.timeoutMs ?? 5_000; + const startedAt = Date.now(); + + for (;;) { + const item = await storage.queue.get(runId); + if (!item) return; + + if (Date.now() - startedAt >= timeoutMs) { + throw new Error( + `Timed out waiting for queue item to be removed (runId=${runId}, status=${item.status})`, + ); + } + + await sleep(10); + } + } + + async function listEvents(runId: RunId): Promise { + return storage.events.list(runId); + } + + async function dispose(): Promise { + // 取消事件转发 + try { + unsubscribeForward(); + } catch { + // ignore + } + + // 停止 scheduler + try { + scheduler.dispose(); + } catch { + // ignore + } + + // 释放 lease manager + try { + leaseManager.dispose(); + } catch { + // ignore + } + + // Remove injected client connections + for (const connId of clientConnIds) { + rpcInternals.connections.delete(connId); + } + clientConnIds.clear(); + + // 关闭 IDB 连接 + closeRrV3Db(); + } + + return { + ownerId, + storage, + events, + scheduler, + runners, + rpcServer, + createClient, + waitForEvent, + waitForTerminal, + waitForQueueItemGone, + listEvents, + dispose, + }; +} + +// ==================== Internal Helpers ==================== + +/** + * 创建 E2E 测试用的 RunExecutor + */ +function createE2EExecutor(deps: { + storage: StoragePort; + events: EventsBus; + runnerFactory: RunRunnerFactory; + runners: RunnerRegistry; + now: () => number; + logger: Logger; +}): RunExecutor { + return async (item: RunQueueItem): Promise => { + const runId = item.id; + + // 1. 获取 RunRecord + const run = await deps.storage.runs.get(runId); + if (!run) { + deps.logger.warn(`[E2E] RunRecord not found for queue item "${runId}", skipping`); + return; + } + + // 2. 获取 Flow + const flow = await deps.storage.flows.get(item.flowId); + if (!flow) { + await failRun(deps, runId, `Flow "${item.flowId}" not found`); + return; + } + + // 3. 同步 attempt/tabId 到 RunRecord + const tabId = item.tabId ?? run.tabId ?? 1; + try { + await deps.storage.runs.patch(runId, { + attempt: item.attempt, + maxAttempts: item.maxAttempts, + tabId, + }); + } catch { + // ignore + } + + // 4. 创建并运行 Runner + const runner = deps.runnerFactory.create(runId, { + flow, + tabId, + args: item.args ?? run.args, + startNodeId: run.startNodeId, + debug: item.debug ?? run.debug, + }); + + deps.runners.register(runId, runner); + try { + await runner.start(); + } finally { + deps.runners.unregister(runId); + } + }; +} + +/** + * 将 Run 标记为失败 + */ +async function failRun( + deps: { storage: StoragePort; events: EventsBus; now: () => number }, + runId: RunId, + message: string, +): Promise { + const t = deps.now(); + const error = createRRError(RR_ERROR_CODES.VALIDATION_ERROR, message); + + await deps.storage.runs.patch(runId, { + status: 'failed', + finishedAt: t, + tookMs: 0, + error, + }); + + await deps.events.append({ + runId, + type: 'run.failed', + error, + }); +} diff --git a/app/chrome-extension/tests/record-replay/_test-helpers.ts b/app/chrome-extension/tests/record-replay/_test-helpers.ts new file mode 100644 index 00000000..6f509c41 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/_test-helpers.ts @@ -0,0 +1,82 @@ +/** + * Test helpers for record-replay contract tests. + * + * Provides minimal factories and mocks for testing the execution pipeline + * without requiring real browser or tool dependencies. + */ + +import { vi } from 'vitest'; +import type { ExecCtx } from '@/entrypoints/background/record-replay/nodes/types'; +import type { ActionExecutionContext } from '@/entrypoints/background/record-replay/actions/types'; + +/** + * Create a minimal ExecCtx for testing + */ +export function createMockExecCtx(overrides: Partial = {}): ExecCtx { + return { + vars: {}, + logger: vi.fn(), + ...overrides, + }; +} + +/** + * Create a minimal ActionExecutionContext for testing + */ +export function createMockActionCtx( + overrides: Partial = {}, +): ActionExecutionContext { + return { + vars: {}, + tabId: 1, + log: vi.fn(), + ...overrides, + }; +} + +/** + * Create a minimal Step for testing + */ +export function createMockStep(type: string, overrides: Record = {}): any { + return { + id: `step_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`, + type, + ...overrides, + }; +} + +/** + * Create a minimal Flow for testing (with nodes/edges for scheduler) + */ +export function createMockFlow(overrides: Record = {}): any { + const id = `flow_${Date.now()}`; + return { + id, + name: 'Test Flow', + version: 1, + steps: [], + nodes: [], + edges: [], + variables: [], + meta: { + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }, + ...overrides, + }; +} + +/** + * Create a mock ActionRegistry for testing + */ +export function createMockRegistry(handlers: Map = new Map()) { + const executeFn = vi.fn(async () => ({ status: 'success' as const })); + + return { + get: vi.fn((type: string) => handlers.get(type) || { type }), + execute: executeFn, + register: vi.fn(), + has: vi.fn((type: string) => handlers.has(type)), + _executeFn: executeFn, // Expose for assertions + }; +} diff --git a/app/chrome-extension/tests/record-replay/adapter-policy.contract.test.ts b/app/chrome-extension/tests/record-replay/adapter-policy.contract.test.ts new file mode 100644 index 00000000..1572f751 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/adapter-policy.contract.test.ts @@ -0,0 +1,155 @@ +/** + * Adapter Policy Contract Tests + * + * Verifies that skipRetry and skipNavWait flags correctly modify + * action execution behavior: + * - skipRetry: removes action.policy.retry before execution + * - skipNavWait: sets ctx.execution.skipNavWait for handlers + */ + +import { describe, expect, it, vi, beforeEach } from 'vitest'; +import { createStepExecutor } from '@/entrypoints/background/record-replay/actions/adapter'; +import { createMockExecCtx, createMockStep } from './_test-helpers'; + +describe('adapter policy flags contract', () => { + let registryExecute: ReturnType; + let mockRegistry: any; + + beforeEach(() => { + registryExecute = vi.fn(async () => ({ status: 'success' })); + mockRegistry = { + get: vi.fn(() => ({ type: 'fill' })), // Returns truthy = handler exists + execute: registryExecute, + }; + }); + + describe('skipRetry flag', () => { + it('removes action.policy.retry when skipRetry is true', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('fill', { + retry: { count: 3, intervalMs: 100, backoff: 'exp' }, + target: { candidates: [{ type: 'css', value: '#input' }] }, + value: 'test', + }), + 1, // tabId + { skipRetry: true }, + ); + + expect(registryExecute).toHaveBeenCalledTimes(1); + const [, action] = registryExecute.mock.calls[0]; + expect(action.policy?.retry).toBeUndefined(); + }); + + it('preserves action.policy.retry when skipRetry is false', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('fill', { + retry: { count: 3, intervalMs: 100, backoff: 'exp' }, + target: { candidates: [{ type: 'css', value: '#input' }] }, + value: 'test', + }), + 1, + { skipRetry: false }, + ); + + expect(registryExecute).toHaveBeenCalledTimes(1); + const [, action] = registryExecute.mock.calls[0]; + expect(action.policy?.retry).toBeDefined(); + expect(action.policy.retry.retries).toBe(3); + }); + + it('preserves action.policy.retry when skipRetry is not specified', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('fill', { + retry: { count: 2, intervalMs: 50 }, + target: { candidates: [{ type: 'css', value: '#input' }] }, + value: 'test', + }), + 1, + {}, // No skipRetry + ); + + const [, action] = registryExecute.mock.calls[0]; + expect(action.policy?.retry).toBeDefined(); + }); + }); + + describe('skipNavWait flag', () => { + it('sets ctx.execution.skipNavWait when skipNavWait is true', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('click', { + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }), + 1, + { skipNavWait: true }, + ); + + expect(registryExecute).toHaveBeenCalledTimes(1); + const [actionCtx] = registryExecute.mock.calls[0]; + expect(actionCtx.execution?.skipNavWait).toBe(true); + }); + + it('does not set ctx.execution when skipNavWait is false', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('click', { + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }), + 1, + { skipNavWait: false }, + ); + + const [actionCtx] = registryExecute.mock.calls[0]; + expect(actionCtx.execution).toBeUndefined(); + }); + + it('does not set ctx.execution when skipNavWait is not specified', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('navigate', { + url: 'https://example.com', + }), + 1, + {}, // No skipNavWait + ); + + const [actionCtx] = registryExecute.mock.calls[0]; + expect(actionCtx.execution).toBeUndefined(); + }); + }); + + describe('combined flags', () => { + it('applies both skipRetry and skipNavWait together', async () => { + const executor = createStepExecutor(mockRegistry); + + await executor( + createMockExecCtx(), + createMockStep('click', { + retry: { count: 5, intervalMs: 200 }, + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }), + 1, + { skipRetry: true, skipNavWait: true }, + ); + + const [actionCtx, action] = registryExecute.mock.calls[0]; + expect(action.policy?.retry).toBeUndefined(); + expect(actionCtx.execution?.skipNavWait).toBe(true); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/flow-store-strip-steps.contract.test.ts b/app/chrome-extension/tests/record-replay/flow-store-strip-steps.contract.test.ts new file mode 100644 index 00000000..fa601247 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/flow-store-strip-steps.contract.test.ts @@ -0,0 +1,280 @@ +/** + * Flow Store Steps Stripping Contract Tests + * + * Verifies that flow-store correctly strips deprecated steps field before persistence: + * - saveFlow() strips steps after normalization + * - lazyNormalize() strips steps when persisting normalized flow + * - importFlowFromJson() strips steps via saveFlow() + * + * These tests ensure new saves only contain the DAG model (nodes/edges). + */ + +import { describe, expect, it, beforeEach, vi, afterEach } from 'vitest'; + +// Use vi.hoisted to ensure mocks are available before module load +const mocks = vi.hoisted(() => ({ + save: vi.fn(), + get: vi.fn(), + list: vi.fn(), + delete: vi.fn(), + ensureMigratedFromLocal: vi.fn(), + sendMessage: vi.fn(), +})); + +// Mock IndexedDbStorage before importing flow-store +vi.mock('@/entrypoints/background/record-replay/storage/indexeddb-manager', () => ({ + ensureMigratedFromLocal: mocks.ensureMigratedFromLocal.mockResolvedValue(undefined), + IndexedDbStorage: { + flows: { + save: mocks.save, + get: mocks.get, + list: mocks.list, + delete: mocks.delete, + }, + runs: { list: vi.fn().mockResolvedValue([]), replaceAll: vi.fn() }, + published: { list: vi.fn().mockResolvedValue([]), save: vi.fn(), delete: vi.fn() }, + schedules: { list: vi.fn().mockResolvedValue([]), save: vi.fn(), delete: vi.fn() }, + }, +})); + +// Mock chrome.runtime.sendMessage +vi.stubGlobal('chrome', { + runtime: { + sendMessage: mocks.sendMessage.mockResolvedValue(undefined), + }, +}); + +import { + saveFlow, + getFlow, + importFlowFromJson, +} from '@/entrypoints/background/record-replay/flow-store'; +import type { Flow } from '@/entrypoints/background/record-replay/types'; + +function createTestFlow(overrides: Partial = {}): Flow { + return { + id: `test_flow_${Date.now()}`, + name: 'Test Flow', + version: 1, + meta: { + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }, + ...overrides, + }; +} + +describe('Flow Store steps stripping', () => { + beforeEach(() => { + vi.clearAllMocks(); + mocks.save.mockResolvedValue(undefined); + mocks.get.mockResolvedValue(undefined); + mocks.list.mockResolvedValue([]); + }); + + afterEach(() => { + vi.useRealTimers(); + }); + + describe('saveFlow strips steps', () => { + it('saves flow without steps field when steps is present', async () => { + const flow = createTestFlow({ + steps: [{ id: 's1', type: 'click' } as any], + nodes: [{ id: 's1', type: 'click', config: {} }], + edges: [], + }); + + await saveFlow(flow); + + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(1); + }); + + it('preserves flow without steps when no steps present', async () => { + const flow = createTestFlow({ + nodes: [{ id: 's1', type: 'click', config: {} }], + edges: [], + }); + + await saveFlow(flow); + + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(1); + }); + + it('normalizes and strips: generates nodes from steps then removes steps', async () => { + // Flow with only steps (no nodes) - should normalize to nodes then strip steps + const flow = createTestFlow({ + steps: [ + { id: 's1', type: 'click' } as any, + { id: 's2', type: 'fill', value: 'test' } as any, + ], + }); + + await saveFlow(flow); + + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(2); + expect(savedFlow.edges).toHaveLength(1); + }); + }); + + describe('getFlow lazy normalize strips steps', () => { + it('strips steps when lazy normalizing legacy flow', async () => { + // Mock a legacy flow with only steps (no nodes) + const legacyFlow = createTestFlow({ + id: 'legacy_flow', + steps: [{ id: 's1', type: 'click' } as any], + nodes: undefined, + }); + mocks.get.mockResolvedValue(legacyFlow); + + const result = await getFlow('legacy_flow'); + + // Flow returned to caller has nodes but NOT steps + expect(result).toBeDefined(); + expect(result!.nodes).toHaveLength(1); + expect(result).not.toHaveProperty('steps'); + + // Saved flow should also not have steps + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(1); + }); + + it('does not save but still strips steps when flow already has nodes', async () => { + // Flow with nodes and steps - should not save but should strip steps on return + const normalFlow = createTestFlow({ + id: 'normal_flow', + steps: [{ id: 's1', type: 'click' } as any], // legacy steps still in storage + nodes: [{ id: 's1', type: 'click', config: {} }], + edges: [], + }); + mocks.get.mockResolvedValue(normalFlow); + + const result = await getFlow('normal_flow'); + + expect(result).toBeDefined(); + expect(result).not.toHaveProperty('steps'); // returned flow should NOT have steps + expect(result!.nodes).toHaveLength(1); + expect(mocks.save).not.toHaveBeenCalled(); // no re-save needed + }); + }); + + describe('importFlowFromJson strips steps', () => { + it('imports flow with steps, saves without steps', async () => { + const json = JSON.stringify({ + id: 'imported_flow', + name: 'Imported Flow', + version: 1, + steps: [ + { id: 's1', type: 'click' }, + { id: 's2', type: 'fill', value: 'hello' }, + ], + }); + + await importFlowFromJson(json); + + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(2); + expect(savedFlow.edges).toHaveLength(1); + }); + + it('imports flow with nodes, saves without steps', async () => { + const json = JSON.stringify({ + id: 'imported_flow', + name: 'Imported Flow', + version: 1, + nodes: [ + { id: 'n1', type: 'click', config: {} }, + { id: 'n2', type: 'fill', config: { value: 'hello' } }, + ], + edges: [{ id: 'e1', from: 'n1', to: 'n2' }], + }); + + await importFlowFromJson(json); + + expect(mocks.save).toHaveBeenCalledTimes(1); + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + expect(savedFlow.nodes).toHaveLength(2); + }); + + it('handles flow array import', async () => { + const json = JSON.stringify([ + { id: 'f1', name: 'Flow 1', steps: [{ id: 's1', type: 'click' }] }, + { id: 'f2', name: 'Flow 2', nodes: [{ id: 'n1', type: 'fill', config: {} }], edges: [] }, + ]); + + await importFlowFromJson(json); + + expect(mocks.save).toHaveBeenCalledTimes(2); + + // First flow: steps normalized and stripped + const savedFlow1 = mocks.save.mock.calls[0][0]; + expect(savedFlow1.id).toBe('f1'); + expect(savedFlow1).not.toHaveProperty('steps'); + expect(savedFlow1.nodes).toHaveLength(1); + + // Second flow: already has nodes, no steps + const savedFlow2 = mocks.save.mock.calls[1][0]; + expect(savedFlow2.id).toBe('f2'); + expect(savedFlow2).not.toHaveProperty('steps'); + expect(savedFlow2.nodes).toHaveLength(1); + }); + }); + + describe('edge cases', () => { + it('handles empty steps array', async () => { + const flow = createTestFlow({ + steps: [], + nodes: [{ id: 'n1', type: 'click', config: {} }], + edges: [], + }); + + await saveFlow(flow); + + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow).not.toHaveProperty('steps'); + }); + + it('preserves all other flow properties', async () => { + const flow = createTestFlow({ + id: 'preserve_test', + name: 'Preserve Test', + description: 'Test description', + version: 5, + steps: [{ id: 's1', type: 'click' } as any], + nodes: [{ id: 's1', type: 'click', config: {} }], + edges: [], + variables: [{ key: 'var1', type: 'string' }], + meta: { + createdAt: '2024-01-01T00:00:00Z', + updatedAt: '2024-01-02T00:00:00Z', + domain: 'example.com', + tags: ['test', 'example'], + }, + }); + + await saveFlow(flow); + + const savedFlow = mocks.save.mock.calls[0][0]; + expect(savedFlow.id).toBe('preserve_test'); + expect(savedFlow.name).toBe('Preserve Test'); + expect(savedFlow.description).toBe('Test description'); + expect(savedFlow.version).toBe(5); + expect(savedFlow.variables).toHaveLength(1); + expect(savedFlow.meta.domain).toBe('example.com'); + expect(savedFlow.meta.tags).toEqual(['test', 'example']); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/high-risk-actions.integration.test.ts b/app/chrome-extension/tests/record-replay/high-risk-actions.integration.test.ts new file mode 100644 index 00000000..cb20fa07 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/high-risk-actions.integration.test.ts @@ -0,0 +1,481 @@ +/** + * High Risk Actions Integration Tests (M3-full batch 2) + * + * Purpose: + * Verify that high-risk step types (click, navigate, tabs) are properly routed + * based on hybrid allowlist configuration, and that skipNavWait policy works correctly. + * + * Test Strategy: + * - Use real HybridStepExecutor + real ActionRegistry + real handlers + * - Mock only environment boundaries: + * - chrome.* APIs (tabs, windows) + * - handleCallTool (tool bridge) + * - selectorLocator.locate (element location) + * - navigation wait functions + * + * Coverage: + * - Default hybrid: click/navigate/openTab/switchTab route to legacy + * - Opt-in: click/navigate can route to actions with custom allowlist + * - skipNavWait: controls whether navigate handler does internal nav-wait + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; + +// ============================================================================= +// Mock Setup (using vi.hoisted for proper hoisting) +// ============================================================================= + +const mocks = vi.hoisted(() => ({ + handleCallTool: vi.fn(), + locate: vi.fn(), + tabsSendMessage: vi.fn(), + tabsGet: vi.fn(), + tabsQuery: vi.fn(), + tabsCreate: vi.fn(), + tabsUpdate: vi.fn(), + windowsCreate: vi.fn(), + windowsUpdate: vi.fn(), + waitForNavigationDone: vi.fn(), + ensureReadPageIfWeb: vi.fn(), + maybeQuickWaitForNav: vi.fn(), + waitForNetworkIdle: vi.fn(), +})); + +// Mock tool bridge +vi.mock('@/entrypoints/background/tools', () => ({ + handleCallTool: mocks.handleCallTool, +})); + +// Mock selector locator +vi.mock('@/shared/selector', async (importOriginal) => { + const actual = await importOriginal(); + return { + ...actual, + createChromeSelectorLocator: () => ({ + locate: mocks.locate, + }), + }; +}); + +// Mock navigation wait wrappers to avoid real webNavigation waiting +vi.mock('@/entrypoints/background/record-replay/engine/policies/wait', () => ({ + waitForNavigationDone: mocks.waitForNavigationDone, + ensureReadPageIfWeb: mocks.ensureReadPageIfWeb, + maybeQuickWaitForNav: mocks.maybeQuickWaitForNav, + waitForNetworkIdle: mocks.waitForNetworkIdle, +})); + +// ============================================================================= +// Imports (after mocks) +// ============================================================================= + +import { createMockExecCtx } from './_test-helpers'; +import { createHybridConfig } from '@/entrypoints/background/record-replay/engine/execution-mode'; +import { HybridStepExecutor } from '@/entrypoints/background/record-replay/engine/runners/step-executor'; +import { createReplayActionRegistry } from '@/entrypoints/background/record-replay/actions'; + +// ============================================================================= +// Test Constants +// ============================================================================= + +const TAB_ID = 1; +const OTHER_TAB_ID = 2; +const FRAME_ID = 0; + +// ============================================================================= +// Helper Types and Functions +// ============================================================================= + +interface TestStep { + id: string; + type: string; + [key: string]: unknown; +} + +/** + * Create executor with configurable hybrid config + */ +function createExecutor(overrides?: Parameters[0]): HybridStepExecutor { + const registry = createReplayActionRegistry(); + const config = createHybridConfig(overrides); + return new HybridStepExecutor(registry, config); +} + +/** + * Setup default mock responses for handleCallTool + */ +function setupDefaultToolMock(): void { + mocks.handleCallTool.mockImplementation(async () => ({})); +} + +/** + * Setup default mock responses for chrome.tabs.sendMessage + */ +function setupDefaultTabsMessageMock(): void { + mocks.tabsSendMessage.mockImplementation(async (_tabId: number, message: unknown) => { + const msg = message as { action?: string }; + switch (msg.action) { + case TOOL_MESSAGE_TYPES.ENSURE_REF_FOR_SELECTOR: + return { success: true, ref: 'ref_from_selector', center: { x: 1, y: 1 } }; + case TOOL_MESSAGE_TYPES.RESOLVE_REF: + return { success: true, rect: { width: 100, height: 20 }, center: { x: 1, y: 1 } }; + default: + return { success: true }; + } + }); +} + +/** + * Setup default mock responses for chrome.tabs.query + */ +function setupDefaultTabsQueryMock(): void { + mocks.tabsQuery.mockImplementation(async (queryInfo?: unknown) => { + const q = queryInfo as Record | undefined; + if (q?.active === true) { + return [{ id: TAB_ID, url: 'https://example.com/', status: 'complete', windowId: 1 }]; + } + return [ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Example', + status: 'complete', + windowId: 1, + }, + { + id: OTHER_TAB_ID, + url: 'https://other.example.com/', + title: 'Other', + status: 'complete', + windowId: 2, + }, + ]; + }); +} + +/** + * Setup default mock responses for chrome.tabs.get + */ +function setupDefaultTabsGetMock(): void { + mocks.tabsGet.mockImplementation(async (tabId: number) => { + if (tabId === TAB_ID) { + return { id: TAB_ID, url: 'https://before.example/', status: 'complete', windowId: 1 }; + } + if (tabId === OTHER_TAB_ID) { + return { + id: OTHER_TAB_ID, + url: 'https://other.example.com/', + status: 'complete', + windowId: 2, + }; + } + return { id: tabId, url: 'https://unknown.example/', status: 'complete', windowId: 1 }; + }); +} + +// ============================================================================= +// Test Suite +// ============================================================================= + +describe('high-risk actions integration (M3-full batch 2)', () => { + beforeEach(() => { + // Reset all mocks + Object.values(mocks).forEach((mock) => mock.mockReset()); + + // Default behaviors + setupDefaultToolMock(); + setupDefaultTabsMessageMock(); + setupDefaultTabsQueryMock(); + setupDefaultTabsGetMock(); + + // Default selector locate result + mocks.locate.mockResolvedValue({ ref: 'ref_default', frameId: FRAME_ID, resolvedBy: 'css' }); + + // Default tab/window operations + mocks.tabsCreate.mockResolvedValue({ id: OTHER_TAB_ID }); + mocks.tabsUpdate.mockResolvedValue({}); + mocks.windowsCreate.mockResolvedValue({ tabs: [{ id: OTHER_TAB_ID }] }); + mocks.windowsUpdate.mockResolvedValue({}); + + // Default wait wrappers (no-op) + mocks.waitForNavigationDone.mockResolvedValue(undefined); + mocks.ensureReadPageIfWeb.mockResolvedValue(undefined); + mocks.maybeQuickWaitForNav.mockResolvedValue(undefined); + mocks.waitForNetworkIdle.mockResolvedValue(undefined); + + // Stub chrome.* globals + vi.stubGlobal('chrome', { + tabs: { + sendMessage: mocks.tabsSendMessage, + get: mocks.tabsGet, + query: mocks.tabsQuery, + create: mocks.tabsCreate, + update: mocks.tabsUpdate, + }, + windows: { + create: mocks.windowsCreate, + update: mocks.windowsUpdate, + }, + webNavigation: { + getAllFrames: vi.fn(async () => []), + }, + }); + }); + + afterEach(() => { + vi.unstubAllGlobals(); + vi.useRealTimers(); + }); + + // =========================================================================== + // Routing Tests (default hybrid allowlist) + // =========================================================================== + + describe('routing (default hybrid allowlist)', () => { + it('click routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'click_routing_legacy', + type: 'click', + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + // Actions locator is only used by ActionRegistry handlers + expect(mocks.locate).not.toHaveBeenCalled(); + }); + + it('dblclick routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'dblclick_routing_legacy', + type: 'dblclick', + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + expect(mocks.locate).not.toHaveBeenCalled(); + }); + + it('navigate routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'navigate_routing_legacy', + type: 'navigate', + url: 'https://example.com/next', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('openTab routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'openTab_routing_legacy', + type: 'openTab', + url: 'https://example.com/new', + newWindow: false, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('switchTab routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchTab_routing_legacy', + type: 'switchTab', + urlContains: 'other.example.com', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + }); + + // =========================================================================== + // Opt-in Actions Tests + // =========================================================================== + + describe('click/navigate actions opt-in', () => { + it('click routes to actions when allowlisted', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['click']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'click_allowlisted_actions', + type: 'click', + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.locate).toHaveBeenCalled(); + + const toolCalls = mocks.handleCallTool.mock.calls.map( + ([arg]) => (arg as { name: string }).name, + ); + expect(toolCalls).toContain(TOOL_NAMES.BROWSER.READ_PAGE); + expect(toolCalls).toContain(TOOL_NAMES.BROWSER.CLICK); + + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.CLICK, + args: expect.objectContaining({ tabId: TAB_ID }), + }), + ); + }); + + it('navigate skipNavWait=true skips beforeUrl read', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['navigate']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'navigate_skipNavWait_true', + type: 'navigate', + url: 'https://example.com/next', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // When skipNavWait=true (default), handler skips reading beforeUrl + expect(mocks.tabsGet).not.toHaveBeenCalled(); + expect(mocks.waitForNavigationDone).not.toHaveBeenCalled(); + expect(mocks.ensureReadPageIfWeb).not.toHaveBeenCalled(); + + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.NAVIGATE, + args: expect.objectContaining({ url: 'https://example.com/next', tabId: TAB_ID }), + }), + ); + }); + + it('navigate skipNavWait=false does nav-wait', async () => { + const executor = createExecutor({ + actionsAllowlist: new Set(['navigate']), + skipActionsNavWait: false, + }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'navigate_skipNavWait_false', + type: 'navigate', + url: 'https://example.com/next', + timeoutMs: 5000, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // When skipNavWait=false, handler reads beforeUrl and does nav-wait + expect(mocks.tabsGet).toHaveBeenCalled(); + expect(mocks.waitForNavigationDone).toHaveBeenCalledWith( + 'https://before.example/', + expect.any(Number), + ); + expect(mocks.ensureReadPageIfWeb).toHaveBeenCalled(); + + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.NAVIGATE, + args: expect.objectContaining({ url: 'https://example.com/next', tabId: TAB_ID }), + }), + ); + }); + + it('navigate with refresh=true calls NAVIGATE tool with refresh', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['navigate']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'navigate_refresh', + type: 'navigate', + refresh: true, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.NAVIGATE, + args: expect.objectContaining({ refresh: true, tabId: TAB_ID }), + }), + ); + }); + + it('click fails when element not visible', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['click']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // Mock resolveRef to return element not visible + mocks.tabsSendMessage.mockImplementation(async (_tabId: number, message: unknown) => { + const msg = message as { action?: string }; + if (msg.action === TOOL_MESSAGE_TYPES.RESOLVE_REF) { + return { success: true, rect: { width: 0, height: 0 }, center: { x: 0, y: 0 } }; + } + return { success: true }; + }); + + const step: TestStep = { + id: 'click_not_visible', + type: 'click', + target: { candidates: [{ type: 'css', value: '#hidden-btn' }] }, + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /not visible|ELEMENT_NOT_VISIBLE/i, + ); + }); + + it('click fails when CLICK tool returns error', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['click']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // Mock CLICK tool to return error + mocks.handleCallTool.mockImplementation(async (req: { name: string }) => { + if (req.name === TOOL_NAMES.BROWSER.CLICK) { + return { + isError: true, + content: [{ text: 'Element not found in DOM' }], + }; + } + return {}; + }); + + const step: TestStep = { + id: 'click_tool_error', + type: 'click', + target: { candidates: [{ type: 'css', value: '#missing' }] }, + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /Element not found|failed|error/i, + ); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/hybrid-actions.integration.test.ts b/app/chrome-extension/tests/record-replay/hybrid-actions.integration.test.ts new file mode 100644 index 00000000..5d7087ca --- /dev/null +++ b/app/chrome-extension/tests/record-replay/hybrid-actions.integration.test.ts @@ -0,0 +1,613 @@ +/** + * Hybrid Actions Integration Tests (M3-full batch 1) + * + * Purpose: + * Verify that HybridStepExecutor correctly routes allowlisted action types + * through the ActionRegistry pipeline, exercising real handlers while + * mocking only environment boundaries. + * + * Test Strategy: + * - Use real HybridStepExecutor + real ActionRegistry + real handlers + * - Mock only environment boundaries: + * - chrome.* APIs (tabs.sendMessage, scripting.executeScript, etc.) + * - handleCallTool (tool bridge to content scripts) + * - selectorLocator.locate (element location) + * + * Coverage: + * - routing sanity: verify allowlist routing works + * - fill, key, scroll, wait, delay, assert, screenshot, drag + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; +import { TOOL_NAMES } from 'chrome-mcp-shared'; +import { TOOL_MESSAGE_TYPES } from '@/common/message-types'; + +// ============================================================================= +// Mock Setup (using vi.hoisted for proper hoisting) +// ============================================================================= + +const mocks = vi.hoisted(() => ({ + handleCallTool: vi.fn(), + locate: vi.fn(), + tabsSendMessage: vi.fn(), + tabsGet: vi.fn(), + scriptingExecuteScript: vi.fn(), +})); + +// Mock tool bridge - all action handlers communicate with content scripts via this +vi.mock('@/entrypoints/background/tools', () => ({ + handleCallTool: mocks.handleCallTool, +})); + +// Mock selector locator - prevents real DOM queries +vi.mock('@/shared/selector', async (importOriginal) => { + const actual = await importOriginal(); + return { + ...actual, + createChromeSelectorLocator: () => ({ + locate: mocks.locate, + }), + }; +}); + +// ============================================================================= +// Imports (after mocks) +// ============================================================================= + +import { createMockExecCtx } from './_test-helpers'; +import { createHybridConfig } from '@/entrypoints/background/record-replay/engine/execution-mode'; +import { HybridStepExecutor } from '@/entrypoints/background/record-replay/engine/runners/step-executor'; +import { createReplayActionRegistry } from '@/entrypoints/background/record-replay/actions'; + +// ============================================================================= +// Test Constants +// ============================================================================= + +const TAB_ID = 1; +const FRAME_ID = 0; + +// ============================================================================= +// Helper Types and Functions +// ============================================================================= + +interface TestStep { + id: string; + type: string; + [key: string]: unknown; +} + +/** + * Create executor with default hybrid config (MINIMAL_HYBRID_ACTION_TYPES) + */ +function createExecutor(): HybridStepExecutor { + const registry = createReplayActionRegistry(); + const config = createHybridConfig(); + return new HybridStepExecutor(registry, config); +} + +/** + * Setup default mock responses for common chrome.tabs.sendMessage actions + */ +function setupDefaultTabsMessageMock(): void { + mocks.tabsSendMessage.mockImplementation(async (_tabId: number, message: unknown) => { + const msg = message as { action?: string }; + + switch (msg.action) { + case TOOL_MESSAGE_TYPES.RESOLVE_REF: + return { success: true, selector: '#resolved', rect: { width: 100, height: 20 } }; + case 'getAttributeForSelector': + return { value: 'text' }; // Not a file input + case 'focusByRef': + return { success: true }; + case 'waitForSelector': + case 'waitForText': + return { success: true }; + default: + return { success: true }; + } + }); +} + +/** + * Setup default mock responses for handleCallTool + */ +function setupDefaultToolMock(): void { + mocks.handleCallTool.mockImplementation(async (req: { name: string }) => { + if (req.name === TOOL_NAMES.BROWSER.SCREENSHOT) { + return { + content: [{ type: 'text', text: JSON.stringify({ base64Data: 'dGVzdGRhdGE=' }) }], + }; + } + return {}; + }); +} + +/** + * Setup default mock responses for chrome.scripting.executeScript + */ +function setupDefaultScriptingMock(): void { + mocks.scriptingExecuteScript.mockImplementation( + async (details: { files?: string[]; args?: unknown[] }) => { + // wait-helper injection path + if (Array.isArray(details.files) && details.files.length > 0) { + return []; + } + + // assert handler expects { passed: boolean } result + const firstArg = details.args?.[0]; + if (firstArg && typeof firstArg === 'object' && firstArg !== null && 'kind' in firstArg) { + return [{ result: { passed: true } }]; + } + + // scroll handler expects boolean true + return [{ result: true }]; + }, + ); +} + +// ============================================================================= +// Test Suite +// ============================================================================= + +describe('hybrid mode actions integration (M3-full batch 1)', () => { + beforeEach(() => { + // Reset all mocks + Object.values(mocks).forEach((mock) => mock.mockReset()); + + // Setup default behaviors + setupDefaultToolMock(); + setupDefaultTabsMessageMock(); + setupDefaultScriptingMock(); + + // Default selector locate result + mocks.locate.mockResolvedValue({ ref: 'ref_default', frameId: FRAME_ID, resolvedBy: 'css' }); + mocks.tabsGet.mockResolvedValue({ id: TAB_ID, url: 'https://example.com/' }); + + // Stub chrome.* globals + vi.stubGlobal('chrome', { + tabs: { + sendMessage: mocks.tabsSendMessage, + get: mocks.tabsGet, + query: vi.fn(async () => [{ id: TAB_ID, url: 'https://example.com/' }]), + }, + scripting: { + executeScript: mocks.scriptingExecuteScript, + }, + webNavigation: { + getAllFrames: vi.fn(async () => []), + }, + windows: { + create: vi.fn(), + update: vi.fn(), + }, + }); + }); + + afterEach(() => { + vi.unstubAllGlobals(); + vi.useRealTimers(); + }); + + // =========================================================================== + // Routing Sanity Tests + // =========================================================================== + + describe('routing sanity', () => { + it('routes allowlisted types to actions executor', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // delay is in MINIMAL_HYBRID_ACTION_TYPES + const step: TestStep = { id: 'delay_routing_test', type: 'delay', sleep: 0 }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + }); + + it('routes non-allowlisted types to legacy executor', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // click is NOT in MINIMAL_HYBRID_ACTION_TYPES (high-risk) + const step: TestStep = { + id: 'click_routing_test', + type: 'click', + target: { candidates: [{ type: 'css', value: '#btn' }] }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + // Verify actions path was NOT taken (selectorLocator is only used by action handlers) + expect(mocks.locate).not.toHaveBeenCalled(); + }); + }); + + // =========================================================================== + // Fill Action Tests + // =========================================================================== + + describe('fill action', () => { + it('routes through ActionRegistry and calls READ_PAGE + FILL tools', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + mocks.locate.mockResolvedValueOnce({ ref: 'ref_fill', frameId: FRAME_ID, resolvedBy: 'css' }); + + const step: TestStep = { + id: 'fill_test', + type: 'fill', + target: { candidates: [{ type: 'css', value: '#name' }] }, + value: 'test input', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + + // Verify tool calls + const toolCalls = mocks.handleCallTool.mock.calls.map(([arg]) => arg.name); + expect(toolCalls).toContain(TOOL_NAMES.BROWSER.READ_PAGE); + expect(toolCalls).toContain(TOOL_NAMES.BROWSER.FILL); + + // Verify FILL was called with correct parameters + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.FILL, + args: expect.objectContaining({ + tabId: TAB_ID, + frameId: FRAME_ID, + ref: 'ref_fill', + value: 'test input', + }), + }), + ); + }); + + it('handles variable interpolation in fill value', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ + frameId: FRAME_ID, + vars: { username: 'john_doe' }, + }); + + mocks.locate.mockResolvedValueOnce({ ref: 'ref_fill', frameId: FRAME_ID, resolvedBy: 'css' }); + + const step: TestStep = { + id: 'fill_var_test', + type: 'fill', + target: { candidates: [{ type: 'css', value: '#username' }] }, + value: '{username}', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.FILL, + args: expect.objectContaining({ value: 'john_doe' }), + }), + ); + }); + }); + + // =========================================================================== + // Key Action Tests + // =========================================================================== + + describe('key action', () => { + it('routes to actions and calls KEYBOARD tool', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { id: 'key_test', type: 'key', keys: 'Enter' }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.KEYBOARD, + args: expect.objectContaining({ tabId: TAB_ID, keys: 'Enter' }), + }), + ); + }); + + it('supports complex key combinations', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { id: 'key_combo_test', type: 'key', keys: 'Control+a' }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.KEYBOARD, + args: expect.objectContaining({ keys: 'Control+a' }), + }), + ); + }); + }); + + // =========================================================================== + // Scroll Action Tests + // =========================================================================== + + describe('scroll action', () => { + it('executes window scroll via chrome.scripting in offset mode', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'scroll_offset_test', + type: 'scroll', + mode: 'offset', + offset: { x: 0, y: 200 }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.scriptingExecuteScript).toHaveBeenCalledWith( + expect.objectContaining({ + target: expect.objectContaining({ tabId: TAB_ID }), + world: 'MAIN', + }), + ); + }); + }); + + // =========================================================================== + // Wait Action Tests + // =========================================================================== + + describe('wait action', () => { + it('injects helper and sends waitForSelector message', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'wait_selector_test', + type: 'wait', + condition: { kind: 'selector', selector: '#ready', visible: true }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + + // Verify wait helper injection + expect(mocks.scriptingExecuteScript).toHaveBeenCalledWith( + expect.objectContaining({ + files: ['inject-scripts/wait-helper.js'], + world: 'ISOLATED', + }), + ); + + // Verify wait request sent to content script + expect(mocks.tabsSendMessage).toHaveBeenCalledWith( + TAB_ID, + expect.objectContaining({ action: 'waitForSelector', selector: '#ready' }), + expect.objectContaining({ frameId: FRAME_ID }), + ); + }); + + it('supports text wait condition', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'wait_text_test', + type: 'wait', + condition: { kind: 'text', text: 'Loading complete' }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.tabsSendMessage).toHaveBeenCalledWith( + TAB_ID, + expect.objectContaining({ action: 'waitForText', text: 'Loading complete' }), + expect.anything(), + ); + }); + }); + + // =========================================================================== + // Delay Action Tests + // =========================================================================== + + describe('delay action', () => { + it('awaits specified time using timers', async () => { + vi.useFakeTimers(); + + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { id: 'delay_test', type: 'delay', sleep: 250 }; + + const promise = executor.execute(ctx, step as never, { tabId: TAB_ID }); + await vi.advanceTimersByTimeAsync(250); + const result = await promise; + + expect(result.executor).toBe('actions'); + }); + + it('handles zero delay', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { id: 'delay_zero_test', type: 'delay', sleep: 0 }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + }); + }); + + // =========================================================================== + // Assert Action Tests + // =========================================================================== + + describe('assert action', () => { + it.each(['exists', 'visible'] as const)('handles %s assertion kind', async (kind) => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: `assert_${kind}_test`, + type: 'assert', + assert: { kind, selector: '#target' }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.scriptingExecuteScript).toHaveBeenCalledWith( + expect.objectContaining({ + args: [expect.objectContaining({ kind })], + }), + ); + }); + + it('propagates assertion failure as thrown error', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // Mock all calls to return failed assertion (assert handler polls) + mocks.scriptingExecuteScript.mockImplementation( + async (details: { files?: string[]; args?: unknown[] }) => { + // wait-helper injection path - return empty for file injections + if (Array.isArray(details.files) && details.files.length > 0) { + return []; + } + // Always return assertion failed + return [{ result: { passed: false, message: 'Element not found' } }]; + }, + ); + + // Use very short timeout to minimize test duration + // (adapter reads step.timeoutMs, default is 5000ms) + const step: TestStep = { + id: 'assert_fail_test', + type: 'assert', + assert: { kind: 'exists', selector: '#missing' }, + failStrategy: 'stop', + timeoutMs: 50, // Very short to speed up test + }; + + // When assertion fails (or times out), adapter throws an error + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /ASSERTION_FAILED|Element not found|Timeout/i, + ); + }); + }); + + // =========================================================================== + // Screenshot Action Tests + // =========================================================================== + + describe('screenshot action', () => { + it('stores base64 data in ctx.vars when saveAs is specified', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'screenshot_test', + type: 'screenshot', + fullPage: false, + saveAs: 'capturedImage', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(ctx.vars.capturedImage).toBe('dGVzdGRhdGE='); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.SCREENSHOT, + args: expect.objectContaining({ tabId: TAB_ID, storeBase64: true }), + }), + ); + }); + + it('supports fullPage option', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'screenshot_fullpage_test', + type: 'screenshot', + fullPage: true, + saveAs: 'fullCapture', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.SCREENSHOT, + args: expect.objectContaining({ fullPage: true }), + }), + ); + }); + }); + + // =========================================================================== + // Drag Action Tests + // =========================================================================== + + describe('drag action', () => { + it('locates start/end targets and calls COMPUTER left_click_drag', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + // Mock separate locate calls for start and end + mocks.locate + .mockResolvedValueOnce({ ref: 'ref_start', frameId: FRAME_ID, resolvedBy: 'css' }) + .mockResolvedValueOnce({ ref: 'ref_end', frameId: FRAME_ID, resolvedBy: 'css' }); + + const step: TestStep = { + id: 'drag_test', + type: 'drag', + start: { candidates: [{ type: 'css', value: '#drag-source' }] }, + end: { candidates: [{ type: 'css', value: '#drop-target' }] }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + + // Verify both endpoints were located + expect(mocks.locate).toHaveBeenCalledTimes(2); + + // Verify first call was for start element + expect(mocks.locate.mock.calls[0]?.[1]).toMatchObject({ + candidates: expect.arrayContaining([expect.objectContaining({ value: '#drag-source' })]), + }); + + // Verify second call was for end element + expect(mocks.locate.mock.calls[1]?.[1]).toMatchObject({ + candidates: expect.arrayContaining([expect.objectContaining({ value: '#drop-target' })]), + }); + + // Verify COMPUTER tool called with drag action + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + name: TOOL_NAMES.BROWSER.COMPUTER, + args: expect.objectContaining({ + action: 'left_click_drag', + tabId: TAB_ID, + startRef: 'ref_start', + ref: 'ref_end', + }), + }), + ); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/script-control-flow.integration.test.ts b/app/chrome-extension/tests/record-replay/script-control-flow.integration.test.ts new file mode 100644 index 00000000..17debbf5 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/script-control-flow.integration.test.ts @@ -0,0 +1,693 @@ +/** + * Script & Control-Flow Integration Tests (M3-full batch 3) + * + * Purpose: + * Verify that script and control-flow step types are properly routed and executed + * based on hybrid allowlist configuration. + * + * Test Strategy: + * - Use real HybridStepExecutor + real ActionRegistry + real handlers + * - Mock only environment boundaries: + * - chrome.scripting.executeScript (for script execution) + * - chrome.webNavigation.getAllFrames (for switchFrame) + * - handleCallTool (tool bridge, not used by these handlers) + * + * Coverage: + * - Default hybrid: script/if/foreach/while/switchFrame route to legacy + * - Script defer semantics: when='after' returns deferAfterScript (legacy behavior) + * - Script opt-in: when='before' can route to actions with custom allowlist + * - Control-flow opt-in: if/foreach/while/switchFrame with actions allowlist + * + * Key Behavior Difference: + * Legacy script handler: when='after' returns { deferAfterScript: step } + * Actions script handler: executes immediately (no defer support) + * This difference is intentional - script with when='after' should stay on legacy. + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +// ============================================================================= +// Mock Setup (using vi.hoisted for proper hoisting) +// ============================================================================= + +const mocks = vi.hoisted(() => ({ + handleCallTool: vi.fn(), + locate: vi.fn(), + executeScript: vi.fn(), + getAllFrames: vi.fn(), + tabsQuery: vi.fn(), + tabsGet: vi.fn(), +})); + +// Mock tool bridge +vi.mock('@/entrypoints/background/tools', () => ({ + handleCallTool: mocks.handleCallTool, +})); + +// Mock selector locator +vi.mock('@/shared/selector', async (importOriginal) => { + const actual = await importOriginal(); + return { + ...actual, + createChromeSelectorLocator: () => ({ + locate: mocks.locate, + }), + }; +}); + +// ============================================================================= +// Imports (after mocks) +// ============================================================================= + +import { createMockExecCtx } from './_test-helpers'; +import { createHybridConfig } from '@/entrypoints/background/record-replay/engine/execution-mode'; +import { HybridStepExecutor } from '@/entrypoints/background/record-replay/engine/runners/step-executor'; +import { createReplayActionRegistry } from '@/entrypoints/background/record-replay/actions'; + +// ============================================================================= +// Test Constants +// ============================================================================= + +const TAB_ID = 1; +const FRAME_ID = 0; +const CHILD_FRAME_ID = 123; + +// ============================================================================= +// Helper Types and Functions +// ============================================================================= + +interface TestStep { + id: string; + type: string; + [key: string]: unknown; +} + +/** + * Create executor with configurable hybrid config + */ +function createExecutor(overrides?: Parameters[0]): HybridStepExecutor { + const registry = createReplayActionRegistry(); + const config = createHybridConfig(overrides); + return new HybridStepExecutor(registry, config); +} + +/** + * Setup default mock responses for handleCallTool + */ +function setupDefaultToolMock(): void { + mocks.handleCallTool.mockImplementation(async () => ({})); +} + +/** + * Setup default mock for chrome.scripting.executeScript + * Returns a successful script execution result + */ +function setupDefaultScriptMock(): void { + mocks.executeScript.mockImplementation(async () => [ + { result: { success: true, result: 'script_result' } }, + ]); +} + +/** + * Setup default mock for chrome.webNavigation.getAllFrames + */ +function setupDefaultFramesMock(): void { + mocks.getAllFrames.mockImplementation(async () => [ + { frameId: 0, url: 'https://example.com/', parentFrameId: -1 }, + { frameId: CHILD_FRAME_ID, url: 'https://example.com/iframe', parentFrameId: 0 }, + { frameId: 456, url: 'https://ads.example.com/', parentFrameId: 0 }, + ]); +} + +/** + * Setup default mock for chrome.tabs.query (needed by legacy handlers) + */ +function setupDefaultTabsQueryMock(): void { + mocks.tabsQuery.mockImplementation(async (queryInfo?: unknown) => { + const q = queryInfo as Record | undefined; + if (q?.active === true) { + return [{ id: TAB_ID, url: 'https://example.com/', status: 'complete', windowId: 1 }]; + } + return [{ id: TAB_ID, url: 'https://example.com/', status: 'complete', windowId: 1 }]; + }); +} + +/** + * Setup default mock for chrome.tabs.get (needed by legacy handlers) + */ +function setupDefaultTabsGetMock(): void { + mocks.tabsGet.mockImplementation(async (tabId: number) => ({ + id: tabId, + url: 'https://example.com/', + status: 'complete', + windowId: 1, + })); +} + +// ============================================================================= +// Test Suite +// ============================================================================= + +describe('script & control-flow integration (M3-full batch 3)', () => { + beforeEach(() => { + // Reset all mocks + Object.values(mocks).forEach((mock) => mock.mockReset()); + + // Default behaviors + setupDefaultToolMock(); + setupDefaultScriptMock(); + setupDefaultFramesMock(); + setupDefaultTabsQueryMock(); + setupDefaultTabsGetMock(); + + // Default selector locate result + mocks.locate.mockResolvedValue({ ref: 'ref_default', frameId: FRAME_ID, resolvedBy: 'css' }); + + // Stub chrome.* globals + vi.stubGlobal('chrome', { + scripting: { + executeScript: mocks.executeScript, + }, + webNavigation: { + getAllFrames: mocks.getAllFrames, + }, + tabs: { + query: mocks.tabsQuery, + get: mocks.tabsGet, + }, + }); + }); + + afterEach(() => { + vi.unstubAllGlobals(); + }); + + // =========================================================================== + // Routing Tests (default hybrid allowlist) + // =========================================================================== + + describe('routing (default hybrid allowlist)', () => { + it('script routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_routing_legacy', + type: 'script', + code: 'return 42;', + world: 'MAIN', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('if routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { testVar: true } }); + + const step: TestStep = { + id: 'if_routing_legacy', + type: 'if', + condition: { type: 'truthy', value: '{{testVar}}' }, + then: [], + else: [], + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('foreach routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { items: [] } }); + + const step: TestStep = { + id: 'foreach_routing_legacy', + type: 'foreach', + listVar: 'items', + itemVar: 'item', + subflowId: 'subflow_1', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('while routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { counter: 0 } }); + + const step: TestStep = { + id: 'while_routing_legacy', + type: 'while', + condition: { type: 'compare', left: '{{counter}}', op: 'lt', right: 10 }, + subflowId: 'subflow_1', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + + it('switchFrame routes to legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_routing_legacy', + type: 'switchFrame', + target: { kind: 'top' }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + }); + }); + + // =========================================================================== + // Script Defer Semantics (Legacy Behavior) + // =========================================================================== + + describe('script defer semantics (legacy behavior)', () => { + it('script when=after returns deferAfterScript, not executed immediately', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_defer_after', + type: 'script', + code: 'console.log("deferred");', + when: 'after', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + // Legacy behavior: when='after' returns deferAfterScript instead of executing + expect(result.result.deferAfterScript).toBeDefined(); + // Script should NOT have been executed + expect(mocks.executeScript).not.toHaveBeenCalled(); + }); + + it('script when=before executes immediately in legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_when_before_legacy', + type: 'script', + code: 'return "immediate";', + when: 'before', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + // Legacy executes when='before' scripts immediately + expect(mocks.executeScript).toHaveBeenCalled(); + expect(result.result.deferAfterScript).toBeUndefined(); + }); + + it('script without when executes immediately in legacy', async () => { + const executor = createExecutor(); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_no_when_legacy', + type: 'script', + code: 'return "immediate";', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('legacy'); + expect(mocks.executeScript).toHaveBeenCalled(); + expect(result.result.deferAfterScript).toBeUndefined(); + }); + }); + + // =========================================================================== + // Script Actions Opt-in Tests + // =========================================================================== + + describe('script actions opt-in', () => { + it('script when=before routes to actions when allowlisted', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['script']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_actions_opt_in', + type: 'script', + code: 'return "via_actions";', + when: 'before', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.executeScript).toHaveBeenCalled(); + }); + + it('script without when routes to actions when allowlisted', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['script']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_actions_no_when', + type: 'script', + code: 'return "via_actions";', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.executeScript).toHaveBeenCalled(); + }); + + /** + * IMPORTANT: Even when script is allowlisted, when='after' should NOT be + * handled by actions because actions handler doesn't support defer semantics. + * This test documents the expected behavior - script with when='after' falls + * back to legacy even when script type is in allowlist. + */ + it('script when=after falls back to legacy even when allowlisted (defer not supported)', async () => { + // This test documents expected behavior: actions handler validates when param + // but doesn't implement defer, so it will execute immediately if it handles it. + // The proper fix would be to add explicit step-level routing for when='after'. + // For now, this documents the current behavior. + const executor = createExecutor({ actionsAllowlist: new Set(['script']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'script_after_allowlisted', + type: 'script', + code: 'console.log("should defer");', + when: 'after', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + // Note: Current behavior routes to actions and executes immediately. + // This is a known limitation documented in execution-mode.ts. + // Ideal behavior: should fall back to legacy for when='after'. + expect(result.executor).toBe('actions'); + }); + + it('script with saveAs captures result', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['script']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: {} }); + + mocks.executeScript.mockResolvedValueOnce([ + { result: { success: true, result: { data: 'captured' } } }, + ]); + + const step: TestStep = { + id: 'script_save_as', + type: 'script', + code: 'return { data: "captured" };', + saveAs: 'scriptOutput', + }; + + await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + // Actions handler stores result in ctx.vars + expect(ctx.vars.scriptOutput).toEqual({ data: 'captured' }); + }); + }); + + // =========================================================================== + // Control-Flow Actions Opt-in Tests + // =========================================================================== + + describe('control-flow actions opt-in', () => { + it('if binary condition evaluates correctly in actions', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['if']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { isEnabled: true } }); + + const step: TestStep = { + id: 'if_binary_actions', + type: 'if', + mode: 'binary', + // Use correct VarValue format: { kind: 'var', ref: { name: 'varName' } } + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'isEnabled' } } }, + trueLabel: 'yes', + falseLabel: 'no', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(result.result.nextLabel).toBe('yes'); + }); + + it('if binary condition false path', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['if']) }); + // Set isEnabled to a falsy value (empty string) + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { isEnabled: '' } }); + + const step: TestStep = { + id: 'if_binary_false_actions', + type: 'if', + mode: 'binary', + // truthy check on empty string should return false + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'isEnabled' } } }, + trueLabel: 'yes', + falseLabel: 'no', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(result.result.nextLabel).toBe('no'); + }); + + it('foreach with empty array returns success without control directive', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['foreach']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { items: [] } }); + + const step: TestStep = { + id: 'foreach_empty_actions', + type: 'foreach', + listVar: 'items', + itemVar: 'item', + subflowId: 'sub_1', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // Empty array = no iteration needed + expect(result.result.control).toBeUndefined(); + }); + + it('foreach with non-empty array returns control directive', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['foreach']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { items: [1, 2, 3] } }); + + const step: TestStep = { + id: 'foreach_non_empty_actions', + type: 'foreach', + listVar: 'items', + itemVar: 'current', + subflowId: 'sub_1', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(result.result.control).toMatchObject({ + kind: 'foreach', + listVar: 'items', + itemVar: 'current', + subflowId: 'sub_1', + }); + }); + + it('while with false condition returns success without control directive', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['while']) }); + // shouldLoop=false will make truthy check return false + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { shouldLoop: false } }); + + const step: TestStep = { + id: 'while_false_actions', + type: 'while', + // truthy check on false will evaluate to false + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'shouldLoop' } } }, + subflowId: 'sub_1', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // shouldLoop=false, so truthy condition is false, no loop + expect(result.result.control).toBeUndefined(); + }); + + it('while with true condition returns control directive', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['while']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { shouldLoop: true } }); + + const step: TestStep = { + id: 'while_true_actions', + type: 'while', + // Use truthy condition which should evaluate to true + condition: { kind: 'truthy', value: { kind: 'var', ref: { name: 'shouldLoop' } } }, + subflowId: 'sub_1', + maxIterations: 50, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(result.result.control).toMatchObject({ + kind: 'while', + subflowId: 'sub_1', + maxIterations: 50, + }); + }); + + it('switchFrame to top frame', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: CHILD_FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_top_actions', + type: 'switchFrame', + target: { kind: 'top' }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // ctx.frameId should be updated to 0 (top frame) + expect(ctx.frameId).toBe(0); + }); + + it('switchFrame by urlContains', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_url_actions', + type: 'switchFrame', + target: { kind: 'urlContains', value: 'ads.example.com' }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // ctx.frameId should be updated to the matching frame (456) + expect(ctx.frameId).toBe(456); + }); + + it('switchFrame by index', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_index_actions', + type: 'switchFrame', + target: { kind: 'index', index: 0 }, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + // First child frame (excluding main frame) is at index 0 + // Our mock returns frameId 123 as first child + expect(ctx.frameId).toBe(CHILD_FRAME_ID); + }); + + it('switchFrame fails when no matching frame found', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_not_found', + type: 'switchFrame', + target: { kind: 'urlContains', value: 'nonexistent.com' }, + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /FRAME_NOT_FOUND|no matching frame/i, + ); + }); + }); + + // =========================================================================== + // Error Handling Tests + // =========================================================================== + + describe('error handling', () => { + it('script fails when execution throws', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['script']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + mocks.executeScript.mockRejectedValueOnce(new Error('Script execution blocked')); + + const step: TestStep = { + id: 'script_error', + type: 'script', + code: 'throw new Error("test");', + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /Script execution|failed/i, + ); + }); + + it('foreach fails when listVar is not an array', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['foreach']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID, vars: { items: 'not an array' } }); + + const step: TestStep = { + id: 'foreach_invalid_list', + type: 'foreach', + listVar: 'items', + itemVar: 'item', + subflowId: 'sub_1', + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /not an array|VALIDATION_ERROR/i, + ); + }); + + it('switchFrame fails when tab has no frames', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + mocks.getAllFrames.mockResolvedValueOnce([]); + + const step: TestStep = { + id: 'switchFrame_no_frames', + type: 'switchFrame', + target: { kind: 'index', index: 0 }, + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /FRAME_NOT_FOUND|no frames/i, + ); + }); + + it('switchFrame fails when index out of bounds', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchFrame']) }); + const ctx = createMockExecCtx({ frameId: FRAME_ID }); + + const step: TestStep = { + id: 'switchFrame_out_of_bounds', + type: 'switchFrame', + target: { kind: 'index', index: 999 }, + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /FRAME_NOT_FOUND|out of bounds/i, + ); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/session-dag-sync.contract.test.ts b/app/chrome-extension/tests/record-replay/session-dag-sync.contract.test.ts new file mode 100644 index 00000000..384e4e91 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/session-dag-sync.contract.test.ts @@ -0,0 +1,314 @@ +/** + * Session DAG Sync Contract Tests + * + * Verifies that RecordingSessionManager correctly maintains flow.nodes/edges + * during recording: + * - New step → create node + edge from previous node + * - Upsert step → update node.config and node.type + * - Invariant violation → fallback to linear DAG rebuild + * + * Note: flow.steps is no longer written. Nodes are the source of truth. + */ + +import { describe, expect, it, beforeEach } from 'vitest'; +import { RecordingSessionManager } from '@/entrypoints/background/record-replay/recording/session-manager'; +import type { Flow, Step } from '@/entrypoints/background/record-replay/types'; + +function createTestFlow(overrides: Partial = {}): Flow { + return { + id: `test_flow_${Date.now()}`, + name: 'Test Flow', + version: 1, + steps: [], + meta: { + createdAt: new Date().toISOString(), + updatedAt: new Date().toISOString(), + }, + ...overrides, + }; +} + +function createTestStep(type: string, id?: string, overrides: Record = {}): Step { + return { + id: id || `step_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`, + type, + ...overrides, + } as Step; +} + +describe('RecordingSessionManager DAG sync', () => { + let manager: RecordingSessionManager; + + beforeEach(async () => { + manager = new RecordingSessionManager(); + }); + + describe('appendSteps creates nodes/edges', () => { + it('creates node for first step without edge', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([createTestStep('click', 'step1')]); + + const f = manager.getFlow()!; + expect(f.nodes).toHaveLength(1); + expect(f.nodes![0].id).toBe('step1'); + expect(f.nodes![0].type).toBe('click'); + expect(f.edges).toHaveLength(0); // No edge for first step + }); + + it('creates node and edge for subsequent steps', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([createTestStep('click', 'step1')]); + manager.appendSteps([createTestStep('fill', 'step2', { value: 'hello' })]); + + const f = manager.getFlow()!; + expect(f.nodes).toHaveLength(2); + expect(f.nodes![1].id).toBe('step2'); + expect(f.nodes![1].type).toBe('fill'); + + expect(f.edges).toHaveLength(1); + expect(f.edges![0].from).toBe('step1'); + expect(f.edges![0].to).toBe('step2'); + }); + + it('creates correct chain for multiple steps in single batch', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([ + createTestStep('navigate', 'step1', { url: 'https://example.com' }), + createTestStep('click', 'step2'), + createTestStep('fill', 'step3', { value: 'test' }), + ]); + + const f = manager.getFlow()!; + // Note: flow.steps is no longer written, nodes are the source of truth + expect(f.nodes).toHaveLength(3); + expect(f.edges).toHaveLength(2); + + // Verify chain: step1 → step2 → step3 + expect(f.edges![0].from).toBe('step1'); + expect(f.edges![0].to).toBe('step2'); + expect(f.edges![1].from).toBe('step2'); + expect(f.edges![1].to).toBe('step3'); + }); + }); + + describe('upsert updates node config', () => { + it('updates node config when step is upserted', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + // Initial step + manager.appendSteps([createTestStep('fill', 'step1', { value: 'initial' })]); + + // Upsert with new value + manager.appendSteps([createTestStep('fill', 'step1', { value: 'updated' })]); + + const f = manager.getFlow()!; + // Note: flow.steps is no longer written, nodes are the source of truth + expect(f.nodes).toHaveLength(1); + expect(f.nodes![0].config?.value).toBe('updated'); + }); + + it('preserves edges when upserting', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([ + createTestStep('click', 'step1'), + createTestStep('fill', 'step2', { value: 'initial' }), + ]); + + // Upsert step2 + manager.appendSteps([createTestStep('fill', 'step2', { value: 'updated' })]); + + const f = manager.getFlow()!; + expect(f.edges).toHaveLength(1); + expect(f.edges![0].from).toBe('step1'); + expect(f.edges![0].to).toBe('step2'); + }); + }); + + describe('invariant handling', () => { + it('rebuilds DAG from legacy steps when nodes missing', async () => { + // Create flow with steps but no nodes (legacy scenario) + const flow = createTestFlow({ + steps: [ + { id: 'existing1', type: 'click' } as any, + { id: 'existing2', type: 'fill', value: 'test' } as any, + ], + nodes: undefined, + edges: undefined, + }); + await manager.startSession(flow, 1); + + // Append new step - should trigger rebuild from legacy steps first + manager.appendSteps([createTestStep('navigate', 'step3', { url: 'https://test.com' })]); + + const f = manager.getFlow()!; + // Should have rebuilt: 2 existing (from legacy steps) + 1 new = 3 + expect(f.nodes).toHaveLength(3); + expect(f.edges).toHaveLength(2); + }); + + it('handles empty flow gracefully', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + // Empty appendSteps should be no-op + manager.appendSteps([]); + + const f = manager.getFlow()!; + // nodes/edges may be undefined when no steps added, that's valid + expect(f.nodes?.length ?? 0).toBe(0); + expect(f.edges?.length ?? 0).toBe(0); + }); + }); + + describe('session lifecycle', () => { + it('clears caches on session stop', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([createTestStep('click', 'step1')]); + + const stoppedFlow = await manager.stopSession(); + + expect(stoppedFlow).not.toBeNull(); + expect(stoppedFlow!.nodes).toHaveLength(1); + + // After stop, manager should have no flow + expect(manager.getFlow()).toBeNull(); + }); + + it('reinitializes caches on new session', async () => { + // First session + const flow1 = createTestFlow({ id: 'flow1' }); + await manager.startSession(flow1, 1); + manager.appendSteps([createTestStep('click', 'step1')]); + await manager.stopSession(); + + // Second session - should have fresh state + const flow2 = createTestFlow({ id: 'flow2' }); + await manager.startSession(flow2, 2); + manager.appendSteps([createTestStep('fill', 'step2')]); + + const f = manager.getFlow()!; + expect(f.id).toBe('flow2'); + // Note: flow.steps is no longer written, nodes are the source of truth + expect(f.nodes).toHaveLength(1); + expect(f.nodes![0].id).toBe('step2'); + }); + }); + + describe('node type conversion', () => { + it('converts valid step types to node types', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([ + createTestStep('click', 'step1'), + createTestStep('fill', 'step2'), + createTestStep('navigate', 'step3'), + createTestStep('scroll', 'step4'), + ]); + + const f = manager.getFlow()!; + expect(f.nodes![0].type).toBe('click'); + expect(f.nodes![1].type).toBe('fill'); + expect(f.nodes![2].type).toBe('navigate'); + expect(f.nodes![3].type).toBe('scroll'); + }); + + it('falls back to script for unknown types', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([createTestStep('unknown_type_xyz', 'step1')]); + + const f = manager.getFlow()!; + expect(f.nodes![0].type).toBe('script'); + }); + }); + + describe('edge id uniqueness', () => { + it('generates unique edge ids', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + manager.appendSteps([ + createTestStep('click', 's1'), + createTestStep('click', 's2'), + createTestStep('click', 's3'), + createTestStep('click', 's4'), + ]); + + const f = manager.getFlow()!; + const edgeIds = f.edges!.map((e) => e.id); + const uniqueIds = new Set(edgeIds); + + expect(uniqueIds.size).toBe(edgeIds.length); + }); + + it('uses monotonic sequence for edge ids', async () => { + const flow = createTestFlow(); + await manager.startSession(flow, 1); + + // Add steps in multiple batches + manager.appendSteps([createTestStep('click', 's1')]); + manager.appendSteps([createTestStep('click', 's2')]); + manager.appendSteps([createTestStep('click', 's3')]); + + const f = manager.getFlow()!; + // Edge ids should contain sequential numbers + expect(f.edges![0].id).toMatch(/^e_0_/); + expect(f.edges![1].id).toMatch(/^e_1_/); + }); + }); + + describe('edge invariant handling', () => { + it('rechains edges when edges are missing', async () => { + // Create flow with nodes but missing edges + const flow = createTestFlow({ + nodes: [ + { id: 's1', type: 'click', config: {} }, + { id: 's2', type: 'fill', config: {} }, + ], + edges: [], // Missing edges! + }); + await manager.startSession(flow, 1); + + // Append should trigger rechain due to edge invariant violation + manager.appendSteps([createTestStep('navigate', 's3')]); + + const f = manager.getFlow()!; + expect(f.nodes).toHaveLength(3); + // Should have rechained edges: s1→s2→s3 + expect(f.edges).toHaveLength(2); + }); + + it('rechains edges when last edge points to wrong node', async () => { + // Create flow with corrupted edge pointing to wrong target + const flow = createTestFlow({ + nodes: [ + { id: 's1', type: 'click', config: {} }, + { id: 's2', type: 'fill', config: {} }, + ], + edges: [{ id: 'e_0', from: 's1', to: 'wrong_id' }], // Wrong target! + }); + await manager.startSession(flow, 1); + + // Append should trigger rechain due to edge invariant violation + manager.appendSteps([createTestStep('navigate', 's3')]); + + const f = manager.getFlow()!; + expect(f.edges).toHaveLength(2); + // Last edge should point to last node + expect(f.edges![1].to).toBe('s3'); + }); + }); +}); diff --git a/app/chrome-extension/tests/record-replay/step-executor.contract.test.ts b/app/chrome-extension/tests/record-replay/step-executor.contract.test.ts new file mode 100644 index 00000000..15388450 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/step-executor.contract.test.ts @@ -0,0 +1,212 @@ +/** + * Step Executor Routing Contract Tests + * + * Verifies that step execution routes correctly based on ExecutionModeConfig: + * - legacy mode: always uses legacy executeStep + * - hybrid mode: uses actions for allowlisted types, legacy for others + * - actions mode: always uses ActionRegistry (strict) + */ + +import { describe, expect, it, vi, beforeEach } from 'vitest'; + +// Mock legacy executeStep - must be defined inline in vi.mock factory +vi.mock('@/entrypoints/background/record-replay/nodes', () => ({ + executeStep: vi.fn(async () => ({})), +})); + +// Mock createStepExecutor from adapter - must be defined inline in vi.mock factory +vi.mock('@/entrypoints/background/record-replay/actions/adapter', () => ({ + createStepExecutor: vi.fn(() => vi.fn(async () => ({ supported: true, result: {} }))), + isActionSupported: vi.fn((type: string) => { + const supported = ['fill', 'key', 'scroll', 'click', 'navigate', 'delay', 'wait']; + return supported.includes(type); + }), +})); + +import { createMockExecCtx, createMockStep, createMockRegistry } from './_test-helpers'; +import { + DEFAULT_EXECUTION_MODE_CONFIG, + createHybridConfig, + createActionsOnlyConfig, + MINIMAL_HYBRID_ACTION_TYPES, +} from '@/entrypoints/background/record-replay/engine/execution-mode'; +import { + LegacyStepExecutor, + ActionsStepExecutor, + HybridStepExecutor, + createExecutor, +} from '@/entrypoints/background/record-replay/engine/runners/step-executor'; +import { executeStep as legacyExecuteStep } from '@/entrypoints/background/record-replay/nodes'; +import { createStepExecutor as createAdapterExecutor } from '@/entrypoints/background/record-replay/actions/adapter'; + +describe('ExecutionModeConfig contract', () => { + describe('DEFAULT_EXECUTION_MODE_CONFIG', () => { + it('defaults to legacy mode', () => { + expect(DEFAULT_EXECUTION_MODE_CONFIG.mode).toBe('legacy'); + }); + + it('defaults skipActionsRetry to true', () => { + expect(DEFAULT_EXECUTION_MODE_CONFIG.skipActionsRetry).toBe(true); + }); + + it('defaults skipActionsNavWait to true', () => { + expect(DEFAULT_EXECUTION_MODE_CONFIG.skipActionsNavWait).toBe(true); + }); + }); + + describe('createHybridConfig', () => { + it('sets mode to hybrid', () => { + const config = createHybridConfig(); + expect(config.mode).toBe('hybrid'); + }); + + it('uses MINIMAL_HYBRID_ACTION_TYPES as default allowlist', () => { + const config = createHybridConfig(); + expect(config.actionsAllowlist).toBeDefined(); + expect(config.actionsAllowlist?.has('fill')).toBe(true); + expect(config.actionsAllowlist?.has('key')).toBe(true); + expect(config.actionsAllowlist?.has('scroll')).toBe(true); + // High-risk types should NOT be in minimal allowlist + expect(config.actionsAllowlist?.has('click')).toBe(false); + expect(config.actionsAllowlist?.has('navigate')).toBe(false); + }); + + it('allows overriding actionsAllowlist', () => { + const config = createHybridConfig({ + actionsAllowlist: new Set(['fill', 'click']), + }); + expect(config.actionsAllowlist?.has('fill')).toBe(true); + expect(config.actionsAllowlist?.has('click')).toBe(true); + expect(config.actionsAllowlist?.has('key')).toBe(false); + }); + }); + + describe('createActionsOnlyConfig', () => { + it('sets mode to actions', () => { + const config = createActionsOnlyConfig(); + expect(config.mode).toBe('actions'); + }); + + it('keeps StepRunner as policy authority (skip flags true)', () => { + const config = createActionsOnlyConfig(); + expect(config.skipActionsRetry).toBe(true); + expect(config.skipActionsNavWait).toBe(true); + }); + }); +}); + +describe('LegacyStepExecutor', () => { + const mockLegacyExecuteStep = legacyExecuteStep as ReturnType; + + beforeEach(() => { + mockLegacyExecuteStep.mockClear(); + }); + + it('always uses legacy executeStep', async () => { + const executor = new LegacyStepExecutor(); + const ctx = createMockExecCtx(); + const step = createMockStep('fill'); + + await executor.execute(ctx, step, { tabId: 1 }); + + expect(mockLegacyExecuteStep).toHaveBeenCalledWith(ctx, step); + }); + + it('returns executor type as legacy', async () => { + const executor = new LegacyStepExecutor(); + const result = await executor.execute(createMockExecCtx(), createMockStep('click'), { + tabId: 1, + }); + + expect(result.executor).toBe('legacy'); + }); + + it('supports all step types', () => { + const executor = new LegacyStepExecutor(); + expect(executor.supports('fill')).toBe(true); + expect(executor.supports('unknown_type')).toBe(true); + }); +}); + +describe('HybridStepExecutor routing', () => { + const mockLegacyExecuteStep = legacyExecuteStep as ReturnType; + + beforeEach(() => { + mockLegacyExecuteStep.mockClear(); + }); + + it('uses legacy for non-allowlisted types', async () => { + const config = createHybridConfig({ actionsAllowlist: new Set(['fill']) }); + const mockReg = createMockRegistry(); + const executor = new HybridStepExecutor(mockReg as any, config); + + await executor.execute( + createMockExecCtx(), + createMockStep('click', { target: { candidates: [] } }), + { tabId: 1 }, + ); + + expect(mockLegacyExecuteStep).toHaveBeenCalled(); + }); + + it('returns legacy executor type for non-allowlisted types', async () => { + const config = createHybridConfig({ actionsAllowlist: new Set(['fill']) }); + const mockReg = createMockRegistry(); + const executor = new HybridStepExecutor(mockReg as any, config); + + const result = await executor.execute( + createMockExecCtx(), + createMockStep('navigate', { url: 'https://example.com' }), + { tabId: 1 }, + ); + + expect(result.executor).toBe('legacy'); + }); +}); + +describe('createExecutor factory', () => { + it('creates LegacyStepExecutor for legacy mode', () => { + const executor = createExecutor({ ...DEFAULT_EXECUTION_MODE_CONFIG, mode: 'legacy' }); + expect(executor).toBeInstanceOf(LegacyStepExecutor); + }); + + it('creates ActionsStepExecutor for actions mode', () => { + const mockReg = createMockRegistry(); + const executor = createExecutor(createActionsOnlyConfig(), mockReg as any); + expect(executor).toBeInstanceOf(ActionsStepExecutor); + }); + + it('creates HybridStepExecutor for hybrid mode', () => { + const mockReg = createMockRegistry(); + const executor = createExecutor(createHybridConfig(), mockReg as any); + expect(executor).toBeInstanceOf(HybridStepExecutor); + }); + + it('throws if actions mode has no registry', () => { + expect(() => createExecutor(createActionsOnlyConfig())).toThrow( + 'ActionRegistry required for actions execution mode', + ); + }); + + it('throws if hybrid mode has no registry', () => { + expect(() => createExecutor(createHybridConfig())).toThrow( + 'ActionRegistry required for hybrid execution mode', + ); + }); +}); + +describe('MINIMAL_HYBRID_ACTION_TYPES', () => { + it('contains only low-risk action types', () => { + const expected = ['fill', 'key', 'scroll', 'drag', 'wait', 'delay', 'screenshot', 'assert']; + for (const type of expected) { + expect(MINIMAL_HYBRID_ACTION_TYPES.has(type)).toBe(true); + } + }); + + it('excludes high-risk types (navigate, click, tab management)', () => { + const excluded = ['navigate', 'click', 'dblclick', 'openTab', 'switchTab', 'closeTab']; + for (const type of excluded) { + expect(MINIMAL_HYBRID_ACTION_TYPES.has(type)).toBe(false); + } + }); +}); diff --git a/app/chrome-extension/tests/record-replay/tab-cursor.integration.test.ts b/app/chrome-extension/tests/record-replay/tab-cursor.integration.test.ts new file mode 100644 index 00000000..659d9cb4 --- /dev/null +++ b/app/chrome-extension/tests/record-replay/tab-cursor.integration.test.ts @@ -0,0 +1,423 @@ +/** + * Tab Cursor Integration Tests (M3-full batch 2) + * + * Purpose: + * Test tab management operations (openTab, switchTab) and verify their behavior, + * including ctx.tabId cursor updates after tab operations (M3 requirement). + * + * Test Strategy: + * - Use real HybridStepExecutor + real ActionRegistry + real tab handlers + * - Mock only environment boundaries (chrome.* APIs) + * + * Coverage: + * - Basic tab operations: openTab with newWindow, switchTab by urlContains + * - Tab cursor sync: ctx.tabId updated and used by subsequent steps + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +// ============================================================================= +// Mock Setup (using vi.hoisted for proper hoisting) +// ============================================================================= + +const mocks = vi.hoisted(() => ({ + handleCallTool: vi.fn(), + locate: vi.fn(), + tabsQuery: vi.fn(), + tabsGet: vi.fn(), + tabsCreate: vi.fn(), + tabsUpdate: vi.fn(), + windowsCreate: vi.fn(), + windowsUpdate: vi.fn(), +})); + +// Mock tool bridge +vi.mock('@/entrypoints/background/tools', () => ({ + handleCallTool: mocks.handleCallTool, +})); + +// Mock selector locator +vi.mock('@/shared/selector', async (importOriginal) => { + const actual = await importOriginal(); + return { + ...actual, + createChromeSelectorLocator: () => ({ + locate: mocks.locate, + }), + }; +}); + +// ============================================================================= +// Imports (after mocks) +// ============================================================================= + +import { createMockExecCtx } from './_test-helpers'; +import { createHybridConfig } from '@/entrypoints/background/record-replay/engine/execution-mode'; +import { HybridStepExecutor } from '@/entrypoints/background/record-replay/engine/runners/step-executor'; +import { createReplayActionRegistry } from '@/entrypoints/background/record-replay/actions'; + +// ============================================================================= +// Test Constants +// ============================================================================= + +const TAB_ID = 1; +const NEW_TAB_ID = 101; +const TARGET_TAB_ID = 42; +const TARGET_WINDOW_ID = 999; + +// ============================================================================= +// Helper Types and Functions +// ============================================================================= + +interface TestStep { + id: string; + type: string; + [key: string]: unknown; +} + +/** + * Create executor with configurable hybrid config + */ +function createExecutor(overrides?: Parameters[0]): HybridStepExecutor { + const registry = createReplayActionRegistry(); + const config = createHybridConfig(overrides); + return new HybridStepExecutor(registry, config); +} + +/** + * Setup default mock responses for handleCallTool + */ +function setupDefaultToolMock(): void { + mocks.handleCallTool.mockImplementation(async () => ({})); +} + +// ============================================================================= +// Test Suite +// ============================================================================= + +describe('tab cursor integration (M3-full batch 2)', () => { + beforeEach(() => { + // Reset all mocks + Object.values(mocks).forEach((mock) => mock.mockReset()); + setupDefaultToolMock(); + + // Default selector locate result + mocks.locate.mockResolvedValue({ ref: 'ref_default', frameId: 0, resolvedBy: 'css' }); + + // Default tabs.query returns current tab + mocks.tabsQuery.mockResolvedValue([ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Example', + windowId: 1, + status: 'complete', + }, + ]); + + // Default tabs.get returns tab info + mocks.tabsGet.mockImplementation(async (tabId: number) => ({ + id: tabId, + url: 'https://example.com/', + windowId: TARGET_WINDOW_ID, + status: 'complete', + })); + + // Default tab/window creation + mocks.tabsCreate.mockResolvedValue({ id: NEW_TAB_ID }); + mocks.tabsUpdate.mockResolvedValue({}); + mocks.windowsCreate.mockResolvedValue({ tabs: [{ id: NEW_TAB_ID }] }); + mocks.windowsUpdate.mockResolvedValue({}); + + // Stub chrome.* globals + vi.stubGlobal('chrome', { + tabs: { + query: mocks.tabsQuery, + get: mocks.tabsGet, + create: mocks.tabsCreate, + update: mocks.tabsUpdate, + }, + windows: { + create: mocks.windowsCreate, + update: mocks.windowsUpdate, + }, + }); + }); + + afterEach(() => { + vi.unstubAllGlobals(); + }); + + // =========================================================================== + // ctx.tabId Sync Tests + // =========================================================================== + + describe('ctx.tabId sync after tab operations', () => { + it('openTab updates ctx.tabId for subsequent steps', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['openTab', 'click']) }); + const ctx = createMockExecCtx({ tabId: TAB_ID }); + + const openStep: TestStep = { + id: 'openTab_updates_ctx_tabId', + type: 'openTab', + newWindow: false, + }; + + await executor.execute(ctx, openStep as never, { tabId: ctx.tabId ?? TAB_ID }); + + // ctx.tabId should be updated to the new tab + expect(ctx.tabId).toBe(NEW_TAB_ID); + + // Verify subsequent step uses the new tabId + mocks.locate.mockResolvedValueOnce(undefined); + + const clickStep: TestStep = { + id: 'click_after_openTab', + type: 'click', + target: { + candidates: [{ type: 'css', value: '#btn' }], + }, + }; + + await executor.execute(ctx, clickStep as never, { tabId: ctx.tabId ?? TAB_ID }); + + // The click tool should be called with the NEW_TAB_ID + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + args: expect.objectContaining({ tabId: NEW_TAB_ID }), + }), + ); + }); + + it('switchTab updates ctx.tabId for subsequent steps', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchTab', 'click']) }); + const ctx = createMockExecCtx({ tabId: TAB_ID }); + + // Setup tabs.query to return multiple tabs + mocks.tabsQuery.mockResolvedValueOnce([ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Example', + windowId: 1, + status: 'complete', + }, + { + id: TARGET_TAB_ID, + url: 'https://docs.example.com/', + title: 'Docs', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }, + ]); + + const switchStep: TestStep = { + id: 'switchTab_updates_ctx_tabId', + type: 'switchTab', + urlContains: 'docs.example.com', + }; + + await executor.execute(ctx, switchStep as never, { tabId: ctx.tabId ?? TAB_ID }); + + // ctx.tabId should be updated to the target tab + expect(ctx.tabId).toBe(TARGET_TAB_ID); + + // Verify subsequent step uses the new tabId + mocks.locate.mockResolvedValueOnce(undefined); + + const clickStep: TestStep = { + id: 'click_after_switchTab', + type: 'click', + target: { + candidates: [{ type: 'css', value: '#btn' }], + }, + }; + + await executor.execute(ctx, clickStep as never, { tabId: ctx.tabId ?? TAB_ID }); + + // The click tool should be called with the TARGET_TAB_ID + expect(mocks.handleCallTool).toHaveBeenCalledWith( + expect.objectContaining({ + args: expect.objectContaining({ tabId: TARGET_TAB_ID }), + }), + ); + }); + }); + + // =========================================================================== + // Basic Tab Operations Tests + // =========================================================================== + + describe('basic tab operations', () => { + it('openTab success with new window', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['openTab']) }); + const ctx = createMockExecCtx(); + + const step: TestStep = { + id: 'openTab_newWindow_success', + type: 'openTab', + newWindow: true, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.windowsCreate).toHaveBeenCalledWith( + expect.objectContaining({ url: 'about:blank', focused: true }), + ); + }); + + it('openTab success with new tab in current window', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['openTab']) }); + const ctx = createMockExecCtx(); + + const step: TestStep = { + id: 'openTab_newTab_success', + type: 'openTab', + url: 'https://example.com/new-page', + newWindow: false, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.tabsCreate).toHaveBeenCalledWith( + expect.objectContaining({ url: 'https://example.com/new-page', active: true }), + ); + }); + + it('switchTab finds tab by urlContains', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchTab']) }); + const ctx = createMockExecCtx(); + + // Setup tabs.query to return multiple tabs + mocks.tabsQuery.mockResolvedValueOnce([ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Example', + windowId: 1, + status: 'complete', + }, + { + id: TARGET_TAB_ID, + url: 'https://docs.example.com/', + title: 'Docs', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }, + ]); + + // Setup tabs.get to return the target tab + mocks.tabsGet.mockResolvedValueOnce({ + id: TARGET_TAB_ID, + url: 'https://docs.example.com/', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }); + + const step: TestStep = { + id: 'switchTab_urlContains_success', + type: 'switchTab', + urlContains: 'docs.example.com', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.tabsUpdate).toHaveBeenCalledWith(TARGET_TAB_ID, { active: true }); + expect(mocks.windowsUpdate).toHaveBeenCalledWith(TARGET_WINDOW_ID, { focused: true }); + }); + + it('switchTab finds tab by titleContains', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchTab']) }); + const ctx = createMockExecCtx(); + + // Setup tabs.query to return multiple tabs + mocks.tabsQuery.mockResolvedValueOnce([ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Home Page', + windowId: 1, + status: 'complete', + }, + { + id: TARGET_TAB_ID, + url: 'https://example.com/settings', + title: 'Settings - My Account', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }, + ]); + + mocks.tabsGet.mockResolvedValueOnce({ + id: TARGET_TAB_ID, + url: 'https://example.com/settings', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }); + + const step: TestStep = { + id: 'switchTab_titleContains_success', + type: 'switchTab', + titleContains: 'Settings', + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.tabsUpdate).toHaveBeenCalledWith(TARGET_TAB_ID, { active: true }); + }); + + it('switchTab by explicit tabId', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchTab']) }); + const ctx = createMockExecCtx(); + + mocks.tabsGet.mockResolvedValueOnce({ + id: TARGET_TAB_ID, + url: 'https://example.com/', + windowId: TARGET_WINDOW_ID, + status: 'complete', + }); + + const step: TestStep = { + id: 'switchTab_byId_success', + type: 'switchTab', + tabId: TARGET_TAB_ID, + }; + + const result = await executor.execute(ctx, step as never, { tabId: TAB_ID }); + + expect(result.executor).toBe('actions'); + expect(mocks.tabsUpdate).toHaveBeenCalledWith(TARGET_TAB_ID, { active: true }); + expect(mocks.windowsUpdate).toHaveBeenCalledWith(TARGET_WINDOW_ID, { focused: true }); + }); + + it('switchTab fails when no matching tab found', async () => { + const executor = createExecutor({ actionsAllowlist: new Set(['switchTab']) }); + const ctx = createMockExecCtx(); + + // Setup tabs.query to return only tabs that don't match + mocks.tabsQuery.mockResolvedValueOnce([ + { + id: TAB_ID, + url: 'https://example.com/', + title: 'Example', + windowId: 1, + status: 'complete', + }, + ]); + + const step: TestStep = { + id: 'switchTab_not_found', + type: 'switchTab', + urlContains: 'nonexistent.example.com', + }; + + await expect(executor.execute(ctx, step as never, { tabId: TAB_ID })).rejects.toThrow( + /TAB_NOT_FOUND|no matching tab/i, + ); + }); + }); +}); diff --git a/app/chrome-extension/tests/vitest.setup.ts b/app/chrome-extension/tests/vitest.setup.ts new file mode 100644 index 00000000..e992379d --- /dev/null +++ b/app/chrome-extension/tests/vitest.setup.ts @@ -0,0 +1,72 @@ +/** + * @fileoverview Vitest Global Setup + * @description Provides global configuration and polyfills for test environment + */ + +import { vi } from 'vitest'; + +// Provide IndexedDB globals (jsdom doesn't include them) +import 'fake-indexeddb/auto'; + +// Mock chrome API (basic placeholder) +if (typeof globalThis.chrome === 'undefined') { + (globalThis as unknown as { chrome: object }).chrome = { + runtime: { + id: 'test-extension-id', + sendMessage: vi.fn().mockResolvedValue(undefined), + onMessage: { + addListener: vi.fn(), + removeListener: vi.fn(), + }, + connect: vi.fn().mockReturnValue({ + onMessage: { addListener: vi.fn(), removeListener: vi.fn() }, + onDisconnect: { addListener: vi.fn(), removeListener: vi.fn() }, + postMessage: vi.fn(), + disconnect: vi.fn(), + }), + }, + storage: { + local: { + get: vi.fn().mockResolvedValue({}), + set: vi.fn().mockResolvedValue(undefined), + remove: vi.fn().mockResolvedValue(undefined), + }, + }, + tabs: { + query: vi.fn().mockResolvedValue([]), + get: vi.fn().mockResolvedValue(null), + create: vi.fn().mockResolvedValue({ id: 1 }), + update: vi.fn().mockResolvedValue({}), + remove: vi.fn().mockResolvedValue(undefined), + captureVisibleTab: vi.fn().mockResolvedValue('data:image/png;base64,'), + onRemoved: { addListener: vi.fn(), removeListener: vi.fn() }, + onCreated: { addListener: vi.fn(), removeListener: vi.fn() }, + onUpdated: { addListener: vi.fn(), removeListener: vi.fn() }, + }, + webRequest: { + onBeforeRequest: { addListener: vi.fn(), removeListener: vi.fn() }, + onCompleted: { addListener: vi.fn(), removeListener: vi.fn() }, + onErrorOccurred: { addListener: vi.fn(), removeListener: vi.fn() }, + }, + webNavigation: { + onCommitted: { addListener: vi.fn(), removeListener: vi.fn() }, + onDOMContentLoaded: { addListener: vi.fn(), removeListener: vi.fn() }, + onCompleted: { addListener: vi.fn(), removeListener: vi.fn() }, + }, + debugger: { + onEvent: { addListener: vi.fn(), removeListener: vi.fn() }, + onDetach: { addListener: vi.fn(), removeListener: vi.fn() }, + attach: vi.fn().mockResolvedValue(undefined), + detach: vi.fn().mockResolvedValue(undefined), + sendCommand: vi.fn().mockResolvedValue({}), + }, + commands: { + onCommand: { addListener: vi.fn(), removeListener: vi.fn() }, + }, + contextMenus: { + create: vi.fn(), + remove: vi.fn(), + onClicked: { addListener: vi.fn(), removeListener: vi.fn() }, + }, + }; +} diff --git a/app/chrome-extension/tests/web-editor-v2/design-tokens.test.ts b/app/chrome-extension/tests/web-editor-v2/design-tokens.test.ts new file mode 100644 index 00000000..db16d1f0 --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/design-tokens.test.ts @@ -0,0 +1,473 @@ +/** + * Unit tests for Design Tokens Module (Phase 5.4) + * + * Tests cover: + * - token-resolver: var() parsing and formatting + * - token-detector: CSSOM scanning (mocked) + * - design-tokens-service: caching and query + * + * Note: jsdom doesn't have full CSSOM support, so we mock stylesheet APIs. + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +import { + createTokenResolver, + createTokenDetector, + createDesignTokensService, + type CssVarName, +} from '@/entrypoints/web-editor-v2/core/design-tokens'; + +// ============================================================================= +// Test Setup +// ============================================================================= + +beforeEach(() => { + document.body.innerHTML = ''; + vi.restoreAllMocks(); +}); + +afterEach(() => { + vi.restoreAllMocks(); +}); + +// ============================================================================= +// Token Resolver Tests +// ============================================================================= + +describe('token-resolver: formatCssVar', () => { + it('formats simple var() without fallback', () => { + const resolver = createTokenResolver(); + expect(resolver.formatCssVar('--color-primary')).toBe('var(--color-primary)'); + }); + + it('formats var() with fallback', () => { + const resolver = createTokenResolver(); + expect(resolver.formatCssVar('--color-primary', 'blue')).toBe('var(--color-primary, blue)'); + }); + + it('trims fallback whitespace', () => { + const resolver = createTokenResolver(); + expect(resolver.formatCssVar('--spacing', ' 16px ')).toBe('var(--spacing, 16px)'); + }); + + it('ignores empty fallback', () => { + const resolver = createTokenResolver(); + expect(resolver.formatCssVar('--x', '')).toBe('var(--x)'); + expect(resolver.formatCssVar('--x', ' ')).toBe('var(--x)'); + }); +}); + +describe('token-resolver: parseCssVar', () => { + it('parses simple var()', () => { + const resolver = createTokenResolver(); + const result = resolver.parseCssVar('var(--color)'); + expect(result).toEqual({ name: '--color' }); + }); + + it('parses var() with fallback', () => { + const resolver = createTokenResolver(); + const result = resolver.parseCssVar('var(--color, blue)'); + expect(result).toEqual({ name: '--color', fallback: 'blue' }); + }); + + it('parses var() with complex fallback', () => { + const resolver = createTokenResolver(); + const result = resolver.parseCssVar('var(--color, rgba(0, 0, 0, 0.5))'); + expect(result).toEqual({ name: '--color', fallback: 'rgba(0, 0, 0, 0.5)' }); + }); + + it('parses var() with nested var() fallback', () => { + const resolver = createTokenResolver(); + const result = resolver.parseCssVar('var(--color, var(--fallback))'); + expect(result).toEqual({ name: '--color', fallback: 'var(--fallback)' }); + }); + + it('returns null for non-var values', () => { + const resolver = createTokenResolver(); + expect(resolver.parseCssVar('blue')).toBeNull(); + expect(resolver.parseCssVar('rgb(0,0,0)')).toBeNull(); + expect(resolver.parseCssVar('')).toBeNull(); + expect(resolver.parseCssVar(' ')).toBeNull(); + }); + + it('returns null for invalid var()', () => { + const resolver = createTokenResolver(); + expect(resolver.parseCssVar('var()')).toBeNull(); + expect(resolver.parseCssVar('var(invalid)')).toBeNull(); // No -- prefix + expect(resolver.parseCssVar('var(--')).toBeNull(); // Unclosed + }); + + it('handles whitespace in var()', () => { + const resolver = createTokenResolver(); + expect(resolver.parseCssVar(' var( --x ) ')).toEqual({ name: '--x' }); + expect(resolver.parseCssVar('var( --x , blue )')).toEqual({ + name: '--x', + fallback: 'blue', + }); + }); +}); + +describe('token-resolver: extractCssVarNames', () => { + it('extracts single var() reference', () => { + const resolver = createTokenResolver(); + expect(resolver.extractCssVarNames('var(--color)')).toEqual(['--color']); + }); + + it('extracts multiple var() references', () => { + const resolver = createTokenResolver(); + const names = resolver.extractCssVarNames('calc(var(--a) + var(--b)) var(--c)'); + expect(names).toEqual(['--a', '--b', '--c']); + }); + + it('returns empty array for no vars', () => { + const resolver = createTokenResolver(); + expect(resolver.extractCssVarNames('blue')).toEqual([]); + expect(resolver.extractCssVarNames('')).toEqual([]); + }); + + it('handles nested var() in fallback', () => { + const resolver = createTokenResolver(); + // Only extracts top-level names (regex limitation, but good enough for Phase 5.4) + const names = resolver.extractCssVarNames('var(--color, var(--fallback))'); + expect(names).toContain('--color'); + expect(names).toContain('--fallback'); + }); +}); + +describe('token-resolver: readComputedValue', () => { + it('reads custom property from element', () => { + const div = document.createElement('div'); + div.style.setProperty('--test-color', 'red'); + document.body.append(div); + + const resolver = createTokenResolver(); + // Note: jsdom may not fully support computed custom properties + // This test verifies the API works without errors + const value = resolver.readComputedValue(div, '--test-color'); + // jsdom returns empty for custom props, but in real browser it would work + expect(typeof value).toBe('string'); + }); + + it('returns empty string for unset property', () => { + const div = document.createElement('div'); + document.body.append(div); + + const resolver = createTokenResolver(); + expect(resolver.readComputedValue(div, '--nonexistent')).toBe(''); + }); +}); + +describe('token-resolver: resolveToken', () => { + it('returns available for set token', () => { + const div = document.createElement('div'); + document.body.append(div); + + // Mock getComputedStyle + vi.spyOn(window, 'getComputedStyle').mockReturnValue({ + getPropertyValue: (name: string) => (name === '--color' ? 'red' : ''), + } as CSSStyleDeclaration); + + const resolver = createTokenResolver(); + const result = resolver.resolveToken(div, '--color'); + + expect(result.token).toBe('--color'); + expect(result.computedValue).toBe('red'); + expect(result.availability).toBe('available'); + }); + + it('returns unset for missing token', () => { + const div = document.createElement('div'); + document.body.append(div); + + vi.spyOn(window, 'getComputedStyle').mockReturnValue({ + getPropertyValue: () => '', + } as CSSStyleDeclaration); + + const resolver = createTokenResolver(); + const result = resolver.resolveToken(div, '--missing'); + + expect(result.availability).toBe('unset'); + }); +}); + +describe('token-resolver: resolveTokenForProperty', () => { + it('builds CSS value for property', () => { + const div = document.createElement('div'); + document.body.append(div); + + const resolver = createTokenResolver(); + const result = resolver.resolveTokenForProperty(div, '--color', 'color'); + + expect(result.token).toBe('--color'); + expect(result.cssProperty).toBe('color'); + expect(result.cssValue).toBe('var(--color)'); + expect(result.method).toBe('computed'); + }); + + it('includes fallback in CSS value', () => { + const div = document.createElement('div'); + + const resolver = createTokenResolver(); + const result = resolver.resolveTokenForProperty(div, '--color', 'background-color', { + fallback: 'white', + }); + + expect(result.cssValue).toBe('var(--color, white)'); + }); +}); + +// ============================================================================= +// Token Detector Tests +// ============================================================================= + +describe('token-detector: collectInlineTokenNames', () => { + it('collects token names from element inline style', () => { + const div = document.createElement('div'); + div.style.setProperty('--custom-var', '10px'); + div.style.setProperty('color', 'red'); // Regular property, should be ignored + document.body.append(div); + + const detector = createTokenDetector(); + const names = detector.collectInlineTokenNames(div); + + expect(names.has('--custom-var' as CssVarName)).toBe(true); + expect(names.size).toBe(1); + }); + + it('collects from ancestor chain', () => { + const parent = document.createElement('div'); + parent.style.setProperty('--parent-var', '20px'); + + const child = document.createElement('div'); + child.style.setProperty('--child-var', '10px'); + + parent.append(child); + document.body.append(parent); + + const detector = createTokenDetector(); + const names = detector.collectInlineTokenNames(child); + + expect(names.has('--parent-var' as CssVarName)).toBe(true); + expect(names.has('--child-var' as CssVarName)).toBe(true); + }); + + it('respects maxDepth option', () => { + const grandparent = document.createElement('div'); + grandparent.style.setProperty('--grandparent-var', '30px'); + + const parent = document.createElement('div'); + parent.style.setProperty('--parent-var', '20px'); + + const child = document.createElement('div'); + child.style.setProperty('--child-var', '10px'); + + grandparent.append(parent); + parent.append(child); + document.body.append(grandparent); + + const detector = createTokenDetector(); + const names = detector.collectInlineTokenNames(child, { maxDepth: 1 }); + + // Should only include child and parent (depth 0 and 1) + expect(names.has('--child-var' as CssVarName)).toBe(true); + expect(names.has('--parent-var' as CssVarName)).toBe(true); + expect(names.has('--grandparent-var' as CssVarName)).toBe(false); + }); + + it('returns empty set for element without custom props', () => { + const div = document.createElement('div'); + div.style.color = 'red'; + document.body.append(div); + + const detector = createTokenDetector(); + const names = detector.collectInlineTokenNames(div); + + expect(names.size).toBe(0); + }); +}); + +describe('token-detector: collectRootIndex', () => { + it('returns empty index when no stylesheets', () => { + // jsdom has empty styleSheets by default + const detector = createTokenDetector(); + const index = detector.collectRootIndex(document); + + expect(index.rootType).toBe('document'); + expect(index.tokens.size).toBe(0); + expect(index.warnings).toEqual([]); + expect(index.stats.styleSheets).toBeGreaterThanOrEqual(0); + }); + + it('handles missing styleSheets gracefully', () => { + const detector = createTokenDetector(); + + // Mock document with no styleSheets + const mockRoot = { + styleSheets: null, + adoptedStyleSheets: undefined, + } as unknown as Document; + + const index = detector.collectRootIndex(mockRoot); + expect(index.tokens.size).toBe(0); + }); +}); + +// ============================================================================= +// Design Tokens Service Tests +// ============================================================================= + +describe('design-tokens-service: basic operations', () => { + it('creates service successfully', () => { + const service = createDesignTokensService(); + expect(service).toBeDefined(); + expect(typeof service.getRootTokens).toBe('function'); + expect(typeof service.getContextTokens).toBe('function'); + service.dispose(); + }); + + it('getRootTokens returns empty for document without tokens', () => { + const service = createDesignTokensService(); + const result = service.getRootTokens(document); + + expect(result.tokens).toEqual([]); + expect(result.warnings).toBeDefined(); + expect(result.stats).toBeDefined(); + + service.dispose(); + }); + + it('getContextTokens filters to available tokens', () => { + const div = document.createElement('div'); + document.body.append(div); + + // Mock to return no tokens + vi.spyOn(window, 'getComputedStyle').mockReturnValue({ + getPropertyValue: () => '', + } as CSSStyleDeclaration); + + const service = createDesignTokensService(); + const result = service.getContextTokens(div); + + // Should be empty since no tokens resolve + expect(result.tokens).toEqual([]); + + service.dispose(); + }); +}); + +describe('design-tokens-service: utility methods', () => { + it('formatCssVar delegates to resolver', () => { + const service = createDesignTokensService(); + expect(service.formatCssVar('--x')).toBe('var(--x)'); + expect(service.formatCssVar('--x', 'y')).toBe('var(--x, y)'); + service.dispose(); + }); + + it('parseCssVar delegates to resolver', () => { + const service = createDesignTokensService(); + expect(service.parseCssVar('var(--x)')).toEqual({ name: '--x' }); + expect(service.parseCssVar('invalid')).toBeNull(); + service.dispose(); + }); + + it('extractCssVarNames delegates to resolver', () => { + const service = createDesignTokensService(); + expect(service.extractCssVarNames('var(--a) var(--b)')).toEqual(['--a', '--b']); + service.dispose(); + }); +}); + +describe('design-tokens-service: cache invalidation', () => { + it('invalidateRoot clears cache and emits event', () => { + const service = createDesignTokensService(); + const handler = vi.fn(); + + service.onInvalidation(handler); + service.invalidateRoot(document, 'manual'); + + expect(handler).toHaveBeenCalledTimes(1); + expect(handler).toHaveBeenCalledWith( + expect.objectContaining({ + root: document, + rootType: 'document', + reason: 'manual', + }), + ); + + service.dispose(); + }); + + it('onInvalidation returns unsubscribe function', () => { + const service = createDesignTokensService(); + const handler = vi.fn(); + + const unsubscribe = service.onInvalidation(handler); + service.invalidateRoot(document); + expect(handler).toHaveBeenCalledTimes(1); + + unsubscribe(); + service.invalidateRoot(document); + expect(handler).toHaveBeenCalledTimes(1); // Not called again + + service.dispose(); + }); +}); + +describe('design-tokens-service: dispose', () => { + it('can be called multiple times safely', () => { + const service = createDesignTokensService(); + expect(() => { + service.dispose(); + service.dispose(); + }).not.toThrow(); + }); + + it('clears invalidation listeners on dispose', () => { + const service = createDesignTokensService(); + const handler = vi.fn(); + + service.onInvalidation(handler); + service.dispose(); + + // After dispose, invalidation shouldn't call handler + // (but we can't easily test this without exposing internals) + expect(handler).not.toHaveBeenCalled(); + }); +}); + +describe('design-tokens-service: resolveToken', () => { + it('resolves token for element', () => { + const div = document.createElement('div'); + document.body.append(div); + + vi.spyOn(window, 'getComputedStyle').mockReturnValue({ + getPropertyValue: (name: string) => (name === '--color' ? '#ff0000' : ''), + } as CSSStyleDeclaration); + + const service = createDesignTokensService(); + const result = service.resolveToken(div, '--color'); + + expect(result.token).toBe('--color'); + expect(result.computedValue).toBe('#ff0000'); + expect(result.availability).toBe('available'); + + service.dispose(); + }); +}); + +describe('design-tokens-service: resolveTokenForProperty', () => { + it('builds CSS value for applying token', () => { + const div = document.createElement('div'); + + const service = createDesignTokensService(); + const result = service.resolveTokenForProperty(div, '--spacing', 'padding', { + fallback: '8px', + }); + + expect(result.cssValue).toBe('var(--spacing, 8px)'); + expect(result.cssProperty).toBe('padding'); + + service.dispose(); + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/drag-reorder-controller.test.ts b/app/chrome-extension/tests/web-editor-v2/drag-reorder-controller.test.ts new file mode 100644 index 00000000..c6f1f3e1 --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/drag-reorder-controller.test.ts @@ -0,0 +1,277 @@ +/** + * Unit tests for Web Editor V2 Drag Reorder Controller. + * + * These tests focus on the container axis detection and side calculation: + * - Flex row support (Bug 2 fix) + * - Reverse layout handling + * - Insertion line direction + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +import type { RestoreFn } from './test-utils/dom'; +import { mockBoundingClientRect, mockGetComputedStyle } from './test-utils/dom'; + +// ============================================================================= +// Test Utilities +// ============================================================================= + +// Import the internal functions we want to test +// Since they're not exported, we'll test through the public API behavior +// For unit testing internal logic, we can create a separate test module + +/** + * Helper to determine container axis from computed style. + * This mirrors the internal getContainerAxis logic for testing. + */ +function getContainerAxisFromStyle(style: { + display: string; + flexDirection?: string; + flexWrap?: string; +}): { axis: 'x' | 'y'; reverse: boolean } | null { + const { display, flexDirection, flexWrap } = style; + + // Reject grid + if (display === 'grid' || display === 'inline-grid') return null; + + // Handle flex + if (display === 'flex' || display === 'inline-flex') { + // Reject wrapped flex (2D) + if (flexWrap === 'wrap' || flexWrap === 'wrap-reverse') return null; + + switch (flexDirection) { + case 'row': + return { axis: 'x', reverse: false }; + case 'row-reverse': + return { axis: 'x', reverse: true }; + case 'column': + return { axis: 'y', reverse: false }; + case 'column-reverse': + return { axis: 'y', reverse: true }; + default: + return { axis: 'y', reverse: false }; + } + } + + // Default to vertical + return { axis: 'y', reverse: false }; +} + +/** + * Helper to calculate side with hysteresis. + * This mirrors the internal chooseSideWithHysteresis logic. + */ +function chooseSide( + clientPos: number, + rectStart: number, + rectSize: number, + axis: 'x' | 'y', + reverse: boolean, +): 'before' | 'after' { + const mid = rectStart + rectSize / 2; + const effectivePos = reverse ? -clientPos : clientPos; + const effectiveMid = reverse ? -mid : mid; + return effectivePos < effectiveMid ? 'before' : 'after'; +} + +// ============================================================================= +// Test Setup +// ============================================================================= + +let restores: RestoreFn[] = []; + +beforeEach(() => { + restores = []; + document.body.innerHTML = ''; +}); + +afterEach(() => { + for (let i = restores.length - 1; i >= 0; i--) { + restores[i]!(); + } + restores = []; + vi.restoreAllMocks(); +}); + +// ============================================================================= +// Container Axis Detection Tests +// ============================================================================= + +describe('drag-reorder: container axis detection', () => { + it('flex-direction: row returns X axis', () => { + const result = getContainerAxisFromStyle({ + display: 'flex', + flexDirection: 'row', + }); + expect(result).toEqual({ axis: 'x', reverse: false }); + }); + + it('flex-direction: row-reverse returns X axis with reverse', () => { + const result = getContainerAxisFromStyle({ + display: 'flex', + flexDirection: 'row-reverse', + }); + expect(result).toEqual({ axis: 'x', reverse: true }); + }); + + it('flex-direction: column returns Y axis', () => { + const result = getContainerAxisFromStyle({ + display: 'flex', + flexDirection: 'column', + }); + expect(result).toEqual({ axis: 'y', reverse: false }); + }); + + it('flex-direction: column-reverse returns Y axis with reverse', () => { + const result = getContainerAxisFromStyle({ + display: 'flex', + flexDirection: 'column-reverse', + }); + expect(result).toEqual({ axis: 'y', reverse: true }); + }); + + it('non-flex layout returns Y axis (block flow)', () => { + const result = getContainerAxisFromStyle({ + display: 'block', + }); + expect(result).toEqual({ axis: 'y', reverse: false }); + }); + + it('grid layout returns null (not supported)', () => { + const result = getContainerAxisFromStyle({ + display: 'grid', + }); + expect(result).toBeNull(); + }); + + it('flex-wrap: wrap returns null (2D not supported)', () => { + const result = getContainerAxisFromStyle({ + display: 'flex', + flexDirection: 'row', + flexWrap: 'wrap', + }); + expect(result).toBeNull(); + }); +}); + +// ============================================================================= +// Side Calculation Tests +// ============================================================================= + +describe('drag-reorder: side calculation', () => { + describe('X axis (horizontal)', () => { + it('left half returns "before"', () => { + // rect: left=100, width=100 (100-200), mid=150 + // clientX=120 (left of mid) + const side = chooseSide(120, 100, 100, 'x', false); + expect(side).toBe('before'); + }); + + it('right half returns "after"', () => { + // rect: left=100, width=100, mid=150 + // clientX=180 (right of mid) + const side = chooseSide(180, 100, 100, 'x', false); + expect(side).toBe('after'); + }); + }); + + describe('X axis with reverse (row-reverse)', () => { + it('right half returns "before" in reverse mode', () => { + // In row-reverse, visual left is DOM right + // rect: left=100, width=100, mid=150 + // clientX=180 (visual right = DOM before) + const side = chooseSide(180, 100, 100, 'x', true); + expect(side).toBe('before'); + }); + + it('left half returns "after" in reverse mode', () => { + // rect: left=100, width=100, mid=150 + // clientX=120 (visual left = DOM after) + const side = chooseSide(120, 100, 100, 'x', true); + expect(side).toBe('after'); + }); + }); + + describe('Y axis (vertical)', () => { + it('top half returns "before"', () => { + // rect: top=100, height=100 (100-200), mid=150 + // clientY=120 (above mid) + const side = chooseSide(120, 100, 100, 'y', false); + expect(side).toBe('before'); + }); + + it('bottom half returns "after"', () => { + // rect: top=100, height=100, mid=150 + // clientY=180 (below mid) + const side = chooseSide(180, 100, 100, 'y', false); + expect(side).toBe('after'); + }); + }); + + describe('Y axis with reverse (column-reverse)', () => { + it('bottom half returns "before" in reverse mode', () => { + const side = chooseSide(180, 100, 100, 'y', true); + expect(side).toBe('before'); + }); + + it('top half returns "after" in reverse mode', () => { + const side = chooseSide(120, 100, 100, 'y', true); + expect(side).toBe('after'); + }); + }); +}); + +// ============================================================================= +// Insertion Line Direction Tests +// ============================================================================= + +describe('drag-reorder: insertion line direction', () => { + it('horizontal layout should produce vertical line (x1 === x2)', () => { + // For flex-row, insertion line should be vertical + // This is a conceptual test - actual line is calculated in computeInsertPosition + + const rect = { left: 100, top: 50, width: 80, height: 40 }; + const axis = 'x'; + const side = 'before'; + const reverse = false; + + // Calculate expected line position + const beforeX = reverse ? rect.left + rect.width : rect.left; + const afterX = reverse ? rect.left : rect.left + rect.width; + const x = side === 'before' ? beforeX : afterX; + + // Vertical line: x1 === x2 + const line = { + x1: x, + y1: rect.top, + x2: x, + y2: rect.top + rect.height, + }; + + expect(line.x1).toBe(line.x2); // Vertical line + expect(line.x1).toBe(rect.left); // At left edge for "before" + }); + + it('vertical layout should produce horizontal line (y1 === y2)', () => { + const rect = { left: 100, top: 50, width: 80, height: 40 }; + const axis = 'y'; + const side = 'before'; + const reverse = false; + + // Calculate expected line position + const beforeY = reverse ? rect.top + rect.height : rect.top; + const afterY = reverse ? rect.top : rect.top + rect.height; + const y = side === 'before' ? beforeY : afterY; + + // Horizontal line: y1 === y2 + const line = { + x1: rect.left, + y1: y, + x2: rect.left + rect.width, + y2: y, + }; + + expect(line.y1).toBe(line.y2); // Horizontal line + expect(line.y1).toBe(rect.top); // At top edge for "before" + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/event-controller.test.ts b/app/chrome-extension/tests/web-editor-v2/event-controller.test.ts new file mode 100644 index 00000000..d107b6b7 --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/event-controller.test.ts @@ -0,0 +1,234 @@ +/** + * Unit tests for Web Editor V2 Event Controller. + * + * These tests focus on the selecting mode behavior: + * - Clicking within selection subtree prepares drag candidate + * - Clicking outside selection triggers reselection (Bug 1 fix) + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +import { + createEventController, + type EventController, + type EventControllerOptions, + type Modifiers, +} from '@/entrypoints/web-editor-v2/core/event-controller'; + +import type { RestoreFn } from './test-utils/dom'; +import { mockBoundingClientRect } from './test-utils/dom'; + +// ============================================================================= +// Test Utilities +// ============================================================================= + +const NO_MODIFIERS: Modifiers = { alt: false, shift: false, ctrl: false, meta: false }; + +/** + * Check if an element is part of the editor overlay. + */ +function isOverlayElement(node: unknown): boolean { + return node instanceof Element && node.getAttribute('data-overlay') === 'true'; +} + +/** + * Create a minimal mock PointerEvent for testing. + * jsdom doesn't support PointerEvent, so we create a MouseEvent and extend it. + */ +function createPointerEvent( + type: string, + options: { + clientX?: number; + clientY?: number; + button?: number; + pointerId?: number; + target?: EventTarget | null; + } = {}, +): MouseEvent & { pointerId: number } { + const event = new MouseEvent(type, { + bubbles: true, + cancelable: true, + clientX: options.clientX ?? 0, + clientY: options.clientY ?? 0, + button: options.button ?? 0, + }); + + // Add pointerId property (jsdom doesn't have PointerEvent) + Object.defineProperty(event, 'pointerId', { + value: options.pointerId ?? 1, + writable: false, + }); + + // Mock composedPath to return target path + if (options.target) { + vi.spyOn(event, 'composedPath').mockReturnValue([options.target as EventTarget]); + } + + return event as MouseEvent & { pointerId: number }; +} + +// ============================================================================= +// Test Setup +// ============================================================================= + +let restores: RestoreFn[] = []; +let controller: EventController | null = null; + +beforeEach(() => { + restores = []; + document.body.innerHTML = ''; +}); + +afterEach(() => { + controller?.dispose(); + controller = null; + for (let i = restores.length - 1; i >= 0; i--) { + restores[i]!(); + } + restores = []; + vi.restoreAllMocks(); +}); + +// ============================================================================= +// Selecting Mode Tests (Bug 1 Fix) +// ============================================================================= + +describe('event-controller: selecting mode click behavior', () => { + it('clicking within selection subtree prepares drag candidate (does not trigger onSelect)', () => { + // Setup DOM + const selected = document.createElement('div'); + selected.id = 'selected'; + const child = document.createElement('span'); + child.id = 'child'; + selected.appendChild(child); + document.body.appendChild(selected); + + // Mock rect for selected element + restores.push(mockBoundingClientRect(selected, { left: 0, top: 0, width: 100, height: 100 })); + restores.push(mockBoundingClientRect(child, { left: 10, top: 10, width: 50, height: 50 })); + + // Setup callbacks + const onSelect = vi.fn(); + const onStartDrag = vi.fn().mockReturnValue(true); + + const options: EventControllerOptions = { + isOverlayElement, + isEditorUiElement: () => false, + getSelectedElement: () => selected, + getEditingElement: () => null, + findTargetForSelect: () => child, + onHover: vi.fn(), + onSelect, + onDeselect: vi.fn(), + onStartDrag, + }; + + controller = createEventController(options); + controller.setMode('selecting'); + + // Simulate pointerdown within selected element + const event = createPointerEvent('pointerdown', { + clientX: 20, + clientY: 20, + target: child, + }); + + document.dispatchEvent(event); + + // onSelect should NOT be called (we're preparing drag instead) + expect(onSelect).not.toHaveBeenCalled(); + }); + + it('clicking outside selection triggers reselection (Bug 1 fix)', () => { + // Setup DOM + const selected = document.createElement('div'); + selected.id = 'selected'; + document.body.appendChild(selected); + + const other = document.createElement('div'); + other.id = 'other'; + document.body.appendChild(other); + + // Mock rects + restores.push(mockBoundingClientRect(selected, { left: 0, top: 0, width: 100, height: 100 })); + restores.push(mockBoundingClientRect(other, { left: 200, top: 0, width: 100, height: 100 })); + + // Setup callbacks + const onSelect = vi.fn(); + const onStartDrag = vi.fn().mockReturnValue(true); + + const options: EventControllerOptions = { + isOverlayElement, + isEditorUiElement: () => false, + getSelectedElement: () => selected, + getEditingElement: () => null, + findTargetForSelect: () => other, // Returns the "other" element as target + onHover: vi.fn(), + onSelect, + onDeselect: vi.fn(), + onStartDrag, + }; + + controller = createEventController(options); + controller.setMode('selecting'); + + // Simulate mousedown outside selected element (on "other") + // Use mousedown since jsdom doesn't support PointerEvent + const event = new MouseEvent('mousedown', { + bubbles: true, + cancelable: true, + clientX: 250, // Outside selected (0-100), inside other (200-300) + clientY: 50, + button: 0, + }); + + // Mock composedPath to return a path that does NOT include "selected" + // This simulates clicking outside the selection + vi.spyOn(event, 'composedPath').mockReturnValue([other, document.body, document]); + + document.dispatchEvent(event); + + // onSelect SHOULD be called with the new element + expect(onSelect).toHaveBeenCalledWith(other, expect.any(Object)); + }); + + it('clicking outside with no valid target does not trigger onSelect', () => { + // Setup DOM + const selected = document.createElement('div'); + selected.id = 'selected'; + document.body.appendChild(selected); + + // Mock rect + restores.push(mockBoundingClientRect(selected, { left: 0, top: 0, width: 100, height: 100 })); + + // Setup callbacks + const onSelect = vi.fn(); + + const options: EventControllerOptions = { + isOverlayElement, + isEditorUiElement: () => false, + getSelectedElement: () => selected, + getEditingElement: () => null, + findTargetForSelect: () => null, // No valid target found + onHover: vi.fn(), + onSelect, + onDeselect: vi.fn(), + onStartDrag: vi.fn(), + }; + + controller = createEventController(options); + controller.setMode('selecting'); + + // Simulate pointerdown outside selected element + const event = createPointerEvent('pointerdown', { + clientX: 500, + clientY: 500, + target: document.body, + }); + + document.dispatchEvent(event); + + // onSelect should NOT be called (no valid target) + expect(onSelect).not.toHaveBeenCalled(); + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/locator.test.ts b/app/chrome-extension/tests/web-editor-v2/locator.test.ts new file mode 100644 index 00000000..81b436c4 --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/locator.test.ts @@ -0,0 +1,506 @@ +/** + * Unit tests for Web Editor V2 locator utilities. + * + * These tests run in jsdom and validate: + * - Fingerprint generation (tag, id, class, text normalization) + * - DOM path computation + * - Selector candidate strategies (ID > data-attrs > classes > path > anchor) + * - Locator creation and resolution + * - Locator key stability + * - Shadow host chain detection + */ + +import { beforeEach, describe, expect, it } from 'vitest'; + +import type { ElementLocator } from '@/common/web-editor-types'; +import { + computeDomPath, + computeFingerprint, + createElementLocator, + generateCssSelector, + generateSelectorCandidates, + getShadowHostChain, + locateElement, + locatorKey, +} from '@/entrypoints/web-editor-v2/core/locator'; + +// ============================================================================= +// Test Utilities +// ============================================================================= + +const supportsShadowDom = + typeof (document.createElement('div') as HTMLElement).attachShadow === 'function'; +const itIfShadow = supportsShadowDom ? it : it.skip; + +beforeEach(() => { + document.body.innerHTML = ''; +}); + +// ============================================================================= +// computeFingerprint Tests +// ============================================================================= + +describe('locator: computeFingerprint', () => { + it('includes tag, id, class list, and normalized text', () => { + const el = document.createElement('button'); + el.id = 'save'; + el.className = 'btn primary'; + el.textContent = ' Hello world \n ok '; + document.body.append(el); + + const fp = computeFingerprint(el); + + expect(fp).toContain('button'); + expect(fp).toContain('id=save'); + expect(fp).toContain('class=btn.primary'); + expect(fp).toContain('text=Hello world ok'); + }); + + it('limits classes to 8 tokens', () => { + const el = document.createElement('div'); + el.className = Array.from({ length: 10 }, (_, i) => `c${i}`).join(' '); + document.body.append(el); + + const fp = computeFingerprint(el); + const classPart = fp.split('|').find((p) => p.startsWith('class=')); + + // Should have exactly 8 classes + const classes = classPart?.replace('class=', '').split('.') ?? []; + expect(classes).toHaveLength(8); + expect(classes).toEqual(['c0', 'c1', 'c2', 'c3', 'c4', 'c5', 'c6', 'c7']); + }); + + it('truncates text to 32 characters', () => { + const el = document.createElement('div'); + el.textContent = 'a'.repeat(40); + document.body.append(el); + + const fp = computeFingerprint(el); + const textPart = fp.split('|').find((p) => p.startsWith('text=')); + const text = textPart?.replace('text=', '') ?? ''; + + expect(text.length).toBeLessThanOrEqual(32); + }); + + it('returns only tag when id/class/text are empty', () => { + const el = document.createElement('div'); + document.body.append(el); + + expect(computeFingerprint(el)).toBe('div'); + }); + + it('normalizes whitespace in text', () => { + const el = document.createElement('span'); + el.textContent = '\n foo bar\t\tbaz \n'; + document.body.append(el); + + const fp = computeFingerprint(el); + expect(fp).toContain('text=foo bar baz'); + }); + + it('preserves class order from classList', () => { + const el = document.createElement('div'); + el.className = 'z-class a-class m-class'; + document.body.append(el); + + const fp = computeFingerprint(el); + // Classes are preserved in their original order from classList + expect(fp).toContain('class=z-class.a-class.m-class'); + }); +}); + +// ============================================================================= +// computeDomPath Tests +// ============================================================================= + +describe('locator: computeDomPath', () => { + it('computes stable indices for nested elements in document', () => { + const container = document.createElement('div'); + const first = document.createElement('span'); + const second = document.createElement('span'); + container.append(first, second); + document.body.append(container); + + const firstPath = computeDomPath(first); + const secondPath = computeDomPath(second); + + // Second child should have higher last index + expect(secondPath[secondPath.length - 1]).toBeGreaterThan( + firstPath[firstPath.length - 1] as number, + ); + }); + + it('returns different paths for siblings', () => { + const a = document.createElement('div'); + const b = document.createElement('div'); + document.body.append(a, b); + + expect(computeDomPath(a)).not.toEqual(computeDomPath(b)); + }); + + itIfShadow('computes index within a ShadowRoot boundary', () => { + const host = document.createElement('div'); + document.body.append(host); + + const shadow = host.attachShadow({ mode: 'open' }); + const a = document.createElement('div'); + const b = document.createElement('div'); + shadow.append(a, b); + + // Path within shadow should start from 0 + const pathA = computeDomPath(a); + const pathB = computeDomPath(b); + + expect(pathA[0]).toBe(0); + expect(pathB[0]).toBe(1); + }); +}); + +// ============================================================================= +// Selector Generation Tests +// ============================================================================= + +describe('locator: generateSelectorCandidates', () => { + it('prefers unique id selector first', () => { + const el = document.createElement('div'); + el.id = 'unique'; + document.body.append(el); + + const candidates = generateSelectorCandidates(el, { root: document }); + expect(candidates[0]).toBe('#unique'); + }); + + it('uses data-testid when unique', () => { + const el = document.createElement('button'); + el.setAttribute('data-testid', 'save-btn'); + document.body.append(el); + + const candidates = generateSelectorCandidates(el, { root: document }); + expect(candidates[0]).toBe('[data-testid="save-btn"]'); + }); + + it('uses tag+data-testid when attribute alone is not unique', () => { + const div = document.createElement('div'); + div.setAttribute('data-testid', 'dup'); + const span = document.createElement('span'); + span.setAttribute('data-testid', 'dup'); + document.body.append(div, span); + + const candidates = generateSelectorCandidates(div, { root: document }); + expect(candidates[0]).toBe('div[data-testid="dup"]'); + }); + + it('uses tag+class when class alone is not unique', () => { + const a = document.createElement('div'); + a.className = 'item'; + const b = document.createElement('button'); + b.className = 'item'; + document.body.append(a, b); + + const candidates = generateSelectorCandidates(b, { root: document }); + expect(candidates[0]).toBe('button.item'); + }); + + it('uses class pair selector when only the combination is unique', () => { + const target = document.createElement('div'); + target.className = 'a b'; + const onlyA = document.createElement('div'); + onlyA.className = 'a'; + const onlyB = document.createElement('div'); + onlyB.className = 'b'; + document.body.append(target, onlyA, onlyB); + + const candidates = generateSelectorCandidates(target, { root: document }); + expect(candidates[0]).toBe('.a.b'); + }); + + it('generates multiple candidates', () => { + const el = document.createElement('div'); + el.id = 'myid'; + el.className = 'myclass'; + el.setAttribute('data-testid', 'mytest'); + document.body.append(el); + + const candidates = generateSelectorCandidates(el, { root: document, maxCandidates: 5 }); + expect(candidates.length).toBeGreaterThan(1); + expect(candidates).toContain('#myid'); + }); + + it('falls back to structural path selector when no unique attrs/classes exist', () => { + const section = document.createElement('section'); + const p = document.createElement('p'); + section.append(p); + document.body.append(section); + + const candidates = generateSelectorCandidates(p, { root: document }); + // Should include a path-based selector + const hasPath = candidates.some((c) => c.includes('>')); + expect(hasPath).toBe(true); + }); + + it('respects maxCandidates option', () => { + const el = document.createElement('div'); + el.id = 'test'; + el.className = 'a b c'; + el.setAttribute('data-testid', 'x'); + document.body.append(el); + + const candidates = generateSelectorCandidates(el, { root: document, maxCandidates: 2 }); + expect(candidates.length).toBeLessThanOrEqual(2); + }); +}); + +describe('locator: generateCssSelector', () => { + it('returns the best single selector', () => { + const el = document.createElement('div'); + el.id = 'unique'; + document.body.append(el); + + expect(generateCssSelector(el, { root: document })).toBe('#unique'); + }); + + it('returns empty string for orphan element', () => { + const el = document.createElement('div'); + // Element not in document + const selector = generateCssSelector(el); + // May return a selector or empty depending on implementation + expect(typeof selector).toBe('string'); + }); +}); + +// ============================================================================= +// Locator Creation & Resolution Tests +// ============================================================================= + +describe('locator: createElementLocator', () => { + it('creates a locator with selectors, fingerprint, and dom path', () => { + const el = document.createElement('div'); + el.id = 'target'; + el.className = 'box'; + el.textContent = 'Hello'; + document.body.append(el); + + const locator = createElementLocator(el); + + expect(locator.selectors.length).toBeGreaterThan(0); + expect(locator.selectors[0]).toBe('#target'); + expect(locator.fingerprint).toBe(computeFingerprint(el)); + expect(locator.path).toEqual(computeDomPath(el)); + }); + + itIfShadow('includes shadowHostChain when element is inside Shadow DOM', () => { + const host = document.createElement('div'); + host.id = 'host'; + document.body.append(host); + + const shadow = host.attachShadow({ mode: 'open' }); + const target = document.createElement('span'); + target.id = 'inner'; + shadow.append(target); + + const locator = createElementLocator(target); + + expect(locator.shadowHostChain).toBeDefined(); + expect(locator.shadowHostChain!.length).toBeGreaterThan(0); + }); +}); + +describe('locator: locateElement', () => { + it('locates an element from its own locator', () => { + const el = document.createElement('div'); + el.id = 'target'; + el.textContent = 'Hello'; + document.body.append(el); + + const locator = createElementLocator(el); + const found = locateElement(locator, document); + + expect(found).toBe(el); + }); + + it('tries multiple selectors and falls back to later candidates', () => { + const el = document.createElement('div'); + el.id = 'target'; + document.body.append(el); + + const locator: ElementLocator = { + selectors: ['#missing', '#target'], + fingerprint: computeFingerprint(el), + path: [], + }; + + expect(locateElement(locator, document)).toBe(el); + }); + + it('returns null when selector is not unique', () => { + const a = document.createElement('div'); + a.className = 'x'; + const b = document.createElement('div'); + b.className = 'x'; + document.body.append(a, b); + + const locator: ElementLocator = { + selectors: ['.x'], + fingerprint: computeFingerprint(a), + path: [], + }; + + // Should return null because .x matches 2 elements + expect(locateElement(locator, document)).toBeNull(); + }); + + it('returns null when fingerprint does not match', () => { + const el = document.createElement('div'); + el.id = 'a'; + document.body.append(el); + + const locator: ElementLocator = { + selectors: ['#a'], + fingerprint: 'div|id=wrong', // Wrong fingerprint + path: [], + }; + + expect(locateElement(locator, document)).toBeNull(); + }); + + it('handles element removal gracefully', () => { + const el = document.createElement('div'); + el.id = 'temp'; + document.body.append(el); + + const locator = createElementLocator(el); + el.remove(); + + expect(locateElement(locator, document)).toBeNull(); + }); + + itIfShadow('locates element inside nested ShadowRoot via shadowHostChain', () => { + const outerHost = document.createElement('div'); + outerHost.id = 'outer-host'; + document.body.append(outerHost); + + const outerShadow = outerHost.attachShadow({ mode: 'open' }); + + const innerHost = document.createElement('div'); + innerHost.id = 'inner-host'; + outerShadow.append(innerHost); + + const innerShadow = innerHost.attachShadow({ mode: 'open' }); + const target = document.createElement('span'); + target.id = 'shadow-target'; + innerShadow.append(target); + + const locator = createElementLocator(target); + const found = locateElement(locator, document); + + expect(found).toBe(target); + }); +}); + +// ============================================================================= +// Shadow Host Chain Tests +// ============================================================================= + +describe('locator: getShadowHostChain', () => { + it('returns undefined for element not in Shadow DOM', () => { + const el = document.createElement('div'); + document.body.append(el); + + expect(getShadowHostChain(el)).toBeUndefined(); + }); + + itIfShadow('returns chain for single-level Shadow DOM', () => { + const host = document.createElement('div'); + host.id = 'myhost'; + document.body.append(host); + + const shadow = host.attachShadow({ mode: 'open' }); + const inner = document.createElement('span'); + shadow.append(inner); + + const chain = getShadowHostChain(inner); + expect(chain).toBeDefined(); + expect(chain!.length).toBe(1); + expect(chain![0]).toBe('#myhost'); + }); + + itIfShadow('returns chain for nested Shadow DOMs', () => { + const outer = document.createElement('div'); + outer.id = 'outer'; + document.body.append(outer); + + const outerShadow = outer.attachShadow({ mode: 'open' }); + const inner = document.createElement('div'); + inner.id = 'inner'; + outerShadow.append(inner); + + const innerShadow = inner.attachShadow({ mode: 'open' }); + const target = document.createElement('span'); + innerShadow.append(target); + + const chain = getShadowHostChain(target); + expect(chain).toBeDefined(); + expect(chain!.length).toBe(2); + expect(chain![0]).toBe('#outer'); + expect(chain![1]).toBe('#inner'); + }); +}); + +// ============================================================================= +// locatorKey Tests +// ============================================================================= + +describe('locator: locatorKey', () => { + it('generates a stable key including selectors', () => { + const el = document.createElement('div'); + el.id = 'k1'; + document.body.append(el); + + const locator = createElementLocator(el); + const key = locatorKey(locator); + + expect(key).toContain('sel:'); + expect(key).toContain('#k1'); + }); + + it('differs for different locators', () => { + const a = document.createElement('div'); + a.id = 'a'; + const b = document.createElement('div'); + b.id = 'b'; + document.body.append(a, b); + + const keyA = locatorKey(createElementLocator(a)); + const keyB = locatorKey(createElementLocator(b)); + + expect(keyA).not.toBe(keyB); + }); + + it('is deterministic for same element', () => { + const el = document.createElement('div'); + el.id = 'stable'; + document.body.append(el); + + const key1 = locatorKey(createElementLocator(el)); + const key2 = locatorKey(createElementLocator(el)); + + expect(key1).toBe(key2); + }); + + itIfShadow('includes shadow host chain in the key when present', () => { + const host = document.createElement('div'); + host.id = 'host'; + document.body.append(host); + const shadow = host.attachShadow({ mode: 'open' }); + + const target = document.createElement('span'); + target.id = 't'; + shadow.append(target); + + const locator = createElementLocator(target); + const key = locatorKey(locator); + + expect(key).toContain('shadow:'); + expect(key).toContain('#host'); + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/property-panel-live-sync.test.ts b/app/chrome-extension/tests/web-editor-v2/property-panel-live-sync.test.ts new file mode 100644 index 00000000..fafe493c --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/property-panel-live-sync.test.ts @@ -0,0 +1,243 @@ +/** + * Unit tests for Web Editor V2 Property Panel Live Style Sync. + * + * These tests focus on: + * - MutationObserver setup for style attribute changes (Bug 3 fix) + * - rAF throttling of refresh calls + * - Proper cleanup on target change and dispose + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +// ============================================================================= +// Test Setup +// ============================================================================= + +// Mock MutationObserver +let mockObserverCallback: MutationCallback | null = null; +let mockObserverDisconnect: ReturnType; + +class MockMutationObserver { + callback: MutationCallback; + + constructor(callback: MutationCallback) { + this.callback = callback; + mockObserverCallback = callback; + } + + observe = vi.fn(); + disconnect = vi.fn(() => { + mockObserverDisconnect?.(); + }); + takeRecords = vi.fn(() => []); +} + +beforeEach(() => { + mockObserverCallback = null; + mockObserverDisconnect = vi.fn(); + + // Install mock MutationObserver + vi.stubGlobal('MutationObserver', MockMutationObserver); + + // Mock requestAnimationFrame + vi.stubGlobal( + 'requestAnimationFrame', + vi.fn((cb: FrameRequestCallback) => { + // Execute immediately for testing + cb(performance.now()); + return 1; + }), + ); + + vi.stubGlobal('cancelAnimationFrame', vi.fn()); +}); + +afterEach(() => { + vi.unstubAllGlobals(); + vi.restoreAllMocks(); +}); + +// ============================================================================= +// MutationObserver Integration Tests +// ============================================================================= + +describe('property-panel: live style sync', () => { + it('should observe style attribute changes on target element', () => { + // This is a conceptual test for the MutationObserver setup + // The actual implementation is in property-panel.ts + + const target = document.createElement('div'); + const observer = new MockMutationObserver(() => {}); + + observer.observe(target, { + attributes: true, + attributeFilter: ['style'], + }); + + expect(observer.observe).toHaveBeenCalledWith(target, { + attributes: true, + attributeFilter: ['style'], + }); + }); + + it('should trigger callback when style changes', () => { + const callback = vi.fn(); + const observer = new MockMutationObserver(callback); + const target = document.createElement('div'); + + observer.observe(target, { attributes: true, attributeFilter: ['style'] }); + + // Simulate style mutation with a minimal MutationRecord-like object + if (mockObserverCallback) { + mockObserverCallback( + [ + { + type: 'attributes', + target, + attributeName: 'style', + attributeNamespace: null, + oldValue: null, + addedNodes: { length: 0 } as unknown as NodeList, + removedNodes: { length: 0 } as unknown as NodeList, + previousSibling: null, + nextSibling: null, + } as MutationRecord, + ], + observer as unknown as MutationObserver, + ); + } + + expect(callback).toHaveBeenCalled(); + }); + + it('should disconnect observer when target changes', () => { + const observer = new MockMutationObserver(() => {}); + observer.disconnect(); + expect(observer.disconnect).toHaveBeenCalled(); + }); +}); + +// ============================================================================= +// rAF Throttling Tests +// ============================================================================= + +describe('property-panel: rAF throttling', () => { + it('should coalesce multiple style changes into single refresh', () => { + let rafCallCount = 0; + let scheduledCallback: FrameRequestCallback | null = null; + + vi.stubGlobal('requestAnimationFrame', (cb: FrameRequestCallback) => { + rafCallCount++; + scheduledCallback = cb; + return rafCallCount; + }); + + // Simulate the throttling logic + let rafId: number | null = null; + const refreshCalls: number[] = []; + + function scheduleRefresh(): void { + if (rafId !== null) return; // Already scheduled + rafId = requestAnimationFrame(() => { + rafId = null; + refreshCalls.push(Date.now()); + }); + } + + // Schedule multiple refreshes + scheduleRefresh(); + scheduleRefresh(); + scheduleRefresh(); + + // Only one rAF should be scheduled + expect(rafCallCount).toBe(1); + + // Execute the callback + if (scheduledCallback) { + scheduledCallback(performance.now()); + } + + // Only one refresh should have occurred + expect(refreshCalls.length).toBe(1); + }); + + it('should cancel pending rAF on cleanup', () => { + const cancelRaf = vi.fn(); + vi.stubGlobal('cancelAnimationFrame', cancelRaf); + + let rafId: number | null = requestAnimationFrame(() => {}); + + // Cleanup + if (rafId !== null) { + cancelAnimationFrame(rafId); + rafId = null; + } + + expect(cancelRaf).toHaveBeenCalled(); + }); +}); + +// ============================================================================= +// Lifecycle Tests +// ============================================================================= + +describe('property-panel: observer lifecycle', () => { + it('should disconnect old observer before connecting new one', () => { + const disconnectCalls: string[] = []; + + class TrackedObserver { + id: string; + constructor(id: string) { + this.id = id; + } + observe = vi.fn(); + disconnect = vi.fn(() => { + disconnectCalls.push(this.id); + }); + } + + // Simulate target change + const observer1 = new TrackedObserver('observer1'); + const observer2 = new TrackedObserver('observer2'); + + // First target + const target1 = document.createElement('div'); + observer1.observe(target1, { attributes: true }); + + // Change target - should disconnect old observer first + observer1.disconnect(); + observer2.observe(document.createElement('div'), { attributes: true }); + + expect(disconnectCalls).toContain('observer1'); + }); + + it('should handle null target gracefully', () => { + // When target is null, should disconnect and not create new observer + const observer = new MockMutationObserver(() => {}); + + // Simulate setTarget(null) + observer.disconnect(); + + expect(observer.disconnect).toHaveBeenCalled(); + }); + + it('should handle disconnected target gracefully', () => { + const callback = vi.fn(); + const observer = new MockMutationObserver(callback); + + const target = document.createElement('div'); + // Target not connected to DOM + expect(target.isConnected).toBe(false); + + // Should still be able to observe (MutationObserver allows this) + observer.observe(target, { attributes: true }); + + // Callback should check isConnected before processing + if (mockObserverCallback) { + // Simulate mutation on disconnected element + mockObserverCallback([], observer as unknown as MutationObserver); + } + + // In real implementation, the callback should guard against disconnected elements + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/selection-engine.test.ts b/app/chrome-extension/tests/web-editor-v2/selection-engine.test.ts new file mode 100644 index 00000000..0a56defc --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/selection-engine.test.ts @@ -0,0 +1,489 @@ +/** + * Unit tests for Web Editor V2 Selection Engine. + * + * These tests focus on deterministic scoring and selection behavior. + * jsdom has no real layout engine, so we mock: + * - document.elementsFromPoint / document.elementFromPoint + * - element.getBoundingClientRect() + * - window.getComputedStyle() + */ + +import { afterEach, beforeEach, describe, expect, it } from 'vitest'; + +import { + createSelectionEngine, + type Modifiers, + type SelectionCandidate, + type SelectionEngine, +} from '@/entrypoints/web-editor-v2/selection/selection-engine'; + +import type { RestoreFn, StyleOverrides } from './test-utils/dom'; +import { + createMockEvent, + installDomMocks, + mockBoundingClientRect, + mockViewport, +} from './test-utils/dom'; + +// ============================================================================= +// Test Utilities +// ============================================================================= + +const NO_MODIFIERS: Modifiers = { alt: false, shift: false, ctrl: false, meta: false }; + +/** + * Check if an element is part of the editor overlay. + * In tests, elements with data-overlay="true" are considered overlay elements. + */ +function isOverlayElement(node: unknown): boolean { + return node instanceof Element && node.getAttribute('data-overlay') === 'true'; +} + +/** + * Find a candidate by element in the candidates array. + */ +function getCandidate( + candidates: SelectionCandidate[], + element: Element, +): SelectionCandidate | undefined { + return candidates.find((c) => c.element === element); +} + +/** + * Check if any of the candidate's reasons contain a specific substring. + */ +function hasReason(candidate: SelectionCandidate | undefined, substring: string): boolean { + return candidate?.reasons.some((r) => r.includes(substring)) ?? false; +} + +// ============================================================================= +// Test Setup +// ============================================================================= + +let restores: RestoreFn[] = []; +let engine: SelectionEngine | null = null; + +beforeEach(() => { + restores = []; + document.body.innerHTML = ''; +}); + +afterEach(() => { + engine?.dispose(); + engine = null; + for (let i = restores.length - 1; i >= 0; i--) { + restores[i]!(); + } + restores = []; +}); + +// ============================================================================= +// getCandidatesAtPoint Tests +// ============================================================================= + +describe('selection-engine: getCandidatesAtPoint', () => { + it('returns empty array when no elements are hit', () => { + restores.push( + installDomMocks({ + elementsFromPoint: () => [], + getComputedStyle: () => ({}), + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + expect(engine.getCandidatesAtPoint(10, 10)).toEqual([]); + }); + + it('skips overlay elements from hit testing', () => { + const overlay = document.createElement('div'); + overlay.setAttribute('data-overlay', 'true'); + + const button = document.createElement('button'); + button.tabIndex = 0; + + document.body.append(overlay, button); + + restores.push(mockBoundingClientRect(overlay, { left: 0, top: 0, width: 200, height: 200 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + + const styleByEl = new Map([[button, { cursor: 'pointer' }]]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [overlay, button], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(12, 12); + + // Overlay should be excluded + expect(candidates.some((c) => c.element === overlay)).toBe(false); + // Button should be selected + expect(candidates.some((c) => c.element === button)).toBe(true); + }); + + it('scores interactive button element highly', () => { + const wrapper = document.createElement('div'); + const button = document.createElement('button'); + button.tabIndex = 0; + wrapper.append(button); + document.body.append(wrapper); + + restores.push(mockBoundingClientRect(wrapper, { left: 0, top: 0, width: 200, height: 120 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + + const styleByEl = new Map([[button, { cursor: 'pointer' }]]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [button, wrapper], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(12, 12); + + // Button should have higher score due to interactive tag + const buttonCandidate = getCandidate(candidates, button); + expect(buttonCandidate).toBeDefined(); + expect(hasReason(buttonCandidate, 'button') || hasReason(buttonCandidate, 'type')).toBe(true); + }); + + it('prefers elements with visual boundaries', () => { + const plain = document.createElement('div'); + const bordered = document.createElement('div'); + document.body.append(plain, bordered); + + restores.push(mockBoundingClientRect(plain, { left: 0, top: 0, width: 100, height: 100 })); + restores.push(mockBoundingClientRect(bordered, { left: 0, top: 0, width: 100, height: 100 })); + + const styleByEl = new Map([ + [ + bordered, + { + borderTopWidth: '1px', + borderRightWidth: '1px', + borderBottomWidth: '1px', + borderLeftWidth: '1px', + borderTopStyle: 'solid', + borderRightStyle: 'solid', + borderBottomStyle: 'solid', + borderLeftStyle: 'solid', + }, + ], + ]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [plain, bordered], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(10, 10); + + const borderedCandidate = getCandidate(candidates, bordered); + expect(borderedCandidate).toBeDefined(); + expect(hasReason(borderedCandidate, 'border')).toBe(true); + }); + + it('penalizes tiny elements', () => { + const tiny = document.createElement('div'); + const normal = document.createElement('div'); + document.body.append(tiny, normal); + + restores.push(mockBoundingClientRect(tiny, { left: 0, top: 0, width: 2, height: 2 })); + restores.push(mockBoundingClientRect(normal, { left: 0, top: 0, width: 100, height: 100 })); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [tiny, normal], + getComputedStyle: () => ({}), + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(1, 1); + + const tinyCandidate = getCandidate(candidates, tiny); + const normalCandidate = getCandidate(candidates, normal); + + expect(tinyCandidate).toBeDefined(); + expect(normalCandidate).toBeDefined(); + // Tiny element should have lower score + expect((tinyCandidate?.score ?? 0) < (normalCandidate?.score ?? 0)).toBe(true); + }); + + it('penalizes very large elements (viewport-sized)', () => { + const huge = document.createElement('div'); + const normal = document.createElement('div'); + document.body.append(huge, normal); + + // Mock viewport as 800x600 + restores.push(mockViewport(800, 600)); + // Huge element takes 90% of viewport + restores.push(mockBoundingClientRect(huge, { left: 0, top: 0, width: 720, height: 540 })); + restores.push(mockBoundingClientRect(normal, { left: 10, top: 10, width: 100, height: 100 })); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [normal, huge], + getComputedStyle: () => ({}), + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(50, 50); + + const hugeCandidate = getCandidate(candidates, huge); + const normalCandidate = getCandidate(candidates, normal); + expect(hugeCandidate).toBeDefined(); + expect(normalCandidate).toBeDefined(); + // Large element should have lower score due to size penalty + expect((hugeCandidate?.score ?? 0) < (normalCandidate?.score ?? 0)).toBe(true); + }); + + it('excludes invisible elements', () => { + const hidden = document.createElement('div'); + const visible = document.createElement('div'); + document.body.append(hidden, visible); + + restores.push(mockBoundingClientRect(hidden, { left: 0, top: 0, width: 100, height: 100 })); + restores.push(mockBoundingClientRect(visible, { left: 0, top: 0, width: 100, height: 100 })); + + const styleByEl = new Map([ + [hidden, { display: 'none' }], + [visible, { display: 'block' }], + ]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [hidden, visible], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const candidates = engine.getCandidatesAtPoint(50, 50); + + // Hidden element should be excluded + expect(candidates.some((c) => c.element === hidden)).toBe(false); + expect(candidates.some((c) => c.element === visible)).toBe(true); + }); +}); + +// ============================================================================= +// findBestTarget Tests +// ============================================================================= + +describe('selection-engine: findBestTarget', () => { + it('returns null when no elements are hit', () => { + restores.push( + installDomMocks({ + elementsFromPoint: () => [], + getComputedStyle: () => ({}), + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + expect(engine.findBestTarget(10, 10, NO_MODIFIERS)).toBeNull(); + }); + + it('returns the best scored element', () => { + const button = document.createElement('button'); + button.tabIndex = 0; + document.body.append(button); + + restores.push(mockBoundingClientRect(button, { left: 0, top: 0, width: 120, height: 48 })); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [button], + getComputedStyle: () => ({}), + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + expect(engine.findBestTarget(10, 10, NO_MODIFIERS)).toBe(button); + }); + + it('Alt modifier drills up to parent element', () => { + const panel = document.createElement('section'); + panel.id = 'panel'; + + const wrapper = document.createElement('div'); + const button = document.createElement('button'); + button.tabIndex = 0; + + wrapper.append(button); + panel.append(wrapper); + document.body.append(panel); + + restores.push(mockBoundingClientRect(panel, { left: 0, top: 0, width: 400, height: 300 })); + restores.push(mockBoundingClientRect(wrapper, { left: 0, top: 0, width: 240, height: 160 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + + const styleByEl = new Map([ + [panel, { paddingTop: '8px', paddingLeft: '8px' }], + [button, { cursor: 'pointer' }], + ]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [button, wrapper, panel], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const target = engine.findBestTarget(12, 12, { ...NO_MODIFIERS, alt: true }); + + // Should drill up past wrapper to panel (which has visual boundary via padding) + expect(target).toBe(panel); + }); +}); + +// ============================================================================= +// findBestTargetFromEvent Tests +// ============================================================================= + +describe('selection-engine: findBestTargetFromEvent', () => { + it('Ctrl/Cmd selects the innermost visible element from composedPath', () => { + const wrapper = document.createElement('div'); + const button = document.createElement('button'); + button.tabIndex = 0; + const inner = document.createElement('span'); + inner.textContent = 'Inner'; + + button.append(inner); + wrapper.append(button); + document.body.append(wrapper); + + restores.push(mockBoundingClientRect(wrapper, { left: 0, top: 0, width: 240, height: 160 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + restores.push(mockBoundingClientRect(inner, { left: 14, top: 14, width: 50, height: 20 })); + + const styleByEl = new Map([[button, { cursor: 'pointer' }]]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [inner, button, wrapper], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + + const event = createMockEvent({ + clientX: 16, + clientY: 16, + path: [inner, button, wrapper, document.body, document], + }); + + const target = engine.findBestTargetFromEvent(event, { ...NO_MODIFIERS, ctrl: true }); + // Ctrl should select innermost visible element + expect(target).toBe(inner); + }); + + it('Alt in event-based selection drills up from best target', () => { + const panel = document.createElement('section'); + panel.id = 'panel'; + + const wrapper = document.createElement('div'); + const button = document.createElement('button'); + button.tabIndex = 0; + + wrapper.append(button); + panel.append(wrapper); + document.body.append(panel); + + restores.push(mockBoundingClientRect(panel, { left: 0, top: 0, width: 400, height: 300 })); + restores.push(mockBoundingClientRect(wrapper, { left: 0, top: 0, width: 240, height: 160 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + + const styleByEl = new Map([ + [panel, { paddingTop: '8px', paddingLeft: '8px' }], + [button, { cursor: 'pointer' }], + ]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [button, wrapper, panel], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + + const event = createMockEvent({ + clientX: 12, + clientY: 12, + path: [button, wrapper, panel, document.body, document], + }); + + const target = engine.findBestTargetFromEvent(event, { ...NO_MODIFIERS, alt: true }); + expect(target).toBe(panel); + }); +}); + +// ============================================================================= +// getParentCandidate Tests +// ============================================================================= + +describe('selection-engine: getParentCandidate', () => { + it('returns null for body element', () => { + engine = createSelectionEngine({ isOverlayElement }); + expect(engine.getParentCandidate(document.body)).toBeNull(); + }); + + it('returns first non-wrapper ancestor', () => { + const section = document.createElement('section'); + section.id = 'section'; + const wrapper = document.createElement('div'); + const button = document.createElement('button'); + + wrapper.append(button); + section.append(wrapper); + document.body.append(section); + + restores.push(mockBoundingClientRect(section, { left: 0, top: 0, width: 400, height: 300 })); + restores.push(mockBoundingClientRect(wrapper, { left: 0, top: 0, width: 240, height: 160 })); + restores.push(mockBoundingClientRect(button, { left: 10, top: 10, width: 120, height: 48 })); + + // Section has visual boundary + const styleByEl = new Map([ + [section, { paddingTop: '8px', paddingLeft: '8px' }], + ]); + + restores.push( + installDomMocks({ + elementsFromPoint: () => [], + getComputedStyle: (el) => styleByEl.get(el) ?? {}, + }), + ); + + engine = createSelectionEngine({ isOverlayElement }); + const parent = engine.getParentCandidate(button); + + // Should skip wrapper and return section + expect(parent).toBe(section); + }); +}); + +// ============================================================================= +// dispose Tests +// ============================================================================= + +describe('selection-engine: dispose', () => { + it('can be called multiple times safely', () => { + engine = createSelectionEngine({ isOverlayElement }); + expect(() => { + engine!.dispose(); + engine!.dispose(); + }).not.toThrow(); + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/snap-engine.test.ts b/app/chrome-extension/tests/web-editor-v2/snap-engine.test.ts new file mode 100644 index 00000000..c3c57cae --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/snap-engine.test.ts @@ -0,0 +1,873 @@ +/** + * Unit tests for Web Editor V2 Snap Engine + * + * Tests cover: + * - mergeAnchors: Anchor collection merging + * - computeResizeSnap: Snap computation during resize + * - computeDistanceLabels: Distance label generation + * + * All functions tested here are pure functions with no DOM dependencies, + * making them ideal for unit testing. + */ + +import { describe, expect, it } from 'vitest'; + +import { + computeDistanceLabels, + computeResizeSnap, + mergeAnchors, + type ComputeDistanceLabelsParams, + type ComputeResizeSnapParams, + type SnapAnchors, + type SnapLockX, + type SnapLockY, +} from '@/entrypoints/web-editor-v2/core/snap-engine'; +import type { ViewportRect } from '@/entrypoints/web-editor-v2/overlay/canvas-overlay'; + +// ============================================================================= +// Test Utilities +// ============================================================================= + +/** + * Creates a ViewportRect from coordinates and dimensions. + */ +function rect(left: number, top: number, width: number, height: number): ViewportRect { + return { left, top, width, height }; +} + +/** + * Default viewport dimensions for tests. + */ +const VIEWPORT = { width: 800, height: 600 }; + +/** + * Creates default params for computeResizeSnap tests. + */ +function createSnapParams(overrides: Partial): ComputeResizeSnapParams { + return { + rect: rect(100, 100, 200, 150), + resize: { hasWest: false, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { x: [], y: [] }, + thresholdPx: 6, + hysteresisPx: 2, + minSizePx: 10, + lockX: null, + lockY: null, + viewport: VIEWPORT, + ...overrides, + }; +} + +/** + * Creates default params for computeDistanceLabels tests. + */ +function createLabelParams( + overrides: Partial, +): ComputeDistanceLabelsParams { + return { + rect: rect(100, 100, 200, 150), + lockX: null, + lockY: null, + viewport: VIEWPORT, + minGapPx: 1, + ...overrides, + }; +} + +// ============================================================================= +// mergeAnchors Tests +// ============================================================================= + +describe('snap-engine: mergeAnchors', () => { + it('returns empty anchors when called with no arguments', () => { + const result = mergeAnchors(); + expect(result).toEqual({ x: [], y: [] }); + }); + + it('returns the same anchors when called with single collection', () => { + const anchors: SnapAnchors = { + x: [{ type: 'left', value: 0, source: 'viewport' }], + y: [{ type: 'top', value: 0, source: 'viewport' }], + }; + + const result = mergeAnchors(anchors); + + expect(result.x).toHaveLength(1); + expect(result.y).toHaveLength(1); + }); + + it('concatenates anchors from multiple collections in order', () => { + const collection1: SnapAnchors = { + x: [{ type: 'left', value: 0, source: 'viewport' }], + y: [{ type: 'top', value: 0, source: 'viewport' }], + }; + + const collection2: SnapAnchors = { + x: [{ type: 'center', value: 50, source: 'sibling', sourceRect: rect(40, 0, 20, 20) }], + y: [], + }; + + const collection3: SnapAnchors = { + x: [{ type: 'right', value: 100, source: 'sibling', sourceRect: rect(80, 0, 20, 20) }], + y: [{ type: 'bottom', value: 100, source: 'viewport' }], + }; + + const result = mergeAnchors(collection1, collection2, collection3); + + expect(result.x).toHaveLength(3); + expect(result.y).toHaveLength(2); + + // Verify order is preserved + expect(result.x[0]).toMatchObject({ type: 'left', value: 0 }); + expect(result.x[1]).toMatchObject({ type: 'center', value: 50 }); + expect(result.x[2]).toMatchObject({ type: 'right', value: 100 }); + }); + + it('handles empty collections gracefully', () => { + const empty: SnapAnchors = { x: [], y: [] }; + const nonEmpty: SnapAnchors = { + x: [{ type: 'left', value: 10, source: 'viewport' }], + y: [], + }; + + const result = mergeAnchors(empty, nonEmpty, empty); + + expect(result.x).toHaveLength(1); + expect(result.y).toHaveLength(0); + }); +}); + +// ============================================================================= +// computeResizeSnap Tests +// ============================================================================= + +describe('snap-engine: computeResizeSnap', () => { + describe('basic snapping', () => { + it('snaps west edge within threshold and emits vertical guide line', () => { + const params = createSnapParams({ + rect: rect(103, 100, 197, 150), // left edge at 103 + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 100, source: 'viewport' }], // anchor at 100 + y: [], + }, + }); + + const result = computeResizeSnap(params); + + // Should snap left edge from 103 to 100 (distance 3 < threshold 6) + expect(result.snappedRect.left).toBe(100); + expect(result.snappedRect.width).toBe(200); // width adjusted + expect(result.lockX).toMatchObject({ type: 'left', value: 100, source: 'viewport' }); + expect(result.lockY).toBeNull(); + expect(result.guideLines).toHaveLength(1); + expect(result.guideLines[0]).toEqual({ x1: 100, y1: 0, x2: 100, y2: VIEWPORT.height }); + }); + + it('snaps east edge within threshold', () => { + const params = createSnapParams({ + rect: rect(100, 100, 197, 150), // right edge at 297 + resize: { hasWest: false, hasEast: true, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'right', value: 300, source: 'viewport' }], // anchor at 300 + y: [], + }, + }); + + const result = computeResizeSnap(params); + + // Should snap right edge from 297 to 300 + expect(result.snappedRect.left).toBe(100); // left unchanged + expect(result.snappedRect.width).toBe(200); + expect(result.lockX).toMatchObject({ type: 'right', value: 300 }); + }); + + it('snaps north edge within threshold and emits horizontal guide line', () => { + const params = createSnapParams({ + rect: rect(100, 104, 200, 146), // top edge at 104 + resize: { hasWest: false, hasEast: false, hasNorth: true, hasSouth: false }, + anchors: { + x: [], + y: [{ type: 'top', value: 100, source: 'viewport' }], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect.top).toBe(100); + expect(result.snappedRect.height).toBe(150); + expect(result.lockY).toMatchObject({ type: 'top', value: 100 }); + expect(result.guideLines).toHaveLength(1); + expect(result.guideLines[0]).toEqual({ x1: 0, y1: 100, x2: VIEWPORT.width, y2: 100 }); + }); + + it('snaps south edge within threshold', () => { + const params = createSnapParams({ + rect: rect(100, 100, 200, 147), // bottom edge at 247 + resize: { hasWest: false, hasEast: false, hasNorth: false, hasSouth: true }, + anchors: { + x: [], + y: [{ type: 'bottom', value: 250, source: 'viewport' }], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect.top).toBe(100); + expect(result.snappedRect.height).toBe(150); + expect(result.lockY).toMatchObject({ type: 'bottom', value: 250 }); + }); + }); + + describe('threshold behavior', () => { + it('does not snap when distance exceeds threshold', () => { + const params = createSnapParams({ + rect: rect(100, 100, 200, 150), + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 90, source: 'viewport' }], // distance 10 > threshold 6 + y: [], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect).toEqual(params.rect); + expect(result.lockX).toBeNull(); + expect(result.guideLines).toEqual([]); + }); + + it('snaps at exactly the threshold distance', () => { + const params = createSnapParams({ + rect: rect(106, 100, 194, 150), + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 100, source: 'viewport' }], // distance exactly 6 + y: [], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect.left).toBe(100); + expect(result.lockX).not.toBeNull(); + }); + }); + + describe('anchor priority', () => { + it('prefers sibling anchors over viewport anchors at equal distance', () => { + // Both anchors at same value (100), same type (left), same distance from rect.left (103) + // When hasWest: true, we're moving the left edge, so 'left' type anchors are allowed + const siblingRect = rect(50, 0, 50, 50); + const params = createSnapParams({ + rect: rect(103, 100, 197, 150), // left edge at 103 + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [ + { type: 'left', value: 100, source: 'viewport' }, // distance 3, left type + { type: 'left', value: 100, source: 'sibling', sourceRect: siblingRect }, // distance 3, left type + ], + y: [], + }, + }); + + const result = computeResizeSnap(params); + + // Sibling should be preferred over viewport at equal distance + expect(result.lockX?.source).toBe('sibling'); + expect(result.snappedRect.left).toBe(100); + }); + + it('chooses closest anchor regardless of source when distances differ', () => { + // Both anchors have 'left' type (allowed for hasWest resize), but different distances + const siblingRect = rect(50, 0, 50, 50); + const params = createSnapParams({ + rect: rect(103, 100, 197, 150), // left edge at 103 + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [ + { type: 'left', value: 102, source: 'viewport' }, // distance 1, left type + { type: 'left', value: 100, source: 'sibling', sourceRect: siblingRect }, // distance 3, left type + ], + y: [], + }, + }); + + const result = computeResizeSnap(params); + + // Closer anchor (viewport at 102) should be chosen despite sibling having priority at equal distance + expect(result.lockX?.source).toBe('viewport'); + expect(result.snappedRect.left).toBe(102); + }); + }); + + describe('hysteresis (lock stability)', () => { + it('maintains existing lock within threshold + hysteresis', () => { + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'viewport', + sourceRect: null, + }; + + const params = createSnapParams({ + rect: rect(107, 100, 193, 150), // distance 7 from lock (threshold 6 + hysteresis 2 = 8) + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { x: [], y: [] }, + lockX, + }); + + const result = computeResizeSnap(params); + + expect(result.lockX).toMatchObject({ type: 'left', value: 100 }); + expect(result.snappedRect.left).toBe(100); // still snapped + }); + + it('releases lock when distance exceeds threshold + hysteresis', () => { + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'viewport', + sourceRect: null, + }; + + const params = createSnapParams({ + rect: rect(109, 100, 191, 150), // distance 9 > threshold 6 + hysteresis 2 + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { x: [], y: [] }, + lockX, + }); + + const result = computeResizeSnap(params); + + expect(result.lockX).toBeNull(); + expect(result.snappedRect.left).toBe(109); // no snap + }); + }); + + describe('minimum size constraint', () => { + it('rejects snap that would violate minimum width', () => { + const params = createSnapParams({ + rect: rect(100, 100, 20, 150), + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 115, source: 'viewport' }], // would make width = 5 + y: [], + }, + minSizePx: 10, + thresholdPx: 20, // large threshold to ensure snap would trigger + }); + + const result = computeResizeSnap(params); + + expect(result.lockX).toBeNull(); + expect(result.snappedRect).toEqual(params.rect); + }); + + it('rejects snap that would violate minimum height', () => { + const params = createSnapParams({ + rect: rect(100, 100, 200, 15), + resize: { hasWest: false, hasEast: false, hasNorth: true, hasSouth: false }, + anchors: { + x: [], + y: [{ type: 'top', value: 110, source: 'viewport' }], // would make height = 5 + }, + minSizePx: 10, + thresholdPx: 20, + }); + + const result = computeResizeSnap(params); + + expect(result.lockY).toBeNull(); + }); + }); + + describe('invalid rect handling', () => { + it('returns unchanged rect and clears locks for zero-width rect', () => { + const lockX: SnapLockX = { type: 'left', value: 0, source: 'viewport', sourceRect: null }; + const params = createSnapParams({ + rect: rect(0, 0, 0, 100), + lockX, + lockY: null, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect).toEqual(params.rect); + expect(result.lockX).toBeNull(); + expect(result.lockY).toBeNull(); + expect(result.guideLines).toEqual([]); + }); + + it('returns unchanged rect for zero-height rect', () => { + const params = createSnapParams({ + rect: rect(0, 0, 100, 0), + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect).toEqual(params.rect); + }); + }); + + describe('multi-direction resize', () => { + it('snaps both X and Y axes simultaneously', () => { + const params = createSnapParams({ + rect: rect(103, 97, 197, 153), + resize: { hasWest: true, hasEast: false, hasNorth: true, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 100, source: 'viewport' }], + y: [{ type: 'top', value: 100, source: 'viewport' }], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.snappedRect.left).toBe(100); + expect(result.snappedRect.top).toBe(100); + expect(result.lockX).not.toBeNull(); + expect(result.lockY).not.toBeNull(); + expect(result.guideLines).toHaveLength(2); + }); + }); + + describe('center/middle anchor snapping', () => { + it('snaps to center anchor when resizing from west (left is fixed)', () => { + // When hasEast: true, fixedEdgeX = 'left', allowedTypes = ['right', 'center'] + const params = createSnapParams({ + rect: rect(100, 100, 198, 150), // center at 199, right at 298 + resize: { hasWest: false, hasEast: true, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'center', value: 200, source: 'viewport' }], // distance 1 + y: [], + }, + }); + + const result = computeResizeSnap(params); + + // Center snapped to 200, so width = (200 - 100) * 2 = 200 + expect(result.snappedRect.left).toBe(100); // left unchanged + expect(result.snappedRect.width).toBe(200); + expect(result.lockX).toMatchObject({ type: 'center', value: 200 }); + }); + + it('snaps to middle anchor when resizing from south', () => { + // When hasSouth: true, fixedEdgeY = 'top', allowedTypes = ['bottom', 'middle'] + const params = createSnapParams({ + rect: rect(100, 100, 200, 148), // middle at 174, bottom at 248 + resize: { hasWest: false, hasEast: false, hasNorth: false, hasSouth: true }, + anchors: { + x: [], + y: [{ type: 'middle', value: 175, source: 'viewport' }], // distance 1 + }, + }); + + const result = computeResizeSnap(params); + + // Middle snapped to 175, so height = (175 - 100) * 2 = 150 + expect(result.snappedRect.top).toBe(100); + expect(result.snappedRect.height).toBe(150); + expect(result.lockY).toMatchObject({ type: 'middle', value: 175 }); + }); + }); + + describe('lock invalidation', () => { + it('clears lock when its type is not allowed for current resize direction', () => { + // Lock was on 'right' but now we're resizing from east (which allows right/center) + // When hasWest: true, only 'left' and 'center' are allowed + const lockX: SnapLockX = { + type: 'right', + value: 300, + source: 'viewport', + sourceRect: null, + }; + + const params = createSnapParams({ + rect: rect(100, 100, 200, 150), + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { x: [], y: [] }, + lockX, + }); + + const result = computeResizeSnap(params); + + // Lock should be cleared because 'right' is not in allowed types for west resize + expect(result.lockX).toBeNull(); + }); + + it('clears lock when axis is not being resized', () => { + // X-axis lock but no X resize is happening + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'viewport', + sourceRect: null, + }; + + const params = createSnapParams({ + rect: rect(100, 100, 200, 150), + resize: { hasWest: false, hasEast: false, hasNorth: true, hasSouth: false }, // only Y resize + anchors: { x: [], y: [] }, + lockX, + }); + + const result = computeResizeSnap(params); + + expect(result.lockX).toBeNull(); + }); + }); + + describe('sibling guide line extent', () => { + it('generates guide line spanning from source to target element for sibling snap', () => { + const siblingRect = rect(50, 20, 50, 60); // right edge at 100, bottom at 80 + const params = createSnapParams({ + rect: rect(103, 100, 197, 150), // top at 100, bottom at 250 + resize: { hasWest: true, hasEast: false, hasNorth: false, hasSouth: false }, + anchors: { + x: [{ type: 'left', value: 100, source: 'sibling', sourceRect: siblingRect }], + y: [], + }, + }); + + const result = computeResizeSnap(params); + + expect(result.guideLines).toHaveLength(1); + // Guide line should span from sibling's vertical extent to target's vertical extent + // min(sibling.top, target.top) to max(sibling.bottom, target.bottom) + expect(result.guideLines[0]).toEqual({ + x1: 100, + y1: Math.min(siblingRect.top, 100), // 20 + x2: 100, + y2: Math.max(80, 250), // 250 + }); + }); + }); +}); + +// ============================================================================= +// computeDistanceLabels Tests +// ============================================================================= + +describe('snap-engine: computeDistanceLabels', () => { + describe('sibling gap labels', () => { + it('computes vertical gap from X-axis sibling lock', () => { + const sourceRect = rect(100, 30, 50, 50); // bottom at 80 + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 200, 150), // top at 100, gap = 20 + lockX, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toHaveLength(1); + expect(labels[0]).toMatchObject({ + kind: 'sibling', + axis: 'y', + value: 20, + text: '20px', + }); + expect(labels[0]?.line).toEqual({ x1: 100, y1: 80, x2: 100, y2: 100 }); + }); + + it('computes horizontal gap from Y-axis sibling lock', () => { + const sourceRect = rect(30, 100, 50, 50); // right at 80 + const lockY: SnapLockY = { + type: 'top', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 200, 150), // left at 100, gap = 20 + lockY, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toHaveLength(1); + expect(labels[0]).toMatchObject({ + kind: 'sibling', + axis: 'x', + value: 20, + text: '20px', + }); + expect(labels[0]?.line).toEqual({ x1: 80, y1: 100, x2: 100, y2: 100 }); + }); + + it('hides labels for gaps below minGapPx', () => { + const sourceRect = rect(100, 99.5, 50, 0.3); // bottom at 99.8 + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 200, 150), // gap = 0.2 + lockX, + minGapPx: 1, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toEqual([]); + }); + + it('hides labels for zero gap (touching elements)', () => { + const sourceRect = rect(100, 50, 50, 50); // bottom at 100 + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 200, 150), // top at 100, gap = 0 + lockX, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toEqual([]); + }); + + it('computes vertical gap when target is above source (reverse direction)', () => { + const sourceRect = rect(100, 150, 50, 50); // top at 150 + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 50, 200, 80), // bottom at 130, gap = 20 + lockX, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toHaveLength(1); + expect(labels[0]).toMatchObject({ + kind: 'sibling', + axis: 'y', + value: 20, + text: '20px', + }); + }); + + it('computes horizontal gap when target is left of source (reverse direction)', () => { + const sourceRect = rect(250, 100, 50, 50); // left at 250 + const lockY: SnapLockY = { + type: 'top', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 100, 150), // right at 200, gap = 50 + lockY, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toHaveLength(1); + expect(labels[0]).toMatchObject({ + kind: 'sibling', + axis: 'x', + value: 50, + text: '50px', + }); + }); + + it('hides labels for overlapping elements (negative gap)', () => { + const sourceRect = rect(100, 80, 50, 50); // bottom at 130 + const lockX: SnapLockX = { + type: 'left', + value: 100, + source: 'sibling', + sourceRect, + }; + + const params = createLabelParams({ + rect: rect(100, 100, 200, 150), // top at 100, overlaps with source + lockX, + }); + + const labels = computeDistanceLabels(params); + + // Negative gap (overlap) should not produce labels + expect(labels).toEqual([]); + }); + }); + + describe('viewport margin labels', () => { + it('shows viewport margin for X-axis viewport lock (left align)', () => { + const lockX: SnapLockX = { + type: 'left', + value: 50, + source: 'viewport', + sourceRect: null, + }; + + const params = createLabelParams({ + rect: rect(50, 100, 200, 150), // left=50, right=250, center at y=175 + lockX, + viewport: { width: 800, height: 600 }, + }); + + const labels = computeDistanceLabels(params); + + expect(labels.length).toBeGreaterThanOrEqual(1); + const viewportLabel = labels.find((l) => l.kind === 'viewport'); + expect(viewportLabel).toBeDefined(); + expect(viewportLabel).toMatchObject({ + kind: 'viewport', + axis: 'x', + value: 50, // left margin + text: '50px', + }); + // Line should be horizontal from left edge of viewport to left edge of rect + expect(viewportLabel?.line).toEqual({ x1: 0, y1: 175, x2: 50, y2: 175 }); + }); + + it('shows opposite margin when aligned margin is 0', () => { + const lockX: SnapLockX = { + type: 'left', + value: 0, + source: 'viewport', + sourceRect: null, + }; + + const params = createLabelParams({ + rect: rect(0, 100, 200, 150), // left margin = 0, right margin = 600 + lockX, + viewport: { width: 800, height: 600 }, + }); + + const labels = computeDistanceLabels(params); + + const viewportLabel = labels.find((l) => l.kind === 'viewport'); + expect(viewportLabel).toBeDefined(); + // Should show the right margin since left is 0 + expect(viewportLabel?.value).toBe(600); + }); + + it('shows viewport margin for Y-axis viewport lock (top align)', () => { + const lockY: SnapLockY = { + type: 'top', + value: 50, + source: 'viewport', + sourceRect: null, + }; + + const params = createLabelParams({ + rect: rect(100, 50, 200, 150), // top=50, bottom=200, center at x=200 + lockY, + viewport: { width: 800, height: 600 }, + }); + + const labels = computeDistanceLabels(params); + + expect(labels.length).toBeGreaterThanOrEqual(1); + const viewportLabel = labels.find((l) => l.kind === 'viewport'); + expect(viewportLabel).toBeDefined(); + expect(viewportLabel).toMatchObject({ + kind: 'viewport', + axis: 'y', + value: 50, // top margin + text: '50px', + }); + }); + + it('shows both margins for center lock (X-axis)', () => { + const lockX: SnapLockX = { + type: 'center', + value: 400, // viewport center + source: 'viewport', + sourceRect: null, + }; + + const params = createLabelParams({ + rect: rect(300, 100, 200, 150), // left=300, right=500, center=400 + lockX, + viewport: { width: 800, height: 600 }, + }); + + const labels = computeDistanceLabels(params); + + // Center lock should produce 2 viewport labels (left and right margins) + const viewportLabels = labels.filter((l) => l.kind === 'viewport'); + expect(viewportLabels).toHaveLength(2); + expect(viewportLabels.map((l) => l.value).sort()).toEqual([300, 300]); + }); + + it('shows both margins for middle lock (Y-axis)', () => { + const lockY: SnapLockY = { + type: 'middle', + value: 300, // viewport middle + source: 'viewport', + sourceRect: null, + }; + + const params = createLabelParams({ + rect: rect(100, 225, 200, 150), // top=225, bottom=375, middle=300 + lockY, + viewport: { width: 800, height: 600 }, + }); + + const labels = computeDistanceLabels(params); + + // Middle lock should produce 2 viewport labels (top and bottom margins) + const viewportLabels = labels.filter((l) => l.kind === 'viewport'); + expect(viewportLabels).toHaveLength(2); + expect(viewportLabels.map((l) => l.value).sort()).toEqual([225, 225]); + }); + }); + + describe('invalid rect handling', () => { + it('returns empty labels for zero-width rect', () => { + const params = createLabelParams({ + rect: rect(0, 0, 0, 100), + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toEqual([]); + }); + + it('returns empty labels for zero-height rect', () => { + const params = createLabelParams({ + rect: rect(0, 0, 100, 0), + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toEqual([]); + }); + }); + + describe('no lock state', () => { + it('returns empty labels when no locks are active', () => { + const params = createLabelParams({ + lockX: null, + lockY: null, + }); + + const labels = computeDistanceLabels(params); + + expect(labels).toEqual([]); + }); + }); +}); diff --git a/app/chrome-extension/tests/web-editor-v2/test-utils/dom.ts b/app/chrome-extension/tests/web-editor-v2/test-utils/dom.ts new file mode 100644 index 00000000..15d3ccb0 --- /dev/null +++ b/app/chrome-extension/tests/web-editor-v2/test-utils/dom.ts @@ -0,0 +1,325 @@ +/** + * DOM Mocking Utilities for Web Editor V2 Unit Tests + * + * These helpers patch DOM APIs that are missing or non-deterministic in jsdom + * (e.g. elementsFromPoint, layout-dependent getBoundingClientRect). + * + * Usage: + * const restore = mockElementsFromPoint((x, y) => [element1, element2]); + * // run test + * restore(); + * + * Or use installDomMocks() for batch installation with automatic cleanup. + */ + +// ============================================================================= +// Types +// ============================================================================= + +/** Function to restore original state */ +export type RestoreFn = () => void; + +/** Initialization data for a DOMRect */ +export interface RectInit { + left: number; + top: number; + width: number; + height: number; +} + +/** Handler for elementsFromPoint mock */ +export type ElementsFromPointHandler = (x: number, y: number) => Element[]; + +/** CSS property overrides for computed style mock */ +export type StyleOverrides = Record; + +/** Handler for getComputedStyle mock */ +export type ComputedStyleHandler = (element: Element) => StyleOverrides | CSSStyleDeclaration; + +/** Options for creating a mock event with composedPath */ +export interface MockEventOptions { + clientX?: number; + clientY?: number; + path: EventTarget[]; +} + +/** Batch mock configuration */ +export interface DomMocks { + elementsFromPoint?: ElementsFromPointHandler; + getComputedStyle?: ComputedStyleHandler; +} + +// ============================================================================= +// Default Style Values +// ============================================================================= + +/** + * Default computed style values that match browser defaults. + * These cover properties commonly accessed by SelectionEngine and PositionTracker. + */ +const DEFAULT_STYLE: Record = { + // Display & visibility + display: 'block', + visibility: 'visible', + opacity: '1', + contentVisibility: 'visible', + + // Background + backgroundColor: 'transparent', + backgroundImage: 'none', + + // Border + borderTopWidth: '0px', + borderRightWidth: '0px', + borderBottomWidth: '0px', + borderLeftWidth: '0px', + borderTopStyle: 'none', + borderRightStyle: 'none', + borderBottomStyle: 'none', + borderLeftStyle: 'none', + + // Effects + boxShadow: 'none', + outlineStyle: 'none', + outlineWidth: '0px', + + // Spacing + paddingTop: '0px', + paddingRight: '0px', + paddingBottom: '0px', + paddingLeft: '0px', + + // Cursor & position + cursor: 'auto', + position: 'static', + + // Flex + flexDirection: 'row', +}; + +// ============================================================================= +// Internal Utilities +// ============================================================================= + +/** + * Creates a DOMRectReadOnly-like object from init data. + */ +function createRect(init: RectInit): DOMRectReadOnly { + const { left, top, width, height } = init; + const right = left + width; + const bottom = top + height; + + return { + left, + top, + width, + height, + right, + bottom, + x: left, + y: top, + toJSON() { + return { left, top, width, height, right, bottom, x: left, y: top }; + }, + } as DOMRectReadOnly; +} + +/** + * Patches a property on an object and returns a restore function. + */ +function patchProperty(target: object, key: string, value: unknown): RestoreFn { + const descriptor = Object.getOwnPropertyDescriptor(target, key); + + Object.defineProperty(target, key, { + value, + configurable: true, + writable: true, + }); + + return () => { + if (descriptor) { + Object.defineProperty(target, key, descriptor); + } else { + delete (target as Record)[key]; + } + }; +} + +// ============================================================================= +// Public API +// ============================================================================= + +/** + * Creates a CSSStyleDeclaration-like object with the given overrides. + */ +export function createComputedStyle(overrides: StyleOverrides = {}): CSSStyleDeclaration { + const values: Record = { ...DEFAULT_STYLE }; + + for (const [key, value] of Object.entries(overrides)) { + if (typeof value === 'string') { + values[key] = value; + } + } + + const style = { + ...values, + getPropertyValue(prop: string): string { + return values[prop] ?? ''; + }, + // Add commonly accessed methods to prevent errors + getPropertyPriority(): string { + return ''; + }, + length: 0, + item(): string { + return ''; + }, + }; + + return style as unknown as CSSStyleDeclaration; +} + +/** + * Patches an element's getBoundingClientRect() to return a fixed rect. + * + * @example + * const restore = mockBoundingClientRect(element, { left: 10, top: 20, width: 100, height: 50 }); + * expect(element.getBoundingClientRect().left).toBe(10); + * restore(); + */ +export function mockBoundingClientRect(element: Element, rect: RectInit): RestoreFn { + const domRect = createRect(rect); + return patchProperty(element, 'getBoundingClientRect', () => domRect); +} + +/** + * Patches document.elementsFromPoint and document.elementFromPoint. + * + * SelectionEngine prefers elementsFromPoint when available, so both must be mocked. + * + * @example + * const restore = mockElementsFromPoint((x, y) => { + * if (x < 100) return [elementA, elementB]; + * return [elementC]; + * }); + */ +export function mockElementsFromPoint(handler: ElementsFromPointHandler): RestoreFn { + const restoreElements = patchProperty(document, 'elementsFromPoint', (x: number, y: number) => + handler(x, y), + ); + + const restoreElement = patchProperty(document, 'elementFromPoint', (x: number, y: number) => { + const elements = handler(x, y); + return elements[0] ?? null; + }); + + return () => { + restoreElement(); + restoreElements(); + }; +} + +/** + * Patches window.getComputedStyle. + * + * The handler can return either StyleOverrides (merged with defaults) or a full CSSStyleDeclaration. + * + * @example + * const restore = mockGetComputedStyle((el) => ({ + * display: 'flex', + * backgroundColor: 'rgb(255, 0, 0)', + * })); + */ +export function mockGetComputedStyle(handler: ComputedStyleHandler): RestoreFn { + return patchProperty(window, 'getComputedStyle', (element: Element) => { + const result = handler(element); + + // If handler returned a full CSSStyleDeclaration, use it directly + if (result && typeof (result as CSSStyleDeclaration).getPropertyValue === 'function') { + return result as CSSStyleDeclaration; + } + + // Otherwise, merge with defaults + return createComputedStyle(result as StyleOverrides); + }); +} + +/** + * Creates a minimal Event-like object with composedPath() support. + * + * Useful for testing findBestTargetFromEvent() which relies on composedPath() + * to access Shadow DOM internals. + * + * @example + * const event = createMockEvent({ clientX: 100, clientY: 200, path: [button, div, document] }); + */ +export function createMockEvent(options: MockEventOptions): Event { + const { clientX = 0, clientY = 0, path } = options; + + return { + clientX, + clientY, + composedPath: () => path, + // Add common event properties to prevent errors + type: 'click', + target: path[0] ?? null, + currentTarget: null, + bubbles: true, + cancelable: true, + defaultPrevented: false, + eventPhase: 0, + isTrusted: false, + timeStamp: Date.now(), + preventDefault: () => {}, + stopPropagation: () => {}, + stopImmediatePropagation: () => {}, + } as unknown as Event; +} + +/** + * Installs multiple DOM mocks at once and returns a single restore function. + * + * Restores are called in reverse order to handle dependencies correctly. + * + * @example + * const restore = installDomMocks({ + * elementsFromPoint: (x, y) => [element], + * getComputedStyle: (el) => ({ display: 'block' }), + * }); + * + * // In afterEach: + * restore(); + */ +export function installDomMocks(mocks: DomMocks): RestoreFn { + const restores: RestoreFn[] = []; + + if (mocks.elementsFromPoint) { + restores.push(mockElementsFromPoint(mocks.elementsFromPoint)); + } + + if (mocks.getComputedStyle) { + restores.push(mockGetComputedStyle(mocks.getComputedStyle)); + } + + return () => { + // Restore in reverse order + for (let i = restores.length - 1; i >= 0; i--) { + restores[i]!(); + } + }; +} + +/** + * Sets up mock viewport dimensions. + * + * Useful for snap-engine tests that rely on window.innerWidth/innerHeight. + */ +export function mockViewport(width: number, height: number): RestoreFn { + const restoreWidth = patchProperty(window, 'innerWidth', width); + const restoreHeight = patchProperty(window, 'innerHeight', height); + + return () => { + restoreHeight(); + restoreWidth(); + }; +} diff --git a/app/chrome-extension/types/gifenc.d.ts b/app/chrome-extension/types/gifenc.d.ts new file mode 100644 index 00000000..7ccc56be --- /dev/null +++ b/app/chrome-extension/types/gifenc.d.ts @@ -0,0 +1,71 @@ +/** + * Type declarations for gifenc library + * @see https://github.com/mattdesl/gifenc + */ + +declare module 'gifenc' { + export interface GIFEncoderOptions { + auto?: boolean; + } + + export interface WriteFrameOptions { + palette: number[]; + delay?: number; + transparent?: boolean; + transparentIndex?: number; + dispose?: number; + } + + export interface GIFEncoder { + writeFrame( + index: Uint8Array | Uint8ClampedArray, + width: number, + height: number, + options: WriteFrameOptions, + ): void; + finish(): void; + bytes(): Uint8Array; + bytesView(): Uint8Array; + reset(): void; + } + + export function GIFEncoder(options?: GIFEncoderOptions): GIFEncoder; + + export interface QuantizeOptions { + format?: 'rgb565' | 'rgba4444' | 'rgb444'; + oneBitAlpha?: boolean | number; + clearAlpha?: boolean; + clearAlphaColor?: number; + clearAlphaThreshold?: number; + } + + export function quantize( + rgba: Uint8Array | Uint8ClampedArray, + maxColors: number, + options?: QuantizeOptions, + ): number[]; + + export function applyPalette( + rgba: Uint8Array | Uint8ClampedArray, + palette: number[], + format?: 'rgb565' | 'rgba4444' | 'rgb444', + ): Uint8Array; + + export function nearestColorIndex(palette: number[], pixel: number[]): number; + + export function nearestColorIndexWithDistance( + palette: number[], + pixel: number[], + ): [number, number]; + + export function snapColorsToPalette( + palette: number[], + knownColors: number[][], + threshold?: number, + ): void; + + export function prequantize( + rgba: Uint8Array | Uint8ClampedArray, + options?: { roundRGB?: number; roundAlpha?: number; oneBitAlpha?: boolean | number }, + ): void; +} diff --git a/app/chrome-extension/types/icons.d.ts b/app/chrome-extension/types/icons.d.ts new file mode 100644 index 00000000..4ab5c444 --- /dev/null +++ b/app/chrome-extension/types/icons.d.ts @@ -0,0 +1,8 @@ +// Type shim for unplugin-icons virtual modules used as Vue components +// Keeps TS happy in IDE and during type-check without generating code. +declare module '~icons/*' { + import type { DefineComponent } from 'vue'; + // Use explicit, non-empty object types to satisfy eslint rule + const component: DefineComponent, Record, any>; + export default component; +} diff --git a/app/chrome-extension/utils/cdp-session-manager.ts b/app/chrome-extension/utils/cdp-session-manager.ts new file mode 100644 index 00000000..8f04c233 --- /dev/null +++ b/app/chrome-extension/utils/cdp-session-manager.ts @@ -0,0 +1,109 @@ +import { TOOL_NAMES } from 'chrome-mcp-shared'; + +type OwnerTag = string; + +interface TabSessionState { + refCount: number; + owners: Set; + attachedByUs: boolean; +} + +const DEBUGGER_PROTOCOL_VERSION = '1.3'; + +class CDPSessionManager { + private sessions = new Map(); + + private getState(tabId: number): TabSessionState | undefined { + return this.sessions.get(tabId); + } + + private setState(tabId: number, state: TabSessionState) { + this.sessions.set(tabId, state); + } + + async attach(tabId: number, owner: OwnerTag = 'unknown'): Promise { + const state = this.getState(tabId); + if (state && state.attachedByUs) { + state.refCount += 1; + state.owners.add(owner); + return; + } + + // Check existing attachments + const targets = await chrome.debugger.getTargets(); + const existing = targets.find((t) => t.tabId === tabId && t.attached); + if (existing) { + if (existing.extensionId === chrome.runtime.id) { + // Already attached by us (e.g., previous tool). Adopt and refcount. + this.setState(tabId, { + refCount: state ? state.refCount + 1 : 1, + owners: new Set([...(state?.owners || []), owner]), + attachedByUs: true, + }); + return; + } + // Another client (DevTools/other extension) is attached + throw new Error( + `Debugger is already attached to tab ${tabId} by another client (e.g., DevTools/extension)`, + ); + } + + // Attach freshly + await chrome.debugger.attach({ tabId }, DEBUGGER_PROTOCOL_VERSION); + this.setState(tabId, { refCount: 1, owners: new Set([owner]), attachedByUs: true }); + } + + async detach(tabId: number, owner: OwnerTag = 'unknown'): Promise { + const state = this.getState(tabId); + if (!state) return; // Nothing to do + + // Update ownership/refcount + if (state.owners.has(owner)) state.owners.delete(owner); + state.refCount = Math.max(0, state.refCount - 1); + + if (state.refCount > 0) { + // Still in use by other owners + return; + } + + // We are the last owner + try { + if (state.attachedByUs) { + await chrome.debugger.detach({ tabId }); + } + } catch (e) { + // Best-effort detach; ignore + } finally { + this.sessions.delete(tabId); + } + } + + /** + * Convenience wrapper: ensures attach before fn, and balanced detach after. + */ + async withSession(tabId: number, owner: OwnerTag, fn: () => Promise): Promise { + await this.attach(tabId, owner); + try { + return await fn(); + } finally { + await this.detach(tabId, owner); + } + } + + /** + * Send a CDP command. Requires that this manager has attached to the tab. + * If not attached by us, will attempt a one-shot attach around the call. + */ + async sendCommand(tabId: number, method: string, params?: object): Promise { + const state = this.getState(tabId); + if (state && state.attachedByUs) { + return (await chrome.debugger.sendCommand({ tabId }, method, params)) as T; + } + // Fallback: temporary session + return await this.withSession(tabId, `send:${method}`, async () => { + return (await chrome.debugger.sendCommand({ tabId }, method, params)) as T; + }); + } +} + +export const cdpSessionManager = new CDPSessionManager(); diff --git a/app/chrome-extension/utils/indexeddb-client.ts b/app/chrome-extension/utils/indexeddb-client.ts new file mode 100644 index 00000000..caa9a4da --- /dev/null +++ b/app/chrome-extension/utils/indexeddb-client.ts @@ -0,0 +1,131 @@ +// indexeddb-client.ts +// Generic IndexedDB client with robust transaction handling and small helpers. + +export type UpgradeHandler = ( + db: IDBDatabase, + oldVersion: number, + tx: IDBTransaction | null, +) => void; + +export class IndexedDbClient { + private dbPromise: Promise | null = null; + + constructor( + private name: string, + private version: number, + private onUpgrade: UpgradeHandler, + ) {} + + async openDb(): Promise { + if (this.dbPromise) return this.dbPromise; + this.dbPromise = new Promise((resolve, reject) => { + const req = indexedDB.open(this.name, this.version); + req.onupgradeneeded = (event) => { + const db = req.result; + const oldVersion = (event as IDBVersionChangeEvent).oldVersion || 0; + const tx = req.transaction as IDBTransaction | null; + try { + this.onUpgrade(db, oldVersion, tx); + } catch (e) { + console.error('IndexedDbClient upgrade failed:', e); + } + }; + req.onsuccess = () => resolve(req.result); + req.onerror = () => + reject(new Error(`IndexedDB open failed: ${req.error?.message || req.error}`)); + }); + return this.dbPromise; + } + + async tx( + storeName: string, + mode: IDBTransactionMode, + op: (store: IDBObjectStore, txn: IDBTransaction) => T | Promise, + ): Promise { + const db = await this.openDb(); + return new Promise((resolve, reject) => { + const transaction = db.transaction(storeName, mode); + const st = transaction.objectStore(storeName); + let opResult: T | undefined; + let opError: any; + transaction.oncomplete = () => resolve(opResult as T); + transaction.onerror = () => + reject( + new Error( + `IDB transaction error on ${storeName}: ${transaction.error?.message || transaction.error}`, + ), + ); + transaction.onabort = () => + reject( + new Error( + `IDB transaction aborted on ${storeName}: ${transaction.error?.message || opError || 'unknown'}`, + ), + ); + Promise.resolve() + .then(() => op(st, transaction)) + .then((res) => { + opResult = res as T; + }) + .catch((err) => { + opError = err; + try { + transaction.abort(); + } catch {} + }); + }); + } + + async getAll(store: string): Promise { + return this.tx(store, 'readonly', (st) => + this.promisifyRequest(st.getAll(), store, 'getAll').then((res) => (res as T[]) || []), + ); + } + + async get(store: string, key: IDBValidKey): Promise { + return this.tx(store, 'readonly', (st) => + this.promisifyRequest(st.get(key), store, `get(${String(key)})`).then( + (res) => res as any, + ), + ); + } + + async put(store: string, value: T): Promise { + return this.tx(store, 'readwrite', (st) => + this.promisifyRequest(st.put(value as any), store, 'put').then(() => undefined), + ); + } + + async delete(store: string, key: IDBValidKey): Promise { + return this.tx(store, 'readwrite', (st) => + this.promisifyRequest(st.delete(key), store, `delete(${String(key)})`).then( + () => undefined, + ), + ); + } + + async clear(store: string): Promise { + return this.tx(store, 'readwrite', (st) => + this.promisifyRequest(st.clear(), store, 'clear').then(() => undefined), + ); + } + + async putMany(store: string, values: T[]): Promise { + return this.tx(store, 'readwrite', async (st) => { + for (const v of values) st.put(v as any); + return; + }); + } + + // Expose helper for advanced callers if needed + promisifyRequest(req: IDBRequest, store: string, action: string): Promise { + return new Promise((resolve, reject) => { + req.onsuccess = () => resolve(req.result as R); + req.onerror = () => + reject( + new Error( + `IDB ${action} error on ${store}: ${(req.error as any)?.message || (req.error as any)}`, + ), + ); + }); + } +} diff --git a/app/chrome-extension/utils/output-sanitizer.ts b/app/chrome-extension/utils/output-sanitizer.ts new file mode 100644 index 00000000..de50701a --- /dev/null +++ b/app/chrome-extension/utils/output-sanitizer.ts @@ -0,0 +1,354 @@ +/** + * Output Sanitizer - 输出脱敏和限长工具 + * + * 提供对 JavaScript 执行结果的安全处理： + * 1. 敏感信息脱敏（cookie/token/password 等） + * 2. 输出长度限制（默认 50KB） + * 3. 深度对象序列化 + */ + +export const DEFAULT_MAX_OUTPUT_BYTES = 50 * 1024; + +export interface OutputSanitizerOptions { + maxBytes?: number; + maxDepth?: number; + maxArrayLength?: number; + maxObjectKeys?: number; + maxStringLength?: number; +} + +export interface SanitizedOutput { + text: string; + truncated: boolean; + redacted: boolean; + originalBytes: number; +} + +const DEFAULT_MAX_DEPTH = 6; +const DEFAULT_MAX_ARRAY_LENGTH = 200; +const DEFAULT_MAX_OBJECT_KEYS = 200; +const DEFAULT_MAX_STRING_LENGTH = 10_000; + +// 敏感 key 标识符（会被脱敏） +// 参考 mcp-tools.js 的敏感 key 列表 +const SENSITIVE_KEY_MARKERS = [ + 'cookie', + 'setcookie', + 'authorization', + 'proxyauthorization', + 'bearer', + 'token', + 'accesstoken', + 'refreshtoken', + 'idtoken', + 'password', + 'passwd', + 'pwd', + 'secret', + 'clientsecret', + 'apikey', + 'session', + 'sessionid', + 'sid', + 'csrf', + 'xsrf', + // 补充 mcp-tools.js 中的敏感 key + 'credential', + 'privatekey', + 'accesskey', + 'auth', + 'oauth', +] as const; + +/** + * 对任意值进行脱敏和限长处理 + */ +export function sanitizeAndLimitOutput( + value: unknown, + options: OutputSanitizerOptions = {}, +): SanitizedOutput { + const maxBytes = normalizePositiveInt(options.maxBytes, DEFAULT_MAX_OUTPUT_BYTES); + const maxDepth = normalizePositiveInt(options.maxDepth, DEFAULT_MAX_DEPTH); + const maxArrayLength = normalizePositiveInt(options.maxArrayLength, DEFAULT_MAX_ARRAY_LENGTH); + const maxObjectKeys = normalizePositiveInt(options.maxObjectKeys, DEFAULT_MAX_OBJECT_KEYS); + const maxStringLength = normalizePositiveInt(options.maxStringLength, DEFAULT_MAX_STRING_LENGTH); + + const { value: sanitizedValue, redacted } = sanitizeValue(value, { + maxDepth, + maxArrayLength, + maxObjectKeys, + maxStringLength, + }); + + const formatted = formatValueForOutput(sanitizedValue); + const truncated = truncateTextBytes(formatted, maxBytes); + + return { + text: truncated.text, + truncated: truncated.truncated, + redacted, + originalBytes: truncated.originalBytes, + }; +} + +/** + * 对字符串进行敏感信息脱敏 + * 参考 mcp-tools.js 的脱敏逻辑，增加 Base64/Hex/cookie-query 识别 + */ +export function sanitizeText(text: string): { text: string; redacted: boolean } { + let out = text; + let redacted = false; + + const replace = ( + re: RegExp, + replacement: string | ((substring: string, ...args: string[]) => string), + ) => { + const next = out.replace(re, replacement as Parameters[1]); + if (next !== out) { + out = next; + redacted = true; + } + }; + + // 1. 整体字符串检测（mcp-tools.js 风格） + // Cookie/query string 形态检测（包含 = 和 ; 或 &） + if (out.includes('=') && (out.includes(';') || out.includes('&'))) { + // 检测 cookie 字符串 + if (looksLikeCookieString(out)) { + return { text: '[BLOCKED: Cookie/query string data]', redacted: true }; + } + // 检测 query string (key=value&key2=value2 形态) + if (looksLikeQueryString(out)) { + return { text: '[BLOCKED: Cookie/query string data]', redacted: true }; + } + } + + // Base64 编码数据检测（20+ 字符的 Base64 字符串） + if (/^[A-Za-z0-9+/]{20,}={0,2}$/.test(out)) { + return { text: '[BLOCKED: Base64 encoded data]', redacted: true }; + } + + // Hex credential 检测（32+ 字符的纯十六进制） + if (/^[a-f0-9]{32,}$/i.test(out)) { + return { text: '[BLOCKED: Hex credential]', redacted: true }; + } + + // 2. Bearer token + replace(/\bBearer\s+([A-Za-z0-9._~+/=-]+)\b/gi, 'Bearer '); + + // 3. JWT (三段式) + replace(/\b[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/g, ''); + + // 4. URL query 参数中的敏感值 + replace( + /(^|[?&])(access_token|refresh_token|id_token|token|api_key|apikey|password|passwd|pwd|secret|session|sid|credential|auth|oauth)=([^&#\s]+)/gi, + (_m, p1, p2) => `${p1}${p2}=`, + ); + + // 5. Header-like 键值对 + replace( + /\b(authorization|cookie|set-cookie|x-api-key|api_key|apikey|password|passwd|pwd|secret|token|access_token|refresh_token|id_token|session|sid|credential|private_key|oauth)\b\s*[:=]\s*([^\s,;"']+)/gi, + (_m, key) => `${key}=`, + ); + + // 6. 内嵌的 Base64 数据（在混合内容中） + replace(/\b[A-Za-z0-9+/]{40,}={0,2}\b/g, ''); + + // 7. 内嵌的长 Hex 字符串（可能是 API key、hash 等） + replace(/\b[a-f0-9]{40,}\b/gi, ''); + + return { text: out, redacted }; +} + +/** + * 检测字符串是否像 query string (key=value&key2=value2) + */ +function looksLikeQueryString(text: string): boolean { + const s = (text || '').trim(); + if (!s || !s.includes('=') || !s.includes('&')) return false; + + const parts = s.split('&'); + if (parts.length < 2) return false; + + let pairs = 0; + for (const part of parts) { + const idx = part.indexOf('='); + if (idx > 0) pairs += 1; + } + return pairs >= 2; +} + +function sanitizeValue( + value: unknown, + limits: { + maxDepth: number; + maxArrayLength: number; + maxObjectKeys: number; + maxStringLength: number; + }, +): { value: unknown; redacted: boolean } { + const { maxDepth, maxArrayLength, maxObjectKeys, maxStringLength } = limits; + const seen = new WeakMap(); + let redacted = false; + + const walk = (v: unknown, depth: number): unknown => { + if (depth < 0) return '[MaxDepth]'; + + if (typeof v === 'string') { + const sanitized = sanitizeText(v); + if (sanitized.redacted) redacted = true; + let s = sanitized.text; + if (s.length > maxStringLength) { + s = `${s.slice(0, maxStringLength)}... [truncated ${s.length - maxStringLength} chars]`; + } + return s; + } + + if ( + v === null || + typeof v === 'number' || + typeof v === 'boolean' || + typeof v === 'bigint' || + typeof v === 'undefined' + ) { + return v; + } + + if (typeof v === 'symbol') return v.toString(); + if (typeof v === 'function') return `[Function${v.name ? `: ${v.name}` : ''}]`; + + if (typeof v !== 'object') return String(v); + + const obj = v as Record; + + if (seen.has(obj)) return '[Circular]'; + + if (Array.isArray(obj)) { + const out: unknown[] = []; + seen.set(obj, out); + const len = Math.min(obj.length, maxArrayLength); + for (let i = 0; i < len; i++) { + out.push(walk(obj[i], depth - 1)); + } + if (obj.length > maxArrayLength) out.push('[...truncated]'); + return out; + } + + const out: Record = {}; + seen.set(obj, out); + + const keys = Object.keys(obj); + const len = Math.min(keys.length, maxObjectKeys); + for (let i = 0; i < len; i++) { + const key = keys[i]; + if (isSensitiveKey(key)) { + out[key] = ''; + redacted = true; + continue; + } + out[key] = walk(obj[key], depth - 1); + } + if (keys.length > maxObjectKeys) out.__truncated__ = true; + + return out; + }; + + return { value: walk(value, maxDepth), redacted }; +} + +function isSensitiveKey(key: string): boolean { + const normalized = normalizeKey(key); + return SENSITIVE_KEY_MARKERS.some((marker) => normalized.includes(marker)); +} + +function normalizeKey(key: string): string { + return (key || '').toLowerCase().replace(/[^a-z0-9]/g, ''); +} + +/** + * 检测字符串是否像 cookie 字符串 (key=value; key2=value2) + */ +function looksLikeCookieString(text: string): boolean { + const s = (text || '').trim(); + if (!s) return false; + if (!s.includes('=') || !s.includes(';')) return false; + + const parts = s.split(';'); + if (parts.length < 2) return false; + + let pairs = 0; + for (const part of parts) { + const idx = part.indexOf('='); + if (idx > 0) pairs += 1; + } + return pairs >= 2; +} + +function formatValueForOutput(value: unknown): string { + if (typeof value === 'string') return value; + if (typeof value === 'undefined') return 'undefined'; + + try { + return safeJsonStringify(value); + } catch { + return String(value); + } +} + +function safeJsonStringify(value: unknown): string { + const seen = new WeakSet(); + return JSON.stringify(value, (_key, val) => { + if (typeof val === 'bigint') return `${val.toString()}n`; + if (typeof val === 'symbol') return val.toString(); + if (typeof val === 'function') return `[Function${val.name ? `: ${val.name}` : ''}]`; + if (val && typeof val === 'object') { + if (seen.has(val)) return '[Circular]'; + seen.add(val); + } + return val; + }); +} + +function truncateTextBytes( + text: string, + maxBytes: number, +): { text: string; truncated: boolean; originalBytes: number } { + const originalBytes = byteLength(text); + if (originalBytes <= maxBytes) { + return { text, truncated: false, originalBytes }; + } + + const suffix = `\n... [truncated to ${maxBytes} bytes; original ${originalBytes} bytes]`; + const suffixBytes = byteLength(suffix); + const budget = Math.max(0, maxBytes - suffixBytes); + + // 二分查找合适的截断点 + let lo = 0; + let hi = text.length; + + while (lo < hi) { + const mid = Math.ceil((lo + hi) / 2); + const candidate = text.slice(0, mid); + if (byteLength(candidate) <= budget) { + lo = mid; + } else { + hi = mid - 1; + } + } + + const prefix = text.slice(0, lo); + return { text: prefix + suffix, truncated: true, originalBytes }; +} + +function byteLength(text: string): number { + try { + return new TextEncoder().encode(text).length; + } catch { + return text.length; + } +} + +function normalizePositiveInt(value: unknown, fallback: number): number { + const n = typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : fallback; + return Math.max(1, n); +} diff --git a/app/chrome-extension/utils/screenshot-context.ts b/app/chrome-extension/utils/screenshot-context.ts new file mode 100644 index 00000000..16ecc632 --- /dev/null +++ b/app/chrome-extension/utils/screenshot-context.ts @@ -0,0 +1,53 @@ +// Simple in-memory screenshot context manager per tab +// Used to scale coordinates from screenshot space to viewport space + +export interface ScreenshotContext { + // Final screenshot dimensions (in CSS pixels after any scaling) + screenshotWidth: number; + screenshotHeight: number; + // Viewport dimensions (CSS pixels) + viewportWidth: number; + viewportHeight: number; + // Device pixel ratio at capture time (optional, for reference) + devicePixelRatio?: number; + // Hostname of the page when the screenshot was taken (used for domain safety checks) + hostname?: string; + // Timestamp + timestamp: number; +} + +const TTL_MS = 5 * 60 * 1000; // 5 minutes + +const contexts = new Map(); + +export const screenshotContextManager = { + setContext(tabId: number, ctx: Omit) { + contexts.set(tabId, { ...ctx, timestamp: Date.now() }); + }, + getContext(tabId: number): ScreenshotContext | undefined { + const ctx = contexts.get(tabId); + if (!ctx) return undefined; + if (Date.now() - ctx.timestamp > TTL_MS) { + contexts.delete(tabId); + return undefined; + } + return ctx; + }, + clear(tabId: number) { + contexts.delete(tabId); + }, +}; + +// Scale screenshot-space coordinates (x,y) to viewport CSS pixels +export function scaleCoordinates( + x: number, + y: number, + ctx: ScreenshotContext, +): { x: number; y: number } { + if (!ctx.screenshotWidth || !ctx.screenshotHeight || !ctx.viewportWidth || !ctx.viewportHeight) { + return { x, y }; + } + const sx = (x / ctx.screenshotWidth) * ctx.viewportWidth; + const sy = (y / ctx.screenshotHeight) * ctx.viewportHeight; + return { x: Math.round(sx), y: Math.round(sy) }; +} diff --git a/app/chrome-extension/vitest.config.ts b/app/chrome-extension/vitest.config.ts new file mode 100644 index 00000000..a5915387 --- /dev/null +++ b/app/chrome-extension/vitest.config.ts @@ -0,0 +1,36 @@ +import { fileURLToPath } from 'node:url'; + +import { defineConfig } from 'vitest/config'; + +const rootDir = fileURLToPath(new URL('.', import.meta.url)); + +export default defineConfig({ + resolve: { + alias: { + // Match WXT's path aliases from .wxt/tsconfig.json + '@': rootDir, + '~': rootDir, + // Mock hnswlib-wasm-static to avoid native module issues in tests + 'hnswlib-wasm-static': `${rootDir}/tests/__mocks__/hnswlib-wasm-static.ts`, + }, + }, + test: { + environment: 'jsdom', + include: ['tests/**/*.test.ts'], + exclude: ['node_modules', '.output', 'dist', '.wxt'], + setupFiles: ['tests/vitest.setup.ts'], + environmentOptions: { + jsdom: { + // Provide a stable URL for anchor/href tests + url: 'https://example.com/', + }, + }, + // Auto-cleanup mocks between tests + clearMocks: true, + restoreMocks: true, + // TypeScript support via esbuild (faster than ts-jest) + typecheck: { + enabled: false, // Run separately with vue-tsc + }, + }, +}); diff --git a/app/chrome-extension/wxt.config.ts b/app/chrome-extension/wxt.config.ts index e18a89a6..7f2fae41 100644 --- a/app/chrome-extension/wxt.config.ts +++ b/app/chrome-extension/wxt.config.ts @@ -1,12 +1,18 @@ import { defineConfig } from 'wxt'; +import tailwindcss from '@tailwindcss/vite'; import { viteStaticCopy } from 'vite-plugin-static-copy'; import { config } from 'dotenv'; import { resolve } from 'path'; +import Icons from 'unplugin-icons/vite'; +import Components from 'unplugin-vue-components/vite'; +import IconsResolver from 'unplugin-icons/resolver'; config({ path: resolve(process.cwd(), '.env') }); config({ path: resolve(process.cwd(), '.env.local') }); const CHROME_EXTENSION_KEY = process.env.CHROME_EXTENSION_KEY; +// Detect dev mode early for manifest-level switches +const IS_DEV = process.env.NODE_ENV !== 'production' && process.env.MODE !== 'production'; // See https://wxt.dev/api/config.html export default defineConfig({ @@ -36,36 +42,97 @@ export default defineConfig({ 'tabs', 'activeTab', 'scripting', + 'contextMenus', 'downloads', 'webRequest', + 'webNavigation', 'debugger', 'history', 'bookmarks', 'offscreen', 'storage', + 'declarativeNetRequest', + 'alarms', + // Allow programmatic control of Chrome Side Panel + 'sidePanel', ], host_permissions: [''], + options_ui: { + page: 'options.html', + open_in_tab: true, + }, + action: { + default_popup: 'popup.html', + default_title: 'Chrome MCP Server', + }, + // Chrome Side Panel entry for workflow management + // Ref: https://developer.chrome.com/docs/extensions/reference/api/sidePanel + side_panel: { + default_path: 'sidepanel.html', + }, + // Keyboard shortcuts for quick triggers + commands: { + // run_quick_trigger_1: { + // suggested_key: { default: 'Ctrl+Shift+1' }, + // description: 'Run quick trigger 1', + // }, + // run_quick_trigger_2: { + // suggested_key: { default: 'Ctrl+Shift+2' }, + // description: 'Run quick trigger 2', + // }, + // run_quick_trigger_3: { + // suggested_key: { default: 'Ctrl+Shift+3' }, + // description: 'Run quick trigger 3', + // }, + // open_workflow_sidepanel: { + // suggested_key: { default: 'Ctrl+Shift+O' }, + // description: 'Open workflow sidepanel', + // }, + toggle_web_editor: { + suggested_key: { default: 'Ctrl+Shift+O', mac: 'Command+Shift+O' }, + description: 'Toggle Web Editor mode', + }, + toggle_quick_panel: { + suggested_key: { default: 'Ctrl+Shift+U', mac: 'Command+Shift+U' }, + description: 'Toggle Quick Panel AI Chat', + }, + }, web_accessible_resources: [ { resources: [ '/models/*', // 允许访问 public/models/ 下的所有文件 '/workers/*', // 允许访问 workers 文件 + '/inject-scripts/*', // 允许内容脚本注入的助手文件 ], matches: [''], }, ], - cross_origin_embedder_policy: { - value: 'require-corp', - }, - cross_origin_opener_policy: { - value: 'same-origin', - }, - content_security_policy: { - extension_pages: "script-src 'self' 'wasm-unsafe-eval'; object-src 'self';", - }, + // 注意：以下安全策略在开发环境会阻断 dev server 的资源加载， + // 只在生产环境启用，开发环境交由 WXT 默认策略处理。 + ...(IS_DEV + ? {} + : { + cross_origin_embedder_policy: { value: 'require-corp' as const }, + cross_origin_opener_policy: { value: 'same-origin' as const }, + content_security_policy: { + // Allow inline styles injected by Vite (compiled CSS) and data images used in UI thumbnails + extension_pages: + "script-src 'self' 'wasm-unsafe-eval'; object-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:;", + }, + }), }, vite: (env) => ({ plugins: [ + // TailwindCSS v4 Vite plugin – no PostCSS config required + tailwindcss(), + // Auto-register SVG icons as Vue components; all icons are bundled locally + Components({ + dts: false, + resolvers: [IconsResolver({ prefix: 'i', enabledCollections: ['lucide', 'mdi', 'ri'] })], + }) as any, + Icons({ compiler: 'vue3', autoInstall: false }) as any, + // Ensure static assets are available as early as possible to avoid race conditions in dev + // Copy workers/_locales/inject-scripts into the build output before other steps viteStaticCopy({ targets: [ { @@ -81,6 +148,13 @@ export default defineConfig({ dest: '_locales', }, ], + // Use writeBundle so outDir exists for dev and prod + hook: 'writeBundle', + // Enable watch so changes to these files are reflected during dev + watch: { + // Use default patterns inferred from targets; explicit true enables watching + // Vite plugin will watch src patterns and re-copy on change + } as any, }) as any, ], build: { diff --git a/app/native-server/.npmignore b/app/native-server/.npmignore new file mode 100644 index 00000000..459acdb6 --- /dev/null +++ b/app/native-server/.npmignore @@ -0,0 +1,8 @@ +# Development-only files that should not be published to npm + +# node_path.txt contains the absolute path to Node.js used during build. +# It's written by build.ts for development hot-reload, but is useless +# (and potentially confusing) in the published package since users will +# have their own Node.js path written by postinstall. +node_path.txt +**/node_path.txt diff --git a/app/native-server/README.md b/app/native-server/README.md index 0228f121..487461c0 100644 --- a/app/native-server/README.md +++ b/app/native-server/README.md @@ -15,8 +15,8 @@ ### 前置条件 -- Node.js 14+ -- npm 6+ +- Node.js 20+ +- npm 8+ 或 pnpm 8+ ### 安装 diff --git a/app/native-server/install.md b/app/native-server/install.md index 0121915e..0a009b97 100644 --- a/app/native-server/install.md +++ b/app/native-server/install.md @@ -7,12 +7,12 @@ Chrome MCP Bridge 的安装和注册流程如下： ``` -npm install -g chrome-mcp-bridge +npm install -g mcp-chrome-bridge └─ postinstall.js ├─ 复制可执行文件到 npm_prefix/bin ← 总是可写（用户或root权限） ├─ 尝试用户级别注册 ← 无需sudo，大多数情况下成功 - └─ 如果失败 ➜ 提示用户运行 chrome-mcp-bridge register --system - └─ 使用sudo-prompt自动提权 → 写入系统级清单文件 + └─ 如果失败 ➜ 提示用户运行 mcp-chrome-bridge register --system + └─ 需要手动使用管理员权限运行 ``` 上面的流程图展示了从全局安装开始，到最终完成注册的完整过程。 @@ -22,7 +22,7 @@ npm install -g chrome-mcp-bridge ### 1. 全局安装 ```bash -npm install -g chrome-mcp-bridge +npm install -g mcp-chrome-bridge ``` 安装完成后，系统会自动尝试在用户目录中注册 Native Messaging 主机。这不需要管理员权限，是推荐的安装方式。 @@ -47,7 +47,13 @@ npm install -g chrome-mcp-bridge 如果自动注册失败，或者您想手动注册，可以运行： ```bash -chrome-mcp-bridge register +mcp-chrome-bridge register +``` + +**推荐：运行诊断工具检查问题：** + +```bash +mcp-chrome-bridge doctor ``` ### 3. 系统级别注册 @@ -59,10 +65,14 @@ chrome-mcp-bridge register #### 方式一：使用 `--system` 参数（推荐） ```bash -chrome-mcp-bridge register --system +# macOS/Linux +sudo mcp-chrome-bridge register --system + +# Windows (以管理员身份运行命令提示符) +mcp-chrome-bridge register --system ``` -这将使用 `sudo-prompt` 自动提升权限，无需手动输入 `sudo` 命令。 +系统级安装需要管理员权限才能写入系统目录和注册表。 #### 方式二：直接使用管理员权限 @@ -70,14 +80,14 @@ chrome-mcp-bridge register --system 以管理员身份运行命令提示符或 PowerShell，然后执行： ``` -chrome-mcp-bridge register +mcp-chrome-bridge register ``` **macOS/Linux**： 使用 sudo 命令： ``` -sudo chrome-mcp-bridge register +sudo mcp-chrome-bridge register ``` ## 注册流程详解 @@ -86,19 +96,17 @@ sudo chrome-mcp-bridge register ``` 注册流程 -├─ 用户级别注册 (chrome-mcp-bridge register) +├─ 用户级别注册 (mcp-chrome-bridge register) │ ├─ 获取用户级别清单路径 │ ├─ 创建用户目录 │ ├─ 生成清单内容 │ ├─ 写入清单文件 │ └─ Windows平台：创建用户级注册表项 │ -└─ 系统级别注册 (chrome-mcp-bridge register --system) +└─ 系统级别注册 (mcp-chrome-bridge register --system) ├─ 检查是否有管理员权限 │ ├─ 有权限 → 直接创建系统目录和写入清单 - │ └─ 无权限 → 使用sudo-prompt提权 - │ ├─ 创建临时清单文件 - │ └─ 复制到系统目录 + │ └─ 无权限 → 提示用户使用管理员权限运行 └─ Windows平台：创建系统级注册表项 ``` @@ -106,15 +114,12 @@ sudo chrome-mcp-bridge register ``` manifest.json -├─ name: "com.chrome-mcp.native-host" +├─ name: "com.chromemcp.nativehost" ├─ description: "Node.js Host for Browser Bridge Extension" -├─ path: "/path/to/node" ← Node.js可执行文件路径 +├─ path: "/path/to/run_host.sh" ← 启动脚本路径 ├─ type: "stdio" ← 通信类型 -├─ allowed_origins: [ ← 允许连接的扩展 -│ "chrome-extension://扩展ID/" -└─ args: [ ← 启动参数 - "/path/to/chrome-mcp-bridge", - "native" +└─ allowed_origins: [ ← 允许连接的扩展 + "chrome-extension://扩展ID/" ] ``` @@ -141,10 +146,9 @@ manifest.json - 设置适当的权限 - 在 Windows 上创建系统级注册表项 3. 如果没有管理员权限： - - 使用 `sudo-prompt` 提升权限 - - 创建临时清单文件 - - 复制到系统目录 - - 在 Windows 上创建系统级注册表项 + - 提示用户使用管理员权限重新运行命令 + - macOS/Linux: `sudo mcp-chrome-bridge register --system` + - Windows: 以管理员身份运行命令提示符 ## 验证安装 @@ -170,13 +174,11 @@ manifest.json 安装完成后，您可以通过以下方式验证安装是否成功： 1. 检查清单文件是否存在于相应目录 - - 用户级别：检查用户目录下的清单文件 - 系统级别：检查系统目录下的清单文件 - 确认清单文件内容是否正确 2. 在 Chrome 中安装对应的扩展 - - 确保扩展已正确安装 - 确保扩展有 `nativeMessaging` 权限 @@ -198,9 +200,9 @@ manifest.json │ ├─ 执行权限问题 (macOS/Linux) │ │ ├─ "Permission denied" 错误 │ │ ├─ "Native host has exited" 错误 -│ │ └─ 运行 chrome-mcp-bridge fix-permissions +│ │ └─ 运行 mcp-chrome-bridge fix-permissions │ │ -│ └─ 尝试 chrome-mcp-bridge register --system +│ └─ 尝试 mcp-chrome-bridge register --system │ ├─ 路径问题 │ ├─ 检查Node.js安装 (node -v) @@ -220,12 +222,10 @@ manifest.json 如果安装过程中遇到问题，请尝试以下步骤： 1. 确保 Node.js 已正确安装 - - 运行 `node -v` 和 `npm -v` 检查版本 - - 确保 Node.js 版本 >= 14.x + - 确保 Node.js 版本 >= 20.x 2. 检查是否有足够的权限创建文件和目录 - - 用户级别安装需要对用户目录有写入权限 - 系统级别安装需要管理员/root权限 @@ -234,7 +234,6 @@ manifest.json **macOS/Linux 平台**： **问题描述**： - - npm 安装通常会保留文件权限，但 pnpm 可能不会 - 可能遇到 "Permission denied" 或 "Native host has exited" 错误 - Chrome 扩展无法启动 native host 进程 @@ -244,27 +243,32 @@ manifest.json a) **使用内置修复命令（推荐）**： ```bash - chrome-mcp-bridge fix-permissions + mcp-chrome-bridge fix-permissions ``` - b) **手动设置权限**： + b) **运行诊断工具自动修复**： + + ```bash + mcp-chrome-bridge doctor --fix + ``` + + c) **手动设置权限**： ```bash # 查找安装路径 - npm list -g chrome-mcp-bridge + npm list -g mcp-chrome-bridge # 或者对于 pnpm - pnpm list -g chrome-mcp-bridge + pnpm list -g mcp-chrome-bridge # 设置执行权限（替换为实际路径） - chmod +x /path/to/node_modules/chrome-mcp-bridge/run_host.sh - chmod +x /path/to/node_modules/chrome-mcp-bridge/index.js - chmod +x /path/to/node_modules/chrome-mcp-bridge/cli.js + chmod +x /path/to/node_modules/mcp-chrome-bridge/run_host.sh + chmod +x /path/to/node_modules/mcp-chrome-bridge/index.js + chmod +x /path/to/node_modules/mcp-chrome-bridge/cli.js ``` **Windows 平台**： **问题描述**： - - Windows 上 `.bat` 文件通常不需要执行权限，但可能遇到其他问题 - 文件可能被标记为只读 - 可能遇到 "Access denied" 或文件无法执行的错误 @@ -274,42 +278,46 @@ manifest.json a) **使用内置修复命令（推荐）**： ```cmd - chrome-mcp-bridge fix-permissions + mcp-chrome-bridge fix-permissions ``` - b) **手动检查文件属性**： + b) **运行诊断工具自动修复**： + + ```cmd + mcp-chrome-bridge doctor --fix + ``` + + c) **手动检查文件属性**： ```cmd # 查找安装路径 - npm list -g chrome-mcp-bridge + npm list -g mcp-chrome-bridge # 检查文件属性（在文件资源管理器中右键 -> 属性） # 确保 run_host.bat 不是只读文件 ``` - c) **重新安装并强制权限**： + d) **重新安装并强制权限**： ```bash # 卸载 - npm uninstall -g chrome-mcp-bridge - # 或 pnpm uninstall -g chrome-mcp-bridge + npm uninstall -g mcp-chrome-bridge + # 或 pnpm uninstall -g mcp-chrome-bridge # 重新安装 - npm install -g chrome-mcp-bridge - # 或 pnpm install -g chrome-mcp-bridge + npm install -g mcp-chrome-bridge + # 或 pnpm install -g mcp-chrome-bridge # 如果仍有问题，运行权限修复 - chrome-mcp-bridge fix-permissions + mcp-chrome-bridge fix-permissions ``` 4. 在 Windows 上，确保注册表访问没有被限制 - - 检查是否可以访问 `HKCU\Software\Google\Chrome\NativeMessagingHosts\` - 对于系统级别，检查 `HKLM\Software\Google\Chrome\NativeMessagingHosts\` 5. 尝试使用系统级别安装 - - - 使用 `chrome-mcp-bridge register --system` 命令 + - 使用 `mcp-chrome-bridge register --system` 命令 - 或直接使用管理员权限运行 6. 检查控制台输出的错误信息 diff --git a/app/native-server/package.json b/app/native-server/package.json index 48489f08..cbfd3e5f 100644 --- a/app/native-server/package.json +++ b/app/native-server/package.json @@ -5,6 +5,7 @@ "main": "dist/index.js", "bin": { "mcp-chrome-bridge": "./dist/cli.js", + "chrome-mcp-bridge": "./dist/cli.js", "mcp-chrome-stdio": "./dist/mcp/mcp-server-stdio.js" }, "scripts": { @@ -19,10 +20,11 @@ "postinstall": "node dist/scripts/postinstall.js" }, "files": [ - "dist" + "dist", + "!dist/node_path.txt" ], "engines": { - "node": ">=14.0.0" + "node": ">=20.0.0" }, "preferGlobal": true, "keywords": [ @@ -33,20 +35,25 @@ "author": "hangye", "license": "MIT", "dependencies": { + "@anthropic-ai/claude-agent-sdk": "^0.1.69", "@fastify/cors": "^11.0.1", "@modelcontextprotocol/sdk": "^1.11.0", - "@types/node-fetch": "^2.6.13", + "@types/node-fetch": "2", + "better-sqlite3": "^11.6.0", "chalk": "^5.4.1", + "chrome-devtools-frontend": "^1.0.1299282", "chrome-mcp-shared": "workspace:*", "commander": "^13.1.0", + "drizzle-orm": "^0.38.2", "fastify": "^5.3.2", "is-admin": "^4.0.0", - "node-fetch": "^2.7.0", + "node-fetch": "2", "pino": "^9.6.0", "uuid": "^11.1.0" }, "devDependencies": { "@jest/globals": "^29.7.0", + "@types/better-sqlite3": "^7.6.12", "@types/chrome": "^0.0.318", "@types/jest": "^29.5.14", "@types/node": "^22.15.3", diff --git a/app/native-server/src/agent/attachment-service.ts b/app/native-server/src/agent/attachment-service.ts new file mode 100644 index 00000000..33375788 --- /dev/null +++ b/app/native-server/src/agent/attachment-service.ts @@ -0,0 +1,463 @@ +/** + * Attachment Service for persisting and managing image attachments. + * + * Handles: + * - Saving attachments to persistent storage (not temp files) + * - Getting attachment statistics per project + * - Cleaning up attachments by project or all + * + * Storage structure: + * ~/.chrome-mcp-agent/attachments/{projectId}/{messageId}-{index}-{uuid}.{ext} + */ +import fs from 'node:fs/promises'; +import path from 'node:path'; +import { randomUUID } from 'node:crypto'; +import type { + AgentAttachment, + AttachmentMetadata, + AttachmentProjectStats, +} from 'chrome-mcp-shared'; +import { getAgentDataDir } from './storage'; + +// ============================================================ +// Types +// ============================================================ + +export interface SaveAttachmentInput { + projectId: string; + messageId: string; + attachment: AgentAttachment; + index: number; +} + +export interface SavedAttachment { + /** Absolute path on disk (for engines) */ + absolutePath: string; + /** Persisted filename under project dir */ + filename: string; + /** Metadata to store in message.metadata.attachments */ + metadata: AttachmentMetadata; +} + +export interface AttachmentStats { + rootDir: string; + totalFiles: number; + totalBytes: number; + projects: AttachmentProjectStats[]; +} + +export interface CleanupAttachmentsInput { + /** If omitted, cleanup all project dirs under root */ + projectIds?: string[]; +} + +export interface CleanupProjectResult { + projectId: string; + dirPath: string; + existed: boolean; + removedFiles: number; + removedBytes: number; +} + +export interface CleanupResult { + rootDir: string; + removedFiles: number; + removedBytes: number; + results: CleanupProjectResult[]; +} + +// ============================================================ +// Constants +// ============================================================ + +const ATTACHMENTS_DIR_NAME = 'attachments'; + +/** Allowed MIME types for image attachments */ +const ALLOWED_MIME_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']); + +// ============================================================ +// Helper Functions +// ============================================================ + +/** + * Convert MIME type to file extension. + */ +function mimeTypeToExt(mimeType: string): string { + switch (mimeType) { + case 'image/png': + return 'png'; + case 'image/jpeg': + return 'jpg'; + case 'image/gif': + return 'gif'; + case 'image/webp': + return 'webp'; + default: + return 'bin'; + } +} + +/** + * Build a unique filename for an attachment. + * Format: {messageId}-{index}-{uuid}.{ext} + */ +function buildAttachmentFilename(params: { + messageId: string; + index: number; + mimeType: string; +}): string { + const ext = mimeTypeToExt(params.mimeType); + const uuid = randomUUID().slice(0, 8); + return `${params.messageId}-${params.index}-${uuid}.${ext}`; +} + +/** + * Validate filename to prevent path traversal attacks. + */ +function isValidFilename(filename: string): boolean { + // Reject empty, path separators, parent directory references + if (!filename || filename.includes('/') || filename.includes('\\')) { + return false; + } + if (filename === '.' || filename === '..' || filename.startsWith('.')) { + return false; + } + // Only allow alphanumeric, dash, underscore, dot + return /^[a-zA-Z0-9_-]+\.[a-zA-Z0-9]+$/.test(filename); +} + +/** + * Validate projectId to prevent path traversal attacks. + */ +function isValidProjectId(projectId: string): boolean { + if (!projectId) return false; + // UUID format or alphanumeric with dashes + return /^[a-zA-Z0-9_-]+$/.test(projectId); +} + +// ============================================================ +// AttachmentService Class +// ============================================================ + +export class AttachmentService { + /** + * Get the root directory for all attachments. + */ + getAttachmentsRootDir(): string { + return path.join(getAgentDataDir(), ATTACHMENTS_DIR_NAME); + } + + /** + * Get the directory for a specific project's attachments. + */ + getProjectAttachmentsDir(projectId: string): string { + if (!isValidProjectId(projectId)) { + throw new Error(`Invalid projectId: ${projectId}`); + } + return path.join(this.getAttachmentsRootDir(), projectId); + } + + /** + * Get the absolute path for a specific attachment file. + * Validates to prevent path traversal attacks. + */ + getAttachmentPath(projectId: string, filename: string): string { + if (!isValidProjectId(projectId)) { + throw new Error(`Invalid projectId: ${projectId}`); + } + if (!isValidFilename(filename)) { + throw new Error(`Invalid filename: ${filename}`); + } + + const projectDir = this.getProjectAttachmentsDir(projectId); + const filePath = path.join(projectDir, filename); + + // Double-check resolved path is within project directory (defense in depth) + const resolved = path.resolve(filePath); + const resolvedProjectDir = path.resolve(projectDir); + if (!resolved.startsWith(resolvedProjectDir + path.sep)) { + throw new Error('Path traversal attempt detected'); + } + + return filePath; + } + + /** + * Save an attachment to persistent storage. + * Creates directories if needed. + */ + async saveAttachment(input: SaveAttachmentInput): Promise { + const { projectId, messageId, attachment, index } = input; + + // Validate input + if (!isValidProjectId(projectId)) { + throw new Error(`Invalid projectId: ${projectId}`); + } + if (attachment.type !== 'image') { + throw new Error(`Unsupported attachment type: ${attachment.type}`); + } + if (!ALLOWED_MIME_TYPES.has(attachment.mimeType)) { + throw new Error(`Unsupported MIME type: ${attachment.mimeType}`); + } + + // Build filename and paths + const filename = buildAttachmentFilename({ + messageId, + index, + mimeType: attachment.mimeType, + }); + const projectDir = this.getProjectAttachmentsDir(projectId); + const absolutePath = path.join(projectDir, filename); + + // Decode base64 and get size + const buffer = Buffer.from(attachment.dataBase64, 'base64'); + const sizeBytes = buffer.length; + + // Create directory and write file + await fs.mkdir(projectDir, { recursive: true }); + await fs.writeFile(absolutePath, buffer); + + // Build metadata + const metadata: AttachmentMetadata = { + version: 1, + kind: 'image', + projectId, + messageId, + index, + filename, + urlPath: `/agent/attachments/${projectId}/${filename}`, + mimeType: attachment.mimeType, + sizeBytes, + originalName: attachment.name, + createdAt: new Date().toISOString(), + }; + + console.error(`[AttachmentService] Saved attachment: ${absolutePath} (${sizeBytes} bytes)`); + + return { + absolutePath, + filename, + metadata, + }; + } + + /** + * Get statistics for all attachments. + */ + async getAttachmentStats(): Promise { + const rootDir = this.getAttachmentsRootDir(); + const projects: AttachmentProjectStats[] = []; + let totalFiles = 0; + let totalBytes = 0; + + try { + // Check if root directory exists + await fs.access(rootDir); + + // Read all project directories + const entries = await fs.readdir(rootDir, { withFileTypes: true }); + + for (const entry of entries) { + if (!entry.isDirectory()) continue; + + const projectId = entry.name; + const dirPath = path.join(rootDir, projectId); + + try { + const stats = await this.getProjectStats(projectId, dirPath); + projects.push(stats); + totalFiles += stats.fileCount; + totalBytes += stats.totalBytes; + } catch (error) { + // Skip directories we can't read + console.error(`[AttachmentService] Failed to stat project ${projectId}:`, error); + } + } + } catch { + // Root directory doesn't exist - return empty stats + } + + return { + rootDir, + totalFiles, + totalBytes, + projects, + }; + } + + /** + * Get statistics for a single project. + */ + private async getProjectStats( + projectId: string, + dirPath: string, + ): Promise { + let fileCount = 0; + let totalBytes = 0; + let lastModifiedAt: string | undefined; + let latestMtime = 0; + + try { + const files = await fs.readdir(dirPath); + + for (const file of files) { + const filePath = path.join(dirPath, file); + try { + const stat = await fs.stat(filePath); + if (stat.isFile()) { + fileCount++; + totalBytes += stat.size; + if (stat.mtimeMs > latestMtime) { + latestMtime = stat.mtimeMs; + lastModifiedAt = stat.mtime.toISOString(); + } + } + } catch { + // Skip files we can't stat + } + } + + return { + projectId, + dirPath, + exists: true, + fileCount, + totalBytes, + lastModifiedAt, + }; + } catch { + return { + projectId, + dirPath, + exists: false, + fileCount: 0, + totalBytes: 0, + }; + } + } + + /** + * Cleanup attachments for specified projects or all projects. + */ + async cleanupAttachments(input?: CleanupAttachmentsInput): Promise { + const rootDir = this.getAttachmentsRootDir(); + const results: CleanupProjectResult[] = []; + let totalRemovedFiles = 0; + let totalRemovedBytes = 0; + + // Determine which projects to clean + let projectIds: string[]; + + if (input?.projectIds && input.projectIds.length > 0) { + // Clean specific projects + projectIds = input.projectIds; + } else { + // Clean all projects - enumerate from filesystem + try { + const entries = await fs.readdir(rootDir, { withFileTypes: true }); + projectIds = entries.filter((e) => e.isDirectory()).map((e) => e.name); + } catch { + // Root doesn't exist - nothing to clean + return { + rootDir, + removedFiles: 0, + removedBytes: 0, + results: [], + }; + } + } + + // Clean each project + for (const projectId of projectIds) { + if (!isValidProjectId(projectId)) { + console.error(`[AttachmentService] Skipping invalid projectId: ${projectId}`); + continue; + } + + const result = await this.cleanupProject(projectId); + results.push(result); + totalRemovedFiles += result.removedFiles; + totalRemovedBytes += result.removedBytes; + } + + return { + rootDir, + removedFiles: totalRemovedFiles, + removedBytes: totalRemovedBytes, + results, + }; + } + + /** + * Cleanup attachments for a single project. + */ + private async cleanupProject(projectId: string): Promise { + const dirPath = this.getProjectAttachmentsDir(projectId); + + try { + // Get stats before deletion + const stats = await this.getProjectStats(projectId, dirPath); + + if (!stats.exists) { + return { + projectId, + dirPath, + existed: false, + removedFiles: 0, + removedBytes: 0, + }; + } + + // Remove directory and all contents + await fs.rm(dirPath, { recursive: true, force: true }); + + console.error( + `[AttachmentService] Cleaned up ${stats.fileCount} files (${stats.totalBytes} bytes) for project ${projectId}`, + ); + + return { + projectId, + dirPath, + existed: true, + removedFiles: stats.fileCount, + removedBytes: stats.totalBytes, + }; + } catch (error) { + console.error(`[AttachmentService] Failed to cleanup project ${projectId}:`, error); + return { + projectId, + dirPath, + existed: false, + removedFiles: 0, + removedBytes: 0, + }; + } + } + + /** + * Check if an attachment file exists. + */ + async attachmentExists(projectId: string, filename: string): Promise { + try { + const filePath = this.getAttachmentPath(projectId, filename); + await fs.access(filePath); + return true; + } catch { + return false; + } + } + + /** + * Read an attachment file. + */ + async readAttachment(projectId: string, filename: string): Promise { + const filePath = this.getAttachmentPath(projectId, filename); + return fs.readFile(filePath); + } +} + +// ============================================================ +// Singleton Export +// ============================================================ + +export const attachmentService = new AttachmentService(); diff --git a/app/native-server/src/agent/ccr-detector.ts b/app/native-server/src/agent/ccr-detector.ts new file mode 100644 index 00000000..008953d6 --- /dev/null +++ b/app/native-server/src/agent/ccr-detector.ts @@ -0,0 +1,406 @@ +/** + * Claude Code Router (CCR) Auto-Detection Module. + * + * This module provides automatic detection of CCR configuration + * for users who have already set up CCR on their system. + * + * CCR config location: ~/.claude-code-router/config.json + * CCR uses env vars: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN + * + * The detection flow: + * 1. Check if CCR env vars are already set (skip if yes) + * 2. Read CCR config file + * 3. Parse JSON5 config with env var interpolation + * 4. Verify CCR is running via health check + * 5. Return derived env vars if healthy + */ +import { readFile } from 'node:fs/promises'; +import path from 'node:path'; +import os from 'node:os'; + +/** + * Result of CCR detection. + */ +export interface CcrDetectionResult { + detected: boolean; + baseUrl?: string; + authToken?: string; + source?: 'env' | 'config'; + error?: string; +} + +/** + * Result of validating CCR configuration. + */ +export interface CcrValidationResult { + /** Whether a CCR config file was found and inspected */ + checked: boolean; + /** Whether the configuration is valid */ + valid: boolean; + /** Path to the CCR config file */ + configPath: string; + /** Current Router.default value if available */ + routerDefault?: string; + /** Human-readable issue description when valid is false */ + issue?: string; + /** Suggested Router.default value in "provider,model" format */ + suggestedFix?: string; + /** Full suggestion message for the user */ + suggestion?: string; +} + +/** + * CCR Router configuration. + */ +interface CcrRouterConfig { + default?: string; + background?: string; + think?: string; + longContext?: string; + webSearch?: string; + image?: string; +} + +/** + * CCR Provider configuration. + */ +interface CcrProviderConfig { + name?: string; + models?: string[]; +} + +/** + * CCR configuration structure. + * Note: CCR uses uppercase field names in config.json + */ +interface CcrConfig { + // Uppercase (actual CCR config format) + PORT?: number; + HOST?: string; + APIKEY?: string; + Router?: CcrRouterConfig; + Providers?: CcrProviderConfig[]; + // Lowercase (for compatibility) + port?: number; + host?: string; + apiKey?: string; + router?: CcrRouterConfig; + providers?: CcrProviderConfig[]; +} + +/** + * Default CCR port. + */ +const DEFAULT_CCR_PORT = 9898; + +/** + * CCR config file path. + */ +const CCR_CONFIG_PATH = path.join(os.homedir(), '.claude-code-router', 'config.json'); + +/** + * Health check timeout in milliseconds. + */ +const HEALTH_CHECK_TIMEOUT = 2000; + +/** + * Cache for CCR detection result (to avoid repeated file reads and health checks). + * Cached for the lifetime of the process. + */ +let cachedResult: CcrDetectionResult | null = null; +let cacheTimestamp = 0; +const CACHE_TTL = 60000; // 1 minute + +/** + * Detect CCR configuration and verify it's running. + * + * This function: + * 1. Returns cached result if still valid + * 2. Checks if CCR env vars are already set in process.env + * 3. If not, reads and parses CCR config file + * 4. Verifies CCR is running via health check + * + * @returns Detection result with baseUrl and authToken if CCR is available + */ +export async function detectCcr(): Promise { + // Check cache + const now = Date.now(); + if (cachedResult && now - cacheTimestamp < CACHE_TTL) { + return cachedResult; + } + + try { + // First, check if env vars are already set (user ran `eval "$(ccr activate)"`) + const envBaseUrl = process.env.ANTHROPIC_BASE_URL; + const envAuthToken = process.env.ANTHROPIC_AUTH_TOKEN; + + if (envBaseUrl && envAuthToken) { + // Verify CCR is running + const healthy = await checkCcrHealth(envBaseUrl); + if (healthy) { + cachedResult = { + detected: true, + baseUrl: envBaseUrl, + authToken: envAuthToken, + source: 'env', + }; + cacheTimestamp = now; + return cachedResult; + } + // Env vars set but CCR not healthy - fall through to config detection + } + + // Try to read CCR config file + const configResult = await readCcrConfig(); + if (!configResult.config) { + cachedResult = { + detected: false, + error: configResult.error || 'CCR config not found or invalid', + }; + cacheTimestamp = now; + return cachedResult; + } + const config = configResult.config; + + // Derive env vars from config (support both uppercase and lowercase field names) + const port = config.PORT ?? config.port ?? DEFAULT_CCR_PORT; + const host = config.HOST ?? config.host ?? '127.0.0.1'; + const baseUrl = `http://${host}:${port}`; + // APIKEY can be empty string in config, use 'APIKEY' as fallback (CCR accepts this) + const apiKey = config.APIKEY ?? config.apiKey; + const authToken = apiKey && apiKey.length > 0 ? apiKey : 'APIKEY'; + + // Verify CCR is running + const healthy = await checkCcrHealth(baseUrl); + if (!healthy) { + cachedResult = { + detected: false, + error: 'CCR config found but service not running', + }; + cacheTimestamp = now; + return cachedResult; + } + + cachedResult = { + detected: true, + baseUrl, + authToken, + source: 'config', + }; + cacheTimestamp = now; + return cachedResult; + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + cachedResult = { detected: false, error: message }; + cacheTimestamp = now; + return cachedResult; + } +} + +/** + * Result of reading CCR config. + */ +interface ReadConfigResult { + config: CcrConfig | null; + error?: string; +} + +/** + * Read and parse CCR config file. + */ +async function readCcrConfig(): Promise { + try { + const content = await readFile(CCR_CONFIG_PATH, 'utf-8'); + const config = parseJson5Config(content); + if (!config) { + return { config: null, error: 'Failed to parse CCR config file' }; + } + return { config }; + } catch (error) { + const err = error as NodeJS.ErrnoException; + if (err.code === 'ENOENT') { + // Config file doesn't exist - CCR not installed + return { config: null, error: 'CCR config file not found' }; + } + return { config: null, error: `Failed to read CCR config: ${err.message}` }; + } +} + +/** + * Parse CCR config file. + * + * CCR config is standard JSON (not JSON5), so we can use JSON.parse directly. + * We only need to handle env var interpolation: ${VAR_NAME} + * + * Note: Previous implementation tried to strip comments using regex which + * incorrectly matched "http://" URLs inside strings. + */ +function parseJson5Config(content: string): CcrConfig | null { + try { + // First try standard JSON parse (CCR config is usually valid JSON) + // Only interpolate env vars if needed + let processed = content; + + // Interpolate env vars: ${VAR_NAME} -> value + // Only do this outside of the JSON parsing to avoid breaking strings + if (content.includes('${')) { + processed = content.replace(/\$\{([^}]+)\}/g, (_, varName) => { + const value = process.env[varName.trim()]; + return value || ''; + }); + } + + const parsed = JSON.parse(processed); + return parsed as CcrConfig; + } catch (parseError) { + // Log parse error for debugging + console.error('[CCR] Failed to parse config:', parseError); + return null; + } +} + +/** + * Check if CCR is running by hitting its health endpoint. + */ +async function checkCcrHealth(baseUrl: string): Promise { + try { + const healthUrl = `${baseUrl}/health`; + const controller = new AbortController(); + const timeoutId = setTimeout(() => controller.abort(), HEALTH_CHECK_TIMEOUT); + + try { + const response = await fetch(healthUrl, { + method: 'GET', + signal: controller.signal, + }); + clearTimeout(timeoutId); + return response.ok; + } catch { + clearTimeout(timeoutId); + return false; + } + } catch { + return false; + } +} + +/** + * Clear the CCR detection cache. + * Useful for testing or when user wants to re-detect. + */ +export function clearCcrCache(): void { + cachedResult = null; + cacheTimestamp = 0; +} + +/** + * Validate CCR configuration for common misconfigurations. + * + * This function checks for issues that would cause runtime errors in CCR, + * particularly the "Router.default must be provider,model" requirement. + * + * The most common misconfiguration is setting Router.default to just a provider + * name (e.g., "venus") instead of the required "provider,model" format + * (e.g., "venus,claude-4-5-sonnet-20250929"). This causes CCR to crash with + * "Cannot read properties of undefined (reading 'includes')" when it tries + * to split the model name. + */ +export async function validateCcrConfig(): Promise { + const configResult = await readCcrConfig(); + + // If we can't read the config, return early (not our problem to report) + if (!configResult.config) { + return { + checked: false, + valid: true, + configPath: CCR_CONFIG_PATH, + issue: configResult.error, + }; + } + + const config = configResult.config; + const router = config.Router ?? config.router; + const routerDefault = router?.default?.trim(); + + // No Router.default configured + if (!routerDefault) { + return { + checked: true, + valid: false, + configPath: CCR_CONFIG_PATH, + issue: 'CCR Router.default is not configured.', + suggestion: `Edit ${CCR_CONFIG_PATH} and set Router.default to "provider,model" format, then restart CCR.`, + }; + } + + // Check if Router.default contains a comma (required format: provider,model) + if (!routerDefault.includes(',')) { + const suggestedFix = inferSuggestedRouterDefault(routerDefault, config, router); + const example = suggestedFix ?? `${routerDefault},`; + + return { + checked: true, + valid: false, + configPath: CCR_CONFIG_PATH, + routerDefault, + issue: `CCR Router.default must be "provider,model" format, but got "${routerDefault}" (missing model).`, + suggestedFix, + suggestion: `Edit ${CCR_CONFIG_PATH} and change Router.default from "${routerDefault}" to "${example}", then restart CCR.`, + }; + } + + // Validate the model part is not empty after splitting + const [providerPart, modelPart] = routerDefault.split(',', 2); + if (!providerPart?.trim() || !modelPart?.trim()) { + const suggestedFix = inferSuggestedRouterDefault(providerPart?.trim() ?? '', config, router); + return { + checked: true, + valid: false, + configPath: CCR_CONFIG_PATH, + routerDefault, + issue: `CCR Router.default "${routerDefault}" has empty provider or model part.`, + suggestedFix, + suggestion: `Edit ${CCR_CONFIG_PATH} and set Router.default to a valid "provider,model" format, then restart CCR.`, + }; + } + + return { + checked: true, + valid: true, + configPath: CCR_CONFIG_PATH, + routerDefault, + }; +} + +/** + * Try to infer a suggested Router.default value based on available providers and models. + */ +function inferSuggestedRouterDefault( + providerName: string, + config: CcrConfig, + router?: CcrRouterConfig, +): string | undefined { + const normalizedProvider = providerName.toLowerCase(); + if (!normalizedProvider) return undefined; + + // Try to find the provider in Providers array and get its first model + const providers = config.Providers ?? config.providers ?? []; + const matchedProvider = providers.find((p) => p.name?.toLowerCase() === normalizedProvider); + + if (matchedProvider?.name && matchedProvider.models?.[0]) { + return `${matchedProvider.name},${matchedProvider.models[0]}`; + } + + // Fallback: look at other Router entries that have valid "provider,model" format + const routerEntries = [router?.background, router?.think, router?.longContext]; + for (const entry of routerEntries) { + if (!entry || !entry.includes(',')) continue; + + const [p, m] = entry.split(',', 2); + if (p?.trim().toLowerCase() === normalizedProvider && m?.trim()) { + return `${providerName},${m.trim()}`; + } + } + + return undefined; +} diff --git a/app/native-server/src/agent/chat-service.ts b/app/native-server/src/agent/chat-service.ts new file mode 100644 index 00000000..f9a90f70 --- /dev/null +++ b/app/native-server/src/agent/chat-service.ts @@ -0,0 +1,527 @@ +import { randomUUID } from 'node:crypto'; +import type { AgentActRequest } from './types'; +import type { + AgentEngine, + EngineExecutionContext, + EngineName, + EngineInitOptions, + RunningExecution, +} from './engines/types'; +import type { AgentMessage, RealtimeEvent } from './types'; +import type { AttachmentMetadata } from 'chrome-mcp-shared'; +import { AgentStreamManager } from './stream-manager'; +import { getProject, touchProjectActivity, updateProjectClaudeSessionId } from './project-service'; +import { createMessage as persistAgentMessage } from './message-service'; +import { + getSession, + updateEngineSessionId, + updateManagementInfo, + touchSessionActivity, + type AgentSession, +} from './session-service'; +import { attachmentService, type SavedAttachment } from './attachment-service'; + +export interface AgentChatServiceOptions { + engines: AgentEngine[]; + streamManager: AgentStreamManager; + defaultEngineName?: EngineName; +} + +/** + * AgentChatService coordinates incoming /agent/chat requests and delegates to engines. + * + * 中文说明：该服务负责会话级调度，不关心具体 CLI/SDK 实现细节。 + * 通过 Engine 接口实现依赖倒置，后续替换或新增引擎时无需修改 HTTP 路由层。 + */ +export class AgentChatService { + private readonly engines = new Map(); + private readonly streamManager: AgentStreamManager; + private readonly defaultEngineName: EngineName; + + /** + * Registry of currently running executions, keyed by requestId. + */ + private readonly runningExecutions = new Map(); + + constructor(options: AgentChatServiceOptions) { + this.streamManager = options.streamManager; + + for (const engine of options.engines) { + this.engines.set(engine.name, engine); + } + + if (options.defaultEngineName && this.engines.has(options.defaultEngineName)) { + this.defaultEngineName = options.defaultEngineName; + } else { + // Fallback to first registered engine to avoid hard-coding 'claude' here. + const firstEngine = options.engines[0]; + if (!firstEngine) { + throw new Error('AgentChatService requires at least one engine'); + } + this.defaultEngineName = firstEngine.name; + } + } + + async handleAct(sessionId: string, payload: AgentActRequest): Promise<{ requestId: string }> { + const trimmed = payload.instruction?.trim(); + if (!trimmed) { + throw new Error('instruction is required'); + } + + const requestId = payload.requestId || randomUUID(); + let projectId = payload.projectId; + // Normalize empty string to undefined + const rawDbSessionId = + typeof payload.dbSessionId === 'string' ? payload.dbSessionId.trim() : ''; + const dbSessionId = rawDbSessionId || undefined; + + // Load session from database if dbSessionId is provided + let dbSession: AgentSession | undefined; + if (dbSessionId) { + dbSession = await getSession(dbSessionId); + if (!dbSession) { + throw new Error(`Session not found for id: ${dbSessionId}`); + } + // Validate project association + if (projectId && dbSession.projectId !== projectId) { + throw new Error(`Session ${dbSessionId} does not belong to project: ${projectId}`); + } + // Use session's project if not explicitly provided + if (!projectId) { + projectId = dbSession.projectId; + } + } + + // Project is required - workspace path must come from project system + if (!projectId) { + throw new Error('projectId is required. Please select or create a project first.'); + } + + const project = await getProject(projectId); + if (!project) { + throw new Error(`Project not found for id: ${projectId}`); + } + + const projectRoot = project.rootPath; + const projectPreferredCli = project.preferredCli as EngineName | undefined; + const projectSelectedModel = project.selectedModel; + const projectUseCcr = project.useCcr; + + // Legacy fallback: if caller does not use sessions table, use project-level resume id + let resumeClaudeSessionId: string | undefined; + if (!dbSessionId) { + resumeClaudeSessionId = project.activeClaudeSessionId; + } + + // Resolve engine name - session binding takes precedence + let engineName: EngineName; + if (dbSession) { + engineName = dbSession.engineName as EngineName; + // Validate cliPreference matches session engine + if (payload.cliPreference && payload.cliPreference !== engineName) { + throw new Error( + `cliPreference (${payload.cliPreference}) does not match session.engineName (${engineName})`, + ); + } + } else { + engineName = this.resolveEngineName( + payload.cliPreference as EngineName | undefined, + projectPreferredCli, + ); + } + + const engine = this.engines.get(engineName); + if (!engine) { + throw new Error(`No agent engine registered for ${engineName}`); + } + + // Model priority: request > session > project + const effectiveModel = payload.model?.trim() || dbSession?.model || projectSelectedModel; + + // For Claude engine with session, use session's engineSessionId for resume + if (dbSession && engineName === 'claude') { + resumeClaudeSessionId = dbSession.engineSessionId; + } + + const now = new Date().toISOString(); + const userMessageId = randomUUID(); + + // Process and persist image attachments + const savedAttachments: SavedAttachment[] = []; + let attachmentMetadata: AttachmentMetadata[] | undefined; + let resolvedImagePaths: string[] | undefined; + + if (projectId && payload.attachments && payload.attachments.length > 0) { + const imageAttachments = payload.attachments.filter((a) => a.type === 'image'); + + if (imageAttachments.length > 0) { + try { + console.error( + `[AgentChatService] Saving ${imageAttachments.length} image attachment(s) for project ${projectId}`, + ); + + for (let i = 0; i < imageAttachments.length; i++) { + const attachment = imageAttachments[i]; + const saved = await attachmentService.saveAttachment({ + projectId, + messageId: userMessageId, + attachment, + index: i, + }); + savedAttachments.push(saved); + } + + // Build metadata array for message persistence + attachmentMetadata = savedAttachments.map((s) => s.metadata); + // Build paths array for engine consumption + resolvedImagePaths = savedAttachments.map((s) => s.absolutePath); + + console.error( + `[AgentChatService] Saved ${savedAttachments.length} attachment(s): ${resolvedImagePaths.join(', ')}`, + ); + } catch (error) { + console.error('[AgentChatService] Failed to save attachments:', error); + // Continue without attachments - don't fail the entire request + } + } + } + + // Build metadata object for user message + // Include attachments, clientMeta, and displayText if present + let userMessageMetadata: Record | undefined; + const hasAttachments = attachmentMetadata && attachmentMetadata.length > 0; + const hasClientMeta = payload.clientMeta !== undefined; + const hasDisplayText = payload.displayText !== undefined; + + if (hasAttachments || hasClientMeta || hasDisplayText) { + userMessageMetadata = {}; + if (hasAttachments) { + userMessageMetadata.attachments = attachmentMetadata; + } + if (hasClientMeta) { + userMessageMetadata.clientMeta = payload.clientMeta; + } + if (hasDisplayText) { + userMessageMetadata.displayText = payload.displayText; + } + } + + // Emit a canonical user message into the stream so UI can render from server events only. + const userMessage: AgentMessage = { + id: userMessageId, + sessionId, + role: 'user', + content: trimmed, + messageType: 'chat', + cliSource: engineName, + requestId, + isStreaming: false, + isFinal: true, + createdAt: now, + metadata: userMessageMetadata, + }; + + this.streamManager.publish({ type: 'message', data: userMessage }); + + if (projectId) { + // Persist user message into project history for later reload. + try { + await touchProjectActivity(projectId); + // Update session activity timestamp so it appears at top of session list + if (dbSessionId) { + await touchSessionActivity(dbSessionId); + } + await persistAgentMessage({ + projectId, + role: 'user', + messageType: 'chat', + content: trimmed, + sessionId, + cliSource: engineName, + requestId, + id: userMessage.id, + createdAt: userMessage.createdAt, + metadata: userMessageMetadata, + }); + } catch (error) { + console.error('[AgentChatService] Failed to persist user message:', error); + } + } + + this.streamManager.publish({ + type: 'status', + data: { + sessionId, + status: 'starting', + requestId, + message: 'Agent request accepted', + }, + }); + + const ctx: EngineExecutionContext = { + emit: (event: RealtimeEvent) => { + this.streamManager.publish(event); + + if (!projectId) { + return; + } + + if (event.type === 'message') { + const msg = event.data; + if (!msg) return; + + // Only persist final snapshots; streaming deltas are transient. + if (msg.isStreaming && !msg.isFinal) { + return; + } + + // User messages are already handled above. + if (msg.role === 'user') { + return; + } + + const content = msg.content?.trim(); + if (!content) { + return; + } + + void persistAgentMessage({ + projectId, + role: msg.role, + messageType: msg.messageType, + content, + metadata: msg.metadata, + sessionId: msg.sessionId, + conversationId: undefined, + cliSource: msg.cliSource, + requestId: msg.requestId, + id: msg.id, + createdAt: msg.createdAt, + }).catch((error) => { + console.error('[AgentChatService] Failed to persist agent message:', error); + }); + } + }, + // Callback to persist Claude session ID when SDK returns system/init message + // Prefer session-level persistence over project-level + persistClaudeSessionId: dbSessionId + ? async (claudeSessionId: string) => { + await updateEngineSessionId(dbSessionId, claudeSessionId); + } + : projectId + ? async (claudeSessionId: string) => { + await updateProjectClaudeSessionId(projectId, claudeSessionId); + } + : undefined, + // Callback to persist management info from system:init message + // Only available when using session-level persistence + persistManagementInfo: dbSessionId + ? async (info) => { + await updateManagementInfo(dbSessionId, info); + } + : undefined, + }; + + const engineOptions: EngineInitOptions = { + sessionId, + instruction: trimmed, + model: effectiveModel, + projectRoot, + requestId, + // Pass original attachments (for fallback) and resolved paths (preferred) + attachments: payload.attachments, + resolvedImagePaths, + projectId, + dbSessionId, + // Session-level configuration for ClaudeEngine + permissionMode: dbSession?.permissionMode, + allowDangerouslySkipPermissions: dbSession?.allowDangerouslySkipPermissions, + systemPromptConfig: dbSession?.systemPromptConfig, + optionsConfig: dbSession?.optionsConfig, + // Pass Claude session ID for session resumption (ClaudeEngine only) + resumeClaudeSessionId: engineName === 'claude' ? resumeClaudeSessionId : undefined, + // Pass useCcr flag for Claude Code Router support (ClaudeEngine only) + useCcr: engineName === 'claude' ? projectUseCcr : undefined, + // Pass Codex-specific configuration (CodexEngine only) + codexConfig: engineName === 'codex' ? dbSession?.optionsConfig?.codexConfig : undefined, + }; + + // Create abort controller for cancellation support + const abortController = new AbortController(); + + // Register execution in the running executions registry + this.runningExecutions.set(requestId, { + requestId, + sessionId, + engineName, + abortController, + startedAt: new Date(), + }); + + // Fire-and-forget execution to keep HTTP handler fast. + void this.runEngine(engine, engineOptions, ctx, sessionId, requestId, abortController); + + return { requestId }; + } + + /** + * Cancel a running execution by requestId. + * Returns true if the execution was found and cancelled, false otherwise. + */ + cancelExecution(requestId: string): boolean { + const execution = this.runningExecutions.get(requestId); + if (!execution) { + return false; + } + + // Abort the execution + execution.abortController.abort(); + + // Emit cancelled status + this.streamManager.publish({ + type: 'status', + data: { + sessionId: execution.sessionId, + status: 'cancelled', + requestId, + message: 'Execution cancelled by user', + }, + }); + + // Remove from registry + this.runningExecutions.delete(requestId); + + return true; + } + + /** + * Cancel all running executions for a session. + * Returns the number of executions cancelled. + */ + cancelSessionExecutions(sessionId: string): number { + let cancelled = 0; + for (const [requestId, execution] of this.runningExecutions) { + if (execution.sessionId === sessionId) { + execution.abortController.abort(); + this.runningExecutions.delete(requestId); + cancelled++; + } + } + + if (cancelled > 0) { + this.streamManager.publish({ + type: 'status', + data: { + sessionId, + status: 'cancelled', + message: `Cancelled ${cancelled} running execution(s)`, + }, + }); + } + + return cancelled; + } + + /** + * Get list of running executions for diagnostics. + */ + getRunningExecutions(): RunningExecution[] { + return Array.from(this.runningExecutions.values()); + } + + private resolveEngineName(preference?: EngineName, projectPreferredCli?: EngineName): EngineName { + if (preference && this.engines.has(preference)) { + return preference; + } + if (projectPreferredCli && this.engines.has(projectPreferredCli)) { + return projectPreferredCli; + } + return this.defaultEngineName; + } + + private async runEngine( + engine: AgentEngine, + options: EngineInitOptions, + ctx: EngineExecutionContext, + sessionId: string, + requestId: string, + abortController: AbortController, + ): Promise { + try { + // Check if already aborted before starting + if (abortController.signal.aborted) { + return; + } + + this.streamManager.publish({ + type: 'status', + data: { + sessionId, + status: 'running', + requestId, + }, + }); + + // Pass abort signal to engine + const optionsWithSignal: EngineInitOptions = { + ...options, + signal: abortController.signal, + }; + + await engine.initializeAndRun(optionsWithSignal, ctx); + + // Only emit completed if not aborted + if (!abortController.signal.aborted) { + this.streamManager.publish({ + type: 'status', + data: { + sessionId, + status: 'completed', + requestId, + }, + }); + } + } catch (error) { + // Check if this was an abort error + if (abortController.signal.aborted) { + // Already handled by cancelExecution, just return + return; + } + + const message = error instanceof Error ? error.message : String(error); + + this.streamManager.publish({ + type: 'error', + error: message, + data: { sessionId, requestId }, + }); + + this.streamManager.publish({ + type: 'status', + data: { + sessionId, + status: 'error', + message, + requestId, + }, + }); + } finally { + // Always remove from running executions when done + this.runningExecutions.delete(requestId); + } + } + + /** + * Expose registered engines for UI and diagnostics. + */ + getEngineInfos(): Array<{ name: EngineName; supportsMcp?: boolean }> { + const result: Array<{ name: EngineName; supportsMcp?: boolean }> = []; + for (const engine of this.engines.values()) { + result.push({ + name: engine.name, + supportsMcp: engine.supportsMcp, + }); + } + return result; + } +} diff --git a/app/native-server/src/agent/db/client.ts b/app/native-server/src/agent/db/client.ts new file mode 100644 index 00000000..534eb1c1 --- /dev/null +++ b/app/native-server/src/agent/db/client.ts @@ -0,0 +1,232 @@ +/** + * Database client singleton for Agent storage. + * + * Design principles: + * - Lazy initialization - only connect when first accessed + * - Singleton pattern - single connection throughout the app lifecycle + * - Auto-create tables on first run (no migration tool needed) + * - Configurable path via environment variable + */ +import Database from 'better-sqlite3'; +import { drizzle, BetterSQLite3Database } from 'drizzle-orm/better-sqlite3'; +import { sql } from 'drizzle-orm'; +import * as schema from './schema'; +import { getAgentDataDir } from '../storage'; +import path from 'node:path'; +import { existsSync, mkdirSync } from 'node:fs'; + +// ============================================================ +// Types +// ============================================================ + +export type DrizzleDB = BetterSQLite3Database; + +// ============================================================ +// Singleton State +// ============================================================ + +let dbInstance: DrizzleDB | null = null; +let sqliteInstance: Database.Database | null = null; + +// ============================================================ +// Database Path Resolution +// ============================================================ + +/** + * Get the database file path. + * Environment: CHROME_MCP_AGENT_DB_FILE overrides the default path. + */ +export function getDatabasePath(): string { + const envPath = process.env.CHROME_MCP_AGENT_DB_FILE; + if (envPath && envPath.trim()) { + return path.resolve(envPath.trim()); + } + return path.join(getAgentDataDir(), 'agent.db'); +} + +// ============================================================ +// Schema Initialization SQL +// ============================================================ + +const CREATE_TABLES_SQL = ` +-- Projects table +CREATE TABLE IF NOT EXISTS projects ( + id TEXT PRIMARY KEY, + name TEXT NOT NULL, + description TEXT, + root_path TEXT NOT NULL, + preferred_cli TEXT, + selected_model TEXT, + active_claude_session_id TEXT, + created_at TEXT NOT NULL, + updated_at TEXT NOT NULL, + last_active_at TEXT +); + +CREATE INDEX IF NOT EXISTS projects_last_active_idx ON projects(last_active_at); + +-- Sessions table +CREATE TABLE IF NOT EXISTS sessions ( + id TEXT PRIMARY KEY, + project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE, + engine_name TEXT NOT NULL, + engine_session_id TEXT, + name TEXT, + model TEXT, + permission_mode TEXT NOT NULL DEFAULT 'bypassPermissions', + allow_dangerously_skip_permissions TEXT, + system_prompt_config TEXT, + options_config TEXT, + management_info TEXT, + created_at TEXT NOT NULL, + updated_at TEXT NOT NULL +); + +CREATE INDEX IF NOT EXISTS sessions_project_id_idx ON sessions(project_id); +CREATE INDEX IF NOT EXISTS sessions_engine_name_idx ON sessions(engine_name); + +-- Messages table +CREATE TABLE IF NOT EXISTS messages ( + id TEXT PRIMARY KEY, + project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE, + session_id TEXT NOT NULL, + conversation_id TEXT, + role TEXT NOT NULL, + content TEXT NOT NULL, + message_type TEXT NOT NULL, + metadata TEXT, + cli_source TEXT, + request_id TEXT, + created_at TEXT NOT NULL +); + +CREATE INDEX IF NOT EXISTS messages_project_id_idx ON messages(project_id); +CREATE INDEX IF NOT EXISTS messages_session_id_idx ON messages(session_id); +CREATE INDEX IF NOT EXISTS messages_created_at_idx ON messages(created_at); +CREATE INDEX IF NOT EXISTS messages_request_id_idx ON messages(request_id); + +-- Enable foreign key enforcement +PRAGMA foreign_keys = ON; +`; + +/** + * Migration SQL to add new columns to existing databases. + * Each migration is idempotent - safe to run multiple times. + */ +const MIGRATION_SQL = ` +-- Add active_claude_session_id column if it doesn't exist (for existing databases) +-- SQLite doesn't support IF NOT EXISTS for columns, so we use a workaround +`; + +// ============================================================ +// Database Initialization +// ============================================================ + +/** + * Check if a column exists in a table. + */ +function columnExists(sqlite: Database.Database, tableName: string, columnName: string): boolean { + const result = sqlite.prepare(`PRAGMA table_info(${tableName})`).all() as Array<{ name: string }>; + return result.some((col) => col.name === columnName); +} + +/** + * Run migrations for existing databases. + * Adds new columns that may be missing in older database versions. + */ +function runMigrations(sqlite: Database.Database): void { + // Migration 1: Add active_claude_session_id column to projects table + if (!columnExists(sqlite, 'projects', 'active_claude_session_id')) { + sqlite.exec('ALTER TABLE projects ADD COLUMN active_claude_session_id TEXT'); + } + + // Migration 2: Add use_ccr column to projects table + if (!columnExists(sqlite, 'projects', 'use_ccr')) { + sqlite.exec('ALTER TABLE projects ADD COLUMN use_ccr TEXT'); + } + + // Migration 3: Add enable_chrome_mcp column to projects table (default enabled) + if (!columnExists(sqlite, 'projects', 'enable_chrome_mcp')) { + sqlite.exec("ALTER TABLE projects ADD COLUMN enable_chrome_mcp TEXT NOT NULL DEFAULT '1'"); + } +} + +/** + * Initialize the database schema. + * Safe to call multiple times - uses IF NOT EXISTS. + * Also runs migrations for existing databases. + */ +function initializeSchema(sqlite: Database.Database): void { + sqlite.exec(CREATE_TABLES_SQL); + runMigrations(sqlite); +} + +/** + * Ensure the data directory exists. + */ +function ensureDataDir(): void { + const dataDir = getAgentDataDir(); + if (!existsSync(dataDir)) { + mkdirSync(dataDir, { recursive: true }); + } +} + +// ============================================================ +// Public API +// ============================================================ + +/** + * Get the Drizzle database instance. + * Lazily initializes the connection and schema on first call. + */ +export function getDb(): DrizzleDB { + if (dbInstance) { + return dbInstance; + } + + ensureDataDir(); + const dbPath = getDatabasePath(); + + // Create SQLite connection + sqliteInstance = new Database(dbPath); + + // Enable WAL mode for better concurrent read performance + sqliteInstance.pragma('journal_mode = WAL'); + + // Initialize schema + initializeSchema(sqliteInstance); + + // Create Drizzle instance + dbInstance = drizzle(sqliteInstance, { schema }); + + return dbInstance; +} + +/** + * Close the database connection. + * Should be called on graceful shutdown. + */ +export function closeDb(): void { + if (sqliteInstance) { + sqliteInstance.close(); + sqliteInstance = null; + dbInstance = null; + } +} + +/** + * Check if database is initialized. + */ +export function isDbInitialized(): boolean { + return dbInstance !== null; +} + +/** + * Execute raw SQL (for advanced use cases). + */ +export function execRawSql(sqlStr: string): void { + if (!sqliteInstance) { + getDb(); // Initialize if not already + } + sqliteInstance!.exec(sqlStr); +} diff --git a/app/native-server/src/agent/db/index.ts b/app/native-server/src/agent/db/index.ts new file mode 100644 index 00000000..c2818647 --- /dev/null +++ b/app/native-server/src/agent/db/index.ts @@ -0,0 +1,5 @@ +/** + * Database module exports. + */ +export * from './schema'; +export * from './client'; diff --git a/app/native-server/src/agent/db/schema.ts b/app/native-server/src/agent/db/schema.ts new file mode 100644 index 00000000..2df1a3e2 --- /dev/null +++ b/app/native-server/src/agent/db/schema.ts @@ -0,0 +1,146 @@ +/** + * Drizzle ORM Schema for Agent Storage. + * + * Design principles: + * - Type-safe database access + * - Consistent with shared types (AgentProject, AgentStoredMessage) + * - Proper indexes for common query patterns + * - Foreign key constraints with cascade delete + */ +import { sqliteTable, text, index } from 'drizzle-orm/sqlite-core'; + +// ============================================================ +// Projects Table +// ============================================================ + +export const projects = sqliteTable( + 'projects', + { + id: text().primaryKey(), + name: text().notNull(), + description: text(), + rootPath: text('root_path').notNull(), + preferredCli: text('preferred_cli'), + selectedModel: text('selected_model'), + /** + * Active Claude session ID (UUID format) for session resumption. + * Captured from SDK's system/init message. + */ + activeClaudeSessionId: text('active_claude_session_id'), + /** + * Whether to use Claude Code Router (CCR) for this project. + * Stored as '1' (true) or '0'/null (false). + */ + useCcr: text('use_ccr'), + /** + * Whether to enable the local Chrome MCP server integration for this project. + * Stored as '1' (true) or '0' (false). Default: '1' (enabled). + */ + enableChromeMcp: text('enable_chrome_mcp').notNull().default('1'), + createdAt: text('created_at').notNull(), + updatedAt: text('updated_at').notNull(), + lastActiveAt: text('last_active_at'), + }, + (table) => ({ + lastActiveIdx: index('projects_last_active_idx').on(table.lastActiveAt), + }), +); + +// ============================================================ +// Sessions Table +// ============================================================ + +export const sessions = sqliteTable( + 'sessions', + { + id: text().primaryKey(), + projectId: text('project_id') + .notNull() + .references(() => projects.id, { onDelete: 'cascade' }), + /** + * Engine name: claude, codex, cursor, qwen, glm, etc. + */ + engineName: text('engine_name').notNull(), + /** + * Engine-specific session ID for resumption. + * For Claude: SDK's session_id from system:init message. + */ + engineSessionId: text('engine_session_id'), + /** + * User-defined session name for display. + */ + name: text(), + /** + * Model override for this session. + */ + model: text(), + /** + * Permission mode: default, acceptEdits, bypassPermissions, plan, dontAsk. + */ + permissionMode: text('permission_mode').notNull().default('bypassPermissions'), + /** + * Whether to allow bypassing interactive permission prompts. + * Stored as '1' (true) or null (false). + */ + allowDangerouslySkipPermissions: text('allow_dangerously_skip_permissions'), + /** + * JSON: System prompt configuration. + * Format: { type: 'custom', text: string } | { type: 'preset', preset: 'claude_code', append?: string } + */ + systemPromptConfig: text('system_prompt_config'), + /** + * JSON: Engine/session option overrides (settingSources, tools, betas, etc.). + */ + optionsConfig: text('options_config'), + /** + * JSON: Cached management info (supported models, commands, account, MCP servers, etc.). + */ + managementInfo: text('management_info'), + createdAt: text('created_at').notNull(), + updatedAt: text('updated_at').notNull(), + }, + (table) => ({ + projectIdIdx: index('sessions_project_id_idx').on(table.projectId), + engineNameIdx: index('sessions_engine_name_idx').on(table.engineName), + }), +); + +// ============================================================ +// Messages Table +// ============================================================ + +export const messages = sqliteTable( + 'messages', + { + id: text().primaryKey(), + projectId: text('project_id') + .notNull() + .references(() => projects.id, { onDelete: 'cascade' }), + sessionId: text('session_id').notNull(), + conversationId: text('conversation_id'), + role: text().notNull(), // 'user' | 'assistant' | 'tool' | 'system' + content: text().notNull(), + messageType: text('message_type').notNull(), // 'chat' | 'tool_use' | 'tool_result' | 'status' + metadata: text(), // JSON string + cliSource: text('cli_source'), + requestId: text('request_id'), + createdAt: text('created_at').notNull(), + }, + (table) => ({ + projectIdIdx: index('messages_project_id_idx').on(table.projectId), + sessionIdIdx: index('messages_session_id_idx').on(table.sessionId), + createdAtIdx: index('messages_created_at_idx').on(table.createdAt), + requestIdIdx: index('messages_request_id_idx').on(table.requestId), + }), +); + +// ============================================================ +// Type Inference Helpers +// ============================================================ + +export type ProjectRow = typeof projects.$inferSelect; +export type ProjectInsert = typeof projects.$inferInsert; +export type SessionRow = typeof sessions.$inferSelect; +export type SessionInsert = typeof sessions.$inferInsert; +export type MessageRow = typeof messages.$inferSelect; +export type MessageInsert = typeof messages.$inferInsert; diff --git a/app/native-server/src/agent/directory-picker.ts b/app/native-server/src/agent/directory-picker.ts new file mode 100644 index 00000000..709e169b --- /dev/null +++ b/app/native-server/src/agent/directory-picker.ts @@ -0,0 +1,160 @@ +/** + * Directory Picker Service. + * + * Provides cross-platform directory selection using native system dialogs. + * Uses platform-specific commands: + * - macOS: osascript (AppleScript) + * - Windows: PowerShell + * - Linux: zenity or kdialog + */ +import { exec } from 'node:child_process'; +import { promisify } from 'node:util'; +import os from 'node:os'; + +const execAsync = promisify(exec); + +export interface DirectoryPickerResult { + success: boolean; + path?: string; + cancelled?: boolean; + error?: string; +} + +/** + * Open a native directory picker dialog. + * Returns the selected directory path or indicates cancellation. + */ +export async function openDirectoryPicker( + title = 'Select Project Directory', +): Promise { + const platform = os.platform(); + + try { + switch (platform) { + case 'darwin': + return await openMacOSPicker(title); + case 'win32': + return await openWindowsPicker(title); + case 'linux': + return await openLinuxPicker(title); + default: + return { + success: false, + error: `Unsupported platform: ${platform}`, + }; + } + } catch (error) { + return { + success: false, + error: error instanceof Error ? error.message : String(error), + }; + } +} + +/** + * macOS: Use osascript to open Finder folder picker. + */ +async function openMacOSPicker(title: string): Promise { + const script = ` + set selectedFolder to choose folder with prompt "${title}" + return POSIX path of selectedFolder + `; + + try { + const { stdout } = await execAsync(`osascript -e '${script}'`); + const path = stdout.trim(); + if (path) { + return { success: true, path }; + } + return { success: false, cancelled: true }; + } catch (error) { + // User cancelled returns error code 1 + const err = error as { code?: number; stderr?: string }; + if (err.code === 1) { + return { success: false, cancelled: true }; + } + throw error; + } +} + +/** + * Windows: Use PowerShell to open folder browser dialog. + */ +async function openWindowsPicker(title: string): Promise { + const psScript = ` + Add-Type -AssemblyName System.Windows.Forms + $dialog = New-Object System.Windows.Forms.FolderBrowserDialog + $dialog.Description = "${title}" + $dialog.ShowNewFolderButton = $true + $result = $dialog.ShowDialog() + if ($result -eq [System.Windows.Forms.DialogResult]::OK) { + Write-Output $dialog.SelectedPath + } + `; + + // Escape for command line + const escapedScript = psScript.replace(/"/g, '\\"').replace(/\n/g, ' '); + + try { + const { stdout } = await execAsync( + `powershell -NoProfile -Command "${escapedScript}"`, + { timeout: 60000 }, // 60 second timeout + ); + const path = stdout.trim(); + if (path) { + return { success: true, path }; + } + return { success: false, cancelled: true }; + } catch (error) { + const err = error as { killed?: boolean }; + if (err.killed) { + return { success: false, error: 'Dialog timed out' }; + } + throw error; + } +} + +/** + * Linux: Try zenity first, then kdialog as fallback. + */ +async function openLinuxPicker(title: string): Promise { + // Try zenity first (GTK) + try { + const { stdout } = await execAsync(`zenity --file-selection --directory --title="${title}"`, { + timeout: 60000, + }); + const path = stdout.trim(); + if (path) { + return { success: true, path }; + } + return { success: false, cancelled: true }; + } catch (zenityError) { + // zenity returns exit code 1 on cancel, 5 if not installed + const err = zenityError as { code?: number }; + if (err.code === 1) { + return { success: false, cancelled: true }; + } + + // Try kdialog as fallback (KDE) + try { + const { stdout } = await execAsync(`kdialog --getexistingdirectory ~ --title "${title}"`, { + timeout: 60000, + }); + const path = stdout.trim(); + if (path) { + return { success: true, path }; + } + return { success: false, cancelled: true }; + } catch (kdialogError) { + const kdErr = kdialogError as { code?: number }; + if (kdErr.code === 1) { + return { success: false, cancelled: true }; + } + + return { + success: false, + error: 'No directory picker available. Please install zenity or kdialog.', + }; + } + } +} diff --git a/app/native-server/src/agent/engines/claude.ts b/app/native-server/src/agent/engines/claude.ts new file mode 100644 index 00000000..b88cc779 --- /dev/null +++ b/app/native-server/src/agent/engines/claude.ts @@ -0,0 +1,1571 @@ +import { randomUUID } from 'node:crypto'; +import path from 'node:path'; +import type { AgentEngine, EngineExecutionContext, EngineInitOptions } from './types'; +import type { AgentMessage, RealtimeEvent } from '../types'; +import { detectCcr, validateCcrConfig } from '../ccr-detector'; +import { getProject } from '../project-service'; +import { getChromeMcpUrl } from '../../constant'; + +// Images are provided to Claude Code via local file paths referenced in the prompt text. +// Claude Code CLI reads images from local paths, so we write base64 images to temp files and reference them. + +/** + * Tool action type for categorizing tool operations. + */ +type ToolAction = 'Edited' | 'Created' | 'Read' | 'Deleted' | 'Generated' | 'Searched' | 'Executed'; + +/** + * Map of tool names to their corresponding actions. + */ +const TOOL_NAME_ACTION_MAP: Record = { + read: 'Read', + read_file: 'Read', + write: 'Created', + write_file: 'Created', + create_file: 'Created', + edit: 'Edited', + edit_file: 'Edited', + apply_patch: 'Edited', + patch_file: 'Edited', + remove_file: 'Deleted', + delete_file: 'Deleted', + list_files: 'Searched', + glob: 'Searched', + glob_files: 'Searched', + search_files: 'Searched', + grep: 'Searched', + bash: 'Executed', + run: 'Executed', + shell: 'Executed', + todo_write: 'Generated', + plan_write: 'Generated', +}; + +/** + * ClaudeEngine integrates the Claude Agent SDK as an AgentEngine implementation. + * + * This engine uses the @anthropic-ai/claude-agent-sdk to interact with Claude, + * streaming events back to the sidepanel UI via RealtimeEvent envelopes. + */ +export class ClaudeEngine implements AgentEngine { + public readonly name = 'claude' as const; + public readonly supportsMcp = true; + + /** + * Maximum number of stderr lines to keep in memory. + */ + private static readonly MAX_STDERR_LINES = 200; + + async initializeAndRun(options: EngineInitOptions, ctx: EngineExecutionContext): Promise { + const { + sessionId, + instruction, + model, + projectRoot, + requestId, + signal, + attachments, + resolvedImagePaths, + projectId, + permissionMode, + allowDangerouslySkipPermissions, + systemPromptConfig, + optionsConfig, + resumeClaudeSessionId, + useCcr, + } = options; + const repoPath = this.resolveRepoPath(projectRoot); + + // Check if already aborted + if (signal?.aborted) { + throw new Error('ClaudeEngine: execution was cancelled'); + } + + const normalizedInstruction = instruction.trim(); + if (!normalizedInstruction) { + throw new Error('ClaudeEngine: instruction must not be empty'); + } + + // Dynamically import the Claude Agent SDK + // Images are passed via temp file paths appended to the prompt string + let query: (args: { prompt: string; options?: Record }) => AsyncIterable; + try { + // Dynamic import to avoid hard dependency - install @anthropic-ai/claude-agent-sdk to use this engine + // Use string variable to bypass TypeScript module resolution + const sdkModuleName = '@anthropic-ai/claude-agent-sdk'; + + const sdk = await (Function( + 'moduleName', + 'return import(moduleName)', + )(sdkModuleName) as Promise); + query = sdk.query; + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + throw new Error( + `ClaudeEngine: Failed to load Claude Agent SDK. Please install @anthropic-ai/claude-agent-sdk. Error: ${message}`, + ); + } + + // Resolve model + const resolvedModel = + model?.trim() || process.env.CLAUDE_DEFAULT_MODEL || 'claude-sonnet-4-20250514'; + + // State management + const stderrBuffer: string[] = []; + let assistantBuffer = ''; + let assistantMessageId: string | null = null; + let assistantCreatedAt: string | null = null; + let lastAssistantEmitted: { content: string; isFinal: boolean } | null = null; + const streamedToolHashes = new Set(); + + // Tool input accumulation for streaming tool_use blocks + // Key: content block index, Value: { toolName, toolId, inputJson } + const pendingToolInputs = new Map< + number, + { toolName: string; toolId: string; inputJsonParts: string[] } + >(); + let currentContentBlockIndex = -1; + + /** + * Emit assistant message to the stream. + * Includes deduplication to prevent multiple identical final emissions. + */ + const emitAssistant = (isFinal: boolean): void => { + const content = assistantBuffer.trim(); + if (!content) return; + + // Deduplicate: skip if same content and isFinal state was already emitted + if ( + lastAssistantEmitted && + lastAssistantEmitted.content === content && + lastAssistantEmitted.isFinal === isFinal + ) { + return; + } + lastAssistantEmitted = { content, isFinal }; + + if (!assistantMessageId) { + assistantMessageId = randomUUID(); + } + if (!assistantCreatedAt) { + assistantCreatedAt = new Date().toISOString(); + } + + const message: AgentMessage = { + id: assistantMessageId, + sessionId, + role: 'assistant', + content, + messageType: 'chat', + cliSource: this.name, + requestId, + isStreaming: !isFinal, + isFinal, + createdAt: assistantCreatedAt, + }; + + ctx.emit({ type: 'message', data: message }); + }; + + /** + * Emit tool message with deduplication. + */ + const dispatchToolMessage = ( + content: string, + metadata: Record, + messageType: 'tool_use' | 'tool_result', + isStreaming: boolean, + ): void => { + const trimmed = content.trim(); + if (!trimmed) return; + + const hash = this.encodeHash( + `${messageType}:${trimmed}:${JSON.stringify(metadata)}:${sessionId}:${requestId || ''}`, + ).slice(0, 16); + if (streamedToolHashes.has(hash)) return; + streamedToolHashes.add(hash); + + const message: AgentMessage = { + id: randomUUID(), + sessionId, + role: 'tool', + content: trimmed, + messageType, + cliSource: this.name, + requestId, + isStreaming, + isFinal: !isStreaming, + createdAt: new Date().toISOString(), + metadata: { cli_type: 'claude', ...metadata }, + }; + + ctx.emit({ type: 'message', data: message }); + }; + + /** + * Infer tool action from tool name. + */ + const inferActionFromToolName = (toolName: unknown): ToolAction | undefined => { + if (typeof toolName !== 'string') return undefined; + const normalized = toolName.trim().toLowerCase(); + if (!normalized) return undefined; + + if (TOOL_NAME_ACTION_MAP[normalized]) { + return TOOL_NAME_ACTION_MAP[normalized]; + } + + // Try suffix after colon (e.g., "mcp__server__tool" -> "tool") + const suffix = normalized.split(':').pop() ?? normalized; + if (suffix && TOOL_NAME_ACTION_MAP[suffix]) { + return TOOL_NAME_ACTION_MAP[suffix]; + } + + // Infer from name patterns + if ( + normalized.includes('edit') || + normalized.includes('modify') || + normalized.includes('patch') + ) { + return 'Edited'; + } + if (normalized.includes('write') || normalized.includes('create')) { + return 'Created'; + } + if (normalized.includes('read') || normalized.includes('view')) { + return 'Read'; + } + if (normalized.includes('delete') || normalized.includes('remove')) { + return 'Deleted'; + } + if ( + normalized.includes('search') || + normalized.includes('find') || + normalized.includes('glob') || + normalized.includes('grep') + ) { + return 'Searched'; + } + if ( + normalized.includes('bash') || + normalized.includes('shell') || + normalized.includes('exec') + ) { + return 'Executed'; + } + if (normalized.includes('todo') || normalized.includes('plan')) { + return 'Generated'; + } + + return undefined; + }; + + /** + * Build tool metadata from content block with detailed tool-specific information. + */ + const buildToolMetadata = (contentBlock: Record): Record => { + const toolName = this.pickFirstString(contentBlock.name) || 'unknown'; + const toolId = this.pickFirstString(contentBlock.id); + const input = contentBlock.input as Record | undefined; + const action = inferActionFromToolName(toolName); + + const metadata: Record = { + toolName, + tool_name: toolName, + toolId, + action, + }; + + if (!input) { + return metadata; + } + + // Extract tool-specific details + const normalizedName = toolName.toLowerCase(); + + // File operations (read, write, edit) + if (typeof input.file_path === 'string') { + metadata.filePath = input.file_path; + } + + // Edit tool - extract diff information + if ( + normalizedName.includes('edit') || + normalizedName === 'apply_patch' || + normalizedName === 'patch_file' + ) { + if (typeof input.old_string === 'string') { + metadata.oldString = input.old_string; + metadata.deletedLines = input.old_string.split('\n').length; + } + if (typeof input.new_string === 'string') { + metadata.newString = input.new_string; + metadata.addedLines = input.new_string.split('\n').length; + } + if (typeof input.replace_all === 'boolean') { + metadata.replaceAll = input.replace_all; + } + } + + // Write tool - content preview + if (normalizedName.includes('write') || normalizedName === 'create_file') { + if (typeof input.content === 'string') { + metadata.contentPreview = input.content.slice(0, 200); + metadata.totalLines = input.content.split('\n').length; + } + } + + // Read tool - offset/limit + if (normalizedName.includes('read')) { + if (typeof input.offset === 'number') metadata.offset = input.offset; + if (typeof input.limit === 'number') metadata.limit = input.limit; + } + + // Bash/shell - command + if ( + normalizedName === 'bash' || + normalizedName.includes('shell') || + normalizedName === 'run' + ) { + if (typeof input.command === 'string') { + metadata.command = input.command; + } + if (typeof input.description === 'string') { + metadata.commandDescription = input.description; + } + } + + // Search tools (grep, glob) + if (normalizedName === 'grep' || normalizedName.includes('search')) { + if (typeof input.pattern === 'string') metadata.pattern = input.pattern; + if (typeof input.path === 'string') metadata.searchPath = input.path; + if (typeof input.glob === 'string') metadata.glob = input.glob; + if (typeof input.output_mode === 'string') metadata.outputMode = input.output_mode; + } + + if (normalizedName === 'glob' || normalizedName === 'glob_files') { + if (typeof input.pattern === 'string') metadata.pattern = input.pattern; + if (typeof input.path === 'string') metadata.searchPath = input.path; + } + + // TodoWrite + if (normalizedName === 'todo_write' || normalizedName === 'todowrite') { + if (Array.isArray(input.todos)) { + metadata.todoCount = input.todos.length; + metadata.todos = input.todos; + } + } + + // Store raw input for debugging (truncated) + metadata.rawInput = JSON.stringify(input).slice(0, 1000); + + return metadata; + }; + + // State for temp file cleanup + const tempFiles: string[] = []; + const cleanupTempFiles = async (): Promise => { + if (tempFiles.length === 0) return; + + try { + const fs = await import('node:fs/promises'); + for (const filePath of tempFiles) { + try { + await fs.unlink(filePath); + console.error(`[ClaudeEngine] Cleaned up temp file: ${filePath}`); + } catch (err) { + // Best-effort cleanup; ignore failures (file may already be deleted) + console.error(`[ClaudeEngine] Failed to cleanup temp file ${filePath}:`, err); + } + } + } catch (err) { + console.error('[ClaudeEngine] Failed to cleanup temp files:', err); + } + }; + + // Build prompt instruction (may be modified if images are attached) + let promptInstruction = normalizedInstruction; + + try { + // Use console.error for logging to avoid polluting stdout (Native Messaging protocol) + console.error(`[ClaudeEngine] Starting query with model: ${resolvedModel}`); + console.error(`[ClaudeEngine] Working directory: ${repoPath}`); + + // Check for image attachments - prefer resolvedImagePaths (persisted), fallback to temp files + const hasResolvedPaths = resolvedImagePaths && resolvedImagePaths.length > 0; + const imageAttachments = (attachments ?? []).filter((a) => a.type === 'image'); + const hasImages = hasResolvedPaths || imageAttachments.length > 0; + + if (hasImages) { + // Strip any legacy "Image #N path:" lines to avoid duplicating references + const instructionWithoutLegacyPaths = normalizedInstruction + .replace(/\n*Image #\d+ path: [^\n]+/g, '') + .trim(); + + const imageLines: string[] = []; + + if (hasResolvedPaths) { + // Use pre-resolved persistent paths (preferred - no temp files needed) + console.error( + `[ClaudeEngine] Using ${resolvedImagePaths.length} pre-resolved image path(s)`, + ); + for (let index = 0; index < resolvedImagePaths.length; index++) { + imageLines.push(`Image #${index + 1} path: ${resolvedImagePaths[index]}`); + } + } else { + // Fallback: write base64 to temp files (legacy behavior) + console.error( + `[ClaudeEngine] Writing ${imageAttachments.length} image attachment(s) to temp files (fallback)`, + ); + for (let index = 0; index < imageAttachments.length; index++) { + const attachment = imageAttachments[index]; + const tempFilePath = await this.writeAttachmentToTemp(attachment); + tempFiles.push(tempFilePath); + imageLines.push(`Image #${index + 1} path: ${tempFilePath}`); + } + } + + // Build final instruction with image paths appended + promptInstruction = [instructionWithoutLegacyPaths, imageLines.join('\n')] + .filter((segment) => segment && segment.trim().length > 0) + .join('\n\n') + .trim(); + + console.error( + `[ClaudeEngine] Prompt with image paths: ${promptInstruction.slice(0, 200)}...`, + ); + } + + // Start Claude Agent SDK query + // Session resumption: if resumeClaudeSessionId is provided (from sessions.engineSessionId or legacy project), + // pass it as 'resume' to continue a previous Claude conversation. + // If not provided, SDK will create a new session. + + // Build environment for Claude Code Router support + // SDK treats options.env as a complete replacement, so we must merge with process.env + // Reference: https://github.com/musistudio/claude-code-router/issues/855 + const claudeEnv = await this.buildClaudeEnv(useCcr); + + // Validate CCR configuration and emit friendly warning before calling into CCR + // This prevents users from seeing cryptic "includes of undefined" errors + if (useCcr) { + await this.validateAndWarnCcrConfig(sessionId, requestId, ctx); + } + + // Resolve permission mode from session config or use default + // SDK default is 'default', but AgentChat defaults to 'bypassPermissions' for headless operation + const allowedPermissionModes = new Set([ + 'default', + 'acceptEdits', + 'bypassPermissions', + 'plan', + 'dontAsk', + ]); + const normalizedPermissionMode = + typeof permissionMode === 'string' ? permissionMode.trim() : ''; + + let resolvedPermissionMode: string; + if (normalizedPermissionMode === '') { + // No permission mode specified - use AgentChat default for headless operation + resolvedPermissionMode = 'bypassPermissions'; + } else if (allowedPermissionModes.has(normalizedPermissionMode)) { + // Valid permission mode - use as specified + resolvedPermissionMode = normalizedPermissionMode; + } else { + // Invalid permission mode - fall back to SDK default and warn + console.error( + `[ClaudeEngine] Invalid permissionMode "${normalizedPermissionMode}", falling back to SDK default "default"`, + ); + resolvedPermissionMode = 'default'; + } + + // allowDangerouslySkipPermissions must be true when using bypassPermissions mode + // SDK requirement: bypass mode requires explicit acknowledgment via allowDangerouslySkipPermissions=true + const resolvedAllowDangerouslySkipPermissions = (() => { + const explicitValue = + typeof allowDangerouslySkipPermissions === 'boolean' + ? allowDangerouslySkipPermissions + : undefined; + + if (resolvedPermissionMode === 'bypassPermissions') { + // Force true for bypassPermissions mode - SDK requirement + if (explicitValue === false) { + console.error( + '[ClaudeEngine] Warning: allowDangerouslySkipPermissions=false is incompatible with bypassPermissions mode, forcing to true', + ); + } + return true; + } + + // For non-bypass modes, use explicit value or default to false + return explicitValue ?? false; + })(); + + // Parse optionsConfig for additional SDK options + const optionsRecord = + optionsConfig && typeof optionsConfig === 'object' && !Array.isArray(optionsConfig) + ? (optionsConfig as Record) + : undefined; + + // Resolve project-scoped Chrome MCP toggle (default: enabled) + const enableChromeMcp = await (async (): Promise => { + if (!projectId) return true; + try { + const project = await getProject(projectId); + return project?.enableChromeMcp !== false; + } catch (err) { + const message = err instanceof Error ? err.message : String(err); + console.error( + `[ClaudeEngine] Failed to load project enableChromeMcp, defaulting to enabled: ${message}`, + ); + return true; + } + })(); + + // Resolve setting sources + // SDK isolation mode: settingSources=[] prevents loading any filesystem settings + // Default behavior: include 'project' to load CLAUDE.md + const resolvedSettingSources = (() => { + const allowedSettingSources = new Set(['user', 'project', 'local']); + const raw = optionsRecord?.settingSources; + + // Check for explicit isolation mode (empty array) + if (Array.isArray(raw) && raw.length === 0) { + console.error('[ClaudeEngine] Isolation mode enabled: settingSources=[]'); + return []; + } + + // Parse provided sources + if (Array.isArray(raw)) { + const sources: string[] = []; + for (const entry of raw) { + if (typeof entry === 'string' && allowedSettingSources.has(entry)) { + sources.push(entry); + } + } + // If valid sources were provided, use them as-is (trust user config) + if (sources.length > 0) { + return sources; + } + } + + // Default: include 'project' to load CLAUDE.md + return ['project']; + })(); + + // Resolve system prompt from session config + const resolvedSystemPrompt = (() => { + if (typeof systemPromptConfig === 'string') { + const trimmed = systemPromptConfig.trim(); + return trimmed.length > 0 ? trimmed : undefined; + } + if ( + !systemPromptConfig || + typeof systemPromptConfig !== 'object' || + Array.isArray(systemPromptConfig) + ) { + return undefined; + } + const record = systemPromptConfig as Record; + const type = record.type; + if (type === 'custom' && typeof record.text === 'string') { + const trimmed = record.text.trim(); + return trimmed.length > 0 ? trimmed : undefined; + } + if (type === 'preset' && record.preset === 'claude_code') { + // Trim append and ignore empty strings to avoid "append is empty but object is passed" edge case + const rawAppend = typeof record.append === 'string' ? record.append.trim() : ''; + const append = rawAppend.length > 0 ? rawAppend : undefined; + return append + ? { type: 'preset' as const, preset: 'claude_code' as const, append } + : { type: 'preset' as const, preset: 'claude_code' as const }; + } + return undefined; + })(); + + // Create internal AbortController that mirrors the external signal + // SDK expects abortController option, not raw AbortSignal + const internalAbortController = new AbortController(); + if (signal) { + // Propagate external abort to internal controller + if (signal.aborted) { + internalAbortController.abort(); + } else { + signal.addEventListener( + 'abort', + () => { + internalAbortController.abort(); + }, + { once: true }, + ); + } + } + + const queryOptions: Record = { + cwd: repoPath, + additionalDirectories: [repoPath], + model: resolvedModel, + // Permission settings are session-configurable (defaults preserve previous behavior) + permissionMode: resolvedPermissionMode, + allowDangerouslySkipPermissions: resolvedAllowDangerouslySkipPermissions, + // Enable streaming: emit stream_event with content_block_delta for real-time UI updates + // Without this, SDK only outputs aggregated assistant/result messages + includePartialMessages: true, + // Load CLAUDE.md / .claude/settings.json from the project root + settingSources: resolvedSettingSources, + // Custom system prompt if provided + systemPrompt: resolvedSystemPrompt, + // AbortController for cancellation support - SDK uses this to terminate underlying processes + abortController: internalAbortController, + // Pass merged env to support Claude Code Router (CCR) + // This allows users to set ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN via: + // 1. eval "$(ccr activate)" before launching Chrome + // 2. Or setting env vars in shell profile + env: claudeEnv, + stderr: (data: string) => { + const line = String(data).trimEnd(); + if (!line) return; + if (stderrBuffer.length > ClaudeEngine.MAX_STDERR_LINES) { + stderrBuffer.shift(); + } + stderrBuffer.push(line); + console.error(`[ClaudeEngine][stderr] ${line}`); + }, + }; + + // Apply additional SDK options from optionsConfig + if (optionsRecord) { + const isStringArray = (value: unknown): value is string[] => + Array.isArray(value) && value.every((v) => typeof v === 'string'); + + if (isStringArray(optionsRecord.allowedTools)) { + queryOptions.allowedTools = optionsRecord.allowedTools; + } + if (isStringArray(optionsRecord.disallowedTools)) { + queryOptions.disallowedTools = optionsRecord.disallowedTools; + } + + const tools = optionsRecord.tools; + if (isStringArray(tools)) { + queryOptions.tools = tools; + } else if (tools && typeof tools === 'object' && !Array.isArray(tools)) { + const toolsRecord = tools as Record; + if (toolsRecord.type === 'preset' && toolsRecord.preset === 'claude_code') { + queryOptions.tools = { type: 'preset', preset: 'claude_code' }; + } + } + + if (isStringArray(optionsRecord.betas)) { + queryOptions.betas = optionsRecord.betas; + } + + if ( + typeof optionsRecord.maxThinkingTokens === 'number' && + Number.isFinite(optionsRecord.maxThinkingTokens) + ) { + queryOptions.maxThinkingTokens = optionsRecord.maxThinkingTokens; + } + if (typeof optionsRecord.maxTurns === 'number' && Number.isFinite(optionsRecord.maxTurns)) { + queryOptions.maxTurns = optionsRecord.maxTurns; + } + if ( + typeof optionsRecord.maxBudgetUsd === 'number' && + Number.isFinite(optionsRecord.maxBudgetUsd) + ) { + queryOptions.maxBudgetUsd = optionsRecord.maxBudgetUsd; + } + + if ( + optionsRecord.mcpServers && + typeof optionsRecord.mcpServers === 'object' && + !Array.isArray(optionsRecord.mcpServers) + ) { + queryOptions.mcpServers = optionsRecord.mcpServers; + } + if ( + optionsRecord.outputFormat && + typeof optionsRecord.outputFormat === 'object' && + !Array.isArray(optionsRecord.outputFormat) + ) { + queryOptions.outputFormat = optionsRecord.outputFormat; + } + if (typeof optionsRecord.enableFileCheckpointing === 'boolean') { + queryOptions.enableFileCheckpointing = optionsRecord.enableFileCheckpointing; + } + if ( + optionsRecord.sandbox && + typeof optionsRecord.sandbox === 'object' && + !Array.isArray(optionsRecord.sandbox) + ) { + queryOptions.sandbox = optionsRecord.sandbox; + } + + // Merge session-level env overrides with base claudeEnv + // Session env takes precedence over process env (useful for per-session API keys, etc.) + if ( + optionsRecord.env && + typeof optionsRecord.env === 'object' && + !Array.isArray(optionsRecord.env) + ) { + const sessionEnv = optionsRecord.env as Record; + const mergedEnv = { ...claudeEnv }; + for (const [key, value] of Object.entries(sessionEnv)) { + if (typeof value === 'string') { + mergedEnv[key] = value; + } + } + // Ensure Node.js bin directory is still in PATH after merge + // Session may have overwritten PATH, which would break child processes + const nodeBinDir = path.dirname(process.execPath); + const mergedPath = mergedEnv.PATH || mergedEnv.Path || ''; + if (!mergedPath.includes(nodeBinDir)) { + mergedEnv.PATH = [nodeBinDir, mergedPath].filter(Boolean).join(path.delimiter); + } + queryOptions.env = mergedEnv; + } + } + + // Inject the local Chrome MCP server based on project preference. + // This only controls the built-in "chrome-mcp" entry; user-configured MCP servers remain untouched. + const CHROME_MCP_SERVER_NAME = 'chrome-mcp'; + if (enableChromeMcp) { + const existingMcpServers = + queryOptions.mcpServers && + typeof queryOptions.mcpServers === 'object' && + !Array.isArray(queryOptions.mcpServers) + ? (queryOptions.mcpServers as Record) + : {}; + + queryOptions.mcpServers = { + ...existingMcpServers, + [CHROME_MCP_SERVER_NAME]: { + type: 'http', + url: getChromeMcpUrl(), + }, + }; + console.error(`[ClaudeEngine] Chrome MCP server enabled: ${getChromeMcpUrl()}`); + } else if ( + queryOptions.mcpServers && + typeof queryOptions.mcpServers === 'object' && + !Array.isArray(queryOptions.mcpServers) + ) { + // If Chrome MCP is disabled, remove it from existing mcpServers if present + const existing = queryOptions.mcpServers as Record; + if (CHROME_MCP_SERVER_NAME in existing) { + const { [CHROME_MCP_SERVER_NAME]: _removed, ...rest } = existing; + if (Object.keys(rest).length > 0) { + queryOptions.mcpServers = rest; + } else { + delete (queryOptions as Record).mcpServers; + } + } + console.error('[ClaudeEngine] Chrome MCP server disabled'); + } + + // Add resume option if we have a valid Claude session ID + if (resumeClaudeSessionId) { + queryOptions.resume = resumeClaudeSessionId; + console.error(`[ClaudeEngine] Resuming Claude session: ${resumeClaudeSessionId}`); + } + + const response = query({ + prompt: promptInstruction, + options: queryOptions, + }); + + // Process streaming response + for await (const message of response) { + // Check for cancellation before processing each message + if (signal?.aborted) { + console.error('[ClaudeEngine] Execution cancelled via abort signal'); + throw new Error('ClaudeEngine: execution was cancelled'); + } + + console.error('[ClaudeEngine] Message type:', message.type); + + if (message.type === 'stream_event') { + const event = (message as unknown as { event?: Record }).event ?? {}; + const eventType = this.pickFirstString(event.type); + + switch (eventType) { + case 'message_start': { + // Reset assistant state for new message + assistantBuffer = ''; + assistantMessageId = randomUUID(); + assistantCreatedAt = new Date().toISOString(); + lastAssistantEmitted = null; + break; + } + + case 'content_block_start': { + const contentBlock = event.content_block as Record | undefined; + const blockIndex = + typeof event.index === 'number' ? event.index : ++currentContentBlockIndex; + currentContentBlockIndex = blockIndex; + + if (contentBlock && contentBlock.type === 'tool_use') { + const toolName = this.pickFirstString(contentBlock.name) || 'tool'; + const toolId = this.pickFirstString(contentBlock.id) || ''; + + // Store pending tool input for accumulation + // Don't emit message here - wait for content_block_stop with complete input + pendingToolInputs.set(blockIndex, { + toolName, + toolId, + inputJsonParts: [], + }); + } else if (contentBlock && contentBlock.type === 'tool_result') { + // Handle tool_result in content_block_start + const metadata = this.buildToolResultMetadata(contentBlock); + const content = this.extractToolResultContent(contentBlock); + const isError = contentBlock.is_error === true; + + dispatchToolMessage( + isError + ? `Error: ${content || 'Tool execution failed'}` + : content || 'Tool completed', + metadata, + 'tool_result', + false, + ); + } + break; + } + + case 'content_block_stop': { + const blockIndex = + typeof event.index === 'number' ? event.index : currentContentBlockIndex; + + // Check if we have accumulated tool input for this block + if (pendingToolInputs.has(blockIndex)) { + const pending = pendingToolInputs.get(blockIndex)!; + pendingToolInputs.delete(blockIndex); + + // Parse the accumulated JSON + const fullJsonStr = pending.inputJsonParts.join(''); + let input: Record = {}; + try { + if (fullJsonStr) { + input = JSON.parse(fullJsonStr); + } + } catch (e) { + console.error(`[ClaudeEngine] Failed to parse tool input JSON: ${e}`); + } + + console.error( + `[ClaudeEngine] content_block_stop - toolName: ${pending.toolName}, input: ${JSON.stringify(input).slice(0, 500)}`, + ); + + // Build metadata with full input + const metadata = buildToolMetadata({ + name: pending.toolName, + id: pending.toolId, + input, + }); + + // Build informative content + let content = `Using tool: ${pending.toolName}`; + if (input.command) content = `Running: ${input.command}`; + else if (input.file_path) content = `Operating on: ${input.file_path}`; + else if (input.pattern) content = `Searching: ${input.pattern}`; + else if (input.query) content = `Searching: ${input.query}`; + + // Emit final tool_use message with complete metadata + dispatchToolMessage(content, metadata, 'tool_use', false); + } + + // Check if this block was a tool_result + const contentBlock = event.content_block as Record | undefined; + if (contentBlock && contentBlock.type === 'tool_result') { + const metadata = this.buildToolResultMetadata(contentBlock); + const content = this.extractToolResultContent(contentBlock); + const isError = contentBlock.is_error === true; + + dispatchToolMessage( + isError + ? `Error: ${content || 'Tool execution failed'}` + : content || 'Tool completed', + metadata, + 'tool_result', + false, + ); + } + break; + } + + case 'content_block_delta': { + const delta = event.delta as Record | string | undefined; + const blockIndex = + typeof event.index === 'number' ? event.index : currentContentBlockIndex; + + // Check if this is a tool_use input_json_delta + if (delta && typeof delta === 'object' && delta.type === 'input_json_delta') { + const partialJson = delta.partial_json as string | undefined; + if (partialJson && pendingToolInputs.has(blockIndex)) { + pendingToolInputs.get(blockIndex)!.inputJsonParts.push(partialJson); + } + break; + } + + // Handle text delta for assistant messages + let textChunk = ''; + + if (typeof delta === 'string') { + textChunk = delta; + } else if (delta && typeof delta === 'object') { + if (typeof delta.text === 'string') { + textChunk = delta.text; + } else if (typeof delta.delta === 'string') { + textChunk = delta.delta; + } else if (typeof delta.partial === 'string') { + textChunk = delta.partial; + } + } + + if (textChunk) { + assistantBuffer += textChunk; + emitAssistant(false); + } + break; + } + + case 'message_delta': { + // message_delta usually contains metadata only (stop_reason, usage) + // Don't emit final here to avoid duplicate finals + break; + } + + case 'message_stop': { + // Emit final assistant message only on message_stop + emitAssistant(true); + break; + } + + default: + // Other stream events are ignored + break; + } + } else if (message.type === 'assistant') { + // Fallback for non-streaming assistant messages + const content = this.extractMessageContent(message); + if (content) { + assistantBuffer = content; + emitAssistant(true); + } + } else if (message.type === 'result') { + // Final result - check for errors first + const resultRecord = message as unknown as Record; + + // Log full result for debugging + console.error(`[ClaudeEngine] Result message: ${JSON.stringify(resultRecord, null, 2)}`); + + // Extract and emit usage statistics + const usage = resultRecord.usage as Record | undefined; + const totalCostUsd = + typeof resultRecord.total_cost_usd === 'number' ? resultRecord.total_cost_usd : 0; + const durationMs = + typeof resultRecord.duration_ms === 'number' ? resultRecord.duration_ms : 0; + const numTurns = typeof resultRecord.num_turns === 'number' ? resultRecord.num_turns : 0; + + if (usage || totalCostUsd > 0) { + ctx.emit({ + type: 'usage', + data: { + sessionId, + requestId, + inputTokens: typeof usage?.input_tokens === 'number' ? usage.input_tokens : 0, + outputTokens: typeof usage?.output_tokens === 'number' ? usage.output_tokens : 0, + cacheReadInputTokens: + typeof usage?.cache_read_input_tokens === 'number' + ? usage.cache_read_input_tokens + : undefined, + cacheCreationInputTokens: + typeof usage?.cache_creation_input_tokens === 'number' + ? usage.cache_creation_input_tokens + : undefined, + totalCostUsd, + durationMs, + numTurns, + }, + }); + } + + // Check if result contains errors (SDK puts error details here) + // Note: is_error can be true even with empty errors array + if (resultRecord.is_error) { + const errors = resultRecord.errors as string[] | undefined; + const resultText = resultRecord.result as string | undefined; + const errorMsg = errors?.length + ? errors.join('; ') + : resultText || 'Unknown error from Claude Code'; + console.error(`[ClaudeEngine] Result error: ${errorMsg}`); + + // Check if this is a resume failure + const isResumeFailure = + errorMsg.includes('No conversation found') || + errorMsg.includes('Failed to resume session') || + errorMsg.includes('session ID'); + + if (isResumeFailure && resumeClaudeSessionId) { + // Clear the stored session ID so next request starts fresh + if (ctx.persistClaudeSessionId && projectId) { + try { + // Pass empty string to clear the session + await ctx.persistClaudeSessionId(''); + console.error('[ClaudeEngine] Cleared invalid session ID'); + } catch { + // Ignore clear errors + } + } + throw new Error( + `Resume failed: ${errorMsg}. Session has been cleared - please retry.`, + ); + } + + throw new Error(errorMsg); + } + + // Extract content from successful result + const resultContent = this.extractMessageContent(message); + if (resultContent && resultContent !== assistantBuffer.trim()) { + assistantBuffer = resultContent; + emitAssistant(true); + } + } else if (message.type === 'system') { + // Handle system messages + const record = message as unknown as Record; + const subtype = this.pickFirstString(record.subtype); + + if (subtype === 'init') { + // system:init - contains session_id and management information + const claudeSessionId = record.session_id ? String(record.session_id) : undefined; + + if (claudeSessionId) { + console.error(`[ClaudeEngine] Session initialized: ${claudeSessionId}`); + + // Persist the session ID if callback is provided and projectId exists + if (ctx.persistClaudeSessionId && projectId) { + try { + await ctx.persistClaudeSessionId(claudeSessionId); + console.error(`[ClaudeEngine] Session ID persisted for project: ${projectId}`); + } catch (persistError) { + console.error('[ClaudeEngine] Failed to persist session ID:', persistError); + } + } + } + + // Extract and persist management information + if (ctx.persistManagementInfo) { + try { + const managementInfo = { + tools: Array.isArray(record.tools) + ? record.tools.filter((t): t is string => typeof t === 'string') + : undefined, + agents: Array.isArray(record.agents) + ? record.agents.filter((a): a is string => typeof a === 'string') + : undefined, + // SDK returns plugins as { name, path }[] objects + plugins: Array.isArray(record.plugins) + ? (record.plugins as Array<{ name?: string; path?: string }>) + .filter((p) => p && typeof p.name === 'string') + .map((p) => ({ + name: String(p.name), + path: p.path ? String(p.path) : undefined, + })) + : undefined, + skills: Array.isArray(record.skills) + ? record.skills.filter((s): s is string => typeof s === 'string') + : undefined, + mcpServers: Array.isArray(record.mcp_servers) + ? (record.mcp_servers as Array<{ name?: string; status?: string }>) + .filter((s) => s && typeof s.name === 'string') + .map((s) => ({ + name: String(s.name), + status: String(s.status || 'unknown'), + })) + : undefined, + slashCommands: Array.isArray(record.slash_commands) + ? record.slash_commands.filter((c): c is string => typeof c === 'string') + : undefined, + model: this.pickFirstString(record.model), + permissionMode: this.pickFirstString(record.permissionMode), + cwd: this.pickFirstString(record.cwd), + outputStyle: this.pickFirstString(record.output_style), + betas: Array.isArray(record.betas) + ? record.betas.filter((b): b is string => typeof b === 'string') + : undefined, + claudeCodeVersion: this.pickFirstString(record.claude_code_version), + apiKeySource: this.pickFirstString(record.apiKeySource), + }; + + await ctx.persistManagementInfo(managementInfo); + console.error('[ClaudeEngine] Management info persisted'); + } catch (persistError) { + console.error('[ClaudeEngine] Failed to persist management info:', persistError); + } + } + } else if (subtype === 'status') { + // system:status - log for debugging (e.g., compacting) + const statusText = this.pickFirstString(record.status); + console.error(`[ClaudeEngine] System status: ${statusText || 'unknown'}`); + } + } else if (message.type === 'auth_status') { + // Handle authentication status - SDK fields: isAuthenticating, output, error + const record = message as unknown as Record; + const isAuthenticating = record.isAuthenticating === true; + const output = Array.isArray(record.output) + ? record.output.filter((o): o is string => typeof o === 'string') + : []; + const authError = this.pickFirstString(record.error); + + console.error( + `[ClaudeEngine] Auth status: isAuthenticating=${isAuthenticating}, hasError=${!!authError}`, + ); + + // Build content from output or error + const content = authError || output.join('\n') || 'Authentication in progress...'; + + // Determine if login is required: + // - Not currently authenticating AND (has error OR output contains login keywords) + const outputText = output.join(' ').toLowerCase(); + const requiresLogin = + !isAuthenticating && + (!!authError || + outputText.includes('login') || + outputText.includes('authenticate') || + outputText.includes('sign in')); + + // Emit auth status as a system message so UI can display login prompts + const authSystemMessage: AgentMessage = { + id: randomUUID(), + sessionId, + role: 'system', + content, + messageType: 'status', + cliSource: this.name, + requestId, + isStreaming: false, + isFinal: !isAuthenticating, + createdAt: new Date().toISOString(), + metadata: { + cli_type: 'claude', + event_type: 'auth_status', + isAuthenticating, + output, + error: authError, + requires_login: requiresLogin, + }, + }; + + ctx.emit({ type: 'message', data: authSystemMessage }); + } else if (message.type === 'tool_progress') { + // Handle tool progress - SDK fields: tool_use_id, tool_name, parent_tool_use_id, elapsed_time_seconds + const record = message as unknown as Record; + const toolUseId = this.pickFirstString(record.tool_use_id); + const toolName = this.pickFirstString(record.tool_name); + const parentToolUseId = this.pickFirstString(record.parent_tool_use_id); + const elapsedTimeSeconds = + typeof record.elapsed_time_seconds === 'number' + ? record.elapsed_time_seconds + : undefined; + + if (toolName || toolUseId) { + const displayName = toolName || toolUseId || 'tool'; + const elapsedStr = + elapsedTimeSeconds !== undefined ? ` (${elapsedTimeSeconds.toFixed(1)}s)` : ''; + console.error(`[ClaudeEngine] Tool progress: ${displayName}${elapsedStr}`); + + // Use tool_use_id as message id if available, so UI can update the same progress entry + const messageId = toolUseId ? `progress-${toolUseId}` : randomUUID(); + + // Emit tool progress as a tool message + const progressMessage: AgentMessage = { + id: messageId, + sessionId, + role: 'tool', + content: `${displayName} in progress${elapsedStr}`, + messageType: 'tool_use', + cliSource: this.name, + requestId, + isStreaming: true, + isFinal: false, + createdAt: new Date().toISOString(), + metadata: { + cli_type: 'claude', + event_type: 'tool_progress', + toolUseId, + toolName, + parentToolUseId, + elapsedTimeSeconds, + }, + }; + + ctx.emit({ type: 'message', data: progressMessage }); + } + } + } + + // Ensure final message is emitted + if (assistantBuffer.trim()) { + emitAssistant(true); + } + + console.error('[ClaudeEngine] Query completed successfully'); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + + // Log full stderr for debugging + console.error(`[ClaudeEngine] Error: ${message}`); + if (stderrBuffer.length > 0) { + console.error(`[ClaudeEngine] Stderr (${stderrBuffer.length} lines):`); + stderrBuffer.slice(-10).forEach((line) => console.error(` ${line}`)); + } + + // Check if this is a resume failure from stderr + const stderrText = stderrBuffer.join('\n'); + const isResumeFailure = + stderrText.includes('No conversation found') || + stderrText.includes('Failed to resume session') || + stderrText.includes('session ID') || + message.includes('Resume failed'); + + if (isResumeFailure && resumeClaudeSessionId && ctx.persistClaudeSessionId && projectId) { + // Clear the stored session ID so next request starts fresh + try { + await ctx.persistClaudeSessionId(''); + console.error('[ClaudeEngine] Cleared invalid session ID due to resume failure'); + } catch { + // Ignore clear errors + } + } + + // Enhance error message for CCR-related errors + const enhancedMessage = await this.enhanceCcrErrorMessage(message, stderrText); + + // Classify errors for better UX + const errorMessage = this.classifyError(enhancedMessage, stderrBuffer); + throw new Error(`ClaudeEngine: ${errorMessage}`); + } finally { + // Always cleanup temp files, even on error + await cleanupTempFiles(); + } + } + + /** + * Build environment variables for Claude Code. + * Supports Claude Code Router (CCR) when useCcr is true: + * 1. Auto-detecting CCR from config file (~/.claude-code-router/config.json) + * 2. Passing through env vars if already set (via `eval "$(ccr activate)"`) + * + * SDK treats options.env as a complete replacement (not merged with process.env), + * so we must explicitly include all necessary variables. + * + * @param useCcr - Whether CCR is enabled for this project. When false/undefined, CCR detection is skipped. + */ + private async buildClaudeEnv(useCcr?: boolean): Promise { + const env: NodeJS.ProcessEnv = { ...process.env }; + + // Ensure Node.js bin directory is in PATH (for child processes) + const nodeBinDir = path.dirname(process.execPath); + const currentPath = env.PATH || env.Path || ''; + if (!currentPath.includes(nodeBinDir)) { + env.PATH = [nodeBinDir, currentPath].filter(Boolean).join(path.delimiter); + } + + // Only detect CCR if explicitly enabled for this project + if (useCcr && !env.ANTHROPIC_BASE_URL) { + try { + const ccrResult = await detectCcr(); + if (ccrResult.detected && ccrResult.baseUrl && ccrResult.authToken) { + env.ANTHROPIC_BASE_URL = ccrResult.baseUrl; + env.ANTHROPIC_AUTH_TOKEN = ccrResult.authToken; + console.error(`[ClaudeEngine] CCR auto-detected (source: ${ccrResult.source})`); + } else if (ccrResult.error) { + console.error(`[ClaudeEngine] CCR detection failed: ${ccrResult.error}`); + } else { + console.error( + '[ClaudeEngine] CCR enabled but not detected (config not found or service not running)', + ); + } + } catch (err) { + // CCR detection is best-effort, don't fail the request + console.error(`[ClaudeEngine] CCR detection error: ${err}`); + } + } + + // Log CCR-related env vars for debugging (without exposing full token) + const baseUrl = env.ANTHROPIC_BASE_URL; + const authToken = env.ANTHROPIC_AUTH_TOKEN; + if (baseUrl) { + console.error(`[ClaudeEngine] Using ANTHROPIC_BASE_URL: ${baseUrl}`); + } + if (authToken) { + const preview = + authToken.length > 8 ? `${authToken.slice(0, 4)}...${authToken.slice(-4)}` : '****'; + console.error(`[ClaudeEngine] Using ANTHROPIC_AUTH_TOKEN: ${preview}`); + } + + return env; + } + + /** + * Resolve project root path. + */ + private resolveRepoPath(projectRoot?: string): string { + const base = + (projectRoot && projectRoot.trim()) || process.env.MCP_AGENT_PROJECT_ROOT || process.cwd(); + return path.resolve(base); + } + + /** + * Pick first string value from unknown input. + */ + private pickFirstString(value: unknown): string | undefined { + if (typeof value === 'string') { + const trimmed = value.trim(); + return trimmed.length > 0 ? trimmed : undefined; + } + if (typeof value === 'number' || typeof value === 'boolean') { + return String(value); + } + if (Array.isArray(value)) { + for (const entry of value) { + const candidate = this.pickFirstString(entry); + if (candidate) return candidate; + } + return undefined; + } + return undefined; + } + + /** + * Extract content from SDK message. + * Handles various message structures from Claude Agent SDK: + * - result.result (final result text) + * - assistant.message (nested message content) + * - content/text (direct content fields) + * - content[] (array of content blocks) + * + * @param message - The message object to extract content from + * @param depth - Current recursion depth (max 3 to prevent infinite loops) + */ + private extractMessageContent(message: unknown, depth = 0): string | undefined { + // Prevent infinite recursion + if (depth > 3 || !message || typeof message !== 'object') return undefined; + const record = message as Record; + + // Handle result message: result field contains final text + if (typeof record.result === 'string') { + return record.result.trim(); + } + + // Handle assistant message: message field may contain nested content + if (record.message && typeof record.message === 'object') { + const nested = this.extractMessageContent(record.message, depth + 1); + if (nested) return nested; + } + + // Try common content fields + if (typeof record.content === 'string') { + return record.content.trim(); + } + if (typeof record.text === 'string') { + return record.text.trim(); + } + if (Array.isArray(record.content)) { + const textParts: string[] = []; + for (const part of record.content) { + if (part && typeof part === 'object' && (part as Record).type === 'text') { + const text = (part as Record).text; + if (typeof text === 'string') { + textParts.push(text); + } + } + } + if (textParts.length > 0) { + return textParts.join('').trim(); + } + } + + return undefined; + } + + /** + * Format error message for user display. + * Preserves the original error message and only appends stderr context if useful. + */ + private classifyError(message: string, stderrBuffer: string[]): string { + // Always preserve the original error message + // Only append stderr context if it contains useful information beyond the spawn line + const usefulStderr = stderrBuffer.filter( + (line) => !line.includes('Spawning Claude Code:') && line.trim().length > 0, + ); + + if (usefulStderr.length > 0) { + const lastLines = usefulStderr.slice(-3).join(' | '); + return `${message} (stderr: ${lastLines})`; + } + + return message; + } + + /** + * Validate CCR configuration and emit a warning message if issues are found. + * This is a best-effort check to provide actionable guidance before CCR crashes. + */ + private async validateAndWarnCcrConfig( + sessionId: string, + requestId: string | undefined, + ctx: EngineExecutionContext, + ): Promise { + try { + const validation = await validateCcrConfig(); + + if (!validation.checked || validation.valid) { + return; + } + + // Build user-friendly warning message + const lines = [ + '⚠️ Claude Code Router (CCR) configuration issue detected:', + validation.issue ?? 'CCR configuration appears invalid.', + '', + validation.suggestion ?? 'Please check your CCR configuration.', + ]; + + if (validation.suggestedFix) { + lines.push('', `Suggested fix: Router.default = "${validation.suggestedFix}"`); + } + + const content = lines.join('\n'); + console.error(`[ClaudeEngine] CCR config warning: ${validation.issue}`); + + const warningMessage: AgentMessage = { + id: randomUUID(), + sessionId, + role: 'system', + content, + messageType: 'status', + cliSource: this.name, + requestId, + isStreaming: false, + isFinal: true, + createdAt: new Date().toISOString(), + metadata: { + cli_type: 'claude', + warning_type: 'ccr_config', + ccr_issue: validation.issue, + ccr_suggested_fix: validation.suggestedFix, + }, + }; + + ctx.emit({ type: 'message', data: warningMessage }); + } catch (err) { + // CCR config validation is best-effort, don't fail the request + console.error('[ClaudeEngine] CCR config validation error:', err); + } + } + + /** + * Enhance error messages for CCR-related errors. + * Detects the common "includes of undefined" crash and provides actionable guidance. + */ + private async enhanceCcrErrorMessage(message: string, stderrText: string): Promise { + const combinedText = `${message}\n${stderrText}`; + + // Detect CCR's "includes of undefined" error pattern + const isCcrIncludesError = + combinedText.includes('claude-code-router') && + (combinedText.includes("reading 'includes'") || combinedText.includes('transformRequestIn')); + + if (!isCcrIncludesError) { + return message; + } + + // Try to get specific fix suggestion from CCR config + let suggestion = + 'Edit ~/.claude-code-router/config.json and set Router.default to "provider,model" format (e.g., "venus,claude-4-5-sonnet-20250929"), then restart CCR.'; + + try { + const validation = await validateCcrConfig(); + if (validation.checked && !validation.valid && validation.suggestion) { + suggestion = validation.suggestion; + } + } catch { + // Use default suggestion if validation fails + } + + return [ + message, + '', + '💡 CCR Configuration Issue Detected:', + 'This error is commonly caused by Router.default being set to only a provider name', + '(e.g., "venus") instead of the required "provider,model" format.', + '', + `Fix: ${suggestion}`, + ].join('\n'); + } + + /** + * Build metadata for tool result events. + */ + private buildToolResultMetadata(block: Record): Record { + const toolUseId = this.pickFirstString(block.tool_use_id); + const isError = block.is_error === true; + + return { + toolUseId, + is_error: isError, + status: isError ? 'failed' : 'completed', + cli_type: 'claude', + }; + } + + /** + * Extract content from a tool_result block. + */ + private extractToolResultContent(block: Record): string | undefined { + const content = block.content; + if (typeof content === 'string') return content; + if (Array.isArray(content)) { + const textParts = content + .filter((c) => c && typeof c === 'object' && (c as Record).type === 'text') + .map((c) => (c as Record).text as string) + .filter(Boolean); + if (textParts.length > 0) { + return textParts.join('\n'); + } + } + return undefined; + } + + /** + * Encode string to base64 for hashing. + */ + private encodeHash(value: string): string { + return Buffer.from(value, 'utf-8').toString('base64'); + } + + /** + * Write an attachment to a temporary file and return its path. + */ + private async writeAttachmentToTemp(attachment: { + type: string; + name: string; + mimeType: string; + dataBase64: string; + }): Promise { + const os = await import('node:os'); + const fs = await import('node:fs/promises'); + + const tempDir = os.tmpdir(); + const ext = attachment.mimeType.split('/')[1] || 'bin'; + const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9.-]/g, '_'); + const fileName = `mcp-agent-${Date.now()}-${sanitizedName}.${ext}`; + const filePath = path.join(tempDir, fileName); + + const buffer = Buffer.from(attachment.dataBase64, 'base64'); + await fs.writeFile(filePath, buffer); + + return filePath; + } +} diff --git a/app/native-server/src/agent/engines/codex.ts b/app/native-server/src/agent/engines/codex.ts new file mode 100644 index 00000000..956ad4a0 --- /dev/null +++ b/app/native-server/src/agent/engines/codex.ts @@ -0,0 +1,957 @@ +import { spawn } from 'node:child_process'; +import readline from 'node:readline'; +import path from 'node:path'; +import { randomUUID } from 'node:crypto'; +import { + CODEX_AUTO_INSTRUCTIONS, + DEFAULT_CODEX_CONFIG, + type CodexEngineConfig, +} from 'chrome-mcp-shared'; +import type { AgentEngine, EngineExecutionContext, EngineInitOptions } from './types'; +import type { AgentMessage, RealtimeEvent } from '../types'; +import { AgentToolBridge } from '../tool-bridge'; +import { getProject } from '../project-service'; +import { getChromeMcpUrl } from '../../constant'; + +type TodoListPhase = 'started' | 'update' | 'completed'; + +interface TodoListItem { + text: string; + completed: boolean; + index: number; +} + +/** + * CodexEngine integrates the Codex CLI as an AgentEngine implementation. + * + * The implementation is intentionally self-contained and does not persist messages; + * it focuses on streaming Codex JSON events into RealtimeEvent envelopes that the + * sidepanel UI can consume. + * + * 中文说明：该引擎基于 other/cweb 中 Codex 适配器的事件协议，完整处理 + * item.started/item.delta/item.completed/item.failed/error 等事件，并 + * 通过 AgentStreamManager 将编码后的 RealtimeEvent 推送给 sidepanel， + * 确保数据链路「Sidepanel → Native Server → Codex CLI → Sidepanel」闭环。 + */ +export class CodexEngine implements AgentEngine { + public readonly name = 'codex' as const; + public readonly supportsMcp = false; + private readonly toolBridge: AgentToolBridge; + + constructor(toolBridge?: AgentToolBridge) { + this.toolBridge = toolBridge ?? new AgentToolBridge(); + } + + /** + * Maximum number of stderr lines to keep in memory to avoid unbounded growth. + */ + private static readonly MAX_STDERR_LINES = 200; + + async initializeAndRun(options: EngineInitOptions, ctx: EngineExecutionContext): Promise { + const { + sessionId, + instruction, + model, + projectRoot, + projectId, + requestId, + signal, + attachments, + resolvedImagePaths, + codexConfig, + } = options; + const repoPath = this.resolveRepoPath(projectRoot); + + // Check if already aborted + if (signal?.aborted) { + throw new Error('CodexEngine: execution was cancelled'); + } + + const normalizedInstruction = instruction.trim(); + if (!normalizedInstruction) { + throw new Error('CodexEngine: instruction must not be empty'); + } + + // Merge user config with defaults + const resolvedConfig: CodexEngineConfig = { + ...DEFAULT_CODEX_CONFIG, + ...(codexConfig ?? {}), + }; + + // Ensure autoInstructions has a value + if (!resolvedConfig.autoInstructions?.trim()) { + resolvedConfig.autoInstructions = CODEX_AUTO_INSTRUCTIONS; + } + + // Resolve project-scoped Chrome MCP toggle (default: enabled) + const enableChromeMcp = await (async (): Promise => { + if (!projectId) return true; + try { + const project = await getProject(projectId); + return project?.enableChromeMcp !== false; + } catch (err) { + const message = err instanceof Error ? err.message : String(err); + console.error( + `[CodexEngine] Failed to load project enableChromeMcp, defaulting to enabled: ${message}`, + ); + return true; + } + })(); + + // Optionally append project context to the prompt + const prompt = resolvedConfig.appendProjectContext + ? await this.appendProjectContext(normalizedInstruction, repoPath) + : normalizedInstruction; + + const executable = process.platform === 'win32' ? 'codex.cmd' : 'codex'; + const args: string[] = [ + 'exec', + '--json', + '--skip-git-repo-check', + '--dangerously-bypass-approvals-and-sandbox', + '--color', + 'never', + '--cd', + repoPath, + ]; + + // Add Codex configuration arguments + args.push(...this.buildCodexConfigArgs(resolvedConfig)); + + // Inject local Chrome MCP server via runtime config override (no global codex config mutation) + // Use a unique server name to avoid collision with any existing global config + if (enableChromeMcp) { + const chromeMcpUrl = getChromeMcpUrl(); + // Set both url and type for complete HTTP MCP server configuration + args.push('-c', `mcp_servers.chrome_mcp_http.url=${JSON.stringify(chromeMcpUrl)}`); + args.push('-c', `mcp_servers.chrome_mcp_http.type="http"`); + console.error(`[CodexEngine] Chrome MCP server enabled: ${chromeMcpUrl}`); + } else { + console.error('[CodexEngine] Chrome MCP server disabled'); + } + + if (model && model.trim()) { + args.push('--model', model.trim()); + } + + // Process image attachments - prefer resolvedImagePaths (persisted), fallback to temp files + const tempFiles: string[] = []; + const hasResolvedPaths = resolvedImagePaths && resolvedImagePaths.length > 0; + + if (hasResolvedPaths) { + // Use pre-resolved persistent paths (preferred - no temp files needed) + console.error(`[CodexEngine] Using ${resolvedImagePaths.length} pre-resolved image path(s)`); + for (const imagePath of resolvedImagePaths) { + args.push('--image', imagePath); + } + } else if (attachments && attachments.length > 0) { + // Fallback: write base64 to temp files (legacy behavior) + for (const attachment of attachments) { + if (attachment.type === 'image') { + try { + const tempFile = await this.writeAttachmentToTemp(attachment); + tempFiles.push(tempFile); + args.push('--image', tempFile); + } catch (err) { + console.error('[CodexEngine] Failed to write attachment to temp file:', err); + } + } + } + } + + args.push(prompt); + + // Use explicit Promise wrapping to ensure child process errors are properly rejected. + return new Promise((resolve, reject) => { + const child = spawn(executable, args, { + cwd: repoPath, + env: this.buildCodexEnv(), + stdio: ['ignore', 'pipe', 'pipe'], + }); + + // State management + const stderrBuffer: string[] = []; + let hasCompleted = false; + let timedOut = false; + let settled = false; + let timeoutHandle: NodeJS.Timeout | null = null; + + // Readline interface - declared early to avoid TDZ issues in finish() + let rl: readline.Interface | null = null; + + // Assistant message state + let assistantBuffer = ''; + let assistantMessageId: string | null = null; + let assistantCreatedAt: string | null = null; + const streamedToolHashes = new Set(); + const activeCommands = new Map(); + const thinkingSegments: string[] = []; + + /** + * Cleanup temporary files created for image attachments. + */ + const cleanupTempFiles = async (): Promise => { + if (tempFiles.length === 0) return; + + const fs = await import('node:fs/promises'); + for (const filePath of tempFiles) { + try { + await fs.unlink(filePath); + console.error(`[CodexEngine] Cleaned up temp file: ${filePath}`); + } catch (err) { + // Ignore errors during cleanup - file may already be deleted + console.error(`[CodexEngine] Failed to cleanup temp file ${filePath}:`, err); + } + } + }; + + /** + * Cleanup and settle the promise (resolve or reject). + * Waits for temp file cleanup to complete before settling. + */ + const finish = async (error?: unknown): Promise => { + if (settled) return; + settled = true; + + // Clear timeout + if (timeoutHandle) { + clearTimeout(timeoutHandle); + timeoutHandle = null; + } + + // Close readline interface + if (rl) { + try { + rl.close(); + } catch { + // Ignore close errors during cleanup + } + } + + // Kill child process if still running + if (!child.killed) { + try { + child.kill(); + } catch { + // Ignore kill errors during cleanup + } + } + + // Cleanup temp files after process is killed (wait for completion) + await cleanupTempFiles(); + + // Settle the promise + if (error) { + reject(error instanceof Error ? error : new Error(String(error))); + } else { + resolve(); + } + }; + + // Handle child process error immediately after spawn (e.g., command not found) + child.on('error', (error) => { + const message = + error instanceof Error + ? error.message + : stderrBuffer.slice(-5).join('\n') || 'Codex CLI failed to start'; + void finish(new Error(`CodexEngine: ${message}`)); + }); + + // Listen for abort signal to cancel execution + const abortHandler = signal + ? () => { + console.error('[CodexEngine] Execution cancelled via abort signal'); + void finish(new Error('CodexEngine: execution was cancelled')); + } + : null; + + if (signal && abortHandler) { + signal.addEventListener('abort', abortHandler, { once: true }); + } + + // Collect stderr with bounded buffer + child.stderr?.on('data', (chunk) => { + const text = String(chunk).trim(); + if (!text) return; + + stderrBuffer.push(text); + // Keep only the most recent lines to prevent memory growth + if (stderrBuffer.length > CodexEngine.MAX_STDERR_LINES) { + stderrBuffer.splice(0, stderrBuffer.length - CodexEngine.MAX_STDERR_LINES); + } + + console.error('[CodexEngine][stderr]', text); + }); + + rl = readline.createInterface({ input: child.stdout }); + + /** + * Build the assistant message payload, combining thinking and agent content. + */ + const buildAssistantPayload = (): string => { + const trimmedAssistant = assistantBuffer.trim(); + const thinkingContent = thinkingSegments + .map((segment) => segment.trim()) + .filter((segment) => segment.length > 0) + .map((segment) => `${segment}`) + .join('\n\n'); + + const parts: string[] = []; + if (thinkingContent) { + parts.push(thinkingContent); + } + if (trimmedAssistant) { + parts.push(trimmedAssistant); + } + return parts.join('\n\n').trim(); + }; + + /** + * Reset assistant buffers after emitting a final message. + */ + const resetAssistantBuffers = (): void => { + assistantBuffer = ''; + thinkingSegments.length = 0; + assistantMessageId = null; + assistantCreatedAt = null; + }; + + // Helper: emit assistant message + const emitAssistant = (isFinal: boolean): void => { + const content = buildAssistantPayload(); + if (!content) return; + + if (!assistantMessageId) { + assistantMessageId = randomUUID(); + } + if (!assistantCreatedAt) { + assistantCreatedAt = new Date().toISOString(); + } + + const message: AgentMessage = { + id: assistantMessageId, + sessionId, + role: 'assistant', + content, + messageType: 'chat', + cliSource: this.name, + requestId, + isStreaming: !isFinal, + isFinal, + createdAt: assistantCreatedAt, + }; + + ctx.emit({ type: 'message', data: message }); + }; + + // Helper: emit tool message with deduplication + const dispatchToolMessage = ( + content: string, + metadata: Record, + messageType: 'tool_use' | 'tool_result', + isStreaming: boolean, + ): void => { + const trimmed = content.trim(); + if (!trimmed) return; + + const hash = this.encodeHash( + `${messageType}:${trimmed}:${JSON.stringify(metadata)}:${sessionId}:${requestId || ''}`, + ).slice(0, 16); + if (streamedToolHashes.has(hash)) return; + streamedToolHashes.add(hash); + + const message: AgentMessage = { + id: randomUUID(), + sessionId, + role: 'tool', + content: trimmed, + messageType, + cliSource: this.name, + requestId, + isStreaming, + isFinal: !isStreaming, + createdAt: new Date().toISOString(), + metadata: { cli_type: 'codex', ...metadata }, + }; + + ctx.emit({ type: 'message', data: message }); + }; + + // Event handlers for specific item types + const emitCommandStart = (item: Record): void => { + const id = this.pickFirstString(item.id) ?? randomUUID(); + const command = this.pickFirstString(item.command); + activeCommands.set(id, { command }); + dispatchToolMessage( + command ? `Running: ${command}` : 'Running command', + { + toolName: 'Bash', + tool_name: 'Bash', + command, + status: this.pickFirstString(item.status) ?? 'in_progress', + }, + 'tool_use', + true, + ); + }; + + const emitCommandResult = (item: Record): void => { + const id = this.pickFirstString(item.id); + const tracked = id ? activeCommands.get(id) : undefined; + if (id) { + activeCommands.delete(id); + } + const command = this.pickFirstString(item.command) ?? tracked?.command; + const output = this.pickFirstString(item.aggregated_output) ?? ''; + const exitCode = typeof item.exit_code === 'number' ? item.exit_code : undefined; + const status = this.pickFirstString(item.status); + const isError = status === 'failed' || (typeof exitCode === 'number' && exitCode !== 0); + + const summary = command ? `Ran: ${command}` : 'Executed shell command'; + const exitSuffix = typeof exitCode === 'number' ? ` (exit ${exitCode})` : ''; + const body = output.trim(); + const fullContent = body ? `${summary}${exitSuffix}\n\n${body}` : `${summary}${exitSuffix}`; + + dispatchToolMessage( + fullContent, + { + toolName: 'Bash', + tool_name: 'Bash', + command, + exitCode, + status, + output, + is_error: isError || undefined, + }, + 'tool_result', + false, + ); + }; + + const emitFileChange = (item: Record): void => { + const { content, metadata } = this.summarizeApplyPatch({ + changes: item.changes as Record | Array>, + }); + const status = this.pickFirstString(item.status) ?? 'completed'; + const isError = status === 'failed'; + const toolName = + (metadata?.toolName as string) || (metadata?.tool_name as string) || 'Edit'; + + dispatchToolMessage( + isError ? `Failed: ${content}` : content, + { ...metadata, toolName, tool_name: toolName, status, is_error: isError || undefined }, + 'tool_result', + false, + ); + }; + + const emitTodoListUpdate = (record: Record, phase: TodoListPhase): void => { + const rawItems = this.extractTodoListItems(record); + const items = this.normalizeTodoListItems(rawItems); + const content = this.buildTodoListContent(items, phase); + const status = + this.pickFirstString(record.status) ?? + (phase === 'completed' ? 'completed' : 'in_progress'); + const metadata = this.createTodoListMetadata(items, phase, { + status, + planId: this.pickFirstString(record.id), + }); + + dispatchToolMessage( + content, + metadata, + phase === 'completed' ? 'tool_result' : 'tool_use', + phase === 'update', + ); + }; + + // Item event handlers + const handleItemStarted = (item: unknown): void => { + if (!item || typeof item !== 'object') return; + const record = item as Record; + const type = this.pickFirstString(record.type); + if (type === 'command_execution') { + emitCommandStart(record); + } else if (type === 'todo_list') { + emitTodoListUpdate(record, 'started'); + } + }; + + const handleItemDelta = (delta: unknown): void => { + if (!delta || typeof delta !== 'object') return; + const record = delta as Record; + const type = this.pickFirstString(record.type); + + if (type === 'agent_message') { + const text = this.pickFirstString(record.text); + if (text) { + assistantBuffer += text; + emitAssistant(false); + } + } else if (type === 'reasoning') { + const text = this.pickFirstString(record.text); + if (text) { + thinkingSegments.push(text); + emitAssistant(false); + } + } else if (type === 'todo_list') { + emitTodoListUpdate(record, 'update'); + } + }; + + const handleItemCompleted = (item: unknown): void => { + if (!item || typeof item !== 'object') return; + const record = item as Record; + const type = this.pickFirstString(record.type); + + switch (type) { + case 'command_execution': + emitCommandResult(record); + break; + case 'file_change': + emitFileChange(record); + break; + case 'todo_list': + emitTodoListUpdate(record, 'completed'); + break; + case 'agent_message': { + const text = this.pickFirstString(record.text); + if (text) assistantBuffer = text; + emitAssistant(true); + resetAssistantBuffers(); + break; + } + case 'reasoning': { + const text = this.pickFirstString(record.text); + if (text) { + thinkingSegments.push(text); + emitAssistant(false); + } + break; + } + default: { + const text = this.pickFirstString(record.text); + if (text) { + thinkingSegments.push(text); + emitAssistant(false); + } + break; + } + } + }; + + // Setup timeout + const timeoutMs = + Number.parseInt(process.env.CODEX_ENGINE_TIMEOUT_MS || '', 10) || 15 * 60 * 1000; + timeoutHandle = setTimeout(() => { + timedOut = true; + // Close readline to exit the loop + try { + rl.close(); + } catch { + // Ignore + } + if (!child.killed) { + try { + child.kill(); + } catch { + // Ignore + } + } + }, timeoutMs); + timeoutHandle.unref?.(); + + // Cleanup timeout and handle abnormal exit + child.on('close', (code: number | null, closeSignal: NodeJS.Signals | null) => { + if (timeoutHandle) { + clearTimeout(timeoutHandle); + timeoutHandle = null; + } + + // If already timed out, settled, or completed normally, do nothing + if (timedOut || settled || hasCompleted) { + return; + } + + // Build error detail from exit code and signal + const detailParts: string[] = []; + if (typeof code === 'number') { + detailParts.push(`exit code ${code}`); + } + if (closeSignal) { + detailParts.push(`signal ${closeSignal}`); + } + const detail = detailParts.length > 0 ? detailParts.join(', ') : 'unexpected shutdown'; + + // Emit final assistant message and mark as failed + emitAssistant(true); + resetAssistantBuffers(); + hasCompleted = true; + void finish(new Error(`CodexEngine: process terminated (${detail})`)); + }); + + // Main event processing loop (wrapped in IIFE to handle async properly) + void (async () => { + try { + for await (const line of rl) { + const trimmed = line.trim(); + if (!trimmed) continue; + + let event: Record; + try { + event = JSON.parse(trimmed) as Record; + } catch { + console.warn('[CodexEngine] Failed to parse Codex event line:', trimmed); + continue; + } + + const eventType = this.pickFirstString(event.type); + switch (eventType) { + case 'item.started': + handleItemStarted((event as { item?: unknown }).item ?? null); + break; + case 'item.delta': + handleItemDelta((event as { delta?: unknown }).delta ?? null); + break; + case 'item.completed': + handleItemCompleted((event as { item?: unknown }).item ?? null); + break; + case 'item.failed': { + const item = (event as { item?: unknown }).item ?? null; + handleItemCompleted(item); + // Flush assistant message before throwing (aligned with other/cweb) + emitAssistant(true); + resetAssistantBuffers(); + const msg = + (item && + typeof item === 'object' && + this.pickFirstString((item as Record).error)) || + 'Codex execution failed'; + hasCompleted = true; + throw new Error(msg); + } + case 'error': { + // Flush assistant message before throwing (aligned with other/cweb) + emitAssistant(true); + resetAssistantBuffers(); + const msg = + this.pickFirstString((event as { error?: unknown }).error) || + this.pickFirstString((event as { message?: unknown }).message) || + stderrBuffer.slice(-5).join('\n') || + 'Codex execution error'; + hasCompleted = true; + throw new Error(msg); + } + case 'turn.completed': + emitAssistant(true); + resetAssistantBuffers(); + hasCompleted = true; + break; + default: + // Non-critical events are ignored + break; + } + } + + // Check for timeout after loop exits + if (timedOut) { + throw new Error('CodexEngine: execution timed out'); + } + + // Emit final assistant message if not already completed + if (!hasCompleted) { + emitAssistant(true); + resetAssistantBuffers(); + hasCompleted = true; + } + + await finish(); + } catch (error) { + await finish(error); + } + })(); + }); + } + + private resolveRepoPath(projectRoot?: string): string { + const base = + (projectRoot && projectRoot.trim()) || process.env.MCP_AGENT_PROJECT_ROOT || process.cwd(); + return path.resolve(base); + } + + /** + * Append project context (file listing) to the prompt. + * Aligned with other/cweb implementation. + */ + private async appendProjectContext(baseInstruction: string, repoPath: string): Promise { + try { + const fs = await import('node:fs/promises'); + const entries = await fs.readdir(repoPath, { withFileTypes: true }); + const visible = entries + .filter((entry) => !entry.name.startsWith('.git') && entry.name !== 'AGENTS.md') + .map((entry) => entry.name); + + if (visible.length === 0) { + return `${baseInstruction} + + +This is an empty project directory. Work directly in the current folder without creating extra subdirectories. +`; + } + + return `${baseInstruction} + + +Current files in project directory: ${visible.sort().join(', ')} +Work directly in the current directory. Do not create subdirectories unless specifically requested. +`; + } catch (error) { + console.warn('[CodexEngine] Failed to append project context:', error); + return baseInstruction; + } + } + + /** + * Build Codex CLI configuration arguments from the resolved config. + * Aligned with other/cweb implementation for feature parity. + */ + private buildCodexConfigArgs(config: CodexEngineConfig): string[] { + const args: string[] = []; + + const pushConfig = (key: string, value: string | number | boolean): void => { + args.push('-c', `${key}=${String(value)}`); + }; + + pushConfig('include_apply_patch_tool', config.includeApplyPatchTool); + pushConfig('include_plan_tool', config.includePlanTool); + pushConfig('tools.web_search_request', config.enableWebSearch); + pushConfig('use_experimental_streamable_shell_tool', config.useStreamableShell); + pushConfig('sandbox_mode', config.sandboxMode); + pushConfig('max_turns', config.maxTurns); + pushConfig('max_thinking_tokens', config.maxThinkingTokens); + pushConfig('reasoning_effort', config.reasoningEffort); + args.push('-c', `instructions=${JSON.stringify(config.autoInstructions)}`); + + return args; + } + + /** + * Write an attachment to a temporary file and return its path. + */ + private async writeAttachmentToTemp(attachment: { + type: string; + name: string; + mimeType: string; + dataBase64: string; + }): Promise { + const os = await import('node:os'); + const fs = await import('node:fs/promises'); + + const tempDir = os.tmpdir(); + const ext = attachment.mimeType.split('/')[1] || 'bin'; + const sanitizedName = attachment.name.replace(/[^a-zA-Z0-9.-]/g, '_'); + const fileName = `mcp-agent-${Date.now()}-${sanitizedName}.${ext}`; + const filePath = path.join(tempDir, fileName); + + const buffer = Buffer.from(attachment.dataBase64, 'base64'); + await fs.writeFile(filePath, buffer); + + return filePath; + } + + private buildCodexEnv(): NodeJS.ProcessEnv { + const env: NodeJS.ProcessEnv = { ...process.env }; + const extraPaths: string[] = []; + const globalPath = process.env.NPM_GLOBAL_PATH; + if (globalPath) { + extraPaths.push(globalPath); + } + // Enhanced Windows PATH handling (aligned with other/cweb) + if (process.platform === 'win32') { + const appData = process.env.APPDATA; + const localApp = process.env.LOCALAPPDATA; + if (appData) { + extraPaths.push(path.join(appData, 'npm')); + } + if (localApp) { + extraPaths.push(path.join(localApp, 'Programs', 'nodejs')); + } + } + if (extraPaths.length > 0) { + const currentPath = env.PATH || env.Path || ''; + env.PATH = [...extraPaths, currentPath].filter(Boolean).join(path.delimiter); + } + return env; + } + + private pickFirstString(value: unknown): string | undefined { + if (typeof value === 'string') { + const trimmed = value.trim(); + return trimmed.length > 0 ? trimmed : undefined; + } + if (typeof value === 'number' || typeof value === 'boolean') { + return String(value); + } + if (Array.isArray(value)) { + for (const entry of value) { + const candidate = this.pickFirstString(entry); + if (candidate) { + return candidate; + } + } + return undefined; + } + if (value && typeof value === 'object') { + const record = value as Record; + for (const key of Object.keys(record)) { + const candidate = this.pickFirstString(record[key]); + if (candidate) { + return candidate; + } + } + } + return undefined; + } + + private summarizeApplyPatch(payload: { + changes?: Record | Array>; + }): { content: string; metadata: Record } { + const changes = payload?.changes; + const files: string[] = []; + if (Array.isArray(changes)) { + for (const entry of changes) { + const file = + entry && typeof entry === 'object' + ? ((entry as Record).path as string) || + ((entry as Record).file as string) + : undefined; + if (file && typeof file === 'string') { + files.push(file); + } + } + } else if (changes && typeof changes === 'object') { + for (const key of Object.keys(changes)) { + files.push(key); + } + } + + const unique = Array.from(new Set(files)); + const summary = + unique.length === 0 + ? 'Applied file changes' + : unique.length === 1 + ? `Updated ${unique[0]}` + : `Updated ${unique.length} files (${unique + .slice(0, 3) + .join(', ')}${unique.length > 3 ? ', ...' : ''})`; + + return { + content: summary, + metadata: { + files: unique, + }, + }; + } + + private extractTodoListItems(record: Record): unknown { + if (Array.isArray(record.items)) { + return record.items; + } + const nestedItem = record.item; + if ( + nestedItem && + typeof nestedItem === 'object' && + Array.isArray((nestedItem as Record).items) + ) { + return (nestedItem as Record).items; + } + const delta = record.delta; + if ( + delta && + typeof delta === 'object' && + Array.isArray((delta as Record).items) + ) { + return (delta as Record).items; + } + return []; + } + + private normalizeTodoListItems(input: unknown): TodoListItem[] { + if (!Array.isArray(input)) { + return []; + } + + const result: TodoListItem[] = []; + + input.forEach((entry, index) => { + if (!entry || typeof entry !== 'object') { + return; + } + const record = entry as Record; + const text = this.pickFirstString(record.text) ?? `Step ${index + 1}`; + const completed = record.completed === true || record.done === true; + result.push({ + text, + completed, + index, + }); + }); + + return result; + } + + private buildTodoListContent(items: TodoListItem[], phase: TodoListPhase): string { + if (items.length === 0) { + switch (phase) { + case 'started': + return 'Started plan with no explicit steps.'; + case 'completed': + return 'Plan completed.'; + default: + return 'Plan updated.'; + } + } + + const header = + phase === 'completed' + ? 'Plan completed:' + : phase === 'started' + ? 'Plan generated:' + : 'Plan updated:'; + + const stepLines = items.map((item, idx) => { + const bullet = item.completed ? '✅' : '⬜️'; + const label = `Step ${idx + 1}`; + return `${bullet} ${label}: ${item.text}`; + }); + + return [header, ...stepLines].join('\n'); + } + + private createTodoListMetadata( + items: TodoListItem[], + phase: TodoListPhase, + extra?: Record, + ): Record { + const totalSteps = items.length; + const completedSteps = items.filter((item) => item.completed).length; + return { + toolName: 'Plan', + tool_name: 'Plan', + planPhase: phase, + planStatus: phase === 'completed' ? 'completed' : 'in_progress', + totalSteps, + completedSteps, + items: items.map(({ text, completed, index }) => ({ + text, + completed, + index, + })), + ...(extra ?? {}), + }; + } + + private encodeHash(value: string): string { + return Buffer.from(value, 'utf-8').toString('base64'); + } +} diff --git a/app/native-server/src/agent/engines/types.ts b/app/native-server/src/agent/engines/types.ts new file mode 100644 index 00000000..8274d761 --- /dev/null +++ b/app/native-server/src/agent/engines/types.ts @@ -0,0 +1,135 @@ +import type { AgentAttachment, RealtimeEvent } from '../types'; +import type { CodexEngineConfig } from 'chrome-mcp-shared'; + +export interface EngineInitOptions { + sessionId: string; + instruction: string; + model?: string; + projectRoot?: string; + requestId: string; + /** + * AbortSignal for cancellation support. + */ + signal?: AbortSignal; + /** + * Optional attachments (images/files) to include with the instruction. + * Note: When using persisted attachments, use resolvedImagePaths instead. + */ + attachments?: AgentAttachment[]; + /** + * Resolved absolute paths to persisted image files. + * These are used by engines instead of writing temp files from base64. + * Set by chat-service after saving attachments to persistent storage. + */ + resolvedImagePaths?: string[]; + /** + * Optional project ID for session persistence. + * When provided, engines can use this to save/load session state. + */ + projectId?: string; + /** + * Optional database session ID (sessions.id) for session-scoped configuration and persistence. + */ + dbSessionId?: string; + /** + * Optional session-scoped permission mode override (Claude SDK option). + */ + permissionMode?: string; + /** + * Optional session-scoped permission bypass override (Claude SDK option). + */ + allowDangerouslySkipPermissions?: boolean; + /** + * Optional session-scoped system prompt configuration. + */ + systemPromptConfig?: unknown; + /** + * Optional session-scoped engine option overrides. + */ + optionsConfig?: unknown; + /** + * Optional Claude session ID (UUID) for resuming a previous session. + * Only applicable to ClaudeEngine; retrieved from sessions.engineSessionId (preferred) + * or project's activeClaudeSessionId (legacy fallback). + */ + resumeClaudeSessionId?: string; + /** + * Whether to use Claude Code Router (CCR) for this request. + * Only applicable to ClaudeEngine; when true, CCR will be auto-detected. + */ + useCcr?: boolean; + /** + * Optional Codex-specific configuration overrides. + * Only applicable to CodexEngine; merged with DEFAULT_CODEX_CONFIG. + */ + codexConfig?: Partial; +} + +/** + * Callback to persist Claude session ID after initialization. + */ +export type ClaudeSessionPersistCallback = (sessionId: string) => Promise; + +/** + * Management information extracted from Claude SDK system:init message. + */ +export interface ClaudeManagementInfo { + tools?: string[]; + agents?: string[]; + /** Plugins with name and path (SDK returns { name, path }[]) */ + plugins?: Array<{ name: string; path?: string }>; + skills?: string[]; + mcpServers?: Array<{ name: string; status: string }>; + slashCommands?: string[]; + model?: string; + permissionMode?: string; + cwd?: string; + outputStyle?: string; + betas?: string[]; + claudeCodeVersion?: string; + apiKeySource?: string; +} + +/** + * Callback to persist management information after SDK initialization. + */ +export type ManagementInfoPersistCallback = (info: ClaudeManagementInfo) => Promise; + +export type EngineName = 'claude' | 'codex' | 'cursor' | 'qwen' | 'glm'; + +export interface EngineExecutionContext { + /** + * Emit a realtime event to all connected clients for the current session. + */ + emit(event: RealtimeEvent): void; + /** + * Optional callback to persist Claude session ID after SDK initialization. + * Only called by ClaudeEngine when projectId is provided. + */ + persistClaudeSessionId?: ClaudeSessionPersistCallback; + /** + * Optional callback to persist management information after SDK initialization. + * Only called by ClaudeEngine when dbSessionId is provided. + */ + persistManagementInfo?: ManagementInfoPersistCallback; +} + +export interface AgentEngine { + name: EngineName; + /** + * Whether this engine can act as an MCP client natively. + */ + supportsMcp?: boolean; + initializeAndRun(options: EngineInitOptions, ctx: EngineExecutionContext): Promise; +} + +/** + * Represents a running engine execution that can be cancelled. + */ +export interface RunningExecution { + requestId: string; + sessionId: string; + engineName: EngineName; + abortController: AbortController; + startedAt: Date; +} diff --git a/app/native-server/src/agent/message-service.ts b/app/native-server/src/agent/message-service.ts new file mode 100644 index 00000000..581cc6d3 --- /dev/null +++ b/app/native-server/src/agent/message-service.ts @@ -0,0 +1,241 @@ +/** + * Message Service - Database-backed implementation using Drizzle ORM. + * + * Provides CRUD operations for agent chat messages with: + * - Type-safe database queries + * - Efficient indexed queries + * - Consistent with AgentStoredMessage interface from shared types + */ +import { randomUUID } from 'node:crypto'; +import { eq, asc, and, count } from 'drizzle-orm'; +import type { AgentRole, AgentStoredMessage } from 'chrome-mcp-shared'; +import { getDb, messages, type MessageRow } from './db'; + +// ============================================================ +// Types +// ============================================================ + +export type { AgentStoredMessage }; + +export interface CreateAgentStoredMessageInput { + projectId: string; + role: AgentRole; + messageType: AgentStoredMessage['messageType']; + content: string; + metadata?: Record; + sessionId?: string; + conversationId?: string | null; + cliSource?: string; + requestId?: string; + id?: string; + createdAt?: string; +} + +// ============================================================ +// Type Conversion +// ============================================================ + +/** + * Convert database row to AgentStoredMessage interface. + */ +function rowToMessage(row: MessageRow): AgentStoredMessage { + return { + id: row.id, + projectId: row.projectId, + sessionId: row.sessionId, + conversationId: row.conversationId, + role: row.role as AgentRole, + content: row.content, + messageType: row.messageType as AgentStoredMessage['messageType'], + metadata: row.metadata ? JSON.parse(row.metadata) : undefined, + cliSource: row.cliSource, + requestId: row.requestId ?? undefined, + createdAt: row.createdAt, + }; +} + +// ============================================================ +// Public API +// ============================================================ + +/** + * Get messages by project ID with pagination. + * Returns messages sorted by creation time (oldest first). + */ +export async function getMessagesByProjectId( + projectId: string, + limit = 50, + offset = 0, +): Promise { + const db = getDb(); + + const query = db + .select() + .from(messages) + .where(eq(messages.projectId, projectId)) + .orderBy(asc(messages.createdAt)); + + // Apply pagination if specified + if (limit > 0) { + query.limit(limit); + } + if (offset > 0) { + query.offset(offset); + } + + const rows = await query; + return rows.map(rowToMessage); +} + +/** + * Get the total count of messages for a project. + */ +export async function getMessagesCountByProjectId(projectId: string): Promise { + const db = getDb(); + const result = await db + .select({ count: count() }) + .from(messages) + .where(eq(messages.projectId, projectId)); + return result[0]?.count ?? 0; +} + +/** + * Create a new message. + */ +export async function createMessage( + input: CreateAgentStoredMessageInput, +): Promise { + const db = getDb(); + const now = new Date().toISOString(); + + const messageData: MessageRow = { + id: input.id?.trim() || randomUUID(), + projectId: input.projectId, + sessionId: input.sessionId || '', + conversationId: input.conversationId ?? null, + role: input.role, + content: input.content, + messageType: input.messageType, + metadata: input.metadata ? JSON.stringify(input.metadata) : null, + cliSource: input.cliSource ?? null, + requestId: input.requestId ?? null, + createdAt: input.createdAt || now, + }; + + await db + .insert(messages) + .values(messageData) + .onConflictDoUpdate({ + target: messages.id, + set: { + role: messageData.role, + messageType: messageData.messageType, + content: messageData.content, + metadata: messageData.metadata, + sessionId: messageData.sessionId, + conversationId: messageData.conversationId, + cliSource: messageData.cliSource, + requestId: messageData.requestId, + }, + }); + + return rowToMessage(messageData); +} + +/** + * Delete messages by project ID. + * Optionally filter by conversation ID. + * Returns the number of deleted messages. + */ +export async function deleteMessagesByProjectId( + projectId: string, + conversationId?: string, +): Promise { + const db = getDb(); + + // Get count before deletion + const beforeCount = await getMessagesCountByProjectId(projectId); + + if (conversationId) { + await db + .delete(messages) + .where(and(eq(messages.projectId, projectId), eq(messages.conversationId, conversationId))); + } else { + await db.delete(messages).where(eq(messages.projectId, projectId)); + } + + // Get count after deletion to calculate deleted count + const afterCount = await getMessagesCountByProjectId(projectId); + return beforeCount - afterCount; +} + +/** + * Get messages by session ID with optional pagination. + * Returns messages sorted by creation time (oldest first). + * + * @param sessionId - The session ID to filter by + * @param limit - Maximum number of messages to return (0 = no limit) + * @param offset - Number of messages to skip + */ +export async function getMessagesBySessionId( + sessionId: string, + limit = 0, + offset = 0, +): Promise { + const db = getDb(); + + const query = db + .select() + .from(messages) + .where(eq(messages.sessionId, sessionId)) + .orderBy(asc(messages.createdAt)); + + if (limit > 0) { + query.limit(limit); + } + if (offset > 0) { + query.offset(offset); + } + + const rows = await query; + return rows.map(rowToMessage); +} + +/** + * Get count of messages by session ID. + */ +export async function getMessagesCountBySessionId(sessionId: string): Promise { + const db = getDb(); + const result = await db + .select({ count: count() }) + .from(messages) + .where(eq(messages.sessionId, sessionId)); + return result[0]?.count ?? 0; +} + +/** + * Delete all messages for a session. + * Returns the number of deleted messages. + */ +export async function deleteMessagesBySessionId(sessionId: string): Promise { + const db = getDb(); + + const beforeCount = await getMessagesCountBySessionId(sessionId); + await db.delete(messages).where(eq(messages.sessionId, sessionId)); + const afterCount = await getMessagesCountBySessionId(sessionId); + + return beforeCount - afterCount; +} + +/** + * Get messages by request ID. + */ +export async function getMessagesByRequestId(requestId: string): Promise { + const db = getDb(); + const rows = await db + .select() + .from(messages) + .where(eq(messages.requestId, requestId)) + .orderBy(asc(messages.createdAt)); + return rows.map(rowToMessage); +} diff --git a/app/native-server/src/agent/open-project.ts b/app/native-server/src/agent/open-project.ts new file mode 100644 index 00000000..ed562f61 --- /dev/null +++ b/app/native-server/src/agent/open-project.ts @@ -0,0 +1,536 @@ +/** + * Open Project Service. + * + * Provides cross-platform functionality to open a project directory in: + * - VS Code (or compatible editors) + * - System terminal + * + * Security: + * - Uses validateRootPath() for path validation (allowed directories check) + * - Uses spawn() with args array (shell: false) to prevent command injection + * + * Platform Support: + * - macOS: Terminal.app, VS Code via 'code' or 'open -b' + * - Windows: Windows Terminal, PowerShell, VS Code + * - Linux: gnome-terminal, konsole, xfce4-terminal, xterm + */ +import os from 'node:os'; +import path from 'node:path'; +import { stat } from 'node:fs/promises'; +import { spawn } from 'node:child_process'; +import type { OpenProjectResponse, OpenProjectTarget } from 'chrome-mcp-shared'; +import { validateRootPath } from './project-service'; + +// ============================================================ +// Types +// ============================================================ + +type LaunchResult = { success: true } | { success: false; error: string }; + +interface LaunchAttempt { + /** Human-readable label for error messages */ + label: string; + /** Command to execute */ + cmd: string; + /** Arguments array (no shell interpolation) */ + args: string[]; + /** + * Time to wait before considering launch successful. + * Terminal processes are long-lived, so we don't wait for exit. + */ + successAfterMs?: number; + /** Whether to detach the process (default: true) */ + detached?: boolean; +} + +// ============================================================ +// Utility Functions +// ============================================================ + +/** + * Convert spawn error to human-readable string. + */ +function formatSpawnError(err: unknown): string { + if (err instanceof Error) { + const errnoErr = err as NodeJS.ErrnoException; + if (errnoErr.code) { + return `${errnoErr.code}: ${err.message}`; + } + return err.message; + } + return String(err); +} + +/** + * Format process exit information. + */ +function formatExitFailure(code: number | null, signal: NodeJS.Signals | null): string { + if (typeof code === 'number') { + return `Exit code ${code}`; + } + if (signal) { + return `Terminated by signal ${signal}`; + } + return 'Exited with unknown status'; +} + +// ============================================================ +// Launch Logic +// ============================================================ + +/** + * Attempt to launch a process. + * + * Strategy: + * - If spawn fails immediately (e.g., ENOENT): return failure + * - If process exits quickly with code 0: return success + * - If process exits quickly with non-zero: return failure + * - If process is still running after successAfterMs: return success + * (for long-lived terminal processes) + */ +async function tryLaunch(attempt: LaunchAttempt): Promise { + const successAfterMs = attempt.successAfterMs ?? 1500; + const detached = attempt.detached !== false; + + return new Promise((resolve) => { + let settled = false; + let timer: NodeJS.Timeout | null = null; + + const cleanup = () => { + if (timer) { + clearTimeout(timer); + timer = null; + } + child.removeAllListeners('error'); + child.removeAllListeners('exit'); + }; + + const child = spawn(attempt.cmd, attempt.args, { + shell: false, + stdio: 'ignore', + detached, + }); + + if (detached) { + // Let the child process continue independently + child.unref(); + } + + child.once('error', (err) => { + if (settled) return; + settled = true; + cleanup(); + resolve({ success: false, error: formatSpawnError(err) }); + }); + + child.once('exit', (code, signal) => { + if (settled) return; + settled = true; + cleanup(); + + if (code === 0) { + resolve({ success: true }); + } else { + resolve({ success: false, error: formatExitFailure(code, signal) }); + } + }); + + // If process is still running after timeout, consider it successful + timer = setTimeout(() => { + if (settled) return; + settled = true; + cleanup(); + resolve({ success: true }); + }, successAfterMs); + }); +} + +/** + * Try multiple launch attempts in sequence until one succeeds. + */ +async function runFallbackSequence(errorTitle: string, attempts: LaunchAttempt[]): Promise { + const errors: string[] = []; + + for (const attempt of attempts) { + const result = await tryLaunch(attempt); + if (result.success) { + return; + } + errors.push(`${attempt.label}: ${result.error}`); + } + + throw new Error(`${errorTitle}\n${errors.map((e) => ` - ${e}`).join('\n')}`); +} + +// ============================================================ +// VS Code +// ============================================================ + +/** + * Open directory in VS Code. + * + * Strategy: + * - All platforms: try 'code' command first + * - Windows: also try 'code.cmd' + * - macOS: fallback to 'open -b com.microsoft.VSCode' + */ +async function openInVSCode(absolutePath: string): Promise { + const platform = os.platform(); + + const attempts: LaunchAttempt[] = [ + { + label: 'code', + cmd: 'code', + args: [absolutePath], + successAfterMs: 8000, // VS Code takes time to start + }, + ]; + + // Windows: code.cmd is the batch wrapper + if (platform === 'win32') { + attempts.push({ + label: 'code.cmd', + cmd: 'code.cmd', + args: [absolutePath], + successAfterMs: 8000, + }); + } + + // macOS: fallback to bundle identifier + if (platform === 'darwin') { + attempts.push({ + label: 'open -b com.microsoft.VSCode', + cmd: 'open', + args: ['-b', 'com.microsoft.VSCode', absolutePath], + successAfterMs: 3000, + }); + } + + await runFallbackSequence(`Failed to open VS Code for: ${absolutePath}`, attempts); +} + +/** + * Open a file in VS Code at a specific line/column. + * + * Uses 'code -g file:line:col' syntax for goto functionality. + * Also opens the project root with -r to reuse existing window. + * + * Security: + * - Validates that file path stays within project root + * - Uses spawn with args array (no shell interpolation) + * + * @param projectRoot - Project root directory (for security validation and -r flag) + * @param filePath - File path (relative or absolute) + * @param line - Optional line number (1-based) + * @param column - Optional column number (1-based) + */ +export async function openFileInVSCode( + projectRoot: string, + filePath: string, + line?: number, + column?: number, +): Promise { + try { + // Validate project root + const projectValidation = await validateRootPath(projectRoot); + if (!projectValidation.valid) { + return { + success: false, + error: projectValidation.error ?? 'Invalid project rootPath', + }; + } + if (!projectValidation.exists) { + return { + success: false, + error: `Project directory does not exist: ${projectValidation.absolute}`, + }; + } + + const rootAbs = projectValidation.absolute; + + // Validate file path + const trimmedFile = String(filePath ?? '').trim(); + if (!trimmedFile) { + return { success: false, error: 'filePath is required' }; + } + + // Resolve file path with smart fallback + // Some frameworks (Vue/Vite) return paths like "/src/components/Foo.vue" which + // look absolute but are actually relative to project root. We try multiple strategies: + // 1. If path looks absolute and exists as-is, use it + // 2. Otherwise, strip leading slash and try as relative path + // 3. Finally, try as relative path directly + let absoluteFile: string = ''; + let fileExists = false; + + if (path.isAbsolute(trimmedFile)) { + // Try as true absolute path first + const asAbsolute = path.resolve(trimmedFile); + try { + const fileStat = await stat(asAbsolute); + if (fileStat.isFile()) { + absoluteFile = asAbsolute; + fileExists = true; + } + } catch { + // Not found as absolute path + } + + // If not found and path starts with /, try stripping it and treating as relative + if (!fileExists && trimmedFile.startsWith('/')) { + const strippedPath = trimmedFile.slice(1); + const asRelative = path.resolve(rootAbs, strippedPath); + try { + const fileStat = await stat(asRelative); + if (fileStat.isFile()) { + absoluteFile = asRelative; + fileExists = true; + } + } catch { + // Not found as relative path either + } + } + + // Default to absolute interpretation if nothing found + if (!absoluteFile) { + absoluteFile = path.resolve(trimmedFile); + } + } else { + // Relative path - resolve against project root + absoluteFile = path.resolve(rootAbs, trimmedFile); + } + + // Security: ensure file stays within project root + const relativeToRoot = path.relative(rootAbs, absoluteFile); + if (relativeToRoot.startsWith('..') || path.isAbsolute(relativeToRoot)) { + return { success: false, error: 'File path must be within project directory' }; + } + + // Check file exists + if (!fileExists) { + try { + const fileStat = await stat(absoluteFile); + if (!fileStat.isFile()) { + return { success: false, error: `Not a file: ${absoluteFile}` }; + } + } catch { + return { success: false, error: `File does not exist: ${absoluteFile}` }; + } + } + + // Validate and sanitize line/column + const safeLine = + typeof line === 'number' && Number.isFinite(line) && line > 0 ? Math.floor(line) : undefined; + const safeColumn = + typeof column === 'number' && Number.isFinite(column) && column > 0 + ? Math.floor(column) + : undefined; + + // Build goto argument: file:line:col + let gotoArg = absoluteFile; + if (safeLine) { + gotoArg += `:${safeLine}`; + if (safeColumn) { + gotoArg += `:${safeColumn}`; + } + } + + const platform = os.platform(); + + // Build launch attempts + // Use -r to reuse existing window, -g for goto + const attempts: LaunchAttempt[] = [ + { + label: 'code -r -g', + cmd: 'code', + args: ['-r', rootAbs, '-g', gotoArg], + successAfterMs: 8000, + }, + ]; + + if (platform === 'win32') { + attempts.push({ + label: 'code.cmd -r -g', + cmd: 'code.cmd', + args: ['-r', rootAbs, '-g', gotoArg], + successAfterMs: 8000, + }); + } + + if (platform === 'darwin') { + // macOS: use --args to pass flags to VS Code + attempts.push({ + label: 'open -b com.microsoft.VSCode --args', + cmd: 'open', + args: ['-b', 'com.microsoft.VSCode', '--args', '-r', rootAbs, '-g', gotoArg], + successAfterMs: 3000, + }); + } + + await runFallbackSequence(`Failed to open VS Code for: ${gotoArg}`, attempts); + return { success: true }; + } catch (error) { + return { success: false, error: formatSpawnError(error) }; + } +} + +// ============================================================ +// Terminal +// ============================================================ + +/** + * Open directory in system terminal. + */ +async function openInTerminal(absolutePath: string): Promise { + const platform = os.platform(); + + switch (platform) { + case 'darwin': + return openTerminalDarwin(absolutePath); + case 'win32': + return openTerminalWindows(absolutePath); + case 'linux': + return openTerminalLinux(absolutePath); + default: + throw new Error(`Unsupported platform: ${platform}`); + } +} + +/** + * macOS: Open Terminal.app with directory. + */ +async function openTerminalDarwin(absolutePath: string): Promise { + await runFallbackSequence(`Failed to open Terminal for: ${absolutePath}`, [ + { + label: 'open -a Terminal', + cmd: 'open', + args: ['-a', 'Terminal', absolutePath], + successAfterMs: 3000, + }, + ]); +} + +/** + * Windows: Open Windows Terminal or PowerShell. + */ +async function openTerminalWindows(absolutePath: string): Promise { + await runFallbackSequence(`Failed to open terminal for: ${absolutePath}`, [ + // Windows Terminal (wt) + { + label: 'wt -d', + cmd: 'wt', + args: ['-d', absolutePath], + successAfterMs: 3000, + }, + // PowerShell fallback - using -LiteralPath to handle special characters + // Use powershell.exe for better PATH compatibility + { + label: 'powershell.exe Set-Location', + cmd: 'powershell.exe', + args: ['-NoExit', '-Command', 'Set-Location -LiteralPath $args[0]', absolutePath], + successAfterMs: 1500, + }, + ]); +} + +/** + * Linux: Try common terminal emulators in sequence. + */ +async function openTerminalLinux(absolutePath: string): Promise { + await runFallbackSequence( + `Failed to open terminal for: ${absolutePath}. Please install gnome-terminal, konsole, xfce4-terminal, or xterm.`, + [ + // GNOME Terminal + { + label: 'gnome-terminal', + cmd: 'gnome-terminal', + args: ['--working-directory', absolutePath], + successAfterMs: 3000, + }, + // KDE Konsole + { + label: 'konsole', + cmd: 'konsole', + args: ['--workdir', absolutePath], + successAfterMs: 3000, + }, + // XFCE Terminal + { + label: 'xfce4-terminal', + cmd: 'xfce4-terminal', + args: ['--working-directory', absolutePath], + successAfterMs: 3000, + }, + // xterm (last resort) + { + label: 'xterm', + cmd: 'xterm', + // Use bash with positional parameter to safely pass the path + args: ['-e', 'bash', '-lc', 'cd -- "$1" && exec "${SHELL:-bash}"', '_', absolutePath], + successAfterMs: 3000, + }, + ], + ); +} + +// ============================================================ +// Public API +// ============================================================ + +/** + * Open a project directory in the specified target application. + * + * @param rootPath - The project directory path + * @param target - 'vscode' or 'terminal' + * @returns Response indicating success or failure with error message + */ +export async function openProjectDirectory( + rootPath: string, + target: OpenProjectTarget, +): Promise { + try { + // Validate path security and existence + const validation = await validateRootPath(rootPath); + + if (!validation.valid) { + return { + success: false, + error: validation.error ?? 'Invalid project rootPath', + }; + } + + if (!validation.exists) { + return { + success: false, + error: `Directory does not exist: ${validation.absolute}`, + }; + } + + const absolutePath = validation.absolute; + + // Open in target application + switch (target) { + case 'vscode': + await openInVSCode(absolutePath); + return { success: true }; + + case 'terminal': + await openInTerminal(absolutePath); + return { success: true }; + + default: { + // Type guard for exhaustive check + const _exhaustive: never = target; + return { + success: false, + error: `Unsupported target: ${String(_exhaustive)}`, + }; + } + } + } catch (error) { + return { + success: false, + error: formatSpawnError(error), + }; + } +} diff --git a/app/native-server/src/agent/project-service.ts b/app/native-server/src/agent/project-service.ts new file mode 100644 index 00000000..cf773ac1 --- /dev/null +++ b/app/native-server/src/agent/project-service.ts @@ -0,0 +1,284 @@ +/** + * Project Service - Database-backed implementation using Drizzle ORM. + * + * Provides CRUD operations for agent projects with: + * - Type-safe database queries + * - Path validation with security checks + * - Consistent with AgentProject interface from shared types + */ +import { randomUUID } from 'node:crypto'; +import { mkdir, stat } from 'node:fs/promises'; +import path from 'node:path'; +import os from 'node:os'; +import { eq, desc } from 'drizzle-orm'; +import type { AgentProject } from 'chrome-mcp-shared'; +import type { CreateOrUpdateProjectInput } from './project-types'; +import { getDb, projects, type ProjectRow } from './db'; + +// ============================================================ +// Security Configuration +// ============================================================ + +/** + * Allowed base directories for project roots. + * Only paths under these directories are considered safe. + */ +const ALLOWED_BASE_DIRS: string[] = [ + os.homedir(), + process.env.USERPROFILE, + process.env.MCP_ALLOWED_WORKSPACE_BASE, +].filter((dir): dir is string => typeof dir === 'string' && dir.length > 0); + +// ============================================================ +// Path Validation +// ============================================================ + +/** + * Result of path validation. + */ +export interface PathValidationResult { + valid: boolean; + absolute: string; + exists: boolean; + needsCreation: boolean; + error?: string; +} + +/** + * Validate a root path without creating it. + * Returns validation result including whether directory needs creation. + */ +export async function validateRootPath(rootPath: string): Promise { + const trimmed = rootPath.trim(); + if (!trimmed) { + return { + valid: false, + absolute: '', + exists: false, + needsCreation: false, + error: 'Project rootPath must not be empty', + }; + } + + const absolute = path.isAbsolute(trimmed) + ? path.resolve(trimmed) + : path.resolve(process.cwd(), trimmed); + + // Security check: ensure path is under allowed base directories + const isAllowed = ALLOWED_BASE_DIRS.some((base) => absolute.startsWith(path.resolve(base))); + + if (!isAllowed) { + return { + valid: false, + absolute, + exists: false, + needsCreation: false, + error: `Project rootPath must be under allowed directories: ${ALLOWED_BASE_DIRS.join(', ')}`, + }; + } + + // Check if path exists + try { + const s = await stat(absolute); + if (!s.isDirectory()) { + return { + valid: false, + absolute, + exists: true, + needsCreation: false, + error: `Path exists but is not a directory: ${absolute}`, + }; + } + return { valid: true, absolute, exists: true, needsCreation: false }; + } catch (err: unknown) { + const error = err as NodeJS.ErrnoException; + if (error.code === 'ENOENT') { + // Path doesn't exist but is valid - can be created + return { valid: true, absolute, exists: false, needsCreation: true }; + } + return { + valid: false, + absolute, + exists: false, + needsCreation: false, + error: error.message || 'Unknown error validating path', + }; + } +} + +/** + * Create a project directory after user confirmation. + * This should only be called after validateRootPath returns needsCreation: true. + */ +export async function createProjectDirectory(absolutePath: string): Promise { + // Re-validate for safety + const validation = await validateRootPath(absolutePath); + if (!validation.valid) { + throw new Error(validation.error || 'Invalid path'); + } + if (validation.exists) { + throw new Error('Directory already exists'); + } + await mkdir(absolutePath, { recursive: true }); +} + +/** + * Normalize and validate root path. + * @param rootPath - The path to normalize + * @param allowCreate - If true, create directory if it doesn't exist + */ +async function normalizeRootPath(rootPath: string, allowCreate = false): Promise { + const result = await validateRootPath(rootPath); + + if (!result.valid) { + throw new Error(result.error || 'Invalid path'); + } + + if (result.needsCreation) { + if (allowCreate) { + await mkdir(result.absolute, { recursive: true }); + } else { + throw new Error( + `Directory does not exist: ${result.absolute}. Use the validate-path API first and confirm creation with the user.`, + ); + } + } + + return result.absolute; +} + +// ============================================================ +// Type Conversion +// ============================================================ + +/** + * Convert database row to AgentProject interface. + */ +function rowToProject(row: ProjectRow): AgentProject { + return { + id: row.id, + name: row.name, + description: row.description ?? undefined, + rootPath: row.rootPath, + preferredCli: row.preferredCli as AgentProject['preferredCli'], + selectedModel: row.selectedModel ?? undefined, + activeClaudeSessionId: row.activeClaudeSessionId ?? undefined, + useCcr: row.useCcr === '1', + enableChromeMcp: row.enableChromeMcp !== '0', + createdAt: row.createdAt, + updatedAt: row.updatedAt, + lastActiveAt: row.lastActiveAt ?? undefined, + }; +} + +// ============================================================ +// Public API +// ============================================================ + +/** + * List all projects, sorted by last activity (most recent first). + */ +export async function listProjects(): Promise { + const db = getDb(); + const rows = await db.select().from(projects).orderBy(desc(projects.lastActiveAt)); + return rows.map(rowToProject); +} + +/** + * Get a single project by ID. + */ +export async function getProject(id: string): Promise { + const db = getDb(); + const rows = await db.select().from(projects).where(eq(projects.id, id)).limit(1); + return rows.length > 0 ? rowToProject(rows[0]) : undefined; +} + +/** + * Create or update a project. + */ +export async function upsertProject(input: CreateOrUpdateProjectInput): Promise { + const db = getDb(); + const now = new Date().toISOString(); + const rootPath = await normalizeRootPath(input.rootPath, input.allowCreate ?? false); + + const id = input.id?.trim() || randomUUID(); + const existing = await getProject(id); + + // Convert booleans to strings for SQLite storage: + // - useCcr: '1' or null (legacy) + // - enableChromeMcp: '1' or '0' (non-null; defaults to enabled) + const useCcrValue = + input.useCcr !== undefined ? (input.useCcr ? '1' : null) : existing?.useCcr ? '1' : null; + + let enableChromeMcpValue: '1' | '0'; + if (typeof input.enableChromeMcp === 'boolean') { + enableChromeMcpValue = input.enableChromeMcp ? '1' : '0'; + } else { + enableChromeMcpValue = existing?.enableChromeMcp === false ? '0' : '1'; + } + + const projectData = { + id, + name: input.name.trim(), + description: input.description?.trim() || existing?.description || null, + rootPath, + preferredCli: input.preferredCli ?? existing?.preferredCli ?? null, + selectedModel: input.selectedModel ?? existing?.selectedModel ?? null, + // Preserve activeClaudeSessionId from existing project (not settable via upsert) + activeClaudeSessionId: existing?.activeClaudeSessionId ?? null, + useCcr: useCcrValue, + enableChromeMcp: enableChromeMcpValue, + createdAt: existing?.createdAt || now, + updatedAt: now, + lastActiveAt: now, + }; + + if (existing) { + // Update existing project + await db.update(projects).set(projectData).where(eq(projects.id, id)); + } else { + // Insert new project + await db.insert(projects).values(projectData); + } + + return rowToProject(projectData as ProjectRow); +} + +/** + * Delete a project by ID. + * Messages are automatically deleted via cascade. + */ +export async function deleteProject(id: string): Promise { + const db = getDb(); + await db.delete(projects).where(eq(projects.id, id)); +} + +/** + * Update the last activity timestamp for a project. + */ +export async function touchProjectActivity(id: string): Promise { + const db = getDb(); + const now = new Date().toISOString(); + await db.update(projects).set({ lastActiveAt: now, updatedAt: now }).where(eq(projects.id, id)); +} + +/** + * Update the active Claude session ID for a project. + * This is called when the SDK returns a system/init message with a new session_id. + * Pass empty string or null to clear the session ID. + */ +export async function updateProjectClaudeSessionId( + id: string, + claudeSessionId: string | null, +): Promise { + const db = getDb(); + const now = new Date().toISOString(); + await db + .update(projects) + .set({ + // Store null if empty string is passed (to clear the session) + activeClaudeSessionId: claudeSessionId?.trim() || null, + updatedAt: now, + }) + .where(eq(projects.id, id)); +} diff --git a/app/native-server/src/agent/project-types.ts b/app/native-server/src/agent/project-types.ts new file mode 100644 index 00000000..e4f6434c --- /dev/null +++ b/app/native-server/src/agent/project-types.ts @@ -0,0 +1,30 @@ +/** + * Re-export AgentProject from shared package and define local input types. + */ +import type { AgentCliPreference, AgentProject } from 'chrome-mcp-shared'; + +// Re-export for backward compatibility +export type { AgentProject }; + +export interface CreateOrUpdateProjectInput { + id?: string; + name: string; + description?: string; + rootPath: string; + preferredCli?: AgentCliPreference; + selectedModel?: string; + /** + * Whether to use Claude Code Router (CCR) for this project. + */ + useCcr?: boolean; + /** + * Whether to enable the local Chrome MCP server integration for this project. + * Defaults to true when omitted. + */ + enableChromeMcp?: boolean; + /** + * If true, create the directory if it doesn't exist. + * Should only be set after user confirmation. + */ + allowCreate?: boolean; +} diff --git a/app/native-server/src/agent/session-service.ts b/app/native-server/src/agent/session-service.ts new file mode 100644 index 00000000..a92836e4 --- /dev/null +++ b/app/native-server/src/agent/session-service.ts @@ -0,0 +1,473 @@ +/** + * Session Service - Database-backed implementation using Drizzle ORM. + * + * Provides CRUD operations for agent sessions with: + * - Type-safe database queries + * - Engine-agnostic session configuration storage + * - JSON config and management info caching + */ +import { randomUUID } from 'node:crypto'; +import { eq, desc, and, asc } from 'drizzle-orm'; +import { getDb, sessions, messages, type SessionRow } from './db'; +import type { EngineName } from './engines/types'; + +// ============================================================ +// Types +// ============================================================ + +/** + * System prompt configuration options. + */ +export type SystemPromptConfig = + | { type: 'custom'; text: string } + | { type: 'preset'; preset: 'claude_code'; append?: string }; + +/** + * Tools configuration - can be a list of tool names or a preset. + */ +export type ToolsConfig = string[] | { type: 'preset'; preset: 'claude_code' }; + +/** + * Session options configuration (stored as JSON). + */ +export interface SessionOptionsConfig { + settingSources?: string[]; + allowedTools?: string[]; + disallowedTools?: string[]; + tools?: ToolsConfig; + betas?: string[]; + maxThinkingTokens?: number; + maxTurns?: number; + maxBudgetUsd?: number; + mcpServers?: Record; + outputFormat?: Record; + enableFileCheckpointing?: boolean; + sandbox?: Record; + env?: Record; + /** + * Optional Codex-specific configuration overrides. + * Only applicable when using CodexEngine. + */ + codexConfig?: Partial; +} + +/** + * Cached management information from Claude SDK. + */ +export interface ManagementInfo { + models?: Array<{ value: string; displayName: string; description: string }>; + commands?: Array<{ name: string; description: string; argumentHint: string }>; + account?: { email?: string; organization?: string; subscriptionType?: string }; + mcpServers?: Array<{ name: string; status: string }>; + tools?: string[]; + agents?: string[]; + /** Plugins with name and path (SDK returns { name, path }[]) */ + plugins?: Array<{ name: string; path?: string }>; + skills?: string[]; + slashCommands?: string[]; + model?: string; + permissionMode?: string; + cwd?: string; + outputStyle?: string; + betas?: string[]; + claudeCodeVersion?: string; + apiKeySource?: string; + lastUpdated?: string; +} + +/** + * Structured preview metadata for session list display. + * When present, allows rendering special styles (e.g., chip for web editor apply). + */ +export interface AgentSessionPreviewMeta { + /** Compact display text (e.g., user's message or "Apply changes") */ + displayText?: string; + /** Client metadata for special rendering */ + clientMeta?: { + kind?: 'web_editor_apply_batch' | 'web_editor_apply_single'; + pageUrl?: string; + elementCount?: number; + elementLabels?: string[]; + }; + /** Full content for tooltip preview (truncated to avoid payload bloat) */ + fullContent?: string; +} + +/** + * Agent session representation. + */ +export interface AgentSession { + id: string; + projectId: string; + engineName: string; + engineSessionId?: string; + name?: string; + /** Preview text from first user message, for display in session list */ + preview?: string; + /** Structured preview metadata for special rendering (e.g., web editor apply chip) */ + previewMeta?: AgentSessionPreviewMeta; + model?: string; + permissionMode: string; + allowDangerouslySkipPermissions: boolean; + systemPromptConfig?: SystemPromptConfig; + optionsConfig?: SessionOptionsConfig; + managementInfo?: ManagementInfo; + createdAt: string; + updatedAt: string; +} + +/** + * Options for creating a new session. + */ +export interface CreateSessionOptions { + id?: string; + engineSessionId?: string; + name?: string; + model?: string; + permissionMode?: string; + allowDangerouslySkipPermissions?: boolean; + systemPromptConfig?: SystemPromptConfig; + optionsConfig?: SessionOptionsConfig; +} + +/** + * Options for updating an existing session. + */ +export interface UpdateSessionInput { + engineSessionId?: string | null; + name?: string | null; + model?: string | null; + permissionMode?: string | null; + allowDangerouslySkipPermissions?: boolean | null; + systemPromptConfig?: SystemPromptConfig | null; + optionsConfig?: SessionOptionsConfig | null; + managementInfo?: ManagementInfo | null; +} + +// ============================================================ +// JSON Parsing Utilities +// ============================================================ + +function parseJson(value: string | null): T | undefined { + if (!value) return undefined; + try { + return JSON.parse(value) as T; + } catch { + return undefined; + } +} + +function stringifyJson(value: T | null | undefined): string | null { + if (value === null || value === undefined) return null; + return JSON.stringify(value); +} + +// ============================================================ +// Type Conversion +// ============================================================ + +function rowToSession(row: SessionRow): AgentSession { + return { + id: row.id, + projectId: row.projectId, + engineName: row.engineName, + engineSessionId: row.engineSessionId ?? undefined, + name: row.name ?? undefined, + model: row.model ?? undefined, + permissionMode: row.permissionMode, + allowDangerouslySkipPermissions: row.allowDangerouslySkipPermissions === '1', + systemPromptConfig: parseJson(row.systemPromptConfig), + optionsConfig: parseJson(row.optionsConfig), + managementInfo: parseJson(row.managementInfo), + createdAt: row.createdAt, + updatedAt: row.updatedAt, + }; +} + +// ============================================================ +// Public API +// ============================================================ + +/** + * Create a new session for a project. + */ +export async function createSession( + projectId: string, + engineName: EngineName, + options: CreateSessionOptions = {}, +): Promise { + const db = getDb(); + const now = new Date().toISOString(); + + // Resolve permission mode - AgentChat defaults to bypassPermissions for headless operation + const resolvedPermissionMode = options.permissionMode?.trim() || 'bypassPermissions'; + + // SDK requires allowDangerouslySkipPermissions=true when using bypassPermissions mode + // If explicitly provided, use that value; otherwise infer from permission mode + const resolvedAllowDangerouslySkipPermissions = + typeof options.allowDangerouslySkipPermissions === 'boolean' + ? options.allowDangerouslySkipPermissions + : resolvedPermissionMode === 'bypassPermissions'; + + const sessionData = { + id: options.id?.trim() || randomUUID(), + projectId, + engineName, + engineSessionId: options.engineSessionId?.trim() || null, + name: options.name?.trim() || null, + model: options.model?.trim() || null, + permissionMode: resolvedPermissionMode, + allowDangerouslySkipPermissions: resolvedAllowDangerouslySkipPermissions ? '1' : null, + systemPromptConfig: stringifyJson(options.systemPromptConfig), + optionsConfig: stringifyJson(options.optionsConfig), + managementInfo: null, + createdAt: now, + updatedAt: now, + }; + + await db.insert(sessions).values(sessionData); + return rowToSession(sessionData as SessionRow); +} + +/** + * Get a session by ID. + */ +export async function getSession(sessionId: string): Promise { + const db = getDb(); + const rows = await db.select().from(sessions).where(eq(sessions.id, sessionId)).limit(1); + return rows.length > 0 ? rowToSession(rows[0]) : undefined; +} + +/** Maximum length for preview text */ +const MAX_PREVIEW_LENGTH = 50; + +/** + * Truncate text to max length with ellipsis. + */ +function truncatePreview(text: string, maxLength: number = MAX_PREVIEW_LENGTH): string { + const trimmed = text.trim().replace(/\s+/g, ' '); + if (trimmed.length <= maxLength) return trimmed; + return trimmed.slice(0, maxLength - 1) + '…'; +} + +/** + * Add preview to sessions by fetching first user message for each. + * Shared helper to avoid code duplication. + */ +async function addPreviewsToSessions(rows: SessionRow[]): Promise { + const db = getDb(); + + return Promise.all( + rows.map(async (row) => { + const session = rowToSession(row); + + // Query first user message for this session (include metadata for special rendering) + const firstUserMessages = await db + .select({ content: messages.content, metadata: messages.metadata }) + .from(messages) + .where(and(eq(messages.sessionId, row.id), eq(messages.role, 'user'))) + .orderBy(asc(messages.createdAt)) + .limit(1); + + if (firstUserMessages.length > 0 && firstUserMessages[0].content) { + const content = firstUserMessages[0].content; + const metadataJson = firstUserMessages[0].metadata; + + session.preview = truncatePreview(content); + + // Parse metadata to extract clientMeta/displayText for special rendering + if (metadataJson) { + try { + const parsed = JSON.parse(metadataJson) as Record; + + // Type-safe extraction with validation + const rawClientMeta = parsed.clientMeta; + const rawDisplayText = parsed.displayText; + + // Validate displayText is a string + const displayText = typeof rawDisplayText === 'string' ? rawDisplayText : undefined; + + // Validate clientMeta structure + const clientMeta = + rawClientMeta && + typeof rawClientMeta === 'object' && + 'kind' in rawClientMeta && + (rawClientMeta.kind === 'web_editor_apply_batch' || + rawClientMeta.kind === 'web_editor_apply_single') + ? (rawClientMeta as AgentSessionPreviewMeta['clientMeta']) + : undefined; + + // Only set previewMeta if we have valid special metadata + if (clientMeta || displayText) { + session.previewMeta = { + displayText: displayText || truncatePreview(content), + clientMeta, + // Truncate fullContent to avoid payload bloat (200 chars max) + fullContent: truncatePreview(content, 200), + }; + } + } catch { + // Ignore JSON parse errors, just use plain preview + } + } + } + + return session; + }), + ); +} + +/** + * Get all sessions for a project, sorted by most recently updated. + * Includes preview from first user message for each session. + */ +export async function getSessionsByProject(projectId: string): Promise { + const db = getDb(); + const rows = await db + .select() + .from(sessions) + .where(eq(sessions.projectId, projectId)) + .orderBy(desc(sessions.updatedAt)); + + return addPreviewsToSessions(rows); +} + +/** + * Get all sessions across all projects, sorted by most recently updated. + * Includes preview from first user message for each session. + */ +export async function getAllSessions(): Promise { + const db = getDb(); + const rows = await db.select().from(sessions).orderBy(desc(sessions.updatedAt)); + + return addPreviewsToSessions(rows); +} + +/** + * Get sessions for a project filtered by engine name. + */ +export async function getSessionsByProjectAndEngine( + projectId: string, + engineName: EngineName, +): Promise { + const db = getDb(); + const rows = await db + .select() + .from(sessions) + .where(and(eq(sessions.projectId, projectId), eq(sessions.engineName, engineName))) + .orderBy(desc(sessions.updatedAt)); + return rows.map(rowToSession); +} + +/** + * Update an existing session. + */ +export async function updateSession(sessionId: string, updates: UpdateSessionInput): Promise { + const db = getDb(); + const now = new Date().toISOString(); + + const updateData: Record = { + updatedAt: now, + }; + + if (updates.engineSessionId !== undefined) { + updateData.engineSessionId = updates.engineSessionId?.trim() || null; + } + + if (updates.name !== undefined) { + updateData.name = updates.name?.trim() || null; + } + + if (updates.model !== undefined) { + updateData.model = updates.model?.trim() || null; + } + + if (updates.permissionMode !== undefined) { + updateData.permissionMode = updates.permissionMode?.trim() || 'bypassPermissions'; + } + + if (updates.allowDangerouslySkipPermissions !== undefined) { + updateData.allowDangerouslySkipPermissions = updates.allowDangerouslySkipPermissions + ? '1' + : null; + } + + if (updates.systemPromptConfig !== undefined) { + updateData.systemPromptConfig = stringifyJson(updates.systemPromptConfig); + } + + if (updates.optionsConfig !== undefined) { + updateData.optionsConfig = stringifyJson(updates.optionsConfig); + } + + if (updates.managementInfo !== undefined) { + updateData.managementInfo = stringifyJson(updates.managementInfo); + } + + await db.update(sessions).set(updateData).where(eq(sessions.id, sessionId)); +} + +/** + * Delete a session by ID. + * Note: Messages associated with this session are NOT automatically deleted. + * The caller should handle message cleanup if needed. + */ +export async function deleteSession(sessionId: string): Promise { + const db = getDb(); + await db.delete(sessions).where(eq(sessions.id, sessionId)); +} + +/** + * Update the engine session ID (e.g., Claude SDK session_id). + */ +export async function updateEngineSessionId( + sessionId: string, + engineSessionId: string | null, +): Promise { + await updateSession(sessionId, { engineSessionId }); +} + +/** + * Touch session activity - updates the updatedAt timestamp. + * Used when a message is sent to move the session to the top of the list. + */ +export async function touchSessionActivity(sessionId: string): Promise { + const db = getDb(); + const now = new Date().toISOString(); + await db.update(sessions).set({ updatedAt: now }).where(eq(sessions.id, sessionId)); +} + +/** + * Update the cached management information. + */ +export async function updateManagementInfo( + sessionId: string, + info: ManagementInfo | null, +): Promise { + // Add timestamp to management info + const infoWithTimestamp = info ? { ...info, lastUpdated: new Date().toISOString() } : null; + await updateSession(sessionId, { managementInfo: infoWithTimestamp }); +} + +/** + * Get or create a default session for a project and engine. + * Useful for backwards compatibility - creates a session if none exists. + */ +export async function getOrCreateDefaultSession( + projectId: string, + engineName: EngineName, + options: CreateSessionOptions = {}, +): Promise { + const existingSessions = await getSessionsByProjectAndEngine(projectId, engineName); + + if (existingSessions.length > 0) { + // Return the most recently updated session + return existingSessions[0]; + } + + // Create a new default session + return createSession(projectId, engineName, { + ...options, + name: options.name || `Default ${engineName} session`, + }); +} diff --git a/app/native-server/src/agent/storage.ts b/app/native-server/src/agent/storage.ts new file mode 100644 index 00000000..5bc9309f --- /dev/null +++ b/app/native-server/src/agent/storage.ts @@ -0,0 +1,68 @@ +/** + * Storage path helpers for agent-related state. + * + * Provides unified path resolution for: + * - SQLite database file + * - Data directory + * - Default workspace directory + * + * All paths can be overridden via environment variables. + */ +import os from 'node:os'; +import path from 'node:path'; + +const DEFAULT_DATA_DIR = path.join(os.homedir(), '.chrome-mcp-agent'); + +/** + * Resolve base data directory for agent state. + * + * Environment: + * - CHROME_MCP_AGENT_DATA_DIR: overrides the default base directory. + */ +export function getAgentDataDir(): string { + const raw = process.env.CHROME_MCP_AGENT_DATA_DIR; + if (raw && raw.trim()) { + return path.resolve(raw.trim()); + } + return DEFAULT_DATA_DIR; +} + +/** + * Resolve database file path. + * + * Environment: + * - CHROME_MCP_AGENT_DB_FILE: overrides the default database path. + */ +export function getDatabasePath(): string { + const raw = process.env.CHROME_MCP_AGENT_DB_FILE; + if (raw && raw.trim()) { + return path.resolve(raw.trim()); + } + return path.join(getAgentDataDir(), 'agent.db'); +} + +/** + * Get the default workspace directory for agent projects. + * This is a subdirectory under the agent data directory. + * + * Cross-platform compatible: + * - Mac/Linux: ~/.chrome-mcp-agent/workspaces + * - Windows: %USERPROFILE%\.chrome-mcp-agent\workspaces + */ +export function getDefaultWorkspaceDir(): string { + return path.join(getAgentDataDir(), 'workspaces'); +} + +/** + * Generate a default project root path for a given project name. + */ +export function getDefaultProjectRoot(projectName: string): string { + // Sanitize project name for use as directory name + const safeName = projectName + .trim() + .toLowerCase() + .replace(/[^a-z0-9_-]/g, '-') + .replace(/-+/g, '-') + .replace(/^-|-$/g, ''); + return path.join(getDefaultWorkspaceDir(), safeName || 'default-project'); +} diff --git a/app/native-server/src/agent/stream-manager.ts b/app/native-server/src/agent/stream-manager.ts new file mode 100644 index 00000000..12b15a69 --- /dev/null +++ b/app/native-server/src/agent/stream-manager.ts @@ -0,0 +1,266 @@ +import type { ServerResponse } from 'node:http'; +import type { RealtimeEvent } from './types'; + +type WebSocketLike = { + readyState?: number; + send(data: string): void; + close?: () => void; +}; + +const WEBSOCKET_OPEN_STATE = 1; + +/** + * AgentStreamManager manages SSE/WebSocket connections keyed by sessionId. + * + * 中文说明：此实现参考 other/cweb 中的 StreamManager，但适配 Fastify/Node HTTP， + * 使用 ServerResponse 直接写入 SSE 数据，避免在 Node 环境中额外引入 Web Streams 依赖。 + */ +export class AgentStreamManager { + private readonly sseClients = new Map>(); + private readonly webSocketClients = new Map>(); + private heartbeatTimer: NodeJS.Timeout | null = null; + + addSseStream(sessionId: string, res: ServerResponse): void { + if (!this.sseClients.has(sessionId)) { + this.sseClients.set(sessionId, new Set()); + } + this.sseClients.get(sessionId)!.add(res); + this.ensureHeartbeatTimer(); + } + + removeSseStream(sessionId: string, res: ServerResponse): void { + const clients = this.sseClients.get(sessionId); + if (!clients) { + return; + } + + clients.delete(res); + if (clients.size === 0) { + this.sseClients.delete(sessionId); + } + + this.stopHeartbeatTimerIfIdle(); + } + + addWebSocket(sessionId: string, socket: WebSocketLike): void { + if (!this.webSocketClients.has(sessionId)) { + this.webSocketClients.set(sessionId, new Set()); + } + this.webSocketClients.get(sessionId)!.add(socket); + this.ensureHeartbeatTimer(); + } + + removeWebSocket(sessionId: string, socket: WebSocketLike): void { + const sockets = this.webSocketClients.get(sessionId); + if (!sockets) { + return; + } + + sockets.delete(socket); + if (sockets.size === 0) { + this.webSocketClients.delete(sessionId); + } + + this.stopHeartbeatTimerIfIdle(); + } + + publish(event: RealtimeEvent): void { + const payload = JSON.stringify(event); + const ssePayload = `data: ${payload}\n\n`; + + // Heartbeat events are broadcast to all connections to keep them alive. + if (event.type === 'heartbeat') { + this.broadcastToAll(ssePayload, payload); + return; + } + + // For all other event types, require a sessionId for routing. + const targetSessionId = this.extractSessionId(event); + if (!targetSessionId) { + // Drop events without sessionId to prevent cross-session leakage. + + console.warn('[AgentStreamManager] Dropping event without sessionId:', event.type); + return; + } + + // Session-scoped routing: only send to clients subscribed to this session. + this.sendToSession(targetSessionId, ssePayload, payload); + } + + /** + * Extract sessionId from event based on event type. + */ + private extractSessionId(event: RealtimeEvent): string | undefined { + switch (event.type) { + case 'message': + return event.data?.sessionId; + case 'status': + return event.data?.sessionId; + case 'connected': + return event.data?.sessionId; + case 'error': + return event.data?.sessionId; + case 'usage': + return event.data?.sessionId; + case 'heartbeat': + return undefined; + default: + return undefined; + } + } + + /** + * Send event to a specific session's clients only. + */ + private sendToSession(sessionId: string, ssePayload: string, wsPayload: string): void { + // SSE clients + const sseClients = this.sseClients.get(sessionId); + if (sseClients) { + const deadClients: ServerResponse[] = []; + for (const res of sseClients) { + if (this.isResponseDead(res)) { + deadClients.push(res); + continue; + } + try { + res.write(ssePayload); + } catch { + deadClients.push(res); + } + } + for (const res of deadClients) { + this.removeSseStream(sessionId, res); + } + } + + // WebSocket clients + const wsSockets = this.webSocketClients.get(sessionId); + if (wsSockets) { + const deadSockets: WebSocketLike[] = []; + for (const socket of wsSockets) { + if (this.isSocketDead(socket)) { + deadSockets.push(socket); + continue; + } + try { + socket.send(wsPayload); + } catch { + deadSockets.push(socket); + } + } + for (const socket of deadSockets) { + this.removeWebSocket(sessionId, socket); + } + } + } + + /** + * Broadcast event to all connected clients (used for heartbeat). + */ + private broadcastToAll(ssePayload: string, wsPayload: string): void { + const deadSse: Array<{ sessionId: string; res: ServerResponse }> = []; + for (const [sessionId, clients] of this.sseClients.entries()) { + for (const res of clients) { + if (this.isResponseDead(res)) { + deadSse.push({ sessionId, res }); + continue; + } + try { + res.write(ssePayload); + } catch { + deadSse.push({ sessionId, res }); + } + } + } + for (const { sessionId, res } of deadSse) { + this.removeSseStream(sessionId, res); + } + + const deadSockets: Array<{ sessionId: string; socket: WebSocketLike }> = []; + for (const [sessionId, sockets] of this.webSocketClients.entries()) { + for (const socket of sockets) { + if (this.isSocketDead(socket)) { + deadSockets.push({ sessionId, socket }); + continue; + } + try { + socket.send(wsPayload); + } catch { + deadSockets.push({ sessionId, socket }); + } + } + } + for (const { sessionId, socket } of deadSockets) { + this.removeWebSocket(sessionId, socket); + } + } + + private isResponseDead(res: ServerResponse): boolean { + return (res as any).writableEnded || (res as any).destroyed; + } + + private isSocketDead(socket: WebSocketLike): boolean { + return socket.readyState !== undefined && socket.readyState !== WEBSOCKET_OPEN_STATE; + } + + closeAll(): void { + for (const [sessionId, clients] of this.sseClients.entries()) { + for (const res of clients) { + try { + res.end(); + } catch { + // Ignore errors during shutdown. + } + } + this.sseClients.delete(sessionId); + } + + for (const [sessionId, sockets] of this.webSocketClients.entries()) { + for (const socket of sockets) { + try { + socket.close?.(); + } catch { + // Ignore errors during shutdown. + } + } + this.webSocketClients.delete(sessionId); + } + + this.stopHeartbeatTimer(); + } + + private ensureHeartbeatTimer(): void { + if (this.heartbeatTimer) { + return; + } + + this.heartbeatTimer = setInterval(() => { + if (this.sseClients.size === 0 && this.webSocketClients.size === 0) { + this.stopHeartbeatTimer(); + return; + } + + const event: RealtimeEvent = { + type: 'heartbeat', + data: { timestamp: new Date().toISOString() }, + }; + this.publish(event); + }, 30_000); + + // Allow Node process to exit naturally even if heartbeat is active. + this.heartbeatTimer.unref?.(); + } + + private stopHeartbeatTimerIfIdle(): void { + if (this.sseClients.size === 0 && this.webSocketClients.size === 0) { + this.stopHeartbeatTimer(); + } + } + + private stopHeartbeatTimer(): void { + if (this.heartbeatTimer) { + clearInterval(this.heartbeatTimer); + this.heartbeatTimer = null; + } + } +} diff --git a/app/native-server/src/agent/tool-bridge.ts b/app/native-server/src/agent/tool-bridge.ts new file mode 100644 index 00000000..b3ddfccc --- /dev/null +++ b/app/native-server/src/agent/tool-bridge.ts @@ -0,0 +1,82 @@ +import { Client } from '@modelcontextprotocol/sdk/client/index.js'; +import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'; +import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js'; +import { NATIVE_SERVER_PORT } from '../constant/index.js'; + +export interface CliToolInvocation { + /** + * The MCP server identifier (if provided by CLI). + * When omitted, this bridge defaults to the local chrome MCP server. + */ + server?: string; + /** + * The MCP tool name to invoke. + */ + tool: string; + /** + * JSON-serializable arguments for the tool call. + */ + args?: Record; +} + +export interface AgentToolBridgeOptions { + /** + * Base URL of the local MCP HTTP endpoint (e.g. http://127.0.0.1:12306/mcp). + * If omitted, DEFAULT_SERVER_PORT from chrome-mcp-shared is used. + */ + mcpUrl?: string; +} + +/** + * AgentToolBridge maps CLI tool events (Codex, etc.) to MCP tool calls + * against the local chrome MCP server via the official MCP SDK client. + * + * 中文说明：该桥接层负责将 CLI 上报的工具调用统一转为标准 MCP CallTool 请求， + * 复用现有 /mcp HTTP server，而不是在本项目内自研额外协议。 + */ +export class AgentToolBridge { + private readonly client: Client; + private readonly transport: StreamableHTTPClientTransport; + + constructor(options: AgentToolBridgeOptions = {}) { + const url = + options.mcpUrl || `http://127.0.0.1:${process.env.MCP_HTTP_PORT || NATIVE_SERVER_PORT}/mcp`; + + this.transport = new StreamableHTTPClientTransport(new URL(url)); + this.client = new Client( + { + name: 'chrome-mcp-agent-bridge', + version: '1.0.0', + }, + {}, + ); + } + + /** + * Connects the MCP client over Streamable HTTP if not already connected. + */ + async ensureConnected(): Promise { + // Client.connect is idempotent; repeated calls reuse the same transport session. + if ((this.transport as any)._sessionId) { + return; + } + await this.client.connect(this.transport); + } + + /** + * Invoke an MCP tool based on a CLI tool event. + * Returns the raw result from MCP client.callTool(). + */ + async callTool(invocation: CliToolInvocation): Promise { + await this.ensureConnected(); + + const args = invocation.args ?? {}; + const result = await this.client.callTool({ + name: invocation.tool, + arguments: args, + }); + + // The SDK returns a compatible structure; cast to satisfy strict typing. + return result as unknown as CallToolResult; + } +} diff --git a/app/native-server/src/agent/types.ts b/app/native-server/src/agent/types.ts new file mode 100644 index 00000000..48134b90 --- /dev/null +++ b/app/native-server/src/agent/types.ts @@ -0,0 +1,21 @@ +/** + * Re-export agent types from shared package for backward compatibility. + * All types are now defined in packages/shared/src/agent-types.ts to ensure + * consistency between native-server and chrome-extension. + */ +export { + type AgentRole, + type AgentMessage, + type StreamTransport, + type AgentStatusEvent, + type AgentConnectedEvent, + type AgentHeartbeatEvent, + type RealtimeEvent, + type AgentAttachment, + type AgentCliPreference, + type AgentActRequest, + type AgentActResponse, + type AgentProject, + type AgentEngineInfo, + type AgentStoredMessage, +} from 'chrome-mcp-shared'; diff --git a/app/native-server/src/cli.ts b/app/native-server/src/cli.ts index 90e57209..11d4b5a3 100644 --- a/app/native-server/src/cli.ts +++ b/app/native-server/src/cli.ts @@ -8,22 +8,11 @@ import { colorText, registerWithElevatedPermissions, ensureExecutionPermissions, + writeNodePathFile, } from './scripts/utils'; import { BrowserType, parseBrowserType, detectInstalledBrowsers } from './scripts/browser-config'; - -// Import writeNodePath from postinstall -async function writeNodePath(): Promise { - try { - const nodePath = process.execPath; - const nodePathFile = path.join(__dirname, 'node_path.txt'); - - console.log(colorText(`Writing Node.js path: ${nodePath}`, 'blue')); - fs.writeFileSync(nodePathFile, nodePath, 'utf8'); - console.log(colorText('✓ Node.js path written for run_host scripts', 'green')); - } catch (error: any) { - console.warn(colorText(`⚠️ Failed to write Node.js path: ${error.message}`, 'yellow')); - } -} +import { runDoctor } from './scripts/doctor'; +import { runReport } from './scripts/report'; program .version(require('../package.json').version) @@ -40,7 +29,7 @@ program .action(async (options) => { try { // Write Node.js path for run_host scripts - await writeNodePath(); + writeNodePathFile(__dirname); // Determine which browsers to register let targetBrowsers: BrowserType[] | undefined; @@ -188,6 +177,56 @@ program } }); +// Diagnose installation and environment issues +program + .command('doctor') + .description('Diagnose installation and environment issues') + .option('--json', 'Output diagnostics as JSON') + .option('--fix', 'Attempt to fix common issues automatically') + .option('-b, --browser ', 'Target browser (chrome, chromium, or all)') + .action(async (options) => { + try { + const exitCode = await runDoctor({ + json: Boolean(options.json), + fix: Boolean(options.fix), + browser: options.browser, + }); + process.exit(exitCode); + } catch (error: any) { + console.error(colorText(`Doctor failed: ${error.message}`, 'red')); + process.exit(1); + } + }); + +// Export diagnostic report for GitHub Issues +program + .command('report') + .description('Export a diagnostic report for GitHub Issues') + .option('--json', 'Output report as JSON (default: Markdown)') + .option('--output ', 'Write report to file instead of stdout') + .option('--copy', 'Copy report to clipboard') + .option('--no-redact', 'Disable redaction of usernames/paths/tokens') + .option('--include-logs ', 'Include wrapper logs: none | tail | full', 'tail') + .option('--log-lines ', 'Lines to include when --include-logs=tail', '200') + .option('-b, --browser ', 'Target browser (chrome, chromium, or all)') + .action(async (options) => { + try { + const exitCode = await runReport({ + json: Boolean(options.json), + output: options.output, + copy: Boolean(options.copy), + redact: options.redact, + includeLogs: options.includeLogs, + logLines: options.logLines ? parseInt(options.logLines, 10) : undefined, + browser: options.browser, + }); + process.exit(exitCode); + } catch (error: any) { + console.error(colorText(`Report failed: ${error.message}`, 'red')); + process.exit(1); + } + }); + program.parse(process.argv); // If no command provided, show help diff --git a/app/native-server/src/constant/index.ts b/app/native-server/src/constant/index.ts index 2757f3b2..9785d0ab 100644 --- a/app/native-server/src/constant/index.ts +++ b/app/native-server/src/constant/index.ts @@ -8,7 +8,7 @@ export enum NATIVE_MESSAGE_TYPE { ERROR = 'error', } -export const NATIVE_SERVER_PORT = 56889; +export const NATIVE_SERVER_PORT = 12306; // Timeout constants (in milliseconds) export const TIMEOUTS = { @@ -20,15 +20,21 @@ export const TIMEOUTS = { // Server configuration export const SERVER_CONFIG = { HOST: '127.0.0.1', - CORS_ORIGIN: true, + /** + * CORS origin whitelist - only allow Chrome/Firefox extensions and local debugging. + * Use RegExp patterns for extension origins, string for exact match. + */ + CORS_ORIGIN: [/^chrome-extension:\/\//, /^moz-extension:\/\//, 'http://127.0.0.1'] as const, LOGGER_ENABLED: false, } as const; // HTTP Status codes export const HTTP_STATUS = { OK: 200, + CREATED: 201, NO_CONTENT: 204, BAD_REQUEST: 400, + NOT_FOUND: 404, INTERNAL_SERVER_ERROR: 500, GATEWAY_TIMEOUT: 504, } as const; @@ -45,3 +51,32 @@ export const ERROR_MESSAGES = { MCP_REQUEST_PROCESSING_ERROR: 'Internal server error during MCP request processing.', INVALID_SSE_SESSION: 'Invalid or missing MCP session ID for SSE.', } as const; + +// ============================================================ +// Chrome MCP Server Configuration +// ============================================================ + +/** + * Environment variables for dynamically resolving the local MCP HTTP endpoint. + * CHROME_MCP_PORT is the preferred source; MCP_HTTP_PORT is kept for backward compatibility. + */ +export const CHROME_MCP_PORT_ENV = 'CHROME_MCP_PORT'; +export const MCP_HTTP_PORT_ENV = 'MCP_HTTP_PORT'; + +/** + * Get the actual port the Chrome MCP server is listening on. + * Priority: CHROME_MCP_PORT env > MCP_HTTP_PORT env > NATIVE_SERVER_PORT default + */ +export function getChromeMcpPort(): number { + const raw = process.env[CHROME_MCP_PORT_ENV] || process.env[MCP_HTTP_PORT_ENV]; + const port = raw ? Number.parseInt(String(raw), 10) : NaN; + return Number.isFinite(port) && port > 0 && port <= 65535 ? port : NATIVE_SERVER_PORT; +} + +/** + * Get the full URL to the local Chrome MCP HTTP endpoint. + * This URL is used by Claude/Codex agents to connect to the MCP server. + */ +export function getChromeMcpUrl(): string { + return `http://${SERVER_CONFIG.HOST}:${getChromeMcpPort()}/mcp`; +} diff --git a/app/native-server/src/file-handler.ts b/app/native-server/src/file-handler.ts index 5f86aeed..577ae139 100644 --- a/app/native-server/src/file-handler.ts +++ b/app/native-server/src/file-handler.ts @@ -22,7 +22,7 @@ export class FileHandler { * Handle file preparation request from the extension */ async handleFileRequest(request: any): Promise { - const { action, fileUrl, base64Data, fileName, filePath } = request; + const { action, fileUrl, base64Data, fileName, filePath, traceFilePath, insightName } = request; try { switch (action) { @@ -36,9 +36,29 @@ export class FileHandler { } break; + case 'readBase64File': { + if (!filePath) return { success: false, error: 'filePath is required' }; + return await this.readBase64File(filePath); + } + case 'cleanupFile': return await this.cleanupFile(filePath); + case 'analyzeTrace': { + const targetPath = traceFilePath || filePath; + if (!targetPath) { + return { success: false, error: 'traceFilePath is required' }; + } + try { + // With tsconfig moduleResolution=NodeNext, relative ESM imports need explicit .js extension + const { analyzeTraceFile } = await import('./trace-analyzer.js'); + const res = await analyzeTraceFile(targetPath, insightName); + return { success: true, ...res }; + } catch (e: any) { + return { success: false, error: e?.message || String(e) }; + } + } + default: return { success: false, @@ -91,7 +111,7 @@ export class FileHandler { try { // Remove data URL prefix if present const base64Content = base64Data.replace(/^data:.*?;base64,/, ''); - + // Convert base64 to buffer const buffer = Buffer.from(base64Content, 'base64'); @@ -145,6 +165,35 @@ export class FileHandler { } } + /** + * Read file content and return as base64 string + */ + private async readBase64File(filePath: string): Promise { + try { + if (!fs.existsSync(filePath)) { + throw new Error(`File does not exist: ${filePath}`); + } + const stats = fs.statSync(filePath); + if (!stats.isFile()) { + throw new Error(`Path is not a file: ${filePath}`); + } + const buf = fs.readFileSync(filePath); + const base64 = buf.toString('base64'); + return { + success: true, + filePath, + fileName: path.basename(filePath), + size: stats.size, + base64Data: base64, + }; + } catch (error) { + return { + success: false, + error: `Failed to read file: ${error instanceof Error ? error.message : String(error)}`, + }; + } + } + /** * Clean up a temporary file */ @@ -213,7 +262,8 @@ export class FileHandler { const stats = fs.statSync(filePath); if (now - stats.mtimeMs > oneHour) { fs.unlinkSync(filePath); - console.log(`Cleaned up old temp file: ${file}`); + // Use stderr to avoid polluting stdout (Native Messaging protocol) + console.error(`Cleaned up old temp file: ${file}`); } } } catch (error) { @@ -222,4 +272,4 @@ export class FileHandler { } } -export default new FileHandler(); \ No newline at end of file +export default new FileHandler(); diff --git a/app/native-server/src/mcp/mcp-server-stdio.ts b/app/native-server/src/mcp/mcp-server-stdio.ts index 9a1d0fde..b7bb1e83 100644 --- a/app/native-server/src/mcp/mcp-server-stdio.ts +++ b/app/native-server/src/mcp/mcp-server-stdio.ts @@ -95,8 +95,10 @@ const handleToolCall = async (name: string, args: any): Promise if (!client) { throw new Error('Failed to connect to MCP server'); } + // Use a sane default of 2 minutes; the previous value mistakenly used 2*6*1000 (12s) + const DEFAULT_CALL_TIMEOUT_MS = 2 * 60 * 1000; const result = await client.callTool({ name, arguments: args }, undefined, { - timeout: 2 * 6 * 1000, // Default timeout of 2 minute + timeout: DEFAULT_CALL_TIMEOUT_MS, }); return result as CallToolResult; } catch (error: any) { diff --git a/app/native-server/src/mcp/register-tools.ts b/app/native-server/src/mcp/register-tools.ts index f917d8ea..28846525 100644 --- a/app/native-server/src/mcp/register-tools.ts +++ b/app/native-server/src/mcp/register-tools.ts @@ -6,10 +6,72 @@ import { } from '@modelcontextprotocol/sdk/types.js'; import nativeMessagingHostInstance from '../native-messaging-host'; import { NativeMessageType, TOOL_SCHEMAS } from 'chrome-mcp-shared'; +import type { Tool } from '@modelcontextprotocol/sdk/types.js'; + +async function listDynamicFlowTools(): Promise { + try { + const response = await nativeMessagingHostInstance.sendRequestToExtensionAndWait( + {}, + 'rr_list_published_flows', + 20000, + ); + if (response && response.status === 'success' && Array.isArray(response.items)) { + const tools: Tool[] = []; + for (const item of response.items) { + const name = `flow.${item.slug}`; + const description = + (item.meta && item.meta.tool && item.meta.tool.description) || + item.description || + 'Recorded flow'; + const properties: Record = {}; + const required: string[] = []; + for (const v of item.variables || []) { + const desc = v.label || v.key; + const typ = (v.type || 'string').toLowerCase(); + const prop: any = { description: desc }; + if (typ === 'boolean') prop.type = 'boolean'; + else if (typ === 'number') prop.type = 'number'; + else if (typ === 'enum') { + prop.type = 'string'; + if (v.rules && Array.isArray(v.rules.enum)) prop.enum = v.rules.enum; + } else if (typ === 'array') { + // default array of strings; can extend with itemType later + prop.type = 'array'; + prop.items = { type: 'string' }; + } else { + prop.type = 'string'; + } + if (v.default !== undefined) prop.default = v.default; + if (v.rules && v.rules.required) required.push(v.key); + properties[v.key] = prop; + } + // Run options + properties['tabTarget'] = { type: 'string', enum: ['current', 'new'], default: 'current' }; + properties['refresh'] = { type: 'boolean', default: false }; + properties['captureNetwork'] = { type: 'boolean', default: false }; + properties['returnLogs'] = { type: 'boolean', default: false }; + properties['timeoutMs'] = { type: 'number', minimum: 0 }; + const tool: Tool = { + name, + description, + inputSchema: { type: 'object', properties, required }, + }; + tools.push(tool); + } + return tools; + } + return []; + } catch (e) { + return []; + } +} export const setupTools = (server: Server) => { // List tools handler - server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOL_SCHEMAS })); + server.setRequestHandler(ListToolsRequestSchema, async () => { + const dynamicTools = await listDynamicFlowTools(); + return { tools: [...TOOL_SCHEMAS, ...dynamicTools] }; + }); // Call tool handler server.setRequestHandler(CallToolRequestSchema, async (request) => @@ -19,6 +81,42 @@ export const setupTools = (server: Server) => { const handleToolCall = async (name: string, args: any): Promise => { try { + // If calling a dynamic flow tool (name starts with flow.), proxy to common flow-run tool + if (name && name.startsWith('flow.')) { + // We need to resolve flow by slug to ID + try { + const resp = await nativeMessagingHostInstance.sendRequestToExtensionAndWait( + {}, + 'rr_list_published_flows', + 20000, + ); + const items = (resp && resp.items) || []; + const slug = name.slice('flow.'.length); + const match = items.find((it: any) => it.slug === slug); + if (!match) throw new Error(`Flow not found for tool ${name}`); + const flowArgs = { flowId: match.id, args }; + const proxyRes = await nativeMessagingHostInstance.sendRequestToExtensionAndWait( + { name: 'record_replay_flow_run', args: flowArgs }, + NativeMessageType.CALL_TOOL, + 120000, + ); + if (proxyRes.status === 'success') return proxyRes.data; + return { + content: [{ type: 'text', text: `Error calling dynamic flow tool: ${proxyRes.error}` }], + isError: true, + }; + } catch (err: any) { + return { + content: [ + { + type: 'text', + text: `Error resolving dynamic flow tool: ${err?.message || String(err)}`, + }, + ], + isError: true, + }; + } + } // 发送请求到Chrome扩展并等待响应 const response = await nativeMessagingHostInstance.sendRequestToExtensionAndWait( { @@ -26,7 +124,7 @@ const handleToolCall = async (name: string, args: any): Promise args, }, NativeMessageType.CALL_TOOL, - 30000, // 30秒超时 + 120000, // 延长到 120 秒，避免性能分析等长任务超时 ); if (response.status === 'success') { return response.data; diff --git a/app/native-server/src/native-messaging-host.ts b/app/native-server/src/native-messaging-host.ts index dcf5a16c..a6f4c6da 100644 --- a/app/native-server/src/native-messaging-host.ts +++ b/app/native-server/src/native-messaging-host.ts @@ -31,30 +31,56 @@ export class NativeMessagingHost { private setupMessageHandling(): void { let buffer = Buffer.alloc(0); let expectedLength = -1; - - stdin.on('readable', () => { - let chunk; - while ((chunk = stdin.read()) !== null) { - buffer = Buffer.concat([buffer, chunk]); - - if (expectedLength === -1 && buffer.length >= 4) { + const MAX_MESSAGES_PER_TICK = 100; // Safety guard to avoid long-running loops per readable tick + const MAX_MESSAGE_SIZE_BYTES = 16 * 1024 * 1024; // 16MB upper bound for a single message + + const processAvailable = () => { + let processed = 0; + while (processed < MAX_MESSAGES_PER_TICK) { + // Read length header when needed + if (expectedLength === -1) { + if (buffer.length < 4) break; // not enough for header expectedLength = buffer.readUInt32LE(0); buffer = buffer.slice(4); + + // Validate length header + if (expectedLength <= 0 || expectedLength > MAX_MESSAGE_SIZE_BYTES) { + this.sendError(`Invalid message length: ${expectedLength}`); + // Reset state to resynchronize stream + expectedLength = -1; + buffer = Buffer.alloc(0); + break; + } } - if (expectedLength !== -1 && buffer.length >= expectedLength) { - const messageBuffer = buffer.slice(0, expectedLength); - buffer = buffer.slice(expectedLength); + // Wait for complete body + if (buffer.length < expectedLength) break; - try { - const message = JSON.parse(messageBuffer.toString()); - this.handleMessage(message); - } catch (error: any) { - this.sendError(`Failed to parse message: ${error.message}`); - } - expectedLength = -1; // reset to get next data + const messageBuffer = buffer.slice(0, expectedLength); + buffer = buffer.slice(expectedLength); + expectedLength = -1; + processed++; + + try { + const message = JSON.parse(messageBuffer.toString()); + this.handleMessage(message); + } catch (error: any) { + this.sendError(`Failed to parse message: ${error.message}`); } } + + // If we hit the cap but still have at least one complete message pending, schedule to continue soon + if (processed === MAX_MESSAGES_PER_TICK) { + setImmediate(processAvailable); + } + }; + + stdin.on('readable', () => { + let chunk; + while ((chunk = stdin.read()) !== null) { + buffer = Buffer.concat([buffer, chunk]); + processAvailable(); + } }); stdin.on('end', () => { @@ -94,7 +120,7 @@ export class NativeMessagingHost { try { switch (message.type) { case NativeMessageType.START: - await this.startServer(message.payload?.port || 3000); + await this.startServer(message.payload?.port || 12306); break; case NativeMessageType.STOP: await this.stopServer(); @@ -125,7 +151,7 @@ export class NativeMessagingHost { private async handleFileOperation(message: any): Promise { try { const result = await fileHandler.handleFileRequest(message.payload); - + if (message.requestId) { // Send response back with the request ID this.sendMessage({ @@ -145,7 +171,7 @@ export class NativeMessagingHost { success: false, error: error.message || 'Unknown error during file operation', }; - + if (message.requestId) { this.sendMessage({ type: 'file_operation_response', @@ -212,7 +238,6 @@ export class NativeMessagingHost { type: NativeMessageType.SERVER_STARTED, payload: { port }, }); - } catch (error: any) { this.sendError(`Failed to start server: ${error.message}`); } @@ -279,8 +304,6 @@ export class NativeMessagingHost { }); } - - /** * Clean up resources */ diff --git a/app/native-server/src/scripts/build.ts b/app/native-server/src/scripts/build.ts index 47d73cd6..c5e70dbd 100644 --- a/app/native-server/src/scripts/build.ts +++ b/app/native-server/src/scripts/build.ts @@ -118,4 +118,12 @@ filesToMakeExecutable.forEach((file) => { } }); +// Write node_path.txt immediately after build to ensure Chrome uses the correct Node.js version. +// This is critical for development mode where dist is deleted on each rebuild. +// The file points to the same Node.js that compiled the native modules (better-sqlite3 etc.) +console.log('写入 node_path.txt...'); +const nodePathFile = path.join(distDir, 'node_path.txt'); +fs.writeFileSync(nodePathFile, process.execPath, 'utf8'); +console.log(`已写入 Node.js 路径: ${process.execPath}`); + console.log('✅ 构建完成'); diff --git a/app/native-server/src/scripts/constant.ts b/app/native-server/src/scripts/constant.ts index 70c1e496..85daf452 100644 --- a/app/native-server/src/scripts/constant.ts +++ b/app/native-server/src/scripts/constant.ts @@ -1,4 +1,4 @@ -export const COMMAND_NAME = 'chrome-mcp-bridge'; +export const COMMAND_NAME = 'mcp-chrome-bridge'; export const EXTENSION_ID = 'hbdgbgagpkpjffpklnamcljpakneikee'; export const HOST_NAME = 'com.chromemcp.nativehost'; export const DESCRIPTION = 'Node.js Host for Browser Bridge Extension'; diff --git a/app/native-server/src/scripts/doctor.ts b/app/native-server/src/scripts/doctor.ts new file mode 100644 index 00000000..9cc090fc --- /dev/null +++ b/app/native-server/src/scripts/doctor.ts @@ -0,0 +1,1099 @@ +#!/usr/bin/env node + +/** + * doctor.ts + * + * Diagnoses common installation and runtime issues for the Chrome Native Messaging host. + * Provides checks for manifest files, Node.js path, permissions, and connectivity. + */ + +import fs from 'fs'; +import os from 'os'; +import path from 'path'; +import { execFileSync } from 'child_process'; +import { EXTENSION_ID, HOST_NAME, COMMAND_NAME } from './constant'; +import { + BrowserType, + detectInstalledBrowsers, + getBrowserConfig, + parseBrowserType, +} from './browser-config'; +import { + colorText, + ensureExecutionPermissions, + tryRegisterUserLevelHost, + getLogDir, +} from './utils'; +import { NATIVE_SERVER_PORT } from '../constant'; + +const EXPECTED_PORT = 12306; +const SCHEMA_VERSION = 1; +const MIN_NODE_MAJOR_VERSION = 20; + +// ============================================================================ +// Types +// ============================================================================ + +export interface DoctorOptions { + json?: boolean; + fix?: boolean; + browser?: string; +} + +export type DoctorStatus = 'ok' | 'warn' | 'error'; + +export interface DoctorFixAttempt { + id: string; + description: string; + success: boolean; + error?: string; +} + +export interface DoctorCheckResult { + id: string; + title: string; + status: DoctorStatus; + message: string; + details?: Record; +} + +export interface DoctorReport { + schemaVersion: number; + timestamp: string; + ok: boolean; + summary: { + ok: number; + warn: number; + error: number; + }; + environment: { + platform: NodeJS.Platform; + arch: string; + node: { + version: string; + execPath: string; + }; + package: { + name: string; + version: string; + rootDir: string; + distDir: string; + }; + command: { + canonical: string; + aliases: string[]; + }; + nativeHost: { + hostName: string; + expectedPort: number; + }; + }; + fixes: DoctorFixAttempt[]; + checks: DoctorCheckResult[]; + nextSteps: string[]; +} + +interface NodeResolutionResult { + nodePath?: string; + source?: string; + version?: string; + versionError?: string; + nodePathFile: { + path: string; + exists: boolean; + value?: string; + valid?: boolean; + error?: string; + }; +} + +// ============================================================================ +// Utility Functions +// ============================================================================ + +function readPackageJson(): Record { + try { + return require('../../package.json') as Record; + } catch { + return {}; + } +} + +function getCommandInfo(pkg: Record): { canonical: string; aliases: string[] } { + const bin = pkg.bin as Record | undefined; + if (!bin || typeof bin !== 'object') { + return { canonical: COMMAND_NAME, aliases: [] }; + } + + const canonical = COMMAND_NAME; + const canonicalTarget = bin[canonical]; + + const aliases = canonicalTarget + ? Object.keys(bin).filter((name) => name !== canonical && bin[name] === canonicalTarget) + : []; + + return { canonical, aliases }; +} + +function resolveDistDir(): string { + // __dirname is dist/scripts when running from compiled code + const candidateFromDistScripts = path.resolve(__dirname, '..'); + const candidateFromSrcScripts = path.resolve(__dirname, '..', '..', 'dist'); + + const looksLikeDist = (dir: string): boolean => { + return ( + fs.existsSync(path.join(dir, 'mcp', 'stdio-config.json')) || + fs.existsSync(path.join(dir, 'run_host.sh')) || + fs.existsSync(path.join(dir, 'run_host.bat')) + ); + }; + + if (looksLikeDist(candidateFromDistScripts)) return candidateFromDistScripts; + if (looksLikeDist(candidateFromSrcScripts)) return candidateFromSrcScripts; + return candidateFromDistScripts; +} + +function stringifyError(err: unknown): string { + if (err instanceof Error) return err.message; + return String(err); +} + +function canExecute(filePath: string): boolean { + try { + fs.accessSync(filePath, fs.constants.X_OK); + return true; + } catch { + return false; + } +} + +function normalizeComparablePath(filePath: string): string { + if (process.platform === 'win32') { + return path.normalize(filePath).toLowerCase(); + } + return path.normalize(filePath); +} + +function stripOuterQuotes(input: string): string { + const trimmed = input.trim(); + if ( + (trimmed.startsWith('"') && trimmed.endsWith('"')) || + (trimmed.startsWith("'") && trimmed.endsWith("'")) + ) { + return trimmed.slice(1, -1); + } + return trimmed; +} + +function expandTilde(inputPath: string): string { + if (inputPath === '~') return os.homedir(); + if (inputPath.startsWith('~/') || inputPath.startsWith('~\\')) { + return path.join(os.homedir(), inputPath.slice(2)); + } + return inputPath; +} + +function expandWindowsEnvVars(input: string): string { + if (process.platform !== 'win32') return input; + return input.replace(/%([^%]+)%/g, (_match, name: string) => { + const key = String(name); + return ( + process.env[key] ?? process.env[key.toUpperCase()] ?? process.env[key.toLowerCase()] ?? _match + ); + }); +} + +function parseVersionFromDirName(dirName: string): number[] | null { + const cleaned = dirName.trim().replace(/^v/, ''); + if (!/^\d+(\.\d+){0,3}$/.test(cleaned)) return null; + return cleaned.split('.').map((part) => Number(part)); +} + +/** + * Parse Node.js version string from `node -v` output. + * Handles versions like: v20.10.0, v22.0.0-nightly.2024..., v21.0.0-rc.1 + * Returns major version number or null if parsing fails. + */ +function parseNodeMajorVersion(versionString: string): number | null { + if (!versionString) return null; + // Match pattern: v?MAJOR.MINOR.PATCH[-anything] + const match = versionString.trim().match(/^v?(\d+)(?:\.\d+)*(?:[-+].*)?$/i); + if (match?.[1]) { + const major = Number(match[1]); + return Number.isNaN(major) ? null : major; + } + return null; +} + +function compareVersions(a: number[], b: number[]): number { + const len = Math.max(a.length, b.length); + for (let i = 0; i < len; i++) { + const av = a[i] ?? 0; + const bv = b[i] ?? 0; + if (av !== bv) return av - bv; + } + return 0; +} + +function pickLatestVersionDir(parentDir: string): string | null { + if (!fs.existsSync(parentDir)) return null; + const dirents = fs.readdirSync(parentDir, { withFileTypes: true }); + let best: { name: string; version: number[] } | null = null; + + for (const dirent of dirents) { + if (!dirent.isDirectory()) continue; + const parsed = parseVersionFromDirName(dirent.name); + if (!parsed) continue; + if (!best || compareVersions(parsed, best.version) > 0) { + best = { name: dirent.name, version: parsed }; + } + } + + return best ? path.join(parentDir, best.name) : null; +} + +// ============================================================================ +// Node Resolution (mirrors run_host.sh/bat logic) +// ============================================================================ + +function resolveNodeCandidate(distDir: string): NodeResolutionResult { + const nodeFileName = process.platform === 'win32' ? 'node.exe' : 'node'; + const nodePathFilePath = path.join(distDir, 'node_path.txt'); + + const nodePathFile: NodeResolutionResult['nodePathFile'] = { + path: nodePathFilePath, + exists: fs.existsSync(nodePathFilePath), + }; + + const consider = ( + source: string, + rawCandidate?: string, + ): { nodePath: string; source: string } | null => { + if (!rawCandidate) return null; + let candidate = expandTilde(stripOuterQuotes(rawCandidate)); + + try { + if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) { + candidate = path.join(candidate, nodeFileName); + } + } catch { + // ignore + } + + if (canExecute(candidate)) { + return { nodePath: candidate, source }; + } + return null; + }; + + // Priority 0: CHROME_MCP_NODE_PATH + const fromEnv = consider('CHROME_MCP_NODE_PATH', process.env.CHROME_MCP_NODE_PATH); + if (fromEnv) { + return { ...fromEnv, nodePathFile }; + } + + // Priority 1: node_path.txt + if (nodePathFile.exists) { + try { + const content = fs.readFileSync(nodePathFilePath, 'utf8').trim(); + nodePathFile.value = content; + const fromFile = consider('node_path.txt', content); + nodePathFile.valid = Boolean(fromFile); + if (fromFile) { + return { ...fromFile, nodePathFile }; + } + } catch (e) { + nodePathFile.error = stringifyError(e); + nodePathFile.valid = false; + } + } + + // Priority 1.5: Relative path fallback (mirrors run_host.sh/bat) + // Unix: ../../../bin/node (from dist/) + // Windows: ..\..\..\node.exe (from dist/, no bin/ subdirectory) + const relativeNodePath = + process.platform === 'win32' + ? path.resolve(distDir, '..', '..', '..', nodeFileName) + : path.resolve(distDir, '..', '..', '..', 'bin', nodeFileName); + const fromRelative = consider('relative', relativeNodePath); + if (fromRelative) return { ...fromRelative, nodePathFile }; + + // Priority 2: Volta + const voltaHome = process.env.VOLTA_HOME || path.join(os.homedir(), '.volta'); + const fromVolta = consider('volta', path.join(voltaHome, 'bin', nodeFileName)); + if (fromVolta) return { ...fromVolta, nodePathFile }; + + // Priority 3: asdf (cross-platform) + const asdfDir = process.env.ASDF_DATA_DIR || path.join(os.homedir(), '.asdf'); + const asdfNodejsDir = path.join(asdfDir, 'installs', 'nodejs'); + const latestAsdf = pickLatestVersionDir(asdfNodejsDir); + if (latestAsdf) { + const fromAsdf = consider('asdf', path.join(latestAsdf, 'bin', nodeFileName)); + if (fromAsdf) return { ...fromAsdf, nodePathFile }; + } + + // Priority 4: fnm (cross-platform, Windows uses different layout) + const fnmDir = process.env.FNM_DIR || path.join(os.homedir(), '.fnm'); + const fnmVersionsDir = path.join(fnmDir, 'node-versions'); + const latestFnm = pickLatestVersionDir(fnmVersionsDir); + if (latestFnm) { + const fnmNodePath = + process.platform === 'win32' + ? path.join(latestFnm, 'installation', nodeFileName) + : path.join(latestFnm, 'installation', 'bin', nodeFileName); + const fromFnm = consider('fnm', fnmNodePath); + if (fromFnm) return { ...fromFnm, nodePathFile }; + } + + // Priority 5: NVM (Unix only) + if (process.platform !== 'win32') { + const nvmDir = process.env.NVM_DIR || path.join(os.homedir(), '.nvm'); + const nvmDefaultAlias = path.join(nvmDir, 'alias', 'default'); + try { + if (fs.existsSync(nvmDefaultAlias)) { + const stat = fs.lstatSync(nvmDefaultAlias); + const maybeVersion = stat.isSymbolicLink() + ? fs.readlinkSync(nvmDefaultAlias).trim() + : fs.readFileSync(nvmDefaultAlias, 'utf8').trim(); + const fromDefault = consider( + 'nvm-default', + path.join(nvmDir, 'versions', 'node', maybeVersion, 'bin', 'node'), + ); + if (fromDefault) return { ...fromDefault, nodePathFile }; + } + } catch { + // ignore + } + + const latestNvm = pickLatestVersionDir(path.join(nvmDir, 'versions', 'node')); + if (latestNvm) { + const fromNvm = consider('nvm-latest', path.join(latestNvm, 'bin', 'node')); + if (fromNvm) return { ...fromNvm, nodePathFile }; + } + } + + // Priority 6: Common paths + const commonPaths = + process.platform === 'win32' + ? [ + path.join(process.env.ProgramFiles || 'C:\\Program Files', 'nodejs', 'node.exe'), + path.join( + process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)', + 'nodejs', + 'node.exe', + ), + path.join(process.env.LOCALAPPDATA || '', 'Programs', 'nodejs', 'node.exe'), + ].filter((p) => path.isAbsolute(p)) + : ['/opt/homebrew/bin/node', '/usr/local/bin/node', '/usr/bin/node']; + for (const common of commonPaths) { + const resolved = consider('common', common); + if (resolved) return { ...resolved, nodePathFile }; + } + + // Priority 7: PATH + const pathEnv = process.env.PATH || ''; + for (const rawDir of pathEnv.split(path.delimiter)) { + const dir = stripOuterQuotes(rawDir); + if (!dir) continue; + const candidate = path.join(dir, nodeFileName); + if (canExecute(candidate)) { + return { nodePath: candidate, source: 'PATH', nodePathFile }; + } + } + + return { nodePathFile }; +} + +// ============================================================================ +// Browser Resolution +// ============================================================================ + +function resolveTargetBrowsers(browserArg: string | undefined): BrowserType[] | undefined { + if (!browserArg) return undefined; + const normalized = browserArg.toLowerCase(); + if (normalized === 'all') return [BrowserType.CHROME, BrowserType.CHROMIUM]; + if (normalized === 'detect' || normalized === 'auto') return undefined; + const parsed = parseBrowserType(normalized); + if (!parsed) { + throw new Error(`Invalid browser: ${browserArg}. Use 'chrome', 'chromium', or 'all'`); + } + return [parsed]; +} + +function resolveBrowsersToCheck(requested: BrowserType[] | undefined): BrowserType[] { + if (requested && requested.length > 0) return requested; + const detected = detectInstalledBrowsers(); + if (detected.length > 0) return detected; + return [BrowserType.CHROME, BrowserType.CHROMIUM]; +} + +// ============================================================================ +// Windows Registry Check +// ============================================================================ + +type RegistryValueType = 'REG_SZ' | 'REG_EXPAND_SZ'; + +function queryWindowsRegistryDefaultValue(registryKey: string): { + value?: string; + valueType?: RegistryValueType; + error?: string; +} { + try { + const output = execFileSync('reg', ['query', registryKey, '/ve'], { + encoding: 'utf8', + stdio: ['ignore', 'pipe', 'pipe'], + timeout: 2500, + windowsHide: true, + }); + const lines = output + .split(/\r?\n/) + .map((l) => l.trim()) + .filter(Boolean); + for (const line of lines) { + const match = line.match(/\b(REG_SZ|REG_EXPAND_SZ)\b\s+(.*)$/i); + if (match?.[2]) { + const valueType = match[1].toUpperCase() as RegistryValueType; + return { value: match[2].trim(), valueType }; + } + } + return { error: 'No REG_SZ/REG_EXPAND_SZ default value found' }; + } catch (e) { + return { error: stringifyError(e) }; + } +} + +// ============================================================================ +// Fix Attempts +// ============================================================================ + +async function attemptFixes( + enabled: boolean, + silent: boolean, + distDir: string, + targetBrowsers: BrowserType[] | undefined, +): Promise { + if (!enabled) return []; + + const fixes: DoctorFixAttempt[] = []; + const logDir = getLogDir(); + const nodePathFile = path.join(distDir, 'node_path.txt'); + + const withMutedConsole = async (fn: () => Promise): Promise => { + if (!silent) return await fn(); + const originalLog = console.log; + const originalInfo = console.info; + const originalWarn = console.warn; + const originalError = console.error; + console.log = () => {}; + console.info = () => {}; + console.warn = () => {}; + console.error = () => {}; + try { + return await fn(); + } finally { + console.log = originalLog; + console.info = originalInfo; + console.warn = originalWarn; + console.error = originalError; + } + }; + + const attempt = async (id: string, description: string, action: () => Promise | void) => { + try { + await withMutedConsole(async () => { + await action(); + }); + fixes.push({ id, description, success: true }); + } catch (e) { + fixes.push({ id, description, success: false, error: stringifyError(e) }); + } + }; + + await attempt('logs', 'Ensure logs directory exists', async () => { + fs.mkdirSync(logDir, { recursive: true }); + }); + + await attempt('node_path', 'Write node_path.txt for run_host scripts', async () => { + fs.writeFileSync(nodePathFile, process.execPath, 'utf8'); + }); + + await attempt('permissions', 'Fix execution permissions for native host files', async () => { + await ensureExecutionPermissions(); + }); + + await attempt('register', 'Re-register Native Messaging host (user-level)', async () => { + const ok = await tryRegisterUserLevelHost(targetBrowsers); + if (!ok) { + throw new Error('User-level registration failed'); + } + }); + + return fixes; +} + +// ============================================================================ +// JSON File Reading +// ============================================================================ + +function readJsonFile( + filePath: string, +): { ok: true; value: unknown } | { ok: false; error: string } { + try { + const raw = fs.readFileSync(filePath, 'utf8'); + return { ok: true, value: JSON.parse(raw) }; + } catch (e) { + return { ok: false, error: stringifyError(e) }; + } +} + +// ============================================================================ +// Connectivity Check +// ============================================================================ + +type FetchFn = typeof globalThis.fetch; + +function resolveFetch(): FetchFn | null { + if (typeof globalThis.fetch === 'function') { + return globalThis.fetch.bind(globalThis) as FetchFn; + } + try { + const mod = require('node-fetch'); + return (mod.default ?? mod) as FetchFn; + } catch { + return null; + } +} + +async function checkConnectivity( + url: string, + timeoutMs: number, +): Promise<{ ok: boolean; status?: number; error?: string }> { + const fetchFn = resolveFetch(); + if (!fetchFn) { + return { ok: false, error: 'fetch is not available (requires Node.js >=18 or node-fetch)' }; + } + + const controller = new AbortController(); + const timeout = setTimeout(() => controller.abort(), timeoutMs); + // Prevent timeout from keeping the process alive + if (typeof timeout.unref === 'function') { + timeout.unref(); + } + + try { + const res = await fetchFn(url, { method: 'GET', signal: controller.signal }); + return { ok: res.ok, status: res.status }; + } catch (e: unknown) { + const errMessage = e instanceof Error ? e.message : String(e); + const errName = e instanceof Error ? e.name : ''; + if (errName === 'AbortError' || errMessage.toLowerCase().includes('abort')) { + return { ok: false, error: `Timeout after ${timeoutMs}ms` }; + } + return { ok: false, error: errMessage }; + } finally { + clearTimeout(timeout); + } +} + +// ============================================================================ +// Summary Computation +// ============================================================================ + +function computeSummary(checks: DoctorCheckResult[]): { ok: number; warn: number; error: number } { + let ok = 0; + let warn = 0; + let error = 0; + for (const check of checks) { + if (check.status === 'ok') ok++; + else if (check.status === 'warn') warn++; + else error++; + } + return { ok, warn, error }; +} + +function statusBadge(status: DoctorStatus): string { + if (status === 'ok') return colorText('[OK]', 'green'); + if (status === 'warn') return colorText('[WARN]', 'yellow'); + return colorText('[ERROR]', 'red'); +} + +// ============================================================================ +// Main Doctor Function +// ============================================================================ + +/** + * Collect doctor report without outputting to console. + * Used by both runDoctor and report command. + */ +export async function collectDoctorReport(options: DoctorOptions): Promise { + const pkg = readPackageJson(); + const distDir = resolveDistDir(); + const rootDir = path.resolve(distDir, '..'); + const packageName = typeof pkg.name === 'string' ? pkg.name : 'mcp-chrome-bridge'; + const packageVersion = typeof pkg.version === 'string' ? pkg.version : 'unknown'; + const commandInfo = getCommandInfo(pkg); + + const targetBrowsers = resolveTargetBrowsers(options.browser); + const browsersToCheck = resolveBrowsersToCheck(targetBrowsers); + + const wrapperScriptName = process.platform === 'win32' ? 'run_host.bat' : 'run_host.sh'; + const wrapperPath = path.resolve(distDir, wrapperScriptName); + const nodeScriptPath = path.resolve(distDir, 'index.js'); + const logDir = getLogDir(); + const stdioConfigPath = path.resolve(distDir, 'mcp', 'stdio-config.json'); + + // Run fixes if requested + const fixes = await attemptFixes( + Boolean(options.fix), + Boolean(options.json), + distDir, + targetBrowsers, + ); + + const checks: DoctorCheckResult[] = []; + const nextSteps: string[] = []; + + // Check 1: Installation info + checks.push({ + id: 'installation', + title: 'Installation', + status: 'ok', + message: `${packageName}@${packageVersion}, ${process.platform}-${process.arch}, node ${process.version}`, + details: { + packageRoot: rootDir, + distDir, + execPath: process.execPath, + aliases: commandInfo.aliases, + }, + }); + + // Check 2: Host files + const missingHostFiles: string[] = []; + if (!fs.existsSync(wrapperPath)) missingHostFiles.push(wrapperPath); + if (!fs.existsSync(nodeScriptPath)) missingHostFiles.push(nodeScriptPath); + if (!fs.existsSync(stdioConfigPath)) missingHostFiles.push(stdioConfigPath); + + if (missingHostFiles.length > 0) { + checks.push({ + id: 'host.files', + title: 'Host files', + status: 'error', + message: `Missing required files (${missingHostFiles.length})`, + details: { missing: missingHostFiles }, + }); + nextSteps.push(`Reinstall: npm install -g ${COMMAND_NAME}`); + } else { + checks.push({ + id: 'host.files', + title: 'Host files', + status: 'ok', + message: `Wrapper: ${wrapperPath}`, + details: { wrapperPath, nodeScriptPath, stdioConfigPath }, + }); + } + + // Check 3: Permissions (Unix only) + if (process.platform !== 'win32' && fs.existsSync(wrapperPath)) { + const executable = canExecute(wrapperPath); + checks.push({ + id: 'host.permissions', + title: 'Host permissions', + status: executable ? 'ok' : 'error', + message: executable ? 'run_host.sh is executable' : 'run_host.sh is not executable', + details: { + path: wrapperPath, + fix: executable + ? undefined + : [`${COMMAND_NAME} fix-permissions`, `chmod +x "${wrapperPath}"`], + }, + }); + if (!executable) nextSteps.push(`${COMMAND_NAME} fix-permissions`); + } else { + checks.push({ + id: 'host.permissions', + title: 'Host permissions', + status: 'ok', + message: process.platform === 'win32' ? 'Not applicable on Windows' : 'N/A', + }); + } + + // Check 4: Node resolution + const nodeResolution = resolveNodeCandidate(distDir); + if (nodeResolution.nodePath) { + try { + nodeResolution.version = execFileSync(nodeResolution.nodePath, ['-v'], { + encoding: 'utf8', + stdio: ['ignore', 'pipe', 'pipe'], + timeout: 2500, + windowsHide: true, + }).trim(); + } catch (e) { + nodeResolution.versionError = stringifyError(e); + } + } + + // Parse Node version and check if it meets minimum requirement + const nodeMajorVersion = parseNodeMajorVersion(nodeResolution.version || ''); + const nodeVersionTooOld = nodeMajorVersion !== null && nodeMajorVersion < MIN_NODE_MAJOR_VERSION; + + const nodePathWarn = + Boolean(nodeResolution.nodePath) && + (!nodeResolution.nodePathFile.exists || nodeResolution.nodePathFile.valid === false) && + !process.env.CHROME_MCP_NODE_PATH; + + // Determine node check status: error if not found or version too old, warn if path issue + let nodeStatus: DoctorStatus = 'ok'; + let nodeMessage: string; + let nodeFix: string[] | undefined; + + if (!nodeResolution.nodePath) { + nodeStatus = 'error'; + nodeMessage = 'Node.js executable not found by wrapper search order'; + nodeFix = [ + `${COMMAND_NAME} doctor --fix`, + `Or set CHROME_MCP_NODE_PATH to an absolute node path`, + ]; + nextSteps.push(`${COMMAND_NAME} doctor --fix`); + } else if (nodeResolution.versionError) { + nodeStatus = 'error'; + nodeMessage = `Found ${nodeResolution.source}: ${nodeResolution.nodePath} but failed to run "node -v" (${nodeResolution.versionError})`; + nodeFix = [ + `Verify the executable: "${nodeResolution.nodePath}" -v`, + `Reinstall/repair Node.js`, + ]; + nextSteps.push(`Verify Node.js: "${nodeResolution.nodePath}" -v`); + } else if (nodeVersionTooOld) { + nodeStatus = 'error'; + nodeMessage = `Node.js ${nodeResolution.version} is too old (requires >= ${MIN_NODE_MAJOR_VERSION}.0.0)`; + nodeFix = [`Upgrade Node.js to version ${MIN_NODE_MAJOR_VERSION} or higher`]; + nextSteps.push(`Upgrade Node.js to version ${MIN_NODE_MAJOR_VERSION}+`); + } else if (nodePathWarn) { + nodeStatus = 'warn'; + nodeMessage = `Using ${nodeResolution.source}: ${nodeResolution.nodePath}${nodeResolution.version ? ` (${nodeResolution.version})` : ''}`; + nodeFix = [ + `${COMMAND_NAME} doctor --fix`, + `Or set CHROME_MCP_NODE_PATH to an absolute node path`, + ]; + } else { + nodeStatus = 'ok'; + nodeMessage = `Using ${nodeResolution.source}: ${nodeResolution.nodePath}${nodeResolution.version ? ` (${nodeResolution.version})` : ''}`; + } + + checks.push({ + id: 'node', + title: 'Node executable', + status: nodeStatus, + message: nodeMessage, + details: { + resolved: nodeResolution.nodePath + ? { + source: nodeResolution.source, + path: nodeResolution.nodePath, + version: nodeResolution.version, + versionError: nodeResolution.versionError, + majorVersion: nodeMajorVersion, + } + : undefined, + nodePathFile: nodeResolution.nodePathFile, + minRequired: `>=${MIN_NODE_MAJOR_VERSION}.0.0`, + fix: nodeFix, + }, + }); + + // Check 5: Manifest checks per browser + const expectedOrigin = `chrome-extension://${EXTENSION_ID}/`; + for (const browser of browsersToCheck) { + const config = getBrowserConfig(browser); + const candidates = [config.userManifestPath, config.systemManifestPath]; + const found = candidates.find((p) => fs.existsSync(p)); + + if (!found) { + checks.push({ + id: `manifest.${browser}`, + title: `${config.displayName} manifest`, + status: 'error', + message: 'Manifest not found', + details: { + expected: candidates, + fix: [ + `${COMMAND_NAME} register --browser ${browser}`, + `${COMMAND_NAME} register --detect`, + ], + }, + }); + nextSteps.push(`${COMMAND_NAME} register --detect`); + continue; + } + + const parsed = readJsonFile(found); + if (!parsed.ok) { + checks.push({ + id: `manifest.${browser}`, + title: `${config.displayName} manifest`, + status: 'error', + message: `Failed to parse manifest: ${parsed.error}`, + details: { path: found, fix: [`${COMMAND_NAME} register --browser ${browser}`] }, + }); + nextSteps.push(`${COMMAND_NAME} register --browser ${browser}`); + continue; + } + + const manifest = parsed.value as Record; + const issues: string[] = []; + if (manifest.name !== HOST_NAME) issues.push(`name != ${HOST_NAME}`); + if (manifest.type !== 'stdio') issues.push(`type != stdio`); + if (typeof manifest.path !== 'string') issues.push('path is missing'); + if (typeof manifest.path === 'string') { + const actual = normalizeComparablePath(manifest.path); + const expected = normalizeComparablePath(wrapperPath); + if (actual !== expected) issues.push('path does not match installed wrapper'); + if (!fs.existsSync(manifest.path)) issues.push('path target does not exist'); + } + const allowedOrigins = manifest.allowed_origins; + if (!Array.isArray(allowedOrigins) || !allowedOrigins.includes(expectedOrigin)) { + issues.push(`allowed_origins missing ${expectedOrigin}`); + } + + checks.push({ + id: `manifest.${browser}`, + title: `${config.displayName} manifest`, + status: issues.length === 0 ? 'ok' : 'error', + message: issues.length === 0 ? found : `Invalid manifest (${issues.join('; ')})`, + details: { + path: found, + expectedWrapperPath: wrapperPath, + expectedOrigin, + fix: issues.length === 0 ? undefined : [`${COMMAND_NAME} register --browser ${browser}`], + }, + }); + if (issues.length > 0) nextSteps.push(`${COMMAND_NAME} register --browser ${browser}`); + } + + // Check 6: Windows registry (Windows only) + if (process.platform === 'win32') { + for (const browser of browsersToCheck) { + const config = getBrowserConfig(browser); + const keySpecs = [ + config.registryKey ? { key: config.registryKey, expected: config.userManifestPath } : null, + config.systemRegistryKey + ? { key: config.systemRegistryKey, expected: config.systemManifestPath } + : null, + ].filter(Boolean) as Array<{ key: string; expected: string }>; + if (keySpecs.length === 0) continue; + + let anyValue = false; + let anyExistingTarget = false; + let anyMissingTarget = false; + let anyMismatch = false; + + const results: Array<{ + key: string; + expected: string; + value?: string; + valueType?: string; + expandedValue?: string; + exists?: boolean; + matchesExpected?: boolean; + error?: string; + }> = []; + + for (const spec of keySpecs) { + const res = queryWindowsRegistryDefaultValue(spec.key); + if (!res.value) { + results.push({ key: spec.key, expected: spec.expected, error: res.error }); + continue; + } + + anyValue = true; + // Expand environment variables for REG_EXPAND_SZ values + const expandedValue = expandWindowsEnvVars(stripOuterQuotes(res.value)); + const exists = fs.existsSync(expandedValue); + const matchesExpected = + normalizeComparablePath(expandedValue) === normalizeComparablePath(spec.expected); + + if (exists) { + anyExistingTarget = true; + if (!matchesExpected) anyMismatch = true; + } else { + anyMissingTarget = true; + } + + results.push({ + key: spec.key, + expected: spec.expected, + value: res.value, + valueType: res.valueType, + expandedValue: expandedValue !== res.value ? expandedValue : undefined, + exists, + matchesExpected, + }); + } + + let status: DoctorStatus = 'error'; + let message = 'Registry entry not found'; + if (!anyValue) { + status = 'error'; + message = 'Registry entry not found'; + } else if (!anyExistingTarget) { + status = 'error'; + message = 'Registry entry points to missing manifest'; + } else if (anyMissingTarget || anyMismatch) { + status = 'warn'; + message = 'Registry entry found but inconsistent'; + } else { + status = 'ok'; + message = 'Registry entry points to manifest'; + } + + checks.push({ + id: `registry.${browser}`, + title: `${config.displayName} registry`, + status, + message, + details: { + keys: keySpecs.map((s) => s.key), + results, + fix: status === 'ok' ? undefined : [`${COMMAND_NAME} register --browser ${browser}`], + }, + }); + if (status !== 'ok') nextSteps.push(`${COMMAND_NAME} register --browser ${browser}`); + } + } + + // Check 7: Port configuration + if (fs.existsSync(stdioConfigPath)) { + const cfg = readJsonFile(stdioConfigPath); + if (!cfg.ok) { + checks.push({ + id: 'port.config', + title: 'Port config', + status: 'error', + message: `Failed to parse stdio-config.json: ${cfg.error}`, + }); + } else { + try { + const configValue = cfg.value as Record; + const url = new URL(configValue.url as string); + const port = Number(url.port); + const portOk = port === EXPECTED_PORT; + checks.push({ + id: 'port.config', + title: 'Port config', + status: portOk ? 'ok' : 'error', + message: configValue.url as string, + details: { + expectedPort: EXPECTED_PORT, + actualPort: port, + fix: portOk ? undefined : [`${COMMAND_NAME} update-port ${EXPECTED_PORT}`], + }, + }); + if (!portOk) nextSteps.push(`${COMMAND_NAME} update-port ${EXPECTED_PORT}`); + + // Check constant consistency + const nativePortOk = NATIVE_SERVER_PORT === EXPECTED_PORT; + checks.push({ + id: 'port.constant', + title: 'Port constant', + status: nativePortOk ? 'ok' : 'warn', + message: `NATIVE_SERVER_PORT=${NATIVE_SERVER_PORT}`, + details: { expectedPort: EXPECTED_PORT }, + }); + + // Connectivity check + const pingUrl = new URL('/ping', url); + const ping = await checkConnectivity(pingUrl.toString(), 1500); + checks.push({ + id: 'connectivity', + title: 'Connectivity', + status: ping.ok ? 'ok' : 'warn', + message: ping.ok + ? `GET ${pingUrl} -> ${ping.status}` + : `GET ${pingUrl} failed (${ping.error || 'unknown error'})`, + details: { + hint: 'If the server is not running, click "Connect" in the extension and retry.', + }, + }); + if (!ping.ok) nextSteps.push('Click "Connect" in the extension, then re-run doctor'); + } catch (e) { + checks.push({ + id: 'port.config', + title: 'Port config', + status: 'error', + message: `Invalid URL in stdio-config.json: ${stringifyError(e)}`, + }); + } + } + } + + // Check 8: Logs directory + checks.push({ + id: 'logs', + title: 'Logs', + status: fs.existsSync(logDir) ? 'ok' : 'warn', + message: logDir, + details: { + hint: 'Wrapper logs are created when Chrome launches the native host.', + }, + }); + + // Compute summary + const summary = computeSummary(checks); + const ok = summary.error === 0; + + const report: DoctorReport = { + schemaVersion: SCHEMA_VERSION, + timestamp: new Date().toISOString(), + ok, + summary, + environment: { + platform: process.platform, + arch: process.arch, + node: { version: process.version, execPath: process.execPath }, + package: { name: packageName, version: packageVersion, rootDir, distDir }, + command: { canonical: commandInfo.canonical, aliases: commandInfo.aliases }, + nativeHost: { hostName: HOST_NAME, expectedPort: EXPECTED_PORT }, + }, + fixes, + checks, + nextSteps: Array.from(new Set(nextSteps)).slice(0, 10), + }; + + return report; +} + +/** + * Run doctor command with console output. + */ +export async function runDoctor(options: DoctorOptions): Promise { + const report = await collectDoctorReport(options); + const packageVersion = report.environment.package.version; + + // Output + if (options.json) { + process.stdout.write(JSON.stringify(report, null, 2) + '\n'); + } else { + console.log(`${COMMAND_NAME} doctor v${packageVersion}\n`); + for (const check of report.checks) { + console.log(`${statusBadge(check.status)} ${check.title}: ${check.message}`); + const fix = (check.details as Record | undefined)?.fix as + | string[] + | undefined; + if (check.status !== 'ok' && fix && fix.length > 0) { + console.log(` Fix: ${fix[0]}`); + } + } + if (report.fixes.length > 0) { + console.log('\nFix attempts:'); + for (const f of report.fixes) { + const badge = f.success ? colorText('[OK]', 'green') : colorText('[ERROR]', 'red'); + console.log(`${badge} ${f.description}${f.success ? '' : ` (${f.error})`}`); + } + } + if (report.nextSteps.length > 0) { + console.log('\nNext steps:'); + report.nextSteps.forEach((s, i) => console.log(` ${i + 1}. ${s}`)); + } + } + + return report.ok ? 0 : 1; +} diff --git a/app/native-server/src/scripts/postinstall.ts b/app/native-server/src/scripts/postinstall.ts index 3e7568ff..f8573396 100644 --- a/app/native-server/src/scripts/postinstall.ts +++ b/app/native-server/src/scripts/postinstall.ts @@ -4,7 +4,7 @@ import fs from 'fs'; import os from 'os'; import path from 'path'; import { COMMAND_NAME } from './constant'; -import { colorText, tryRegisterUserLevelHost } from './utils'; +import { colorText, tryRegisterUserLevelHost, writeNodePathFile } from './utils'; // Check if this script is run directly const isDirectRun = require.main === module; @@ -59,18 +59,17 @@ function detectGlobalInstall(): boolean { const isGlobalInstall = detectGlobalInstall(); /** - * Write Node.js path for run_host scripts to avoid fragile relative paths + * Detect if running with elevated privileges (sudo/admin) + * This can cause issues because user-level registration will go to root's home directory */ -async function writeNodePath(): Promise { - try { - const nodePath = process.execPath; - const nodePathFile = path.join(__dirname, '..', 'node_path.txt'); - - console.log(colorText(`Writing Node.js path: ${nodePath}`, 'blue')); - fs.writeFileSync(nodePathFile, nodePath, 'utf8'); - console.log(colorText('✓ Node.js path written for run_host scripts', 'green')); - } catch (error: any) { - console.warn(colorText(`⚠️ Failed to write Node.js path: ${error.message}`, 'yellow')); +function isRunningElevated(): boolean { + if (process.platform === 'win32') { + // On Windows, check common admin indicators + // Note: Full admin check requires is-admin package which is ESM + return false; // Skip for now, Windows npm usually doesn't run as admin by default + } else { + // On Unix, check if running as root (UID 0) + return process.getuid?.() === 0; } } @@ -162,6 +161,30 @@ async function tryRegisterNativeHost(): Promise { // Always ensure execution permissions, regardless of installation type await ensureExecutionPermissions(); + // Check if running with elevated privileges + if (isRunningElevated()) { + console.log( + colorText('\n⚠️ WARNING: Running with elevated privileges (sudo/root)', 'yellow'), + ); + console.log( + colorText(" User-level registration will be written to root's home directory,", 'yellow'), + ); + console.log( + colorText(' which may not work correctly for your normal user account.', 'yellow'), + ); + console.log( + colorText( + '\n Please run the following command as your normal user after installation:', + 'blue', + ), + ); + console.log(` ${COMMAND_NAME} register`); + console.log(colorText('\n Or if you need system-level installation, use:', 'blue')); + console.log(` sudo ${COMMAND_NAME} register --system`); + // Skip automatic registration when running as root + return; + } + if (isGlobalInstall) { // First try user-level installation (no elevated permissions required) const userLevelSuccess = await tryRegisterUserLevelHost(); @@ -215,7 +238,7 @@ function printManualInstructions(): void { colorText('\n2. If user-level installation fails, try system-level installation:', 'yellow'), ); - console.log(colorText(' Use --system parameter (auto-elevate permissions):', 'yellow')); + console.log(colorText(' Use --system parameter (requires admin privileges):', 'yellow')); if (isGlobalInstall) { console.log(` ${COMMAND_NAME} register --system`); } else { @@ -271,7 +294,7 @@ async function main(): Promise { await ensureExecutionPermissions(); // Write Node.js path for run_host scripts to use - await writeNodePath(); + writeNodePathFile(path.join(__dirname, '..')); // If global installation, try automatic registration if (isGlobalInstall) { @@ -291,5 +314,7 @@ if (isDirectRun) { 'red', ), ); + // Set non-zero exit code to indicate installation failure + process.exitCode = 1; }); } diff --git a/app/native-server/src/scripts/register-dev.ts b/app/native-server/src/scripts/register-dev.ts index 0389004b..85da1066 100644 --- a/app/native-server/src/scripts/register-dev.ts +++ b/app/native-server/src/scripts/register-dev.ts @@ -1,3 +1,3 @@ -import { tryRegisterUserLevelHost } from './utils'; +import { registerUserLevelHostWithNodePath } from './utils'; -tryRegisterUserLevelHost(); +registerUserLevelHostWithNodePath(); diff --git a/app/native-server/src/scripts/register.ts b/app/native-server/src/scripts/register.ts index 9331bbda..9fb9ea1d 100644 --- a/app/native-server/src/scripts/register.ts +++ b/app/native-server/src/scripts/register.ts @@ -1,6 +1,7 @@ #!/usr/bin/env node +import path from 'path'; import { COMMAND_NAME } from './constant'; -import { colorText, registerWithElevatedPermissions } from './utils'; +import { colorText, registerWithElevatedPermissions, writeNodePathFile } from './utils'; /** * 主函数 @@ -9,6 +10,9 @@ async function main(): Promise { console.log(colorText(`正在注册 ${COMMAND_NAME} Native Messaging主机...`, 'blue')); try { + // Write Node.js path before registration + writeNodePathFile(path.join(__dirname, '..')); + await registerWithElevatedPermissions(); console.log( colorText('注册成功！现在Chrome扩展可以通过Native Messaging与本地服务通信。', 'green'), diff --git a/app/native-server/src/scripts/report.ts b/app/native-server/src/scripts/report.ts new file mode 100644 index 00000000..4b0c3768 --- /dev/null +++ b/app/native-server/src/scripts/report.ts @@ -0,0 +1,847 @@ +#!/usr/bin/env node + +/** + * report.ts + * + * Export a diagnostic report for GitHub Issues. + * Collects system info, doctor output, logs, manifests, and registry info. + */ + +import fs from 'fs'; +import os from 'os'; +import path from 'path'; +import { execFileSync, spawnSync } from 'child_process'; +import { COMMAND_NAME } from './constant'; +import { + BrowserType, + detectInstalledBrowsers, + getBrowserConfig, + parseBrowserType, +} from './browser-config'; +import { getLogDir } from './utils'; +import { collectDoctorReport, DoctorReport } from './doctor'; + +const REPORT_SCHEMA_VERSION = 1; +const DEFAULT_LOG_LINES = 200; +const DEFAULT_TAIL_BYTES = 256 * 1024; +const MAX_LOG_FILES = 6; +const MAX_FULL_LOG_BYTES = 1024 * 1024; + +type IncludeLogsMode = 'none' | 'tail' | 'full'; + +export interface ReportOptions { + json?: boolean; + output?: string; + copy?: boolean; + redact?: boolean; + includeLogs?: string; + logLines?: number; + browser?: string; +} + +interface VersionResult { + version?: string; + error?: string; +} + +interface ManifestSnapshot { + browser: string; + scope: 'user' | 'system'; + path: string; + exists: boolean; + json?: unknown; + raw?: string; + error?: string; +} + +interface LogFileSnapshot { + name: string; + path: string; + mtime?: string; + size?: number; + note?: string; + content?: string; + truncated?: boolean; + error?: string; +} + +interface WrapperLogsSnapshot { + dir: string; + mode: IncludeLogsMode; + files: LogFileSnapshot[]; + error?: string; +} + +interface WindowsRegistryEntrySnapshot { + browser: string; + scope: 'user' | 'system'; + key: string; + expectedManifestPath: string; + value?: string; + raw?: string; + error?: string; +} + +interface WindowsRegistrySnapshot { + entries: WindowsRegistryEntrySnapshot[]; +} + +export interface DiagnosticReport { + schemaVersion: number; + timestamp: string; + tool: { + name: string; + version: string; + }; + environment: { + platform: NodeJS.Platform; + arch: string; + node: { + version: string; + execPath: string; + }; + os: { + type: string; + release: string; + version?: string; + }; + cwd: string; + env: Record; + }; + packageManager: { + npm: VersionResult; + pnpm: VersionResult; + }; + doctor?: DoctorReport; + doctorError?: string; + manifests: ManifestSnapshot[]; + wrapperLogs: WrapperLogsSnapshot; + windowsRegistry?: WindowsRegistrySnapshot; + redaction: { + enabled: boolean; + }; +} + +function stringifyError(err: unknown): string { + if (err instanceof Error) return err.message; + return String(err); +} + +function readPackageJson(): Record { + try { + return require('../../package.json') as Record; + } catch { + return {}; + } +} + +function getToolVersion(): { name: string; version: string } { + const pkg = readPackageJson(); + const name = typeof pkg.name === 'string' ? pkg.name : COMMAND_NAME; + const version = typeof pkg.version === 'string' ? pkg.version : 'unknown'; + return { name, version }; +} + +function safeOsVersion(): string | undefined { + try { + return os.version(); + } catch { + return undefined; + } +} + +function safeExecVersion(command: string): VersionResult { + try { + const out = execFileSync(command, ['-v'], { + encoding: 'utf8', + stdio: ['ignore', 'pipe', 'pipe'], + timeout: 2500, + windowsHide: true, + }); + return { version: out.trim() }; + } catch (e) { + return { error: stringifyError(e) }; + } +} + +function parseIncludeLogsMode(raw: unknown): IncludeLogsMode { + const v = typeof raw === 'string' ? raw.toLowerCase() : ''; + if (v === 'none' || v === 'tail' || v === 'full') return v; + return 'tail'; +} + +function parsePositiveInt(raw: unknown, fallback: number): number { + if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0) return Math.floor(raw); + if (typeof raw === 'string') { + const parsed = Number.parseInt(raw, 10); + if (Number.isFinite(parsed) && parsed > 0) return parsed; + } + return fallback; +} + +function resolveBrowsers(browserArg: string | undefined): BrowserType[] { + if (!browserArg) { + const detected = detectInstalledBrowsers(); + return detected.length > 0 ? detected : [BrowserType.CHROME, BrowserType.CHROMIUM]; + } + + const normalized = browserArg.toLowerCase(); + if (normalized === 'all') return [BrowserType.CHROME, BrowserType.CHROMIUM]; + if (normalized === 'detect' || normalized === 'auto') { + const detected = detectInstalledBrowsers(); + return detected.length > 0 ? detected : [BrowserType.CHROME, BrowserType.CHROMIUM]; + } + + const parsed = parseBrowserType(normalized); + if (!parsed) { + throw new Error(`Invalid browser: ${browserArg}. Use 'chrome', 'chromium', or 'all'`); + } + return [parsed]; +} + +function readJsonSnapshot(filePath: string): { + exists: boolean; + json?: unknown; + raw?: string; + error?: string; +} { + try { + if (!fs.existsSync(filePath)) return { exists: false }; + const raw = fs.readFileSync(filePath, 'utf8'); + try { + const json = JSON.parse(raw) as unknown; + return { exists: true, json }; + } catch (e) { + return { exists: true, raw, error: `Failed to parse JSON: ${stringifyError(e)}` }; + } + } catch (e) { + return { exists: fs.existsSync(filePath), error: stringifyError(e) }; + } +} + +function collectManifests(browsers: BrowserType[]): ManifestSnapshot[] { + const results: ManifestSnapshot[] = []; + for (const browser of browsers) { + const config = getBrowserConfig(browser); + for (const scope of ['user', 'system'] as const) { + const manifestPath = scope === 'user' ? config.userManifestPath : config.systemManifestPath; + const snap = readJsonSnapshot(manifestPath); + results.push({ + browser, + scope, + path: manifestPath, + exists: snap.exists, + json: snap.json, + raw: snap.raw, + error: snap.error, + }); + } + } + return results; +} + +function readFileTail( + filePath: string, + maxBytes: number, + maxLines: number, +): { content: string; truncated: boolean } { + const stat = fs.statSync(filePath); + const size = stat.size; + const bytesToRead = Math.min(size, maxBytes); + const start = Math.max(0, size - bytesToRead); + + const fd = fs.openSync(filePath, 'r'); + try { + const buf = Buffer.alloc(bytesToRead); + fs.readSync(fd, buf, 0, bytesToRead, start); + const text = buf.toString('utf8'); + const lines = text.split(/\r?\n/); + const tail = lines.slice(Math.max(0, lines.length - maxLines)); + return { content: tail.join('\n'), truncated: size > maxBytes || lines.length > maxLines }; + } finally { + fs.closeSync(fd); + } +} + +function readFileLastBytes( + filePath: string, + maxBytes: number, +): { content: string; truncated: boolean } { + const stat = fs.statSync(filePath); + const size = stat.size; + if (size <= maxBytes) { + const content = fs.readFileSync(filePath, 'utf8'); + return { content, truncated: false }; + } + + const bytesToRead = maxBytes; + const start = Math.max(0, size - bytesToRead); + + const fd = fs.openSync(filePath, 'r'); + try { + const buf = Buffer.alloc(bytesToRead); + fs.readSync(fd, buf, 0, bytesToRead, start); + const content = buf.toString('utf8'); + return { content, truncated: true }; + } finally { + fs.closeSync(fd); + } +} + +function collectWrapperLogs( + logDir: string, + mode: IncludeLogsMode, + logLines: number, +): WrapperLogsSnapshot { + if (!fs.existsSync(logDir)) { + return { dir: logDir, mode, files: [], error: 'Log directory does not exist' }; + } + + const prefixes = ['native_host_wrapper_', 'native_host_stderr_']; + let entries: fs.Dirent[] = []; + try { + entries = fs.readdirSync(logDir, { withFileTypes: true }); + } catch (e) { + return { dir: logDir, mode, files: [], error: stringifyError(e) }; + } + + const candidates = entries + .filter((ent) => ent.isFile()) + .map((ent) => ent.name) + .filter((name) => name.endsWith('.log') && prefixes.some((p) => name.startsWith(p))); + + const filesWithStat: Array<{ name: string; fullPath: string; mtimeMs: number; size: number }> = + []; + for (const name of candidates) { + const fullPath = path.join(logDir, name); + try { + const stat = fs.statSync(fullPath); + filesWithStat.push({ name, fullPath, mtimeMs: stat.mtimeMs, size: stat.size }); + } catch { + // ignore + } + } + + filesWithStat.sort((a, b) => b.mtimeMs - a.mtimeMs); + + const selected = filesWithStat.slice(0, MAX_LOG_FILES); + const snapshots: LogFileSnapshot[] = []; + + for (const file of selected) { + const snap: LogFileSnapshot = { + name: file.name, + path: file.fullPath, + mtime: new Date(file.mtimeMs).toISOString(), + size: file.size, + }; + + if (mode !== 'none') { + try { + if (mode === 'tail') { + const read = readFileTail(file.fullPath, DEFAULT_TAIL_BYTES, logLines); + snap.content = read.content; + snap.truncated = read.truncated; + snap.note = `Tail: last ${logLines} lines (from last ${DEFAULT_TAIL_BYTES} bytes)`; + } else { + const read = readFileLastBytes(file.fullPath, MAX_FULL_LOG_BYTES); + snap.content = read.content; + snap.truncated = read.truncated; + snap.note = read.truncated + ? `Truncated: showing last ${MAX_FULL_LOG_BYTES} bytes` + : 'Full file'; + } + } catch (e) { + snap.error = stringifyError(e); + } + } else { + snap.note = 'Content omitted'; + } + + snapshots.push(snap); + } + + return { dir: logDir, mode, files: snapshots }; +} + +function queryWindowsRegistryDefaultValue(registryKey: string): { + value?: string; + raw?: string; + error?: string; +} { + try { + const output = execFileSync('reg', ['query', registryKey, '/ve'], { + encoding: 'utf8', + stdio: ['ignore', 'pipe', 'pipe'], + timeout: 2500, + windowsHide: true, + }); + const lines = output + .split(/\r?\n/) + .map((l) => l.trim()) + .filter(Boolean); + for (const line of lines) { + const match = line.match(/REG_SZ\s+(.*)$/i); + if (match?.[1]) return { value: match[1].trim(), raw: output }; + } + return { raw: output, error: 'No REG_SZ default value found' }; + } catch (e) { + return { error: stringifyError(e) }; + } +} + +function collectWindowsRegistry(browsers: BrowserType[]): WindowsRegistrySnapshot { + const entries: WindowsRegistryEntrySnapshot[] = []; + + for (const browser of browsers) { + const config = getBrowserConfig(browser); + const keySpecs = [ + config.registryKey + ? { key: config.registryKey, scope: 'user' as const, expected: config.userManifestPath } + : null, + config.systemRegistryKey + ? { + key: config.systemRegistryKey, + scope: 'system' as const, + expected: config.systemManifestPath, + } + : null, + ].filter(Boolean) as Array<{ key: string; scope: 'user' | 'system'; expected: string }>; + + for (const spec of keySpecs) { + const res = queryWindowsRegistryDefaultValue(spec.key); + entries.push({ + browser, + scope: spec.scope, + key: spec.key, + expectedManifestPath: spec.expected, + value: res.value, + raw: res.raw, + error: res.error, + }); + } + } + + return { entries }; +} + +// ============================================================================ +// Redaction +// ============================================================================ + +function escapeRegExp(input: string): string { + return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); +} + +function buildLiteralReplacements(): Array<[RegExp, string]> { + const replacements: Array<[RegExp, string]> = []; + const ignoreCase = process.platform === 'win32'; + + const addLiteral = (literal: string | undefined, replacement: string): void => { + if (!literal) return; + const variants = new Set(); + variants.add(literal); + variants.add(literal.replace(/\\/g, '/')); + variants.add(literal.replace(/\//g, '\\')); + + for (const v of variants) { + if (!v) continue; + replacements.push([new RegExp(escapeRegExp(v), ignoreCase ? 'gi' : 'g'), replacement]); + } + }; + + addLiteral(os.homedir(), ''); + addLiteral(process.env.USERPROFILE, ''); + addLiteral(process.env.HOME, ''); + + try { + const username = os.userInfo().username; + if (username) { + replacements.push([ + new RegExp(`\\b${escapeRegExp(username)}\\b`, ignoreCase ? 'gi' : 'g'), + '', + ]); + } + } catch { + // ignore + } + + return replacements; +} + +function createRedactor(enabled: boolean): (input: string) => string { + if (!enabled) return (s) => s; + + const literalReplacements = buildLiteralReplacements(); + const patternReplacements: Array<[RegExp, string]> = [ + // Sensitive key=value patterns (supports JSON-style "key": "value" and env-style KEY=value) + [ + /(\b[A-Z0-9_]*(?:TOKEN|PASSWORD|SECRET|API_KEY|ACCESS_KEY|PRIVATE_KEY)\b)(\s*["']?\s*[:=]\s*["']?)([^\s"']+)/gi, + '$1$2', + ], + // HTTP Authorization headers + [/(Authorization:\s*Bearer\s+)[^\s]+/gi, '$1'], + [/(Authorization:\s*Basic\s+)[^\s]+/gi, '$1'], + // JSON-style Authorization fields ("Authorization": "Bearer ...") + [ + /(\bAuthorization\b)(\s*["']?\s*[:=]\s*["']?)(Bearer\s+|Basic\s+)?[^\s"']+/gi, + '$1$2$3', + ], + // Cookies + [/(Cookie:\s*)[^\r\n]+/gi, '$1'], + [/(Set-Cookie:\s*)[^\r\n]+/gi, '$1'], + // JSON-style Cookie fields ("Cookie": "...") + [/(\b(?:Cookie|Set-Cookie)\b)(\s*["']?\s*[:=]\s*["']?)[^\r\n"']+/gi, '$1$2'], + // Common API header patterns (supports JSON-style) + [ + /(\b(?:x-api-key|api-key|x-auth-token|x-access-token)\b)(\s*["']?\s*[:=]\s*["']?)([^\s"']+)/gi, + '$1$2', + ], + // Email addresses + [/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, ''], + // User paths (Windows and macOS/Linux) + [/[A-Z]:\\Users\\[^\\]+/gi, ''], + [/\/Users\/[^/]+/g, '/Users/'], + ]; + + return (input: string): string => { + let out = input; + for (const [re, replacement] of literalReplacements) { + out = out.replace(re, replacement); + } + for (const [re, replacement] of patternReplacements) { + out = out.replace(re, replacement); + } + return out; + }; +} + +function redactDeep(value: unknown, redact: (s: string) => string): unknown { + if (typeof value === 'string') return redact(value); + if (Array.isArray(value)) return value.map((v) => redactDeep(v, redact)); + if (value && typeof value === 'object') { + const obj = value as Record; + const out: Record = {}; + for (const [k, v] of Object.entries(obj)) { + out[k] = redactDeep(v, redact); + } + return out; + } + return value; +} + +// ============================================================================ +// Output Rendering +// ============================================================================ + +function renderMarkdown(report: DiagnosticReport): string { + const lines: string[] = []; + + lines.push(`# ${report.tool.name} Diagnostic Report`); + lines.push(''); + lines.push(`**Generated:** ${report.timestamp}`); + lines.push(`**Redaction:** ${report.redaction.enabled ? 'enabled (default)' : 'disabled'}`); + lines.push(''); + + lines.push('## Environment'); + lines.push(''); + lines.push(`- **Platform:** ${report.environment.platform} (${report.environment.arch})`); + lines.push( + `- **OS:** ${report.environment.os.type} ${report.environment.os.release}${ + report.environment.os.version ? ` (${report.environment.os.version})` : '' + }`, + ); + lines.push(`- **Node:** ${report.environment.node.version}`); + lines.push(`- **Node execPath:** \`${report.environment.node.execPath}\``); + lines.push(`- **CWD:** \`${report.environment.cwd}\``); + lines.push(''); + + lines.push('## Package Managers'); + lines.push(''); + lines.push( + `- **npm:** ${ + report.packageManager.npm.version ?? `ERROR: ${report.packageManager.npm.error ?? 'unknown'}` + }`, + ); + lines.push( + `- **pnpm:** ${ + report.packageManager.pnpm.version ?? + `ERROR: ${report.packageManager.pnpm.error ?? 'unknown'}` + }`, + ); + lines.push(''); + + lines.push('## Relevant Environment Variables'); + lines.push(''); + for (const [k, v] of Object.entries(report.environment.env)) { + lines.push(`- \`${k}\`: ${v ?? ''}`); + } + lines.push(''); + + lines.push('## Doctor Output'); + lines.push(''); + if (report.doctor) { + lines.push('
'); + lines.push('Click to expand doctor JSON'); + lines.push(''); + lines.push('```json'); + lines.push(JSON.stringify(report.doctor, null, 2)); + lines.push('```'); + lines.push('
'); + } else { + lines.push(`**Doctor failed:** ${report.doctorError ?? 'unknown error'}`); + } + lines.push(''); + + lines.push('## Wrapper Logs'); + lines.push(''); + lines.push(`**Log directory:** \`${report.wrapperLogs.dir}\``); + lines.push(`**Mode:** ${report.wrapperLogs.mode}`); + if (report.wrapperLogs.error) { + lines.push(`**Error:** ${report.wrapperLogs.error}`); + } + lines.push(''); + if (report.wrapperLogs.files.length === 0) { + lines.push('No wrapper logs found.'); + } else { + for (const f of report.wrapperLogs.files) { + lines.push(`### ${f.name}`); + lines.push(''); + lines.push(`- **Path:** \`${f.path}\``); + if (f.mtime) lines.push(`- **Modified:** ${f.mtime}`); + if (typeof f.size === 'number') lines.push(`- **Size:** ${f.size} bytes`); + if (f.note) lines.push(`- **Note:** ${f.note}`); + if (f.error) { + lines.push(`- **Error:** ${f.error}`); + lines.push(''); + continue; + } + if (typeof f.content === 'string') { + if (f.truncated) lines.push('*(Truncated)*'); + lines.push(''); + lines.push('
'); + lines.push('Click to expand log content'); + lines.push(''); + lines.push('```text'); + lines.push(f.content); + lines.push('```'); + lines.push('
'); + } else { + lines.push('*(Content omitted)*'); + } + lines.push(''); + } + } + lines.push(''); + + lines.push('## Manifests'); + lines.push(''); + for (const m of report.manifests) { + lines.push(`### ${m.browser} (${m.scope})`); + lines.push(''); + lines.push(`- **Path:** \`${m.path}\``); + if (!m.exists) { + lines.push('- **Status:** not found'); + lines.push(''); + continue; + } + if (m.error) { + lines.push(`- **Status:** error (${m.error})`); + } + if (m.json !== undefined) { + lines.push(''); + lines.push('```json'); + lines.push(JSON.stringify(m.json, null, 2)); + lines.push('```'); + } else if (typeof m.raw === 'string') { + lines.push(''); + lines.push('```text'); + lines.push(m.raw); + lines.push('```'); + } + lines.push(''); + } + + if (report.windowsRegistry) { + lines.push('## Windows Registry'); + lines.push(''); + for (const entry of report.windowsRegistry.entries) { + lines.push(`### ${entry.browser} (${entry.scope})`); + lines.push(''); + lines.push(`- **Key:** \`${entry.key}\``); + lines.push(`- **Expected manifest:** \`${entry.expectedManifestPath}\``); + if (entry.error) { + lines.push(`- **Error:** ${entry.error}`); + lines.push(''); + continue; + } + if (entry.value) lines.push(`- **Default value:** \`${entry.value}\``); + if (entry.raw) { + lines.push(''); + lines.push('```text'); + lines.push(entry.raw); + lines.push('```'); + } + lines.push(''); + } + } + + lines.push('---'); + lines.push(''); + lines.push( + '> If you are opening a GitHub Issue, paste everything above. ' + + `You can disable redaction with: \`${report.tool.name} report --no-redact\``, + ); + + return lines.join('\n'); +} + +function writeOutput( + outputPath: string | undefined, + content: string, +): { ok: true; destination: string } | { ok: false; error: string } { + if (!outputPath || outputPath === '-' || outputPath.toLowerCase() === 'stdout') { + process.stdout.write(content); + return { ok: true, destination: 'stdout' }; + } + + try { + const resolved = path.resolve(outputPath); + fs.writeFileSync(resolved, content, 'utf8'); + return { ok: true, destination: resolved }; + } catch (e) { + return { ok: false, error: stringifyError(e) }; + } +} + +function tryCopyToClipboard(text: string): { ok: boolean; method?: string; error?: string } { + const spawn = (cmd: string, args: string[]): { ok: boolean; error?: string } => { + const res = spawnSync(cmd, args, { + input: text, + encoding: 'utf8', + timeout: 3000, + windowsHide: true, + }); + if (res.error) return { ok: false, error: stringifyError(res.error) }; + if (res.status !== 0) return { ok: false, error: `Exit code ${res.status ?? 'unknown'}` }; + return { ok: true }; + }; + + if (process.platform === 'darwin') { + const r = spawn('pbcopy', []); + return r.ok ? { ok: true, method: 'pbcopy' } : { ok: false, method: 'pbcopy', error: r.error }; + } + if (process.platform === 'win32') { + const r = spawn('clip', []); + return r.ok ? { ok: true, method: 'clip' } : { ok: false, method: 'clip', error: r.error }; + } + + // Linux: try wl-copy, xclip, xsel + for (const cmd of [ + { cmd: 'wl-copy', args: [] as string[] }, + { cmd: 'xclip', args: ['-selection', 'clipboard'] as string[] }, + { cmd: 'xsel', args: ['--clipboard', '--input'] as string[] }, + ]) { + const r = spawn(cmd.cmd, cmd.args); + if (r.ok) return { ok: true, method: cmd.cmd }; + } + + return { ok: false, error: 'No clipboard command available (tried wl-copy, xclip, xsel)' }; +} + +// ============================================================================ +// Main Report Function +// ============================================================================ + +export async function runReport(options: ReportOptions): Promise { + try { + const includeLogs = parseIncludeLogsMode(options.includeLogs); + const logLines = parsePositiveInt(options.logLines, DEFAULT_LOG_LINES); + const redactionEnabled = options.redact !== false; + + const tool = getToolVersion(); + const browsers = resolveBrowsers(options.browser); + + // Collect doctor report + let doctor: DoctorReport | undefined; + let doctorError: string | undefined; + try { + doctor = await collectDoctorReport({ + json: true, + fix: false, + browser: options.browser, + }); + } catch (e) { + doctorError = stringifyError(e); + } + + // Build the report + const report: DiagnosticReport = { + schemaVersion: REPORT_SCHEMA_VERSION, + timestamp: new Date().toISOString(), + tool, + environment: { + platform: process.platform, + arch: process.arch, + node: { version: process.version, execPath: process.execPath }, + os: { type: os.type(), release: os.release(), version: safeOsVersion() }, + cwd: process.cwd(), + env: { + CHROME_MCP_NODE_PATH: process.env.CHROME_MCP_NODE_PATH ?? null, + VOLTA_HOME: process.env.VOLTA_HOME ?? null, + ASDF_DATA_DIR: process.env.ASDF_DATA_DIR ?? null, + FNM_DIR: process.env.FNM_DIR ?? null, + NVM_DIR: process.env.NVM_DIR ?? null, + // nvm-windows uses different environment variables + NVM_HOME: process.env.NVM_HOME ?? null, + NVM_SYMLINK: process.env.NVM_SYMLINK ?? null, + npm_config_user_agent: process.env.npm_config_user_agent ?? null, + }, + }, + packageManager: { + npm: safeExecVersion('npm'), + pnpm: safeExecVersion('pnpm'), + }, + doctor, + doctorError, + manifests: collectManifests(browsers), + wrapperLogs: collectWrapperLogs(getLogDir(), includeLogs, logLines), + windowsRegistry: process.platform === 'win32' ? collectWindowsRegistry(browsers) : undefined, + redaction: { enabled: redactionEnabled }, + }; + + // Apply redaction + const redact = createRedactor(redactionEnabled); + const finalReport = redactionEnabled + ? (redactDeep(report, redact) as DiagnosticReport) + : report; + + // Render output + const output = options.json + ? JSON.stringify(finalReport, null, 2) + '\n' + : renderMarkdown(finalReport) + '\n'; + + // Write output + const write = writeOutput(options.output, output); + if (!write.ok) { + process.stderr.write(`Failed to write report: ${write.error}\n`); + process.stdout.write(output); + } else if (write.destination !== 'stdout') { + process.stderr.write(`Report written to: ${write.destination}\n`); + } + + // Copy to clipboard if requested + if (options.copy) { + const copied = tryCopyToClipboard(output); + if (copied.ok) { + process.stderr.write(`Copied to clipboard (${copied.method})\n`); + } else { + process.stderr.write(`Failed to copy to clipboard: ${copied.error ?? 'unknown error'}\n`); + } + } + + return 0; + } catch (e) { + process.stderr.write(`Report failed: ${stringifyError(e)}\n`); + return 1; + } +} diff --git a/app/native-server/src/scripts/run_host.bat b/app/native-server/src/scripts/run_host.bat index c409c8f8..3731a958 100644 --- a/app/native-server/src/scripts/run_host.bat +++ b/app/native-server/src/scripts/run_host.bat @@ -4,10 +4,17 @@ setlocal enabledelayedexpansion REM Setup paths set "SCRIPT_DIR=%~dp0" if "%SCRIPT_DIR:~-1%"=="\" set "SCRIPT_DIR=%SCRIPT_DIR:~0,-1%" -set "LOG_DIR=%SCRIPT_DIR%\logs" set "NODE_SCRIPT=%SCRIPT_DIR%\index.js" -if not exist "%LOG_DIR%" md "%LOG_DIR%" +REM Setup log directory - prefer user-writable locations +REM Windows: %LOCALAPPDATA%\mcp-chrome-bridge\logs +set "LOG_DIR=%LOCALAPPDATA%\mcp-chrome-bridge\logs" +if not exist "%LOG_DIR%" mkdir "%LOG_DIR%" 2>nul +if not exist "%LOG_DIR%" ( + REM Fallback to package directory if user directory not writable + set "LOG_DIR=%SCRIPT_DIR%\logs" + if not exist "!LOG_DIR!" mkdir "!LOG_DIR!" 2>nul +) REM Generate timestamp for /f %%i in ('powershell -NoProfile -Command "Get-Date -Format 'yyyyMMdd_HHmmss'"') do set "TIMESTAMP=%%i" @@ -20,54 +27,129 @@ echo SCRIPT_DIR: %SCRIPT_DIR% >> "%WRAPPER_LOG%" echo LOG_DIR: %LOG_DIR% >> "%WRAPPER_LOG%" echo NODE_SCRIPT: %NODE_SCRIPT% >> "%WRAPPER_LOG%" echo Initial PATH: %PATH% >> "%WRAPPER_LOG%" +echo CHROME_MCP_NODE_PATH: %CHROME_MCP_NODE_PATH% >> "%WRAPPER_LOG%" +echo VOLTA_HOME: %VOLTA_HOME% >> "%WRAPPER_LOG%" +echo ASDF_DATA_DIR: %ASDF_DATA_DIR% >> "%WRAPPER_LOG%" +echo FNM_DIR: %FNM_DIR% >> "%WRAPPER_LOG%" echo User: %USERNAME% >> "%WRAPPER_LOG%" echo Current PWD: %CD% >> "%WRAPPER_LOG%" REM Node.js discovery set "NODE_EXEC=" +set "NODE_EXEC_SOURCE=" + +REM Priority 0: CHROME_MCP_NODE_PATH environment variable override +echo [Priority 0] Checking CHROME_MCP_NODE_PATH override >> "%WRAPPER_LOG%" +if defined CHROME_MCP_NODE_PATH ( + set "CANDIDATE_NODE=%CHROME_MCP_NODE_PATH%" + REM Check if it's a directory, then append node.exe + if exist "!CANDIDATE_NODE!\*" ( + set "CANDIDATE_NODE=!CANDIDATE_NODE!\node.exe" + ) + if exist "!CANDIDATE_NODE!" ( + set "NODE_EXEC=!CANDIDATE_NODE!" + set "NODE_EXEC_SOURCE=CHROME_MCP_NODE_PATH" + echo Found node via CHROME_MCP_NODE_PATH: !NODE_EXEC! >> "%WRAPPER_LOG%" + ) else ( + echo CHROME_MCP_NODE_PATH is set but not found: !CANDIDATE_NODE! >> "%WRAPPER_LOG%" + ) +) REM Priority 1: Installation-time node path set "NODE_PATH_FILE=%SCRIPT_DIR%\node_path.txt" -echo Checking installation-time node path >> "%WRAPPER_LOG%" -if exist "%NODE_PATH_FILE%" ( - set /p EXPECTED_NODE=<"%NODE_PATH_FILE%" - if exist "!EXPECTED_NODE!" ( - set "NODE_EXEC=!EXPECTED_NODE!" - echo Found installation-time node at !NODE_EXEC! >> "%WRAPPER_LOG%" +echo [Priority 1] Checking installation-time node path >> "%WRAPPER_LOG%" +if not defined NODE_EXEC ( + if exist "%NODE_PATH_FILE%" ( + set /p EXPECTED_NODE=<"%NODE_PATH_FILE%" + if exist "!EXPECTED_NODE!" ( + set "NODE_EXEC=!EXPECTED_NODE!" + set "NODE_EXEC_SOURCE=node_path.txt" + echo Found installation-time node at !NODE_EXEC! >> "%WRAPPER_LOG%" + ) else ( + echo node_path.txt exists but path invalid: !EXPECTED_NODE! >> "%WRAPPER_LOG%" + ) ) ) REM Priority 1.5: Fallback to relative path if not defined NODE_EXEC ( set "EXPECTED_NODE=%SCRIPT_DIR%\..\..\..\node.exe" - echo Checking relative path >> "%WRAPPER_LOG%" + echo [Priority 1.5] Checking relative path >> "%WRAPPER_LOG%" if exist "%EXPECTED_NODE%" ( set "NODE_EXEC=%EXPECTED_NODE%" + set "NODE_EXEC_SOURCE=relative" echo Found node at relative path: !NODE_EXEC! >> "%WRAPPER_LOG%" ) ) -REM Priority 2: where command +REM Priority 2: Volta +if not defined NODE_EXEC ( + echo [Priority 2] Checking Volta >> "%WRAPPER_LOG%" + if defined VOLTA_HOME ( + if exist "%VOLTA_HOME%\bin\node.exe" ( + set "NODE_EXEC=%VOLTA_HOME%\bin\node.exe" + set "NODE_EXEC_SOURCE=volta" + echo Found Volta node: !NODE_EXEC! >> "%WRAPPER_LOG%" + ) + ) else ( + if exist "%USERPROFILE%\.volta\bin\node.exe" ( + set "NODE_EXEC=%USERPROFILE%\.volta\bin\node.exe" + set "NODE_EXEC_SOURCE=volta" + echo Found Volta node: !NODE_EXEC! >> "%WRAPPER_LOG%" + ) + ) +) + +REM Priority 3: asdf (use PowerShell to find latest version) if not defined NODE_EXEC ( - echo Trying 'where node.exe' >> "%WRAPPER_LOG%" + echo [Priority 3] Checking asdf >> "%WRAPPER_LOG%" + set "ASDF_NODE=" + for /f "delims=" %%i in ('powershell -NoProfile -Command "$base=$env:ASDF_DATA_DIR; if(-not $base){$base=Join-Path $env:USERPROFILE '.asdf'}; $root=Join-Path $base 'installs\nodejs'; $best=$null; if(Test-Path $root){ foreach($d in (Get-ChildItem -Directory -Path $root -ErrorAction SilentlyContinue)){ if($d.Name -match '^v?\d+(\.\d+){1,3}$'){ $v=[version]($d.Name -replace '^v',''); if(-not $best -or $v -gt $best.Ver){ $best=[pscustomobject]@{Ver=$v;Dir=$d.FullName} } } } }; if($best){ $p=Join-Path $best.Dir 'bin\node.exe'; if(Test-Path $p){ Write-Output $p } }" 2^>nul') do set "ASDF_NODE=%%i" + if defined ASDF_NODE ( + set "NODE_EXEC=!ASDF_NODE!" + set "NODE_EXEC_SOURCE=asdf" + echo Found asdf node: !NODE_EXEC! >> "%WRAPPER_LOG%" + ) +) + +REM Priority 4: fnm (use PowerShell to find latest version) +if not defined NODE_EXEC ( + echo [Priority 4] Checking fnm >> "%WRAPPER_LOG%" + set "FNM_NODE=" + for /f "delims=" %%i in ('powershell -NoProfile -Command "$base=$env:FNM_DIR; if(-not $base){$base=Join-Path $env:USERPROFILE '.fnm'}; $root=Join-Path $base 'node-versions'; $best=$null; if(Test-Path $root){ foreach($d in (Get-ChildItem -Directory -Path $root -ErrorAction SilentlyContinue)){ if($d.Name -match '^v?\d+(\.\d+){1,3}$'){ $v=[version]($d.Name -replace '^v',''); if(-not $best -or $v -gt $best.Ver){ $best=[pscustomobject]@{Ver=$v;Dir=$d.FullName} } } } }; if($best){ $p=Join-Path $best.Dir 'installation\node.exe'; if(Test-Path $p){ Write-Output $p } }" 2^>nul') do set "FNM_NODE=%%i" + if defined FNM_NODE ( + set "NODE_EXEC=!FNM_NODE!" + set "NODE_EXEC_SOURCE=fnm" + echo Found fnm node: !NODE_EXEC! >> "%WRAPPER_LOG%" + ) +) + +REM Priority 5: where command +if not defined NODE_EXEC ( + echo [Priority 5] Trying 'where node.exe' >> "%WRAPPER_LOG%" for /f "delims=" %%i in ('where node.exe 2^>nul') do ( if not defined NODE_EXEC ( set "NODE_EXEC=%%i" + set "NODE_EXEC_SOURCE=where" echo Found node using 'where': !NODE_EXEC! >> "%WRAPPER_LOG%" ) ) ) -REM Priority 3: Common paths +REM Priority 6: Common paths if not defined NODE_EXEC ( + echo [Priority 6] Checking common paths >> "%WRAPPER_LOG%" if exist "%ProgramFiles%\nodejs\node.exe" ( set "NODE_EXEC=%ProgramFiles%\nodejs\node.exe" + set "NODE_EXEC_SOURCE=common" echo Found node at !NODE_EXEC! >> "%WRAPPER_LOG%" ) else if exist "%ProgramFiles(x86)%\nodejs\node.exe" ( set "NODE_EXEC=%ProgramFiles(x86)%\nodejs\node.exe" + set "NODE_EXEC_SOURCE=common" echo Found node at !NODE_EXEC! >> "%WRAPPER_LOG%" ) else if exist "%LOCALAPPDATA%\Programs\nodejs\node.exe" ( set "NODE_EXEC=%LOCALAPPDATA%\Programs\nodejs\node.exe" + set "NODE_EXEC_SOURCE=common" echo Found node at !NODE_EXEC! >> "%WRAPPER_LOG%" ) ) @@ -75,10 +157,13 @@ if not defined NODE_EXEC ( REM Validation if not defined NODE_EXEC ( echo ERROR: Node.js executable not found! >> "%WRAPPER_LOG%" + echo Searched: CHROME_MCP_NODE_PATH, node_path.txt, relative, Volta, asdf, fnm, where, common paths >> "%WRAPPER_LOG%" + echo To fix: Set CHROME_MCP_NODE_PATH environment variable or run 'mcp-chrome-bridge doctor --fix' >> "%WRAPPER_LOG%" exit /B 1 ) echo Using Node executable: %NODE_EXEC% >> "%WRAPPER_LOG%" +echo Node discovery source: %NODE_EXEC_SOURCE% >> "%WRAPPER_LOG%" call "%NODE_EXEC%" -v >> "%WRAPPER_LOG%" 2>>&1 if not exist "%NODE_SCRIPT%" ( @@ -86,10 +171,24 @@ if not exist "%NODE_SCRIPT%" ( exit /B 1 ) +REM Add Node.js bin directory to PATH for child processes +for %%I in ("%NODE_EXEC%") do set "NODE_BIN_DIR=%%~dpI" +if defined PATH (set "PATH=%NODE_BIN_DIR%;%PATH%") else (set "PATH=%NODE_BIN_DIR%") +echo Added %NODE_BIN_DIR% to PATH >> "%WRAPPER_LOG%" + +REM Log Claude Code Router (CCR) related env vars for debugging +REM These are set via System Properties or PowerShell profile +if defined ANTHROPIC_BASE_URL ( + echo ANTHROPIC_BASE_URL is set: %ANTHROPIC_BASE_URL% >> "%WRAPPER_LOG%" +) +if defined ANTHROPIC_AUTH_TOKEN ( + echo ANTHROPIC_AUTH_TOKEN is set (value hidden) >> "%WRAPPER_LOG%" +) + echo Executing: "%NODE_EXEC%" "%NODE_SCRIPT%" >> "%WRAPPER_LOG%" call "%NODE_EXEC%" "%NODE_SCRIPT%" 2>> "%STDERR_LOG%" set "EXIT_CODE=%ERRORLEVEL%" echo Exit code: %EXIT_CODE% >> "%WRAPPER_LOG%" endlocal -exit /B %EXIT_CODE% \ No newline at end of file +exit /B %EXIT_CODE% diff --git a/app/native-server/src/scripts/run_host.sh b/app/native-server/src/scripts/run_host.sh index 3418f57f..b82e0ae2 100644 --- a/app/native-server/src/scripts/run_host.sh +++ b/app/native-server/src/scripts/run_host.sh @@ -6,20 +6,34 @@ LOG_RETENTION_COUNT=5 # Setup paths SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" -LOG_DIR="${SCRIPT_DIR}/logs" -mkdir -p "${LOG_DIR}" +NODE_SCRIPT="${SCRIPT_DIR}/index.js" + +# Setup log directory - prefer user-writable locations +# macOS: ~/Library/Logs/mcp-chrome-bridge +# Linux: $XDG_STATE_HOME/mcp-chrome-bridge/logs or ~/.local/state/mcp-chrome-bridge/logs +if [ "$(uname)" = "Darwin" ]; then + LOG_DIR="${HOME}/Library/Logs/mcp-chrome-bridge" +else + LOG_DIR="${XDG_STATE_HOME:-${HOME}/.local/state}/mcp-chrome-bridge/logs" +fi + +# Fallback: if user directory is not writable, use package directory +if ! mkdir -p "${LOG_DIR}" 2>/dev/null; then + LOG_DIR="${SCRIPT_DIR}/logs" + mkdir -p "${LOG_DIR}" 2>/dev/null || true +fi # Log rotation if [ "${ENABLE_LOG_ROTATION}" = "true" ]; then - ls -tp "${LOG_DIR}/native_host_wrapper_macos_"* 2>/dev/null | tail -n +$((LOG_RETENTION_COUNT + 1)) | xargs -I {} rm -- {} - ls -tp "${LOG_DIR}/native_host_stderr_macos_"* 2>/dev/null | tail -n +$((LOG_RETENTION_COUNT + 1)) | xargs -I {} rm -- {} + # Clean up old logs (both legacy _macos_ and new _unix_ naming) + ls -tp "${LOG_DIR}/native_host_wrapper_"* 2>/dev/null | tail -n +$((LOG_RETENTION_COUNT + 1)) | xargs -I {} rm -- {} + ls -tp "${LOG_DIR}/native_host_stderr_"* 2>/dev/null | tail -n +$((LOG_RETENTION_COUNT + 1)) | xargs -I {} rm -- {} fi # Logging setup TIMESTAMP=$(date +"%Y%m%d_%H%M%S") -WRAPPER_LOG="${LOG_DIR}/native_host_wrapper_macos_${TIMESTAMP}.log" -STDERR_LOG="${LOG_DIR}/native_host_stderr_macos_${TIMESTAMP}.log" -NODE_SCRIPT="${SCRIPT_DIR}/index.js" +WRAPPER_LOG="${LOG_DIR}/native_host_wrapper_unix_${TIMESTAMP}.log" +STDERR_LOG="${LOG_DIR}/native_host_stderr_unix_${TIMESTAMP}.log" # Initial logging { @@ -28,22 +42,53 @@ NODE_SCRIPT="${SCRIPT_DIR}/index.js" echo "LOG_DIR: ${LOG_DIR}" echo "NODE_SCRIPT: ${NODE_SCRIPT}" echo "Initial PATH: ${PATH}" + echo "CHROME_MCP_NODE_PATH: ${CHROME_MCP_NODE_PATH:-}" + echo "VOLTA_HOME: ${VOLTA_HOME:-}" + echo "ASDF_DATA_DIR: ${ASDF_DATA_DIR:-}" + echo "FNM_DIR: ${FNM_DIR:-}" + echo "NVM_DIR: ${NVM_DIR:-}" echo "User: $(whoami)" echo "Current PWD: $(pwd)" } > "${WRAPPER_LOG}" # Node.js discovery NODE_EXEC="" - -# Priority 1: Installation-time node path +NODE_EXEC_SOURCE="" NODE_PATH_FILE="${SCRIPT_DIR}/node_path.txt" + echo "Searching for Node.js..." >> "${WRAPPER_LOG}" + +# Priority 0: CHROME_MCP_NODE_PATH environment variable override +echo "[Priority 0] Checking CHROME_MCP_NODE_PATH override" >> "${WRAPPER_LOG}" +if [ -n "${CHROME_MCP_NODE_PATH:-}" ]; then + CANDIDATE_NODE="${CHROME_MCP_NODE_PATH}" + # Expand tilde + if [[ "${CANDIDATE_NODE}" == "~/"* ]]; then + CANDIDATE_NODE="${HOME}/${CANDIDATE_NODE#~/}" + fi + # If directory, append /node + if [ -d "${CANDIDATE_NODE}" ]; then + CANDIDATE_NODE="${CANDIDATE_NODE%/}/node" + fi + if [ -x "${CANDIDATE_NODE}" ]; then + NODE_EXEC="${CANDIDATE_NODE}" + NODE_EXEC_SOURCE="CHROME_MCP_NODE_PATH" + echo "Found node via CHROME_MCP_NODE_PATH: ${NODE_EXEC}" >> "${WRAPPER_LOG}" + else + echo "CHROME_MCP_NODE_PATH is set but not executable: ${CANDIDATE_NODE}" >> "${WRAPPER_LOG}" + fi +fi + +# Priority 1: Installation-time node path echo "[Priority 1] Checking installation-time node path" >> "${WRAPPER_LOG}" -if [ -f "${NODE_PATH_FILE}" ]; then +if [ -z "${NODE_EXEC}" ] && [ -f "${NODE_PATH_FILE}" ]; then EXPECTED_NODE=$(cat "${NODE_PATH_FILE}" 2>/dev/null | tr -d '\n\r') if [ -n "${EXPECTED_NODE}" ] && [ -x "${EXPECTED_NODE}" ]; then NODE_EXEC="${EXPECTED_NODE}" + NODE_EXEC_SOURCE="node_path.txt" echo "Found installation-time node at ${NODE_EXEC}" >> "${WRAPPER_LOG}" + else + echo "node_path.txt exists but path invalid or not executable: ${EXPECTED_NODE}" >> "${WRAPPER_LOG}" fi fi @@ -53,69 +98,125 @@ if [ -z "${NODE_EXEC}" ]; then echo "[Priority 1.5] Checking relative path" >> "${WRAPPER_LOG}" if [ -x "${EXPECTED_NODE}" ]; then NODE_EXEC="${EXPECTED_NODE}" + NODE_EXEC_SOURCE="relative" echo "Found node at relative path: ${NODE_EXEC}" >> "${WRAPPER_LOG}" fi fi -# Priority 2: NVM +# Priority 2: Volta +if [ -z "${NODE_EXEC}" ]; then + echo "[Priority 2] Checking Volta" >> "${WRAPPER_LOG}" + VOLTA_HOME_CANDIDATE="${VOLTA_HOME:-$HOME/.volta}" + VOLTA_NODE="${VOLTA_HOME_CANDIDATE}/bin/node" + if [ -x "${VOLTA_NODE}" ]; then + NODE_EXEC="${VOLTA_NODE}" + NODE_EXEC_SOURCE="volta" + echo "Found Volta node: ${NODE_EXEC}" >> "${WRAPPER_LOG}" + fi +fi + +# Priority 3: asdf +if [ -z "${NODE_EXEC}" ]; then + echo "[Priority 3] Checking asdf" >> "${WRAPPER_LOG}" + ASDF_DIR="${ASDF_DATA_DIR:-$HOME/.asdf}" + ASDF_NODEJS_DIR="${ASDF_DIR}/installs/nodejs" + if [ -d "${ASDF_NODEJS_DIR}" ]; then + # Find the latest version directory + LATEST_ASDF_NODE_DIR=$(ls -1d "${ASDF_NODEJS_DIR}/"* 2>/dev/null | sort -V | tail -n 1) + if [ -n "${LATEST_ASDF_NODE_DIR}" ] && [ -x "${LATEST_ASDF_NODE_DIR}/bin/node" ]; then + NODE_EXEC="${LATEST_ASDF_NODE_DIR}/bin/node" + NODE_EXEC_SOURCE="asdf" + echo "Found asdf node: ${NODE_EXEC}" >> "${WRAPPER_LOG}" + fi + fi +fi + +# Priority 4: fnm if [ -z "${NODE_EXEC}" ]; then - echo "[Priority 2] Checking NVM" >> "${WRAPPER_LOG}" - NVM_DIR="$HOME/.nvm" + echo "[Priority 4] Checking fnm" >> "${WRAPPER_LOG}" + FNM_HOME_CANDIDATE="${FNM_DIR:-$HOME/.fnm}" + FNM_NODE_VERSIONS_DIR="${FNM_HOME_CANDIDATE}/node-versions" + if [ -d "${FNM_NODE_VERSIONS_DIR}" ]; then + # Find the latest version directory + LATEST_FNM_NODE_DIR=$(ls -1d "${FNM_NODE_VERSIONS_DIR}/"* 2>/dev/null | sort -V | tail -n 1) + if [ -n "${LATEST_FNM_NODE_DIR}" ] && [ -x "${LATEST_FNM_NODE_DIR}/installation/bin/node" ]; then + NODE_EXEC="${LATEST_FNM_NODE_DIR}/installation/bin/node" + NODE_EXEC_SOURCE="fnm" + echo "Found fnm node: ${NODE_EXEC}" >> "${WRAPPER_LOG}" + fi + fi +fi + +# Priority 5: NVM +if [ -z "${NODE_EXEC}" ]; then + echo "[Priority 5] Checking NVM" >> "${WRAPPER_LOG}" + NVM_DIR="${NVM_DIR:-$HOME/.nvm}" if [ -d "${NVM_DIR}" ]; then - # Try default version first - if [ -L "${NVM_DIR}/alias/default" ]; then - NVM_DEFAULT_VERSION=$(readlink "${NVM_DIR}/alias/default") + # Try default version first (check both symlink and file) + NVM_DEFAULT_ALIAS="${NVM_DIR}/alias/default" + if [ -e "${NVM_DEFAULT_ALIAS}" ]; then + if [ -L "${NVM_DEFAULT_ALIAS}" ]; then + NVM_DEFAULT_VERSION=$(readlink "${NVM_DEFAULT_ALIAS}") + else + NVM_DEFAULT_VERSION=$(cat "${NVM_DEFAULT_ALIAS}" 2>/dev/null | tr -d '\n\r') + fi NVM_DEFAULT_NODE="${NVM_DIR}/versions/node/${NVM_DEFAULT_VERSION}/bin/node" if [ -x "${NVM_DEFAULT_NODE}" ]; then NODE_EXEC="${NVM_DEFAULT_NODE}" + NODE_EXEC_SOURCE="nvm-default" echo "Found NVM default node: ${NODE_EXEC}" >> "${WRAPPER_LOG}" fi fi # Fallback to latest version if [ -z "${NODE_EXEC}" ]; then - LATEST_NVM_VERSION_PATH=$(ls -d ${NVM_DIR}/versions/node/v* 2>/dev/null | sort -V | tail -n 1) + LATEST_NVM_VERSION_PATH=$(ls -d "${NVM_DIR}"/versions/node/v* 2>/dev/null | sort -V | tail -n 1) if [ -n "${LATEST_NVM_VERSION_PATH}" ] && [ -x "${LATEST_NVM_VERSION_PATH}/bin/node" ]; then NODE_EXEC="${LATEST_NVM_VERSION_PATH}/bin/node" + NODE_EXEC_SOURCE="nvm-latest" echo "Found NVM latest node: ${NODE_EXEC}" >> "${WRAPPER_LOG}" fi fi fi fi -# Priority 3: Common paths +# Priority 6: Common paths if [ -z "${NODE_EXEC}" ]; then - echo "[Priority 3] Checking common paths" >> "${WRAPPER_LOG}" + echo "[Priority 6] Checking common paths" >> "${WRAPPER_LOG}" COMMON_NODE_PATHS=( "/opt/homebrew/bin/node" "/usr/local/bin/node" + "/usr/bin/node" ) for path_to_node in "${COMMON_NODE_PATHS[@]}"; do if [ -x "${path_to_node}" ]; then NODE_EXEC="${path_to_node}" + NODE_EXEC_SOURCE="common" echo "Found node at: ${NODE_EXEC}" >> "${WRAPPER_LOG}" break fi done fi -# Priority 4: command -v +# Priority 7: command -v if [ -z "${NODE_EXEC}" ]; then - echo "[Priority 4] Trying 'command -v node'" >> "${WRAPPER_LOG}" + echo "[Priority 7] Trying 'command -v node'" >> "${WRAPPER_LOG}" if command -v node &>/dev/null; then NODE_EXEC=$(command -v node) + NODE_EXEC_SOURCE="command -v" echo "Found node using 'command -v': ${NODE_EXEC}" >> "${WRAPPER_LOG}" fi fi -# Priority 5: PATH search +# Priority 8: PATH search if [ -z "${NODE_EXEC}" ]; then - echo "[Priority 5] Searching PATH" >> "${WRAPPER_LOG}" + echo "[Priority 8] Searching PATH" >> "${WRAPPER_LOG}" OLD_IFS=$IFS IFS=: for path_in_env in $PATH; do if [ -x "${path_in_env}/node" ]; then NODE_EXEC="${path_in_env}/node" + NODE_EXEC_SOURCE="PATH" echo "Found node in PATH: ${NODE_EXEC}" >> "${WRAPPER_LOG}" break fi @@ -127,15 +228,37 @@ fi if [ -z "${NODE_EXEC}" ]; then { echo "ERROR: Node.js executable not found!" - echo "Searched: installation path, relative path, NVM, common paths, command -v, PATH" + echo "Searched: CHROME_MCP_NODE_PATH, node_path.txt, relative path, Volta, asdf, fnm, NVM, common paths, command -v, PATH" + echo "To fix: Set CHROME_MCP_NODE_PATH environment variable or run 'mcp-chrome-bridge doctor --fix'" } >> "${WRAPPER_LOG}" exit 1 fi +if [ ! -f "${NODE_SCRIPT}" ]; then + echo "ERROR: Node.js script not found at ${NODE_SCRIPT}" >> "${WRAPPER_LOG}" + exit 1 +fi + { echo "Using Node executable: ${NODE_EXEC}" + echo "Node discovery source: ${NODE_EXEC_SOURCE:-unknown}" echo "Node version: $(${NODE_EXEC} -v)" echo "Executing: ${NODE_EXEC} ${NODE_SCRIPT}" } >> "${WRAPPER_LOG}" -exec "${NODE_EXEC}" "${NODE_SCRIPT}" 2>> "${STDERR_LOG}" \ No newline at end of file +# Add Node.js bin directory to PATH so child processes can find node and related tools +NODE_BIN_DIR="$(dirname "${NODE_EXEC}")" +# Use ${PATH:+:${PATH}} to avoid trailing colon when PATH is empty (security concern) +export PATH="${NODE_BIN_DIR}${PATH:+:${PATH}}" +echo "Added ${NODE_BIN_DIR} to PATH" >> "${WRAPPER_LOG}" + +# Log Claude Code Router (CCR) related env vars for debugging +# These are set by `eval "$(ccr activate)"` or in shell profile +if [ -n "${ANTHROPIC_BASE_URL:-}" ]; then + echo "ANTHROPIC_BASE_URL is set: ${ANTHROPIC_BASE_URL}" >> "${WRAPPER_LOG}" +fi +if [ -n "${ANTHROPIC_AUTH_TOKEN:-}" ]; then + echo "ANTHROPIC_AUTH_TOKEN is set (value hidden)" >> "${WRAPPER_LOG}" +fi + +exec "${NODE_EXEC}" "${NODE_SCRIPT}" 2>> "${STDERR_LOG}" diff --git a/app/native-server/src/scripts/utils.ts b/app/native-server/src/scripts/utils.ts index 19a5297a..b732ca0d 100644 --- a/app/native-server/src/scripts/utils.ts +++ b/app/native-server/src/scripts/utils.ts @@ -10,6 +10,32 @@ export const access = promisify(fs.access); export const mkdir = promisify(fs.mkdir); export const writeFile = promisify(fs.writeFile); +/** + * Get the log directory path for wrapper scripts. + * Uses platform-appropriate user directories to avoid permission issues. + * + * - macOS: ~/Library/Logs/mcp-chrome-bridge + * - Windows: %LOCALAPPDATA%/mcp-chrome-bridge/logs + * - Linux: $XDG_STATE_HOME/mcp-chrome-bridge/logs or ~/.local/state/mcp-chrome-bridge/logs + */ +export function getLogDir(): string { + const homedir = os.homedir(); + + if (os.platform() === 'darwin') { + return path.join(homedir, 'Library', 'Logs', 'mcp-chrome-bridge'); + } else if (os.platform() === 'win32') { + return path.join( + process.env.LOCALAPPDATA || path.join(homedir, 'AppData', 'Local'), + 'mcp-chrome-bridge', + 'logs', + ); + } else { + // Linux: XDG_STATE_HOME or ~/.local/state + const xdgState = process.env.XDG_STATE_HOME || path.join(homedir, '.local', 'state'); + return path.join(xdgState, 'mcp-chrome-bridge', 'logs'); + } +} + /** * 打印彩色文本 */ @@ -98,6 +124,28 @@ export async function getMainPath(): Promise { } } +/** + * Write Node.js executable path to node_path.txt for run_host scripts. + * This ensures the native host uses the same Node.js version that was used during installation, + * avoiding NODE_MODULE_VERSION mismatch errors with native modules like better-sqlite3. + * + * @param distDir - The dist directory where node_path.txt should be written + * @param nodeExecPath - The Node.js executable path to write (defaults to current process.execPath) + */ +export function writeNodePathFile(distDir: string, nodeExecPath = process.execPath): void { + try { + const nodePathFile = path.join(distDir, 'node_path.txt'); + fs.mkdirSync(distDir, { recursive: true }); + + console.log(colorText(`Writing Node.js path: ${nodeExecPath}`, 'blue')); + fs.writeFileSync(nodePathFile, nodeExecPath, 'utf8'); + console.log(colorText('✓ Node.js path written for run_host scripts', 'green')); + } catch (error: unknown) { + const message = error instanceof Error ? error.message : String(error); + console.warn(colorText(`⚠️ Failed to write Node.js path: ${message}`, 'yellow')); + } +} + /** * 确保关键文件具有执行权限 */ @@ -201,25 +249,51 @@ export async function createManifestContent(): Promise { } /** - * 验证Windows注册表项是否存在 + * 验证Windows注册表项是否存在且指向正确路径 */ function verifyWindowsRegistryEntry(registryKey: string, expectedPath: string): boolean { if (os.platform() !== 'win32') { return true; // 非Windows平台跳过验证 } + const normalizeForCompare = (filePath: string): string => path.normalize(filePath).toLowerCase(); + try { - const result = execSync(`reg query "${registryKey}" /ve`, { encoding: 'utf8', stdio: 'pipe' }); - const lines = result.split('\n'); + const output = execSync(`reg query "${registryKey}" /ve`, { + encoding: 'utf8', + stdio: 'pipe', + }); + const lines = output + .split(/\r?\n/) + .map((l) => l.trim()) + .filter(Boolean); + for (const line of lines) { - if (line.includes('REG_SZ') && line.includes(expectedPath.replace(/\\/g, '\\\\'))) { - return true; - } + const match = line.match(/REG_SZ\s+(.*)$/i); + if (!match?.[1]) continue; + const actualPath = match[1].trim(); + return normalizeForCompare(actualPath) === normalizeForCompare(expectedPath); } - return false; - } catch (error) { - return false; + } catch { + // ignore } + + return false; +} + +/** + * Write node_path.txt and then register user-level Native Messaging host. + * This is the recommended entry point for development and production registration, + * as it ensures the Node.js path is captured before registration. + * + * @param browsers - Optional list of browsers to register for + * @returns true if at least one browser was registered successfully + */ +export async function registerUserLevelHostWithNodePath( + browsers?: BrowserType[], +): Promise { + writeNodePathFile(path.join(__dirname, '..')); + return tryRegisterUserLevelHost(browsers); } /** @@ -266,8 +340,8 @@ export async function tryRegisterUserLevelHost(targetBrowsers?: BrowserType[]): // Windows需要额外注册表项 if (os.platform() === 'win32' && config.registryKey) { try { - const escapedPath = config.userManifestPath.replace(/\\/g, '\\\\'); - const regCommand = `reg add "${config.registryKey}" /ve /t REG_SZ /d "${escapedPath}" /f`; + // 注意：不需要手动双写反斜杠，reg 命令会正确处理 Windows 路径 + const regCommand = `reg add "${config.registryKey}" /ve /t REG_SZ /d "${config.userManifestPath}" /f`; execSync(regCommand, { stdio: 'pipe' }); if (verifyWindowsRegistryEntry(config.registryKey, config.userManifestPath)) { @@ -409,9 +483,8 @@ export async function registerWithElevatedPermissions(): Promise { // 6. Windows特殊处理 - 设置系统级注册表 if (os.platform() === 'win32') { const registryKey = `HKLM\\Software\\Google\\Chrome\\NativeMessagingHosts\\${HOST_NAME}`; - // 确保路径使用正确的转义格式 - const escapedPath = manifestPath.replace(/\\/g, '\\\\'); - const regCommand = `reg add "${registryKey}" /ve /t REG_SZ /d "${escapedPath}" /f`; + // 注意：不需要手动双写反斜杠，reg 命令会正确处理 Windows 路径 + const regCommand = `reg add "${registryKey}" /ve /t REG_SZ /d "${manifestPath}" /f`; console.log(colorText(`Creating system registry entry: ${registryKey}`, 'blue')); console.log(colorText(`Manifest path: ${manifestPath}`, 'blue')); diff --git a/app/native-server/src/server/index.ts b/app/native-server/src/server/index.ts index 9d6aecfd..ae1e6330 100644 --- a/app/native-server/src/server/index.ts +++ b/app/native-server/src/server/index.ts @@ -1,3 +1,13 @@ +/** + * HTTP Server - Core server implementation. + * + * Responsibilities: + * - Fastify instance management + * - Plugin registration (CORS, etc.) + * - Route delegation to specialized modules + * - MCP transport handling + * - Server lifecycle management + */ import Fastify, { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify'; import cors from '@fastify/cors'; import { @@ -13,26 +23,47 @@ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/ import { randomUUID } from 'node:crypto'; import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js'; import { getMcpServer } from '../mcp/mcp-server'; +import { AgentStreamManager } from '../agent/stream-manager'; +import { AgentChatService } from '../agent/chat-service'; +import { CodexEngine } from '../agent/engines/codex'; +import { ClaudeEngine } from '../agent/engines/claude'; +import { closeDb } from '../agent/db'; +import { registerAgentRoutes } from './routes'; + +// ============================================================ +// Types +// ============================================================ -// Define request body type (if data needs to be retrieved from HTTP requests) interface ExtensionRequestPayload { - data?: any; // Data you want to pass to the extension + data?: unknown; } +// ============================================================ +// Server Class +// ============================================================ + export class Server { private fastify: FastifyInstance; - public isRunning = false; // Changed to public or provide a getter + public isRunning = false; private nativeHost: NativeMessagingHost | null = null; private transportsMap: Map = new Map(); + private agentStreamManager: AgentStreamManager; + private agentChatService: AgentChatService; constructor() { this.fastify = Fastify({ logger: SERVER_CONFIG.LOGGER_ENABLED }); + this.agentStreamManager = new AgentStreamManager(); + this.agentChatService = new AgentChatService({ + engines: [new CodexEngine(), new ClaudeEngine()], + streamManager: this.agentStreamManager, + }); this.setupPlugins(); this.setupRoutes(); } + /** - * Associate NativeMessagingHost instance + * Associate NativeMessagingHost instance. */ public setNativeHost(nativeHost: NativeMessagingHost): void { this.nativeHost = nativeHost; @@ -40,16 +71,60 @@ export class Server { private async setupPlugins(): Promise { await this.fastify.register(cors, { - origin: SERVER_CONFIG.CORS_ORIGIN, + origin: (origin, cb) => { + // Allow requests with no origin (e.g., curl, server-to-server) + if (!origin) { + return cb(null, true); + } + // Check if origin matches any pattern in whitelist + const allowed = SERVER_CONFIG.CORS_ORIGIN.some((pattern) => + pattern instanceof RegExp ? pattern.test(origin) : origin.startsWith(pattern), + ); + cb(null, allowed); + }, + methods: ['GET', 'POST', 'DELETE', 'OPTIONS'], + credentials: true, }); } private setupRoutes(): void { - // for ping + // Health check + this.setupHealthRoutes(); + + // Extension communication + this.setupExtensionRoutes(); + + // Agent routes (delegated to separate module) + registerAgentRoutes(this.fastify, { + streamManager: this.agentStreamManager, + chatService: this.agentChatService, + }); + + // MCP routes + this.setupMcpRoutes(); + } + + // ============================================================ + // Health Routes + // ============================================================ + + private setupHealthRoutes(): void { + this.fastify.get('/ping', async (_request: FastifyRequest, reply: FastifyReply) => { + reply.status(HTTP_STATUS.OK).send({ + status: 'ok', + message: 'pong', + }); + }); + } + + // ============================================================ + // Extension Routes + // ============================================================ + + private setupExtensionRoutes(): void { this.fastify.get( '/ask-extension', async (request: FastifyRequest<{ Body: ExtensionRequestPayload }>, reply: FastifyReply) => { - if (!this.nativeHost) { return reply .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) @@ -62,39 +137,43 @@ export class Server { } try { - // wait from extension message const extensionResponse = await this.nativeHost.sendRequestToExtensionAndWait( request.query, 'process_data', TIMEOUTS.EXTENSION_REQUEST_TIMEOUT, ); return reply.status(HTTP_STATUS.OK).send({ status: 'success', data: extensionResponse }); - } catch (error: any) { - if (error.message.includes('timed out')) { + } catch (error: unknown) { + const err = error as Error; + if (err.message.includes('timed out')) { return reply .status(HTTP_STATUS.GATEWAY_TIMEOUT) .send({ status: 'error', message: ERROR_MESSAGES.REQUEST_TIMEOUT }); } else { return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ status: 'error', - message: `Failed to get response from extension: ${error.message}`, + message: `Failed to get response from extension: ${err.message}`, }); } } }, ); + } + + // ============================================================ + // MCP Routes + // ============================================================ - // Compatible with SSE + private setupMcpRoutes(): void { + // SSE endpoint this.fastify.get('/sse', async (_, reply) => { try { - // Set SSE headers reply.raw.writeHead(HTTP_STATUS.OK, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive', }); - // Create SSE transport const transport = new SSEServerTransport('/messages', reply.raw); this.transportsMap.set(transport.sessionId, transport); @@ -105,7 +184,6 @@ export class Server { const server = getMcpServer(); await server.connect(transport); - // Keep connection open reply.raw.write(':\n\n'); } catch (error) { if (!reply.sent) { @@ -114,11 +192,11 @@ export class Server { } }); - // Compatible with SSE + // SSE messages endpoint this.fastify.post('/messages', async (req, reply) => { try { - const { sessionId } = req.query as any; - const transport = this.transportsMap.get(sessionId) as SSEServerTransport; + const { sessionId } = req.query as { sessionId?: string }; + const transport = this.transportsMap.get(sessionId || '') as SSEServerTransport; if (!sessionId || !transport) { reply.code(HTTP_STATUS.BAD_REQUEST).send('No transport found for sessionId'); return; @@ -132,20 +210,20 @@ export class Server { } }); - // POST /mcp: Handle client-to-server messages + // MCP POST endpoint this.fastify.post('/mcp', async (request, reply) => { const sessionId = request.headers['mcp-session-id'] as string | undefined; let transport: StreamableHTTPServerTransport | undefined = this.transportsMap.get( sessionId || '', ) as StreamableHTTPServerTransport; + if (transport) { - // transport found, do nothing + // Transport found, proceed } else if (!sessionId && isInitializeRequest(request.body)) { - const newSessionId = randomUUID(); // Generate session ID + const newSessionId = randomUUID(); transport = new StreamableHTTPServerTransport({ - sessionIdGenerator: () => newSessionId, // Use pre-generated ID + sessionIdGenerator: () => newSessionId, onsessioninitialized: (initializedSessionId) => { - // Ensure transport instance exists and session ID matches if (transport && initializedSessionId === newSessionId) { this.transportsMap.set(initializedSessionId, transport); } @@ -174,11 +252,13 @@ export class Server { } }); + // MCP GET endpoint (SSE stream) this.fastify.get('/mcp', async (request, reply) => { const sessionId = request.headers['mcp-session-id'] as string | undefined; const transport = sessionId ? (this.transportsMap.get(sessionId) as StreamableHTTPServerTransport) : undefined; + if (!transport) { reply.code(HTTP_STATUS.BAD_REQUEST).send({ error: ERROR_MESSAGES.INVALID_SSE_SESSION }); return; @@ -187,14 +267,12 @@ export class Server { reply.raw.setHeader('Content-Type', 'text/event-stream'); reply.raw.setHeader('Cache-Control', 'no-cache'); reply.raw.setHeader('Connection', 'keep-alive'); - reply.raw.flushHeaders(); // Ensure headers are sent immediately + reply.raw.flushHeaders(); try { - // transport.handleRequest will take over the response stream await transport.handleRequest(request.raw, reply.raw); if (!reply.sent) { - // If transport didn't send anything (unlikely for SSE initial handshake) - reply.hijack(); // Prevent Fastify from automatically sending response + reply.hijack(); } } catch (error) { if (!reply.raw.writableEnded) { @@ -204,10 +282,10 @@ export class Server { request.socket.on('close', () => { request.log.info(`SSE client disconnected for session: ${sessionId}`); - // transport's onclose should handle its own cleanup }); }); + // MCP DELETE endpoint this.fastify.delete('/mcp', async (request, reply) => { const sessionId = request.headers['mcp-session-id'] as string | undefined; const transport = sessionId @@ -221,7 +299,6 @@ export class Server { try { await transport.handleRequest(request.raw, reply.raw); - // Assume transport.handleRequest will send response or transport.onclose will cleanup if (!reply.sent) { reply.code(HTTP_STATUS.NO_CONTENT).send(); } @@ -235,11 +312,15 @@ export class Server { }); } + // ============================================================ + // Server Lifecycle + // ============================================================ + public async start(port = NATIVE_SERVER_PORT, nativeHost: NativeMessagingHost): Promise { if (!this.nativeHost) { - this.nativeHost = nativeHost; // Ensure nativeHost is set + this.nativeHost = nativeHost; } else if (this.nativeHost !== nativeHost) { - this.nativeHost = nativeHost; // Update to the passed instance + this.nativeHost = nativeHost; } if (this.isRunning) { @@ -248,13 +329,15 @@ export class Server { try { await this.fastify.listen({ port, host: SERVER_CONFIG.HOST }); - this.isRunning = true; // Update running status - // No need to return, Promise resolves void by default + + // Set port environment variables after successful listen for Chrome MCP URL resolution + process.env.CHROME_MCP_PORT = String(port); + process.env.MCP_HTTP_PORT = String(port); + + this.isRunning = true; } catch (err) { - this.isRunning = false; // Startup failed, reset status - // Throw error instead of exiting directly, let caller (possibly NativeHost) handle - throw err; // or return Promise.reject(err); - // process.exit(1); // Not recommended to exit directly here + this.isRunning = false; + throw err; } } @@ -262,14 +345,15 @@ export class Server { if (!this.isRunning) { return; } - // this.nativeHost = null; // Not recommended to nullify here, association relationship may still be needed + try { await this.fastify.close(); - this.isRunning = false; // Update running status + closeDb(); + this.isRunning = false; } catch (err) { - // Even if closing fails, mark as not running, but log the error this.isRunning = false; - throw err; // Throw error + closeDb(); + throw err; } } diff --git a/app/native-server/src/server/routes/agent.ts b/app/native-server/src/server/routes/agent.ts new file mode 100644 index 00000000..de5e98fe --- /dev/null +++ b/app/native-server/src/server/routes/agent.ts @@ -0,0 +1,1264 @@ +/** + * Agent Routes - All agent-related HTTP endpoints. + * + * Handles: + * - Projects CRUD + * - Chat messages CRUD + * - Chat streaming (SSE) + * - Chat actions (act, cancel) + * - Engine listing + */ +import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify'; +import { HTTP_STATUS, ERROR_MESSAGES } from '../../constant'; +import { AgentStreamManager } from '../../agent/stream-manager'; +import { AgentChatService } from '../../agent/chat-service'; +import type { AgentActRequest, AgentActResponse, RealtimeEvent } from '../../agent/types'; +import type { CreateOrUpdateProjectInput } from '../../agent/project-types'; +import { + createProjectDirectory, + deleteProject, + listProjects, + upsertProject, + validateRootPath, +} from '../../agent/project-service'; +import { + createMessage as createStoredMessage, + deleteMessagesByProjectId, + deleteMessagesBySessionId, + getMessagesByProjectId, + getMessagesCountByProjectId, + getMessagesBySessionId, + getMessagesCountBySessionId, +} from '../../agent/message-service'; +import { + createSession, + deleteSession, + getSession, + getSessionsByProject, + getSessionsByProjectAndEngine, + getAllSessions, + updateSession, + type CreateSessionOptions, + type UpdateSessionInput, +} from '../../agent/session-service'; +import { getProject } from '../../agent/project-service'; +import { getDefaultWorkspaceDir, getDefaultProjectRoot } from '../../agent/storage'; +import { openDirectoryPicker } from '../../agent/directory-picker'; +import type { EngineName } from '../../agent/engines/types'; +import { attachmentService } from '../../agent/attachment-service'; +import { openProjectDirectory, openFileInVSCode } from '../../agent/open-project'; +import type { + AttachmentStatsResponse, + AttachmentCleanupRequest, + AttachmentCleanupResponse, + OpenProjectRequest, + OpenProjectTarget, +} from 'chrome-mcp-shared'; + +// Valid engine names for validation +const VALID_ENGINE_NAMES: readonly EngineName[] = ['claude', 'codex', 'cursor', 'qwen', 'glm']; + +function isValidEngineName(name: string): name is EngineName { + return VALID_ENGINE_NAMES.includes(name as EngineName); +} + +// Valid open project targets +const VALID_OPEN_TARGETS: readonly OpenProjectTarget[] = ['vscode', 'terminal']; + +function isValidOpenTarget(target: string): target is OpenProjectTarget { + return VALID_OPEN_TARGETS.includes(target as OpenProjectTarget); +} + +// ============================================================ +// Types +// ============================================================ + +export interface AgentRoutesOptions { + streamManager: AgentStreamManager; + chatService: AgentChatService; +} + +// ============================================================ +// Route Registration +// ============================================================ + +/** + * Register all agent-related routes on the Fastify instance. + */ +export function registerAgentRoutes(fastify: FastifyInstance, options: AgentRoutesOptions): void { + const { streamManager, chatService } = options; + + // ============================================================ + // Engine Routes + // ============================================================ + + fastify.get('/agent/engines', async (_request, reply) => { + try { + const engines = chatService.getEngineInfos(); + reply.status(HTTP_STATUS.OK).send({ engines }); + } catch (error) { + fastify.log.error({ err: error }, 'Failed to list agent engines'); + if (!reply.sent) { + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + } + }); + + // ============================================================ + // Project Routes + // ============================================================ + + fastify.get('/agent/projects', async (_request, reply) => { + try { + const projects = await listProjects(); + reply.status(HTTP_STATUS.OK).send({ projects }); + } catch (error) { + if (!reply.sent) { + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + } + }); + + fastify.post( + '/agent/projects', + async (request: FastifyRequest<{ Body: CreateOrUpdateProjectInput }>, reply: FastifyReply) => { + try { + const body = request.body; + if (!body || !body.name || !body.rootPath) { + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ error: 'name and rootPath are required to create a project' }); + return; + } + const project = await upsertProject(body); + reply.status(HTTP_STATUS.OK).send({ project }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + }, + ); + + fastify.delete( + '/agent/projects/:id', + async (request: FastifyRequest<{ Params: { id: string } }>, reply: FastifyReply) => { + const { id } = request.params; + if (!id) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'project id is required' }); + return; + } + try { + await deleteProject(id); + reply.status(HTTP_STATUS.NO_CONTENT).send(); + } catch (error) { + if (!reply.sent) { + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + } + }, + ); + + // Path validation API + fastify.post( + '/agent/projects/validate-path', + async (request: FastifyRequest<{ Body: { rootPath: string } }>, reply: FastifyReply) => { + const { rootPath } = request.body || {}; + if (!rootPath || typeof rootPath !== 'string') { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'rootPath is required' }); + } + try { + const result = await validateRootPath(rootPath); + return reply.send(result); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ error: message }); + } + }, + ); + + // Create directory API + fastify.post( + '/agent/projects/create-directory', + async (request: FastifyRequest<{ Body: { absolutePath: string } }>, reply: FastifyReply) => { + const { absolutePath } = request.body || {}; + if (!absolutePath || typeof absolutePath !== 'string') { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'absolutePath is required' }); + } + try { + await createProjectDirectory(absolutePath); + return reply.send({ success: true, path: absolutePath }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: message }); + } + }, + ); + + // Get default workspace directory + fastify.get('/agent/projects/default-workspace', async (_request, reply) => { + try { + const workspaceDir = getDefaultWorkspaceDir(); + return reply.send({ success: true, path: workspaceDir }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ error: message }); + } + }); + + // Get default project root for a given project name + fastify.post( + '/agent/projects/default-root', + async (request: FastifyRequest<{ Body: { projectName: string } }>, reply: FastifyReply) => { + const { projectName } = request.body || {}; + if (!projectName || typeof projectName !== 'string') { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectName is required' }); + } + try { + const rootPath = getDefaultProjectRoot(projectName); + return reply.send({ success: true, path: rootPath }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ error: message }); + } + }, + ); + + // Open directory picker dialog + fastify.post('/agent/projects/pick-directory', async (_request, reply) => { + try { + const result = await openDirectoryPicker('Select Project Directory'); + if (result.success && result.path) { + return reply.send({ success: true, path: result.path }); + } else if (result.cancelled) { + return reply.send({ success: false, cancelled: true }); + } else { + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: result.error || 'Failed to open directory picker', + }); + } + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ error: message }); + } + }); + + // ============================================================ + // Session Routes + // ============================================================ + + // List all sessions across all projects + fastify.get('/agent/sessions', async (_request: FastifyRequest, reply: FastifyReply) => { + try { + const sessions = await getAllSessions(); + return reply.status(HTTP_STATUS.OK).send({ sessions }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to list all sessions'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }); + + // List sessions for a project + fastify.get( + '/agent/projects/:projectId/sessions', + async (request: FastifyRequest<{ Params: { projectId: string } }>, reply: FastifyReply) => { + const { projectId } = request.params; + if (!projectId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + } + + try { + const sessions = await getSessionsByProject(projectId); + return reply.status(HTTP_STATUS.OK).send({ sessions }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to list sessions'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Create a new session for a project + fastify.post( + '/agent/projects/:projectId/sessions', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Body: CreateSessionOptions & { engineName: string }; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + const body = request.body || {}; + + if (!projectId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + } + if (!body.engineName) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'engineName is required' }); + } + if (!isValidEngineName(body.engineName)) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ + error: `Invalid engineName. Must be one of: ${VALID_ENGINE_NAMES.join(', ')}`, + }); + } + + try { + // Verify project exists + const project = await getProject(projectId); + if (!project) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Project not found' }); + } + + const session = await createSession(projectId, body.engineName, { + name: body.name, + model: body.model, + permissionMode: body.permissionMode, + allowDangerouslySkipPermissions: body.allowDangerouslySkipPermissions, + systemPromptConfig: body.systemPromptConfig, + optionsConfig: body.optionsConfig, + }); + return reply.status(HTTP_STATUS.CREATED).send({ session }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to create session'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Get a specific session + fastify.get( + '/agent/sessions/:sessionId', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + try { + const session = await getSession(sessionId); + if (!session) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Session not found' }); + } + return reply.status(HTTP_STATUS.OK).send({ session }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to get session'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Update a session + fastify.patch( + '/agent/sessions/:sessionId', + async ( + request: FastifyRequest<{ + Params: { sessionId: string }; + Body: UpdateSessionInput; + }>, + reply: FastifyReply, + ) => { + const { sessionId } = request.params; + const updates = request.body || {}; + + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + try { + const existing = await getSession(sessionId); + if (!existing) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Session not found' }); + } + + await updateSession(sessionId, updates); + const updated = await getSession(sessionId); + return reply.status(HTTP_STATUS.OK).send({ session: updated }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to update session'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Delete a session + fastify.delete( + '/agent/sessions/:sessionId', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + try { + await deleteSession(sessionId); + return reply.status(HTTP_STATUS.NO_CONTENT).send(); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to delete session'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Get message history for a session + fastify.get( + '/agent/sessions/:sessionId/history', + async ( + request: FastifyRequest<{ + Params: { sessionId: string }; + Querystring: { limit?: string; offset?: string }; + }>, + reply: FastifyReply, + ) => { + const { sessionId } = request.params; + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + const limitRaw = request.query.limit; + const offsetRaw = request.query.offset; + const limit = Number.parseInt(limitRaw || '', 10); + const offset = Number.parseInt(offsetRaw || '', 10); + const safeLimit = Number.isFinite(limit) && limit > 0 ? limit : 0; + const safeOffset = Number.isFinite(offset) && offset >= 0 ? offset : 0; + + try { + const session = await getSession(sessionId); + if (!session) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Session not found' }); + } + + const [messages, totalCount] = await Promise.all([ + getMessagesBySessionId(sessionId, safeLimit, safeOffset), + getMessagesCountBySessionId(sessionId), + ]); + + return reply.status(HTTP_STATUS.OK).send({ + success: true, + sessionId, + messages, + totalCount, + pagination: { + limit: safeLimit, + offset: safeOffset, + count: messages.length, + hasMore: safeLimit > 0 ? safeOffset + messages.length < totalCount : false, + }, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to get session history'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Reset a session conversation (clear messages + engineSessionId) + fastify.post( + '/agent/sessions/:sessionId/reset', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + try { + const existing = await getSession(sessionId); + if (!existing) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Session not found' }); + } + + // Clear resume state first, then delete messages + await updateSession(sessionId, { engineSessionId: null }); + const deletedMessages = await deleteMessagesBySessionId(sessionId); + const updated = await getSession(sessionId); + + return reply.status(HTTP_STATUS.OK).send({ + success: true, + sessionId, + deletedMessages, + clearedEngineSessionId: Boolean(existing.engineSessionId), + session: updated || null, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to reset session'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Get Claude management info for a session + fastify.get( + '/agent/sessions/:sessionId/claude-info', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + if (!sessionId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + } + + try { + const session = await getSession(sessionId); + if (!session) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Session not found' }); + } + + return reply.status(HTTP_STATUS.OK).send({ + managementInfo: session.managementInfo || null, + sessionId, + engineName: session.engineName, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to get Claude info'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // Get aggregated Claude management info for a project + // Returns the most recent management info from any Claude session in the project + fastify.get( + '/agent/projects/:projectId/claude-info', + async (request: FastifyRequest<{ Params: { projectId: string } }>, reply: FastifyReply) => { + const { projectId } = request.params; + if (!projectId) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + } + + try { + const project = await getProject(projectId); + if (!project) { + return reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Project not found' }); + } + + // Get only Claude sessions (more efficient than fetching all and filtering) + const claudeSessions = await getSessionsByProjectAndEngine(projectId, 'claude'); + const sessionsWithInfo = claudeSessions.filter((s) => s.managementInfo); + + // Sort by lastUpdated in management info (fallback to session.updatedAt for old data) + sessionsWithInfo.sort((a, b) => { + const aTime = a.managementInfo?.lastUpdated || a.updatedAt || ''; + const bTime = b.managementInfo?.lastUpdated || b.updatedAt || ''; + return bTime.localeCompare(aTime); + }); + + const latestInfo = sessionsWithInfo[0]?.managementInfo || null; + const sourceSessionId = sessionsWithInfo[0]?.id; + + return reply.status(HTTP_STATUS.OK).send({ + managementInfo: latestInfo, + sourceSessionId, + projectId, + sessionsWithInfo: sessionsWithInfo.length, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to get project Claude info'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // ============================================================ + // Open Project Routes + // ============================================================ + + /** + * POST /agent/sessions/:sessionId/open + * Open session's project directory in VSCode or terminal. + */ + fastify.post( + '/agent/sessions/:sessionId/open', + async ( + request: FastifyRequest<{ + Params: { sessionId: string }; + Body: OpenProjectRequest; + }>, + reply: FastifyReply, + ) => { + const { sessionId } = request.params; + const { target } = request.body || {}; + + if (!sessionId) { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'sessionId is required' }); + } + if (!target || typeof target !== 'string') { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'target is required' }); + } + if (!isValidOpenTarget(target)) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ + success: false, + error: `Invalid target. Must be one of: ${VALID_OPEN_TARGETS.join(', ')}`, + }); + } + + try { + // Get session and its project + const session = await getSession(sessionId); + if (!session) { + return reply + .status(HTTP_STATUS.NOT_FOUND) + .send({ success: false, error: 'Session not found' }); + } + + const project = await getProject(session.projectId); + if (!project) { + return reply + .status(HTTP_STATUS.NOT_FOUND) + .send({ success: false, error: 'Project not found' }); + } + + // Open the project directory + const result = await openProjectDirectory(project.rootPath, target); + if (result.success) { + return reply.status(HTTP_STATUS.OK).send({ success: true }); + } + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: result.error, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to open session project'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + /** + * POST /agent/projects/:projectId/open + * Open project directory in VSCode or terminal. + */ + fastify.post( + '/agent/projects/:projectId/open', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Body: OpenProjectRequest; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + const { target } = request.body || {}; + + if (!projectId) { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'projectId is required' }); + } + if (!target || typeof target !== 'string') { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'target is required' }); + } + if (!isValidOpenTarget(target)) { + return reply.status(HTTP_STATUS.BAD_REQUEST).send({ + success: false, + error: `Invalid target. Must be one of: ${VALID_OPEN_TARGETS.join(', ')}`, + }); + } + + try { + const project = await getProject(projectId); + if (!project) { + return reply + .status(HTTP_STATUS.NOT_FOUND) + .send({ success: false, error: 'Project not found' }); + } + + // Open the project directory + const result = await openProjectDirectory(project.rootPath, target); + if (result.success) { + return reply.status(HTTP_STATUS.OK).send({ success: true }); + } + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: result.error, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to open project'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + /** + * POST /agent/projects/:projectId/open-file + * Open a file in VSCode at a specific line/column. + * + * Request body: + * - filePath: string (required) - File path (relative or absolute) + * - line?: number - Line number (1-based) + * - column?: number - Column number (1-based) + */ + fastify.post( + '/agent/projects/:projectId/open-file', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Body: { filePath?: string; line?: number; column?: number }; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + const { filePath, line, column } = request.body || {}; + + if (!projectId) { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'projectId is required' }); + } + if (!filePath || typeof filePath !== 'string') { + return reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'filePath is required' }); + } + + try { + const project = await getProject(projectId); + if (!project) { + return reply + .status(HTTP_STATUS.NOT_FOUND) + .send({ success: false, error: 'Project not found' }); + } + + // Open the file in VSCode + const result = await openFileInVSCode(project.rootPath, filePath, line, column); + if (result.success) { + return reply.status(HTTP_STATUS.OK).send({ success: true }); + } + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: result.error, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to open file in VSCode'); + return reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // ============================================================ + // Chat Message Routes + // ============================================================ + + fastify.get( + '/agent/chat/:projectId/messages', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Querystring: { limit?: string; offset?: string }; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + if (!projectId) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + return; + } + + const limitRaw = request.query.limit; + const offsetRaw = request.query.offset; + const limit = Number.parseInt(limitRaw || '', 10); + const offset = Number.parseInt(offsetRaw || '', 10); + const safeLimit = Number.isFinite(limit) && limit > 0 ? limit : 50; + const safeOffset = Number.isFinite(offset) && offset >= 0 ? offset : 0; + + try { + const [messages, totalCount] = await Promise.all([ + getMessagesByProjectId(projectId, safeLimit, safeOffset), + getMessagesCountByProjectId(projectId), + ]); + + reply.status(HTTP_STATUS.OK).send({ + success: true, + data: messages, + totalCount, + pagination: { + limit: safeLimit, + offset: safeOffset, + count: messages.length, + hasMore: safeOffset + messages.length < totalCount, + }, + }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to load agent chat messages'); + reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: 'Failed to fetch messages', + message: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + fastify.post( + '/agent/chat/:projectId/messages', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Body: { + content?: string; + role?: string; + messageType?: string; + conversationId?: string; + sessionId?: string; + cliSource?: string; + metadata?: Record; + requestId?: string; + id?: string; + createdAt?: string; + }; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + if (!projectId) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + return; + } + + const body = request.body || {}; + const content = typeof body.content === 'string' ? body.content.trim() : ''; + if (!content) { + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ success: false, error: 'content is required' }); + return; + } + + const rawRole = typeof body.role === 'string' ? body.role.toLowerCase().trim() : 'user'; + const role: 'assistant' | 'user' | 'system' | 'tool' = + rawRole === 'assistant' || rawRole === 'system' || rawRole === 'tool' + ? (rawRole as 'assistant' | 'system' | 'tool') + : 'user'; + + const rawType = typeof body.messageType === 'string' ? body.messageType.toLowerCase() : ''; + const allowedTypes = ['chat', 'tool_use', 'tool_result', 'status'] as const; + const fallbackType: (typeof allowedTypes)[number] = role === 'system' ? 'status' : 'chat'; + const messageType = + (allowedTypes as readonly string[]).includes(rawType) && rawType + ? (rawType as (typeof allowedTypes)[number]) + : fallbackType; + + try { + const stored = await createStoredMessage({ + projectId, + role, + messageType, + content, + metadata: body.metadata, + sessionId: body.sessionId, + conversationId: body.conversationId, + cliSource: body.cliSource, + requestId: body.requestId, + id: body.id, + createdAt: body.createdAt, + }); + + reply.status(HTTP_STATUS.CREATED).send({ success: true, data: stored }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to create agent chat message'); + reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: 'Failed to create message', + message: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + fastify.delete( + '/agent/chat/:projectId/messages', + async ( + request: FastifyRequest<{ + Params: { projectId: string }; + Querystring: { conversationId?: string }; + }>, + reply: FastifyReply, + ) => { + const { projectId } = request.params; + if (!projectId) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'projectId is required' }); + return; + } + + const { conversationId } = request.query; + + try { + const deleted = await deleteMessagesByProjectId(projectId, conversationId || undefined); + reply.status(HTTP_STATUS.OK).send({ success: true, deleted }); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + fastify.log.error({ err: error }, 'Failed to delete agent chat messages'); + reply.status(HTTP_STATUS.INTERNAL_SERVER_ERROR).send({ + success: false, + error: 'Failed to delete messages', + message: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR, + }); + } + }, + ); + + // ============================================================ + // Chat Streaming Routes (SSE) + // ============================================================ + + fastify.get( + '/agent/chat/:sessionId/stream', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + if (!sessionId) { + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ error: 'sessionId is required for agent stream' }); + return; + } + + try { + reply.raw.writeHead(HTTP_STATUS.OK, { + 'Content-Type': 'text/event-stream', + 'Cache-Control': 'no-cache', + Connection: 'keep-alive', + }); + + // Ensure client immediately receives an open event + reply.raw.write(':\n\n'); + + streamManager.addSseStream(sessionId, reply.raw); + + const connectedEvent: RealtimeEvent = { + type: 'connected', + data: { + sessionId, + transport: 'sse', + timestamp: new Date().toISOString(), + }, + }; + streamManager.publish(connectedEvent); + + reply.raw.on('close', () => { + streamManager.removeSseStream(sessionId, reply.raw); + }); + } catch (error) { + if (!reply.sent) { + reply.code(HTTP_STATUS.INTERNAL_SERVER_ERROR).send(ERROR_MESSAGES.INTERNAL_SERVER_ERROR); + } + } + }, + ); + + // ============================================================ + // Chat Action Routes + // ============================================================ + + fastify.post( + '/agent/chat/:sessionId/act', + { + // Increase body limit to support image attachments (base64 encoded) + // Default Fastify limit is 1MB, which is too small for images + config: { + rawBody: false, + }, + bodyLimit: 50 * 1024 * 1024, // 50MB to support multiple images + }, + async ( + request: FastifyRequest<{ Params: { sessionId: string }; Body: AgentActRequest }>, + reply: FastifyReply, + ) => { + const { sessionId } = request.params; + const payload = request.body; + + if (!sessionId) { + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ error: 'sessionId is required for agent act' }); + return; + } + + try { + const { requestId } = await chatService.handleAct(sessionId, payload); + const response: AgentActResponse = { + requestId, + sessionId, + status: 'accepted', + }; + reply.status(HTTP_STATUS.OK).send(response); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ error: message || ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + }, + ); + + // Cancel specific request + fastify.delete( + '/agent/chat/:sessionId/cancel/:requestId', + async ( + request: FastifyRequest<{ Params: { sessionId: string; requestId: string } }>, + reply: FastifyReply, + ) => { + const { sessionId, requestId } = request.params; + + if (!sessionId || !requestId) { + reply + .status(HTTP_STATUS.BAD_REQUEST) + .send({ error: 'sessionId and requestId are required' }); + return; + } + + const cancelled = chatService.cancelExecution(requestId); + if (cancelled) { + reply.status(HTTP_STATUS.OK).send({ + success: true, + message: 'Execution cancelled', + requestId, + sessionId, + }); + } else { + reply.status(HTTP_STATUS.OK).send({ + success: false, + message: 'No running execution found with this requestId', + requestId, + sessionId, + }); + } + }, + ); + + // Cancel all executions for a session + fastify.delete( + '/agent/chat/:sessionId/cancel', + async (request: FastifyRequest<{ Params: { sessionId: string } }>, reply: FastifyReply) => { + const { sessionId } = request.params; + + if (!sessionId) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: 'sessionId is required' }); + return; + } + + const cancelledCount = chatService.cancelSessionExecutions(sessionId); + reply.status(HTTP_STATUS.OK).send({ + success: true, + cancelledCount, + sessionId, + }); + }, + ); + + // ============================================================ + // Attachment Routes + // ============================================================ + + /** + * GET /agent/attachments/stats + * Get statistics for all attachment caches. + */ + fastify.get('/agent/attachments/stats', async (_request, reply) => { + try { + const stats = await attachmentService.getAttachmentStats(); + + // Enrich with project names from database + const projects = await listProjects(); + const projectMap = new Map(projects.map((p) => [p.id, p.name])); + const dbProjectIds = new Set(projects.map((p) => p.id)); + + const enrichedProjects = stats.projects.map((p) => ({ + ...p, + projectName: projectMap.get(p.projectId), + existsInDb: dbProjectIds.has(p.projectId), + })); + + const orphanProjectIds = stats.projects + .filter((p) => !dbProjectIds.has(p.projectId)) + .map((p) => p.projectId); + + const response: AttachmentStatsResponse = { + success: true, + rootDir: stats.rootDir, + totalFiles: stats.totalFiles, + totalBytes: stats.totalBytes, + projects: enrichedProjects, + orphanProjectIds, + }; + + reply.status(HTTP_STATUS.OK).send(response); + } catch (error) { + fastify.log.error({ err: error }, 'Failed to get attachment stats'); + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + }); + + /** + * GET /agent/attachments/:projectId/:filename + * Serve an attachment file. + */ + fastify.get( + '/agent/attachments/:projectId/:filename', + async ( + request: FastifyRequest<{ Params: { projectId: string; filename: string } }>, + reply: FastifyReply, + ) => { + const { projectId, filename } = request.params; + + try { + // Validate and get file + const buffer = await attachmentService.readAttachment(projectId, filename); + + // Determine content type from filename extension + const ext = filename.split('.').pop()?.toLowerCase(); + let contentType = 'application/octet-stream'; + switch (ext) { + case 'png': + contentType = 'image/png'; + break; + case 'jpg': + case 'jpeg': + contentType = 'image/jpeg'; + break; + case 'gif': + contentType = 'image/gif'; + break; + case 'webp': + contentType = 'image/webp'; + break; + } + + reply + .header('Content-Type', contentType) + .header('Cache-Control', 'public, max-age=31536000, immutable') + .send(buffer); + } catch (error) { + const message = error instanceof Error ? error.message : String(error); + + if (message.includes('Invalid') || message.includes('traversal')) { + reply.status(HTTP_STATUS.BAD_REQUEST).send({ error: message }); + return; + } + + // File not found or read error + reply.status(HTTP_STATUS.NOT_FOUND).send({ error: 'Attachment not found' }); + } + }, + ); + + /** + * DELETE /agent/attachments/:projectId + * Clean up attachments for a specific project. + */ + fastify.delete( + '/agent/attachments/:projectId', + async (request: FastifyRequest<{ Params: { projectId: string } }>, reply: FastifyReply) => { + const { projectId } = request.params; + + try { + const result = await attachmentService.cleanupAttachments({ projectIds: [projectId] }); + + const response: AttachmentCleanupResponse = { + success: true, + scope: 'project', + removedFiles: result.removedFiles, + removedBytes: result.removedBytes, + results: result.results, + }; + + reply.status(HTTP_STATUS.OK).send(response); + } catch (error) { + fastify.log.error({ err: error }, 'Failed to cleanup project attachments'); + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + }, + ); + + /** + * DELETE /agent/attachments + * Clean up attachments for all or selected projects. + */ + fastify.delete( + '/agent/attachments', + async (request: FastifyRequest<{ Body?: AttachmentCleanupRequest }>, reply: FastifyReply) => { + try { + const body = request.body; + const projectIds = body?.projectIds; + + const result = await attachmentService.cleanupAttachments( + projectIds ? { projectIds } : undefined, + ); + + const scope = projectIds && projectIds.length > 0 ? 'selected' : 'all'; + + const response: AttachmentCleanupResponse = { + success: true, + scope, + removedFiles: result.removedFiles, + removedBytes: result.removedBytes, + results: result.results, + }; + + reply.status(HTTP_STATUS.OK).send(response); + } catch (error) { + fastify.log.error({ err: error }, 'Failed to cleanup attachments'); + reply + .status(HTTP_STATUS.INTERNAL_SERVER_ERROR) + .send({ error: ERROR_MESSAGES.INTERNAL_SERVER_ERROR }); + } + }, + ); +} diff --git a/app/native-server/src/server/routes/index.ts b/app/native-server/src/server/routes/index.ts new file mode 100644 index 00000000..f98a8e2f --- /dev/null +++ b/app/native-server/src/server/routes/index.ts @@ -0,0 +1,4 @@ +/** + * Routes module exports. + */ +export { registerAgentRoutes, type AgentRoutesOptions } from './agent'; diff --git a/app/native-server/src/shims/devtools.d.ts b/app/native-server/src/shims/devtools.d.ts new file mode 100644 index 00000000..2207dd3e --- /dev/null +++ b/app/native-server/src/shims/devtools.d.ts @@ -0,0 +1,7 @@ +// Single-file shim for all deep imports from chrome-devtools-frontend. +// This prevents TypeScript from type-checking the upstream DevTools source tree. +// Runtime still loads the real package; this file is types-only and local to TS. +declare module 'chrome-devtools-frontend/*' { + const anyExport: any; + export = anyExport; +} diff --git a/app/native-server/src/trace-analyzer.ts b/app/native-server/src/trace-analyzer.ts new file mode 100644 index 00000000..0332665a --- /dev/null +++ b/app/native-server/src/trace-analyzer.ts @@ -0,0 +1,86 @@ +import * as fs from 'fs'; + +// Import DevTools trace engine and formatters from chrome-devtools-frontend +// We intentionally use deep imports to match the package structure. +// These modules are ESM and require NodeNext module resolution. +// Types are loosely typed to minimize coupling with DevTools internals. +// eslint-disable-next-line @typescript-eslint/ban-ts-comment +// @ts-ignore +import * as TraceEngine from 'chrome-devtools-frontend/front_end/models/trace/trace.js'; +// eslint-disable-next-line @typescript-eslint/ban-ts-comment +// @ts-ignore +import { PerformanceTraceFormatter } from 'chrome-devtools-frontend/front_end/models/ai_assistance/data_formatters/PerformanceTraceFormatter.js'; +// eslint-disable-next-line @typescript-eslint/ban-ts-comment +// @ts-ignore +import { PerformanceInsightFormatter } from 'chrome-devtools-frontend/front_end/models/ai_assistance/data_formatters/PerformanceInsightFormatter.js'; +// eslint-disable-next-line @typescript-eslint/ban-ts-comment +// @ts-ignore +import { AgentFocus } from 'chrome-devtools-frontend/front_end/models/ai_assistance/performance/AIContext.js'; + +const engine = TraceEngine.TraceModel.Model.createWithAllHandlers(); + +function readJsonFile(path: string): any { + const text = fs.readFileSync(path, 'utf-8'); + return JSON.parse(text); +} + +export async function parseTrace(json: any): Promise<{ + parsedTrace: any; + insights: any | null; +}> { + engine.resetProcessor(); + const events = Array.isArray(json) ? json : json.traceEvents; + if (!events || !Array.isArray(events)) { + throw new Error('Invalid trace format: expected array or {traceEvents: []}'); + } + await engine.parse(events); + const parsedTrace = engine.parsedTrace(); + const insights = parsedTrace?.insights ?? null; + if (!parsedTrace) throw new Error('No parsed trace returned by engine'); + return { parsedTrace, insights }; +} + +export function getTraceSummary(parsedTrace: any): string { + const focus = AgentFocus.fromParsedTrace(parsedTrace); + const formatter = new PerformanceTraceFormatter(focus); + return formatter.formatTraceSummary(); +} + +export function getInsightText(parsedTrace: any, insights: any, insightName: string): string { + if (!insights) throw new Error('No insights available for this trace'); + const mainNavId = parsedTrace.data?.Meta?.mainFrameNavigations?.at(0)?.args?.data?.navigationId; + const NO_NAV = TraceEngine.Types.Events.NO_NAVIGATION; + const set = insights.get(mainNavId ?? NO_NAV); + if (!set) throw new Error('No insights for selected navigation'); + const model = set.model || {}; + if (!(insightName in model)) throw new Error(`Insight not found: ${insightName}`); + const formatter = new PerformanceInsightFormatter( + AgentFocus.fromParsedTrace(parsedTrace), + model[insightName], + ); + return formatter.formatInsight(); +} + +export async function analyzeTraceFile( + filePath: string, + insightName?: string, +): Promise<{ + summary: string; + insight?: string; +}> { + const json = readJsonFile(filePath); + const { parsedTrace, insights } = await parseTrace(json); + const summary = getTraceSummary(parsedTrace); + if (insightName) { + try { + const insight = getInsightText(parsedTrace, insights, insightName); + return { summary, insight }; + } catch { + // If requested insight missing, still return summary + return { summary }; + } + } + return { summary }; +} + +export default { analyzeTraceFile }; diff --git a/app/native-server/src/types/devtools-frontend.d.ts b/app/native-server/src/types/devtools-frontend.d.ts new file mode 100644 index 00000000..9c24d688 --- /dev/null +++ b/app/native-server/src/types/devtools-frontend.d.ts @@ -0,0 +1,28 @@ +// Minimal ambient declarations to avoid compiling chrome-devtools-frontend sources. +// We intentionally treat these modules as `any` to keep our build lightweight and decoupled +// from DevTools' internal TypeScript and lib targets. + +declare module 'chrome-devtools-frontend/front_end/models/trace/trace.js' { + // Shape used by our code: TraceModel + Types + Insights + export const TraceModel: any; + export const Types: any; + export const Insights: any; +} + +declare module 'chrome-devtools-frontend/front_end/models/ai_assistance/data_formatters/PerformanceTraceFormatter.js' { + export class PerformanceTraceFormatter { + constructor(...args: any[]); + formatTraceSummary(): string; + } +} + +declare module 'chrome-devtools-frontend/front_end/models/ai_assistance/data_formatters/PerformanceInsightFormatter.js' { + export class PerformanceInsightFormatter { + constructor(...args: any[]); + formatInsight(): string; + } +} + +declare module 'chrome-devtools-frontend/front_end/models/ai_assistance/performance/AIContext.js' { + export const AgentFocus: any; +} diff --git a/app/native-server/tsconfig.json b/app/native-server/tsconfig.json index 788c525e..2d14e69c 100644 --- a/app/native-server/tsconfig.json +++ b/app/native-server/tsconfig.json @@ -1,19 +1,23 @@ { - "compilerOptions": { - "target": "ES2018", - "module": "NodeNext", - "moduleResolution": "NodeNext", - "lib": ["ES2018", "DOM"], - "outDir": "dist", - "rootDir": "src", - "strict": true, - "esModuleInterop": true, - "forceConsistentCasingInFileNames": true, - "skipLibCheck": true, - "declaration": true, - "sourceMap": true, - "resolveJsonModule": true - }, - "include": ["src/**/*"], - "exclude": ["node_modules", "dist", "**/*.spec.ts", "**/*.test.ts"] - } \ No newline at end of file + "compilerOptions": { + "target": "ES2018", + "module": "NodeNext", + "moduleResolution": "NodeNext", + "lib": ["ES2018", "DOM"], + "outDir": "dist", + "rootDir": "src", + "strict": true, + "esModuleInterop": true, + "forceConsistentCasingInFileNames": true, + "skipLibCheck": true, + "declaration": true, + "sourceMap": true, + "resolveJsonModule": true, + "baseUrl": ".", + "paths": { + "chrome-devtools-frontend/*": ["src/shims/devtools.d.ts"] + } + }, + "include": ["src/**/*"], + "exclude": ["node_modules", "dist", "**/*.spec.ts", "**/*.test.ts"] +} diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 89cecba3..475d6231 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -17,7 +17,7 @@ We welcome contributions in many forms: ### Prerequisites -- **Node.js 18.19.0+** and **pnpm or npm** (latest version) +- **Node.js 20+** and **pnpm or npm** (latest version) - **Chrome/Chromium** browser for testing - **Git** for version control - **Rust** (for WASM development, optional) @@ -121,13 +121,11 @@ git checkout -b feature/your-feature-name ``` 2. **Make your changes** - - Follow the code style guidelines - Add tests for new functionality - Update documentation if needed 3. **Test your changes** - - Ensure all existing tests pass - Test the Chrome extension manually - Verify MCP protocol compatibility diff --git a/docs/CONTRIBUTING_zh.md b/docs/CONTRIBUTING_zh.md index 3e8e0fed..a6a5ef98 100644 --- a/docs/CONTRIBUTING_zh.md +++ b/docs/CONTRIBUTING_zh.md @@ -17,7 +17,7 @@ ### 环境要求 -- **Node.js 18+** 和 **pnpm**（最新版本） +- **Node.js 20+** 和 **pnpm**（最新版本） - **Chrome/Chromium** 浏览器用于测试 - **Git** 版本控制 - **Rust**（用于 WASM 开发，可选） @@ -121,13 +121,11 @@ git checkout -b feature/your-feature-name ``` 2. **进行更改** - - 遵循代码风格指南 - 为新功能添加测试 - 如需要，更新文档 3. **测试您的更改** - - 确保所有现有测试通过 - 手动测试 Chrome 扩展 - 验证 MCP 协议兼容性 diff --git a/docs/ISSUE.md b/docs/ISSUE.md new file mode 100644 index 00000000..e8797881 --- /dev/null +++ b/docs/ISSUE.md @@ -0,0 +1,1190 @@ +# Issues 总览 + +## 📊 统计信息 + +- **总Issue数**: 183 +- **开放中**: 116 +- **已关闭**: 67 +- **关闭率**: 36.6% +- **最后更新**: 2025-10-11 + +## 📑 目录 + +- [功能请求](#功能请求) +- [Bug报告](#bug报告) +- [安装问题](#安装问题) +- [配置问题](#配置问题) +- [兼容性问题](#兼容性问题) +- [文档改进](#文档改进) +- [已解决的问题](#已解决的问题) + +--- + +## 🚀 功能请求 + +### 开放中 + +#### #215 chrome_console获取的数据不完整 + +- **状态**: OPEN +- **作者**: africa1207 +- **日期**: 2025-09-30 +- **描述**: chrome_console获取的数据是浅拷贝数据，无法获取深层对象信息 + +#### #207 Screenshots can't autosave? I have to manually click Save? + +- **状态**: OPEN +- **作者**: FVEFWFE +- **日期**: 2025-09-18 +- **描述**: 希望截图能自动保存，而不需要手动点击保存 + +#### #205 希望支持从 clipboard 获取信息填入页面输入框 + +- **状态**: OPEN +- **作者**: sunzh231 +- **日期**: 2025-09-17 +- **描述**: 根据鼠标光标所在的输入框直接从clipboard获取信息填入，避免使用Inject Script被浏览器CSP阻止 + +#### #202 Electron应用程序如何使用此插件 + +- **状态**: OPEN +- **作者**: lyl340321 +- **日期**: 2025-09-13 +- **描述**: 在electron中支持了简易浏览器功能，想复用此插件提供mcp服务 + +#### #201 chrome-mcp无法从dialog中获取信息 + +- **状态**: OPEN +- **作者**: qphien +- **日期**: 2025-09-12 +- **描述**: dialog中含有token敏感信息，通过js获取内容的时候，获得的值为空 + +#### #200 如何滚动页面 + +- **状态**: OPEN +- **作者**: qphien +- **日期**: 2025-09-12 +- **描述**: Mac上如何instruct chrome-mcp滚动页面，通过调用快捷键space，chrome页面并没有发生滚动 + +#### #190 不支持离线加载本地模型吗？ + +- **状态**: OPEN +- **作者**: long36708 +- **日期**: 2025-09-02 +- **描述**: 内网环境下，无法自动下载hugeface上的模型，网络不通 + +#### #183 how to save the HTML displayed in the Chrome browser using Chrome MCP + +- **状态**: OPEN +- **作者**: sansanai +- **日期**: 2025-08-28 +- **描述**: 如何保存Chrome浏览器中显示的HTML内容，特别是当HTML内容很大时 + +#### #180 服务状态经常莫名其妙停止 + +- **状态**: OPEN +- **作者**: IAmKongHai +- **日期**: 2025-08-28 +- **描述**: 希望提高稳定性，在浏览器退出前一直保持服务状态运行中 + +#### #178 操作MCP打开谷歌浏览器的页面之后他会自动弹窗出来 + +- **状态**: OPEN +- **作者**: MiloQ +- **日期**: 2025-08-27 +- **描述**: 希望浏览器能在后台静默运行 + +#### #177 n8n integration + +- **状态**: OPEN +- **作者**: judaemon +- **日期**: 2025-08-27 +- **描述**: 是否可以在n8n工作流中使用 + +#### #175 可以以sse模式启动mcp server么 + +- **状态**: OPEN +- **作者**: FriSeaSky +- **日期**: 2025-08-25 +- **描述**: 当前看readme只支持其他两种模式，希望能实现sse模式 + +#### #171 Tab group api controls + +- **状态**: OPEN +- **作者**: danieliser +- **日期**: 2025-08-21 +- **描述**: 允许MCP控制标签组，创建、删除、添加标签到组等 + +#### #169 Feature Request: Support Environment Variables to Disable Specific Tools + +- **状态**: OPEN +- **作者**: lathidadia +- **日期**: 2025-08-20 +- **描述**: 支持通过环境变量禁用或过滤特定工具，解决工具名称冲突问题 + +#### #162 Needs some rate limit logic from tools going rogue in the real browser + +- **状态**: OPEN +- **作者**: neberej +- **日期**: 2025-08-16 +- **描述**: 需要添加速率限制逻辑，防止工具失控 + +#### #157 Chrome 商店 + +- **状态**: OPEN +- **作者**: nelzomal +- **日期**: 2025-08-13 +- **描述**: 有计划上架Chrome web store吗 + +#### #155 More intelligent + +- **状态**: OPEN +- **作者**: nullCode666 +- **日期**: 2025-08-13 +- **描述**: 希望MCP能自动理解当前网页的源代码，找到对应的加密方法等 + +#### #153 `chrome_inject_script` not working on some sites + +- **状态**: OPEN +- **作者**: rmorse +- **日期**: 2025-08-12 +- **描述**: 在某些网站上chrome_inject_script不工作，需要支持不同的注入点 + +#### #141 功能支持鼠标悬停、多窗口mcp隔离 + +- **状态**: OPEN +- **作者**: lironghai +- **日期**: 2025-08-07 +- **描述**: 支持鼠标悬停和多窗口MCP隔离功能 + +### 已关闭 + +#### #145 Add file upload capability for web forms + +- **状态**: CLOSED +- **作者**: kaovilai +- **日期**: 2025-08-08 +- **描述**: 添加文件上传功能以支持web表单 + +#### #107 Support .dxt format + +- **状态**: CLOSED +- **作者**: metalshanked +- **日期**: 2025-07-16 +- **描述**: 支持Anthropic发布的.dxt格式，实现一键安装 + +--- + +## 🐛 Bug报告 + +### 开放中 + +#### #215 chrome_console获取的数据不完整 + +- **状态**: OPEN +- **作者**: africa1207 +- **日期**: 2025-09-30 +- **描述**: chrome_console获取的数据是浅拷贝，深层对象显示为"object" + +#### #212 调用工具错误 + +- **状态**: OPEN +- **作者**: zhaooa +- **日期**: 2025-09-28 +- **描述**: 工具是打开状态，但是还是提示调用工具错误 + +#### #209 运行第一个例子的时候，mcp工具调用了但是画图没有动静 + +- **状态**: OPEN +- **作者**: scwlkq +- **日期**: 2025-09-26 + +#### #206 请求报错 + +- **状态**: OPEN +- **作者**: lghxuelang +- **日期**: 2025-09-18 +- **描述**: Invalid or missing MCP session ID for SSE + +#### #204 经常会打开 chrome-extension://hbdgbgagpkpjffpklnamcljpakneikee/true + +- **状态**: OPEN +- **作者**: Wouldyouplace45 +- **日期**: 2025-09-15 +- **描述**: 浏览器显示无法访问您的文件 + +#### #191 chrome_console要求当前页面没有打开dev tool + +- **状态**: OPEN +- **作者**: string1225 +- **日期**: 2025-09-03 +- **描述**: 这是chrome浏览器的机制限制 + +#### #184 trae显示个别工具名字超过60字符最大限制 + +- **状态**: OPEN +- **作者**: wangqi996 +- **日期**: 2025-08-29 + +#### #163 chrome_screenshot always gives "exceeds maximum allowed tokens" error + +- **状态**: OPEN +- **作者**: maddada +- **日期**: 2025-08-18 +- **描述**: 截图响应超过最大允许的token数（25000） + +#### #152 并发执行过程中发生错乱 + +- **状态**: OPEN +- **作者**: shatang123 +- **日期**: 2025-08-12 +- **描述**: 并发爬取网页时tabId错位，标签未关闭等问题 + +#### #149 一直提示脚本注入失败 + +- **状态**: OPEN +- **作者**: manzhonglu +- **日期**: 2025-08-11 + +#### #144 让它打开网页，打开之后，会一直等待，直到超时 + +- **状态**: OPEN +- **作者**: shopkeeper2020 +- **日期**: 2025-08-08 + +#### #142 我打开了网页，让他帮我点击个东西他都不好使 + +- **状态**: OPEN +- **作者**: bbhxwl +- **日期**: 2025-08-07 +- **描述**: 使用qweb3 4b，只是回答提问，不执行点击操作 + +#### #139 错误: Error calling tool: Request timed out after 30000ms + +- **状态**: OPEN +- **作者**: sunhao28256 +- **日期**: 2025-08-05 + +#### #136 `chrome_keyboard` is not working with Claude Code + +- **状态**: OPEN +- **作者**: hanayashiki +- **日期**: 2025-08-03 +- **描述**: 虽然显示成功，但没有输入到textarea中 + +#### #128 如果找不到网页元素的话，会一直重试 + +- **状态**: OPEN +- **作者**: GragonForce666 +- **日期**: 2025-07-29 + +#### #122 各种各样的超时，自动停止 + +- **状态**: OPEN +- **作者**: fordiy +- **日期**: 2025-07-26 +- **描述**: 已经把30秒超时改多10倍，还是有超时问题 + +#### #118 无法自动点击 cloudflare 人机验证 + +- **状态**: OPEN +- **作者**: windzhu0514 +- **日期**: 2025-07-23 + +#### #114 试了豆瓣、即刻，似乎抓取不了 + +- **状态**: OPEN +- **作者**: imHw +- **日期**: 2025-07-20 +- **描述**: AI反馈访问这些网站遇到问题，可能是反爬机制 + +#### #112 chrome_network_debugger的maxRequests太少了 + +- **状态**: OPEN +- **作者**: kanekanefy +- **日期**: 2025-07-19 +- **描述**: maxRequests限制在100个请求后自动停止 + +#### #111 使用CherryStudio进行网站截图时报错 + +- **状态**: OPEN +- **作者**: GehuaZhang +- **日期**: 2025-07-18 +- **描述**: Cannot read properties of undefined (reading 'map') + +#### #99 chrome_get_web_content 工具获取的页面信息似乎不全 + +- **状态**: OPEN +- **作者**: Reviel +- **日期**: 2025-07-13 +- **描述**: 获取PostGIS ticket页面时缺失Description部分内容 + +#### #92 AI无法关闭alert提示框 + +- **状态**: OPEN +- **作者**: chgblog +- **日期**: 2025-07-11 +- **描述**: 遇到alert、confirm弹窗后AI无法继续操作，显示MCP超时 + +#### #67 windows function call 报超时错误 + +- **状态**: OPEN +- **作者**: zhiyu +- **日期**: 2025-07-01 + +### 已关闭 + +#### #181 The extension stays disconnected + +- **状态**: CLOSED +- **作者**: Arefinw +- **日期**: 2025-08-28 + +#### #140 语音引擎初始化失败 + +- **状态**: CLOSED +- **作者**: Demi555 +- **日期**: 2025-08-06 + +#### #116 插件点击连接，然后失焦点，隐藏，会自动断开连接 + +- **状态**: CLOSED +- **作者**: BeginnerDone +- **日期**: 2025-07-22 + +#### #73 API Error: 413: Prompt is too long + +- **状态**: CLOSED +- **作者**: Lehtien +- **日期**: 2025-07-04 + +#### #60 Claude code Chrome MCP服务器启动时输出包含emoji的console.log语句 + +- **状态**: CLOSED +- **作者**: gabyic +- **日期**: 2025-06-28 +- **描述**: 导致MCP协议JSON解析错误 + +--- + +## 📦 安装问题 + +### 开放中 + +#### #198 关于该插件在谷歌浏览器连接不上的问题 + +- **状态**: OPEN +- **作者**: nice-nicegod +- **日期**: 2025-09-09 +- **描述**: 插件显示"已连接，服务未启动"。如果Node.js安装时更改了默认路径会导致此问题 + +#### #187 打开连接时显示 Connected, Service Not Started + +- **状态**: OPEN +- **作者**: wyx66624 +- **日期**: 2025-08-31 +- **描述**: 已手动注册mcp-chrome-bridge，12306端口没有进程监听 + +#### #174 Browser in Docker + Chrome MCP: troubleshooting + +- **状态**: OPEN +- **作者**: f3l1x +- **日期**: 2025-08-25 +- **描述**: 在Docker虚拟浏览器中预装扩展，显示"Connected, Service Not Started" + +#### #170 Claude Code integration on WSL + +- **状态**: OPEN +- **作者**: TimHuey +- **日期**: 2025-08-20 +- **描述**: WSL中Claude Code无法识别mcp server + +#### #159 WSL Support? + +- **状态**: OPEN +- **作者**: D3OXY +- **日期**: 2025-08-14 + +#### #148 chrome插件已经成功启动，但是命令行显示failed + +- **状态**: OPEN +- **作者**: joytianya +- **日期**: 2025-08-10 + +#### #147 有打算支持 docker 部署吗 + +- **状态**: OPEN +- **作者**: tgscan-dev +- **日期**: 2025-08-10 + +#### #143 服务器上怎么部署这个mcp服务 + +- **状态**: OPEN +- **作者**: no-bystander +- **日期**: 2025-08-08 + +#### #138 在chrome浏览器里已经安装上插件，可以配置端口 + +- **状态**: OPEN +- **作者**: KylanJimmy +- **日期**: 2025-08-05 +- **描述**: 是否可以绑定0.0.0.0的端口，而不只是127.0.0.1 + +#### #137 win上 已连接，服务未启动 + +- **状态**: OPEN +- **作者**: steven111920 +- **日期**: 2025-08-04 +- **描述**: 点击run_host.bat显示拒绝访问 + +#### #127 已连接，服务未启动 + +- **状态**: OPEN +- **作者**: Fanzaijun +- **日期**: 2025-07-29 + +#### #115 已连接服务未启动 + +- **状态**: OPEN +- **作者**: yanghao112 +- **日期**: 2025-07-21 +- **描述**: 能排查的都排查了，还是不行 + +#### #106 启动成功但是没法配置 + +- **状态**: OPEN +- **作者**: crxxxxxxx +- **日期**: 2025-07-15 + +#### #90 不能启动 + +- **状态**: OPEN +- **作者**: qiffang +- **日期**: 2025-07-11 +- **描述**: 运行run_hosts.sh一直hang住 + +#### #88 Failed to install on Apple Silicon Mac + +- **状态**: OPEN +- **作者**: DaniloHandsOn +- **日期**: 2025-07-10 +- **描述**: chrome-mcp-bridge命令未找到 + +#### #85 一直报错 Session termination 400 + +- **状态**: OPEN +- **作者**: hcoona +- **日期**: 2025-07-08 + +#### #78 docs/CONTRIBUTING.md instructions to build missing packages/shared build + +- **状态**: OPEN +- **作者**: adrianlzt +- **日期**: 2025-07-06 +- **描述**: 文档缺少shared包的构建步骤 + +#### #68 Execute mcp-chrome-bridge -v and report [ERR_REQUIRE_ESM] + +- **状态**: OPEN +- **作者**: coisini6 +- **日期**: 2025-07-02 +- **描述**: Windows10下报ERR_REQUIRE_ESM错误 + +#### #65 mac m4 浏览器插件服务未连接 + +- **状态**: OPEN +- **作者**: wzp-coding +- **日期**: 2025-06-30 +- **描述**: 已按troubleshooting排查，执行index.js卡住无反应 + +#### #62 无法启动 + +- **状态**: OPEN +- **作者**: Mocha-s +- **日期**: 2025-06-28 +- **描述**: 直接不知道怎么启动 + +### 已关闭 + +#### #196 SOLUTION - Native Messaging not working in Chromium + +- **状态**: CLOSED (已有PR #195解决) +- **作者**: gebeer +- **日期**: 2025-09-07 +- **描述**: mcp-chrome-bridge npm包只安装到Chrome目录，不支持Chromium + +#### #161 unexpected error: Running Status --> "Connected, Service Not Started" + +- **状态**: CLOSED +- **作者**: TonnyWong1052 +- **日期**: 2025-08-15 + +#### #154 Chrome 未能成功加载扩展程序 + +- **状态**: CLOSED +- **作者**: mmhzlrj +- **日期**: 2025-08-12 +- **描述**: Missing 'manifest_version' key + +#### #81 chromium浏览器启动失败的目录问题 + +- **状态**: CLOSED +- **作者**: lesszzen +- **日期**: 2025-07-07 +- **描述**: Chromium在Linux下配置文件目录为.config/chromium + +#### #69 是否有适配firefox浏览器计划 + +- **状态**: CLOSED +- **作者**: Shuai-S +- **日期**: 2025-07-02 + +#### #64 不支持linux部署这个项目吧 + +- **状态**: CLOSED +- **作者**: caiji2019-cai +- **日期**: 2025-06-30 + +#### #22 Mac上运行失败，Native服务没有成功启动 + +- **状态**: CLOSED +- **作者**: DengKaiRong +- **日期**: 2025-06-19 + +#### #16 开发模式启动项目，server未成功启动 + +- **状态**: CLOSED +- **作者**: WSCZou +- **日期**: 2025-06-18 + +--- + +## ⚙️ 配置问题 + +### 开放中 + +#### #203 INSTALL IN THE CURSOR, LOADING TOOLS,BUT NOT SUCESS + +- **状态**: OPEN +- **作者**: chenhunhun +- **日期**: 2025-09-14 +- **描述**: Cursor中配置后工具加载失败 + +#### #199 Claude code cil 连上不上怎么回事 + +- **状态**: OPEN +- **作者**: 666xjs +- **日期**: 2025-09-10 +- **描述**: 服务端运行成功了，但就是连上不上 + +#### #188 windsurf中无法连接 + +- **状态**: OPEN +- **作者**: NoComments +- **日期**: 2025-09-02 +- **描述**: Error: TransformStream is not defined + +#### #185 Kiro 提示 "Enabled MCP Server chrome-mcp-server must specify a command" + +- **状态**: OPEN +- **作者**: Chris-C1108 +- **日期**: 2025-08-29 +- **描述**: 不清楚command是指什么，会不会是kiro不支持streamable-http类型 + +#### #182 Claude CLI fails to connect to running server on macOS + +- **状态**: OPEN +- **作者**: dreamreels +- **日期**: 2025-08-28 +- **描述**: 扩展显示运行正常，但claude命令行工具无法连接 + +#### #173 claude code 不支持streamableHttp + +- **状态**: OPEN +- **作者**: Baddts +- **日期**: 2025-08-24 +- **描述**: 配置streamableHttp后claude code不会加载这个mcp + +#### #168 Failed to parse MCP servers from JSON + +- **状态**: OPEN +- **作者**: joyhu +- **日期**: 2025-08-19 + +#### #167 claude code mcp 链接不了 + +- **状态**: OPEN +- **作者**: TheBloodthirster +- **日期**: 2025-08-18 +- **描述**: Native connection disconnected + +#### #160 在使用multilingual-e5-base时出错 + +- **状态**: OPEN +- **作者**: lcylcyll +- **日期**: 2025-08-15 +- **描述**: 模型要求维度是768D，但在谷歌浏览器上出错 + +#### #150 Readme Image not found - Installation- Step 3 + +- **状态**: OPEN +- **作者**: amritbanerjee +- **日期**: 2025-08-12 +- **描述**: Readme文件第3步的图片链接404 + +#### #135 callTool() 这个工具函数 在哪个库里 + +- **状态**: OPEN +- **作者**: hechengdu +- **日期**: 2025-08-03 + +#### #134 Cursor无法连接Chrome MCP + +- **状态**: OPEN +- **作者**: shengcruz +- **日期**: 2025-08-02 +- **描述**: 显示"No connection to browser extension" + +#### #132 trae 加载失败 + +- **状态**: OPEN +- **作者**: mimicode +- **日期**: 2025-08-02 +- **描述**: chrome_send_command_to_inject_script长度超过60个字符 + +#### #131 claude desktop 配置后不识别 + +- **状态**: OPEN +- **作者**: microxxx +- **日期**: 2025-08-01 + +#### #124 请看截图，说已经搞掂画图了，但Excalidraw永远都是空白 + +- **状态**: OPEN +- **作者**: fordiy +- **日期**: 2025-07-27 + +#### #123 在AI输出过程中，经常会自动停掉 + +- **状态**: OPEN +- **作者**: fordiy +- **日期**: 2025-07-26 +- **描述**: 没法继续在原来页面excalidraw画图 + +#### #121 cherrystudio升级1.5.3之后，无法调用了 + +- **状态**: OPEN +- **作者**: csfeng1 +- **日期**: 2025-07-26 + +#### #109 cherrystudio无法正常使用MCP + +- **状态**: OPEN +- **作者**: kksqwerc +- **日期**: 2025-07-17 +- **描述**: 工具已罗列出来，但在对话过程中无法准确调用 + +#### #103 报错 400 的一般是客户端配置方式不对 + +- **状态**: OPEN +- **作者**: ifastcc +- **日期**: 2025-07-15 +- **描述**: 给出了Claude code、Gemini cli、Cursor的正确配置方式 + +#### #102 Cherry-Studio 启动失败 + +- **状态**: OPEN +- **作者**: Bboossccoo +- **日期**: 2025-07-14 + +#### #100 cursor调用excalidraw 提示Error calling tool + +- **状态**: OPEN +- **作者**: DevilMay-Cry +- **日期**: 2025-07-14 +- **描述**: Request timed out after 30000ms + +#### #101 vscode使用：输入打开url，输入账号密码。一直卡在打开url中 + +- **状态**: OPEN +- **作者**: kkk123dm +- **日期**: 2025-07-14 + +### 已关闭 + +#### #221 如何在VSC中配置mcp-chrome？ + +- **状态**: CLOSED +- **作者**: valuex +- **日期**: 2025-10-04 +- **描述**: 配置后不能启动服务器 + +#### #193 Cursor中添加mcp后一直显示loading tools + +- **状态**: CLOSED +- **作者**: lixiaolong613 +- **日期**: 2025-09-04 + +#### #192 部署到远程服务器之后访问连接被重置 + +- **状态**: CLOSED +- **作者**: wlxwlxwlx +- **日期**: 2025-09-04 + +#### #164 如何在claude desktop中也用上预定义的prompt template + +- **状态**: CLOSED +- **作者**: WeiyangZhang +- **日期**: 2025-08-18 + +#### #133 issue with setting up the MCP in Claude Code + +- **状态**: CLOSED +- **作者**: seldaneg +- **日期**: 2025-08-02 + +#### #113 Error invoking remote method 'mcp:restart-server' + +- **状态**: CLOSED +- **作者**: Daiyuxin26 +- **日期**: 2025-07-19 + +#### #102 Cherry-Studio 启动失败 + +- **状态**: CLOSED +- **作者**: Bboossccoo +- **日期**: 2025-07-14 + +#### #57 DIFY MCP调用失败 + +- **状态**: CLOSED +- **作者**: SpringMeta +- **日期**: 2025-06-27 + +#### #45 Cherry Studio 下连接 MCP报错 + +- **状态**: CLOSED +- **作者**: nooldey +- **日期**: 2025-06-25 +- **描述**: serverType不正确，应使用小驼峰写法 + +#### #32 vscode 中启动失败 + +- **状态**: CLOSED +- **作者**: linjinxing +- **日期**: 2025-06-23 + +#### #30 没法使用 + +- **状态**: CLOSED +- **作者**: 2513483494 +- **日期**: 2025-06-23 +- **描述**: unexpected status code: 400 + +#### #19 cursor 里面配置后会出现报错 + +- **状态**: CLOSED +- **作者**: Sumouren1 +- **日期**: 2025-06-18 + +#### #18 不支持cursor/cline么？ + +- **状态**: CLOSED +- **作者**: Rainmen-xia +- **日期**: 2025-06-18 + +#### #13 cherry studio addition failed + +- **状态**: CLOSED +- **作者**: LLmoskk +- **日期**: 2025-06-17 + +#### #8 chrome_navigate调用报错 + +- **状态**: CLOSED +- **作者**: fcyf +- **日期**: 2025-06-16 + +--- + +## 🔌 兼容性问题 + +### 开放中 + +#### #172 iframe页面元素not found + +- **状态**: OPEN +- **作者**: Actor12 +- **日期**: 2025-08-22 +- **描述**: 使用iframe开发的网页，chrome_fill_or_selector总是not found + +#### #126 自动回复、自动发布 希望功能更强大一些 + +- **状态**: OPEN +- **作者**: smartchainark +- **日期**: 2025-07-29 +- **描述**: 在x平台和小红书平台无法正常完成任务 + +#### #93 动态的数据怎样获取 + +- **状态**: OPEN +- **作者**: carter115 +- **日期**: 2025-07-11 +- **描述**: 页面上滚动鼠标才调用接口的数据 + +#### #43 【无数据输出】cursor+edge 测试绘制一个月的浏览记录 + +- **状态**: OPEN +- **作者**: 3377 +- **日期**: 2025-06-24 + +#### #42 能否和automa一起联动制作工作流呢？ + +- **状态**: OPEN +- **作者**: 3377 +- **日期**: 2025-06-24 + +#### #40 语义引擎初始化失败 + +- **状态**: OPEN +- **作者**: HY-Hu +- **日期**: 2025-06-24 + +#### #39 一直报权限问题 + +- **状态**: OPEN +- **作者**: mozhuangshu +- **日期**: 2025-06-24 + +#### #33 找不到元素 + +- **状态**: OPEN +- **作者**: 2513483494 +- **日期**: 2025-06-23 +- **描述**: 腾讯云控制台页面元素找不到 + +### 已关闭 + +--- + +## 📚 文档改进 + +### 开放中 + +#### #197 指令里 无法执行 + +- **状态**: OPEN +- **作者**: lujuny328-cmyk +- **日期**: 2025-09-08 +- **描述**: 把链接桥放到指令里无法执行 + +#### #189 求拉群 + +- **状态**: OPEN +- **作者**: wwenj +- **日期**: 2025-09-02 +- **描述**: 文档中的群二维码过期了 + +#### #117 好像没有点击扩展程序的工具？ + +- **状态**: OPEN +- **作者**: sunweihunu +- **日期**: 2025-07-22 +- **描述**: 希望能增加点击Chrome扩展程序的工具 + +#### #125 二维码已过期 + +- **状态**: OPEN +- **作者**: NuoLanC +- **日期**: 2025-07-29 + +### 已关闭 + +#### #95 整理网页文档包含图片的效果不如 playwright + +- **状态**: CLOSED +- **作者**: Xuzan9396 +- **日期**: 2025-07-12 + +#### #94 readme 视频链接失效 + +- **状态**: CLOSED +- **作者**: vcan +- **日期**: 2025-07-11 + +#### #91 群满人了，大佬加下我 + +- **状态**: CLOSED +- **作者**: huangxingzhao +- **日期**: 2025-07-11 + +#### #89 请问这个是什么工具 + +- **状态**: CLOSED +- **作者**: Messilimeng +- **日期**: 2025-07-11 +- **描述**: 我用cursor有没有很好的互动prompt呢 + +#### #84 如何配置自己的AI？ + +- **状态**: CLOSED +- **作者**: liaoyu-zju +- **日期**: 2025-07-08 + +#### #83 中文文档中的微信二维码已过期 + +- **状态**: CLOSED +- **作者**: YunfanGoForIt +- **日期**: 2025-07-07 + +#### #79 english ? + +- **状态**: CLOSED +- **作者**: michabbb +- **日期**: 2025-07-06 +- **描述**: README是英文的，而Chrome扩展完全是中文的 + +#### #75 prompt 目录下的文件如何引用 + +- **状态**: CLOSED +- **作者**: jovezhong +- **日期**: 2025-07-05 + +#### #52 README 中多媒体资源 404 问题 + +- **状态**: CLOSED +- **作者**: yunkst +- **日期**: 2025-06-26 + +#### #49 视频里面在浏览器右侧这个大模型聊天工具是什么啊？ + +- **状态**: CLOSED +- **作者**: MoeMoeFish +- **日期**: 2025-06-25 + +#### #48 建议楼主创建一个微信群 + +- **状态**: CLOSED +- **作者**: goreycn +- **日期**: 2025-06-25 + +#### #44 没有看到查看MCP配置的连接按扭 + +- **状态**: CLOSED +- **作者**: jimleee +- **日期**: 2025-06-25 + +#### #35 画图功能没有调动起来 + +- **状态**: CLOSED +- **作者**: guangzhou +- **日期**: 2025-06-23 + +#### #34 怎么才能在画板上画图呢 + +- **状态**: CLOSED +- **作者**: guangzhou +- **日期**: 2025-06-23 + +#### #31 可增加对Consle日志的读取吗 + +- **状态**: CLOSED +- **作者**: ZoidbergPi +- **日期**: 2025-06-23 + +#### #26 使用教程 + +- **状态**: CLOSED +- **作者**: fanhaoj +- **日期**: 2025-06-22 + +#### #23 怎么打开对话框？ + +- **状态**: CLOSED +- **作者**: kokwiw +- **日期**: 2025-06-20 + +#### #17 对比2个京东商品就超token了 + +- **状态**: CLOSED +- **作者**: namejee +- **日期**: 2025-06-18 + +#### #15 Claude Desktop + +- **状态**: CLOSED +- **作者**: GoldRush520 +- **日期**: 2025-06-18 +- **描述**: Claude Desktop国内用不了，有没有其他可替代的 + +#### #11 大佬有没有可能添加一个drag and drop功能 + +- **状态**: CLOSED +- **作者**: tom63001 +- **日期**: 2025-06-17 + +--- + +## ✅ 已解决的问题 + +### 社区交流相关 + +#### #213 求个微信群组，互相交流 + +- **状态**: OPEN +- **作者**: zhangchao0323 +- **日期**: 2025-09-29 + +#### #211 求拉群，想参与项目贡献～ + +- **状态**: OPEN +- **作者**: suoaiyisheng +- **日期**: 2025-09-27 + +### 使用问题 + +#### #176 claude code 无法画图 + +- **状态**: OPEN +- **作者**: woshihoujinxin +- **日期**: 2025-08-26 +- **描述**: 打开excalidraw.com画图，但没有流畅效果 + +#### #166 画图问题 + +- **状态**: OPEN +- **作者**: fyture +- **日期**: 2025-08-18 +- **描述**: 模型说已完成，但excalidraw上什么都没有 + +### Python集成 + +#### #194 如何在代码上接入呢，不用AI agent + +- **状态**: CLOSED +- **作者**: dreambe +- **日期**: 2025-09-05 +- **描述**: 比如python，有没有demo代码 + +#### #82 尝试使用python代码直接调用工具失败 + +- **状态**: CLOSED +- **作者**: YunfanGoForIt +- **日期**: 2025-07-07 + +#### #24 可以使用python代码调用这个插件吗？ + +- **状态**: CLOSED +- **作者**: liulint +- **日期**: 2025-06-20 + +#### #21 请问目前不带有MCP功能的的LLM可以接入这个mcp服务器吗 + +- **状态**: CLOSED +- **作者**: JessiePen +- **日期**: 2025-06-19 + +### 服务器部署 + +#### #74 Suggestion: Enable External Access to Local Server + +- **状态**: OPEN +- **作者**: ErrorGz +- **日期**: 2025-07-05 +- **描述**: 建议修改HOST为0.0.0.0以允许外部访问 + +#### #72 Tab串联问题 + +- **状态**: CLOSED +- **作者**: fundoop +- **日期**: 2025-07-04 +- **描述**: 是否可以增加指定tab页面操作，切换tab等 + +#### #71 这个mcp服务器不能和客户端分开吗 + +- **状态**: CLOSED +- **作者**: xiaodiao216 +- **日期**: 2025-07-03 + +#### #70 【Help Wanted】项目首页视频里的MCP客户端是什么？ + +- **状态**: CLOSED +- **作者**: tonyxu721 +- **日期**: 2025-07-03 + +### 其他 + +#### #97 请问使用示例中出现的对话工具是什么 + +- **状态**: CLOSED +- **作者**: sbwg +- **日期**: 2025-07-12 + +#### #96 入口在哪里啊？ + +- **状态**: CLOSED +- **作者**: DavidCalls +- **日期**: 2025-07-12 + +#### #80 alternative way question + +- **状态**: CLOSED +- **作者**: yiminhale +- **日期**: 2025-07-06 +- **描述**: 能否用npm而不是pnpm + +#### #51 navigate功能不能标签打开地址 + +- **状态**: CLOSED +- **作者**: adoin +- **日期**: 2025-06-26 + +#### #25 [Feature Request] - Can I use it with my Cursor? + +- **状态**: CLOSED +- **作者**: DaleXiao +- **日期**: 2025-06-21 + +#### #14 How to support VSCode or trae? + +- **状态**: CLOSED +- **作者**: loki-zhou +- **日期**: 2025-06-17 + +#### #5 佬，augment里咋设置mcp？ + +- **状态**: CLOSED +- **作者**: gally16 +- **日期**: 2025-06-15 + +--- + +## 📈 Issue 趋势分析 + +### 高频问题类型 + +1. **安装配置问题** (约40%): 主要集中在Native Messaging连接失败、服务未启动 +2. **兼容性问题** (约25%): 不同客户端（Cursor、Claude Code、Cherry Studio等）的集成问题 +3. **功能请求** (约20%): 文件上传、鼠标悬停、多窗口隔离等 +4. **Bug报告** (约15%): 工具调用错误、超时、元素查找失败等 + +### 常见解决方案 + +1. **权限问题**: 使用`chmod -R 755`赋予dist目录权限 +2. **Node.js路径问题**: 重新安装Node.js到默认路径 +3. **配置格式问题**: 不同客户端使用不同的配置格式（streamableHttp vs streamable-http） +4. **端口访问**: 默认127.0.0.1，需要外部访问时改为0.0.0.0 + +--- + +## 🔗 相关资源 + +- [故障排除文档](TROUBLESHOOTING_zh.md) +- [贡献指南](CONTRIBUTING_zh.md) +- [工具文档](TOOLS_zh.md) +- [Windows安装指南](WINDOWS_INSTALL_zh.md) + +--- + +**最后更新**: 2025-10-11 +**统计数据来源**: GitHub Issues API diff --git a/docs/TOOLS.md b/docs/TOOLS.md index a3b4f63e..4d892156 100644 --- a/docs/TOOLS.md +++ b/docs/TOOLS.md @@ -48,8 +48,10 @@ Navigate to a URL with optional viewport control. **Parameters**: -- `url` (string, required): URL to navigate to +- `url` (string, optional): URL to navigate to (omit when `refresh=true`) - `newWindow` (boolean, optional): Create new window (default: false) +- `tabId` (number, optional): Target an existing tab by ID (navigate/refresh that tab) +- `background` (boolean, optional): Do not activate the tab or focus the window (default: false) - `width` (number, optional): Viewport width in pixels (default: 1280) - `height` (number, optional): Viewport height in pixels (default: 720) @@ -128,6 +130,8 @@ Take advanced screenshots with various options. - `name` (string, optional): Screenshot filename - `selector` (string, optional): CSS selector for element screenshot +- `tabId` (number, optional): Target tab to capture (default: active tab) +- `background` (boolean, optional): Attempt capture without bringing tab/window to foreground (viewport-only uses CDP) - `width` (number, optional): Width in pixels (default: 800) - `height` (number, optional): Height in pixels (default: 600) - `storeBase64` (boolean, optional): Return base64 data (default: false) @@ -247,6 +251,25 @@ Send custom HTTP requests. ## 🔍 Content Analysis +### `chrome_read_page` + +Build an accessibility-like tree of the current page (visible viewport by default) with stable `ref_*` identifiers and viewport info. Useful for semantic element discovery or agent planning. + +Parameters: + +- `filter` (string, optional): `interactive` to only include interactive elements; default includes structural and labeled nodes. +- `tabId` (number, optional): Target an existing tab by ID (default: active tab). + +Example: + +```json +{ + "filter": "interactive" +} +``` + +Response contains `pageContent` (text tree), `viewport`, and a `refMapCount` summary. Use `chrome_get_interactive_elements` or your own logic to act on returned refs. + ### `search_tabs_content` AI-powered semantic search across browser tabs. @@ -298,6 +321,7 @@ Extract HTML or text content from web pages. - `format` (string, optional): "html" or "text" (default: "text") - `selector` (string, optional): CSS selector for specific elements - `tabId` (number, optional): Specific tab ID (default: active tab) +- `background` (boolean, optional): Do not activate tab/focus window while fetching (default: false) **Example**: @@ -308,46 +332,72 @@ Extract HTML or text content from web pages. } ``` -### `chrome_get_interactive_elements` +### `chrome_get_interactive_elements` (deprecated) -Find clickable and interactive elements on the page. +Replaced by `chrome_read_page` as the primary discovery tool. The `read_page` implementation will automatically fallback to the interactive-elements logic when the accessibility tree is unavailable or too sparse. This tool is no longer listed via ListTools and is kept only for backward compatibility. -**Parameters**: +## 🎯 Interaction -- `tabId` (number, optional): Specific tab ID (default: active tab) +### `chrome_computer` -**Response**: +Unified advanced interaction tool that prioritizes high-level DOM actions with CDP fallback. Supports hover, click, drag, scroll, typing, key chords, fill, wait and screenshot. If a recent screenshot was taken via `chrome_screenshot`, coordinates are auto-scaled from screenshot space to viewport space. + +Parameters: + +- `action` (string, required): `left_click` | `right_click` | `double_click` | `triple_click` | `left_click_drag` | `scroll` | `type` | `key` | `fill` | `hover` | `wait` | `screenshot` +- `tabId` (number, optional): Target an existing tab by ID (default: active tab) +- `background` (boolean, optional): Avoid focusing/activating tab/window for certain operations (best-effort) +- `ref` (string, optional): element ref from `chrome_read_page` (preferred). Used for click/scroll/type/key and as drag end when provided +- `coordinates` (object, optional): `{ "x": 100, "y": 200 }` for click/scroll or drag end +- `startRef` (string, optional): element ref for drag start +- `startCoordinates` (object, optional): for `left_click_drag` when no `startRef` +- `scrollDirection` (string, optional): `up` | `down` | `left` | `right` +- `scrollAmount` (number, optional): ticks 1–10 (default 3) +- `text` (string, optional): for `type` (raw text) or `key` (space-separated chords/keys like `"cmd+a Enter"`) +- `duration` (number, optional): seconds for `wait` (max 30) +- `selector` (string, optional): for `fill` when no `ref` +- `value` (string, optional): for `fill` value + +Examples: ```json -{ - "elements": [ - { - "selector": "#submit-button", - "type": "button", - "text": "Submit", - "visible": true, - "clickable": true - } - ] -} +{ "action": "left_click", "coordinates": { "x": 420, "y": 260 } } ``` -## 🎯 Interaction +```json +{ "action": "key", "text": "cmd+a Backspace" } +``` + +````json +{ "action": "fill", "ref": "ref_7", "value": "user@example.com" } + +```json +{ "action": "hover", "ref": "ref_12", "duration": 0.6 } +```` + +```` + +```json +{ "action": "left_click_drag", "startRef": "ref_10", "ref": "ref_15" } +```` ### `chrome_click_element` -Click elements using CSS selectors. +Click elements using a ref, selector, or coordinates. **Parameters**: -- `selector` (string, required): CSS selector for target element -- `tabId` (number, optional): Specific tab ID (default: active tab) +- `ref` (string, optional): Element ref from `chrome_read_page` (preferred when available) +- `selector` (string, optional): CSS selector for target element +- `coordinates` (object, optional): `{ "x": 120, "y": 240 }` viewport coordinates + +At least one of `ref`, `selector`, or `coordinates` must be provided. **Example**: ```json { - "selector": "#submit-button" + "ref": "ref_42" } ``` @@ -357,15 +407,17 @@ Fill form fields or select options. **Parameters**: -- `selector` (string, required): CSS selector for target element +- `ref` (string, optional): Element ref from `chrome_read_page` +- `selector` (string, optional): CSS selector for target element - `value` (string, required): Value to fill or select -- `tabId` (number, optional): Specific tab ID (default: active tab) + +Provide `ref` or `selector` to identify the element. **Example**: ```json { - "selector": "#email-input", + "ref": "ref_7", "value": "user@example.com" } ``` diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index dfe2f5c6..9c79e8e8 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -1,8 +1,47 @@ # 🚀 Installation and Connection Issues -### If Connection Fails After Clicking the Connect Button on the Extension +## Quick Diagnosis -1. **Check if mcp-chrome-bridge is installed successfully**, ensure it's globally installed +Run the diagnostic tool to identify common issues: + +```bash +mcp-chrome-bridge doctor +``` + +To automatically fix common issues: + +```bash +mcp-chrome-bridge doctor --fix +``` + +## Export Report for GitHub Issues + +If you need to open an issue, export a diagnostic report: + +```bash +# Print Markdown report to terminal (copy/paste into GitHub Issue) +mcp-chrome-bridge report + +# Write to a file +mcp-chrome-bridge report --output mcp-report.md + +# Copy directly to clipboard +mcp-chrome-bridge report --copy +``` + +By default, usernames, paths, and tokens are redacted. Use `--no-redact` if you're comfortable sharing full paths. + +## If Connection Fails After Clicking the Connect Button on the Extension + +1. **Run the diagnostic tool first** + +```bash +mcp-chrome-bridge doctor +``` + +This will check installation, manifest, permissions, and Node.js path. + +2. **Check if mcp-chrome-bridge is installed successfully**, ensure it's globally installed ```bash mcp-chrome-bridge -V @@ -18,10 +57,12 @@ Mac path: /Users/xxx/Library/Application\ Support/Google/Chrome/NativeMessagingH If the npm package is installed correctly, a file named `com.chromemcp.nativehost.json` should be generated in this directory -3. **Check if there are logs in the npm package installation directory** - You need to check your installation path (if unclear, open the manifest file in step 2, the path field shows the installation directory). For example, if the installation path is as follows, check the log contents: +3. **Check logs** + Logs are now stored in user-writable directories: -C:\Users\admin\AppData\Local\nvm\v20.19.2\node_modules\mcp-chrome-bridge\dist\logs +- **macOS**: `~/Library/Logs/mcp-chrome-bridge/` +- **Windows**: `%LOCALAPPDATA%\mcp-chrome-bridge\logs\` +- **Linux**: `~/.local/state/mcp-chrome-bridge/logs/` Screenshot 2025-06-11 15 09 41 @@ -30,4 +71,25 @@ C:\Users\admin\AppData\Local\nvm\v20.19.2\node_modules\mcp-chrome-bridge\dist\lo `xxx/node_modules/mcp-chrome-bridge/dist/run_host.sh` -Check if this script has execution permissions +Check if this script has execution permissions. Run to fix: + +```bash +mcp-chrome-bridge fix-permissions +``` + +5. **Node.js not found** + If you use a Node version manager (nvm, volta, asdf, fnm), the wrapper script may not find Node.js. Set the `CHROME_MCP_NODE_PATH` environment variable: + +```bash +export CHROME_MCP_NODE_PATH=/path/to/your/node +``` + +Or run `mcp-chrome-bridge doctor --fix` to write the current Node path. + +## Log Locations + +Wrapper logs are now stored in user-writable locations: + +- **macOS**: `~/Library/Logs/mcp-chrome-bridge/` +- **Windows**: `%LOCALAPPDATA%\mcp-chrome-bridge\logs\` +- **Linux**: `~/.local/state/mcp-chrome-bridge/logs/` diff --git a/docs/TROUBLESHOOTING_zh.md b/docs/TROUBLESHOOTING_zh.md index a7fd3bbf..f95d9994 100644 --- a/docs/TROUBLESHOOTING_zh.md +++ b/docs/TROUBLESHOOTING_zh.md @@ -1,10 +1,49 @@ ## 🚀 安装和连接问题 +### 快速诊断 + +运行诊断工具来识别常见问题： + +```bash +mcp-chrome-bridge doctor +``` + +自动修复常见问题： + +```bash +mcp-chrome-bridge doctor --fix +``` + +### 导出诊断报告 + +如果需要提交 Issue，可以导出诊断报告： + +```bash +# 打印 Markdown 报告到终端（复制粘贴到 GitHub Issue） +mcp-chrome-bridge report + +# 写入到文件 +mcp-chrome-bridge report --output mcp-report.md + +# 直接复制到剪贴板 +mcp-chrome-bridge report --copy +``` + +默认情况下，用户名、路径和令牌会被脱敏。如果你需要提供完整路径，可以使用 `--no-redact`。 + ### 常见问题 #### 连接成功，但是服务启动失败 -启动失败基本上都是**权限问题**或者用包管理工具安装的**node**导致的启动脚本找不到对应的node，核心排查流程 +启动失败基本上都是**权限问题**或者用包管理工具安装的**node**导致的启动脚本找不到对应的node。 + +**推荐先运行诊断工具：** + +```bash +mcp-chrome-bridge doctor +``` + +核心排查流程 1. npm包全局安装后，确认清单文件com.chromemcp.nativehost.json的位置，里面有一个**path**字段，指向的是一个启动脚本: @@ -36,21 +75,42 @@ mac路径： /Users/xxx/Library/Application\ Support/Google/Chrome/NativeMessagi > 如果发现没有此清单文件，可以尝试命令行执行：`mcp-chrome-bridge register` -2. Chrome浏览器会找到上面的清单文件指向的脚本路径来执行该脚本，同时会在/Users/xxx/Library/pnpm/global/5/.pnpm/mcp-chrome-bridge@1.0.23/node_modules/mcp-chrome-bridge/dist/（windows的自行查看清单文件对应的目录）下生成logs文件夹，里面会记录日志 +2. **检查日志** + +日志现在存储在用户可写目录： + +- **macOS**: `~/Library/Logs/mcp-chrome-bridge/` +- **Windows**: `%LOCALAPPDATA%\mcp-chrome-bridge\logs\`（例如 `C:\Users\xxx\AppData\Local\mcp-chrome-bridge\logs\`） +- **Linux**: `~/.local/state/mcp-chrome-bridge/logs/` -具体要看你的安装路径（如果不清楚，可以打开上面提到的清单文件，里面的path就是安装目录），比如安装路径如下：看下日志的内容 -C:\Users\admin\AppData\Local\nvm\v20.19.2\node_modules\mcp-chrome-bridge\dist\logs 截屏2025-06-11 15 09 41 3. 一般失败的原因就是两种 -3.1. run_host.sh(windows是run_host.bat)没有执行权限：此时你可以自行赋予权限，参考：https://github.com/hangwin/mcp-chrome/issues/22#issuecomment-2990636930。 脚本路径在上述的清单文件可以查看 +3.1. run_host.sh(windows是run_host.bat)没有执行权限：运行以下命令修复： -3.2. 脚本找不到node，因为你可能电脑上装了不同版本的node，脚本确认不了你把npm包装在哪个node底下了，不同的人可能用了不同的node版本管理工具，导致找不到， -参考：https://github.com/hangwin/mcp-chrome/issues/29#issuecomment-3003513940 （这个点目前正在优化中） +```bash +mcp-chrome-bridge fix-permissions +``` + +3.2. 脚本找不到node：如果你使用 Node 版本管理工具（nvm、volta、asdf、fnm），可以设置 `CHROME_MCP_NODE_PATH` 环境变量： + +```bash +export CHROME_MCP_NODE_PATH=/path/to/your/node +``` + +或者运行 `mcp-chrome-bridge doctor --fix` 来写入当前 Node 路径。 3.3 如果排除了以上两种原因都不行，则查看日志目录的日志，然后提issue +### 日志位置 + +包装器日志现在存储在用户可写的位置： + +- **macOS**: `~/Library/Logs/mcp-chrome-bridge/` +- **Windows**: `%LOCALAPPDATA%\mcp-chrome-bridge\logs\` +- **Linux**: `~/.local/state/mcp-chrome-bridge/logs/` + #### 工具执行超时 有可能长时间连接的时候session会超时，这个时候重新连接即可 diff --git a/docs/VisualEditor.md b/docs/VisualEditor.md new file mode 100644 index 00000000..64dce465 --- /dev/null +++ b/docs/VisualEditor.md @@ -0,0 +1,47 @@ +# A Visual Editor for Claude Code & Codex + +**How to enable:** +`Right Click > Chrome MCP Server > Toggle Web Editing Mode` +**Shortcut:** `Cmd/Ctrl` + `Shift` + `O` + +### Interactive Sizing & Layout Adjustment + +Directly drag element edges on the canvas to adjust width, height, and font sizes. All visual manipulations are automatically converted into code suggestions and applied to your source code by the Agent, bridging the gap between design and development in real-time. + + + +### Visual Property Controls + +Manage CSS properties directly through a visual inspector panel. Effortlessly tweak Flex/Grid layouts, margins, padding, and styling details with a single click. Perfect for rapid prototyping or UI fine-tuning, significantly reducing the time spent writing raw CSS. + + + +### Live Component State Debugging (Vue/React) + +Inspect and modify React and Vue component props in real-time. Test how your components render under different data states without ever leaving your current view or writing temporary console logs. + + + +### Point, Click & Prompt + +Select any element on the page and send instructions directly to Claude Code or Codex. The tool automatically captures the component's structure and context, enabling the AI to provide modifications with far greater precision and lower latency than global chat contexts. + +Simply click an element and say, _"Make this bigger"_ or _"Change the background to red"_, and watch Claude Code implement the exact changes in seconds. + + diff --git a/docs/VisualEditor_zh.md b/docs/VisualEditor_zh.md new file mode 100644 index 00000000..f7260ca1 --- /dev/null +++ b/docs/VisualEditor_zh.md @@ -0,0 +1,44 @@ +## 让Claude Code/Codex也能使用的可视化编辑器 + +如何开启：`右键 > chrome mcp server > 切换网页编辑模式` +或者快捷键： `cmd/ctrl + shift + o` + +### 交互式尺寸与排版调整 + +接在画布上拖拽元素边缘调整宽、高及字体大小。所有的视觉调整将自动转换为代码变更建议，由 Agent 应用到源码中，实现设计与代码的实时同步。 + + + +### 可视化属性面板 + +通过元素属性面板直接管理 CSS 属性。支持一键调整 Flex/Grid 布局、内外边距及样式细节。适合快速原型设计或 UI 微调，大幅减少 CSS 编写时间。 + + + +### 直接调试组件Vue/React组件的状态 + +支持实时查看和修改 React 及 Vue 组件的 props，无需离开当前视图，即可测试组件在不同状态下的渲染表现。 + + + +### 点选并提示 + +选中任意页面元素，直接向Claude Code或者Codex发送修改指令。工具会自动提取选中组件结构与上下文信息发送给 AI，从而实现比全局对话更精准、更低延迟的代码修改。比如你可以点选某个元素然后说「把这个变大一些」，让Claude Code帮你在几秒内实现精准修改并实时生效 + + diff --git a/docs/WINDOWS_INSTALL_zh.md b/docs/WINDOWS_INSTALL_zh.md index 91fc5cbe..dd287e3e 100644 --- a/docs/WINDOWS_INSTALL_zh.md +++ b/docs/WINDOWS_INSTALL_zh.md @@ -13,7 +13,6 @@ Chrome MCP Server 在windows电脑的详细安装和配置步骤 确保电脑上已经安装了node，如果没安装请自行先安装 ```bash -# 确保安装的是最新版本的npm包(当前最新版本是1.0.14)，否则可能有问题 npm install -g mcp-chrome-bridge ``` @@ -47,6 +46,20 @@ npm install -g mcp-chrome-bridge ## 🚀 安装和连接问题 +### 快速诊断 + +如果遇到问题，运行诊断工具： + +```bash +mcp-chrome-bridge doctor +``` + +自动修复常见问题： + +```bash +mcp-chrome-bridge doctor --fix +``` + ### 点击扩展的连接按钮后如果没连接成功 1. **检查mcp-chrome-bridge是否安装成功**，确保是全局安装的 @@ -61,8 +74,20 @@ mcp-chrome-bridge -V 路径：C:\Users\xxx\AppData\Roaming\Google\Chrome\NativeMessagingHosts -3. **检查npm包的安装目录下是否有日志** +3. **检查日志** + +日志现在存储在用户目录：`%LOCALAPPDATA%\mcp-chrome-bridge\logs\` + +例如：`C:\Users\xxx\AppData\Local\mcp-chrome-bridge\logs\` -具体要看你的安装路径（如果不清楚，可以打开第2步的清单文件，里面的path就是安装目录），比如安装路径如下：看下日志的内容 -C:\Users\admin\AppData\Local\nvm\v20.19.2\node_modules\mcp-chrome-bridge\dist\logs 截屏2025-06-11 15 09 41 + +4. **Node.js 路径问题** + +如果使用 Node 版本管理器（nvm-windows、volta、fnm），可以设置环境变量： + +```cmd +set CHROME_MCP_NODE_PATH=C:\path\to\your\node.exe +``` + +或者运行 `mcp-chrome-bridge doctor --fix` 自动写入当前 Node 路径。 diff --git a/docs/mcp-cli-config.md b/docs/mcp-cli-config.md new file mode 100644 index 00000000..adbe9058 --- /dev/null +++ b/docs/mcp-cli-config.md @@ -0,0 +1,108 @@ +# CLI MCP Configuration Guide + +This guide explains how to configure Codex CLI and Claude Code to connect to the Chrome MCP Server. + +## Overview + +The Chrome MCP Server exposes its MCP interface at `http://127.0.0.1:12306/mcp` (default port). +Both Codex CLI and Claude Code can connect to this endpoint to use Chrome browser control tools. + +## Codex CLI Configuration + +### Option 1: HTTP MCP Server (Recommended) + +Add the following to your `~/.codex/config.json`: + +```json +{ + "mcpServers": { + "chrome-mcp": { + "url": "http://127.0.0.1:12306/mcp" + } + } +} +``` + +### Option 2: Via Environment Variable + +Set the MCP URL via environment variable before running codex: + +```bash +export MCP_HTTP_PORT=12306 +``` + +## Claude Code Configuration + +### Option 1: HTTP MCP Server + +Add the following to your `~/.claude/claude_desktop_config.json`: + +```json +{ + "mcpServers": { + "chrome-mcp": { + "url": "http://127.0.0.1:12306/mcp" + } + } +} +``` + +### Option 2: Stdio Server (Alternative) + +If you prefer stdio-based MCP communication: + +```json +{ + "mcpServers": { + "chrome-mcp": { + "command": "node", + "args": ["/path/to/mcp-chrome/dist/mcp/mcp-server-stdio.js"] + } + } +} +``` + +## Verifying Connection + +After configuration, the CLI tools should be able to see and use Chrome MCP tools such as: + +- `chrome_get_windows_and_tabs` - Get browser window and tab information +- `chrome_navigate` - Navigate to a URL +- `chrome_click_element` - Click on page elements +- `chrome_get_page_content` - Get page content +- And more... + +## Troubleshooting + +### Connection Refused + +If you get "connection refused" errors: + +1. Ensure the Chrome extension is installed and the native server is running +2. Check that the port matches (default: 12306) +3. Verify no firewall is blocking localhost connections +4. Run `mcp-chrome-bridge doctor` to diagnose issues + +### Tools Not Appearing + +If MCP tools don't appear in the CLI: + +1. Restart the CLI tool after configuration changes +2. Check the configuration file syntax (valid JSON) +3. Ensure the MCP server URL is accessible + +### Port Conflicts + +If port 12306 is already in use: + +1. Set a custom port in the extension settings +2. Update the CLI configuration to match the new port +3. Run `mcp-chrome-bridge update-port ` to update the stdio config + +## Environment Variables + +| Variable | Description | Default | +| ---------------------------- | -------------------------------------- | ------- | +| `MCP_HTTP_PORT` | HTTP port for MCP server | 12306 | +| `MCP_ALLOWED_WORKSPACE_BASE` | Additional allowed workspace directory | (none) | +| `CHROME_MCP_NODE_PATH` | Override Node.js executable path | (auto) | diff --git a/eslint.config.js b/eslint.config.js index 5a843f72..8781dbbd 100644 --- a/eslint.config.js +++ b/eslint.config.js @@ -32,6 +32,14 @@ export default tseslint.config( js.configs.recommended, ...tseslint.configs.recommended, + // Global rule adjustments + { + // Allow intentionally empty catch blocks (common in extension code), + // while keeping other empty blocks reported. + rules: { + 'no-empty': ['error', { allowEmptyCatch: true }], + }, + }, { files: ['app/**/*.{js,jsx,ts,tsx}', 'packages/**/*.{js,jsx,ts,tsx}'], ignores: ['**/workers/**'], // Additional ignores for this specific config diff --git a/packages/shared/src/agent-types.ts b/packages/shared/src/agent-types.ts new file mode 100644 index 00000000..3a39ff7b --- /dev/null +++ b/packages/shared/src/agent-types.ts @@ -0,0 +1,477 @@ +/** + * Agent-side shared data contracts. + * These types are shared between native-server and chrome-extension to ensure consistency. + * + * English is used for technical contracts; Chinese comments explain design choices. + */ + +// ============================================================ +// Core Types +// ============================================================ + +export type AgentRole = 'user' | 'assistant' | 'tool' | 'system'; + +export interface AgentMessage { + id: string; + sessionId: string; + role: AgentRole; + content: string; + messageType: 'chat' | 'tool_use' | 'tool_result' | 'status'; + cliSource?: string; + requestId?: string; + isStreaming?: boolean; + isFinal?: boolean; + createdAt: string; + metadata?: Record; +} + +// ============================================================ +// Stream Events +// ============================================================ + +export type StreamTransport = 'sse' | 'websocket'; + +export interface AgentStatusEvent { + sessionId: string; + status: 'starting' | 'ready' | 'running' | 'completed' | 'error' | 'cancelled'; + message?: string; + requestId?: string; +} + +export interface AgentConnectedEvent { + sessionId: string; + transport: StreamTransport; + timestamp: string; +} + +export interface AgentHeartbeatEvent { + timestamp: string; +} + +/** Usage statistics for a request */ +export interface AgentUsageStats { + sessionId: string; + requestId?: string; + inputTokens: number; + outputTokens: number; + cacheReadInputTokens?: number; + cacheCreationInputTokens?: number; + totalCostUsd: number; + durationMs: number; + numTurns: number; +} + +export type RealtimeEvent = + | { type: 'message'; data: AgentMessage } + | { type: 'status'; data: AgentStatusEvent } + | { type: 'error'; error: string; data?: { sessionId?: string; requestId?: string } } + | { type: 'connected'; data: AgentConnectedEvent } + | { type: 'heartbeat'; data: AgentHeartbeatEvent } + | { type: 'usage'; data: AgentUsageStats }; + +// ============================================================ +// HTTP API Contracts +// ============================================================ + +export interface AgentAttachment { + type: 'file' | 'image'; + name: string; + mimeType: string; + dataBase64: string; +} + +export type AgentCliPreference = 'claude' | 'codex' | 'cursor' | 'qwen' | 'glm'; + +export interface AgentActRequest { + instruction: string; + cliPreference?: AgentCliPreference; + model?: string; + attachments?: AgentAttachment[]; + /** + * Optional logical project identifier. When provided, the backend + * can resolve a stable workspace configuration instead of relying + * solely on ad-hoc paths. + */ + projectId?: string; + /** + * Optional database session ID (sessions.id). When provided, the backend + * will load session-level configuration (engine, model, permission mode, + * resume ids, etc.) from the sessions table. + */ + dbSessionId?: string; + /** + * Optional project root / workspace directory on the local filesystem + * that the engine should use as its working directory. + */ + projectRoot?: string; + /** + * Optional request id from client; server will generate one if missing. + */ + requestId?: string; + /** + * Optional client metadata to store with the user message. + * For extension-specific context that should be preserved. + */ + clientMeta?: Record; + /** + * Optional display text override for the instruction. + * When set, UI should display this instead of raw instruction. + */ + displayText?: string; +} + +export interface AgentActResponse { + requestId: string; + sessionId: string; + status: 'accepted'; +} + +// ============================================================ +// Project & Engine Types +// ============================================================ + +export interface AgentProject { + id: string; + name: string; + description?: string; + /** + * Absolute filesystem path for this project workspace. + */ + rootPath: string; + preferredCli?: AgentCliPreference; + selectedModel?: string; + /** + * Active Claude session ID (UUID format) for session resumption. + * Captured from SDK's system/init message and used for the 'resume' parameter. + */ + activeClaudeSessionId?: string; + /** + * Whether to use Claude Code Router (CCR) for this project. + * When enabled, the engine will auto-detect CCR configuration. + */ + useCcr?: boolean; + /** + * Whether to enable Chrome MCP integration for this project. + * Default: true + */ + enableChromeMcp?: boolean; + createdAt: string; + updatedAt: string; + lastActiveAt?: string; +} + +export interface AgentEngineInfo { + name: string; + supportsMcp?: boolean; +} + +// ============================================================ +// Session Types +// ============================================================ + +/** + * System prompt configuration for a session. + */ +export type AgentSystemPromptConfig = + | { type: 'custom'; text: string } + | { type: 'preset'; preset: 'claude_code'; append?: string }; + +/** + * Tools configuration - can be a list of tool names or a preset. + */ +export type AgentToolsConfig = string[] | { type: 'preset'; preset: 'claude_code' }; + +/** + * Session options configuration. + */ +export interface AgentSessionOptionsConfig { + settingSources?: string[]; + allowedTools?: string[]; + disallowedTools?: string[]; + tools?: AgentToolsConfig; + betas?: string[]; + maxThinkingTokens?: number; + maxTurns?: number; + maxBudgetUsd?: number; + mcpServers?: Record; + outputFormat?: Record; + enableFileCheckpointing?: boolean; + sandbox?: Record; + env?: Record; + /** + * Optional Codex-specific configuration overrides. + * Only applicable when using CodexEngine. + */ + codexConfig?: Partial; +} + +/** + * Cached management information from Claude SDK. + */ +export interface AgentManagementInfo { + tools?: string[]; + agents?: string[]; + plugins?: Array<{ name: string; path?: string }>; + skills?: string[]; + mcpServers?: Array<{ name: string; status: string }>; + slashCommands?: string[]; + model?: string; + permissionMode?: string; + cwd?: string; + outputStyle?: string; + betas?: string[]; + claudeCodeVersion?: string; + apiKeySource?: string; + lastUpdated?: string; +} + +/** + * Agent session - represents an independent conversation within a project. + */ +export interface AgentSession { + id: string; + projectId: string; + engineName: AgentCliPreference; + engineSessionId?: string; + name?: string; + /** Preview text from first user message, for display in session list */ + preview?: string; + model?: string; + permissionMode: string; + allowDangerouslySkipPermissions: boolean; + systemPromptConfig?: AgentSystemPromptConfig; + optionsConfig?: AgentSessionOptionsConfig; + managementInfo?: AgentManagementInfo; + createdAt: string; + updatedAt: string; +} + +/** + * Options for creating a new session. + */ +export interface CreateAgentSessionInput { + engineName: AgentCliPreference; + name?: string; + model?: string; + permissionMode?: string; + allowDangerouslySkipPermissions?: boolean; + systemPromptConfig?: AgentSystemPromptConfig; + optionsConfig?: AgentSessionOptionsConfig; +} + +/** + * Options for updating a session. + */ +export interface UpdateAgentSessionInput { + name?: string | null; + model?: string | null; + permissionMode?: string | null; + allowDangerouslySkipPermissions?: boolean | null; + systemPromptConfig?: AgentSystemPromptConfig | null; + optionsConfig?: AgentSessionOptionsConfig | null; +} + +// ============================================================ +// Stored Message (for persistence) +// ============================================================ + +export interface AgentStoredMessage { + id: string; + projectId: string; + sessionId: string; + conversationId?: string | null; + role: AgentRole; + content: string; + messageType: AgentMessage['messageType']; + metadata?: Record; + cliSource?: string | null; + createdAt?: string; + requestId?: string; +} + +// ============================================================ +// Codex Engine Configuration +// ============================================================ + +/** + * Sandbox mode for Codex CLI execution. + */ +export type CodexSandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access'; + +/** + * Reasoning effort for Codex models. + * - low/medium/high: supported by all models + * - xhigh: only supported by gpt-5.2 and gpt-5.1-codex-max + */ +export type CodexReasoningEffort = 'low' | 'medium' | 'high' | 'xhigh'; + +/** + * Configuration options for Codex Engine. + * These can be overridden per-session via session settings. + */ +export interface CodexEngineConfig { + /** Enable apply_patch tool for file modifications. Default: true */ + includeApplyPatchTool: boolean; + /** Enable plan tool for task planning. Default: true */ + includePlanTool: boolean; + /** Enable web search capability. Default: true */ + enableWebSearch: boolean; + /** Use experimental streamable shell tool. Default: true */ + useStreamableShell: boolean; + /** Sandbox mode for command execution. Default: 'danger-full-access' */ + sandboxMode: CodexSandboxMode; + /** Maximum number of turns. Default: 20 */ + maxTurns: number; + /** Maximum thinking tokens. Default: 4096 */ + maxThinkingTokens: number; + /** Reasoning effort for supported models. Default: 'medium' */ + reasoningEffort: CodexReasoningEffort; + /** Auto instructions for autonomous behavior. Default: AUTO_INSTRUCTIONS */ + autoInstructions: string; + /** Append project context (file listing) to prompt. Default: true */ + appendProjectContext: boolean; +} + +/** + * Default auto instructions for Codex to act autonomously. + * Aligned with other/cweb implementation. + */ +export const CODEX_AUTO_INSTRUCTIONS = `Act autonomously without asking for confirmations. +Use apply_patch to create and modify files directly in the current working directory (do not create subdirectories unless the user explicitly requests it). +Use exec_command to run, build, and test as needed. +You have full permissions. Keep taking concrete actions until the task is complete. +Respect the existing project structure when creating or modifying files. +Prefer concise status updates over questions.`; + +/** + * Default configuration for Codex Engine. + * Aligned with other/cweb implementation for feature parity. + */ +export const DEFAULT_CODEX_CONFIG: CodexEngineConfig = { + includeApplyPatchTool: true, + includePlanTool: true, + enableWebSearch: true, + useStreamableShell: true, + sandboxMode: 'danger-full-access', + maxTurns: 20, + maxThinkingTokens: 4096, + reasoningEffort: 'medium', + autoInstructions: CODEX_AUTO_INSTRUCTIONS, + appendProjectContext: true, +}; + +// ============================================================ +// Attachment Types +// ============================================================ + +/** + * Metadata for a persisted attachment file. + */ +export interface AttachmentMetadata { + /** Schema version for forward compatibility */ + version: number; + /** Kind of attachment (e.g., 'image', 'file') */ + kind: string; + /** Project ID this attachment belongs to */ + projectId: string; + /** Message ID this attachment is associated with */ + messageId: string; + /** Index of this attachment in the message */ + index: number; + /** Persisted filename under project dir */ + filename: string; + /** URL path to access this attachment */ + urlPath: string; + /** MIME type of the attachment */ + mimeType: string; + /** File size in bytes */ + sizeBytes: number; + /** Original filename from upload */ + originalName: string; + /** Timestamp when attachment was created */ + createdAt: string; +} + +/** + * Statistics for attachments in a single project. + */ +export interface AttachmentProjectStats { + projectId: string; + /** Directory path for this project's attachments */ + dirPath: string; + /** Whether the directory exists */ + exists: boolean; + fileCount: number; + totalBytes: number; + /** Last modification timestamp (only when exists is true) */ + lastModifiedAt?: string; +} + +/** + * Cleanup result for a single project. + */ +export interface CleanupProjectResult { + projectId: string; + dirPath: string; + existed: boolean; + removedFiles: number; + removedBytes: number; +} + +/** + * Response for attachment statistics endpoint. + */ +export interface AttachmentStatsResponse { + success: boolean; + rootDir: string; + totalFiles: number; + totalBytes: number; + projects: Array< + AttachmentProjectStats & { + projectName?: string; + existsInDb: boolean; + } + >; + orphanProjectIds: string[]; +} + +/** + * Request body for attachment cleanup endpoint. + */ +export interface AttachmentCleanupRequest { + /** If provided, cleanup only these projects. Otherwise cleanup all. */ + projectIds?: string[]; +} + +/** + * Response for attachment cleanup endpoint. + */ +export interface AttachmentCleanupResponse { + success: boolean; + scope: 'project' | 'selected' | 'all'; + removedFiles: number; + removedBytes: number; + results: CleanupProjectResult[]; +} + +// ============================================================ +// Open Project Types +// ============================================================ + +/** + * Target application for opening a project directory. + */ +export type OpenProjectTarget = 'vscode' | 'terminal'; + +/** + * Request body for open-project endpoint. + */ +export interface OpenProjectRequest { + /** Target application to open the project in */ + target: OpenProjectTarget; +} + +/** + * Response for open-project endpoint. + */ +export type OpenProjectResponse = { success: true } | { success: false; error: string }; diff --git a/packages/shared/src/constants.ts b/packages/shared/src/constants.ts index 092b15de..827b551f 100644 --- a/packages/shared/src/constants.ts +++ b/packages/shared/src/constants.ts @@ -1,2 +1,2 @@ -export const DEFAULT_SERVER_PORT = 56889; -export const HOST_NAME = 'com.chrome_mcp.native_host'; +export const DEFAULT_SERVER_PORT = 12306; +export const HOST_NAME = 'com.chromemcp.nativehost'; diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts index 7bc7678b..bd56609a 100644 --- a/packages/shared/src/index.ts +++ b/packages/shared/src/index.ts @@ -1,3 +1,10 @@ export * from './constants'; export * from './types'; export * from './tools'; +export * from './rr-graph'; +export * from './step-types'; +export * from './labels'; +export * from './node-spec'; +export * from './node-spec-registry'; +export * from './node-specs-builtin'; +export * from './agent-types'; diff --git a/packages/shared/src/labels.ts b/packages/shared/src/labels.ts new file mode 100644 index 00000000..779ad36e --- /dev/null +++ b/packages/shared/src/labels.ts @@ -0,0 +1,10 @@ +// labels.ts — centralized labels for edges and other enums + +export const EDGE_LABELS = { + DEFAULT: 'default', + TRUE: 'true', + FALSE: 'false', + ON_ERROR: 'onError', +} as const; + +export type EdgeLabel = (typeof EDGE_LABELS)[keyof typeof EDGE_LABELS]; diff --git a/packages/shared/src/node-spec-registry.ts b/packages/shared/src/node-spec-registry.ts new file mode 100644 index 00000000..ba71cbf9 --- /dev/null +++ b/packages/shared/src/node-spec-registry.ts @@ -0,0 +1,16 @@ +// node-spec-registry.ts — runtime registry for NodeSpec (shared between UI/runtime) +import type { NodeSpec } from './node-spec'; + +const REG = new Map(); + +export function registerNodeSpec(spec: NodeSpec) { + REG.set(spec.type, spec); +} + +export function getNodeSpec(type: string): NodeSpec | undefined { + return REG.get(type); +} + +export function listNodeSpecs(): NodeSpec[] { + return Array.from(REG.values()); +} diff --git a/packages/shared/src/node-spec.ts b/packages/shared/src/node-spec.ts new file mode 100644 index 00000000..dea463bb --- /dev/null +++ b/packages/shared/src/node-spec.ts @@ -0,0 +1,78 @@ +// node-spec.ts — shared NodeSpec types for UI-driven forms + +export type FieldType = 'string' | 'number' | 'boolean' | 'select' | 'object' | 'array' | 'json'; + +export interface FieldSpecBase { + key: string; + label: string; + type: FieldType; + required?: boolean; + placeholder?: string; + help?: string; + // widget name used by UI; runtime ignores it + widget?: string; + uiProps?: Record; +} + +export interface FieldString extends FieldSpecBase { + type: 'string'; + default?: string; +} +export interface FieldNumber extends FieldSpecBase { + type: 'number'; + min?: number; + max?: number; + step?: number; + default?: number; +} +export interface FieldBoolean extends FieldSpecBase { + type: 'boolean'; + default?: boolean; +} +export interface FieldSelect extends FieldSpecBase { + type: 'select'; + options: Array<{ label: string; value: string | number | boolean }>; + default?: string | number | boolean; +} +export interface FieldObject extends FieldSpecBase { + type: 'object'; + fields: FieldSpec[]; + default?: Record; +} +export interface FieldArray extends FieldSpecBase { + type: 'array'; + item: FieldString | FieldNumber | FieldBoolean | FieldSelect | FieldObject | FieldJson; + default?: any[]; +} +export interface FieldJson extends FieldSpecBase { + type: 'json'; + default?: any; +} + +export type FieldSpec = + | FieldString + | FieldNumber + | FieldBoolean + | FieldSelect + | FieldObject + | FieldArray + | FieldJson; + +export type NodeCategory = 'Flow' | 'Actions' | 'Logic' | 'Tools' | 'Tabs' | 'Page'; + +export interface NodeSpecDisplay { + label: string; + iconClass: string; + category: NodeCategory; + docUrl?: string; +} + +export interface NodeSpec { + type: string; // Aligns with NodeType/StepType + version: number; + display: NodeSpecDisplay; + ports: { inputs: number | 'any'; outputs: Array<{ label?: string }> | 'any' }; + schema: FieldSpec[]; + defaults: Record; + validate?: (config: any) => string[]; +} diff --git a/packages/shared/src/node-specs-builtin.ts b/packages/shared/src/node-specs-builtin.ts new file mode 100644 index 00000000..2cc4f807 --- /dev/null +++ b/packages/shared/src/node-specs-builtin.ts @@ -0,0 +1,659 @@ +// node-specs-builtin.ts — builtin NodeSpecs shared for UI + runtime +import type { NodeSpec } from './node-spec'; +import { registerNodeSpec } from './node-spec-registry'; +import { STEP_TYPES } from './step-types'; + +export function registerBuiltinSpecs() { + const nav: NodeSpec = { + type: STEP_TYPES.NAVIGATE, + version: 1, + display: { label: '导航', iconClass: 'icon-navigate', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'url', + label: 'URL', + type: 'string', + required: true, + placeholder: 'https://example.com', + help: '目标地址，支持变量模板 {var}', + default: '', + }, + ], + defaults: { url: '' }, + validate: (cfg) => { + const errs: string[] = []; + if (!cfg || !cfg.url || String(cfg.url).trim() === '') errs.push('URL 必填'); + return errs; + }, + }; + registerNodeSpec(nav); + + // Click / Dblclick + registerNodeSpec({ + type: STEP_TYPES.CLICK, + version: 1, + display: { label: '点击', iconClass: 'icon-click', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'target', + label: '目标', + type: 'json', + widget: 'targetlocator', + help: '选择或输入元素选择器', + }, + { + key: 'before', + label: '执行前', + type: 'object', + fields: [ + { key: 'scrollIntoView', label: '滚动到可见', type: 'boolean', default: true }, + { key: 'waitForSelector', label: '等待选择器', type: 'boolean', default: true }, + ], + }, + { + key: 'after', + label: '执行后', + type: 'object', + fields: [ + { key: 'waitForNavigation', label: '等待导航完成', type: 'boolean', default: false }, + { key: 'waitForNetworkIdle', label: '等待网络空闲', type: 'boolean', default: false }, + ], + }, + ], + defaults: { before: { scrollIntoView: true, waitForSelector: true }, after: {} }, + }); + registerNodeSpec({ + type: STEP_TYPES.DBLCLICK, + version: 1, + display: { label: '双击', iconClass: 'icon-click', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'target', label: '目标', type: 'json', widget: 'targetlocator' }, + { + key: 'before', + label: '执行前', + type: 'object', + fields: [ + { key: 'scrollIntoView', label: '滚动到可见', type: 'boolean', default: true }, + { key: 'waitForSelector', label: '等待选择器', type: 'boolean', default: true }, + ], + }, + { + key: 'after', + label: '执行后', + type: 'object', + fields: [ + { key: 'waitForNavigation', label: '等待导航完成', type: 'boolean', default: false }, + { key: 'waitForNetworkIdle', label: '等待网络空闲', type: 'boolean', default: false }, + ], + }, + ], + defaults: { before: { scrollIntoView: true, waitForSelector: true }, after: {} }, + }); + + // Fill + registerNodeSpec({ + type: STEP_TYPES.FILL, + version: 1, + display: { label: '填充', iconClass: 'icon-fill', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'target', label: '目标', type: 'json', widget: 'targetlocator' }, + { key: 'value', label: '输入值', type: 'string', required: true, help: '支持 {var} 模板' }, + ], + defaults: { value: '' }, + }); + + // Key + registerNodeSpec({ + type: STEP_TYPES.KEY, + version: 1, + display: { label: '键盘', iconClass: 'icon-key', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'keys', + label: '按键序列', + type: 'string', + widget: 'keysequence', + required: true, + help: '如 Backspace Enter 或 cmd+a', + }, + { key: 'target', label: '焦点目标(可选)', type: 'json', widget: 'targetlocator' }, + ], + defaults: { keys: '' }, + }); + + // Scroll + registerNodeSpec({ + type: STEP_TYPES.SCROLL, + version: 1, + display: { label: '滚动', iconClass: 'icon-scroll', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'mode', + label: '模式', + type: 'select', + options: [ + { label: '元素', value: 'element' }, + { label: '偏移', value: 'offset' }, + { label: '容器', value: 'container' }, + ] as any, + default: 'offset', + }, + { key: 'target', label: '目标(当元素/容器)', type: 'json', widget: 'targetlocator' }, + { + key: 'offset', + label: '偏移', + type: 'object', + fields: [ + { key: 'x', label: 'X', type: 'number' }, + { key: 'y', label: 'Y', type: 'number' }, + ], + }, + ], + defaults: { mode: 'offset', offset: { x: 0, y: 300 } }, + }); + + // Drag + registerNodeSpec({ + type: STEP_TYPES.DRAG, + version: 1, + display: { label: '拖拽', iconClass: 'icon-drag', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'start', label: '起点', type: 'json', widget: 'targetlocator' }, + { key: 'end', label: '终点', type: 'json', widget: 'targetlocator' }, + { + key: 'path', + label: '路径坐标', + type: 'array', + item: { + key: 'p', + label: '点', + type: 'object', + fields: [ + { key: 'x', label: 'X', type: 'number' }, + { key: 'y', label: 'Y', type: 'number' }, + ], + } as any, + }, + ], + defaults: {}, + }); + + // Wait + registerNodeSpec({ + type: STEP_TYPES.WAIT, + version: 1, + display: { label: '等待', iconClass: 'icon-wait', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'condition', + label: '条件(JSON)', + type: 'json', + help: '如 {"sleep":1000} 或 {"text":"Hello","appear":true}', + }, + ], + defaults: { condition: { sleep: 500 } }, + }); + + // Assert + registerNodeSpec({ + type: STEP_TYPES.ASSERT, + version: 1, + display: { label: '断言', iconClass: 'icon-assert', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }, { label: 'onError' }] }, + schema: [ + { + key: 'assert', + label: '断言(JSON)', + type: 'json', + help: '如 {"exists":"#id"} / {"visible":".btn"}', + }, + { + key: 'failStrategy', + label: '失败策略', + type: 'select', + options: [ + { label: '停止', value: 'stop' }, + { label: '警告', value: 'warn' }, + { label: '重试', value: 'retry' }, + ] as any, + default: 'stop', + }, + ], + defaults: { assert: {} }, + }); + + // HTTP + registerNodeSpec({ + type: STEP_TYPES.HTTP, + version: 1, + display: { label: 'HTTP', iconClass: 'icon-http', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'method', + label: '方法', + type: 'select', + options: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].map((m) => ({ + label: m, + value: m, + })) as any, + default: 'GET', + }, + { key: 'url', label: 'URL', type: 'string', required: true }, + { key: 'headers', label: '请求头(JSON)', type: 'json' }, + { key: 'body', label: '请求体(JSON)', type: 'json' }, + { key: 'formData', label: '表单(JSON)', type: 'json' }, + { key: 'saveAs', label: '保存为变量', type: 'string' }, + { key: 'assign', label: '映射(JSON)', type: 'json' }, + ], + defaults: { method: 'GET' }, + }); + + // Extract + registerNodeSpec({ + type: STEP_TYPES.EXTRACT, + version: 1, + display: { label: '提取', iconClass: 'icon-extract', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'selector', label: '选择器', type: 'string', widget: 'selector' }, + { + key: 'attr', + label: '属性', + type: 'select', + options: [ + { label: '文本(text)', value: 'text' }, + { label: '文本(textContent)', value: 'textContent' }, + { label: '自定义属性名', value: 'attr' }, + ] as any, + }, + { key: 'js', label: '自定义JS', type: 'string', help: '在页面中执行并返回值' }, + { key: 'saveAs', label: '保存变量', type: 'string', required: true }, + ], + defaults: { saveAs: '' }, + }); + + // Screenshot + registerNodeSpec({ + type: STEP_TYPES.SCREENSHOT, + version: 1, + display: { label: '截图', iconClass: 'icon-screenshot', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'selector', label: '目标选择器', type: 'string' }, + { key: 'fullPage', label: '整页截图', type: 'boolean', default: false }, + { key: 'saveAs', label: '保存变量', type: 'string' }, + ], + defaults: { fullPage: false }, + }); + + // TriggerEvent + registerNodeSpec({ + type: STEP_TYPES.TRIGGER_EVENT, + version: 1, + display: { label: '触发事件', iconClass: 'icon-trigger', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'target', label: '目标', type: 'json', widget: 'targetlocator' }, + { key: 'event', label: '事件类型', type: 'string', required: true }, + { key: 'bubbles', label: '冒泡', type: 'boolean', default: true }, + { key: 'cancelable', label: '可取消', type: 'boolean', default: false }, + ], + defaults: { event: '' }, + }); + + // SetAttribute + registerNodeSpec({ + type: STEP_TYPES.SET_ATTRIBUTE, + version: 1, + display: { label: '设置属性', iconClass: 'icon-attr', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'target', label: '目标', type: 'json', widget: 'targetlocator' }, + { key: 'name', label: '属性名', type: 'string', required: true }, + { key: 'value', label: '属性值', type: 'string' }, + { key: 'remove', label: '移除属性', type: 'boolean', default: false }, + ], + defaults: { remove: false }, + }); + + // LoopElements + registerNodeSpec({ + type: STEP_TYPES.LOOP_ELEMENTS, + version: 1, + display: { label: '循环元素', iconClass: 'icon-loop', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'selector', label: '选择器', type: 'string', required: true }, + { key: 'saveAs', label: '列表变量名', type: 'string', default: 'elements' }, + { key: 'itemVar', label: '项变量名', type: 'string', default: 'item' }, + { key: 'subflowId', label: '子流程ID', type: 'string', required: true }, + ], + defaults: { saveAs: 'elements', itemVar: 'item' }, + }); + + // SwitchFrame + registerNodeSpec({ + type: STEP_TYPES.SWITCH_FRAME, + version: 1, + display: { label: '切换Frame', iconClass: 'icon-frame', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'frame', + label: 'frame定位', + type: 'object', + fields: [ + { key: 'index', label: '索引', type: 'number' }, + { key: 'urlContains', label: 'URL包含', type: 'string' }, + ], + }, + ], + defaults: {}, + }); + + // HandleDownload + registerNodeSpec({ + type: STEP_TYPES.HANDLE_DOWNLOAD, + version: 1, + display: { label: '下载处理', iconClass: 'icon-download', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'filenameContains', label: '文件名包含', type: 'string' }, + { key: 'waitForComplete', label: '等待完成', type: 'boolean', default: true }, + { key: 'timeoutMs', label: '超时(ms)', type: 'number', default: 60000 }, + { key: 'saveAs', label: '保存变量', type: 'string' }, + ], + defaults: { waitForComplete: true, timeoutMs: 60000 }, + }); + + // Script + registerNodeSpec({ + type: STEP_TYPES.SCRIPT, + version: 1, + display: { label: '脚本', iconClass: 'icon-script', category: 'Tools' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'world', + label: '执行上下文', + type: 'select', + options: [ + { label: 'ISOLATED', value: 'ISOLATED' }, + { label: 'MAIN', value: 'MAIN' }, + ] as any, + default: 'ISOLATED', + }, + { key: 'code', label: '脚本代码', type: 'string', widget: 'code', required: true }, + { + key: 'when', + label: '执行时机', + type: 'select', + options: [ + { label: 'before', value: 'before' }, + { label: 'after', value: 'after' }, + ] as any, + default: 'after', + }, + { key: 'assign', label: '映射(JSON)', type: 'json' }, + { key: 'saveAs', label: '保存变量', type: 'string' }, + ], + defaults: { world: 'ISOLATED', when: 'after' }, + }); + + // Tabs + registerNodeSpec({ + type: STEP_TYPES.OPEN_TAB, + version: 1, + display: { label: '打开标签', iconClass: 'icon-openTab', category: 'Tabs' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'url', label: 'URL', type: 'string' }, + { key: 'newWindow', label: '新窗口', type: 'boolean', default: false }, + ], + defaults: { newWindow: false }, + }); + registerNodeSpec({ + type: 'executeFlow' as any, + version: 1, + display: { label: '执行子流程', iconClass: 'icon-exec', category: 'Flow' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'flowId', label: '流程ID', type: 'string', required: true }, + { key: 'inline', label: '内联执行', type: 'boolean', default: false }, + { key: 'args', label: '参数(JSON)', type: 'json' }, + ], + defaults: { inline: false }, + }); + registerNodeSpec({ + type: STEP_TYPES.SWITCH_TAB, + version: 1, + display: { label: '切换标签', iconClass: 'icon-switchTab', category: 'Tabs' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'tabId', label: 'TabId', type: 'number' }, + { key: 'urlContains', label: 'URL包含', type: 'string' }, + { key: 'titleContains', label: '标题包含', type: 'string' }, + ], + defaults: {}, + }); + registerNodeSpec({ + type: STEP_TYPES.CLOSE_TAB, + version: 1, + display: { label: '关闭标签', iconClass: 'icon-closeTab', category: 'Tabs' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'tabIds', + label: 'TabIds', + type: 'array', + item: { key: 'id', label: 'id', type: 'number' } as any, + }, + { key: 'url', label: 'URL', type: 'string' }, + ], + defaults: {}, + }); + + // Logic + registerNodeSpec({ + type: STEP_TYPES.IF, + version: 1, + display: { label: '条件', iconClass: 'icon-if', category: 'Logic' }, + ports: { inputs: 1, outputs: 'any' }, + schema: [ + { + key: 'condition', + label: '条件表达式(JSON)', + type: 'json', + help: '如 {"expression":"vars.a>0"} 等', + }, + { + key: 'branches', + label: '分支', + type: 'array', + item: { + key: 'b', + label: 'case', + type: 'object', + fields: [ + { key: 'id', label: 'ID', type: 'string' }, + { key: 'name', label: '名称', type: 'string' }, + { key: 'expr', label: '表达式', type: 'string' }, + ], + } as any, + }, + { key: 'else', label: '启用 else', type: 'boolean', default: true }, + ], + defaults: { else: true }, + }); + registerNodeSpec({ + type: STEP_TYPES.FOREACH, + version: 1, + display: { label: '循环', iconClass: 'icon-foreach', category: 'Logic' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'listVar', label: '列表变量', type: 'string', required: true }, + { key: 'itemVar', label: '项变量', type: 'string', default: 'item' }, + { key: 'subflowId', label: '子流程ID', type: 'string', required: true }, + { + key: 'concurrency', + label: '并发数', + type: 'number', + default: 1, + help: '并发执行子流程（浅拷贝变量，不自动合并）', + }, + ], + defaults: { itemVar: 'item' }, + }); + registerNodeSpec({ + type: STEP_TYPES.WHILE, + version: 1, + display: { label: '循环', iconClass: 'icon-while', category: 'Logic' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'condition', label: '条件(JSON)', type: 'json' }, + { key: 'subflowId', label: '子流程ID', type: 'string', required: true }, + { key: 'maxIterations', label: '最大次数', type: 'number', default: 100 }, + ], + defaults: { maxIterations: 100 }, + }); + + // Delay (UI-only helper) + registerNodeSpec({ + type: STEP_TYPES.DELAY, + version: 1, + display: { label: '延迟', iconClass: 'icon-delay', category: 'Actions' }, + ports: { inputs: 1, outputs: [{ label: 'default' }] }, + schema: [ + { + key: 'sleep', + label: '延迟', + type: 'number', + widget: 'duration', + required: true, + default: 1000, + }, + ], + defaults: { sleep: 1000 }, + }); + + // Trigger (builder-only, flow-level node) + registerNodeSpec({ + type: STEP_TYPES.TRIGGER, + version: 1, + display: { label: '触发器', iconClass: 'icon-trigger', category: 'Flow' }, + ports: { inputs: 0, outputs: [{ label: 'default' }] }, + schema: [ + { key: 'enabled', label: '启用', type: 'boolean', default: true }, + { key: 'description', label: '描述', type: 'string' }, + { + key: 'modes', + label: '模式', + type: 'object', + fields: [ + { key: 'manual', label: '手动', type: 'boolean', default: true }, + { key: 'url', label: 'URL 触发', type: 'boolean', default: false }, + { key: 'contextMenu', label: '右键菜单', type: 'boolean', default: false }, + { key: 'command', label: '快捷键', type: 'boolean', default: false }, + { key: 'dom', label: 'DOM 事件', type: 'boolean', default: false }, + { key: 'schedule', label: '定时', type: 'boolean', default: false }, + ], + }, + { + key: 'url', + label: 'URL 规则', + type: 'object', + fields: [ + { + key: 'rules', + label: '规则列表', + type: 'array', + item: { + key: 'rule', + label: '规则', + type: 'object', + fields: [ + { + key: 'kind', + label: '类型', + type: 'select', + options: [ + { label: 'URL', value: 'url' }, + { label: '域名', value: 'domain' }, + { label: '路径', value: 'path' }, + ] as any, + default: 'url', + }, + { key: 'value', label: '值', type: 'string' }, + ], + } as any, + }, + ], + }, + { + key: 'contextMenu', + label: '右键菜单', + type: 'object', + fields: [ + { key: 'title', label: '标题', type: 'string', default: '运行工作流' }, + { key: 'enabled', label: '启用', type: 'boolean', default: false }, + ], + }, + { + key: 'command', + label: '快捷键', + type: 'object', + fields: [ + { key: 'commandKey', label: '快捷键', type: 'string' }, + { key: 'enabled', label: '启用', type: 'boolean', default: false }, + ], + }, + { + key: 'dom', + label: 'DOM 事件', + type: 'object', + fields: [ + { key: 'selector', label: '选择器', type: 'string' }, + { key: 'appear', label: '出现', type: 'boolean', default: true }, + { key: 'once', label: '一次', type: 'boolean', default: true }, + { key: 'debounceMs', label: '防抖(ms)', type: 'number', default: 800 }, + { key: 'enabled', label: '启用', type: 'boolean', default: false }, + ], + }, + { + key: 'schedules', + label: '定时', + type: 'array', + item: { + key: 'sched', + label: '计划', + type: 'object', + fields: [ + { key: 'id', label: 'ID', type: 'string' }, + { + key: 'type', + label: '类型', + type: 'select', + options: [ + { label: '一次', value: 'once' }, + { label: '间隔', value: 'interval' }, + { label: '每日', value: 'daily' }, + ] as any, + }, + { key: 'when', label: '时间(ISO/cron)', type: 'string' }, + { key: 'enabled', label: '启用', type: 'boolean', default: true }, + ], + } as any, + }, + ], + defaults: { enabled: true }, + }); +} diff --git a/packages/shared/src/rr-graph.ts b/packages/shared/src/rr-graph.ts new file mode 100644 index 00000000..8c560494 --- /dev/null +++ b/packages/shared/src/rr-graph.ts @@ -0,0 +1,336 @@ +// rr-graph.ts — shared DAG helpers for Record & Replay +// Note: keep types lightweight to avoid cross-package coupling +// Centralize step type strings and tiny helpers here to avoid magic literals. + +import { EDGE_LABELS, type EdgeLabel } from './labels'; + +export interface RRNode { + id: string; + type: string; + config?: Record; +} +export interface RREdge { + id: string; + from: string; + to: string; + label?: EdgeLabel; +} + +// Centralized step type strings (kept in shared to avoid duplication) +export const RR_STEP_TYPES = { + CLICK: 'click', + DBLCLICK: 'dblclick', + FILL: 'fill', + DRAG: 'drag', + KEY: 'key', + WAIT: 'wait', + ASSERT: 'assert', + IF: 'if', + FOREACH: 'foreach', + WHILE: 'while', + NAVIGATE: 'navigate', + SCRIPT: 'script', + HTTP: 'http', + EXTRACT: 'extract', + SCREENSHOT: 'screenshot', + SCROLL: 'scroll', + TRIGGER_EVENT: 'triggerEvent', + SET_ATTRIBUTE: 'setAttribute', + LOOP_ELEMENTS: 'loopElements', + SWITCH_FRAME: 'switchFrame', + OPEN_TAB: 'openTab', + SWITCH_TAB: 'switchTab', + CLOSE_TAB: 'closeTab', + EXECUTE_FLOW: 'executeFlow', + HANDLE_DOWNLOAD: 'handleDownload', + // UI-only, mapped to WAIT + DELAY: 'delay', +} as const; +export type RRStepType = (typeof RR_STEP_TYPES)[keyof typeof RR_STEP_TYPES]; + +function ensureTarget(t: any) { + return t && typeof t === 'object' ? t : { candidates: [] }; +} + +// Topological order using Kahn's algorithm; edges considered as-is (caller may pre-filter labels) +export function topoOrder(nodes: T[], edges: RREdge[]): T[] { + const id2n = new Map(nodes.map((n) => [n.id, n] as const)); + const indeg = new Map(nodes.map((n) => [n.id, 0] as const)); + for (const e of edges) indeg.set(e.to, (indeg.get(e.to) || 0) + 1); + const nexts = new Map(nodes.map((n) => [n.id, [] as string[]] as const)); + for (const e of edges) nexts.get(e.from)!.push(e.to); + const q: string[] = nodes.filter((n) => (indeg.get(n.id) || 0) === 0).map((n) => n.id); + const out: T[] = []; + while (q.length) { + const id = q.shift()!; + const n = id2n.get(id); + if (!n) continue; + out.push(n as T); + for (const v of nexts.get(id)!) { + indeg.set(v, (indeg.get(v) || 0) - 1); + if ((indeg.get(v) || 0) === 0) q.push(v); + } + } + return out.length === nodes.length ? out : nodes.slice(); +} + +// Map a Node (Flow V2) to a linear Step (Flow V1) +export function mapNodeToStep(node: RRNode): any { + const c: any = node.config || {}; + const base = { id: node.id } as any; + // Config-driven generic mapping (prefer this path) + try { + const type = String(node.type); + // UI-only helper: delay -> wait.sleep + if (type === 'delay') { + const sleep = Number((c as any).sleep ?? (c as any).ms ?? 1000); + return { ...base, type: 'wait', condition: { sleep: Math.max(0, sleep) } }; + } + const step: any = { ...base, type, ...c }; + if (step.target) step.target = ensureTarget(step.target); + if (step.start) step.start = ensureTarget(step.start); + if (step.end) step.end = ensureTarget(step.end); + return step; + } catch {} + switch (node.type) { + case RR_STEP_TYPES.CLICK: + case RR_STEP_TYPES.DBLCLICK: + return { + ...base, + type: node.type, + target: ensureTarget(c.target), + before: c.before, + after: c.after, + }; + case RR_STEP_TYPES.FILL: + return { + ...base, + type: RR_STEP_TYPES.FILL, + target: ensureTarget(c.target), + value: c.value || '', + }; + case RR_STEP_TYPES.DRAG: + return { + ...base, + type: RR_STEP_TYPES.DRAG, + start: ensureTarget(c.start), + end: ensureTarget(c.end), + path: Array.isArray(c.path) ? c.path : undefined, + }; + case RR_STEP_TYPES.KEY: + return { ...base, type: RR_STEP_TYPES.KEY, keys: c.keys || '' }; + case RR_STEP_TYPES.WAIT: + return { + ...base, + type: RR_STEP_TYPES.WAIT, + condition: c.condition || { text: '', appear: true }, + }; + case RR_STEP_TYPES.ASSERT: + return { + ...base, + type: RR_STEP_TYPES.ASSERT, + assert: c.assert || { exists: '' }, + failStrategy: c.failStrategy, + }; + case RR_STEP_TYPES.IF: + return { ...base, type: RR_STEP_TYPES.IF, condition: c.condition || {} }; + case RR_STEP_TYPES.FOREACH: + return { + ...base, + type: RR_STEP_TYPES.FOREACH, + listVar: c.listVar || '', + itemVar: c.itemVar || 'item', + subflowId: c.subflowId || '', + }; + case RR_STEP_TYPES.WHILE: + return { + ...base, + type: RR_STEP_TYPES.WHILE, + condition: c.condition || {}, + subflowId: c.subflowId || '', + maxIterations: Math.max(0, Number(c.maxIterations ?? 100)), + }; + case RR_STEP_TYPES.NAVIGATE: + return { ...base, type: RR_STEP_TYPES.NAVIGATE, url: c.url || '' }; + case RR_STEP_TYPES.SCRIPT: + return { + ...base, + type: RR_STEP_TYPES.SCRIPT, + world: c.world || 'ISOLATED', + code: c.code || '', + when: c.when, + }; + case RR_STEP_TYPES.DELAY: // map to wait.sleep to avoid navigation confusion + return { + ...base, + type: RR_STEP_TYPES.WAIT, + condition: { sleep: Math.max(0, Number(c.ms ?? 1000)) }, + }; + case RR_STEP_TYPES.HTTP: + return { + ...base, + type: RR_STEP_TYPES.HTTP, + method: c.method || 'GET', + url: c.url || '', + headers: c.headers || {}, + body: c.body, + formData: c.formData, + saveAs: c.saveAs || '', + }; + case RR_STEP_TYPES.EXTRACT: + return { + ...base, + type: RR_STEP_TYPES.EXTRACT, + selector: c.selector || '', + attr: c.attr || 'text', + js: c.js || '', + saveAs: c.saveAs || '', + }; + case RR_STEP_TYPES.SCREENSHOT: + return { + ...base, + type: RR_STEP_TYPES.SCREENSHOT, + selector: c.selector || '', + fullPage: !!c.fullPage, + saveAs: c.saveAs || '', + }; + case RR_STEP_TYPES.SCROLL: + return { + ...base, + type: RR_STEP_TYPES.SCROLL, + mode: c.mode || 'offset', + target: ensureTarget(c.target), + offset: c.offset || { x: 0, y: 300 }, + }; + case RR_STEP_TYPES.TRIGGER_EVENT: + return { + ...base, + type: RR_STEP_TYPES.TRIGGER_EVENT, + target: ensureTarget(c.target), + event: c.event || 'input', + bubbles: c.bubbles !== false, + cancelable: !!c.cancelable, + }; + case RR_STEP_TYPES.SET_ATTRIBUTE: + return { + ...base, + type: RR_STEP_TYPES.SET_ATTRIBUTE, + target: ensureTarget(c.target), + name: c.name || '', + value: c.value, + remove: !!c.remove, + }; + case RR_STEP_TYPES.LOOP_ELEMENTS: + return { + ...base, + type: RR_STEP_TYPES.LOOP_ELEMENTS, + selector: c.selector || '', + saveAs: c.saveAs || 'elements', + itemVar: c.itemVar || 'item', + subflowId: c.subflowId || '', + }; + case RR_STEP_TYPES.SWITCH_FRAME: + return { + ...base, + type: RR_STEP_TYPES.SWITCH_FRAME, + frame: { + index: c.frame && c.frame.index != null ? Number(c.frame.index) : undefined, + urlContains: c.frame?.urlContains || '', + }, + }; + case RR_STEP_TYPES.OPEN_TAB: + return { ...base, type: RR_STEP_TYPES.OPEN_TAB, url: c.url || '', newWindow: !!c.newWindow }; + case RR_STEP_TYPES.SWITCH_TAB: + return { + ...base, + type: RR_STEP_TYPES.SWITCH_TAB, + tabId: c.tabId || undefined, + urlContains: c.urlContains || '', + titleContains: c.titleContains || '', + }; + case RR_STEP_TYPES.CLOSE_TAB: + return { + ...base, + type: RR_STEP_TYPES.CLOSE_TAB, + tabIds: Array.isArray(c.tabIds) ? c.tabIds : undefined, + url: c.url || '', + }; + case RR_STEP_TYPES.EXECUTE_FLOW: + return { + ...base, + type: RR_STEP_TYPES.EXECUTE_FLOW, + flowId: c.flowId || '', + inline: c.inline !== false, + args: c.args || {}, + }; + case RR_STEP_TYPES.HANDLE_DOWNLOAD: + return { + ...base, + type: RR_STEP_TYPES.HANDLE_DOWNLOAD, + filenameContains: c.filenameContains || '', + waitForComplete: c.waitForComplete !== false, + timeoutMs: Math.max(0, Number(c.timeoutMs ?? 60000)), + saveAs: c.saveAs || '', + }; + default: + return { ...base, type: RR_STEP_TYPES.SCRIPT, world: 'ISOLATED', code: '' }; + } +} + +export function nodesToSteps(nodes: RRNode[], edges: RREdge[]): any[] { + const order = edges && edges.length ? topoOrder(nodes, edges) : nodes.slice(); + return order.map((n) => mapNodeToStep(n)); +} + +// Reverse mapping (Step -> Node config) +export function mapStepToNodeConfig(step: unknown): Record { + if (!step || typeof step !== 'object') return {}; + const src = step as Record; + const out: Record = {}; + for (const [k, v] of Object.entries(src)) { + if (k === 'id' || k === 'type') continue; + out[k] = v; + } + const target = out['target']; + if (target) out['target'] = ensureTarget(target); + const start = out['start']; + if (start) out['start'] = ensureTarget(start); + const end = out['end']; + if (end) out['end'] = ensureTarget(end); + return out; +} + +export function stepsToNodes(steps: ReadonlyArray): RRNode[] { + const arr: RRNode[] = []; + steps.forEach((step, i) => { + const obj: Record = + step && typeof step === 'object' ? (step as Record) : {}; + const idValue = obj['id']; + const typeValue = obj['type']; + const id = typeof idValue === 'string' && idValue ? idValue : `n_${i}`; + const type = typeof typeValue === 'string' && typeValue ? typeValue : RR_STEP_TYPES.SCRIPT; + arr.push({ id, type, config: mapStepToNodeConfig(step) }); + }); + return arr; +} + +/** + * Convert linear steps array to DAG format (nodes + edges). + * Generates sequential edges connecting nodes in order. + */ +export function stepsToDAG(steps: ReadonlyArray): { nodes: RRNode[]; edges: RREdge[] } { + const nodes = stepsToNodes(steps); + const edges: RREdge[] = []; + for (let i = 0; i < nodes.length - 1; i++) { + const from = nodes[i].id; + const to = nodes[i + 1].id; + // Include index in edge id to avoid collision when step ids repeat + edges.push({ + id: `e_${i}_${from}_${to}`, + from, + to, + label: EDGE_LABELS.DEFAULT, + }); + } + return { nodes, edges }; +} diff --git a/packages/shared/src/step-types.ts b/packages/shared/src/step-types.ts new file mode 100644 index 00000000..9ff9039b --- /dev/null +++ b/packages/shared/src/step-types.ts @@ -0,0 +1,34 @@ +// step-types.ts — centralized step type constants for UI + runtime + +export const STEP_TYPES = { + CLICK: 'click', + DBLCLICK: 'dblclick', + FILL: 'fill', + TRIGGER_EVENT: 'triggerEvent', + SET_ATTRIBUTE: 'setAttribute', + SCREENSHOT: 'screenshot', + SWITCH_FRAME: 'switchFrame', + LOOP_ELEMENTS: 'loopElements', + KEY: 'key', + SCROLL: 'scroll', + DRAG: 'drag', + WAIT: 'wait', + ASSERT: 'assert', + SCRIPT: 'script', + IF: 'if', + FOREACH: 'foreach', + WHILE: 'while', + NAVIGATE: 'navigate', + HTTP: 'http', + EXTRACT: 'extract', + OPEN_TAB: 'openTab', + SWITCH_TAB: 'switchTab', + CLOSE_TAB: 'closeTab', + HANDLE_DOWNLOAD: 'handleDownload', + EXECUTE_FLOW: 'executeFlow', + // UI-only helpers + TRIGGER: 'trigger', + DELAY: 'delay', +} as const; + +export type StepTypeConst = (typeof STEP_TYPES)[keyof typeof STEP_TYPES]; diff --git a/packages/shared/src/tools.ts b/packages/shared/src/tools.ts index 9180aa02..bc5c77ea 100644 --- a/packages/shared/src/tools.ts +++ b/packages/shared/src/tools.ts @@ -8,11 +8,13 @@ export const TOOL_NAMES = { SCREENSHOT: 'chrome_screenshot', CLOSE_TABS: 'chrome_close_tabs', SWITCH_TAB: 'chrome_switch_tab', - GO_BACK_OR_FORWARD: 'chrome_go_back_or_forward', WEB_FETCHER: 'chrome_get_web_content', CLICK: 'chrome_click_element', FILL: 'chrome_fill_or_select', + REQUEST_ELEMENT_SELECTION: 'chrome_request_element_selection', GET_INTERACTIVE_ELEMENTS: 'chrome_get_interactive_elements', + NETWORK_CAPTURE: 'chrome_network_capture', + // Legacy tool names (kept for internal use, not exposed in TOOL_SCHEMAS) NETWORK_CAPTURE_START: 'chrome_network_capture_start', NETWORK_CAPTURE_STOP: 'chrome_network_capture_stop', NETWORK_REQUEST: 'chrome_network_request', @@ -25,8 +27,22 @@ export const TOOL_NAMES = { BOOKMARK_DELETE: 'chrome_bookmark_delete', INJECT_SCRIPT: 'chrome_inject_script', SEND_COMMAND_TO_INJECT_SCRIPT: 'chrome_send_command_to_inject_script', + JAVASCRIPT: 'chrome_javascript', CONSOLE: 'chrome_console', FILE_UPLOAD: 'chrome_upload_file', + READ_PAGE: 'chrome_read_page', + COMPUTER: 'chrome_computer', + HANDLE_DIALOG: 'chrome_handle_dialog', + HANDLE_DOWNLOAD: 'chrome_handle_download', + USERSCRIPT: 'chrome_userscript', + PERFORMANCE_START_TRACE: 'performance_start_trace', + PERFORMANCE_STOP_TRACE: 'performance_stop_trace', + PERFORMANCE_ANALYZE_INSIGHT: 'performance_analyze_insight', + GIF_RECORDER: 'chrome_gif_recorder', + }, + RECORD_REPLAY: { + FLOW_RUN: 'record_replay_flow_run', + LIST_PUBLISHED: 'record_replay_list_published', }, }; @@ -40,214 +56,506 @@ export const TOOL_SCHEMAS: Tool[] = [ required: [], }, }, + // { + // name: TOOL_NAMES.RECORD_REPLAY.FLOW_RUN, + // description: + // 'Run a recorded flow by ID with optional variables and run options. Returns a standardized run result.', + // inputSchema: { + // type: 'object', + // properties: { + // flowId: { type: 'string', description: 'ID of the flow to run' }, + // args: { + // type: 'object', + // description: 'Variable values for the flow (flat object of key/value)', + // }, + // tabTarget: { + // type: 'string', + // description: "Target tab: 'current' or 'new' (default: current)", + // enum: ['current', 'new'], + // }, + // refresh: { type: 'boolean', description: 'Refresh before running (default false)' }, + // captureNetwork: { + // type: 'boolean', + // description: 'Capture network snippets for debugging (default false)', + // }, + // returnLogs: { type: 'boolean', description: 'Return run logs (default false)' }, + // timeoutMs: { type: 'number', description: 'Global timeout in ms (optional)' }, + // startUrl: { type: 'string', description: 'Optional start URL to open before running' }, + // }, + // required: ['flowId'], + // }, + // }, + // { + // name: TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED, + // description: 'List published flows available as dynamic tools (for discovery).', + // inputSchema: { + // type: 'object', + // properties: {}, + // required: [], + // }, + // }, { - name: TOOL_NAMES.BROWSER.NAVIGATE, - description: 'Navigate to a URL or refresh the current tab', + name: TOOL_NAMES.BROWSER.PERFORMANCE_START_TRACE, + description: + 'Starts a performance trace recording on the selected page. Optionally reloads the page and/or auto-stops after a short duration.', inputSchema: { type: 'object', properties: { - url: { type: 'string', description: 'URL to navigate to the website specified' }, - newWindow: { + reload: { type: 'boolean', - description: 'Create a new window to navigate to the URL or not. Defaults to false', + description: + 'Determines if, once tracing has started, the page should be automatically reloaded (ignore cache).', }, - width: { type: 'number', description: 'Viewport width in pixels (default: 1280)' }, - height: { type: 'number', description: 'Viewport height in pixels (default: 720)' }, - refresh: { + autoStop: { type: 'boolean', - description: - 'Refresh the current active tab instead of navigating to a URL. When true, the url parameter is ignored. Defaults to false', + description: 'Determines if the trace should be automatically stopped (default false).', + }, + durationMs: { + type: 'number', + description: 'Auto-stop duration in milliseconds when autoStop is true (default 5000).', }, }, required: [], }, }, { - name: TOOL_NAMES.BROWSER.SCREENSHOT, - description: - 'Take a screenshot of the current page or a specific element(if you want to see the page, recommend to use chrome_get_web_content first)', + name: TOOL_NAMES.BROWSER.PERFORMANCE_STOP_TRACE, + description: 'Stops the active performance trace recording on the selected page.', inputSchema: { type: 'object', properties: { - name: { type: 'string', description: 'Name for the screenshot, if saving as PNG' }, - selector: { type: 'string', description: 'CSS selector for element to screenshot' }, - width: { type: 'number', description: 'Width in pixels (default: 800)' }, - height: { type: 'number', description: 'Height in pixels (default: 600)' }, - storeBase64: { - type: 'boolean', - description: - 'return screenshot in base64 format (default: false) if you want to see the page, recommend set this to be true', - }, - fullPage: { + saveToDownloads: { type: 'boolean', - description: 'Store screenshot of the entire page (default: true)', + description: 'Whether to save the trace as a JSON file in Downloads (default true).', }, - savePng: { - type: 'boolean', - description: - 'Save screenshot as PNG file (default: true)，if you want to see the page, recommend set this to be false, and set storeBase64 to be true', + filenamePrefix: { + type: 'string', + description: 'Optional filename prefix for the downloaded trace JSON.', }, }, required: [], }, }, { - name: TOOL_NAMES.BROWSER.CLOSE_TABS, - description: 'Close one or more browser tabs', + name: TOOL_NAMES.BROWSER.PERFORMANCE_ANALYZE_INSIGHT, + description: + 'Provides a lightweight summary of the last recorded trace. For deep insights (CWV, breakdowns), integrate native-side DevTools trace engine.', inputSchema: { type: 'object', properties: { - tabIds: { - type: 'array', - items: { type: 'number' }, - description: 'Array of tab IDs to close. If not provided, will close the active tab.', - }, - url: { + insightName: { type: 'string', - description: 'Close tabs matching this URL. Can be used instead of tabIds.', + description: + 'Optional insight name for future deep analysis (e.g., "DocumentLatency"). Currently informational only.', + }, + timeoutMs: { + type: 'number', + description: + 'Timeout for deep analysis via native host (milliseconds). Default 60000. Increase for large traces.', }, }, required: [], }, }, { - name: TOOL_NAMES.BROWSER.SWITCH_TAB, - description: 'Switch to a specific browser tab', + name: TOOL_NAMES.BROWSER.READ_PAGE, + description: + 'Get an accessibility tree representation of visible elements on the page. Only returns elements that are visible in the viewport. Optionally filter for only interactive elements.\nTip: If the returned elements do not include the specific element you need, use the computer tool\'s screenshot (action="screenshot") to capture the element\'s on-screen coordinates, then operate by coordinates.', inputSchema: { type: 'object', properties: { + filter: { + type: 'string', + description: + 'Filter elements: "interactive" for such as buttons/links/inputs only (default: all visible elements)', + }, + depth: { + type: 'number', + description: + 'Maximum DOM depth to traverse (integer >= 0). Lower values reduce output size and can improve performance.', + }, + refId: { + type: 'string', + description: + 'Focus on the subtree rooted at this element refId (e.g., "ref_12"). The refId must come from a recent chrome_read_page response in the same tab (refs may expire).', + }, tabId: { type: 'number', - description: 'The ID of the tab to switch to.', + description: 'Target an existing tab by ID (default: active tab).', }, windowId: { type: 'number', - description: 'The ID of the window where the tab is located.', + description: 'Target window ID to pick active tab when tabId is omitted.', }, }, - required: ['tabId'], + required: [], }, }, { - name: TOOL_NAMES.BROWSER.GO_BACK_OR_FORWARD, - description: 'Navigate back or forward in browser history', + name: TOOL_NAMES.BROWSER.COMPUTER, + description: + "Use a mouse and keyboard to interact with a web browser, and take screenshots.\n* Whenever you intend to click on an element like an icon, you should consult a read_page to determine the ref of the element before moving the cursor.\n* If you tried clicking on a program or link but it failed to load, even after waiting, try screenshot and then adjusting your click location so that the tip of the cursor visually falls on the element that you want to click.\n* Make sure to click any buttons, links, icons, etc with the cursor tip in the center of the element. Don't click boxes on their edges unless asked.", inputSchema: { type: 'object', properties: { - isForward: { + tabId: { type: 'number', description: 'Target tab ID (default: active tab)' }, + background: { + type: 'boolean', + description: + 'Avoid focusing/activating tab/window for certain operations (best-effort). Default: false', + }, + action: { + type: 'string', + description: + 'Action to perform: left_click | right_click | double_click | triple_click | left_click_drag | scroll | scroll_to | type | key | fill | fill_form | hover | wait | resize_page | zoom | screenshot', + }, + ref: { + type: 'string', + description: + 'Element ref from chrome_read_page. For click/scroll/scroll_to/key/type and drag end when provided; takes precedence over coordinates.', + }, + coordinates: { + type: 'object', + properties: { + x: { type: 'number', description: 'X coordinate' }, + y: { type: 'number', description: 'Y coordinate' }, + }, + description: + 'Coordinates for actions (in screenshot space if a recent screenshot was taken, otherwise viewport). Required for click/scroll and as end point for drag.', + }, + startCoordinates: { + type: 'object', + properties: { + x: { type: 'number' }, + y: { type: 'number' }, + }, + description: 'Starting coordinates for drag action', + }, + startRef: { + type: 'string', + description: 'Drag start ref from chrome_read_page (alternative to startCoordinates).', + }, + scrollDirection: { + type: 'string', + description: 'Scroll direction: up | down | left | right', + }, + scrollAmount: { + type: 'number', + description: 'Scroll ticks (1-10), default 3', + }, + text: { + type: 'string', + description: + 'Text to type (for action=type) or keys/chords separated by space (for action=key, e.g. "Backspace Enter" or "cmd+a")', + }, + repeat: { + type: 'number', + description: + 'For action=key: number of times to repeat the key sequence (integer 1-100, default 1).', + }, + modifiers: { + type: 'object', + description: + 'Modifier keys for click actions (left_click/right_click/double_click/triple_click).', + properties: { + altKey: { type: 'boolean' }, + ctrlKey: { type: 'boolean' }, + metaKey: { type: 'boolean' }, + shiftKey: { type: 'boolean' }, + }, + }, + region: { + type: 'object', + description: + 'For action=zoom: rectangular region to capture (x0,y0)-(x1,y1) in viewport pixels (or screenshot-space if a recent screenshot context exists).', + properties: { + x0: { type: 'number' }, + y0: { type: 'number' }, + x1: { type: 'number' }, + y1: { type: 'number' }, + }, + required: ['x0', 'y0', 'x1', 'y1'], + }, + // For action=fill + selector: { + type: 'string', + description: 'CSS selector for fill (alternative to ref).', + }, + value: { + oneOf: [{ type: 'string' }, { type: 'boolean' }, { type: 'number' }], + description: 'Value to set for action=fill (string | boolean | number)', + }, + elements: { + type: 'array', + description: 'For action=fill_form: list of elements to fill (ref + value)', + items: { + type: 'object', + properties: { + ref: { type: 'string', description: 'Element ref from chrome_read_page' }, + value: { type: 'string', description: 'Value to set (stringified if non-string)' }, + }, + required: ['ref', 'value'], + }, + }, + width: { type: 'number', description: 'For action=resize_page: viewport width' }, + height: { type: 'number', description: 'For action=resize_page: viewport height' }, + appear: { type: 'boolean', - description: 'Go forward in history if true, go back if false (default: false)', + description: + 'For action=wait with text: whether to wait for the text to appear (true, default) or disappear (false)', + }, + timeout: { + type: 'number', + description: + 'For action=wait with text: timeout in milliseconds (default 10000, max 120000)', + }, + duration: { + type: 'number', + description: 'Seconds to wait for action=wait (max 30s)', }, }, - required: [], + required: ['action'], }, }, + // { + // name: TOOL_NAMES.BROWSER.USERSCRIPT, + // description: + // 'Unified userscript tool (create/list/get/enable/disable/update/remove/send_command/export). Paste JS/CSS/Tampermonkey script and the system will auto-select the best strategy (insertCSS / persistent script in ISOLATED or MAIN world / once by CDP) with CSP-aware fallbacks.', + // inputSchema: { + // type: 'object', + // properties: { + // action: { + // type: 'string', + // description: + // 'Operation to perform', + // enum: [ + // 'create', + // 'list', + // 'get', + // 'enable', + // 'disable', + // 'update', + // 'remove', + // 'send_command', + // 'export', + // ], + // }, + // args: { + // type: 'object', + // description: + // 'Arguments for the specified action.\n- create: { script (required), name?, description?, matches?: string[], excludes?: string[], persist?: boolean (default true), runAt?: "document_start"|"document_end"|"document_idle"|"auto", world?: "auto"|"ISOLATED"|"MAIN", allFrames?: boolean (default true), mode?: "auto"|"css"|"persistent"|"once", dnrFallback?: boolean (default true), tags?: string[] }\n- list: { query?: string, status?: "enabled"|"disabled", domain?: string }\n- get: { id (required) }\n- enable/disable: { id (required) }\n- update: { id (required), script?, name?, description?, matches?, excludes?, runAt?, world?, allFrames?, persist?, dnrFallback?, tags? }\n- remove: { id (required) }\n- send_command: { id (required), payload?: string, tabId?: number }\n- export: {}\nTip: For a one-off execution that returns a value, use create with args.mode="once". The returned value is included as onceResult in the tool response.', + // properties: { + // // Common identifiers + // id: { type: 'string', description: 'Userscript id (for get/enable/disable/update/remove/send_command)' }, + // // Create / Update fields + // script: { type: 'string', description: 'JS/CSS/Tampermonkey script source (required for create)' }, + // name: { type: 'string', description: 'Userscript name (optional)' }, + // description: { type: 'string', description: 'Userscript description (optional)' }, + // matches: { + // type: 'array', + // items: { type: 'string' }, + // description: 'Match patterns for pages to apply to (e.g., https://*.example.com/*)' + // }, + // excludes: { + // type: 'array', + // items: { type: 'string' }, + // description: 'Exclude patterns' + // }, + // persist: { type: 'boolean', description: 'Persist userscript for matched pages (default true)' }, + // runAt: { + // type: 'string', + // description: 'Injection timing', + // enum: ['document_start', 'document_end', 'document_idle', 'auto'], + // }, + // world: { + // type: 'string', + // description: 'Execution world', + // enum: ['auto', 'ISOLATED', 'MAIN'], + // }, + // allFrames: { type: 'boolean', description: 'Inject into all frames (default true)' }, + // mode: { + // type: 'string', + // description: + // 'Injection strategy: auto | css | persistent | once. Use once to evaluate immediately (no persistence) and include the return value in onceResult.', + // enum: ['auto', 'css', 'persistent', 'once'], + // }, + // dnrFallback: { type: 'boolean', description: 'Use DNR fallback when needed (default true)' }, + // tags: { type: 'array', items: { type: 'string' }, description: 'Custom tags' }, + // // List filters + // query: { type: 'string', description: 'Search by name/description (list action)' }, + // status: { type: 'string', enum: ['enabled', 'disabled'], description: 'Filter by status (list action)' }, + // domain: { type: 'string', description: 'Filter by domain (list action)' }, + // // Send command + // payload: { type: 'string', description: 'Arbitrary payload (stringified) for send_command' }, + // tabId: { type: 'number', description: 'Target tab for send_command (default active tab)' }, + // }, + // }, + // }, + // required: ['action'], + // }, + // }, { - name: TOOL_NAMES.BROWSER.WEB_FETCHER, - description: 'Fetch content from a web page', + name: TOOL_NAMES.BROWSER.NAVIGATE, + description: + 'Navigate to a URL, refresh the current tab, or navigate browser history (back/forward)', inputSchema: { type: 'object', properties: { url: { type: 'string', - description: 'URL to fetch content from. If not provided, uses the current active tab', + description: + 'URL to navigate to. Special values: "back" or "forward" to navigate browser history in the target tab.', }, - htmlContent: { + newWindow: { type: 'boolean', + description: 'Create a new window to navigate to the URL or not. Defaults to false', + }, + tabId: { + type: 'number', description: - 'Get the visible HTML content of the page. If true, textContent will be ignored (default: false)', + 'Target an existing tab by ID (if provided, navigate/refresh/back/forward that tab instead of the active tab).', }, - textContent: { + windowId: { + type: 'number', + description: + 'Target an existing window by ID (when creating a new tab in existing window, or picking active tab if tabId is not provided).', + }, + background: { type: 'boolean', description: - 'Get the visible text content of the page with metadata. Ignored if htmlContent is true (default: true)', + 'Perform the operation without stealing focus (do not activate the tab or focus the window). Default: false', }, - - selector: { - type: 'string', + width: { + type: 'number', description: - 'CSS selector to get content from a specific element. If provided, only content from this element will be returned', + 'Window width in pixels (default: 1280). When width or height is provided, a new window will be created.', + }, + height: { + type: 'number', + description: + 'Window height in pixels (default: 720). When width or height is provided, a new window will be created.', + }, + refresh: { + type: 'boolean', + description: + 'Refresh the current active tab instead of navigating to a URL. When true, the url parameter is ignored. Defaults to false', }, }, required: [], }, }, { - name: TOOL_NAMES.BROWSER.CLICK, - description: 'Click on an element in the current page or at specific coordinates', + name: TOOL_NAMES.BROWSER.SCREENSHOT, + description: + '[Prefer read_page over taking a screenshot and Prefer chrome_computer] Take a screenshot of the current page or a specific element. For new usage, use chrome_computer with action="screenshot". Use this tool if you need advanced options.', inputSchema: { type: 'object', properties: { - selector: { - type: 'string', + name: { type: 'string', description: 'Name for the screenshot, if saving as PNG' }, + selector: { type: 'string', description: 'CSS selector for element to screenshot' }, + tabId: { + type: 'number', + description: 'Target tab ID to capture from (default: active tab).', + }, + windowId: { + type: 'number', + description: 'Target window ID to pick active tab from when tabId is not provided.', + }, + background: { + type: 'boolean', description: - 'CSS selector for the element to click. Either selector or coordinates must be provided. if coordinates are not provided, the selector must be provided.', + 'Attempt capture without bringing tab/window to foreground. CDP-based capture is used for simple viewport captures. For element/full-page capture, the tab may still be made active in its window without focusing the window. Default: false', }, - coordinates: { - type: 'object', + width: { type: 'number', description: 'Width in pixels (default: 800)' }, + height: { type: 'number', description: 'Height in pixels (default: 600)' }, + storeBase64: { + type: 'boolean', description: - 'Coordinates to click at (relative to viewport). If provided, takes precedence over selector.', - properties: { - x: { - type: 'number', - description: 'X coordinate relative to the viewport', - }, - y: { - type: 'number', - description: 'Y coordinate relative to the viewport', - }, - }, - required: ['x', 'y'], + 'return screenshot in base64 format (default: false) if you want to see the page, recommend set this to be true', }, - waitForNavigation: { + fullPage: { type: 'boolean', - description: 'Wait for page navigation to complete after click (default: false)', + description: 'Store screenshot of the entire page (default: true)', }, - timeout: { - type: 'number', + savePng: { + type: 'boolean', description: - 'Timeout in milliseconds for waiting for the element or navigation (default: 5000)', + 'Save screenshot as PNG file (default: true)，if you want to see the page, recommend set this to be false, and set storeBase64 to be true', }, }, required: [], }, }, { - name: TOOL_NAMES.BROWSER.FILL, - description: 'Fill a form element or select an option with the specified value', + name: TOOL_NAMES.BROWSER.CLOSE_TABS, + description: 'Close one or more browser tabs', inputSchema: { type: 'object', properties: { - selector: { - type: 'string', - description: 'CSS selector for the input element to fill or select', + tabIds: { + type: 'array', + items: { type: 'number' }, + description: 'Array of tab IDs to close. If not provided, will close the active tab.', }, - value: { + url: { type: 'string', - description: 'Value to fill or select into the element', + description: 'Close tabs matching this URL. Can be used instead of tabIds.', }, }, - required: ['selector', 'value'], + required: [], }, }, { - name: TOOL_NAMES.BROWSER.GET_INTERACTIVE_ELEMENTS, - description: 'Get interactive elements from the current page', + name: TOOL_NAMES.BROWSER.SWITCH_TAB, + description: 'Switch to a specific browser tab', inputSchema: { type: 'object', properties: { - textQuery: { - type: 'string', - description: 'Text to search for within interactive elements (fuzzy search)', + tabId: { + type: 'number', + description: 'The ID of the tab to switch to.', }, - selector: { + windowId: { + type: 'number', + description: 'The ID of the window where the tab is located.', + }, + }, + required: ['tabId'], + }, + }, + { + name: TOOL_NAMES.BROWSER.WEB_FETCHER, + description: 'Fetch content from a web page', + inputSchema: { + type: 'object', + properties: { + url: { type: 'string', + description: 'URL to fetch content from. If not provided, uses the current active tab', + }, + tabId: { + type: 'number', + description: 'Target an existing tab by ID (default: active tab).', + }, + background: { + type: 'boolean', + description: 'Do not activate tab/focus window while fetching (default: false)', + }, + htmlContent: { + type: 'boolean', description: - 'CSS selector to filter interactive elements. Takes precedence over textQuery if both are provided.', + 'Get the visible HTML content of the page. If true, textContent will be ignored (default: false)', }, - includeCoordinates: { + textContent: { type: 'boolean', - description: 'Include element coordinates in the response (default: true)', + description: + 'Get the visible text content of the page with metadata. Ignored if htmlContent is true (default: true)', + }, + + selector: { + type: 'string', + description: + 'CSS selector to get content from a specific element. If provided, only content from this element will be returned', }, }, required: [], @@ -279,83 +587,64 @@ export const TOOL_SCHEMAS: Tool[] = [ type: 'number', description: 'Timeout in milliseconds (default: 30000)', }, + formData: { + type: 'object', + description: + 'Multipart/form-data descriptor. If provided, overrides body and builds FormData with optional file attachments. Shape: { fields?: Record, files?: Array<{ name: string, fileUrl?: string, filePath?: string, base64Data?: string, filename?: string, contentType?: string }> }. Also supports a compact array form: [ [name, fileSpec, filename?], ... ] where fileSpec may be url:, file:, or base64:.', + }, }, required: ['url'], }, }, { - name: TOOL_NAMES.BROWSER.NETWORK_DEBUGGER_START, + name: TOOL_NAMES.BROWSER.NETWORK_CAPTURE, description: - 'Start capturing network requests from a web page using Chrome Debugger API（with responseBody）', + 'Unified network capture tool. Use action="start" to begin capturing, action="stop" to end and retrieve results. Set needResponseBody=true to capture response bodies (uses Debugger API, may conflict with DevTools). Default mode uses webRequest API (lightweight, no debugger conflict, but no response body).', inputSchema: { type: 'object', properties: { - url: { + action: { type: 'string', + enum: ['start', 'stop'], + description: 'Action to perform: "start" begins capture, "stop" ends and returns results', + }, + needResponseBody: { + type: 'boolean', description: - 'URL to capture network requests from. If not provided, uses the current active tab', + 'When true, captures response body using Debugger API (default: false). Only use when you need to inspect response content.', }, - }, - required: [], - }, - }, - { - name: TOOL_NAMES.BROWSER.NETWORK_DEBUGGER_STOP, - description: - 'Stop capturing network requests using Chrome Debugger API and return the captured data', - inputSchema: { - type: 'object', - properties: {}, - required: [], - }, - }, - { - name: TOOL_NAMES.BROWSER.NETWORK_CAPTURE_START, - description: - 'Start capturing network requests from a web page using Chrome webRequest API(without responseBody)', - inputSchema: { - type: 'object', - properties: { url: { type: 'string', description: - 'URL to capture network requests from. If not provided, uses the current active tab', + 'URL to capture network requests from. For action="start". If not provided, uses the current active tab.', + }, + maxCaptureTime: { + type: 'number', + description: 'Maximum capture time in milliseconds (default: 180000)', + }, + inactivityTimeout: { + type: 'number', + description: 'Stop after inactivity in milliseconds (default: 60000). Set 0 to disable.', + }, + includeStatic: { + type: 'boolean', + description: 'Include static resources like images/scripts/styles (default: false)', }, }, - required: [], + required: ['action'], }, }, { - name: TOOL_NAMES.BROWSER.NETWORK_CAPTURE_STOP, - description: - 'Stop capturing network requests using webRequest API and return the captured data', - inputSchema: { - type: 'object', - properties: {}, - required: [], - }, - }, - { - name: TOOL_NAMES.BROWSER.KEYBOARD, - description: 'Simulate keyboard events in the browser', + name: TOOL_NAMES.BROWSER.HANDLE_DOWNLOAD, + description: 'Wait for a browser download and return details (id, filename, url, state, size)', inputSchema: { type: 'object', properties: { - keys: { - type: 'string', - description: 'Keys to simulate (e.g., "Enter", "Ctrl+C", "A,B,C" for sequence)', - }, - selector: { - type: 'string', - description: - 'CSS selector for the element to send keyboard events to (optional, defaults to active element)', - }, - delay: { - type: 'number', - description: 'Delay between key sequences in milliseconds (optional, default: 0)', - }, + filenameContains: { type: 'string', description: 'Filter by substring in filename or URL' }, + timeoutMs: { type: 'number', description: 'Timeout in ms (default 60000, max 300000)' }, + waitForComplete: { type: 'boolean', description: 'Wait until completed (default true)' }, }, - required: ['keys'], + required: [], }, }, { @@ -466,74 +755,323 @@ export const TOOL_SCHEMAS: Tool[] = [ required: [], }, }, + // { + // name: TOOL_NAMES.BROWSER.SEARCH_TABS_CONTENT, + // description: + // 'search for related content from the currently open tab and return the corresponding web pages.', + // inputSchema: { + // type: 'object', + // properties: { + // query: { + // type: 'string', + // description: 'the query to search for related content.', + // }, + // }, + // required: ['query'], + // }, + // }, + // { + // name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + // description: + // 'inject the user-specified content script into the webpage. By default, inject into the currently active tab', + // inputSchema: { + // type: 'object', + // properties: { + // url: { + // type: 'string', + // description: + // 'If a URL is specified, inject the script into the webpage corresponding to the URL.', + // }, + // tabId: { + // type: 'number', + // description: + // 'Target an existing tab by ID to inject into. Overrides url/active tab selection when provided.', + // }, + // windowId: { + // type: 'number', + // description: + // 'Target window ID for selecting active tab or creating new tab when url is provided and tabId is omitted.', + // }, + // background: { + // type: 'boolean', + // description: + // 'Do not activate tab/focus window during injection when true (default: false).', + // }, + // type: { + // type: 'string', + // description: + // 'the javaScript world for a script to execute within. must be ISOLATED or MAIN', + // }, + // jsScript: { + // type: 'string', + // description: 'the content script to inject', + // }, + // }, + // required: ['type', 'jsScript'], + // }, + // }, + // { + // name: TOOL_NAMES.BROWSER.SEND_COMMAND_TO_INJECT_SCRIPT, + // description: + // 'if the script injected using chrome_inject_script listens for user-defined events, this tool can be used to trigger those events', + // inputSchema: { + // type: 'object', + // properties: { + // tabId: { + // type: 'number', + // description: + // 'the tab where you previously injected the script(if not provided, use the currently active tab)', + // }, + // eventName: { + // type: 'string', + // description: 'the eventName your injected content script listen for', + // }, + // payload: { + // type: 'string', + // description: 'the payload passed to event, must be a json string', + // }, + // }, + // required: ['eventName'], + // }, + // }, { - name: TOOL_NAMES.BROWSER.SEARCH_TABS_CONTENT, + name: TOOL_NAMES.BROWSER.JAVASCRIPT, description: - 'search for related content from the currently open tab and return the corresponding web pages.', + 'Execute JavaScript code in a browser tab and return the result. Uses CDP Runtime.evaluate with awaitPromise and returnByValue; automatically falls back to chrome.scripting.executeScript if the debugger is busy. Output is sanitized (sensitive data redacted) and truncated by default.', inputSchema: { type: 'object', properties: { - query: { + code: { type: 'string', - description: 'the query to search for related content.', + description: + 'JavaScript code to execute. Runs inside an async function body, so top-level await and "return ..." are supported.', + }, + tabId: { + type: 'number', + description: 'Target tab ID. If omitted, uses the current active tab.', + }, + timeoutMs: { + type: 'number', + description: 'Execution timeout in milliseconds (default: 15000).', + }, + maxOutputBytes: { + type: 'number', + description: + 'Maximum output size in bytes after sanitization (default: 51200). Output exceeding this limit will be truncated.', }, }, - required: ['query'], + required: ['code'], }, }, { - name: TOOL_NAMES.BROWSER.INJECT_SCRIPT, + name: TOOL_NAMES.BROWSER.CLICK, description: - 'inject the user-specified content script into the webpage. By default, inject into the currently active tab', + 'Click on an element in a web page. Supports multiple targeting methods: CSS selector, XPath, element ref (from chrome_read_page), or viewport coordinates. More focused than chrome_computer for simple click operations.', inputSchema: { type: 'object', properties: { - url: { + selector: { type: 'string', - description: - 'If a URL is specified, inject the script into the webpage corresponding to the URL.', + description: 'CSS selector or XPath for the element to click.', }, - type: { + selectorType: { type: 'string', - description: - 'the javaScript world for a script to execute within. must be ISOLATED or MAIN', + enum: ['css', 'xpath'], + description: 'Type of selector (default: "css").', + }, + ref: { + type: 'string', + description: 'Element ref from chrome_read_page (takes precedence over selector).', + }, + coordinates: { + type: 'object', + description: 'Viewport coordinates to click at.', + properties: { + x: { type: 'number' }, + y: { type: 'number' }, + }, + required: ['x', 'y'], }, - jsScript: { + double: { + type: 'boolean', + description: 'Perform double click when true (default: false).', + }, + button: { type: 'string', - description: 'the content script to inject', + enum: ['left', 'right', 'middle'], + description: 'Mouse button to click (default: "left").', + }, + modifiers: { + type: 'object', + description: 'Modifier keys to hold during click.', + properties: { + altKey: { type: 'boolean' }, + ctrlKey: { type: 'boolean' }, + metaKey: { type: 'boolean' }, + shiftKey: { type: 'boolean' }, + }, + }, + waitForNavigation: { + type: 'boolean', + description: 'Wait for navigation to complete after click (default: false).', + }, + timeout: { + type: 'number', + description: 'Timeout in milliseconds for waiting (default: 5000).', + }, + tabId: { + type: 'number', + description: 'Target tab ID. If omitted, uses the current active tab.', + }, + windowId: { + type: 'number', + description: 'Window ID to select active tab from (when tabId is omitted).', + }, + frameId: { + type: 'number', + description: 'Target frame ID for iframe support.', }, }, - required: ['type', 'jsScript'], + required: [], }, }, { - name: TOOL_NAMES.BROWSER.SEND_COMMAND_TO_INJECT_SCRIPT, + name: TOOL_NAMES.BROWSER.FILL, description: - 'if the script injected using chrome_inject_script listens for user-defined events, this tool can be used to trigger those events', + 'Fill or select a form element on a web page. Supports input, textarea, select, checkbox, and radio elements. Use CSS selector, XPath, or element ref to target the element.', inputSchema: { type: 'object', properties: { + selector: { + type: 'string', + description: 'CSS selector or XPath for the form element.', + }, + selectorType: { + type: 'string', + enum: ['css', 'xpath'], + description: 'Type of selector (default: "css").', + }, + ref: { + type: 'string', + description: 'Element ref from chrome_read_page (takes precedence over selector).', + }, + value: { + type: ['string', 'number', 'boolean'], + description: + 'Value to fill. For text inputs: string. For checkboxes/radios: boolean. For selects: option value or text.', + }, tabId: { + type: 'number', + description: 'Target tab ID. If omitted, uses the current active tab.', + }, + windowId: { + type: 'number', + description: 'Window ID to select active tab from (when tabId is omitted).', + }, + frameId: { + type: 'number', + description: 'Target frame ID for iframe support.', + }, + }, + required: ['value'], + }, + }, + { + name: TOOL_NAMES.BROWSER.REQUEST_ELEMENT_SELECTION, + description: + 'Request the user to manually select one or more elements on the current page. Use this as a human-in-the-loop fallback when you cannot reliably locate the target element after approximately 3 attempts using chrome_read_page combined with chrome_click_element/chrome_fill_or_select/chrome_computer. The user will see a panel with instructions and can click on the requested elements. Returns element refs compatible with chrome_click_element/chrome_fill_or_select (including iframe frameId for cross-frame support).', + inputSchema: { + type: 'object', + properties: { + requests: { + type: 'array', + description: + 'A list of element selection requests. Each request produces exactly one picked element. The user will see these requests in a panel and select each element by clicking on the page.', + minItems: 1, + items: { + type: 'object', + properties: { + id: { + type: 'string', + description: + 'Optional stable request id for correlation. If omitted, an id is auto-generated (e.g., "req_1").', + }, + name: { + type: 'string', + description: + 'Short label shown to the user describing what element to select (e.g., "Login button", "Email input field").', + }, + description: { + type: 'string', + description: + 'Optional longer instruction shown to the user with more context (e.g., "Click on the primary login button in the top-right corner").', + }, + }, + required: ['name'], + }, + }, + timeoutMs: { type: 'number', description: - 'the tab where you previously injected the script(if not provided, use the currently active tab)', + 'Timeout in milliseconds for the user to complete all selections. Default: 180000 (3 minutes). Maximum: 600000 (10 minutes).', }, - eventName: { + tabId: { + type: 'number', + description: 'Target tab ID. If omitted, uses the current active tab.', + }, + windowId: { + type: 'number', + description: 'Window ID to select active tab from (when tabId is omitted).', + }, + }, + required: ['requests'], + }, + }, + { + name: TOOL_NAMES.BROWSER.KEYBOARD, + description: + 'Simulate keyboard input on a web page. Supports single keys (Enter, Tab, Escape), key combinations (Ctrl+C, Ctrl+V), and text input. Can target a specific element or send to the focused element.', + inputSchema: { + type: 'object', + properties: { + keys: { type: 'string', - description: 'the eventName your injected content script listen for', + description: + 'Keys or key combinations to simulate. Examples: "Enter", "Tab", "Ctrl+C", "Shift+Tab", "Hello World".', + }, + selector: { + type: 'string', + description: 'CSS selector or XPath for target element to receive keyboard events.', }, - payload: { + selectorType: { type: 'string', - description: 'the payload passed to event, must be a json string', + enum: ['css', 'xpath'], + description: 'Type of selector (default: "css").', + }, + delay: { + type: 'number', + description: 'Delay between keystrokes in milliseconds (default: 50).', + }, + tabId: { + type: 'number', + description: 'Target tab ID. If omitted, uses the current active tab.', + }, + windowId: { + type: 'number', + description: 'Window ID to select active tab from (when tabId is omitted).', + }, + frameId: { + type: 'number', + description: 'Target frame ID for iframe support.', }, }, - required: ['eventName'], + required: ['keys'], }, }, { name: TOOL_NAMES.BROWSER.CONSOLE, description: - 'Capture and retrieve all console output from the current active browser tab/page. This captures console messages that existed before the tool was called.', + 'Capture console output from a browser tab. Supports snapshot mode (default; one-time capture with ~2s wait) and buffer mode (persistent per-tab buffer you can read/clear instantly without waiting).', inputSchema: { type: 'object', properties: { @@ -542,13 +1080,61 @@ export const TOOL_SCHEMAS: Tool[] = [ description: 'URL to navigate to and capture console from. If not provided, uses the current active tab', }, + tabId: { + type: 'number', + description: 'Target an existing tab by ID (default: active tab).', + }, + windowId: { + type: 'number', + description: 'Target window ID to pick active tab when tabId is omitted.', + }, + background: { + type: 'boolean', + description: 'Do not activate tab/focus window when capturing via CDP. Default: false', + }, includeExceptions: { type: 'boolean', description: 'Include uncaught exceptions in the output (default: true)', }, maxMessages: { type: 'number', - description: 'Maximum number of console messages to capture (default: 100)', + description: + 'Maximum number of console messages to capture in snapshot mode (default: 100). If limit is provided, it takes precedence.', + }, + mode: { + type: 'string', + enum: ['snapshot', 'buffer'], + description: + 'Console capture mode: snapshot (default; waits ~2s for messages) or buffer (persistent per-tab buffer; reads from memory instantly).', + }, + buffer: { + type: 'boolean', + description: 'Alias for mode="buffer" (default: false).', + }, + clear: { + type: 'boolean', + description: + 'Buffer mode only: clear the buffered logs for this tab before reading (default: false). Use clearAfterRead instead to clear after reading (mcp-tools.js style).', + }, + clearAfterRead: { + type: 'boolean', + description: + 'Buffer mode only: clear the buffered logs for this tab AFTER reading, to avoid duplicate messages on subsequent calls (default: false). This matches mcp-tools.js behavior.', + }, + pattern: { + type: 'string', + description: + 'Optional regex filter applied to message/exception text. Supports /pattern/flags syntax.', + }, + onlyErrors: { + type: 'boolean', + description: + 'Only return error-level console messages (and exceptions when includeExceptions=true). Default: false.', + }, + limit: { + type: 'number', + description: + 'Limit returned console messages. In snapshot mode this is an alias for maxMessages; in buffer mode it limits returned messages from the buffer.', }, }, required: [], @@ -556,10 +1142,16 @@ export const TOOL_SCHEMAS: Tool[] = [ }, { name: TOOL_NAMES.BROWSER.FILE_UPLOAD, - description: 'Upload files to web forms with file input elements using Chrome DevTools Protocol', + description: + 'Upload files to web forms with file input elements using Chrome DevTools Protocol', inputSchema: { type: 'object', properties: { + tabId: { type: 'number', description: 'Target tab ID (default: active tab)' }, + windowId: { + type: 'number', + description: 'Target window ID to pick active tab when tabId is omitted', + }, selector: { type: 'string', description: 'CSS selector for the file input element (input[type="file"])', @@ -588,4 +1180,221 @@ export const TOOL_SCHEMAS: Tool[] = [ required: ['selector'], }, }, + { + name: TOOL_NAMES.BROWSER.HANDLE_DIALOG, + description: 'Handle JavaScript dialogs (alert/confirm/prompt) via CDP', + inputSchema: { + type: 'object', + properties: { + action: { type: 'string', description: 'accept | dismiss' }, + promptText: { + type: 'string', + description: 'Optional prompt text when accepting a prompt', + }, + }, + required: ['action'], + }, + }, + { + name: TOOL_NAMES.BROWSER.GIF_RECORDER, + description: + 'Record browser tab activity as an animated GIF.\n\nModes:\n- Fixed FPS mode (action="start"): Captures frames at regular intervals. Good for animations/videos.\n- Auto-capture mode (action="auto_start"): Captures frames automatically when chrome_computer or chrome_navigate actions succeed. Better for interaction recordings with natural pacing.\n\nUse "stop" to end recording and save the GIF.', + inputSchema: { + type: 'object', + properties: { + action: { + type: 'string', + enum: ['start', 'stop', 'status', 'auto_start', 'capture', 'clear', 'export'], + description: + 'Action to perform:\n- "start": Begin fixed-FPS recording (captures frames at regular intervals)\n- "auto_start": Begin auto-capture mode (frames captured on tool actions)\n- "stop": End recording and save GIF\n- "status": Get current recording state\n- "capture": Manually trigger a frame capture in auto mode\n- "clear": Clear all recording state and cached GIF without saving\n- "export": Export the last recorded GIF (download or drag&drop upload)', + }, + tabId: { + type: 'number', + description: + 'Target tab ID (default: active tab). Used with "start"/"auto_start" for recording, and with "export" (download=false) for drag&drop upload target.', + }, + fps: { + type: 'number', + description: + 'Frames per second for fixed-FPS mode (1-30, default: 5). Higher values = smoother but larger file.', + }, + durationMs: { + type: 'number', + description: + 'Maximum recording duration in milliseconds (default: 5000, max: 60000). Only for fixed-FPS mode.', + }, + maxFrames: { + type: 'number', + description: + 'Maximum number of frames to capture (default: 50 for fixed-FPS, 100 for auto mode, max: 300).', + }, + width: { + type: 'number', + description: 'Output GIF width in pixels (default: 800, max: 1920).', + }, + height: { + type: 'number', + description: 'Output GIF height in pixels (default: 600, max: 1080).', + }, + maxColors: { + type: 'number', + description: + 'Maximum colors in palette (default: 256). Lower values = smaller file size.', + }, + filename: { + type: 'string', + description: 'Output filename (without extension). Defaults to timestamped name.', + }, + captureDelayMs: { + type: 'number', + description: + 'Auto-capture mode only: Delay in ms after action before capturing frame (default: 150). Allows UI to stabilize.', + }, + frameDelayCs: { + type: 'number', + description: + 'Auto-capture mode only: Display duration per frame in centiseconds (default: 20 = 200ms per frame).', + }, + annotation: { + type: 'string', + description: + 'Auto-capture mode only (action="capture"): Optional text label to render on the captured frame.', + }, + download: { + type: 'boolean', + description: + 'Export action only: Set to true (default) to download the GIF, or false to upload via drag&drop.', + }, + coordinates: { + type: 'object', + description: + 'Export action only (when download=false): Target coordinates for drag&drop upload.', + properties: { + x: { type: 'number' }, + y: { type: 'number' }, + }, + required: ['x', 'y'], + }, + ref: { + type: 'string', + description: + 'Export action only (when download=false): Element ref from chrome_read_page for drag&drop target.', + }, + selector: { + type: 'string', + description: + 'Export action only (when download=false): CSS selector for drag&drop target element.', + }, + enhancedRendering: { + type: 'object', + description: + 'Auto-capture mode only: Configure visual overlays for recorded actions (click indicators, drag paths, labels). Pass `true` to enable all defaults.', + properties: { + clickIndicators: { + oneOf: [ + { type: 'boolean' }, + { + type: 'object', + properties: { + enabled: { + type: 'boolean', + description: 'Enable click indicators (default: true)', + }, + color: { + type: 'string', + description: + 'CSS color for click indicator (default: "rgba(255, 87, 34, 0.8)")', + }, + radius: { type: 'number', description: 'Initial radius in px (default: 20)' }, + animationDurationMs: { + type: 'number', + description: 'Animation duration in ms (default: 400)', + }, + animationFrames: { + type: 'number', + description: 'Number of animation frames (default: 3)', + }, + animationIntervalMs: { + type: 'number', + description: 'Interval between animation frames in ms (default: 80)', + }, + }, + }, + ], + description: + 'Click indicator overlay config (true for defaults, or object for custom).', + }, + dragPaths: { + oneOf: [ + { type: 'boolean' }, + { + type: 'object', + properties: { + enabled: { + type: 'boolean', + description: 'Enable drag path rendering (default: true)', + }, + color: { + type: 'string', + description: 'CSS color for drag path (default: "rgba(33, 150, 243, 0.7)")', + }, + lineWidth: { type: 'number', description: 'Line width in px (default: 3)' }, + lineDash: { + type: 'array', + items: { type: 'number' }, + description: 'Dash pattern (default: [6, 4])', + }, + arrowSize: { + type: 'number', + description: 'Arrow head size in px (default: 10)', + }, + }, + }, + ], + description: 'Drag path overlay config (true for defaults, or object for custom).', + }, + labels: { + oneOf: [ + { type: 'boolean' }, + { + type: 'object', + properties: { + enabled: { + type: 'boolean', + description: 'Enable action labels (default: true)', + }, + font: { + type: 'string', + description: 'Font for labels (default: "bold 12px sans-serif")', + }, + textColor: { type: 'string', description: 'Text color (default: "#fff")' }, + bgColor: { + type: 'string', + description: 'Background color (default: "rgba(0,0,0,0.7)")', + }, + padding: { type: 'number', description: 'Padding in px (default: 4)' }, + borderRadius: { + type: 'number', + description: 'Border radius in px (default: 4)', + }, + offset: { + type: 'object', + properties: { x: { type: 'number' }, y: { type: 'number' } }, + description: 'Offset from action position (default: {x: 10, y: -20})', + }, + }, + }, + ], + description: 'Action label overlay config (true for defaults, or object for custom).', + }, + durationMs: { + type: 'number', + description: 'How long overlays remain visible in ms (default: 1500).', + }, + }, + }, + }, + required: ['action'], + }, + }, ]; diff --git a/packages/shared/src/types.ts b/packages/shared/src/types.ts index 90396b92..b78f66d4 100644 --- a/packages/shared/src/types.ts +++ b/packages/shared/src/types.ts @@ -15,6 +15,7 @@ export enum NativeMessageType { SERVER_STOPPED = 'server_stopped', ERROR_FROM_NATIVE_HOST = 'error_from_native_host', CONNECT_NATIVE = 'connectNative', + ENSURE_NATIVE = 'ensure_native', PING_NATIVE = 'ping_native', DISCONNECT_NATIVE = 'disconnect_native', } @@ -25,3 +26,140 @@ export interface NativeMessage

{ payload?: P; error?: E; } + +// ============================================================ +// Element Picker Types (chrome_request_element_selection) +// ============================================================ + +/** + * A single element selection request from the AI. + */ +export interface ElementPickerRequest { + /** + * Optional stable request id. If omitted, the extension will generate one. + */ + id?: string; + /** + * Short label shown to the user (e.g., "Login button"). + */ + name: string; + /** + * Optional longer instruction shown to the user. + */ + description?: string; +} + +/** + * Bounding rectangle of a picked element. + */ +export interface PickedElementRect { + x: number; + y: number; + width: number; + height: number; +} + +/** + * Center point of a picked element. + */ +export interface PickedElementPoint { + x: number; + y: number; +} + +/** + * A picked element that can be used with other tools (click, fill, etc.). + */ +export interface PickedElement { + /** + * Element ref written into window.__claudeElementMap (frame-local). + * Can be used directly with chrome_click_element, chrome_fill_or_select, etc. + */ + ref: string; + /** + * Best-effort stable CSS selector. + */ + selector: string; + /** + * Selector type (currently CSS only). + */ + selectorType: 'css'; + /** + * Bounding rect in the element's frame viewport coordinates. + */ + rect: PickedElementRect; + /** + * Center point in the element's frame viewport coordinates. + * Can be used as coordinates for chrome_computer. + */ + center: PickedElementPoint; + /** + * Optional text snippet to help verify the selection. + */ + text?: string; + /** + * Lowercased tag name. + */ + tagName?: string; + /** + * Chrome frameId for iframe targeting. + * Pass this to chrome_click_element/chrome_fill_or_select for cross-frame support. + */ + frameId: number; +} + +/** + * Result for a single element selection request. + */ +export interface ElementPickerResultItem { + /** + * The request id (matches the input request). + */ + id: string; + /** + * The request name (for reference). + */ + name: string; + /** + * The picked element, or null if not selected. + */ + element: PickedElement | null; + /** + * Error message if selection failed for this request. + */ + error?: string; +} + +/** + * Result of the chrome_request_element_selection tool. + */ +export interface ElementPickerResult { + /** + * True if the user confirmed all selections. + */ + success: boolean; + /** + * Session identifier for this picker session. + */ + sessionId: string; + /** + * Timeout value used for this session. + */ + timeoutMs: number; + /** + * True if the user cancelled the selection. + */ + cancelled?: boolean; + /** + * True if the selection timed out. + */ + timedOut?: boolean; + /** + * List of request IDs that were not selected (for debugging). + */ + missingRequestIds?: string[]; + /** + * Results for each requested element. + */ + results: ElementPickerResultItem[]; +} diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index bf448095..9effb0e8 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -1,4 +1,4 @@ -lockfileVersion: '9.0' +lockfileVersion: '6.0' settings: autoInstallPeers: true @@ -10,31 +10,31 @@ importers: devDependencies: '@commitlint/cli': specifier: ^19.8.1 - version: 19.8.1(@types/node@22.15.30)(typescript@5.8.3) + version: 19.8.1(@types/node@22.19.2)(typescript@5.9.3) '@commitlint/config-conventional': specifier: ^19.8.1 version: 19.8.1 '@eslint/js': specifier: ^9.25.1 - version: 9.28.0 + version: 9.39.2 '@typescript-eslint/eslint-plugin': specifier: ^8.32.0 - version: 8.33.1(@typescript-eslint/parser@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3))(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) + version: 8.49.0(@typescript-eslint/parser@8.49.0)(eslint@9.39.2)(typescript@5.9.3) '@typescript-eslint/parser': specifier: ^8.32.0 - version: 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) + version: 8.49.0(eslint@9.39.2)(typescript@5.9.3) eslint: specifier: ^9.26.0 - version: 9.28.0(jiti@2.4.2) + version: 9.39.2 eslint-config-prettier: specifier: ^10.1.5 - version: 10.1.5(eslint@9.28.0(jiti@2.4.2)) + version: 10.1.8(eslint@9.39.2) eslint-plugin-vue: specifier: ^10.0.0 - version: 10.2.0(eslint@9.28.0(jiti@2.4.2))(vue-eslint-parser@10.1.3(eslint@9.28.0(jiti@2.4.2))) + version: 10.6.2(@typescript-eslint/parser@8.49.0)(eslint@9.39.2)(vue-eslint-parser@10.2.0) globals: specifier: ^16.1.0 - version: 16.2.0 + version: 16.5.0 husky: specifier: ^9.1.7 version: 9.1.7 @@ -43,22 +43,34 @@ importers: version: 15.5.2 prettier: specifier: ^3.5.3 - version: 3.5.3 + version: 3.7.4 typescript: specifier: ^5.8.3 - version: 5.8.3 + version: 5.9.3 typescript-eslint: specifier: ^8.32.0 - version: 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) + version: 8.49.0(eslint@9.39.2)(typescript@5.9.3) vue-eslint-parser: specifier: ^10.1.3 - version: 10.1.3(eslint@9.28.0(jiti@2.4.2)) + version: 10.2.0(eslint@9.39.2) app/chrome-extension: dependencies: '@modelcontextprotocol/sdk': specifier: ^1.11.0 - version: 1.12.1 + version: 1.24.3(zod@3.25.76) + '@vue-flow/background': + specifier: ^1.3.2 + version: 1.3.2(@vue-flow/core@1.48.0)(vue@3.5.25) + '@vue-flow/controls': + specifier: ^1.1.3 + version: 1.1.3(@vue-flow/core@1.48.0)(vue@3.5.25) + '@vue-flow/core': + specifier: ^1.47.0 + version: 1.48.0(vue@3.5.25) + '@vue-flow/minimap': + specifier: ^1.5.4 + version: 1.5.4(@vue-flow/core@1.48.0)(vue@3.5.25) '@xenova/transformers': specifier: ^2.17.2 version: 2.17.2 @@ -68,67 +80,112 @@ importers: date-fns: specifier: ^4.1.0 version: 4.1.0 + elkjs: + specifier: ^0.11.0 + version: 0.11.0 + gifenc: + specifier: ^1.0.3 + version: 1.0.3 hnswlib-wasm-static: specifier: 0.8.5 version: 0.8.5 + markstream-vue: + specifier: 0.0.3-beta.5 + version: 0.0.3-beta.5(vue@3.5.25) vue: specifier: ^3.5.13 - version: 3.5.16(typescript@5.8.3) + version: 3.5.25(typescript@5.9.3) zod: specifier: ^3.24.4 - version: 3.25.56 + version: 3.25.76 devDependencies: + '@iconify-json/lucide': + specifier: ^1.1.0 + version: 1.2.80 + '@tailwindcss/vite': + specifier: ^4.0.0 + version: 4.1.18(vite@7.2.7) '@types/chrome': specifier: ^0.0.318 version: 0.0.318 '@wxt-dev/module-vue': specifier: ^1.0.2 - version: 1.0.2(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0))(vue@3.5.16(typescript@5.8.3))(wxt@0.20.7(@types/node@22.15.30)(jiti@2.4.2)(rollup@4.42.0)(yaml@2.8.0)) + version: 1.0.3(vite@7.2.7)(vue@3.5.25)(wxt@0.20.11) dotenv: specifier: ^16.5.0 - version: 16.5.0 + version: 16.6.1 + fake-indexeddb: + specifier: ^6.2.5 + version: 6.2.5 + jsdom: + specifier: ^26.0.0 + version: 26.1.0 + tailwindcss: + specifier: ^4.0.0 + version: 4.1.18 + unplugin-icons: + specifier: ^0.19.0 + version: 0.19.3 + unplugin-vue-components: + specifier: ^0.27.5 + version: 0.27.5(vue@3.5.25) vite-plugin-static-copy: specifier: ^3.0.0 - version: 3.0.0(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0)) + version: 3.1.4(vite@7.2.7) + vitest: + specifier: ^2.1.8 + version: 2.1.9(@types/node@22.19.2)(jsdom@26.1.0) vue-tsc: specifier: ^2.2.8 - version: 2.2.10(typescript@5.8.3) + version: 2.2.12(typescript@5.9.3) wxt: specifier: ^0.20.0 - version: 0.20.7(@types/node@22.15.30)(jiti@2.4.2)(rollup@4.42.0)(yaml@2.8.0) + version: 0.20.11(@types/node@22.19.2) app/native-server: dependencies: + '@anthropic-ai/claude-agent-sdk': + specifier: ^0.1.69 + version: 0.1.69(zod@3.25.76) '@fastify/cors': specifier: ^11.0.1 - version: 11.0.1 + version: 11.2.0 '@modelcontextprotocol/sdk': specifier: ^1.11.0 - version: 1.12.1 + version: 1.24.3(zod@3.25.76) '@types/node-fetch': - specifier: ^2.6.13 + specifier: '2' version: 2.6.13 + better-sqlite3: + specifier: ^11.6.0 + version: 11.10.0 chalk: specifier: ^5.4.1 - version: 5.4.1 + version: 5.6.2 + chrome-devtools-frontend: + specifier: ^1.0.1299282 + version: 1.0.1556696 chrome-mcp-shared: specifier: workspace:* version: link:../../packages/shared commander: specifier: ^13.1.0 version: 13.1.0 + drizzle-orm: + specifier: ^0.38.2 + version: 0.38.4(@types/better-sqlite3@7.6.13)(better-sqlite3@11.10.0) fastify: specifier: ^5.3.2 - version: 5.3.3 + version: 5.6.2 is-admin: specifier: ^4.0.0 version: 4.0.0 node-fetch: - specifier: ^2.7.0 + specifier: '2' version: 2.7.0 pino: specifier: ^9.6.0 - version: 9.7.0 + version: 9.14.0 uuid: specifier: ^11.1.0 version: 11.1.0 @@ -136,6 +193,9 @@ importers: '@jest/globals': specifier: ^29.7.0 version: 29.7.0 + '@types/better-sqlite3': + specifier: ^7.6.12 + version: 7.6.13 '@types/chrome': specifier: ^0.0.318 version: 0.0.318 @@ -144,13 +204,13 @@ importers: version: 29.5.14 '@types/node': specifier: ^22.15.3 - version: 22.15.30 + version: 22.19.2 '@types/supertest': specifier: ^6.0.3 version: 6.0.3 '@typescript-eslint/parser': specifier: ^8.31.1 - version: 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) + version: 8.49.0(eslint@9.39.2)(typescript@5.9.3) cross-env: specifier: ^7.0.3 version: 7.0.3 @@ -159,47 +219,47 @@ importers: version: 9.1.7 jest: specifier: ^29.7.0 - version: 29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + version: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) lint-staged: specifier: ^15.5.1 version: 15.5.2 nodemon: specifier: ^3.1.10 - version: 3.1.10 + version: 3.1.11 pino-pretty: specifier: ^13.0.0 - version: 13.0.0 + version: 13.1.3 rimraf: specifier: ^6.0.1 - version: 6.0.1 + version: 6.1.2 supertest: specifier: ^7.1.0 - version: 7.1.1 + version: 7.1.4 ts-jest: specifier: ^29.3.2 - version: 29.3.4(@babel/core@7.27.4)(@jest/transform@29.7.0)(@jest/types@29.6.3)(babel-jest@29.7.0(@babel/core@7.27.4))(jest@29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)))(typescript@5.8.3) + version: 29.4.6(@babel/core@7.28.5)(jest@29.7.0)(typescript@5.9.3) ts-node: specifier: ^10.9.2 - version: 10.9.2(@types/node@22.15.30)(typescript@5.8.3) + version: 10.9.2(@types/node@22.19.2)(typescript@5.9.3) packages/shared: dependencies: '@modelcontextprotocol/sdk': specifier: ^1.11.0 - version: 1.12.1 + version: 1.24.3(zod@3.25.76) zod: specifier: ^3.24.4 - version: 3.25.56 + version: 3.25.76 devDependencies: '@types/node': specifier: ^18.0.0 - version: 18.19.111 + version: 18.19.130 '@typescript-eslint/parser': specifier: ^8.32.0 - version: 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) + version: 8.49.0(eslint@9.39.2)(typescript@5.9.3) tsup: specifier: ^8.4.0 - version: 8.5.0(jiti@2.4.2)(postcss@8.5.4)(typescript@5.8.3)(yaml@2.8.0) + version: 8.5.1(typescript@5.9.3) packages/wasm-simd: devDependencies: @@ -209,10 +269,14 @@ importers: packages: - '@1natsu/wait-element@4.1.2': + /@1natsu/wait-element@4.1.2: resolution: {integrity: sha512-qWxSJD+Q5b8bKOvESFifvfZ92DuMsY+03SBNjTO34ipJLP6mZ9yK4bQz/vlh48aEQXoJfaZBqUwKL5BdI5iiWw==} + dependencies: + defu: 6.1.4 + many-keys-map: 2.0.1 + dev: true - '@aklinker1/rollup-plugin-visualizer@5.12.0': + /@aklinker1/rollup-plugin-visualizer@5.12.0: resolution: {integrity: sha512-X24LvEGw6UFmy0lpGJDmXsMyBD58XmX1bbwsaMLhNoM+UMQfQ3b2RtC+nz4b/NoRK5r6QJSKJHBNVeUdwqybaQ==} engines: {node: '>=14'} hasBin: true @@ -221,4914 +285,1699 @@ packages: peerDependenciesMeta: rollup: optional: true + dependencies: + open: 8.4.2 + picomatch: 2.3.1 + source-map: 0.7.6 + yargs: 17.7.2 + dev: true - '@ampproject/remapping@2.3.0': - resolution: {integrity: sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==} - engines: {node: '>=6.0.0'} + /@antfu/install-pkg@0.4.1: + resolution: {integrity: sha512-T7yB5QNG29afhWVkVq7XeIMBa5U/vs9mX69YqayXypPRmYzUmzwnYltplHmPtZ4HPCn+sQKeXW8I47wCbuBOjw==} + dependencies: + package-manager-detector: 0.2.11 + tinyexec: 0.3.2 + dev: true + + /@antfu/install-pkg@1.1.0: + resolution: {integrity: sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ==} + dependencies: + package-manager-detector: 1.6.0 + tinyexec: 1.0.2 + dev: true - '@babel/code-frame@7.27.1': + /@antfu/utils@0.7.10: + resolution: {integrity: sha512-+562v9k4aI80m1+VuMHehNJWLOFjBnXn3tdOitzD0il5b7smkSBal4+a3oKiQTbrwMmN/TBUMDvbdoWDehgOww==} + dev: true + + /@antfu/utils@8.1.1: + resolution: {integrity: sha512-Mex9nXf9vR6AhcXmMrlz/HVgYYZpVGJ6YlPgwl7UnaFpnshXs6EK/oa5Gpf3CzENMjkvEx2tQtntGnb7UtSTOQ==} + dev: true + + /@anthropic-ai/claude-agent-sdk@0.1.69(zod@3.25.76): + resolution: {integrity: sha512-T6mb8xKGYIH0g3drS0VRxDHemj8kmWD37nuB+ENoD9sZfi/lomnugWLWBjq9Cjw10WBewE5hjv+i8swM34nkAA==} + engines: {node: '>=18.0.0'} + peerDependencies: + zod: ^3.24.1 + dependencies: + zod: 3.25.76 + optionalDependencies: + '@img/sharp-darwin-arm64': 0.33.5 + '@img/sharp-darwin-x64': 0.33.5 + '@img/sharp-linux-arm': 0.33.5 + '@img/sharp-linux-arm64': 0.33.5 + '@img/sharp-linux-x64': 0.33.5 + '@img/sharp-linuxmusl-arm64': 0.33.5 + '@img/sharp-linuxmusl-x64': 0.33.5 + '@img/sharp-win32-x64': 0.33.5 + dev: false + + /@asamuzakjp/css-color@3.2.0: + resolution: {integrity: sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==} + dependencies: + '@csstools/css-calc': 2.1.4(@csstools/css-parser-algorithms@3.0.5)(@csstools/css-tokenizer@3.0.4) + '@csstools/css-color-parser': 3.1.0(@csstools/css-parser-algorithms@3.0.5)(@csstools/css-tokenizer@3.0.4) + '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4) + '@csstools/css-tokenizer': 3.0.4 + lru-cache: 10.4.3 + dev: true + + /@babel/code-frame@7.27.1: resolution: {integrity: sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/helper-validator-identifier': 7.28.5 + js-tokens: 4.0.0 + picocolors: 1.1.1 + dev: true - '@babel/compat-data@7.27.5': - resolution: {integrity: sha512-KiRAp/VoJaWkkte84TvUd9qjdbZAdiqyvMxrGl1N6vzFogKmaLgoM3L1kgtLicp2HP5fBJS8JrZKLVIZGVJAVg==} + /@babel/compat-data@7.28.5: + resolution: {integrity: sha512-6uFXyCayocRbqhZOB+6XcuZbkMNimwfVGFji8CTZnCzOHVGvDqzvitu1re2AU5LROliz7eQPhB8CpAMvnx9EjA==} engines: {node: '>=6.9.0'} + dev: true - '@babel/core@7.27.4': - resolution: {integrity: sha512-bXYxrXFubeYdvB0NhD/NBB3Qi6aZeV20GOWVI47t2dkecCEoneR4NPVcb7abpXDEvejgrUfFtG6vG/zxAKmg+g==} + /@babel/core@7.28.5: + resolution: {integrity: sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/code-frame': 7.27.1 + '@babel/generator': 7.28.5 + '@babel/helper-compilation-targets': 7.27.2 + '@babel/helper-module-transforms': 7.28.3(@babel/core@7.28.5) + '@babel/helpers': 7.28.4 + '@babel/parser': 7.28.5 + '@babel/template': 7.27.2 + '@babel/traverse': 7.28.5 + '@babel/types': 7.28.5 + '@jridgewell/remapping': 2.3.5 + convert-source-map: 2.0.0 + debug: 4.4.3(supports-color@5.5.0) + gensync: 1.0.0-beta.2 + json5: 2.2.3 + semver: 6.3.1 + transitivePeerDependencies: + - supports-color + dev: true - '@babel/generator@7.27.5': - resolution: {integrity: sha512-ZGhA37l0e/g2s1Cnzdix0O3aLYm66eF8aufiVteOgnwxgnRP8GoyMj7VWsgWnQbVKXyge7hqrFh2K2TQM6t1Hw==} + /@babel/generator@7.28.5: + resolution: {integrity: sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/parser': 7.28.5 + '@babel/types': 7.28.5 + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + jsesc: 3.1.0 + dev: true - '@babel/helper-compilation-targets@7.27.2': + /@babel/helper-compilation-targets@7.27.2: resolution: {integrity: sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/compat-data': 7.28.5 + '@babel/helper-validator-option': 7.27.1 + browserslist: 4.28.1 + lru-cache: 5.1.1 + semver: 6.3.1 + dev: true - '@babel/helper-module-imports@7.27.1': + /@babel/helper-globals@7.28.0: + resolution: {integrity: sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==} + engines: {node: '>=6.9.0'} + dev: true + + /@babel/helper-module-imports@7.27.1: resolution: {integrity: sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/traverse': 7.28.5 + '@babel/types': 7.28.5 + transitivePeerDependencies: + - supports-color + dev: true - '@babel/helper-module-transforms@7.27.3': - resolution: {integrity: sha512-dSOvYwvyLsWBeIRyOeHXp5vPj5l1I011r52FM1+r1jCERv+aFXYk4whgQccYEGYxK2H3ZAIA8nuPkQ0HaUo3qg==} + /@babel/helper-module-transforms@7.28.3(@babel/core@7.28.5): + resolution: {integrity: sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-module-imports': 7.27.1 + '@babel/helper-validator-identifier': 7.28.5 + '@babel/traverse': 7.28.5 + transitivePeerDependencies: + - supports-color + dev: true - '@babel/helper-plugin-utils@7.27.1': + /@babel/helper-plugin-utils@7.27.1: resolution: {integrity: sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==} engines: {node: '>=6.9.0'} + dev: true - '@babel/helper-string-parser@7.27.1': + /@babel/helper-string-parser@7.27.1: resolution: {integrity: sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==} engines: {node: '>=6.9.0'} - '@babel/helper-validator-identifier@7.27.1': - resolution: {integrity: sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==} + /@babel/helper-validator-identifier@7.28.5: + resolution: {integrity: sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==} engines: {node: '>=6.9.0'} - '@babel/helper-validator-option@7.27.1': + /@babel/helper-validator-option@7.27.1: resolution: {integrity: sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==} engines: {node: '>=6.9.0'} + dev: true - '@babel/helpers@7.27.6': - resolution: {integrity: sha512-muE8Tt8M22638HU31A3CgfSUciwz1fhATfoVai05aPXGor//CdWDCbnlY1yvBPo07njuVOCNGCSp/GTt12lIug==} + /@babel/helpers@7.28.4: + resolution: {integrity: sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/template': 7.27.2 + '@babel/types': 7.28.5 + dev: true - '@babel/parser@7.27.5': - resolution: {integrity: sha512-OsQd175SxWkGlzbny8J3K8TnnDD0N3lrIUtB92xwyRpzaenGZhxDvxN/JgU00U3CDZNj9tPuDJ5H0WS4Nt3vKg==} + /@babel/parser@7.28.5: + resolution: {integrity: sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ==} engines: {node: '>=6.0.0'} hasBin: true + dependencies: + '@babel/types': 7.28.5 - '@babel/plugin-syntax-async-generators@7.8.4': + /@babel/plugin-syntax-async-generators@7.8.4(@babel/core@7.28.5): resolution: {integrity: sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-bigint@7.8.3': + /@babel/plugin-syntax-bigint@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-class-properties@7.12.13': + /@babel/plugin-syntax-class-properties@7.12.13(@babel/core@7.28.5): resolution: {integrity: sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-class-static-block@7.14.5': + /@babel/plugin-syntax-class-static-block@7.14.5(@babel/core@7.28.5): resolution: {integrity: sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-import-attributes@7.27.1': + /@babel/plugin-syntax-import-attributes@7.27.1(@babel/core@7.28.5): resolution: {integrity: sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-import-meta@7.10.4': + /@babel/plugin-syntax-import-meta@7.10.4(@babel/core@7.28.5): resolution: {integrity: sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-json-strings@7.8.3': + /@babel/plugin-syntax-json-strings@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-jsx@7.27.1': + /@babel/plugin-syntax-jsx@7.27.1(@babel/core@7.28.5): resolution: {integrity: sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-logical-assignment-operators@7.10.4': + /@babel/plugin-syntax-logical-assignment-operators@7.10.4(@babel/core@7.28.5): resolution: {integrity: sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-nullish-coalescing-operator@7.8.3': + /@babel/plugin-syntax-nullish-coalescing-operator@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-numeric-separator@7.10.4': + /@babel/plugin-syntax-numeric-separator@7.10.4(@babel/core@7.28.5): resolution: {integrity: sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-object-rest-spread@7.8.3': + /@babel/plugin-syntax-object-rest-spread@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-optional-catch-binding@7.8.3': + /@babel/plugin-syntax-optional-catch-binding@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-optional-chaining@7.8.3': + /@babel/plugin-syntax-optional-chaining@7.8.3(@babel/core@7.28.5): resolution: {integrity: sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-private-property-in-object@7.14.5': + /@babel/plugin-syntax-private-property-in-object@7.14.5(@babel/core@7.28.5): resolution: {integrity: sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-top-level-await@7.14.5': + /@babel/plugin-syntax-top-level-await@7.14.5(@babel/core@7.28.5): resolution: {integrity: sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/plugin-syntax-typescript@7.27.1': + /@babel/plugin-syntax-typescript@7.27.1(@babel/core@7.28.5): resolution: {integrity: sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==} engines: {node: '>=6.9.0'} peerDependencies: '@babel/core': ^7.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-plugin-utils': 7.27.1 + dev: true - '@babel/runtime@7.27.0': - resolution: {integrity: sha512-VtPOkrdPHZsKc/clNqyi9WUA8TINkZ4cGk63UUE3u4pmB2k+ZMQRDuIOagv8UVd6j7k0T3+RRIb7beKTebNbcw==} + /@babel/runtime@7.28.2: + resolution: {integrity: sha512-KHp2IflsnGywDjBWDkR9iEqiWSpc8GIi0lgTT3mOElT0PP1tG26P4tmFI2YvAdzgq9RGyoHZQEIEdZy6Ec5xCA==} engines: {node: '>=6.9.0'} + dev: true - '@babel/template@7.27.2': + /@babel/template@7.27.2: resolution: {integrity: sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/code-frame': 7.27.1 + '@babel/parser': 7.28.5 + '@babel/types': 7.28.5 + dev: true - '@babel/traverse@7.27.4': - resolution: {integrity: sha512-oNcu2QbHqts9BtOWJosOVJapWjBDSxGCpFvikNR5TGDYDQf3JwpIoMzIKrvfoti93cLfPJEG4tH9SPVeyCGgdA==} + /@babel/traverse@7.28.5: + resolution: {integrity: sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/code-frame': 7.27.1 + '@babel/generator': 7.28.5 + '@babel/helper-globals': 7.28.0 + '@babel/parser': 7.28.5 + '@babel/template': 7.27.2 + '@babel/types': 7.28.5 + debug: 4.4.3(supports-color@5.5.0) + transitivePeerDependencies: + - supports-color + dev: true - '@babel/types@7.27.6': - resolution: {integrity: sha512-ETyHEk2VHHvl9b9jZP5IHPavHYk57EhanlRRuae9XCpb/j5bDCbPPMOBfCWhnl/7EDJz0jEMCi/RhccCE8r1+Q==} + /@babel/types@7.28.5: + resolution: {integrity: sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA==} engines: {node: '>=6.9.0'} + dependencies: + '@babel/helper-string-parser': 7.27.1 + '@babel/helper-validator-identifier': 7.28.5 - '@bcoe/v8-coverage@0.2.3': + /@bcoe/v8-coverage@0.2.3: resolution: {integrity: sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==} + dev: true - '@commitlint/cli@19.8.1': + /@commitlint/cli@19.8.1(@types/node@22.19.2)(typescript@5.9.3): resolution: {integrity: sha512-LXUdNIkspyxrlV6VDHWBmCZRtkEVRpBKxi2Gtw3J54cGWhLCTouVD/Q6ZSaSvd2YaDObWK8mDjrz3TIKtaQMAA==} engines: {node: '>=v18'} hasBin: true + dependencies: + '@commitlint/format': 19.8.1 + '@commitlint/lint': 19.8.1 + '@commitlint/load': 19.8.1(@types/node@22.19.2)(typescript@5.9.3) + '@commitlint/read': 19.8.1 + '@commitlint/types': 19.8.1 + tinyexec: 1.0.2 + yargs: 17.7.2 + transitivePeerDependencies: + - '@types/node' + - typescript + dev: true - '@commitlint/config-conventional@19.8.1': + /@commitlint/config-conventional@19.8.1: resolution: {integrity: sha512-/AZHJL6F6B/G959CsMAzrPKKZjeEiAVifRyEwXxcT6qtqbPwGw+iQxmNS+Bu+i09OCtdNRW6pNpBvgPrtMr9EQ==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + conventional-changelog-conventionalcommits: 7.0.2 + dev: true - '@commitlint/config-validator@19.8.1': + /@commitlint/config-validator@19.8.1: resolution: {integrity: sha512-0jvJ4u+eqGPBIzzSdqKNX1rvdbSU1lPNYlfQQRIFnBgLy26BtC0cFnr7c/AyuzExMxWsMOte6MkTi9I3SQ3iGQ==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + ajv: 8.17.1 + dev: true - '@commitlint/ensure@19.8.1': + /@commitlint/ensure@19.8.1: resolution: {integrity: sha512-mXDnlJdvDzSObafjYrOSvZBwkD01cqB4gbnnFuVyNpGUM5ijwU/r/6uqUmBXAAOKRfyEjpkGVZxaDsCVnHAgyw==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + lodash.camelcase: 4.3.0 + lodash.kebabcase: 4.1.1 + lodash.snakecase: 4.1.1 + lodash.startcase: 4.4.0 + lodash.upperfirst: 4.3.1 + dev: true - '@commitlint/execute-rule@19.8.1': + /@commitlint/execute-rule@19.8.1: resolution: {integrity: sha512-YfJyIqIKWI64Mgvn/sE7FXvVMQER/Cd+s3hZke6cI1xgNT/f6ZAz5heND0QtffH+KbcqAwXDEE1/5niYayYaQA==} engines: {node: '>=v18'} + dev: true - '@commitlint/format@19.8.1': + /@commitlint/format@19.8.1: resolution: {integrity: sha512-kSJj34Rp10ItP+Eh9oCItiuN/HwGQMXBnIRk69jdOwEW9llW9FlyqcWYbHPSGofmjsqeoxa38UaEA5tsbm2JWw==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + chalk: 5.6.2 + dev: true - '@commitlint/is-ignored@19.8.1': + /@commitlint/is-ignored@19.8.1: resolution: {integrity: sha512-AceOhEhekBUQ5dzrVhDDsbMaY5LqtN8s1mqSnT2Kz1ERvVZkNihrs3Sfk1Je/rxRNbXYFzKZSHaPsEJJDJV8dg==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + semver: 7.7.3 + dev: true - '@commitlint/lint@19.8.1': + /@commitlint/lint@19.8.1: resolution: {integrity: sha512-52PFbsl+1EvMuokZXLRlOsdcLHf10isTPlWwoY1FQIidTsTvjKXVXYb7AvtpWkDzRO2ZsqIgPK7bI98x8LRUEw==} engines: {node: '>=v18'} + dependencies: + '@commitlint/is-ignored': 19.8.1 + '@commitlint/parse': 19.8.1 + '@commitlint/rules': 19.8.1 + '@commitlint/types': 19.8.1 + dev: true - '@commitlint/load@19.8.1': + /@commitlint/load@19.8.1(@types/node@22.19.2)(typescript@5.9.3): resolution: {integrity: sha512-9V99EKG3u7z+FEoe4ikgq7YGRCSukAcvmKQuTtUyiYPnOd9a2/H9Ak1J9nJA1HChRQp9OA/sIKPugGS+FK/k1A==} engines: {node: '>=v18'} + dependencies: + '@commitlint/config-validator': 19.8.1 + '@commitlint/execute-rule': 19.8.1 + '@commitlint/resolve-extends': 19.8.1 + '@commitlint/types': 19.8.1 + chalk: 5.6.2 + cosmiconfig: 9.0.0(typescript@5.9.3) + cosmiconfig-typescript-loader: 6.2.0(@types/node@22.19.2)(cosmiconfig@9.0.0)(typescript@5.9.3) + lodash.isplainobject: 4.0.6 + lodash.merge: 4.6.2 + lodash.uniq: 4.5.0 + transitivePeerDependencies: + - '@types/node' + - typescript + dev: true - '@commitlint/message@19.8.1': + /@commitlint/message@19.8.1: resolution: {integrity: sha512-+PMLQvjRXiU+Ae0Wc+p99EoGEutzSXFVwQfa3jRNUZLNW5odZAyseb92OSBTKCu+9gGZiJASt76Cj3dLTtcTdg==} engines: {node: '>=v18'} + dev: true - '@commitlint/parse@19.8.1': + /@commitlint/parse@19.8.1: resolution: {integrity: sha512-mmAHYcMBmAgJDKWdkjIGq50X4yB0pSGpxyOODwYmoexxxiUCy5JJT99t1+PEMK7KtsCtzuWYIAXYAiKR+k+/Jw==} engines: {node: '>=v18'} + dependencies: + '@commitlint/types': 19.8.1 + conventional-changelog-angular: 7.0.0 + conventional-commits-parser: 5.0.0 + dev: true - '@commitlint/read@19.8.1': + /@commitlint/read@19.8.1: resolution: {integrity: sha512-03Jbjb1MqluaVXKHKRuGhcKWtSgh3Jizqy2lJCRbRrnWpcM06MYm8th59Xcns8EqBYvo0Xqb+2DoZFlga97uXQ==} engines: {node: '>=v18'} + dependencies: + '@commitlint/top-level': 19.8.1 + '@commitlint/types': 19.8.1 + git-raw-commits: 4.0.0 + minimist: 1.2.8 + tinyexec: 1.0.2 + dev: true - '@commitlint/resolve-extends@19.8.1': + /@commitlint/resolve-extends@19.8.1: resolution: {integrity: sha512-GM0mAhFk49I+T/5UCYns5ayGStkTt4XFFrjjf0L4S26xoMTSkdCf9ZRO8en1kuopC4isDFuEm7ZOm/WRVeElVg==} engines: {node: '>=v18'} + dependencies: + '@commitlint/config-validator': 19.8.1 + '@commitlint/types': 19.8.1 + global-directory: 4.0.1 + import-meta-resolve: 4.2.0 + lodash.mergewith: 4.6.2 + resolve-from: 5.0.0 + dev: true - '@commitlint/rules@19.8.1': + /@commitlint/rules@19.8.1: resolution: {integrity: sha512-Hnlhd9DyvGiGwjfjfToMi1dsnw1EXKGJNLTcsuGORHz6SS9swRgkBsou33MQ2n51/boIDrbsg4tIBbRpEWK2kw==} engines: {node: '>=v18'} + dependencies: + '@commitlint/ensure': 19.8.1 + '@commitlint/message': 19.8.1 + '@commitlint/to-lines': 19.8.1 + '@commitlint/types': 19.8.1 + dev: true - '@commitlint/to-lines@19.8.1': + /@commitlint/to-lines@19.8.1: resolution: {integrity: sha512-98Mm5inzbWTKuZQr2aW4SReY6WUukdWXuZhrqf1QdKPZBCCsXuG87c+iP0bwtD6DBnmVVQjgp4whoHRVixyPBg==} engines: {node: '>=v18'} + dev: true - '@commitlint/top-level@19.8.1': + /@commitlint/top-level@19.8.1: resolution: {integrity: sha512-Ph8IN1IOHPSDhURCSXBz44+CIu+60duFwRsg6HqaISFHQHbmBtxVw4ZrFNIYUzEP7WwrNPxa2/5qJ//NK1FGcw==} engines: {node: '>=v18'} + dependencies: + find-up: 7.0.0 + dev: true - '@commitlint/types@19.8.1': + /@commitlint/types@19.8.1: resolution: {integrity: sha512-/yCrWGCoA1SVKOks25EGadP9Pnj0oAIHGpl2wH2M2Y46dPM2ueb8wyCVOD7O3WCTkaJ0IkKvzhl1JY7+uCT2Dw==} engines: {node: '>=v18'} + dependencies: + '@types/conventional-commits-parser': 5.0.2 + chalk: 5.6.2 + dev: true - '@cspotcode/source-map-support@0.8.1': + /@cspotcode/source-map-support@0.8.1: resolution: {integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==} engines: {node: '>=12'} + dependencies: + '@jridgewell/trace-mapping': 0.3.9 + dev: true + + /@csstools/color-helpers@5.1.0: + resolution: {integrity: sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==} + engines: {node: '>=18'} + dev: true + + /@csstools/css-calc@2.1.4(@csstools/css-parser-algorithms@3.0.5)(@csstools/css-tokenizer@3.0.4): + resolution: {integrity: sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==} + engines: {node: '>=18'} + peerDependencies: + '@csstools/css-parser-algorithms': ^3.0.5 + '@csstools/css-tokenizer': ^3.0.4 + dependencies: + '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4) + '@csstools/css-tokenizer': 3.0.4 + dev: true + + /@csstools/css-color-parser@3.1.0(@csstools/css-parser-algorithms@3.0.5)(@csstools/css-tokenizer@3.0.4): + resolution: {integrity: sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==} + engines: {node: '>=18'} + peerDependencies: + '@csstools/css-parser-algorithms': ^3.0.5 + '@csstools/css-tokenizer': ^3.0.4 + dependencies: + '@csstools/color-helpers': 5.1.0 + '@csstools/css-calc': 2.1.4(@csstools/css-parser-algorithms@3.0.5)(@csstools/css-tokenizer@3.0.4) + '@csstools/css-parser-algorithms': 3.0.5(@csstools/css-tokenizer@3.0.4) + '@csstools/css-tokenizer': 3.0.4 + dev: true - '@devicefarmer/adbkit-logcat@2.1.3': + /@csstools/css-parser-algorithms@3.0.5(@csstools/css-tokenizer@3.0.4): + resolution: {integrity: sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==} + engines: {node: '>=18'} + peerDependencies: + '@csstools/css-tokenizer': ^3.0.4 + dependencies: + '@csstools/css-tokenizer': 3.0.4 + dev: true + + /@csstools/css-tokenizer@3.0.4: + resolution: {integrity: sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==} + engines: {node: '>=18'} + dev: true + + /@devicefarmer/adbkit-logcat@2.1.3: resolution: {integrity: sha512-yeaGFjNBc/6+svbDeul1tNHtNChw6h8pSHAt5D+JsedUrMTN7tla7B15WLDyekxsuS2XlZHRxpuC6m92wiwCNw==} engines: {node: '>= 4'} + dev: true - '@devicefarmer/adbkit-monkey@1.2.1': + /@devicefarmer/adbkit-monkey@1.2.1: resolution: {integrity: sha512-ZzZY/b66W2Jd6NHbAhLyDWOEIBWC11VizGFk7Wx7M61JZRz7HR9Cq5P+65RKWUU7u6wgsE8Lmh9nE4Mz+U2eTg==} engines: {node: '>= 0.10.4'} + dev: true - '@devicefarmer/adbkit@3.3.8': + /@devicefarmer/adbkit@3.3.8: resolution: {integrity: sha512-7rBLLzWQnBwutH2WZ0EWUkQdihqrnLYCUMaB44hSol9e0/cdIhuNFcqZO0xNheAU6qqHVA8sMiLofkYTgb+lmw==} engines: {node: '>= 0.10.4'} hasBin: true + dependencies: + '@devicefarmer/adbkit-logcat': 2.1.3 + '@devicefarmer/adbkit-monkey': 1.2.1 + bluebird: 3.7.2 + commander: 9.5.0 + debug: 4.3.7 + node-forge: 1.3.3 + split: 1.0.1 + transitivePeerDependencies: + - supports-color + dev: true + + /@esbuild/aix-ppc64@0.21.5: + resolution: {integrity: sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==} + engines: {node: '>=12'} + cpu: [ppc64] + os: [aix] + requiresBuild: true + dev: true + optional: true - '@esbuild/aix-ppc64@0.25.5': - resolution: {integrity: sha512-9o3TMmpmftaCMepOdA5k/yDw8SfInyzWWTjYTFCX3kPSDJMROQTb8jg+h9Cnwnmm1vOzvxN7gIfB5V2ewpjtGA==} + /@esbuild/aix-ppc64@0.25.12: + resolution: {integrity: sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==} engines: {node: '>=18'} cpu: [ppc64] os: [aix] + requiresBuild: true + dev: true + optional: true - '@esbuild/android-arm64@0.25.5': - resolution: {integrity: sha512-VGzGhj4lJO+TVGV1v8ntCZWJktV7SGCs3Pn1GRWI1SBFtRALoomm8k5E9Pmwg3HOAal2VDc2F9+PM/rEY6oIDg==} + /@esbuild/aix-ppc64@0.27.1: + resolution: {integrity: sha512-HHB50pdsBX6k47S4u5g/CaLjqS3qwaOVE5ILsq64jyzgMhLuCuZ8rGzM9yhsAjfjkbgUPMzZEPa7DAp7yz6vuA==} engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + requiresBuild: true + dev: true + optional: true + + /@esbuild/android-arm64@0.21.5: + resolution: {integrity: sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==} + engines: {node: '>=12'} cpu: [arm64] os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/android-arm@0.25.5': - resolution: {integrity: sha512-AdJKSPeEHgi7/ZhuIPtcQKr5RQdo6OO2IL87JkianiMYMPbCtot9fxPbrMiBADOWWm3T2si9stAiVsGbTQFkbA==} + /@esbuild/android-arm64@0.25.12: + resolution: {integrity: sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==} engines: {node: '>=18'} - cpu: [arm] + cpu: [arm64] os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/android-x64@0.25.5': - resolution: {integrity: sha512-D2GyJT1kjvO//drbRT3Hib9XPwQeWd9vZoBJn+bu/lVsOZ13cqNdDeqIF/xQ5/VmWvMduP6AmXvylO/PIc2isw==} + /@esbuild/android-arm64@0.27.1: + resolution: {integrity: sha512-45fuKmAJpxnQWixOGCrS+ro4Uvb4Re9+UTieUY2f8AEc+t7d4AaZ6eUJ3Hva7dtrxAAWHtlEFsXFMAgNnGU9uQ==} engines: {node: '>=18'} - cpu: [x64] + cpu: [arm64] os: [android] + requiresBuild: true + dev: true + optional: true + + /@esbuild/android-arm@0.21.5: + resolution: {integrity: sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==} + engines: {node: '>=12'} + cpu: [arm] + os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/darwin-arm64@0.25.5': - resolution: {integrity: sha512-GtaBgammVvdF7aPIgH2jxMDdivezgFu6iKpmT+48+F8Hhg5J/sfnDieg0aeG/jfSvkYQU2/pceFPDKlqZzwnfQ==} + /@esbuild/android-arm@0.25.12: + resolution: {integrity: sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==} engines: {node: '>=18'} - cpu: [arm64] - os: [darwin] + cpu: [arm] + os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/darwin-x64@0.25.5': - resolution: {integrity: sha512-1iT4FVL0dJ76/q1wd7XDsXrSW+oLoquptvh4CLR4kITDtqi2e/xwXwdCVH8hVHU43wgJdsq7Gxuzcs6Iq/7bxQ==} + /@esbuild/android-arm@0.27.1: + resolution: {integrity: sha512-kFqa6/UcaTbGm/NncN9kzVOODjhZW8e+FRdSeypWe6j33gzclHtwlANs26JrupOntlcWmB0u8+8HZo8s7thHvg==} engines: {node: '>=18'} + cpu: [arm] + os: [android] + requiresBuild: true + dev: true + optional: true + + /@esbuild/android-x64@0.21.5: + resolution: {integrity: sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==} + engines: {node: '>=12'} cpu: [x64] - os: [darwin] + os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/freebsd-arm64@0.25.5': - resolution: {integrity: sha512-nk4tGP3JThz4La38Uy/gzyXtpkPW8zSAmoUhK9xKKXdBCzKODMc2adkB2+8om9BDYugz+uGV7sLmpTYzvmz6Sw==} + /@esbuild/android-x64@0.25.12: + resolution: {integrity: sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==} engines: {node: '>=18'} - cpu: [arm64] - os: [freebsd] + cpu: [x64] + os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/freebsd-x64@0.25.5': - resolution: {integrity: sha512-PrikaNjiXdR2laW6OIjlbeuCPrPaAl0IwPIaRv+SMV8CiM8i2LqVUHFC1+8eORgWyY7yhQY+2U2fA55mBzReaw==} + /@esbuild/android-x64@0.27.1: + resolution: {integrity: sha512-LBEpOz0BsgMEeHgenf5aqmn/lLNTFXVfoWMUox8CtWWYK9X4jmQzWjoGoNb8lmAYml/tQ/Ysvm8q7szu7BoxRQ==} engines: {node: '>=18'} cpu: [x64] - os: [freebsd] + os: [android] + requiresBuild: true + dev: true + optional: true - '@esbuild/linux-arm64@0.25.5': - resolution: {integrity: sha512-Z9kfb1v6ZlGbWj8EJk9T6czVEjjq2ntSYLY2cw6pAZl4oKtfgQuS4HOq41M/BcoLPzrUbNd+R4BXFyH//nHxVg==} - engines: {node: '>=18'} + /@esbuild/darwin-arm64@0.21.5: + resolution: {integrity: sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==} + engines: {node: '>=12'} cpu: [arm64] - os: [linux] + os: [darwin] + requiresBuild: true + dev: true + optional: true - '@esbuild/linux-arm@0.25.5': - resolution: {integrity: sha512-cPzojwW2okgh7ZlRpcBEtsX7WBuqbLrNXqLU89GxWbNt6uIg78ET82qifUy3W6OVww6ZWobWub5oqZOVtwolfw==} + /@esbuild/darwin-arm64@0.25.12: + resolution: {integrity: sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==} engines: {node: '>=18'} - cpu: [arm] - os: [linux] + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: true + optional: true - '@esbuild/linux-ia32@0.25.5': - resolution: {integrity: sha512-sQ7l00M8bSv36GLV95BVAdhJ2QsIbCuCjh/uYrWiMQSUuV+LpXwIqhgJDcvMTj+VsQmqAHL2yYaasENvJ7CDKA==} + /@esbuild/darwin-arm64@0.27.1: + resolution: {integrity: sha512-veg7fL8eMSCVKL7IW4pxb54QERtedFDfY/ASrumK/SbFsXnRazxY4YykN/THYqFnFwJ0aVjiUrVG2PwcdAEqQQ==} engines: {node: '>=18'} - cpu: [ia32] - os: [linux] + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: true + optional: true + + /@esbuild/darwin-x64@0.21.5: + resolution: {integrity: sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==} + engines: {node: '>=12'} + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: true + optional: true - '@esbuild/linux-loong64@0.25.5': - resolution: {integrity: sha512-0ur7ae16hDUC4OL5iEnDb0tZHDxYmuQyhKhsPBV8f99f6Z9KQM02g33f93rNH5A30agMS46u2HP6qTdEt6Q1kg==} + /@esbuild/darwin-x64@0.25.12: + resolution: {integrity: sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==} engines: {node: '>=18'} - cpu: [loong64] - os: [linux] - - '@esbuild/linux-mips64el@0.25.5': - resolution: {integrity: sha512-kB/66P1OsHO5zLz0i6X0RxlQ+3cu0mkxS3TKFvkb5lin6uwZ/ttOkP3Z8lfR9mJOBk14ZwZ9182SIIWFGNmqmg==} - engines: {node: '>=18'} - cpu: [mips64el] - os: [linux] - - '@esbuild/linux-ppc64@0.25.5': - resolution: {integrity: sha512-UZCmJ7r9X2fe2D6jBmkLBMQetXPXIsZjQJCjgwpVDz+YMcS6oFR27alkgGv3Oqkv07bxdvw7fyB71/olceJhkQ==} - engines: {node: '>=18'} - cpu: [ppc64] - os: [linux] - - '@esbuild/linux-riscv64@0.25.5': - resolution: {integrity: sha512-kTxwu4mLyeOlsVIFPfQo+fQJAV9mh24xL+y+Bm6ej067sYANjyEw1dNHmvoqxJUCMnkBdKpvOn0Ahql6+4VyeA==} - engines: {node: '>=18'} - cpu: [riscv64] - os: [linux] - - '@esbuild/linux-s390x@0.25.5': - resolution: {integrity: sha512-K2dSKTKfmdh78uJ3NcWFiqyRrimfdinS5ErLSn3vluHNeHVnBAFWC8a4X5N+7FgVE1EjXS1QDZbpqZBjfrqMTQ==} - engines: {node: '>=18'} - cpu: [s390x] - os: [linux] + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: true + optional: true - '@esbuild/linux-x64@0.25.5': - resolution: {integrity: sha512-uhj8N2obKTE6pSZ+aMUbqq+1nXxNjZIIjCjGLfsWvVpy7gKCOL6rsY1MhRh9zLtUtAI7vpgLMK6DxjO8Qm9lJw==} + /@esbuild/darwin-x64@0.27.1: + resolution: {integrity: sha512-+3ELd+nTzhfWb07Vol7EZ+5PTbJ/u74nC6iv4/lwIU99Ip5uuY6QoIf0Hn4m2HoV0qcnRivN3KSqc+FyCHjoVQ==} engines: {node: '>=18'} cpu: [x64] - os: [linux] + os: [darwin] + requiresBuild: true + dev: true + optional: true - '@esbuild/netbsd-arm64@0.25.5': - resolution: {integrity: sha512-pwHtMP9viAy1oHPvgxtOv+OkduK5ugofNTVDilIzBLpoWAM16r7b/mxBvfpuQDpRQFMfuVr5aLcn4yveGvBZvw==} - engines: {node: '>=18'} + /@esbuild/freebsd-arm64@0.21.5: + resolution: {integrity: sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==} + engines: {node: '>=12'} cpu: [arm64] - os: [netbsd] + os: [freebsd] + requiresBuild: true + dev: true + optional: true - '@esbuild/netbsd-x64@0.25.5': - resolution: {integrity: sha512-WOb5fKrvVTRMfWFNCroYWWklbnXH0Q5rZppjq0vQIdlsQKuw6mdSihwSo4RV/YdQ5UCKKvBy7/0ZZYLBZKIbwQ==} + /@esbuild/freebsd-arm64@0.25.12: + resolution: {integrity: sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==} engines: {node: '>=18'} - cpu: [x64] - os: [netbsd] + cpu: [arm64] + os: [freebsd] + requiresBuild: true + dev: true + optional: true - '@esbuild/openbsd-arm64@0.25.5': - resolution: {integrity: sha512-7A208+uQKgTxHd0G0uqZO8UjK2R0DDb4fDmERtARjSHWxqMTye4Erz4zZafx7Di9Cv+lNHYuncAkiGFySoD+Mw==} + /@esbuild/freebsd-arm64@0.27.1: + resolution: {integrity: sha512-/8Rfgns4XD9XOSXlzUDepG8PX+AVWHliYlUkFI3K3GB6tqbdjYqdhcb4BKRd7C0BhZSoaCxhv8kTcBrcZWP+xg==} engines: {node: '>=18'} cpu: [arm64] - os: [openbsd] + os: [freebsd] + requiresBuild: true + dev: true + optional: true - '@esbuild/openbsd-x64@0.25.5': - resolution: {integrity: sha512-G4hE405ErTWraiZ8UiSoesH8DaCsMm0Cay4fsFWOOUcz8b8rC6uCvnagr+gnioEjWn0wC+o1/TAHt+It+MpIMg==} - engines: {node: '>=18'} + /@esbuild/freebsd-x64@0.21.5: + resolution: {integrity: sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==} + engines: {node: '>=12'} cpu: [x64] - os: [openbsd] + os: [freebsd] + requiresBuild: true + dev: true + optional: true - '@esbuild/sunos-x64@0.25.5': - resolution: {integrity: sha512-l+azKShMy7FxzY0Rj4RCt5VD/q8mG/e+mDivgspo+yL8zW7qEwctQ6YqKX34DTEleFAvCIUviCFX1SDZRSyMQA==} + /@esbuild/freebsd-x64@0.25.12: + resolution: {integrity: sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==} engines: {node: '>=18'} cpu: [x64] - os: [sunos] + os: [freebsd] + requiresBuild: true + dev: true + optional: true - '@esbuild/win32-arm64@0.25.5': - resolution: {integrity: sha512-O2S7SNZzdcFG7eFKgvwUEZ2VG9D/sn/eIiz8XRZ1Q/DO5a3s76Xv0mdBzVM5j5R639lXQmPmSo0iRpHqUUrsxw==} + /@esbuild/freebsd-x64@0.27.1: + resolution: {integrity: sha512-GITpD8dK9C+r+5yRT/UKVT36h/DQLOHdwGVwwoHidlnA168oD3uxA878XloXebK4Ul3gDBBIvEdL7go9gCUFzQ==} engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + requiresBuild: true + dev: true + optional: true + + /@esbuild/linux-arm64@0.21.5: + resolution: {integrity: sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==} + engines: {node: '>=12'} cpu: [arm64] - os: [win32] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@esbuild/win32-ia32@0.25.5': - resolution: {integrity: sha512-onOJ02pqs9h1iMJ1PQphR+VZv8qBMQ77Klcsqv9CNW2w6yLqoURLcgERAIurY6QE63bbLuqgP9ATqajFLK5AMQ==} + /@esbuild/linux-arm64@0.25.12: + resolution: {integrity: sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==} engines: {node: '>=18'} - cpu: [ia32] - os: [win32] + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@esbuild/win32-x64@0.25.5': - resolution: {integrity: sha512-TXv6YnJ8ZMVdX+SXWVBo/0p8LTcrUYngpWjvm91TMjjBQii7Oz11Lw5lbDV5Y0TzuhSJHwiH4hEtC1I42mMS0g==} + /@esbuild/linux-arm64@0.27.1: + resolution: {integrity: sha512-W9//kCrh/6in9rWIBdKaMtuTTzNj6jSeG/haWBADqLLa9P8O5YSRDzgD5y9QBok4AYlzS6ARHifAb75V6G670Q==} engines: {node: '>=18'} - cpu: [x64] - os: [win32] - - '@eslint-community/eslint-utils@4.7.0': - resolution: {integrity: sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw==} - engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} - peerDependencies: - eslint: ^6.0.0 || ^7.0.0 || >=8.0.0 - - '@eslint-community/regexpp@4.12.1': - resolution: {integrity: sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==} - engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0} - - '@eslint/config-array@0.20.0': - resolution: {integrity: sha512-fxlS1kkIjx8+vy2SjuCB94q3htSNrufYTXubwiBFeaQHbH6Ipi43gFJq2zCMt6PHhImH3Xmr0NksKDvchWlpQQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/config-helpers@0.2.2': - resolution: {integrity: sha512-+GPzk8PlG0sPpzdU5ZvIRMPidzAnZDl/s9L+y13iodqvb8leL53bTannOrQ/Im7UkpsmFU5Ily5U60LWixnmLg==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/core@0.14.0': - resolution: {integrity: sha512-qIbV0/JZr7iSDjqAc60IqbLdsj9GDt16xQtWD+B78d/HAlvysGdZZ6rpJHGAc2T0FQx1X6thsSPdnoiGKdNtdg==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/eslintrc@3.3.1': - resolution: {integrity: sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/js@9.28.0': - resolution: {integrity: sha512-fnqSjGWd/CoIp4EXIxWVK/sHA6DOHN4+8Ix2cX5ycOY7LG0UY8nHCU5pIp2eaE1Mc7Qd8kHspYNzYXT2ojPLzg==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/object-schema@2.1.6': - resolution: {integrity: sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@eslint/plugin-kit@0.3.1': - resolution: {integrity: sha512-0J+zgWxHN+xXONWIyPWKFMgVuJoZuGiIFu8yxk7RJjxkzpGmyja5wRFqZIVtjDVOQpV+Rw0iOAjYPE2eQyjr0w==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@fastify/ajv-compiler@4.0.2': - resolution: {integrity: sha512-Rkiu/8wIjpsf46Rr+Fitd3HRP+VsxUFDDeag0hs9L0ksfnwx2g7SPQQTFL0E8Qv+rfXzQOxBJnjUB9ITUDjfWQ==} - - '@fastify/cors@11.0.1': - resolution: {integrity: sha512-dmZaE7M1f4SM8ZZuk5RhSsDJ+ezTgI7v3HHRj8Ow9CneczsPLZV6+2j2uwdaSLn8zhTv6QV0F4ZRcqdalGx1pQ==} - - '@fastify/error@4.2.0': - resolution: {integrity: sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==} - - '@fastify/fast-json-stringify-compiler@5.0.3': - resolution: {integrity: sha512-uik7yYHkLr6fxd8hJSZ8c+xF4WafPK+XzneQDPU+D10r5X19GW8lJcom2YijX2+qtFF1ENJlHXKFM9ouXNJYgQ==} - - '@fastify/forwarded@3.0.0': - resolution: {integrity: sha512-kJExsp4JCms7ipzg7SJ3y8DwmePaELHxKYtg+tZow+k0znUTf3cb+npgyqm8+ATZOdmfgfydIebPDWM172wfyA==} - - '@fastify/merge-json-schemas@0.2.1': - resolution: {integrity: sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@fastify/proxy-addr@5.0.0': - resolution: {integrity: sha512-37qVVA1qZ5sgH7KpHkkC4z9SK6StIsIcOmpjvMPXNb3vx2GQxhZocogVYbr2PbbeLCQxYIPDok307xEvRZOzGA==} + /@esbuild/linux-arm@0.21.5: + resolution: {integrity: sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==} + engines: {node: '>=12'} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@huggingface/jinja@0.2.2': - resolution: {integrity: sha512-/KPde26khDUIPkTGU82jdtTW9UAuvUTumCAbFs/7giR0SxsvZC4hru51PBvpijH6BVkHcROcvZM/lpy5h1jRRA==} + /@esbuild/linux-arm@0.25.12: + resolution: {integrity: sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==} engines: {node: '>=18'} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@humanfs/core@0.19.1': - resolution: {integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==} - engines: {node: '>=18.18.0'} - - '@humanfs/node@0.16.6': - resolution: {integrity: sha512-YuI2ZHQL78Q5HbhDiBA1X4LmYdXCKCMQIfw0pw7piHJwyREFebJUvrQN4cMssyES6x+vfUbx1CIpaQUKYdQZOw==} - engines: {node: '>=18.18.0'} - - '@humanwhocodes/module-importer@1.0.1': - resolution: {integrity: sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==} - engines: {node: '>=12.22'} - - '@humanwhocodes/retry@0.3.1': - resolution: {integrity: sha512-JBxkERygn7Bv/GbN5Rv8Ul6LVknS+5Bp6RgDC/O8gEBU/yeH5Ui5C/OlWrTb6qct7LjjfT6Re2NxB0ln0yYybA==} - engines: {node: '>=18.18'} - - '@humanwhocodes/retry@0.4.3': - resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==} - engines: {node: '>=18.18'} + /@esbuild/linux-arm@0.27.1: + resolution: {integrity: sha512-ieMID0JRZY/ZeCrsFQ3Y3NlHNCqIhTprJfDgSB3/lv5jJZ8FX3hqPyXWhe+gvS5ARMBJ242PM+VNz/ctNj//eA==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@isaacs/cliui@8.0.2': - resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==} + /@esbuild/linux-ia32@0.21.5: + resolution: {integrity: sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==} engines: {node: '>=12'} + cpu: [ia32] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@istanbuljs/load-nyc-config@1.1.0': - resolution: {integrity: sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==} - engines: {node: '>=8'} - - '@istanbuljs/schema@0.1.3': - resolution: {integrity: sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==} - engines: {node: '>=8'} - - '@jest/console@29.7.0': - resolution: {integrity: sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/core@29.7.0': - resolution: {integrity: sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - peerDependencies: - node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 - peerDependenciesMeta: - node-notifier: - optional: true - - '@jest/environment@29.7.0': - resolution: {integrity: sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/expect-utils@29.7.0': - resolution: {integrity: sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/expect@29.7.0': - resolution: {integrity: sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/fake-timers@29.7.0': - resolution: {integrity: sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/globals@29.7.0': - resolution: {integrity: sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/reporters@29.7.0': - resolution: {integrity: sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - peerDependencies: - node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 - peerDependenciesMeta: - node-notifier: - optional: true - - '@jest/schemas@29.6.3': - resolution: {integrity: sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/source-map@29.6.3': - resolution: {integrity: sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/test-result@29.7.0': - resolution: {integrity: sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/test-sequencer@29.7.0': - resolution: {integrity: sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/transform@29.7.0': - resolution: {integrity: sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jest/types@29.6.3': - resolution: {integrity: sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - '@jridgewell/gen-mapping@0.3.8': - resolution: {integrity: sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==} - engines: {node: '>=6.0.0'} - - '@jridgewell/resolve-uri@3.1.2': - resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==} - engines: {node: '>=6.0.0'} - - '@jridgewell/set-array@1.2.1': - resolution: {integrity: sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==} - engines: {node: '>=6.0.0'} - - '@jridgewell/sourcemap-codec@1.5.0': - resolution: {integrity: sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==} - - '@jridgewell/trace-mapping@0.3.25': - resolution: {integrity: sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==} - - '@jridgewell/trace-mapping@0.3.9': - resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==} - - '@modelcontextprotocol/sdk@1.12.1': - resolution: {integrity: sha512-KG1CZhZfWg+u8pxeM/mByJDScJSrjjxLc8fwQqbsS8xCjBmQfMNEBTotYdNanKekepnfRI85GtgQlctLFpcYPw==} + /@esbuild/linux-ia32@0.25.12: + resolution: {integrity: sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==} engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@noble/hashes@1.8.0': - resolution: {integrity: sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==} - engines: {node: ^14.21.3 || >=16} - - '@nodelib/fs.scandir@2.1.5': - resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==} - engines: {node: '>= 8'} - - '@nodelib/fs.stat@2.0.5': - resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==} - engines: {node: '>= 8'} - - '@nodelib/fs.walk@1.2.8': - resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==} - engines: {node: '>= 8'} - - '@paralleldrive/cuid2@2.2.2': - resolution: {integrity: sha512-ZOBkgDwEdoYVlSeRbYYXs0S9MejQofiVYoTbKzy/6GQa39/q5tQU2IX46+shYnUkpEl3wc+J6wRlar7r2EK2xA==} + /@esbuild/linux-ia32@0.27.1: + resolution: {integrity: sha512-VIUV4z8GD8rtSVMfAj1aXFahsi/+tcoXXNYmXgzISL+KB381vbSTNdeZHHHIYqFyXcoEhu9n5cT+05tRv13rlw==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@pkgjs/parseargs@0.11.0': - resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==} - engines: {node: '>=14'} + /@esbuild/linux-loong64@0.21.5: + resolution: {integrity: sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==} + engines: {node: '>=12'} + cpu: [loong64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@pnpm/config.env-replace@1.1.0': - resolution: {integrity: sha512-htyl8TWnKL7K/ESFa1oW2UB5lVDxuF5DpM7tBi6Hu2LNL3mWkIzNLG6N4zoCUP1lCKNxWy/3iu8mS8MvToGd6w==} - engines: {node: '>=12.22.0'} + /@esbuild/linux-loong64@0.25.12: + resolution: {integrity: sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@pnpm/network.ca-file@1.0.2': - resolution: {integrity: sha512-YcPQ8a0jwYU9bTdJDpXjMi7Brhkr1mXsXrUJvjqM2mQDgkRiz8jFaQGOdaLxgjtUfQgZhKy/O3cG/YwmgKaxLA==} - engines: {node: '>=12.22.0'} + /@esbuild/linux-loong64@0.27.1: + resolution: {integrity: sha512-l4rfiiJRN7sTNI//ff65zJ9z8U+k6zcCg0LALU5iEWzY+a1mVZ8iWC1k5EsNKThZ7XCQ6YWtsZ8EWYm7r1UEsg==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@pnpm/npm-conf@2.3.1': - resolution: {integrity: sha512-c83qWb22rNRuB0UaVCI0uRPNRr8Z0FWnEIvT47jiHAmOIUHbBOg5XvV7pM5x+rKn9HRpjxquDbXYSXr3fAKFcw==} + /@esbuild/linux-mips64el@0.21.5: + resolution: {integrity: sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==} engines: {node: '>=12'} + cpu: [mips64el] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/aspromise@1.1.2': - resolution: {integrity: sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==} - - '@protobufjs/base64@1.1.2': - resolution: {integrity: sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==} + /@esbuild/linux-mips64el@0.25.12: + resolution: {integrity: sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/codegen@2.0.4': - resolution: {integrity: sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==} + /@esbuild/linux-mips64el@0.27.1: + resolution: {integrity: sha512-U0bEuAOLvO/DWFdygTHWY8C067FXz+UbzKgxYhXC0fDieFa0kDIra1FAhsAARRJbvEyso8aAqvPdNxzWuStBnA==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/eventemitter@1.1.0': - resolution: {integrity: sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==} + /@esbuild/linux-ppc64@0.21.5: + resolution: {integrity: sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==} + engines: {node: '>=12'} + cpu: [ppc64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/fetch@1.1.0': - resolution: {integrity: sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==} + /@esbuild/linux-ppc64@0.25.12: + resolution: {integrity: sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/float@1.0.2': - resolution: {integrity: sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==} + /@esbuild/linux-ppc64@0.27.1: + resolution: {integrity: sha512-NzdQ/Xwu6vPSf/GkdmRNsOfIeSGnh7muundsWItmBsVpMoNPVpM61qNzAVY3pZ1glzzAxLR40UyYM23eaDDbYQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@protobufjs/inquire@1.1.0': - resolution: {integrity: sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==} - - '@protobufjs/path@1.1.2': - resolution: {integrity: sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==} - - '@protobufjs/pool@1.1.0': - resolution: {integrity: sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==} - - '@protobufjs/utf8@1.1.0': - resolution: {integrity: sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==} - - '@rollup/rollup-android-arm-eabi@4.42.0': - resolution: {integrity: sha512-gldmAyS9hpj+H6LpRNlcjQWbuKUtb94lodB9uCz71Jm+7BxK1VIOo7y62tZZwxhA7j1ylv/yQz080L5WkS+LoQ==} - cpu: [arm] - os: [android] - - '@rollup/rollup-android-arm64@4.42.0': - resolution: {integrity: sha512-bpRipfTgmGFdCZDFLRvIkSNO1/3RGS74aWkJJTFJBH7h3MRV4UijkaEUeOMbi9wxtxYmtAbVcnMtHTPBhLEkaw==} - cpu: [arm64] - os: [android] - - '@rollup/rollup-darwin-arm64@4.42.0': - resolution: {integrity: sha512-JxHtA081izPBVCHLKnl6GEA0w3920mlJPLh89NojpU2GsBSB6ypu4erFg/Wx1qbpUbepn0jY4dVWMGZM8gplgA==} - cpu: [arm64] - os: [darwin] - - '@rollup/rollup-darwin-x64@4.42.0': - resolution: {integrity: sha512-rv5UZaWVIJTDMyQ3dCEK+m0SAn6G7H3PRc2AZmExvbDvtaDc+qXkei0knQWcI3+c9tEs7iL/4I4pTQoPbNL2SA==} - cpu: [x64] - os: [darwin] - - '@rollup/rollup-freebsd-arm64@4.42.0': - resolution: {integrity: sha512-fJcN4uSGPWdpVmvLuMtALUFwCHgb2XiQjuECkHT3lWLZhSQ3MBQ9pq+WoWeJq2PrNxr9rPM1Qx+IjyGj8/c6zQ==} - cpu: [arm64] - os: [freebsd] - - '@rollup/rollup-freebsd-x64@4.42.0': - resolution: {integrity: sha512-CziHfyzpp8hJpCVE/ZdTizw58gr+m7Y2Xq5VOuCSrZR++th2xWAz4Nqk52MoIIrV3JHtVBhbBsJcAxs6NammOQ==} - cpu: [x64] - os: [freebsd] - - '@rollup/rollup-linux-arm-gnueabihf@4.42.0': - resolution: {integrity: sha512-UsQD5fyLWm2Fe5CDM7VPYAo+UC7+2Px4Y+N3AcPh/LdZu23YcuGPegQly++XEVaC8XUTFVPscl5y5Cl1twEI4A==} - cpu: [arm] - os: [linux] - - '@rollup/rollup-linux-arm-musleabihf@4.42.0': - resolution: {integrity: sha512-/i8NIrlgc/+4n1lnoWl1zgH7Uo0XK5xK3EDqVTf38KvyYgCU/Rm04+o1VvvzJZnVS5/cWSd07owkzcVasgfIkQ==} - cpu: [arm] - os: [linux] - - '@rollup/rollup-linux-arm64-gnu@4.42.0': - resolution: {integrity: sha512-eoujJFOvoIBjZEi9hJnXAbWg+Vo1Ov8n/0IKZZcPZ7JhBzxh2A+2NFyeMZIRkY9iwBvSjloKgcvnjTbGKHE44Q==} - cpu: [arm64] - os: [linux] - - '@rollup/rollup-linux-arm64-musl@4.42.0': - resolution: {integrity: sha512-/3NrcOWFSR7RQUQIuZQChLND36aTU9IYE4j+TB40VU78S+RA0IiqHR30oSh6P1S9f9/wVOenHQnacs/Byb824g==} - cpu: [arm64] - os: [linux] - - '@rollup/rollup-linux-loongarch64-gnu@4.42.0': - resolution: {integrity: sha512-O8AplvIeavK5ABmZlKBq9/STdZlnQo7Sle0LLhVA7QT+CiGpNVe197/t8Aph9bhJqbDVGCHpY2i7QyfEDDStDg==} - cpu: [loong64] - os: [linux] - - '@rollup/rollup-linux-powerpc64le-gnu@4.42.0': - resolution: {integrity: sha512-6Qb66tbKVN7VyQrekhEzbHRxXXFFD8QKiFAwX5v9Xt6FiJ3BnCVBuyBxa2fkFGqxOCSGGYNejxd8ht+q5SnmtA==} - cpu: [ppc64] - os: [linux] - - '@rollup/rollup-linux-riscv64-gnu@4.42.0': - resolution: {integrity: sha512-KQETDSEBamQFvg/d8jajtRwLNBlGc3aKpaGiP/LvEbnmVUKlFta1vqJqTrvPtsYsfbE/DLg5CC9zyXRX3fnBiA==} - cpu: [riscv64] - os: [linux] - - '@rollup/rollup-linux-riscv64-musl@4.42.0': - resolution: {integrity: sha512-qMvnyjcU37sCo/tuC+JqeDKSuukGAd+pVlRl/oyDbkvPJ3awk6G6ua7tyum02O3lI+fio+eM5wsVd66X0jQtxw==} - cpu: [riscv64] - os: [linux] - - '@rollup/rollup-linux-s390x-gnu@4.42.0': - resolution: {integrity: sha512-I2Y1ZUgTgU2RLddUHXTIgyrdOwljjkmcZ/VilvaEumtS3Fkuhbw4p4hgHc39Ypwvo2o7sBFNl2MquNvGCa55Iw==} - cpu: [s390x] - os: [linux] - - '@rollup/rollup-linux-x64-gnu@4.42.0': - resolution: {integrity: sha512-Gfm6cV6mj3hCUY8TqWa63DB8Mx3NADoFwiJrMpoZ1uESbK8FQV3LXkhfry+8bOniq9pqY1OdsjFWNsSbfjPugw==} - cpu: [x64] - os: [linux] - - '@rollup/rollup-linux-x64-musl@4.42.0': - resolution: {integrity: sha512-g86PF8YZ9GRqkdi0VoGlcDUb4rYtQKyTD1IVtxxN4Hpe7YqLBShA7oHMKU6oKTCi3uxwW4VkIGnOaH/El8de3w==} - cpu: [x64] - os: [linux] - - '@rollup/rollup-win32-arm64-msvc@4.42.0': - resolution: {integrity: sha512-+axkdyDGSp6hjyzQ5m1pgcvQScfHnMCcsXkx8pTgy/6qBmWVhtRVlgxjWwDp67wEXXUr0x+vD6tp5W4x6V7u1A==} - cpu: [arm64] - os: [win32] - - '@rollup/rollup-win32-ia32-msvc@4.42.0': - resolution: {integrity: sha512-F+5J9pelstXKwRSDq92J0TEBXn2nfUrQGg+HK1+Tk7VOL09e0gBqUHugZv7SW4MGrYj41oNCUe3IKCDGVlis2g==} - cpu: [ia32] - os: [win32] - - '@rollup/rollup-win32-x64-msvc@4.42.0': - resolution: {integrity: sha512-LpHiJRwkaVz/LqjHjK8LCi8osq7elmpwujwbXKNW88bM8eeGxavJIKKjkjpMHAh/2xfnrt1ZSnhTv41WYUHYmA==} - cpu: [x64] - os: [win32] - - '@sinclair/typebox@0.27.8': - resolution: {integrity: sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==} - - '@sinonjs/commons@3.0.1': - resolution: {integrity: sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==} - - '@sinonjs/fake-timers@10.3.0': - resolution: {integrity: sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==} - - '@tsconfig/node10@1.0.11': - resolution: {integrity: sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==} - - '@tsconfig/node12@1.0.11': - resolution: {integrity: sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==} - - '@tsconfig/node14@1.0.3': - resolution: {integrity: sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==} - - '@tsconfig/node16@1.0.4': - resolution: {integrity: sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==} - - '@types/babel__core@7.20.5': - resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==} - - '@types/babel__generator@7.27.0': - resolution: {integrity: sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==} - - '@types/babel__template@7.4.4': - resolution: {integrity: sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==} - - '@types/babel__traverse@7.20.7': - resolution: {integrity: sha512-dkO5fhS7+/oos4ciWxyEyjWe48zmG6wbCheo/G2ZnHx4fs3EU6YC6UM8rk56gAjNJ9P3MTH2jo5jb92/K6wbng==} - - '@types/chrome@0.0.318': - resolution: {integrity: sha512-rrtyYQ1t+g7EyG0FejE+UXQBjSGUHGh0RIdXwUT/laPo9T724NOIgXA94ns6ewmNauwijYa5ck3+dBxWnHcynQ==} - - '@types/conventional-commits-parser@5.0.1': - resolution: {integrity: sha512-7uz5EHdzz2TqoMfV7ee61Egf5y6NkcO4FB/1iCCQnbeiI1F3xzv3vK5dBCXUCLQgGYS+mUeigK1iKQzvED+QnQ==} - - '@types/cookiejar@2.1.5': - resolution: {integrity: sha512-he+DHOWReW0nghN24E1WUqM0efK4kI9oTqDm6XmK8ZPe2djZ90BSNdGnIyCLzCPw7/pogPlGbzI2wHGGmi4O/Q==} - - '@types/estree@1.0.7': - resolution: {integrity: sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==} - - '@types/estree@1.0.8': - resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==} - - '@types/filesystem@0.0.36': - resolution: {integrity: sha512-vPDXOZuannb9FZdxgHnqSwAG/jvdGM8Wq+6N4D/d80z+D4HWH+bItqsZaVRQykAn6WEVeEkLm2oQigyHtgb0RA==} - - '@types/filewriter@0.0.33': - resolution: {integrity: sha512-xFU8ZXTw4gd358lb2jw25nxY9QAgqn2+bKKjKOYfNCzN4DKCFetK7sPtrlpg66Ywe3vWY9FNxprZawAh9wfJ3g==} - - '@types/graceful-fs@4.1.9': - resolution: {integrity: sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==} - - '@types/har-format@1.2.16': - resolution: {integrity: sha512-fluxdy7ryD3MV6h8pTfTYpy/xQzCFC7m89nOH9y94cNqJ1mDIDPut7MnRHI3F6qRmh/cT2fUjG1MLdCNb4hE9A==} - - '@types/istanbul-lib-coverage@2.0.6': - resolution: {integrity: sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==} - - '@types/istanbul-lib-report@3.0.3': - resolution: {integrity: sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==} - - '@types/istanbul-reports@3.0.4': - resolution: {integrity: sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==} - - '@types/jest@29.5.14': - resolution: {integrity: sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==} - - '@types/json-schema@7.0.15': - resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==} - - '@types/long@4.0.2': - resolution: {integrity: sha512-MqTGEo5bj5t157U6fA/BiDynNkn0YknVdh48CMPkTSpFTVmvao5UQmm7uEF6xBEo7qIMAlY/JSleYaE6VOdpaA==} - - '@types/methods@1.1.4': - resolution: {integrity: sha512-ymXWVrDiCxTBE3+RIrrP533E70eA+9qu7zdWoHuOmGujkYtzf4HQF96b8nwHLqhuf4ykX61IGRIB38CC6/sImQ==} - - '@types/minimatch@3.0.5': - resolution: {integrity: sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ==} - - '@types/node-fetch@2.6.13': - resolution: {integrity: sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==} - - '@types/node@18.19.111': - resolution: {integrity: sha512-90sGdgA+QLJr1F9X79tQuEut0gEYIfkX9pydI4XGRgvFo9g2JWswefI+WUSUHPYVBHYSEfTEqBxA5hQvAZB3Mw==} - - '@types/node@22.15.30': - resolution: {integrity: sha512-6Q7lr06bEHdlfplU6YRbgG1SFBdlsfNC4/lX+SkhiTs0cpJkOElmWls8PxDFv4yY/xKb8Y6SO0OmSX4wgqTZbA==} - - '@types/stack-utils@2.0.3': - resolution: {integrity: sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==} - - '@types/superagent@8.1.9': - resolution: {integrity: sha512-pTVjI73witn+9ILmoJdajHGW2jkSaOzhiFYF1Rd3EQ94kymLqB9PjD9ISg7WaALC7+dCHT0FGe9T2LktLq/3GQ==} - - '@types/supertest@6.0.3': - resolution: {integrity: sha512-8WzXq62EXFhJ7QsH3Ocb/iKQ/Ty9ZVWnVzoTKc9tyyFRRF3a74Tk2+TLFgaFFw364Ere+npzHKEJ6ga2LzIL7w==} - - '@types/yargs-parser@21.0.3': - resolution: {integrity: sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==} - - '@types/yargs@17.0.33': - resolution: {integrity: sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==} - - '@types/yauzl@2.10.3': - resolution: {integrity: sha512-oJoftv0LSuaDZE3Le4DbKX+KS9G36NzOeSap90UIK0yMA/NhKJhqlSGtNDORNRaIbQfzjXDrQa0ytJ6mNRGz/Q==} - - '@typescript-eslint/eslint-plugin@8.33.1': - resolution: {integrity: sha512-TDCXj+YxLgtvxvFlAvpoRv9MAncDLBV2oT9Bd7YBGC/b/sEURoOYuIwLI99rjWOfY3QtDzO+mk0n4AmdFExW8A==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - '@typescript-eslint/parser': ^8.33.1 - eslint: ^8.57.0 || ^9.0.0 - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/parser@8.33.1': - resolution: {integrity: sha512-qwxv6dq682yVvgKKp2qWwLgRbscDAYktPptK4JPojCwwi3R9cwrvIxS4lvBpzmcqzR4bdn54Z0IG1uHFskW4dA==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/project-service@8.33.1': - resolution: {integrity: sha512-DZR0efeNklDIHHGRpMpR5gJITQpu6tLr9lDJnKdONTC7vvzOlLAG/wcfxcdxEWrbiZApcoBCzXqU/Z458Za5Iw==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/scope-manager@8.33.1': - resolution: {integrity: sha512-dM4UBtgmzHR9bS0Rv09JST0RcHYearoEoo3pG5B6GoTR9XcyeqX87FEhPo+5kTvVfKCvfHaHrcgeJQc6mrDKrA==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@typescript-eslint/tsconfig-utils@8.33.1': - resolution: {integrity: sha512-STAQsGYbHCF0/e+ShUQ4EatXQ7ceh3fBCXkNU7/MZVKulrlq1usH7t2FhxvCpuCi5O5oi1vmVaAjrGeL71OK1g==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/type-utils@8.33.1': - resolution: {integrity: sha512-1cG37d9xOkhlykom55WVwG2QRNC7YXlxMaMzqw2uPeJixBFfKWZgaP/hjAObqMN/u3fr5BrTwTnc31/L9jQ2ww==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/types@8.33.1': - resolution: {integrity: sha512-xid1WfizGhy/TKMTwhtVOgalHwPtV8T32MS9MaH50Cwvz6x6YqRIPdD2WvW0XaqOzTV9p5xdLY0h/ZusU5Lokg==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@typescript-eslint/typescript-estree@8.33.1': - resolution: {integrity: sha512-+s9LYcT8LWjdYWu7IWs7FvUxpQ/DGkdjZeE/GGulHvv8rvYwQvVaUZ6DE+j5x/prADUgSbbCWZ2nPI3usuVeOA==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/utils@8.33.1': - resolution: {integrity: sha512-52HaBiEQUaRYqAXpfzWSR2U3gxk92Kw006+xZpElaPMg3C4PgM+A5LqwoQI1f9E5aZ/qlxAZxzm42WX+vn92SQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - typescript: '>=4.8.4 <5.9.0' - - '@typescript-eslint/visitor-keys@8.33.1': - resolution: {integrity: sha512-3i8NrFcZeeDHJ+7ZUuDkGT+UHq+XoFGsymNK2jZCOHcfEzRQ0BdpRtdpSx/Iyf3MHLWIcLS0COuOPibKQboIiQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - '@vitejs/plugin-vue@5.2.4': - resolution: {integrity: sha512-7Yx/SXSOcQq5HiiV3orevHUFn+pmMB4cgbEkDYgnkUWb0WfeQ/wa2yFv6D5ICiCQOVpjA7vYDXrC7AGO8yjDHA==} - engines: {node: ^18.0.0 || >=20.0.0} - peerDependencies: - vite: ^5.0.0 || ^6.0.0 - vue: ^3.2.25 - - '@volar/language-core@2.4.14': - resolution: {integrity: sha512-X6beusV0DvuVseaOEy7GoagS4rYHgDHnTrdOj5jeUb49fW5ceQyP9Ej5rBhqgz2wJggl+2fDbbojq1XKaxDi6w==} - - '@volar/source-map@2.4.14': - resolution: {integrity: sha512-5TeKKMh7Sfxo8021cJfmBzcjfY1SsXsPMMjMvjY7ivesdnybqqS+GxGAoXHAOUawQTwtdUxgP65Im+dEmvWtYQ==} - - '@volar/typescript@2.4.14': - resolution: {integrity: sha512-p8Z6f/bZM3/HyCdRNFZOEEzts51uV8WHeN8Tnfnm2EBv6FDB2TQLzfVx7aJvnl8ofKAOnS64B2O8bImBFaauRw==} - - '@vue/compiler-core@3.5.16': - resolution: {integrity: sha512-AOQS2eaQOaaZQoL1u+2rCJIKDruNXVBZSiUD3chnUrsoX5ZTQMaCvXlWNIfxBJuU15r1o7+mpo5223KVtIhAgQ==} - - '@vue/compiler-dom@3.5.16': - resolution: {integrity: sha512-SSJIhBr/teipXiXjmWOVWLnxjNGo65Oj/8wTEQz0nqwQeP75jWZ0n4sF24Zxoht1cuJoWopwj0J0exYwCJ0dCQ==} - - '@vue/compiler-sfc@3.5.16': - resolution: {integrity: sha512-rQR6VSFNpiinDy/DVUE0vHoIDUF++6p910cgcZoaAUm3POxgNOOdS/xgoll3rNdKYTYPnnbARDCZOyZ+QSe6Pw==} - - '@vue/compiler-ssr@3.5.16': - resolution: {integrity: sha512-d2V7kfxbdsjrDSGlJE7my1ZzCXViEcqN6w14DOsDrUCHEA6vbnVCpRFfrc4ryCP/lCKzX2eS1YtnLE/BuC9f/A==} - - '@vue/compiler-vue2@2.7.16': - resolution: {integrity: sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==} - - '@vue/language-core@2.2.10': - resolution: {integrity: sha512-+yNoYx6XIKuAO8Mqh1vGytu8jkFEOH5C8iOv3i8Z/65A7x9iAOXA97Q+PqZ3nlm2lxf5rOJuIGI/wDtx/riNYw==} - peerDependencies: - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true - - '@vue/reactivity@3.5.16': - resolution: {integrity: sha512-FG5Q5ee/kxhIm1p2bykPpPwqiUBV3kFySsHEQha5BJvjXdZTUfmya7wP7zC39dFuZAcf/PD5S4Lni55vGLMhvA==} - - '@vue/runtime-core@3.5.16': - resolution: {integrity: sha512-bw5Ykq6+JFHYxrQa7Tjr+VSzw7Dj4ldR/udyBZbq73fCdJmyy5MPIFR9IX/M5Qs+TtTjuyUTCnmK3lWWwpAcFQ==} - - '@vue/runtime-dom@3.5.16': - resolution: {integrity: sha512-T1qqYJsG2xMGhImRUV9y/RseB9d0eCYZQ4CWca9ztCuiPj/XWNNN+lkNBuzVbia5z4/cgxdL28NoQCvC0Xcfww==} - - '@vue/server-renderer@3.5.16': - resolution: {integrity: sha512-BrX0qLiv/WugguGsnQUJiYOE0Fe5mZTwi6b7X/ybGB0vfrPH9z0gD/Y6WOR1sGCgX4gc25L1RYS5eYQKDMoNIg==} - peerDependencies: - vue: 3.5.16 - - '@vue/shared@3.5.16': - resolution: {integrity: sha512-c/0fWy3Jw6Z8L9FmTyYfkpM5zklnqqa9+a6dz3DvONRKW2NEbh46BP0FHuLFSWi2TnQEtp91Z6zOWNrU6QiyPg==} - - '@webext-core/fake-browser@1.3.2': - resolution: {integrity: sha512-jFyPWWz+VkHAC9DRIiIPOyu6X/KlC8dYqSKweHz6tsDb86QawtVgZSpYcM+GOQBlZc5DHFo92jJ7cIq4uBnU0A==} - - '@webext-core/isolated-element@1.1.2': - resolution: {integrity: sha512-CNHYhsIR8TPkPb+4yqTIuzaGnVn/Fshev5fyoPW+/8Cyc93tJbCjP9PC1XSK6fDWu+xASdPHLZaoa2nWAYoxeQ==} - - '@webext-core/match-patterns@1.0.3': - resolution: {integrity: sha512-NY39ACqCxdKBmHgw361M9pfJma8e4AZo20w9AY+5ZjIj1W2dvXC8J31G5fjfOGbulW9w4WKpT8fPooi0mLkn9A==} - - '@wxt-dev/browser@0.0.326': - resolution: {integrity: sha512-4Pb4ES7jMsxYFHEEhK005bOL2BnDEXO3jjZTOvF0gWdota8Ytpg81VtKVSC1ohj17C6tE6oNI3FdcVRfKUBl3Q==} - - '@wxt-dev/module-vue@1.0.2': - resolution: {integrity: sha512-eRRpPgrakgQSfzR8AnmT3+Dd/ltgghOzgfy1MrHl0zZ2Pc2rcuwcoeFt9rrpjH3KuvZfYD2JIAg3gY9OlTPkmQ==} - peerDependencies: - wxt: '>=0.19.16' - - '@wxt-dev/storage@1.1.1': - resolution: {integrity: sha512-H1vYWeoWz03INV4r+sLYDFil88b3rgMMfgGp/EXy3bLbveJeiMiFs/G0bsBN2Ra87Iqlf2oVYRb/ABQpAugbew==} - - '@xenova/transformers@2.17.2': - resolution: {integrity: sha512-lZmHqzrVIkSvZdKZEx7IYY51TK0WDrC8eR0c5IMnBsO8di8are1zzw8BlLhyO2TklZKLN5UffNGs1IJwT6oOqQ==} - - JSONStream@1.3.5: - resolution: {integrity: sha512-E+iruNOY8VV9s4JEbe1aNEm6MiszPRr/UfcHMz0TQh1BXSxHK+ASV1R6W4HpjBhSeS+54PIsAMCBmwD06LLsqQ==} - hasBin: true - - abstract-logging@2.0.1: - resolution: {integrity: sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA==} - - accepts@2.0.0: - resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==} - engines: {node: '>= 0.6'} - - acorn-jsx@5.3.2: - resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==} - peerDependencies: - acorn: ^6.0.0 || ^7.0.0 || ^8.0.0 - - acorn-walk@8.3.4: - resolution: {integrity: sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==} - engines: {node: '>=0.4.0'} - - acorn@8.15.0: - resolution: {integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==} - engines: {node: '>=0.4.0'} - hasBin: true - - adm-zip@0.5.16: - resolution: {integrity: sha512-TGw5yVi4saajsSEgz25grObGHEUaDrniwvA2qwSC060KfqGPdglhvPMA2lPIoxs3PQIItj2iag35fONcQqgUaQ==} - engines: {node: '>=12.0'} - - ajv-formats@3.0.1: - resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==} - peerDependencies: - ajv: ^8.0.0 - peerDependenciesMeta: - ajv: - optional: true - - ajv@6.12.6: - resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==} - - ajv@8.17.1: - resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==} - - alien-signals@1.0.13: - resolution: {integrity: sha512-OGj9yyTnJEttvzhTUWuscOvtqxq5vrhF7vL9oS0xJ2mK0ItPYP1/y+vCFebfxoEyAz0++1AIwJ5CMr+Fk3nDmg==} - - ansi-align@3.0.1: - resolution: {integrity: sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==} - - ansi-escapes@4.3.2: - resolution: {integrity: sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==} - engines: {node: '>=8'} - - ansi-escapes@7.0.0: - resolution: {integrity: sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw==} - engines: {node: '>=18'} - - ansi-regex@5.0.1: - resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==} - engines: {node: '>=8'} - - ansi-regex@6.1.0: - resolution: {integrity: sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==} - engines: {node: '>=12'} - - ansi-styles@4.3.0: - resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==} - engines: {node: '>=8'} - - ansi-styles@5.2.0: - resolution: {integrity: sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==} - engines: {node: '>=10'} - - ansi-styles@6.2.1: - resolution: {integrity: sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==} - engines: {node: '>=12'} - - any-promise@1.3.0: - resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==} - - anymatch@3.1.3: - resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==} - engines: {node: '>= 8'} - - arg@4.1.3: - resolution: {integrity: sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==} - - argparse@1.0.10: - resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==} - - argparse@2.0.1: - resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==} - - array-differ@4.0.0: - resolution: {integrity: sha512-Q6VPTLMsmXZ47ENG3V+wQyZS1ZxXMxFyYzA+Z/GMrJ6yIutAIEf9wTyroTzmGjNfox9/h3GdGBCVh43GVFx4Uw==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - array-ify@1.0.0: - resolution: {integrity: sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==} - - array-union@3.0.1: - resolution: {integrity: sha512-1OvF9IbWwaeiM9VhzYXVQacMibxpXOMYVNIvMtKRyX9SImBXpKcFr8XvFDeEslCyuH/t6KRt7HEO94AlP8Iatw==} - engines: {node: '>=12'} - - asap@2.0.6: - resolution: {integrity: sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==} - - async-mutex@0.5.0: - resolution: {integrity: sha512-1A94B18jkJ3DYq284ohPxoXbfTA5HsQ7/Mf4DEhcyLx3Bz27Rh59iScbB6EPiP+B+joue6YCxcMXSbFC1tZKwA==} - - async@3.2.6: - resolution: {integrity: sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==} - - asynckit@0.4.0: - resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==} - - atomic-sleep@1.0.0: - resolution: {integrity: sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==} - engines: {node: '>=8.0.0'} - - atomically@2.0.3: - resolution: {integrity: sha512-kU6FmrwZ3Lx7/7y3hPS5QnbJfaohcIul5fGqf7ok+4KklIEk9tJ0C2IQPdacSbVUWv6zVHXEBWoWd6NrVMT7Cw==} - - avvio@9.1.0: - resolution: {integrity: sha512-fYASnYi600CsH/j9EQov7lECAniYiBFiiAtBNuZYLA2leLe9qOvZzqYHFjtIj6gD2VMoMLP14834LFWvr4IfDw==} - - b4a@1.6.7: - resolution: {integrity: sha512-OnAYlL5b7LEkALw87fUVafQw5rVR9RjwGd4KUwNQ6DrrNmaVaUCgLipfVlzrPQ4tWOR9P0IXGNOx50jYCCdSJg==} - - babel-jest@29.7.0: - resolution: {integrity: sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - peerDependencies: - '@babel/core': ^7.8.0 - - babel-plugin-istanbul@6.1.1: - resolution: {integrity: sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==} - engines: {node: '>=8'} - - babel-plugin-jest-hoist@29.6.3: - resolution: {integrity: sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - babel-preset-current-node-syntax@1.1.0: - resolution: {integrity: sha512-ldYss8SbBlWva1bs28q78Ju5Zq1F+8BrqBZZ0VFhLBvhh6lCpC2o3gDJi/5DRLs9FgYZCnmPYIVFU4lRXCkyUw==} - peerDependencies: - '@babel/core': ^7.0.0 - - babel-preset-jest@29.6.3: - resolution: {integrity: sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - peerDependencies: - '@babel/core': ^7.0.0 - - balanced-match@1.0.2: - resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==} - - bare-events@2.5.4: - resolution: {integrity: sha512-+gFfDkR8pj4/TrWCGUGWmJIkBwuxPS5F+a5yWjOHQt2hHvNZd5YLzadjmDUtFmMM4y429bnKLa8bYBMHcYdnQA==} - - bare-fs@4.1.5: - resolution: {integrity: sha512-1zccWBMypln0jEE05LzZt+V/8y8AQsQQqxtklqaIyg5nu6OAYFhZxPXinJTSG+kU5qyNmeLgcn9AW7eHiCHVLA==} - engines: {bare: '>=1.16.0'} - peerDependencies: - bare-buffer: '*' - peerDependenciesMeta: - bare-buffer: - optional: true - - bare-os@3.6.1: - resolution: {integrity: sha512-uaIjxokhFidJP+bmmvKSgiMzj2sV5GPHaZVAIktcxcpCyBFFWO+YlikVAdhmUo2vYFvFhOXIAlldqV29L8126g==} - engines: {bare: '>=1.14.0'} - - bare-path@3.0.0: - resolution: {integrity: sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==} - - bare-stream@2.6.5: - resolution: {integrity: sha512-jSmxKJNJmHySi6hC42zlZnq00rga4jjxcgNZjY9N5WlOe/iOoGRtdwGsHzQv2RlH2KOYMwGUXhf2zXd32BA9RA==} - peerDependencies: - bare-buffer: '*' - bare-events: '*' - peerDependenciesMeta: - bare-buffer: - optional: true - bare-events: - optional: true - - base64-js@1.5.1: - resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==} - - big-integer@1.6.52: - resolution: {integrity: sha512-QxD8cf2eVqJOOz63z6JIN9BzvVs/dlySa5HGSBH5xtR8dPteIRQnBxxKqkNTiT6jbDTF6jAfrd4oMcND9RGbQg==} - engines: {node: '>=0.6'} - - binary-extensions@2.3.0: - resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==} - engines: {node: '>=8'} - - bl@4.1.0: - resolution: {integrity: sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==} - - bl@5.1.0: - resolution: {integrity: sha512-tv1ZJHLfTDnXE6tMHv73YgSJaWR2AFuPwMntBe7XL/GBFHnT0CLnsHMogfk5+GzCDC5ZWarSCYaIGATZt9dNsQ==} - - bluebird@3.7.2: - resolution: {integrity: sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==} - - body-parser@2.2.0: - resolution: {integrity: sha512-02qvAaxv8tp7fBa/mw1ga98OGm+eCbqzJOKoRt70sLmfEEi+jyBYVTDGfCL/k06/4EMk/z01gCe7HoCH/f2LTg==} - engines: {node: '>=18'} - - boolbase@1.0.0: - resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==} - - boxen@8.0.1: - resolution: {integrity: sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw==} - engines: {node: '>=18'} - - bplist-parser@0.2.0: - resolution: {integrity: sha512-z0M+byMThzQmD9NILRniCUXYsYpjwnlO8N5uCFaCqIOpqRsJCrQL9NK3JsD67CN5a08nF5oIL2bD6loTdHOuKw==} - engines: {node: '>= 5.10.0'} - - brace-expansion@1.1.11: - resolution: {integrity: sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==} - - brace-expansion@2.0.1: - resolution: {integrity: sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==} - - braces@3.0.3: - resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==} - engines: {node: '>=8'} - - browserslist@4.25.0: - resolution: {integrity: sha512-PJ8gYKeS5e/whHBh8xrwYK+dAvEj7JXtz6uTucnMRB8OiGTsKccFekoRrjajPBHV8oOY+2tI4uxeceSimKwMFA==} - engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7} - hasBin: true - - bs-logger@0.2.6: - resolution: {integrity: sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==} - engines: {node: '>= 6'} - - bser@2.1.1: - resolution: {integrity: sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==} - - buffer-crc32@0.2.13: - resolution: {integrity: sha512-VO9Ht/+p3SN7SKWqcrgEzjGbRSJYTx+Q1pTQC0wrWqHx0vpJraQ6GtHx8tvcg1rlK1byhU5gccxgOgj7B0TDkQ==} - - buffer-from@1.1.2: - resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==} - - buffer@5.7.1: - resolution: {integrity: sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==} - - buffer@6.0.3: - resolution: {integrity: sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==} - - bundle-name@3.0.0: - resolution: {integrity: sha512-PKA4BeSvBpQKQ8iPOGCSiell+N8P+Tf1DlwqmYhpe2gAhKPHn8EYOxVT+ShuGmhg8lN8XiSlS80yiExKXrURlw==} - engines: {node: '>=12'} - - bundle-name@4.1.0: - resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==} - engines: {node: '>=18'} - - bundle-require@5.1.0: - resolution: {integrity: sha512-3WrrOuZiyaaZPWiEt4G3+IffISVC9HYlWueJEBWED4ZH4aIAC2PnkdnuRrR94M+w6yGWn4AglWtJtBI8YqvgoA==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - peerDependencies: - esbuild: '>=0.18' - - bytes@3.1.2: - resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==} - engines: {node: '>= 0.8'} - - c12@3.0.4: - resolution: {integrity: sha512-t5FaZTYbbCtvxuZq9xxIruYydrAGsJ+8UdP0pZzMiK2xl/gNiSOy0OxhLzHUEEb0m1QXYqfzfvyIFEmz/g9lqg==} - peerDependencies: - magicast: ^0.3.5 - peerDependenciesMeta: - magicast: - optional: true - - cac@6.7.14: - resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==} - engines: {node: '>=8'} - - call-bind-apply-helpers@1.0.2: - resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==} - engines: {node: '>= 0.4'} - - call-bound@1.0.4: - resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==} - engines: {node: '>= 0.4'} - - callsites@3.1.0: - resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==} - engines: {node: '>=6'} - - camelcase@5.3.1: - resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==} - engines: {node: '>=6'} - - camelcase@6.3.0: - resolution: {integrity: sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==} - engines: {node: '>=10'} - - camelcase@8.0.0: - resolution: {integrity: sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA==} - engines: {node: '>=16'} - - caniuse-lite@1.0.30001721: - resolution: {integrity: sha512-cOuvmUVtKrtEaoKiO0rSc29jcjwMwX5tOHDy4MgVFEWiUXj4uBMJkwI8MDySkgXidpMiHUcviogAvFi4pA2hDQ==} - - chalk@4.1.2: - resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==} - engines: {node: '>=10'} - - chalk@5.4.1: - resolution: {integrity: sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==} - engines: {node: ^12.17.0 || ^14.13 || >=16.0.0} - - char-regex@1.0.2: - resolution: {integrity: sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==} - engines: {node: '>=10'} - - chokidar@3.6.0: - resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==} - engines: {node: '>= 8.10.0'} - - chokidar@4.0.3: - resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==} - engines: {node: '>= 14.16.0'} - - chownr@1.1.4: - resolution: {integrity: sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==} - - chrome-launcher@1.1.2: - resolution: {integrity: sha512-YclTJey34KUm5jB1aEJCq807bSievi7Nb/TU4Gu504fUYi3jw3KCIaH6L7nFWQhdEgH3V+wCh+kKD1P5cXnfxw==} - engines: {node: '>=12.13.0'} - hasBin: true - - ci-info@3.9.0: - resolution: {integrity: sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==} - engines: {node: '>=8'} - - ci-info@4.2.0: - resolution: {integrity: sha512-cYY9mypksY8NRqgDB1XD1RiJL338v/551niynFTGkZOO2LHuB2OmOYxDIe/ttN9AHwrqdum1360G3ald0W9kCg==} - engines: {node: '>=8'} - - citty@0.1.6: - resolution: {integrity: sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==} - - cjs-module-lexer@1.4.3: - resolution: {integrity: sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==} - - cli-boxes@3.0.0: - resolution: {integrity: sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==} - engines: {node: '>=10'} - - cli-cursor@4.0.0: - resolution: {integrity: sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - cli-cursor@5.0.0: - resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==} - engines: {node: '>=18'} - - cli-highlight@2.1.11: - resolution: {integrity: sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg==} - engines: {node: '>=8.0.0', npm: '>=5.0.0'} - hasBin: true - - cli-spinners@2.9.2: - resolution: {integrity: sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==} - engines: {node: '>=6'} - - cli-truncate@4.0.0: - resolution: {integrity: sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==} - engines: {node: '>=18'} - - cliui@7.0.4: - resolution: {integrity: sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==} - - cliui@8.0.1: - resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==} - engines: {node: '>=12'} - - clone@1.0.4: - resolution: {integrity: sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==} - engines: {node: '>=0.8'} - - co@4.6.0: - resolution: {integrity: sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==} - engines: {iojs: '>= 1.0.0', node: '>= 0.12.0'} - - collect-v8-coverage@1.0.2: - resolution: {integrity: sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==} - - color-convert@2.0.1: - resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==} - engines: {node: '>=7.0.0'} - - color-name@1.1.4: - resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==} - - color-string@1.9.1: - resolution: {integrity: sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==} - - color@4.2.3: - resolution: {integrity: sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==} - engines: {node: '>=12.5.0'} - - colorette@2.0.20: - resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==} - - combined-stream@1.0.8: - resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==} - engines: {node: '>= 0.8'} - - commander@13.1.0: - resolution: {integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==} - engines: {node: '>=18'} - - commander@2.9.0: - resolution: {integrity: sha512-bmkUukX8wAOjHdN26xj5c4ctEV22TQ7dQYhSmuckKhToXrkUn0iIaolHdIxYYqD55nhpSPA9zPQ1yP57GdXP2A==} - engines: {node: '>= 0.6.x'} - - commander@4.1.1: - resolution: {integrity: sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==} - engines: {node: '>= 6'} - - commander@9.5.0: - resolution: {integrity: sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==} - engines: {node: ^12.20.0 || >=14} - - compare-func@2.0.0: - resolution: {integrity: sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==} - - component-emitter@1.3.1: - resolution: {integrity: sha512-T0+barUSQRTUQASh8bx02dl+DhF54GtIDY13Y3m9oWTklKbb3Wv974meRpeZ3lp1JpLVECWWNHC4vaG2XHXouQ==} - - concat-map@0.0.1: - resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==} - - concat-stream@1.6.2: - resolution: {integrity: sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==} - engines: {'0': node >= 0.8} - - confbox@0.1.8: - resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==} - - confbox@0.2.2: - resolution: {integrity: sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ==} - - config-chain@1.1.13: - resolution: {integrity: sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==} - - configstore@7.0.0: - resolution: {integrity: sha512-yk7/5PN5im4qwz0WFZW3PXnzHgPu9mX29Y8uZ3aefe2lBPC1FYttWZRcaW9fKkT0pBCJyuQ2HfbmPVaODi9jcQ==} - engines: {node: '>=18'} - - consola@3.4.2: - resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==} - engines: {node: ^14.18.0 || >=16.10.0} - - content-disposition@1.0.0: - resolution: {integrity: sha512-Au9nRL8VNUut/XSzbQA38+M78dzP4D+eqg3gfJHMIHHYa3bg067xj1KxMUWj+VULbiZMowKngFFbKczUrNJ1mg==} - engines: {node: '>= 0.6'} - - content-type@1.0.5: - resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==} - engines: {node: '>= 0.6'} - - conventional-changelog-angular@7.0.0: - resolution: {integrity: sha512-ROjNchA9LgfNMTTFSIWPzebCwOGFdgkEq45EnvvrmSLvCtAw0HSmrCs7/ty+wAeYUZyNay0YMUNYFTRL72PkBQ==} - engines: {node: '>=16'} - - conventional-changelog-conventionalcommits@7.0.2: - resolution: {integrity: sha512-NKXYmMR/Hr1DevQegFB4MwfM5Vv0m4UIxKZTTYuD98lpTknaZlSRrDOG4X7wIXpGkfsYxZTghUN+Qq+T0YQI7w==} - engines: {node: '>=16'} - - conventional-commits-parser@5.0.0: - resolution: {integrity: sha512-ZPMl0ZJbw74iS9LuX9YIAiW8pfM5p3yh2o/NbXHbkFuZzY5jvdi5jFycEOkmBW5H5I7nA+D6f3UcsCLP2vvSEA==} - engines: {node: '>=16'} - hasBin: true - - convert-source-map@2.0.0: - resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} - - cookie-signature@1.2.2: - resolution: {integrity: sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==} - engines: {node: '>=6.6.0'} - - cookie@0.7.2: - resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==} - engines: {node: '>= 0.6'} - - cookie@1.0.2: - resolution: {integrity: sha512-9Kr/j4O16ISv8zBBhJoi4bXOYNTkFLOqSL3UDB0njXxCXNezjeyVrJyGOWtgfs/q2km1gwBcfH8q1yEGoMYunA==} - engines: {node: '>=18'} - - cookiejar@2.1.4: - resolution: {integrity: sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw==} - - core-util-is@1.0.3: - resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==} - - cors@2.8.5: - resolution: {integrity: sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==} - engines: {node: '>= 0.10'} - - cosmiconfig-typescript-loader@6.1.0: - resolution: {integrity: sha512-tJ1w35ZRUiM5FeTzT7DtYWAFFv37ZLqSRkGi2oeCK1gPhvaWjkAtfXvLmvE1pRfxxp9aQo6ba/Pvg1dKj05D4g==} - engines: {node: '>=v18'} - peerDependencies: - '@types/node': '*' - cosmiconfig: '>=9' - typescript: '>=5' - - cosmiconfig@9.0.0: - resolution: {integrity: sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==} - engines: {node: '>=14'} - peerDependencies: - typescript: '>=4.9.5' - peerDependenciesMeta: - typescript: - optional: true - - create-jest@29.7.0: - resolution: {integrity: sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - hasBin: true - - create-require@1.1.1: - resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==} - - cross-env@7.0.3: - resolution: {integrity: sha512-+/HKd6EgcQCJGh2PSjZuUitQBQynKor4wrFbRg4DtAgS1aWO+gU52xpH7M9ScGgXSYmAVS9bIJ8EzuaGw0oNAw==} - engines: {node: '>=10.14', npm: '>=6', yarn: '>=1'} - hasBin: true - - cross-spawn@7.0.6: - resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==} - engines: {node: '>= 8'} - - css-select@5.1.0: - resolution: {integrity: sha512-nwoRF1rvRRnnCqqY7updORDsuqKzqYJ28+oSMaJMMgOauh3fvwHqMS7EZpIPqK8GL+g9mKxF1vP/ZjSeNjEVHg==} - - css-what@6.1.0: - resolution: {integrity: sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw==} - engines: {node: '>= 6'} - - cssesc@3.0.0: - resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==} - engines: {node: '>=4'} - hasBin: true - - cssom@0.5.0: - resolution: {integrity: sha512-iKuQcq+NdHqlAcwUY0o/HL69XQrUaQdMjmStJ8JFmUaiiQErlhrmuigkg/CU4E2J0IyUKUrMAgl36TvN67MqTw==} - - csstype@3.1.3: - resolution: {integrity: sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==} - - dargs@8.1.0: - resolution: {integrity: sha512-wAV9QHOsNbwnWdNW2FYvE1P56wtgSbM+3SZcdGiWQILwVjACCXDCI3Ai8QlCjMDB8YK5zySiXZYBiwGmNY3lnw==} - engines: {node: '>=12'} - - date-fns@4.1.0: - resolution: {integrity: sha512-Ukq0owbQXxa/U3EGtsdVBkR1w7KOQ5gIBqdH2hkvknzZPYvBxb/aa6E8L7tmjFtkwZBu3UXBbjIgPo/Ez4xaNg==} - - dateformat@4.6.3: - resolution: {integrity: sha512-2P0p0pFGzHS5EMnhdxQi7aJN+iMheud0UhG4dlE1DLAlvL8JHjJJTX/CSm4JXwV0Ka5nGk3zC5mcb5bUQUxxMA==} - - de-indent@1.0.2: - resolution: {integrity: sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==} - - debounce@1.2.1: - resolution: {integrity: sha512-XRRe6Glud4rd/ZGQfiV1ruXSfbvfJedlV9Y6zOlP+2K04vBYiJEte6stfFkCP03aMnY5tsipamumUjL14fofug==} - - debug@2.6.9: - resolution: {integrity: sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==} - peerDependencies: - supports-color: '*' - peerDependenciesMeta: - supports-color: - optional: true - - debug@4.3.7: - resolution: {integrity: sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==} - engines: {node: '>=6.0'} - peerDependencies: - supports-color: '*' - peerDependenciesMeta: - supports-color: - optional: true - - debug@4.4.1: - resolution: {integrity: sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==} - engines: {node: '>=6.0'} - peerDependencies: - supports-color: '*' - peerDependenciesMeta: - supports-color: - optional: true - - decompress-response@6.0.0: - resolution: {integrity: sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==} - engines: {node: '>=10'} - - dedent@1.6.0: - resolution: {integrity: sha512-F1Z+5UCFpmQUzJa11agbyPVMbpgT/qA3/SKyJ1jyBgm7dUcUEa8v9JwDkerSQXfakBwFljIxhOJqGkjUwZ9FSA==} - peerDependencies: - babel-plugin-macros: ^3.1.0 - peerDependenciesMeta: - babel-plugin-macros: - optional: true - - deep-extend@0.6.0: - resolution: {integrity: sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==} - engines: {node: '>=4.0.0'} - - deep-is@0.1.4: - resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==} - - deepmerge@4.3.1: - resolution: {integrity: sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==} - engines: {node: '>=0.10.0'} - - default-browser-id@3.0.0: - resolution: {integrity: sha512-OZ1y3y0SqSICtE8DE4S8YOE9UZOJ8wO16fKWVP5J1Qz42kV9jcnMVFrEE/noXb/ss3Q4pZIH79kxofzyNNtUNA==} - engines: {node: '>=12'} - - default-browser-id@5.0.0: - resolution: {integrity: sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==} - engines: {node: '>=18'} - - default-browser@4.0.0: - resolution: {integrity: sha512-wX5pXO1+BrhMkSbROFsyxUm0i/cJEScyNhA4PPxc41ICuv05ZZB/MX28s8aZx6xjmatvebIapF6hLEKEcpneUA==} - engines: {node: '>=14.16'} - - default-browser@5.2.1: - resolution: {integrity: sha512-WY/3TUME0x3KPYdRRxEJJvXRHV4PyPoUsxtZa78lwItwRQRHhd2U9xOscaT/YTf8uCXIAjeJOFBVEh/7FtD8Xg==} - engines: {node: '>=18'} - - defaults@1.0.4: - resolution: {integrity: sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A==} - - define-lazy-prop@2.0.0: - resolution: {integrity: sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==} - engines: {node: '>=8'} - - define-lazy-prop@3.0.0: - resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==} - engines: {node: '>=12'} - - defu@6.1.4: - resolution: {integrity: sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==} - - delayed-stream@1.0.0: - resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==} - engines: {node: '>=0.4.0'} - - depd@2.0.0: - resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==} - engines: {node: '>= 0.8'} - - dequal@2.0.3: - resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==} - engines: {node: '>=6'} - - destr@2.0.5: - resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==} - - detect-libc@2.0.4: - resolution: {integrity: sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==} - engines: {node: '>=8'} - - detect-newline@3.1.0: - resolution: {integrity: sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==} - engines: {node: '>=8'} - - dezalgo@1.0.4: - resolution: {integrity: sha512-rXSP0bf+5n0Qonsb+SVVfNfIsimO4HEtmnIpPHY8Q1UCzKlQrDMfdobr8nJOOsRgWCyMRqeSBQzmWUMq7zvVig==} - - diff-sequences@29.6.3: - resolution: {integrity: sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - diff@4.0.2: - resolution: {integrity: sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==} - engines: {node: '>=0.3.1'} - - dom-serializer@2.0.0: - resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==} - - domelementtype@2.3.0: - resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==} - - domhandler@5.0.3: - resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==} - engines: {node: '>= 4'} - - domutils@3.2.2: - resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==} - - dot-prop@5.3.0: - resolution: {integrity: sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==} - engines: {node: '>=8'} - - dot-prop@9.0.0: - resolution: {integrity: sha512-1gxPBJpI/pcjQhKgIU91II6Wkay+dLcN3M6rf2uwP8hRur3HtQXjVrdAK3sjC0piaEuxzMwjXChcETiJl47lAQ==} - engines: {node: '>=18'} - - dotenv-expand@12.0.2: - resolution: {integrity: sha512-lXpXz2ZE1cea1gL4sz2Ipj8y4PiVjytYr3Ij0SWoms1PGxIv7m2CRKuRuCRtHdVuvM/hNJPMxt5PbhboNC4dPQ==} - engines: {node: '>=12'} - - dotenv@16.5.0: - resolution: {integrity: sha512-m/C+AwOAr9/W1UOIZUo232ejMNnJAJtYQjUbHoNTBNTJSvqzzDh7vnrei3o3r3m9blf6ZoDkvcw0VmozNRFJxg==} - engines: {node: '>=12'} - - dunder-proto@1.0.1: - resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==} - engines: {node: '>= 0.4'} - - eastasianwidth@0.2.0: - resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==} - - ee-first@1.1.1: - resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==} - - ejs@3.1.10: - resolution: {integrity: sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==} - engines: {node: '>=0.10.0'} - hasBin: true - - electron-to-chromium@1.5.165: - resolution: {integrity: sha512-naiMx1Z6Nb2TxPU6fiFrUrDTjyPMLdTtaOd2oLmG8zVSg2hCWGkhPyxwk+qRmZ1ytwVqUv0u7ZcDA5+ALhaUtw==} - - emittery@0.13.1: - resolution: {integrity: sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==} - engines: {node: '>=12'} - - emoji-regex@10.4.0: - resolution: {integrity: sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==} - - emoji-regex@8.0.0: - resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==} - - emoji-regex@9.2.2: - resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==} - - encodeurl@2.0.0: - resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==} - engines: {node: '>= 0.8'} - - end-of-stream@1.4.4: - resolution: {integrity: sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==} - - entities@4.5.0: - resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} - engines: {node: '>=0.12'} - - entities@6.0.1: - resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==} - engines: {node: '>=0.12'} - - env-paths@2.2.1: - resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==} - engines: {node: '>=6'} - - environment@1.1.0: - resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==} - engines: {node: '>=18'} - - error-ex@1.3.2: - resolution: {integrity: sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==} - - es-define-property@1.0.1: - resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==} - engines: {node: '>= 0.4'} - - es-errors@1.3.0: - resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==} - engines: {node: '>= 0.4'} - - es-module-lexer@1.7.0: - resolution: {integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==} - - es-object-atoms@1.1.1: - resolution: {integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==} - engines: {node: '>= 0.4'} - - es-set-tostringtag@2.1.0: - resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==} - engines: {node: '>= 0.4'} - - es6-error@4.1.1: - resolution: {integrity: sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==} - - esbuild@0.25.5: - resolution: {integrity: sha512-P8OtKZRv/5J5hhz0cUAdu/cLuPIKXpQl1R9pZtvmHWQvrAUVd0UNIPT4IB4W3rNOqVO0rlqHmCIbSwxh/c9yUQ==} - engines: {node: '>=18'} - hasBin: true - - escalade@3.2.0: - resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==} - engines: {node: '>=6'} - - escape-goat@4.0.0: - resolution: {integrity: sha512-2Sd4ShcWxbx6OY1IHyla/CVNwvg7XwZVoXZHcSu9w9SReNP1EzzD5T8NWKIR38fIqEns9kDWKUQTXXAmlDrdPg==} - engines: {node: '>=12'} - - escape-html@1.0.3: - resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==} - - escape-string-regexp@2.0.0: - resolution: {integrity: sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==} - engines: {node: '>=8'} - - escape-string-regexp@4.0.0: - resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==} - engines: {node: '>=10'} - - escape-string-regexp@5.0.0: - resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==} - engines: {node: '>=12'} - - eslint-config-prettier@10.1.5: - resolution: {integrity: sha512-zc1UmCpNltmVY34vuLRV61r1K27sWuX39E+uyUnY8xS2Bex88VV9cugG+UZbRSRGtGyFboj+D8JODyme1plMpw==} - hasBin: true - peerDependencies: - eslint: '>=7.0.0' - - eslint-plugin-vue@10.2.0: - resolution: {integrity: sha512-tl9s+KN3z0hN2b8fV2xSs5ytGl7Esk1oSCxULLwFcdaElhZ8btYYZFrWxvh4En+czrSDtuLCeCOGa8HhEZuBdQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - vue-eslint-parser: ^10.0.0 - - eslint-scope@8.4.0: - resolution: {integrity: sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - eslint-visitor-keys@3.4.3: - resolution: {integrity: sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==} - engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} - - eslint-visitor-keys@4.2.1: - resolution: {integrity: sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - eslint@9.28.0: - resolution: {integrity: sha512-ocgh41VhRlf9+fVpe7QKzwLj9c92fDiqOj8Y3Sd4/ZmVA4Btx4PlUYPq4pp9JDyupkf1upbEXecxL2mwNV7jPQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - hasBin: true - peerDependencies: - jiti: '*' - peerDependenciesMeta: - jiti: - optional: true - - espree@10.4.0: - resolution: {integrity: sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - - esprima@4.0.1: - resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==} - engines: {node: '>=4'} - hasBin: true - - esquery@1.6.0: - resolution: {integrity: sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==} - engines: {node: '>=0.10'} - - esrecurse@4.3.0: - resolution: {integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==} - engines: {node: '>=4.0'} - - estraverse@5.3.0: - resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==} - engines: {node: '>=4.0'} - - estree-walker@2.0.2: - resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==} - - estree-walker@3.0.3: - resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==} - - esutils@2.0.3: - resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==} - engines: {node: '>=0.10.0'} - - etag@1.8.1: - resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==} - engines: {node: '>= 0.6'} - - eventemitter3@5.0.1: - resolution: {integrity: sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==} - - eventsource-parser@3.0.2: - resolution: {integrity: sha512-6RxOBZ/cYgd8usLwsEl+EC09Au/9BcmCKYF2/xbml6DNczf7nv0MQb+7BA2F+li6//I+28VNlQR37XfQtcAJuA==} - engines: {node: '>=18.0.0'} - - eventsource@3.0.7: - resolution: {integrity: sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==} - engines: {node: '>=18.0.0'} - - execa@5.1.1: - resolution: {integrity: sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==} - engines: {node: '>=10'} - - execa@7.2.0: - resolution: {integrity: sha512-UduyVP7TLB5IcAQl+OzLyLcS/l32W/GLg+AhHJ+ow40FOk2U3SAllPwR44v4vmdFwIWqpdwxxpQbF1n5ta9seA==} - engines: {node: ^14.18.0 || ^16.14.0 || >=18.0.0} - - execa@8.0.1: - resolution: {integrity: sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==} - engines: {node: '>=16.17'} - - exit@0.1.2: - resolution: {integrity: sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==} - engines: {node: '>= 0.8.0'} - - expand-template@2.0.3: - resolution: {integrity: sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==} - engines: {node: '>=6'} - - expect@29.7.0: - resolution: {integrity: sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - express-rate-limit@7.5.0: - resolution: {integrity: sha512-eB5zbQh5h+VenMPM3fh+nw1YExi5nMr6HUCR62ELSP11huvxm/Uir1H1QEyTkk5QX6A58pX6NmaTMceKZ0Eodg==} - engines: {node: '>= 16'} - peerDependencies: - express: ^4.11 || 5 || ^5.0.0-beta.1 - - express@5.1.0: - resolution: {integrity: sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==} - engines: {node: '>= 18'} - - exsolve@1.0.5: - resolution: {integrity: sha512-pz5dvkYYKQ1AHVrgOzBKWeP4u4FRb3a6DNK2ucr0OoNwYIU4QWsJ+NM36LLzORT+z845MzKHHhpXiUF5nvQoJg==} - - extract-zip@2.0.1: - resolution: {integrity: sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==} - engines: {node: '>= 10.17.0'} - hasBin: true - - fast-copy@3.0.2: - resolution: {integrity: sha512-dl0O9Vhju8IrcLndv2eU4ldt1ftXMqqfgN4H1cpmGV7P6jeB9FwpN9a2c8DPGE1Ys88rNUJVYDHq73CGAGOPfQ==} - - fast-decode-uri-component@1.0.1: - resolution: {integrity: sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==} - - fast-deep-equal@3.1.3: - resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==} - - fast-fifo@1.3.2: - resolution: {integrity: sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==} - - fast-glob@3.3.3: - resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==} - engines: {node: '>=8.6.0'} - - fast-json-stable-stringify@2.1.0: - resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==} - - fast-json-stringify@6.0.1: - resolution: {integrity: sha512-s7SJE83QKBZwg54dIbD5rCtzOBVD43V1ReWXXYqBgwCwHLYAAT0RQc/FmrQglXqWPpz6omtryJQOau5jI4Nrvg==} - - fast-levenshtein@2.0.6: - resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==} - - fast-querystring@1.1.2: - resolution: {integrity: sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg==} - - fast-redact@3.5.0: - resolution: {integrity: sha512-dwsoQlS7h9hMeYUq1W++23NDcBLV4KqONnITDV9DjfS3q1SgDGVrBdvvTLUotWtPSD7asWDV9/CmsZPy8Hf70A==} - engines: {node: '>=6'} - - fast-safe-stringify@2.1.1: - resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==} - - fast-uri@3.0.6: - resolution: {integrity: sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw==} - - fastify-plugin@5.0.1: - resolution: {integrity: sha512-HCxs+YnRaWzCl+cWRYFnHmeRFyR5GVnJTAaCJQiYzQSDwK9MgJdyAsuL3nh0EWRCYMgQ5MeziymvmAhUHYHDUQ==} - - fastify@5.3.3: - resolution: {integrity: sha512-nCBiBCw9q6jPx+JJNVgO8JVnTXeUyrGcyTKPQikRkA/PanrFcOIo4R+ZnLeOLPZPGgzjomqfVarzE0kYx7qWiQ==} - - fastq@1.19.1: - resolution: {integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==} - - fb-watchman@2.0.2: - resolution: {integrity: sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==} - - fd-slicer@1.1.0: - resolution: {integrity: sha512-cE1qsB/VwyQozZ+q1dGxR8LBYNZeofhEdUNGSMbQD3Gw2lAzX9Zb3uIU6Ebc/Fmyjo9AWWfnn0AUCHqtevs/8g==} - - fdir@6.4.5: - resolution: {integrity: sha512-4BG7puHpVsIYxZUbiUE3RqGloLaSSwzYie5jvasC4LWuBWzZawynvYouhjbQKw2JuIGYdm0DzIxl8iVidKlUEw==} - peerDependencies: - picomatch: ^3 || ^4 - peerDependenciesMeta: - picomatch: - optional: true - - file-entry-cache@8.0.0: - resolution: {integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==} - engines: {node: '>=16.0.0'} - - filelist@1.0.4: - resolution: {integrity: sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==} - - filesize@10.1.6: - resolution: {integrity: sha512-sJslQKU2uM33qH5nqewAwVB2QgR6w1aMNsYUp3aN5rMRyXEwJGmZvaWzeJFNTOXWlHQyBFCWrdj3fV/fsTOX8w==} - engines: {node: '>= 10.4.0'} - - fill-range@7.1.1: - resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==} - engines: {node: '>=8'} - - finalhandler@2.1.0: - resolution: {integrity: sha512-/t88Ty3d5JWQbWYgaOGCCYfXRwV1+be02WqYYlL6h0lEiUAMPM8o8qKGO01YIkOHzka2up08wvgYD0mDiI+q3Q==} - engines: {node: '>= 0.8'} - - find-my-way@9.3.0: - resolution: {integrity: sha512-eRoFWQw+Yv2tuYlK2pjFS2jGXSxSppAs3hSQjfxVKxM5amECzIgYYc1FEI8ZmhSh/Ig+FrKEz43NLRKJjYCZVg==} - engines: {node: '>=20'} - - find-up@4.1.0: - resolution: {integrity: sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==} - engines: {node: '>=8'} - - find-up@5.0.0: - resolution: {integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==} - engines: {node: '>=10'} - - find-up@7.0.0: - resolution: {integrity: sha512-YyZM99iHrqLKjmt4LJDj58KI+fYyufRLBSYcqycxf//KpBk9FoewoGX0450m9nB44qrZnovzC2oeP5hUibxc/g==} - engines: {node: '>=18'} - - firefox-profile@4.7.0: - resolution: {integrity: sha512-aGApEu5bfCNbA4PGUZiRJAIU6jKmghV2UVdklXAofnNtiDjqYw0czLS46W7IfFqVKgKhFB8Ao2YoNGHY4BoIMQ==} - engines: {node: '>=18'} - hasBin: true - - fix-dts-default-cjs-exports@1.0.1: - resolution: {integrity: sha512-pVIECanWFC61Hzl2+oOCtoJ3F17kglZC/6N94eRWycFgBH35hHx0Li604ZIzhseh97mf2p0cv7vVrOZGoqhlEg==} - - flat-cache@4.0.1: - resolution: {integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==} - engines: {node: '>=16'} - - flatbuffers@1.12.0: - resolution: {integrity: sha512-c7CZADjRcl6j0PlvFy0ZqXQ67qSEZfrVPynmnL+2zPc+NtMvrF8Y0QceMo7QqnSPc7+uWjUIAbvCQ5WIKlMVdQ==} - - flatted@3.3.3: - resolution: {integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==} - - foreground-child@3.3.1: - resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==} - engines: {node: '>=14'} - - form-data@4.0.3: - resolution: {integrity: sha512-qsITQPfmvMOSAdeyZ+12I1c+CKSstAFAwu+97zrnWAbIr5u8wfsExUzCesVLC8NgHuRUqNN4Zy6UPWUTRGslcA==} - engines: {node: '>= 6'} - - form-data@4.0.4: - resolution: {integrity: sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==} - engines: {node: '>= 6'} - - formdata-node@6.0.3: - resolution: {integrity: sha512-8e1++BCiTzUno9v5IZ2J6bv4RU+3UKDmqWUQD0MIMVCd9AdhWkO1gw57oo1mNEX1dMq2EGI+FbWz4B92pscSQg==} - engines: {node: '>= 18'} - - formidable@3.5.4: - resolution: {integrity: sha512-YikH+7CUTOtP44ZTnUhR7Ic2UASBPOqmaRkRKxRbywPTe5VxF7RRCck4af9wutiZ/QKM5nME9Bie2fFaPz5Gug==} - engines: {node: '>=14.0.0'} - - forwarded@0.2.0: - resolution: {integrity: sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==} - engines: {node: '>= 0.6'} - - fresh@2.0.0: - resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==} - engines: {node: '>= 0.8'} - - fs-constants@1.0.0: - resolution: {integrity: sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==} - - fs-extra@11.3.0: - resolution: {integrity: sha512-Z4XaCL6dUDHfP/jT25jJKMmtxvuwbkrD1vNSMFlo9lNLY2c5FHYSQgHPRZUjAB26TpDEoW9HCOgplrdbaPV/ew==} - engines: {node: '>=14.14'} - - fs.realpath@1.0.0: - resolution: {integrity: sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==} - - fsevents@2.3.3: - resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} - engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} - os: [darwin] - - function-bind@1.1.2: - resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==} - - fx-runner@1.4.0: - resolution: {integrity: sha512-rci1g6U0rdTg6bAaBboP7XdRu01dzTAaKXxFf+PUqGuCv6Xu7o8NZdY1D5MvKGIjb6EdS1g3VlXOgksir1uGkg==} - hasBin: true - - gensync@1.0.0-beta.2: - resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==} - engines: {node: '>=6.9.0'} - - get-caller-file@2.0.5: - resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==} - engines: {node: 6.* || 8.* || >= 10.*} - - get-east-asian-width@1.3.0: - resolution: {integrity: sha512-vpeMIQKxczTD/0s2CdEWHcb0eeJe6TFjxb+J5xgX7hScxqrGuyjmv4c1D4A/gelKfyox0gJJwIHF+fLjeaM8kQ==} - engines: {node: '>=18'} - - get-intrinsic@1.3.0: - resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==} - engines: {node: '>= 0.4'} - - get-package-type@0.1.0: - resolution: {integrity: sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==} - engines: {node: '>=8.0.0'} - - get-port-please@3.1.2: - resolution: {integrity: sha512-Gxc29eLs1fbn6LQ4jSU4vXjlwyZhF5HsGuMAa7gqBP4Rw4yxxltyDUuF5MBclFzDTXO+ACchGQoeela4DSfzdQ==} - - get-proto@1.0.1: - resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==} - engines: {node: '>= 0.4'} - - get-stream@5.2.0: - resolution: {integrity: sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA==} - engines: {node: '>=8'} - - get-stream@6.0.1: - resolution: {integrity: sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==} - engines: {node: '>=10'} - - get-stream@8.0.1: - resolution: {integrity: sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==} - engines: {node: '>=16'} - - giget@2.0.0: - resolution: {integrity: sha512-L5bGsVkxJbJgdnwyuheIunkGatUF/zssUoxxjACCseZYAVbaqdh9Tsmmlkl8vYan09H7sbvKt4pS8GqKLBrEzA==} - hasBin: true - - git-raw-commits@4.0.0: - resolution: {integrity: sha512-ICsMM1Wk8xSGMowkOmPrzo2Fgmfo4bMHLNX6ytHjajRJUqvHOw/TFapQ+QG75c3X/tTDDhOSRPGC52dDbNM8FQ==} - engines: {node: '>=16'} - hasBin: true - - github-from-package@0.0.0: - resolution: {integrity: sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==} - - glob-parent@5.1.2: - resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==} - engines: {node: '>= 6'} - - glob-parent@6.0.2: - resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==} - engines: {node: '>=10.13.0'} - - glob-to-regexp@0.4.1: - resolution: {integrity: sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==} - - glob@10.4.5: - resolution: {integrity: sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==} - hasBin: true - - glob@11.0.2: - resolution: {integrity: sha512-YT7U7Vye+t5fZ/QMkBFrTJ7ZQxInIUjwyAjVj84CYXqgBdv30MFUPGnBR6sQaVq6Is15wYJUsnzTuWaGRBhBAQ==} - engines: {node: 20 || >=22} - hasBin: true - - glob@7.2.3: - resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==} - deprecated: Glob versions prior to v9 are no longer supported - - global-directory@4.0.1: - resolution: {integrity: sha512-wHTUcDUoZ1H5/0iVqEudYW4/kAlN5cZ3j/bXn0Dpbizl9iaUVeWSHqiOjsgk6OW2bkLclbBjzewBz6weQ1zA2Q==} - engines: {node: '>=18'} - - globals@11.12.0: - resolution: {integrity: sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==} - engines: {node: '>=4'} - - globals@14.0.0: - resolution: {integrity: sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==} - engines: {node: '>=18'} - - globals@16.2.0: - resolution: {integrity: sha512-O+7l9tPdHCU320IigZZPj5zmRCFG9xHmx9cU8FqU2Rp+JN714seHV+2S9+JslCpY4gJwU2vOGox0wzgae/MCEg==} - engines: {node: '>=18'} - - gopd@1.2.0: - resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==} - engines: {node: '>= 0.4'} - - graceful-fs@4.2.10: - resolution: {integrity: sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==} - - graceful-fs@4.2.11: - resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==} - - graceful-readlink@1.0.1: - resolution: {integrity: sha512-8tLu60LgxF6XpdbK8OW3FA+IfTNBn1ZHGHKF4KQbEeSkajYw5PlYJcKluntgegDPTg8UkHjpet1T82vk6TQ68w==} - - graphemer@1.4.0: - resolution: {integrity: sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==} - - growly@1.3.0: - resolution: {integrity: sha512-+xGQY0YyAWCnqy7Cd++hc2JqMYzlm0dG30Jd0beaA64sROr8C4nt8Yc9V5Ro3avlSUDTN0ulqP/VBKi1/lLygw==} - - guid-typescript@1.0.9: - resolution: {integrity: sha512-Y8T4vYhEfwJOTbouREvG+3XDsjr8E3kIr7uf+JZ0BYloFsttiHU0WfvANVsR7TxNUJa/WpCnw/Ino/p+DeBhBQ==} - - has-flag@3.0.0: - resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==} - engines: {node: '>=4'} - - has-flag@4.0.0: - resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==} - engines: {node: '>=8'} - - has-symbols@1.1.0: - resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==} - engines: {node: '>= 0.4'} - - has-tostringtag@1.0.2: - resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==} - engines: {node: '>= 0.4'} - - hasown@2.0.2: - resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==} - engines: {node: '>= 0.4'} - - he@1.2.0: - resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==} - hasBin: true - - help-me@5.0.0: - resolution: {integrity: sha512-7xgomUX6ADmcYzFik0HzAxh/73YlKR9bmFzf51CZwR+b6YtzU2m0u49hQCqV6SvlqIqsaxovfwdvbnsw3b/zpg==} - - highlight.js@10.7.3: - resolution: {integrity: sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==} - - hnswlib-wasm-static@0.8.5: - resolution: {integrity: sha512-jhmkHoCK6qvsiziwHmIZ5ujg9LrBnVmvgHw70Gm4k3nwnXlD8nHEQIHIQBgTD7scsHnmAvQLPm/wmC6ylPHGNQ==} - - hookable@5.5.3: - resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==} - - html-escaper@2.0.2: - resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==} - - html-escaper@3.0.3: - resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==} - - htmlparser2@10.0.0: - resolution: {integrity: sha512-TwAZM+zE5Tq3lrEHvOlvwgj1XLWQCtaaibSN11Q+gGBAS7Y1uZSWwXXRe4iF6OXnaq1riyQAPFOBtYc77Mxq0g==} - - http-errors@2.0.0: - resolution: {integrity: sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==} - engines: {node: '>= 0.8'} - - human-signals@2.1.0: - resolution: {integrity: sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==} - engines: {node: '>=10.17.0'} - - human-signals@4.3.1: - resolution: {integrity: sha512-nZXjEF2nbo7lIw3mgYjItAfgQXog3OjJogSbKa2CQIIvSGWcKgeJnQlNXip6NglNzYH45nSRiEVimMvYL8DDqQ==} - engines: {node: '>=14.18.0'} - - human-signals@5.0.0: - resolution: {integrity: sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==} - engines: {node: '>=16.17.0'} - - husky@9.1.7: - resolution: {integrity: sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==} - engines: {node: '>=18'} - hasBin: true - - iconv-lite@0.6.3: - resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==} - engines: {node: '>=0.10.0'} - - ieee754@1.2.1: - resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==} - - ignore-by-default@1.0.1: - resolution: {integrity: sha512-Ius2VYcGNk7T90CppJqcIkS5ooHUZyIQK+ClZfMfMNFEF9VSE73Fq+906u/CWu92x4gzZMWOwfFYckPObzdEbA==} - - ignore@5.3.2: - resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==} - engines: {node: '>= 4'} - - ignore@7.0.5: - resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==} - engines: {node: '>= 4'} - - immediate@3.0.6: - resolution: {integrity: sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==} - - import-fresh@3.3.1: - resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==} - engines: {node: '>=6'} - - import-local@3.2.0: - resolution: {integrity: sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==} - engines: {node: '>=8'} - hasBin: true - - import-meta-resolve@4.1.0: - resolution: {integrity: sha512-I6fiaX09Xivtk+THaMfAwnA3MVA5Big1WHF1Dfx9hFuvNIWpXnorlkzhcQf6ehrqQiiZECRt1poOAkPmer3ruw==} - - imurmurhash@0.1.4: - resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==} - engines: {node: '>=0.8.19'} - - inflight@1.0.6: - resolution: {integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==} - deprecated: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful. - - inherits@2.0.4: - resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==} - - ini@1.3.8: - resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==} - - ini@4.1.1: - resolution: {integrity: sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==} - engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} - - ini@4.1.3: - resolution: {integrity: sha512-X7rqawQBvfdjS10YU1y1YVreA3SsLrW9dX2CewP2EbBJM4ypVNLDkO5y04gejPwKIY9lR+7r9gn3rFPt/kmWFg==} - engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} - - ipaddr.js@1.9.1: - resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==} - engines: {node: '>= 0.10'} - - ipaddr.js@2.2.0: - resolution: {integrity: sha512-Ag3wB2o37wslZS19hZqorUnrnzSkpOVy+IiiDEiTqNubEYpYuHWIf6K4psgN2ZWKExS4xhVCrRVfb/wfW8fWJA==} - engines: {node: '>= 10'} - - is-absolute@0.1.7: - resolution: {integrity: sha512-Xi9/ZSn4NFapG8RP98iNPMOeaV3mXPisxKxzKtHVqr3g56j/fBn+yZmnxSVAA8lmZbl2J9b/a4kJvfU3hqQYgA==} - engines: {node: '>=0.10.0'} - - is-admin@4.0.0: - resolution: {integrity: sha512-ODl+ygFCyHXMauhn+0mBebcwO1tiB+b4FoBiIC97gFDcmdO3JMD+YmIhSA8+1KVZuGwfsX8ANo2yblgW5KUPTg==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - is-arrayish@0.2.1: - resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==} - - is-arrayish@0.3.2: - resolution: {integrity: sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==} - - is-binary-path@2.1.0: - resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==} - engines: {node: '>=8'} - - is-core-module@2.16.1: - resolution: {integrity: sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==} - engines: {node: '>= 0.4'} - - is-docker@2.2.1: - resolution: {integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==} - engines: {node: '>=8'} - hasBin: true - - is-docker@3.0.0: - resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - hasBin: true - - is-extglob@2.1.1: - resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==} - engines: {node: '>=0.10.0'} - - is-fullwidth-code-point@3.0.0: - resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==} - engines: {node: '>=8'} - - is-fullwidth-code-point@4.0.0: - resolution: {integrity: sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==} - engines: {node: '>=12'} - - is-fullwidth-code-point@5.0.0: - resolution: {integrity: sha512-OVa3u9kkBbw7b8Xw5F9P+D/T9X+Z4+JruYVNapTjPYZYUznQ5YfWeFkOj606XYYW8yugTfC8Pj0hYqvi4ryAhA==} - engines: {node: '>=18'} - - is-generator-fn@2.1.0: - resolution: {integrity: sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==} - engines: {node: '>=6'} - - is-glob@4.0.3: - resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==} - engines: {node: '>=0.10.0'} - - is-in-ci@1.0.0: - resolution: {integrity: sha512-eUuAjybVTHMYWm/U+vBO1sY/JOCgoPCXRxzdju0K+K0BiGW0SChEL1MLC0PoCIR1OlPo5YAp8HuQoUlsWEICwg==} - engines: {node: '>=18'} - hasBin: true - - is-inside-container@1.0.0: - resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==} - engines: {node: '>=14.16'} - hasBin: true - - is-installed-globally@1.0.0: - resolution: {integrity: sha512-K55T22lfpQ63N4KEN57jZUAaAYqYHEe8veb/TycJRk9DdSCLLcovXz/mL6mOnhQaZsQGwPhuFopdQIlqGSEjiQ==} - engines: {node: '>=18'} - - is-interactive@2.0.0: - resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==} - engines: {node: '>=12'} - - is-npm@6.0.0: - resolution: {integrity: sha512-JEjxbSmtPSt1c8XTkVrlujcXdKV1/tvuQ7GwKcAlyiVLeYFQ2VHat8xfrDJsIkhCdF/tZ7CiIR3sy141c6+gPQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - is-number@7.0.0: - resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==} - engines: {node: '>=0.12.0'} - - is-obj@2.0.0: - resolution: {integrity: sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==} - engines: {node: '>=8'} - - is-path-inside@4.0.0: - resolution: {integrity: sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==} - engines: {node: '>=12'} - - is-plain-object@2.0.4: - resolution: {integrity: sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==} - engines: {node: '>=0.10.0'} - - is-potential-custom-element-name@1.0.1: - resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==} - - is-primitive@3.0.1: - resolution: {integrity: sha512-GljRxhWvlCNRfZyORiH77FwdFwGcMO620o37EOYC0ORWdq+WYNVqW0w2Juzew4M+L81l6/QS3t5gkkihyRqv9w==} - engines: {node: '>=0.10.0'} - - is-promise@4.0.0: - resolution: {integrity: sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==} - - is-relative@0.1.3: - resolution: {integrity: sha512-wBOr+rNM4gkAZqoLRJI4myw5WzzIdQosFAAbnvfXP5z1LyzgAI3ivOKehC5KfqlQJZoihVhirgtCBj378Eg8GA==} - engines: {node: '>=0.10.0'} - - is-stream@2.0.1: - resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==} - engines: {node: '>=8'} - - is-stream@3.0.0: - resolution: {integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - is-text-path@2.0.0: - resolution: {integrity: sha512-+oDTluR6WEjdXEJMnC2z6A4FRwFoYuvShVVEGsS7ewc0UTi2QtAKMDJuL4BDEVt+5T7MjFo12RP8ghOM75oKJw==} - engines: {node: '>=8'} - - is-unicode-supported@1.3.0: - resolution: {integrity: sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ==} - engines: {node: '>=12'} - - is-unicode-supported@2.1.0: - resolution: {integrity: sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==} - engines: {node: '>=18'} - - is-wsl@2.2.0: - resolution: {integrity: sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==} - engines: {node: '>=8'} - - is-wsl@3.1.0: - resolution: {integrity: sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==} - engines: {node: '>=16'} - - isarray@1.0.0: - resolution: {integrity: sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==} - - isexe@1.1.2: - resolution: {integrity: sha512-d2eJzK691yZwPHcv1LbeAOa91yMJ9QmfTgSO1oXB65ezVhXQsxBac2vEB4bMVms9cGzaA99n6V2viHMq82VLDw==} - - isexe@2.0.0: - resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==} - - isobject@3.0.1: - resolution: {integrity: sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==} - engines: {node: '>=0.10.0'} - - istanbul-lib-coverage@3.2.2: - resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==} - engines: {node: '>=8'} - - istanbul-lib-instrument@5.2.1: - resolution: {integrity: sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==} - engines: {node: '>=8'} - - istanbul-lib-instrument@6.0.3: - resolution: {integrity: sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==} - engines: {node: '>=10'} - - istanbul-lib-report@3.0.1: - resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==} - engines: {node: '>=10'} - - istanbul-lib-source-maps@4.0.1: - resolution: {integrity: sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==} - engines: {node: '>=10'} - - istanbul-reports@3.1.7: - resolution: {integrity: sha512-BewmUXImeuRk2YY0PVbxgKAysvhRPUQE0h5QRM++nVWyubKGV0l8qQ5op8+B2DOmwSe63Jivj0BjkPQVf8fP5g==} - engines: {node: '>=8'} - - jackspeak@3.4.3: - resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==} - - jackspeak@4.1.1: - resolution: {integrity: sha512-zptv57P3GpL+O0I7VdMJNBZCu+BPHVQUk55Ft8/QCJjTVxrnJHuVuX/0Bl2A6/+2oyR/ZMEuFKwmzqqZ/U5nPQ==} - engines: {node: 20 || >=22} - - jake@10.9.2: - resolution: {integrity: sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==} - engines: {node: '>=10'} - hasBin: true - - jest-changed-files@29.7.0: - resolution: {integrity: sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-circus@29.7.0: - resolution: {integrity: sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-cli@29.7.0: - resolution: {integrity: sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - hasBin: true - peerDependencies: - node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 - peerDependenciesMeta: - node-notifier: - optional: true - - jest-config@29.7.0: - resolution: {integrity: sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - peerDependencies: - '@types/node': '*' - ts-node: '>=9.0.0' - peerDependenciesMeta: - '@types/node': - optional: true - ts-node: - optional: true - - jest-diff@29.7.0: - resolution: {integrity: sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-docblock@29.7.0: - resolution: {integrity: sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-each@29.7.0: - resolution: {integrity: sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-environment-node@29.7.0: - resolution: {integrity: sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-get-type@29.6.3: - resolution: {integrity: sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-haste-map@29.7.0: - resolution: {integrity: sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-leak-detector@29.7.0: - resolution: {integrity: sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-matcher-utils@29.7.0: - resolution: {integrity: sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-message-util@29.7.0: - resolution: {integrity: sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-mock@29.7.0: - resolution: {integrity: sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-pnp-resolver@1.2.3: - resolution: {integrity: sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==} - engines: {node: '>=6'} - peerDependencies: - jest-resolve: '*' - peerDependenciesMeta: - jest-resolve: - optional: true - - jest-regex-util@29.6.3: - resolution: {integrity: sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-resolve-dependencies@29.7.0: - resolution: {integrity: sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-resolve@29.7.0: - resolution: {integrity: sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-runner@29.7.0: - resolution: {integrity: sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-runtime@29.7.0: - resolution: {integrity: sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-snapshot@29.7.0: - resolution: {integrity: sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-util@29.7.0: - resolution: {integrity: sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-validate@29.7.0: - resolution: {integrity: sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-watcher@29.7.0: - resolution: {integrity: sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest-worker@29.7.0: - resolution: {integrity: sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - jest@29.7.0: - resolution: {integrity: sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - hasBin: true - peerDependencies: - node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 - peerDependenciesMeta: - node-notifier: - optional: true - - jiti@2.4.2: - resolution: {integrity: sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A==} - hasBin: true - - joycon@3.1.1: - resolution: {integrity: sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw==} - engines: {node: '>=10'} - - js-tokens@4.0.0: - resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - - js-tokens@9.0.1: - resolution: {integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==} - - js-yaml@3.14.1: - resolution: {integrity: sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==} - hasBin: true - - js-yaml@4.1.0: - resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==} - hasBin: true - - jsesc@3.1.0: - resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==} - engines: {node: '>=6'} - hasBin: true - - json-buffer@3.0.1: - resolution: {integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==} - - json-parse-even-better-errors@2.3.1: - resolution: {integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==} - - json-parse-even-better-errors@3.0.2: - resolution: {integrity: sha512-fi0NG4bPjCHunUJffmLd0gxssIgkNmArMvis4iNah6Owg1MCJjWhEcDLmsK6iGkJq3tHwbDkTlce70/tmXN4cQ==} - engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} - - json-schema-ref-resolver@2.0.1: - resolution: {integrity: sha512-HG0SIB9X4J8bwbxCbnd5FfPEbcXAJYTi1pBJeP/QPON+w8ovSME8iRG+ElHNxZNX2Qh6eYn1GdzJFS4cDFfx0Q==} - - json-schema-traverse@0.4.1: - resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==} - - json-schema-traverse@1.0.0: - resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==} - - json-stable-stringify-without-jsonify@1.0.1: - resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==} - - json5@2.2.3: - resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==} - engines: {node: '>=6'} - hasBin: true - - jsonfile@6.1.0: - resolution: {integrity: sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==} - - jsonparse@1.3.1: - resolution: {integrity: sha512-POQXvpdL69+CluYsillJ7SUhKvytYjW9vG/GKpnf+xP8UWgYEM/RaMzHHofbALDiKbbP1W8UEYmgGl39WkPZsg==} - engines: {'0': node >= 0.2.0} - - jszip@3.10.1: - resolution: {integrity: sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==} - - keyv@4.5.4: - resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==} - - kleur@3.0.3: - resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==} - engines: {node: '>=6'} - - ky@1.8.1: - resolution: {integrity: sha512-7Bp3TpsE+L+TARSnnDpk3xg8Idi8RwSLdj6CMbNWoOARIrGrbuLGusV0dYwbZOm4bB3jHNxSw8Wk/ByDqJEnDw==} - engines: {node: '>=18'} - - latest-version@9.0.0: - resolution: {integrity: sha512-7W0vV3rqv5tokqkBAFV1LbR7HPOWzXQDpDgEuib/aJ1jsZZx6x3c2mBI+TJhJzOhkGeaLbCKEHXEXLfirtG2JA==} - engines: {node: '>=18'} - - leven@3.1.0: - resolution: {integrity: sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==} - engines: {node: '>=6'} - - levn@0.4.1: - resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==} - engines: {node: '>= 0.8.0'} - - lie@3.3.0: - resolution: {integrity: sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==} - - light-my-request@6.6.0: - resolution: {integrity: sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==} - - lighthouse-logger@2.0.1: - resolution: {integrity: sha512-ioBrW3s2i97noEmnXxmUq7cjIcVRjT5HBpAYy8zE11CxU9HqlWHHeRxfeN1tn8F7OEMVPIC9x1f8t3Z7US9ehQ==} - - lilconfig@3.1.3: - resolution: {integrity: sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==} - engines: {node: '>=14'} - - lines-and-columns@1.2.4: - resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==} - - lines-and-columns@2.0.4: - resolution: {integrity: sha512-wM1+Z03eypVAVUCE7QdSqpVIvelbOakn1M0bPDoA4SGWPx3sNDVUiMo3L6To6WWGClB7VyXnhQ4Sn7gxiJbE6A==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - linkedom@0.18.11: - resolution: {integrity: sha512-K03GU3FUlnhBAP0jPb7tN7YJl7LbjZx30Z8h6wgLXusnKF7+BEZvfEbdkN/lO9LfFzxN3S0ZAriDuJ/13dIsLA==} - - lint-staged@15.5.2: - resolution: {integrity: sha512-YUSOLq9VeRNAo/CTaVmhGDKG+LBtA8KF1X4K5+ykMSwWST1vDxJRB2kv2COgLb1fvpCo+A/y9A0G0znNVmdx4w==} - engines: {node: '>=18.12.0'} - hasBin: true - - listr2@8.3.3: - resolution: {integrity: sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==} - engines: {node: '>=18.0.0'} - - load-tsconfig@0.2.5: - resolution: {integrity: sha512-IXO6OCs9yg8tMKzfPZ1YmheJbZCiEsnBdcB03l0OcfK9prKnJb96siuHCr5Fl37/yo9DnKU+TLpxzTUspw9shg==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - local-pkg@1.1.1: - resolution: {integrity: sha512-WunYko2W1NcdfAFpuLUoucsgULmgDBRkdxHxWQ7mK0cQqwPiy8E1enjuRBrhLtZkB5iScJ1XIPdhVEFK8aOLSg==} - engines: {node: '>=14'} - - locate-path@5.0.0: - resolution: {integrity: sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==} - engines: {node: '>=8'} - - locate-path@6.0.0: - resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==} - engines: {node: '>=10'} - - locate-path@7.2.0: - resolution: {integrity: sha512-gvVijfZvn7R+2qyPX8mAuKcFGDf6Nc61GdvGafQsHL0sBIxfKzA+usWn4GFC/bk+QdwPUD4kWFJLhElipq+0VA==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - lodash.camelcase@4.3.0: - resolution: {integrity: sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==} - - lodash.isplainobject@4.0.6: - resolution: {integrity: sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==} - - lodash.kebabcase@4.1.1: - resolution: {integrity: sha512-N8XRTIMMqqDgSy4VLKPnJ/+hpGZN+PHQiJnSenYqPaVV/NCqEogTnAdZLQiGKhxX+JCs8waWq2t1XHWKOmlY8g==} - - lodash.memoize@4.1.2: - resolution: {integrity: sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==} - - lodash.merge@4.6.2: - resolution: {integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==} - - lodash.mergewith@4.6.2: - resolution: {integrity: sha512-GK3g5RPZWTRSeLSpgP8Xhra+pnjBC56q9FZYe1d5RN3TJ35dbkGy3YqBSMbyCrlbi+CM9Z3Jk5yTL7RCsqboyQ==} - - lodash.snakecase@4.1.1: - resolution: {integrity: sha512-QZ1d4xoBHYUeuouhEq3lk3Uq7ldgyFXGBhg04+oRLnIz8o9T65Eh+8YdroUwn846zchkA9yDsDl5CVVaV2nqYw==} - - lodash.sortby@4.7.0: - resolution: {integrity: sha512-HDWXG8isMntAyRF5vZ7xKuEvOhT4AhlRt/3czTSjvGUxjYCBVRQY48ViDHyfYz9VIoBkW4TMGQNapx+l3RUwdA==} - - lodash.startcase@4.4.0: - resolution: {integrity: sha512-+WKqsK294HMSc2jEbNgpHpd0JfIBhp7rEV4aqXWqFr6AlXov+SlcgB1Fv01y2kGe3Gc8nMW7VA0SrGuSkRfIEg==} - - lodash.uniq@4.5.0: - resolution: {integrity: sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==} - - lodash.upperfirst@4.3.1: - resolution: {integrity: sha512-sReKOYJIJf74dhJONhU4e0/shzi1trVbSWDOhKYE5XV2O+H7Sb2Dihwuc7xWxVl+DgFPyTqIN3zMfT9cq5iWDg==} - - lodash@4.17.21: - resolution: {integrity: sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==} - - log-symbols@5.1.0: - resolution: {integrity: sha512-l0x2DvrW294C9uDCoQe1VSU4gf529FkSZ6leBl4TiqZH/e+0R7hSfHQBNut2mNygDgHwvYHfFLn6Oxb3VWj2rA==} - engines: {node: '>=12'} - - log-symbols@6.0.0: - resolution: {integrity: sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw==} - engines: {node: '>=18'} - - log-update@6.1.0: - resolution: {integrity: sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==} - engines: {node: '>=18'} - - long@4.0.0: - resolution: {integrity: sha512-XsP+KhQif4bjX1kbuSiySJFNAehNxgLb6hPRGJ9QsUr8ajHkuXGdrHmFUTUUXhDwVX2R5bY4JNZEwbUiMhV+MA==} - - lru-cache@10.4.3: - resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==} - - lru-cache@11.1.0: - resolution: {integrity: sha512-QIXZUBJUx+2zHUdQujWejBkcD9+cs94tLn0+YL8UrCh+D5sCXZ4c7LaEH48pNwRY3MLDgqUFyhlCyjJPf1WP0A==} - engines: {node: 20 || >=22} - - lru-cache@5.1.1: - resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==} - - magic-string@0.30.17: - resolution: {integrity: sha512-sNPKHvyjVf7gyjwS4xGTaW/mCnF8wnjtifKBEhxfZ7E/S8tQ0rssrwGNn6q8JH/ohItJfSQp9mBtQYuTlH5QnA==} - - magicast@0.3.5: - resolution: {integrity: sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ==} - - make-dir@4.0.0: - resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==} - engines: {node: '>=10'} - - make-error@1.3.6: - resolution: {integrity: sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==} - - makeerror@1.0.12: - resolution: {integrity: sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==} - - many-keys-map@2.0.1: - resolution: {integrity: sha512-DHnZAD4phTbZ+qnJdjoNEVU1NecYoSdbOOoVmTDH46AuxDkEVh3MxTVpXq10GtcTC6mndN9dkv1rNfpjRcLnOw==} - - marky@1.3.0: - resolution: {integrity: sha512-ocnPZQLNpvbedwTy9kNrQEsknEfgvcLMvOtz3sFeWApDq1MXH1TqkCIx58xlpESsfwQOnuBO9beyQuNGzVvuhQ==} - - math-intrinsics@1.1.0: - resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==} - engines: {node: '>= 0.4'} - - media-typer@1.1.0: - resolution: {integrity: sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==} - engines: {node: '>= 0.8'} - - meow@12.1.1: - resolution: {integrity: sha512-BhXM0Au22RwUneMPwSCnyhTOizdWoIEPU9sp0Aqa1PnDMR5Wv2FGXYDjuzJEIX+Eo2Rb8xuYe5jrnm5QowQFkw==} - engines: {node: '>=16.10'} - - merge-descriptors@2.0.0: - resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==} - engines: {node: '>=18'} - - merge-stream@2.0.0: - resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==} - - merge2@1.4.1: - resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==} - engines: {node: '>= 8'} - - methods@1.1.2: - resolution: {integrity: sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==} - engines: {node: '>= 0.6'} - - micromatch@4.0.8: - resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==} - engines: {node: '>=8.6'} - - mime-db@1.52.0: - resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==} - engines: {node: '>= 0.6'} - - mime-db@1.54.0: - resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==} - engines: {node: '>= 0.6'} - - mime-types@2.1.35: - resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==} - engines: {node: '>= 0.6'} - - mime-types@3.0.1: - resolution: {integrity: sha512-xRc4oEhT6eaBpU1XF7AjpOFD+xQmXNB5OVKwp4tqCuBpHLS/ZbBDrc07mYTDqVMg6PfxUjjNp85O6Cd2Z/5HWA==} - engines: {node: '>= 0.6'} - - mime@2.6.0: - resolution: {integrity: sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg==} - engines: {node: '>=4.0.0'} - hasBin: true - - mimic-fn@2.1.0: - resolution: {integrity: sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==} - engines: {node: '>=6'} - - mimic-fn@4.0.0: - resolution: {integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==} - engines: {node: '>=12'} - - mimic-function@5.0.1: - resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==} - engines: {node: '>=18'} - - mimic-response@3.1.0: - resolution: {integrity: sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==} - engines: {node: '>=10'} - - minimatch@10.0.1: - resolution: {integrity: sha512-ethXTt3SGGR+95gudmqJ1eNhRO7eGEGIgYA9vnPatK4/etz2MEVDno5GMCibdMTuBMyElzIlgxMna3K94XDIDQ==} - engines: {node: 20 || >=22} - - minimatch@3.1.2: - resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==} - - minimatch@5.1.6: - resolution: {integrity: sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==} - engines: {node: '>=10'} - - minimatch@9.0.5: - resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==} - engines: {node: '>=16 || 14 >=14.17'} - - minimist@1.2.8: - resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==} - - minipass@7.1.2: - resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==} - engines: {node: '>=16 || 14 >=14.17'} - - mkdirp-classic@0.5.3: - resolution: {integrity: sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==} - - mlly@1.7.4: - resolution: {integrity: sha512-qmdSIPC4bDJXgZTCR7XosJiNKySV7O215tsPtDN9iEO/7q/76b/ijtgRu/+epFXSJhijtTCCGp3DWS549P3xKw==} - - ms@2.0.0: - resolution: {integrity: sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==} - - ms@2.1.3: - resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==} - - muggle-string@0.4.1: - resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==} - - multimatch@6.0.0: - resolution: {integrity: sha512-I7tSVxHGPlmPN/enE3mS1aOSo6bWBfls+3HmuEeCUBCE7gWnm3cBXCBkpurzFjVRwC6Kld8lLaZ1Iv5vOcjvcQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - mz@2.7.0: - resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==} - - nano-spawn@0.2.1: - resolution: {integrity: sha512-/pULofvsF8mOVcl/nUeVXL/GYOEvc7eJWSIxa+K4OYUolvXa5zwSgevsn4eoHs1xvh/BO3vx/PZiD9+Ow2ZVuw==} - engines: {node: '>=18.19'} - - nanoid@3.3.11: - resolution: {integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==} - engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} - hasBin: true - - napi-build-utils@2.0.0: - resolution: {integrity: sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==} - - natural-compare@1.4.0: - resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==} - - negotiator@1.0.0: - resolution: {integrity: sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==} - engines: {node: '>= 0.6'} - - node-abi@3.75.0: - resolution: {integrity: sha512-OhYaY5sDsIka7H7AtijtI9jwGYLyl29eQn/W623DiN/MIv5sUqc4g7BIDThX+gb7di9f6xK02nkp8sdfFWZLTg==} - engines: {node: '>=10'} - - node-addon-api@6.1.0: - resolution: {integrity: sha512-+eawOlIgy680F0kBzPUNFhMZGtJ1YmqM6l4+Crf4IkImjYrO/mqPwRMh352g23uIaQKFItcQ64I7KMaJxHgAVA==} - - node-fetch-native@1.6.6: - resolution: {integrity: sha512-8Mc2HhqPdlIfedsuZoc3yioPuzp6b+L5jRCRY1QzuWZh2EGJVQrGppC6V6cF0bLdbW0+O2YpqCA25aF/1lvipQ==} - - node-fetch@2.7.0: - resolution: {integrity: sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==} - engines: {node: 4.x || >=6.0.0} - peerDependencies: - encoding: ^0.1.0 - peerDependenciesMeta: - encoding: - optional: true - - node-forge@1.3.1: - resolution: {integrity: sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==} - engines: {node: '>= 6.13.0'} - - node-int64@0.4.0: - resolution: {integrity: sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==} - - node-notifier@10.0.1: - resolution: {integrity: sha512-YX7TSyDukOZ0g+gmzjB6abKu+hTGvO8+8+gIFDsRCU2t8fLV/P2unmt+LGFaIa4y64aX98Qksa97rgz4vMNeLQ==} - - node-releases@2.0.19: - resolution: {integrity: sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==} - - nodemon@3.1.10: - resolution: {integrity: sha512-WDjw3pJ0/0jMFmyNDp3gvY2YizjLmmOUQo6DEBY+JgdvW/yQ9mEeSw6H5ythl5Ny2ytb7f9C2nIbjSxMNzbJXw==} - engines: {node: '>=10'} - hasBin: true - - normalize-path@3.0.0: - resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==} - engines: {node: '>=0.10.0'} - - npm-run-path@4.0.1: - resolution: {integrity: sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==} - engines: {node: '>=8'} - - npm-run-path@5.3.0: - resolution: {integrity: sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - nth-check@2.1.1: - resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==} - - nypm@0.6.0: - resolution: {integrity: sha512-mn8wBFV9G9+UFHIrq+pZ2r2zL4aPau/by3kJb3cM7+5tQHMt6HGQB8FDIeKFYp8o0D2pnH6nVsO88N4AmUxIWg==} - engines: {node: ^14.16.0 || >=16.10.0} - hasBin: true - - object-assign@4.1.1: - resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==} - engines: {node: '>=0.10.0'} - - object-inspect@1.13.4: - resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==} - engines: {node: '>= 0.4'} - - ofetch@1.4.1: - resolution: {integrity: sha512-QZj2DfGplQAr2oj9KzceK9Hwz6Whxazmn85yYeVuS3u9XTMOGMRx0kO95MQ+vLsj/S/NwBDMMLU5hpxvI6Tklw==} - - ohash@2.0.11: - resolution: {integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==} - - on-exit-leak-free@2.1.2: - resolution: {integrity: sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==} - engines: {node: '>=14.0.0'} - - on-finished@2.4.1: - resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==} - engines: {node: '>= 0.8'} - - once@1.4.0: - resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==} - - onetime@5.1.2: - resolution: {integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==} - engines: {node: '>=6'} - - onetime@6.0.0: - resolution: {integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==} - engines: {node: '>=12'} - - onetime@7.0.0: - resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==} - engines: {node: '>=18'} - - onnx-proto@4.0.4: - resolution: {integrity: sha512-aldMOB3HRoo6q/phyB6QRQxSt895HNNw82BNyZ2CMh4bjeKv7g/c+VpAFtJuEMVfYLMbRx61hbuqnKceLeDcDA==} - - onnxruntime-common@1.14.0: - resolution: {integrity: sha512-3LJpegM2iMNRX2wUmtYfeX/ytfOzNwAWKSq1HbRrKc9+uqG/FsEA0bbKZl1btQeZaXhC26l44NWpNUeXPII7Ew==} - - onnxruntime-node@1.14.0: - resolution: {integrity: sha512-5ba7TWomIV/9b6NH/1x/8QEeowsb+jBEvFzU6z0T4mNsFwdPqXeFUM7uxC6QeSRkEbWu3qEB0VMjrvzN/0S9+w==} - os: [win32, darwin, linux] - - onnxruntime-web@1.14.0: - resolution: {integrity: sha512-Kcqf43UMfW8mCydVGcX9OMXI2VN17c0p6XvR7IPSZzBf/6lteBzXHvcEVWDPmCKuGombl997HgLqj91F11DzXw==} - - open@10.1.2: - resolution: {integrity: sha512-cxN6aIDPz6rm8hbebcP7vrQNhvRcveZoJU72Y7vskh4oIm+BZwBECnx5nTmrlres1Qapvx27Qo1Auukpf8PKXw==} - engines: {node: '>=18'} - - open@8.4.2: - resolution: {integrity: sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==} - engines: {node: '>=12'} - - open@9.1.0: - resolution: {integrity: sha512-OS+QTnw1/4vrf+9hh1jc1jnYjzSG4ttTBB8UxOwAnInG3Uo4ssetzC1ihqaIHjLJnA5GGlRl6QlZXOTQhRBUvg==} - engines: {node: '>=14.16'} - - optionator@0.9.4: - resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==} - engines: {node: '>= 0.8.0'} - - ora@6.3.1: - resolution: {integrity: sha512-ERAyNnZOfqM+Ao3RAvIXkYh5joP220yf59gVe2X/cI6SiCxIdi4c9HZKZD8R6q/RDXEje1THBju6iExiSsgJaQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - ora@8.2.0: - resolution: {integrity: sha512-weP+BZ8MVNnlCm8c0Qdc1WSWq4Qn7I+9CJGm7Qali6g44e/PUzbjNqJX5NJ9ljlNMosfJvg1fKEGILklK9cwnw==} - engines: {node: '>=18'} - - os-shim@0.1.3: - resolution: {integrity: sha512-jd0cvB8qQ5uVt0lvCIexBaROw1KyKm5sbulg2fWOHjETisuCzWyt+eTZKEMs8v6HwzoGs8xik26jg7eCM6pS+A==} - engines: {node: '>= 0.4.0'} - - p-limit@2.3.0: - resolution: {integrity: sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==} - engines: {node: '>=6'} - - p-limit@3.1.0: - resolution: {integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==} - engines: {node: '>=10'} - - p-limit@4.0.0: - resolution: {integrity: sha512-5b0R4txpzjPWVw/cXXUResoD4hb6U/x9BH08L7nw+GN1sezDzPdxeRvpc9c433fZhBan/wusjbCsqwqm4EIBIQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - p-locate@4.1.0: - resolution: {integrity: sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==} - engines: {node: '>=8'} - - p-locate@5.0.0: - resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==} - engines: {node: '>=10'} - - p-locate@6.0.0: - resolution: {integrity: sha512-wPrq66Llhl7/4AGC6I+cqxT07LhXvWL08LNXz1fENOw0Ap4sRZZ/gZpTTJ5jpurzzzfS2W/Ge9BY3LgLjCShcw==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - p-map@7.0.3: - resolution: {integrity: sha512-VkndIv2fIB99swvQoA65bm+fsmt6UNdGeIB0oxBs+WhAhdh08QA04JXpI7rbB9r08/nkbysKoya9rtDERYOYMA==} - engines: {node: '>=18'} - - p-try@2.2.0: - resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==} - engines: {node: '>=6'} - - package-json-from-dist@1.0.1: - resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==} - - package-json@10.0.1: - resolution: {integrity: sha512-ua1L4OgXSBdsu1FPb7F3tYH0F48a6kxvod4pLUlGY9COeJAJQNX/sNH2IiEmsxw7lqYiAwrdHMjz1FctOsyDQg==} - engines: {node: '>=18'} - - pako@1.0.11: - resolution: {integrity: sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==} - - parent-module@1.0.1: - resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==} - engines: {node: '>=6'} - - parse-json@5.2.0: - resolution: {integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==} - engines: {node: '>=8'} - - parse-json@7.1.1: - resolution: {integrity: sha512-SgOTCX/EZXtZxBE5eJ97P4yGM5n37BwRU+YMsH4vNzFqJV/oWFXXCmwFlgWUM4PrakybVOueJJ6pwHqSVhTFDw==} - engines: {node: '>=16'} - - parse5-htmlparser2-tree-adapter@6.0.1: - resolution: {integrity: sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA==} - - parse5@5.1.1: - resolution: {integrity: sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==} - - parse5@6.0.1: - resolution: {integrity: sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==} - - parseurl@1.3.3: - resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==} - engines: {node: '>= 0.8'} - - path-browserify@1.0.1: - resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==} - - path-exists@4.0.0: - resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==} - engines: {node: '>=8'} - - path-exists@5.0.0: - resolution: {integrity: sha512-RjhtfwJOxzcFmNOi6ltcbcu4Iu+FL3zEj83dk4kAS+fVpTxXLO1b38RvJgT/0QwvV/L3aY9TAnyv0EOqW4GoMQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - path-is-absolute@1.0.1: - resolution: {integrity: sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==} - engines: {node: '>=0.10.0'} - - path-key@3.1.1: - resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==} - engines: {node: '>=8'} - - path-key@4.0.0: - resolution: {integrity: sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==} - engines: {node: '>=12'} - - path-parse@1.0.7: - resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==} - - path-scurry@1.11.1: - resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==} - engines: {node: '>=16 || 14 >=14.18'} - - path-scurry@2.0.0: - resolution: {integrity: sha512-ypGJsmGtdXUOeM5u93TyeIEfEhM6s+ljAhrk5vAvSx8uyY/02OvrZnA0YNGUrPXfpJMgI1ODd3nwz8Npx4O4cg==} - engines: {node: 20 || >=22} - - path-to-regexp@8.2.0: - resolution: {integrity: sha512-TdrF7fW9Rphjq4RjrW0Kp2AW0Ahwu9sRGTkS6bvDi0SCwZlEZYmcfDbEsTz8RVk0EHIS/Vd1bv3JhG+1xZuAyQ==} - engines: {node: '>=16'} - - pathe@2.0.3: - resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==} - - pend@1.2.0: - resolution: {integrity: sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==} - - perfect-debounce@1.0.0: - resolution: {integrity: sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA==} - - picocolors@1.1.1: - resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} - - picomatch@2.3.1: - resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==} - engines: {node: '>=8.6'} - - picomatch@4.0.2: - resolution: {integrity: sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==} - engines: {node: '>=12'} - - pidtree@0.6.0: - resolution: {integrity: sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==} - engines: {node: '>=0.10'} - hasBin: true - - pino-abstract-transport@2.0.0: - resolution: {integrity: sha512-F63x5tizV6WCh4R6RHyi2Ml+M70DNRXt/+HANowMflpgGFMAym/VKm6G7ZOQRjqN7XbGxK1Lg9t6ZrtzOaivMw==} - - pino-pretty@13.0.0: - resolution: {integrity: sha512-cQBBIVG3YajgoUjo1FdKVRX6t9XPxwB9lcNJVD5GCnNM4Y6T12YYx8c6zEejxQsU0wrg9TwmDulcE9LR7qcJqA==} - hasBin: true - - pino-std-serializers@7.0.0: - resolution: {integrity: sha512-e906FRY0+tV27iq4juKzSYPbUj2do2X2JX4EzSca1631EB2QJQUqGbDuERal7LCtOpxl6x3+nvo9NPZcmjkiFA==} - - pino@9.6.0: - resolution: {integrity: sha512-i85pKRCt4qMjZ1+L7sy2Ag4t1atFcdbEt76+7iRJn1g2BvsnRMGu9p8pivl9fs63M2kF/A0OacFZhTub+m/qMg==} - hasBin: true - - pino@9.7.0: - resolution: {integrity: sha512-vnMCM6xZTb1WDmLvtG2lE/2p+t9hDEIvTWJsu6FejkE62vB7gDhvzrpFR4Cw2to+9JNQxVnkAKVPA1KPB98vWg==} - hasBin: true - - pirates@4.0.7: - resolution: {integrity: sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==} - engines: {node: '>= 6'} - - pkce-challenge@5.0.0: - resolution: {integrity: sha512-ueGLflrrnvwB3xuo/uGob5pd5FN7l0MsLf0Z87o/UQmRtwjvfylfc9MurIxRAWywCYTgrvpXBcqjV4OfCYGCIQ==} - engines: {node: '>=16.20.0'} - - pkg-dir@4.2.0: - resolution: {integrity: sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==} - engines: {node: '>=8'} - - pkg-types@1.3.1: - resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==} - - pkg-types@2.1.0: - resolution: {integrity: sha512-wmJwA+8ihJixSoHKxZJRBQG1oY8Yr9pGLzRmSsNms0iNWyHHAlZCa7mmKiFR10YPZuz/2k169JiS/inOjBCZ2A==} - - platform@1.3.6: - resolution: {integrity: sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg==} - - postcss-load-config@6.0.1: - resolution: {integrity: sha512-oPtTM4oerL+UXmx+93ytZVN82RrlY/wPUV8IeDxFrzIjXOLF1pN+EmKPLbubvKHT2HC20xXsCAH2Z+CKV6Oz/g==} - engines: {node: '>= 18'} - peerDependencies: - jiti: '>=1.21.0' - postcss: '>=8.0.9' - tsx: ^4.8.1 - yaml: ^2.4.2 - peerDependenciesMeta: - jiti: - optional: true - postcss: - optional: true - tsx: - optional: true - yaml: - optional: true - - postcss-selector-parser@6.1.2: - resolution: {integrity: sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==} - engines: {node: '>=4'} - - postcss@8.5.4: - resolution: {integrity: sha512-QSa9EBe+uwlGTFmHsPKokv3B/oEMQZxfqW0QqNCyhpa6mB1afzulwn8hihglqAb2pOw+BJgNlmXQ8la2VeHB7w==} - engines: {node: ^10 || ^12 || >=14} - - prebuild-install@7.1.3: - resolution: {integrity: sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==} - engines: {node: '>=10'} - hasBin: true - - prelude-ls@1.2.1: - resolution: {integrity: sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==} - engines: {node: '>= 0.8.0'} - - prettier@3.5.3: - resolution: {integrity: sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==} - engines: {node: '>=14'} - hasBin: true - - pretty-format@29.7.0: - resolution: {integrity: sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==} - engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} - - process-nextick-args@2.0.1: - resolution: {integrity: sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==} - - process-warning@4.0.1: - resolution: {integrity: sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==} - - process-warning@5.0.0: - resolution: {integrity: sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA==} - - promise-toolbox@0.21.0: - resolution: {integrity: sha512-NV8aTmpwrZv+Iys54sSFOBx3tuVaOBvvrft5PNppnxy9xpU/akHbaWIril22AB22zaPgrgwKdD0KsrM0ptUtpg==} - engines: {node: '>=6'} - - prompts@2.4.2: - resolution: {integrity: sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==} - engines: {node: '>= 6'} - - proto-list@1.2.4: - resolution: {integrity: sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==} - - protobufjs@6.11.4: - resolution: {integrity: sha512-5kQWPaJHi1WoCpjTGszzQ32PG2F4+wRY6BmAT4Vfw56Q2FZ4YZzK20xUYQH4YkfehY1e6QSICrJquM6xXZNcrw==} - hasBin: true - - proxy-addr@2.0.7: - resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==} - engines: {node: '>= 0.10'} - - pstree.remy@1.1.8: - resolution: {integrity: sha512-77DZwxQmxKnu3aR542U+X8FypNzbfJ+C5XQDk3uWjWxn6151aIMGthWYRXTqT1E5oJvg+ljaa2OJi+VfvCOQ8w==} - - publish-browser-extension@3.0.0: - resolution: {integrity: sha512-gwjH8mIepNqID2VqKIxzT6lmtvkcc5tcWYzrGSUdkeUFFFSHhGp9xx01EZ7j8wPq50dDe0XU5VNbHMAqr6wWAA==} - engines: {node: ^18.0.0 || >=20.0.0} - hasBin: true - - pump@3.0.2: - resolution: {integrity: sha512-tUPXtzlGM8FE3P0ZL6DVs/3P58k9nk8/jZeQCurTJylQA8qFYzHFfhBJkuqyE0FifOsQ0uKWekiZ5g8wtr28cw==} - - punycode@2.3.1: - resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==} - engines: {node: '>=6'} - - pupa@3.1.0: - resolution: {integrity: sha512-FLpr4flz5xZTSJxSeaheeMKN/EDzMdK7b8PTOC6a5PYFKTucWbdqjgqaEyH0shFiSJrVB1+Qqi4Tk19ccU6Aug==} - engines: {node: '>=12.20'} - - pure-rand@6.1.0: - resolution: {integrity: sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==} - - qs@6.14.0: - resolution: {integrity: sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==} - engines: {node: '>=0.6'} - - quansync@0.2.10: - resolution: {integrity: sha512-t41VRkMYbkHyCYmOvx/6URnN80H7k4X0lLdBMGsz+maAwrJQYB1djpV6vHrQIBE0WBSGqhtEHrK9U3DWWH8v7A==} - - queue-microtask@1.2.3: - resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==} - - quick-format-unescaped@4.0.4: - resolution: {integrity: sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==} - - range-parser@1.2.1: - resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==} - engines: {node: '>= 0.6'} - - raw-body@3.0.0: - resolution: {integrity: sha512-RmkhL8CAyCRPXCE28MMH0z2PNWQBNk2Q09ZdxM9IOOXwxwZbN+qbWaatPkdkWIKL2ZVDImrN/pK5HTRz2PcS4g==} - engines: {node: '>= 0.8'} - - rc9@2.1.2: - resolution: {integrity: sha512-btXCnMmRIBINM2LDZoEmOogIZU7Qe7zn4BpomSKZ/ykbLObuBdvG+mFq11DL6fjH1DRwHhrlgtYWG96bJiC7Cg==} - - rc@1.2.8: - resolution: {integrity: sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==} - hasBin: true - - react-is@18.3.1: - resolution: {integrity: sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==} - - readable-stream@2.3.8: - resolution: {integrity: sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==} - - readable-stream@3.6.2: - resolution: {integrity: sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==} - engines: {node: '>= 6'} - - readdirp@3.6.0: - resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==} - engines: {node: '>=8.10.0'} - - readdirp@4.1.2: - resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==} - engines: {node: '>= 14.18.0'} - - real-require@0.2.0: - resolution: {integrity: sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==} - engines: {node: '>= 12.13.0'} - - regenerator-runtime@0.14.1: - resolution: {integrity: sha512-dYnhHh0nJoMfnkZs6GmmhFknAGRrLznOu5nc9ML+EJxGvrx6H7teuevqVqCuPcPK//3eDrrjQhehXVx9cnkGdw==} - - registry-auth-token@5.1.0: - resolution: {integrity: sha512-GdekYuwLXLxMuFTwAPg5UKGLW/UXzQrZvH/Zj791BQif5T05T0RsaLfHc9q3ZOKi7n+BoprPD9mJ0O0k4xzUlw==} - engines: {node: '>=14'} - - registry-url@6.0.1: - resolution: {integrity: sha512-+crtS5QjFRqFCoQmvGduwYWEBng99ZvmFvF+cUJkGYF1L1BfU8C6Zp9T7f5vPAwyLkUExpvK+ANVZmGU49qi4Q==} - engines: {node: '>=12'} - - require-directory@2.1.1: - resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==} - engines: {node: '>=0.10.0'} - - require-from-string@2.0.2: - resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==} - engines: {node: '>=0.10.0'} - - resolve-cwd@3.0.0: - resolution: {integrity: sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==} - engines: {node: '>=8'} - - resolve-from@4.0.0: - resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==} - engines: {node: '>=4'} - - resolve-from@5.0.0: - resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==} - engines: {node: '>=8'} - - resolve.exports@2.0.3: - resolution: {integrity: sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==} - engines: {node: '>=10'} - - resolve@1.22.10: - resolution: {integrity: sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==} - engines: {node: '>= 0.4'} - hasBin: true - - restore-cursor@4.0.0: - resolution: {integrity: sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - restore-cursor@5.1.0: - resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==} - engines: {node: '>=18'} - - ret@0.5.0: - resolution: {integrity: sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==} - engines: {node: '>=10'} - - reusify@1.1.0: - resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==} - engines: {iojs: '>=1.0.0', node: '>=0.10.0'} - - rfdc@1.4.1: - resolution: {integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==} - - rimraf@5.0.10: - resolution: {integrity: sha512-l0OE8wL34P4nJH/H2ffoaniAokM2qSmrtXHmlpvYr5AVVX8msAyW0l8NVJFDxlSK4u3Uh/f41cQheDVdnYijwQ==} - hasBin: true - - rimraf@6.0.1: - resolution: {integrity: sha512-9dkvaxAsk/xNXSJzMgFqqMCuFgt2+KsOFek3TMLfo8NCPfWpBmqwyNn5Y+NX56QUYfCtsyhF3ayiboEoUmJk/A==} - engines: {node: 20 || >=22} - hasBin: true - - rollup@4.42.0: - resolution: {integrity: sha512-LW+Vse3BJPyGJGAJt1j8pWDKPd73QM8cRXYK1IxOBgL2AGLu7Xd2YOW0M2sLUBCkF5MshXXtMApyEAEzMVMsnw==} - engines: {node: '>=18.0.0', npm: '>=8.0.0'} - hasBin: true - - router@2.2.0: - resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==} - engines: {node: '>= 18'} - - run-applescript@5.0.0: - resolution: {integrity: sha512-XcT5rBksx1QdIhlFOCtgZkB99ZEouFZ1E2Kc2LHqNW13U3/74YGdkQRmThTwxy4QIyookibDKYZOPqX//6BlAg==} - engines: {node: '>=12'} - - run-applescript@7.0.0: - resolution: {integrity: sha512-9by4Ij99JUr/MCFBUkDKLWK3G9HVXmabKz9U5MlIAIuvuzkiOicRYs8XJLxX+xahD+mLiiCYDqF9dKAgtzKP1A==} - engines: {node: '>=18'} - - run-parallel@1.2.0: - resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==} - - safe-buffer@5.1.2: - resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==} - - safe-buffer@5.2.1: - resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==} - - safe-regex2@5.0.0: - resolution: {integrity: sha512-YwJwe5a51WlK7KbOJREPdjNrpViQBI3p4T50lfwPuDhZnE3XGVTlGvi+aolc5+RvxDD6bnUmjVsU9n1eboLUYw==} - - safe-stable-stringify@2.5.0: - resolution: {integrity: sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==} - engines: {node: '>=10'} - - safer-buffer@2.1.2: - resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==} - - sax@1.4.1: - resolution: {integrity: sha512-+aWOz7yVScEGoKNd4PA10LZ8sk0A/z5+nXQG5giUO5rprX9jgYsTdov9qCchZiPIZezbZH+jRut8nPodFAX4Jg==} - - scule@1.3.0: - resolution: {integrity: sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==} - - secure-json-parse@2.7.0: - resolution: {integrity: sha512-6aU+Rwsezw7VR8/nyvKTx8QpWH9FrcYiXXlqC4z5d5XQBDRqtbfsRjnwGyqbi3gddNtWHuEk9OANUotL26qKUw==} - - secure-json-parse@4.0.0: - resolution: {integrity: sha512-dxtLJO6sc35jWidmLxo7ij+Eg48PM/kleBsxpC8QJE0qJICe+KawkDQmvCMZUr9u7WKVHgMW6vy3fQ7zMiFZMA==} - - semver@6.3.1: - resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==} - hasBin: true - - semver@7.7.2: - resolution: {integrity: sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==} - engines: {node: '>=10'} - hasBin: true - - send@1.2.0: - resolution: {integrity: sha512-uaW0WwXKpL9blXE2o0bRhoL2EGXIrZxQ2ZQ4mgcfoBxdFmQold+qWsD2jLrfZ0trjKL6vOw0j//eAwcALFjKSw==} - engines: {node: '>= 18'} - - serve-static@2.2.0: - resolution: {integrity: sha512-61g9pCh0Vnh7IutZjtLGGpTA355+OPn2TyDv/6ivP2h/AdAVX9azsoxmg2/M6nZeQZNYBEwIcsne1mJd9oQItQ==} - engines: {node: '>= 18'} - - set-cookie-parser@2.7.1: - resolution: {integrity: sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ==} - - set-value@4.1.0: - resolution: {integrity: sha512-zTEg4HL0RwVrqcWs3ztF+x1vkxfm0lP+MQQFPiMJTKVceBwEV0A569Ou8l9IYQG8jOZdMVI1hGsc0tmeD2o/Lw==} - engines: {node: '>=11.0'} - - setimmediate@1.0.5: - resolution: {integrity: sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==} - - setprototypeof@1.2.0: - resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==} - - sharp@0.32.6: - resolution: {integrity: sha512-KyLTWwgcR9Oe4d9HwCwNM2l7+J0dUQwn/yf7S0EnTtb0eVS4RxO0eUSvxPtzT4F3SY+C4K6fqdv/DO27sJ/v/w==} - engines: {node: '>=14.15.0'} - - shebang-command@2.0.0: - resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==} - engines: {node: '>=8'} - - shebang-regex@3.0.0: - resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} - engines: {node: '>=8'} - - shell-quote@1.7.3: - resolution: {integrity: sha512-Vpfqwm4EnqGdlsBFNmHhxhElJYrdfcxPThu+ryKS5J8L/fhAwLazFZtq+S+TWZ9ANj2piSQLGj6NQg+lKPmxrw==} - - shellwords@0.1.1: - resolution: {integrity: sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==} - - side-channel-list@1.0.0: - resolution: {integrity: sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==} - engines: {node: '>= 0.4'} - - side-channel-map@1.0.1: - resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==} - engines: {node: '>= 0.4'} - - side-channel-weakmap@1.0.2: - resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==} - engines: {node: '>= 0.4'} - - side-channel@1.1.0: - resolution: {integrity: sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==} - engines: {node: '>= 0.4'} - - signal-exit@3.0.7: - resolution: {integrity: sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==} - - signal-exit@4.1.0: - resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==} - engines: {node: '>=14'} - - simple-concat@1.0.1: - resolution: {integrity: sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==} - - simple-get@4.0.1: - resolution: {integrity: sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==} - - simple-swizzle@0.2.2: - resolution: {integrity: sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==} - - simple-update-notifier@2.0.0: - resolution: {integrity: sha512-a2B9Y0KlNXl9u/vsW6sTIu9vGEpfKu2wRV6l1H3XEas/0gUIzGzBoP/IouTcUQbm9JWZLH3COxyn03TYlFax6w==} - engines: {node: '>=10'} - - sisteransi@1.0.5: - resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==} - - slash@3.0.0: - resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==} - engines: {node: '>=8'} - - slice-ansi@5.0.0: - resolution: {integrity: sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==} - engines: {node: '>=12'} - - slice-ansi@7.1.0: - resolution: {integrity: sha512-bSiSngZ/jWeX93BqeIAbImyTbEihizcwNjFoRUIY/T1wWQsfsm2Vw1agPKylXvQTU7iASGdHhyqRlqQzfz+Htg==} - engines: {node: '>=18'} - - sonic-boom@4.2.0: - resolution: {integrity: sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww==} - - source-map-js@1.2.1: - resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} - engines: {node: '>=0.10.0'} - - source-map-support@0.5.13: - resolution: {integrity: sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==} - - source-map-support@0.5.21: - resolution: {integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==} - - source-map@0.6.1: - resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==} - engines: {node: '>=0.10.0'} - - source-map@0.7.4: - resolution: {integrity: sha512-l3BikUxvPOcn5E74dZiq5BGsTb5yEwhaTSzccU6t4sDOH8NWJCstKO5QT2CvtFoK6F0saL7p9xHAqHOlCPJygA==} - engines: {node: '>= 8'} - - source-map@0.8.0-beta.0: - resolution: {integrity: sha512-2ymg6oRBpebeZi9UUNsgQ89bhx01TcTkmNTGnNO88imTmbSgy4nfujrgVEFKWpMTEGA11EDkTt7mqObTPdigIA==} - engines: {node: '>= 8'} - deprecated: The work that was done in this beta branch won't be included in future versions - - spawn-sync@1.0.15: - resolution: {integrity: sha512-9DWBgrgYZzNghseho0JOuh+5fg9u6QWhAWa51QC7+U5rCheZ/j1DrEZnyE0RBBRqZ9uEXGPgSSM0nky6burpVw==} - - split2@4.2.0: - resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==} - engines: {node: '>= 10.x'} - - split@1.0.1: - resolution: {integrity: sha512-mTyOoPbrivtXnwnIxZRFYRrPNtEFKlpB2fvjSnCQUiAA6qAZzqwna5envK4uk6OIeP17CsdF3rSBGYVBsU0Tkg==} - - sprintf-js@1.0.3: - resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==} - - stack-utils@2.0.6: - resolution: {integrity: sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==} - engines: {node: '>=10'} - - statuses@2.0.1: - resolution: {integrity: sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==} - engines: {node: '>= 0.8'} - - statuses@2.0.2: - resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==} - engines: {node: '>= 0.8'} - - stdin-discarder@0.1.0: - resolution: {integrity: sha512-xhV7w8S+bUwlPTb4bAOUQhv8/cSS5offJuX8GQGq32ONF0ZtDWKfkdomM3HMRA+LhX6um/FZ0COqlwsjD53LeQ==} - engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} - - stdin-discarder@0.2.2: - resolution: {integrity: sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ==} - engines: {node: '>=18'} - - streamx@2.22.1: - resolution: {integrity: sha512-znKXEBxfatz2GBNK02kRnCXjV+AA4kjZIUxeWSr3UGirZMJfTE9uiwKHobnbgxWyL/JWro8tTq+vOqAK1/qbSA==} - - string-argv@0.3.2: - resolution: {integrity: sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==} - engines: {node: '>=0.6.19'} - - string-length@4.0.2: - resolution: {integrity: sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==} - engines: {node: '>=10'} - - string-width@4.2.3: - resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==} - engines: {node: '>=8'} - - string-width@5.1.2: - resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==} - engines: {node: '>=12'} - - string-width@7.2.0: - resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==} - engines: {node: '>=18'} - - string_decoder@1.1.1: - resolution: {integrity: sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==} - - string_decoder@1.3.0: - resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==} - - strip-ansi@6.0.1: - resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==} - engines: {node: '>=8'} - - strip-ansi@7.1.0: - resolution: {integrity: sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==} - engines: {node: '>=12'} - - strip-bom@4.0.0: - resolution: {integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==} - engines: {node: '>=8'} - - strip-bom@5.0.0: - resolution: {integrity: sha512-p+byADHF7SzEcVnLvc/r3uognM1hUhObuHXxJcgLCfD194XAkaLbjq3Wzb0N5G2tgIjH0dgT708Z51QxMeu60A==} - engines: {node: '>=12'} - - strip-final-newline@2.0.0: - resolution: {integrity: sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==} - engines: {node: '>=6'} - - strip-final-newline@3.0.0: - resolution: {integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==} - engines: {node: '>=12'} - - strip-json-comments@2.0.1: - resolution: {integrity: sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==} - engines: {node: '>=0.10.0'} - - strip-json-comments@3.1.1: - resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==} - engines: {node: '>=8'} - - strip-json-comments@5.0.1: - resolution: {integrity: sha512-0fk9zBqO67Nq5M/m45qHCJxylV/DhBlIOVExqgOMiCCrzrhU6tCibRXNqE3jwJLftzE9SNuZtYbpzcO+i9FiKw==} - engines: {node: '>=14.16'} - - strip-literal@3.0.0: - resolution: {integrity: sha512-TcccoMhJOM3OebGhSBEmp3UZ2SfDMZUEBdRA/9ynfLi8yYajyWX3JiXArcJt4Umh4vISpspkQIY8ZZoCqjbviA==} - - stubborn-fs@1.2.5: - resolution: {integrity: sha512-H2N9c26eXjzL/S/K+i/RHHcFanE74dptvvjM8iwzwbVcWY/zjBbgRqF3K0DY4+OD+uTTASTBvDoxPDaPN02D7g==} - - sucrase@3.35.0: - resolution: {integrity: sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==} - engines: {node: '>=16 || 14 >=14.17'} - hasBin: true - - superagent@10.2.1: - resolution: {integrity: sha512-O+PCv11lgTNJUzy49teNAWLjBZfc+A1enOwTpLlH6/rsvKcTwcdTT8m9azGkVqM7HBl5jpyZ7KTPhHweokBcdg==} - engines: {node: '>=14.18.0'} - deprecated: Please upgrade to superagent v10.2.2+, see release notes at https://github.com/forwardemail/superagent/releases/tag/v10.2.2 - maintenance is supported by Forward Email @ https://forwardemail.net - - supertest@7.1.1: - resolution: {integrity: sha512-aI59HBTlG9e2wTjxGJV+DygfNLgnWbGdZxiA/sgrnNNikIW8lbDvCtF6RnhZoJ82nU7qv7ZLjrvWqCEm52fAmw==} - engines: {node: '>=14.18.0'} - deprecated: Please upgrade to supertest v7.1.3+, see release notes at https://github.com/forwardemail/supertest/releases/tag/v7.1.3 - maintenance is supported by Forward Email @ https://forwardemail.net - - supports-color@5.5.0: - resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==} - engines: {node: '>=4'} - - supports-color@7.2.0: - resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==} - engines: {node: '>=8'} - - supports-color@8.1.1: - resolution: {integrity: sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==} - engines: {node: '>=10'} - - supports-preserve-symlinks-flag@1.0.0: - resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==} - engines: {node: '>= 0.4'} - - tar-fs@2.1.3: - resolution: {integrity: sha512-090nwYJDmlhwFwEW3QQl+vaNnxsO2yVsd45eTKRBzSzu+hlb1w2K9inVq5b0ngXuLVqQ4ApvsUHHnu/zQNkWAg==} - - tar-fs@3.0.9: - resolution: {integrity: sha512-XF4w9Xp+ZQgifKakjZYmFdkLoSWd34VGKcsTCwlNWM7QG3ZbaxnTsaBwnjFZqHRf/rROxaR8rXnbtwdvaDI+lA==} - - tar-stream@2.2.0: - resolution: {integrity: sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==} - engines: {node: '>=6'} - - tar-stream@3.1.7: - resolution: {integrity: sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==} - - test-exclude@6.0.0: - resolution: {integrity: sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==} - engines: {node: '>=8'} - - text-decoder@1.2.3: - resolution: {integrity: sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==} - - text-extensions@2.4.0: - resolution: {integrity: sha512-te/NtwBwfiNRLf9Ijqx3T0nlqZiQ2XrrtBvu+cLL8ZRrGkO0NHTug8MYFKyoSrv/sHTaSKfilUkizV6XhxMJ3g==} - engines: {node: '>=8'} - - thenify-all@1.6.0: - resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==} - engines: {node: '>=0.8'} - - thenify@3.3.1: - resolution: {integrity: sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==} - - thread-stream@3.1.0: - resolution: {integrity: sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A==} - - through@2.3.8: - resolution: {integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==} - - tinyexec@0.3.2: - resolution: {integrity: sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==} - - tinyexec@1.0.1: - resolution: {integrity: sha512-5uC6DDlmeqiOwCPmK9jMSdOuZTh8bU39Ys6yidB+UTt5hfZUPGAypSgFRiEp+jbi9qH40BLDvy85jIU88wKSqw==} - - tinyglobby@0.2.14: - resolution: {integrity: sha512-tX5e7OM1HnYr2+a2C/4V0htOcSQcoSTH9KgJnVvNm5zm/cyEWKJ7j7YutsH9CxMdtOkkLFy2AHrMci9IM8IPZQ==} - engines: {node: '>=12.0.0'} - - titleize@3.0.0: - resolution: {integrity: sha512-KxVu8EYHDPBdUYdKZdKtU2aj2XfEx9AfjXxE/Aj0vT06w2icA09Vus1rh6eSu1y01akYg6BjIK/hxyLJINoMLQ==} - engines: {node: '>=12'} - - tmp@0.2.3: - resolution: {integrity: sha512-nZD7m9iCPC5g0pYmcaxogYKggSfLsdxl8of3Q/oIbqCqLLIO9IAF0GWjX1z9NZRHPiXv8Wex4yDCaZsgEw0Y8w==} - engines: {node: '>=14.14'} - - tmpl@1.0.5: - resolution: {integrity: sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==} - - to-regex-range@5.0.1: - resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==} - engines: {node: '>=8.0'} - - toad-cache@3.7.0: - resolution: {integrity: sha512-/m8M+2BJUpoJdgAHoG+baCwBT+tf2VraSfkBgl0Y00qIWt41DJ8R5B8nsEw0I58YwF5IZH6z24/2TobDKnqSWw==} - engines: {node: '>=12'} - - toidentifier@1.0.1: - resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==} - engines: {node: '>=0.6'} - - touch@3.1.1: - resolution: {integrity: sha512-r0eojU4bI8MnHr8c5bNo7lJDdI2qXlWWJk6a9EAFG7vbhTjElYhBVS3/miuE0uOuoLdb8Mc/rVfsmm6eo5o9GA==} - hasBin: true - - tr46@0.0.3: - resolution: {integrity: sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==} - - tr46@1.0.1: - resolution: {integrity: sha512-dTpowEjclQ7Kgx5SdBkqRzVhERQXov8/l9Ft9dVM9fmg0W0KQSVaXX9T4i6twCPNtYiZM53lpSSUAwJbFPOHxA==} - - tree-kill@1.2.2: - resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==} - hasBin: true - - ts-api-utils@2.1.0: - resolution: {integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==} - engines: {node: '>=18.12'} - peerDependencies: - typescript: '>=4.8.4' - - ts-interface-checker@0.1.13: - resolution: {integrity: sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==} - - ts-jest@29.3.4: - resolution: {integrity: sha512-Iqbrm8IXOmV+ggWHOTEbjwyCf2xZlUMv5npExksXohL+tk8va4Fjhb+X2+Rt9NBmgO7bJ8WpnMLOwih/DnMlFA==} - engines: {node: ^14.15.0 || ^16.10.0 || ^18.0.0 || >=20.0.0} - hasBin: true - peerDependencies: - '@babel/core': '>=7.0.0-beta.0 <8' - '@jest/transform': ^29.0.0 - '@jest/types': ^29.0.0 - babel-jest: ^29.0.0 - esbuild: '*' - jest: ^29.0.0 - typescript: '>=4.3 <6' - peerDependenciesMeta: - '@babel/core': - optional: true - '@jest/transform': - optional: true - '@jest/types': - optional: true - babel-jest: - optional: true - esbuild: - optional: true - - ts-node@10.9.2: - resolution: {integrity: sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==} - hasBin: true - peerDependencies: - '@swc/core': '>=1.2.50' - '@swc/wasm': '>=1.2.50' - '@types/node': '*' - typescript: '>=2.7' - peerDependenciesMeta: - '@swc/core': - optional: true - '@swc/wasm': - optional: true - - tslib@2.8.1: - resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} - - tsup@8.5.0: - resolution: {integrity: sha512-VmBp77lWNQq6PfuMqCHD3xWl22vEoWsKajkF8t+yMBawlUS8JzEI+vOVMeuNZIuMML8qXRizFKi9oD5glKQVcQ==} - engines: {node: '>=18'} - hasBin: true - peerDependencies: - '@microsoft/api-extractor': ^7.36.0 - '@swc/core': ^1 - postcss: ^8.4.12 - typescript: '>=4.5.0' - peerDependenciesMeta: - '@microsoft/api-extractor': - optional: true - '@swc/core': - optional: true - postcss: - optional: true - typescript: - optional: true - - tunnel-agent@0.6.0: - resolution: {integrity: sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==} - - type-check@0.4.0: - resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==} - engines: {node: '>= 0.8.0'} - - type-detect@4.0.8: - resolution: {integrity: sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==} - engines: {node: '>=4'} - - type-fest@0.21.3: - resolution: {integrity: sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==} - engines: {node: '>=10'} - - type-fest@3.13.1: - resolution: {integrity: sha512-tLq3bSNx+xSpwvAJnzrK0Ep5CLNWjvFTOp71URMaAEWBfRb9nnJiBoUe0tF8bI4ZFO3omgBR6NvnbzVUT3Ly4g==} - engines: {node: '>=14.16'} - - type-fest@4.41.0: - resolution: {integrity: sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==} - engines: {node: '>=16'} - - type-is@2.0.1: - resolution: {integrity: sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==} - engines: {node: '>= 0.6'} - - typedarray@0.0.6: - resolution: {integrity: sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==} - - typescript-eslint@8.33.1: - resolution: {integrity: sha512-AgRnV4sKkWOiZ0Kjbnf5ytTJXMUZQ0qhSVdQtDNYLPLnjsATEYhaO94GlRQwi4t4gO8FfjM6NnikHeKjUm8D7A==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - typescript: '>=4.8.4 <5.9.0' - - typescript@5.8.3: - resolution: {integrity: sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==} - engines: {node: '>=14.17'} - hasBin: true - - ufo@1.6.1: - resolution: {integrity: sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==} - - uhyphen@0.2.0: - resolution: {integrity: sha512-qz3o9CHXmJJPGBdqzab7qAYuW8kQGKNEuoHFYrBwV6hWIMcpAmxDLXojcHfFr9US1Pe6zUswEIJIbLI610fuqA==} - - undefsafe@2.0.5: - resolution: {integrity: sha512-WxONCrssBM8TSPRqN5EmsjVrsv4A8X12J4ArBiiayv3DyyG3ZlIg6yysuuSYdZsVz3TKcTg2fd//Ujd4CHV1iA==} - - undici-types@5.26.5: - resolution: {integrity: sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==} - - undici-types@6.21.0: - resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==} - - unicorn-magic@0.1.0: - resolution: {integrity: sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==} - engines: {node: '>=18'} - - unimport@5.0.1: - resolution: {integrity: sha512-1YWzPj6wYhtwHE+9LxRlyqP4DiRrhGfJxdtH475im8ktyZXO3jHj/3PZ97zDdvkYoovFdi0K4SKl3a7l92v3sQ==} - engines: {node: '>=18.12.0'} - - universalify@2.0.1: - resolution: {integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==} - engines: {node: '>= 10.0.0'} - - unpipe@1.0.0: - resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==} - engines: {node: '>= 0.8'} - - unplugin-utils@0.2.4: - resolution: {integrity: sha512-8U/MtpkPkkk3Atewj1+RcKIjb5WBimZ/WSLhhR3w6SsIj8XJuKTacSP8g+2JhfSGw0Cb125Y+2zA/IzJZDVbhA==} - engines: {node: '>=18.12.0'} - - unplugin@2.3.5: - resolution: {integrity: sha512-RyWSb5AHmGtjjNQ6gIlA67sHOsWpsbWpwDokLwTcejVdOjEkJZh7QKu14J00gDDVSh8kGH4KYC/TNBceXFZhtw==} - engines: {node: '>=18.12.0'} - - untildify@4.0.0: - resolution: {integrity: sha512-KK8xQ1mkzZeg9inewmFVDNkg3l5LUhoq9kN6iWYB/CC9YMG8HA+c1Q8HwDe6dEX7kErrEVNVBO3fWsVq5iDgtw==} - engines: {node: '>=8'} - - update-browserslist-db@1.1.3: - resolution: {integrity: sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==} - hasBin: true - peerDependencies: - browserslist: '>= 4.21.0' - - update-notifier@7.3.1: - resolution: {integrity: sha512-+dwUY4L35XFYEzE+OAL3sarJdUioVovq+8f7lcIJ7wnmnYQV5UD1Y/lcwaMSyaQ6Bj3JMj1XSTjZbNLHn/19yA==} - engines: {node: '>=18'} - - uri-js@4.4.1: - resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==} - - util-deprecate@1.0.2: - resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==} - - uuid@11.1.0: - resolution: {integrity: sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==} - hasBin: true - - uuid@8.3.2: - resolution: {integrity: sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==} - hasBin: true - - v8-compile-cache-lib@3.0.1: - resolution: {integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==} - - v8-to-istanbul@9.3.0: - resolution: {integrity: sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==} - engines: {node: '>=10.12.0'} - - vary@1.1.2: - resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==} - engines: {node: '>= 0.8'} - - vite-node@3.2.3: - resolution: {integrity: sha512-gc8aAifGuDIpZHrPjuHyP4dpQmYXqWw7D1GmDnWeNWP654UEXzVfQ5IHPSK5HaHkwB/+p1atpYpSdw/2kOv8iQ==} - engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0} - hasBin: true - - vite-plugin-static-copy@3.0.0: - resolution: {integrity: sha512-Uki9pPUQ4ZnoMEdIFabvoh9h6Bh9Q1m3iF7BrZvoiF30reREpJh2gZb4jOnW1/uYFzyRiLCmFSkM+8hwiq1vWQ==} - engines: {node: ^18.0.0 || >=20.0.0} - peerDependencies: - vite: ^5.0.0 || ^6.0.0 - - vite@6.3.5: - resolution: {integrity: sha512-cZn6NDFE7wdTpINgs++ZJ4N49W2vRp8LCKrn3Ob1kYNtOo21vfDoaV5GzBfLU4MovSAB8uNRm4jgzVQZ+mBzPQ==} - engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0} - hasBin: true - peerDependencies: - '@types/node': ^18.0.0 || ^20.0.0 || >=22.0.0 - jiti: '>=1.21.0' - less: '*' - lightningcss: ^1.21.0 - sass: '*' - sass-embedded: '*' - stylus: '*' - sugarss: '*' - terser: ^5.16.0 - tsx: ^4.8.1 - yaml: ^2.4.2 - peerDependenciesMeta: - '@types/node': - optional: true - jiti: - optional: true - less: - optional: true - lightningcss: - optional: true - sass: - optional: true - sass-embedded: - optional: true - stylus: - optional: true - sugarss: - optional: true - terser: - optional: true - tsx: - optional: true - yaml: - optional: true - - vscode-uri@3.1.0: - resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==} - - vue-eslint-parser@10.1.3: - resolution: {integrity: sha512-dbCBnd2e02dYWsXoqX5yKUZlOt+ExIpq7hmHKPb5ZqKcjf++Eo0hMseFTZMLKThrUk61m+Uv6A2YSBve6ZvuDQ==} - engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} - peerDependencies: - eslint: ^8.57.0 || ^9.0.0 - - vue-tsc@2.2.10: - resolution: {integrity: sha512-jWZ1xSaNbabEV3whpIDMbjVSVawjAyW+x1n3JeGQo7S0uv2n9F/JMgWW90tGWNFRKya4YwKMZgCtr0vRAM7DeQ==} - hasBin: true - peerDependencies: - typescript: '>=5.0.0' - - vue@3.5.16: - resolution: {integrity: sha512-rjOV2ecxMd5SiAmof2xzh2WxntRcigkX/He4YFJ6WdRvVUrbt6DxC1Iujh10XLl8xCDRDtGKMeO3D+pRQ1PP9w==} - peerDependencies: - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true - - walker@1.0.8: - resolution: {integrity: sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==} - - watchpack@2.4.2: - resolution: {integrity: sha512-TnbFSbcOCcDgjZ4piURLCbJ3nJhznVh9kw6F6iokjiFPl8ONxe9A6nMDVXDiNbrSfLILs6vB07F7wLBrwPYzJw==} - engines: {node: '>=10.13.0'} - - wcwidth@1.0.1: - resolution: {integrity: sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg==} - - web-ext-run@0.2.3: - resolution: {integrity: sha512-u/IiZaZ7dHFqTM1MLF27rBy8mS9fEEsqoOKL0u+kQdOLmEioA/0Szp67ADd3WAJZLd8/hO8cFST1IC/YMXKIjQ==} - engines: {node: '>=18.0.0', npm: '>=8.0.0'} - - webidl-conversions@3.0.1: - resolution: {integrity: sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==} - - webidl-conversions@4.0.2: - resolution: {integrity: sha512-YQ+BmxuTgd6UXZW3+ICGfyqRyHXVlD5GtQr5+qjiNW7bF0cqrzX500HVXPBOvgXb5YnzDd+h0zqyv61KUD7+Sg==} - - webpack-virtual-modules@0.6.2: - resolution: {integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==} - - whatwg-url@5.0.0: - resolution: {integrity: sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==} - - whatwg-url@7.1.0: - resolution: {integrity: sha512-WUu7Rg1DroM7oQvGWfOiAK21n74Gg+T4elXEQYkOhtyLeWiJFoOGLXPKI/9gzIie9CtwVLm8wtw6YJdKyxSjeg==} - - when-exit@2.1.4: - resolution: {integrity: sha512-4rnvd3A1t16PWzrBUcSDZqcAmsUIy4minDXT/CZ8F2mVDgd65i4Aalimgz1aQkRGU0iH5eT5+6Rx2TK8o443Pg==} - - when@3.7.7: - resolution: {integrity: sha512-9lFZp/KHoqH6bPKjbWqa+3Dg/K/r2v0X/3/G2x4DBGchVS2QX2VXL3cZV994WQVnTM1/PD71Az25nAzryEUugw==} - - which@1.2.4: - resolution: {integrity: sha512-zDRAqDSBudazdfM9zpiI30Fu9ve47htYXcGi3ln0wfKu2a7SmrT6F3VDoYONu//48V8Vz4TdCRNPjtvyRO3yBA==} - hasBin: true - - which@2.0.2: - resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==} - engines: {node: '>= 8'} - hasBin: true - - widest-line@5.0.0: - resolution: {integrity: sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==} - engines: {node: '>=18'} - - winreg@0.0.12: - resolution: {integrity: sha512-typ/+JRmi7RqP1NanzFULK36vczznSNN8kWVA9vIqXyv8GhghUlwhGp1Xj3Nms1FsPcNnsQrJOR10N58/nQ9hQ==} - - word-wrap@1.2.5: - resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==} - engines: {node: '>=0.10.0'} - - wrap-ansi@7.0.0: - resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==} - engines: {node: '>=10'} - - wrap-ansi@8.1.0: - resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==} - engines: {node: '>=12'} - - wrap-ansi@9.0.0: - resolution: {integrity: sha512-G8ura3S+3Z2G+mkgNRq8dqaFZAuxfsxpBB8OCTGRTCtp+l/v9nbFNmCUP1BZMts3G1142MsZfn6eeUKrr4PD1Q==} - engines: {node: '>=18'} - - wrappy@1.0.2: - resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==} - - write-file-atomic@4.0.2: - resolution: {integrity: sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==} - engines: {node: ^12.13.0 || ^14.15.0 || >=16.0.0} - - ws@8.18.1: - resolution: {integrity: sha512-RKW2aJZMXeMxVpnZ6bck+RswznaxmzdULiBr6KY7XkTnW8uvt0iT9H5DkHUChXrc+uurzwa0rVI16n/Xzjdz1w==} - engines: {node: '>=10.0.0'} - peerDependencies: - bufferutil: ^4.0.1 - utf-8-validate: '>=5.0.2' - peerDependenciesMeta: - bufferutil: - optional: true - utf-8-validate: - optional: true - - wxt@0.20.7: - resolution: {integrity: sha512-KABq5i3CnXMUaJTcORGDLCi04K/IceUVAx5rler2QbZpLvS13OUOO0k+4s/7LI3+N8zXLh/GlQArMyJfk3M2yQ==} - hasBin: true - - xdg-basedir@5.1.0: - resolution: {integrity: sha512-GCPAHLvrIH13+c0SuacwvRYj2SxJXQ4kaVTT5xgL3kPrz56XxkF21IGhjSE1+W0aw7gpBWRGXLCPnPby6lSpmQ==} - engines: {node: '>=12'} - - xml-name-validator@4.0.0: - resolution: {integrity: sha512-ICP2e+jsHvAj2E2lIHxa5tjXRlKDJo4IdvPvCXbXQGdzSfmSpNVyIKMvoZHjDY9DP0zV17iI85o90vRFXNccRw==} - engines: {node: '>=12'} - - xml2js@0.6.2: - resolution: {integrity: sha512-T4rieHaC1EXcES0Kxxj4JWgaUQHDk+qwHcYOCFHfiwKz7tOVPLq7Hjq9dM1WCMhylqMEfP7hMcOIChvotiZegA==} - engines: {node: '>=4.0.0'} - - xmlbuilder@11.0.1: - resolution: {integrity: sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA==} - engines: {node: '>=4.0'} - - y18n@5.0.8: - resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==} - engines: {node: '>=10'} - - yallist@3.1.1: - resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==} - - yaml@2.8.0: - resolution: {integrity: sha512-4lLa/EcQCB0cJkyts+FpIRx5G/llPxfP6VQU5KByHEhLxY3IJCH0f0Hy1MHI8sClTvsIb8qwRJ6R/ZdlDJ/leQ==} - engines: {node: '>= 14.6'} - hasBin: true - - yargs-parser@20.2.9: - resolution: {integrity: sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==} - engines: {node: '>=10'} - - yargs-parser@21.1.1: - resolution: {integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==} - engines: {node: '>=12'} - - yargs@16.2.0: - resolution: {integrity: sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==} - engines: {node: '>=10'} - - yargs@17.7.2: - resolution: {integrity: sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==} - engines: {node: '>=12'} - - yauzl@2.10.0: - resolution: {integrity: sha512-p4a9I6X6nu6IhoGmBqAcbJy1mlC4j27vEPZX9F4L4/vZT3Lyq1VkFHw/V/PUcB9Buo+DG3iHkT0x3Qya58zc3g==} - - yn@3.1.1: - resolution: {integrity: sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==} - engines: {node: '>=6'} - - yocto-queue@0.1.0: - resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==} - engines: {node: '>=10'} - - yocto-queue@1.2.1: - resolution: {integrity: sha512-AyeEbWOu/TAXdxlV9wmGcR0+yh2j3vYPGOECcIj2S7MkrLyC7ne+oye2BKTItt0ii2PHk4cDy+95+LshzbXnGg==} - engines: {node: '>=12.20'} - - zip-dir@2.0.0: - resolution: {integrity: sha512-uhlsJZWz26FLYXOD6WVuq+fIcZ3aBPGo/cFdiLlv3KNwpa52IF3ISV8fLhQLiqVu5No3VhlqlgthN6gehil1Dg==} - - zod-to-json-schema@3.24.5: - resolution: {integrity: sha512-/AuWwMP+YqiPbsJx5D6TfgRTc4kTLjsh5SOcd4bLsfUg2RcEXrFMJl1DGgdHy2aCfsIA/cr/1JM0xcB2GZji8g==} - peerDependencies: - zod: ^3.24.1 - - zod@3.25.56: - resolution: {integrity: sha512-rd6eEF3BTNvQnR2e2wwolfTmUTnp70aUTqr0oaGbHifzC3BKJsoV+Gat8vxUMR1hwOKBs6El+qWehrHbCpW6SQ==} - -snapshots: - - '@1natsu/wait-element@4.1.2': - dependencies: - defu: 6.1.4 - many-keys-map: 2.0.1 - - '@aklinker1/rollup-plugin-visualizer@5.12.0(rollup@4.42.0)': - dependencies: - open: 8.4.2 - picomatch: 2.3.1 - source-map: 0.7.4 - yargs: 17.7.2 - optionalDependencies: - rollup: 4.42.0 - - '@ampproject/remapping@2.3.0': - dependencies: - '@jridgewell/gen-mapping': 0.3.8 - '@jridgewell/trace-mapping': 0.3.25 - - '@babel/code-frame@7.27.1': - dependencies: - '@babel/helper-validator-identifier': 7.27.1 - js-tokens: 4.0.0 - picocolors: 1.1.1 - - '@babel/compat-data@7.27.5': {} - - '@babel/core@7.27.4': - dependencies: - '@ampproject/remapping': 2.3.0 - '@babel/code-frame': 7.27.1 - '@babel/generator': 7.27.5 - '@babel/helper-compilation-targets': 7.27.2 - '@babel/helper-module-transforms': 7.27.3(@babel/core@7.27.4) - '@babel/helpers': 7.27.6 - '@babel/parser': 7.27.5 - '@babel/template': 7.27.2 - '@babel/traverse': 7.27.4 - '@babel/types': 7.27.6 - convert-source-map: 2.0.0 - debug: 4.4.1(supports-color@5.5.0) - gensync: 1.0.0-beta.2 - json5: 2.2.3 - semver: 6.3.1 - transitivePeerDependencies: - - supports-color - - '@babel/generator@7.27.5': - dependencies: - '@babel/parser': 7.27.5 - '@babel/types': 7.27.6 - '@jridgewell/gen-mapping': 0.3.8 - '@jridgewell/trace-mapping': 0.3.25 - jsesc: 3.1.0 - - '@babel/helper-compilation-targets@7.27.2': - dependencies: - '@babel/compat-data': 7.27.5 - '@babel/helper-validator-option': 7.27.1 - browserslist: 4.25.0 - lru-cache: 5.1.1 - semver: 6.3.1 - - '@babel/helper-module-imports@7.27.1': - dependencies: - '@babel/traverse': 7.27.4 - '@babel/types': 7.27.6 - transitivePeerDependencies: - - supports-color - - '@babel/helper-module-transforms@7.27.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-module-imports': 7.27.1 - '@babel/helper-validator-identifier': 7.27.1 - '@babel/traverse': 7.27.4 - transitivePeerDependencies: - - supports-color - - '@babel/helper-plugin-utils@7.27.1': {} - - '@babel/helper-string-parser@7.27.1': {} - - '@babel/helper-validator-identifier@7.27.1': {} - - '@babel/helper-validator-option@7.27.1': {} - - '@babel/helpers@7.27.6': - dependencies: - '@babel/template': 7.27.2 - '@babel/types': 7.27.6 - - '@babel/parser@7.27.5': - dependencies: - '@babel/types': 7.27.6 - - '@babel/plugin-syntax-async-generators@7.8.4(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-bigint@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-class-properties@7.12.13(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-class-static-block@7.14.5(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-import-attributes@7.27.1(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-import-meta@7.10.4(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-json-strings@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-jsx@7.27.1(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-logical-assignment-operators@7.10.4(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-nullish-coalescing-operator@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-numeric-separator@7.10.4(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-object-rest-spread@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-optional-catch-binding@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-optional-chaining@7.8.3(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-private-property-in-object@7.14.5(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-top-level-await@7.14.5(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/plugin-syntax-typescript@7.27.1(@babel/core@7.27.4)': - dependencies: - '@babel/core': 7.27.4 - '@babel/helper-plugin-utils': 7.27.1 - - '@babel/runtime@7.27.0': - dependencies: - regenerator-runtime: 0.14.1 - - '@babel/template@7.27.2': - dependencies: - '@babel/code-frame': 7.27.1 - '@babel/parser': 7.27.5 - '@babel/types': 7.27.6 - - '@babel/traverse@7.27.4': - dependencies: - '@babel/code-frame': 7.27.1 - '@babel/generator': 7.27.5 - '@babel/parser': 7.27.5 - '@babel/template': 7.27.2 - '@babel/types': 7.27.6 - debug: 4.4.1(supports-color@5.5.0) - globals: 11.12.0 - transitivePeerDependencies: - - supports-color - - '@babel/types@7.27.6': - dependencies: - '@babel/helper-string-parser': 7.27.1 - '@babel/helper-validator-identifier': 7.27.1 - - '@bcoe/v8-coverage@0.2.3': {} - - '@commitlint/cli@19.8.1(@types/node@22.15.30)(typescript@5.8.3)': - dependencies: - '@commitlint/format': 19.8.1 - '@commitlint/lint': 19.8.1 - '@commitlint/load': 19.8.1(@types/node@22.15.30)(typescript@5.8.3) - '@commitlint/read': 19.8.1 - '@commitlint/types': 19.8.1 - tinyexec: 1.0.1 - yargs: 17.7.2 - transitivePeerDependencies: - - '@types/node' - - typescript - - '@commitlint/config-conventional@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - conventional-changelog-conventionalcommits: 7.0.2 - - '@commitlint/config-validator@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - ajv: 8.17.1 - - '@commitlint/ensure@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - lodash.camelcase: 4.3.0 - lodash.kebabcase: 4.1.1 - lodash.snakecase: 4.1.1 - lodash.startcase: 4.4.0 - lodash.upperfirst: 4.3.1 - - '@commitlint/execute-rule@19.8.1': {} - - '@commitlint/format@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - chalk: 5.4.1 - - '@commitlint/is-ignored@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - semver: 7.7.2 - - '@commitlint/lint@19.8.1': - dependencies: - '@commitlint/is-ignored': 19.8.1 - '@commitlint/parse': 19.8.1 - '@commitlint/rules': 19.8.1 - '@commitlint/types': 19.8.1 - - '@commitlint/load@19.8.1(@types/node@22.15.30)(typescript@5.8.3)': - dependencies: - '@commitlint/config-validator': 19.8.1 - '@commitlint/execute-rule': 19.8.1 - '@commitlint/resolve-extends': 19.8.1 - '@commitlint/types': 19.8.1 - chalk: 5.4.1 - cosmiconfig: 9.0.0(typescript@5.8.3) - cosmiconfig-typescript-loader: 6.1.0(@types/node@22.15.30)(cosmiconfig@9.0.0(typescript@5.8.3))(typescript@5.8.3) - lodash.isplainobject: 4.0.6 - lodash.merge: 4.6.2 - lodash.uniq: 4.5.0 - transitivePeerDependencies: - - '@types/node' - - typescript - - '@commitlint/message@19.8.1': {} - - '@commitlint/parse@19.8.1': - dependencies: - '@commitlint/types': 19.8.1 - conventional-changelog-angular: 7.0.0 - conventional-commits-parser: 5.0.0 - - '@commitlint/read@19.8.1': - dependencies: - '@commitlint/top-level': 19.8.1 - '@commitlint/types': 19.8.1 - git-raw-commits: 4.0.0 - minimist: 1.2.8 - tinyexec: 1.0.1 - - '@commitlint/resolve-extends@19.8.1': - dependencies: - '@commitlint/config-validator': 19.8.1 - '@commitlint/types': 19.8.1 - global-directory: 4.0.1 - import-meta-resolve: 4.1.0 - lodash.mergewith: 4.6.2 - resolve-from: 5.0.0 - - '@commitlint/rules@19.8.1': - dependencies: - '@commitlint/ensure': 19.8.1 - '@commitlint/message': 19.8.1 - '@commitlint/to-lines': 19.8.1 - '@commitlint/types': 19.8.1 + /@esbuild/linux-riscv64@0.21.5: + resolution: {integrity: sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==} + engines: {node: '>=12'} + cpu: [riscv64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@commitlint/to-lines@19.8.1': {} + /@esbuild/linux-riscv64@0.25.12: + resolution: {integrity: sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@commitlint/top-level@19.8.1': - dependencies: - find-up: 7.0.0 + /@esbuild/linux-riscv64@0.27.1: + resolution: {integrity: sha512-7zlw8p3IApcsN7mFw0O1Z1PyEk6PlKMu18roImfl3iQHTnr/yAfYv6s4hXPidbDoI2Q0pW+5xeoM4eTCC0UdrQ==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@commitlint/types@19.8.1': - dependencies: - '@types/conventional-commits-parser': 5.0.1 - chalk: 5.4.1 + /@esbuild/linux-s390x@0.21.5: + resolution: {integrity: sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==} + engines: {node: '>=12'} + cpu: [s390x] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@cspotcode/source-map-support@0.8.1': - dependencies: - '@jridgewell/trace-mapping': 0.3.9 + /@esbuild/linux-s390x@0.25.12: + resolution: {integrity: sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@devicefarmer/adbkit-logcat@2.1.3': {} + /@esbuild/linux-s390x@0.27.1: + resolution: {integrity: sha512-cGj5wli+G+nkVQdZo3+7FDKC25Uh4ZVwOAK6A06Hsvgr8WqBBuOy/1s+PUEd/6Je+vjfm6stX0kmib5b/O2Ykw==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@devicefarmer/adbkit-monkey@1.2.1': {} + /@esbuild/linux-x64@0.21.5: + resolution: {integrity: sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==} + engines: {node: '>=12'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@devicefarmer/adbkit@3.3.8': - dependencies: - '@devicefarmer/adbkit-logcat': 2.1.3 - '@devicefarmer/adbkit-monkey': 1.2.1 - bluebird: 3.7.2 - commander: 9.5.0 - debug: 4.3.7 - node-forge: 1.3.1 - split: 1.0.1 - transitivePeerDependencies: - - supports-color + /@esbuild/linux-x64@0.25.12: + resolution: {integrity: sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@esbuild/aix-ppc64@0.25.5': + /@esbuild/linux-x64@0.27.1: + resolution: {integrity: sha512-z3H/HYI9MM0HTv3hQZ81f+AKb+yEoCRlUby1F80vbQ5XdzEMyY/9iNlAmhqiBKw4MJXwfgsh7ERGEOhrM1niMA==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@esbuild/android-arm64@0.25.5': + /@esbuild/netbsd-arm64@0.25.12: + resolution: {integrity: sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/android-arm@0.25.5': + /@esbuild/netbsd-arm64@0.27.1: + resolution: {integrity: sha512-wzC24DxAvk8Em01YmVXyjl96Mr+ecTPyOuADAvjGg+fyBpGmxmcr2E5ttf7Im8D0sXZihpxzO1isus8MdjMCXQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/android-x64@0.25.5': + /@esbuild/netbsd-x64@0.21.5: + resolution: {integrity: sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==} + engines: {node: '>=12'} + cpu: [x64] + os: [netbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/darwin-arm64@0.25.5': + /@esbuild/netbsd-x64@0.25.12: + resolution: {integrity: sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/darwin-x64@0.25.5': + /@esbuild/netbsd-x64@0.27.1: + resolution: {integrity: sha512-1YQ8ybGi2yIXswu6eNzJsrYIGFpnlzEWRl6iR5gMgmsrR0FcNoV1m9k9sc3PuP5rUBLshOZylc9nqSgymI+TYg==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/freebsd-arm64@0.25.5': + /@esbuild/openbsd-arm64@0.25.12: + resolution: {integrity: sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/freebsd-x64@0.25.5': + /@esbuild/openbsd-arm64@0.27.1: + resolution: {integrity: sha512-5Z+DzLCrq5wmU7RDaMDe2DVXMRm2tTDvX2KU14JJVBN2CT/qov7XVix85QoJqHltpvAOZUAc3ndU56HSMWrv8g==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-arm64@0.25.5': + /@esbuild/openbsd-x64@0.21.5: + resolution: {integrity: sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==} + engines: {node: '>=12'} + cpu: [x64] + os: [openbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-arm@0.25.5': + /@esbuild/openbsd-x64@0.25.12: + resolution: {integrity: sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-ia32@0.25.5': + /@esbuild/openbsd-x64@0.27.1: + resolution: {integrity: sha512-Q73ENzIdPF5jap4wqLtsfh8YbYSZ8Q0wnxplOlZUOyZy7B4ZKW8DXGWgTCZmF8VWD7Tciwv5F4NsRf6vYlZtqg==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-loong64@0.25.5': + /@esbuild/openharmony-arm64@0.25.12: + resolution: {integrity: sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-mips64el@0.25.5': + /@esbuild/openharmony-arm64@0.27.1: + resolution: {integrity: sha512-ajbHrGM/XiK+sXM0JzEbJAen+0E+JMQZ2l4RR4VFwvV9JEERx+oxtgkpoKv1SevhjavK2z2ReHk32pjzktWbGg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-ppc64@0.25.5': + /@esbuild/sunos-x64@0.21.5: + resolution: {integrity: sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==} + engines: {node: '>=12'} + cpu: [x64] + os: [sunos] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-riscv64@0.25.5': + /@esbuild/sunos-x64@0.25.12: + resolution: {integrity: sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-s390x@0.25.5': + /@esbuild/sunos-x64@0.27.1: + resolution: {integrity: sha512-IPUW+y4VIjuDVn+OMzHc5FV4GubIwPnsz6ubkvN8cuhEqH81NovB53IUlrlBkPMEPxvNnf79MGBoz8rZ2iW8HA==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + requiresBuild: true + dev: true optional: true - '@esbuild/linux-x64@0.25.5': + /@esbuild/win32-arm64@0.21.5: + resolution: {integrity: sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==} + engines: {node: '>=12'} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/netbsd-arm64@0.25.5': + /@esbuild/win32-arm64@0.25.12: + resolution: {integrity: sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/netbsd-x64@0.25.5': + /@esbuild/win32-arm64@0.27.1: + resolution: {integrity: sha512-RIVRWiljWA6CdVu8zkWcRmGP7iRRIIwvhDKem8UMBjPql2TXM5PkDVvvrzMtj1V+WFPB4K7zkIGM7VzRtFkjdg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/openbsd-arm64@0.25.5': + /@esbuild/win32-ia32@0.21.5: + resolution: {integrity: sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==} + engines: {node: '>=12'} + cpu: [ia32] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/openbsd-x64@0.25.5': + /@esbuild/win32-ia32@0.25.12: + resolution: {integrity: sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/sunos-x64@0.25.5': + /@esbuild/win32-ia32@0.27.1: + resolution: {integrity: sha512-2BR5M8CPbptC1AK5JbJT1fWrHLvejwZidKx3UMSF0ecHMa+smhi16drIrCEggkgviBwLYd5nwrFLSl5Kho96RQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/win32-arm64@0.25.5': + /@esbuild/win32-x64@0.21.5: + resolution: {integrity: sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==} + engines: {node: '>=12'} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/win32-ia32@0.25.5': + /@esbuild/win32-x64@0.25.12: + resolution: {integrity: sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@esbuild/win32-x64@0.25.5': + /@esbuild/win32-x64@0.27.1: + resolution: {integrity: sha512-d5X6RMYv6taIymSk8JBP+nxv8DQAMY6A51GPgusqLdK9wBz5wWIXy1KjTck6HnjE9hqJzJRdk+1p/t5soSbCtw==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@eslint-community/eslint-utils@4.7.0(eslint@9.28.0(jiti@2.4.2))': + /@eslint-community/eslint-utils@4.9.0(eslint@9.39.2): + resolution: {integrity: sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==} + engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} + peerDependencies: + eslint: ^6.0.0 || ^7.0.0 || >=8.0.0 dependencies: - eslint: 9.28.0(jiti@2.4.2) + eslint: 9.39.2 eslint-visitor-keys: 3.4.3 + dev: true - '@eslint-community/regexpp@4.12.1': {} + /@eslint-community/regexpp@4.12.2: + resolution: {integrity: sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==} + engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0} + dev: true - '@eslint/config-array@0.20.0': + /@eslint/config-array@0.21.1: + resolution: {integrity: sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: - '@eslint/object-schema': 2.1.6 - debug: 4.4.1(supports-color@5.5.0) + '@eslint/object-schema': 2.1.7 + debug: 4.4.3(supports-color@5.5.0) minimatch: 3.1.2 transitivePeerDependencies: - supports-color + dev: true - '@eslint/config-helpers@0.2.2': {} + /@eslint/config-helpers@0.4.2: + resolution: {integrity: sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dependencies: + '@eslint/core': 0.17.0 + dev: true - '@eslint/core@0.14.0': + /@eslint/core@0.17.0: + resolution: {integrity: sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: '@types/json-schema': 7.0.15 + dev: true - '@eslint/eslintrc@3.3.1': + /@eslint/eslintrc@3.3.3: + resolution: {integrity: sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: ajv: 6.12.6 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) espree: 10.4.0 globals: 14.0.0 ignore: 5.3.2 import-fresh: 3.3.1 - js-yaml: 4.1.0 + js-yaml: 4.1.1 minimatch: 3.1.2 strip-json-comments: 3.1.1 transitivePeerDependencies: - supports-color + dev: true - '@eslint/js@9.28.0': {} + /@eslint/js@9.39.2: + resolution: {integrity: sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dev: true - '@eslint/object-schema@2.1.6': {} + /@eslint/object-schema@2.1.7: + resolution: {integrity: sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dev: true - '@eslint/plugin-kit@0.3.1': + /@eslint/plugin-kit@0.4.1: + resolution: {integrity: sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: - '@eslint/core': 0.14.0 + '@eslint/core': 0.17.0 levn: 0.4.1 + dev: true - '@fastify/ajv-compiler@4.0.2': + /@fastify/ajv-compiler@4.0.5: + resolution: {integrity: sha512-KoWKW+MhvfTRWL4qrhUwAAZoaChluo0m0vbiJlGMt2GXvL4LVPQEjt8kSpHI3IBq5Rez8fg+XeH3cneztq+C7A==} dependencies: ajv: 8.17.1 ajv-formats: 3.0.1(ajv@8.17.1) - fast-uri: 3.0.6 + fast-uri: 3.1.0 + dev: false - '@fastify/cors@11.0.1': + /@fastify/cors@11.2.0: + resolution: {integrity: sha512-LbLHBuSAdGdSFZYTLVA3+Ch2t+sA6nq3Ejc6XLAKiQ6ViS2qFnvicpj0htsx03FyYeLs04HfRNBsz/a8SvbcUw==} dependencies: - fastify-plugin: 5.0.1 + fastify-plugin: 5.1.0 toad-cache: 3.7.0 + dev: false - '@fastify/error@4.2.0': {} + /@fastify/error@4.2.0: + resolution: {integrity: sha512-RSo3sVDXfHskiBZKBPRgnQTtIqpi/7zhJOEmAxCiBcM7d0uwdGdxLlsCaLzGs8v8NnxIRlfG0N51p5yFaOentQ==} + dev: false - '@fastify/fast-json-stringify-compiler@5.0.3': + /@fastify/fast-json-stringify-compiler@5.0.3: + resolution: {integrity: sha512-uik7yYHkLr6fxd8hJSZ8c+xF4WafPK+XzneQDPU+D10r5X19GW8lJcom2YijX2+qtFF1ENJlHXKFM9ouXNJYgQ==} dependencies: - fast-json-stringify: 6.0.1 + fast-json-stringify: 6.1.1 + dev: false - '@fastify/forwarded@3.0.0': {} + /@fastify/forwarded@3.0.1: + resolution: {integrity: sha512-JqDochHFqXs3C3Ml3gOY58zM7OqO9ENqPo0UqAjAjH8L01fRZqwX9iLeX34//kiJubF7r2ZQHtBRU36vONbLlw==} + dev: false - '@fastify/merge-json-schemas@0.2.1': + /@fastify/merge-json-schemas@0.2.1: + resolution: {integrity: sha512-OA3KGBCy6KtIvLf8DINC5880o5iBlDX4SxzLQS8HorJAbqluzLRn80UXU0bxZn7UOFhFgpRJDasfwn9nG4FG4A==} dependencies: dequal: 2.0.3 + dev: false + + /@fastify/proxy-addr@5.1.0: + resolution: {integrity: sha512-INS+6gh91cLUjB+PVHfu1UqcB76Sqtpyp7bnL+FYojhjygvOPA9ctiD/JDKsyD9Xgu4hUhCSJBPig/w7duNajw==} + dependencies: + '@fastify/forwarded': 3.0.1 + ipaddr.js: 2.3.0 + dev: false - '@fastify/proxy-addr@5.0.0': + /@floating-ui/core@1.7.3: + resolution: {integrity: sha512-sGnvb5dmrJaKEZ+LDIpguvdX3bDlEllmv4/ClQ9awcmCZrlx5jQyyMWFM5kBI+EyNOCDDiKk8il0zeuX3Zlg/w==} dependencies: - '@fastify/forwarded': 3.0.0 - ipaddr.js: 2.2.0 + '@floating-ui/utils': 0.2.10 + dev: false - '@huggingface/jinja@0.2.2': {} + /@floating-ui/dom@1.7.4: + resolution: {integrity: sha512-OOchDgh4F2CchOX94cRVqhvy7b3AFb+/rQXyswmzmGakRfkMgoWVjfnLWkRirfLEfuD4ysVW16eXzwt3jHIzKA==} + dependencies: + '@floating-ui/core': 1.7.3 + '@floating-ui/utils': 0.2.10 + dev: false + + /@floating-ui/utils@0.2.10: + resolution: {integrity: sha512-aGTxbpbg8/b5JfU1HXSrbH3wXZuLPJcNEcZQFMxLs3oSzgtVu6nFPkbbGGUvBcUjKV2YyB9Wxxabo+HEH9tcRQ==} + dev: false + + /@huggingface/jinja@0.2.2: + resolution: {integrity: sha512-/KPde26khDUIPkTGU82jdtTW9UAuvUTumCAbFs/7giR0SxsvZC4hru51PBvpijH6BVkHcROcvZM/lpy5h1jRRA==} + engines: {node: '>=18'} + dev: false - '@humanfs/core@0.19.1': {} + /@humanfs/core@0.19.1: + resolution: {integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==} + engines: {node: '>=18.18.0'} + dev: true - '@humanfs/node@0.16.6': + /@humanfs/node@0.16.7: + resolution: {integrity: sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==} + engines: {node: '>=18.18.0'} dependencies: '@humanfs/core': 0.19.1 - '@humanwhocodes/retry': 0.3.1 + '@humanwhocodes/retry': 0.4.3 + dev: true + + /@humanwhocodes/module-importer@1.0.1: + resolution: {integrity: sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==} + engines: {node: '>=12.22'} + dev: true + + /@humanwhocodes/retry@0.4.3: + resolution: {integrity: sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==} + engines: {node: '>=18.18'} + dev: true + + /@iconify-json/lucide@1.2.80: + resolution: {integrity: sha512-DwAHO+xJEJpOV5y2Q0DIoR3Au9UPk+J6an6KRO281QAxsz/+YpeySGSyZzUEK9tMrSAohkQamqlHx6lPDB8BEg==} + dependencies: + '@iconify/types': 2.0.0 + dev: true + + /@iconify/types@2.0.0: + resolution: {integrity: sha512-+wluvCrRhXrhyOmRDJ3q8mux9JkKy5SJ/v8ol2tu4FVjyYvtEzkc/3pK15ET6RKg4b4w4BmTk1+gsCUhf21Ykg==} + dev: true + + /@iconify/utils@2.3.0: + resolution: {integrity: sha512-GmQ78prtwYW6EtzXRU1rY+KwOKfz32PD7iJh6Iyqw68GiKuoZ2A6pRtzWONz5VQJbp50mEjXh/7NkumtrAgRKA==} + dependencies: + '@antfu/install-pkg': 1.1.0 + '@antfu/utils': 8.1.1 + '@iconify/types': 2.0.0 + debug: 4.4.3(supports-color@5.5.0) + globals: 15.15.0 + kolorist: 1.8.0 + local-pkg: 1.1.2 + mlly: 1.8.0 + transitivePeerDependencies: + - supports-color + dev: true + + /@img/sharp-darwin-arm64@0.33.5: + resolution: {integrity: sha512-UT4p+iz/2H4twwAoLCqfA9UH5pI6DggwKEGuaPy7nCVQ8ZsiY5PIcrRvD1DzuY3qYL07NtIQcWnBSY/heikIFQ==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [arm64] + os: [darwin] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-darwin-arm64': 1.0.4 + dev: false + optional: true + + /@img/sharp-darwin-x64@0.33.5: + resolution: {integrity: sha512-fyHac4jIc1ANYGRDxtiqelIbdWkIuQaI84Mv45KvGRRxSAa7o7d1ZKAOBaYbnepLC1WqxfpimdeWfvqqSGwR2Q==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [x64] + os: [darwin] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-darwin-x64': 1.0.4 + dev: false + optional: true + + /@img/sharp-libvips-darwin-arm64@1.0.4: + resolution: {integrity: sha512-XblONe153h0O2zuFfTAbQYAX2JhYmDHeWikp1LM9Hul9gVPjFY427k6dFEcOL72O01QxQsWi761svJ/ev9xEDg==} + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-libvips-darwin-x64@1.0.4: + resolution: {integrity: sha512-xnGR8YuZYfJGmWPvmlunFaWJsb9T/AO2ykoP3Fz/0X5XV2aoYBPkX6xqCQvUTKKiLddarLaxpzNe+b1hjeWHAQ==} + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-libvips-linux-arm64@1.0.4: + resolution: {integrity: sha512-9B+taZ8DlyyqzZQnoeIvDVR/2F4EbMepXMc/NdVbkzsJbzkUjhXv/70GQJ7tdLA4YJgNP25zukcxpX2/SueNrA==} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-libvips-linux-arm@1.0.5: + resolution: {integrity: sha512-gvcC4ACAOPRNATg/ov8/MnbxFDJqf/pDePbBnuBDcjsI8PssmjoKMAz4LtLaVi+OnSb5FK/yIOamqDwGmXW32g==} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-libvips-linux-x64@1.0.4: + resolution: {integrity: sha512-MmWmQ3iPFZr0Iev+BAgVMb3ZyC4KeFc3jFxnNbEPas60e1cIfevbtuyf9nDGIzOaW9PdnDciJm+wFFaTlj5xYw==} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-libvips-linuxmusl-arm64@1.0.4: + resolution: {integrity: sha512-9Ti+BbTYDcsbp4wfYib8Ctm1ilkugkA/uscUn6UXK1ldpC1JjiXbLfFZtRlBhjPZ5o1NCLiDbg8fhUPKStHoTA==} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: false + optional: true - '@humanwhocodes/module-importer@1.0.1': {} + /@img/sharp-libvips-linuxmusl-x64@1.0.4: + resolution: {integrity: sha512-viYN1KX9m+/hGkJtvYYp+CCLgnJXwiQB39damAO7WMdKWlIhmYTfHjwSbQeUK/20vY154mwezd9HflVFM1wVSw==} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: false + optional: true + + /@img/sharp-linux-arm64@0.33.5: + resolution: {integrity: sha512-JMVv+AMRyGOHtO1RFBiJy/MBsgz0x4AWrT6QoEVVTyh1E39TrCUpTRI7mx9VksGX4awWASxqCYLCV4wBZHAYxA==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [arm64] + os: [linux] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-linux-arm64': 1.0.4 + dev: false + optional: true + + /@img/sharp-linux-arm@0.33.5: + resolution: {integrity: sha512-JTS1eldqZbJxjvKaAkxhZmBqPRGmxgu+qFKSInv8moZ2AmT5Yib3EQ1c6gp493HvrvV8QgdOXdyaIBrhvFhBMQ==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [arm] + os: [linux] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-linux-arm': 1.0.5 + dev: false + optional: true + + /@img/sharp-linux-x64@0.33.5: + resolution: {integrity: sha512-opC+Ok5pRNAzuvq1AG0ar+1owsu842/Ab+4qvU879ippJBHvyY5n2mxF1izXqkPYlGuP/M556uh53jRLJmzTWA==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [x64] + os: [linux] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-linux-x64': 1.0.4 + dev: false + optional: true + + /@img/sharp-linuxmusl-arm64@0.33.5: + resolution: {integrity: sha512-XrHMZwGQGvJg2V/oRSUfSAfjfPxO+4DkiRh6p2AFjLQztWUuY/o8Mq0eMQVIY7HJ1CDQUJlxGGZRw1a5bqmd1g==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [arm64] + os: [linux] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-linuxmusl-arm64': 1.0.4 + dev: false + optional: true + + /@img/sharp-linuxmusl-x64@0.33.5: + resolution: {integrity: sha512-WT+d/cgqKkkKySYmqoZ8y3pxx7lx9vVejxW/W4DOFMYVSkErR+w7mf2u8m/y4+xHe7yY9DAXQMWQhpnMuFfScw==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [x64] + os: [linux] + requiresBuild: true + optionalDependencies: + '@img/sharp-libvips-linuxmusl-x64': 1.0.4 + dev: false + optional: true + + /@img/sharp-win32-x64@0.33.5: + resolution: {integrity: sha512-MpY/o8/8kj+EcnxwvrP4aTJSWw/aZ7JIGR4aBeZkZw5B7/Jn+tY9/VNwtcoGmdT7GfggGIU4kygOMSbYnOrAbg==} + engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: false + optional: true - '@humanwhocodes/retry@0.3.1': {} + /@isaacs/balanced-match@4.0.1: + resolution: {integrity: sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==} + engines: {node: 20 || >=22} + dev: true - '@humanwhocodes/retry@0.4.3': {} + /@isaacs/brace-expansion@5.0.0: + resolution: {integrity: sha512-ZT55BDLV0yv0RBm2czMiZ+SqCGO7AvmOM3G/w2xhVPH+te0aKgFjmBvGlL1dH+ql2tgGO3MVrbb3jCKyvpgnxA==} + engines: {node: 20 || >=22} + dependencies: + '@isaacs/balanced-match': 4.0.1 + dev: true - '@isaacs/cliui@8.0.2': + /@isaacs/cliui@8.0.2: + resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==} + engines: {node: '>=12'} dependencies: string-width: 5.1.2 - string-width-cjs: string-width@4.2.3 - strip-ansi: 7.1.0 - strip-ansi-cjs: strip-ansi@6.0.1 + string-width-cjs: /string-width@4.2.3 + strip-ansi: 7.1.2 + strip-ansi-cjs: /strip-ansi@6.0.1 wrap-ansi: 8.1.0 - wrap-ansi-cjs: wrap-ansi@7.0.0 + wrap-ansi-cjs: /wrap-ansi@7.0.0 + dev: true - '@istanbuljs/load-nyc-config@1.1.0': + /@istanbuljs/load-nyc-config@1.1.0: + resolution: {integrity: sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==} + engines: {node: '>=8'} dependencies: camelcase: 5.3.1 find-up: 4.1.0 get-package-type: 0.1.0 - js-yaml: 3.14.1 + js-yaml: 3.14.2 resolve-from: 5.0.0 + dev: true - '@istanbuljs/schema@0.1.3': {} + /@istanbuljs/schema@0.1.3: + resolution: {integrity: sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==} + engines: {node: '>=8'} + dev: true - '@jest/console@29.7.0': + /@jest/console@29.7.0: + resolution: {integrity: sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 chalk: 4.1.2 jest-message-util: 29.7.0 jest-util: 29.7.0 slash: 3.0.0 + dev: true - '@jest/core@29.7.0(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3))': + /@jest/core@29.7.0(ts-node@10.9.2): + resolution: {integrity: sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + peerDependencies: + node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 + peerDependenciesMeta: + node-notifier: + optional: true dependencies: '@jest/console': 29.7.0 - '@jest/reporters': 29.7.0(node-notifier@10.0.1) + '@jest/reporters': 29.7.0 '@jest/test-result': 29.7.0 '@jest/transform': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 ansi-escapes: 4.3.2 chalk: 4.1.2 ci-info: 3.9.0 exit: 0.1.2 graceful-fs: 4.2.11 jest-changed-files: 29.7.0 - jest-config: 29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + jest-config: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) jest-haste-map: 29.7.0 jest-message-util: 29.7.0 jest-regex-util: 29.6.3 @@ -5144,41 +1993,54 @@ snapshots: pretty-format: 29.7.0 slash: 3.0.0 strip-ansi: 6.0.1 - optionalDependencies: - node-notifier: 10.0.1 transitivePeerDependencies: - babel-plugin-macros - supports-color - ts-node + dev: true - '@jest/environment@29.7.0': + /@jest/environment@29.7.0: + resolution: {integrity: sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/fake-timers': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 jest-mock: 29.7.0 + dev: true - '@jest/expect-utils@29.7.0': + /@jest/expect-utils@29.7.0: + resolution: {integrity: sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: jest-get-type: 29.6.3 + dev: true - '@jest/expect@29.7.0': + /@jest/expect@29.7.0: + resolution: {integrity: sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: expect: 29.7.0 jest-snapshot: 29.7.0 transitivePeerDependencies: - supports-color + dev: true - '@jest/fake-timers@29.7.0': + /@jest/fake-timers@29.7.0: + resolution: {integrity: sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 '@sinonjs/fake-timers': 10.3.0 - '@types/node': 22.15.30 + '@types/node': 22.19.2 jest-message-util: 29.7.0 jest-mock: 29.7.0 jest-util: 29.7.0 + dev: true - '@jest/globals@29.7.0': + /@jest/globals@29.7.0: + resolution: {integrity: sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/environment': 29.7.0 '@jest/expect': 29.7.0 @@ -5186,18 +2048,26 @@ snapshots: jest-mock: 29.7.0 transitivePeerDependencies: - supports-color + dev: true - '@jest/reporters@29.7.0(node-notifier@10.0.1)': + /@jest/reporters@29.7.0: + resolution: {integrity: sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + peerDependencies: + node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 + peerDependenciesMeta: + node-notifier: + optional: true dependencies: '@bcoe/v8-coverage': 0.2.3 '@jest/console': 29.7.0 '@jest/test-result': 29.7.0 '@jest/transform': 29.7.0 '@jest/types': 29.6.3 - '@jridgewell/trace-mapping': 0.3.25 - '@types/node': 22.15.30 + '@jridgewell/trace-mapping': 0.3.31 + '@types/node': 22.19.2 chalk: 4.1.2 - collect-v8-coverage: 1.0.2 + collect-v8-coverage: 1.0.3 exit: 0.1.2 glob: 7.2.3 graceful-fs: 4.2.11 @@ -5205,7 +2075,7 @@ snapshots: istanbul-lib-instrument: 6.0.3 istanbul-lib-report: 3.0.1 istanbul-lib-source-maps: 4.0.1 - istanbul-reports: 3.1.7 + istanbul-reports: 3.2.0 jest-message-util: 29.7.0 jest-util: 29.7.0 jest-worker: 29.7.0 @@ -5213,40 +2083,53 @@ snapshots: string-length: 4.0.2 strip-ansi: 6.0.1 v8-to-istanbul: 9.3.0 - optionalDependencies: - node-notifier: 10.0.1 transitivePeerDependencies: - supports-color + dev: true - '@jest/schemas@29.6.3': + /@jest/schemas@29.6.3: + resolution: {integrity: sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@sinclair/typebox': 0.27.8 + dev: true - '@jest/source-map@29.6.3': + /@jest/source-map@29.6.3: + resolution: {integrity: sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: - '@jridgewell/trace-mapping': 0.3.25 + '@jridgewell/trace-mapping': 0.3.31 callsites: 3.1.0 graceful-fs: 4.2.11 + dev: true - '@jest/test-result@29.7.0': + /@jest/test-result@29.7.0: + resolution: {integrity: sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/console': 29.7.0 '@jest/types': 29.6.3 '@types/istanbul-lib-coverage': 2.0.6 - collect-v8-coverage: 1.0.2 + collect-v8-coverage: 1.0.3 + dev: true - '@jest/test-sequencer@29.7.0': + /@jest/test-sequencer@29.7.0: + resolution: {integrity: sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/test-result': 29.7.0 graceful-fs: 4.2.11 jest-haste-map: 29.7.0 slash: 3.0.0 + dev: true - '@jest/transform@29.7.0': + /@jest/transform@29.7.0: + resolution: {integrity: sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: - '@babel/core': 7.27.4 + '@babel/core': 7.28.5 '@jest/types': 29.6.3 - '@jridgewell/trace-mapping': 0.3.25 + '@jridgewell/trace-mapping': 0.3.31 babel-plugin-istanbul: 6.1.1 chalk: 4.1.2 convert-source-map: 2.0.0 @@ -5261,507 +2144,1177 @@ snapshots: write-file-atomic: 4.0.2 transitivePeerDependencies: - supports-color + dev: true - '@jest/types@29.6.3': + /@jest/types@29.6.3: + resolution: {integrity: sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/schemas': 29.6.3 '@types/istanbul-lib-coverage': 2.0.6 '@types/istanbul-reports': 3.0.4 - '@types/node': 22.15.30 - '@types/yargs': 17.0.33 + '@types/node': 22.19.2 + '@types/yargs': 17.0.35 chalk: 4.1.2 + dev: true - '@jridgewell/gen-mapping@0.3.8': + /@jridgewell/gen-mapping@0.3.13: + resolution: {integrity: sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==} dependencies: - '@jridgewell/set-array': 1.2.1 - '@jridgewell/sourcemap-codec': 1.5.0 - '@jridgewell/trace-mapping': 0.3.25 + '@jridgewell/sourcemap-codec': 1.5.5 + '@jridgewell/trace-mapping': 0.3.31 + dev: true - '@jridgewell/resolve-uri@3.1.2': {} + /@jridgewell/remapping@2.3.5: + resolution: {integrity: sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==} + dependencies: + '@jridgewell/gen-mapping': 0.3.13 + '@jridgewell/trace-mapping': 0.3.31 + dev: true - '@jridgewell/set-array@1.2.1': {} + /@jridgewell/resolve-uri@3.1.2: + resolution: {integrity: sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==} + engines: {node: '>=6.0.0'} + dev: true - '@jridgewell/sourcemap-codec@1.5.0': {} + /@jridgewell/sourcemap-codec@1.5.5: + resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==} - '@jridgewell/trace-mapping@0.3.25': + /@jridgewell/trace-mapping@0.3.31: + resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==} dependencies: '@jridgewell/resolve-uri': 3.1.2 - '@jridgewell/sourcemap-codec': 1.5.0 + '@jridgewell/sourcemap-codec': 1.5.5 + dev: true - '@jridgewell/trace-mapping@0.3.9': + /@jridgewell/trace-mapping@0.3.9: + resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==} dependencies: '@jridgewell/resolve-uri': 3.1.2 - '@jridgewell/sourcemap-codec': 1.5.0 + '@jridgewell/sourcemap-codec': 1.5.5 + dev: true - '@modelcontextprotocol/sdk@1.12.1': + /@modelcontextprotocol/sdk@1.24.3(zod@3.25.76): + resolution: {integrity: sha512-YgSHW29fuzKKAHTGe9zjNoo+yF8KaQPzDC2W9Pv41E7/57IfY+AMGJ/aDFlgTLcVVELoggKE4syABCE75u3NCw==} + engines: {node: '>=18'} + peerDependencies: + '@cfworker/json-schema': ^4.1.1 + zod: ^3.25 || ^4.0 + peerDependenciesMeta: + '@cfworker/json-schema': + optional: true dependencies: - ajv: 6.12.6 + ajv: 8.17.1 + ajv-formats: 3.0.1(ajv@8.17.1) content-type: 1.0.5 cors: 2.8.5 cross-spawn: 7.0.6 eventsource: 3.0.7 - express: 5.1.0 - express-rate-limit: 7.5.0(express@5.1.0) - pkce-challenge: 5.0.0 - raw-body: 3.0.0 - zod: 3.25.56 - zod-to-json-schema: 3.24.5(zod@3.25.56) + eventsource-parser: 3.0.6 + express: 5.2.1 + express-rate-limit: 7.5.1(express@5.2.1) + jose: 6.1.3 + pkce-challenge: 5.0.1 + raw-body: 3.0.2 + zod: 3.25.76 + zod-to-json-schema: 3.25.0(zod@3.25.76) transitivePeerDependencies: - supports-color + dev: false - '@noble/hashes@1.8.0': {} + /@noble/hashes@1.8.0: + resolution: {integrity: sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==} + engines: {node: ^14.21.3 || >=16} + dev: true - '@nodelib/fs.scandir@2.1.5': + /@nodelib/fs.scandir@2.1.5: + resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==} + engines: {node: '>= 8'} dependencies: '@nodelib/fs.stat': 2.0.5 run-parallel: 1.2.0 + dev: true - '@nodelib/fs.stat@2.0.5': {} + /@nodelib/fs.stat@2.0.5: + resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==} + engines: {node: '>= 8'} + dev: true - '@nodelib/fs.walk@1.2.8': + /@nodelib/fs.walk@1.2.8: + resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==} + engines: {node: '>= 8'} dependencies: '@nodelib/fs.scandir': 2.1.5 fastq: 1.19.1 + dev: true - '@paralleldrive/cuid2@2.2.2': + /@paralleldrive/cuid2@2.3.1: + resolution: {integrity: sha512-XO7cAxhnTZl0Yggq6jOgjiOHhbgcO4NqFqwSmQpjK3b6TEE6Uj/jfSk6wzYyemh3+I0sHirKSetjQwn5cZktFw==} dependencies: '@noble/hashes': 1.8.0 + dev: true - '@pkgjs/parseargs@0.11.0': + /@pinojs/redact@0.4.0: + resolution: {integrity: sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg==} + dev: false + + /@pkgjs/parseargs@0.11.0: + resolution: {integrity: sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==} + engines: {node: '>=14'} + requiresBuild: true + dev: true optional: true - '@pnpm/config.env-replace@1.1.0': {} + /@pnpm/config.env-replace@1.1.0: + resolution: {integrity: sha512-htyl8TWnKL7K/ESFa1oW2UB5lVDxuF5DpM7tBi6Hu2LNL3mWkIzNLG6N4zoCUP1lCKNxWy/3iu8mS8MvToGd6w==} + engines: {node: '>=12.22.0'} + dev: true - '@pnpm/network.ca-file@1.0.2': + /@pnpm/network.ca-file@1.0.2: + resolution: {integrity: sha512-YcPQ8a0jwYU9bTdJDpXjMi7Brhkr1mXsXrUJvjqM2mQDgkRiz8jFaQGOdaLxgjtUfQgZhKy/O3cG/YwmgKaxLA==} + engines: {node: '>=12.22.0'} dependencies: graceful-fs: 4.2.10 + dev: true - '@pnpm/npm-conf@2.3.1': + /@pnpm/npm-conf@2.3.1: + resolution: {integrity: sha512-c83qWb22rNRuB0UaVCI0uRPNRr8Z0FWnEIvT47jiHAmOIUHbBOg5XvV7pM5x+rKn9HRpjxquDbXYSXr3fAKFcw==} + engines: {node: '>=12'} dependencies: '@pnpm/config.env-replace': 1.1.0 '@pnpm/network.ca-file': 1.0.2 config-chain: 1.1.13 + dev: true - '@protobufjs/aspromise@1.1.2': {} + /@protobufjs/aspromise@1.1.2: + resolution: {integrity: sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==} + dev: false - '@protobufjs/base64@1.1.2': {} + /@protobufjs/base64@1.1.2: + resolution: {integrity: sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==} + dev: false - '@protobufjs/codegen@2.0.4': {} + /@protobufjs/codegen@2.0.4: + resolution: {integrity: sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==} + dev: false - '@protobufjs/eventemitter@1.1.0': {} + /@protobufjs/eventemitter@1.1.0: + resolution: {integrity: sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==} + dev: false - '@protobufjs/fetch@1.1.0': + /@protobufjs/fetch@1.1.0: + resolution: {integrity: sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==} dependencies: '@protobufjs/aspromise': 1.1.2 '@protobufjs/inquire': 1.1.0 + dev: false + + /@protobufjs/float@1.0.2: + resolution: {integrity: sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==} + dev: false + + /@protobufjs/inquire@1.1.0: + resolution: {integrity: sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==} + dev: false - '@protobufjs/float@1.0.2': {} + /@protobufjs/path@1.1.2: + resolution: {integrity: sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==} + dev: false + + /@protobufjs/pool@1.1.0: + resolution: {integrity: sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==} + dev: false + + /@protobufjs/utf8@1.1.0: + resolution: {integrity: sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==} + dev: false - '@protobufjs/inquire@1.1.0': {} + /@rolldown/pluginutils@1.0.0-beta.53: + resolution: {integrity: sha512-vENRlFU4YbrwVqNDZ7fLvy+JR1CRkyr01jhSiDpE1u6py3OMzQfztQU2jxykW3ALNxO4kSlqIDeYyD0Y9RcQeQ==} + dev: true - '@protobufjs/path@1.1.2': {} + /@rollup/pluginutils@5.3.0: + resolution: {integrity: sha512-5EdhGZtnu3V88ces7s53hhfK5KSASnJZv8Lulpc04cWO3REESroJXg73DFsOmgbU2BhwV0E20bu2IDZb3VKW4Q==} + engines: {node: '>=14.0.0'} + peerDependencies: + rollup: ^1.20.0||^2.0.0||^3.0.0||^4.0.0 + peerDependenciesMeta: + rollup: + optional: true + dependencies: + '@types/estree': 1.0.8 + estree-walker: 2.0.2 + picomatch: 4.0.3 + dev: true - '@protobufjs/pool@1.1.0': {} + /@rollup/rollup-android-arm-eabi@4.53.3: + resolution: {integrity: sha512-mRSi+4cBjrRLoaal2PnqH82Wqyb+d3HsPUN/W+WslCXsZsyHa9ZeQQX/pQsZaVIWDkPcpV6jJ+3KLbTbgnwv8w==} + cpu: [arm] + os: [android] + requiresBuild: true + dev: true + optional: true - '@protobufjs/utf8@1.1.0': {} + /@rollup/rollup-android-arm64@4.53.3: + resolution: {integrity: sha512-CbDGaMpdE9sh7sCmTrTUyllhrg65t6SwhjlMJsLr+J8YjFuPmCEjbBSx4Z/e4SmDyH3aB5hGaJUP2ltV/vcs4w==} + cpu: [arm64] + os: [android] + requiresBuild: true + dev: true + optional: true - '@rollup/rollup-android-arm-eabi@4.42.0': + /@rollup/rollup-darwin-arm64@4.53.3: + resolution: {integrity: sha512-Nr7SlQeqIBpOV6BHHGZgYBuSdanCXuw09hon14MGOLGmXAFYjx1wNvquVPmpZnl0tLjg25dEdr4IQ6GgyToCUA==} + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-android-arm64@4.42.0': + /@rollup/rollup-darwin-x64@4.53.3: + resolution: {integrity: sha512-DZ8N4CSNfl965CmPktJ8oBnfYr3F8dTTNBQkRlffnUarJ2ohudQD17sZBa097J8xhQ26AwhHJ5mvUyQW8ddTsQ==} + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-darwin-arm64@4.42.0': + /@rollup/rollup-freebsd-arm64@4.53.3: + resolution: {integrity: sha512-yMTrCrK92aGyi7GuDNtGn2sNW+Gdb4vErx4t3Gv/Tr+1zRb8ax4z8GWVRfr3Jw8zJWvpGHNpss3vVlbF58DZ4w==} + cpu: [arm64] + os: [freebsd] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-darwin-x64@4.42.0': + /@rollup/rollup-freebsd-x64@4.53.3: + resolution: {integrity: sha512-lMfF8X7QhdQzseM6XaX0vbno2m3hlyZFhwcndRMw8fbAGUGL3WFMBdK0hbUBIUYcEcMhVLr1SIamDeuLBnXS+Q==} + cpu: [x64] + os: [freebsd] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-freebsd-arm64@4.42.0': + /@rollup/rollup-linux-arm-gnueabihf@4.53.3: + resolution: {integrity: sha512-k9oD15soC/Ln6d2Wv/JOFPzZXIAIFLp6B+i14KhxAfnq76ajt0EhYc5YPeX6W1xJkAdItcVT+JhKl1QZh44/qw==} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-freebsd-x64@4.42.0': + /@rollup/rollup-linux-arm-musleabihf@4.53.3: + resolution: {integrity: sha512-vTNlKq+N6CK/8UktsrFuc+/7NlEYVxgaEgRXVUVK258Z5ymho29skzW1sutgYjqNnquGwVUObAaxae8rZ6YMhg==} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-arm-gnueabihf@4.42.0': + /@rollup/rollup-linux-arm64-gnu@4.53.3: + resolution: {integrity: sha512-RGrFLWgMhSxRs/EWJMIFM1O5Mzuz3Xy3/mnxJp/5cVhZ2XoCAxJnmNsEyeMJtpK+wu0FJFWz+QF4mjCA7AUQ3w==} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-arm-musleabihf@4.42.0': + /@rollup/rollup-linux-arm64-musl@4.53.3: + resolution: {integrity: sha512-kASyvfBEWYPEwe0Qv4nfu6pNkITLTb32p4yTgzFCocHnJLAHs+9LjUu9ONIhvfT/5lv4YS5muBHyuV84epBo/A==} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-arm64-gnu@4.42.0': + /@rollup/rollup-linux-loong64-gnu@4.53.3: + resolution: {integrity: sha512-JiuKcp2teLJwQ7vkJ95EwESWkNRFJD7TQgYmCnrPtlu50b4XvT5MOmurWNrCj3IFdyjBQ5p9vnrX4JM6I8OE7g==} + cpu: [loong64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-arm64-musl@4.42.0': + /@rollup/rollup-linux-ppc64-gnu@4.53.3: + resolution: {integrity: sha512-EoGSa8nd6d3T7zLuqdojxC20oBfNT8nexBbB/rkxgKj5T5vhpAQKKnD+h3UkoMuTyXkP5jTjK/ccNRmQrPNDuw==} + cpu: [ppc64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-loongarch64-gnu@4.42.0': + /@rollup/rollup-linux-riscv64-gnu@4.53.3: + resolution: {integrity: sha512-4s+Wped2IHXHPnAEbIB0YWBv7SDohqxobiiPA1FIWZpX+w9o2i4LezzH/NkFUl8LRci/8udci6cLq+jJQlh+0g==} + cpu: [riscv64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-powerpc64le-gnu@4.42.0': + /@rollup/rollup-linux-riscv64-musl@4.53.3: + resolution: {integrity: sha512-68k2g7+0vs2u9CxDt5ktXTngsxOQkSEV/xBbwlqYcUrAVh6P9EgMZvFsnHy4SEiUl46Xf0IObWVbMvPrr2gw8A==} + cpu: [riscv64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-riscv64-gnu@4.42.0': + /@rollup/rollup-linux-s390x-gnu@4.53.3: + resolution: {integrity: sha512-VYsFMpULAz87ZW6BVYw3I6sWesGpsP9OPcyKe8ofdg9LHxSbRMd7zrVrr5xi/3kMZtpWL/wC+UIJWJYVX5uTKg==} + cpu: [s390x] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-riscv64-musl@4.42.0': + /@rollup/rollup-linux-x64-gnu@4.53.3: + resolution: {integrity: sha512-3EhFi1FU6YL8HTUJZ51imGJWEX//ajQPfqWLI3BQq4TlvHy4X0MOr5q3D2Zof/ka0d5FNdPwZXm3Yyib/UEd+w==} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-s390x-gnu@4.42.0': + /@rollup/rollup-linux-x64-musl@4.53.3: + resolution: {integrity: sha512-eoROhjcc6HbZCJr+tvVT8X4fW3/5g/WkGvvmwz/88sDtSJzO7r/blvoBDgISDiCjDRZmHpwud7h+6Q9JxFwq1Q==} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-x64-gnu@4.42.0': + /@rollup/rollup-openharmony-arm64@4.53.3: + resolution: {integrity: sha512-OueLAWgrNSPGAdUdIjSWXw+u/02BRTcnfw9PN41D2vq/JSEPnJnVuBgw18VkN8wcd4fjUs+jFHVM4t9+kBSNLw==} + cpu: [arm64] + os: [openharmony] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-linux-x64-musl@4.42.0': + /@rollup/rollup-win32-arm64-msvc@4.53.3: + resolution: {integrity: sha512-GOFuKpsxR/whszbF/bzydebLiXIHSgsEUp6M0JI8dWvi+fFa1TD6YQa4aSZHtpmh2/uAlj/Dy+nmby3TJ3pkTw==} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-win32-arm64-msvc@4.42.0': + /@rollup/rollup-win32-ia32-msvc@4.53.3: + resolution: {integrity: sha512-iah+THLcBJdpfZ1TstDFbKNznlzoxa8fmnFYK4V67HvmuNYkVdAywJSoteUszvBQ9/HqN2+9AZghbajMsFT+oA==} + cpu: [ia32] + os: [win32] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-win32-ia32-msvc@4.42.0': + /@rollup/rollup-win32-x64-gnu@4.53.3: + resolution: {integrity: sha512-J9QDiOIZlZLdcot5NXEepDkstocktoVjkaKUtqzgzpt2yWjGlbYiKyp05rWwk4nypbYUNoFAztEgixoLaSETkg==} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@rollup/rollup-win32-x64-msvc@4.42.0': + /@rollup/rollup-win32-x64-msvc@4.53.3: + resolution: {integrity: sha512-UhTd8u31dXadv0MopwGgNOBpUVROFKWVQgAg5N1ESyCz8AuBcMqm4AuTjrwgQKGDfoFuz02EuMRHQIw/frmYKQ==} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true optional: true - '@sinclair/typebox@0.27.8': {} + /@sinclair/typebox@0.27.8: + resolution: {integrity: sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==} + dev: true - '@sinonjs/commons@3.0.1': + /@sinonjs/commons@3.0.1: + resolution: {integrity: sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==} dependencies: type-detect: 4.0.8 + dev: true - '@sinonjs/fake-timers@10.3.0': + /@sinonjs/fake-timers@10.3.0: + resolution: {integrity: sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==} dependencies: '@sinonjs/commons': 3.0.1 + dev: true + + /@tailwindcss/node@4.1.18: + resolution: {integrity: sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ==} + dependencies: + '@jridgewell/remapping': 2.3.5 + enhanced-resolve: 5.18.4 + jiti: 2.6.1 + lightningcss: 1.30.2 + magic-string: 0.30.21 + source-map-js: 1.2.1 + tailwindcss: 4.1.18 + dev: true + + /@tailwindcss/oxide-android-arm64@4.1.18: + resolution: {integrity: sha512-dJHz7+Ugr9U/diKJA0W6N/6/cjI+ZTAoxPf9Iz9BFRF2GzEX8IvXxFIi/dZBloVJX/MZGvRuFA9rqwdiIEZQ0Q==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [android] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-darwin-arm64@4.1.18: + resolution: {integrity: sha512-Gc2q4Qhs660bhjyBSKgq6BYvwDz4G+BuyJ5H1xfhmDR3D8HnHCmT/BSkvSL0vQLy/nkMLY20PQ2OoYMO15Jd0A==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-darwin-x64@4.1.18: + resolution: {integrity: sha512-FL5oxr2xQsFrc3X9o1fjHKBYBMD1QZNyc1Xzw/h5Qu4XnEBi3dZn96HcHm41c/euGV+GRiXFfh2hUCyKi/e+yw==} + engines: {node: '>= 10'} + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-freebsd-x64@4.1.18: + resolution: {integrity: sha512-Fj+RHgu5bDodmV1dM9yAxlfJwkkWvLiRjbhuO2LEtwtlYlBgiAT4x/j5wQr1tC3SANAgD+0YcmWVrj8R9trVMA==} + engines: {node: '>= 10'} + cpu: [x64] + os: [freebsd] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-linux-arm-gnueabihf@4.1.18: + resolution: {integrity: sha512-Fp+Wzk/Ws4dZn+LV2Nqx3IilnhH51YZoRaYHQsVq3RQvEl+71VGKFpkfHrLM/Li+kt5c0DJe/bHXK1eHgDmdiA==} + engines: {node: '>= 10'} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-linux-arm64-gnu@4.1.18: + resolution: {integrity: sha512-S0n3jboLysNbh55Vrt7pk9wgpyTTPD0fdQeh7wQfMqLPM/Hrxi+dVsLsPrycQjGKEQk85Kgbx+6+QnYNiHalnw==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-linux-arm64-musl@4.1.18: + resolution: {integrity: sha512-1px92582HkPQlaaCkdRcio71p8bc8i/ap5807tPRDK/uw953cauQBT8c5tVGkOwrHMfc2Yh6UuxaH4vtTjGvHg==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-linux-x64-gnu@4.1.18: + resolution: {integrity: sha512-v3gyT0ivkfBLoZGF9LyHmts0Isc8jHZyVcbzio6Wpzifg/+5ZJpDiRiUhDLkcr7f/r38SWNe7ucxmGW3j3Kb/g==} + engines: {node: '>= 10'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true - '@tsconfig/node10@1.0.11': {} + /@tailwindcss/oxide-linux-x64-musl@4.1.18: + resolution: {integrity: sha512-bhJ2y2OQNlcRwwgOAGMY0xTFStt4/wyU6pvI6LSuZpRgKQwxTec0/3Scu91O8ir7qCR3AuepQKLU/kX99FouqQ==} + engines: {node: '>= 10'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-wasm32-wasi@4.1.18: + resolution: {integrity: sha512-LffYTvPjODiP6PT16oNeUQJzNVyJl1cjIebq/rWWBF+3eDst5JGEFSc5cWxyRCJ0Mxl+KyIkqRxk1XPEs9x8TA==} + engines: {node: '>=14.0.0'} + cpu: [wasm32] + requiresBuild: true + dev: true + optional: true + bundledDependencies: + - '@napi-rs/wasm-runtime' + - '@emnapi/core' + - '@emnapi/runtime' + - '@tybys/wasm-util' + - '@emnapi/wasi-threads' + - tslib + + /@tailwindcss/oxide-win32-arm64-msvc@4.1.18: + resolution: {integrity: sha512-HjSA7mr9HmC8fu6bdsZvZ+dhjyGCLdotjVOgLA2vEqxEBZaQo9YTX4kwgEvPCpRh8o4uWc4J/wEoFzhEmjvPbA==} + engines: {node: '>= 10'} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true + optional: true + + /@tailwindcss/oxide-win32-x64-msvc@4.1.18: + resolution: {integrity: sha512-bJWbyYpUlqamC8dpR7pfjA0I7vdF6t5VpUGMWRkXVE3AXgIZjYUYAK7II1GNaxR8J1SSrSrppRar8G++JekE3Q==} + engines: {node: '>= 10'} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true + optional: true - '@tsconfig/node12@1.0.11': {} + /@tailwindcss/oxide@4.1.18: + resolution: {integrity: sha512-EgCR5tTS5bUSKQgzeMClT6iCY3ToqE1y+ZB0AKldj809QXk1Y+3jB0upOYZrn9aGIzPtUsP7sX4QQ4XtjBB95A==} + engines: {node: '>= 10'} + optionalDependencies: + '@tailwindcss/oxide-android-arm64': 4.1.18 + '@tailwindcss/oxide-darwin-arm64': 4.1.18 + '@tailwindcss/oxide-darwin-x64': 4.1.18 + '@tailwindcss/oxide-freebsd-x64': 4.1.18 + '@tailwindcss/oxide-linux-arm-gnueabihf': 4.1.18 + '@tailwindcss/oxide-linux-arm64-gnu': 4.1.18 + '@tailwindcss/oxide-linux-arm64-musl': 4.1.18 + '@tailwindcss/oxide-linux-x64-gnu': 4.1.18 + '@tailwindcss/oxide-linux-x64-musl': 4.1.18 + '@tailwindcss/oxide-wasm32-wasi': 4.1.18 + '@tailwindcss/oxide-win32-arm64-msvc': 4.1.18 + '@tailwindcss/oxide-win32-x64-msvc': 4.1.18 + dev: true + + /@tailwindcss/vite@4.1.18(vite@7.2.7): + resolution: {integrity: sha512-jVA+/UpKL1vRLg6Hkao5jldawNmRo7mQYrZtNHMIVpLfLhDml5nMRUo/8MwoX2vNXvnaXNNMedrMfMugAVX1nA==} + peerDependencies: + vite: ^5.2.0 || ^6 || ^7 + dependencies: + '@tailwindcss/node': 4.1.18 + '@tailwindcss/oxide': 4.1.18 + tailwindcss: 4.1.18 + vite: 7.2.7(@types/node@22.19.2) + dev: true - '@tsconfig/node14@1.0.3': {} + /@tsconfig/node10@1.0.12: + resolution: {integrity: sha512-UCYBaeFvM11aU2y3YPZ//O5Rhj+xKyzy7mvcIoAjASbigy8mHMryP5cK7dgjlz2hWxh1g5pLw084E0a/wlUSFQ==} + dev: true + + /@tsconfig/node12@1.0.11: + resolution: {integrity: sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==} + dev: true + + /@tsconfig/node14@1.0.3: + resolution: {integrity: sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==} + dev: true - '@tsconfig/node16@1.0.4': {} + /@tsconfig/node16@1.0.4: + resolution: {integrity: sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==} + dev: true - '@types/babel__core@7.20.5': + /@types/babel__core@7.20.5: + resolution: {integrity: sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==} dependencies: - '@babel/parser': 7.27.5 - '@babel/types': 7.27.6 + '@babel/parser': 7.28.5 + '@babel/types': 7.28.5 '@types/babel__generator': 7.27.0 '@types/babel__template': 7.4.4 - '@types/babel__traverse': 7.20.7 + '@types/babel__traverse': 7.28.0 + dev: true + + /@types/babel__generator@7.27.0: + resolution: {integrity: sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==} + dependencies: + '@babel/types': 7.28.5 + dev: true - '@types/babel__generator@7.27.0': + /@types/babel__template@7.4.4: + resolution: {integrity: sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==} dependencies: - '@babel/types': 7.27.6 + '@babel/parser': 7.28.5 + '@babel/types': 7.28.5 + dev: true - '@types/babel__template@7.4.4': + /@types/babel__traverse@7.28.0: + resolution: {integrity: sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==} dependencies: - '@babel/parser': 7.27.5 - '@babel/types': 7.27.6 + '@babel/types': 7.28.5 + dev: true - '@types/babel__traverse@7.20.7': + /@types/better-sqlite3@7.6.13: + resolution: {integrity: sha512-NMv9ASNARoKksWtsq/SHakpYAYnhBrQgGD8zkLYk/jaK8jUGn08CfEdTRgYhMypUQAfzSP8W6gNLe0q19/t4VA==} dependencies: - '@babel/types': 7.27.6 + '@types/node': 22.19.2 - '@types/chrome@0.0.318': + /@types/chrome@0.0.318: + resolution: {integrity: sha512-rrtyYQ1t+g7EyG0FejE+UXQBjSGUHGh0RIdXwUT/laPo9T724NOIgXA94ns6ewmNauwijYa5ck3+dBxWnHcynQ==} dependencies: '@types/filesystem': 0.0.36 '@types/har-format': 1.2.16 + dev: true - '@types/conventional-commits-parser@5.0.1': + /@types/conventional-commits-parser@5.0.2: + resolution: {integrity: sha512-BgT2szDXnVypgpNxOK8aL5SGjUdaQbC++WZNjF1Qge3Og2+zhHj+RWhmehLhYyvQwqAmvezruVfOf8+3m74W+g==} dependencies: - '@types/node': 22.15.30 - - '@types/cookiejar@2.1.5': {} + '@types/node': 22.19.2 + dev: true - '@types/estree@1.0.7': {} + /@types/cookiejar@2.1.5: + resolution: {integrity: sha512-he+DHOWReW0nghN24E1WUqM0efK4kI9oTqDm6XmK8ZPe2djZ90BSNdGnIyCLzCPw7/pogPlGbzI2wHGGmi4O/Q==} + dev: true - '@types/estree@1.0.8': {} + /@types/estree@1.0.8: + resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==} + dev: true - '@types/filesystem@0.0.36': + /@types/filesystem@0.0.36: + resolution: {integrity: sha512-vPDXOZuannb9FZdxgHnqSwAG/jvdGM8Wq+6N4D/d80z+D4HWH+bItqsZaVRQykAn6WEVeEkLm2oQigyHtgb0RA==} dependencies: '@types/filewriter': 0.0.33 + dev: true - '@types/filewriter@0.0.33': {} + /@types/filewriter@0.0.33: + resolution: {integrity: sha512-xFU8ZXTw4gd358lb2jw25nxY9QAgqn2+bKKjKOYfNCzN4DKCFetK7sPtrlpg66Ywe3vWY9FNxprZawAh9wfJ3g==} + dev: true - '@types/graceful-fs@4.1.9': + /@types/graceful-fs@4.1.9: + resolution: {integrity: sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==} dependencies: - '@types/node': 22.15.30 + '@types/node': 22.19.2 + dev: true - '@types/har-format@1.2.16': {} + /@types/har-format@1.2.16: + resolution: {integrity: sha512-fluxdy7ryD3MV6h8pTfTYpy/xQzCFC7m89nOH9y94cNqJ1mDIDPut7MnRHI3F6qRmh/cT2fUjG1MLdCNb4hE9A==} + dev: true - '@types/istanbul-lib-coverage@2.0.6': {} + /@types/istanbul-lib-coverage@2.0.6: + resolution: {integrity: sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==} + dev: true - '@types/istanbul-lib-report@3.0.3': + /@types/istanbul-lib-report@3.0.3: + resolution: {integrity: sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==} dependencies: '@types/istanbul-lib-coverage': 2.0.6 + dev: true - '@types/istanbul-reports@3.0.4': + /@types/istanbul-reports@3.0.4: + resolution: {integrity: sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==} dependencies: '@types/istanbul-lib-report': 3.0.3 + dev: true - '@types/jest@29.5.14': + /@types/jest@29.5.14: + resolution: {integrity: sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==} dependencies: expect: 29.7.0 pretty-format: 29.7.0 + dev: true - '@types/json-schema@7.0.15': {} + /@types/json-schema@7.0.15: + resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==} + dev: true - '@types/long@4.0.2': {} + /@types/long@4.0.2: + resolution: {integrity: sha512-MqTGEo5bj5t157U6fA/BiDynNkn0YknVdh48CMPkTSpFTVmvao5UQmm7uEF6xBEo7qIMAlY/JSleYaE6VOdpaA==} + dev: false - '@types/methods@1.1.4': {} + /@types/methods@1.1.4: + resolution: {integrity: sha512-ymXWVrDiCxTBE3+RIrrP533E70eA+9qu7zdWoHuOmGujkYtzf4HQF96b8nwHLqhuf4ykX61IGRIB38CC6/sImQ==} + dev: true - '@types/minimatch@3.0.5': {} + /@types/minimatch@3.0.5: + resolution: {integrity: sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ==} + dev: true - '@types/node-fetch@2.6.13': + /@types/node-fetch@2.6.13: + resolution: {integrity: sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==} dependencies: - '@types/node': 22.15.30 - form-data: 4.0.4 + '@types/node': 22.19.2 + form-data: 4.0.5 + dev: false - '@types/node@18.19.111': + /@types/node@18.19.130: + resolution: {integrity: sha512-GRaXQx6jGfL8sKfaIDD6OupbIHBr9jv7Jnaml9tB7l4v068PAOXqfcujMMo5PhbIs6ggR1XODELqahT2R8v0fg==} dependencies: undici-types: 5.26.5 + dev: true - '@types/node@22.15.30': + /@types/node@22.19.2: + resolution: {integrity: sha512-LPM2G3Syo1GLzXLGJAKdqoU35XvrWzGJ21/7sgZTUpbkBaOasTj8tjwn6w+hCkqaa1TfJ/w67rJSwYItlJ2mYw==} dependencies: undici-types: 6.21.0 - '@types/stack-utils@2.0.3': {} + /@types/stack-utils@2.0.3: + resolution: {integrity: sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==} + dev: true - '@types/superagent@8.1.9': + /@types/superagent@8.1.9: + resolution: {integrity: sha512-pTVjI73witn+9ILmoJdajHGW2jkSaOzhiFYF1Rd3EQ94kymLqB9PjD9ISg7WaALC7+dCHT0FGe9T2LktLq/3GQ==} dependencies: '@types/cookiejar': 2.1.5 '@types/methods': 1.1.4 - '@types/node': 22.15.30 - form-data: 4.0.3 + '@types/node': 22.19.2 + form-data: 4.0.5 + dev: true - '@types/supertest@6.0.3': + /@types/supertest@6.0.3: + resolution: {integrity: sha512-8WzXq62EXFhJ7QsH3Ocb/iKQ/Ty9ZVWnVzoTKc9tyyFRRF3a74Tk2+TLFgaFFw364Ere+npzHKEJ6ga2LzIL7w==} dependencies: '@types/methods': 1.1.4 '@types/superagent': 8.1.9 + dev: true - '@types/yargs-parser@21.0.3': {} + /@types/web-bluetooth@0.0.20: + resolution: {integrity: sha512-g9gZnnXVq7gM7v3tJCWV/qw7w+KeOlSHAhgF9RytFyifW6AF61hdT2ucrYhPq9hLs5JIryeupHV3qGk95dH9ow==} + dev: false + + /@types/yargs-parser@21.0.3: + resolution: {integrity: sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==} + dev: true - '@types/yargs@17.0.33': + /@types/yargs@17.0.35: + resolution: {integrity: sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==} dependencies: '@types/yargs-parser': 21.0.3 + dev: true + + /@typescript-eslint/eslint-plugin@8.49.0(@typescript-eslint/parser@8.49.0)(eslint@9.39.2)(typescript@5.9.3): + resolution: {integrity: sha512-JXij0vzIaTtCwu6SxTh8qBc66kmf1xs7pI4UOiMDFVct6q86G0Zs7KRcEoJgY3Cav3x5Tq0MF5jwgpgLqgKG3A==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + '@typescript-eslint/parser': ^8.49.0 + eslint: ^8.57.0 || ^9.0.0 + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@eslint-community/regexpp': 4.12.2 + '@typescript-eslint/parser': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + '@typescript-eslint/scope-manager': 8.49.0 + '@typescript-eslint/type-utils': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + '@typescript-eslint/utils': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + '@typescript-eslint/visitor-keys': 8.49.0 + eslint: 9.39.2 + ignore: 7.0.5 + natural-compare: 1.4.0 + ts-api-utils: 2.1.0(typescript@5.9.3) + typescript: 5.9.3 + transitivePeerDependencies: + - supports-color + dev: true + + /@typescript-eslint/parser@8.49.0(eslint@9.39.2)(typescript@5.9.3): + resolution: {integrity: sha512-N9lBGA9o9aqb1hVMc9hzySbhKibHmB+N3IpoShyV6HyQYRGIhlrO5rQgttypi+yEeKsKI4idxC8Jw6gXKD4THA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@typescript-eslint/scope-manager': 8.49.0 + '@typescript-eslint/types': 8.49.0 + '@typescript-eslint/typescript-estree': 8.49.0(typescript@5.9.3) + '@typescript-eslint/visitor-keys': 8.49.0 + debug: 4.4.3(supports-color@5.5.0) + eslint: 9.39.2 + typescript: 5.9.3 + transitivePeerDependencies: + - supports-color + dev: true - '@types/yauzl@2.10.3': + /@typescript-eslint/project-service@8.49.0(typescript@5.9.3): + resolution: {integrity: sha512-/wJN0/DKkmRUMXjZUXYZpD1NEQzQAAn9QWfGwo+Ai8gnzqH7tvqS7oNVdTjKqOcPyVIdZdyCMoqN66Ia789e7g==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + typescript: '>=4.8.4 <6.0.0' dependencies: - '@types/node': 22.15.30 - optional: true + '@typescript-eslint/tsconfig-utils': 8.49.0(typescript@5.9.3) + '@typescript-eslint/types': 8.49.0 + debug: 4.4.3(supports-color@5.5.0) + typescript: 5.9.3 + transitivePeerDependencies: + - supports-color + dev: true + + /@typescript-eslint/scope-manager@8.49.0: + resolution: {integrity: sha512-npgS3zi+/30KSOkXNs0LQXtsg9ekZ8OISAOLGWA/ZOEn0ZH74Ginfl7foziV8DT+D98WfQ5Kopwqb/PZOaIJGg==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dependencies: + '@typescript-eslint/types': 8.49.0 + '@typescript-eslint/visitor-keys': 8.49.0 + dev: true - '@typescript-eslint/eslint-plugin@8.33.1(@typescript-eslint/parser@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3))(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3)': + /@typescript-eslint/tsconfig-utils@8.49.0(typescript@5.9.3): + resolution: {integrity: sha512-8prixNi1/6nawsRYxet4YOhnbW+W9FK/bQPxsGB1D3ZrDzbJ5FXw5XmzxZv82X3B+ZccuSxo/X8q9nQ+mFecWA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + typescript: '>=4.8.4 <6.0.0' dependencies: - '@eslint-community/regexpp': 4.12.1 - '@typescript-eslint/parser': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - '@typescript-eslint/scope-manager': 8.33.1 - '@typescript-eslint/type-utils': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - '@typescript-eslint/utils': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - '@typescript-eslint/visitor-keys': 8.33.1 - eslint: 9.28.0(jiti@2.4.2) - graphemer: 1.4.0 - ignore: 7.0.5 - natural-compare: 1.4.0 - ts-api-utils: 2.1.0(typescript@5.8.3) - typescript: 5.8.3 + typescript: 5.9.3 + dev: true + + /@typescript-eslint/type-utils@8.49.0(eslint@9.39.2)(typescript@5.9.3): + resolution: {integrity: sha512-KTExJfQ+svY8I10P4HdxKzWsvtVnsuCifU5MvXrRwoP2KOlNZ9ADNEWWsQTJgMxLzS5VLQKDjkCT/YzgsnqmZg==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@typescript-eslint/types': 8.49.0 + '@typescript-eslint/typescript-estree': 8.49.0(typescript@5.9.3) + '@typescript-eslint/utils': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + debug: 4.4.3(supports-color@5.5.0) + eslint: 9.39.2 + ts-api-utils: 2.1.0(typescript@5.9.3) + typescript: 5.9.3 + transitivePeerDependencies: + - supports-color + dev: true + + /@typescript-eslint/types@8.49.0: + resolution: {integrity: sha512-e9k/fneezorUo6WShlQpMxXh8/8wfyc+biu6tnAqA81oWrEic0k21RHzP9uqqpyBBeBKu4T+Bsjy9/b8u7obXQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dev: true + + /@typescript-eslint/typescript-estree@8.49.0(typescript@5.9.3): + resolution: {integrity: sha512-jrLdRuAbPfPIdYNppHJ/D0wN+wwNfJ32YTAm10eJVsFmrVpXQnDWBn8niCSMlWjvml8jsce5E/O+86IQtTbJWA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@typescript-eslint/project-service': 8.49.0(typescript@5.9.3) + '@typescript-eslint/tsconfig-utils': 8.49.0(typescript@5.9.3) + '@typescript-eslint/types': 8.49.0 + '@typescript-eslint/visitor-keys': 8.49.0 + debug: 4.4.3(supports-color@5.5.0) + minimatch: 9.0.5 + semver: 7.7.3 + tinyglobby: 0.2.15 + ts-api-utils: 2.1.0(typescript@5.9.3) + typescript: 5.9.3 + transitivePeerDependencies: + - supports-color + dev: true + + /@typescript-eslint/utils@8.49.0(eslint@9.39.2)(typescript@5.9.3): + resolution: {integrity: sha512-N3W7rJw7Rw+z1tRsHZbK395TWSYvufBXumYtEGzypgMUthlg0/hmCImeA8hgO2d2G4pd7ftpxxul2J8OdtdaFA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@eslint-community/eslint-utils': 4.9.0(eslint@9.39.2) + '@typescript-eslint/scope-manager': 8.49.0 + '@typescript-eslint/types': 8.49.0 + '@typescript-eslint/typescript-estree': 8.49.0(typescript@5.9.3) + eslint: 9.39.2 + typescript: 5.9.3 transitivePeerDependencies: - supports-color + dev: true - '@typescript-eslint/parser@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3)': + /@typescript-eslint/visitor-keys@8.49.0: + resolution: {integrity: sha512-LlKaciDe3GmZFphXIc79THF/YYBugZ7FS1pO581E/edlVVNbZKDy93evqmrfQ9/Y4uN0vVhX4iuchq26mK/iiA==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: - '@typescript-eslint/scope-manager': 8.33.1 - '@typescript-eslint/types': 8.33.1 - '@typescript-eslint/typescript-estree': 8.33.1(typescript@5.8.3) - '@typescript-eslint/visitor-keys': 8.33.1 - debug: 4.4.1(supports-color@5.5.0) - eslint: 9.28.0(jiti@2.4.2) - typescript: 5.8.3 - transitivePeerDependencies: - - supports-color + '@typescript-eslint/types': 8.49.0 + eslint-visitor-keys: 4.2.1 + dev: true - '@typescript-eslint/project-service@8.33.1(typescript@5.8.3)': + /@vitejs/plugin-vue@6.0.3(vite@7.2.7)(vue@3.5.25): + resolution: {integrity: sha512-TlGPkLFLVOY3T7fZrwdvKpjprR3s4fxRln0ORDo1VQ7HHyxJwTlrjKU3kpVWTlaAjIEuCTokmjkZnr8Tpc925w==} + engines: {node: ^20.19.0 || >=22.12.0} + peerDependencies: + vite: ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 + vue: ^3.2.25 dependencies: - '@typescript-eslint/tsconfig-utils': 8.33.1(typescript@5.8.3) - '@typescript-eslint/types': 8.33.1 - debug: 4.4.1(supports-color@5.5.0) - typescript: 5.8.3 - transitivePeerDependencies: - - supports-color + '@rolldown/pluginutils': 1.0.0-beta.53 + vite: 7.2.7(@types/node@22.19.2) + vue: 3.5.25(typescript@5.9.3) + dev: true - '@typescript-eslint/scope-manager@8.33.1': + /@vitest/expect@2.1.9: + resolution: {integrity: sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==} dependencies: - '@typescript-eslint/types': 8.33.1 - '@typescript-eslint/visitor-keys': 8.33.1 + '@vitest/spy': 2.1.9 + '@vitest/utils': 2.1.9 + chai: 5.3.3 + tinyrainbow: 1.2.0 + dev: true - '@typescript-eslint/tsconfig-utils@8.33.1(typescript@5.8.3)': + /@vitest/mocker@2.1.9(vite@5.4.21): + resolution: {integrity: sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==} + peerDependencies: + msw: ^2.4.9 + vite: ^5.0.0 + peerDependenciesMeta: + msw: + optional: true + vite: + optional: true dependencies: - typescript: 5.8.3 + '@vitest/spy': 2.1.9 + estree-walker: 3.0.3 + magic-string: 0.30.21 + vite: 5.4.21(@types/node@22.19.2) + dev: true - '@typescript-eslint/type-utils@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3)': + /@vitest/pretty-format@2.1.9: + resolution: {integrity: sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==} dependencies: - '@typescript-eslint/typescript-estree': 8.33.1(typescript@5.8.3) - '@typescript-eslint/utils': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - debug: 4.4.1(supports-color@5.5.0) - eslint: 9.28.0(jiti@2.4.2) - ts-api-utils: 2.1.0(typescript@5.8.3) - typescript: 5.8.3 - transitivePeerDependencies: - - supports-color + tinyrainbow: 1.2.0 + dev: true - '@typescript-eslint/types@8.33.1': {} - - '@typescript-eslint/typescript-estree@8.33.1(typescript@5.8.3)': + /@vitest/runner@2.1.9: + resolution: {integrity: sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==} dependencies: - '@typescript-eslint/project-service': 8.33.1(typescript@5.8.3) - '@typescript-eslint/tsconfig-utils': 8.33.1(typescript@5.8.3) - '@typescript-eslint/types': 8.33.1 - '@typescript-eslint/visitor-keys': 8.33.1 - debug: 4.4.1(supports-color@5.5.0) - fast-glob: 3.3.3 - is-glob: 4.0.3 - minimatch: 9.0.5 - semver: 7.7.2 - ts-api-utils: 2.1.0(typescript@5.8.3) - typescript: 5.8.3 - transitivePeerDependencies: - - supports-color + '@vitest/utils': 2.1.9 + pathe: 1.1.2 + dev: true - '@typescript-eslint/utils@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3)': + /@vitest/snapshot@2.1.9: + resolution: {integrity: sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==} dependencies: - '@eslint-community/eslint-utils': 4.7.0(eslint@9.28.0(jiti@2.4.2)) - '@typescript-eslint/scope-manager': 8.33.1 - '@typescript-eslint/types': 8.33.1 - '@typescript-eslint/typescript-estree': 8.33.1(typescript@5.8.3) - eslint: 9.28.0(jiti@2.4.2) - typescript: 5.8.3 - transitivePeerDependencies: - - supports-color + '@vitest/pretty-format': 2.1.9 + magic-string: 0.30.21 + pathe: 1.1.2 + dev: true - '@typescript-eslint/visitor-keys@8.33.1': + /@vitest/spy@2.1.9: + resolution: {integrity: sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==} dependencies: - '@typescript-eslint/types': 8.33.1 - eslint-visitor-keys: 4.2.1 + tinyspy: 3.0.2 + dev: true - '@vitejs/plugin-vue@5.2.4(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0))(vue@3.5.16(typescript@5.8.3))': + /@vitest/utils@2.1.9: + resolution: {integrity: sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==} dependencies: - vite: 6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0) - vue: 3.5.16(typescript@5.8.3) + '@vitest/pretty-format': 2.1.9 + loupe: 3.2.1 + tinyrainbow: 1.2.0 + dev: true - '@volar/language-core@2.4.14': + /@volar/language-core@2.4.15: + resolution: {integrity: sha512-3VHw+QZU0ZG9IuQmzT68IyN4hZNd9GchGPhbD9+pa8CVv7rnoOZwo7T8weIbrRmihqy3ATpdfXFnqRrfPVK6CA==} dependencies: - '@volar/source-map': 2.4.14 + '@volar/source-map': 2.4.15 + dev: true - '@volar/source-map@2.4.14': {} + /@volar/source-map@2.4.15: + resolution: {integrity: sha512-CPbMWlUN6hVZJYGcU/GSoHu4EnCHiLaXI9n8c9la6RaI9W5JHX+NqG+GSQcB0JdC2FIBLdZJwGsfKyBB71VlTg==} + dev: true - '@volar/typescript@2.4.14': + /@volar/typescript@2.4.15: + resolution: {integrity: sha512-2aZ8i0cqPGjXb4BhkMsPYDkkuc2ZQ6yOpqwAuNwUoncELqoy5fRgOQtLR9gB0g902iS0NAkvpIzs27geVyVdPg==} dependencies: - '@volar/language-core': 2.4.14 + '@volar/language-core': 2.4.15 path-browserify: 1.0.1 vscode-uri: 3.1.0 + dev: true + + /@vue-flow/background@1.3.2(@vue-flow/core@1.48.0)(vue@3.5.25): + resolution: {integrity: sha512-eJPhDcLj1wEo45bBoqTXw1uhl0yK2RaQGnEINqvvBsAFKh/camHJd5NPmOdS1w+M9lggc9igUewxaEd3iCQX2w==} + peerDependencies: + '@vue-flow/core': ^1.23.0 + vue: ^3.3.0 + dependencies: + '@vue-flow/core': 1.48.0(vue@3.5.25) + vue: 3.5.25(typescript@5.9.3) + dev: false + + /@vue-flow/controls@1.1.3(@vue-flow/core@1.48.0)(vue@3.5.25): + resolution: {integrity: sha512-XCf+G+jCvaWURdFlZmOjifZGw3XMhN5hHlfMGkWh9xot+9nH9gdTZtn+ldIJKtarg3B21iyHU8JjKDhYcB6JMw==} + peerDependencies: + '@vue-flow/core': ^1.23.0 + vue: ^3.3.0 + dependencies: + '@vue-flow/core': 1.48.0(vue@3.5.25) + vue: 3.5.25(typescript@5.9.3) + dev: false + + /@vue-flow/core@1.48.0(vue@3.5.25): + resolution: {integrity: sha512-keW9HGaEZEe4SKYtrzp5E+qSGJ5/z+9i2yRDtCr3o72IUnS0Ns1qQNsIbGGz0ygpKzg6LdtbVLWeYAvl3dzLQA==} + peerDependencies: + vue: ^3.3.0 + dependencies: + '@vueuse/core': 10.11.1(vue@3.5.25) + d3-drag: 3.0.0 + d3-interpolate: 3.0.1 + d3-selection: 3.0.0 + d3-zoom: 3.0.0 + vue: 3.5.25(typescript@5.9.3) + transitivePeerDependencies: + - '@vue/composition-api' + dev: false + + /@vue-flow/minimap@1.5.4(@vue-flow/core@1.48.0)(vue@3.5.25): + resolution: {integrity: sha512-l4C+XTAXnRxsRpUdN7cAVFBennC1sVRzq4bDSpVK+ag7tdMczAnhFYGgbLkUw3v3sY6gokyWwMl8CDonp8eB2g==} + peerDependencies: + '@vue-flow/core': ^1.23.0 + vue: ^3.3.0 + dependencies: + '@vue-flow/core': 1.48.0(vue@3.5.25) + d3-selection: 3.0.0 + d3-zoom: 3.0.0 + vue: 3.5.25(typescript@5.9.3) + dev: false - '@vue/compiler-core@3.5.16': + /@vue/compiler-core@3.5.25: + resolution: {integrity: sha512-vay5/oQJdsNHmliWoZfHPoVZZRmnSWhug0BYT34njkYTPqClh3DNWLkZNJBVSjsNMrg0CCrBfoKkjZQPM/QVUw==} dependencies: - '@babel/parser': 7.27.5 - '@vue/shared': 3.5.16 + '@babel/parser': 7.28.5 + '@vue/shared': 3.5.25 entities: 4.5.0 estree-walker: 2.0.2 source-map-js: 1.2.1 - '@vue/compiler-dom@3.5.16': + /@vue/compiler-dom@3.5.25: + resolution: {integrity: sha512-4We0OAcMZsKgYoGlMjzYvaoErltdFI2/25wqanuTu+S4gismOTRTBPi4IASOjxWdzIwrYSjnqONfKvuqkXzE2Q==} dependencies: - '@vue/compiler-core': 3.5.16 - '@vue/shared': 3.5.16 + '@vue/compiler-core': 3.5.25 + '@vue/shared': 3.5.25 - '@vue/compiler-sfc@3.5.16': + /@vue/compiler-sfc@3.5.25: + resolution: {integrity: sha512-PUgKp2rn8fFsI++lF2sO7gwO2d9Yj57Utr5yEsDf3GNaQcowCLKL7sf+LvVFvtJDXUp/03+dC6f2+LCv5aK1ag==} dependencies: - '@babel/parser': 7.27.5 - '@vue/compiler-core': 3.5.16 - '@vue/compiler-dom': 3.5.16 - '@vue/compiler-ssr': 3.5.16 - '@vue/shared': 3.5.16 + '@babel/parser': 7.28.5 + '@vue/compiler-core': 3.5.25 + '@vue/compiler-dom': 3.5.25 + '@vue/compiler-ssr': 3.5.25 + '@vue/shared': 3.5.25 estree-walker: 2.0.2 - magic-string: 0.30.17 - postcss: 8.5.4 + magic-string: 0.30.21 + postcss: 8.5.6 source-map-js: 1.2.1 - '@vue/compiler-ssr@3.5.16': + /@vue/compiler-ssr@3.5.25: + resolution: {integrity: sha512-ritPSKLBcParnsKYi+GNtbdbrIE1mtuFEJ4U1sWeuOMlIziK5GtOL85t5RhsNy4uWIXPgk+OUdpnXiTdzn8o3A==} dependencies: - '@vue/compiler-dom': 3.5.16 - '@vue/shared': 3.5.16 + '@vue/compiler-dom': 3.5.25 + '@vue/shared': 3.5.25 - '@vue/compiler-vue2@2.7.16': + /@vue/compiler-vue2@2.7.16: + resolution: {integrity: sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A==} dependencies: de-indent: 1.0.2 he: 1.2.0 + dev: true - '@vue/language-core@2.2.10(typescript@5.8.3)': + /@vue/language-core@2.2.12(typescript@5.9.3): + resolution: {integrity: sha512-IsGljWbKGU1MZpBPN+BvPAdr55YPkj2nB/TBNGNC32Vy2qLG25DYu/NBN2vNtZqdRbTRjaoYrahLrToim2NanA==} + peerDependencies: + typescript: '*' + peerDependenciesMeta: + typescript: + optional: true dependencies: - '@volar/language-core': 2.4.14 - '@vue/compiler-dom': 3.5.16 + '@volar/language-core': 2.4.15 + '@vue/compiler-dom': 3.5.25 '@vue/compiler-vue2': 2.7.16 - '@vue/shared': 3.5.16 + '@vue/shared': 3.5.25 alien-signals: 1.0.13 minimatch: 9.0.5 muggle-string: 0.4.1 path-browserify: 1.0.1 - optionalDependencies: - typescript: 5.8.3 + typescript: 5.9.3 + dev: true - '@vue/reactivity@3.5.16': + /@vue/reactivity@3.5.25: + resolution: {integrity: sha512-5xfAypCQepv4Jog1U4zn8cZIcbKKFka3AgWHEFQeK65OW+Ys4XybP6z2kKgws4YB43KGpqp5D/K3go2UPPunLA==} dependencies: - '@vue/shared': 3.5.16 + '@vue/shared': 3.5.25 - '@vue/runtime-core@3.5.16': + /@vue/runtime-core@3.5.25: + resolution: {integrity: sha512-Z751v203YWwYzy460bzsYQISDfPjHTl+6Zzwo/a3CsAf+0ccEjQ8c+0CdX1WsumRTHeywvyUFtW6KvNukT/smA==} dependencies: - '@vue/reactivity': 3.5.16 - '@vue/shared': 3.5.16 + '@vue/reactivity': 3.5.25 + '@vue/shared': 3.5.25 - '@vue/runtime-dom@3.5.16': + /@vue/runtime-dom@3.5.25: + resolution: {integrity: sha512-a4WrkYFbb19i9pjkz38zJBg8wa/rboNERq3+hRRb0dHiJh13c+6kAbgqCPfMaJ2gg4weWD3APZswASOfmKwamA==} dependencies: - '@vue/reactivity': 3.5.16 - '@vue/runtime-core': 3.5.16 - '@vue/shared': 3.5.16 - csstype: 3.1.3 + '@vue/reactivity': 3.5.25 + '@vue/runtime-core': 3.5.25 + '@vue/shared': 3.5.25 + csstype: 3.2.3 + + /@vue/server-renderer@3.5.25(vue@3.5.25): + resolution: {integrity: sha512-UJaXR54vMG61i8XNIzTSf2Q7MOqZHpp8+x3XLGtE3+fL+nQd+k7O5+X3D/uWrnQXOdMw5VPih+Uremcw+u1woQ==} + peerDependencies: + vue: 3.5.25 + dependencies: + '@vue/compiler-ssr': 3.5.25 + '@vue/shared': 3.5.25 + vue: 3.5.25(typescript@5.9.3) + + /@vue/shared@3.5.25: + resolution: {integrity: sha512-AbOPdQQnAnzs58H2FrrDxYj/TJfmeS2jdfEEhgiKINy+bnOANmVizIEgq1r+C5zsbs6l1CCQxtcj71rwNQ4jWg==} - '@vue/server-renderer@3.5.16(vue@3.5.16(typescript@5.8.3))': + /@vueuse/core@10.11.1(vue@3.5.25): + resolution: {integrity: sha512-guoy26JQktXPcz+0n3GukWIy/JDNKti9v6VEMu6kV2sYBsWuGiTU8OWdg+ADfUbHg3/3DlqySDe7JmdHrktiww==} dependencies: - '@vue/compiler-ssr': 3.5.16 - '@vue/shared': 3.5.16 - vue: 3.5.16(typescript@5.8.3) + '@types/web-bluetooth': 0.0.20 + '@vueuse/metadata': 10.11.1 + '@vueuse/shared': 10.11.1(vue@3.5.25) + vue-demi: 0.14.10(vue@3.5.25) + transitivePeerDependencies: + - '@vue/composition-api' + - vue + dev: false - '@vue/shared@3.5.16': {} + /@vueuse/metadata@10.11.1: + resolution: {integrity: sha512-IGa5FXd003Ug1qAZmyE8wF3sJ81xGLSqTqtQ6jaVfkeZ4i5kS2mwQF61yhVqojRnenVew5PldLyRgvdl4YYuSw==} + dev: false + + /@vueuse/shared@10.11.1(vue@3.5.25): + resolution: {integrity: sha512-LHpC8711VFZlDaYUXEBbFBCQ7GS3dVU9mjOhhMhXP6txTV4EhYQg/KGnQuvt/sPAtoUKq7VVUnL6mVtFoL42sA==} + dependencies: + vue-demi: 0.14.10(vue@3.5.25) + transitivePeerDependencies: + - '@vue/composition-api' + - vue + dev: false - '@webext-core/fake-browser@1.3.2': + /@webext-core/fake-browser@1.3.2: + resolution: {integrity: sha512-jFyPWWz+VkHAC9DRIiIPOyu6X/KlC8dYqSKweHz6tsDb86QawtVgZSpYcM+GOQBlZc5DHFo92jJ7cIq4uBnU0A==} dependencies: lodash.merge: 4.6.2 + dev: true - '@webext-core/isolated-element@1.1.2': + /@webext-core/isolated-element@1.1.2: + resolution: {integrity: sha512-CNHYhsIR8TPkPb+4yqTIuzaGnVn/Fshev5fyoPW+/8Cyc93tJbCjP9PC1XSK6fDWu+xASdPHLZaoa2nWAYoxeQ==} dependencies: is-potential-custom-element-name: 1.0.1 + dev: true - '@webext-core/match-patterns@1.0.3': {} + /@webext-core/match-patterns@1.0.3: + resolution: {integrity: sha512-NY39ACqCxdKBmHgw361M9pfJma8e4AZo20w9AY+5ZjIj1W2dvXC8J31G5fjfOGbulW9w4WKpT8fPooi0mLkn9A==} + dev: true - '@wxt-dev/browser@0.0.326': + /@wxt-dev/browser@0.1.4: + resolution: {integrity: sha512-9x03I15i79XU8qYwjv4le0K2HdMl/Yga2wUBSoUbcrCnamv8P3nvuYxREQ9C5QY/qPAfeEVdAtaTrS3KWak71g==} dependencies: '@types/filesystem': 0.0.36 '@types/har-format': 1.2.16 + dev: true - '@wxt-dev/module-vue@1.0.2(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0))(vue@3.5.16(typescript@5.8.3))(wxt@0.20.7(@types/node@22.15.30)(jiti@2.4.2)(rollup@4.42.0)(yaml@2.8.0))': + /@wxt-dev/module-vue@1.0.3(vite@7.2.7)(vue@3.5.25)(wxt@0.20.11): + resolution: {integrity: sha512-xUNygcj4w0b1MzQGOQIp5V2ZwFE4y+5AwKPi/IPKyo2aNeFVJTfItIxzWI5vTj7031WCLzHgQrrBRS5C63D5iw==} + peerDependencies: + wxt: '>=0.19.16' dependencies: - '@vitejs/plugin-vue': 5.2.4(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0))(vue@3.5.16(typescript@5.8.3)) - wxt: 0.20.7(@types/node@22.15.30)(jiti@2.4.2)(rollup@4.42.0)(yaml@2.8.0) + '@vitejs/plugin-vue': 6.0.3(vite@7.2.7)(vue@3.5.25) + wxt: 0.20.11(@types/node@22.19.2) transitivePeerDependencies: - vite - vue + dev: true - '@wxt-dev/storage@1.1.1': + /@wxt-dev/storage@1.2.6: + resolution: {integrity: sha512-f6AknnpJvhNHW4s0WqwSGCuZAj0fjP3EVNPBO5kB30pY+3Zt/nqZGqJN6FgBLCSkYjPJ8VL1hNX5LMVmvxQoDw==} dependencies: + '@wxt-dev/browser': 0.1.4 async-mutex: 0.5.0 dequal: 2.0.3 + dev: true - '@xenova/transformers@2.17.2': + /@xenova/transformers@2.17.2: + resolution: {integrity: sha512-lZmHqzrVIkSvZdKZEx7IYY51TK0WDrC8eR0c5IMnBsO8di8are1zzw8BlLhyO2TklZKLN5UffNGs1IJwT6oOqQ==} dependencies: '@huggingface/jinja': 0.2.2 onnxruntime-web: 1.14.0 @@ -5769,135 +3322,251 @@ snapshots: optionalDependencies: onnxruntime-node: 1.14.0 transitivePeerDependencies: + - bare-abort-controller - bare-buffer + - react-native-b4a + dev: false - JSONStream@1.3.5: + /JSONStream@1.3.5: + resolution: {integrity: sha512-E+iruNOY8VV9s4JEbe1aNEm6MiszPRr/UfcHMz0TQh1BXSxHK+ASV1R6W4HpjBhSeS+54PIsAMCBmwD06LLsqQ==} + hasBin: true dependencies: jsonparse: 1.3.1 through: 2.3.8 + dev: true - abstract-logging@2.0.1: {} + /abstract-logging@2.0.1: + resolution: {integrity: sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA==} + dev: false - accepts@2.0.0: + /accepts@2.0.0: + resolution: {integrity: sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==} + engines: {node: '>= 0.6'} dependencies: - mime-types: 3.0.1 + mime-types: 3.0.2 negotiator: 1.0.0 + dev: false - acorn-jsx@5.3.2(acorn@8.15.0): + /acorn-jsx@5.3.2(acorn@8.15.0): + resolution: {integrity: sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==} + peerDependencies: + acorn: ^6.0.0 || ^7.0.0 || ^8.0.0 dependencies: acorn: 8.15.0 + dev: true - acorn-walk@8.3.4: + /acorn-walk@8.3.4: + resolution: {integrity: sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==} + engines: {node: '>=0.4.0'} dependencies: acorn: 8.15.0 + dev: true + + /acorn@8.15.0: + resolution: {integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==} + engines: {node: '>=0.4.0'} + hasBin: true + dev: true - acorn@8.15.0: {} + /adm-zip@0.5.16: + resolution: {integrity: sha512-TGw5yVi4saajsSEgz25grObGHEUaDrniwvA2qwSC060KfqGPdglhvPMA2lPIoxs3PQIItj2iag35fONcQqgUaQ==} + engines: {node: '>=12.0'} + dev: true - adm-zip@0.5.16: {} + /agent-base@7.1.4: + resolution: {integrity: sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==} + engines: {node: '>= 14'} + dev: true - ajv-formats@3.0.1(ajv@8.17.1): - optionalDependencies: + /ajv-formats@3.0.1(ajv@8.17.1): + resolution: {integrity: sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==} + peerDependencies: + ajv: ^8.0.0 + peerDependenciesMeta: + ajv: + optional: true + dependencies: ajv: 8.17.1 + dev: false - ajv@6.12.6: + /ajv@6.12.6: + resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==} dependencies: fast-deep-equal: 3.1.3 fast-json-stable-stringify: 2.1.0 json-schema-traverse: 0.4.1 uri-js: 4.4.1 + dev: true - ajv@8.17.1: + /ajv@8.17.1: + resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==} dependencies: fast-deep-equal: 3.1.3 - fast-uri: 3.0.6 + fast-uri: 3.1.0 json-schema-traverse: 1.0.0 require-from-string: 2.0.2 - alien-signals@1.0.13: {} + /alien-signals@1.0.13: + resolution: {integrity: sha512-OGj9yyTnJEttvzhTUWuscOvtqxq5vrhF7vL9oS0xJ2mK0ItPYP1/y+vCFebfxoEyAz0++1AIwJ5CMr+Fk3nDmg==} + dev: true - ansi-align@3.0.1: + /ansi-align@3.0.1: + resolution: {integrity: sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==} dependencies: string-width: 4.2.3 + dev: true - ansi-escapes@4.3.2: + /ansi-escapes@4.3.2: + resolution: {integrity: sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==} + engines: {node: '>=8'} dependencies: type-fest: 0.21.3 + dev: true - ansi-escapes@7.0.0: + /ansi-escapes@7.2.0: + resolution: {integrity: sha512-g6LhBsl+GBPRWGWsBtutpzBYuIIdBkLEvad5C/va/74Db018+5TZiyA26cZJAr3Rft5lprVqOIPxf5Vid6tqAw==} + engines: {node: '>=18'} dependencies: environment: 1.1.0 + dev: true - ansi-regex@5.0.1: {} + /ansi-regex@5.0.1: + resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==} + engines: {node: '>=8'} + dev: true - ansi-regex@6.1.0: {} + /ansi-regex@6.2.2: + resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==} + engines: {node: '>=12'} + dev: true - ansi-styles@4.3.0: + /ansi-styles@4.3.0: + resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==} + engines: {node: '>=8'} dependencies: color-convert: 2.0.1 + dev: true - ansi-styles@5.2.0: {} + /ansi-styles@5.2.0: + resolution: {integrity: sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==} + engines: {node: '>=10'} + dev: true - ansi-styles@6.2.1: {} + /ansi-styles@6.2.3: + resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==} + engines: {node: '>=12'} + dev: true - any-promise@1.3.0: {} + /any-promise@1.3.0: + resolution: {integrity: sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==} + dev: true - anymatch@3.1.3: + /anymatch@3.1.3: + resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==} + engines: {node: '>= 8'} dependencies: normalize-path: 3.0.0 picomatch: 2.3.1 + dev: true - arg@4.1.3: {} + /arg@4.1.3: + resolution: {integrity: sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==} + dev: true - argparse@1.0.10: + /argparse@1.0.10: + resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==} dependencies: sprintf-js: 1.0.3 + dev: true - argparse@2.0.1: {} + /argparse@2.0.1: + resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==} + dev: true + + /array-differ@4.0.0: + resolution: {integrity: sha512-Q6VPTLMsmXZ47ENG3V+wQyZS1ZxXMxFyYzA+Z/GMrJ6yIutAIEf9wTyroTzmGjNfox9/h3GdGBCVh43GVFx4Uw==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - array-differ@4.0.0: {} + /array-ify@1.0.0: + resolution: {integrity: sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==} + dev: true - array-ify@1.0.0: {} + /array-union@3.0.1: + resolution: {integrity: sha512-1OvF9IbWwaeiM9VhzYXVQacMibxpXOMYVNIvMtKRyX9SImBXpKcFr8XvFDeEslCyuH/t6KRt7HEO94AlP8Iatw==} + engines: {node: '>=12'} + dev: true - array-union@3.0.1: {} + /asap@2.0.6: + resolution: {integrity: sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==} + dev: true - asap@2.0.6: {} + /assertion-error@2.0.1: + resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==} + engines: {node: '>=12'} + dev: true - async-mutex@0.5.0: + /async-mutex@0.5.0: + resolution: {integrity: sha512-1A94B18jkJ3DYq284ohPxoXbfTA5HsQ7/Mf4DEhcyLx3Bz27Rh59iScbB6EPiP+B+joue6YCxcMXSbFC1tZKwA==} dependencies: tslib: 2.8.1 + dev: true - async@3.2.6: {} + /async@3.2.6: + resolution: {integrity: sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==} + dev: true - asynckit@0.4.0: {} + /asynckit@0.4.0: + resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==} - atomic-sleep@1.0.0: {} + /atomic-sleep@1.0.0: + resolution: {integrity: sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ==} + engines: {node: '>=8.0.0'} - atomically@2.0.3: + /atomically@2.1.0: + resolution: {integrity: sha512-+gDffFXRW6sl/HCwbta7zK4uNqbPjv4YJEAdz7Vu+FLQHe77eZ4bvbJGi4hE0QPeJlMYMA3piXEr1UL3dAwx7Q==} dependencies: - stubborn-fs: 1.2.5 - when-exit: 2.1.4 + stubborn-fs: 2.0.0 + when-exit: 2.1.5 + dev: true - avvio@9.1.0: + /avvio@9.1.0: + resolution: {integrity: sha512-fYASnYi600CsH/j9EQov7lECAniYiBFiiAtBNuZYLA2leLe9qOvZzqYHFjtIj6gD2VMoMLP14834LFWvr4IfDw==} dependencies: '@fastify/error': 4.2.0 fastq: 1.19.1 + dev: false - b4a@1.6.7: {} + /b4a@1.7.3: + resolution: {integrity: sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q==} + peerDependencies: + react-native-b4a: '*' + peerDependenciesMeta: + react-native-b4a: + optional: true + dev: false - babel-jest@29.7.0(@babel/core@7.27.4): + /babel-jest@29.7.0(@babel/core@7.28.5): + resolution: {integrity: sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + peerDependencies: + '@babel/core': ^7.8.0 dependencies: - '@babel/core': 7.27.4 + '@babel/core': 7.28.5 '@jest/transform': 29.7.0 '@types/babel__core': 7.20.5 babel-plugin-istanbul: 6.1.1 - babel-preset-jest: 29.6.3(@babel/core@7.27.4) + babel-preset-jest: 29.6.3(@babel/core@7.28.5) chalk: 4.1.2 graceful-fs: 4.2.11 slash: 3.0.0 transitivePeerDependencies: - supports-color + dev: true - babel-plugin-istanbul@6.1.1: + /babel-plugin-istanbul@6.1.1: + resolution: {integrity: sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==} + engines: {node: '>=8'} dependencies: '@babel/helper-plugin-utils': 7.27.1 '@istanbuljs/load-nyc-config': 1.1.0 @@ -5906,223 +3575,384 @@ snapshots: test-exclude: 6.0.0 transitivePeerDependencies: - supports-color + dev: true - babel-plugin-jest-hoist@29.6.3: + /babel-plugin-jest-hoist@29.6.3: + resolution: {integrity: sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@babel/template': 7.27.2 - '@babel/types': 7.27.6 + '@babel/types': 7.28.5 '@types/babel__core': 7.20.5 - '@types/babel__traverse': 7.20.7 - - babel-preset-current-node-syntax@1.1.0(@babel/core@7.27.4): - dependencies: - '@babel/core': 7.27.4 - '@babel/plugin-syntax-async-generators': 7.8.4(@babel/core@7.27.4) - '@babel/plugin-syntax-bigint': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-class-properties': 7.12.13(@babel/core@7.27.4) - '@babel/plugin-syntax-class-static-block': 7.14.5(@babel/core@7.27.4) - '@babel/plugin-syntax-import-attributes': 7.27.1(@babel/core@7.27.4) - '@babel/plugin-syntax-import-meta': 7.10.4(@babel/core@7.27.4) - '@babel/plugin-syntax-json-strings': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-logical-assignment-operators': 7.10.4(@babel/core@7.27.4) - '@babel/plugin-syntax-nullish-coalescing-operator': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-numeric-separator': 7.10.4(@babel/core@7.27.4) - '@babel/plugin-syntax-object-rest-spread': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-optional-catch-binding': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-optional-chaining': 7.8.3(@babel/core@7.27.4) - '@babel/plugin-syntax-private-property-in-object': 7.14.5(@babel/core@7.27.4) - '@babel/plugin-syntax-top-level-await': 7.14.5(@babel/core@7.27.4) - - babel-preset-jest@29.6.3(@babel/core@7.27.4): - dependencies: - '@babel/core': 7.27.4 + '@types/babel__traverse': 7.28.0 + dev: true + + /babel-preset-current-node-syntax@1.2.0(@babel/core@7.28.5): + resolution: {integrity: sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==} + peerDependencies: + '@babel/core': ^7.0.0 || ^8.0.0-0 + dependencies: + '@babel/core': 7.28.5 + '@babel/plugin-syntax-async-generators': 7.8.4(@babel/core@7.28.5) + '@babel/plugin-syntax-bigint': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-class-properties': 7.12.13(@babel/core@7.28.5) + '@babel/plugin-syntax-class-static-block': 7.14.5(@babel/core@7.28.5) + '@babel/plugin-syntax-import-attributes': 7.27.1(@babel/core@7.28.5) + '@babel/plugin-syntax-import-meta': 7.10.4(@babel/core@7.28.5) + '@babel/plugin-syntax-json-strings': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-logical-assignment-operators': 7.10.4(@babel/core@7.28.5) + '@babel/plugin-syntax-nullish-coalescing-operator': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-numeric-separator': 7.10.4(@babel/core@7.28.5) + '@babel/plugin-syntax-object-rest-spread': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-optional-catch-binding': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-optional-chaining': 7.8.3(@babel/core@7.28.5) + '@babel/plugin-syntax-private-property-in-object': 7.14.5(@babel/core@7.28.5) + '@babel/plugin-syntax-top-level-await': 7.14.5(@babel/core@7.28.5) + dev: true + + /babel-preset-jest@29.6.3(@babel/core@7.28.5): + resolution: {integrity: sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + peerDependencies: + '@babel/core': ^7.0.0 + dependencies: + '@babel/core': 7.28.5 babel-plugin-jest-hoist: 29.6.3 - babel-preset-current-node-syntax: 1.1.0(@babel/core@7.27.4) + babel-preset-current-node-syntax: 1.2.0(@babel/core@7.28.5) + dev: true - balanced-match@1.0.2: {} + /balanced-match@1.0.2: + resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==} + dev: true - bare-events@2.5.4: - optional: true + /bare-events@2.8.2: + resolution: {integrity: sha512-riJjyv1/mHLIPX4RwiK+oW9/4c3TEUeORHKefKAKnZ5kyslbN+HXowtbaVEqt4IMUB7OXlfixcs6gsFeo/jhiQ==} + peerDependencies: + bare-abort-controller: '*' + peerDependenciesMeta: + bare-abort-controller: + optional: true + dev: false - bare-fs@4.1.5: + /bare-fs@4.5.2: + resolution: {integrity: sha512-veTnRzkb6aPHOvSKIOy60KzURfBdUflr5VReI+NSaPL6xf+XLdONQgZgpYvUuZLVQ8dCqxpBAudaOM1+KpAUxw==} + engines: {bare: '>=1.16.0'} + requiresBuild: true + peerDependencies: + bare-buffer: '*' + peerDependenciesMeta: + bare-buffer: + optional: true dependencies: - bare-events: 2.5.4 + bare-events: 2.8.2 bare-path: 3.0.0 - bare-stream: 2.6.5(bare-events@2.5.4) + bare-stream: 2.7.0(bare-events@2.8.2) + bare-url: 2.3.2 + fast-fifo: 1.3.2 + transitivePeerDependencies: + - bare-abort-controller + - react-native-b4a + dev: false + optional: true + + /bare-os@3.6.2: + resolution: {integrity: sha512-T+V1+1srU2qYNBmJCXZkUY5vQ0B4FSlL3QDROnKQYOqeiQR8UbjNHlPa+TIbM4cuidiN9GaTaOZgSEgsvPbh5A==} + engines: {bare: '>=1.14.0'} + requiresBuild: true + dev: false optional: true - bare-os@3.6.1: + /bare-path@3.0.0: + resolution: {integrity: sha512-tyfW2cQcB5NN8Saijrhqn0Zh7AnFNsnczRcuWODH0eYAXBsJ5gVxAUuNr7tsHSC6IZ77cA0SitzT+s47kot8Mw==} + requiresBuild: true + dependencies: + bare-os: 3.6.2 + dev: false optional: true - bare-path@3.0.0: + /bare-stream@2.7.0(bare-events@2.8.2): + resolution: {integrity: sha512-oyXQNicV1y8nc2aKffH+BUHFRXmx6VrPzlnaEvMhram0nPBrKcEdcyBg5r08D0i8VxngHFAiVyn1QKXpSG0B8A==} + requiresBuild: true + peerDependencies: + bare-buffer: '*' + bare-events: '*' + peerDependenciesMeta: + bare-buffer: + optional: true + bare-events: + optional: true dependencies: - bare-os: 3.6.1 + bare-events: 2.8.2 + streamx: 2.23.0 + transitivePeerDependencies: + - bare-abort-controller + - react-native-b4a + dev: false optional: true - bare-stream@2.6.5(bare-events@2.5.4): + /bare-url@2.3.2: + resolution: {integrity: sha512-ZMq4gd9ngV5aTMa5p9+UfY0b3skwhHELaDkhEHetMdX0LRkW9kzaym4oo/Eh+Ghm0CCDuMTsRIGM/ytUc1ZYmw==} + requiresBuild: true dependencies: - streamx: 2.22.1 - optionalDependencies: - bare-events: 2.5.4 + bare-path: 3.0.0 + dev: false optional: true - base64-js@1.5.1: {} + /base64-js@1.5.1: + resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==} + dev: false + + /baseline-browser-mapping@2.9.7: + resolution: {integrity: sha512-k9xFKplee6KIio3IDbwj+uaCLpqzOwakOgmqzPezM0sFJlFKcg30vk2wOiAJtkTSfx0SSQDSe8q+mWA/fSH5Zg==} + hasBin: true + dev: true - big-integer@1.6.52: {} + /better-sqlite3@11.10.0: + resolution: {integrity: sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==} + requiresBuild: true + dependencies: + bindings: 1.5.0 + prebuild-install: 7.1.3 + dev: false - binary-extensions@2.3.0: {} + /binary-extensions@2.3.0: + resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==} + engines: {node: '>=8'} + dev: true - bl@4.1.0: + /bindings@1.5.0: + resolution: {integrity: sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==} dependencies: - buffer: 5.7.1 - inherits: 2.0.4 - readable-stream: 3.6.2 + file-uri-to-path: 1.0.0 + dev: false - bl@5.1.0: + /bl@4.1.0: + resolution: {integrity: sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==} dependencies: - buffer: 6.0.3 + buffer: 5.7.1 inherits: 2.0.4 readable-stream: 3.6.2 + dev: false - bluebird@3.7.2: {} + /bluebird@3.7.2: + resolution: {integrity: sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==} + dev: true - body-parser@2.2.0: + /body-parser@2.2.1: + resolution: {integrity: sha512-nfDwkulwiZYQIGwxdy0RUmowMhKcFVcYXUU7m4QlKYim1rUtg83xm2yjZ40QjDuc291AJjjeSc9b++AWHSgSHw==} + engines: {node: '>=18'} dependencies: bytes: 3.1.2 content-type: 1.0.5 - debug: 4.4.1(supports-color@5.5.0) - http-errors: 2.0.0 - iconv-lite: 0.6.3 + debug: 4.4.3(supports-color@5.5.0) + http-errors: 2.0.1 + iconv-lite: 0.7.1 on-finished: 2.4.1 qs: 6.14.0 - raw-body: 3.0.0 + raw-body: 3.0.2 type-is: 2.0.1 transitivePeerDependencies: - supports-color + dev: false - boolbase@1.0.0: {} + /boolbase@1.0.0: + resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==} + dev: true - boxen@8.0.1: + /boxen@8.0.1: + resolution: {integrity: sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw==} + engines: {node: '>=18'} dependencies: ansi-align: 3.0.1 camelcase: 8.0.0 - chalk: 5.4.1 + chalk: 5.6.2 cli-boxes: 3.0.0 string-width: 7.2.0 type-fest: 4.41.0 widest-line: 5.0.0 - wrap-ansi: 9.0.0 + wrap-ansi: 9.0.2 + dev: true - bplist-parser@0.2.0: - dependencies: - big-integer: 1.6.52 - - brace-expansion@1.1.11: + /brace-expansion@1.1.12: + resolution: {integrity: sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==} dependencies: balanced-match: 1.0.2 concat-map: 0.0.1 + dev: true - brace-expansion@2.0.1: + /brace-expansion@2.0.2: + resolution: {integrity: sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==} dependencies: balanced-match: 1.0.2 + dev: true - braces@3.0.3: + /braces@3.0.3: + resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==} + engines: {node: '>=8'} dependencies: fill-range: 7.1.1 + dev: true - browserslist@4.25.0: + /browserslist@4.28.1: + resolution: {integrity: sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==} + engines: {node: ^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7} + hasBin: true dependencies: - caniuse-lite: 1.0.30001721 - electron-to-chromium: 1.5.165 - node-releases: 2.0.19 - update-browserslist-db: 1.1.3(browserslist@4.25.0) + baseline-browser-mapping: 2.9.7 + caniuse-lite: 1.0.30001760 + electron-to-chromium: 1.5.267 + node-releases: 2.0.27 + update-browserslist-db: 1.2.2(browserslist@4.28.1) + dev: true - bs-logger@0.2.6: + /bs-logger@0.2.6: + resolution: {integrity: sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==} + engines: {node: '>= 6'} dependencies: fast-json-stable-stringify: 2.1.0 + dev: true - bser@2.1.1: + /bser@2.1.1: + resolution: {integrity: sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==} dependencies: node-int64: 0.4.0 + dev: true - buffer-crc32@0.2.13: {} - - buffer-from@1.1.2: {} - - buffer@5.7.1: - dependencies: - base64-js: 1.5.1 - ieee754: 1.2.1 + /buffer-from@1.1.2: + resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==} + dev: true - buffer@6.0.3: + /buffer@5.7.1: + resolution: {integrity: sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==} dependencies: base64-js: 1.5.1 ieee754: 1.2.1 + dev: false - bundle-name@3.0.0: - dependencies: - run-applescript: 5.0.0 - - bundle-name@4.1.0: + /bundle-name@4.1.0: + resolution: {integrity: sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==} + engines: {node: '>=18'} dependencies: - run-applescript: 7.0.0 + run-applescript: 7.1.0 + dev: true - bundle-require@5.1.0(esbuild@0.25.5): + /bundle-require@5.1.0(esbuild@0.27.1): + resolution: {integrity: sha512-3WrrOuZiyaaZPWiEt4G3+IffISVC9HYlWueJEBWED4ZH4aIAC2PnkdnuRrR94M+w6yGWn4AglWtJtBI8YqvgoA==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + peerDependencies: + esbuild: '>=0.18' dependencies: - esbuild: 0.25.5 + esbuild: 0.27.1 load-tsconfig: 0.2.5 + dev: true - bytes@3.1.2: {} + /bytes@3.1.2: + resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==} + engines: {node: '>= 0.8'} + dev: false - c12@3.0.4(magicast@0.3.5): + /c12@3.3.2(magicast@0.3.5): + resolution: {integrity: sha512-QkikB2X5voO1okL3QsES0N690Sn/K9WokXqUsDQsWy5SnYb+psYQFGA10iy1bZHj3fjISKsI67Q90gruvWWM3A==} + peerDependencies: + magicast: '*' + peerDependenciesMeta: + magicast: + optional: true dependencies: chokidar: 4.0.3 confbox: 0.2.2 defu: 6.1.4 - dotenv: 16.5.0 - exsolve: 1.0.5 + dotenv: 17.2.3 + exsolve: 1.0.8 giget: 2.0.0 - jiti: 2.4.2 + jiti: 2.6.1 + magicast: 0.3.5 ohash: 2.0.11 pathe: 2.0.3 - perfect-debounce: 1.0.0 - pkg-types: 2.1.0 + perfect-debounce: 2.0.0 + pkg-types: 2.3.0 rc9: 2.1.2 - optionalDependencies: - magicast: 0.3.5 + dev: true - cac@6.7.14: {} + /cac@6.7.14: + resolution: {integrity: sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==} + engines: {node: '>=8'} + dev: true - call-bind-apply-helpers@1.0.2: + /call-bind-apply-helpers@1.0.2: + resolution: {integrity: sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==} + engines: {node: '>= 0.4'} dependencies: es-errors: 1.3.0 function-bind: 1.1.2 - call-bound@1.0.4: + /call-bound@1.0.4: + resolution: {integrity: sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==} + engines: {node: '>= 0.4'} dependencies: call-bind-apply-helpers: 1.0.2 get-intrinsic: 1.3.0 - callsites@3.1.0: {} + /callsites@3.1.0: + resolution: {integrity: sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==} + engines: {node: '>=6'} + dev: true + + /camelcase@5.3.1: + resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==} + engines: {node: '>=6'} + dev: true - camelcase@5.3.1: {} + /camelcase@6.3.0: + resolution: {integrity: sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==} + engines: {node: '>=10'} + dev: true - camelcase@6.3.0: {} + /camelcase@8.0.0: + resolution: {integrity: sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA==} + engines: {node: '>=16'} + dev: true - camelcase@8.0.0: {} + /caniuse-lite@1.0.30001760: + resolution: {integrity: sha512-7AAMPcueWELt1p3mi13HR/LHH0TJLT11cnwDJEs3xA4+CK/PLKeO9Kl1oru24htkyUKtkGCvAx4ohB0Ttry8Dw==} + dev: true - caniuse-lite@1.0.30001721: {} + /chai@5.3.3: + resolution: {integrity: sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==} + engines: {node: '>=18'} + dependencies: + assertion-error: 2.0.1 + check-error: 2.1.1 + deep-eql: 5.0.2 + loupe: 3.2.1 + pathval: 2.0.1 + dev: true - chalk@4.1.2: + /chalk@4.1.2: + resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==} + engines: {node: '>=10'} dependencies: ansi-styles: 4.3.0 supports-color: 7.2.0 + dev: true - chalk@5.4.1: {} + /chalk@5.6.2: + resolution: {integrity: sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==} + engines: {node: ^12.17.0 || ^14.13 || >=16.0.0} + + /char-regex@1.0.2: + resolution: {integrity: sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==} + engines: {node: '>=10'} + dev: true - char-regex@1.0.2: {} + /check-error@2.1.1: + resolution: {integrity: sha512-OAlb+T7V4Op9OwdkjmguYRqncdlx5JiofwOAUkmTF+jNdHwzTaTs4sRAGpzLF3oOz5xAyDGrPgeIDFQmDOTiJw==} + engines: {node: '>= 16'} + dev: true - chokidar@3.6.0: + /chokidar@3.6.0: + resolution: {integrity: sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==} + engines: {node: '>= 8.10.0'} dependencies: anymatch: 3.1.3 braces: 3.0.3 @@ -6133,203 +3963,319 @@ snapshots: readdirp: 3.6.0 optionalDependencies: fsevents: 2.3.3 + dev: true - chokidar@4.0.3: + /chokidar@4.0.3: + resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==} + engines: {node: '>= 14.16.0'} dependencies: readdirp: 4.1.2 + dev: true + + /chownr@1.1.4: + resolution: {integrity: sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==} + dev: false - chownr@1.1.4: {} + /chrome-devtools-frontend@1.0.1556696: + resolution: {integrity: sha512-OrMFQ85xq9qMoQpN30oAjO5kM2RXU+5Fny7kEY+rejCoB6F/3D5GAXNAbaVvW1TpsBmC1hXLah29Z05tCFKOYQ==} + dev: false - chrome-launcher@1.1.2: + /chrome-launcher@1.2.0: + resolution: {integrity: sha512-JbuGuBNss258bvGil7FT4HKdC3SC2K7UAEUqiPy3ACS3Yxo3hAW6bvFpCu2HsIJLgTqxgEX6BkujvzZfLpUD0Q==} + engines: {node: '>=12.13.0'} + hasBin: true dependencies: - '@types/node': 22.15.30 + '@types/node': 22.19.2 escape-string-regexp: 4.0.0 is-wsl: 2.2.0 - lighthouse-logger: 2.0.1 + lighthouse-logger: 2.0.2 transitivePeerDependencies: - supports-color + dev: true - ci-info@3.9.0: {} + /ci-info@3.9.0: + resolution: {integrity: sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==} + engines: {node: '>=8'} + dev: true - ci-info@4.2.0: {} + /ci-info@4.3.1: + resolution: {integrity: sha512-Wdy2Igu8OcBpI2pZePZ5oWjPC38tmDVx5WKUXKwlLYkA0ozo85sLsLvkBbBn/sZaSCMFOGZJ14fvW9t5/d7kdA==} + engines: {node: '>=8'} + dev: true - citty@0.1.6: + /citty@0.1.6: + resolution: {integrity: sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ==} dependencies: consola: 3.4.2 + dev: true - cjs-module-lexer@1.4.3: {} - - cli-boxes@3.0.0: {} + /cjs-module-lexer@1.4.3: + resolution: {integrity: sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==} + dev: true - cli-cursor@4.0.0: - dependencies: - restore-cursor: 4.0.0 + /cli-boxes@3.0.0: + resolution: {integrity: sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==} + engines: {node: '>=10'} + dev: true - cli-cursor@5.0.0: + /cli-cursor@5.0.0: + resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==} + engines: {node: '>=18'} dependencies: restore-cursor: 5.1.0 + dev: true - cli-highlight@2.1.11: - dependencies: - chalk: 4.1.2 - highlight.js: 10.7.3 - mz: 2.7.0 - parse5: 5.1.1 - parse5-htmlparser2-tree-adapter: 6.0.1 - yargs: 16.2.0 - - cli-spinners@2.9.2: {} + /cli-spinners@2.9.2: + resolution: {integrity: sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg==} + engines: {node: '>=6'} + dev: true - cli-truncate@4.0.0: + /cli-truncate@4.0.0: + resolution: {integrity: sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==} + engines: {node: '>=18'} dependencies: slice-ansi: 5.0.0 string-width: 7.2.0 + dev: true - cliui@7.0.4: - dependencies: - string-width: 4.2.3 - strip-ansi: 6.0.1 - wrap-ansi: 7.0.0 - - cliui@8.0.1: + /cliui@8.0.1: + resolution: {integrity: sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==} + engines: {node: '>=12'} dependencies: string-width: 4.2.3 strip-ansi: 6.0.1 wrap-ansi: 7.0.0 + dev: true - clone@1.0.4: {} - - co@4.6.0: {} + /co@4.6.0: + resolution: {integrity: sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==} + engines: {iojs: '>= 1.0.0', node: '>= 0.12.0'} + dev: true - collect-v8-coverage@1.0.2: {} + /collect-v8-coverage@1.0.3: + resolution: {integrity: sha512-1L5aqIkwPfiodaMgQunkF1zRhNqifHBmtbbbxcr6yVxxBnliw4TDOW6NxpO8DJLgJ16OT+Y4ztZqP6p/FtXnAw==} + dev: true - color-convert@2.0.1: + /color-convert@2.0.1: + resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==} + engines: {node: '>=7.0.0'} dependencies: color-name: 1.1.4 - color-name@1.1.4: {} + /color-name@1.1.4: + resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==} - color-string@1.9.1: + /color-string@1.9.1: + resolution: {integrity: sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==} dependencies: color-name: 1.1.4 - simple-swizzle: 0.2.2 + simple-swizzle: 0.2.4 + dev: false - color@4.2.3: + /color@4.2.3: + resolution: {integrity: sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==} + engines: {node: '>=12.5.0'} dependencies: color-convert: 2.0.1 color-string: 1.9.1 + dev: false - colorette@2.0.20: {} + /colorette@2.0.20: + resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==} + dev: true - combined-stream@1.0.8: + /combined-stream@1.0.8: + resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==} + engines: {node: '>= 0.8'} dependencies: delayed-stream: 1.0.0 - commander@13.1.0: {} + /commander@13.1.0: + resolution: {integrity: sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==} + engines: {node: '>=18'} - commander@2.9.0: + /commander@2.9.0: + resolution: {integrity: sha512-bmkUukX8wAOjHdN26xj5c4ctEV22TQ7dQYhSmuckKhToXrkUn0iIaolHdIxYYqD55nhpSPA9zPQ1yP57GdXP2A==} + engines: {node: '>= 0.6.x'} dependencies: graceful-readlink: 1.0.1 + dev: true - commander@4.1.1: {} + /commander@4.1.1: + resolution: {integrity: sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==} + engines: {node: '>= 6'} + dev: true - commander@9.5.0: {} + /commander@9.5.0: + resolution: {integrity: sha512-KRs7WVDKg86PWiuAqhDrAQnTXZKraVcCc6vFdL14qrZ/DcWwuRo7VoiYXalXO7S5GKpqYiVEwCbgFDfxNHKJBQ==} + engines: {node: ^12.20.0 || >=14} + dev: true - compare-func@2.0.0: + /compare-func@2.0.0: + resolution: {integrity: sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==} dependencies: array-ify: 1.0.0 dot-prop: 5.3.0 + dev: true - component-emitter@1.3.1: {} + /component-emitter@1.3.1: + resolution: {integrity: sha512-T0+barUSQRTUQASh8bx02dl+DhF54GtIDY13Y3m9oWTklKbb3Wv974meRpeZ3lp1JpLVECWWNHC4vaG2XHXouQ==} + dev: true - concat-map@0.0.1: {} + /concat-map@0.0.1: + resolution: {integrity: sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==} + dev: true - concat-stream@1.6.2: + /concat-stream@1.6.2: + resolution: {integrity: sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==} + engines: {'0': node >= 0.8} dependencies: buffer-from: 1.1.2 inherits: 2.0.4 readable-stream: 2.3.8 typedarray: 0.0.6 + dev: true - confbox@0.1.8: {} + /confbox@0.1.8: + resolution: {integrity: sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w==} + dev: true - confbox@0.2.2: {} + /confbox@0.2.2: + resolution: {integrity: sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ==} + dev: true - config-chain@1.1.13: + /config-chain@1.1.13: + resolution: {integrity: sha512-qj+f8APARXHrM0hraqXYb2/bOVSV4PvJQlNZ/DVj0QrmNM2q2euizkeuVckQ57J+W0mRH6Hvi+k50M4Jul2VRQ==} dependencies: ini: 1.3.8 proto-list: 1.2.4 + dev: true - configstore@7.0.0: + /configstore@7.1.0: + resolution: {integrity: sha512-N4oog6YJWbR9kGyXvS7jEykLDXIE2C0ILYqNBZBp9iwiJpoCBWYsuAdW6PPFn6w06jjnC+3JstVvWHO4cZqvRg==} + engines: {node: '>=18'} dependencies: - atomically: 2.0.3 + atomically: 2.1.0 dot-prop: 9.0.0 graceful-fs: 4.2.11 xdg-basedir: 5.1.0 + dev: true - consola@3.4.2: {} + /consola@3.4.2: + resolution: {integrity: sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA==} + engines: {node: ^14.18.0 || >=16.10.0} + dev: true - content-disposition@1.0.0: - dependencies: - safe-buffer: 5.2.1 + /content-disposition@1.0.1: + resolution: {integrity: sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==} + engines: {node: '>=18'} + dev: false - content-type@1.0.5: {} + /content-type@1.0.5: + resolution: {integrity: sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==} + engines: {node: '>= 0.6'} + dev: false - conventional-changelog-angular@7.0.0: + /conventional-changelog-angular@7.0.0: + resolution: {integrity: sha512-ROjNchA9LgfNMTTFSIWPzebCwOGFdgkEq45EnvvrmSLvCtAw0HSmrCs7/ty+wAeYUZyNay0YMUNYFTRL72PkBQ==} + engines: {node: '>=16'} dependencies: compare-func: 2.0.0 + dev: true - conventional-changelog-conventionalcommits@7.0.2: + /conventional-changelog-conventionalcommits@7.0.2: + resolution: {integrity: sha512-NKXYmMR/Hr1DevQegFB4MwfM5Vv0m4UIxKZTTYuD98lpTknaZlSRrDOG4X7wIXpGkfsYxZTghUN+Qq+T0YQI7w==} + engines: {node: '>=16'} dependencies: compare-func: 2.0.0 + dev: true - conventional-commits-parser@5.0.0: + /conventional-commits-parser@5.0.0: + resolution: {integrity: sha512-ZPMl0ZJbw74iS9LuX9YIAiW8pfM5p3yh2o/NbXHbkFuZzY5jvdi5jFycEOkmBW5H5I7nA+D6f3UcsCLP2vvSEA==} + engines: {node: '>=16'} + hasBin: true dependencies: JSONStream: 1.3.5 is-text-path: 2.0.0 meow: 12.1.1 split2: 4.2.0 + dev: true - convert-source-map@2.0.0: {} + /convert-source-map@2.0.0: + resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} + dev: true - cookie-signature@1.2.2: {} + /cookie-signature@1.2.2: + resolution: {integrity: sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==} + engines: {node: '>=6.6.0'} + dev: false - cookie@0.7.2: {} + /cookie@0.7.2: + resolution: {integrity: sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==} + engines: {node: '>= 0.6'} + dev: false - cookie@1.0.2: {} + /cookie@1.1.1: + resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==} + engines: {node: '>=18'} + dev: false - cookiejar@2.1.4: {} + /cookiejar@2.1.4: + resolution: {integrity: sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw==} + dev: true - core-util-is@1.0.3: {} + /core-util-is@1.0.3: + resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==} + dev: true - cors@2.8.5: + /cors@2.8.5: + resolution: {integrity: sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==} + engines: {node: '>= 0.10'} dependencies: object-assign: 4.1.1 vary: 1.1.2 + dev: false - cosmiconfig-typescript-loader@6.1.0(@types/node@22.15.30)(cosmiconfig@9.0.0(typescript@5.8.3))(typescript@5.8.3): + /cosmiconfig-typescript-loader@6.2.0(@types/node@22.19.2)(cosmiconfig@9.0.0)(typescript@5.9.3): + resolution: {integrity: sha512-GEN39v7TgdxgIoNcdkRE3uiAzQt3UXLyHbRHD6YoL048XAeOomyxaP+Hh/+2C6C2wYjxJ2onhJcsQp+L4YEkVQ==} + engines: {node: '>=v18'} + peerDependencies: + '@types/node': '*' + cosmiconfig: '>=9' + typescript: '>=5' dependencies: - '@types/node': 22.15.30 - cosmiconfig: 9.0.0(typescript@5.8.3) - jiti: 2.4.2 - typescript: 5.8.3 + '@types/node': 22.19.2 + cosmiconfig: 9.0.0(typescript@5.9.3) + jiti: 2.6.1 + typescript: 5.9.3 + dev: true - cosmiconfig@9.0.0(typescript@5.8.3): + /cosmiconfig@9.0.0(typescript@5.9.3): + resolution: {integrity: sha512-itvL5h8RETACmOTFc4UfIyB2RfEHi71Ax6E/PivVxq9NseKbOWpeyHEOIbmAw1rs8Ak0VursQNww7lf7YtUwzg==} + engines: {node: '>=14'} + peerDependencies: + typescript: '>=4.9.5' + peerDependenciesMeta: + typescript: + optional: true dependencies: env-paths: 2.2.1 import-fresh: 3.3.1 - js-yaml: 4.1.0 + js-yaml: 4.1.1 parse-json: 5.2.0 - optionalDependencies: - typescript: 5.8.3 + typescript: 5.9.3 + dev: true - create-jest@29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)): + /create-jest@29.7.0(@types/node@22.19.2)(ts-node@10.9.2): + resolution: {integrity: sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + hasBin: true dependencies: '@jest/types': 29.6.3 chalk: 4.1.2 exit: 0.1.2 graceful-fs: 4.2.11 - jest-config: 29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + jest-config: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) jest-util: 29.7.0 prompts: 2.4.2 transitivePeerDependencies: @@ -6337,297 +4283,765 @@ snapshots: - babel-plugin-macros - supports-color - ts-node + dev: true - create-require@1.1.1: {} + /create-require@1.1.1: + resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==} + dev: true - cross-env@7.0.3: + /cross-env@7.0.3: + resolution: {integrity: sha512-+/HKd6EgcQCJGh2PSjZuUitQBQynKor4wrFbRg4DtAgS1aWO+gU52xpH7M9ScGgXSYmAVS9bIJ8EzuaGw0oNAw==} + engines: {node: '>=10.14', npm: '>=6', yarn: '>=1'} + hasBin: true dependencies: cross-spawn: 7.0.6 + dev: true - cross-spawn@7.0.6: + /cross-spawn@7.0.6: + resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==} + engines: {node: '>= 8'} dependencies: path-key: 3.1.1 shebang-command: 2.0.0 which: 2.0.2 - css-select@5.1.0: + /css-select@5.2.2: + resolution: {integrity: sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==} dependencies: boolbase: 1.0.0 - css-what: 6.1.0 + css-what: 6.2.2 domhandler: 5.0.3 domutils: 3.2.2 nth-check: 2.1.1 + dev: true + + /css-what@6.2.2: + resolution: {integrity: sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==} + engines: {node: '>= 6'} + dev: true - css-what@6.1.0: {} + /cssesc@3.0.0: + resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==} + engines: {node: '>=4'} + hasBin: true + dev: true + + /cssom@0.5.0: + resolution: {integrity: sha512-iKuQcq+NdHqlAcwUY0o/HL69XQrUaQdMjmStJ8JFmUaiiQErlhrmuigkg/CU4E2J0IyUKUrMAgl36TvN67MqTw==} + dev: true + + /cssstyle@4.6.0: + resolution: {integrity: sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==} + engines: {node: '>=18'} + dependencies: + '@asamuzakjp/css-color': 3.2.0 + rrweb-cssom: 0.8.0 + dev: true - cssesc@3.0.0: {} + /csstype@3.2.3: + resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==} - cssom@0.5.0: {} + /d3-color@3.1.0: + resolution: {integrity: sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==} + engines: {node: '>=12'} + dev: false + + /d3-dispatch@3.0.1: + resolution: {integrity: sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==} + engines: {node: '>=12'} + dev: false + + /d3-drag@3.0.0: + resolution: {integrity: sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg==} + engines: {node: '>=12'} + dependencies: + d3-dispatch: 3.0.1 + d3-selection: 3.0.0 + dev: false - csstype@3.1.3: {} + /d3-ease@3.0.1: + resolution: {integrity: sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==} + engines: {node: '>=12'} + dev: false - dargs@8.1.0: {} + /d3-interpolate@3.0.1: + resolution: {integrity: sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==} + engines: {node: '>=12'} + dependencies: + d3-color: 3.1.0 + dev: false - date-fns@4.1.0: {} + /d3-selection@3.0.0: + resolution: {integrity: sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ==} + engines: {node: '>=12'} + dev: false - dateformat@4.6.3: {} + /d3-timer@3.0.1: + resolution: {integrity: sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==} + engines: {node: '>=12'} + dev: false - de-indent@1.0.2: {} + /d3-transition@3.0.1(d3-selection@3.0.0): + resolution: {integrity: sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w==} + engines: {node: '>=12'} + peerDependencies: + d3-selection: 2 - 3 + dependencies: + d3-color: 3.1.0 + d3-dispatch: 3.0.1 + d3-ease: 3.0.1 + d3-interpolate: 3.0.1 + d3-selection: 3.0.0 + d3-timer: 3.0.1 + dev: false + + /d3-zoom@3.0.0: + resolution: {integrity: sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw==} + engines: {node: '>=12'} + dependencies: + d3-dispatch: 3.0.1 + d3-drag: 3.0.0 + d3-interpolate: 3.0.1 + d3-selection: 3.0.0 + d3-transition: 3.0.1(d3-selection@3.0.0) + dev: false - debounce@1.2.1: {} + /dargs@8.1.0: + resolution: {integrity: sha512-wAV9QHOsNbwnWdNW2FYvE1P56wtgSbM+3SZcdGiWQILwVjACCXDCI3Ai8QlCjMDB8YK5zySiXZYBiwGmNY3lnw==} + engines: {node: '>=12'} + dev: true - debug@2.6.9: + /data-urls@5.0.0: + resolution: {integrity: sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==} + engines: {node: '>=18'} dependencies: - ms: 2.0.0 + whatwg-mimetype: 4.0.0 + whatwg-url: 14.2.0 + dev: true + + /date-fns@4.1.0: + resolution: {integrity: sha512-Ukq0owbQXxa/U3EGtsdVBkR1w7KOQ5gIBqdH2hkvknzZPYvBxb/aa6E8L7tmjFtkwZBu3UXBbjIgPo/Ez4xaNg==} + dev: false + + /dateformat@4.6.3: + resolution: {integrity: sha512-2P0p0pFGzHS5EMnhdxQi7aJN+iMheud0UhG4dlE1DLAlvL8JHjJJTX/CSm4JXwV0Ka5nGk3zC5mcb5bUQUxxMA==} + dev: true + + /de-indent@1.0.2: + resolution: {integrity: sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==} + dev: true - debug@4.3.7: + /debounce@1.2.1: + resolution: {integrity: sha512-XRRe6Glud4rd/ZGQfiV1ruXSfbvfJedlV9Y6zOlP+2K04vBYiJEte6stfFkCP03aMnY5tsipamumUjL14fofug==} + dev: true + + /debug@4.3.7: + resolution: {integrity: sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true dependencies: ms: 2.1.3 + dev: true - debug@4.4.1(supports-color@5.5.0): + /debug@4.4.3(supports-color@5.5.0): + resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true dependencies: ms: 2.1.3 - optionalDependencies: supports-color: 5.5.0 - decompress-response@6.0.0: + /decimal.js@10.6.0: + resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==} + dev: true + + /decompress-response@6.0.0: + resolution: {integrity: sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==} + engines: {node: '>=10'} dependencies: mimic-response: 3.1.0 + dev: false - dedent@1.6.0: {} - - deep-extend@0.6.0: {} + /dedent@1.7.0: + resolution: {integrity: sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==} + peerDependencies: + babel-plugin-macros: ^3.1.0 + peerDependenciesMeta: + babel-plugin-macros: + optional: true + dev: true - deep-is@0.1.4: {} + /deep-eql@5.0.2: + resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==} + engines: {node: '>=6'} + dev: true - deepmerge@4.3.1: {} + /deep-extend@0.6.0: + resolution: {integrity: sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==} + engines: {node: '>=4.0.0'} - default-browser-id@3.0.0: - dependencies: - bplist-parser: 0.2.0 - untildify: 4.0.0 + /deep-is@0.1.4: + resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==} + dev: true - default-browser-id@5.0.0: {} + /deepmerge@4.3.1: + resolution: {integrity: sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==} + engines: {node: '>=0.10.0'} + dev: true - default-browser@4.0.0: - dependencies: - bundle-name: 3.0.0 - default-browser-id: 3.0.0 - execa: 7.2.0 - titleize: 3.0.0 + /default-browser-id@5.0.1: + resolution: {integrity: sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==} + engines: {node: '>=18'} + dev: true - default-browser@5.2.1: + /default-browser@5.4.0: + resolution: {integrity: sha512-XDuvSq38Hr1MdN47EDvYtx3U0MTqpCEn+F6ft8z2vYDzMrvQhVp0ui9oQdqW3MvK3vqUETglt1tVGgjLuJ5izg==} + engines: {node: '>=18'} dependencies: bundle-name: 4.1.0 - default-browser-id: 5.0.0 - - defaults@1.0.4: - dependencies: - clone: 1.0.4 + default-browser-id: 5.0.1 + dev: true - define-lazy-prop@2.0.0: {} + /define-lazy-prop@2.0.0: + resolution: {integrity: sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==} + engines: {node: '>=8'} + dev: true - define-lazy-prop@3.0.0: {} + /define-lazy-prop@3.0.0: + resolution: {integrity: sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==} + engines: {node: '>=12'} + dev: true - defu@6.1.4: {} + /defu@6.1.4: + resolution: {integrity: sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==} + dev: true - delayed-stream@1.0.0: {} + /delayed-stream@1.0.0: + resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==} + engines: {node: '>=0.4.0'} - depd@2.0.0: {} + /depd@2.0.0: + resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==} + engines: {node: '>= 0.8'} + dev: false - dequal@2.0.3: {} + /dequal@2.0.3: + resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==} + engines: {node: '>=6'} - destr@2.0.5: {} + /destr@2.0.5: + resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==} + dev: true - detect-libc@2.0.4: {} + /detect-libc@2.1.2: + resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} + engines: {node: '>=8'} - detect-newline@3.1.0: {} + /detect-newline@3.1.0: + resolution: {integrity: sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==} + engines: {node: '>=8'} + dev: true - dezalgo@1.0.4: + /dezalgo@1.0.4: + resolution: {integrity: sha512-rXSP0bf+5n0Qonsb+SVVfNfIsimO4HEtmnIpPHY8Q1UCzKlQrDMfdobr8nJOOsRgWCyMRqeSBQzmWUMq7zvVig==} dependencies: asap: 2.0.6 wrappy: 1.0.2 + dev: true - diff-sequences@29.6.3: {} + /diff-sequences@29.6.3: + resolution: {integrity: sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + dev: true - diff@4.0.2: {} + /diff@4.0.2: + resolution: {integrity: sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==} + engines: {node: '>=0.3.1'} + dev: true - dom-serializer@2.0.0: + /dom-serializer@2.0.0: + resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==} dependencies: domelementtype: 2.3.0 domhandler: 5.0.3 entities: 4.5.0 + dev: true - domelementtype@2.3.0: {} + /domelementtype@2.3.0: + resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==} + dev: true - domhandler@5.0.3: + /domhandler@5.0.3: + resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==} + engines: {node: '>= 4'} dependencies: domelementtype: 2.3.0 + dev: true - domutils@3.2.2: + /domutils@3.2.2: + resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==} dependencies: dom-serializer: 2.0.0 domelementtype: 2.3.0 domhandler: 5.0.3 + dev: true - dot-prop@5.3.0: + /dot-prop@5.3.0: + resolution: {integrity: sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==} + engines: {node: '>=8'} dependencies: is-obj: 2.0.0 + dev: true - dot-prop@9.0.0: + /dot-prop@9.0.0: + resolution: {integrity: sha512-1gxPBJpI/pcjQhKgIU91II6Wkay+dLcN3M6rf2uwP8hRur3HtQXjVrdAK3sjC0piaEuxzMwjXChcETiJl47lAQ==} + engines: {node: '>=18'} dependencies: type-fest: 4.41.0 + dev: true - dotenv-expand@12.0.2: + /dotenv-expand@12.0.3: + resolution: {integrity: sha512-uc47g4b+4k/M/SeaW1y4OApx+mtLWl92l5LMPP0GNXctZqELk+YGgOPIIC5elYmUH4OuoK3JLhuRUYegeySiFA==} + engines: {node: '>=12'} dependencies: - dotenv: 16.5.0 + dotenv: 16.6.1 + dev: true + + /dotenv@16.6.1: + resolution: {integrity: sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==} + engines: {node: '>=12'} + dev: true + + /dotenv@17.2.3: + resolution: {integrity: sha512-JVUnt+DUIzu87TABbhPmNfVdBDt18BLOWjMUFJMSi/Qqg7NTYtabbvSNJGOJ7afbRuv9D/lngizHtP7QyLQ+9w==} + engines: {node: '>=12'} + dev: true - dotenv@16.5.0: {} + /drizzle-orm@0.38.4(@types/better-sqlite3@7.6.13)(better-sqlite3@11.10.0): + resolution: {integrity: sha512-s7/5BpLKO+WJRHspvpqTydxFob8i1vo2rEx4pY6TGY7QSMuUfWUuzaY0DIpXCkgHOo37BaFC+SJQb99dDUXT3Q==} + peerDependencies: + '@aws-sdk/client-rds-data': '>=3' + '@cloudflare/workers-types': '>=4' + '@electric-sql/pglite': '>=0.2.0' + '@libsql/client': '>=0.10.0' + '@libsql/client-wasm': '>=0.10.0' + '@neondatabase/serverless': '>=0.10.0' + '@op-engineering/op-sqlite': '>=2' + '@opentelemetry/api': ^1.4.1 + '@planetscale/database': '>=1' + '@prisma/client': '*' + '@tidbcloud/serverless': '*' + '@types/better-sqlite3': '*' + '@types/pg': '*' + '@types/react': '>=18' + '@types/sql.js': '*' + '@vercel/postgres': '>=0.8.0' + '@xata.io/client': '*' + better-sqlite3: '>=7' + bun-types: '*' + expo-sqlite: '>=14.0.0' + knex: '*' + kysely: '*' + mysql2: '>=2' + pg: '>=8' + postgres: '>=3' + prisma: '*' + react: '>=18' + sql.js: '>=1' + sqlite3: '>=5' + peerDependenciesMeta: + '@aws-sdk/client-rds-data': + optional: true + '@cloudflare/workers-types': + optional: true + '@electric-sql/pglite': + optional: true + '@libsql/client': + optional: true + '@libsql/client-wasm': + optional: true + '@neondatabase/serverless': + optional: true + '@op-engineering/op-sqlite': + optional: true + '@opentelemetry/api': + optional: true + '@planetscale/database': + optional: true + '@prisma/client': + optional: true + '@tidbcloud/serverless': + optional: true + '@types/better-sqlite3': + optional: true + '@types/pg': + optional: true + '@types/react': + optional: true + '@types/sql.js': + optional: true + '@vercel/postgres': + optional: true + '@xata.io/client': + optional: true + better-sqlite3: + optional: true + bun-types: + optional: true + expo-sqlite: + optional: true + knex: + optional: true + kysely: + optional: true + mysql2: + optional: true + pg: + optional: true + postgres: + optional: true + prisma: + optional: true + react: + optional: true + sql.js: + optional: true + sqlite3: + optional: true + dependencies: + '@types/better-sqlite3': 7.6.13 + better-sqlite3: 11.10.0 + dev: false - dunder-proto@1.0.1: + /dunder-proto@1.0.1: + resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==} + engines: {node: '>= 0.4'} dependencies: call-bind-apply-helpers: 1.0.2 es-errors: 1.3.0 gopd: 1.2.0 - eastasianwidth@0.2.0: {} + /eastasianwidth@0.2.0: + resolution: {integrity: sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==} + dev: true - ee-first@1.1.1: {} + /ee-first@1.1.1: + resolution: {integrity: sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==} + dev: false - ejs@3.1.10: - dependencies: - jake: 10.9.2 + /electron-to-chromium@1.5.267: + resolution: {integrity: sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==} + dev: true - electron-to-chromium@1.5.165: {} + /elkjs@0.11.0: + resolution: {integrity: sha512-u4J8h9mwEDaYMqo0RYJpqNMFDoMK7f+pu4GjcV+N8jIC7TRdORgzkfSjTJemhqONFfH6fBI3wpysgWbhgVWIXw==} + dev: false - emittery@0.13.1: {} + /emittery@0.13.1: + resolution: {integrity: sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==} + engines: {node: '>=12'} + dev: true - emoji-regex@10.4.0: {} + /emoji-regex@10.6.0: + resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==} + dev: true - emoji-regex@8.0.0: {} + /emoji-regex@8.0.0: + resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==} + dev: true - emoji-regex@9.2.2: {} + /emoji-regex@9.2.2: + resolution: {integrity: sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==} + dev: true - encodeurl@2.0.0: {} + /encodeurl@2.0.0: + resolution: {integrity: sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==} + engines: {node: '>= 0.8'} + dev: false - end-of-stream@1.4.4: + /end-of-stream@1.4.5: + resolution: {integrity: sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==} dependencies: once: 1.4.0 - entities@4.5.0: {} + /enhanced-resolve@5.18.4: + resolution: {integrity: sha512-LgQMM4WXU3QI+SYgEc2liRgznaD5ojbmY3sb8LxyguVkIg5FxdpTkvk72te2R38/TGKxH634oLxXRGY6d7AP+Q==} + engines: {node: '>=10.13.0'} + dependencies: + graceful-fs: 4.2.11 + tapable: 2.3.0 + dev: true + + /entities@4.5.0: + resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} + engines: {node: '>=0.12'} - entities@6.0.1: {} + /entities@6.0.1: + resolution: {integrity: sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==} + engines: {node: '>=0.12'} + dev: true - env-paths@2.2.1: {} + /env-paths@2.2.1: + resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==} + engines: {node: '>=6'} + dev: true - environment@1.1.0: {} + /environment@1.1.0: + resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==} + engines: {node: '>=18'} + dev: true - error-ex@1.3.2: + /error-ex@1.3.4: + resolution: {integrity: sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==} dependencies: is-arrayish: 0.2.1 + dev: true - es-define-property@1.0.1: {} + /es-define-property@1.0.1: + resolution: {integrity: sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==} + engines: {node: '>= 0.4'} - es-errors@1.3.0: {} + /es-errors@1.3.0: + resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==} + engines: {node: '>= 0.4'} - es-module-lexer@1.7.0: {} + /es-module-lexer@1.7.0: + resolution: {integrity: sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==} + dev: true - es-object-atoms@1.1.1: + /es-object-atoms@1.1.1: + resolution: {integrity: sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==} + engines: {node: '>= 0.4'} dependencies: es-errors: 1.3.0 - es-set-tostringtag@2.1.0: + /es-set-tostringtag@2.1.0: + resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==} + engines: {node: '>= 0.4'} dependencies: es-errors: 1.3.0 get-intrinsic: 1.3.0 has-tostringtag: 1.0.2 hasown: 2.0.2 - es6-error@4.1.1: {} + /es6-error@4.1.1: + resolution: {integrity: sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==} + dev: true - esbuild@0.25.5: + /esbuild@0.21.5: + resolution: {integrity: sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==} + engines: {node: '>=12'} + hasBin: true + requiresBuild: true + optionalDependencies: + '@esbuild/aix-ppc64': 0.21.5 + '@esbuild/android-arm': 0.21.5 + '@esbuild/android-arm64': 0.21.5 + '@esbuild/android-x64': 0.21.5 + '@esbuild/darwin-arm64': 0.21.5 + '@esbuild/darwin-x64': 0.21.5 + '@esbuild/freebsd-arm64': 0.21.5 + '@esbuild/freebsd-x64': 0.21.5 + '@esbuild/linux-arm': 0.21.5 + '@esbuild/linux-arm64': 0.21.5 + '@esbuild/linux-ia32': 0.21.5 + '@esbuild/linux-loong64': 0.21.5 + '@esbuild/linux-mips64el': 0.21.5 + '@esbuild/linux-ppc64': 0.21.5 + '@esbuild/linux-riscv64': 0.21.5 + '@esbuild/linux-s390x': 0.21.5 + '@esbuild/linux-x64': 0.21.5 + '@esbuild/netbsd-x64': 0.21.5 + '@esbuild/openbsd-x64': 0.21.5 + '@esbuild/sunos-x64': 0.21.5 + '@esbuild/win32-arm64': 0.21.5 + '@esbuild/win32-ia32': 0.21.5 + '@esbuild/win32-x64': 0.21.5 + dev: true + + /esbuild@0.25.12: + resolution: {integrity: sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==} + engines: {node: '>=18'} + hasBin: true + requiresBuild: true + optionalDependencies: + '@esbuild/aix-ppc64': 0.25.12 + '@esbuild/android-arm': 0.25.12 + '@esbuild/android-arm64': 0.25.12 + '@esbuild/android-x64': 0.25.12 + '@esbuild/darwin-arm64': 0.25.12 + '@esbuild/darwin-x64': 0.25.12 + '@esbuild/freebsd-arm64': 0.25.12 + '@esbuild/freebsd-x64': 0.25.12 + '@esbuild/linux-arm': 0.25.12 + '@esbuild/linux-arm64': 0.25.12 + '@esbuild/linux-ia32': 0.25.12 + '@esbuild/linux-loong64': 0.25.12 + '@esbuild/linux-mips64el': 0.25.12 + '@esbuild/linux-ppc64': 0.25.12 + '@esbuild/linux-riscv64': 0.25.12 + '@esbuild/linux-s390x': 0.25.12 + '@esbuild/linux-x64': 0.25.12 + '@esbuild/netbsd-arm64': 0.25.12 + '@esbuild/netbsd-x64': 0.25.12 + '@esbuild/openbsd-arm64': 0.25.12 + '@esbuild/openbsd-x64': 0.25.12 + '@esbuild/openharmony-arm64': 0.25.12 + '@esbuild/sunos-x64': 0.25.12 + '@esbuild/win32-arm64': 0.25.12 + '@esbuild/win32-ia32': 0.25.12 + '@esbuild/win32-x64': 0.25.12 + dev: true + + /esbuild@0.27.1: + resolution: {integrity: sha512-yY35KZckJJuVVPXpvjgxiCuVEJT67F6zDeVTv4rizyPrfGBUpZQsvmxnN+C371c2esD/hNMjj4tpBhuueLN7aA==} + engines: {node: '>=18'} + hasBin: true + requiresBuild: true optionalDependencies: - '@esbuild/aix-ppc64': 0.25.5 - '@esbuild/android-arm': 0.25.5 - '@esbuild/android-arm64': 0.25.5 - '@esbuild/android-x64': 0.25.5 - '@esbuild/darwin-arm64': 0.25.5 - '@esbuild/darwin-x64': 0.25.5 - '@esbuild/freebsd-arm64': 0.25.5 - '@esbuild/freebsd-x64': 0.25.5 - '@esbuild/linux-arm': 0.25.5 - '@esbuild/linux-arm64': 0.25.5 - '@esbuild/linux-ia32': 0.25.5 - '@esbuild/linux-loong64': 0.25.5 - '@esbuild/linux-mips64el': 0.25.5 - '@esbuild/linux-ppc64': 0.25.5 - '@esbuild/linux-riscv64': 0.25.5 - '@esbuild/linux-s390x': 0.25.5 - '@esbuild/linux-x64': 0.25.5 - '@esbuild/netbsd-arm64': 0.25.5 - '@esbuild/netbsd-x64': 0.25.5 - '@esbuild/openbsd-arm64': 0.25.5 - '@esbuild/openbsd-x64': 0.25.5 - '@esbuild/sunos-x64': 0.25.5 - '@esbuild/win32-arm64': 0.25.5 - '@esbuild/win32-ia32': 0.25.5 - '@esbuild/win32-x64': 0.25.5 - - escalade@3.2.0: {} - - escape-goat@4.0.0: {} - - escape-html@1.0.3: {} - - escape-string-regexp@2.0.0: {} - - escape-string-regexp@4.0.0: {} - - escape-string-regexp@5.0.0: {} - - eslint-config-prettier@10.1.5(eslint@9.28.0(jiti@2.4.2)): - dependencies: - eslint: 9.28.0(jiti@2.4.2) - - eslint-plugin-vue@10.2.0(eslint@9.28.0(jiti@2.4.2))(vue-eslint-parser@10.1.3(eslint@9.28.0(jiti@2.4.2))): - dependencies: - '@eslint-community/eslint-utils': 4.7.0(eslint@9.28.0(jiti@2.4.2)) - eslint: 9.28.0(jiti@2.4.2) + '@esbuild/aix-ppc64': 0.27.1 + '@esbuild/android-arm': 0.27.1 + '@esbuild/android-arm64': 0.27.1 + '@esbuild/android-x64': 0.27.1 + '@esbuild/darwin-arm64': 0.27.1 + '@esbuild/darwin-x64': 0.27.1 + '@esbuild/freebsd-arm64': 0.27.1 + '@esbuild/freebsd-x64': 0.27.1 + '@esbuild/linux-arm': 0.27.1 + '@esbuild/linux-arm64': 0.27.1 + '@esbuild/linux-ia32': 0.27.1 + '@esbuild/linux-loong64': 0.27.1 + '@esbuild/linux-mips64el': 0.27.1 + '@esbuild/linux-ppc64': 0.27.1 + '@esbuild/linux-riscv64': 0.27.1 + '@esbuild/linux-s390x': 0.27.1 + '@esbuild/linux-x64': 0.27.1 + '@esbuild/netbsd-arm64': 0.27.1 + '@esbuild/netbsd-x64': 0.27.1 + '@esbuild/openbsd-arm64': 0.27.1 + '@esbuild/openbsd-x64': 0.27.1 + '@esbuild/openharmony-arm64': 0.27.1 + '@esbuild/sunos-x64': 0.27.1 + '@esbuild/win32-arm64': 0.27.1 + '@esbuild/win32-ia32': 0.27.1 + '@esbuild/win32-x64': 0.27.1 + dev: true + + /escalade@3.2.0: + resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==} + engines: {node: '>=6'} + dev: true + + /escape-goat@4.0.0: + resolution: {integrity: sha512-2Sd4ShcWxbx6OY1IHyla/CVNwvg7XwZVoXZHcSu9w9SReNP1EzzD5T8NWKIR38fIqEns9kDWKUQTXXAmlDrdPg==} + engines: {node: '>=12'} + dev: true + + /escape-html@1.0.3: + resolution: {integrity: sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==} + dev: false + + /escape-string-regexp@2.0.0: + resolution: {integrity: sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==} + engines: {node: '>=8'} + dev: true + + /escape-string-regexp@4.0.0: + resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==} + engines: {node: '>=10'} + dev: true + + /escape-string-regexp@5.0.0: + resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==} + engines: {node: '>=12'} + dev: true + + /eslint-config-prettier@10.1.8(eslint@9.39.2): + resolution: {integrity: sha512-82GZUjRS0p/jganf6q1rEO25VSoHH0hKPCTrgillPjdI/3bgBhAE1QzHrHTizjpRvy6pGAvKjDJtk2pF9NDq8w==} + hasBin: true + peerDependencies: + eslint: '>=7.0.0' + dependencies: + eslint: 9.39.2 + dev: true + + /eslint-plugin-vue@10.6.2(@typescript-eslint/parser@8.49.0)(eslint@9.39.2)(vue-eslint-parser@10.2.0): + resolution: {integrity: sha512-nA5yUs/B1KmKzvC42fyD0+l9Yd+LtEpVhWRbXuDj0e+ZURcTtyRbMDWUeJmTAh2wC6jC83raS63anNM2YT3NPw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + '@stylistic/eslint-plugin': ^2.0.0 || ^3.0.0 || ^4.0.0 || ^5.0.0 + '@typescript-eslint/parser': ^7.0.0 || ^8.0.0 + eslint: ^8.57.0 || ^9.0.0 + vue-eslint-parser: ^10.0.0 + peerDependenciesMeta: + '@stylistic/eslint-plugin': + optional: true + '@typescript-eslint/parser': + optional: true + dependencies: + '@eslint-community/eslint-utils': 4.9.0(eslint@9.39.2) + '@typescript-eslint/parser': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + eslint: 9.39.2 natural-compare: 1.4.0 nth-check: 2.1.1 - postcss-selector-parser: 6.1.2 - semver: 7.7.2 - vue-eslint-parser: 10.1.3(eslint@9.28.0(jiti@2.4.2)) + postcss-selector-parser: 7.1.1 + semver: 7.7.3 + vue-eslint-parser: 10.2.0(eslint@9.39.2) xml-name-validator: 4.0.0 + dev: true - eslint-scope@8.4.0: + /eslint-scope@8.4.0: + resolution: {integrity: sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: esrecurse: 4.3.0 estraverse: 5.3.0 + dev: true - eslint-visitor-keys@3.4.3: {} + /eslint-visitor-keys@3.4.3: + resolution: {integrity: sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==} + engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} + dev: true - eslint-visitor-keys@4.2.1: {} + /eslint-visitor-keys@4.2.1: + resolution: {integrity: sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + dev: true - eslint@9.28.0(jiti@2.4.2): + /eslint@9.39.2: + resolution: {integrity: sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + hasBin: true + peerDependencies: + jiti: '*' + peerDependenciesMeta: + jiti: + optional: true dependencies: - '@eslint-community/eslint-utils': 4.7.0(eslint@9.28.0(jiti@2.4.2)) - '@eslint-community/regexpp': 4.12.1 - '@eslint/config-array': 0.20.0 - '@eslint/config-helpers': 0.2.2 - '@eslint/core': 0.14.0 - '@eslint/eslintrc': 3.3.1 - '@eslint/js': 9.28.0 - '@eslint/plugin-kit': 0.3.1 - '@humanfs/node': 0.16.6 + '@eslint-community/eslint-utils': 4.9.0(eslint@9.39.2) + '@eslint-community/regexpp': 4.12.2 + '@eslint/config-array': 0.21.1 + '@eslint/config-helpers': 0.4.2 + '@eslint/core': 0.17.0 + '@eslint/eslintrc': 3.3.3 + '@eslint/js': 9.39.2 + '@eslint/plugin-kit': 0.4.1 + '@humanfs/node': 0.16.7 '@humanwhocodes/module-importer': 1.0.1 '@humanwhocodes/retry': 0.4.3 '@types/estree': 1.0.8 - '@types/json-schema': 7.0.15 ajv: 6.12.6 chalk: 4.1.2 cross-spawn: 7.0.6 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) escape-string-regexp: 4.0.0 eslint-scope: 8.4.0 eslint-visitor-keys: 4.2.1 @@ -6646,48 +5060,90 @@ snapshots: minimatch: 3.1.2 natural-compare: 1.4.0 optionator: 0.9.4 - optionalDependencies: - jiti: 2.4.2 transitivePeerDependencies: - supports-color + dev: true - espree@10.4.0: + /espree@10.4.0: + resolution: {integrity: sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} dependencies: acorn: 8.15.0 acorn-jsx: 5.3.2(acorn@8.15.0) eslint-visitor-keys: 4.2.1 + dev: true - esprima@4.0.1: {} + /esprima@4.0.1: + resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==} + engines: {node: '>=4'} + hasBin: true + dev: true - esquery@1.6.0: + /esquery@1.6.0: + resolution: {integrity: sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==} + engines: {node: '>=0.10'} dependencies: estraverse: 5.3.0 + dev: true - esrecurse@4.3.0: + /esrecurse@4.3.0: + resolution: {integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==} + engines: {node: '>=4.0'} dependencies: estraverse: 5.3.0 + dev: true - estraverse@5.3.0: {} + /estraverse@5.3.0: + resolution: {integrity: sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==} + engines: {node: '>=4.0'} + dev: true - estree-walker@2.0.2: {} + /estree-walker@2.0.2: + resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==} - estree-walker@3.0.3: + /estree-walker@3.0.3: + resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==} dependencies: '@types/estree': 1.0.8 + dev: true + + /esutils@2.0.3: + resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==} + engines: {node: '>=0.10.0'} + dev: true - esutils@2.0.3: {} + /etag@1.8.1: + resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==} + engines: {node: '>= 0.6'} + dev: false - etag@1.8.1: {} + /eventemitter3@5.0.1: + resolution: {integrity: sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==} + dev: true - eventemitter3@5.0.1: {} + /events-universal@1.0.1: + resolution: {integrity: sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==} + dependencies: + bare-events: 2.8.2 + transitivePeerDependencies: + - bare-abort-controller + dev: false - eventsource-parser@3.0.2: {} + /eventsource-parser@3.0.6: + resolution: {integrity: sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg==} + engines: {node: '>=18.0.0'} + dev: false - eventsource@3.0.7: + /eventsource@3.0.7: + resolution: {integrity: sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==} + engines: {node: '>=18.0.0'} dependencies: - eventsource-parser: 3.0.2 + eventsource-parser: 3.0.6 + dev: false - execa@5.1.1: + /execa@5.1.1: + resolution: {integrity: sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==} + engines: {node: '>=10'} dependencies: cross-spawn: 7.0.6 get-stream: 6.0.1 @@ -6699,19 +5155,9 @@ snapshots: signal-exit: 3.0.7 strip-final-newline: 2.0.0 - execa@7.2.0: - dependencies: - cross-spawn: 7.0.6 - get-stream: 6.0.1 - human-signals: 4.3.1 - is-stream: 3.0.0 - merge-stream: 2.0.0 - npm-run-path: 5.3.0 - onetime: 6.0.0 - signal-exit: 3.0.7 - strip-final-newline: 3.0.0 - - execa@8.0.1: + /execa@8.0.1: + resolution: {integrity: sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==} + engines: {node: '>=16.17'} dependencies: cross-spawn: 7.0.6 get-stream: 8.0.1 @@ -6722,40 +5168,63 @@ snapshots: onetime: 6.0.0 signal-exit: 4.1.0 strip-final-newline: 3.0.0 + dev: true - exit@0.1.2: {} + /exit@0.1.2: + resolution: {integrity: sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==} + engines: {node: '>= 0.8.0'} + dev: true + + /expand-template@2.0.3: + resolution: {integrity: sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==} + engines: {node: '>=6'} + dev: false - expand-template@2.0.3: {} + /expect-type@1.3.0: + resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==} + engines: {node: '>=12.0.0'} + dev: true - expect@29.7.0: + /expect@29.7.0: + resolution: {integrity: sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/expect-utils': 29.7.0 jest-get-type: 29.6.3 jest-matcher-utils: 29.7.0 jest-message-util: 29.7.0 jest-util: 29.7.0 + dev: true - express-rate-limit@7.5.0(express@5.1.0): + /express-rate-limit@7.5.1(express@5.2.1): + resolution: {integrity: sha512-7iN8iPMDzOMHPUYllBEsQdWVB6fPDMPqwjBaFrgr4Jgr/+okjvzAy+UHlYYL/Vs0OsOrMkwS6PJDkFlJwoxUnw==} + engines: {node: '>= 16'} + peerDependencies: + express: '>= 4.11' dependencies: - express: 5.1.0 + express: 5.2.1 + dev: false - express@5.1.0: + /express@5.2.1: + resolution: {integrity: sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==} + engines: {node: '>= 18'} dependencies: accepts: 2.0.0 - body-parser: 2.2.0 - content-disposition: 1.0.0 + body-parser: 2.2.1 + content-disposition: 1.0.1 content-type: 1.0.5 cookie: 0.7.2 cookie-signature: 1.2.2 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) + depd: 2.0.0 encodeurl: 2.0.0 escape-html: 1.0.3 etag: 1.8.1 - finalhandler: 2.1.0 + finalhandler: 2.1.1 fresh: 2.0.0 - http-errors: 2.0.0 + http-errors: 2.0.1 merge-descriptors: 2.0.0 - mime-types: 3.0.1 + mime-types: 3.0.2 on-finished: 2.4.1 once: 1.4.0 parseurl: 1.3.3 @@ -6770,111 +5239,155 @@ snapshots: vary: 1.1.2 transitivePeerDependencies: - supports-color + dev: false - exsolve@1.0.5: {} + /exsolve@1.0.8: + resolution: {integrity: sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==} + dev: true - extract-zip@2.0.1: - dependencies: - debug: 4.4.1(supports-color@5.5.0) - get-stream: 5.2.0 - yauzl: 2.10.0 - optionalDependencies: - '@types/yauzl': 2.10.3 - transitivePeerDependencies: - - supports-color + /fake-indexeddb@6.2.5: + resolution: {integrity: sha512-CGnyrvbhPlWYMngksqrSSUT1BAVP49dZocrHuK0SvtR0D5TMs5wP0o3j7jexDJW01KSadjBp1M/71o/KR3nD1w==} + engines: {node: '>=18'} + dev: true - fast-copy@3.0.2: {} + /fast-copy@4.0.1: + resolution: {integrity: sha512-+uUOQlhsaswsizHFmEFAQhB3lSiQ+lisxl50N6ZP0wywlZeWsIESxSi9ftPEps8UGfiBzyYP7x27zA674WUvXw==} + dev: true - fast-decode-uri-component@1.0.1: {} + /fast-decode-uri-component@1.0.1: + resolution: {integrity: sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==} + dev: false - fast-deep-equal@3.1.3: {} + /fast-deep-equal@3.1.3: + resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==} - fast-fifo@1.3.2: {} + /fast-fifo@1.3.2: + resolution: {integrity: sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==} + dev: false - fast-glob@3.3.3: + /fast-glob@3.3.3: + resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==} + engines: {node: '>=8.6.0'} dependencies: '@nodelib/fs.stat': 2.0.5 '@nodelib/fs.walk': 1.2.8 glob-parent: 5.1.2 merge2: 1.4.1 micromatch: 4.0.8 + dev: true - fast-json-stable-stringify@2.1.0: {} + /fast-json-stable-stringify@2.1.0: + resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==} + dev: true - fast-json-stringify@6.0.1: + /fast-json-stringify@6.1.1: + resolution: {integrity: sha512-DbgptncYEXZqDUOEl4krff4mUiVrTZZVI7BBrQR/T3BqMj/eM1flTC1Uk2uUoLcWCxjT95xKulV/Lc6hhOZsBQ==} dependencies: '@fastify/merge-json-schemas': 0.2.1 ajv: 8.17.1 ajv-formats: 3.0.1(ajv@8.17.1) - fast-uri: 3.0.6 - json-schema-ref-resolver: 2.0.1 + fast-uri: 3.1.0 + json-schema-ref-resolver: 3.0.0 rfdc: 1.4.1 + dev: false - fast-levenshtein@2.0.6: {} + /fast-levenshtein@2.0.6: + resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==} + dev: true - fast-querystring@1.1.2: + /fast-querystring@1.1.2: + resolution: {integrity: sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg==} dependencies: fast-decode-uri-component: 1.0.1 + dev: false - fast-redact@3.5.0: {} + /fast-redact@3.5.0: + resolution: {integrity: sha512-dwsoQlS7h9hMeYUq1W++23NDcBLV4KqONnITDV9DjfS3q1SgDGVrBdvvTLUotWtPSD7asWDV9/CmsZPy8Hf70A==} + engines: {node: '>=6'} + dev: true - fast-safe-stringify@2.1.1: {} + /fast-safe-stringify@2.1.1: + resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==} + dev: true - fast-uri@3.0.6: {} + /fast-uri@3.1.0: + resolution: {integrity: sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==} - fastify-plugin@5.0.1: {} + /fastify-plugin@5.1.0: + resolution: {integrity: sha512-FAIDA8eovSt5qcDgcBvDuX/v0Cjz0ohGhENZ/wpc3y+oZCY2afZ9Baqql3g/lC+OHRnciQol4ww7tuthOb9idw==} + dev: false - fastify@5.3.3: + /fastify@5.6.2: + resolution: {integrity: sha512-dPugdGnsvYkBlENLhCgX8yhyGCsCPrpA8lFWbTNU428l+YOnLgYHR69hzV8HWPC79n536EqzqQtvhtdaCE0dKg==} dependencies: - '@fastify/ajv-compiler': 4.0.2 + '@fastify/ajv-compiler': 4.0.5 '@fastify/error': 4.2.0 '@fastify/fast-json-stringify-compiler': 5.0.3 - '@fastify/proxy-addr': 5.0.0 + '@fastify/proxy-addr': 5.1.0 abstract-logging: 2.0.1 avvio: 9.1.0 - fast-json-stringify: 6.0.1 + fast-json-stringify: 6.1.1 find-my-way: 9.3.0 light-my-request: 6.6.0 - pino: 9.7.0 + pino: 10.1.0 process-warning: 5.0.0 rfdc: 1.4.1 - secure-json-parse: 4.0.0 - semver: 7.7.2 + secure-json-parse: 4.1.0 + semver: 7.7.3 toad-cache: 3.7.0 + dev: false - fastq@1.19.1: + /fastq@1.19.1: + resolution: {integrity: sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==} dependencies: reusify: 1.1.0 - fb-watchman@2.0.2: + /fb-watchman@2.0.2: + resolution: {integrity: sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==} dependencies: bser: 2.1.1 + dev: true - fd-slicer@1.1.0: + /fdir@6.5.0(picomatch@4.0.3): + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true dependencies: - pend: 1.2.0 - - fdir@6.4.5(picomatch@4.0.2): - optionalDependencies: - picomatch: 4.0.2 + picomatch: 4.0.3 + dev: true - file-entry-cache@8.0.0: + /file-entry-cache@8.0.0: + resolution: {integrity: sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==} + engines: {node: '>=16.0.0'} dependencies: flat-cache: 4.0.1 + dev: true - filelist@1.0.4: - dependencies: - minimatch: 5.1.6 + /file-uri-to-path@1.0.0: + resolution: {integrity: sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==} + dev: false - filesize@10.1.6: {} + /filesize@11.0.13: + resolution: {integrity: sha512-mYJ/qXKvREuO0uH8LTQJ6v7GsUvVOguqxg2VTwQUkyTPXXRRWPdjuUPVqdBrJQhvci48OHlNGRnux+Slr2Rnvw==} + engines: {node: '>= 10.8.0'} + dev: true - fill-range@7.1.1: + /fill-range@7.1.1: + resolution: {integrity: sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==} + engines: {node: '>=8'} dependencies: to-regex-range: 5.0.1 + dev: true - finalhandler@2.1.0: + /finalhandler@2.1.1: + resolution: {integrity: sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==} + engines: {node: '>= 18.0.0'} dependencies: - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) encodeurl: 2.0.0 escape-html: 1.0.3 on-finished: 2.4.1 @@ -6882,66 +5395,94 @@ snapshots: statuses: 2.0.2 transitivePeerDependencies: - supports-color + dev: false - find-my-way@9.3.0: + /find-my-way@9.3.0: + resolution: {integrity: sha512-eRoFWQw+Yv2tuYlK2pjFS2jGXSxSppAs3hSQjfxVKxM5amECzIgYYc1FEI8ZmhSh/Ig+FrKEz43NLRKJjYCZVg==} + engines: {node: '>=20'} dependencies: fast-deep-equal: 3.1.3 fast-querystring: 1.1.2 safe-regex2: 5.0.0 + dev: false - find-up@4.1.0: + /find-up@4.1.0: + resolution: {integrity: sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==} + engines: {node: '>=8'} dependencies: locate-path: 5.0.0 path-exists: 4.0.0 + dev: true - find-up@5.0.0: + /find-up@5.0.0: + resolution: {integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==} + engines: {node: '>=10'} dependencies: locate-path: 6.0.0 path-exists: 4.0.0 + dev: true - find-up@7.0.0: + /find-up@7.0.0: + resolution: {integrity: sha512-YyZM99iHrqLKjmt4LJDj58KI+fYyufRLBSYcqycxf//KpBk9FoewoGX0450m9nB44qrZnovzC2oeP5hUibxc/g==} + engines: {node: '>=18'} dependencies: locate-path: 7.2.0 path-exists: 5.0.0 unicorn-magic: 0.1.0 + dev: true - firefox-profile@4.7.0: + /firefox-profile@4.7.0: + resolution: {integrity: sha512-aGApEu5bfCNbA4PGUZiRJAIU6jKmghV2UVdklXAofnNtiDjqYw0czLS46W7IfFqVKgKhFB8Ao2YoNGHY4BoIMQ==} + engines: {node: '>=18'} + hasBin: true dependencies: adm-zip: 0.5.16 - fs-extra: 11.3.0 + fs-extra: 11.3.2 ini: 4.1.3 minimist: 1.2.8 xml2js: 0.6.2 + dev: true - fix-dts-default-cjs-exports@1.0.1: + /fix-dts-default-cjs-exports@1.0.1: + resolution: {integrity: sha512-pVIECanWFC61Hzl2+oOCtoJ3F17kglZC/6N94eRWycFgBH35hHx0Li604ZIzhseh97mf2p0cv7vVrOZGoqhlEg==} dependencies: - magic-string: 0.30.17 - mlly: 1.7.4 - rollup: 4.42.0 + magic-string: 0.30.21 + mlly: 1.8.0 + rollup: 4.53.3 + dev: true - flat-cache@4.0.1: + /flat-cache@4.0.1: + resolution: {integrity: sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==} + engines: {node: '>=16'} dependencies: flatted: 3.3.3 keyv: 4.5.4 + dev: true - flatbuffers@1.12.0: {} + /flatbuffers@1.12.0: + resolution: {integrity: sha512-c7CZADjRcl6j0PlvFy0ZqXQ67qSEZfrVPynmnL+2zPc+NtMvrF8Y0QceMo7QqnSPc7+uWjUIAbvCQ5WIKlMVdQ==} + dev: false - flatted@3.3.3: {} + /flatted@3.3.3: + resolution: {integrity: sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==} + dev: true - foreground-child@3.3.1: + /foreground-child@3.3.1: + resolution: {integrity: sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==} + engines: {node: '>=14'} dependencies: cross-spawn: 7.0.6 signal-exit: 4.1.0 + dev: true - form-data@4.0.3: - dependencies: - asynckit: 0.4.0 - combined-stream: 1.0.8 - es-set-tostringtag: 2.1.0 - hasown: 2.0.2 - mime-types: 2.1.35 + /form-data-encoder@4.1.0: + resolution: {integrity: sha512-G6NsmEW15s0Uw9XnCg+33H3ViYRyiM0hMrMhhqQOR8NFc5GhYrI+6I3u7OTw7b91J2g8rtvMBZJDbcGb2YUniw==} + engines: {node: '>= 18'} + dev: true - form-data@4.0.4: + /form-data@4.0.5: + resolution: {integrity: sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==} + engines: {node: '>= 6'} dependencies: asynckit: 0.4.0 combined-stream: 1.0.8 @@ -6949,34 +5490,61 @@ snapshots: hasown: 2.0.2 mime-types: 2.1.35 - formdata-node@6.0.3: {} + /formdata-node@6.0.3: + resolution: {integrity: sha512-8e1++BCiTzUno9v5IZ2J6bv4RU+3UKDmqWUQD0MIMVCd9AdhWkO1gw57oo1mNEX1dMq2EGI+FbWz4B92pscSQg==} + engines: {node: '>= 18'} + dev: true - formidable@3.5.4: + /formidable@3.5.4: + resolution: {integrity: sha512-YikH+7CUTOtP44ZTnUhR7Ic2UASBPOqmaRkRKxRbywPTe5VxF7RRCck4af9wutiZ/QKM5nME9Bie2fFaPz5Gug==} + engines: {node: '>=14.0.0'} dependencies: - '@paralleldrive/cuid2': 2.2.2 + '@paralleldrive/cuid2': 2.3.1 dezalgo: 1.0.4 once: 1.4.0 + dev: true - forwarded@0.2.0: {} + /forwarded@0.2.0: + resolution: {integrity: sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==} + engines: {node: '>= 0.6'} + dev: false - fresh@2.0.0: {} + /fresh@2.0.0: + resolution: {integrity: sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==} + engines: {node: '>= 0.8'} + dev: false - fs-constants@1.0.0: {} + /fs-constants@1.0.0: + resolution: {integrity: sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==} + dev: false - fs-extra@11.3.0: + /fs-extra@11.3.2: + resolution: {integrity: sha512-Xr9F6z6up6Ws+NjzMCZc6WXg2YFRlrLP9NQDO3VQrWrfiojdhS56TzueT88ze0uBdCTwEIhQ3ptnmKeWGFAe0A==} + engines: {node: '>=14.14'} dependencies: graceful-fs: 4.2.11 - jsonfile: 6.1.0 + jsonfile: 6.2.0 universalify: 2.0.1 + dev: true - fs.realpath@1.0.0: {} + /fs.realpath@1.0.0: + resolution: {integrity: sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==} + dev: true - fsevents@2.3.3: + /fsevents@2.3.3: + resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + requiresBuild: true + dev: true optional: true - function-bind@1.1.2: {} + /function-bind@1.1.2: + resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==} - fx-runner@1.4.0: + /fx-runner@1.4.0: + resolution: {integrity: sha512-rci1g6U0rdTg6bAaBboP7XdRu01dzTAaKXxFf+PUqGuCv6Xu7o8NZdY1D5MvKGIjb6EdS1g3VlXOgksir1uGkg==} + hasBin: true dependencies: commander: 2.9.0 shell-quote: 1.7.3 @@ -6984,14 +5552,26 @@ snapshots: when: 3.7.7 which: 1.2.4 winreg: 0.0.12 + dev: true - gensync@1.0.0-beta.2: {} + /gensync@1.0.0-beta.2: + resolution: {integrity: sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==} + engines: {node: '>=6.9.0'} + dev: true - get-caller-file@2.0.5: {} + /get-caller-file@2.0.5: + resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==} + engines: {node: 6.* || 8.* || >= 10.*} + dev: true - get-east-asian-width@1.3.0: {} + /get-east-asian-width@1.4.0: + resolution: {integrity: sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q==} + engines: {node: '>=18'} + dev: true - get-intrinsic@1.3.0: + /get-intrinsic@1.3.0: + resolution: {integrity: sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==} + engines: {node: '>= 0.4'} dependencies: call-bind-apply-helpers: 1.0.2 es-define-property: 1.0.1 @@ -7004,51 +5584,82 @@ snapshots: hasown: 2.0.2 math-intrinsics: 1.1.0 - get-package-type@0.1.0: {} + /get-package-type@0.1.0: + resolution: {integrity: sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==} + engines: {node: '>=8.0.0'} + dev: true - get-port-please@3.1.2: {} + /get-port-please@3.2.0: + resolution: {integrity: sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==} + dev: true - get-proto@1.0.1: + /get-proto@1.0.1: + resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==} + engines: {node: '>= 0.4'} dependencies: dunder-proto: 1.0.1 es-object-atoms: 1.1.1 - get-stream@5.2.0: - dependencies: - pump: 3.0.2 + /get-stream@6.0.1: + resolution: {integrity: sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==} + engines: {node: '>=10'} - get-stream@6.0.1: {} + /get-stream@8.0.1: + resolution: {integrity: sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==} + engines: {node: '>=16'} + dev: true - get-stream@8.0.1: {} + /gifenc@1.0.3: + resolution: {integrity: sha512-xdr6AdrfGBcfzncONUOlXMBuc5wJDtOueE3c5rdG0oNgtINLD+f2iFZltrBRZYzACRbKr+mSVU/x98zv2u3jmw==} + dev: false - giget@2.0.0: + /giget@2.0.0: + resolution: {integrity: sha512-L5bGsVkxJbJgdnwyuheIunkGatUF/zssUoxxjACCseZYAVbaqdh9Tsmmlkl8vYan09H7sbvKt4pS8GqKLBrEzA==} + hasBin: true dependencies: citty: 0.1.6 consola: 3.4.2 defu: 6.1.4 - node-fetch-native: 1.6.6 - nypm: 0.6.0 + node-fetch-native: 1.6.7 + nypm: 0.6.2 pathe: 2.0.3 + dev: true - git-raw-commits@4.0.0: + /git-raw-commits@4.0.0: + resolution: {integrity: sha512-ICsMM1Wk8xSGMowkOmPrzo2Fgmfo4bMHLNX6ytHjajRJUqvHOw/TFapQ+QG75c3X/tTDDhOSRPGC52dDbNM8FQ==} + engines: {node: '>=16'} + hasBin: true dependencies: dargs: 8.1.0 meow: 12.1.1 split2: 4.2.0 + dev: true - github-from-package@0.0.0: {} + /github-from-package@0.0.0: + resolution: {integrity: sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==} + dev: false - glob-parent@5.1.2: + /glob-parent@5.1.2: + resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==} + engines: {node: '>= 6'} dependencies: is-glob: 4.0.3 + dev: true - glob-parent@6.0.2: + /glob-parent@6.0.2: + resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==} + engines: {node: '>=10.13.0'} dependencies: is-glob: 4.0.3 + dev: true - glob-to-regexp@0.4.1: {} + /glob-to-regexp@0.4.1: + resolution: {integrity: sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==} + dev: true - glob@10.4.5: + /glob@10.5.0: + resolution: {integrity: sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==} + hasBin: true dependencies: foreground-child: 3.3.1 jackspeak: 3.4.3 @@ -7056,17 +5667,20 @@ snapshots: minipass: 7.1.2 package-json-from-dist: 1.0.1 path-scurry: 1.11.1 + dev: true - glob@11.0.2: + /glob@13.0.0: + resolution: {integrity: sha512-tvZgpqk6fz4BaNZ66ZsRaZnbHvP/jG3uKJvAZOwEVUL4RTA5nJeeLYfyN9/VA8NX/V3IBG+hkeuGpKjvELkVhA==} + engines: {node: 20 || >=22} dependencies: - foreground-child: 3.3.1 - jackspeak: 4.1.1 - minimatch: 10.0.1 + minimatch: 10.1.1 minipass: 7.1.2 - package-json-from-dist: 1.0.1 - path-scurry: 2.0.0 + path-scurry: 2.0.1 + dev: true - glob@7.2.3: + /glob@7.2.3: + resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==} + deprecated: Glob versions prior to v9 are no longer supported dependencies: fs.realpath: 1.0.0 inflight: 1.0.6 @@ -7074,302 +5688,573 @@ snapshots: minimatch: 3.1.2 once: 1.4.0 path-is-absolute: 1.0.1 + dev: true - global-directory@4.0.1: + /global-directory@4.0.1: + resolution: {integrity: sha512-wHTUcDUoZ1H5/0iVqEudYW4/kAlN5cZ3j/bXn0Dpbizl9iaUVeWSHqiOjsgk6OW2bkLclbBjzewBz6weQ1zA2Q==} + engines: {node: '>=18'} dependencies: ini: 4.1.1 + dev: true - globals@11.12.0: {} + /globals@14.0.0: + resolution: {integrity: sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==} + engines: {node: '>=18'} + dev: true - globals@14.0.0: {} + /globals@15.15.0: + resolution: {integrity: sha512-7ACyT3wmyp3I61S4fG682L0VA2RGD9otkqGJIwNUMF1SWUombIIk+af1unuDYgMm082aHYwD+mzJvv9Iu8dsgg==} + engines: {node: '>=18'} + dev: true - globals@16.2.0: {} + /globals@16.5.0: + resolution: {integrity: sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==} + engines: {node: '>=18'} + dev: true - gopd@1.2.0: {} + /gopd@1.2.0: + resolution: {integrity: sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==} + engines: {node: '>= 0.4'} - graceful-fs@4.2.10: {} + /graceful-fs@4.2.10: + resolution: {integrity: sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==} + dev: true - graceful-fs@4.2.11: {} + /graceful-fs@4.2.11: + resolution: {integrity: sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==} + dev: true - graceful-readlink@1.0.1: {} + /graceful-readlink@1.0.1: + resolution: {integrity: sha512-8tLu60LgxF6XpdbK8OW3FA+IfTNBn1ZHGHKF4KQbEeSkajYw5PlYJcKluntgegDPTg8UkHjpet1T82vk6TQ68w==} + dev: true - graphemer@1.4.0: {} + /growly@1.3.0: + resolution: {integrity: sha512-+xGQY0YyAWCnqy7Cd++hc2JqMYzlm0dG30Jd0beaA64sROr8C4nt8Yc9V5Ro3avlSUDTN0ulqP/VBKi1/lLygw==} + dev: true - growly@1.3.0: {} + /guid-typescript@1.0.9: + resolution: {integrity: sha512-Y8T4vYhEfwJOTbouREvG+3XDsjr8E3kIr7uf+JZ0BYloFsttiHU0WfvANVsR7TxNUJa/WpCnw/Ino/p+DeBhBQ==} + dev: false - guid-typescript@1.0.9: {} + /handlebars@4.7.8: + resolution: {integrity: sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==} + engines: {node: '>=0.4.7'} + hasBin: true + dependencies: + minimist: 1.2.8 + neo-async: 2.6.2 + source-map: 0.6.1 + wordwrap: 1.0.0 + optionalDependencies: + uglify-js: 3.19.3 + dev: true - has-flag@3.0.0: {} + /has-flag@3.0.0: + resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==} + engines: {node: '>=4'} - has-flag@4.0.0: {} + /has-flag@4.0.0: + resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==} + engines: {node: '>=8'} + dev: true - has-symbols@1.1.0: {} + /has-symbols@1.1.0: + resolution: {integrity: sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==} + engines: {node: '>= 0.4'} - has-tostringtag@1.0.2: + /has-tostringtag@1.0.2: + resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==} + engines: {node: '>= 0.4'} dependencies: has-symbols: 1.1.0 - hasown@2.0.2: + /hasown@2.0.2: + resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==} + engines: {node: '>= 0.4'} dependencies: function-bind: 1.1.2 - he@1.2.0: {} + /he@1.2.0: + resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==} + hasBin: true + dev: true - help-me@5.0.0: {} + /help-me@5.0.0: + resolution: {integrity: sha512-7xgomUX6ADmcYzFik0HzAxh/73YlKR9bmFzf51CZwR+b6YtzU2m0u49hQCqV6SvlqIqsaxovfwdvbnsw3b/zpg==} + dev: true - highlight.js@10.7.3: {} + /hnswlib-wasm-static@0.8.5: + resolution: {integrity: sha512-jhmkHoCK6qvsiziwHmIZ5ujg9LrBnVmvgHw70Gm4k3nwnXlD8nHEQIHIQBgTD7scsHnmAvQLPm/wmC6ylPHGNQ==} + dev: false - hnswlib-wasm-static@0.8.5: {} + /hookable@5.5.3: + resolution: {integrity: sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ==} + dev: true - hookable@5.5.3: {} + /html-encoding-sniffer@4.0.0: + resolution: {integrity: sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==} + engines: {node: '>=18'} + dependencies: + whatwg-encoding: 3.1.1 + dev: true - html-escaper@2.0.2: {} + /html-escaper@2.0.2: + resolution: {integrity: sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==} + dev: true - html-escaper@3.0.3: {} + /html-escaper@3.0.3: + resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==} + dev: true - htmlparser2@10.0.0: + /htmlparser2@10.0.0: + resolution: {integrity: sha512-TwAZM+zE5Tq3lrEHvOlvwgj1XLWQCtaaibSN11Q+gGBAS7Y1uZSWwXXRe4iF6OXnaq1riyQAPFOBtYc77Mxq0g==} dependencies: domelementtype: 2.3.0 domhandler: 5.0.3 domutils: 3.2.2 entities: 6.0.1 + dev: true - http-errors@2.0.0: + /http-errors@2.0.1: + resolution: {integrity: sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==} + engines: {node: '>= 0.8'} dependencies: depd: 2.0.0 inherits: 2.0.4 setprototypeof: 1.2.0 - statuses: 2.0.1 + statuses: 2.0.2 toidentifier: 1.0.1 + dev: false + + /http-proxy-agent@7.0.2: + resolution: {integrity: sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==} + engines: {node: '>= 14'} + dependencies: + agent-base: 7.1.4 + debug: 4.4.3(supports-color@5.5.0) + transitivePeerDependencies: + - supports-color + dev: true - human-signals@2.1.0: {} + /https-proxy-agent@7.0.6: + resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==} + engines: {node: '>= 14'} + dependencies: + agent-base: 7.1.4 + debug: 4.4.3(supports-color@5.5.0) + transitivePeerDependencies: + - supports-color + dev: true + + /human-signals@2.1.0: + resolution: {integrity: sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==} + engines: {node: '>=10.17.0'} - human-signals@4.3.1: {} + /human-signals@5.0.0: + resolution: {integrity: sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==} + engines: {node: '>=16.17.0'} + dev: true - human-signals@5.0.0: {} + /husky@9.1.7: + resolution: {integrity: sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==} + engines: {node: '>=18'} + hasBin: true + dev: true - husky@9.1.7: {} + /iconv-lite@0.6.3: + resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==} + engines: {node: '>=0.10.0'} + dependencies: + safer-buffer: 2.1.2 + dev: true - iconv-lite@0.6.3: + /iconv-lite@0.7.1: + resolution: {integrity: sha512-2Tth85cXwGFHfvRgZWszZSvdo+0Xsqmw8k8ZwxScfcBneNUraK+dxRxRm24nszx80Y0TVio8kKLt5sLE7ZCLlw==} + engines: {node: '>=0.10.0'} dependencies: safer-buffer: 2.1.2 + dev: false - ieee754@1.2.1: {} + /ieee754@1.2.1: + resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==} + dev: false - ignore-by-default@1.0.1: {} + /ignore-by-default@1.0.1: + resolution: {integrity: sha512-Ius2VYcGNk7T90CppJqcIkS5ooHUZyIQK+ClZfMfMNFEF9VSE73Fq+906u/CWu92x4gzZMWOwfFYckPObzdEbA==} + dev: true - ignore@5.3.2: {} + /ignore@5.3.2: + resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==} + engines: {node: '>= 4'} + dev: true - ignore@7.0.5: {} + /ignore@7.0.5: + resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==} + engines: {node: '>= 4'} + dev: true - immediate@3.0.6: {} + /immediate@3.0.6: + resolution: {integrity: sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==} + dev: true - import-fresh@3.3.1: + /import-fresh@3.3.1: + resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==} + engines: {node: '>=6'} dependencies: parent-module: 1.0.1 resolve-from: 4.0.0 + dev: true - import-local@3.2.0: + /import-local@3.2.0: + resolution: {integrity: sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==} + engines: {node: '>=8'} + hasBin: true dependencies: pkg-dir: 4.2.0 resolve-cwd: 3.0.0 + dev: true - import-meta-resolve@4.1.0: {} + /import-meta-resolve@4.2.0: + resolution: {integrity: sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==} + dev: true - imurmurhash@0.1.4: {} + /imurmurhash@0.1.4: + resolution: {integrity: sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==} + engines: {node: '>=0.8.19'} + dev: true - inflight@1.0.6: + /inflight@1.0.6: + resolution: {integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==} + deprecated: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful. dependencies: once: 1.4.0 wrappy: 1.0.2 + dev: true - inherits@2.0.4: {} + /inherits@2.0.4: + resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==} - ini@1.3.8: {} + /ini@1.3.8: + resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==} - ini@4.1.1: {} + /ini@4.1.1: + resolution: {integrity: sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==} + engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} + dev: true - ini@4.1.3: {} + /ini@4.1.3: + resolution: {integrity: sha512-X7rqawQBvfdjS10YU1y1YVreA3SsLrW9dX2CewP2EbBJM4ypVNLDkO5y04gejPwKIY9lR+7r9gn3rFPt/kmWFg==} + engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} + dev: true - ipaddr.js@1.9.1: {} + /ipaddr.js@1.9.1: + resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==} + engines: {node: '>= 0.10'} + dev: false - ipaddr.js@2.2.0: {} + /ipaddr.js@2.3.0: + resolution: {integrity: sha512-Zv/pA+ciVFbCSBBjGfaKUya/CcGmUHzTydLMaTwrUUEM2DIEO3iZvueGxmacvmN50fGpGVKeTXpb2LcYQxeVdg==} + engines: {node: '>= 10'} + dev: false - is-absolute@0.1.7: + /is-absolute@0.1.7: + resolution: {integrity: sha512-Xi9/ZSn4NFapG8RP98iNPMOeaV3mXPisxKxzKtHVqr3g56j/fBn+yZmnxSVAA8lmZbl2J9b/a4kJvfU3hqQYgA==} + engines: {node: '>=0.10.0'} dependencies: is-relative: 0.1.3 + dev: true - is-admin@4.0.0: + /is-admin@4.0.0: + resolution: {integrity: sha512-ODl+ygFCyHXMauhn+0mBebcwO1tiB+b4FoBiIC97gFDcmdO3JMD+YmIhSA8+1KVZuGwfsX8ANo2yblgW5KUPTg==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: execa: 5.1.1 + dev: false - is-arrayish@0.2.1: {} + /is-arrayish@0.2.1: + resolution: {integrity: sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==} + dev: true - is-arrayish@0.3.2: {} + /is-arrayish@0.3.4: + resolution: {integrity: sha512-m6UrgzFVUYawGBh1dUsWR5M2Clqic9RVXC/9f8ceNlv2IcO9j9J/z8UoCLPqtsPBFNzEpfR3xftohbfqDx8EQA==} + dev: false - is-binary-path@2.1.0: + /is-binary-path@2.1.0: + resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==} + engines: {node: '>=8'} dependencies: binary-extensions: 2.3.0 + dev: true - is-core-module@2.16.1: + /is-core-module@2.16.1: + resolution: {integrity: sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==} + engines: {node: '>= 0.4'} dependencies: hasown: 2.0.2 + dev: true - is-docker@2.2.1: {} + /is-docker@2.2.1: + resolution: {integrity: sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==} + engines: {node: '>=8'} + hasBin: true + dev: true - is-docker@3.0.0: {} + /is-docker@3.0.0: + resolution: {integrity: sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + hasBin: true + dev: true - is-extglob@2.1.1: {} + /is-extglob@2.1.1: + resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==} + engines: {node: '>=0.10.0'} + dev: true - is-fullwidth-code-point@3.0.0: {} + /is-fullwidth-code-point@3.0.0: + resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==} + engines: {node: '>=8'} + dev: true - is-fullwidth-code-point@4.0.0: {} + /is-fullwidth-code-point@4.0.0: + resolution: {integrity: sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==} + engines: {node: '>=12'} + dev: true - is-fullwidth-code-point@5.0.0: + /is-fullwidth-code-point@5.1.0: + resolution: {integrity: sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==} + engines: {node: '>=18'} dependencies: - get-east-asian-width: 1.3.0 + get-east-asian-width: 1.4.0 + dev: true - is-generator-fn@2.1.0: {} + /is-generator-fn@2.1.0: + resolution: {integrity: sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==} + engines: {node: '>=6'} + dev: true - is-glob@4.0.3: + /is-glob@4.0.3: + resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==} + engines: {node: '>=0.10.0'} dependencies: is-extglob: 2.1.1 + dev: true - is-in-ci@1.0.0: {} + /is-in-ci@1.0.0: + resolution: {integrity: sha512-eUuAjybVTHMYWm/U+vBO1sY/JOCgoPCXRxzdju0K+K0BiGW0SChEL1MLC0PoCIR1OlPo5YAp8HuQoUlsWEICwg==} + engines: {node: '>=18'} + hasBin: true + dev: true - is-inside-container@1.0.0: + /is-inside-container@1.0.0: + resolution: {integrity: sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==} + engines: {node: '>=14.16'} + hasBin: true dependencies: is-docker: 3.0.0 + dev: true - is-installed-globally@1.0.0: + /is-installed-globally@1.0.0: + resolution: {integrity: sha512-K55T22lfpQ63N4KEN57jZUAaAYqYHEe8veb/TycJRk9DdSCLLcovXz/mL6mOnhQaZsQGwPhuFopdQIlqGSEjiQ==} + engines: {node: '>=18'} dependencies: global-directory: 4.0.1 is-path-inside: 4.0.0 + dev: true - is-interactive@2.0.0: {} + /is-interactive@2.0.0: + resolution: {integrity: sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ==} + engines: {node: '>=12'} + dev: true - is-npm@6.0.0: {} + /is-npm@6.1.0: + resolution: {integrity: sha512-O2z4/kNgyjhQwVR1Wpkbfc19JIhggF97NZNCpWTnjH7kVcZMUrnut9XSN7txI7VdyIYk5ZatOq3zvSuWpU8hoA==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - is-number@7.0.0: {} + /is-number@7.0.0: + resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==} + engines: {node: '>=0.12.0'} + dev: true - is-obj@2.0.0: {} + /is-obj@2.0.0: + resolution: {integrity: sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==} + engines: {node: '>=8'} + dev: true - is-path-inside@4.0.0: {} + /is-path-inside@4.0.0: + resolution: {integrity: sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==} + engines: {node: '>=12'} + dev: true - is-plain-object@2.0.4: + /is-plain-object@2.0.4: + resolution: {integrity: sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==} + engines: {node: '>=0.10.0'} dependencies: isobject: 3.0.1 + dev: true - is-potential-custom-element-name@1.0.1: {} + /is-potential-custom-element-name@1.0.1: + resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==} + dev: true - is-primitive@3.0.1: {} + /is-primitive@3.0.1: + resolution: {integrity: sha512-GljRxhWvlCNRfZyORiH77FwdFwGcMO620o37EOYC0ORWdq+WYNVqW0w2Juzew4M+L81l6/QS3t5gkkihyRqv9w==} + engines: {node: '>=0.10.0'} + dev: true - is-promise@4.0.0: {} + /is-promise@4.0.0: + resolution: {integrity: sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==} + dev: false - is-relative@0.1.3: {} + /is-relative@0.1.3: + resolution: {integrity: sha512-wBOr+rNM4gkAZqoLRJI4myw5WzzIdQosFAAbnvfXP5z1LyzgAI3ivOKehC5KfqlQJZoihVhirgtCBj378Eg8GA==} + engines: {node: '>=0.10.0'} + dev: true - is-stream@2.0.1: {} + /is-stream@2.0.1: + resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==} + engines: {node: '>=8'} - is-stream@3.0.0: {} + /is-stream@3.0.0: + resolution: {integrity: sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - is-text-path@2.0.0: + /is-text-path@2.0.0: + resolution: {integrity: sha512-+oDTluR6WEjdXEJMnC2z6A4FRwFoYuvShVVEGsS7ewc0UTi2QtAKMDJuL4BDEVt+5T7MjFo12RP8ghOM75oKJw==} + engines: {node: '>=8'} dependencies: text-extensions: 2.4.0 + dev: true - is-unicode-supported@1.3.0: {} + /is-unicode-supported@1.3.0: + resolution: {integrity: sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ==} + engines: {node: '>=12'} + dev: true - is-unicode-supported@2.1.0: {} + /is-unicode-supported@2.1.0: + resolution: {integrity: sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==} + engines: {node: '>=18'} + dev: true - is-wsl@2.2.0: + /is-wsl@2.2.0: + resolution: {integrity: sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==} + engines: {node: '>=8'} dependencies: is-docker: 2.2.1 + dev: true - is-wsl@3.1.0: + /is-wsl@3.1.0: + resolution: {integrity: sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==} + engines: {node: '>=16'} dependencies: is-inside-container: 1.0.0 + dev: true - isarray@1.0.0: {} + /isarray@1.0.0: + resolution: {integrity: sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==} + dev: true - isexe@1.1.2: {} + /isexe@1.1.2: + resolution: {integrity: sha512-d2eJzK691yZwPHcv1LbeAOa91yMJ9QmfTgSO1oXB65ezVhXQsxBac2vEB4bMVms9cGzaA99n6V2viHMq82VLDw==} + dev: true - isexe@2.0.0: {} + /isexe@2.0.0: + resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==} - isobject@3.0.1: {} + /isobject@3.0.1: + resolution: {integrity: sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==} + engines: {node: '>=0.10.0'} + dev: true - istanbul-lib-coverage@3.2.2: {} + /istanbul-lib-coverage@3.2.2: + resolution: {integrity: sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==} + engines: {node: '>=8'} + dev: true - istanbul-lib-instrument@5.2.1: + /istanbul-lib-instrument@5.2.1: + resolution: {integrity: sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==} + engines: {node: '>=8'} dependencies: - '@babel/core': 7.27.4 - '@babel/parser': 7.27.5 + '@babel/core': 7.28.5 + '@babel/parser': 7.28.5 '@istanbuljs/schema': 0.1.3 istanbul-lib-coverage: 3.2.2 semver: 6.3.1 transitivePeerDependencies: - supports-color + dev: true - istanbul-lib-instrument@6.0.3: + /istanbul-lib-instrument@6.0.3: + resolution: {integrity: sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==} + engines: {node: '>=10'} dependencies: - '@babel/core': 7.27.4 - '@babel/parser': 7.27.5 + '@babel/core': 7.28.5 + '@babel/parser': 7.28.5 '@istanbuljs/schema': 0.1.3 istanbul-lib-coverage: 3.2.2 - semver: 7.7.2 + semver: 7.7.3 transitivePeerDependencies: - supports-color + dev: true - istanbul-lib-report@3.0.1: + /istanbul-lib-report@3.0.1: + resolution: {integrity: sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==} + engines: {node: '>=10'} dependencies: istanbul-lib-coverage: 3.2.2 make-dir: 4.0.0 supports-color: 7.2.0 + dev: true - istanbul-lib-source-maps@4.0.1: + /istanbul-lib-source-maps@4.0.1: + resolution: {integrity: sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==} + engines: {node: '>=10'} dependencies: - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) istanbul-lib-coverage: 3.2.2 source-map: 0.6.1 transitivePeerDependencies: - supports-color + dev: true - istanbul-reports@3.1.7: + /istanbul-reports@3.2.0: + resolution: {integrity: sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==} + engines: {node: '>=8'} dependencies: html-escaper: 2.0.2 istanbul-lib-report: 3.0.1 + dev: true - jackspeak@3.4.3: + /jackspeak@3.4.3: + resolution: {integrity: sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==} dependencies: '@isaacs/cliui': 8.0.2 optionalDependencies: '@pkgjs/parseargs': 0.11.0 + dev: true - jackspeak@4.1.1: - dependencies: - '@isaacs/cliui': 8.0.2 - - jake@10.9.2: - dependencies: - async: 3.2.6 - chalk: 4.1.2 - filelist: 1.0.4 - minimatch: 3.1.2 - - jest-changed-files@29.7.0: + /jest-changed-files@29.7.0: + resolution: {integrity: sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: execa: 5.1.1 jest-util: 29.7.0 p-limit: 3.1.0 + dev: true - jest-circus@29.7.0: + /jest-circus@29.7.0: + resolution: {integrity: sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/environment': 29.7.0 '@jest/expect': 29.7.0 '@jest/test-result': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 chalk: 4.1.2 co: 4.6.0 - dedent: 1.6.0 + dedent: 1.7.0 is-generator-fn: 2.1.0 jest-each: 29.7.0 jest-matcher-utils: 29.7.0 @@ -7385,34 +6270,53 @@ snapshots: transitivePeerDependencies: - babel-plugin-macros - supports-color + dev: true - jest-cli@29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)): + /jest-cli@29.7.0(@types/node@22.19.2)(ts-node@10.9.2): + resolution: {integrity: sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + hasBin: true + peerDependencies: + node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 + peerDependenciesMeta: + node-notifier: + optional: true dependencies: - '@jest/core': 29.7.0(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + '@jest/core': 29.7.0(ts-node@10.9.2) '@jest/test-result': 29.7.0 '@jest/types': 29.6.3 chalk: 4.1.2 - create-jest: 29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + create-jest: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) exit: 0.1.2 import-local: 3.2.0 - jest-config: 29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + jest-config: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) jest-util: 29.7.0 jest-validate: 29.7.0 yargs: 17.7.2 - optionalDependencies: - node-notifier: 10.0.1 transitivePeerDependencies: - '@types/node' - babel-plugin-macros - supports-color - ts-node + dev: true - jest-config@29.7.0(@types/node@22.15.30)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)): + /jest-config@29.7.0(@types/node@22.19.2)(ts-node@10.9.2): + resolution: {integrity: sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + peerDependencies: + '@types/node': '*' + ts-node: '>=9.0.0' + peerDependenciesMeta: + '@types/node': + optional: true + ts-node: + optional: true dependencies: - '@babel/core': 7.27.4 + '@babel/core': 7.28.5 '@jest/test-sequencer': 29.7.0 '@jest/types': 29.6.3 - babel-jest: 29.7.0(@babel/core@7.27.4) + '@types/node': 22.19.2 + babel-jest: 29.7.0(@babel/core@7.28.5) chalk: 4.1.2 ci-info: 3.9.0 deepmerge: 4.3.1 @@ -7431,48 +6335,64 @@ snapshots: pretty-format: 29.7.0 slash: 3.0.0 strip-json-comments: 3.1.1 - optionalDependencies: - '@types/node': 22.15.30 - ts-node: 10.9.2(@types/node@22.15.30)(typescript@5.8.3) + ts-node: 10.9.2(@types/node@22.19.2)(typescript@5.9.3) transitivePeerDependencies: - babel-plugin-macros - supports-color + dev: true - jest-diff@29.7.0: + /jest-diff@29.7.0: + resolution: {integrity: sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: chalk: 4.1.2 diff-sequences: 29.6.3 jest-get-type: 29.6.3 pretty-format: 29.7.0 + dev: true - jest-docblock@29.7.0: + /jest-docblock@29.7.0: + resolution: {integrity: sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: detect-newline: 3.1.0 + dev: true - jest-each@29.7.0: + /jest-each@29.7.0: + resolution: {integrity: sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 chalk: 4.1.2 jest-get-type: 29.6.3 jest-util: 29.7.0 pretty-format: 29.7.0 + dev: true - jest-environment-node@29.7.0: + /jest-environment-node@29.7.0: + resolution: {integrity: sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/environment': 29.7.0 '@jest/fake-timers': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 jest-mock: 29.7.0 jest-util: 29.7.0 + dev: true - jest-get-type@29.6.3: {} + /jest-get-type@29.6.3: + resolution: {integrity: sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + dev: true - jest-haste-map@29.7.0: + /jest-haste-map@29.7.0: + resolution: {integrity: sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 '@types/graceful-fs': 4.1.9 - '@types/node': 22.15.30 + '@types/node': 22.19.2 anymatch: 3.1.3 fb-watchman: 2.0.2 graceful-fs: 4.2.11 @@ -7483,20 +6403,29 @@ snapshots: walker: 1.0.8 optionalDependencies: fsevents: 2.3.3 + dev: true - jest-leak-detector@29.7.0: + /jest-leak-detector@29.7.0: + resolution: {integrity: sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: jest-get-type: 29.6.3 pretty-format: 29.7.0 + dev: true - jest-matcher-utils@29.7.0: + /jest-matcher-utils@29.7.0: + resolution: {integrity: sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: chalk: 4.1.2 jest-diff: 29.7.0 jest-get-type: 29.6.3 pretty-format: 29.7.0 + dev: true - jest-message-util@29.7.0: + /jest-message-util@29.7.0: + resolution: {integrity: sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@babel/code-frame': 7.27.1 '@jest/types': 29.6.3 @@ -7507,27 +6436,47 @@ snapshots: pretty-format: 29.7.0 slash: 3.0.0 stack-utils: 2.0.6 + dev: true - jest-mock@29.7.0: + /jest-mock@29.7.0: + resolution: {integrity: sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 jest-util: 29.7.0 + dev: true - jest-pnp-resolver@1.2.3(jest-resolve@29.7.0): - optionalDependencies: + /jest-pnp-resolver@1.2.3(jest-resolve@29.7.0): + resolution: {integrity: sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==} + engines: {node: '>=6'} + peerDependencies: + jest-resolve: '*' + peerDependenciesMeta: + jest-resolve: + optional: true + dependencies: jest-resolve: 29.7.0 + dev: true - jest-regex-util@29.6.3: {} + /jest-regex-util@29.6.3: + resolution: {integrity: sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + dev: true - jest-resolve-dependencies@29.7.0: + /jest-resolve-dependencies@29.7.0: + resolution: {integrity: sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: jest-regex-util: 29.6.3 jest-snapshot: 29.7.0 transitivePeerDependencies: - supports-color + dev: true - jest-resolve@29.7.0: + /jest-resolve@29.7.0: + resolution: {integrity: sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: chalk: 4.1.2 graceful-fs: 4.2.11 @@ -7535,18 +6484,21 @@ snapshots: jest-pnp-resolver: 1.2.3(jest-resolve@29.7.0) jest-util: 29.7.0 jest-validate: 29.7.0 - resolve: 1.22.10 + resolve: 1.22.11 resolve.exports: 2.0.3 slash: 3.0.0 + dev: true - jest-runner@29.7.0: + /jest-runner@29.7.0: + resolution: {integrity: sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/console': 29.7.0 '@jest/environment': 29.7.0 '@jest/test-result': 29.7.0 '@jest/transform': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 chalk: 4.1.2 emittery: 0.13.1 graceful-fs: 4.2.11 @@ -7564,8 +6516,11 @@ snapshots: source-map-support: 0.5.13 transitivePeerDependencies: - supports-color + dev: true - jest-runtime@29.7.0: + /jest-runtime@29.7.0: + resolution: {integrity: sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/environment': 29.7.0 '@jest/fake-timers': 29.7.0 @@ -7574,10 +6529,10 @@ snapshots: '@jest/test-result': 29.7.0 '@jest/transform': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 chalk: 4.1.2 cjs-module-lexer: 1.4.3 - collect-v8-coverage: 1.0.2 + collect-v8-coverage: 1.0.3 glob: 7.2.3 graceful-fs: 4.2.11 jest-haste-map: 29.7.0 @@ -7591,18 +6546,21 @@ snapshots: strip-bom: 4.0.0 transitivePeerDependencies: - supports-color + dev: true - jest-snapshot@29.7.0: + /jest-snapshot@29.7.0: + resolution: {integrity: sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: - '@babel/core': 7.27.4 - '@babel/generator': 7.27.5 - '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.27.4) - '@babel/plugin-syntax-typescript': 7.27.1(@babel/core@7.27.4) - '@babel/types': 7.27.6 + '@babel/core': 7.28.5 + '@babel/generator': 7.28.5 + '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.5) + '@babel/plugin-syntax-typescript': 7.27.1(@babel/core@7.28.5) + '@babel/types': 7.28.5 '@jest/expect-utils': 29.7.0 '@jest/transform': 29.7.0 '@jest/types': 29.6.3 - babel-preset-current-node-syntax: 1.1.0(@babel/core@7.27.4) + babel-preset-current-node-syntax: 1.2.0(@babel/core@7.28.5) chalk: 4.1.2 expect: 29.7.0 graceful-fs: 4.2.11 @@ -7613,20 +6571,26 @@ snapshots: jest-util: 29.7.0 natural-compare: 1.4.0 pretty-format: 29.7.0 - semver: 7.7.2 + semver: 7.7.3 transitivePeerDependencies: - supports-color + dev: true - jest-util@29.7.0: + /jest-util@29.7.0: + resolution: {integrity: sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 chalk: 4.1.2 ci-info: 3.9.0 graceful-fs: 4.2.11 picomatch: 2.3.1 + dev: true - jest-validate@29.7.0: + /jest-validate@29.7.0: + resolution: {integrity: sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/types': 29.6.3 camelcase: 6.3.0 @@ -7634,468 +6598,1037 @@ snapshots: jest-get-type: 29.6.3 leven: 3.1.0 pretty-format: 29.7.0 + dev: true - jest-watcher@29.7.0: + /jest-watcher@29.7.0: + resolution: {integrity: sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/test-result': 29.7.0 '@jest/types': 29.6.3 - '@types/node': 22.15.30 + '@types/node': 22.19.2 ansi-escapes: 4.3.2 chalk: 4.1.2 emittery: 0.13.1 jest-util: 29.7.0 string-length: 4.0.2 + dev: true - jest-worker@29.7.0: + /jest-worker@29.7.0: + resolution: {integrity: sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: - '@types/node': 22.15.30 + '@types/node': 22.19.2 jest-util: 29.7.0 merge-stream: 2.0.0 supports-color: 8.1.1 + dev: true - jest@29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)): + /jest@29.7.0(@types/node@22.19.2)(ts-node@10.9.2): + resolution: {integrity: sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} + hasBin: true + peerDependencies: + node-notifier: ^8.0.1 || ^9.0.0 || ^10.0.0 + peerDependenciesMeta: + node-notifier: + optional: true dependencies: - '@jest/core': 29.7.0(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) + '@jest/core': 29.7.0(ts-node@10.9.2) '@jest/types': 29.6.3 import-local: 3.2.0 - jest-cli: 29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) - optionalDependencies: - node-notifier: 10.0.1 + jest-cli: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) transitivePeerDependencies: - '@types/node' - babel-plugin-macros - supports-color - ts-node + dev: true + + /jiti@2.6.1: + resolution: {integrity: sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ==} + hasBin: true + dev: true - jiti@2.4.2: {} + /jose@6.1.3: + resolution: {integrity: sha512-0TpaTfihd4QMNwrz/ob2Bp7X04yuxJkjRGi4aKmOqwhov54i6u79oCv7T+C7lo70MKH6BesI3vscD1yb/yzKXQ==} + dev: false - joycon@3.1.1: {} + /joycon@3.1.1: + resolution: {integrity: sha512-34wB/Y7MW7bzjKRjUKTa46I2Z7eV62Rkhva+KkopW7Qvv/OSWBqvkSY7vusOPrNuZcUG3tApvdVgNB8POj3SPw==} + engines: {node: '>=10'} + dev: true - js-tokens@4.0.0: {} + /js-tokens@4.0.0: + resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} + dev: true - js-tokens@9.0.1: {} + /js-tokens@9.0.1: + resolution: {integrity: sha512-mxa9E9ITFOt0ban3j6L5MpjwegGz6lBQmM1IJkWeBZGcMxto50+eWdjC/52xDbS2vy0k7vIMK0Fe2wfL9OQSpQ==} + dev: true - js-yaml@3.14.1: + /js-yaml@3.14.2: + resolution: {integrity: sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==} + hasBin: true dependencies: argparse: 1.0.10 esprima: 4.0.1 + dev: true - js-yaml@4.1.0: + /js-yaml@4.1.1: + resolution: {integrity: sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==} + hasBin: true dependencies: argparse: 2.0.1 + dev: true + + /jsdom@26.1.0: + resolution: {integrity: sha512-Cvc9WUhxSMEo4McES3P7oK3QaXldCfNWp7pl2NNeiIFlCoLr3kfq9kb1fxftiwk1FLV7CvpvDfonxtzUDeSOPg==} + engines: {node: '>=18'} + peerDependencies: + canvas: ^3.0.0 + peerDependenciesMeta: + canvas: + optional: true + dependencies: + cssstyle: 4.6.0 + data-urls: 5.0.0 + decimal.js: 10.6.0 + html-encoding-sniffer: 4.0.0 + http-proxy-agent: 7.0.2 + https-proxy-agent: 7.0.6 + is-potential-custom-element-name: 1.0.1 + nwsapi: 2.2.23 + parse5: 7.3.0 + rrweb-cssom: 0.8.0 + saxes: 6.0.0 + symbol-tree: 3.2.4 + tough-cookie: 5.1.2 + w3c-xmlserializer: 5.0.0 + webidl-conversions: 7.0.0 + whatwg-encoding: 3.1.1 + whatwg-mimetype: 4.0.0 + whatwg-url: 14.2.0 + ws: 8.18.3 + xml-name-validator: 5.0.0 + transitivePeerDependencies: + - bufferutil + - supports-color + - utf-8-validate + dev: true - jsesc@3.1.0: {} + /jsesc@3.1.0: + resolution: {integrity: sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==} + engines: {node: '>=6'} + hasBin: true + dev: true - json-buffer@3.0.1: {} + /json-buffer@3.0.1: + resolution: {integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==} + dev: true - json-parse-even-better-errors@2.3.1: {} + /json-parse-even-better-errors@2.3.1: + resolution: {integrity: sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==} + dev: true - json-parse-even-better-errors@3.0.2: {} + /json-parse-even-better-errors@3.0.2: + resolution: {integrity: sha512-fi0NG4bPjCHunUJffmLd0gxssIgkNmArMvis4iNah6Owg1MCJjWhEcDLmsK6iGkJq3tHwbDkTlce70/tmXN4cQ==} + engines: {node: ^14.17.0 || ^16.13.0 || >=18.0.0} + dev: true - json-schema-ref-resolver@2.0.1: + /json-schema-ref-resolver@3.0.0: + resolution: {integrity: sha512-hOrZIVL5jyYFjzk7+y7n5JDzGlU8rfWDuYyHwGa2WA8/pcmMHezp2xsVwxrebD/Q9t8Nc5DboieySDpCp4WG4A==} dependencies: dequal: 2.0.3 + dev: false - json-schema-traverse@0.4.1: {} + /json-schema-traverse@0.4.1: + resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==} + dev: true - json-schema-traverse@1.0.0: {} + /json-schema-traverse@1.0.0: + resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==} - json-stable-stringify-without-jsonify@1.0.1: {} + /json-stable-stringify-without-jsonify@1.0.1: + resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==} + dev: true - json5@2.2.3: {} + /json5@2.2.3: + resolution: {integrity: sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==} + engines: {node: '>=6'} + hasBin: true + dev: true - jsonfile@6.1.0: + /jsonfile@6.2.0: + resolution: {integrity: sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==} dependencies: universalify: 2.0.1 optionalDependencies: graceful-fs: 4.2.11 + dev: true - jsonparse@1.3.1: {} + /jsonparse@1.3.1: + resolution: {integrity: sha512-POQXvpdL69+CluYsillJ7SUhKvytYjW9vG/GKpnf+xP8UWgYEM/RaMzHHofbALDiKbbP1W8UEYmgGl39WkPZsg==} + engines: {'0': node >= 0.2.0} + dev: true - jszip@3.10.1: + /jszip@3.10.1: + resolution: {integrity: sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==} dependencies: lie: 3.3.0 pako: 1.0.11 readable-stream: 2.3.8 setimmediate: 1.0.5 + dev: true - keyv@4.5.4: + /keyv@4.5.4: + resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==} dependencies: json-buffer: 3.0.1 + dev: true + + /kleur@3.0.3: + resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==} + engines: {node: '>=6'} + dev: true - kleur@3.0.3: {} + /kolorist@1.8.0: + resolution: {integrity: sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ==} + dev: true - ky@1.8.1: {} + /ky@1.14.1: + resolution: {integrity: sha512-hYje4L9JCmpEQBtudo+v52X5X8tgWXUYyPcxKSuxQNboqufecl9VMWjGiucAFH060AwPXHZuH+WB2rrqfkmafw==} + engines: {node: '>=18'} + dev: true - latest-version@9.0.0: + /latest-version@9.0.0: + resolution: {integrity: sha512-7W0vV3rqv5tokqkBAFV1LbR7HPOWzXQDpDgEuib/aJ1jsZZx6x3c2mBI+TJhJzOhkGeaLbCKEHXEXLfirtG2JA==} + engines: {node: '>=18'} dependencies: package-json: 10.0.1 + dev: true - leven@3.1.0: {} + /leven@3.1.0: + resolution: {integrity: sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==} + engines: {node: '>=6'} + dev: true - levn@0.4.1: + /levn@0.4.1: + resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==} + engines: {node: '>= 0.8.0'} dependencies: prelude-ls: 1.2.1 type-check: 0.4.0 + dev: true - lie@3.3.0: + /lie@3.3.0: + resolution: {integrity: sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==} dependencies: immediate: 3.0.6 + dev: true - light-my-request@6.6.0: + /light-my-request@6.6.0: + resolution: {integrity: sha512-CHYbu8RtboSIoVsHZ6Ye4cj4Aw/yg2oAFimlF7mNvfDV192LR7nDiKtSIfCuLT7KokPSTn/9kfVLm5OGN0A28A==} dependencies: - cookie: 1.0.2 + cookie: 1.1.1 process-warning: 4.0.1 - set-cookie-parser: 2.7.1 + set-cookie-parser: 2.7.2 + dev: false - lighthouse-logger@2.0.1: + /lighthouse-logger@2.0.2: + resolution: {integrity: sha512-vWl2+u5jgOQuZR55Z1WM0XDdrJT6mzMP8zHUct7xTlWhuQs+eV0g+QL0RQdFjT54zVmbhLCP8vIVpy1wGn/gCg==} dependencies: - debug: 2.6.9 + debug: 4.4.3(supports-color@5.5.0) marky: 1.3.0 transitivePeerDependencies: - supports-color + dev: true + + /lightningcss-android-arm64@1.30.2: + resolution: {integrity: sha512-BH9sEdOCahSgmkVhBLeU7Hc9DWeZ1Eb6wNS6Da8igvUwAe0sqROHddIlvU06q3WyXVEOYDZ6ykBZQnjTbmo4+A==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + requiresBuild: true + dev: true + optional: true + + /lightningcss-darwin-arm64@1.30.2: + resolution: {integrity: sha512-ylTcDJBN3Hp21TdhRT5zBOIi73P6/W0qwvlFEk22fkdXchtNTOU4Qc37SkzV+EKYxLouZ6M4LG9NfZ1qkhhBWA==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + requiresBuild: true + dev: true + optional: true + + /lightningcss-darwin-x64@1.30.2: + resolution: {integrity: sha512-oBZgKchomuDYxr7ilwLcyms6BCyLn0z8J0+ZZmfpjwg9fRVZIR5/GMXd7r9RH94iDhld3UmSjBM6nXWM2TfZTQ==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + requiresBuild: true + dev: true + optional: true + + /lightningcss-freebsd-x64@1.30.2: + resolution: {integrity: sha512-c2bH6xTrf4BDpK8MoGG4Bd6zAMZDAXS569UxCAGcA7IKbHNMlhGQ89eRmvpIUGfKWNVdbhSbkQaWhEoMGmGslA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + requiresBuild: true + dev: true + optional: true + + /lightningcss-linux-arm-gnueabihf@1.30.2: + resolution: {integrity: sha512-eVdpxh4wYcm0PofJIZVuYuLiqBIakQ9uFZmipf6LF/HRj5Bgm0eb3qL/mr1smyXIS1twwOxNWndd8z0E374hiA==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /lightningcss-linux-arm64-gnu@1.30.2: + resolution: {integrity: sha512-UK65WJAbwIJbiBFXpxrbTNArtfuznvxAJw4Q2ZGlU8kPeDIWEX1dg3rn2veBVUylA2Ezg89ktszWbaQnxD/e3A==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /lightningcss-linux-arm64-musl@1.30.2: + resolution: {integrity: sha512-5Vh9dGeblpTxWHpOx8iauV02popZDsCYMPIgiuw97OJ5uaDsL86cnqSFs5LZkG3ghHoX5isLgWzMs+eD1YzrnA==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /lightningcss-linux-x64-gnu@1.30.2: + resolution: {integrity: sha512-Cfd46gdmj1vQ+lR6VRTTadNHu6ALuw2pKR9lYq4FnhvgBc4zWY1EtZcAc6EffShbb1MFrIPfLDXD6Xprbnni4w==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /lightningcss-linux-x64-musl@1.30.2: + resolution: {integrity: sha512-XJaLUUFXb6/QG2lGIW6aIk6jKdtjtcffUT0NKvIqhSBY3hh9Ch+1LCeH80dR9q9LBjG3ewbDjnumefsLsP6aiA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + requiresBuild: true + dev: true + optional: true + + /lightningcss-win32-arm64-msvc@1.30.2: + resolution: {integrity: sha512-FZn+vaj7zLv//D/192WFFVA0RgHawIcHqLX9xuWiQt7P0PtdFEVaxgF9rjM/IRYHQXNnk61/H/gb2Ei+kUQ4xQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + requiresBuild: true + dev: true + optional: true + + /lightningcss-win32-x64-msvc@1.30.2: + resolution: {integrity: sha512-5g1yc73p+iAkid5phb4oVFMB45417DkRevRbt/El/gKXJk4jid+vPFF/AXbxn05Aky8PapwzZrdJShv5C0avjw==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + requiresBuild: true + dev: true + optional: true - lilconfig@3.1.3: {} + /lightningcss@1.30.2: + resolution: {integrity: sha512-utfs7Pr5uJyyvDETitgsaqSyjCb2qNRAtuqUeWIAKztsOYdcACf2KtARYXg2pSvhkt+9NfoaNY7fxjl6nuMjIQ==} + engines: {node: '>= 12.0.0'} + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.30.2 + lightningcss-darwin-arm64: 1.30.2 + lightningcss-darwin-x64: 1.30.2 + lightningcss-freebsd-x64: 1.30.2 + lightningcss-linux-arm-gnueabihf: 1.30.2 + lightningcss-linux-arm64-gnu: 1.30.2 + lightningcss-linux-arm64-musl: 1.30.2 + lightningcss-linux-x64-gnu: 1.30.2 + lightningcss-linux-x64-musl: 1.30.2 + lightningcss-win32-arm64-msvc: 1.30.2 + lightningcss-win32-x64-msvc: 1.30.2 + dev: true + + /lilconfig@3.1.3: + resolution: {integrity: sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==} + engines: {node: '>=14'} + dev: true - lines-and-columns@1.2.4: {} + /lines-and-columns@1.2.4: + resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==} + dev: true - lines-and-columns@2.0.4: {} + /lines-and-columns@2.0.4: + resolution: {integrity: sha512-wM1+Z03eypVAVUCE7QdSqpVIvelbOakn1M0bPDoA4SGWPx3sNDVUiMo3L6To6WWGClB7VyXnhQ4Sn7gxiJbE6A==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - linkedom@0.18.11: + /linkedom@0.18.12: + resolution: {integrity: sha512-jalJsOwIKuQJSeTvsgzPe9iJzyfVaEJiEXl+25EkKevsULHvMJzpNqwvj1jOESWdmgKDiXObyjOYwlUqG7wo1Q==} + engines: {node: '>=16'} + peerDependencies: + canvas: '>= 2' + peerDependenciesMeta: + canvas: + optional: true dependencies: - css-select: 5.1.0 + css-select: 5.2.2 cssom: 0.5.0 html-escaper: 3.0.3 htmlparser2: 10.0.0 uhyphen: 0.2.0 + dev: true + + /linkify-it@5.0.0: + resolution: {integrity: sha512-5aHCbzQRADcdP+ATqnDuhhJ/MRIqDkZX5pyjFHRRysS8vZ5AbqGEoFIb6pYHPZ+L/OC2Lc+xT8uHVVR5CAK/wQ==} + dependencies: + uc.micro: 2.1.0 + dev: false - lint-staged@15.5.2: + /lint-staged@15.5.2: + resolution: {integrity: sha512-YUSOLq9VeRNAo/CTaVmhGDKG+LBtA8KF1X4K5+ykMSwWST1vDxJRB2kv2COgLb1fvpCo+A/y9A0G0znNVmdx4w==} + engines: {node: '>=18.12.0'} + hasBin: true dependencies: - chalk: 5.4.1 + chalk: 5.6.2 commander: 13.1.0 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) execa: 8.0.1 lilconfig: 3.1.3 listr2: 8.3.3 micromatch: 4.0.8 pidtree: 0.6.0 string-argv: 0.3.2 - yaml: 2.8.0 + yaml: 2.8.2 transitivePeerDependencies: - supports-color + dev: true - listr2@8.3.3: + /listr2@8.3.3: + resolution: {integrity: sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==} + engines: {node: '>=18.0.0'} dependencies: cli-truncate: 4.0.0 colorette: 2.0.20 eventemitter3: 5.0.1 log-update: 6.1.0 rfdc: 1.4.1 - wrap-ansi: 9.0.0 + wrap-ansi: 9.0.2 + dev: true + + /load-tsconfig@0.2.5: + resolution: {integrity: sha512-IXO6OCs9yg8tMKzfPZ1YmheJbZCiEsnBdcB03l0OcfK9prKnJb96siuHCr5Fl37/yo9DnKU+TLpxzTUspw9shg==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - load-tsconfig@0.2.5: {} + /local-pkg@0.5.1: + resolution: {integrity: sha512-9rrA30MRRP3gBD3HTGnC6cDFpaE1kVDWxWgqWJUN0RvDNAo+Nz/9GxB+nHOH0ifbVFy0hSA1V6vFDvnx54lTEQ==} + engines: {node: '>=14'} + dependencies: + mlly: 1.8.0 + pkg-types: 1.3.1 + dev: true - local-pkg@1.1.1: + /local-pkg@1.1.2: + resolution: {integrity: sha512-arhlxbFRmoQHl33a0Zkle/YWlmNwoyt6QNZEIJcqNbdrsix5Lvc4HyyI3EnwxTYlZYc32EbYrQ8SzEZ7dqgg9A==} + engines: {node: '>=14'} dependencies: - mlly: 1.7.4 - pkg-types: 2.1.0 - quansync: 0.2.10 + mlly: 1.8.0 + pkg-types: 2.3.0 + quansync: 0.2.11 + dev: true - locate-path@5.0.0: + /locate-path@5.0.0: + resolution: {integrity: sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==} + engines: {node: '>=8'} dependencies: p-locate: 4.1.0 + dev: true - locate-path@6.0.0: + /locate-path@6.0.0: + resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==} + engines: {node: '>=10'} dependencies: p-locate: 5.0.0 + dev: true - locate-path@7.2.0: + /locate-path@7.2.0: + resolution: {integrity: sha512-gvVijfZvn7R+2qyPX8mAuKcFGDf6Nc61GdvGafQsHL0sBIxfKzA+usWn4GFC/bk+QdwPUD4kWFJLhElipq+0VA==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: p-locate: 6.0.0 + dev: true - lodash.camelcase@4.3.0: {} - - lodash.isplainobject@4.0.6: {} - - lodash.kebabcase@4.1.1: {} - - lodash.memoize@4.1.2: {} + /lodash.camelcase@4.3.0: + resolution: {integrity: sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==} + dev: true - lodash.merge@4.6.2: {} + /lodash.isplainobject@4.0.6: + resolution: {integrity: sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==} + dev: true - lodash.mergewith@4.6.2: {} + /lodash.kebabcase@4.1.1: + resolution: {integrity: sha512-N8XRTIMMqqDgSy4VLKPnJ/+hpGZN+PHQiJnSenYqPaVV/NCqEogTnAdZLQiGKhxX+JCs8waWq2t1XHWKOmlY8g==} + dev: true - lodash.snakecase@4.1.1: {} + /lodash.memoize@4.1.2: + resolution: {integrity: sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==} + dev: true - lodash.sortby@4.7.0: {} + /lodash.merge@4.6.2: + resolution: {integrity: sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==} + dev: true - lodash.startcase@4.4.0: {} + /lodash.mergewith@4.6.2: + resolution: {integrity: sha512-GK3g5RPZWTRSeLSpgP8Xhra+pnjBC56q9FZYe1d5RN3TJ35dbkGy3YqBSMbyCrlbi+CM9Z3Jk5yTL7RCsqboyQ==} + dev: true - lodash.uniq@4.5.0: {} + /lodash.snakecase@4.1.1: + resolution: {integrity: sha512-QZ1d4xoBHYUeuouhEq3lk3Uq7ldgyFXGBhg04+oRLnIz8o9T65Eh+8YdroUwn846zchkA9yDsDl5CVVaV2nqYw==} + dev: true - lodash.upperfirst@4.3.1: {} + /lodash.startcase@4.4.0: + resolution: {integrity: sha512-+WKqsK294HMSc2jEbNgpHpd0JfIBhp7rEV4aqXWqFr6AlXov+SlcgB1Fv01y2kGe3Gc8nMW7VA0SrGuSkRfIEg==} + dev: true - lodash@4.17.21: {} + /lodash.uniq@4.5.0: + resolution: {integrity: sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==} + dev: true - log-symbols@5.1.0: - dependencies: - chalk: 5.4.1 - is-unicode-supported: 1.3.0 + /lodash.upperfirst@4.3.1: + resolution: {integrity: sha512-sReKOYJIJf74dhJONhU4e0/shzi1trVbSWDOhKYE5XV2O+H7Sb2Dihwuc7xWxVl+DgFPyTqIN3zMfT9cq5iWDg==} + dev: true - log-symbols@6.0.0: + /log-symbols@6.0.0: + resolution: {integrity: sha512-i24m8rpwhmPIS4zscNzK6MSEhk0DUWa/8iYQWxhffV8jkI4Phvs3F+quL5xvS0gdQR0FyTCMMH33Y78dDTzzIw==} + engines: {node: '>=18'} dependencies: - chalk: 5.4.1 + chalk: 5.6.2 is-unicode-supported: 1.3.0 + dev: true - log-update@6.1.0: + /log-update@6.1.0: + resolution: {integrity: sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==} + engines: {node: '>=18'} dependencies: - ansi-escapes: 7.0.0 + ansi-escapes: 7.2.0 cli-cursor: 5.0.0 - slice-ansi: 7.1.0 - strip-ansi: 7.1.0 - wrap-ansi: 9.0.0 + slice-ansi: 7.1.2 + strip-ansi: 7.1.2 + wrap-ansi: 9.0.2 + dev: true + + /long@4.0.0: + resolution: {integrity: sha512-XsP+KhQif4bjX1kbuSiySJFNAehNxgLb6hPRGJ9QsUr8ajHkuXGdrHmFUTUUXhDwVX2R5bY4JNZEwbUiMhV+MA==} + dev: false - long@4.0.0: {} + /loupe@3.2.1: + resolution: {integrity: sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==} + dev: true - lru-cache@10.4.3: {} + /lru-cache@10.4.3: + resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==} + dev: true - lru-cache@11.1.0: {} + /lru-cache@11.2.4: + resolution: {integrity: sha512-B5Y16Jr9LB9dHVkh6ZevG+vAbOsNOYCX+sXvFWFu7B3Iz5mijW3zdbMyhsh8ANd2mSWBYdJgnqi+mL7/LrOPYg==} + engines: {node: 20 || >=22} + dev: true - lru-cache@5.1.1: + /lru-cache@5.1.1: + resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==} dependencies: yallist: 3.1.1 + dev: true - magic-string@0.30.17: + /magic-string@0.30.21: + resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==} dependencies: - '@jridgewell/sourcemap-codec': 1.5.0 + '@jridgewell/sourcemap-codec': 1.5.5 - magicast@0.3.5: + /magicast@0.3.5: + resolution: {integrity: sha512-L0WhttDl+2BOsybvEOLK7fW3UA0OQ0IQ2d6Zl2x/a6vVRs3bAY0ECOSHHeL5jD+SbOpOCUEi0y1DgHEn9Qn1AQ==} dependencies: - '@babel/parser': 7.27.5 - '@babel/types': 7.27.6 + '@babel/parser': 7.28.5 + '@babel/types': 7.28.5 source-map-js: 1.2.1 + dev: true - make-dir@4.0.0: + /make-dir@4.0.0: + resolution: {integrity: sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==} + engines: {node: '>=10'} dependencies: - semver: 7.7.2 + semver: 7.7.3 + dev: true - make-error@1.3.6: {} + /make-error@1.3.6: + resolution: {integrity: sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==} + dev: true - makeerror@1.0.12: + /makeerror@1.0.12: + resolution: {integrity: sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==} dependencies: tmpl: 1.0.5 + dev: true + + /many-keys-map@2.0.1: + resolution: {integrity: sha512-DHnZAD4phTbZ+qnJdjoNEVU1NecYoSdbOOoVmTDH46AuxDkEVh3MxTVpXq10GtcTC6mndN9dkv1rNfpjRcLnOw==} + dev: true + + /markdown-it-container@4.0.0: + resolution: {integrity: sha512-HaNccxUH0l7BNGYbFbjmGpf5aLHAMTinqRZQAEQbMr2cdD3z91Q6kIo1oUn1CQndkT03jat6ckrdRYuwwqLlQw==} + dev: false + + /markdown-it-footnote@4.0.0: + resolution: {integrity: sha512-WYJ7urf+khJYl3DqofQpYfEYkZKbmXmwxQV8c8mO/hGIhgZ1wOe7R4HLFNwqx7TjILbnC98fuyeSsin19JdFcQ==} + dev: false + + /markdown-it-ins@4.0.0: + resolution: {integrity: sha512-sWbjK2DprrkINE4oYDhHdCijGT+MIDhEupjSHLXe5UXeVr5qmVxs/nTUVtgi0Oh/qtF+QKV0tNWDhQBEPxiMew==} + dev: false + + /markdown-it-mark@4.0.0: + resolution: {integrity: sha512-YLhzaOsU9THO/cal0lUjfMjrqSMPjjyjChYM7oyj4DnyaXEzA8gnW6cVJeyCrCVeyesrY2PlEdUYJSPFYL4Nkg==} + dev: false + + /markdown-it-sub@2.0.0: + resolution: {integrity: sha512-iCBKgwCkfQBRg2vApy9vx1C1Tu6D8XYo8NvevI3OlwzBRmiMtsJ2sXupBgEA7PPxiDwNni3qIUkhZ6j5wofDUA==} + dev: false + + /markdown-it-sup@2.0.0: + resolution: {integrity: sha512-5VgmdKlkBd8sgXuoDoxMpiU+BiEt3I49GItBzzw7Mxq9CxvnhE/k09HFli09zgfFDRixDQDfDxi0mgBCXtaTvA==} + dev: false + + /markdown-it-task-checkbox@1.0.6: + resolution: {integrity: sha512-7pxkHuvqTOu3iwVGmDPeYjQg+AIS9VQxzyLP9JCg9lBjgPAJXGEkChK6A2iFuj3tS0GV3HG2u5AMNhcQqwxpJw==} + dev: false - many-keys-map@2.0.1: {} + /markdown-it-ts@0.0.2: + resolution: {integrity: sha512-QKNmck9IHgsCqJkvk5Zgw29534WZldNtuCnsEKm5HX80XsEUGfX1m3vexY9jmfHYDq8469fAsbwp78bRusI7HQ==} + engines: {node: '>=18'} + dependencies: + entities: 4.5.0 + linkify-it: 5.0.0 + mdurl: 2.0.0 + punycode.js: 2.3.1 + uc.micro: 2.1.0 + dev: false + + /markstream-vue@0.0.3-beta.5(vue@3.5.25): + resolution: {integrity: sha512-mqrwry/nWf25yNcSvdXijh5gZT8oC5wLafPncydFjC8Wtc7Zvr8MkTlRjiWP9wczlQxCr1GW2AHxZDQbKPgrJQ==} + peerDependencies: + katex: '>=0.16.22' + mermaid: '>=11' + shiki: ^3.13.0 + stream-markdown: '>=0.0.11' + stream-monaco: '>=0.0.8' + vue: '>=3.0.0' + vue-i18n: '>=9' + peerDependenciesMeta: + katex: + optional: true + mermaid: + optional: true + shiki: + optional: true + stream-markdown: + optional: true + stream-monaco: + optional: true + vue-i18n: + optional: true + dependencies: + '@floating-ui/dom': 1.7.4 + stream-markdown-parser: 0.0.42 + vue: 3.5.25(typescript@5.9.3) + dev: false - marky@1.3.0: {} + /marky@1.3.0: + resolution: {integrity: sha512-ocnPZQLNpvbedwTy9kNrQEsknEfgvcLMvOtz3sFeWApDq1MXH1TqkCIx58xlpESsfwQOnuBO9beyQuNGzVvuhQ==} + dev: true + + /math-intrinsics@1.1.0: + resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==} + engines: {node: '>= 0.4'} - math-intrinsics@1.1.0: {} + /mdurl@2.0.0: + resolution: {integrity: sha512-Lf+9+2r+Tdp5wXDXC4PcIBjTDtq4UKjCPMQhKIuzpJNW0b96kVqSwW0bT7FhRSfmAiFYgP+SCRvdrDozfh0U5w==} + dev: false - media-typer@1.1.0: {} + /media-typer@1.1.0: + resolution: {integrity: sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==} + engines: {node: '>= 0.8'} + dev: false - meow@12.1.1: {} + /meow@12.1.1: + resolution: {integrity: sha512-BhXM0Au22RwUneMPwSCnyhTOizdWoIEPU9sp0Aqa1PnDMR5Wv2FGXYDjuzJEIX+Eo2Rb8xuYe5jrnm5QowQFkw==} + engines: {node: '>=16.10'} + dev: true - merge-descriptors@2.0.0: {} + /merge-descriptors@2.0.0: + resolution: {integrity: sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==} + engines: {node: '>=18'} + dev: false - merge-stream@2.0.0: {} + /merge-stream@2.0.0: + resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==} - merge2@1.4.1: {} + /merge2@1.4.1: + resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==} + engines: {node: '>= 8'} + dev: true - methods@1.1.2: {} + /methods@1.1.2: + resolution: {integrity: sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==} + engines: {node: '>= 0.6'} + dev: true - micromatch@4.0.8: + /micromatch@4.0.8: + resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==} + engines: {node: '>=8.6'} dependencies: braces: 3.0.3 picomatch: 2.3.1 + dev: true - mime-db@1.52.0: {} + /mime-db@1.52.0: + resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==} + engines: {node: '>= 0.6'} - mime-db@1.54.0: {} + /mime-db@1.54.0: + resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==} + engines: {node: '>= 0.6'} + dev: false - mime-types@2.1.35: + /mime-types@2.1.35: + resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==} + engines: {node: '>= 0.6'} dependencies: mime-db: 1.52.0 - mime-types@3.0.1: + /mime-types@3.0.2: + resolution: {integrity: sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==} + engines: {node: '>=18'} dependencies: mime-db: 1.54.0 + dev: false - mime@2.6.0: {} - - mimic-fn@2.1.0: {} + /mime@2.6.0: + resolution: {integrity: sha512-USPkMeET31rOMiarsBNIHZKLGgvKc/LrjofAnBlOttf5ajRvqiRA8QsenbcooctK6d6Ts6aqZXBA+XbkKthiQg==} + engines: {node: '>=4.0.0'} + hasBin: true + dev: true - mimic-fn@4.0.0: {} + /mimic-fn@2.1.0: + resolution: {integrity: sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==} + engines: {node: '>=6'} - mimic-function@5.0.1: {} + /mimic-fn@4.0.0: + resolution: {integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==} + engines: {node: '>=12'} + dev: true - mimic-response@3.1.0: {} + /mimic-function@5.0.1: + resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==} + engines: {node: '>=18'} + dev: true - minimatch@10.0.1: - dependencies: - brace-expansion: 2.0.1 + /mimic-response@3.1.0: + resolution: {integrity: sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==} + engines: {node: '>=10'} + dev: false - minimatch@3.1.2: + /minimatch@10.1.1: + resolution: {integrity: sha512-enIvLvRAFZYXJzkCYG5RKmPfrFArdLv+R+lbQ53BmIMLIry74bjKzX6iHAm8WYamJkhSSEabrWN5D97XnKObjQ==} + engines: {node: 20 || >=22} dependencies: - brace-expansion: 1.1.11 + '@isaacs/brace-expansion': 5.0.0 + dev: true - minimatch@5.1.6: + /minimatch@3.1.2: + resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==} dependencies: - brace-expansion: 2.0.1 + brace-expansion: 1.1.12 + dev: true - minimatch@9.0.5: + /minimatch@9.0.5: + resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==} + engines: {node: '>=16 || 14 >=14.17'} dependencies: - brace-expansion: 2.0.1 + brace-expansion: 2.0.2 + dev: true - minimist@1.2.8: {} + /minimist@1.2.8: + resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==} - minipass@7.1.2: {} + /minipass@7.1.2: + resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==} + engines: {node: '>=16 || 14 >=14.17'} + dev: true - mkdirp-classic@0.5.3: {} + /mkdirp-classic@0.5.3: + resolution: {integrity: sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==} + dev: false - mlly@1.7.4: + /mlly@1.8.0: + resolution: {integrity: sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==} dependencies: acorn: 8.15.0 pathe: 2.0.3 pkg-types: 1.3.1 ufo: 1.6.1 + dev: true - ms@2.0.0: {} - - ms@2.1.3: {} + /ms@2.1.3: + resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==} - muggle-string@0.4.1: {} + /muggle-string@0.4.1: + resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==} + dev: true - multimatch@6.0.0: + /multimatch@6.0.0: + resolution: {integrity: sha512-I7tSVxHGPlmPN/enE3mS1aOSo6bWBfls+3HmuEeCUBCE7gWnm3cBXCBkpurzFjVRwC6Kld8lLaZ1Iv5vOcjvcQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: '@types/minimatch': 3.0.5 array-differ: 4.0.0 array-union: 3.0.1 minimatch: 3.1.2 + dev: true - mz@2.7.0: + /mz@2.7.0: + resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==} dependencies: any-promise: 1.3.0 object-assign: 4.1.1 thenify-all: 1.6.0 + dev: true + + /nano-spawn@1.0.3: + resolution: {integrity: sha512-jtpsQDetTnvS2Ts1fiRdci5rx0VYws5jGyC+4IYOTnIQ/wwdf6JdomlHBwqC3bJYOvaKu0C2GSZ1A60anrYpaA==} + engines: {node: '>=20.17'} + dev: true - nano-spawn@0.2.1: {} + /nanoid@3.3.11: + resolution: {integrity: sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true - nanoid@3.3.11: {} + /napi-build-utils@2.0.0: + resolution: {integrity: sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==} + dev: false - napi-build-utils@2.0.0: {} + /natural-compare@1.4.0: + resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==} + dev: true - natural-compare@1.4.0: {} + /negotiator@1.0.0: + resolution: {integrity: sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==} + engines: {node: '>= 0.6'} + dev: false - negotiator@1.0.0: {} + /neo-async@2.6.2: + resolution: {integrity: sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==} + dev: true - node-abi@3.75.0: + /node-abi@3.85.0: + resolution: {integrity: sha512-zsFhmbkAzwhTft6nd3VxcG0cvJsT70rL+BIGHWVq5fi6MwGrHwzqKaxXE+Hl2GmnGItnDKPPkO5/LQqjVkIdFg==} + engines: {node: '>=10'} dependencies: - semver: 7.7.2 + semver: 7.7.3 + dev: false - node-addon-api@6.1.0: {} + /node-addon-api@6.1.0: + resolution: {integrity: sha512-+eawOlIgy680F0kBzPUNFhMZGtJ1YmqM6l4+Crf4IkImjYrO/mqPwRMh352g23uIaQKFItcQ64I7KMaJxHgAVA==} + dev: false - node-fetch-native@1.6.6: {} + /node-fetch-native@1.6.7: + resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==} + dev: true - node-fetch@2.7.0: + /node-fetch@2.7.0: + resolution: {integrity: sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==} + engines: {node: 4.x || >=6.0.0} + peerDependencies: + encoding: ^0.1.0 + peerDependenciesMeta: + encoding: + optional: true dependencies: whatwg-url: 5.0.0 + dev: false - node-forge@1.3.1: {} + /node-forge@1.3.3: + resolution: {integrity: sha512-rLvcdSyRCyouf6jcOIPe/BgwG/d7hKjzMKOas33/pHEr6gbq18IK9zV7DiPvzsz0oBJPme6qr6H6kGZuI9/DZg==} + engines: {node: '>= 6.13.0'} + dev: true - node-int64@0.4.0: {} + /node-int64@0.4.0: + resolution: {integrity: sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==} + dev: true - node-notifier@10.0.1: + /node-notifier@10.0.1: + resolution: {integrity: sha512-YX7TSyDukOZ0g+gmzjB6abKu+hTGvO8+8+gIFDsRCU2t8fLV/P2unmt+LGFaIa4y64aX98Qksa97rgz4vMNeLQ==} dependencies: growly: 1.3.0 is-wsl: 2.2.0 - semver: 7.7.2 + semver: 7.7.3 shellwords: 0.1.1 uuid: 8.3.2 which: 2.0.2 + dev: true - node-releases@2.0.19: {} + /node-releases@2.0.27: + resolution: {integrity: sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==} + dev: true - nodemon@3.1.10: + /nodemon@3.1.11: + resolution: {integrity: sha512-is96t8F/1//UHAjNPHpbsNY46ELPpftGUoSVNXwUfMk/qdjSylYrWSu1XavVTBOn526kFiOR733ATgNBCQyH0g==} + engines: {node: '>=10'} + hasBin: true dependencies: chokidar: 3.6.0 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) ignore-by-default: 1.0.1 minimatch: 3.1.2 pstree.remy: 1.1.8 - semver: 7.7.2 + semver: 7.7.3 simple-update-notifier: 2.0.0 supports-color: 5.5.0 touch: 3.1.1 undefsafe: 2.0.5 + dev: true - normalize-path@3.0.0: {} + /normalize-path@3.0.0: + resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==} + engines: {node: '>=0.10.0'} + dev: true - npm-run-path@4.0.1: + /npm-run-path@4.0.1: + resolution: {integrity: sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==} + engines: {node: '>=8'} dependencies: path-key: 3.1.1 - npm-run-path@5.3.0: + /npm-run-path@5.3.0: + resolution: {integrity: sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: path-key: 4.0.0 + dev: true - nth-check@2.1.1: + /nth-check@2.1.1: + resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==} dependencies: boolbase: 1.0.0 + dev: true - nypm@0.6.0: + /nwsapi@2.2.23: + resolution: {integrity: sha512-7wfH4sLbt4M0gCDzGE6vzQBo0bfTKjU7Sfpqy/7gs1qBfYz2vEJH6vXcBKpO3+6Yu1telwd0t9HpyOoLEQQbIQ==} + dev: true + + /nypm@0.6.2: + resolution: {integrity: sha512-7eM+hpOtrKrBDCh7Ypu2lJ9Z7PNZBdi/8AT3AX8xoCj43BBVHD0hPSTEvMtkMpfs8FCqBGhxB+uToIQimA111g==} + engines: {node: ^14.16.0 || >=16.10.0} + hasBin: true dependencies: citty: 0.1.6 consola: 3.4.2 pathe: 2.0.3 - pkg-types: 2.1.0 - tinyexec: 0.3.2 + pkg-types: 2.3.0 + tinyexec: 1.0.2 + dev: true - object-assign@4.1.1: {} + /object-assign@4.1.1: + resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==} + engines: {node: '>=0.10.0'} - object-inspect@1.13.4: {} + /object-inspect@1.13.4: + resolution: {integrity: sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==} + engines: {node: '>= 0.4'} - ofetch@1.4.1: + /ofetch@1.5.1: + resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==} dependencies: destr: 2.0.5 - node-fetch-native: 1.6.6 + node-fetch-native: 1.6.7 ufo: 1.6.1 + dev: true - ohash@2.0.11: {} + /ohash@2.0.11: + resolution: {integrity: sha512-RdR9FQrFwNBNXAr4GixM8YaRZRJ5PUWbKYbE5eOsrwAjJW0q2REGcf79oYPsLyskQCZG1PLN+S/K1V00joZAoQ==} + dev: true - on-exit-leak-free@2.1.2: {} + /on-exit-leak-free@2.1.2: + resolution: {integrity: sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA==} + engines: {node: '>=14.0.0'} - on-finished@2.4.1: + /on-finished@2.4.1: + resolution: {integrity: sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==} + engines: {node: '>= 0.8'} dependencies: ee-first: 1.1.1 + dev: false - once@1.4.0: + /once@1.4.0: + resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==} dependencies: wrappy: 1.0.2 - onetime@5.1.2: + /onetime@5.1.2: + resolution: {integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==} + engines: {node: '>=6'} dependencies: mimic-fn: 2.1.0 - onetime@6.0.0: + /onetime@6.0.0: + resolution: {integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==} + engines: {node: '>=12'} dependencies: mimic-fn: 4.0.0 + dev: true - onetime@7.0.0: + /onetime@7.0.0: + resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==} + engines: {node: '>=18'} dependencies: mimic-function: 5.0.1 + dev: true - onnx-proto@4.0.4: + /onnx-proto@4.0.4: + resolution: {integrity: sha512-aldMOB3HRoo6q/phyB6QRQxSt895HNNw82BNyZ2CMh4bjeKv7g/c+VpAFtJuEMVfYLMbRx61hbuqnKceLeDcDA==} dependencies: protobufjs: 6.11.4 + dev: false - onnxruntime-common@1.14.0: {} + /onnxruntime-common@1.14.0: + resolution: {integrity: sha512-3LJpegM2iMNRX2wUmtYfeX/ytfOzNwAWKSq1HbRrKc9+uqG/FsEA0bbKZl1btQeZaXhC26l44NWpNUeXPII7Ew==} + dev: false - onnxruntime-node@1.14.0: + /onnxruntime-node@1.14.0: + resolution: {integrity: sha512-5ba7TWomIV/9b6NH/1x/8QEeowsb+jBEvFzU6z0T4mNsFwdPqXeFUM7uxC6QeSRkEbWu3qEB0VMjrvzN/0S9+w==} + os: [win32, darwin, linux] + requiresBuild: true dependencies: onnxruntime-common: 1.14.0 + dev: false optional: true - onnxruntime-web@1.14.0: + /onnxruntime-web@1.14.0: + resolution: {integrity: sha512-Kcqf43UMfW8mCydVGcX9OMXI2VN17c0p6XvR7IPSZzBf/6lteBzXHvcEVWDPmCKuGombl997HgLqj91F11DzXw==} dependencies: flatbuffers: 1.12.0 guid-typescript: 1.0.9 @@ -8103,28 +7636,30 @@ snapshots: onnx-proto: 4.0.4 onnxruntime-common: 1.14.0 platform: 1.3.6 + dev: false - open@10.1.2: + /open@10.2.0: + resolution: {integrity: sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==} + engines: {node: '>=18'} dependencies: - default-browser: 5.2.1 + default-browser: 5.4.0 define-lazy-prop: 3.0.0 is-inside-container: 1.0.0 - is-wsl: 3.1.0 + wsl-utils: 0.1.0 + dev: true - open@8.4.2: + /open@8.4.2: + resolution: {integrity: sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==} + engines: {node: '>=12'} dependencies: define-lazy-prop: 2.0.0 is-docker: 2.2.1 is-wsl: 2.2.0 + dev: true - open@9.1.0: - dependencies: - default-browser: 4.0.0 - define-lazy-prop: 3.0.0 - is-inside-container: 1.0.0 - is-wsl: 2.2.0 - - optionator@0.9.4: + /optionator@0.9.4: + resolution: {integrity: sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==} + engines: {node: '>= 0.8.0'} dependencies: deep-is: 0.1.4 fast-levenshtein: 2.0.6 @@ -8132,22 +7667,13 @@ snapshots: prelude-ls: 1.2.1 type-check: 0.4.0 word-wrap: 1.2.5 + dev: true - ora@6.3.1: - dependencies: - chalk: 5.4.1 - cli-cursor: 4.0.0 - cli-spinners: 2.9.2 - is-interactive: 2.0.0 - is-unicode-supported: 1.3.0 - log-symbols: 5.1.0 - stdin-discarder: 0.1.0 - strip-ansi: 7.1.0 - wcwidth: 1.0.1 - - ora@8.2.0: + /ora@8.2.0: + resolution: {integrity: sha512-weP+BZ8MVNnlCm8c0Qdc1WSWq4Qn7I+9CJGm7Qali6g44e/PUzbjNqJX5NJ9ljlNMosfJvg1fKEGILklK9cwnw==} + engines: {node: '>=18'} dependencies: - chalk: 5.4.1 + chalk: 5.6.2 cli-cursor: 5.0.0 cli-spinners: 2.9.2 is-interactive: 2.0.0 @@ -8155,155 +7681,291 @@ snapshots: log-symbols: 6.0.0 stdin-discarder: 0.2.2 string-width: 7.2.0 - strip-ansi: 7.1.0 + strip-ansi: 7.1.2 + dev: true - os-shim@0.1.3: {} + /os-shim@0.1.3: + resolution: {integrity: sha512-jd0cvB8qQ5uVt0lvCIexBaROw1KyKm5sbulg2fWOHjETisuCzWyt+eTZKEMs8v6HwzoGs8xik26jg7eCM6pS+A==} + engines: {node: '>= 0.4.0'} + dev: true - p-limit@2.3.0: + /p-limit@2.3.0: + resolution: {integrity: sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==} + engines: {node: '>=6'} dependencies: p-try: 2.2.0 + dev: true - p-limit@3.1.0: + /p-limit@3.1.0: + resolution: {integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==} + engines: {node: '>=10'} dependencies: yocto-queue: 0.1.0 + dev: true - p-limit@4.0.0: + /p-limit@4.0.0: + resolution: {integrity: sha512-5b0R4txpzjPWVw/cXXUResoD4hb6U/x9BH08L7nw+GN1sezDzPdxeRvpc9c433fZhBan/wusjbCsqwqm4EIBIQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: - yocto-queue: 1.2.1 + yocto-queue: 1.2.2 + dev: true - p-locate@4.1.0: + /p-locate@4.1.0: + resolution: {integrity: sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==} + engines: {node: '>=8'} dependencies: p-limit: 2.3.0 + dev: true - p-locate@5.0.0: + /p-locate@5.0.0: + resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==} + engines: {node: '>=10'} dependencies: p-limit: 3.1.0 + dev: true - p-locate@6.0.0: + /p-locate@6.0.0: + resolution: {integrity: sha512-wPrq66Llhl7/4AGC6I+cqxT07LhXvWL08LNXz1fENOw0Ap4sRZZ/gZpTTJ5jpurzzzfS2W/Ge9BY3LgLjCShcw==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} dependencies: p-limit: 4.0.0 + dev: true - p-map@7.0.3: {} + /p-map@7.0.4: + resolution: {integrity: sha512-tkAQEw8ysMzmkhgw8k+1U/iPhWNhykKnSk4Rd5zLoPJCuJaGRPo6YposrZgaxHKzDHdDWWZvE/Sk7hsL2X/CpQ==} + engines: {node: '>=18'} + dev: true - p-try@2.2.0: {} + /p-try@2.2.0: + resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==} + engines: {node: '>=6'} + dev: true - package-json-from-dist@1.0.1: {} + /package-json-from-dist@1.0.1: + resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==} + dev: true - package-json@10.0.1: + /package-json@10.0.1: + resolution: {integrity: sha512-ua1L4OgXSBdsu1FPb7F3tYH0F48a6kxvod4pLUlGY9COeJAJQNX/sNH2IiEmsxw7lqYiAwrdHMjz1FctOsyDQg==} + engines: {node: '>=18'} dependencies: - ky: 1.8.1 + ky: 1.14.1 registry-auth-token: 5.1.0 registry-url: 6.0.1 - semver: 7.7.2 + semver: 7.7.3 + dev: true + + /package-manager-detector@0.2.11: + resolution: {integrity: sha512-BEnLolu+yuz22S56CU1SUKq3XC3PkwD5wv4ikR4MfGvnRVcmzXR9DwSlW2fEamyTPyXHomBJRzgapeuBvRNzJQ==} + dependencies: + quansync: 0.2.11 + dev: true + + /package-manager-detector@1.6.0: + resolution: {integrity: sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA==} + dev: true - pako@1.0.11: {} + /pako@1.0.11: + resolution: {integrity: sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==} + dev: true - parent-module@1.0.1: + /parent-module@1.0.1: + resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==} + engines: {node: '>=6'} dependencies: callsites: 3.1.0 + dev: true - parse-json@5.2.0: + /parse-json@5.2.0: + resolution: {integrity: sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==} + engines: {node: '>=8'} dependencies: '@babel/code-frame': 7.27.1 - error-ex: 1.3.2 + error-ex: 1.3.4 json-parse-even-better-errors: 2.3.1 lines-and-columns: 1.2.4 + dev: true - parse-json@7.1.1: + /parse-json@7.1.1: + resolution: {integrity: sha512-SgOTCX/EZXtZxBE5eJ97P4yGM5n37BwRU+YMsH4vNzFqJV/oWFXXCmwFlgWUM4PrakybVOueJJ6pwHqSVhTFDw==} + engines: {node: '>=16'} dependencies: '@babel/code-frame': 7.27.1 - error-ex: 1.3.2 + error-ex: 1.3.4 json-parse-even-better-errors: 3.0.2 lines-and-columns: 2.0.4 type-fest: 3.13.1 + dev: true - parse5-htmlparser2-tree-adapter@6.0.1: + /parse5@7.3.0: + resolution: {integrity: sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==} dependencies: - parse5: 6.0.1 - - parse5@5.1.1: {} - - parse5@6.0.1: {} + entities: 6.0.1 + dev: true - parseurl@1.3.3: {} + /parseurl@1.3.3: + resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==} + engines: {node: '>= 0.8'} + dev: false - path-browserify@1.0.1: {} + /path-browserify@1.0.1: + resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==} + dev: true - path-exists@4.0.0: {} + /path-exists@4.0.0: + resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==} + engines: {node: '>=8'} + dev: true - path-exists@5.0.0: {} + /path-exists@5.0.0: + resolution: {integrity: sha512-RjhtfwJOxzcFmNOi6ltcbcu4Iu+FL3zEj83dk4kAS+fVpTxXLO1b38RvJgT/0QwvV/L3aY9TAnyv0EOqW4GoMQ==} + engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} + dev: true - path-is-absolute@1.0.1: {} + /path-is-absolute@1.0.1: + resolution: {integrity: sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==} + engines: {node: '>=0.10.0'} + dev: true - path-key@3.1.1: {} + /path-key@3.1.1: + resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==} + engines: {node: '>=8'} - path-key@4.0.0: {} + /path-key@4.0.0: + resolution: {integrity: sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==} + engines: {node: '>=12'} + dev: true - path-parse@1.0.7: {} + /path-parse@1.0.7: + resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==} + dev: true - path-scurry@1.11.1: + /path-scurry@1.11.1: + resolution: {integrity: sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==} + engines: {node: '>=16 || 14 >=14.18'} dependencies: lru-cache: 10.4.3 minipass: 7.1.2 + dev: true - path-scurry@2.0.0: + /path-scurry@2.0.1: + resolution: {integrity: sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==} + engines: {node: 20 || >=22} dependencies: - lru-cache: 11.1.0 + lru-cache: 11.2.4 minipass: 7.1.2 + dev: true + + /path-to-regexp@8.3.0: + resolution: {integrity: sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==} + dev: false - path-to-regexp@8.2.0: {} + /pathe@1.1.2: + resolution: {integrity: sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==} + dev: true + + /pathe@2.0.3: + resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==} + dev: true - pathe@2.0.3: {} + /pathval@2.0.1: + resolution: {integrity: sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==} + engines: {node: '>= 14.16'} + dev: true - pend@1.2.0: {} + /perfect-debounce@2.0.0: + resolution: {integrity: sha512-fkEH/OBiKrqqI/yIgjR92lMfs2K8105zt/VT6+7eTjNwisrsh47CeIED9z58zI7DfKdH3uHAn25ziRZn3kgAow==} + dev: true - perfect-debounce@1.0.0: {} + /picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} - picocolors@1.1.1: {} + /picomatch@2.3.1: + resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==} + engines: {node: '>=8.6'} + dev: true - picomatch@2.3.1: {} + /picomatch@4.0.3: + resolution: {integrity: sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==} + engines: {node: '>=12'} + dev: true - picomatch@4.0.2: {} + /pidtree@0.6.0: + resolution: {integrity: sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==} + engines: {node: '>=0.10'} + hasBin: true + dev: true - pidtree@0.6.0: {} + /pino-abstract-transport@2.0.0: + resolution: {integrity: sha512-F63x5tizV6WCh4R6RHyi2Ml+M70DNRXt/+HANowMflpgGFMAym/VKm6G7ZOQRjqN7XbGxK1Lg9t6ZrtzOaivMw==} + dependencies: + split2: 4.2.0 - pino-abstract-transport@2.0.0: + /pino-abstract-transport@3.0.0: + resolution: {integrity: sha512-wlfUczU+n7Hy/Ha5j9a/gZNy7We5+cXp8YL+X+PG8S0KXxw7n/JXA3c46Y0zQznIJ83URJiwy7Lh56WLokNuxg==} dependencies: split2: 4.2.0 + dev: true - pino-pretty@13.0.0: + /pino-pretty@13.1.3: + resolution: {integrity: sha512-ttXRkkOz6WWC95KeY9+xxWL6AtImwbyMHrL1mSwqwW9u+vLp/WIElvHvCSDg0xO/Dzrggz1zv3rN5ovTRVowKg==} + hasBin: true dependencies: colorette: 2.0.20 dateformat: 4.6.3 - fast-copy: 3.0.2 + fast-copy: 4.0.1 fast-safe-stringify: 2.1.1 help-me: 5.0.0 joycon: 3.1.1 minimist: 1.2.8 on-exit-leak-free: 2.1.2 - pino-abstract-transport: 2.0.0 - pump: 3.0.2 - secure-json-parse: 2.7.0 + pino-abstract-transport: 3.0.0 + pump: 3.0.3 + secure-json-parse: 4.1.0 sonic-boom: 4.2.0 - strip-json-comments: 3.1.1 + strip-json-comments: 5.0.3 + dev: true - pino-std-serializers@7.0.0: {} + /pino-std-serializers@7.0.0: + resolution: {integrity: sha512-e906FRY0+tV27iq4juKzSYPbUj2do2X2JX4EzSca1631EB2QJQUqGbDuERal7LCtOpxl6x3+nvo9NPZcmjkiFA==} - pino@9.6.0: + /pino@10.1.0: + resolution: {integrity: sha512-0zZC2ygfdqvqK8zJIr1e+wT1T/L+LF6qvqvbzEQ6tiMAoTqEVK9a1K3YRu8HEUvGEvNqZyPJTtb2sNIoTkB83w==} + hasBin: true dependencies: + '@pinojs/redact': 0.4.0 atomic-sleep: 1.0.0 - fast-redact: 3.5.0 on-exit-leak-free: 2.1.2 pino-abstract-transport: 2.0.0 pino-std-serializers: 7.0.0 - process-warning: 4.0.1 + process-warning: 5.0.0 + quick-format-unescaped: 4.0.4 + real-require: 0.2.0 + safe-stable-stringify: 2.5.0 + sonic-boom: 4.2.0 + thread-stream: 3.1.0 + dev: false + + /pino@9.14.0: + resolution: {integrity: sha512-8OEwKp5juEvb/MjpIc4hjqfgCNysrS94RIOMXYvpYCdm/jglrKEiAYmiumbmGhCvs+IcInsphYDFwqrjr7398w==} + hasBin: true + dependencies: + '@pinojs/redact': 0.4.0 + atomic-sleep: 1.0.0 + on-exit-leak-free: 2.1.2 + pino-abstract-transport: 2.0.0 + pino-std-serializers: 7.0.0 + process-warning: 5.0.0 quick-format-unescaped: 4.0.4 real-require: 0.2.0 safe-stable-stringify: 2.5.0 sonic-boom: 4.2.0 thread-stream: 3.1.0 + dev: false - pino@9.7.0: + /pino@9.7.0: + resolution: {integrity: sha512-vnMCM6xZTb1WDmLvtG2lE/2p+t9hDEIvTWJsu6FejkE62vB7gDhvzrpFR4Cw2to+9JNQxVnkAKVPA1KPB98vWg==} + hasBin: true dependencies: atomic-sleep: 1.0.0 fast-redact: 3.5.0 @@ -8316,91 +7978,155 @@ snapshots: safe-stable-stringify: 2.5.0 sonic-boom: 4.2.0 thread-stream: 3.1.0 + dev: true - pirates@4.0.7: {} + /pirates@4.0.7: + resolution: {integrity: sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==} + engines: {node: '>= 6'} + dev: true - pkce-challenge@5.0.0: {} + /pkce-challenge@5.0.1: + resolution: {integrity: sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==} + engines: {node: '>=16.20.0'} + dev: false - pkg-dir@4.2.0: + /pkg-dir@4.2.0: + resolution: {integrity: sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==} + engines: {node: '>=8'} dependencies: find-up: 4.1.0 + dev: true - pkg-types@1.3.1: + /pkg-types@1.3.1: + resolution: {integrity: sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ==} dependencies: confbox: 0.1.8 - mlly: 1.7.4 + mlly: 1.8.0 pathe: 2.0.3 + dev: true - pkg-types@2.1.0: + /pkg-types@2.3.0: + resolution: {integrity: sha512-SIqCzDRg0s9npO5XQ3tNZioRY1uK06lA41ynBC1YmFTmnY6FjUjVt6s4LoADmwoig1qqD0oK8h1p/8mlMx8Oig==} dependencies: confbox: 0.2.2 - exsolve: 1.0.5 + exsolve: 1.0.8 pathe: 2.0.3 + dev: true - platform@1.3.6: {} + /platform@1.3.6: + resolution: {integrity: sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg==} + dev: false - postcss-load-config@6.0.1(jiti@2.4.2)(postcss@8.5.4)(yaml@2.8.0): + /postcss-load-config@6.0.1: + resolution: {integrity: sha512-oPtTM4oerL+UXmx+93ytZVN82RrlY/wPUV8IeDxFrzIjXOLF1pN+EmKPLbubvKHT2HC20xXsCAH2Z+CKV6Oz/g==} + engines: {node: '>= 18'} + peerDependencies: + jiti: '>=1.21.0' + postcss: '>=8.0.9' + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + jiti: + optional: true + postcss: + optional: true + tsx: + optional: true + yaml: + optional: true dependencies: lilconfig: 3.1.3 - optionalDependencies: - jiti: 2.4.2 - postcss: 8.5.4 - yaml: 2.8.0 + dev: true - postcss-selector-parser@6.1.2: + /postcss-selector-parser@7.1.1: + resolution: {integrity: sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==} + engines: {node: '>=4'} dependencies: cssesc: 3.0.0 util-deprecate: 1.0.2 + dev: true - postcss@8.5.4: + /postcss@8.5.6: + resolution: {integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==} + engines: {node: ^10 || ^12 || >=14} dependencies: nanoid: 3.3.11 picocolors: 1.1.1 source-map-js: 1.2.1 - prebuild-install@7.1.3: + /prebuild-install@7.1.3: + resolution: {integrity: sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==} + engines: {node: '>=10'} + hasBin: true dependencies: - detect-libc: 2.0.4 + detect-libc: 2.1.2 expand-template: 2.0.3 github-from-package: 0.0.0 minimist: 1.2.8 mkdirp-classic: 0.5.3 napi-build-utils: 2.0.0 - node-abi: 3.75.0 - pump: 3.0.2 + node-abi: 3.85.0 + pump: 3.0.3 rc: 1.2.8 simple-get: 4.0.1 - tar-fs: 2.1.3 + tar-fs: 2.1.4 tunnel-agent: 0.6.0 + dev: false - prelude-ls@1.2.1: {} + /prelude-ls@1.2.1: + resolution: {integrity: sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==} + engines: {node: '>= 0.8.0'} + dev: true - prettier@3.5.3: {} + /prettier@3.7.4: + resolution: {integrity: sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==} + engines: {node: '>=14'} + hasBin: true + dev: true - pretty-format@29.7.0: + /pretty-format@29.7.0: + resolution: {integrity: sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==} + engines: {node: ^14.15.0 || ^16.10.0 || >=18.0.0} dependencies: '@jest/schemas': 29.6.3 ansi-styles: 5.2.0 react-is: 18.3.1 + dev: true - process-nextick-args@2.0.1: {} + /process-nextick-args@2.0.1: + resolution: {integrity: sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==} + dev: true - process-warning@4.0.1: {} + /process-warning@4.0.1: + resolution: {integrity: sha512-3c2LzQ3rY9d0hc1emcsHhfT9Jwz0cChib/QN89oME2R451w5fy3f0afAhERFZAwrbDU43wk12d0ORBpDVME50Q==} + dev: false - process-warning@5.0.0: {} + /process-warning@5.0.0: + resolution: {integrity: sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA==} - promise-toolbox@0.21.0: + /promise-toolbox@0.21.0: + resolution: {integrity: sha512-NV8aTmpwrZv+Iys54sSFOBx3tuVaOBvvrft5PNppnxy9xpU/akHbaWIril22AB22zaPgrgwKdD0KsrM0ptUtpg==} + engines: {node: '>=6'} dependencies: make-error: 1.3.6 + dev: true - prompts@2.4.2: + /prompts@2.4.2: + resolution: {integrity: sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==} + engines: {node: '>= 6'} dependencies: kleur: 3.0.3 sisteransi: 1.0.5 + dev: true - proto-list@1.2.4: {} + /proto-list@1.2.4: + resolution: {integrity: sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==} + dev: true - protobufjs@6.11.4: + /protobufjs@6.11.4: + resolution: {integrity: sha512-5kQWPaJHi1WoCpjTGszzQ32PG2F4+wRY6BmAT4Vfw56Q2FZ4YZzK20xUYQH4YkfehY1e6QSICrJquM6xXZNcrw==} + hasBin: true + requiresBuild: true dependencies: '@protobufjs/aspromise': 1.1.2 '@protobufjs/base64': 1.1.2 @@ -8413,83 +8139,117 @@ snapshots: '@protobufjs/pool': 1.1.0 '@protobufjs/utf8': 1.1.0 '@types/long': 4.0.2 - '@types/node': 22.15.30 + '@types/node': 22.19.2 long: 4.0.0 + dev: false - proxy-addr@2.0.7: + /proxy-addr@2.0.7: + resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==} + engines: {node: '>= 0.10'} dependencies: forwarded: 0.2.0 ipaddr.js: 1.9.1 + dev: false - pstree.remy@1.1.8: {} + /pstree.remy@1.1.8: + resolution: {integrity: sha512-77DZwxQmxKnu3aR542U+X8FypNzbfJ+C5XQDk3uWjWxn6151aIMGthWYRXTqT1E5oJvg+ljaa2OJi+VfvCOQ8w==} + dev: true - publish-browser-extension@3.0.0: + /publish-browser-extension@3.0.3: + resolution: {integrity: sha512-cBINZCkLo7YQaGoUvEHthZ0sDzgJQht28IS+SFMT2omSNhGsPiVNRkWir3qLiTrhGhW9Ci2KVHpA1QAMoBdL2g==} + hasBin: true dependencies: cac: 6.7.14 - cli-highlight: 2.1.11 consola: 3.4.2 - dotenv: 16.5.0 - extract-zip: 2.0.1 + dotenv: 17.2.3 + form-data-encoder: 4.1.0 formdata-node: 6.0.3 listr2: 8.3.3 - lodash.camelcase: 4.3.0 - lodash.kebabcase: 4.1.1 - lodash.snakecase: 4.1.1 - ofetch: 1.4.1 - open: 9.1.0 - ora: 6.3.1 - prompts: 2.4.2 - zod: 3.25.56 - transitivePeerDependencies: - - supports-color + ofetch: 1.5.1 + zod: 3.25.76 + dev: true - pump@3.0.2: + /pump@3.0.3: + resolution: {integrity: sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==} dependencies: - end-of-stream: 1.4.4 + end-of-stream: 1.4.5 once: 1.4.0 - punycode@2.3.1: {} + /punycode.js@2.3.1: + resolution: {integrity: sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==} + engines: {node: '>=6'} + dev: false + + /punycode@2.3.1: + resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==} + engines: {node: '>=6'} + dev: true - pupa@3.1.0: + /pupa@3.3.0: + resolution: {integrity: sha512-LjgDO2zPtoXP2wJpDjZrGdojii1uqO0cnwKoIoUzkfS98HDmbeiGmYiXo3lXeFlq2xvne1QFQhwYXSUCLKtEuA==} + engines: {node: '>=12.20'} dependencies: escape-goat: 4.0.0 + dev: true - pure-rand@6.1.0: {} + /pure-rand@6.1.0: + resolution: {integrity: sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==} + dev: true - qs@6.14.0: + /qs@6.14.0: + resolution: {integrity: sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==} + engines: {node: '>=0.6'} dependencies: side-channel: 1.1.0 - quansync@0.2.10: {} + /quansync@0.2.11: + resolution: {integrity: sha512-AifT7QEbW9Nri4tAwR5M/uzpBuqfZf+zwaEM/QkzEjj7NBuFD2rBuy0K3dE+8wltbezDV7JMA0WfnCPYRSYbXA==} + dev: true - queue-microtask@1.2.3: {} + /queue-microtask@1.2.3: + resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==} + dev: true - quick-format-unescaped@4.0.4: {} + /quick-format-unescaped@4.0.4: + resolution: {integrity: sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg==} - range-parser@1.2.1: {} + /range-parser@1.2.1: + resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==} + engines: {node: '>= 0.6'} + dev: false - raw-body@3.0.0: + /raw-body@3.0.2: + resolution: {integrity: sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==} + engines: {node: '>= 0.10'} dependencies: bytes: 3.1.2 - http-errors: 2.0.0 - iconv-lite: 0.6.3 + http-errors: 2.0.1 + iconv-lite: 0.7.1 unpipe: 1.0.0 + dev: false - rc9@2.1.2: + /rc9@2.1.2: + resolution: {integrity: sha512-btXCnMmRIBINM2LDZoEmOogIZU7Qe7zn4BpomSKZ/ykbLObuBdvG+mFq11DL6fjH1DRwHhrlgtYWG96bJiC7Cg==} dependencies: defu: 6.1.4 destr: 2.0.5 + dev: true - rc@1.2.8: + /rc@1.2.8: + resolution: {integrity: sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==} + hasBin: true dependencies: deep-extend: 0.6.0 ini: 1.3.8 minimist: 1.2.8 strip-json-comments: 2.0.1 - react-is@18.3.1: {} + /react-is@18.3.1: + resolution: {integrity: sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==} + dev: true - readable-stream@2.3.8: + /readable-stream@2.3.8: + resolution: {integrity: sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==} dependencies: core-util-is: 1.0.3 inherits: 2.0.4 @@ -8498,163 +8258,255 @@ snapshots: safe-buffer: 5.1.2 string_decoder: 1.1.1 util-deprecate: 1.0.2 + dev: true - readable-stream@3.6.2: + /readable-stream@3.6.2: + resolution: {integrity: sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==} + engines: {node: '>= 6'} dependencies: inherits: 2.0.4 string_decoder: 1.3.0 util-deprecate: 1.0.2 + dev: false - readdirp@3.6.0: + /readdirp@3.6.0: + resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==} + engines: {node: '>=8.10.0'} dependencies: picomatch: 2.3.1 + dev: true - readdirp@4.1.2: {} - - real-require@0.2.0: {} + /readdirp@4.1.2: + resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==} + engines: {node: '>= 14.18.0'} + dev: true - regenerator-runtime@0.14.1: {} + /real-require@0.2.0: + resolution: {integrity: sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg==} + engines: {node: '>= 12.13.0'} - registry-auth-token@5.1.0: + /registry-auth-token@5.1.0: + resolution: {integrity: sha512-GdekYuwLXLxMuFTwAPg5UKGLW/UXzQrZvH/Zj791BQif5T05T0RsaLfHc9q3ZOKi7n+BoprPD9mJ0O0k4xzUlw==} + engines: {node: '>=14'} dependencies: '@pnpm/npm-conf': 2.3.1 + dev: true - registry-url@6.0.1: + /registry-url@6.0.1: + resolution: {integrity: sha512-+crtS5QjFRqFCoQmvGduwYWEBng99ZvmFvF+cUJkGYF1L1BfU8C6Zp9T7f5vPAwyLkUExpvK+ANVZmGU49qi4Q==} + engines: {node: '>=12'} dependencies: rc: 1.2.8 + dev: true - require-directory@2.1.1: {} + /require-directory@2.1.1: + resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==} + engines: {node: '>=0.10.0'} + dev: true - require-from-string@2.0.2: {} + /require-from-string@2.0.2: + resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==} + engines: {node: '>=0.10.0'} - resolve-cwd@3.0.0: + /resolve-cwd@3.0.0: + resolution: {integrity: sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==} + engines: {node: '>=8'} dependencies: resolve-from: 5.0.0 + dev: true - resolve-from@4.0.0: {} + /resolve-from@4.0.0: + resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==} + engines: {node: '>=4'} + dev: true - resolve-from@5.0.0: {} + /resolve-from@5.0.0: + resolution: {integrity: sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==} + engines: {node: '>=8'} + dev: true - resolve.exports@2.0.3: {} + /resolve.exports@2.0.3: + resolution: {integrity: sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==} + engines: {node: '>=10'} + dev: true - resolve@1.22.10: + /resolve@1.22.11: + resolution: {integrity: sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==} + engines: {node: '>= 0.4'} + hasBin: true dependencies: is-core-module: 2.16.1 path-parse: 1.0.7 supports-preserve-symlinks-flag: 1.0.0 + dev: true - restore-cursor@4.0.0: - dependencies: - onetime: 5.1.2 - signal-exit: 3.0.7 - - restore-cursor@5.1.0: + /restore-cursor@5.1.0: + resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==} + engines: {node: '>=18'} dependencies: onetime: 7.0.0 signal-exit: 4.1.0 + dev: true - ret@0.5.0: {} + /ret@0.5.0: + resolution: {integrity: sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==} + engines: {node: '>=10'} + dev: false - reusify@1.1.0: {} + /reusify@1.1.0: + resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==} + engines: {iojs: '>=1.0.0', node: '>=0.10.0'} - rfdc@1.4.1: {} + /rfdc@1.4.1: + resolution: {integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==} - rimraf@5.0.10: + /rimraf@5.0.10: + resolution: {integrity: sha512-l0OE8wL34P4nJH/H2ffoaniAokM2qSmrtXHmlpvYr5AVVX8msAyW0l8NVJFDxlSK4u3Uh/f41cQheDVdnYijwQ==} + hasBin: true dependencies: - glob: 10.4.5 + glob: 10.5.0 + dev: true - rimraf@6.0.1: + /rimraf@6.1.2: + resolution: {integrity: sha512-cFCkPslJv7BAXJsYlK1dZsbP8/ZNLkCAQ0bi1hf5EKX2QHegmDFEFA6QhuYJlk7UDdc+02JjO80YSOrWPpw06g==} + engines: {node: 20 || >=22} + hasBin: true dependencies: - glob: 11.0.2 + glob: 13.0.0 package-json-from-dist: 1.0.1 + dev: true - rollup@4.42.0: + /rollup@4.53.3: + resolution: {integrity: sha512-w8GmOxZfBmKknvdXU1sdM9NHcoQejwF/4mNgj2JuEEdRaHwwF12K7e9eXn1nLZ07ad+du76mkVsyeb2rKGllsA==} + engines: {node: '>=18.0.0', npm: '>=8.0.0'} + hasBin: true dependencies: - '@types/estree': 1.0.7 + '@types/estree': 1.0.8 optionalDependencies: - '@rollup/rollup-android-arm-eabi': 4.42.0 - '@rollup/rollup-android-arm64': 4.42.0 - '@rollup/rollup-darwin-arm64': 4.42.0 - '@rollup/rollup-darwin-x64': 4.42.0 - '@rollup/rollup-freebsd-arm64': 4.42.0 - '@rollup/rollup-freebsd-x64': 4.42.0 - '@rollup/rollup-linux-arm-gnueabihf': 4.42.0 - '@rollup/rollup-linux-arm-musleabihf': 4.42.0 - '@rollup/rollup-linux-arm64-gnu': 4.42.0 - '@rollup/rollup-linux-arm64-musl': 4.42.0 - '@rollup/rollup-linux-loongarch64-gnu': 4.42.0 - '@rollup/rollup-linux-powerpc64le-gnu': 4.42.0 - '@rollup/rollup-linux-riscv64-gnu': 4.42.0 - '@rollup/rollup-linux-riscv64-musl': 4.42.0 - '@rollup/rollup-linux-s390x-gnu': 4.42.0 - '@rollup/rollup-linux-x64-gnu': 4.42.0 - '@rollup/rollup-linux-x64-musl': 4.42.0 - '@rollup/rollup-win32-arm64-msvc': 4.42.0 - '@rollup/rollup-win32-ia32-msvc': 4.42.0 - '@rollup/rollup-win32-x64-msvc': 4.42.0 + '@rollup/rollup-android-arm-eabi': 4.53.3 + '@rollup/rollup-android-arm64': 4.53.3 + '@rollup/rollup-darwin-arm64': 4.53.3 + '@rollup/rollup-darwin-x64': 4.53.3 + '@rollup/rollup-freebsd-arm64': 4.53.3 + '@rollup/rollup-freebsd-x64': 4.53.3 + '@rollup/rollup-linux-arm-gnueabihf': 4.53.3 + '@rollup/rollup-linux-arm-musleabihf': 4.53.3 + '@rollup/rollup-linux-arm64-gnu': 4.53.3 + '@rollup/rollup-linux-arm64-musl': 4.53.3 + '@rollup/rollup-linux-loong64-gnu': 4.53.3 + '@rollup/rollup-linux-ppc64-gnu': 4.53.3 + '@rollup/rollup-linux-riscv64-gnu': 4.53.3 + '@rollup/rollup-linux-riscv64-musl': 4.53.3 + '@rollup/rollup-linux-s390x-gnu': 4.53.3 + '@rollup/rollup-linux-x64-gnu': 4.53.3 + '@rollup/rollup-linux-x64-musl': 4.53.3 + '@rollup/rollup-openharmony-arm64': 4.53.3 + '@rollup/rollup-win32-arm64-msvc': 4.53.3 + '@rollup/rollup-win32-ia32-msvc': 4.53.3 + '@rollup/rollup-win32-x64-gnu': 4.53.3 + '@rollup/rollup-win32-x64-msvc': 4.53.3 fsevents: 2.3.3 + dev: true - router@2.2.0: + /router@2.2.0: + resolution: {integrity: sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==} + engines: {node: '>= 18'} dependencies: - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) depd: 2.0.0 is-promise: 4.0.0 parseurl: 1.3.3 - path-to-regexp: 8.2.0 + path-to-regexp: 8.3.0 transitivePeerDependencies: - supports-color + dev: false - run-applescript@5.0.0: - dependencies: - execa: 5.1.1 + /rrweb-cssom@0.8.0: + resolution: {integrity: sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==} + dev: true - run-applescript@7.0.0: {} + /run-applescript@7.1.0: + resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==} + engines: {node: '>=18'} + dev: true - run-parallel@1.2.0: + /run-parallel@1.2.0: + resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==} dependencies: queue-microtask: 1.2.3 + dev: true - safe-buffer@5.1.2: {} + /safe-buffer@5.1.2: + resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==} + dev: true - safe-buffer@5.2.1: {} + /safe-buffer@5.2.1: + resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==} + dev: false - safe-regex2@5.0.0: + /safe-regex2@5.0.0: + resolution: {integrity: sha512-YwJwe5a51WlK7KbOJREPdjNrpViQBI3p4T50lfwPuDhZnE3XGVTlGvi+aolc5+RvxDD6bnUmjVsU9n1eboLUYw==} dependencies: ret: 0.5.0 + dev: false - safe-stable-stringify@2.5.0: {} + /safe-stable-stringify@2.5.0: + resolution: {integrity: sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==} + engines: {node: '>=10'} - safer-buffer@2.1.2: {} + /safer-buffer@2.1.2: + resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==} - sax@1.4.1: {} + /sax@1.4.3: + resolution: {integrity: sha512-yqYn1JhPczigF94DMS+shiDMjDowYO6y9+wB/4WgO0Y19jWYk0lQ4tuG5KI7kj4FTp1wxPj5IFfcrz/s1c3jjQ==} + dev: true - scule@1.3.0: {} + /saxes@6.0.0: + resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==} + engines: {node: '>=v12.22.7'} + dependencies: + xmlchars: 2.2.0 + dev: true - secure-json-parse@2.7.0: {} + /scule@1.3.0: + resolution: {integrity: sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==} + dev: true - secure-json-parse@4.0.0: {} + /secure-json-parse@4.1.0: + resolution: {integrity: sha512-l4KnYfEyqYJxDwlNVyRfO2E4NTHfMKAWdUuA8J0yve2Dz/E/PdBepY03RvyJpssIpRFwJoCD55wA+mEDs6ByWA==} - semver@6.3.1: {} + /semver@6.3.1: + resolution: {integrity: sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==} + hasBin: true + dev: true - semver@7.7.2: {} + /semver@7.7.3: + resolution: {integrity: sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==} + engines: {node: '>=10'} + hasBin: true - send@1.2.0: + /send@1.2.0: + resolution: {integrity: sha512-uaW0WwXKpL9blXE2o0bRhoL2EGXIrZxQ2ZQ4mgcfoBxdFmQold+qWsD2jLrfZ0trjKL6vOw0j//eAwcALFjKSw==} + engines: {node: '>= 18'} dependencies: - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) encodeurl: 2.0.0 escape-html: 1.0.3 etag: 1.8.1 fresh: 2.0.0 - http-errors: 2.0.0 - mime-types: 3.0.1 + http-errors: 2.0.1 + mime-types: 3.0.2 ms: 2.1.3 on-finished: 2.4.1 range-parser: 1.2.1 statuses: 2.0.2 transitivePeerDependencies: - supports-color + dev: false - serve-static@2.2.0: + /serve-static@2.2.0: + resolution: {integrity: sha512-61g9pCh0Vnh7IutZjtLGGpTA355+OPn2TyDv/6ivP2h/AdAVX9azsoxmg2/M6nZeQZNYBEwIcsne1mJd9oQItQ==} + engines: {node: '>= 18'} dependencies: encodeurl: 2.0.0 escape-html: 1.0.3 @@ -8662,54 +8514,84 @@ snapshots: send: 1.2.0 transitivePeerDependencies: - supports-color + dev: false - set-cookie-parser@2.7.1: {} + /set-cookie-parser@2.7.2: + resolution: {integrity: sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==} + dev: false - set-value@4.1.0: + /set-value@4.1.0: + resolution: {integrity: sha512-zTEg4HL0RwVrqcWs3ztF+x1vkxfm0lP+MQQFPiMJTKVceBwEV0A569Ou8l9IYQG8jOZdMVI1hGsc0tmeD2o/Lw==} + engines: {node: '>=11.0'} dependencies: is-plain-object: 2.0.4 is-primitive: 3.0.1 + dev: true - setimmediate@1.0.5: {} + /setimmediate@1.0.5: + resolution: {integrity: sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==} + dev: true - setprototypeof@1.2.0: {} + /setprototypeof@1.2.0: + resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==} + dev: false - sharp@0.32.6: + /sharp@0.32.6: + resolution: {integrity: sha512-KyLTWwgcR9Oe4d9HwCwNM2l7+J0dUQwn/yf7S0EnTtb0eVS4RxO0eUSvxPtzT4F3SY+C4K6fqdv/DO27sJ/v/w==} + engines: {node: '>=14.15.0'} + requiresBuild: true dependencies: color: 4.2.3 - detect-libc: 2.0.4 + detect-libc: 2.1.2 node-addon-api: 6.1.0 prebuild-install: 7.1.3 - semver: 7.7.2 + semver: 7.7.3 simple-get: 4.0.1 - tar-fs: 3.0.9 + tar-fs: 3.1.1 tunnel-agent: 0.6.0 transitivePeerDependencies: + - bare-abort-controller - bare-buffer + - react-native-b4a + dev: false - shebang-command@2.0.0: + /shebang-command@2.0.0: + resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==} + engines: {node: '>=8'} dependencies: shebang-regex: 3.0.0 - shebang-regex@3.0.0: {} + /shebang-regex@3.0.0: + resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} + engines: {node: '>=8'} - shell-quote@1.7.3: {} + /shell-quote@1.7.3: + resolution: {integrity: sha512-Vpfqwm4EnqGdlsBFNmHhxhElJYrdfcxPThu+ryKS5J8L/fhAwLazFZtq+S+TWZ9ANj2piSQLGj6NQg+lKPmxrw==} + dev: true - shellwords@0.1.1: {} + /shellwords@0.1.1: + resolution: {integrity: sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==} + dev: true - side-channel-list@1.0.0: + /side-channel-list@1.0.0: + resolution: {integrity: sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==} + engines: {node: '>= 0.4'} dependencies: es-errors: 1.3.0 object-inspect: 1.13.4 - side-channel-map@1.0.1: + /side-channel-map@1.0.1: + resolution: {integrity: sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==} + engines: {node: '>= 0.4'} dependencies: call-bound: 1.0.4 es-errors: 1.3.0 get-intrinsic: 1.3.0 object-inspect: 1.13.4 - side-channel-weakmap@1.0.2: + /side-channel-weakmap@1.0.2: + resolution: {integrity: sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==} + engines: {node: '>= 0.4'} dependencies: call-bound: 1.0.4 es-errors: 1.3.0 @@ -8717,7 +8599,9 @@ snapshots: object-inspect: 1.13.4 side-channel-map: 1.0.1 - side-channel@1.1.0: + /side-channel@1.1.0: + resolution: {integrity: sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==} + engines: {node: '>= 0.4'} dependencies: es-errors: 1.3.0 object-inspect: 1.13.4 @@ -8725,496 +8609,1010 @@ snapshots: side-channel-map: 1.0.1 side-channel-weakmap: 1.0.2 - signal-exit@3.0.7: {} + /siginfo@2.0.0: + resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==} + dev: true + + /signal-exit@3.0.7: + resolution: {integrity: sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==} - signal-exit@4.1.0: {} + /signal-exit@4.1.0: + resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==} + engines: {node: '>=14'} + dev: true - simple-concat@1.0.1: {} + /simple-concat@1.0.1: + resolution: {integrity: sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==} + dev: false - simple-get@4.0.1: + /simple-get@4.0.1: + resolution: {integrity: sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==} dependencies: decompress-response: 6.0.0 once: 1.4.0 simple-concat: 1.0.1 + dev: false - simple-swizzle@0.2.2: + /simple-swizzle@0.2.4: + resolution: {integrity: sha512-nAu1WFPQSMNr2Zn9PGSZK9AGn4t/y97lEm+MXTtUDwfP0ksAIX4nO+6ruD9Jwut4C49SB1Ws+fbXsm/yScWOHw==} dependencies: - is-arrayish: 0.3.2 + is-arrayish: 0.3.4 + dev: false - simple-update-notifier@2.0.0: + /simple-update-notifier@2.0.0: + resolution: {integrity: sha512-a2B9Y0KlNXl9u/vsW6sTIu9vGEpfKu2wRV6l1H3XEas/0gUIzGzBoP/IouTcUQbm9JWZLH3COxyn03TYlFax6w==} + engines: {node: '>=10'} dependencies: - semver: 7.7.2 + semver: 7.7.3 + dev: true - sisteransi@1.0.5: {} + /sisteransi@1.0.5: + resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==} + dev: true - slash@3.0.0: {} + /slash@3.0.0: + resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==} + engines: {node: '>=8'} + dev: true - slice-ansi@5.0.0: + /slice-ansi@5.0.0: + resolution: {integrity: sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==} + engines: {node: '>=12'} dependencies: - ansi-styles: 6.2.1 + ansi-styles: 6.2.3 is-fullwidth-code-point: 4.0.0 + dev: true - slice-ansi@7.1.0: + /slice-ansi@7.1.2: + resolution: {integrity: sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w==} + engines: {node: '>=18'} dependencies: - ansi-styles: 6.2.1 - is-fullwidth-code-point: 5.0.0 + ansi-styles: 6.2.3 + is-fullwidth-code-point: 5.1.0 + dev: true - sonic-boom@4.2.0: + /sonic-boom@4.2.0: + resolution: {integrity: sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww==} dependencies: atomic-sleep: 1.0.0 - source-map-js@1.2.1: {} + /source-map-js@1.2.1: + resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} + engines: {node: '>=0.10.0'} - source-map-support@0.5.13: + /source-map-support@0.5.13: + resolution: {integrity: sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==} dependencies: buffer-from: 1.1.2 source-map: 0.6.1 + dev: true - source-map-support@0.5.21: + /source-map-support@0.5.21: + resolution: {integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==} dependencies: buffer-from: 1.1.2 source-map: 0.6.1 + dev: true - source-map@0.6.1: {} - - source-map@0.7.4: {} + /source-map@0.6.1: + resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==} + engines: {node: '>=0.10.0'} + dev: true - source-map@0.8.0-beta.0: - dependencies: - whatwg-url: 7.1.0 + /source-map@0.7.6: + resolution: {integrity: sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==} + engines: {node: '>= 12'} + dev: true - spawn-sync@1.0.15: + /spawn-sync@1.0.15: + resolution: {integrity: sha512-9DWBgrgYZzNghseho0JOuh+5fg9u6QWhAWa51QC7+U5rCheZ/j1DrEZnyE0RBBRqZ9uEXGPgSSM0nky6burpVw==} + requiresBuild: true dependencies: concat-stream: 1.6.2 os-shim: 0.1.3 + dev: true - split2@4.2.0: {} + /split2@4.2.0: + resolution: {integrity: sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==} + engines: {node: '>= 10.x'} - split@1.0.1: + /split@1.0.1: + resolution: {integrity: sha512-mTyOoPbrivtXnwnIxZRFYRrPNtEFKlpB2fvjSnCQUiAA6qAZzqwna5envK4uk6OIeP17CsdF3rSBGYVBsU0Tkg==} dependencies: through: 2.3.8 + dev: true - sprintf-js@1.0.3: {} + /sprintf-js@1.0.3: + resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==} + dev: true - stack-utils@2.0.6: + /stack-utils@2.0.6: + resolution: {integrity: sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==} + engines: {node: '>=10'} dependencies: escape-string-regexp: 2.0.0 + dev: true - statuses@2.0.1: {} + /stackback@0.0.2: + resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==} + dev: true - statuses@2.0.2: {} + /statuses@2.0.2: + resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==} + engines: {node: '>= 0.8'} + dev: false - stdin-discarder@0.1.0: - dependencies: - bl: 5.1.0 + /std-env@3.10.0: + resolution: {integrity: sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==} + dev: true + + /stdin-discarder@0.2.2: + resolution: {integrity: sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ==} + engines: {node: '>=18'} + dev: true - stdin-discarder@0.2.2: {} + /stream-markdown-parser@0.0.42: + resolution: {integrity: sha512-e8mn3NW7moO/W5KsZ5jWg/iqw8PceuZq4bzynUf1yc+fUBGqu5SKu5SXDF7EH4jC9EDQiUsK49Fne/G/NYS7hQ==} + dependencies: + markdown-it-container: 4.0.0 + markdown-it-footnote: 4.0.0 + markdown-it-ins: 4.0.0 + markdown-it-mark: 4.0.0 + markdown-it-sub: 2.0.0 + markdown-it-sup: 2.0.0 + markdown-it-task-checkbox: 1.0.6 + markdown-it-ts: 0.0.2 + dev: false - streamx@2.22.1: + /streamx@2.23.0: + resolution: {integrity: sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg==} dependencies: + events-universal: 1.0.1 fast-fifo: 1.3.2 text-decoder: 1.2.3 - optionalDependencies: - bare-events: 2.5.4 + transitivePeerDependencies: + - bare-abort-controller + - react-native-b4a + dev: false - string-argv@0.3.2: {} + /string-argv@0.3.2: + resolution: {integrity: sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==} + engines: {node: '>=0.6.19'} + dev: true - string-length@4.0.2: + /string-length@4.0.2: + resolution: {integrity: sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==} + engines: {node: '>=10'} dependencies: char-regex: 1.0.2 strip-ansi: 6.0.1 + dev: true - string-width@4.2.3: + /string-width@4.2.3: + resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==} + engines: {node: '>=8'} dependencies: emoji-regex: 8.0.0 is-fullwidth-code-point: 3.0.0 strip-ansi: 6.0.1 + dev: true - string-width@5.1.2: + /string-width@5.1.2: + resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==} + engines: {node: '>=12'} dependencies: eastasianwidth: 0.2.0 emoji-regex: 9.2.2 - strip-ansi: 7.1.0 + strip-ansi: 7.1.2 + dev: true - string-width@7.2.0: + /string-width@7.2.0: + resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==} + engines: {node: '>=18'} dependencies: - emoji-regex: 10.4.0 - get-east-asian-width: 1.3.0 - strip-ansi: 7.1.0 + emoji-regex: 10.6.0 + get-east-asian-width: 1.4.0 + strip-ansi: 7.1.2 + dev: true - string_decoder@1.1.1: + /string_decoder@1.1.1: + resolution: {integrity: sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==} dependencies: safe-buffer: 5.1.2 + dev: true - string_decoder@1.3.0: + /string_decoder@1.3.0: + resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==} dependencies: safe-buffer: 5.2.1 + dev: false - strip-ansi@6.0.1: + /strip-ansi@6.0.1: + resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==} + engines: {node: '>=8'} dependencies: ansi-regex: 5.0.1 + dev: true - strip-ansi@7.1.0: + /strip-ansi@7.1.2: + resolution: {integrity: sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==} + engines: {node: '>=12'} dependencies: - ansi-regex: 6.1.0 + ansi-regex: 6.2.2 + dev: true - strip-bom@4.0.0: {} + /strip-bom@4.0.0: + resolution: {integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==} + engines: {node: '>=8'} + dev: true + + /strip-bom@5.0.0: + resolution: {integrity: sha512-p+byADHF7SzEcVnLvc/r3uognM1hUhObuHXxJcgLCfD194XAkaLbjq3Wzb0N5G2tgIjH0dgT708Z51QxMeu60A==} + engines: {node: '>=12'} + dev: true - strip-bom@5.0.0: {} + /strip-final-newline@2.0.0: + resolution: {integrity: sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==} + engines: {node: '>=6'} - strip-final-newline@2.0.0: {} + /strip-final-newline@3.0.0: + resolution: {integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==} + engines: {node: '>=12'} + dev: true - strip-final-newline@3.0.0: {} + /strip-json-comments@2.0.1: + resolution: {integrity: sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==} + engines: {node: '>=0.10.0'} - strip-json-comments@2.0.1: {} + /strip-json-comments@3.1.1: + resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==} + engines: {node: '>=8'} + dev: true - strip-json-comments@3.1.1: {} + /strip-json-comments@5.0.2: + resolution: {integrity: sha512-4X2FR3UwhNUE9G49aIsJW5hRRR3GXGTBTZRMfv568O60ojM8HcWjV/VxAxCDW3SUND33O6ZY66ZuRcdkj73q2g==} + engines: {node: '>=14.16'} + dev: true - strip-json-comments@5.0.1: {} + /strip-json-comments@5.0.3: + resolution: {integrity: sha512-1tB5mhVo7U+ETBKNf92xT4hrQa3pm0MZ0PQvuDnWgAAGHDsfp4lPSpiS6psrSiet87wyGPh9ft6wmhOMQ0hDiw==} + engines: {node: '>=14.16'} + dev: true - strip-literal@3.0.0: + /strip-literal@3.1.0: + resolution: {integrity: sha512-8r3mkIM/2+PpjHoOtiAW8Rg3jJLHaV7xPwG+YRGrv6FP0wwk/toTpATxWYOW0BKdWwl82VT2tFYi5DlROa0Mxg==} dependencies: js-tokens: 9.0.1 + dev: true + + /stubborn-fs@2.0.0: + resolution: {integrity: sha512-Y0AvSwDw8y+nlSNFXMm2g6L51rBGdAQT20J3YSOqxC53Lo3bjWRtr2BKcfYoAf352WYpsZSTURrA0tqhfgudPA==} + dependencies: + stubborn-utils: 1.0.2 + dev: true - stubborn-fs@1.2.5: {} + /stubborn-utils@1.0.2: + resolution: {integrity: sha512-zOh9jPYI+xrNOyisSelgym4tolKTJCQd5GBhK0+0xJvcYDcwlOoxF/rnFKQ2KRZknXSG9jWAp66fwP6AxN9STg==} + dev: true - sucrase@3.35.0: + /sucrase@3.35.1: + resolution: {integrity: sha512-DhuTmvZWux4H1UOnWMB3sk0sbaCVOoQZjv8u1rDoTV0HTdGem9hkAZtl4JZy8P2z4Bg0nT+YMeOFyVr4zcG5Tw==} + engines: {node: '>=16 || 14 >=14.17'} + hasBin: true dependencies: - '@jridgewell/gen-mapping': 0.3.8 + '@jridgewell/gen-mapping': 0.3.13 commander: 4.1.1 - glob: 10.4.5 lines-and-columns: 1.2.4 mz: 2.7.0 pirates: 4.0.7 + tinyglobby: 0.2.15 ts-interface-checker: 0.1.13 + dev: true - superagent@10.2.1: + /superagent@10.2.3: + resolution: {integrity: sha512-y/hkYGeXAj7wUMjxRbB21g/l6aAEituGXM9Rwl4o20+SX3e8YOSV6BxFXl+dL3Uk0mjSL3kCbNkwURm8/gEDig==} + engines: {node: '>=14.18.0'} dependencies: component-emitter: 1.3.1 cookiejar: 2.1.4 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) fast-safe-stringify: 2.1.1 - form-data: 4.0.3 + form-data: 4.0.5 formidable: 3.5.4 methods: 1.1.2 mime: 2.6.0 qs: 6.14.0 transitivePeerDependencies: - supports-color + dev: true - supertest@7.1.1: + /supertest@7.1.4: + resolution: {integrity: sha512-tjLPs7dVyqgItVFirHYqe2T+MfWc2VOBQ8QFKKbWTA3PU7liZR8zoSpAi/C1k1ilm9RsXIKYf197oap9wXGVYg==} + engines: {node: '>=14.18.0'} dependencies: methods: 1.1.2 - superagent: 10.2.1 + superagent: 10.2.3 transitivePeerDependencies: - supports-color + dev: true - supports-color@5.5.0: + /supports-color@5.5.0: + resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==} + engines: {node: '>=4'} dependencies: has-flag: 3.0.0 - supports-color@7.2.0: + /supports-color@7.2.0: + resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==} + engines: {node: '>=8'} dependencies: has-flag: 4.0.0 + dev: true - supports-color@8.1.1: + /supports-color@8.1.1: + resolution: {integrity: sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==} + engines: {node: '>=10'} dependencies: has-flag: 4.0.0 + dev: true + + /supports-preserve-symlinks-flag@1.0.0: + resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==} + engines: {node: '>= 0.4'} + dev: true + + /symbol-tree@3.2.4: + resolution: {integrity: sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==} + dev: true + + /tailwindcss@4.1.18: + resolution: {integrity: sha512-4+Z+0yiYyEtUVCScyfHCxOYP06L5Ne+JiHhY2IjR2KWMIWhJOYZKLSGZaP5HkZ8+bY0cxfzwDE5uOmzFXyIwxw==} + dev: true - supports-preserve-symlinks-flag@1.0.0: {} + /tapable@2.3.0: + resolution: {integrity: sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==} + engines: {node: '>=6'} + dev: true - tar-fs@2.1.3: + /tar-fs@2.1.4: + resolution: {integrity: sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==} dependencies: chownr: 1.1.4 mkdirp-classic: 0.5.3 - pump: 3.0.2 + pump: 3.0.3 tar-stream: 2.2.0 + dev: false - tar-fs@3.0.9: + /tar-fs@3.1.1: + resolution: {integrity: sha512-LZA0oaPOc2fVo82Txf3gw+AkEd38szODlptMYejQUhndHMLQ9M059uXR+AfS7DNo0NpINvSqDsvyaCrBVkptWg==} dependencies: - pump: 3.0.2 + pump: 3.0.3 tar-stream: 3.1.7 optionalDependencies: - bare-fs: 4.1.5 + bare-fs: 4.5.2 bare-path: 3.0.0 transitivePeerDependencies: + - bare-abort-controller - bare-buffer + - react-native-b4a + dev: false - tar-stream@2.2.0: + /tar-stream@2.2.0: + resolution: {integrity: sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==} + engines: {node: '>=6'} dependencies: bl: 4.1.0 - end-of-stream: 1.4.4 + end-of-stream: 1.4.5 fs-constants: 1.0.0 inherits: 2.0.4 readable-stream: 3.6.2 + dev: false - tar-stream@3.1.7: + /tar-stream@3.1.7: + resolution: {integrity: sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==} dependencies: - b4a: 1.6.7 + b4a: 1.7.3 fast-fifo: 1.3.2 - streamx: 2.22.1 + streamx: 2.23.0 + transitivePeerDependencies: + - bare-abort-controller + - react-native-b4a + dev: false - test-exclude@6.0.0: + /test-exclude@6.0.0: + resolution: {integrity: sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==} + engines: {node: '>=8'} dependencies: '@istanbuljs/schema': 0.1.3 glob: 7.2.3 minimatch: 3.1.2 + dev: true - text-decoder@1.2.3: + /text-decoder@1.2.3: + resolution: {integrity: sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==} dependencies: - b4a: 1.6.7 + b4a: 1.7.3 + transitivePeerDependencies: + - react-native-b4a + dev: false - text-extensions@2.4.0: {} + /text-extensions@2.4.0: + resolution: {integrity: sha512-te/NtwBwfiNRLf9Ijqx3T0nlqZiQ2XrrtBvu+cLL8ZRrGkO0NHTug8MYFKyoSrv/sHTaSKfilUkizV6XhxMJ3g==} + engines: {node: '>=8'} + dev: true - thenify-all@1.6.0: + /thenify-all@1.6.0: + resolution: {integrity: sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==} + engines: {node: '>=0.8'} dependencies: thenify: 3.3.1 + dev: true - thenify@3.3.1: + /thenify@3.3.1: + resolution: {integrity: sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==} dependencies: any-promise: 1.3.0 + dev: true - thread-stream@3.1.0: + /thread-stream@3.1.0: + resolution: {integrity: sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A==} dependencies: real-require: 0.2.0 - through@2.3.8: {} + /through@2.3.8: + resolution: {integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==} + dev: true + + /tinybench@2.9.0: + resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==} + dev: true - tinyexec@0.3.2: {} + /tinyexec@0.3.2: + resolution: {integrity: sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==} + dev: true - tinyexec@1.0.1: {} + /tinyexec@1.0.2: + resolution: {integrity: sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==} + engines: {node: '>=18'} + dev: true - tinyglobby@0.2.14: + /tinyglobby@0.2.15: + resolution: {integrity: sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==} + engines: {node: '>=12.0.0'} dependencies: - fdir: 6.4.5(picomatch@4.0.2) - picomatch: 4.0.2 + fdir: 6.5.0(picomatch@4.0.3) + picomatch: 4.0.3 + dev: true - titleize@3.0.0: {} + /tinypool@1.1.1: + resolution: {integrity: sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==} + engines: {node: ^18.0.0 || >=20.0.0} + dev: true + + /tinyrainbow@1.2.0: + resolution: {integrity: sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==} + engines: {node: '>=14.0.0'} + dev: true + + /tinyspy@3.0.2: + resolution: {integrity: sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==} + engines: {node: '>=14.0.0'} + dev: true + + /tldts-core@6.1.86: + resolution: {integrity: sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==} + dev: true + + /tldts@6.1.86: + resolution: {integrity: sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==} + hasBin: true + dependencies: + tldts-core: 6.1.86 + dev: true - tmp@0.2.3: {} + /tmp@0.2.5: + resolution: {integrity: sha512-voyz6MApa1rQGUxT3E+BK7/ROe8itEx7vD8/HEvt4xwXucvQ5G5oeEiHkmHZJuBO21RpOf+YYm9MOivj709jow==} + engines: {node: '>=14.14'} + dev: true - tmpl@1.0.5: {} + /tmpl@1.0.5: + resolution: {integrity: sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==} + dev: true - to-regex-range@5.0.1: + /to-regex-range@5.0.1: + resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==} + engines: {node: '>=8.0'} dependencies: is-number: 7.0.0 + dev: true + + /toad-cache@3.7.0: + resolution: {integrity: sha512-/m8M+2BJUpoJdgAHoG+baCwBT+tf2VraSfkBgl0Y00qIWt41DJ8R5B8nsEw0I58YwF5IZH6z24/2TobDKnqSWw==} + engines: {node: '>=12'} + dev: false - toad-cache@3.7.0: {} + /toidentifier@1.0.1: + resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==} + engines: {node: '>=0.6'} + dev: false - toidentifier@1.0.1: {} + /touch@3.1.1: + resolution: {integrity: sha512-r0eojU4bI8MnHr8c5bNo7lJDdI2qXlWWJk6a9EAFG7vbhTjElYhBVS3/miuE0uOuoLdb8Mc/rVfsmm6eo5o9GA==} + hasBin: true + dev: true - touch@3.1.1: {} + /tough-cookie@5.1.2: + resolution: {integrity: sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==} + engines: {node: '>=16'} + dependencies: + tldts: 6.1.86 + dev: true - tr46@0.0.3: {} + /tr46@0.0.3: + resolution: {integrity: sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==} + dev: false - tr46@1.0.1: + /tr46@5.1.1: + resolution: {integrity: sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==} + engines: {node: '>=18'} dependencies: punycode: 2.3.1 + dev: true - tree-kill@1.2.2: {} + /tree-kill@1.2.2: + resolution: {integrity: sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==} + hasBin: true + dev: true - ts-api-utils@2.1.0(typescript@5.8.3): + /ts-api-utils@2.1.0(typescript@5.9.3): + resolution: {integrity: sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==} + engines: {node: '>=18.12'} + peerDependencies: + typescript: '>=4.8.4' dependencies: - typescript: 5.8.3 + typescript: 5.9.3 + dev: true - ts-interface-checker@0.1.13: {} + /ts-interface-checker@0.1.13: + resolution: {integrity: sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==} + dev: true - ts-jest@29.3.4(@babel/core@7.27.4)(@jest/transform@29.7.0)(@jest/types@29.6.3)(babel-jest@29.7.0(@babel/core@7.27.4))(jest@29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)))(typescript@5.8.3): + /ts-jest@29.4.6(@babel/core@7.28.5)(jest@29.7.0)(typescript@5.9.3): + resolution: {integrity: sha512-fSpWtOO/1AjSNQguk43hb/JCo16oJDnMJf3CdEGNkqsEX3t0KX96xvyX1D7PfLCpVoKu4MfVrqUkFyblYoY4lA==} + engines: {node: ^14.15.0 || ^16.10.0 || ^18.0.0 || >=20.0.0} + hasBin: true + peerDependencies: + '@babel/core': '>=7.0.0-beta.0 <8' + '@jest/transform': ^29.0.0 || ^30.0.0 + '@jest/types': ^29.0.0 || ^30.0.0 + babel-jest: ^29.0.0 || ^30.0.0 + esbuild: '*' + jest: ^29.0.0 || ^30.0.0 + jest-util: ^29.0.0 || ^30.0.0 + typescript: '>=4.3 <6' + peerDependenciesMeta: + '@babel/core': + optional: true + '@jest/transform': + optional: true + '@jest/types': + optional: true + babel-jest: + optional: true + esbuild: + optional: true + jest-util: + optional: true dependencies: + '@babel/core': 7.28.5 bs-logger: 0.2.6 - ejs: 3.1.10 fast-json-stable-stringify: 2.1.0 - jest: 29.7.0(@types/node@22.15.30)(node-notifier@10.0.1)(ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3)) - jest-util: 29.7.0 + handlebars: 4.7.8 + jest: 29.7.0(@types/node@22.19.2)(ts-node@10.9.2) json5: 2.2.3 lodash.memoize: 4.1.2 make-error: 1.3.6 - semver: 7.7.2 + semver: 7.7.3 type-fest: 4.41.0 - typescript: 5.8.3 + typescript: 5.9.3 yargs-parser: 21.1.1 - optionalDependencies: - '@babel/core': 7.27.4 - '@jest/transform': 29.7.0 - '@jest/types': 29.6.3 - babel-jest: 29.7.0(@babel/core@7.27.4) + dev: true - ts-node@10.9.2(@types/node@22.15.30)(typescript@5.8.3): + /ts-node@10.9.2(@types/node@22.19.2)(typescript@5.9.3): + resolution: {integrity: sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==} + hasBin: true + peerDependencies: + '@swc/core': '>=1.2.50' + '@swc/wasm': '>=1.2.50' + '@types/node': '*' + typescript: '>=2.7' + peerDependenciesMeta: + '@swc/core': + optional: true + '@swc/wasm': + optional: true dependencies: '@cspotcode/source-map-support': 0.8.1 - '@tsconfig/node10': 1.0.11 + '@tsconfig/node10': 1.0.12 '@tsconfig/node12': 1.0.11 '@tsconfig/node14': 1.0.3 '@tsconfig/node16': 1.0.4 - '@types/node': 22.15.30 + '@types/node': 22.19.2 acorn: 8.15.0 acorn-walk: 8.3.4 arg: 4.1.3 create-require: 1.1.1 diff: 4.0.2 make-error: 1.3.6 - typescript: 5.8.3 + typescript: 5.9.3 v8-compile-cache-lib: 3.0.1 yn: 3.1.1 + dev: true - tslib@2.8.1: {} + /tslib@2.8.1: + resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} + dev: true - tsup@8.5.0(jiti@2.4.2)(postcss@8.5.4)(typescript@5.8.3)(yaml@2.8.0): + /tsup@8.5.1(typescript@5.9.3): + resolution: {integrity: sha512-xtgkqwdhpKWr3tKPmCkvYmS9xnQK3m3XgxZHwSUjvfTjp7YfXe5tT3GgWi0F2N+ZSMsOeWeZFh7ZZFg5iPhing==} + engines: {node: '>=18'} + hasBin: true + peerDependencies: + '@microsoft/api-extractor': ^7.36.0 + '@swc/core': ^1 + postcss: ^8.4.12 + typescript: '>=4.5.0' + peerDependenciesMeta: + '@microsoft/api-extractor': + optional: true + '@swc/core': + optional: true + postcss: + optional: true + typescript: + optional: true dependencies: - bundle-require: 5.1.0(esbuild@0.25.5) + bundle-require: 5.1.0(esbuild@0.27.1) cac: 6.7.14 chokidar: 4.0.3 consola: 3.4.2 - debug: 4.4.1(supports-color@5.5.0) - esbuild: 0.25.5 + debug: 4.4.3(supports-color@5.5.0) + esbuild: 0.27.1 fix-dts-default-cjs-exports: 1.0.1 joycon: 3.1.1 picocolors: 1.1.1 - postcss-load-config: 6.0.1(jiti@2.4.2)(postcss@8.5.4)(yaml@2.8.0) + postcss-load-config: 6.0.1 resolve-from: 5.0.0 - rollup: 4.42.0 - source-map: 0.8.0-beta.0 - sucrase: 3.35.0 + rollup: 4.53.3 + source-map: 0.7.6 + sucrase: 3.35.1 tinyexec: 0.3.2 - tinyglobby: 0.2.14 + tinyglobby: 0.2.15 tree-kill: 1.2.2 - optionalDependencies: - postcss: 8.5.4 - typescript: 5.8.3 + typescript: 5.9.3 transitivePeerDependencies: - jiti - supports-color - tsx - yaml + dev: true - tunnel-agent@0.6.0: + /tunnel-agent@0.6.0: + resolution: {integrity: sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==} dependencies: safe-buffer: 5.2.1 + dev: false - type-check@0.4.0: + /type-check@0.4.0: + resolution: {integrity: sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==} + engines: {node: '>= 0.8.0'} dependencies: prelude-ls: 1.2.1 + dev: true - type-detect@4.0.8: {} + /type-detect@4.0.8: + resolution: {integrity: sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==} + engines: {node: '>=4'} + dev: true - type-fest@0.21.3: {} + /type-fest@0.21.3: + resolution: {integrity: sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==} + engines: {node: '>=10'} + dev: true - type-fest@3.13.1: {} + /type-fest@3.13.1: + resolution: {integrity: sha512-tLq3bSNx+xSpwvAJnzrK0Ep5CLNWjvFTOp71URMaAEWBfRb9nnJiBoUe0tF8bI4ZFO3omgBR6NvnbzVUT3Ly4g==} + engines: {node: '>=14.16'} + dev: true - type-fest@4.41.0: {} + /type-fest@4.41.0: + resolution: {integrity: sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==} + engines: {node: '>=16'} + dev: true - type-is@2.0.1: + /type-is@2.0.1: + resolution: {integrity: sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==} + engines: {node: '>= 0.6'} dependencies: content-type: 1.0.5 media-typer: 1.1.0 - mime-types: 3.0.1 + mime-types: 3.0.2 + dev: false - typedarray@0.0.6: {} + /typedarray@0.0.6: + resolution: {integrity: sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==} + dev: true - typescript-eslint@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3): - dependencies: - '@typescript-eslint/eslint-plugin': 8.33.1(@typescript-eslint/parser@8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3))(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - '@typescript-eslint/parser': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - '@typescript-eslint/utils': 8.33.1(eslint@9.28.0(jiti@2.4.2))(typescript@5.8.3) - eslint: 9.28.0(jiti@2.4.2) - typescript: 5.8.3 + /typescript-eslint@8.49.0(eslint@9.39.2)(typescript@5.9.3): + resolution: {integrity: sha512-zRSVH1WXD0uXczCXw+nsdjGPUdx4dfrs5VQoHnUWmv1U3oNlAKv4FUNdLDhVUg+gYn+a5hUESqch//Rv5wVhrg==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 + typescript: '>=4.8.4 <6.0.0' + dependencies: + '@typescript-eslint/eslint-plugin': 8.49.0(@typescript-eslint/parser@8.49.0)(eslint@9.39.2)(typescript@5.9.3) + '@typescript-eslint/parser': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + '@typescript-eslint/typescript-estree': 8.49.0(typescript@5.9.3) + '@typescript-eslint/utils': 8.49.0(eslint@9.39.2)(typescript@5.9.3) + eslint: 9.39.2 + typescript: 5.9.3 transitivePeerDependencies: - supports-color + dev: true + + /typescript@5.9.3: + resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==} + engines: {node: '>=14.17'} + hasBin: true - typescript@5.8.3: {} + /uc.micro@2.1.0: + resolution: {integrity: sha512-ARDJmphmdvUk6Glw7y9DQ2bFkKBHwQHLi2lsaH6PPmz/Ka9sFOBsBluozhDltWmnv9u/cF6Rt87znRTPV+yp/A==} + dev: false + + /ufo@1.6.1: + resolution: {integrity: sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==} + dev: true + + /uglify-js@3.19.3: + resolution: {integrity: sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==} + engines: {node: '>=0.8.0'} + hasBin: true + requiresBuild: true + dev: true + optional: true + + /uhyphen@0.2.0: + resolution: {integrity: sha512-qz3o9CHXmJJPGBdqzab7qAYuW8kQGKNEuoHFYrBwV6hWIMcpAmxDLXojcHfFr9US1Pe6zUswEIJIbLI610fuqA==} + dev: true + + /undefsafe@2.0.5: + resolution: {integrity: sha512-WxONCrssBM8TSPRqN5EmsjVrsv4A8X12J4ArBiiayv3DyyG3ZlIg6yysuuSYdZsVz3TKcTg2fd//Ujd4CHV1iA==} + dev: true + + /undici-types@5.26.5: + resolution: {integrity: sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==} + dev: true + + /undici-types@6.21.0: + resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==} + + /unicorn-magic@0.1.0: + resolution: {integrity: sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==} + engines: {node: '>=18'} + dev: true - ufo@1.6.1: {} + /unimport@5.5.0: + resolution: {integrity: sha512-/JpWMG9s1nBSlXJAQ8EREFTFy3oy6USFd8T6AoBaw1q2GGcF4R9yp3ofg32UODZlYEO5VD0EWE1RpI9XDWyPYg==} + engines: {node: '>=18.12.0'} + dependencies: + acorn: 8.15.0 + escape-string-regexp: 5.0.0 + estree-walker: 3.0.3 + local-pkg: 1.1.2 + magic-string: 0.30.21 + mlly: 1.8.0 + pathe: 2.0.3 + picomatch: 4.0.3 + pkg-types: 2.3.0 + scule: 1.3.0 + strip-literal: 3.1.0 + tinyglobby: 0.2.15 + unplugin: 2.3.11 + unplugin-utils: 0.3.1 + dev: true - uhyphen@0.2.0: {} + /universalify@2.0.1: + resolution: {integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==} + engines: {node: '>= 10.0.0'} + dev: true - undefsafe@2.0.5: {} + /unpipe@1.0.0: + resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==} + engines: {node: '>= 0.8'} + dev: false - undici-types@5.26.5: {} + /unplugin-icons@0.19.3: + resolution: {integrity: sha512-EUegRmsAI6+rrYr0vXjFlIP+lg4fSC4zb62zAZKx8FGXlWAGgEGBCa3JDe27aRAXhistObLPbBPhwa/0jYLFkQ==} + peerDependencies: + '@svgr/core': '>=7.0.0' + '@svgx/core': ^1.0.1 + '@vue/compiler-sfc': ^3.0.2 || ^2.7.0 + vue-template-compiler: ^2.6.12 + vue-template-es2015-compiler: ^1.9.0 + peerDependenciesMeta: + '@svgr/core': + optional: true + '@svgx/core': + optional: true + '@vue/compiler-sfc': + optional: true + vue-template-compiler: + optional: true + vue-template-es2015-compiler: + optional: true + dependencies: + '@antfu/install-pkg': 0.4.1 + '@antfu/utils': 0.7.10 + '@iconify/utils': 2.3.0 + debug: 4.4.3(supports-color@5.5.0) + kolorist: 1.8.0 + local-pkg: 0.5.1 + unplugin: 1.16.1 + transitivePeerDependencies: + - supports-color + dev: true - undici-types@6.21.0: {} + /unplugin-utils@0.3.1: + resolution: {integrity: sha512-5lWVjgi6vuHhJ526bI4nlCOmkCIF3nnfXkCMDeMJrtdvxTs6ZFCM8oNufGTsDbKv/tJ/xj8RpvXjRuPBZJuJog==} + engines: {node: '>=20.19.0'} + dependencies: + pathe: 2.0.3 + picomatch: 4.0.3 + dev: true - unicorn-magic@0.1.0: {} + /unplugin-vue-components@0.27.5(vue@3.5.25): + resolution: {integrity: sha512-m9j4goBeNwXyNN8oZHHxvIIYiG8FQ9UfmKWeNllpDvhU7btKNNELGPt+o3mckQKuPwrE7e0PvCsx+IWuDSD9Vg==} + engines: {node: '>=14'} + peerDependencies: + '@babel/parser': ^7.15.8 + '@nuxt/kit': ^3.2.2 + vue: 2 || 3 + peerDependenciesMeta: + '@babel/parser': + optional: true + '@nuxt/kit': + optional: true + dependencies: + '@antfu/utils': 0.7.10 + '@rollup/pluginutils': 5.3.0 + chokidar: 3.6.0 + debug: 4.4.3(supports-color@5.5.0) + fast-glob: 3.3.3 + local-pkg: 0.5.1 + magic-string: 0.30.21 + minimatch: 9.0.5 + mlly: 1.8.0 + unplugin: 1.16.1 + vue: 3.5.25(typescript@5.9.3) + transitivePeerDependencies: + - rollup + - supports-color + dev: true - unimport@5.0.1: + /unplugin@1.16.1: + resolution: {integrity: sha512-4/u/j4FrCKdi17jaxuJA0jClGxB1AvU2hw/IuayPc4ay1XGaJs/rbb4v5WKwAjNifjmXK9PIFyuPiaK8azyR9w==} + engines: {node: '>=14.0.0'} dependencies: acorn: 8.15.0 - escape-string-regexp: 5.0.0 - estree-walker: 3.0.3 - local-pkg: 1.1.1 - magic-string: 0.30.17 - mlly: 1.7.4 - pathe: 2.0.3 - picomatch: 4.0.2 - pkg-types: 2.1.0 - scule: 1.3.0 - strip-literal: 3.0.0 - tinyglobby: 0.2.14 - unplugin: 2.3.5 - unplugin-utils: 0.2.4 - - universalify@2.0.1: {} - - unpipe@1.0.0: {} - - unplugin-utils@0.2.4: - dependencies: - pathe: 2.0.3 - picomatch: 4.0.2 + webpack-virtual-modules: 0.6.2 + dev: true - unplugin@2.3.5: + /unplugin@2.3.11: + resolution: {integrity: sha512-5uKD0nqiYVzlmCRs01Fhs2BdkEgBS3SAVP6ndrBsuK42iC2+JHyxM05Rm9G8+5mkmRtzMZGY8Ct5+mliZxU/Ww==} + engines: {node: '>=18.12.0'} dependencies: + '@jridgewell/remapping': 2.3.5 acorn: 8.15.0 - picomatch: 4.0.2 + picomatch: 4.0.3 webpack-virtual-modules: 0.6.2 + dev: true - untildify@4.0.0: {} - - update-browserslist-db@1.1.3(browserslist@4.25.0): + /update-browserslist-db@1.2.2(browserslist@4.28.1): + resolution: {integrity: sha512-E85pfNzMQ9jpKkA7+TJAi4TJN+tBCuWh5rUcS/sv6cFi+1q9LYDwDI5dpUL0u/73EElyQ8d3TEaeW4sPedBqYA==} + hasBin: true + peerDependencies: + browserslist: '>= 4.21.0' dependencies: - browserslist: 4.25.0 + browserslist: 4.28.1 escalade: 3.2.0 picocolors: 1.1.1 + dev: true - update-notifier@7.3.1: + /update-notifier@7.3.1: + resolution: {integrity: sha512-+dwUY4L35XFYEzE+OAL3sarJdUioVovq+8f7lcIJ7wnmnYQV5UD1Y/lcwaMSyaQ6Bj3JMj1XSTjZbNLHn/19yA==} + engines: {node: '>=18'} dependencies: boxen: 8.0.1 - chalk: 5.4.1 - configstore: 7.0.0 + chalk: 5.6.2 + configstore: 7.1.0 is-in-ci: 1.0.0 is-installed-globally: 1.0.0 - is-npm: 6.0.0 + is-npm: 6.1.0 latest-version: 9.0.0 - pupa: 3.1.0 - semver: 7.7.2 + pupa: 3.3.0 + semver: 7.7.3 xdg-basedir: 5.1.0 + dev: true - uri-js@4.4.1: + /uri-js@4.4.1: + resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==} dependencies: punycode: 2.3.1 + dev: true - util-deprecate@1.0.2: {} + /util-deprecate@1.0.2: + resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==} - uuid@11.1.0: {} + /uuid@11.1.0: + resolution: {integrity: sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==} + hasBin: true + dev: false - uuid@8.3.2: {} + /uuid@8.3.2: + resolution: {integrity: sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==} + hasBin: true + dev: true - v8-compile-cache-lib@3.0.1: {} + /v8-compile-cache-lib@3.0.1: + resolution: {integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==} + dev: true - v8-to-istanbul@9.3.0: + /v8-to-istanbul@9.3.0: + resolution: {integrity: sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==} + engines: {node: '>=10.12.0'} dependencies: - '@jridgewell/trace-mapping': 0.3.25 + '@jridgewell/trace-mapping': 0.3.31 '@types/istanbul-lib-coverage': 2.0.6 convert-source-map: 2.0.0 + dev: true + + /vary@1.1.2: + resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==} + engines: {node: '>= 0.8'} + dev: false - vary@1.1.2: {} + /vite-node@2.1.9(@types/node@22.19.2): + resolution: {integrity: sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==} + engines: {node: ^18.0.0 || >=20.0.0} + hasBin: true + dependencies: + cac: 6.7.14 + debug: 4.4.3(supports-color@5.5.0) + es-module-lexer: 1.7.0 + pathe: 1.1.2 + vite: 5.4.21(@types/node@22.19.2) + transitivePeerDependencies: + - '@types/node' + - less + - lightningcss + - sass + - sass-embedded + - stylus + - sugarss + - supports-color + - terser + dev: true - vite-node@3.2.3(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0): + /vite-node@3.2.4(@types/node@22.19.2): + resolution: {integrity: sha512-EbKSKh+bh1E1IFxeO0pg1n4dvoOTt0UDiXMd/qn++r98+jPO1xtJilvXldeuQ8giIB5IkpjCgMleHMNEsGH6pg==} + engines: {node: ^18.0.0 || ^20.0.0 || >=22.0.0} + hasBin: true dependencies: cac: 6.7.14 - debug: 4.4.1(supports-color@5.5.0) + debug: 4.4.3(supports-color@5.5.0) es-module-lexer: 1.7.0 pathe: 2.0.3 - vite: 6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0) + vite: 7.2.7(@types/node@22.19.2) transitivePeerDependencies: - '@types/node' - jiti @@ -9228,79 +9626,260 @@ snapshots: - terser - tsx - yaml + dev: true - vite-plugin-static-copy@3.0.0(vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0)): + /vite-plugin-static-copy@3.1.4(vite@7.2.7): + resolution: {integrity: sha512-iCmr4GSw4eSnaB+G8zc2f4dxSuDjbkjwpuBLLGvQYR9IW7rnDzftnUjOH5p4RYR+d4GsiBqXRvzuFhs5bnzVyw==} + engines: {node: ^18.0.0 || >=20.0.0} + peerDependencies: + vite: ^5.0.0 || ^6.0.0 || ^7.0.0 dependencies: chokidar: 3.6.0 - fs-extra: 11.3.0 - p-map: 7.0.3 + p-map: 7.0.4 picocolors: 1.1.1 - tinyglobby: 0.2.14 - vite: 6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0) + tinyglobby: 0.2.15 + vite: 7.2.7(@types/node@22.19.2) + dev: true + + /vite@5.4.21(@types/node@22.19.2): + resolution: {integrity: sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==} + engines: {node: ^18.0.0 || >=20.0.0} + hasBin: true + peerDependencies: + '@types/node': ^18.0.0 || >=20.0.0 + less: '*' + lightningcss: ^1.21.0 + sass: '*' + sass-embedded: '*' + stylus: '*' + sugarss: '*' + terser: ^5.4.0 + peerDependenciesMeta: + '@types/node': + optional: true + less: + optional: true + lightningcss: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + dependencies: + '@types/node': 22.19.2 + esbuild: 0.21.5 + postcss: 8.5.6 + rollup: 4.53.3 + optionalDependencies: + fsevents: 2.3.3 + dev: true - vite@6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0): + /vite@7.2.7(@types/node@22.19.2): + resolution: {integrity: sha512-ITcnkFeR3+fI8P1wMgItjGrR10170d8auB4EpMLPqmx6uxElH3a/hHGQabSHKdqd4FXWO1nFIp9rRn7JQ34ACQ==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + jiti: '>=1.21.0' + less: ^4.0.0 + lightningcss: ^1.21.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: '>=0.54.8' + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + '@types/node': + optional: true + jiti: + optional: true + less: + optional: true + lightningcss: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true dependencies: - esbuild: 0.25.5 - fdir: 6.4.5(picomatch@4.0.2) - picomatch: 4.0.2 - postcss: 8.5.4 - rollup: 4.42.0 - tinyglobby: 0.2.14 + '@types/node': 22.19.2 + esbuild: 0.25.12 + fdir: 6.5.0(picomatch@4.0.3) + picomatch: 4.0.3 + postcss: 8.5.6 + rollup: 4.53.3 + tinyglobby: 0.2.15 optionalDependencies: - '@types/node': 22.15.30 fsevents: 2.3.3 - jiti: 2.4.2 - yaml: 2.8.0 + dev: true + + /vitest@2.1.9(@types/node@22.19.2)(jsdom@26.1.0): + resolution: {integrity: sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==} + engines: {node: ^18.0.0 || >=20.0.0} + hasBin: true + peerDependencies: + '@edge-runtime/vm': '*' + '@types/node': ^18.0.0 || >=20.0.0 + '@vitest/browser': 2.1.9 + '@vitest/ui': 2.1.9 + happy-dom: '*' + jsdom: '*' + peerDependenciesMeta: + '@edge-runtime/vm': + optional: true + '@types/node': + optional: true + '@vitest/browser': + optional: true + '@vitest/ui': + optional: true + happy-dom: + optional: true + jsdom: + optional: true + dependencies: + '@types/node': 22.19.2 + '@vitest/expect': 2.1.9 + '@vitest/mocker': 2.1.9(vite@5.4.21) + '@vitest/pretty-format': 2.1.9 + '@vitest/runner': 2.1.9 + '@vitest/snapshot': 2.1.9 + '@vitest/spy': 2.1.9 + '@vitest/utils': 2.1.9 + chai: 5.3.3 + debug: 4.4.3(supports-color@5.5.0) + expect-type: 1.3.0 + jsdom: 26.1.0 + magic-string: 0.30.21 + pathe: 1.1.2 + std-env: 3.10.0 + tinybench: 2.9.0 + tinyexec: 0.3.2 + tinypool: 1.1.1 + tinyrainbow: 1.2.0 + vite: 5.4.21(@types/node@22.19.2) + vite-node: 2.1.9(@types/node@22.19.2) + why-is-node-running: 2.3.0 + transitivePeerDependencies: + - less + - lightningcss + - msw + - sass + - sass-embedded + - stylus + - sugarss + - supports-color + - terser + dev: true + + /vscode-uri@3.1.0: + resolution: {integrity: sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==} + dev: true - vscode-uri@3.1.0: {} + /vue-demi@0.14.10(vue@3.5.25): + resolution: {integrity: sha512-nMZBOwuzabUO0nLgIcc6rycZEebF6eeUfaiQx9+WSk8e29IbLvPU9feI6tqW4kTo3hvoYAJkMh8n8D0fuISphg==} + engines: {node: '>=12'} + hasBin: true + requiresBuild: true + peerDependencies: + '@vue/composition-api': ^1.0.0-rc.1 + vue: ^3.0.0-0 || ^2.6.0 + peerDependenciesMeta: + '@vue/composition-api': + optional: true + dependencies: + vue: 3.5.25(typescript@5.9.3) + dev: false - vue-eslint-parser@10.1.3(eslint@9.28.0(jiti@2.4.2)): + /vue-eslint-parser@10.2.0(eslint@9.39.2): + resolution: {integrity: sha512-CydUvFOQKD928UzZhTp4pr2vWz1L+H99t7Pkln2QSPdvmURT0MoC4wUccfCnuEaihNsu9aYYyk+bep8rlfkUXw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 dependencies: - debug: 4.4.1(supports-color@5.5.0) - eslint: 9.28.0(jiti@2.4.2) + debug: 4.4.3(supports-color@5.5.0) + eslint: 9.39.2 eslint-scope: 8.4.0 eslint-visitor-keys: 4.2.1 espree: 10.4.0 esquery: 1.6.0 - lodash: 4.17.21 - semver: 7.7.2 + semver: 7.7.3 transitivePeerDependencies: - supports-color + dev: true + + /vue-tsc@2.2.12(typescript@5.9.3): + resolution: {integrity: sha512-P7OP77b2h/Pmk+lZdJ0YWs+5tJ6J2+uOQPo7tlBnY44QqQSPYvS0qVT4wqDJgwrZaLe47etJLLQRFia71GYITw==} + hasBin: true + peerDependencies: + typescript: '>=5.0.0' + dependencies: + '@volar/typescript': 2.4.15 + '@vue/language-core': 2.2.12(typescript@5.9.3) + typescript: 5.9.3 + dev: true - vue-tsc@2.2.10(typescript@5.8.3): + /vue@3.5.25(typescript@5.9.3): + resolution: {integrity: sha512-YLVdgv2K13WJ6n+kD5owehKtEXwdwXuj2TTyJMsO7pSeKw2bfRNZGjhB7YzrpbMYj5b5QsUebHpOqR3R3ziy/g==} + peerDependencies: + typescript: '*' + peerDependenciesMeta: + typescript: + optional: true dependencies: - '@volar/typescript': 2.4.14 - '@vue/language-core': 2.2.10(typescript@5.8.3) - typescript: 5.8.3 + '@vue/compiler-dom': 3.5.25 + '@vue/compiler-sfc': 3.5.25 + '@vue/runtime-dom': 3.5.25 + '@vue/server-renderer': 3.5.25(vue@3.5.25) + '@vue/shared': 3.5.25 + typescript: 5.9.3 - vue@3.5.16(typescript@5.8.3): + /w3c-xmlserializer@5.0.0: + resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==} + engines: {node: '>=18'} dependencies: - '@vue/compiler-dom': 3.5.16 - '@vue/compiler-sfc': 3.5.16 - '@vue/runtime-dom': 3.5.16 - '@vue/server-renderer': 3.5.16(vue@3.5.16(typescript@5.8.3)) - '@vue/shared': 3.5.16 - optionalDependencies: - typescript: 5.8.3 + xml-name-validator: 5.0.0 + dev: true - walker@1.0.8: + /walker@1.0.8: + resolution: {integrity: sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==} dependencies: makeerror: 1.0.12 + dev: true - watchpack@2.4.2: + /watchpack@2.4.4: + resolution: {integrity: sha512-c5EGNOiyxxV5qmTtAB7rbiXxi1ooX1pQKMLX/MIabJjRA0SJBQOjKF+KSVfHkr9U1cADPon0mRiVe/riyaiDUA==} + engines: {node: '>=10.13.0'} dependencies: glob-to-regexp: 0.4.1 graceful-fs: 4.2.11 + dev: true - wcwidth@1.0.1: - dependencies: - defaults: 1.0.4 - - web-ext-run@0.2.3: + /web-ext-run@0.2.4: + resolution: {integrity: sha512-rQicL7OwuqWdQWI33JkSXKcp7cuv1mJG8u3jRQwx/8aDsmhbTHs9ZRmNYOL+LX0wX8edIEQX8jj4bB60GoXtKA==} + engines: {node: '>=18.0.0', npm: '>=8.0.0'} dependencies: - '@babel/runtime': 7.27.0 + '@babel/runtime': 7.28.2 '@devicefarmer/adbkit': 3.3.8 - chrome-launcher: 1.1.2 + chrome-launcher: 1.2.0 debounce: 1.2.1 es6-error: 4.1.1 firefox-profile: 4.7.0 @@ -9308,137 +9887,222 @@ snapshots: multimatch: 6.0.0 node-notifier: 10.0.1 parse-json: 7.1.1 - pino: 9.6.0 + pino: 9.7.0 promise-toolbox: 0.21.0 set-value: 4.1.0 source-map-support: 0.5.21 strip-bom: 5.0.0 - strip-json-comments: 5.0.1 - tmp: 0.2.3 + strip-json-comments: 5.0.2 + tmp: 0.2.5 update-notifier: 7.3.1 - watchpack: 2.4.2 - ws: 8.18.1 + watchpack: 2.4.4 zip-dir: 2.0.0 transitivePeerDependencies: - - bufferutil - supports-color - - utf-8-validate + dev: true - webidl-conversions@3.0.1: {} + /webidl-conversions@3.0.1: + resolution: {integrity: sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==} + dev: false - webidl-conversions@4.0.2: {} + /webidl-conversions@7.0.0: + resolution: {integrity: sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==} + engines: {node: '>=12'} + dev: true - webpack-virtual-modules@0.6.2: {} + /webpack-virtual-modules@0.6.2: + resolution: {integrity: sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ==} + dev: true - whatwg-url@5.0.0: + /whatwg-encoding@3.1.1: + resolution: {integrity: sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==} + engines: {node: '>=18'} dependencies: - tr46: 0.0.3 - webidl-conversions: 3.0.1 + iconv-lite: 0.6.3 + dev: true + + /whatwg-mimetype@4.0.0: + resolution: {integrity: sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==} + engines: {node: '>=18'} + dev: true + + /whatwg-url@14.2.0: + resolution: {integrity: sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==} + engines: {node: '>=18'} + dependencies: + tr46: 5.1.1 + webidl-conversions: 7.0.0 + dev: true - whatwg-url@7.1.0: + /whatwg-url@5.0.0: + resolution: {integrity: sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==} dependencies: - lodash.sortby: 4.7.0 - tr46: 1.0.1 - webidl-conversions: 4.0.2 + tr46: 0.0.3 + webidl-conversions: 3.0.1 + dev: false - when-exit@2.1.4: {} + /when-exit@2.1.5: + resolution: {integrity: sha512-VGkKJ564kzt6Ms1dbgPP/yuIoQCrsFAnRbptpC5wOEsDaNsbCB2bnfnaA8i/vRs5tjUSEOtIuvl9/MyVsvQZCg==} + dev: true - when@3.7.7: {} + /when@3.7.7: + resolution: {integrity: sha512-9lFZp/KHoqH6bPKjbWqa+3Dg/K/r2v0X/3/G2x4DBGchVS2QX2VXL3cZV994WQVnTM1/PD71Az25nAzryEUugw==} + dev: true - which@1.2.4: + /which@1.2.4: + resolution: {integrity: sha512-zDRAqDSBudazdfM9zpiI30Fu9ve47htYXcGi3ln0wfKu2a7SmrT6F3VDoYONu//48V8Vz4TdCRNPjtvyRO3yBA==} + hasBin: true dependencies: is-absolute: 0.1.7 isexe: 1.1.2 + dev: true - which@2.0.2: + /which@2.0.2: + resolution: {integrity: sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==} + engines: {node: '>= 8'} + hasBin: true dependencies: isexe: 2.0.0 - widest-line@5.0.0: + /why-is-node-running@2.3.0: + resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==} + engines: {node: '>=8'} + hasBin: true + dependencies: + siginfo: 2.0.0 + stackback: 0.0.2 + dev: true + + /widest-line@5.0.0: + resolution: {integrity: sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==} + engines: {node: '>=18'} dependencies: string-width: 7.2.0 + dev: true + + /winreg@0.0.12: + resolution: {integrity: sha512-typ/+JRmi7RqP1NanzFULK36vczznSNN8kWVA9vIqXyv8GhghUlwhGp1Xj3Nms1FsPcNnsQrJOR10N58/nQ9hQ==} + dev: true - winreg@0.0.12: {} + /word-wrap@1.2.5: + resolution: {integrity: sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==} + engines: {node: '>=0.10.0'} + dev: true - word-wrap@1.2.5: {} + /wordwrap@1.0.0: + resolution: {integrity: sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==} + dev: true - wrap-ansi@7.0.0: + /wrap-ansi@7.0.0: + resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==} + engines: {node: '>=10'} dependencies: ansi-styles: 4.3.0 string-width: 4.2.3 strip-ansi: 6.0.1 + dev: true - wrap-ansi@8.1.0: + /wrap-ansi@8.1.0: + resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==} + engines: {node: '>=12'} dependencies: - ansi-styles: 6.2.1 + ansi-styles: 6.2.3 string-width: 5.1.2 - strip-ansi: 7.1.0 + strip-ansi: 7.1.2 + dev: true - wrap-ansi@9.0.0: + /wrap-ansi@9.0.2: + resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==} + engines: {node: '>=18'} dependencies: - ansi-styles: 6.2.1 + ansi-styles: 6.2.3 string-width: 7.2.0 - strip-ansi: 7.1.0 + strip-ansi: 7.1.2 + dev: true - wrappy@1.0.2: {} + /wrappy@1.0.2: + resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==} - write-file-atomic@4.0.2: + /write-file-atomic@4.0.2: + resolution: {integrity: sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==} + engines: {node: ^12.13.0 || ^14.15.0 || >=16.0.0} dependencies: imurmurhash: 0.1.4 signal-exit: 3.0.7 + dev: true + + /ws@8.18.3: + resolution: {integrity: sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==} + engines: {node: '>=10.0.0'} + peerDependencies: + bufferutil: ^4.0.1 + utf-8-validate: '>=5.0.2' + peerDependenciesMeta: + bufferutil: + optional: true + utf-8-validate: + optional: true + dev: true - ws@8.18.1: {} + /wsl-utils@0.1.0: + resolution: {integrity: sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==} + engines: {node: '>=18'} + dependencies: + is-wsl: 3.1.0 + dev: true - wxt@0.20.7(@types/node@22.15.30)(jiti@2.4.2)(rollup@4.42.0)(yaml@2.8.0): + /wxt@0.20.11(@types/node@22.19.2): + resolution: {integrity: sha512-DqqHc/5COs8GR21ii99bANXf/mu6zuDpiXFV1YKNsqO5/PvkrCx5arY0aVPL5IATsuacAnNzdj4eMc1qbzS53Q==} + hasBin: true dependencies: '@1natsu/wait-element': 4.1.2 - '@aklinker1/rollup-plugin-visualizer': 5.12.0(rollup@4.42.0) + '@aklinker1/rollup-plugin-visualizer': 5.12.0 '@webext-core/fake-browser': 1.3.2 '@webext-core/isolated-element': 1.1.2 '@webext-core/match-patterns': 1.0.3 - '@wxt-dev/browser': 0.0.326 - '@wxt-dev/storage': 1.1.1 + '@wxt-dev/browser': 0.1.4 + '@wxt-dev/storage': 1.2.6 async-mutex: 0.5.0 - c12: 3.0.4(magicast@0.3.5) + c12: 3.3.2(magicast@0.3.5) cac: 6.7.14 chokidar: 4.0.3 - ci-info: 4.2.0 + ci-info: 4.3.1 consola: 3.4.2 defu: 6.1.4 - dotenv: 16.5.0 - dotenv-expand: 12.0.2 - esbuild: 0.25.5 + dotenv: 17.2.3 + dotenv-expand: 12.0.3 + esbuild: 0.25.12 fast-glob: 3.3.3 - filesize: 10.1.6 - fs-extra: 11.3.0 - get-port-please: 3.1.2 + filesize: 11.0.13 + fs-extra: 11.3.2 + get-port-please: 3.2.0 giget: 2.0.0 hookable: 5.5.3 - import-meta-resolve: 4.1.0 + import-meta-resolve: 4.2.0 is-wsl: 3.1.0 json5: 2.2.3 jszip: 3.10.1 - linkedom: 0.18.11 + linkedom: 0.18.12 magicast: 0.3.5 - minimatch: 10.0.1 - nano-spawn: 0.2.1 + minimatch: 10.1.1 + nano-spawn: 1.0.3 normalize-path: 3.0.0 - nypm: 0.6.0 + nypm: 0.6.2 ohash: 2.0.11 - open: 10.1.2 + open: 10.2.0 ora: 8.2.0 - perfect-debounce: 1.0.0 + perfect-debounce: 2.0.0 picocolors: 1.1.1 prompts: 2.4.2 - publish-browser-extension: 3.0.0 + publish-browser-extension: 3.0.3 scule: 1.3.0 - unimport: 5.0.1 - vite: 6.3.5(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0) - vite-node: 3.2.3(@types/node@22.15.30)(jiti@2.4.2)(yaml@2.8.0) - web-ext-run: 0.2.3 + unimport: 5.5.0 + vite: 7.2.7(@types/node@22.19.2) + vite-node: 3.2.4(@types/node@22.19.2) + web-ext-run: 0.2.4 transitivePeerDependencies: - '@types/node' - - bufferutil + - canvas - jiti - less - lightningcss @@ -9450,41 +10114,64 @@ snapshots: - supports-color - terser - tsx - - utf-8-validate - yaml + dev: true + + /xdg-basedir@5.1.0: + resolution: {integrity: sha512-GCPAHLvrIH13+c0SuacwvRYj2SxJXQ4kaVTT5xgL3kPrz56XxkF21IGhjSE1+W0aw7gpBWRGXLCPnPby6lSpmQ==} + engines: {node: '>=12'} + dev: true - xdg-basedir@5.1.0: {} + /xml-name-validator@4.0.0: + resolution: {integrity: sha512-ICP2e+jsHvAj2E2lIHxa5tjXRlKDJo4IdvPvCXbXQGdzSfmSpNVyIKMvoZHjDY9DP0zV17iI85o90vRFXNccRw==} + engines: {node: '>=12'} + dev: true - xml-name-validator@4.0.0: {} + /xml-name-validator@5.0.0: + resolution: {integrity: sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==} + engines: {node: '>=18'} + dev: true - xml2js@0.6.2: + /xml2js@0.6.2: + resolution: {integrity: sha512-T4rieHaC1EXcES0Kxxj4JWgaUQHDk+qwHcYOCFHfiwKz7tOVPLq7Hjq9dM1WCMhylqMEfP7hMcOIChvotiZegA==} + engines: {node: '>=4.0.0'} dependencies: - sax: 1.4.1 + sax: 1.4.3 xmlbuilder: 11.0.1 + dev: true - xmlbuilder@11.0.1: {} - - y18n@5.0.8: {} + /xmlbuilder@11.0.1: + resolution: {integrity: sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA==} + engines: {node: '>=4.0'} + dev: true - yallist@3.1.1: {} + /xmlchars@2.2.0: + resolution: {integrity: sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==} + dev: true - yaml@2.8.0: {} + /y18n@5.0.8: + resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==} + engines: {node: '>=10'} + dev: true - yargs-parser@20.2.9: {} + /yallist@3.1.1: + resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==} + dev: true - yargs-parser@21.1.1: {} + /yaml@2.8.2: + resolution: {integrity: sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==} + engines: {node: '>= 14.6'} + hasBin: true + dev: true - yargs@16.2.0: - dependencies: - cliui: 7.0.4 - escalade: 3.2.0 - get-caller-file: 2.0.5 - require-directory: 2.1.1 - string-width: 4.2.3 - y18n: 5.0.8 - yargs-parser: 20.2.9 + /yargs-parser@21.1.1: + resolution: {integrity: sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==} + engines: {node: '>=12'} + dev: true - yargs@17.7.2: + /yargs@17.7.2: + resolution: {integrity: sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==} + engines: {node: '>=12'} dependencies: cliui: 8.0.1 escalade: 3.2.0 @@ -9493,25 +10180,37 @@ snapshots: string-width: 4.2.3 y18n: 5.0.8 yargs-parser: 21.1.1 + dev: true - yauzl@2.10.0: - dependencies: - buffer-crc32: 0.2.13 - fd-slicer: 1.1.0 - - yn@3.1.1: {} + /yn@3.1.1: + resolution: {integrity: sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==} + engines: {node: '>=6'} + dev: true - yocto-queue@0.1.0: {} + /yocto-queue@0.1.0: + resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==} + engines: {node: '>=10'} + dev: true - yocto-queue@1.2.1: {} + /yocto-queue@1.2.2: + resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==} + engines: {node: '>=12.20'} + dev: true - zip-dir@2.0.0: + /zip-dir@2.0.0: + resolution: {integrity: sha512-uhlsJZWz26FLYXOD6WVuq+fIcZ3aBPGo/cFdiLlv3KNwpa52IF3ISV8fLhQLiqVu5No3VhlqlgthN6gehil1Dg==} dependencies: async: 3.2.6 jszip: 3.10.1 + dev: true - zod-to-json-schema@3.24.5(zod@3.25.56): + /zod-to-json-schema@3.25.0(zod@3.25.76): + resolution: {integrity: sha512-HvWtU2UG41LALjajJrML6uQejQhNJx+JBO9IflpSja4R03iNWfKXrj6W2h7ljuLyc1nKS+9yDyL/9tD1U/yBnQ==} + peerDependencies: + zod: ^3.25 || ^4 dependencies: - zod: 3.25.56 + zod: 3.25.76 + dev: false - zod@3.25.56: {} + /zod@3.25.76: + resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==} diff --git a/releases/chrome-extension/latest/chrome-mcp-server-lastest.zip b/releases/chrome-extension/latest/chrome-mcp-server-lastest.zip index 2ba520f0..79d4ed4f 100644 Binary files a/releases/chrome-extension/latest/chrome-mcp-server-lastest.zip and b/releases/chrome-extension/latest/chrome-mcp-server-lastest.zip differ diff --git a/test-inject-script.js b/test-inject-script.js deleted file mode 100644 index 8723f566..00000000 --- a/test-inject-script.js +++ /dev/null @@ -1,314 +0,0 @@ -(() => { - const SCRIPT_ID = 'excalidraw-control-script'; - if (window[SCRIPT_ID]) { - return; - } - function getExcalidrawAPIFromDOM(domElement) { - if (!domElement) { - return null; - } - const reactFiberKey = Object.keys(domElement).find( - (key) => key.startsWith('__reactFiber$') || key.startsWith('__reactInternalInstance$'), - ); - if (!reactFiberKey) { - return null; - } - let fiberNode = domElement[reactFiberKey]; - if (!fiberNode) { - return null; - } - function isExcalidrawAPI(obj) { - return ( - typeof obj === 'object' && - obj !== null && - typeof obj.updateScene === 'function' && - typeof obj.getSceneElements === 'function' && - typeof obj.getAppState === 'function' - ); - } - function findApiInObject(objToSearch) { - if (isExcalidrawAPI(objToSearch)) { - return objToSearch; - } - if (typeof objToSearch === 'object' && objToSearch !== null) { - for (const key in objToSearch) { - if (Object.prototype.hasOwnProperty.call(objToSearch, key)) { - const found = findApiInObject(objToSearch[key]); - if (found) { - return found; - } - } - } - } - return null; - } - let excalidrawApiInstance = null; - let attempts = 0; - const MAX_TRAVERSAL_ATTEMPTS = 25; - while (fiberNode && attempts < MAX_TRAVERSAL_ATTEMPTS) { - if (fiberNode.stateNode && fiberNode.stateNode.props) { - const api = findApiInObject(fiberNode.stateNode.props); - if (api) { - excalidrawApiInstance = api; - break; - } - if (isExcalidrawAPI(fiberNode.stateNode.props.excalidrawAPI)) { - excalidrawApiInstance = fiberNode.stateNode.props.excalidrawAPI; - break; - } - } - if (fiberNode.memoizedProps) { - const api = findApiInObject(fiberNode.memoizedProps); - if (api) { - excalidrawApiInstance = api; - break; - } - if (isExcalidrawAPI(fiberNode.memoizedProps.excalidrawAPI)) { - excalidrawApiInstance = fiberNode.memoizedProps.excalidrawAPI; - break; - } - } - - if (fiberNode.tag === 1 && fiberNode.stateNode && fiberNode.stateNode.state) { - const api = findApiInObject(fiberNode.stateNode.state); - if (api) { - excalidrawApiInstance = api; - break; - } - } - - if ( - fiberNode.tag === 0 || - fiberNode.tag === 2 || - fiberNode.tag === 14 || - fiberNode.tag === 15 || - fiberNode.tag === 11 - ) { - if (fiberNode.memoizedState) { - let currentHook = fiberNode.memoizedState; - let hookAttempts = 0; - const MAX_HOOK_ATTEMPTS = 15; - while (currentHook && hookAttempts < MAX_HOOK_ATTEMPTS) { - const api = findApiInObject(currentHook.memoizedState); - if (api) { - excalidrawApiInstance = api; - break; - } - currentHook = currentHook.next; - hookAttempts++; - } - if (excalidrawApiInstance) break; - } - } - if (fiberNode.stateNode) { - const api = findApiInObject(fiberNode.stateNode); - if (api && api !== fiberNode.stateNode.props && api !== fiberNode.stateNode.state) { - excalidrawApiInstance = api; - break; - } - } - if ( - fiberNode.tag === 9 && - fiberNode.memoizedProps && - typeof fiberNode.memoizedProps.value !== 'undefined' - ) { - const api = findApiInObject(fiberNode.memoizedProps.value); - if (api) { - excalidrawApiInstance = api; - break; - } - } - - if (fiberNode.return) { - fiberNode = fiberNode.return; - } else { - break; - } - attempts++; - } - - if (excalidrawApiInstance) { - window.excalidrawAPI = excalidrawApiInstance; - console.log('现在您可以通过 `window.foundExcalidrawAPI` 在控制台访问它。'); - } else { - console.error('在检查组件树后未能找到 excalidrawAPI。'); - } - return excalidrawApiInstance; - } - - function createFullExcalidrawElement(skeleton) { - const id = Math.random().toString(36).substring(2, 9); - - const seed = Math.floor(Math.random() * 2 ** 31); - const versionNonce = Math.floor(Math.random() * 2 ** 31); - - const defaults = { - isDeleted: false, - fillStyle: 'hachure', - strokeWidth: 1, - strokeStyle: 'solid', - roughness: 1, - opacity: 100, - angle: 0, - groupIds: [], - strokeColor: '#000000', - backgroundColor: 'transparent', - version: 1, - locked: false, - }; - - const fullElement = { - id: id, - seed: seed, - versionNonce: versionNonce, - updated: Date.now(), - ...defaults, - ...skeleton, - }; - - return fullElement; - } - - let targetElementForAPI = document.querySelector('.excalidraw-app'); - - if (targetElementForAPI) { - getExcalidrawAPIFromDOM(targetElementForAPI); - } - - const eventHandler = { - getSceneElements: () => { - try { - return window.excalidrawAPI.getSceneElements(); - } catch (error) { - return { - error: true, - msg: JSON.stringify(error), - }; - } - }, - addElement: (param) => { - try { - const existingElements = window.excalidrawAPI.getSceneElements(); - const newElements = [...existingElements]; - param.eles.forEach((ele, idx) => { - const newEle = createFullExcalidrawElement(ele); - newEle.index = `a${existingElements.length + idx + 1}`; - newElements.push(newEle); - }); - console.log('newElements ==>', newElements); - const appState = window.excalidrawAPI.getAppState(); - window.excalidrawAPI.updateScene({ - elements: newElements, - appState: appState, - commitToHistory: true, - }); - return { - success: true, - }; - } catch (error) { - return { - error: true, - msg: JSON.stringify(error), - }; - } - }, - deleteElement: (param) => { - try { - const existingElements = window.excalidrawAPI.getSceneElements(); - const newElements = [...existingElements]; - const idx = newElements.findIndex((e) => e.id === param.id); - if (idx >= 0) { - newElements.splice(idx, 1); - const appState = window.excalidrawAPI.getAppState(); - window.excalidrawAPI.updateScene({ - elements: newElements, - appState: appState, - commitToHistory: true, - }); - return { - success: true, - }; - } else { - return { - error: true, - msg: 'element not found', - }; - } - } catch (error) { - return { - error: true, - msg: JSON.stringify(error), - }; - } - }, - updateElement: (param) => { - try { - const existingElements = window.excalidrawAPI.getSceneElements(); - const resIds = []; - for (let i = 0; i < param.length; i++) { - const idx = existingElements.findIndex((e) => e.id === param[i].id); - if (idx >= 0) { - resIds.push[idx]; - window.excalidrawAPI.mutateElement(existingElements[idx], { ...param[i] }); - } - } - return { - success: true, - msg: `已更新元素：${resIds.join(',')}`, - }; - } catch (error) { - return { - error: true, - msg: JSON.stringify(error), - }; - } - }, - cleanup: () => { - try { - window.excalidrawAPI.resetScene(); - return { - success: true, - }; - } catch (error) { - return { - error: true, - msg: JSON.stringify(error), - }; - } - }, - }; - - const handleExecution = (event) => { - const { action, payload, requestId } = event.detail; - const param = JSON.parse(payload || '{}'); - let data, error; - try { - const handler = eventHandler[action]; - if (!handler) { - error = 'event name not found'; - } - data = handler(param); - } catch (e) { - error = e.message; - } - window.dispatchEvent( - new CustomEvent('chrome-mcp:response', { detail: { requestId, data, error } }), - ); - }; - - // --- Lifecycle Functions --- - const initialize = () => { - window.addEventListener('chrome-mcp:execute', handleExecution); - window.addEventListener('chrome-mcp:cleanup', cleanup); - window[SCRIPT_ID] = true; - }; - - const cleanup = () => { - window.removeEventListener('chrome-mcp:execute', handleExecution); - window.removeEventListener('chrome-mcp:cleanup', cleanup); - delete window[SCRIPT_ID]; - delete window.excalidrawAPI; - }; - - initialize(); -})();