copilot-tracer 1.0.1

package/dist/setup.js

@@ -0,0 +1,216 @@
+/**
+ * copilot-tracer setup — auto-detect copilot CLI + VS Code and inject OTLP env config
+ *
+ * What it does:
+ *  1. Detect copilot CLI (which copilot)
+ *  2. Detect VS Code installation + built-in copilot (v1.99+)
+ *  3. Inject OTEL env vars into:
+ *     - Shell profile (~/.zshrc / ~/.bashrc / ~/.zprofile)
+ *     - VS Code settings.json (terminal.integrated.env.osx)
+ *  4. Print a summary and next steps
+ */
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const OTEL_ENDPOINT_KEY = 'OTEL_EXPORTER_OTLP_ENDPOINT';
+const OTEL_CONTENT_KEY = 'OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT';
+const OTEL_ENABLED_KEY = 'COPILOT_OTEL_ENABLED';
+function otelEnvBlock(port) {
+    return [
+        `# >>> copilot-tracer OTLP config (auto-added) >>>`,
+        `export ${OTEL_ENDPOINT_KEY}=http://localhost:${port}`,
+        `export ${OTEL_CONTENT_KEY}=true`,
+        `export ${OTEL_ENABLED_KEY}=true`,
+        `# <<< copilot-tracer <<<`,
+    ].join('\n');
+}
+function vscodeEnvBlock(port) {
+    return {
+        [OTEL_ENDPOINT_KEY]: `http://localhost:${port}`,
+        [OTEL_CONTENT_KEY]: 'true',
+        [OTEL_ENABLED_KEY]: 'true',
+    };
+}
+// ── Detection helpers ─────────────────────────────────────────────────────────
+function detectCopilotCli() {
+    try {
+        const p = execSync('which copilot', { encoding: 'utf8' }).trim();
+        const v = execSync('copilot --version 2>/dev/null || true', { encoding: 'utf8' }).trim();
+        return { found: true, path: p, version: v.split('\n')[0] };
+    }
+    catch {
+        return { found: false };
+    }
+}
+function detectVSCode() {
+    try {
+        const v = execSync('code --version 2>/dev/null', { encoding: 'utf8' }).trim();
+        const lines = v.split('\n');
+        const version = lines[0];
+        const major = parseInt(version.split('.')[0], 10);
+        const minor = parseInt(version.split('.')[1], 10);
+        // Copilot built-in since VS Code 1.99
+        const hasBuiltinCopilot = major > 1 || (major === 1 && minor >= 99);
+        return { found: true, version, hasBuiltinCopilot };
+    }
+    catch {
+        // Try app bundle directly
+        const appPath = '/Applications/Visual Studio Code.app';
+        if (fs.existsSync(appPath)) {
+            return { found: true, hasBuiltinCopilot: true, version: 'unknown (app found)' };
+        }
+        return { found: false, hasBuiltinCopilot: false };
+    }
+}
+function detectShellProfile() {
+    const candidates = [
+        path.join(os.homedir(), '.zshrc'),
+        path.join(os.homedir(), '.zprofile'),
+        path.join(os.homedir(), '.bash_profile'),
+        path.join(os.homedir(), '.bashrc'),
+    ];
+    for (const p of candidates) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    // Default to .zshrc (create it)
+    return path.join(os.homedir(), '.zshrc');
+}
+function getVSCodeSettingsPath() {
+    return path.join(os.homedir(), 'Library/Application Support/Code/User/settings.json');
+}
+// ── Patchers ──────────────────────────────────────────────────────────────────
+function patchShellProfile(profilePath, port) {
+    const content = fs.existsSync(profilePath) ? fs.readFileSync(profilePath, 'utf8') : '';
+    const block = otelEnvBlock(port);
+    // Already has our block?
+    if (content.includes('copilot-tracer OTLP config')) {
+        // Check if port matches
+        if (content.includes(`http://localhost:${port}`)) {
+            return { action: 'already_set' };
+        }
+        // Port changed — update
+        const updated = content.replace(/# >>> copilot-tracer OTLP config[\s\S]*?# <<< copilot-tracer <<</, block);
+        fs.writeFileSync(profilePath, updated, 'utf8');
+        return { action: 'updated' };
+    }
+    // Append
+    const newContent = content.trimEnd() + '\n\n' + block + '\n';
+    fs.writeFileSync(profilePath, newContent, 'utf8');
+    return { action: 'added' };
+}
+function patchVSCodeSettings(settingsPath, port) {
+    if (!fs.existsSync(settingsPath)) {
+        return { action: 'skipped', reason: 'settings.json not found' };
+    }
+    let settings;
+    try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    }
+    catch {
+        return { action: 'skipped', reason: 'could not parse settings.json' };
+    }
+    const envKey = 'terminal.integrated.env.osx';
+    const existing = (settings[envKey] ?? {});
+    const newEnv = vscodeEnvBlock(port);
+    // Check if already set correctly
+    if (existing[OTEL_ENDPOINT_KEY] === `http://localhost:${port}` &&
+        existing[OTEL_CONTENT_KEY] === 'true' &&
+        existing[OTEL_ENABLED_KEY] === 'true') {
+        return { action: 'already_set' };
+    }
+    const wasSet = !!existing[OTEL_ENDPOINT_KEY];
+    settings[envKey] = { ...existing, ...newEnv };
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+    return { action: wasSet ? 'updated' : 'added' };
+}
+// ── Main setup ────────────────────────────────────────────────────────────────
+export function runSetup(port) {
+    const CHECK = '✅';
+    const WARN = '⚠️ ';
+    const INFO = '📍';
+    const ARROW = '→';
+    console.log('\n╔════════════════════════════════════════════════╗');
+    console.log('║       Copilot Tracer — Auto Setup              ║');
+    console.log('╚════════════════════════════════════════════════╝\n');
+    // 1. Detect copilot CLI
+    const cli = detectCopilotCli();
+    if (cli.found) {
+        console.log(`${CHECK} GitHub Copilot CLI detected`);
+        console.log(`   ${INFO} Path   : ${cli.path}`);
+        if (cli.version)
+            console.log(`   ${INFO} Version: ${cli.version}`);
+    }
+    else {
+        console.log(`${WARN} GitHub Copilot CLI not found`);
+        console.log(`   Install: npm install -g @github/copilot`);
+    }
+    // 2. Detect VS Code
+    const vscode = detectVSCode();
+    if (vscode.found) {
+        console.log(`\n${CHECK} Visual Studio Code detected`);
+        if (vscode.version)
+            console.log(`   ${INFO} Version: ${vscode.version}`);
+        if (vscode.hasBuiltinCopilot) {
+            console.log(`   ${CHECK} Built-in Copilot (v1.99+) — will be configured`);
+        }
+        else {
+            console.log(`   ${WARN} VS Code version may not have built-in Copilot`);
+        }
+    }
+    else {
+        console.log(`\n${WARN} Visual Studio Code not found — skipping VS Code config`);
+    }
+    // 3. Patch shell profile
+    const profilePath = detectShellProfile();
+    if (profilePath) {
+        const result = patchShellProfile(profilePath, port);
+        const label = path.basename(profilePath);
+        if (result.action === 'added') {
+            console.log(`\n${CHECK} Shell profile patched: ${label}`);
+            console.log(`   ${ARROW} Added OTEL env vars (endpoint, content capture)`);
+            console.log(`   ${ARROW} Run: source ${profilePath}`);
+        }
+        else if (result.action === 'updated') {
+            console.log(`\n${CHECK} Shell profile updated: ${label}`);
+            console.log(`   ${ARROW} Updated port to ${port}`);
+            console.log(`   ${ARROW} Run: source ${profilePath}`);
+        }
+        else {
+            console.log(`\n${CHECK} Shell profile: already configured (${label})`);
+        }
+    }
+    // 4. Patch VS Code settings
+    if (vscode.found) {
+        const settingsPath = getVSCodeSettingsPath();
+        const result = patchVSCodeSettings(settingsPath, port);
+        if (result.action === 'added') {
+            console.log(`\n${CHECK} VS Code settings patched`);
+            console.log(`   ${ARROW} Added terminal.integrated.env.osx with OTEL vars`);
+            console.log(`   ${ARROW} Restart VS Code to apply`);
+        }
+        else if (result.action === 'updated') {
+            console.log(`\n${CHECK} VS Code settings updated`);
+            console.log(`   ${ARROW} Updated port to ${port}`);
+            console.log(`   ${ARROW} Restart VS Code to apply`);
+        }
+        else if (result.action === 'already_set') {
+            console.log(`\n${CHECK} VS Code settings: already configured`);
+        }
+        else {
+            console.log(`\n${WARN} VS Code settings: ${result.reason}`);
+        }
+    }
+    // 5. Summary
+    console.log('\n────────────────────────────────────────────────');
+    console.log('  Next steps:\n');
+    console.log(`  1. source ${profilePath ?? '~/.zshrc'}   (apply to current terminal)`);
+    if (vscode.found)
+        console.log('  2. Restart VS Code');
+    console.log(`  3. node dist/cli.js --ui web --port ${port} --no-proxy`);
+    console.log(`  4. Open http://localhost:${port}`);
+    console.log(`  5. Use copilot normally — traces appear automatically`);
+    console.log('\n  Tracer endpoint: http://localhost:' + port + '/v1/traces');
+    console.log('────────────────────────────────────────────────\n');
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/webServer.js

@@ -0,0 +1,57 @@
+import express from 'express';
+import { createServer } from 'http';
+import { Server } from 'socket.io';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { getTraces, getTrace, getSessionSummary } from './db.js';
+import { traceEvents } from './proxy.js';
+import { registerOtlpRoutes } from './otlpReceiver.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function startWebServer(port = 4747, sessionId) {
+    const app = express();
+    const httpServer = createServer(app);
+    const io = new Server(httpServer, { cors: { origin: '*' } });
+    // Serve static web UI
+    app.use(express.static(path.join(__dirname, '../web')));
+    // Register OTLP receiver routes
+    app.use(express.json({ limit: '10mb' }));
+    registerOtlpRoutes(app, sessionId ?? 'default');
+    // API
+    app.get('/api/traces', (req, res) => {
+        const sid = req.query.sessionId || undefined; // undefined = all sessions
+        const traces = getTraces(sid, 200);
+        res.json(traces);
+    });
+    app.get('/api/traces/:id', (req, res) => {
+        const trace = getTrace(req.params.id);
+        if (!trace)
+            return res.status(404).json({ error: 'Not found' });
+        res.json(trace);
+    });
+    app.get('/api/summary', (req, res) => {
+        const sid = req.query.sessionId || sessionId;
+        if (!sid)
+            return res.json(null);
+        res.json(getSessionSummary(sid));
+    });
+    // Socket.io — push real-time updates
+    io.on('connection', (socket) => {
+        // Send current state on connect
+        const sid = sessionId;
+        socket.emit('init', {
+            traces: getTraces(sid, 200),
+            summary: sid ? getSessionSummary(sid) : null,
+        });
+        const onUpdate = (entry) => socket.emit('trace:update', entry);
+        const onDone = (entry) => socket.emit('trace:done', entry);
+        traceEvents.on('trace:update', onUpdate);
+        traceEvents.on('trace:done', onDone);
+        socket.on('disconnect', () => {
+            traceEvents.off('trace:update', onUpdate);
+            traceEvents.off('trace:done', onDone);
+        });
+    });
+    httpServer.listen(port, () => {
+        console.log(`\n  🌐 Copilot Tracer Web UI: http://localhost:${port}\n`);
+    });
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "copilot-tracer",
+  "version": "1.0.1",
+  "description": "Real-time monitor and tracing tool for GitHub Copilot CLI — tracks tokens, AI credits, MCP/skill/agent calls with console and web UI",
+  "keywords": [
+    "copilot",
+    "github-copilot",
+    "tracing",
+    "observability",
+    "opentelemetry",
+    "tokens",
+    "ai-credits"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chuongnd/copilot-tracer.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist/",
+    "web/",
+    "README.md"
+  ],
+  "main": "dist/index.js",
+  "bin": {
+    "copilot-tracer": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "dev": "tsx src/cli.ts",
+    "console": "tsx src/cli.ts --ui console",
+    "web": "tsx src/cli.ts --ui web",
+    "start": "node dist/cli.js",
+    "publish:npm": "bash scripts/publish.sh"
+  },
+  "dependencies": {
+    "@opentelemetry/otlp-transformer": "^0.221.0",
+    "better-sqlite3": "^13.0.2",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.4",
+    "commander": "^12.0.0",
+    "date-fns": "^3.3.1",
+    "express": "^4.18.2",
+    "ink": "^5.0.1",
+    "ink-table": "^3.0.0",
+    "open": "^10.1.0",
+    "react": "^18.2.0",
+    "socket.io": "^4.7.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  },
+  "type": "module"
+}