@abraca/mcp 2.6.0 → 2.8.0

package/src/index.ts

@@ -24,84 +24,94 @@
  *                                 schema before forwarding to the server.
  *                                 When unset, behaviour is unchanged.
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import { AbracadabraMCPServer, type TriggerMode } from './server.ts'
-import { registerTreeTools } from './tools/tree.ts'
-import { registerContentTools } from './tools/content.ts'
-import { registerMetaTools } from './tools/meta.ts'
-import { registerFileTools } from './tools/files.ts'
-import { registerAwarenessTools } from './tools/awareness.ts'
-import { registerChannelTools } from './tools/channel.ts'
-import { registerSvgTools } from './tools/svg.ts'
-import { registerAgentGuide } from './resources/agent-guide.ts'
-import { registerTreeResource } from './resources/tree-resource.ts'
-import { registerServerInfoResource } from './resources/server-info.ts'
-import { registerHookTools } from './tools/hooks.ts'
-import { HookBridge } from './hook-bridge.ts'
-import { loadSchemaBundle, SchemaBundleLoadError } from './schema/loader.ts'
-import type { SchemaBundleValidator } from './schema/validator.ts'
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { HookBridge } from "./hook-bridge.ts";
+import { registerAgentGuide } from "./resources/agent-guide.ts";
+import { registerServerInfoResource } from "./resources/server-info.ts";
+import { registerTreeResource } from "./resources/tree-resource.ts";
+import { loadSchemaBundle, SchemaBundleLoadError } from "./schema/loader.ts";
+import type { SchemaBundleValidator } from "./schema/validator.ts";
+import { AbracadabraMCPServer, type TriggerMode } from "./server.ts";
+import { registerAwarenessTools } from "./tools/awareness.ts";
+import { registerChannelTools } from "./tools/channel.ts";
+import { registerContentTools } from "./tools/content.ts";
+import { registerFileTools } from "./tools/files.ts";
+import { registerHookTools } from "./tools/hooks.ts";
+import { registerMetaTools } from "./tools/meta.ts";
+import { registerSvgTools } from "./tools/svg.ts";
+import { registerTreeTools } from "./tools/tree.ts";
 
 async function main() {
-  const url = process.env.ABRA_URL
-
-  if (!url) {
-    console.error('Missing required environment variable: ABRA_URL')
-    process.exit(1)
-  }
-
-  // Parse trigger mode (defaults to mention+task)
-  const rawMode = (process.env.ABRA_AGENT_TRIGGER_MODE ?? 'mention+task').trim().toLowerCase()
-  const validModes: TriggerMode[] = ['all', 'mention', 'task', 'mention+task']
-  const triggerMode = (validModes as string[]).includes(rawMode)
-    ? (rawMode as TriggerMode)
-    : 'mention+task'
-  if (rawMode && !(validModes as string[]).includes(rawMode)) {
-    console.error(`[abracadabra-mcp] Invalid ABRA_AGENT_TRIGGER_MODE="${rawMode}", falling back to "mention+task"`)
-  }
-
-  const aliasEnv = process.env.ABRA_AGENT_MENTION_ALIASES
-  const mentionAliases: string[] | undefined = aliasEnv
-    ? aliasEnv.split(',').map((a: string) => a.trim()).filter((a: string) => a.length > 0)
-    : undefined
-
-  // Create the Abracadabra connection manager
-  const server = new AbracadabraMCPServer({
-    url,
-    agentName: process.env.ABRA_AGENT_NAME,
-    agentColor: process.env.ABRA_AGENT_COLOR,
-    inviteCode: process.env.ABRA_INVITE_CODE,
-    keyFile: process.env.ABRA_KEY_FILE,
-    triggerMode,
-    mentionAliases,
-  })
-
-  console.error(`[abracadabra-mcp] Trigger mode: ${triggerMode}; aliases: ${server.mentionAliases.join(', ')}`)
-
-  // Optional schema bundle. When set, update_metadata + create_document validate
-  // `meta` against the resolved doc-type's schema before forwarding. When unset,
-  // behaviour is identical to today (Rules 2 + 4 in feedback_schema_free_core.md).
-  let schemaValidator: SchemaBundleValidator | null = null
-  const schemaBundlePath = process.env.ABRA_MCP_SCHEMA_BUNDLE
-  if (schemaBundlePath && schemaBundlePath.trim().length > 0) {
-    try {
-      schemaValidator = loadSchemaBundle(schemaBundlePath)
-      console.error(
-        `[abracadabra-mcp] Loaded schema bundle from ${schemaBundlePath}; known doc-types: ${schemaValidator.knownTypes.join(', ')}`,
-      )
-    } catch (err) {
-      const msg = err instanceof SchemaBundleLoadError ? err.message : String(err)
-      console.error(`[abracadabra-mcp] ${msg}`)
-      process.exit(1)
-    }
-  }
-
-  // Create MCP server with channel capability
-  const mcp = new McpServer(
-    { name: 'abracadabra', version: '1.0.0' },
-    {
-      capabilities: { experimental: { 'claude/channel': {} } },
-      instructions: `Abracadabra is a CRDT collaboration platform where everything is a document in a tree.
+	const url = process.env.ABRA_URL;
+
+	if (!url) {
+		console.error("Missing required environment variable: ABRA_URL");
+		process.exit(1);
+	}
+
+	// Parse trigger mode (defaults to mention+task)
+	const rawMode = (process.env.ABRA_AGENT_TRIGGER_MODE ?? "mention+task")
+		.trim()
+		.toLowerCase();
+	const validModes: TriggerMode[] = ["all", "mention", "task", "mention+task"];
+	const triggerMode = (validModes as string[]).includes(rawMode)
+		? (rawMode as TriggerMode)
+		: "mention+task";
+	if (rawMode && !(validModes as string[]).includes(rawMode)) {
+		console.error(
+			`[abracadabra-mcp] Invalid ABRA_AGENT_TRIGGER_MODE="${rawMode}", falling back to "mention+task"`,
+		);
+	}
+
+	const aliasEnv = process.env.ABRA_AGENT_MENTION_ALIASES;
+	const mentionAliases: string[] | undefined = aliasEnv
+		? aliasEnv
+				.split(",")
+				.map((a: string) => a.trim())
+				.filter((a: string) => a.length > 0)
+		: undefined;
+
+	// Create the Abracadabra connection manager
+	const server = new AbracadabraMCPServer({
+		url,
+		agentName: process.env.ABRA_AGENT_NAME,
+		agentColor: process.env.ABRA_AGENT_COLOR,
+		inviteCode: process.env.ABRA_INVITE_CODE,
+		keyFile: process.env.ABRA_KEY_FILE,
+		triggerMode,
+		mentionAliases,
+	});
+
+	console.error(
+		`[abracadabra-mcp] Trigger mode: ${triggerMode}; aliases: ${server.mentionAliases.join(", ")}`,
+	);
+
+	// Optional schema bundle. When set, update_metadata + create_document validate
+	// `meta` against the resolved doc-type's schema before forwarding. When unset,
+	// behaviour is identical to today (Rules 2 + 4 in feedback_schema_free_core.md).
+	let schemaValidator: SchemaBundleValidator | null = null;
+	const schemaBundlePath = process.env.ABRA_MCP_SCHEMA_BUNDLE;
+	if (schemaBundlePath && schemaBundlePath.trim().length > 0) {
+		try {
+			schemaValidator = loadSchemaBundle(schemaBundlePath);
+			console.error(
+				`[abracadabra-mcp] Loaded schema bundle from ${schemaBundlePath}; known doc-types: ${schemaValidator.knownTypes.join(", ")}`,
+			);
+		} catch (err) {
+			const msg =
+				err instanceof SchemaBundleLoadError ? err.message : String(err);
+			console.error(`[abracadabra-mcp] ${msg}`);
+			process.exit(1);
+		}
+	}
+
+	// Create MCP server with channel capability
+	const mcp = new McpServer(
+		{ name: "abracadabra", version: "1.0.0" },
+		{
+			capabilities: { experimental: { "claude/channel": {} } },
+			instructions: `Abracadabra is a CRDT collaboration platform where everything is a document in a tree.
 
 ## CRITICAL: Responding to Channel Events
 The user CANNOT see your plain text output — they only see messages sent via MCP tools. When you receive a channel event:
@@ -136,68 +146,72 @@ The user CANNOT see your plain text output — they only see messages sent via M
 
 ## Full Reference
 Read the resource at abracadabra://agent-guide for the complete guide covering page type schemas, metadata reference, awareness/presence, content structure, and detailed examples.`,
-    },
-  )
-
-  // Register tools
-  registerTreeTools(mcp, server, schemaValidator)
-  registerContentTools(mcp, server)
-  registerMetaTools(mcp, server, schemaValidator)
-  registerFileTools(mcp, server)
-  registerAwarenessTools(mcp, server)
-  registerChannelTools(mcp, server)
-  registerSvgTools(mcp, server)
-
-  // Register resources
-  registerAgentGuide(mcp)
-  registerTreeResource(mcp, server)
-  registerServerInfoResource(mcp, server)
-
-  // Connect to Abracadabra server
-  try {
-    await server.connect()
-  } catch (error: any) {
-    console.error(`[abracadabra-mcp] Failed to connect: ${error.message}`)
-    process.exit(1)
-  }
-
-  // Start Claude Code hook bridge (HTTP server for activity events)
-  const hookBridge = new HookBridge(server)
-  try {
-    const hookPort = await hookBridge.start()
-    console.error(`[abracadabra-mcp] Hook bridge listening on port ${hookPort}`)
-  } catch (error: any) {
-    console.error(`[abracadabra-mcp] Hook bridge failed to start: ${error.message}`)
-  }
-
-  // Register hook config tool (must be after bridge starts so port is available)
-  registerHookTools(mcp, hookBridge)
-
-  // Start MCP stdio transport
-  const transport = new StdioServerTransport()
-  await mcp.connect(transport)
-
-  // Wire up real-time channel notifications (awareness → channel dispatch)
-  server.startChannelNotifications(mcp)
-  console.error('[abracadabra-mcp] MCP server running on stdio')
-
-  // Graceful shutdown
-  const shutdown = async () => {
-    console.error('[abracadabra-mcp] Shutting down...')
-    await hookBridge.destroy()
-    await server.destroy()
-    process.exit(0)
-  }
-
-  process.on('SIGINT', shutdown)
-  process.on('SIGTERM', shutdown)
+		},
+	);
+
+	// Register tools
+	registerTreeTools(mcp, server, schemaValidator);
+	registerContentTools(mcp, server);
+	registerMetaTools(mcp, server, schemaValidator);
+	registerFileTools(mcp, server);
+	registerAwarenessTools(mcp, server);
+	registerChannelTools(mcp, server);
+	registerSvgTools(mcp, server);
+
+	// Register resources
+	registerAgentGuide(mcp);
+	registerTreeResource(mcp, server);
+	registerServerInfoResource(mcp, server);
+
+	// Connect to Abracadabra server
+	try {
+		await server.connect();
+	} catch (error: any) {
+		console.error(`[abracadabra-mcp] Failed to connect: ${error.message}`);
+		process.exit(1);
+	}
+
+	// Start Claude Code hook bridge (HTTP server for activity events)
+	const hookBridge = new HookBridge(server);
+	try {
+		const hookPort = await hookBridge.start();
+		console.error(
+			`[abracadabra-mcp] Hook bridge listening on port ${hookPort}`,
+		);
+	} catch (error: any) {
+		console.error(
+			`[abracadabra-mcp] Hook bridge failed to start: ${error.message}`,
+		);
+	}
+
+	// Register hook config tool (must be after bridge starts so port is available)
+	registerHookTools(mcp, hookBridge);
+
+	// Start MCP stdio transport
+	const transport = new StdioServerTransport();
+	await mcp.connect(transport);
+
+	// Wire up real-time channel notifications (awareness → channel dispatch)
+	server.startChannelNotifications(mcp);
+	console.error("[abracadabra-mcp] MCP server running on stdio");
+
+	// Graceful shutdown
+	const shutdown = async () => {
+		console.error("[abracadabra-mcp] Shutting down...");
+		await hookBridge.destroy();
+		await server.destroy();
+		process.exit(0);
+	};
+
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
 }
 
 main().catch((error) => {
-  console.error('[abracadabra-mcp] Fatal error:', error)
-  process.exit(1)
-})
+	console.error("[abracadabra-mcp] Fatal error:", error);
+	process.exit(1);
+});
 
+export type { MCPServerConfig } from "./server.ts";
 // Re-export for library usage
-export { AbracadabraMCPServer } from './server.ts'
-export type { MCPServerConfig } from './server.ts'
+export { AbracadabraMCPServer } from "./server.ts";