@hypertabai/mcp 0.2.0

package/dist/install/skill-writer.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export const DEFAULT_SKILL_URL = 'https://hypertab.ai/skill.md';
+function extractFrontmatterVersion(md) {
+    const match = md.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    const versionLine = match[1].split('\n').find((l) => l.trim().startsWith('version:'));
+    if (!versionLine)
+        return null;
+    return versionLine.replace(/^version:\s*/, '').trim();
+}
+async function fetchWithRetry(url, fetchImpl, retries) {
+    let lastErr;
+    for (let i = 0; i < retries; i += 1) {
+        try {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), 10_000);
+            let res;
+            try {
+                res = await fetchImpl(url, { signal: ctrl.signal });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status} ${res.statusText}`);
+            const text = await res.text();
+            if (text.trimStart().startsWith('<')) {
+                throw new Error(`Expected markdown but got HTML (likely SPA fallback). ` +
+                    `Check that ${url} is served with Content-Type: text/markdown.`);
+            }
+            return text;
+        }
+        catch (err) {
+            lastErr = err;
+            if (i < retries - 1) {
+                await new Promise((r) => setTimeout(r, 500 * (i + 1)));
+            }
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+/**
+ * Fetches the Hypertab skill and installs it at the platform-specific path.
+ *
+ * Behavior:
+ * - Platforms that don't support skills return `unsupported` without touching disk.
+ * - Network failures return `skipped-fetch-failed` (config install still succeeded upstream).
+ * - Re-runs with an identical skill file are `up-to-date` no-ops.
+ */
+export async function installSkill(opts) {
+    const { platform, scope } = opts;
+    if (!platform.supportsSkill || !platform.skillPath) {
+        return { action: 'unsupported', reason: `${platform.name} does not support Hypertab skills.` };
+    }
+    const skillUrl = opts.skillUrl ?? DEFAULT_SKILL_URL;
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const retries = opts.retries ?? 3;
+    const targetPath = platform.skillPath(scope);
+    let fresh;
+    try {
+        fresh = await fetchWithRetry(skillUrl, fetchImpl, retries);
+    }
+    catch (err) {
+        return {
+            action: 'skipped-fetch-failed',
+            reason: `Could not fetch ${skillUrl}: ${err.message}. ` +
+                `The MCP server was still installed; re-run 'hypertab install' to retry the skill.`,
+        };
+    }
+    if (existsSync(targetPath)) {
+        const current = readFileSync(targetPath, 'utf8');
+        const currentVersion = extractFrontmatterVersion(current);
+        const newVersion = extractFrontmatterVersion(fresh);
+        if (currentVersion && newVersion && currentVersion === newVersion && current === fresh) {
+            return { action: 'up-to-date', path: targetPath };
+        }
+    }
+    const parent = dirname(targetPath);
+    if (!existsSync(parent))
+        mkdirSync(parent, { recursive: true });
+    writeFileSync(targetPath, fresh);
+    return { action: 'installed', path: targetPath };
+}
+//# sourceMappingURL=skill-writer.js.map

package/dist/install/skill-writer.js.map

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

package/dist/install/uninstall.d.ts

@@ -0,0 +1,11 @@
+import { type PlatformDef, type Scope } from './platforms.js';
+export interface UninstallOptions {
+    platform: PlatformDef;
+    scope?: Scope;
+    /** When true, preserves the skill file at ~/.claude/skills/hypertab/SKILL.md. */
+    keepSkill?: boolean;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+}
+export declare function runUninstall(opts: UninstallOptions): Promise<number>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/install/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/install/uninstall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAoB,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE/E,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAC9B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6E1E"}

package/dist/install/uninstall.js

@@ -0,0 +1,81 @@
+import { existsSync, unlinkSync } from 'node:fs';
+import { removePlatformConfig } from './config-writer.js';
+import { resolveCanonical } from './platforms.js';
+export async function runUninstall(opts) {
+    const out = opts.stdout ?? process.stdout;
+    const err = opts.stderr ?? process.stderr;
+    const platform = opts.platform;
+    const canonical = resolveCanonical(platform);
+    const desired = opts.scope ?? (canonical.supportsUserScope ? 'user' : 'project');
+    if (desired === 'project' && !canonical.supportsProjectScope) {
+        err.write(`Error: ${canonical.name} does not support project scope. Re-run with --scope user.\n`);
+        return 1;
+    }
+    if (desired === 'user' && !canonical.supportsUserScope) {
+        err.write(`Error: ${canonical.name} does not support user scope. Re-run with --scope project.\n`);
+        return 1;
+    }
+    const scope = desired;
+    let configResult;
+    try {
+        configResult = removePlatformConfig({ platform: canonical, scope });
+    }
+    catch (writeErr) {
+        err.write(`Error removing config: ${writeErr.message}\n`);
+        return 1;
+    }
+    // Skill removal (only for platforms that support skills)
+    let skillStatus = 'unsupported';
+    let skillPath;
+    if (canonical.supportsSkill && canonical.skillPath) {
+        skillPath = canonical.skillPath(scope);
+        if (opts.keepSkill) {
+            skillStatus = 'kept';
+        }
+        else if (existsSync(skillPath)) {
+            try {
+                unlinkSync(skillPath);
+                skillStatus = 'removed';
+            }
+            catch (skillErr) {
+                err.write(`Warning: could not remove skill at ${skillPath}: ${skillErr.message}\n`);
+                skillStatus = 'kept';
+            }
+        }
+        else {
+            skillStatus = 'not-present';
+        }
+    }
+    const lines = [];
+    lines.push('');
+    lines.push(`\u2713 Uninstalled Hypertab MCP from ${platform.name}${platform.aliasOf ? ` (wrote to ${canonical.name} config)` : ''}`);
+    if (configResult.action === 'removed') {
+        lines.push(`  Config: ${configResult.path} (removed${configResult.backupCreated ? ', backup saved as .bak' : ''})`);
+    }
+    else if (configResult.action === 'not-installed') {
+        lines.push(`  Config: ${configResult.path} (nothing to remove — hypertab entry was not present)`);
+    }
+    else {
+        lines.push(`  Config: ${configResult.path} (file did not exist)`);
+    }
+    if (canonical.supportsSkill) {
+        if (skillStatus === 'removed') {
+            lines.push(`  Skill:  ${skillPath} (removed)`);
+        }
+        else if (skillStatus === 'kept') {
+            lines.push(`  Skill:  ${skillPath} (kept, --keep-skill)`);
+        }
+        else if (skillStatus === 'not-present') {
+            lines.push(`  Skill:  not present (nothing to remove)`);
+        }
+    }
+    else {
+        lines.push(`  Skill:  n/a (${canonical.name} does not install a skill)`);
+    }
+    lines.push('');
+    lines.push(`Restart ${platform.name} so it stops loading the Hypertab server.`);
+    lines.push('');
+    out.write(lines.join('\n'));
+    return 0;
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/install/uninstall.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@hypertabai/mcp",
+	"version": "0.2.0",
+	"description": "One-command Hypertab MCP installer and client for Claude Code, Cursor, Windsurf, and more.",
+	"type": "module",
+	"bin": {
+		"hypertab": "./dist/index.js",
+		"hypertab-mcp": "./dist/index.js"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run build"
+	},
+	"keywords": [
+		"hypertab",
+		"mcp",
+		"model-context-protocol",
+		"claude",
+		"cursor",
+		"windsurf",
+		"ai-agent"
+	],
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.0.0",
+		"commander": "latest"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "~5.9.0",
+		"vitest": "^3.2.4"
+	}
+}