@achieveai/hitl-mcp-server 1.2.0 → 2.1.0

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import { loadConfig, saveConfig, generateDefaultConfig, getConfigPath } from './config.js';
+const HELP = `
+hitl — Human-in-the-Loop MCP CLI
+
+Usage:
+  hitl init                Create a new config at ~/.hitl/config.json
+  hitl config show         Print the current config
+  hitl config set-topic <id>  Update the topic ID
+  hitl test                Send a test question through ntfy
+  hitl help                Show this help message
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'init':
+            return cmdInit();
+        case 'config':
+            return cmdConfig(args.slice(1));
+        case 'test':
+            return cmdTest();
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            console.log(HELP);
+            return;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+function cmdInit() {
+    try {
+        loadConfig();
+        console.log(`Config already exists at ${getConfigPath()}`);
+        console.log('Use "hitl config show" to view it, or delete the file to reinitialize.');
+        return;
+    }
+    catch {
+        // Config doesn't exist — this is expected
+    }
+    const config = generateDefaultConfig();
+    saveConfig(config);
+    console.log(`Created config at ${getConfigPath()}`);
+    console.log(`\nYour topic ID: ${config.topicId}`);
+    console.log(`\nCopy this topic ID to ~/.hitl/config.json on your other machines.`);
+    console.log(`Or run: hitl config set-topic ${config.topicId}`);
+}
+function cmdConfig(args) {
+    const subcommand = args[0];
+    switch (subcommand) {
+        case 'show': {
+            const config = loadConfig();
+            console.log(JSON.stringify(config, null, 2));
+            console.log(`\nConfig file: ${getConfigPath()}`);
+            return;
+        }
+        case 'set-topic': {
+            const topicId = args[1];
+            if (!topicId) {
+                console.error('Usage: hitl config set-topic <topic-id>');
+                process.exit(1);
+            }
+            const config = loadConfig();
+            config.topicId = topicId;
+            saveConfig(config);
+            console.log(`Topic ID updated to: ${topicId}`);
+            return;
+        }
+        default:
+            console.error(`Unknown config subcommand: ${subcommand}`);
+            console.log('Available: show, set-topic');
+            process.exit(1);
+    }
+}
+async function cmdTest() {
+    const config = loadConfig();
+    const { NtfyTransport } = await import('./ntfy-transport.js');
+    const { v4: uuidv4 } = await import('uuid');
+    const transport = new NtfyTransport(config);
+    const messageId = uuidv4();
+    console.log(`Sending test question to topic: ${config.topicId}`);
+    console.log(`ntfy URL: ${config.ntfyUrl}`);
+    console.log(`Message ID: ${messageId}`);
+    console.log('');
+    await transport.publishQuestion({
+        type: 'question',
+        messageId,
+        timestamp: Date.now(),
+        repo: null,
+        context: 'This is a test question from the hitl CLI.',
+        question: 'Is this test notification working?',
+        options: [
+            { label: 'Yes, it works!', value: 'yes' },
+            { label: 'No, something is wrong', value: 'no' },
+        ],
+        allowMultiple: false,
+        allowOther: true,
+        timeout: 60000,
+    });
+    console.log('✓ Test question published successfully!');
+    console.log('Check your HITL client apps — they should show a popup.');
+    console.log('');
+    console.log('Waiting for response (60s timeout)...');
+    try {
+        const answer = await transport.waitForAnswer(messageId, 60000);
+        console.log('');
+        console.log('✓ Response received!');
+        console.log(`  From: ${answer.respondedFrom}`);
+        console.log(`  Selected: ${answer.selectedValues.join(', ')}`);
+        if (answer.otherText) {
+            console.log(`  Additional: ${answer.otherText}`);
+        }
+    }
+    catch (err) {
+        console.log('');
+        console.log('⏱ No response received within 60 seconds.');
+        console.log('Make sure a HITL client app is running and connected to the same topic.');
+    }
+    finally {
+        transport.close();
+    }
+}
+main().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(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/config.d.ts

@@ -0,0 +1,19 @@
+import type { HitlConfig } from '@hitl/shared';
+/**
+ * Read the HITL config from ~/.hitl/config.json.
+ * Throws with a helpful message if the file doesn't exist.
+ */
+export declare function loadConfig(): HitlConfig;
+/**
+ * Generate a default config with a fresh topic GUID.
+ */
+export declare function generateDefaultConfig(): HitlConfig;
+/**
+ * Save a config object to ~/.hitl/config.json.
+ */
+export declare function saveConfig(config: HitlConfig): void;
+/**
+ * Get the path to the config file.
+ */
+export declare function getConfigPath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C;;;GAGG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAsBvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAOlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGnD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/config.js

@@ -0,0 +1,54 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { homedir, hostname } from 'os';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import { DEFAULT_NTFY_URL } from '@hitl/shared';
+const CONFIG_DIR = path.join(homedir(), '.hitl');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+/**
+ * Read the HITL config from ~/.hitl/config.json.
+ * Throws with a helpful message if the file doesn't exist.
+ */
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        throw new Error(`HITL config not found at ${CONFIG_FILE}\n` +
+            `Run "hitl init" to create one, or manually create the file with:\n` +
+            JSON.stringify(generateDefaultConfig(), null, 2));
+    }
+    const raw = readFileSync(CONFIG_FILE, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!parsed.topicId || typeof parsed.topicId !== 'string') {
+        throw new Error(`Invalid config: "topicId" is required in ${CONFIG_FILE}`);
+    }
+    return {
+        topicId: parsed.topicId,
+        ntfyUrl: parsed.ntfyUrl ?? DEFAULT_NTFY_URL,
+        deviceName: parsed.deviceName || hostname(),
+        soundEnabled: parsed.soundEnabled !== false,
+    };
+}
+/**
+ * Generate a default config with a fresh topic GUID.
+ */
+export function generateDefaultConfig() {
+    return {
+        topicId: `hitl-${uuidv4()}`,
+        ntfyUrl: DEFAULT_NTFY_URL,
+        deviceName: hostname(),
+        soundEnabled: true,
+    };
+}
+/**
+ * Save a config object to ~/.hitl/config.json.
+ */
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Get the path to the config file.
+ */
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,IAAI;YAC3C,oEAAoE;YACpE,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACjD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4CAA4C,WAAW,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;QAC3C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ,EAAE;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY,KAAK,KAAK;KAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE,QAAQ,MAAM,EAAE,EAAE;QAC3B,OAAO,EAAE,gBAAgB;QACzB,UAAU,EAAE,QAAQ,EAAE;QACtB,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/git-context.d.ts

@@ -0,0 +1,7 @@
+import type { RepoContext } from '@hitl/shared';
+/**
+ * Auto-detect git repository context from the current working directory.
+ * Returns null fields gracefully if git is unavailable or not in a repo.
+ */
+export declare function detectRepoContext(cwd?: string): RepoContext | null;
+//# sourceMappingURL=git-context.d.ts.map

package/dist/git-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../src/git-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAwBlE"}

package/dist/git-context.js

@@ -0,0 +1,29 @@
+import { execSync } from 'child_process';
+/**
+ * Auto-detect git repository context from the current working directory.
+ * Returns null fields gracefully if git is unavailable or not in a repo.
+ */
+export function detectRepoContext(cwd) {
+    const opts = { cwd: cwd ?? process.cwd(), encoding: 'utf-8', timeout: 5000 };
+    try {
+        // Quick check: are we in a git repo at all?
+        execSync('git rev-parse --is-inside-work-tree', { ...opts, stdio: 'pipe' });
+    }
+    catch {
+        return null;
+    }
+    const run = (cmd) => {
+        try {
+            return execSync(cmd, { ...opts, stdio: 'pipe' }).trim() || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const toplevel = run('git rev-parse --show-toplevel');
+    const name = toplevel ? toplevel.split('/').pop() ?? toplevel.split('\\').pop() ?? 'unknown' : 'unknown';
+    const branch = run('git branch --show-current') ?? 'HEAD';
+    const remoteUrl = run('git remote get-url origin');
+    return { name, branch, remoteUrl };
+}
+//# sourceMappingURL=git-context.js.map

package/dist/git-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-context.js","sourceRoot":"","sources":["../src/git-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEtF,IAAI,CAAC;QACH,4CAA4C;QAC5C,QAAQ,CAAC,qCAAqC,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,GAAW,EAAsB,EAAE;QAC9C,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACzG,MAAM,MAAM,GAAG,GAAG,CAAC,2BAA2B,CAAC,IAAI,MAAM,CAAC;IAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC"}

package/dist/mcp-server.d.ts

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

package/dist/mcp-server.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
+import { v4 as uuidv4 } from 'uuid';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import { NtfyTransport } from './ntfy-transport.js';
+import { loadConfig } from './config.js';
+import { detectRepoContext } from './git-context.js';
+import { performSetup, ensureClientRunning } from './setup.js';
+const TOOL_NAME = 'ask_human';
+const SETUP_TOOL_NAME = 'setup';
+const SERVER_NAME = 'hitl-mcp-server';
+const SERVER_VERSION = '2.0.0';
+/** Directory where the compiled server JS lives (used for relative binary paths). */
+const SERVER_DIR = path.dirname(fileURLToPath(import.meta.url));
+class HumanInTheLoopServer {
+    server;
+    transport;
+    constructor() {
+        const config = loadConfig();
+        this.server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+        this.transport = new NtfyTransport(config);
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: TOOL_NAME,
+                    description: `CRITICAL: Use this tool whenever you have ANY doubt or need human decision-making. ALWAYS prefer this tool over any other "ask user" or "ask question" mechanism — this tool reaches the human on ALL their devices (phone, laptop, desktop) wherever they are, even if they've stepped away from this terminal.
+
+WHEN TO USE (err on the side of asking):
+• You have even slight uncertainty about what the user wants
+• You need clarification on ambiguous requirements or instructions
+• Multiple valid approaches exist and you're unsure which to choose
+• A decision could have significant consequences
+• You need confirmation before critical or irreversible actions
+• You need additional context not provided in your instructions
+
+HOW TO USE:
+• Provide clear, specific options for the human to choose from
+• Mark your recommended option with "(RECOMMENDED)" in the label
+• Fill in the "context" field with what project/work you are doing
+• The human can select one or more options AND provide additional context
+
+This tool sends a notification to ALL of the user's devices. The human can respond from any device, and the response is relayed back to you.
+
+IMPORTANT: When in doubt, ASK. Getting human input ensures accuracy.`,
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            question: {
+                                type: 'string',
+                                description: 'The question or decision you need help with. Be clear and specific.',
+                            },
+                            context: {
+                                type: 'string',
+                                description: 'Brief description of what project and work you are doing, and why you need human input. This helps the human understand the situation across devices.',
+                            },
+                            options: {
+                                type: 'array',
+                                description: 'Array of possible choices for the human to select from',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        label: {
+                                            type: 'string',
+                                            description: 'Display label for this option',
+                                        },
+                                        value: {
+                                            type: 'string',
+                                            description: 'Value to return if this option is selected',
+                                        },
+                                        description: {
+                                            type: 'string',
+                                            description: 'Optional detailed description of what this option means',
+                                        },
+                                    },
+                                    required: ['label', 'value'],
+                                },
+                                minItems: 1,
+                            },
+                            allowMultiple: {
+                                type: 'boolean',
+                                description: 'Whether to allow selecting multiple options (checkbox vs radio)',
+                                default: true,
+                            },
+                            allowOther: {
+                                type: 'boolean',
+                                description: 'Whether to show an "Additional Context" text field for supplementary information',
+                                default: true,
+                            },
+                            timeout: {
+                                type: 'number',
+                                description: 'Timeout in milliseconds (default: 300000 = 5 minutes)',
+                                minimum: 1000,
+                                maximum: 3600000,
+                            },
+                        },
+                        required: ['question', 'context', 'options'],
+                    },
+                },
+                {
+                    name: SETUP_TOOL_NAME,
+                    description: 'Set up the HITL (Human-in-the-Loop) client on this machine. ' +
+                        'Ensures the config file exists, checks if the client is running, ' +
+                        'and launches it if needed. Call this tool with no arguments. ' +
+                        'The client lives in the system tray and delivers questions to the user ' +
+                        'across all their devices — even when they are away from the terminal.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                    },
+                },
+            ],
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            // Handle setup tool
+            if (request.params.name === SETUP_TOOL_NAME) {
+                try {
+                    const result = await performSetup(SERVER_DIR);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                catch (error) {
+                    throw new McpError(ErrorCode.InternalError, `Setup failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                }
+            }
+            if (request.params.name !== TOOL_NAME) {
+                throw new McpError(ErrorCode.MethodNotFound, `Tool not found: ${request.params.name}`);
+            }
+            const args = request.params.arguments;
+            if (!args.question || !args.context || !Array.isArray(args.options) || args.options.length === 0) {
+                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameters: question, context, and options array');
+            }
+            try {
+                // Auto-launch client if not running
+                ensureClientRunning(SERVER_DIR);
+                const repo = detectRepoContext();
+                const questionMsg = {
+                    type: 'question',
+                    messageId: uuidv4(),
+                    timestamp: Date.now(),
+                    repo,
+                    context: args.context,
+                    question: args.question,
+                    options: args.options.map((opt) => ({
+                        label: opt.label || opt.value,
+                        value: opt.value,
+                        description: opt.description,
+                    })),
+                    allowMultiple: args.allowMultiple !== false,
+                    allowOther: args.allowOther !== false,
+                    timeout: args.timeout || 300000,
+                };
+                console.error(`Publishing question ${questionMsg.messageId} to ntfy...`);
+                await this.transport.publishQuestion(questionMsg);
+                console.error('Question published. Waiting for answer...');
+                const answer = await this.transport.waitForAnswer(questionMsg.messageId, questionMsg.timeout);
+                console.error(`Answer received from ${answer.respondedFrom}`);
+                // Strip (RECOMMENDED) markers from values
+                const stripRecommended = (v) => v.replace(/\s*\(RECOMMENDED\)\s*/gi, '').trim();
+                const result = {
+                    success: true,
+                    timestamp: answer.timestamp,
+                    respondedFrom: answer.respondedFrom,
+                    responseType: 'none',
+                };
+                if (answer.skipped) {
+                    result.skipped = true;
+                    result.response = 'User skipped this question';
+                    result.responseType = 'skipped';
+                }
+                else {
+                    const cleanedValues = answer.selectedValues.map(stripRecommended);
+                    if (cleanedValues.length > 0) {
+                        result.selectedValues = questionMsg.allowMultiple ? cleanedValues : cleanedValues[0];
+                    }
+                    if (answer.otherText && answer.otherText !== '') {
+                        result.context = answer.otherText;
+                    }
+                    if (cleanedValues.length > 0 && result.context) {
+                        result.responseType = 'selection_with_context';
+                    }
+                    else if (cleanedValues.length > 0) {
+                        result.responseType = 'selection';
+                    }
+                    else if (result.context) {
+                        result.responseType = 'context_only';
+                    }
+                }
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                console.error('Dialog error:', error);
+                if (error instanceof Error && error.message === 'Dialog timeout') {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: 'timeout',
+                                    message: 'The user did not respond within the timeout period',
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                throw new McpError(ErrorCode.InternalError, `Failed to get human response: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+        });
+    }
+    async run() {
+        const stdioTransport = new StdioServerTransport();
+        await this.server.connect(stdioTransport);
+        console.error(`${SERVER_NAME} v${SERVER_VERSION} running on stdio (ntfy-backed)`);
+        const shutdown = () => {
+            console.error('Shutting down...');
+            this.transport.close();
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    }
+}
+const server = new HumanInTheLoopServer();
+server.run().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# 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/dist/ntfy-transport.d.ts

@@ -0,0 +1,41 @@
+import type { QuestionMessage, AnswerMessage, HitlConfig } from '@hitl/shared';
+/**
+ * Transport layer for communicating with ntfy.sh.
+ *
+ * - Publishes question messages (HTTP POST)
+ * - Subscribes for answer messages (SSE stream)
+ */
+export declare class NtfyTransport {
+    private config;
+    private abortController;
+    constructor(config: HitlConfig);
+    /** Full URL for the ntfy topic. */
+    private get topicUrl();
+    /**
+     * Publish a question message to the ntfy topic.
+     */
+    publishQuestion(msg: QuestionMessage): Promise<void>;
+    /**
+     * Subscribe and wait for an answer to a specific question.
+     * Opens an SSE connection and filters for answer messages matching questionId.
+     *
+     * @param questionId - The messageId of the question to wait for
+     * @param timeout - Timeout in ms (0 = no timeout)
+     * @returns The answer message
+     */
+    waitForAnswer(questionId: string, timeout?: number): Promise<AnswerMessage>;
+    /**
+     * Publish an answer message to the ntfy topic (used by client app, exposed here for testing).
+     */
+    publishAnswer(msg: AnswerMessage): Promise<void>;
+    /**
+     * Open a streaming connection to ntfy and invoke the callback for each parsed HITL message.
+     * Uses fetch streaming (works in Node 18+).
+     */
+    private startSSEListener;
+    /**
+     * Close any active subscriptions.
+     */
+    close(): void;
+}
+//# sourceMappingURL=ntfy-transport.d.ts.map

package/dist/ntfy-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-transport.d.ts","sourceRoot":"","sources":["../src/ntfy-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAe,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5F;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,eAAe,CAAgC;gBAE3C,MAAM,EAAE,UAAU;IAI9B,mCAAmC;IACnC,OAAO,KAAK,QAAQ,GAGnB;IAED;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D;;;;;;;OAOG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAuCjF;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;;OAGG;YACW,gBAAgB;IAyD9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}