@telepat/snoopy 0.1.13 → 0.1.15

package/dist/src/agent/install.js

@@ -0,0 +1,488 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+const SNOOPY_MARKER = 'snoopy';
+const SUPPORTED_RUNTIMES = [
+    'claude',
+    'claude-desktop',
+    'chatgpt',
+    'gemini',
+    'codex',
+    'cursor',
+    'vscode',
+    'opencode',
+    'generic-mcp',
+];
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function readJsonFile(path) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+            return {};
+        }
+        return raw;
+    }
+    catch {
+        return {};
+    }
+}
+function writeJsonFile(path, data) {
+    ensureDir(dirname(path));
+    writeFileSync(path, JSON.stringify(data, null, 2) + '\n');
+}
+function readTomlFile(path) {
+    if (!existsSync(path)) {
+        return '';
+    }
+    return readFileSync(path, 'utf8');
+}
+function writeTomlFile(path, content) {
+    ensureDir(dirname(path));
+    writeFileSync(path, content);
+}
+// --- Claude Code ---
+function installClaude() {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    mcpServers[SNOOPY_MARKER] = { command: 'snoopy', args: ['mcp'] };
+    settings.mcpServers = mcpServers;
+    writeJsonFile(settingsPath, settings);
+    return {
+        runtime: 'claude',
+        installed: true,
+        configPath: settingsPath,
+        message: `Registered Snoopy MCP server in ${settingsPath}`,
+    };
+}
+function uninstallClaude() {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    delete mcpServers[SNOOPY_MARKER];
+    settings.mcpServers = mcpServers;
+    writeJsonFile(settingsPath, settings);
+    return {
+        runtime: 'claude',
+        installed: false,
+        configPath: settingsPath,
+        message: `Removed Snoopy MCP server from ${settingsPath}`,
+    };
+}
+function isClaudeInstalled() {
+    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    return SNOOPY_MARKER in mcpServers;
+}
+// --- Claude Desktop ---
+function getClaudeDesktopConfigPath() {
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    }
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+function installClaudeDesktop() {
+    const configPath = getClaudeDesktopConfigPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    mcpServers[SNOOPY_MARKER] = { command: 'snoopy', args: ['mcp'] };
+    config.mcpServers = mcpServers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'claude-desktop',
+        installed: true,
+        configPath,
+        message: `Registered Snoopy MCP server in ${configPath}`,
+    };
+}
+function uninstallClaudeDesktop() {
+    const configPath = getClaudeDesktopConfigPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    delete mcpServers[SNOOPY_MARKER];
+    config.mcpServers = mcpServers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'claude-desktop',
+        installed: false,
+        configPath,
+        message: `Removed Snoopy MCP server from ${configPath}`,
+    };
+}
+function isClaudeDesktopInstalled() {
+    const configPath = getClaudeDesktopConfigPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    return SNOOPY_MARKER in mcpServers;
+}
+// --- ChatGPT Desktop ---
+function installChatGpt() {
+    console.log('[snoopy] ChatGPT Desktop uses remote MCP servers via Developer Mode.');
+    console.log('[snoopy] To register Snoopy with ChatGPT:');
+    console.log('  1. Open ChatGPT Desktop > Settings > Apps > Advanced settings');
+    console.log('  2. Enable Developer mode');
+    console.log('  3. Create a new MCP app pointing to Snoopy (requires a remote MCP proxy)');
+    console.log('[snoopy] Note: ChatGPT Desktop requires a remote HTTP MCP endpoint, not local stdio.');
+    console.log('[snoopy] For local usage, consider using a stdio-to-HTTP proxy.');
+    return {
+        runtime: 'chatgpt',
+        installed: false,
+        configPath: 'manual-setup',
+        message: 'ChatGPT Desktop requires manual MCP app setup via Developer Mode. See printed instructions.',
+    };
+}
+function uninstallChatGpt() {
+    return {
+        runtime: 'chatgpt',
+        installed: false,
+        configPath: 'manual-setup',
+        message: 'ChatGPT Desktop MCP apps are managed in the ChatGPT Desktop UI.',
+    };
+}
+function isChatGptInstalled() {
+    return false;
+}
+// --- Gemini ---
+function getGeminiSettingsPath() {
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'Gemini', 'settings.json');
+    }
+    return join(homedir(), '.gemini', 'settings.json');
+}
+function installGemini() {
+    const settingsPath = getGeminiSettingsPath();
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    mcpServers[SNOOPY_MARKER] = { command: 'snoopy', args: ['mcp'] };
+    settings.mcpServers = mcpServers;
+    writeJsonFile(settingsPath, settings);
+    return {
+        runtime: 'gemini',
+        installed: true,
+        configPath: settingsPath,
+        message: `Registered Snoopy MCP server in ${settingsPath}`,
+    };
+}
+function uninstallGemini() {
+    const settingsPath = getGeminiSettingsPath();
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    delete mcpServers[SNOOPY_MARKER];
+    settings.mcpServers = mcpServers;
+    writeJsonFile(settingsPath, settings);
+    return {
+        runtime: 'gemini',
+        installed: false,
+        configPath: settingsPath,
+        message: `Removed Snoopy MCP server from ${settingsPath}`,
+    };
+}
+function isGeminiInstalled() {
+    const settingsPath = getGeminiSettingsPath();
+    const settings = readJsonFile(settingsPath);
+    const mcpServers = settings.mcpServers ?? {};
+    return SNOOPY_MARKER in mcpServers;
+}
+// --- Codex ---
+function getCodexConfigPath() {
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'codex', 'config.toml');
+    }
+    return join(homedir(), '.codex', 'config.toml');
+}
+function installCodex() {
+    const configPath = getCodexConfigPath();
+    let content = readTomlFile(configPath);
+    const marker = `[mcp_servers.${SNOOPY_MARKER}]`;
+    if (content.includes(marker)) {
+        return {
+            runtime: 'codex',
+            installed: true,
+            configPath,
+            message: `Snoopy MCP server already registered in ${configPath}`,
+        };
+    }
+    const section = `\n${marker}\ncommand = "snoopy"\nargs = ["mcp"]\nenabled = true\ntool_timeout_sec = 120\n`;
+    content += section;
+    writeTomlFile(configPath, content);
+    return {
+        runtime: 'codex',
+        installed: true,
+        configPath,
+        message: `Registered Snoopy MCP server in ${configPath}`,
+    };
+}
+function uninstallCodex() {
+    const configPath = getCodexConfigPath();
+    let content = readTomlFile(configPath);
+    const marker = `[mcp_servers.${SNOOPY_MARKER}]`;
+    const markerIndex = content.indexOf(marker);
+    if (markerIndex === -1) {
+        return {
+            runtime: 'codex',
+            installed: false,
+            configPath,
+            message: `Snoopy MCP server not found in ${configPath}`,
+        };
+    }
+    const afterMarker = content.slice(markerIndex + marker.length);
+    const nextSectionMatch = afterMarker.match(/\n\[/);
+    const endIndex = nextSectionMatch
+        ? markerIndex + marker.length + nextSectionMatch.index + 1
+        : content.length;
+    content = content.slice(0, markerIndex) + content.slice(endIndex);
+    writeTomlFile(configPath, content.trimEnd() + '\n');
+    return {
+        runtime: 'codex',
+        installed: false,
+        configPath,
+        message: `Removed Snoopy MCP server from ${configPath}`,
+    };
+}
+function isCodexInstalled() {
+    const configPath = getCodexConfigPath();
+    const content = readTomlFile(configPath);
+    return content.includes(`[mcp_servers.${SNOOPY_MARKER}]`);
+}
+// --- Cursor ---
+function getCursorMcpPath() {
+    return join(homedir(), '.cursor', 'mcp.json');
+}
+function installCursor() {
+    const configPath = getCursorMcpPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    mcpServers[SNOOPY_MARKER] = { command: 'snoopy', args: ['mcp'] };
+    config.mcpServers = mcpServers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'cursor',
+        installed: true,
+        configPath,
+        message: `Registered Snoopy MCP server in ${configPath}`,
+    };
+}
+function uninstallCursor() {
+    const configPath = getCursorMcpPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    delete mcpServers[SNOOPY_MARKER];
+    config.mcpServers = mcpServers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'cursor',
+        installed: false,
+        configPath,
+        message: `Removed Snoopy MCP server from ${configPath}`,
+    };
+}
+function isCursorInstalled() {
+    const configPath = getCursorMcpPath();
+    const config = readJsonFile(configPath);
+    const mcpServers = config.mcpServers ?? {};
+    return SNOOPY_MARKER in mcpServers;
+}
+// --- VS Code ---
+function getVSCodeMcpPath() {
+    return join(process.cwd(), '.vscode', 'mcp.json');
+}
+function installVSCode() {
+    const configPath = getVSCodeMcpPath();
+    const config = readJsonFile(configPath);
+    const servers = config.servers ?? {};
+    servers[SNOOPY_MARKER] = {
+        type: 'stdio',
+        command: 'snoopy',
+        args: ['mcp'],
+    };
+    config.servers = servers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'vscode',
+        installed: true,
+        configPath,
+        message: `Registered Snoopy MCP server in ${configPath}`,
+    };
+}
+function uninstallVSCode() {
+    const configPath = getVSCodeMcpPath();
+    const config = readJsonFile(configPath);
+    const servers = config.servers ?? {};
+    delete servers[SNOOPY_MARKER];
+    config.servers = servers;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'vscode',
+        installed: false,
+        configPath,
+        message: `Removed Snoopy MCP server from ${configPath}`,
+    };
+}
+function isVSCodeInstalled() {
+    const configPath = getVSCodeMcpPath();
+    const config = readJsonFile(configPath);
+    const servers = config.servers ?? {};
+    return SNOOPY_MARKER in servers;
+}
+// --- OpenCode ---
+function getOpenCodeConfigPath() {
+    return join(process.cwd(), 'opencode.json');
+}
+function installOpenCode() {
+    const configPath = getOpenCodeConfigPath();
+    const config = readJsonFile(configPath);
+    const mcp = config.mcp ?? {};
+    mcp[SNOOPY_MARKER] = {
+        type: 'local',
+        command: ['snoopy', 'mcp'],
+        enabled: true,
+    };
+    config.mcp = mcp;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'opencode',
+        installed: true,
+        configPath,
+        message: `Registered Snoopy MCP server in ${configPath}`,
+    };
+}
+function uninstallOpenCode() {
+    const configPath = getOpenCodeConfigPath();
+    const config = readJsonFile(configPath);
+    const mcp = config.mcp ?? {};
+    delete mcp[SNOOPY_MARKER];
+    config.mcp = mcp;
+    writeJsonFile(configPath, config);
+    return {
+        runtime: 'opencode',
+        installed: false,
+        configPath,
+        message: `Removed Snoopy MCP server from ${configPath}`,
+    };
+}
+function isOpenCodeInstalled() {
+    const configPath = getOpenCodeConfigPath();
+    const config = readJsonFile(configPath);
+    const mcp = config.mcp ?? {};
+    return SNOOPY_MARKER in mcp;
+}
+// --- Generic MCP ---
+function installGenericMcp() {
+    const config = {
+        mcpServers: {
+            snoopy: {
+                command: 'snoopy',
+                args: ['mcp'],
+            },
+        },
+    };
+    console.log('[snoopy] Generic MCP server configuration:');
+    console.log('');
+    console.log('JSON format:');
+    console.log(JSON.stringify(config, null, 2));
+    console.log('');
+    console.log('Add this to your agent framework\'s MCP server configuration.');
+    return {
+        runtime: 'generic-mcp',
+        installed: false,
+        configPath: 'manual',
+        message: 'Printed generic MCP config to stdout. Add to your agent framework manually.',
+    };
+}
+function uninstallGenericMcp() {
+    return {
+        runtime: 'generic-mcp',
+        installed: false,
+        configPath: 'manual',
+        message: 'Remove the snoopy MCP server entry from your agent framework config manually.',
+    };
+}
+function isGenericMcpInstalled() {
+    return false;
+}
+const RUNTIME_HANDLERS = {
+    'claude': { install: installClaude, uninstall: uninstallClaude, isInstalled: isClaudeInstalled },
+    'claude-desktop': { install: installClaudeDesktop, uninstall: uninstallClaudeDesktop, isInstalled: isClaudeDesktopInstalled },
+    'chatgpt': { install: installChatGpt, uninstall: uninstallChatGpt, isInstalled: isChatGptInstalled },
+    'gemini': { install: installGemini, uninstall: uninstallGemini, isInstalled: isGeminiInstalled },
+    'codex': { install: installCodex, uninstall: uninstallCodex, isInstalled: isCodexInstalled },
+    'cursor': { install: installCursor, uninstall: uninstallCursor, isInstalled: isCursorInstalled },
+    'vscode': { install: installVSCode, uninstall: uninstallVSCode, isInstalled: isVSCodeInstalled },
+    'opencode': { install: installOpenCode, uninstall: uninstallOpenCode, isInstalled: isOpenCodeInstalled },
+    'generic-mcp': { install: installGenericMcp, uninstall: uninstallGenericMcp, isInstalled: isGenericMcpInstalled },
+};
+function validateRuntime(runtime) {
+    if (!SUPPORTED_RUNTIMES.includes(runtime)) {
+        throw new Error(`Unsupported runtime "${runtime}". Supported: ${SUPPORTED_RUNTIMES.join(', ')}`);
+    }
+    return runtime;
+}
+export async function agentInstall(runtime) {
+    const rt = validateRuntime(runtime);
+    const result = RUNTIME_HANDLERS[rt].install();
+    console.log(`[snoopy] ${result.message}`);
+    return result;
+}
+export async function agentUninstall(runtime) {
+    const rt = validateRuntime(runtime);
+    const result = RUNTIME_HANDLERS[rt].uninstall();
+    console.log(`[snoopy] ${result.message}`);
+    return result;
+}
+export async function agentStatus() {
+    const runtimes = SUPPORTED_RUNTIMES.map((rt) => {
+        let configPath = '';
+        try {
+            switch (rt) {
+                case 'claude':
+                    configPath = join(homedir(), '.claude', 'settings.json');
+                    break;
+                case 'claude-desktop':
+                    configPath = getClaudeDesktopConfigPath();
+                    break;
+                case 'chatgpt':
+                    configPath = 'manual-setup';
+                    break;
+                case 'gemini':
+                    configPath = getGeminiSettingsPath();
+                    break;
+                case 'codex':
+                    configPath = getCodexConfigPath();
+                    break;
+                case 'cursor':
+                    configPath = getCursorMcpPath();
+                    break;
+                case 'vscode':
+                    configPath = getVSCodeMcpPath();
+                    break;
+                case 'opencode':
+                    configPath = getOpenCodeConfigPath();
+                    break;
+                case 'generic-mcp':
+                    configPath = 'manual';
+                    break;
+            }
+        }
+        catch {
+            configPath = 'unknown';
+        }
+        return {
+            runtime: rt,
+            installed: RUNTIME_HANDLERS[rt].isInstalled(),
+            configPath,
+        };
+    });
+    return { runtimes };
+}
+//# sourceMappingURL=install.js.map

package/dist/src/cli/commands/feedback.d.ts

@@ -0,0 +1,18 @@
+interface FeedbackSubmitOptions {
+    valid?: boolean;
+    invalid?: boolean;
+    reason?: string;
+    json?: boolean;
+}
+interface FeedbackReviewOptions {
+    json?: boolean;
+    limit?: number;
+}
+interface FeedbackConsolidateOptions {
+    limit?: number;
+    json?: boolean;
+}
+export declare function feedbackSubmit(resultId: string, options?: FeedbackSubmitOptions): Promise<void>;
+export declare function feedbackReview(jobRef?: string, options?: FeedbackReviewOptions): Promise<void>;
+export declare function feedbackConsolidate(jobRef?: string, options?: FeedbackConsolidateOptions): Promise<void>;
+export {};