auq-mcp-server 0.1.9 → 0.1.24

package/dist/server.js

@@ -1,107 +0,0 @@
-import { FastMCP } from "fastmcp";
-import { z } from "zod";
-import { SessionManager } from "./session/index.js";
-// import { resolveSessionDirectory } from "./session/utils.js";
-// Initialize session manager
-const sessionManager = new SessionManager();
-const server = new FastMCP({
-    instructions: "This MCP server provides a tool to ask users structured questions via the terminal. " +
-        "The ask_user_questions tool allows AI models to pause and gather direct user input through " +
-        "an interactive TUI, returning formatted responses for continued reasoning.",
-    name: "AskUserQuery",
-    version: "0.1.0",
-});
-// Define the question and option schemas
-const OptionSchema = z.object({
-    description: z
-        .string()
-        .optional()
-        .describe("Optional explanatory note for this option"),
-    label: z.string().describe("The visible text of the choice"),
-});
-const QuestionSchema = z.object({
-    title: z.string().describe("Short 1-2 word summary for UI display"),
-    options: z
-        .array(OptionSchema)
-        .min(1)
-        .describe("Non-empty list of predefined answer choices"),
-    prompt: z.string().describe("The full question text"),
-});
-// Add the ask_user_questions tool
-server.addTool({
-    annotations: {
-        openWorldHint: true, // This tool interacts with the user's terminal
-        readOnlyHint: false, // This tool waits for user input
-        title: "Ask User Questions",
-    },
-    description: "Ask the user one or more structured questions via an interactive terminal interface. " +
-        "Each question includes multiple-choice options and allows custom free-text responses. " +
-        "Returns a formatted summary of all questions and answers.",
-    execute: async (args, { log }) => {
-        try {
-            // Initialize session manager if not already done
-            await sessionManager.initialize();
-            // Clean up old sessions on startup (non-blocking)
-            sessionManager
-                .cleanupExpiredSessions()
-                .then((count) => {
-                if (count > 0) {
-                    log.info(`Cleaned up ${count} expired session(s)`);
-                }
-            })
-                .catch((error) => {
-                log.warn("Cleanup failed:", { error: String(error) });
-            });
-            // Validate questions (using existing Zod schema validation)
-            if (!args.questions || args.questions.length === 0) {
-                throw new Error("At least one question is required");
-            }
-            // Convert Zod-validated questions to our internal Question type
-            const questions = args.questions.map((q) => ({
-                title: q.title,
-                options: q.options.map((opt) => ({
-                    description: opt.description,
-                    label: opt.label,
-                })),
-                prompt: q.prompt,
-            }));
-            log.info("Starting session and waiting for user answers...", {
-                questionCount: questions.length,
-            });
-            // Start complete session lifecycle - this will wait for user answers
-            const { formattedResponse, sessionId } = await sessionManager.startSession(questions);
-            log.info("Session completed successfully", { sessionId });
-            // Return formatted response to AI model
-            return {
-                content: [
-                    {
-                        text: formattedResponse,
-                        type: "text",
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            log.error("Session failed", { error: String(error) });
-            return {
-                content: [
-                    {
-                        text: `Error in session: ${error}`,
-                        type: "text",
-                    },
-                ],
-            };
-        }
-    },
-    name: "ask_user_questions",
-    parameters: z.object({
-        questions: z
-            .array(QuestionSchema)
-            .min(1)
-            .describe("Array of questions to ask the user"),
-    }),
-});
-// Start the server with stdio transport
-server.start({
-    transportType: "stdio",
-});

package/dist/session/ResponseFormatter.js

@@ -1,130 +0,0 @@
-/**
- * Response Formatter
- *
- * Formats user answers according to PRD specification for returning to AI models
- */
-/**
- * ResponseFormatter - Formats session answers into human-readable text
- * according to the PRD specification
- */
-export class ResponseFormatter {
-    /**
-     * Format user answers into PRD-compliant text response
-     *
-     * Format specification:
-     * - Header: "Here are the user's answers:"
-     * - Numbered questions: "1. {prompt}"
-     * - Arrow symbol for answers: "→ {label} — {description}"
-     * - Custom text: "→ Other: '{customText}'"
-     * - Double newline separation between questions
-     *
-     * @param answers - Session answer data containing user responses
-     * @param questions - Original questions asked to the user
-     * @returns Formatted text response ready to send to AI model
-     */
-    static formatUserResponse(answers, questions) {
-        // Validate that we have matching questions and answers
-        if (answers.answers.length === 0) {
-            throw new Error("No answers provided in session");
-        }
-        if (questions.length === 0) {
-            throw new Error("No questions provided");
-        }
-        // Start with header
-        const lines = ["Here are the user's answers:", ""];
-        // Format each question and its answer
-        const formattedQuestions = [];
-        for (let i = 0; i < questions.length; i++) {
-            const question = questions[i];
-            const answer = answers.answers.find((a) => a.questionIndex === i);
-            if (!answer) {
-                // If no answer found for this question, skip it
-                // (This shouldn't happen in normal operation, but handle gracefully)
-                continue;
-            }
-            // Format the question and answer
-            const formattedQA = this.formatQuestion(question, answer, i + 1);
-            formattedQuestions.push(formattedQA);
-        }
-        // Join formatted questions with blank lines between them
-        lines.push(formattedQuestions.join("\n\n"));
-        return lines.join("\n");
-    }
-    /**
-     * Validate that answers match the questions
-     *
-     * @param answers - Session answer data
-     * @param questions - Original questions
-     * @throws Error if validation fails
-     */
-    static validateAnswers(answers, questions) {
-        // Check that we have answers
-        if (!answers || !answers.answers || answers.answers.length === 0) {
-            throw new Error("No answers provided");
-        }
-        // Check that we have questions
-        if (!questions || questions.length === 0) {
-            throw new Error("No questions provided");
-        }
-        // Check each answer references a valid question
-        for (const answer of answers.answers) {
-            if (answer.questionIndex < 0 ||
-                answer.questionIndex >= questions.length) {
-                throw new Error(`Answer references invalid question index: ${answer.questionIndex}`);
-            }
-            // Check that answer has either selectedOption or customText
-            if (!answer.selectedOption && !answer.customText) {
-                throw new Error(`Answer for question ${answer.questionIndex} has neither selectedOption nor customText`);
-            }
-            // If selectedOption is provided, verify it exists in the question's options
-            if (answer.selectedOption) {
-                const question = questions[answer.questionIndex];
-                const optionExists = question.options.some((opt) => opt.label === answer.selectedOption);
-                if (!optionExists) {
-                    throw new Error(`Answer for question ${answer.questionIndex} references non-existent option: ${answer.selectedOption}`);
-                }
-            }
-        }
-    }
-    /**
-     * Format a single question and its answer
-     *
-     * @param question - The question data
-     * @param answer - The user's answer
-     * @param index - Question number (1-indexed for display)
-     * @returns Formatted string for this question/answer pair
-     */
-    static formatQuestion(question, answer, index) {
-        const lines = [];
-        // Add question with number
-        lines.push(`${index}. ${question.prompt}`);
-        // Format the answer
-        if (answer.customText) {
-            // Custom text answer - escape single quotes for display
-            const escapedText = answer.customText.replace(/'/g, "\\'");
-            lines.push(`→ Other: '${escapedText}'`);
-        }
-        else if (answer.selectedOption) {
-            // Selected option - find the option details
-            const option = question.options.find((opt) => opt.label === answer.selectedOption);
-            if (option) {
-                // Format with description if available
-                if (option.description) {
-                    lines.push(`→ ${option.label} — ${option.description}`);
-                }
-                else {
-                    lines.push(`→ ${option.label}`);
-                }
-            }
-            else {
-                // Option not found - shouldn't happen, but handle gracefully
-                lines.push(`→ ${answer.selectedOption}`);
-            }
-        }
-        else {
-            // No answer provided - this shouldn't happen
-            lines.push("→ No answer provided");
-        }
-        return lines.join("\n");
-    }
-}