@fortemate/vega-vvd-driver 0.2.1 → 0.2.2

package/README.md

@@ -92,6 +92,8 @@ Then ask, for example: "Open Settings in the app on the Virtual Device, turn the
 
 A model chooses the arguments, so they are bounded: at most 100 key presses per call, recordings of up to 600 seconds, and `record_video` writes only a new `.mp4`, `.mov` or `.mkv` file, unless it is told to `overwrite` one. When the client cancels a call, its presses, wait or recording stop. `vvd mcp --pid <n>` ties the server to one device.
 
+Each tool declares MCP annotations, for a client that asks before a call that changes something. Four tools only read. `enable_grpc` only turns on the emulator's gRPC endpoint. `press_keys` and `record_video` are marked destructive: a key press can confirm a delete in the app on screen, and `overwrite` replaces a file. None reaches beyond the local device.
+
 ## As a library
 
 ```ts

package/dist/mcp.js

@@ -71,7 +71,7 @@ export const createServer = (options = {}) => {
     server.registerTool('list_devices', {
         title: 'List running Vega Virtual Devices',
         description: 'Lists the running Vega Virtual Devices whose gRPC endpoint is on. An empty list usually means gRPC is off: call enable_grpc.',
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, openWorldHint: false },
     }, async () => {
         const devices = findEmulators({ directories: options.directories }).map(({ pid, grpcPort, consolePort, avdName }) => ({
             pid,
@@ -101,6 +101,12 @@ export const createServer = (options = {}) => {
                 .optional()
                 .describe('The emulator console, an even port; default 5554'),
         },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
     }, async ({ grpc_port, console_port }) => {
         try {
             await enableGrpc(grpc_port ?? 8554, { port: console_port });
@@ -136,6 +142,14 @@ export const createServer = (options = {}) => {
                 .optional()
                 .describe('Return a screenshot once the keys are pressed'),
         },
+        // A key press can confirm anything the app on screen offers, a delete
+        // included.
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async ({ keys, gap_ms, screenshot_after }, { signal }) => {
         try {
             const steps = parseKeys(keys); // a typo fails before any device is touched
@@ -155,7 +169,7 @@ export const createServer = (options = {}) => {
     server.registerTool('screenshot', {
         title: 'Take a screenshot',
         description: 'Returns the current screen of the Vega Virtual Device as a PNG image (1920x1080).',
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, openWorldHint: false },
     }, async ({ signal }) => {
         try {
             return { content: [await screen(connected(), signal)] };
@@ -176,7 +190,7 @@ export const createServer = (options = {}) => {
                 .optional()
                 .describe('Default 5000'),
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, openWorldHint: false },
     }, async ({ timeout_ms }, { signal }) => {
         try {
             const d = connected();
@@ -211,6 +225,13 @@ export const createServer = (options = {}) => {
                 .optional()
                 .describe('Replace an existing file; default false'),
         },
+        // Destructive only with overwrite, which replaces an existing file.
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
     }, async ({ file, seconds, fps, audio, overwrite }, { signal }) => {
         try {
             const path = videoPath(file, overwrite);
@@ -243,7 +264,7 @@ export const createServer = (options = {}) => {
                 .optional()
                 .describe('Fraction of each edge, default 0.05'),
         },
-        annotations: { readOnlyHint: true },
+        annotations: { readOnlyHint: true, openWorldHint: false },
     }, async ({ background, margin }, { signal }) => {
         try {
             const frame = await connected().screenshot('rgb', { signal });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fortemate/vega-vvd-driver",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Unofficial driver for the Vega Virtual Device: remote keys, screenshots and video with sound, from scripts and AI agents. CLI, Node library and MCP server.",
   "keywords": [
     "vega",