@achieveai/hitl-mcp-server 1.2.0 → 2.0.0

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"}

package/dist/ntfy-transport.js

@@ -0,0 +1,150 @@
+/**
+ * Transport layer for communicating with ntfy.sh.
+ *
+ * - Publishes question messages (HTTP POST)
+ * - Subscribes for answer messages (SSE stream)
+ */
+export class NtfyTransport {
+    config;
+    abortController = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Full URL for the ntfy topic. */
+    get topicUrl() {
+        const base = this.config.ntfyUrl.replace(/\/+$/, '');
+        return `${base}/${this.config.topicId}`;
+    }
+    /**
+     * Publish a question message to the ntfy topic.
+     */
+    async publishQuestion(msg) {
+        const response = await fetch(this.topicUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(msg),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to publish question: ${response.status} ${response.statusText}`);
+        }
+    }
+    /**
+     * 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
+     */
+    async waitForAnswer(questionId, timeout) {
+        return new Promise((resolve, reject) => {
+            this.abortController = new AbortController();
+            const { signal } = this.abortController;
+            let timer;
+            if (timeout && timeout > 0) {
+                timer = setTimeout(() => {
+                    this.abortController?.abort();
+                    reject(new Error('Dialog timeout'));
+                }, timeout);
+            }
+            const cleanup = () => {
+                if (timer)
+                    clearTimeout(timer);
+            };
+            // Use ntfy's JSON stream endpoint — since=<now_unix> to only get future messages
+            const sinceTs = Math.floor(Date.now() / 1000);
+            const sseUrl = `${this.topicUrl}/json?since=${sinceTs}`;
+            this.startSSEListener(sseUrl, signal, (msg) => {
+                if (msg.type === 'answer' && msg.questionId === questionId) {
+                    cleanup();
+                    resolve(msg);
+                }
+            }).catch((err) => {
+                cleanup();
+                if (!signal.aborted) {
+                    reject(err);
+                }
+            });
+            signal.addEventListener('abort', () => {
+                cleanup();
+            });
+        });
+    }
+    /**
+     * Publish an answer message to the ntfy topic (used by client app, exposed here for testing).
+     */
+    async publishAnswer(msg) {
+        const response = await fetch(this.topicUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(msg),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to publish answer: ${response.status} ${response.statusText}`);
+        }
+    }
+    /**
+     * Open a streaming connection to ntfy and invoke the callback for each parsed HITL message.
+     * Uses fetch streaming (works in Node 18+).
+     */
+    async startSSEListener(url, signal, onMessage) {
+        const response = await fetch(url, {
+            headers: { Accept: 'application/x-ndjson' },
+            signal,
+        });
+        if (!response.ok) {
+            throw new Error(`ntfy subscription failed: ${response.status} ${response.statusText}`);
+        }
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error('No response body from ntfy');
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    try {
+                        const ntfyEvent = JSON.parse(trimmed);
+                        // ntfy wraps messages — the actual payload is in the 'message' field
+                        if (ntfyEvent.message) {
+                            try {
+                                const hitlMsg = JSON.parse(ntfyEvent.message);
+                                if (hitlMsg.type === 'question' || hitlMsg.type === 'answer') {
+                                    onMessage(hitlMsg);
+                                }
+                            }
+                            catch {
+                                // Not a valid HITL message, ignore
+                            }
+                        }
+                    }
+                    catch {
+                        // Not valid JSON, ignore
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError')
+                return;
+            throw err;
+        }
+    }
+    /**
+     * Close any active subscriptions.
+     */
+    close() {
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+}
+//# sourceMappingURL=ntfy-transport.js.map

package/dist/ntfy-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-transport.js","sourceRoot":"","sources":["../src/ntfy-transport.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAa;IACnB,eAAe,GAA2B,IAAI,CAAC;IAEvD,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,mCAAmC;IACnC,IAAY,QAAQ;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,GAAoB;QACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,OAAgB;QACtD,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpD,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC;YAExC,IAAI,KAAiC,CAAC;YACtC,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC3B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC;oBAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACtC,CAAC,EAAE,OAAO,CAAC,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC,CAAC;YAEF,iFAAiF;YACjF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,eAAe,OAAO,EAAE,CAAC;YAExD,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAgB,EAAE,EAAE;gBACzD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC3D,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,GAAoB,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBACpC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAkB;QACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAC5B,GAAW,EACX,MAAmB,EACnB,SAAqC;QAErC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;YAC3C,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO;wBAAE,SAAS;oBAEvB,IAAI,CAAC;wBACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACtC,qEAAqE;wBACrE,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;4BACtB,IAAI,CAAC;gCACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAgB,CAAC;gCAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oCAC7D,SAAS,CAAC,OAAO,CAAC,CAAC;gCACrB,CAAC;4BACH,CAAC;4BAAC,MAAM,CAAC;gCACP,mCAAmC;4BACrC,CAAC;wBACH,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,yBAAyB;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;gBAAE,OAAO;YAC9D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;CACF"}

package/dist/setup.d.ts

@@ -0,0 +1,38 @@
+/** Result of a single setup step. */
+export interface SetupStepResult {
+    step: string;
+    status: 'ok' | 'created' | 'launched' | 'already_running' | 'not_found' | 'error';
+    message: string;
+}
+/** Aggregated result of the full setup process. */
+export interface SetupResult {
+    success: boolean;
+    steps: SetupStepResult[];
+    summary: string;
+}
+/**
+ * Check if a process with the given name is currently running.
+ * Uses `tasklist` on Windows and `pgrep` on Unix.
+ */
+export declare function isProcessRunning(processName: string): boolean;
+/**
+ * Search known locations for the HITL client binary.
+ * Returns the first path that exists, or null if none found.
+ *
+ * @param serverDir - The directory where the compiled server JS lives (e.g. server/dist/)
+ */
+export declare function findClientBinary(serverDir: string): string | null;
+/**
+ * Launch the client binary as a fully detached background process.
+ */
+export declare function launchClient(binaryPath: string): void;
+/**
+ * Perform the full HITL client setup:
+ *   1. Ensure ~/.hitl/config.json exists
+ *   2. Check if the client process is running
+ *   3. Find and launch the client binary if needed
+ *
+ * @param serverDir - The directory of the running server JS (used to resolve relative binary paths)
+ */
+export declare function performSetup(serverDir: string): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,CAAC;IAClF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAe7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAajE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAMrD;AAkBD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmD1E"}

package/dist/setup.js

@@ -0,0 +1,130 @@
+import { existsSync } from 'fs';
+import { execSync, spawn } from 'child_process';
+import { homedir } from 'os';
+import path from 'path';
+import { saveConfig, generateDefaultConfig, getConfigPath } from './config.js';
+/**
+ * Check if a process with the given name is currently running.
+ * Uses `tasklist` on Windows and `pgrep` on Unix.
+ */
+export function isProcessRunning(processName) {
+    try {
+        if (process.platform === 'win32') {
+            const output = execSync(`tasklist /FI "IMAGENAME eq ${processName}" /NH`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+            return output.toLowerCase().includes(processName.toLowerCase());
+        }
+        else {
+            execSync(`pgrep -x ${processName}`, { stdio: ['pipe', 'pipe', 'pipe'] });
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Search known locations for the HITL client binary.
+ * Returns the first path that exists, or null if none found.
+ *
+ * @param serverDir - The directory where the compiled server JS lives (e.g. server/dist/)
+ */
+export function findClientBinary(serverDir) {
+    const binaryName = process.platform === 'win32' ? 'hitl-client.exe' : 'hitl-client';
+    const candidates = [
+        // Dev build (relative to server dist → repo root → client)
+        path.resolve(serverDir, '..', '..', 'client', 'src-tauri', 'target', 'debug', binaryName),
+        // Release build
+        path.resolve(serverDir, '..', '..', 'client', 'src-tauri', 'target', 'release', binaryName),
+        // Installed location
+        path.join(homedir(), '.hitl', binaryName),
+    ];
+    return candidates.find((p) => existsSync(p)) ?? null;
+}
+/**
+ * Launch the client binary as a fully detached background process.
+ */
+export function launchClient(binaryPath) {
+    const child = spawn(binaryPath, [], {
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+}
+/**
+ * Build a user-friendly "not found" message listing the paths that were searched.
+ */
+function buildNotFoundMessage() {
+    const binaryName = process.platform === 'win32' ? 'hitl-client.exe' : 'hitl-client';
+    return [
+        `HITL client binary not found. Searched locations:`,
+        `  - <serverDir>/../../client/src-tauri/target/debug/${binaryName}`,
+        `  - <serverDir>/../../client/src-tauri/target/release/${binaryName}`,
+        `  - ~/.hitl/${binaryName}`,
+        ``,
+        `To build the client from source, run:`,
+        `  cd client && cargo tauri build`,
+    ].join('\n');
+}
+/**
+ * Perform the full HITL client setup:
+ *   1. Ensure ~/.hitl/config.json exists
+ *   2. Check if the client process is running
+ *   3. Find and launch the client binary if needed
+ *
+ * @param serverDir - The directory of the running server JS (used to resolve relative binary paths)
+ */
+export async function performSetup(serverDir) {
+    const steps = [];
+    let overallSuccess = true;
+    // Step 1: Ensure config exists
+    const configPath = getConfigPath();
+    if (existsSync(configPath)) {
+        steps.push({ step: 'config', status: 'ok', message: `Config already exists at ${configPath}` });
+    }
+    else {
+        try {
+            const config = generateDefaultConfig();
+            saveConfig(config);
+            steps.push({ step: 'config', status: 'created', message: `Created default config at ${configPath}` });
+        }
+        catch (error) {
+            overallSuccess = false;
+            steps.push({
+                step: 'config',
+                status: 'error',
+                message: `Failed to create config: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+    // Step 2: Check if client is already running
+    const binaryName = process.platform === 'win32' ? 'hitl-client.exe' : 'hitl-client';
+    if (isProcessRunning(binaryName)) {
+        steps.push({ step: 'client', status: 'already_running', message: 'HITL client is already running' });
+        return { success: overallSuccess, steps, summary: formatSummary(steps) };
+    }
+    // Step 3: Find and launch binary
+    const binaryPath = findClientBinary(serverDir);
+    if (!binaryPath) {
+        overallSuccess = false;
+        steps.push({ step: 'client', status: 'not_found', message: buildNotFoundMessage() });
+        return { success: overallSuccess, steps, summary: formatSummary(steps) };
+    }
+    try {
+        launchClient(binaryPath);
+        steps.push({ step: 'client', status: 'launched', message: `Launched HITL client from ${binaryPath}` });
+    }
+    catch (error) {
+        overallSuccess = false;
+        steps.push({
+            step: 'client',
+            status: 'error',
+            message: `Failed to launch client: ${error instanceof Error ? error.message : String(error)}`,
+        });
+    }
+    return { success: overallSuccess, steps, summary: formatSummary(steps) };
+}
+/** Format step results into a human-readable summary. */
+function formatSummary(steps) {
+    return steps.map((s) => `[${s.status.toUpperCase()}] ${s.step}: ${s.message}`).join('\n');
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/package.json

@@ -1,63 +1,58 @@
-{
-  "name": "@achieveai/hitl-mcp-server",
-  "version": "1.2.0",
-  "description": "Human In The Loop MCP Server - Enables LLM agents to ask questions and get user feedback through interactive dialogs",
-  "main": "dist/index.js",
-  "bin": {
-    "hitl-mcp-server": "dist/index.js"
-  },
-  "type": "module",
-  "files": [
-    "dist/",
-    "config/",
-    "sounds/",
-    "mcp.json",
-    "README.md",
-    "LICENSE",
-    "example-usage.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/achieveai/HumanInTheLoop.git"
-  },
-  "bugs": {
-    "url": "https://github.com/achieveai/HumanInTheLoop/issues"
-  },
-  "homepage": "https://github.com/achieveai/HumanInTheLoop#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/index.ts",
-    "start": "node dist/index.js",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:dialog": "tsx src/test-client.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "keywords": [
-    "mcp",
-    "llm",
-    "human-in-the-loop",
-    "dialog",
-    "interactive"
-  ],
-  "author": "MCQdb LLC <https://achieve.ai>",
-  "license": "GPL-3.0",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "express": "^4.21.2",
-    "open": "^10.1.0",
-    "uuid": "^11.0.5"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.0",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.10.5",
-    "@types/uuid": "^10.0.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.2.6",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3"
-  }
-}
+{
+  "name": "@achieveai/hitl-mcp-server",
+  "version": "2.0.0",
+  "description": "Human-in-the-Loop MCP Server — enables LLM agents to ask questions across all your devices via ntfy.sh",
+  "type": "module",
+  "main": "./dist/mcp-server.js",
+  "bin": {
+    "hitl": "./dist/cli.js",
+    "hitl-mcp-server": "./dist/mcp-server.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.map",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "llm",
+    "human-in-the-loop",
+    "hitl",
+    "dialog",
+    "interactive",
+    "model-context-protocol",
+    "ntfy",
+    "notifications"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/achieveai/hitl-mcp-server.git"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/mcp-server.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest --config jest.config.js",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@hitl/shared": "*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "eventsource": "^2.0.2",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/eventsource": "^1.1.15",
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
+    "typescript": "^5.3.0",
+    "tsx": "^4.0.0",
+    "rimraf": "^5.0.0",
+    "jest": "^29.7.0",
+    "@jest/globals": "^29.7.0",
+    "ts-jest": "^29.1.0"
+  }
+}

package/LICENSE

@@ -1,20 +0,0 @@
-GNU GENERAL PUBLIC LICENSE
-Version 3, 29 June 2007
-
-Copyright (C) 2025 Human-in-the-Loop MCP Server Contributors
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program.  If not, see <https://www.gnu.org/licenses/>.
-
-For the full text of the GNU General Public License Version 3,
-please visit: https://www.gnu.org/licenses/gpl-3.0.txt