@chrisromp/copilot-bridge 0.6.0-dev.2

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+export interface BotConfig {
+    token: string;
+    agent?: string | null;
+    admin?: boolean;
+}
+export interface PlatformConfig {
+    url: string;
+    botToken?: string;
+    bots?: Record<string, BotConfig>;
+}
+export interface ChannelConfig {
+    id: string;
+    platform: string;
+    name: string;
+    workingDirectory: string;
+    bot?: string;
+    agent?: string | null;
+    model?: string;
+    triggerMode: 'mention' | 'all';
+    threadedReplies: boolean;
+    verbose: boolean;
+    isDM?: boolean;
+}
+export interface PermissionsConfig {
+    allow?: string[];
+    deny?: string[];
+    allowPaths?: string[];
+    allowUrls?: string[];
+}
+export interface AppConfig {
+    platforms: Record<string, PlatformConfig>;
+    channels: ChannelConfig[];
+    defaults: {
+        model: string;
+        agent: string | null;
+        triggerMode: 'mention' | 'all';
+        threadedReplies: boolean;
+        verbose: boolean;
+        permissionMode: 'interactive' | 'autopilot';
+    };
+    permissions?: PermissionsConfig;
+    interAgent?: InterAgentConfig;
+}
+export interface InterAgentConfig {
+    enabled: boolean;
+    defaultTimeout?: number;
+    maxTimeout?: number;
+    maxDepth?: number;
+    allow?: Record<string, InterAgentPermission>;
+}
+export interface InterAgentPermission {
+    canCall?: string[];
+    canBeCalledBy?: string[];
+}
+export interface InboundMessage {
+    platform: string;
+    channelId: string;
+    userId: string;
+    username: string;
+    text: string;
+    postId: string;
+    threadRootId?: string;
+    mentionsBot: boolean;
+    isDM: boolean;
+    attachments?: MessageAttachment[];
+}
+export interface MessageAttachment {
+    type: 'image' | 'file' | 'video' | 'audio';
+    id: string;
+    url: string;
+    name: string;
+    mimeType?: string;
+    size?: number;
+}
+export interface InboundReaction {
+    platform: string;
+    channelId: string;
+    userId: string;
+    postId: string;
+    emoji: string;
+    action: 'added' | 'removed';
+}
+export interface SendOpts {
+    threadRootId?: string;
+}
+export interface CreateChannelOpts {
+    name: string;
+    displayName: string;
+    private: boolean;
+    teamId: string;
+}
+export interface TeamInfo {
+    id: string;
+    name: string;
+    displayName: string;
+}
+export interface ChannelInfo {
+    id: string;
+    name: string;
+    displayName: string;
+    type: string;
+    teamId: string;
+}
+export interface ChannelAdapter {
+    readonly platform: string;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onMessage(handler: (msg: InboundMessage) => void): void;
+    onReaction(handler: (reaction: InboundReaction) => void): void;
+    sendMessage(channelId: string, content: string, opts?: SendOpts): Promise<string>;
+    updateMessage(channelId: string, messageId: string, content: string): Promise<void>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    setTyping(channelId: string): Promise<void>;
+    replyInThread(channelId: string, rootId: string, content: string): Promise<string>;
+    getBotUserId(): string;
+    /** Download a file attachment to a local path. Returns the written path. */
+    downloadFile(fileId: string, destPath: string): Promise<string>;
+    /** Upload a local file and send it as a message in a channel. Returns the post ID. */
+    sendFile(channelId: string, filePath: string, message?: string, opts?: SendOpts): Promise<string>;
+    /** Add an emoji reaction to a message. Best-effort — implementations should not throw. */
+    addReaction?(postId: string, emoji: string): Promise<void>;
+    createChannel?(opts: CreateChannelOpts): Promise<string>;
+    addUserToChannel?(channelId: string, userId: string): Promise<void>;
+    getTeams?(): Promise<TeamInfo[]>;
+    getChannelByName?(teamId: string, name: string): Promise<ChannelInfo | null>;
+    /** Discover DM channels for this bot (optional — platform-specific). */
+    discoverDMChannels?(): Promise<{
+        channelId: string;
+        otherUserId: string;
+    }[]>;
+}
+/** Factory function type for constructing a ChannelAdapter instance for a given platform. */
+export type AdapterFactory = (platformName: string, url: string, token: string) => ChannelAdapter;
+export interface ChannelSessionState {
+    channelId: string;
+    sessionId: string;
+    model: string;
+    agent: string | null;
+    verbose: boolean;
+    triggerMode: 'mention' | 'all';
+    threadedReplies: boolean;
+    permissionMode: 'interactive' | 'autopilot';
+    createdAt: string;
+}
+export interface PermissionRule {
+    id?: number;
+    scope: string;
+    tool: string;
+    commandPattern: string;
+    action: 'allow' | 'deny';
+    createdAt: string;
+}
+export interface PendingPermission {
+    sessionId: string;
+    channelId: string;
+    messageId?: string;
+    toolName: string;
+    serverName?: string;
+    toolInput: unknown;
+    commands: string[];
+    resolve: (result: {
+        kind: 'approved' | 'denied-by-rules' | 'denied-interactively-by-user' | 'denied-no-approval-rule-and-could-not-request-from-user';
+    }) => void;
+    createdAt: number;
+}
+export interface PendingUserInput {
+    sessionId: string;
+    channelId: string;
+    messageId?: string;
+    question: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+    resolve: (answer: {
+        answer: string;
+        wasFreeform: boolean;
+    }) => void;
+    createdAt: number;
+}
+export type CopilotEventType = 'assistant.message' | 'assistant.message_delta' | 'assistant.turn_start' | 'assistant.turn_end' | 'assistant.reasoning' | 'assistant.reasoning_delta' | 'tool.execution_start' | 'tool.execution_complete' | 'session.idle' | 'session.error';
+export interface FormattedEvent {
+    type: 'content' | 'tool_start' | 'tool_complete' | 'error' | 'status';
+    content: string;
+    verbose: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@chrisromp/copilot-bridge",
+  "version": "0.6.0-dev.2",
+  "description": "Mattermost ↔ GitHub Copilot bridge",
+  "type": "module",
+  "main": "dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChrisRomp/copilot-bridge.git"
+  },
+  "bin": {
+    "copilot-bridge": "bin/copilot-bridge.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "scripts/*.ts",
+    "scripts/lib/*.ts",
+    "!scripts/**/*.test.ts",
+    "!scripts/test-admin-api.ts",
+    "scripts/com.copilot-bridge.plist",
+    "scripts/copilot-bridge.service",
+    "templates/",
+    "config.sample.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "tsx dist/index.js",
+    "init": "tsx scripts/init.ts",
+    "check": "tsx scripts/check.ts",
+    "install-service": "tsx scripts/install-service.ts",
+    "uninstall-service": "tsx scripts/uninstall-service.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@github/copilot-sdk": "^0.1.32",
+    "@mattermost/client": "^10.3.0",
+    "@mattermost/types": "^10.3.0",
+    "better-sqlite3": "^12.6.2",
+    "cron": "^4.4.0",
+    "cronstrue": "^3.13.0",
+    "luxon": "^3.7.2",
+    "tsx": "^4.21.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/ws": "^8.5.14",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  }
+}

package/scripts/check.ts

@@ -0,0 +1,267 @@
+#!/usr/bin/env npx tsx
+/**
+ * copilot-bridge check — Validate an existing installation.
+ *
+ * Usage: npm run check
+ *        npx tsx scripts/check.ts
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { heading, printCheck, printSummary, info, dim, type CheckResult } from './lib/output.js';
+import { runAllPrereqs } from './lib/prerequisites.js';
+import { pingServer, validateBotToken, checkChannelAccess } from './lib/mattermost.js';
+import { getConfigPath, getConfigDir } from './lib/config-gen.js';
+import { detectPlatform, getServiceStatus } from './lib/service.js';
+
+async function main() {
+  console.log();
+  heading('🔍 copilot-bridge check');
+  dim('Validating your installation...\n');
+
+  const results: CheckResult[] = [];
+
+  // --- Prerequisites ---
+  heading('Prerequisites');
+  const prereqs = runAllPrereqs();
+  for (const check of prereqs) {
+    printCheck(check);
+    results.push(check);
+  }
+
+  // --- Config file ---
+  heading('Configuration');
+  const configPath = getConfigPath();
+
+  if (!fs.existsSync(configPath)) {
+    const result: CheckResult = { status: 'fail', label: 'Config file', detail: `not found at ${configPath}` };
+    printCheck(result);
+    results.push(result);
+    info('Run "npm run init" to create a config file.');
+    printSummary(results);
+    process.exit(results.some(r => r.status === 'fail') ? 1 : 0);
+  }
+
+  // Parse config
+  let config: any;
+  try {
+    const raw = fs.readFileSync(configPath, 'utf-8');
+    config = JSON.parse(raw);
+    const result: CheckResult = { status: 'pass', label: `Config: ${configPath}` };
+    printCheck(result);
+    results.push(result);
+  } catch (err: any) {
+    const result: CheckResult = { status: 'fail', label: 'Config file', detail: `invalid JSON: ${err.message}` };
+    printCheck(result);
+    results.push(result);
+    printSummary(results);
+    process.exit(1);
+  }
+
+  // Validate required fields
+  if (!config.platforms?.mattermost) {
+    const result: CheckResult = { status: 'fail', label: 'Config structure', detail: 'missing platforms.mattermost' };
+    printCheck(result);
+    results.push(result);
+  } else {
+    const result: CheckResult = { status: 'pass', label: 'Config structure', detail: 'platforms.mattermost present' };
+    printCheck(result);
+    results.push(result);
+  }
+
+  if (!config.channels || !Array.isArray(config.channels) || config.channels.length === 0) {
+    const result: CheckResult = { status: 'warn', label: 'Channels', detail: 'none configured — DMs will still work' };
+    printCheck(result);
+    results.push(result);
+  }
+
+  // --- Mattermost connectivity ---
+  const mmConfig = config.platforms?.mattermost;
+  if (mmConfig?.url) {
+    heading('Mattermost');
+    const pingResult = await pingServer(mmConfig.url);
+    printCheck(pingResult);
+    results.push(pingResult);
+
+    // Validate bot tokens
+    const bots: Array<{ name: string; token: string }> = [];
+
+    if (mmConfig.botToken) {
+      bots.push({ name: 'default', token: mmConfig.botToken });
+    }
+    if (mmConfig.bots && typeof mmConfig.bots === 'object') {
+      for (const [name, botConfig] of Object.entries(mmConfig.bots)) {
+        if ((botConfig as any)?.token) {
+          bots.push({ name, token: (botConfig as any).token });
+        }
+      }
+    }
+
+    if (bots.length === 0) {
+      const result: CheckResult = { status: 'fail', label: 'Bot tokens', detail: 'no botToken or bots configured' };
+      printCheck(result);
+      results.push(result);
+    }
+
+    for (const bot of bots) {
+      const validation = await validateBotToken(mmConfig.url, bot.token);
+      printCheck(validation.result);
+      results.push(validation.result);
+    }
+
+    // Validate channel access
+    if (config.channels?.length > 0) {
+      heading('Channels (from config)');
+      const primaryToken = bots[0]?.token;
+      if (primaryToken) {
+        for (const ch of config.channels) {
+          const channelBot = bots.find(b => b.name === ch.bot) || bots[0];
+          const access = await checkChannelAccess(mmConfig.url, channelBot.token, ch.id, ch.name);
+          printCheck(access);
+          results.push(access);
+        }
+      }
+    }
+  }
+
+  // --- Working directories ---
+  if (config.channels?.length > 0) {
+    heading('Working Directories');
+    for (const ch of config.channels) {
+      if (!ch.workingDirectory) {
+        const result: CheckResult = { status: 'warn', label: `Channel ${ch.id}`, detail: 'no workingDirectory set' };
+        printCheck(result);
+        results.push(result);
+        continue;
+      }
+      if (fs.existsSync(ch.workingDirectory)) {
+        const result: CheckResult = { status: 'pass', label: ch.workingDirectory };
+        printCheck(result);
+        results.push(result);
+      } else {
+        const result: CheckResult = { status: 'fail', label: ch.workingDirectory, detail: 'directory does not exist' };
+        printCheck(result);
+        results.push(result);
+      }
+    }
+  }
+
+  // --- Database ---
+  heading('Database');
+  const dbPath = path.join(getConfigDir(), 'state.db');
+  let dbExists = false;
+  if (fs.existsSync(dbPath)) {
+    dbExists = true;
+    const stats = fs.statSync(dbPath);
+    const sizeKb = Math.round(stats.size / 1024);
+    const result: CheckResult = { status: 'pass', label: `Database: ${dbPath}`, detail: `${sizeKb} KB` };
+    printCheck(result);
+    results.push(result);
+  } else {
+    const result: CheckResult = { status: 'warn', label: 'Database', detail: `not yet created at ${dbPath} — will be created on first run` };
+    printCheck(result);
+    results.push(result);
+  }
+
+  // --- Dynamic channels (from database) ---
+  if (dbExists) {
+    try {
+      const Database = (await import('better-sqlite3')).default;
+      const db = new Database(dbPath, { readonly: true });
+      const dynamicChannels = db.prepare(
+        'SELECT channel_id, platform, bot, is_dm FROM dynamic_channels'
+      ).all() as Array<{ channel_id: string; platform: string; bot: string; is_dm: number }>;
+      db.close();
+
+      if (dynamicChannels.length > 0) {
+        heading('Dynamic Channels (from database)');
+        dim('  Auto-discovered channels not in config.json (DMs, etc.)');
+        const dmCount = dynamicChannels.filter(c => c.is_dm).length;
+        const groupCount = dynamicChannels.length - dmCount;
+        const parts: string[] = [];
+        if (dmCount > 0) parts.push(`${dmCount} DM(s)`);
+        if (groupCount > 0) parts.push(`${groupCount} group channel(s)`);
+        const result: CheckResult = {
+          status: 'pass',
+          label: `${dynamicChannels.length} dynamic channel(s)`,
+          detail: parts.join(', '),
+        };
+        printCheck(result);
+        results.push(result);
+      }
+    } catch {
+      // DB might not have dynamic_channels table yet — not an error
+    }
+  }
+
+  // --- Workspaces ---
+  heading('Workspaces');
+  const workspacesDir = path.join(getConfigDir(), 'workspaces');
+  if (fs.existsSync(workspacesDir)) {
+    const botDirs = fs.readdirSync(workspacesDir).filter(f =>
+      fs.statSync(path.join(workspacesDir, f)).isDirectory()
+    );
+    if (botDirs.length > 0) {
+      const result: CheckResult = { status: 'pass', label: `Workspaces: ${botDirs.length} bot(s)`, detail: botDirs.join(', ') };
+      printCheck(result);
+      results.push(result);
+    } else {
+      const result: CheckResult = { status: 'warn', label: 'Workspaces', detail: 'directory exists but no bots initialized yet' };
+      printCheck(result);
+      results.push(result);
+    }
+  } else {
+    const result: CheckResult = { status: 'warn', label: 'Workspaces', detail: 'not yet created — will be initialized on first run' };
+    printCheck(result);
+    results.push(result);
+  }
+
+  // --- Service status ---
+  heading('Service');
+  const serviceStatus = getServiceStatus();
+  if (serviceStatus.running) {
+    const result: CheckResult = { status: 'pass', label: 'Service running', detail: serviceStatus.detail };
+    printCheck(result);
+    results.push(result);
+  } else {
+    const platform = detectPlatform();
+    const serviceHint = platform === 'macos'
+      ? 'install with: npm run install-service'
+      : platform === 'linux'
+        ? 'install with: npm run install-service (requires sudo)'
+        : 'start with: npm run dev (or npm start)';
+    const result: CheckResult = { status: 'warn', label: 'Service not running', detail: serviceHint };
+    printCheck(result);
+    results.push(result);
+  }
+
+  // --- MCP servers (optional) ---
+  const mcpConfigPath = path.join(os.homedir(), '.copilot', 'mcp-config.json');
+  if (fs.existsSync(mcpConfigPath)) {
+    heading('MCP Servers (user-level)');
+    dim(`  ${mcpConfigPath}`);
+    try {
+      const mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf-8'));
+      const servers = Object.keys(mcpConfig.mcpServers || {});
+      if (servers.length > 0) {
+        const result: CheckResult = { status: 'pass', label: `MCP: ${servers.length} server(s)`, detail: servers.join(', ') };
+        printCheck(result);
+        results.push(result);
+      }
+    } catch {
+      const result: CheckResult = { status: 'warn', label: 'MCP config', detail: 'exists but could not parse' };
+      printCheck(result);
+      results.push(result);
+    }
+  }
+
+  // --- Summary ---
+  printSummary(results);
+  process.exit(results.some(r => r.status === 'fail') ? 1 : 0);
+}
+
+main().catch((err) => {
+  console.error('\nCheck failed:', err.message || err);
+  process.exit(1);
+});

package/scripts/com.copilot-bridge.plist

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.copilot-bridge</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/opt/homebrew/bin/npx</string>
+        <string>tsx</string>
+        <string>src/index.ts</string>
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>/Users/USERNAME/path/to/copilot-bridge</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+        <key>HOME</key>
+        <string>/Users/USERNAME</string>
+    </dict>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <true/>
+
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+
+    <key>StandardOutPath</key>
+    <string>/tmp/copilot-bridge.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>/tmp/copilot-bridge.log</string>
+</dict>
+</plist>

package/scripts/copilot-bridge.service

@@ -0,0 +1,30 @@
+# copilot-bridge systemd service
+#
+# Install:
+#   sudo cp scripts/copilot-bridge.service /etc/systemd/system/
+#   # Edit ExecStart, WorkingDirectory, User, and HOME below
+#   sudo systemctl daemon-reload
+#   sudo systemctl enable --now copilot-bridge
+#
+# Logs:
+#   sudo journalctl -u copilot-bridge -f
+#
+# Restart:
+#   sudo systemctl restart copilot-bridge
+
+[Unit]
+Description=Copilot Bridge
+After=network.target
+
+[Service]
+Type=simple
+User=username
+ExecStart=/usr/local/bin/node /path/to/copilot-bridge/node_modules/.bin/tsx dist/index.js
+WorkingDirectory=/path/to/copilot-bridge
+Environment=HOME=/home/username
+Environment=PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target