Enable input tracking toggle

docs/rest-api/input-tracking.mdx

@@ -0,0 +1,41 @@
+---
+title: "Input Tracking"
+openapi: "POST /input-tracking/start"
+description: "Start and stop input tracking on the Bytebot desktop"
+---
+
+The Bytebot daemon can monitor mouse and keyboard events through the
+`InputTracking` module. Tracking is disabled by default and can be toggled
+via the REST API. Tracked actions are streamed over WebSockets so that the
+agent can store them as messages.
+
+## Start Tracking
+
+`POST /input-tracking/start`
+
+Begins capturing input events. The endpoint returns a simple status object:
+
+```json
+{
+  "status": "started"
+}
+```
+
+## Stop Tracking
+
+`POST /input-tracking/stop`
+
+Stops capturing events and clears any internal buffers. The response is
+similar to the start endpoint:
+
+```json
+{
+  "status": "stopped"
+}
+```
+
+## WebSocket Stream
+
+When tracking is active, actions are emitted on the `input_action` channel of
+the WebSocket server running on the daemon. Clients can connect to the daemon
+and listen for these events to persist them as needed.

docs/rest-api/introduction.mdx

@@ -64,6 +64,9 @@ Common HTTP status codes:
     Execute desktop automation actions like mouse movements, clicks, keyboard
     input, and screenshots
   </Card>
+  <Card title="Input Tracking" icon="eye" href="/rest-api/input-tracking">
+    Control and stream keyboard and mouse events from the desktop
+  </Card>
   <Card title="Usage Examples" icon="code" href="/rest-api/examples">
     Code examples and snippets for common automation scenarios
   </Card>

packages/bytebot-agent/package.json

@@ -27,6 +27,7 @@
     "@nestjs/common": "^11.0.1",
     "@nestjs/config": "^4.0.2",
     "@nestjs/core": "^11.0.1",
+    "@nestjs/event-emitter": "^3.0.1",
     "@nestjs/platform-express": "^11.1.2",
     "@nestjs/platform-socket.io": "^11.1.1",
     "@nestjs/schedule": "^6.0.0",
@@ -35,7 +36,8 @@
     "class-validator": "^0.14.2",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.1",
-    "socket.io": "^4.8.1"
+    "socket.io": "^4.8.1",
+    "socket.io-client": "^4.8.1"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",

packages/bytebot-agent/src/agent/agent.module.ts

@@ -5,10 +5,11 @@ import { AnthropicModule } from '../anthropic/anthropic.module';
 import { AgentProcessor } from './agent.processor';
 import { ConfigModule } from '@nestjs/config';
 import { AgentScheduler } from './agent.scheduler';
+import { InputCaptureService } from './input-capture.service';
 
 @Module({
   imports: [ConfigModule, TasksModule, MessagesModule, AnthropicModule],
-  providers: [AgentProcessor, AgentScheduler],
+  providers: [AgentProcessor, AgentScheduler, InputCaptureService],
   exports: [AgentProcessor],
 })
 export class AgentModule {}