@runsnative/mcp-server 0.2.0 → 0.3.0

package/dist/tools/get-marker-capture.js

@@ -4,13 +4,28 @@ const CROP_PREFIX = 'data:image/png;base64,';
 export const GET_MARKER_CAPTURE_TOOL = {
     name: 'get_marker_capture',
     description: 'Fetch pending marker captures from the linked runsnative.org tab — regions the user circled ' +
-        'with the marker overlay. Each capture carries the resolved component-instance address, its ' +
-        'render inputs, an optional user note, and the pixel crop as an image. Single delivery: a ' +
-        'capture is returned once. Requires an active linked session (link_session first).',
+        'with the marker overlay. Use when the user says they marked, circled, or pointed at something ' +
+        'on the site, or asks "can you see what I selected?". Each capture carries the resolved ' +
+        'component-instance address (usable with set_instance_variant), its render inputs, an optional ' +
+        'user note, and the pixel crop as an image so you see exactly what they saw. Single delivery: a ' +
+        'capture is returned once. Requires an active linked session (call link_session first).',
     inputSchema: {
         type: 'object',
         properties: {},
     },
+    // LSP §5.1 (linked-session-protocol-v0.1, mukadra repo) — session-targeting,
+    // but the READ leg of the bridge: it drains the session's capture queue
+    // rather than enacting a command, so there is no allow-list `enactment`
+    // (the field is optional per §5.1).
+    _meta: {
+        lsp: {
+            target: 'session',
+            tier: 'reversible',
+            consent: 'implicit',
+            entitlement: 'free',
+            visibility: 'advertised',
+        },
+    },
 };
 export async function handleGetMarkerCapture(_args) {
     const pairId = getLinkedPairId();

package/dist/tools/navigate.js

@@ -2,8 +2,11 @@ import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 import { postWorkerApi, getLinkedPairId } from '../bridge-client.js';
 export const NAVIGATE_TOOL = {
     name: 'navigate',
-    description: 'Navigate the linked runsnative.org tab to a path. Slash shim: /rn-go <path>. ' +
-        'Reversible — the user can navigate back. Requires an active linked session (link_session first).',
+    description: "Send the user's linked runsnative.org tab to a different page. Use when the user asks to see, open, or go to " +
+        'something on the site — a component page, a docs section, the gallery — so they watch their own tab move ' +
+        'instead of following a pasted link. The command is enqueued and the tab navigates within one poll interval. ' +
+        'Reversible — the user can navigate back. Requires an active linked session (call link_session first). ' +
+        'Slash shim: /rn-go <path>.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -11,6 +14,19 @@ export const NAVIGATE_TOOL = {
         },
         required: ['path'],
     },
+    // LSP §5.1 (linked-session-protocol-v0.1, mukadra repo) — marks this as a
+    // session-targeting capability. `enactment` names the worker allow-list
+    // entry this tool submits (JUNE-626).
+    _meta: {
+        lsp: {
+            target: 'session',
+            tier: 'reversible',
+            consent: 'implicit',
+            entitlement: 'free',
+            visibility: 'advertised',
+            enactment: 'navigation.navigate',
+        },
+    },
 };
 export async function handleNavigate(args) {
     const path = args['path'];

package/dist/tools/set-instance-variant.js

@@ -4,9 +4,11 @@ import { postWorkerApi, getLinkedPairId } from '../bridge-client.js';
 const RUN_BUTTON_VARIANTS = ['primary', 'secondary', 'outline', 'ghost', 'danger', 'link'];
 export const SET_INSTANCE_VARIANT_TOOL = {
     name: 'set_instance_variant',
-    description: 'Change the variant of a specific run-button instance on the linked runsnative.org tab, ' +
-        'targeted by the instance_id captured via the marker overlay. Slash shim: /rn-set-variant. ' +
-        'Reversible — the user can switch back at any time. Requires an active linked session (link_session first).',
+    description: 'Restyle ONE specific run-button on the linked runsnative.org tab — the instance the user circled with the ' +
+        'marker overlay — leaving every other element untouched. Use after get_marker_capture hands you an ' +
+        'address.instanceId and the user wants that exact button tried in a different variant. The command is enqueued ' +
+        'and the tab applies it within one poll interval, if the instance is still on the page. Reversible — set it ' +
+        'back at any time. Requires an active linked session (call link_session first). Slash shim: /rn-set-variant.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -21,6 +23,19 @@ export const SET_INSTANCE_VARIANT_TOOL = {
         },
         required: ['instance_id', 'variant'],
     },
+    // LSP §5.1 (linked-session-protocol-v0.1, mukadra repo) — marks this as a
+    // session-targeting capability. `enactment` names the worker allow-list
+    // entry this tool submits (JUNE-626).
+    _meta: {
+        lsp: {
+            target: 'session',
+            tier: 'reversible',
+            consent: 'implicit',
+            entitlement: 'free',
+            visibility: 'advertised',
+            enactment: 'instance.setVariant',
+        },
+    },
 };
 export async function handleSetInstanceVariant(args) {
     const instanceId = args['instance_id'];

package/dist/tools/set-theme.js

@@ -2,8 +2,11 @@ import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 import { postWorkerApi, getLinkedPairId } from '../bridge-client.js';
 export const SET_THEME_TOOL = {
     name: 'set_theme',
-    description: 'Apply a theme (color palette) to the linked runsnative.org tab. Slash shim: /rn-theme <theme>. ' +
-        'Reversible — the user can switch back at any time. Requires an active linked session (link_session first).',
+    description: "Restyle the user's linked runsnative.org tab with a named theme — colors, surfaces, and typography change live " +
+        'in their browser. Use when the user asks to change how the site looks, try a different brand feel, or compare ' +
+        'palettes. The command is enqueued and the tab applies it within one poll interval; nothing is saved — fully ' +
+        'reversible, switch again or back at any time. Requires an active linked session (call link_session first). ' +
+        'Slash shim: /rn-theme <theme>.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -11,6 +14,19 @@ export const SET_THEME_TOOL = {
         },
         required: ['theme'],
     },
+    // LSP §5.1 (linked-session-protocol-v0.1, mukadra repo) — marks this as a
+    // session-targeting capability. `enactment` names the worker allow-list
+    // entry this tool submits (JUNE-626).
+    _meta: {
+        lsp: {
+            target: 'session',
+            tier: 'reversible',
+            consent: 'implicit',
+            entitlement: 'free',
+            visibility: 'advertised',
+            enactment: 'theme.setTheme',
+        },
+    },
 };
 export async function handleSetTheme(args) {
     const theme = args['theme'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runsnative/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "files": [
     "dist/"