@hypertabai/mcp 0.2.0

package/dist/index.js.map

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

package/dist/install/config-writer.d.ts

@@ -0,0 +1,49 @@
+import type { PlatformDef, Scope, ServerEntry } from './platforms.js';
+export interface WriteConfigOptions {
+    platform: PlatformDef;
+    scope: Scope;
+    entry: ServerEntry;
+}
+export interface WriteConfigResult {
+    path: string;
+    action: 'created' | 'updated' | 'no-change';
+    backupCreated: boolean;
+}
+/**
+ * Strip JS-style single-line `// ...` and block `/* ... *\/` comments from
+ * a JSON source. Claude Desktop and some editors tolerate JSONC-style comments,
+ * and we must not crash when re-reading a file that has them.
+ */
+export declare function stripJsonComments(src: string): string;
+export interface RemoveConfigOptions {
+    platform: PlatformDef;
+    scope: Scope;
+}
+export interface RemoveConfigResult {
+    path: string;
+    action: 'removed' | 'not-installed' | 'file-missing';
+    backupCreated: boolean;
+}
+/**
+ * Removes the Hypertab entry from a platform's MCP config file.
+ *
+ * Guarantees:
+ * - Never touches other servers in the same file.
+ * - Creates a `.bak` on first touch (once per file).
+ * - Atomic via `.tmp` + rename.
+ * - Idempotent: returns `not-installed` or `file-missing` with no disk writes.
+ * - If removing leaves an empty `mcpServers` map, leaves the empty map in
+ *   place rather than deleting the key — keeps user structure predictable.
+ */
+export declare function removePlatformConfig(opts: RemoveConfigOptions): RemoveConfigResult;
+/**
+ * Writes (or updates) the Hypertab entry in a platform's MCP config file.
+ *
+ * Guarantees:
+ * - Never clobbers other servers in the same file.
+ * - Creates a `.bak` on first touch (once per file).
+ * - Atomic via `.tmp` + rename.
+ * - Idempotent: returns `no-change` if the entry already matches.
+ */
+export declare function writePlatformConfig(opts: WriteConfigOptions): WriteConfigResult;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/install/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/install/config-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAErE,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,WAAW,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;IAC3C,aAAa,EAAE,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoCrD;AAoBD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;CACZ;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,eAAe,GAAG,cAAc,CAAA;IACpD,aAAa,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAuClF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAwC/E"}

package/dist/install/config-writer.js

@@ -0,0 +1,156 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * Strip JS-style single-line `// ...` and block `/* ... *\/` comments from
+ * a JSON source. Claude Desktop and some editors tolerate JSONC-style comments,
+ * and we must not crash when re-reading a file that has them.
+ */
+export function stripJsonComments(src) {
+    let result = '';
+    let i = 0;
+    let inString = false;
+    let escaped = false;
+    while (i < src.length) {
+        const ch = src[i];
+        const next = src[i + 1];
+        if (inString) {
+            result += ch;
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            result += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '/' && next === '/') {
+            while (i < src.length && src[i] !== '\n')
+                i += 1;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            i += 2;
+            while (i < src.length - 1 && !(src[i] === '*' && src[i + 1] === '/'))
+                i += 1;
+            i += 2;
+            continue;
+        }
+        result += ch;
+        i += 1;
+    }
+    return result;
+}
+function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = readFileSync(path, 'utf8');
+    if (!raw.trim())
+        return {};
+    try {
+        return JSON.parse(stripJsonComments(raw));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse existing config at ${path}: ${err.message}. ` +
+            'Fix the JSON syntax manually or delete the file and re-run.');
+    }
+}
+function deepEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * Removes the Hypertab entry from a platform's MCP config file.
+ *
+ * Guarantees:
+ * - Never touches other servers in the same file.
+ * - Creates a `.bak` on first touch (once per file).
+ * - Atomic via `.tmp` + rename.
+ * - Idempotent: returns `not-installed` or `file-missing` with no disk writes.
+ * - If removing leaves an empty `mcpServers` map, leaves the empty map in
+ *   place rather than deleting the key — keeps user structure predictable.
+ */
+export function removePlatformConfig(opts) {
+    const { platform, scope } = opts;
+    const path = platform.configPath(scope);
+    if (!existsSync(path)) {
+        return { path, action: 'file-missing', backupCreated: false };
+    }
+    const existing = readConfig(path);
+    const servers = existing[platform.serversKey] ?? {};
+    if (!(platform.serverName in servers)) {
+        return { path, action: 'not-installed', backupCreated: false };
+    }
+    const nextServers = { ...servers };
+    delete nextServers[platform.serverName];
+    const next = {
+        ...existing,
+        [platform.serversKey]: nextServers,
+    };
+    let backupCreated = false;
+    const backupPath = `${path}.bak`;
+    if (!existsSync(backupPath)) {
+        try {
+            writeFileSync(backupPath, readFileSync(path));
+            backupCreated = true;
+        }
+        catch {
+            // Non-fatal; continue without the backup.
+        }
+    }
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(next, null, 2)}\n`);
+    renameSync(tmp, path);
+    return { path, action: 'removed', backupCreated };
+}
+/**
+ * Writes (or updates) the Hypertab entry in a platform's MCP config file.
+ *
+ * Guarantees:
+ * - Never clobbers other servers in the same file.
+ * - Creates a `.bak` on first touch (once per file).
+ * - Atomic via `.tmp` + rename.
+ * - Idempotent: returns `no-change` if the entry already matches.
+ */
+export function writePlatformConfig(opts) {
+    const { platform, scope, entry } = opts;
+    const path = platform.configPath(scope);
+    const existed = existsSync(path);
+    const existing = readConfig(path);
+    const servers = existing[platform.serversKey] ?? {};
+    const previousEntry = servers[platform.serverName];
+    if (existed && previousEntry && deepEqual(previousEntry, entry)) {
+        return { path, action: 'no-change', backupCreated: false };
+    }
+    const next = {
+        ...existing,
+        [platform.serversKey]: {
+            ...servers,
+            [platform.serverName]: entry,
+        },
+    };
+    const parent = dirname(path);
+    if (!existsSync(parent))
+        mkdirSync(parent, { recursive: true });
+    let backupCreated = false;
+    const backupPath = `${path}.bak`;
+    if (existed && !existsSync(backupPath)) {
+        try {
+            writeFileSync(backupPath, readFileSync(path));
+            backupCreated = true;
+        }
+        catch {
+            // Non-fatal; continue without the backup.
+        }
+    }
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(next, null, 2)}\n`);
+    renameSync(tmp, path);
+    return { path, action: existed ? 'updated' : 'created', backupCreated };
+}
+//# sourceMappingURL=config-writer.js.map

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

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

package/dist/install/index.d.ts

@@ -0,0 +1,17 @@
+import { getPlatform, PLATFORM_IDS, type PlatformDef, type Scope } from './platforms.js';
+export interface InstallOptions {
+    /** Resolved platform. Callers (CLI) use getPlatform() to resolve from a string id. */
+    platform: PlatformDef;
+    apiKey?: string;
+    scope?: Scope;
+    url?: string;
+    skillUrl?: string;
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+    env?: NodeJS.ProcessEnv;
+    promptFn?: (question: string) => Promise<string>;
+    fetchImpl?: typeof fetch;
+}
+export declare function runInstall(opts: InstallOptions): Promise<number>;
+export { getPlatform, PLATFORM_IDS };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,WAAW,EAAoB,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAK1G,MAAM,WAAW,cAAc;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,WAAW,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAChD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACxB;AA2BD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAqEtE;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA"}

package/dist/install/index.js

@@ -0,0 +1,94 @@
+import { createInterface } from 'node:readline';
+import { writePlatformConfig } from './config-writer.js';
+import { getPlatform, PLATFORM_IDS, resolveCanonical } from './platforms.js';
+import { DEFAULT_SKILL_URL, installSkill } from './skill-writer.js';
+const DEFAULT_URL = 'https://api.hypertab.ai/mcp';
+function maskKey(key) {
+    if (!key)
+        return '(empty)';
+    if (key.length <= 10)
+        return `${key.slice(0, 4)}…`;
+    return `${key.slice(0, 10)}…${key.slice(-4)}`;
+}
+async function defaultPrompt(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function resolveApiKey(opts) {
+    if (opts.apiKey)
+        return { key: opts.apiKey.trim(), source: 'flag' };
+    const env = opts.env ?? process.env;
+    if (env.HYPERTAB_API_KEY)
+        return { key: env.HYPERTAB_API_KEY.trim(), source: 'env' };
+    const prompt = opts.promptFn ?? defaultPrompt;
+    const answer = await prompt('Enter your Hypertab API key (ht_sk_...): ');
+    return { key: answer.trim(), source: 'prompt' };
+}
+export async function runInstall(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;
+    const { key, source } = await resolveApiKey(opts);
+    if (!key.startsWith('ht_sk_')) {
+        err.write(`Error: API key must start with 'ht_sk_'. Got: ${maskKey(key)}\n`);
+        return 1;
+    }
+    if (source === 'flag') {
+        err.write('Tip: HYPERTAB_API_KEY env var is safer than --api-key for CI and shared machines.\n');
+    }
+    const url = opts.url ?? DEFAULT_URL;
+    const entry = canonical.buildServerEntry(url, key);
+    let configResult;
+    try {
+        configResult = writePlatformConfig({ platform: canonical, scope, entry });
+    }
+    catch (writeErr) {
+        err.write(`Error writing config: ${writeErr.message}\n`);
+        return 1;
+    }
+    const skillResult = await installSkill({
+        platform: canonical,
+        scope,
+        skillUrl: opts.skillUrl ?? DEFAULT_SKILL_URL,
+        fetchImpl: opts.fetchImpl,
+    });
+    const lines = [];
+    lines.push('');
+    lines.push(`\u2713 Installed Hypertab MCP for ${platform.name}${platform.aliasOf ? ` (writes to ${canonical.name} config)` : ''}`);
+    lines.push(`  Key:    ${maskKey(key)}`);
+    lines.push(`  Config: ${configResult.path} (${configResult.action}${configResult.backupCreated ? ', backup saved as .bak' : ''})`);
+    if (skillResult.action === 'installed' || skillResult.action === 'up-to-date') {
+        lines.push(`  Skill:  ${skillResult.path} (${skillResult.action})`);
+    }
+    else if (skillResult.action === 'unsupported') {
+        lines.push(`  Skill:  skipped (${skillResult.reason})`);
+    }
+    else if (skillResult.action === 'skipped-fetch-failed') {
+        lines.push(`  Skill:  FAILED — ${skillResult.reason}`);
+    }
+    if (platform.note)
+        lines.push(`  Note:   ${platform.note}`);
+    lines.push('');
+    lines.push(platform.restartInstruction);
+    lines.push('');
+    out.write(lines.join('\n'));
+    return 0;
+}
+export { getPlatform, PLATFORM_IDS };
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

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

package/dist/install/platforms.d.ts

@@ -0,0 +1,38 @@
+export type Scope = 'user' | 'project';
+export interface ServerEntry {
+    type?: string;
+    url?: string;
+    serverUrl?: string;
+    headers?: Record<string, string>;
+}
+export interface PlatformDef {
+    id: string;
+    name: string;
+    description: string;
+    supportsUserScope: boolean;
+    supportsProjectScope: boolean;
+    /** Absolute path to the config file for a given scope. Throws if scope unsupported. */
+    configPath(scope: Scope): string;
+    /** Top-level JSON key containing the server map (e.g. 'mcpServers', 'servers'). */
+    serversKey: string;
+    /** Identifier used when adding hypertab to the server map. */
+    serverName: string;
+    /** Builds the per-platform entry shape for a given URL + API key. */
+    buildServerEntry(url: string, apiKey: string): ServerEntry;
+    /** Whether this platform supports Hypertab skills (Claude Code and aliases only today). */
+    supportsSkill: boolean;
+    /** Where to install the skill, if supported. */
+    skillPath?(scope: Scope): string;
+    /** Human-readable restart instruction printed after install. */
+    restartInstruction: string;
+    /** If set, this is a display alias that writes to the canonical platform's config. */
+    aliasOf?: string;
+    /** Optional note shown in the CLI output when installing. */
+    note?: string;
+}
+export declare const PLATFORMS: Record<string, PlatformDef>;
+export declare const PLATFORM_IDS: string[];
+export declare function getPlatform(id: string): PlatformDef;
+/** Resolves display aliases (vscode, cowork) to their canonical platform. */
+export declare function resolveCanonical(platform: PlatformDef): PlatformDef;
+//# sourceMappingURL=platforms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platforms.d.ts","sourceRoot":"","sources":["../../src/install/platforms.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;AAEtC,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,uFAAuF;IACvF,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;IAChC,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1D,2FAA2F;IAC3F,aAAa,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;IAChC,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAmJD,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAQjD,CAAA;AAED,eAAO,MAAM,YAAY,UAAyB,CAAA;AAElD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAMnD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,CAGnE"}

package/dist/install/platforms.js

@@ -0,0 +1,162 @@
+import { homedir, platform as osPlatform } from 'node:os';
+import { join } from 'node:path';
+// Path helpers ----------------------------------------------------------------
+const HOME = homedir();
+const PLATFORM = osPlatform();
+const IS_MAC = PLATFORM === 'darwin';
+const IS_WIN = PLATFORM === 'win32';
+function appDataDir() {
+    if (IS_WIN)
+        return process.env.APPDATA ?? join(HOME, 'AppData', 'Roaming');
+    return HOME;
+}
+function claudeDesktopConfigPath() {
+    if (IS_MAC)
+        return join(HOME, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    if (IS_WIN)
+        return join(appDataDir(), 'Claude', 'claude_desktop_config.json');
+    return join(HOME, '.config', 'Claude', 'claude_desktop_config.json');
+}
+// Per-platform server entry builders -----------------------------------------
+function httpBearerEntry(url, apiKey) {
+    return { type: 'http', url, headers: { Authorization: `Bearer ${apiKey}` } };
+}
+function cursorEntry(url, apiKey) {
+    return { url, headers: { Authorization: `Bearer ${apiKey}` } };
+}
+function windsurfEntry(url, apiKey) {
+    return { serverUrl: url, headers: { Authorization: `Bearer ${apiKey}` } };
+}
+// Canonical platforms --------------------------------------------------------
+const claudeCode = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    description: "Anthropic's CLI. Also used by the VS Code and Cowork plugins.",
+    supportsUserScope: true,
+    supportsProjectScope: true,
+    configPath(scope) {
+        if (scope === 'user')
+            return join(HOME, '.claude.json');
+        return join(process.cwd(), '.mcp.json');
+    },
+    serversKey: 'mcpServers',
+    serverName: 'hypertab',
+    buildServerEntry: httpBearerEntry,
+    supportsSkill: true,
+    skillPath(scope) {
+        if (scope === 'user')
+            return join(HOME, '.claude', 'skills', 'hypertab', 'SKILL.md');
+        return join(process.cwd(), '.claude', 'skills', 'hypertab', 'SKILL.md');
+    },
+    restartInstruction: 'Restart Claude Code to load the new server (quit the app or run `claude` again).',
+};
+const claudeDesktop = {
+    id: 'claude-desktop',
+    name: 'Claude Desktop',
+    description: "Anthropic's macOS / Windows / Linux desktop app.",
+    supportsUserScope: true,
+    supportsProjectScope: false,
+    configPath(scope) {
+        if (scope !== 'user')
+            throw new Error('claude-desktop only supports user scope');
+        return claudeDesktopConfigPath();
+    },
+    serversKey: 'mcpServers',
+    serverName: 'hypertab',
+    buildServerEntry: httpBearerEntry,
+    supportsSkill: false,
+    restartInstruction: 'Quit Claude Desktop (Cmd+Q on macOS) and reopen it to load the new server.',
+};
+const cursor = {
+    id: 'cursor',
+    name: 'Cursor',
+    description: 'Cursor AI-native code editor.',
+    supportsUserScope: true,
+    supportsProjectScope: true,
+    configPath(scope) {
+        if (scope === 'user')
+            return join(HOME, '.cursor', 'mcp.json');
+        return join(process.cwd(), '.cursor', 'mcp.json');
+    },
+    serversKey: 'mcpServers',
+    serverName: 'hypertab',
+    buildServerEntry: cursorEntry,
+    supportsSkill: false,
+    restartInstruction: 'Restart Cursor (quit and reopen) to load the new server.',
+};
+const windsurf = {
+    id: 'windsurf',
+    name: 'Windsurf',
+    description: "Codeium's AI IDE.",
+    supportsUserScope: true,
+    supportsProjectScope: false,
+    configPath(scope) {
+        if (scope !== 'user')
+            throw new Error('windsurf only supports user scope');
+        return join(HOME, '.codeium', 'windsurf', 'mcp_config.json');
+    },
+    serversKey: 'mcpServers',
+    serverName: 'hypertab',
+    buildServerEntry: windsurfEntry,
+    supportsSkill: false,
+    restartInstruction: 'Restart Windsurf (quit and reopen) to load the new server.',
+};
+const antigravity = {
+    id: 'antigravity',
+    name: 'Antigravity',
+    description: "Google's AI coding IDE.",
+    supportsUserScope: true,
+    supportsProjectScope: true,
+    configPath(scope) {
+        if (scope === 'user')
+            return join(HOME, '.antigravity', 'mcp.json');
+        return join(process.cwd(), '.antigravity', 'mcp.json');
+    },
+    serversKey: 'mcpServers',
+    serverName: 'hypertab',
+    buildServerEntry: httpBearerEntry,
+    supportsSkill: false,
+    restartInstruction: 'Restart Antigravity (quit and reopen) to load the new server.',
+    note: 'Antigravity MCP support is still evolving. If the server does not appear after restart, verify the config path and shape against the Antigravity docs.',
+};
+// Display aliases ------------------------------------------------------------
+const vscode = {
+    ...claudeCode,
+    id: 'vscode',
+    name: 'VS Code',
+    description: 'Uses the Claude Code plugin config.',
+    aliasOf: 'claude-code',
+    note: 'VS Code uses the Claude Code plugin, which reads the same config file as standalone Claude Code.',
+};
+const cowork = {
+    ...claudeCode,
+    id: 'cowork',
+    name: 'Claude Cowork',
+    description: 'Anthropic collaborative Claude Code environment.',
+    aliasOf: 'claude-code',
+};
+// Registry -------------------------------------------------------------------
+export const PLATFORMS = {
+    'claude-code': claudeCode,
+    'claude-desktop': claudeDesktop,
+    cursor,
+    windsurf,
+    antigravity,
+    vscode,
+    cowork,
+};
+export const PLATFORM_IDS = Object.keys(PLATFORMS);
+export function getPlatform(id) {
+    const p = PLATFORMS[id];
+    if (!p) {
+        throw new Error(`Unknown client '${id}'. Supported: ${PLATFORM_IDS.join(', ')}`);
+    }
+    return p;
+}
+/** Resolves display aliases (vscode, cowork) to their canonical platform. */
+export function resolveCanonical(platform) {
+    if (!platform.aliasOf)
+        return platform;
+    return getPlatform(platform.aliasOf);
+}
+//# sourceMappingURL=platforms.js.map

package/dist/install/platforms.js.map

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

package/dist/install/skill-writer.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformDef, Scope } from './platforms.js';
+export declare const DEFAULT_SKILL_URL = "https://hypertab.ai/skill.md";
+export interface SkillInstallOptions {
+    platform: PlatformDef;
+    scope: Scope;
+    skillUrl?: string;
+    fetchImpl?: typeof fetch;
+    retries?: number;
+}
+export interface SkillInstallResult {
+    action: 'installed' | 'up-to-date' | 'unsupported' | 'skipped-fetch-failed';
+    path?: string;
+    reason?: string;
+}
+/**
+ * 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 declare function installSkill(opts: SkillInstallOptions): Promise<SkillInstallResult>;
+//# sourceMappingURL=skill-writer.d.ts.map

package/dist/install/skill-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-writer.d.ts","sourceRoot":"","sources":["../../src/install/skill-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAExD,eAAO,MAAM,iBAAiB,iCAAiC,CAAA;AAE/D,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,WAAW,CAAA;IACrB,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,sBAAsB,CAAA;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAyCD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmCzF"}