@botmux-ai/plugin-demo-addon 0.1.0

package/README.md

@@ -0,0 +1,13 @@
+# Botmux Demo Addon
+
+Full-surface example plugin for the Botmux plugin system. It contributes CLI,
+Skill, MCP, Dashboard, and service integrations, and depends on `demo-base`.
+
+GitHub: https://github.com/botmux-ai/botmux-plugin-demo/tree/main/packages/demo-addon
+
+```bash
+botmux plugin install demo-base
+botmux plugin install demo-addon
+botmux plugin enable demo-base
+botmux plugin enable demo-addon
+```

package/dist/cli/commands.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "commands": [
+    {
+      "name": "addon:ping",
+      "description": "Return a structured response from the demo-addon CLI surface."
+    },
+    {
+      "name": "addon:resolve",
+      "description": "Resolve a path through the plugin API."
+    }
+  ]
+}

package/dist/cli/index.js

@@ -0,0 +1,13 @@
+export default {
+  'addon:ping'(ctx) {
+    return JSON.stringify({
+      pluginId: ctx.pluginId,
+      args: ctx.args,
+      settingsPath: ctx.api.settingsPath,
+    });
+  },
+
+  'addon:resolve'(ctx) {
+    return ctx.api.resolve('./dashboard/index.js');
+  },
+};

package/dist/dashboard/index.js

@@ -0,0 +1,3 @@
+export default function DemoAddonDashboard({ pluginId }) {
+  return `Demo dashboard loaded for ${pluginId}`;
+}

package/dist/mcp/index.json

@@ -0,0 +1,10 @@
+{
+  "transport": "stdio",
+  "command": [
+    "./mcp/server.js",
+    "--direct"
+  ],
+  "env": {
+    "DEMO_MCP_PLUGIN": "demo-addon"
+  }
+}

package/dist/mcp/server.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { createInterface } from 'node:readline';
+
+const serverName = process.env.DEMO_MCP_PLUGIN || 'demo-addon';
+const routeName = 'demo-addon';
+const input = createInterface({ input: process.stdin, crlfDelay: Infinity });
+
+function send(message) {
+  process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+
+input.on('line', (line) => {
+  if (!line.trim()) return;
+  let request;
+  try {
+    request = JSON.parse(line);
+  } catch {
+    send({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+    return;
+  }
+  if (request.id === undefined) return;
+  if (request.method === 'initialize') {
+    send({
+      jsonrpc: '2.0',
+      id: request.id,
+      result: {
+        protocolVersion: request.params?.protocolVersion ?? '2024-11-05',
+        capabilities: { tools: {} },
+        serverInfo: { name: serverName, version: '0.1.0' },
+      },
+    });
+    return;
+  }
+  if (request.method === 'tools/list') {
+    send({
+      jsonrpc: '2.0',
+      id: request.id,
+      result: {
+        tools: [
+          { name: 'echo', description: 'Shared collision fixture', inputSchema: { type: 'object' } },
+          { name: `${routeName}_unique`, description: 'Unique addon tool', inputSchema: { type: 'object' } },
+        ],
+      },
+    });
+    return;
+  }
+  if (request.method === 'tools/call') {
+    send({
+      jsonrpc: '2.0',
+      id: request.id,
+      result: { content: [{ type: 'text', text: `${routeName}:${request.params?.name}` }] },
+    });
+    return;
+  }
+  if (request.method === 'ping') {
+    send({ jsonrpc: '2.0', id: request.id, result: {} });
+    return;
+  }
+  send({ jsonrpc: '2.0', id: request.id, error: { code: -32601, message: 'Method not found' } });
+});

package/dist/package.json

@@ -0,0 +1,4 @@
+{
+  "private": true,
+  "type": "module"
+}

package/dist/service/index.js

@@ -0,0 +1,20 @@
+const port = Number(process.env.BOTMUX_DEMO_ADDON_SERVICE_PORT ?? 9356);
+
+export default {
+  mode: 'auto',
+  port,
+  pm2: {
+    script: './service/server.js',
+    args: ['--port', String(port)],
+    env: {
+      PORT: String(port),
+    },
+    autorestart: true,
+  },
+  urls({ host }) {
+    return {
+      openUrl: `http://${host}:${port}/`,
+      healthUrl: `http://${host}:${port}/health`,
+    };
+  },
+};

package/dist/service/server.js

@@ -0,0 +1,32 @@
+import { createServer } from 'node:http';
+
+if (process.argv.includes('--check')) {
+  process.exit(0);
+}
+
+function argValue(flag) {
+  const index = process.argv.indexOf(flag);
+  return index >= 0 ? process.argv[index + 1] : undefined;
+}
+
+const port = Number(argValue('--port') ?? process.env.PORT ?? 9356);
+const startedAt = new Date().toISOString();
+const server = createServer((req, res) => {
+  if (req.url === '/health') {
+    res.writeHead(200, { 'content-type': 'application/json' });
+    res.end(JSON.stringify({ ok: true, pid: process.pid, startedAt }));
+    return;
+  }
+  res.writeHead(200, { 'content-type': 'text/plain' });
+  res.end('botmux demo addon service\n');
+});
+
+server.listen(port, '0.0.0.0');
+
+function shutdown() {
+  server.close(() => process.exit(0));
+  setTimeout(() => process.exit(0), 1000).unref();
+}
+
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);

package/dist/skills/addon/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: botmux-demo-addon
+description: Demo skill installed by the botmux demo-addon plugin.
+---
+
+# Botmux Demo Addon
+
+Use this skill only as a fixture for botmux plugin installation and cleanup.

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@botmux-ai/plugin-demo-addon",
+  "version": "0.1.0",
+  "description": "Addon fixture plugin for botmux plugin conformance tests.",
+  "type": "module",
+  "keywords": [
+    "botmux-plugin"
+  ],
+  "botmux": {
+    "schemaVersion": 1,
+    "id": "demo-addon",
+    "displayName": "Demo Addon",
+    "dependencies": {
+      "plugins": [
+        "demo-base"
+      ]
+    },
+    "service": {
+      "mode": "auto"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT"
+}