vibesurf 0.1.31__tar.gz → 0.1.33__tar.gz

{vibesurf-0.1.31 → vibesurf-0.1.33}/.env.example

@@ -47,6 +47,9 @@ VIBESURF_EXTENSION=
 VIBESURF_WORKSPACE=
 VIBESURF_DATABASE_URL=
 VIBESURF_DEBUG=
+VIBESURF_ANONYMIZED_TELEMETRY=true
 
 BROWSER_EXECUTION_PATH=
-BROWSER_USER_DATA=
+BROWSER_USER_DATA=
+
+COMPOSIO_API_KEY=

{vibesurf-0.1.31 → vibesurf-0.1.33}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vibesurf
-Version: 0.1.31
+Version: 0.1.33
 Summary: VibeSurf: A powerful browser assistant for vibe surfing
 Author: WarmShao
 License: Apache-2.0
@@ -46,10 +46,12 @@ Requires-Dist: dashscope>=1.24.5
 Requires-Dist: yfinance>=0.2.66
 Requires-Dist: pyexecjs>=1.5.1
 Requires-Dist: youtube-transcript-api>=1.2.2
+Requires-Dist: composio>=0.8.20
+Requires-Dist: composio-langchain>=0.8.20
 Dynamic: license-file
 
 # VibeSurf: A powerful browser assistant for vibe surfing
-[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
+[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
 [![WarmShao](https://img.shields.io/twitter/follow/warmshao?style=social)](https://x.com/warmshao)
 
 VibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.
@@ -141,16 +143,16 @@ uv run vibesurf
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
 - [x] **Smart Skills System** - *Completed*
-  Add `/search` for quick information search and `/crawl` for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
+  Add `/search` for quick information search, `/crawl` for automatic website data extraction and `/code` for webpage js code execution. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
 
-- [ ] **Powerful Coding Agent** - *In Progress*
-  Build a comprehensive coding assistant for data processing and analysis directly in your browser
+- [x] **Third-Party Integrations** - *Completed*
+  Connect with hundreds of popular tools including Gmail, Notion, Google Calendar, Slack, Trello, GitHub, and more through Composio integration to combine browsing with powerful automation capabilities
 
-- [ ] **Agentic Browser Workflow** - *Planned*
-  Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks
+- [ ] **Agentic Browser Workflow** - *In Progress*
+  Create custom drag-and-drop and conversation-based workflows for auto-login, data collection, and complex browser automation tasks
 
-- [ ] **Third-Party Integrations** - *Planned*
-  Connect with n8n workflows and other tools to combine browsing with automation
+- [ ] **Powerful Coding Agent** - *In Progress*
+  Build a comprehensive coding assistant for data processing and analysis directly in your browser
 
 - [ ] **Intelligent Memory & Personalization** - *Planned*
   Transform VibeSurf into a truly human-like companion with persistent memory that learns your preferences, habits, and browsing patterns over time

{vibesurf-0.1.31 → vibesurf-0.1.33}/README.md

@@ -1,5 +1,5 @@
 # VibeSurf: A powerful browser assistant for vibe surfing
-[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
+[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
 [![WarmShao](https://img.shields.io/twitter/follow/warmshao?style=social)](https://x.com/warmshao)
 
 VibeSurf is an open-source AI agentic browser that revolutionizes browser automation and research.
@@ -91,16 +91,16 @@ uv run vibesurf
 We're building VibeSurf to be your ultimate AI browser companion. Here's what's coming next:
 
 - [x] **Smart Skills System** - *Completed*
-  Add `/search` for quick information search and `/crawl` for automatic website data extraction. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
+  Add `/search` for quick information search, `/crawl` for automatic website data extraction and `/code` for webpage js code execution. Integrated native APIs for Xiaohongshu, Douyin, Weibo, and YouTube.
 
-- [ ] **Powerful Coding Agent** - *In Progress*
-  Build a comprehensive coding assistant for data processing and analysis directly in your browser
+- [x] **Third-Party Integrations** - *Completed*
+  Connect with hundreds of popular tools including Gmail, Notion, Google Calendar, Slack, Trello, GitHub, and more through Composio integration to combine browsing with powerful automation capabilities
 
-- [ ] **Agentic Browser Workflow** - *Planned*
-  Create custom drag-and-drop workflows for auto-login, data collection, and complex browser automation tasks
+- [ ] **Agentic Browser Workflow** - *In Progress*
+  Create custom drag-and-drop and conversation-based workflows for auto-login, data collection, and complex browser automation tasks
 
-- [ ] **Third-Party Integrations** - *Planned*
-  Connect with n8n workflows and other tools to combine browsing with automation
+- [ ] **Powerful Coding Agent** - *In Progress*
+  Build a comprehensive coding assistant for data processing and analysis directly in your browser
 
 - [ ] **Intelligent Memory & Personalization** - *Planned*
   Transform VibeSurf into a truly human-like companion with persistent memory that learns your preferences, habits, and browsing patterns over time

{vibesurf-0.1.31 → vibesurf-0.1.33}/README_zh.md

@@ -1,6 +1,6 @@
 # VibeSurf：强大的浏览器助手，用于氛围冲浪
 
-[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
+[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/EZ2YnUXP)
 [![WarmShao](https://img.shields.io/twitter/follow/warmshao?style=social)](https://x.com/warmshao)
 
 VibeSurf 是一个开源的 AI 代理浏览器，它革新了浏览器自动化和研究。
@@ -93,16 +93,16 @@ uv run vibesurf
 我们正在构建 VibeSurf，使其成为您终极的 AI 浏览器伴侣。以下是接下来的计划：
 
 - [x] **智能技能系统** - *已完成*
-  添加 `/search` 用于快速信息搜索，`/crawl` 用于自动网站数据提取。集成了小红书、抖音、微博和 YouTube 的原生 API。
+  添加 `/search` 用于快速信息搜索，`/crawl` 用于自动网站数据提取, `/code`用于页面自动执行js code。集成了小红书、抖音、微博和 YouTube 的原生 API。
 
-- [ ] **强大的编码代理** - *进行中*
-  构建一个全面的编码助手，用于在浏览器中直接进行数据处理和分析
+- [x] **第三方集成** - *已完成*
+  通过 Composio 集成连接数百种常用工具，包括 Gmail、Notion、Google Calendar、Slack、Trello、GitHub 等，将浏览与强大的自动化功能相结合
 
-- [ ] **智能浏览器工作流** - *计划中*
-  创建自定义拖拽式工作流，用于自动登录、数据收集和复杂的浏览器自动化任务
+- [ ] **智能浏览器工作流** - *进行中*
+  创建自定义拖拽式和对话式工作流，用于自动登录、数据收集和复杂的浏览器自动化任务
 
-- [ ] **第三方集成** - *计划中*
-  与 n8n 工作流和其他工具连接，将浏览与自动化结合
+- [ ] **强大的编码代理** - *进行中*
+  构建一个全面的编码助手，用于在浏览器中直接进行数据处理和分析
 
 - [ ] **智能记忆与个性化** - *计划中*
   将 VibeSurf 转变为真正的人性化伴侣，具备持久记忆功能，能够学习您的偏好、习惯和浏览模式

{vibesurf-0.1.31 → vibesurf-0.1.33}/pyproject.toml

@@ -47,6 +47,8 @@ dependencies = [
     "yfinance>=0.2.66",
     "pyexecjs>=1.5.1",
     "youtube-transcript-api>=1.2.2",
+    "composio>=0.8.20",
+    "composio-langchain>=0.8.20",
 ]
 
 [project.urls]

vibesurf-0.1.33/tests/test_telemetry.py

@@ -0,0 +1,31 @@
+import pdb
+
+import vibe_surf
+from vibe_surf.telemetry.service import ProductTelemetry
+from vibe_surf.telemetry.views import CLITelemetryEvent
+
+
+def test_cli_telemetry_event():
+    """Test CLITelemetryEvent structure."""
+    event = CLITelemetryEvent(
+        version=str(vibe_surf.__version__),
+        action='start',
+        mode='interactive',
+        model='gpt-4o',
+        model_provider='OpenAI',
+        duration_seconds=10.5,
+        error_message=None,
+    )
+
+    telemetry = ProductTelemetry()
+
+    # Check that posthog client is created
+    assert telemetry._posthog_client is not None
+
+    telemetry.capture(event)
+    telemetry.flush()
+    pdb.set_trace()
+
+
+if __name__ == '__main__':
+    test_cli_telemetry_event()

vibesurf-0.1.33/tests/test_tools.py

@@ -0,0 +1,244 @@
+import asyncio
+import pdb
+import sys
+import time
+import os
+from typing import Dict
+
+sys.path.append(".")
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+async def test_tools_with_mcp():
+    import os
+    from vibe_surf.tools.vibesurf_tools import VibeSurfTools
+
+    mcp_server_config = {
+        "mcpServers": {
+            # "markitdown": {
+            #     "command": "docker",
+            #     "args": [
+            #         "run",
+            #         "--rm",
+            #         "-i",
+            #         "markitdown-mcp:latest"
+            #     ]
+            # },
+            # "desktop-commander": {
+            #     "command": "npx",
+            #     "args": [
+            #         "-y",
+            #         "@wonderwhy-er/desktop-commander"
+            #     ],
+            # },
+            "filesystem": {
+                "command": "npx",
+                "args": [
+                    "-y",
+                    "@modelcontextprotocol/server-filesystem",
+                    "E:\\AIBrowser\\VibeSurf\\tmp\\code",
+                ]
+            },
+        }
+    }
+
+    controller = VibeSurfTools(mcp_server_config=mcp_server_config)
+    await controller.register_mcp_clients()
+    pdb.set_trace()
+    # action_name = "mcp.desktop-commander.start_process"
+    action_name = "mcp.filesystem.list_directory"
+    action_info = controller.registry.registry.actions[action_name]
+    param_model = action_info.param_model
+    print(param_model.model_json_schema())
+    # params = {
+    #     "command": f"python ./tmp/code/test.py",
+    #     "timeout_ms": 30000
+    # }
+    params = {
+        "path": r"E:\AIBrowser\VibeSurf\tmp\code",
+    }
+    validated_params = param_model(**params)
+    ActionModel_ = controller.registry.create_action_model()
+    # Create ActionModel instance with the validated parameters
+    action_model = ActionModel_(**{action_name: validated_params})
+    result = await controller.act(action_model)
+    result = result.extracted_content
+
+    # print(result)
+    # if result and "Command is still running. Use read_output to get more output." in result and "PID" in \
+    #         result.split("\n")[0]:
+    #     pid = int(result.split("\n")[0].split("PID")[-1].strip())
+    #     pdb.set_trace()
+    #     action_name = "mcp.desktop-commander.read_process_output"
+    #     action_info = tools.registry.registry.actions[action_name]
+    #     param_model = action_info.param_model
+    #     print(param_model.model_json_schema())
+    #     params = {"pid": pid}
+    #     validated_params = param_model(**params)
+    #     action_model = ActionModel_(**{action_name: validated_params})
+    #     output_result = ""
+    #     while True:
+    #         time.sleep(1)
+    #         result = await tools.act(action_model)
+    #         result = result.extracted_content
+    #         if result:
+    #             output_result = result
+    #             break
+    #     print(output_result)
+    await controller.unregister_mcp_clients()
+
+
+async def test_filesystem():
+    from vibe_surf.tools.file_system import CustomFileSystem
+
+    file_system_path = r"E:\AIBrowser\VibeSurf\tmp\vibesurf_workspace"
+    filesystem = CustomFileSystem(file_system_path)
+    result = await filesystem.create_file("reports/final_report.html")
+    print(result)
+    result = filesystem.get_absolute_path("reports/final_report.html")
+    print(result)
+
+
+async def test_bu_tools():
+    import os
+    from vibe_surf.tools.browser_use_tools import BrowserUseTools
+
+    tools = BrowserUseTools()
+    print(tools.registry.registry.actions.keys())
+
+
+async def test_vibesurf_tools():
+    import os
+    from vibe_surf.tools.vibesurf_tools import VibeSurfTools
+
+    tools = VibeSurfTools()
+    print(tools.registry.registry.actions.keys())
+
+
+async def test_finance_tools():
+    from vibe_surf.tools.finance_tools import FinanceDataRetriever
+
+    retriever = FinanceDataRetriever('TSLA')
+
+    result = retriever.get_finance_data(["get_news"])
+
+    pdb.set_trace()
+
+
+async def test_composio_integrations():
+    from composio import Composio
+    from langchain_core.tools import Tool
+    from composio_langchain import LangchainProvider
+
+    composio = Composio(
+        api_key=os.getenv("COMPOSIO_API_KEY"),
+        provider=LangchainProvider()
+    )
+
+    schema = composio.toolkits.get()
+    composio_toolkits = []
+    for schema_ in schema:
+        if 'OAUTH2' in schema_.auth_schemes:
+            composio_toolkits.append({
+                'name': schema_.name,
+                'slug': schema_.slug,
+                'description': schema_.meta.description,
+                'logo': schema_.meta.logo,
+                'app_url': schema_.meta.app_url,
+            })
+
+    def configure_tools(entity_id: str, app_name: str, limit: int | None = None) -> Dict:
+        if limit is None:
+            limit = 999
+
+        tools = composio.tools.get(user_id=entity_id, toolkits=[app_name.lower()], limit=limit)
+        configured_tools = []
+        tools_list = []
+        for tool in tools:
+            tools_list.append({
+                'name': tool.name,
+                'description': getattr(tool, 'description', ''),
+                'parameters': tool.args_schema.model_json_schema() if hasattr(tool, 'args_schema') else {},
+                'enabled': True,  # Default enabled
+                'func': tool.func,
+            })
+        return tools_list
+
+    def _find_active_connection_for_app(entity_id: str, app_name: str) -> tuple[str, str] | None:
+        """Find any ACTIVE connection for this app/user. Returns (connection_id, status) or None."""
+        try:
+            connection_list = composio.connected_accounts.list(
+                user_ids=[entity_id], toolkit_slugs=[app_name.lower()]
+            )
+
+            if connection_list and hasattr(connection_list, "items") and connection_list.items:
+                for connection in connection_list.items:
+                    connection_id = getattr(connection, "id", None)
+                    connection_status = getattr(connection, "status", None)
+                    if connection_status == "ACTIVE" and connection_id:
+                        return connection_id, connection_status
+
+        except (ValueError, ConnectionError) as e:
+            return None
+        else:
+            return None
+
+    app_name = "gmail"
+    entity_id = "default"
+    connected_ret = _find_active_connection_for_app(entity_id=entity_id, app_name=app_name)
+    if connected_ret and connected_ret[1] == "ACTIVE":
+        tools_list = configure_tools(entity_id=entity_id, app_name=app_name)
+        toolkit_tools_dict = {}
+        toolkit_tools_dict[app_name] = tools_list
+        from vibe_surf.tools.composio_client import ComposioClient
+        from vibe_surf.tools.vibesurf_tools import VibeSurfTools
+
+        tools = VibeSurfTools()
+
+        # Connect to Composio
+        composio_client = ComposioClient(
+            composio_instance=composio
+        )
+
+        # Register all Composio tools as VibeSurf actions
+        await composio_client.register_to_tools(tools, toolkit_tools_dict)
+        for tool_ in tools_list:
+            if tool_["name"] == "GMAIL_FETCH_EMAILS":
+                break
+        result = tool_['func'](include_payload=False)
+        pdb.set_trace()
+        # result = composio.tools.execute(
+        #     slug="GMAIL_FETCH_EMAILS",
+        #     arguments={},
+        #     user_id=entity_id,
+        # )
+    else:
+        auth_configs = composio.auth_configs.list(toolkit_slug=app_name)
+
+        if len(auth_configs.items) == 0:
+            auth_config_id = composio.auth_configs.create(toolkit=app_name,
+                                                          options={"type": "use_composio_managed_auth"})
+            auth_config_id = auth_config_id
+        else:
+            auth_config_id = None
+            for auth_config in auth_configs.items:
+                if auth_config.auth_scheme == "OAUTH2":
+                    auth_config_id = auth_config.id
+                    break
+        connection_request = composio.connected_accounts.initiate(
+            user_id=entity_id, auth_config_id=auth_config_id, allow_multiple=True
+        )
+        connected_account = connection_request.wait_for_connection()
+        print(connection_request.redirect_url)
+        connected_ret = _find_active_connection_for_app(entity_id=entity_id, app_name=app_name)
+
+if __name__ == '__main__':
+    # asyncio.run(test_tools_with_mcp())
+    # asyncio.run(test_filesystem())
+    # asyncio.run(test_bu_tools())
+    # asyncio.run(test_vibesurf_tools())
+    # asyncio.run(test_finance_tools())
+    asyncio.run(test_composio_integrations())

{vibesurf-0.1.31 → vibesurf-0.1.33}/vibe_surf/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.31'
-__version_tuple__ = version_tuple = (0, 1, 31)
+__version__ = version = '0.1.33'
+__version_tuple__ = version_tuple = (0, 1, 33)
 
-__commit_id__ = commit_id = 'gf2d6ab8af'
+__commit_id__ = commit_id = 'g31e3b1a9f'

{vibesurf-0.1.31 → vibesurf-0.1.33}/vibe_surf/agents/browser_use_agent.py

@@ -64,7 +64,6 @@ from browser_use.dom.views import DOMInteractedElement
 from browser_use.filesystem.file_system import FileSystem
 from browser_use.observability import observe, observe_debug
 from browser_use.sync import CloudSync
-from browser_use.telemetry.service import ProductTelemetry
 from browser_use.telemetry.views import AgentTelemetryEvent
 from browser_use.utils import (
     _log_pretty_path,
@@ -76,6 +75,7 @@ from browser_use.utils import (
 
 from browser_use.agent.service import Agent, AgentHookFunc
 from vibe_surf.tools.file_system import CustomFileSystem
+from vibe_surf.telemetry.service import ProductTelemetry
 
 Context = TypeVar('Context')
 

{vibesurf-0.1.31 → vibesurf-0.1.33}/vibe_surf/agents/prompts/vibe_surf_prompt.py

@@ -65,6 +65,12 @@ You will receive contextual information including:
 - Include file references in task descriptions when relevant
 - All file operations automatically resolve relative to the workspace directory
 
+## Composio Tools Usage Guidelines
+
+When using Composio tools (those with `cpo.{toolkit_name}.{tool_name}` prefix):
+- **Prioritize Composio Tools**: When available, prefer Composio toolkit tools over browser automation for API-based tasks (e.g., Gmail, GitHub, Slack operations) as they provide much higher efficiency through direct API calls
+- **Parameter Optimization**: Always optimize default parameters to prevent information overload. Use appropriate filters and limits to get only essential information.  Such as: Set `include_payload=False` when possible to avoid unnecessary response data.
+
 ## Skills Command Processing
 - When users input commands in `/skill_name` format, please use the corresponding skill action:
 - **Tab Targeting[Optional]**: Such as `/crawl @1234` → Execute `skill_crawl` with tab_id "1234"

{vibesurf-0.1.31 → vibesurf-0.1.33}/vibe_surf/agents/report_writer_agent.py

@@ -16,6 +16,8 @@ from vibe_surf.agents.prompts.report_writer_prompt import REPORT_WRITER_PROMPT
 from vibe_surf.tools.file_system import CustomFileSystem
 from vibe_surf.tools.report_writer_tools import ReportWriterTools
 from vibe_surf.agents.views import CustomAgentOutput
+from vibe_surf.telemetry.service import ProductTelemetry
+from vibe_surf.telemetry.views import ReportWriterTelemetryEvent
 
 from vibe_surf.logger import get_logger
 
@@ -66,6 +68,9 @@ class ReportWriterAgent:
         
         # Initialize message history as instance variable
         self.message_history = []
+        
+        # Initialize telemetry
+        self.telemetry = ProductTelemetry()
 
         logger.info("📄 ReportWriterAgent initialized with LLM-controlled flow")
 
@@ -111,6 +116,18 @@ class ReportWriterAgent:
             ReportTaskResult: Result containing success status, message, and report path
         """
         logger.info("📝 Starting LLM-controlled report generation...")
+        
+        # Capture telemetry start event
+        start_time = time.time()
+        import vibe_surf
+        start_event = ReportWriterTelemetryEvent(
+            version=vibe_surf.__version__,
+            action='start',
+            model=getattr(self.llm, 'model_name', None),
+            model_provider=getattr(self.llm, 'provider', None),
+            report_type='html'
+        )
+        self.telemetry.capture(start_event)
 
         # Get current event loop
         loop = asyncio.get_event_loop()
@@ -260,6 +277,22 @@ Please analyze the task, determine if you need to read any additional files, the
             elif task_completed:
                 # Task completed successfully by LLM
                 logger.info(f"✅ Report generated successfully: {report_path}")
+                
+                # Capture telemetry completion event
+                end_time = time.time()
+                duration = end_time - start_time
+                completion_event = ReportWriterTelemetryEvent(
+                    version=vibe_surf.__version__,
+                    action='report_completed',
+                    model=getattr(self.llm, 'model_name', None),
+                    model_provider=getattr(self.llm, 'provider', None),
+                    duration_seconds=duration,
+                    success=True,
+                    report_type='html'
+                )
+                self.telemetry.capture(completion_event)
+                self.telemetry.flush()
+                
                 return ReportTaskResult(
                     success=True,
                     msg="Report generated successfully by LLM",
@@ -283,6 +316,23 @@ Please analyze the task, determine if you need to read any additional files, the
 
         except Exception as e:
             logger.error(f"❌ Failed to generate report: {e}")
+            
+            # Capture telemetry error event
+            end_time = time.time()
+            duration = end_time - start_time
+            error_event = ReportWriterTelemetryEvent(
+                version=vibe_surf.__version__,
+                action='error',
+                model=getattr(self.llm, 'model_name', None),
+                model_provider=getattr(self.llm, 'provider', None),
+                duration_seconds=duration,
+                success=False,
+                error_message=str(e)[:200],  # Limit error message length
+                report_type='html'
+            )
+            self.telemetry.capture(error_event)
+            self.telemetry.flush()
+            
             # Generate a simple fallback report
             fallback_path = await self._generate_fallback_report(report_data)
             return ReportTaskResult(

{vibesurf-0.1.31 → vibesurf-0.1.33}/vibe_surf/agents/vibe_surf_agent.py

@@ -40,6 +40,9 @@ from vibe_surf.tools.vibesurf_tools import VibeSurfTools
 from vibe_surf.tools.file_system import CustomFileSystem
 from vibe_surf.agents.views import VibeSurfAgentSettings
 
+from vibe_surf.telemetry.service import ProductTelemetry
+from vibe_surf.telemetry.views import VibeSurfAgentTelemetryEvent
+
 from vibe_surf.logger import get_logger
 
 logger = get_logger(__name__)
@@ -479,7 +482,7 @@ async def _vibesurf_agent_node_impl(state: VibeSurfState) -> VibeSurfState:
                     llm=vibesurf_agent.llm,
                     file_system=vibesurf_agent.file_system,
                 )
-                if action_name.startswith("skill_"):
+                if action_name in ['skill_search', 'skill_crawl', 'skill_summary', 'skill_deep_research']:
                     state.current_step = "END"
                     # Format final response
                     final_response = f"{result.extracted_content}" or f"{result.error}"
@@ -1041,6 +1044,9 @@ class VibeSurfAgent:
         self._execution_task: Optional[asyncio.Task] = None
 
         logger.info("🌊 VibeSurf Agent initialized with LangGraph workflow")
+        
+        # Initialize telemetry
+        self.telemetry = ProductTelemetry()
 
     def load_message_history(self, session_id: Optional[str] = None) -> list:
         """Load message history for a specific session, or return [] for new sessions"""
@@ -1568,6 +1574,20 @@ Please continue with your assigned work, incorporating this guidance only if it'
             str: Markdown summary of execution results
         """
         logger.info(f"🚀 Starting VibeSurfAgent execution for task: {task}. Powered by LLM model: {self.llm.model_name}")
+        
+        # Capture telemetry start event
+        start_time = time.time()
+        import vibe_surf
+        start_event = VibeSurfAgentTelemetryEvent(
+            version=vibe_surf.__version__,
+            action='start',
+            task_description=task if task else None,  # Limit task description length
+            model=getattr(self.llm, 'model_name', None),
+            model_provider=getattr(self.llm, 'provider', None),
+            session_id=session_id
+        )
+        self.telemetry.capture(start_event)
+        
         try:
             self.settings.agent_mode = agent_mode
             session_id = session_id or self.cur_session_id or uuid7str()
@@ -1642,6 +1662,23 @@ Please continue with your assigned work, incorporating this guidance only if it'
             # Get final result
             result = await self._get_result(final_state)
             logger.info("✅ VibeSurfAgent execution completed")
+            
+            # Capture telemetry completion event
+            end_time = time.time()
+            duration = end_time - start_time
+            completion_event = VibeSurfAgentTelemetryEvent(
+                version=vibe_surf.__version__,
+                action='task_completed',
+                task_description=task[:200] if task else None,
+                model=getattr(self.llm, 'model_name', None),
+                model_provider=getattr(self.llm, 'provider', None),
+                duration_seconds=duration,
+                success=True,
+                session_id=session_id
+            )
+            self.telemetry.capture(completion_event)
+            self.telemetry.flush()
+            
             return result
 
         except asyncio.CancelledError:
@@ -1659,6 +1696,24 @@ Please continue with your assigned work, incorporating this guidance only if it'
             import traceback
             traceback.print_exc()
             logger.error(f"❌ VibeSurfAgent execution failed: {e}")
+            
+            # Capture telemetry error event
+            end_time = time.time()
+            duration = end_time - start_time
+            error_event = VibeSurfAgentTelemetryEvent(
+                version=vibe_surf.__version__,
+                action='error',
+                task_description=BrowserTaskResult if task else None,
+                model=getattr(self.llm, 'model_name', None),
+                model_provider=getattr(self.llm, 'provider', None),
+                duration_seconds=duration,
+                success=False,
+                error_message=str(e),  # Limit error message length
+                session_id=session_id
+            )
+            self.telemetry.capture(error_event)
+            self.telemetry.flush()
+            
             # Add error activity log
             if self.activity_logs:
                 activity_entry = {