prompt-clarifier-mcp 2.0.0

package/README.md

@@ -0,0 +1,182 @@
+# Prompt Clarifier — MCP Agent
+
+> Arrête le ping-pong avec ton LLM. Cet agent te pose les bonnes questions avant d'exécuter ta demande.
+
+## Comment ça marche
+
+```
+Tu écris : "Crée un modèle ONNX sans opset"
+                    ↓
+Prompt Clarifier pose des questions ciblées
+                    ↓
+Tu réponds (ou tu écris "go" pour arrêter)
+                    ↓
+Un prompt enrichi et précis est généré
+                    ↓
+Ton LLM produit exactement ce que tu voulais — du premier coup
+```
+
+---
+
+## Installation
+
+### Prérequis — Clé API Anthropic
+
+Cet agent utilise Claude Haiku pour générer ses questions. Tu as besoin d'une clé API Anthropic :
+- Crée-en une sur [console.anthropic.com](https://console.anthropic.com)
+- Ajoute-la dans la config MCP de ton outil (voir exemples ci-dessous)
+
+---
+
+### Cursor
+
+Ouvre `~/.cursor/mcp.json` (crée-le s'il n'existe pas) :
+
+```json
+{
+  "mcpServers": {
+    "prompt-clarifier": {
+      "command": "npx",
+      "args": ["-y", "prompt-clarifier-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+Redémarre Cursor. L'outil `clarify` est maintenant disponible.
+
+---
+
+### Claude Desktop
+
+Ouvre le fichier de config :
+- **Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "prompt-clarifier": {
+      "command": "npx",
+      "args": ["-y", "prompt-clarifier-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+Redémarre Claude Desktop.
+
+---
+
+### VS Code (avec GitHub Copilot ou Continue)
+
+Crée ou ouvre `.vscode/mcp.json` à la racine de ton projet :
+
+```json
+{
+  "servers": {
+    "prompt-clarifier": {
+      "command": "npx",
+      "args": ["-y", "prompt-clarifier-mcp"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+---
+
+### IntelliJ IDEA / PyCharm (version 2025.1+)
+
+1. Ouvre `Settings` → `Tools` → `AI Assistant` → `Model Context Protocol (MCP)`
+2. Clique sur `+` pour ajouter un nouveau serveur
+3. Choisis **"Command"** comme type
+4. Remplis :
+   - **Name** : `prompt-clarifier`
+   - **Command** : `npx`
+   - **Arguments** : `-y prompt-clarifier-mcp`
+   - **Environment variables** : `ANTHROPIC_API_KEY=sk-ant-...`
+5. Clique `OK` et redémarre l'IDE
+
+> ⚠️ Requiert IntelliJ IDEA / PyCharm 2025.1 ou supérieur avec AI Assistant activé.
+> Active le mode **"Codebase"** dans le chat AI Assistant pour que les outils MCP soient disponibles.
+
+---
+
+### Claude Code
+
+```bash
+claude mcp add prompt-clarifier npx -- -y prompt-clarifier-mcp
+```
+
+Puis ajoute la clé API dans ton environnement ou dans `.claude/settings.json` :
+```json
+{
+  "env": {
+    "ANTHROPIC_API_KEY": "sk-ant-..."
+  }
+}
+```
+
+---
+
+## Utilisation
+
+Dans n'importe quel chat de ton IDE, appelle l'outil `clarify` avec ton prompt :
+
+**Exemple :**
+```
+Utilise l'outil clarify avec ce prompt : "Crée un modèle ONNX sans opset"
+```
+
+L'agent va :
+1. Détecter le domaine (ML/ONNX dans cet exemple)
+2. Te poser des questions ciblées une par une
+3. Générer un prompt enrichi quand tu as répondu (ou quand tu écris **"go"**)
+
+**Pour arrêter les questions à tout moment**, écris simplement :
+- `go` / `commence` / `lance-toi` / `c'est bon` / `assez` / `proceed`
+
+---
+
+## Prérequis
+
+- Node.js 18 ou supérieur
+- Un IDE avec support MCP (voir liste ci-dessus)
+
+---
+
+## Développement local
+
+```bash
+git clone https://github.com/dmi-agentix/prompt-clarifier
+cd prompt-clarifier
+npm install
+npm run build
+
+# Tester avec l'inspecteur MCP
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+---
+
+## Contribuer
+
+Les contributions sont les bienvenues ! En particulier :
+- Nouvelles banques de questions par domaine (`src/clarifier.ts`)
+- Nouveaux mots-clés "stop" dans d'autres langues
+- Amélioration de la détection de domaine
+
+---
+
+## Licence
+
+MIT — DMI Agentix

package/dist/clarifier.d.ts

@@ -0,0 +1,5 @@
+import { QA } from "./session.js";
+export declare function isGoSignal(text: string): boolean;
+export declare function getNextQuestion(initialPrompt: string, qaHistory: QA[]): Promise<string | null>;
+export declare function buildEnrichedPrompt(initialPrompt: string, qaHistory: QA[]): string;
+//# sourceMappingURL=clarifier.d.ts.map

package/dist/clarifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarifier.d.ts","sourceRoot":"","sources":["../src/clarifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAOlC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhD;AAaD,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,EAAE,EAAE,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,MAAM,CAelF"}

package/dist/clarifier.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGoSignal = isGoSignal;
+exports.getNextQuestion = getNextQuestion;
+exports.buildEnrichedPrompt = buildEnrichedPrompt;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const GO_KEYWORDS = [
+    "go", "commence", "start", "c'est bon", "lance toi", "lance-toi",
+    "démarre", "ok go", "assez", "enough", "proceed", "just do it",
+];
+function isGoSignal(text) {
+    const normalized = text.toLowerCase().trim();
+    return GO_KEYWORDS.some((kw) => normalized === kw ||
+        normalized.startsWith(kw + " ") ||
+        normalized.endsWith(" " + kw));
+}
+const client = new sdk_1.default();
+const SYSTEM_PROMPT = `Tu es un agent expert en amélioration de prompts. Ton rôle est d'analyser un prompt utilisateur et l'historique des questions/réponses déjà échangées, puis de décider de la prochaine action.
+
+Règles strictes :
+1. Si des précisions importantes manquent encore pour bien exécuter la demande, pose UNE SEULE question — la plus pertinente selon le domaine et le contexte réel du prompt.
+2. Si tu as suffisamment d'informations pour que le LLM puisse répondre précisément (ou après 5 questions maximum), réponds uniquement avec le mot : DONE
+3. La question doit être concrète et adaptée au domaine détecté automatiquement (code, data science, design, rédaction, business, DevOps, etc.)
+4. Ne pose jamais une question générique si le contexte est déjà clair. Chaque question doit débloquer une information réellement utile.
+5. Réponds UNIQUEMENT avec la question ou le mot DONE — aucune explication, aucun préambule, aucune ponctuation superflue.`;
+async function getNextQuestion(initialPrompt, qaHistory) {
+    if (qaHistory.length >= 5)
+        return null;
+    const historyText = qaHistory.length > 0
+        ? qaHistory
+            .map((qa, i) => `Q${i + 1}: ${qa.question}\nR${i + 1}: ${qa.answer}`)
+            .join("\n\n")
+        : "Aucune question posée pour l'instant.";
+    const userMessage = `Prompt initial de l'utilisateur :
+"${initialPrompt}"
+
+Historique des questions/réponses :
+${historyText}
+
+Quelle est la prochaine question à poser, ou dois-tu répondre DONE ?`;
+    const response = await client.messages.create({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 200,
+        system: SYSTEM_PROMPT,
+        messages: [{ role: "user", content: userMessage }],
+    });
+    const text = response.content[0].type === "text"
+        ? response.content[0].text.trim()
+        : "";
+    if (text.toUpperCase() === "DONE" || text === "")
+        return null;
+    return text;
+}
+function buildEnrichedPrompt(initialPrompt, qaHistory) {
+    if (qaHistory.length === 0)
+        return initialPrompt;
+    const context = qaHistory
+        .map((qa) => `- ${qa.question}\n  → ${qa.answer}`)
+        .join("\n");
+    return `${initialPrompt}
+
+## Contexte additionnel recueilli
+
+${context}
+
+---
+Prends en compte tout ce contexte pour répondre de façon précise et complète.`;
+}
+//# sourceMappingURL=clarifier.js.map

package/dist/clarifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarifier.js","sourceRoot":"","sources":["../src/clarifier.ts"],"names":[],"mappings":";;;;;AAQA,gCAQC;AAaD,0CAmCC;AAED,kDAeC;AAjFD,4DAA0C;AAG1C,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW;IAChE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY;CAC/D,CAAC;AAEF,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,WAAW,CAAC,IAAI,CACrB,CAAC,EAAE,EAAE,EAAE,CACL,UAAU,KAAK,EAAE;QACjB,UAAU,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,CAAC;QAC/B,UAAU,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,aAAS,EAAE,CAAC;AAE/B,MAAM,aAAa,GAAG;;;;;;;2HAOqG,CAAC;AAErH,KAAK,UAAU,eAAe,CACnC,aAAqB,EACrB,SAAe;IAEf,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,WAAW,GACf,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,SAAS;aACN,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,QAAQ,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC;aACpE,IAAI,CAAC,MAAM,CAAC;QACjB,CAAC,CAAC,uCAAuC,CAAC;IAE9C,MAAM,WAAW,GAAG;GACnB,aAAa;;;EAGd,WAAW;;qEAEwD,CAAC;IAEpE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,2BAA2B;QAClC,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,MAAM,IAAI,GACR,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;QACjC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;QACjC,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,mBAAmB,CAAC,aAAqB,EAAE,SAAe;IACxE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IAEjD,MAAM,OAAO,GAAG,SAAS;SACtB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,GAAG,aAAa;;;;EAIvB,OAAO;;;8EAGqE,CAAC;AAC/E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const session_js_1 = require("./session.js");
+const clarifier_js_1 = require("./clarifier.js");
+const server = new index_js_1.Server({ name: "prompt-clarifier", version: "2.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "clarify",
+            description: "Affine un prompt utilisateur en posant des questions ciblées une par une, puis génère un prompt enrichi prêt à être exécuté par le LLM.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    prompt: {
+                        type: "string",
+                        description: "Le prompt initial de l'utilisateur (requis au premier appel).",
+                    },
+                    session_id: {
+                        type: "string",
+                        description: "ID de session retourné par un appel précédent (pour continuer la conversation).",
+                    },
+                    answer: {
+                        type: "string",
+                        description: "Réponse de l'utilisateur à la dernière question posée par l'agent.",
+                    },
+                },
+                required: [],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    if (request.params.name !== "clarify") {
+        return { content: [{ type: "text", text: `Outil inconnu : ${request.params.name}` }] };
+    }
+    const args = request.params.arguments;
+    // --- New session ---
+    if (!args.session_id) {
+        if (!args.prompt) {
+            return {
+                content: [{ type: "text", text: "Erreur : `prompt` est requis pour démarrer une session." }],
+            };
+        }
+        const session = (0, session_js_1.createSession)(args.prompt);
+        const firstQuestion = await (0, clarifier_js_1.getNextQuestion)(session.initialPrompt, []);
+        if (!firstQuestion) {
+            (0, session_js_1.deleteSession)(session.id);
+            return {
+                content: [{ type: "text", text: (0, clarifier_js_1.buildEnrichedPrompt)(session.initialPrompt, []) }],
+            };
+        }
+        (0, session_js_1.saveSession)(session);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        session_id: session.id,
+                        question: firstQuestion,
+                        instructions: "Réponds à cette question, puis rappelle l'outil clarify avec session_id et answer. Dis 'go' pour générer immédiatement le prompt final.",
+                    }),
+                },
+            ],
+        };
+    }
+    // --- Continue existing session ---
+    const session = (0, session_js_1.loadSession)(args.session_id);
+    if (!session) {
+        return {
+            content: [{ type: "text", text: `Session introuvable : ${args.session_id}` }],
+        };
+    }
+    const answer = args.answer ?? "";
+    // User said "go" → generate final prompt now
+    if ((0, clarifier_js_1.isGoSignal)(answer)) {
+        const enriched = (0, clarifier_js_1.buildEnrichedPrompt)(session.initialPrompt, session.qaHistory);
+        (0, session_js_1.deleteSession)(session.id);
+        return { content: [{ type: "text", text: enriched }] };
+    }
+    // Record the answer to the last question asked
+    if (session.lastQuestion && answer.trim()) {
+        session.qaHistory.push({ question: session.lastQuestion, answer });
+    }
+    // Ask Claude for the next question
+    const nextQuestion = await (0, clarifier_js_1.getNextQuestion)(session.initialPrompt, session.qaHistory);
+    if (!nextQuestion) {
+        const enriched = (0, clarifier_js_1.buildEnrichedPrompt)(session.initialPrompt, session.qaHistory);
+        (0, session_js_1.deleteSession)(session.id);
+        return { content: [{ type: "text", text: enriched }] };
+    }
+    session.lastQuestion = nextQuestion;
+    (0, session_js_1.saveSession)(session);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    session_id: session.id,
+                    question: nextQuestion,
+                    qa_so_far: session.qaHistory.length,
+                    instructions: "Réponds à cette question, puis rappelle l'outil clarify avec session_id et answer. Dis 'go' pour générer immédiatement le prompt final.",
+                }),
+            },
+        ],
+    };
+});
+async function main() {
+    if (!process.env.ANTHROPIC_API_KEY) {
+        process.stderr.write("Erreur : ANTHROPIC_API_KEY non définie.\n");
+        process.exit(1);
+    }
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("Prompt Clarifier MCP server v2.0 started (stdio)\n");
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,17 @@
+export interface QA {
+    question: string;
+    answer: string;
+}
+export interface Session {
+    id: string;
+    initialPrompt: string;
+    qaHistory: QA[];
+    lastQuestion?: string;
+    status: "questioning" | "done";
+    createdAt: number;
+}
+export declare function createSession(initialPrompt: string): Session;
+export declare function loadSession(id: string): Session | null;
+export declare function saveSession(session: Session): void;
+export declare function deleteSession(id: string): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,EAAE;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,EAAE,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAU5D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAItD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG9C"}

package/dist/session.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSession = createSession;
+exports.loadSession = loadSession;
+exports.saveSession = saveSession;
+exports.deleteSession = deleteSession;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+function sessionPath(id) {
+    return path.join(os.tmpdir(), `clarifier-session-${id}.json`);
+}
+function createSession(initialPrompt) {
+    const session = {
+        id: crypto.randomUUID(),
+        initialPrompt,
+        qaHistory: [],
+        status: "questioning",
+        createdAt: Date.now(),
+    };
+    fs.writeFileSync(sessionPath(session.id), JSON.stringify(session, null, 2));
+    return session;
+}
+function loadSession(id) {
+    const p = sessionPath(id);
+    if (!fs.existsSync(p))
+        return null;
+    return JSON.parse(fs.readFileSync(p, "utf8"));
+}
+function saveSession(session) {
+    fs.writeFileSync(sessionPath(session.id), JSON.stringify(session, null, 2));
+}
+function deleteSession(id) {
+    const p = sessionPath(id);
+    if (fs.existsSync(p))
+        fs.unlinkSync(p);
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,sCAUC;AAED,kCAIC;AAED,kCAEC;AAED,sCAGC;AAhDD,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,+CAAiC;AAgBjC,SAAS,WAAW,CAAC,EAAU;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,aAAa,CAAC,aAAqB;IACjD,MAAM,OAAO,GAAY;QACvB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,aAAa;QACb,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,WAAW,CAAC,EAAU;IACpC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC;AAC3D,CAAC;AAED,SAAgB,WAAW,CAAC,OAAgB;IAC1C,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAgB,aAAa,CAAC,EAAU;IACtC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "prompt-clarifier-mcp",
+  "version": "2.0.0",
+  "description": "MCP agent that clarifies user prompts before sending them to any LLM — works in Cursor, VS Code, IntelliJ, PyCharm, Claude Desktop",
+  "main": "dist/index.js",
+  "bin": {
+    "prompt-clarifier-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "prompt",
+    "clarifier",
+    "agent",
+    "llm",
+    "cursor",
+    "vscode",
+    "intellij",
+    "jetbrains"
+  ],
+  "author": "DMI Agentix",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ]
+}