@hypertabai/mcp 0.2.0

package/dist/__tests__/install.test.js

@@ -0,0 +1,211 @@
+import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runInstall } from '../install/index.js';
+const SAMPLE_SKILL = `---
+name: hypertab
+description: Hypertab MCP skill
+version: 1.0.0
+---
+
+# Hypertab
+Skill body.
+`;
+function okFetch(body, status = 200) {
+    return (async () => new Response(body, {
+        status,
+        headers: { 'content-type': 'text/markdown' },
+    }));
+}
+function failingFetch() {
+    return (async () => {
+        throw new Error('network down');
+    });
+}
+function captureStreams() {
+    const out = [];
+    const err = [];
+    return {
+        stdout: { write: (chunk) => out.push(chunk) },
+        stderr: { write: (chunk) => err.push(chunk) },
+        out,
+        err,
+    };
+}
+let workDir;
+function testPlatform(opts = {}) {
+    const id = opts.id ?? 'claude-code';
+    const configFile = join(workDir, `${id}.json`);
+    const skillFile = join(workDir, id, 'skill', 'SKILL.md');
+    return {
+        id,
+        name: opts.name ?? id,
+        description: '',
+        supportsUserScope: opts.supportsUserScope ?? true,
+        supportsProjectScope: opts.supportsProjectScope ?? true,
+        configPath: () => configFile,
+        serversKey: 'mcpServers',
+        serverName: 'hypertab',
+        buildServerEntry: (url, apiKey) => ({
+            type: 'http',
+            url,
+            headers: { Authorization: `Bearer ${apiKey}` },
+        }),
+        supportsSkill: opts.supportsSkill ?? true,
+        skillPath: (opts.supportsSkill ?? true) ? () => skillFile : undefined,
+        restartInstruction: 'Restart the agent.',
+    };
+}
+beforeEach(() => {
+    workDir = mkdtempSync(join(tmpdir(), 'hypertab-install-'));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe('runInstall', () => {
+    it('writes config and skill for claude-code with a valid key', async () => {
+        const platform = testPlatform();
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform,
+            apiKey: 'ht_sk_valid123',
+            scope: 'user',
+            ...streams,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(code).toBe(0);
+        expect(existsSync(join(workDir, 'claude-code.json'))).toBe(true);
+        expect(existsSync(join(workDir, 'claude-code', 'skill', 'SKILL.md'))).toBe(true);
+        const config = JSON.parse(readFileSync(join(workDir, 'claude-code.json'), 'utf8'));
+        expect(config.mcpServers.hypertab.headers.Authorization).toBe('Bearer ht_sk_valid123');
+        const skill = readFileSync(join(workDir, 'claude-code', 'skill', 'SKILL.md'), 'utf8');
+        expect(skill).toBe(SAMPLE_SKILL);
+        expect(streams.out.join('')).toContain('Installed Hypertab MCP');
+        expect(streams.err.join('')).toContain('HYPERTAB_API_KEY env var is safer');
+    });
+    it('uses HYPERTAB_API_KEY env var when flag is not set', async () => {
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform: testPlatform(),
+            scope: 'user',
+            ...streams,
+            env: { HYPERTAB_API_KEY: 'ht_sk_fromenv' },
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(code).toBe(0);
+        const config = JSON.parse(readFileSync(join(workDir, 'claude-code.json'), 'utf8'));
+        expect(config.mcpServers.hypertab.headers.Authorization).toBe('Bearer ht_sk_fromenv');
+        expect(streams.err.join('')).not.toContain('HYPERTAB_API_KEY env var is safer');
+    });
+    it('falls back to the interactive prompt when neither flag nor env var is set', async () => {
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform: testPlatform(),
+            scope: 'user',
+            ...streams,
+            env: {},
+            promptFn: async () => 'ht_sk_prompted',
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(code).toBe(0);
+        const config = JSON.parse(readFileSync(join(workDir, 'claude-code.json'), 'utf8'));
+        expect(config.mcpServers.hypertab.headers.Authorization).toBe('Bearer ht_sk_prompted');
+    });
+    it('rejects keys that do not start with ht_sk_', async () => {
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform: testPlatform(),
+            apiKey: 'wrong_prefix_abc',
+            scope: 'user',
+            ...streams,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(code).toBe(1);
+        expect(streams.err.join('')).toContain("must start with 'ht_sk_'");
+        expect(existsSync(join(workDir, 'claude-code.json'))).toBe(false);
+    });
+    it('still writes the config when the skill fetch fails', async () => {
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform: testPlatform(),
+            apiKey: 'ht_sk_valid123',
+            scope: 'user',
+            ...streams,
+            env: {},
+            fetchImpl: failingFetch(),
+        });
+        expect(code).toBe(0);
+        expect(existsSync(join(workDir, 'claude-code.json'))).toBe(true);
+        expect(existsSync(join(workDir, 'claude-code', 'skill', 'SKILL.md'))).toBe(false);
+        expect(streams.out.join('')).toMatch(/Skill:\s+FAILED/);
+    });
+    it('skips skill install with a note for platforms that do not support skills', async () => {
+        const platform = testPlatform({ id: 'cursor', supportsSkill: false });
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform,
+            apiKey: 'ht_sk_valid123',
+            scope: 'user',
+            ...streams,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(code).toBe(0);
+        expect(existsSync(join(workDir, 'cursor.json'))).toBe(true);
+        expect(existsSync(join(workDir, 'cursor', 'skill', 'SKILL.md'))).toBe(false);
+        expect(streams.out.join('')).toContain('Skill:  skipped');
+    });
+    it('rejects project scope for platforms that only support user scope', async () => {
+        const platform = testPlatform({ id: 'windsurf', supportsProjectScope: false });
+        const streams = captureStreams();
+        const code = await runInstall({
+            platform,
+            apiKey: 'ht_sk_valid123',
+            scope: 'project',
+            ...streams,
+            env: {},
+        });
+        expect(code).toBe(1);
+        expect(streams.err.join('')).toContain('does not support project scope');
+    });
+    it('masks the API key in output (never echoes full)', async () => {
+        const streams = captureStreams();
+        await runInstall({
+            platform: testPlatform(),
+            apiKey: 'ht_sk_fullsecretvalueabc123',
+            scope: 'user',
+            ...streams,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        const combined = streams.out.join('') + streams.err.join('');
+        expect(combined).not.toContain('ht_sk_fullsecretvalueabc123');
+        expect(combined).toMatch(/ht_sk_full/);
+    });
+    it('is idempotent — second run with the same key is a no-op', async () => {
+        const platform = testPlatform();
+        const s1 = captureStreams();
+        await runInstall({
+            platform,
+            apiKey: 'ht_sk_same',
+            scope: 'user',
+            ...s1,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        const s2 = captureStreams();
+        await runInstall({
+            platform,
+            apiKey: 'ht_sk_same',
+            scope: 'user',
+            ...s2,
+            env: {},
+            fetchImpl: okFetch(SAMPLE_SKILL),
+        });
+        expect(s2.out.join('')).toContain('no-change');
+    });
+});
+//# sourceMappingURL=install.test.js.map

package/dist/__tests__/install.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.test.js","sourceRoot":"","sources":["../../src/__tests__/install.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGhD,MAAM,YAAY,GAAG;;;;;;;;CAQpB,CAAA;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,MAAM,GAAG,GAAG;IAC1C,OAAO,CAAC,KAAK,IAAI,EAAE,CAClB,IAAI,QAAQ,CAAC,IAAI,EAAE;QAClB,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE;KAC5C,CAAC,CAA4B,CAAA;AAChC,CAAC;AAED,SAAS,YAAY;IACpB,OAAO,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;IAChC,CAAC,CAA4B,CAAA;AAC9B,CAAC;AAED,SAAS,cAAc;IACtB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,OAAO;QACN,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAsC;QACzF,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAsC;QACzF,GAAG;QACH,GAAG;KACH,CAAA;AACF,CAAC;AAED,IAAI,OAAe,CAAA;AAEnB,SAAS,YAAY,CAAC,OAMlB,EAAE;IACL,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,aAAa,CAAA;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;IACxD,OAAO;QACN,EAAE;QACF,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;QACjD,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,IAAI;QACvD,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU;QAC5B,UAAU,EAAE,YAAY;QACxB,UAAU,EAAE,UAAU;QACtB,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,MAAM;YACZ,GAAG;YACH,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;SAC9C,CAAC;QACF,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;QACzC,SAAS,EAAE,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACrE,kBAAkB,EAAE,oBAAoB;KACxC,CAAA;AACF,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACf,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAC3D,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACd,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;QAC/B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ;YACR,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAClF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QAEtF,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;QACrF,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAEhC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAA;QAChE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ,EAAE,YAAY,EAAE;YACxB,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE,gBAAgB,EAAE,eAAe,EAAE;YAC1C,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAClF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACrF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ,EAAE,YAAY,EAAE;YACxB,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,gBAAgB;YACtC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAClF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ,EAAE,YAAY,EAAE;YACxB,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAA;QAClE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ,EAAE,YAAY,EAAE;YACxB,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,YAAY,EAAE;SACzB,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAA;QACrE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ;YACR,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5E,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9E,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC;YAC7B,QAAQ;YACR,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,SAAS;YAChB,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;SACP,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;QAChC,MAAM,UAAU,CAAC;YAChB,QAAQ,EAAE,YAAY,EAAE;YACxB,MAAM,EAAE,6BAA6B;YACrC,KAAK,EAAE,MAAM;YACb,GAAG,OAAO;YACV,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5D,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAA;QAC7D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;QAC/B,MAAM,EAAE,GAAG,cAAc,EAAE,CAAA;QAC3B,MAAM,UAAU,CAAC;YAChB,QAAQ;YACR,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,MAAM;YACb,GAAG,EAAE;YACL,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,EAAE,GAAG,cAAc,EAAE,CAAA;QAC3B,MAAM,UAAU,CAAC;YAChB,QAAQ;YACR,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,MAAM;YACb,GAAG,EAAE;YACL,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/__tests__/platforms.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platforms.test.d.ts.map

package/dist/__tests__/platforms.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/platforms.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/platforms.test.js

@@ -0,0 +1,109 @@
+import { describe, expect, it } from 'vitest';
+import { getPlatform, PLATFORM_IDS, PLATFORMS, resolveCanonical } from '../install/platforms.js';
+const URL = 'https://api.hypertab.ai/mcp';
+const KEY = 'ht_sk_test12345';
+describe('platform registry', () => {
+    it('exposes all 7 supported client IDs', () => {
+        expect(PLATFORM_IDS).toEqual(expect.arrayContaining(['claude-code', 'claude-desktop', 'cursor', 'windsurf', 'antigravity', 'vscode', 'cowork']));
+        expect(PLATFORM_IDS).toHaveLength(7);
+    });
+    it('getPlatform throws a helpful error for unknown clients', () => {
+        expect(() => getPlatform('sublime-text')).toThrow(/Unknown client/);
+        expect(() => getPlatform('sublime-text')).toThrow(/claude-code/);
+    });
+    it('getPlatform returns the exact registry entry', () => {
+        expect(getPlatform('claude-code').id).toBe('claude-code');
+        expect(getPlatform('cursor').id).toBe('cursor');
+    });
+});
+describe('aliases', () => {
+    it('vscode is an alias for claude-code', () => {
+        const vscode = getPlatform('vscode');
+        expect(vscode.aliasOf).toBe('claude-code');
+        expect(vscode.name).toBe('VS Code');
+        expect(resolveCanonical(vscode).id).toBe('claude-code');
+    });
+    it('cowork is an alias for claude-code', () => {
+        const cowork = getPlatform('cowork');
+        expect(cowork.aliasOf).toBe('claude-code');
+        expect(resolveCanonical(cowork).id).toBe('claude-code');
+    });
+    it('aliases inherit config paths and server entry shape from their canonical', () => {
+        const cc = getPlatform('claude-code');
+        const vs = getPlatform('vscode');
+        expect(vs.configPath('user')).toBe(cc.configPath('user'));
+        expect(vs.configPath('project')).toBe(cc.configPath('project'));
+        expect(vs.buildServerEntry(URL, KEY)).toEqual(cc.buildServerEntry(URL, KEY));
+    });
+    it('resolveCanonical is a no-op for canonical platforms', () => {
+        const cc = getPlatform('claude-code');
+        expect(resolveCanonical(cc)).toBe(cc);
+    });
+});
+describe('server entry shapes', () => {
+    it('claude-code uses { type, url, headers }', () => {
+        expect(getPlatform('claude-code').buildServerEntry(URL, KEY)).toEqual({
+            type: 'http',
+            url: URL,
+            headers: { Authorization: `Bearer ${KEY}` },
+        });
+    });
+    it('cursor uses { url, headers } with no type field', () => {
+        const entry = getPlatform('cursor').buildServerEntry(URL, KEY);
+        expect(entry).toEqual({ url: URL, headers: { Authorization: `Bearer ${KEY}` } });
+        expect(entry.type).toBeUndefined();
+    });
+    it('windsurf uses { serverUrl, headers }', () => {
+        const entry = getPlatform('windsurf').buildServerEntry(URL, KEY);
+        expect(entry).toEqual({ serverUrl: URL, headers: { Authorization: `Bearer ${KEY}` } });
+    });
+    it('all platforms wrap the API key as a Bearer token', () => {
+        for (const id of PLATFORM_IDS) {
+            const entry = PLATFORMS[id].buildServerEntry(URL, KEY);
+            expect(entry.headers?.Authorization).toBe(`Bearer ${KEY}`);
+        }
+    });
+});
+describe('scope support', () => {
+    it('claude-code supports both user and project scopes', () => {
+        const cc = getPlatform('claude-code');
+        expect(cc.supportsUserScope).toBe(true);
+        expect(cc.supportsProjectScope).toBe(true);
+        expect(() => cc.configPath('user')).not.toThrow();
+        expect(() => cc.configPath('project')).not.toThrow();
+    });
+    it('claude-desktop supports user scope only', () => {
+        const cd = getPlatform('claude-desktop');
+        expect(cd.supportsUserScope).toBe(true);
+        expect(cd.supportsProjectScope).toBe(false);
+        expect(() => cd.configPath('project')).toThrow();
+    });
+    it('windsurf supports user scope only', () => {
+        const ws = getPlatform('windsurf');
+        expect(ws.supportsUserScope).toBe(true);
+        expect(ws.supportsProjectScope).toBe(false);
+        expect(() => ws.configPath('project')).toThrow();
+    });
+    it('cursor supports both scopes', () => {
+        const c = getPlatform('cursor');
+        expect(c.supportsUserScope).toBe(true);
+        expect(c.supportsProjectScope).toBe(true);
+    });
+});
+describe('skill support', () => {
+    it('only claude-code and its aliases support skills', () => {
+        expect(getPlatform('claude-code').supportsSkill).toBe(true);
+        expect(getPlatform('vscode').supportsSkill).toBe(true);
+        expect(getPlatform('cowork').supportsSkill).toBe(true);
+    });
+    it('other platforms do not support skills', () => {
+        for (const id of ['claude-desktop', 'cursor', 'windsurf', 'antigravity']) {
+            expect(getPlatform(id).supportsSkill).toBe(false);
+        }
+    });
+    it('skill path for claude-code project scope is under .claude/skills/hypertab', () => {
+        const p = getPlatform('claude-code').skillPath?.('project');
+        expect(p).toMatch(/\.claude[\/\\]skills[\/\\]hypertab[\/\\]SKILL\.md$/);
+    });
+});
+//# sourceMappingURL=platforms.test.js.map

package/dist/__tests__/platforms.test.js.map

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

package/dist/__tests__/uninstall.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=uninstall.test.d.ts.map

package/dist/__tests__/uninstall.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/uninstall.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/uninstall.test.js

@@ -0,0 +1,117 @@
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runUninstall } from '../install/uninstall.js';
+function captureStreams() {
+    const out = [];
+    const err = [];
+    return {
+        stdout: { write: (chunk) => out.push(chunk) },
+        stderr: { write: (chunk) => err.push(chunk) },
+        out,
+        err,
+    };
+}
+let workDir;
+function testPlatform(opts = {}) {
+    const id = opts.id ?? 'claude-code';
+    const configFile = join(workDir, `${id}.json`);
+    const skillFile = join(workDir, id, 'skill', 'SKILL.md');
+    return {
+        id,
+        name: id,
+        description: '',
+        supportsUserScope: true,
+        supportsProjectScope: true,
+        configPath: () => configFile,
+        serversKey: 'mcpServers',
+        serverName: 'hypertab',
+        buildServerEntry: (url, apiKey) => ({
+            type: 'http',
+            url,
+            headers: { Authorization: `Bearer ${apiKey}` },
+        }),
+        supportsSkill: opts.supportsSkill ?? true,
+        skillPath: (opts.supportsSkill ?? true) ? () => skillFile : undefined,
+        restartInstruction: 'Restart.',
+    };
+}
+function seedConfig(platform) {
+    const configFile = platform.configPath('user');
+    const skill = platform.skillPath?.('user');
+    const parent = dirname(configFile);
+    if (!existsSync(parent))
+        mkdirSync(parent, { recursive: true });
+    writeFileSync(configFile, JSON.stringify({
+        mcpServers: {
+            other: { command: 'keep-me' },
+            hypertab: { type: 'http', url: 'https://api.hypertab.ai/mcp' },
+        },
+    }, null, 2));
+    if (skill) {
+        const skillParent = dirname(skill);
+        if (!existsSync(skillParent))
+            mkdirSync(skillParent, { recursive: true });
+        writeFileSync(skill, '---\nname: hypertab\n---\nold skill\n');
+    }
+}
+beforeEach(() => {
+    workDir = mkdtempSync(join(tmpdir(), 'hypertab-uninstall-'));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe('runUninstall', () => {
+    it('removes the config entry and deletes the skill by default', async () => {
+        const platform = testPlatform();
+        seedConfig(platform);
+        const streams = captureStreams();
+        const code = await runUninstall({ platform, scope: 'user', ...streams });
+        expect(code).toBe(0);
+        const cfg = JSON.parse(readFileSync(platform.configPath('user'), 'utf8'));
+        expect(cfg.mcpServers.hypertab).toBeUndefined();
+        expect(cfg.mcpServers.other).toEqual({ command: 'keep-me' });
+        expect(existsSync(platform.skillPath('user'))).toBe(false);
+        const joined = streams.out.join('');
+        expect(joined).toContain('Uninstalled Hypertab MCP');
+        expect(joined).toContain('(removed');
+    });
+    it('keeps the skill file when --keep-skill is passed', async () => {
+        const platform = testPlatform();
+        seedConfig(platform);
+        const streams = captureStreams();
+        const code = await runUninstall({ platform, scope: 'user', keepSkill: true, ...streams });
+        expect(code).toBe(0);
+        expect(existsSync(platform.skillPath('user'))).toBe(true);
+        expect(streams.out.join('')).toContain('(kept, --keep-skill)');
+    });
+    it('reports "not-installed" when hypertab was never added', async () => {
+        const platform = testPlatform();
+        const configFile = platform.configPath('user');
+        writeFileSync(configFile, JSON.stringify({ mcpServers: { other: { command: 'x' } } }, null, 2));
+        const streams = captureStreams();
+        const code = await runUninstall({ platform, scope: 'user', ...streams });
+        expect(code).toBe(0);
+        const cfg = JSON.parse(readFileSync(configFile, 'utf8'));
+        expect(cfg.mcpServers.other).toEqual({ command: 'x' });
+        expect(streams.out.join('')).toContain('nothing to remove');
+    });
+    it('reports file-missing when the config file does not exist', async () => {
+        const platform = testPlatform();
+        const streams = captureStreams();
+        const code = await runUninstall({ platform, scope: 'user', ...streams });
+        expect(code).toBe(0);
+        expect(streams.out.join('')).toContain('file did not exist');
+    });
+    it('platforms without skill support report n/a for skill', async () => {
+        const platform = testPlatform({ id: 'cursor', supportsSkill: false });
+        seedConfig(platform);
+        const streams = captureStreams();
+        const code = await runUninstall({ platform, scope: 'user', ...streams });
+        expect(code).toBe(0);
+        const joined = streams.out.join('');
+        expect(joined).toContain('Skill:  n/a');
+    });
+});
+//# sourceMappingURL=uninstall.test.js.map

package/dist/__tests__/uninstall.test.js.map

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

package/dist/connect.d.ts

@@ -0,0 +1,8 @@
+export type TransportType = 'streamable-http' | 'sse' | 'stdio';
+export interface ConnectOptions {
+    apiKey: string;
+    url: string;
+    transport: TransportType;
+}
+export declare function runConnect(opts: ConnectOptions): Promise<number>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,KAAK,GAAG,OAAO,CAAA;AAE/D,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,aAAa,CAAA;CACxB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CtE"}

package/dist/connect.js

@@ -0,0 +1,49 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+export async function runConnect(opts) {
+    if (!opts.apiKey.startsWith('ht_sk_')) {
+        console.error('Error: API key must start with ht_sk_');
+        return 1;
+    }
+    try {
+        const client = new Client({ name: '@hypertabai/mcp', version: '0.2.0' }, { capabilities: {} });
+        if (opts.transport === 'stdio') {
+            const transport = new StdioClientTransport({ command: 'node', args: ['--version'] });
+            await client.connect(transport);
+        }
+        else if (opts.transport === 'sse') {
+            const transport = new SSEClientTransport(new URL(opts.url), {
+                requestInit: { headers: { Authorization: `Bearer ${opts.apiKey}` } },
+            });
+            await client.connect(transport);
+        }
+        else {
+            const transport = new StreamableHTTPClientTransport(new URL(opts.url), {
+                requestInit: { headers: { Authorization: `Bearer ${opts.apiKey}` } },
+            });
+            await client.connect(transport);
+        }
+        const tools = await client.listTools();
+        console.log(`Connected to Hypertab. ${tools.tools.length} tools available:`);
+        for (const tool of tools.tools) {
+            console.log(`  - ${tool.name}: ${tool.description?.slice(0, 80) ?? ''}`);
+        }
+        console.log('\nMCP client connected. Press Ctrl+C to disconnect.');
+        await new Promise((resolve) => {
+            process.on('SIGINT', () => {
+                console.log('\nDisconnecting...');
+                resolve();
+            });
+            process.on('SIGTERM', resolve);
+        });
+        await client.close();
+        return 0;
+    }
+    catch (err) {
+        console.error('Connection failed:', err instanceof Error ? err.message : err);
+        return 1;
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

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

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,78 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { runConnect } from './connect.js';
+import { runInstall } from './install/index.js';
+import { getPlatform, PLATFORM_IDS } from './install/platforms.js';
+import { runUninstall } from './install/uninstall.js';
+const DEFAULT_URL = 'https://api.hypertab.ai/mcp';
+const VERSION = '0.2.0';
+const program = new Command()
+    .name('hypertab')
+    .description('Hypertab MCP — install and run the Hypertab MCP server for any AI agent')
+    .version(VERSION);
+program
+    .command('install')
+    .description('Install the Hypertab MCP config (and skill where supported) for an AI agent')
+    .requiredOption('-c, --client <id>', `Target client: ${PLATFORM_IDS.join(' | ')}`)
+    .option('-k, --api-key <key>', 'Hypertab API key (ht_sk_...). Prefer HYPERTAB_API_KEY env var for safety.')
+    .option('-s, --scope <scope>', 'Config scope: user | project', 'user')
+    .option('-u, --url <url>', 'Override MCP server URL', DEFAULT_URL)
+    .option('--skill-url <url>', 'Override the Hypertab skill.md source URL (for self-hosted mirrors or testing)')
+    .action(async (opts) => {
+    const scope = opts.scope === 'project' ? 'project' : 'user';
+    let platform;
+    try {
+        platform = getPlatform(opts.client);
+    }
+    catch (e) {
+        process.stderr.write(`Error: ${e.message}\n`);
+        process.exit(1);
+    }
+    const code = await runInstall({
+        platform,
+        apiKey: opts.apiKey,
+        scope,
+        url: opts.url,
+        skillUrl: opts.skillUrl,
+    });
+    process.exit(code);
+});
+program
+    .command('uninstall')
+    .description('Remove the Hypertab MCP config (and skill where supported) from an AI agent')
+    .requiredOption('-c, --client <id>', `Target client: ${PLATFORM_IDS.join(' | ')}`)
+    .option('-s, --scope <scope>', 'Config scope: user | project', 'user')
+    .option('--keep-skill', 'Keep the installed skill file at ~/.claude/skills/hypertab/SKILL.md (Claude Code only)')
+    .action(async (opts) => {
+    const scope = opts.scope === 'project' ? 'project' : 'user';
+    let platform;
+    try {
+        platform = getPlatform(opts.client);
+    }
+    catch (e) {
+        process.stderr.write(`Error: ${e.message}\n`);
+        process.exit(1);
+    }
+    const code = await runUninstall({
+        platform,
+        scope,
+        keepSkill: opts.keepSkill,
+    });
+    process.exit(code);
+});
+program
+    .command('connect')
+    .description('Connect to Hypertab as an MCP client (for testing / debug)')
+    .requiredOption('-k, --api-key <key>', 'Hypertab API key (ht_sk_...)')
+    .option('-u, --url <url>', 'MCP server URL', DEFAULT_URL)
+    .option('-t, --transport <type>', 'Transport: streamable-http | sse | stdio', 'streamable-http')
+    .action(async (opts) => {
+    const code = await runConnect({
+        apiKey: opts.apiKey,
+        url: opts.url,
+        transport: opts.transport,
+    });
+    process.exit(code);
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map