foxcode-channel 0.2.0 → 0.3.0

package/lib.mjs

@@ -70,6 +70,21 @@ export function buildToolResultMessage(tool, content) {
   return { type: 'tool_result', id, tool, content, ts: Date.now() }
 }
 
+/**
+ * Assert that the MCP client (Claude Code) advertises claude/channel support.
+ * Throws if the capability is missing — meaning Claude was launched without
+ * --dangerously-load-development-channels server:<name>.
+ * @param {object|undefined} clientCapabilities - from mcp.getClientCapabilities()
+ */
+export function assertChannelCapability(clientCapabilities, serverName = 'foxcode') {
+  if (!clientCapabilities?.experimental?.['claude/channel']) {
+    throw new Error(
+      'Client does not support claude/channel. ' +
+      `Start Claude Code with: claude --dangerously-load-development-channels server:${serverName}`
+    )
+  }
+}
+
 /**
  * MCP tool definitions exposed by the channel plugin.
  */
@@ -107,7 +122,7 @@ export const TOOL_DEFINITIONS = [
       'Subsequent operations target this managed tab. closeTab() without args closes it;',
       'next navigate() creates a fresh tab.',
       '',
-      'Usage: write JS code using `api` object. Destructure or access directly.',
+      'Usage: write JS code using `api` object. All functions are methods of `api` — call as `api.method()` or destructure first: `const {method} = api`.',
       'All selector-based helpers auto-wait for element (poll 100ms, default timeout 2000ms).',
       'Override: pass {timeout: 5000} as last arg.',
       '',
@@ -135,11 +150,10 @@ export const TOOL_DEFINITIONS = [
       'opts = {timeout: ms} — override auto-wait timeout per call',
       '',
       'Example:',
-      'const {navigate, fill, click, snapshot} = api;',
-      'await navigate("https://example.com/login");',
-      'await fill("#email", "user@test.com");',
-      'await click("button[type=submit]");',
-      'return await snapshot();',
+      'await api.navigate("https://example.com/login");',
+      'await api.fill("#email", "user@test.com");',
+      'await api.click("button[type=submit]");',
+      'return await api.snapshot();',
     ].join('\n'),
     inputSchema: {
       type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foxcode-channel",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP channel plugin bridging Claude Code and FoxCode Firefox extension via WebSocket",
   "type": "module",
   "main": "server.mjs",

package/server.mjs

@@ -19,6 +19,7 @@ import { WebSocketServer } from 'ws'
 import {
   nextId, buildChannelMeta, buildReplyMessage, buildEditMessage,
   buildToolUseMessage, buildToolResultMessage, TOOL_DEFINITIONS,
+  assertChannelCapability,
 } from './lib.mjs'
 import { validateCode } from './validator.mjs'
 
@@ -166,5 +167,14 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
 
 // --- Start ---
 
+mcp.oninitialized = () => {
+  try {
+    assertChannelCapability(mcp.getClientCapabilities())
+  } catch (err) {
+    process.stderr.write(`foxcode: FATAL: ${err.message}\n`)
+    process.exit(1)
+  }
+}
+
 await mcp.connect(new StdioServerTransport())
 process.stderr.write(`foxcode: ws://localhost:${PORT}\n`)