@bbyqtbean/taco-helper 0.1.0

package/dist/agents/config-writer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Config writer — reads, merges, and writes agent MCP config files.
+ */
+import { AgentConfig } from './index.js';
+/**
+ * Write the "taco" MCP entry into the agent's config file.
+ *
+ * - If the file doesn't exist, create it with only taco added as a tool.
+ * - If the file exists, parse it and add "taco" as a value under the
+ *   agent's wrapper key (e.g. "mcpServers"), preserving all existing entries.
+ */
+export declare function writeConfig(agent: AgentConfig): Promise<void>;
+/**
+ * Remove the "taco" MCP entry from the agent's config file.
+ *
+ * - If the file doesn't exist, there's nothing to remove.
+ * - Only removes the "taco" key — all other entries are preserved.
+ * - If the wrapper key is empty after removal, it's cleaned up too.
+ */
+export declare function removeConfig(agent: AgentConfig): Promise<boolean>;
+/**
+ * Clean taco-specific lines from the agent's rules file.
+ *
+ * During setup, taco-helper wraps its injected content with sentinel comments:
+ *   # --- taco-start ---
+ *   ...taco rules...
+ *   # --- taco-end ---
+ *
+ * This function removes only the lines between the sentinels (inclusive),
+ * preserving any user-authored content outside the sentinels.
+ * The file is never deleted — even if empty after cleanup.
+ *
+ * @param agent - The agent config (must have a non-null rulesFileName)
+ * @param projectDir - The project directory containing the rules file
+ * @returns true if taco lines were found and removed
+ */
+export declare function cleanRulesFile(agent: AgentConfig, projectDir: string): Promise<boolean>;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/agents/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/agents/config-writer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzC;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BnE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCvE;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoD7F"}

package/dist/agents/config-writer.js

@@ -0,0 +1,142 @@
+/**
+ * Config writer — reads, merges, and writes agent MCP config files.
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname, join } from 'path';
+/** The MCP server entry that taco-helper writes into agent configs. */
+const TACO_MCP_ENTRY = {
+    command: 'npx',
+    args: ['-y', '@bbyqtbean/taco-helper@latest'],
+};
+/**
+ * Write the "taco" MCP entry into the agent's config file.
+ *
+ * - If the file doesn't exist, create it with only taco added as a tool.
+ * - If the file exists, parse it and add "taco" as a value under the
+ *   agent's wrapper key (e.g. "mcpServers"), preserving all existing entries.
+ */
+export async function writeConfig(agent) {
+    const { configPath, wrapperKey } = agent;
+    // Ensure the parent directory exists
+    const dir = dirname(configPath);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    let config = {};
+    // If the file already exists, parse it
+    if (existsSync(configPath)) {
+        try {
+            const raw = await readFile(configPath, 'utf-8');
+            config = JSON.parse(raw);
+        }
+        catch {
+            // If parsing fails, start fresh but warn the user
+            console.error(`⚠️  Could not parse ${configPath} — creating a fresh config.`);
+            config = {};
+        }
+    }
+    // Add "taco" under the wrapper key, preserving existing entries
+    const servers = config[wrapperKey] ?? {};
+    servers['taco'] = TACO_MCP_ENTRY;
+    config[wrapperKey] = servers;
+    // Write back
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Remove the "taco" MCP entry from the agent's config file.
+ *
+ * - If the file doesn't exist, there's nothing to remove.
+ * - Only removes the "taco" key — all other entries are preserved.
+ * - If the wrapper key is empty after removal, it's cleaned up too.
+ */
+export async function removeConfig(agent) {
+    const { configPath, wrapperKey } = agent;
+    if (!existsSync(configPath)) {
+        return false; // Nothing to remove
+    }
+    let config;
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        config = JSON.parse(raw);
+    }
+    catch {
+        console.error(`⚠️  Could not parse ${configPath} — nothing to remove.`);
+        return false;
+    }
+    const servers = config[wrapperKey];
+    if (!servers || !('taco' in servers)) {
+        return false; // "taco" entry doesn't exist
+    }
+    // Remove just the "taco" key
+    delete servers['taco'];
+    // If the wrapper key is now empty, remove it too
+    if (Object.keys(servers).length === 0) {
+        delete config[wrapperKey];
+    }
+    // Write back
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return true;
+}
+const SENTINEL_START = '# --- taco-start ---';
+const SENTINEL_END = '# --- taco-end ---';
+/**
+ * Clean taco-specific lines from the agent's rules file.
+ *
+ * During setup, taco-helper wraps its injected content with sentinel comments:
+ *   # --- taco-start ---
+ *   ...taco rules...
+ *   # --- taco-end ---
+ *
+ * This function removes only the lines between the sentinels (inclusive),
+ * preserving any user-authored content outside the sentinels.
+ * The file is never deleted — even if empty after cleanup.
+ *
+ * @param agent - The agent config (must have a non-null rulesFileName)
+ * @param projectDir - The project directory containing the rules file
+ * @returns true if taco lines were found and removed
+ */
+export async function cleanRulesFile(agent, projectDir) {
+    const { rulesFileName } = agent;
+    if (!rulesFileName) {
+        return false; // Agent has no rules file
+    }
+    const rulesPath = join(projectDir, rulesFileName);
+    if (!existsSync(rulesPath)) {
+        return false; // Nothing to clean
+    }
+    let content;
+    try {
+        content = await readFile(rulesPath, 'utf-8');
+    }
+    catch {
+        console.error(`⚠️  Could not read ${rulesPath} — skipping rules cleanup.`);
+        return false;
+    }
+    const lines = content.split('\n');
+    const resultLines = [];
+    let insideSentinel = false;
+    let foundSentinel = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === SENTINEL_START) {
+            insideSentinel = true;
+            foundSentinel = true;
+            continue; // Skip this line
+        }
+        if (trimmed === SENTINEL_END) {
+            insideSentinel = false;
+            continue; // Skip this line
+        }
+        if (!insideSentinel) {
+            resultLines.push(line);
+        }
+    }
+    if (!foundSentinel) {
+        return false; // No taco content found
+    }
+    // Write back the cleaned content (file is kept even if empty)
+    await writeFile(rulesPath, resultLines.join('\n'), 'utf-8');
+    return true;
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/agents/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/agents/config-writer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGrC,uEAAuE;AACvE,MAAM,cAAc,GAAG;IACnB,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAkB;IAChD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAEzC,qCAAqC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,GAA4B,EAAE,CAAC;IAEzC,uCAAuC;IACvC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACL,kDAAkD;YAClD,OAAO,CAAC,KAAK,CAAC,uBAAuB,UAAU,6BAA6B,CAAC,CAAC;YAC9E,MAAM,GAAG,EAAE,CAAC;QAChB,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,MAAM,OAAO,GAAI,MAAM,CAAC,UAAU,CAA6B,IAAI,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC;IACjC,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAE7B,aAAa;IACb,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAkB;IACjD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,CAAC,oBAAoB;IACtC,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,KAAK,CAAC,uBAAuB,UAAU,uBAAuB,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAwC,CAAC;IAC1E,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,CAAC,6BAA6B;IAC/C,CAAC;IAED,6BAA6B;IAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvB,iDAAiD;IACjD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa;IACb,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAkB,EAAE,UAAkB;IACvE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAEhC,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC,CAAC,0BAA0B;IAC5C,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,mBAAmB;IACrC,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACD,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,KAAK,CAAC,sBAAsB,SAAS,4BAA4B,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YAC7B,cAAc,GAAG,IAAI,CAAC;YACtB,aAAa,GAAG,IAAI,CAAC;YACrB,SAAS,CAAC,iBAAiB;QAC/B,CAAC;QAED,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;YAC3B,cAAc,GAAG,KAAK,CAAC;YACvB,SAAS,CAAC,iBAAiB;QAC/B,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC,CAAC,wBAAwB;IAC1C,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Agent registry — maps agent IDs to their config file paths and formats.
+ */
+export interface AgentConfig {
+    name: string;
+    agentId: string;
+    /** Absolute path to the agent's MCP config file */
+    configPath: string;
+    /** The top-level key that holds MCP server entries (e.g. "mcpServers") */
+    wrapperKey: string;
+    /** Filename for the agent's rules file (e.g. ".cursorrules", "CLAUDE.md"). null if the agent has no rules file. */
+    rulesFileName: string | null;
+}
+export declare const AGENTS: Record<string, AgentConfig>;
+/**
+ * Look up an agent by its --agent flag value.
+ * Returns undefined if the agent ID is not recognised.
+ */
+export declare function getAgent(agentId: string): AgentConfig | undefined;
+/**
+ * List all supported agent IDs (for help text / error messages).
+ */
+export declare function listAgentIds(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mHAAmH;IACnH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAID,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA2C9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/agents/index.js

@@ -0,0 +1,64 @@
+/**
+ * Agent registry — maps agent IDs to their config file paths and formats.
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+const home = homedir();
+export const AGENTS = {
+    cursor: {
+        name: 'Cursor',
+        agentId: 'cursor',
+        configPath: join(home, '.cursor', 'mcp.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: '.cursorrules',
+    },
+    'claude-desktop': {
+        name: 'Claude Desktop',
+        agentId: 'claude-desktop',
+        configPath: join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: null,
+    },
+    'claude-code': {
+        name: 'Claude Code',
+        agentId: 'claude-code',
+        configPath: join(home, '.claude.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: 'CLAUDE.md',
+    },
+    windsurf: {
+        name: 'Windsurf',
+        agentId: 'windsurf',
+        configPath: join(home, '.windsurf', 'mcp.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: '.windsurfrules',
+    },
+    antigravity: {
+        name: 'Antigravity',
+        agentId: 'antigravity',
+        configPath: join(home, '.antigravity', 'mcp.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: '.antigravityrules',
+    },
+    codex: {
+        name: 'Codex (ChatGPT)',
+        agentId: 'codex',
+        configPath: join(home, '.codex', 'mcp.json'),
+        wrapperKey: 'mcpServers',
+        rulesFileName: '.codexrules',
+    },
+};
+/**
+ * Look up an agent by its --agent flag value.
+ * Returns undefined if the agent ID is not recognised.
+ */
+export function getAgent(agentId) {
+    return AGENTS[agentId];
+}
+/**
+ * List all supported agent IDs (for help text / error messages).
+ */
+export function listAgentIds() {
+    return Object.keys(AGENTS);
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAa5B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,MAAM,GAAgC;IAC/C,MAAM,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;QACjB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC;QAC7C,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,cAAc;KAChC;IACD,gBAAgB,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC;QAChG,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,IAAI;KACtB;IACD,aAAa,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QACtC,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,WAAW;KAC7B;IACD,QAAQ,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC;QAC/C,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,gBAAgB;KAClC;IACD,WAAW,EAAE;QACT,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,CAAC;QAClD,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,mBAAmB;KACrC;IACD,KAAK,EAAE;QACH,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC5C,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,aAAa;KAC/B;CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI commands — setup and uninstall.
+ * These are run by the user directly via npx.
+ */
+export declare function runSetup(args: string[]): Promise<void>;
+export declare function runUninstall(args: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B5D;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsChE"}

package/dist/cli.js

@@ -0,0 +1,74 @@
+/**
+ * CLI commands — setup and uninstall.
+ * These are run by the user directly via npx.
+ */
+import { getAgent, listAgentIds } from './agents/index.js';
+import { writeConfig, removeConfig, cleanRulesFile } from './agents/config-writer.js';
+export async function runSetup(args) {
+    const agentId = getArgValue(args, '--agent');
+    if (!agentId) {
+        console.error('Usage: npx taco-helper setup --agent <agent_id>');
+        console.error(`\nSupported agents: ${listAgentIds().join(', ')}`);
+        process.exit(1);
+    }
+    const agent = getAgent(agentId);
+    if (!agent) {
+        console.error(`❌ Unknown agent: "${agentId}"`);
+        console.error(`Supported agents: ${listAgentIds().join(', ')}`);
+        process.exit(1);
+    }
+    console.log(`\n🌮 Setting up Taco for ${agent.name}...\n`);
+    try {
+        await writeConfig(agent);
+        console.log(`✅ Taco has been added to ${agent.name}'s MCP config.`);
+        console.log(`   Config file: ${agent.configPath}`);
+        console.log(`\n👉 Restart ${agent.name} to activate the connection.\n`);
+    }
+    catch (err) {
+        console.error(`❌ Failed to write config:`, err);
+        process.exit(1);
+    }
+}
+export async function runUninstall(args) {
+    const agentId = getArgValue(args, '--agent');
+    if (!agentId) {
+        console.error('Usage: npx taco-helper uninstall --agent <agent_id>');
+        console.error(`\nSupported agents: ${listAgentIds().join(', ')}`);
+        process.exit(1);
+    }
+    const agent = getAgent(agentId);
+    if (!agent) {
+        console.error(`❌ Unknown agent: "${agentId}"`);
+        console.error(`Supported agents: ${listAgentIds().join(', ')}`);
+        process.exit(1);
+    }
+    console.log(`\n🌮 Removing Taco from ${agent.name}...\n`);
+    try {
+        const removed = await removeConfig(agent);
+        if (removed) {
+            console.log(`✅ Taco has been removed from ${agent.name}'s MCP config.`);
+            console.log(`   Config file: ${agent.configPath}`);
+        }
+        else {
+            console.log(`ℹ️  No Taco entry found in ${agent.name}'s config. Nothing to remove.`);
+        }
+        // Clean taco-specific lines from the agent's rules file
+        const rulesCleaned = await cleanRulesFile(agent, process.cwd());
+        if (rulesCleaned) {
+            console.log(`✅ Taco lines cleaned from ${agent.rulesFileName}.`);
+        }
+        console.log(`\n👉 Restart ${agent.name} to complete the disconnection.\n`);
+    }
+    catch (err) {
+        console.error(`❌ Failed to remove config:`, err);
+        process.exit(1);
+    }
+}
+/** Extract a --flag value from an args array. */
+function getArgValue(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/comment-store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * In-memory comment store — shared between the MCP server and HTTP server.
+ *
+ * Comments live only in memory. When the agent restarts, the store is fresh
+ * and the Chrome extension re-pushes comments on connect.
+ */
+import { EventEmitter } from 'events';
+export interface TacoComment {
+    id: string;
+    text: string;
+    selector: string;
+    pageUrl: string;
+    screenshot?: string;
+    timestamp: string;
+    resolved: boolean;
+    elementName?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class CommentStore extends EventEmitter {
+    private comments;
+    /**
+     * Add one or more comments to the store.
+     * If a comment with the same ID already exists, it is overwritten.
+     * Returns the number of comments added.
+     */
+    addComments(comments: TacoComment[]): number;
+    /**
+     * Get all comments. By default, only returns unresolved comments.
+     * Pass `true` to include resolved ones.
+     */
+    getComments(includeResolved?: boolean): TacoComment[];
+    /**
+     * Mark a comment as resolved by ID.
+     * Returns true if the comment was found and updated, false otherwise.
+     */
+    markResolved(id: string): boolean;
+    /** Remove all comments from the store. */
+    clear(): void;
+    /** Get the total number of comments in the store. */
+    get size(): number;
+}
+//# sourceMappingURL=comment-store.d.ts.map

package/dist/comment-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-store.d.ts","sourceRoot":"","sources":["../src/comment-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAQ5C;;;OAGG;IACH,WAAW,CAAC,eAAe,UAAQ,GAAG,WAAW,EAAE;IAMnD;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQjC,0CAA0C;IAC1C,KAAK,IAAI,IAAI;IAIb,qDAAqD;IACrD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/comment-store.js

@@ -0,0 +1,53 @@
+/**
+ * In-memory comment store — shared between the MCP server and HTTP server.
+ *
+ * Comments live only in memory. When the agent restarts, the store is fresh
+ * and the Chrome extension re-pushes comments on connect.
+ */
+import { EventEmitter } from 'events';
+export class CommentStore extends EventEmitter {
+    comments = new Map();
+    /**
+     * Add one or more comments to the store.
+     * If a comment with the same ID already exists, it is overwritten.
+     * Returns the number of comments added.
+     */
+    addComments(comments) {
+        for (const comment of comments) {
+            this.comments.set(comment.id, comment);
+            this.emit('comment-received', { id: comment.id });
+        }
+        return comments.length;
+    }
+    /**
+     * Get all comments. By default, only returns unresolved comments.
+     * Pass `true` to include resolved ones.
+     */
+    getComments(includeResolved = false) {
+        const all = Array.from(this.comments.values());
+        if (includeResolved)
+            return all;
+        return all.filter((c) => !c.resolved);
+    }
+    /**
+     * Mark a comment as resolved by ID.
+     * Returns true if the comment was found and updated, false otherwise.
+     */
+    markResolved(id) {
+        const comment = this.comments.get(id);
+        if (!comment)
+            return false;
+        comment.resolved = true;
+        this.emit('comment-resolved', { id });
+        return true;
+    }
+    /** Remove all comments from the store. */
+    clear() {
+        this.comments.clear();
+    }
+    /** Get the total number of comments in the store. */
+    get size() {
+        return this.comments.size;
+    }
+}
+//# sourceMappingURL=comment-store.js.map

package/dist/comment-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-store.js","sourceRoot":"","sources":["../src/comment-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AActC,MAAM,OAAO,YAAa,SAAQ,YAAY;IAClC,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,QAAuB;QAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,eAAe,GAAG,KAAK;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,IAAI,eAAe;YAAE,OAAO,GAAG,CAAC;QAChC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,EAAU;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,KAAK;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,qDAAqD;IACrD,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;CACJ"}

package/dist/http-server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP server — listens on localhost:7867.
+ * The Taco Chrome extension pushes comments here via fetch().
+ */
+import { IncomingMessage, ServerResponse } from 'http';
+import { CommentStore } from './comment-store.js';
+/**
+ * Start the HTTP server on localhost:7867.
+ * Returns a reference to the server so it can be closed in tests.
+ */
+export declare function startHttpServer(store: CommentStore): import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAoD/D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,wEA+JlD"}

package/dist/http-server.js

@@ -0,0 +1,199 @@
+/**
+ * HTTP server — listens on localhost:7867.
+ * The Taco Chrome extension pushes comments here via fetch().
+ */
+import { createServer } from 'http';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { getAgent } from './agents/index.js';
+import { removeConfig, cleanRulesFile } from './agents/config-writer.js';
+const PORT = 7867;
+/** Active SSE connections */
+const sseClients = new Set();
+/** Read the full request body as a string. */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+/** Send a JSON response. */
+function json(res, status, data) {
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type',
+    });
+    res.end(JSON.stringify(data));
+}
+/** Set CORS headers and handle preflight. Returns true if this was a preflight request. */
+function handleCors(req, res) {
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204, {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+            'Access-Control-Allow-Headers': 'Content-Type',
+        });
+        res.end();
+        return true;
+    }
+    return false;
+}
+/** Broadcast an SSE event to all connected clients. */
+function broadcastSSE(event, data) {
+    const message = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+    for (const client of sseClients) {
+        client.write(message);
+    }
+}
+/**
+ * Start the HTTP server on localhost:7867.
+ * Returns a reference to the server so it can be closed in tests.
+ */
+export function startHttpServer(store) {
+    // Wire store events to SSE broadcasts
+    store.on('comment-resolved', (payload) => {
+        console.error(`🌮 [SSE] Broadcasting comment-resolved: ${payload.id}`);
+        broadcastSSE('comment-resolved', payload);
+    });
+    store.on('comment-received', (payload) => {
+        broadcastSSE('comment-received', payload);
+    });
+    const server = createServer(async (req, res) => {
+        // Handle CORS preflight
+        if (handleCors(req, res))
+            return;
+        const url = req.url ?? '/';
+        const method = req.method ?? 'GET';
+        try {
+            // GET /health
+            if (url === '/health' && method === 'GET') {
+                // Try to read project name from package.json in working directory
+                let projectName = null;
+                try {
+                    const pkgPath = join(process.cwd(), 'package.json');
+                    const pkgContent = await readFile(pkgPath, 'utf-8');
+                    const pkg = JSON.parse(pkgContent);
+                    projectName = pkg.name || null;
+                }
+                catch {
+                    // package.json not found or unreadable — that's okay
+                }
+                json(res, 200, { status: 'ok', projectName });
+                return;
+            }
+            // GET /events — Server-Sent Events stream
+            if (url === '/events' && method === 'GET') {
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    'Connection': 'keep-alive',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                // Send initial connected event
+                res.write(`event: connected\ndata: {}\n\n`);
+                // Add to active clients
+                sseClients.add(res);
+                console.error(`🌮 [SSE] Client connected (${sseClients.size} active)`);
+                // Remove on disconnect
+                req.on('close', () => {
+                    sseClients.delete(res);
+                    console.error(`🌮 [SSE] Client disconnected (${sseClients.size} active)`);
+                });
+                // Keep connection alive with periodic heartbeat
+                const heartbeat = setInterval(() => {
+                    res.write(`: heartbeat\n\n`);
+                }, 30_000);
+                req.on('close', () => clearInterval(heartbeat));
+                return;
+            }
+            // GET /comments — retrieve current comments
+            // Supports ?include_resolved=true to include resolved comments
+            const parsedUrl = new URL(url, 'http://localhost');
+            if (parsedUrl.pathname === '/comments' && method === 'GET') {
+                const includeResolved = parsedUrl.searchParams.get('include_resolved') === 'true';
+                const comments = store.getComments(includeResolved);
+                json(res, 200, comments);
+                return;
+            }
+            // POST /comments — push new comments from the extension
+            if (url === '/comments' && method === 'POST') {
+                const body = await readBody(req);
+                const comments = JSON.parse(body);
+                const count = store.addComments(comments);
+                json(res, 200, { received: count });
+                return;
+            }
+            // POST /comments/:id/resolve — mark a comment as resolved
+            const resolveMatch = url.match(/^\/comments\/([^/]+)\/resolve$/);
+            if (resolveMatch && method === 'POST') {
+                const id = decodeURIComponent(resolveMatch[1]);
+                const success = store.markResolved(id);
+                if (success) {
+                    json(res, 200, { success: true });
+                }
+                else {
+                    json(res, 404, { error: 'Comment not found' });
+                }
+                return;
+            }
+            // POST /uninstall — self-uninstall: remove MCP config + clean rules file, then shut down
+            if (url === '/uninstall' && method === 'POST') {
+                const body = await readBody(req);
+                const { agent_id } = JSON.parse(body);
+                const agent = getAgent(agent_id);
+                if (!agent) {
+                    json(res, 400, { error: `Unknown agent: "${agent_id}"` });
+                    return;
+                }
+                console.error(`🌮 Uninstalling Taco from ${agent.name}...`);
+                const removed = [];
+                try {
+                    const configRemoved = await removeConfig(agent);
+                    if (configRemoved)
+                        removed.push('mcp_config');
+                }
+                catch (err) {
+                    console.error(`⚠️  Failed to remove MCP config:`, err);
+                }
+                try {
+                    const rulesRemoved = await cleanRulesFile(agent, process.cwd());
+                    if (rulesRemoved)
+                        removed.push('rules_file');
+                }
+                catch (err) {
+                    console.error(`⚠️  Failed to clean rules file:`, err);
+                }
+                json(res, 200, { success: true, removed });
+                // Shut down after a brief delay to allow the response to flush
+                setTimeout(() => {
+                    console.error('🌮 Taco Helper shutting down after uninstall.');
+                    process.exit(0);
+                }, 100);
+                return;
+            }
+            // 404 for anything else
+            json(res, 404, { error: 'Not found' });
+        }
+        catch (err) {
+            console.error('HTTP error:', err);
+            json(res, 500, { error: 'Internal server error' });
+        }
+    });
+    server.listen(PORT, '127.0.0.1', () => {
+        // Log to stderr — stdout is reserved for MCP
+        console.error(`🌮 Taco Helper HTTP server listening on http://127.0.0.1:${PORT}`);
+    });
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            console.error(`❌ Port ${PORT} is already in use. Is another instance of taco-helper running?`);
+            process.exit(1);
+        }
+        throw err;
+    });
+    return server;
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * taco-helper — entry point.
+ *
+ * This file detects how the package was invoked:
+ *
+ *   CLI mode (user runs manually):
+ *     npx taco-helper setup --agent cursor
+ *     npx taco-helper uninstall --agent cursor
+ *
+ *   Server mode (agent launches automatically):
+ *     npx taco-helper
+ *     → starts MCP server on stdio + HTTP server on :7867
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * taco-helper — entry point.
+ *
+ * This file detects how the package was invoked:
+ *
+ *   CLI mode (user runs manually):
+ *     npx taco-helper setup --agent cursor
+ *     npx taco-helper uninstall --agent cursor
+ *
+ *   Server mode (agent launches automatically):
+ *     npx taco-helper
+ *     → starts MCP server on stdio + HTTP server on :7867
+ */
+import { runSetup, runUninstall } from './cli.js';
+import { CommentStore } from './comment-store.js';
+import { startHttpServer } from './http-server.js';
+import { startMcpServer } from './mcp-server.js';
+const command = process.argv[2];
+if (command === 'setup') {
+    // CLI mode: write MCP config and exit
+    await runSetup(process.argv.slice(2));
+}
+else if (command === 'uninstall') {
+    // CLI mode: remove MCP config and exit
+    await runUninstall(process.argv.slice(2));
+}
+else {
+    // Server mode: start both servers
+    const store = new CommentStore();
+    // Start the HTTP server (for the Chrome extension)
+    startHttpServer(store);
+    // Start the MCP server on stdio (for the agent)
+    await startMcpServer(store);
+    console.error('🌮 Taco Helper is running. Press Ctrl+C to stop.');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACtB,sCAAsC;IACtC,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC;KAAM,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;IACjC,uCAAuC;IACvC,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;KAAM,CAAC;IACJ,kCAAkC;IAClC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IAEjC,mDAAmD;IACnD,eAAe,CAAC,KAAK,CAAC,CAAC;IAEvB,gDAAgD;IAChD,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAE5B,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP server — speaks MCP protocol over stdio.
+ * Exposes tools for AI agents to query and manage comments.
+ * Supports sampling to autonomously trigger implementation when comments arrive.
+ */
+import { CommentStore } from './comment-store.js';
+/**
+ * Create and start the MCP server on stdio.
+ * The agent communicates with this server via stdin/stdout.
+ */
+export declare function startMcpServer(store: CommentStore): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAE/D;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4FvE"}

package/dist/mcp-server.js

@@ -0,0 +1,140 @@
+/**
+ * MCP server — speaks MCP protocol over stdio.
+ * Exposes tools for AI agents to query and manage comments.
+ * Supports sampling to autonomously trigger implementation when comments arrive.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+/**
+ * Create and start the MCP server on stdio.
+ * The agent communicates with this server via stdin/stdout.
+ */
+export async function startMcpServer(store) {
+    const server = new McpServer({
+        name: 'taco-helper',
+        version: '0.1.0',
+    });
+    // Tool: get_comments — retrieve all pending (unresolved) comments
+    server.tool('get_comments', 'Retrieve all pending (unresolved) comments left by the user in the Taco Chrome extension. Each comment includes the text, CSS selector of the annotated element, page URL, and optionally a screenshot.', {}, async () => {
+        const comments = store.getComments(false);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: comments.length === 0
+                        ? 'No pending comments.'
+                        : JSON.stringify(comments, null, 2),
+                },
+            ],
+        };
+    });
+    // Tool: get_all_comments — retrieve all comments including resolved
+    server.tool('get_all_comments', 'Retrieve all comments including resolved ones. Use this to see the full history of comments.', {
+        include_resolved: z.boolean().optional().describe('Whether to include resolved comments (default: true)'),
+    }, async ({ include_resolved }) => {
+        const comments = store.getComments(include_resolved ?? true);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: comments.length === 0
+                        ? 'No comments found.'
+                        : JSON.stringify(comments, null, 2),
+                },
+            ],
+        };
+    });
+    // Tool: mark_resolved — mark a comment as resolved
+    server.tool('mark_resolved', 'Mark a comment as resolved by its ID. Use this after you have addressed a comment.', {
+        id: z.string().describe('The ID of the comment to mark as resolved'),
+    }, async ({ id }) => {
+        const success = store.markResolved(id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: success
+                        ? `Comment ${id} marked as resolved.`
+                        : `Comment ${id} not found.`,
+                },
+            ],
+        };
+    });
+    // Connect to stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('🌮 Taco Helper MCP server running on stdio');
+    // --- Sampling: auto-trigger agent when new comments arrive ---
+    // After connection, listen for new comments and request the agent to implement them.
+    // This only works if the connected agent supports the sampling capability.
+    store.on('comment-received', async () => {
+        // Debounce: wait briefly for batch of comments to arrive
+        // (the extension sends multiple comments in one POST, which triggers
+        //  multiple 'comment-received' events — we only want one sampling request)
+        if (samplingDebounceTimer)
+            clearTimeout(samplingDebounceTimer);
+        samplingDebounceTimer = setTimeout(() => {
+            requestAgentImplementation(server, store).catch((err) => {
+                console.error('🌮 [Sampling] Error requesting agent implementation:', err.message ?? err);
+            });
+        }, 1000);
+    });
+    console.error('🌮 Taco Helper sampling listener registered');
+}
+let samplingDebounceTimer = null;
+/**
+ * Request the connected agent to implement pending comments via MCP sampling.
+ * If the agent doesn't support sampling, this silently does nothing.
+ */
+async function requestAgentImplementation(mcpServer, store) {
+    const comments = store.getComments(false); // unresolved only
+    if (comments.length === 0)
+        return;
+    const commentSummary = comments.map((c, i) => {
+        let desc = `${i + 1}. [${c.id}] "${c.text}"`;
+        if (c.elementName)
+            desc += ` (element: ${c.elementName})`;
+        if (c.selector)
+            desc += ` [selector: ${c.selector}]`;
+        if (c.pageUrl)
+            desc += ` on ${c.pageUrl}`;
+        return desc;
+    }).join('\n');
+    const prompt = `You have received ${comments.length} new UI feedback comment(s) from the Taco Chrome extension. Please implement each requested change:
+
+${commentSummary}
+
+For each comment:
+1. Understand the requested change
+2. Implement it in the codebase
+3. Call the mark_resolved tool with the comment ID after implementing
+
+Begin implementing now.`;
+    try {
+        console.error(`🌮 [Sampling] Requesting agent to implement ${comments.length} comment(s)...`);
+        await mcpServer.server.createMessage({
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: prompt,
+                    },
+                },
+            ],
+            maxTokens: 4096,
+        });
+        console.error('🌮 [Sampling] Agent acknowledged the request');
+    }
+    catch (err) {
+        // Expected failure if agent doesn't support sampling — not an error
+        if (err?.code === -32601 || err?.message?.includes('not supported') || err?.message?.includes('Method not found')) {
+            console.error('🌮 [Sampling] Agent does not support sampling — user must prompt manually');
+        }
+        else {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@bbyqtbean/taco-helper",
+    "version": "0.1.0",
+    "description": "MCP server + CLI for connecting the Taco Chrome extension to AI agents",
+    "type": "module",
+    "main": "./dist/index.js",
+    "bin": {
+        "taco-helper": "./dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "taco",
+        "chrome-extension",
+        "ai-agent"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.26.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "typescript": "^5.3.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "dist"
+    ]
+}