vite-plugin-ai-annotator 1.14.13 → 1.14.16

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "vite-plugin-ai-annotator",
-  "version": "1.14.13",
+  "version": "1.14.16",
   "description": "AI-powered element annotator for Vite - Pick elements and get instant AI code modifications",
   "type": "module",
   "main": "dist/vite-plugin.js",
   "types": "dist/vite-plugin.d.ts",
   "bin": {
-    "vite-plugin-ai-annotator": "./dist/index.cjs"
+    "vite-plugin-ai-annotator": "dist/index.cjs"
   },
   "exports": {
     ".": {

package/dist/auto-setup-mcp.d.ts

@@ -1,10 +0,0 @@
-export interface AutoSetupMcpOptions {
-    projectRoot: string;
-    serverUrl: string;
-    verbose?: boolean;
-}
-export interface AutoSetupResult {
-    updated: string[];
-    alreadyConfigured: string[];
-}
-export declare function autoSetupMcp(options: AutoSetupMcpOptions): AutoSetupResult;

package/dist/mcp/index.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-/**
- * InstantCode MCP Server
- *
- * Provides MCP tools for Claude Desktop/Claude Code to interact with
- * browser elements through the InstantCode inspector.
- */
-export {};

package/dist/mcp-stdio.d.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-/**
- * AI Annotator MCP CLI
- *
- * Stdio-based MCP server that connects to AI Annotator server via socket.io
- * and forwards tool calls to browser sessions.
- *
- * Usage:
- *   node mcp-stdio.js [--server <url>]
- *
- * Options:
- *   --server, -s   Server URL (default: http://localhost:7318)
- *                  Can also use AI_ANNOTATOR_SERVER env var
- */
-export {};

package/dist/mcp-tools.d.ts

@@ -1,25 +0,0 @@
-/**
- * Shared MCP tool definitions for AI Annotator
- *
- * Registers all 9 MCP tools on a McpServer instance.
- * Used by both ws-server.ts (HTTP MCP) and mcp-stdio.ts (stdio MCP).
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { BrowserSession, PageContext, ElementData, SelectionResult, ScreenshotResult, InjectResult, ConsoleEntry } from './rpc/define';
-import type { RpcError } from './rpc/types.generated';
-export interface AnnotatorConnection {
-    sessionId: string;
-    getPageContext(timeout?: number): Promise<PageContext | RpcError>;
-    getSelectedElements(timeout?: number): Promise<ElementData[] | RpcError>;
-    triggerSelection(mode: 'inspect' | 'selector', selector?: string, selectorType?: 'css' | 'xpath', timeout?: number): Promise<SelectionResult | RpcError>;
-    captureScreenshot(type: 'viewport' | 'element', selector?: string, quality?: number, timeout?: number): Promise<ScreenshotResult | RpcError>;
-    clearSelection(): void;
-    injectCSS(css: string, timeout?: number): Promise<InjectResult | RpcError>;
-    injectJS(code: string, timeout?: number): Promise<InjectResult | RpcError>;
-    getConsole(clear?: boolean, timeout?: number): Promise<ConsoleEntry[] | RpcError>;
-}
-export type GetConnection = (sessionId?: string) => AnnotatorConnection | {
-    error: string;
-};
-export type ListSessions = () => Promise<BrowserSession[]>;
-export declare function registerMcpTools(mcp: McpServer, listSessions: ListSessions, getConnection: GetConnection): void;

package/dist/shared/schemas.d.ts

@@ -1,119 +0,0 @@
-import { z } from 'zod';
-export declare const WSMessageSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        request: "request";
-        response: "response";
-        event: "event";
-    }>;
-    requestId: z.ZodOptional<z.ZodString>;
-    action: z.ZodString;
-    payload: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>;
-export type WSMessage = z.infer<typeof WSMessageSchema>;
-export declare const WSActionSchema: z.ZodEnum<{
-    ping: "ping";
-    get_page_context: "get_page_context";
-    get_selected_elements: "get_selected_elements";
-    trigger_selection: "trigger_selection";
-    select_by_selector: "select_by_selector";
-    capture_screenshot: "capture_screenshot";
-    clear_selection: "clear_selection";
-}>;
-export type WSAction = z.infer<typeof WSActionSchema>;
-export declare const PageContextSchema: z.ZodObject<{
-    url: z.ZodString;
-    title: z.ZodString;
-    selectionCount: z.ZodNumber;
-    isInspecting: z.ZodBoolean;
-}, z.core.$strip>;
-export type PageContext = z.infer<typeof PageContextSchema>;
-export declare const ScreenshotOptionsSchema: z.ZodObject<{
-    type: z.ZodDefault<z.ZodEnum<{
-        viewport: "viewport";
-        element: "element";
-    }>>;
-    selector: z.ZodOptional<z.ZodString>;
-    format: z.ZodDefault<z.ZodEnum<{
-        png: "png";
-        jpeg: "jpeg";
-    }>>;
-    quality: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export type ScreenshotOptions = z.infer<typeof ScreenshotOptionsSchema>;
-export declare const SelectionTriggerSchema: z.ZodObject<{
-    mode: z.ZodDefault<z.ZodEnum<{
-        inspect: "inspect";
-        selector: "selector";
-    }>>;
-    selector: z.ZodOptional<z.ZodString>;
-    selectorType: z.ZodDefault<z.ZodEnum<{
-        css: "css";
-        xpath: "xpath";
-    }>>;
-}, z.core.$strip>;
-export type SelectionTrigger = z.infer<typeof SelectionTriggerSchema>;
-export declare const BrowserSessionSchema: z.ZodObject<{
-    id: z.ZodString;
-    url: z.ZodString;
-    title: z.ZodString;
-    connectedAt: z.ZodNumber;
-    lastActivity: z.ZodNumber;
-}, z.core.$strip>;
-export type BrowserSession = z.infer<typeof BrowserSessionSchema>;
-declare const ElementDataBaseSchema: z.ZodObject<{
-    index: z.ZodNumber;
-    tagName: z.ZodString;
-    xpath: z.ZodString;
-    cssSelector: z.ZodString;
-    textContent: z.ZodString;
-    attributes: z.ZodRecord<z.ZodString, z.ZodString>;
-    imagePath: z.ZodOptional<z.ZodString>;
-    comment: z.ZodOptional<z.ZodString>;
-    computedStyles: z.ZodOptional<z.ZodObject<{
-        width: z.ZodNumber;
-        height: z.ZodNumber;
-        fontSize: z.ZodString;
-        fontFamily: z.ZodString;
-        color: z.ZodOptional<z.ZodString>;
-        backgroundColor: z.ZodOptional<z.ZodString>;
-        display: z.ZodOptional<z.ZodString>;
-        position: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    componentData: z.ZodOptional<z.ZodObject<{
-        componentLocation: z.ZodString;
-        componentName: z.ZodOptional<z.ZodString>;
-        elementLocation: z.ZodOptional<z.ZodObject<{
-            file: z.ZodString;
-            line: z.ZodNumber;
-            column: z.ZodNumber;
-            endLine: z.ZodOptional<z.ZodNumber>;
-            endColumn: z.ZodOptional<z.ZodNumber>;
-            source: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        framework: z.ZodOptional<z.ZodEnum<{
-            vue: "vue";
-            react: "react";
-            angular: "angular";
-            svelte: "svelte";
-            vanilla: "vanilla";
-        }>>;
-        sourceMap: z.ZodOptional<z.ZodObject<{
-            originalLine: z.ZodNumber;
-            originalColumn: z.ZodNumber;
-            originalSource: z.ZodString;
-            originalName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        sourceHierarchy: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-type ElementDataType = z.infer<typeof ElementDataBaseSchema> & {
-    children: ElementDataType[];
-};
-export declare const ElementDataSchema: z.ZodType<ElementDataType>;
-export declare const PageInfoSchema: z.ZodObject<{
-    url: z.ZodString;
-    title: z.ZodString;
-}, z.core.$strip>;
-export type ElementData = z.infer<typeof ElementDataSchema>;
-export type PageInfo = z.infer<typeof PageInfoSchema>;
-export {};

package/dist/shared/types.d.ts

@@ -1 +0,0 @@
-export type { ElementData, PageInfo, } from './schemas';

package/dist/trpc/context.d.ts

@@ -1,28 +0,0 @@
-import type { CreateExpressContextOptions } from '@trpc/server/adapters/express';
-import type { CreateWSSContextFnOptions } from '@trpc/server/adapters/ws';
-/**
- * Inner context - always available in procedures
- * Used for shared data like database connections
- */
-export declare function createContextInner(verbose?: boolean): Promise<{
-    verbose: boolean;
-    logger: import("../utils/logger").Logger;
-}>;
-/**
- * Context for Express HTTP requests
- */
-export declare function createContext(opts: CreateExpressContextOptions, verbose?: boolean): Promise<{
-    req: import("express").Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
-    res: import("express").Response<any, Record<string, any>>;
-    verbose: boolean;
-    logger: import("../utils/logger").Logger;
-}>;
-/**
- * Context for WebSocket connections
- */
-export declare function createWSSContext(opts: CreateWSSContextFnOptions, verbose?: boolean): Promise<{
-    req: import("http").IncomingMessage;
-    verbose: boolean;
-    logger: import("../utils/logger").Logger;
-}>;
-export type Context = Awaited<ReturnType<typeof createContextInner>>;

package/dist/trpc/router.d.ts

@@ -1,195 +0,0 @@
-export declare const router: import("@trpc/server").TRPCRouterBuilder<{
-    ctx: {
-        verbose: boolean;
-        logger: import("../utils/logger").Logger;
-    };
-    meta: object;
-    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-    transformer: true;
-}>;
-export declare const publicProcedure: import("@trpc/server").TRPCProcedureBuilder<{
-    verbose: boolean;
-    logger: import("../utils/logger").Logger;
-}, object, object, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, import("@trpc/server").TRPCUnsetMarker, false>;
-export declare const appRouter: import("@trpc/server").TRPCBuiltRouter<{
-    ctx: {
-        verbose: boolean;
-        logger: import("../utils/logger").Logger;
-    };
-    meta: object;
-    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
-    transformer: true;
-}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
-    health: import("@trpc/server").TRPCQueryProcedure<{
-        input: void;
-        output: {
-            status: string;
-            timestamp: string;
-        };
-        meta: object;
-    }>;
-    newChat: import("@trpc/server").TRPCMutationProcedure<{
-        input: void;
-        output: {
-            success: boolean;
-        };
-        meta: object;
-    }>;
-    sendMessage: import("@trpc/server").TRPCSubscriptionProcedure<{
-        input: {
-            userPrompt: string;
-            selectedElements: {
-                index: number;
-                tagName: string;
-                xpath: string;
-                cssSelector: string;
-                textContent: string;
-                attributes: Record<string, string>;
-                children: any[];
-                imagePath?: string | undefined;
-                computedStyles?: {
-                    width: number;
-                    height: number;
-                    fontSize: string;
-                    fontFamily: string;
-                    color?: string | undefined;
-                    backgroundColor?: string | undefined;
-                    display?: string | undefined;
-                    position?: string | undefined;
-                } | undefined;
-                componentData?: {
-                    componentLocation: string;
-                    componentName?: string | undefined;
-                    elementLocation?: {
-                        file: string;
-                        line: number;
-                        column: number;
-                        endLine?: number | undefined;
-                        endColumn?: number | undefined;
-                        source?: string | undefined;
-                    } | undefined;
-                    framework?: "vue" | "react" | "angular" | "svelte" | "vanilla" | undefined;
-                    sourceMap?: {
-                        originalLine: number;
-                        originalColumn: number;
-                        originalSource: string;
-                        originalName?: string | undefined;
-                    } | undefined;
-                    sourceHierarchy?: string | undefined;
-                } | undefined;
-            }[];
-            pageInfo: {
-                url: string;
-                title: string;
-            };
-            cwd?: string | undefined;
-            sessionId?: string | undefined;
-            consoleErrors?: string[] | undefined;
-            consoleWarnings?: string[] | undefined;
-            consoleInfo?: string[] | undefined;
-        };
-        output: AsyncIterable<{
-            type: "system";
-            subtype: "init";
-            apiKeySource: "user" | "project" | "org" | "temporary";
-            cwd: string;
-            session_id: string;
-            tools: string[];
-            mcp_servers: {
-                name: string;
-                status: string;
-            }[];
-            model: string;
-            permissionMode: "default" | "acceptEdits" | "bypassPermissions" | "plan";
-            slash_commands: string[];
-        } | {
-            type: "assistant";
-            message: {
-                id: string;
-                type: "message";
-                role: "assistant";
-                model: string;
-                content: {
-                    type: string;
-                    text?: string | undefined;
-                    id?: string | undefined;
-                    name?: string | undefined;
-                    input?: Record<string, unknown> | undefined;
-                }[];
-                stop_reason?: string | null | undefined;
-                stop_sequence?: string | null | undefined;
-                usage?: {
-                    input_tokens: number;
-                    output_tokens: number;
-                    cache_creation_input_tokens?: number | undefined;
-                    cache_read_input_tokens?: number | undefined;
-                } | undefined;
-            };
-            parent_tool_use_id: string | null;
-            session_id: string;
-        } | {
-            type: "user";
-            message: {
-                role: "user";
-                content: {
-                    type: string;
-                    content?: string | undefined;
-                    tool_use_id?: string | undefined;
-                }[];
-            };
-            parent_tool_use_id: string | null;
-            session_id: string;
-        } | {
-            type: "result";
-            subtype: "success";
-            duration_ms: number;
-            duration_api_ms: number;
-            is_error: false;
-            num_turns: number;
-            result: string;
-            session_id: string;
-            total_cost_usd: number;
-            usage: {
-                input_tokens: number;
-                cache_creation_input_tokens: number;
-                cache_read_input_tokens: number;
-                output_tokens: number;
-            };
-            permission_denials: {
-                tool_name: string;
-                tool_use_id: string;
-                tool_input: Record<string, unknown>;
-            }[];
-        } | {
-            type: "result";
-            subtype: "error_max_turns" | "error_during_execution";
-            duration_ms: number;
-            duration_api_ms: number;
-            is_error: true;
-            num_turns: number;
-            session_id: string;
-            total_cost_usd: number;
-            usage: {
-                input_tokens: number;
-                cache_creation_input_tokens: number;
-                cache_read_input_tokens: number;
-                output_tokens: number;
-            };
-            permission_denials: {
-                tool_name: string;
-                tool_use_id: string;
-                tool_input: Record<string, unknown>;
-            }[];
-        } | {
-            type: "result";
-            subtype: "error";
-            is_error: true;
-            duration_ms: number;
-            duration_api_ms: number;
-            result: string;
-            session_id?: string | undefined;
-        }, void, any>;
-        meta: object;
-    }>;
-}>>;
-export type AppRouter = typeof appRouter;

package/dist/trpc-server.d.ts

@@ -1,14 +0,0 @@
-import type { Express } from 'express';
-import type { Server } from 'node:http';
-import { WebSocketServer } from 'ws';
-export interface ServerInstance {
-    app: Express;
-    server: Server;
-    wss: WebSocketServer;
-    port: number;
-    listenAddress: string;
-    publicAddress: string;
-    verbose: boolean;
-}
-export declare function startServer(port: number, listenAddress: string, publicAddress: string, verbose?: boolean): Promise<ServerInstance>;
-export declare function stopServer(serverInstance: ServerInstance): Promise<void>;

package/dist/utils/html.d.ts

@@ -1,7 +0,0 @@
-/**
- * HTML utilities for safe text handling and string hashing
- */
-export declare class HtmlUtils {
-    static escapeHtml(text: string): string;
-    static hashString(content: string): string;
-}

package/dist/utils/sourcemap.d.ts

@@ -1,72 +0,0 @@
-/**
- * Source Map utilities for mapping runtime elements back to source code
- */
-export interface SourceMapPosition {
-    line: number;
-    column: number;
-    source?: string;
-    name?: string;
-}
-export interface SourceMapInfo {
-    file: string;
-    line: number;
-    column: number;
-    endLine?: number;
-    endColumn?: number;
-    originalSource?: string;
-    sourcesContent?: string[];
-}
-/**
- * Basic source map consumer for parsing VLQ-encoded mappings
- * Note: This is a simplified implementation. For production use,
- * consider using the 'source-map' library for full compatibility.
- */
-export declare class BasicSourceMapConsumer {
-    private sources;
-    private sourcesContent?;
-    constructor(sourceMap: any);
-    /**
-     * Find original position for generated position
-     * This is a simplified implementation that looks for approximate mappings
-     */
-    originalPositionFor(line: number, column: number): SourceMapPosition | null;
-    /**
-     * Get source content for a given source file
-     */
-    sourceContentFor(source: string): string | null;
-    /**
-     * Get all available sources
-     */
-    getSources(): string[];
-}
-/**
- * Attempt to find and parse source maps from various sources
- */
-export declare class SourceMapResolver {
-    private sourceMapCache;
-    /**
-     * Try to find source map for a given file URL
-     */
-    findSourceMapForFile(fileUrl: string): Promise<BasicSourceMapConsumer | null>;
-    /**
-     * Resolve original position from generated position using source maps
-     */
-    resolvePosition(fileUrl: string, line: number, column: number): Promise<SourceMapPosition | null>;
-    /**
-     * Get enhanced location info by combining runtime data with source maps
-     */
-    getEnhancedLocationInfo(fileUrl: string, line: number, column: number): Promise<SourceMapInfo | null>;
-    /**
-     * Clear the source map cache
-     */
-    clearCache(): void;
-}
-export declare const sourceMapResolver: SourceMapResolver;
-/**
- * Helper function to extract source location from browser stack traces
- */
-export declare function extractLocationFromStackTrace(error: Error): {
-    file: string;
-    line: number;
-    column: number;
-} | null;