@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/cli/invocation-decision.js

@@ -0,0 +1,86 @@
+/**
+ * Pure decision core for the `bin/yt-builder-mcp.js` dispatcher.
+ *
+ * The bin is a thin JS shim (not type-checked, not linted) so the
+ * branching logic that decides what a given invocation should DO lives
+ * here, in a typed + tested + covered module. The shim imports the
+ * compiled `dist/cli/invocation-decision.js` and acts on the verdict.
+ *
+ * Three outcomes:
+ *   - 'cli'    → a known subcommand (setup / uninstall / add-site / …):
+ *                forward argv to the setup-cli dispatcher.
+ *   - 'hint'   → no or unknown subcommand AND stdin is an interactive
+ *                TTY (a human ran the bin directly): print the
+ *                discoverability hint to stderr and exit 0, rather than
+ *                silently blocking on the stdio read loop ("hang").
+ *   - 'server' → no or unknown subcommand AND stdin is NOT a TTY (a real
+ *                MCP client piping JSON-RPC over stdin): boot the stdio
+ *                server. This path MUST stay byte-for-byte equivalent to
+ *                the pre-hint behaviour — the guard is strict on isTTY so
+ *                the client path is never diverted.
+ *
+ * @license MIT
+ */
+/**
+ * Canonical set of subcommands handled by the setup-cli dispatcher.
+ *
+ * Mirrors `CLI_SUBCOMMANDS` in `bin/yt-builder-mcp.js`. Kept frozen so a
+ * consumer cannot mutate the shared decision surface at runtime.
+ */
+export const KNOWN_SUBCOMMANDS = Object.freeze(new Set([
+    'setup',
+    'install-skill',
+    'install',
+    // Reverse-of-setup: remove our server entry + optional skill.
+    'uninstall',
+    'remove',
+    // W9 multi-site CLI subcommands.
+    'add-site',
+    'list-sites',
+    'remove-site',
+    'set-default',
+    'test-site',
+    'help',
+    '--help',
+    '-h',
+    '--version',
+    '-v',
+]));
+/**
+ * Discoverability hint printed to stderr when a human runs the bin
+ * directly (no/unknown subcommand at an interactive TTY). stderr, not
+ * stdout, so it never contaminates a JSON-RPC frame if redirected.
+ */
+export const BARE_INVOCATION_HINT = [
+    'This is the YT Builder MCP server (stdio), normally launched by your',
+    "AI client, not run directly — that's why it waits.",
+    'Did you mean `npx -y @wootsup/yt-builder-mcp setup`?',
+    'See also: uninstall, help.',
+].join(' ');
+/**
+ * True when `sub` is a subcommand the setup-cli dispatcher handles.
+ * `undefined` (no argument) is never a known subcommand.
+ */
+export function isKnownSubcommand(sub) {
+    return sub !== undefined && KNOWN_SUBCOMMANDS.has(sub);
+}
+/**
+ * Decide the bin action from the first CLI argument and whether stdin is
+ * an interactive TTY.
+ *
+ * @param subcommand  argv[2], or undefined when no argument was passed.
+ * @param stdinIsTTY  `process.stdin.isTTY` — `true` only for an
+ *                    interactive human terminal; `false`/`undefined` for
+ *                    a piped stream (which is how every MCP client runs
+ *                    the server). The guard is STRICT: only `=== true`
+ *                    yields the hint, so the MCP-client path is never
+ *                    diverted.
+ */
+export function decideInvocation(subcommand, stdinIsTTY) {
+    if (isKnownSubcommand(subcommand)) {
+        return 'cli';
+    }
+    // No / unknown subcommand. Only an interactive human gets the hint.
+    return stdinIsTTY === true ? 'hint' : 'server';
+}
+//# sourceMappingURL=invocation-decision.js.map

package/dist/cli/invocation-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-decision.js","sourceRoot":"","sources":["../../src/cli/invocation-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB,MAAM,CAAC,MAAM,CAC/D,IAAI,GAAG,CAAS;IACZ,OAAO;IACP,eAAe;IACf,SAAS;IACT,8DAA8D;IAC9D,WAAW;IACX,QAAQ;IACR,iCAAiC;IACjC,UAAU;IACV,YAAY;IACZ,aAAa;IACb,aAAa;IACb,WAAW;IACX,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,WAAW;IACX,IAAI;CACP,CAAC,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAW;IACxC,sEAAsE;IACtE,oDAAoD;IACpD,sDAAsD;IACtD,4BAA4B;CAC/B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAKZ;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAuB;IACrD,OAAO,GAAG,KAAK,SAAS,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC5B,UAA8B,EAC9B,UAA+B;IAE/B,IAAI,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,oEAAoE;IACpE,OAAO,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnD,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * `RestClient` — thin wrapper around `fetch` that targets the
+ * `yt-builder-mcp/v1` REST namespace.
+ *
+ * Responsibilities:
+ *   - Compose final URLs (`{baseUrl}/wp-json/yt-builder-mcp/v1{path}`)
+ *   - Attach `Authorization: Bearer …`
+ *   - Encode JSON bodies + propagate `If-Match` etag headers
+ *   - Map non-2xx into `RestError` with status / `code` / message
+ *   - Map network failures into `NetworkError`
+ *
+ * The client deliberately keeps zero state beyond constructor config
+ * so each tool can hold a reference and call `.get/.post/.put/.delete`
+ * without coordinating sessions.
+ *
+ * @license MIT
+ */
+import type { Platform } from './platform/index.js';
+/**
+ * Canonical WordPress REST-namespace path. Re-exported for backward
+ * compat — new code should reach for `Platform.restNamespacePath`.
+ */
+export declare const REST_NAMESPACE_PATH = "/wp-json/yt-builder-mcp/v1";
+/**
+ * Legacy single-platform options shape. Kept so existing call-sites
+ * continue working without touching every entry point.
+ */
+export interface LegacyRestClientOptions {
+    readonly baseUrl: string;
+    readonly bearerToken: string;
+    readonly timeoutMs?: number;
+    /** Injected for tests. Defaults to `globalThis.fetch`. */
+    readonly fetch?: typeof fetch;
+}
+/**
+ * Platform-aware options shape (Wave G.0+).
+ * Pass an instance of `WordPressPlatform` (or any future `Platform`)
+ * instead of a bare `baseUrl`.
+ */
+export interface PlatformRestClientOptions {
+    readonly platform: Platform;
+    readonly bearerToken: string;
+    readonly timeoutMs?: number;
+    /** Injected for tests. Defaults to `globalThis.fetch`. */
+    readonly fetch?: typeof fetch;
+}
+/** Discriminated union: callers pick whichever shape suits them. */
+export type RestClientOptions = LegacyRestClientOptions | PlatformRestClientOptions;
+export interface RequestOptions {
+    /** Optional ETag for optimistic-lock (`If-Match` header). */
+    readonly etag?: string;
+    /** JSON body. */
+    readonly body?: unknown;
+    /** Extra headers. */
+    readonly headers?: Record<string, string>;
+    /** Optional AbortSignal. */
+    readonly signal?: AbortSignal;
+}
+export declare class RestClient {
+    private readonly platform;
+    private readonly baseUrl;
+    private readonly bearerToken;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: RestClientOptions);
+    /** Expose the underlying platform (used by tools that need restNamespacePath/kind). */
+    getPlatform(): Platform;
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    post<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    put<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    request<T = unknown>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    private buildUrl;
+}
+/**
+ * URL-encode a JSON-Pointer-style element path for use in the route.
+ *
+ * The plugin's regex captures everything after `/elements/`, so the
+ * raw `/grid/1/columns/0` path can be passed as-is — but each segment
+ * must be percent-encoded so reserved chars like `~` (used in
+ * JSON-Pointer escapes) don't collide with WordPress' router.
+ */
+export declare function encodeElementPath(pointer: string): string;
+/**
+ * URL-encode a `template_id` path segment.
+ *
+ * Per RFC 3986 §3.3 `pchar = unreserved / pct-encoded / sub-delims / ":" /
+ * "@"`, the colon is a valid raw character inside a path segment. The
+ * plugin route regex on both platforms accepts it directly
+ * ({@see ElementsController::register_routes() char class
+ * `[A-Za-z0-9_:-]+`}, and the Joomla `templateId` rule
+ * `[A-Za-z0-9_:-]{1,32}`).
+ *
+ * However, WordPress' rewrite rules pass the rest of the path through to
+ * the `rest_route` query var WITHOUT percent-decoding `%3A`, so when the
+ * REST router compares the route regex against the raw rest_route value,
+ * `%3A` doesn't match `:`. We therefore percent-encode every reserved
+ * character EXCEPT `:` so URLs like `/pages/page:3290/elements` round-trip
+ * to the server with the literal colon intact.
+ *
+ * `encodeURIComponent` is normally the right choice here (path-segment
+ * safety), but it eagerly encodes `:` to `%3A` since the colon is a
+ * gen-delim outside path-segment context. We restore the literal `:`
+ * post-encode. This fix unblocks the agent flow:
+ *
+ *   pages_create → returns `template_id: "page:3290"`
+ *   element_add → route URL `/pages/page:3290/elements` MUST match.
+ *
+ * Task #35 (2026-05-29): E3 live-verify discovered the gap.
+ */
+export declare function encodeTemplateId(templateId: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,+BAAgC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACjC;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,yBAAyB,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CACjC;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,iBAAiB;IAYtC,uFAAuF;IACvF,WAAW,IAAI,QAAQ;IAIvB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxE,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE,OAAO,CAAC,CAAC,GAAG,OAAO,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,CAAC,CAAC;IAgDb,OAAO,CAAC,QAAQ;CAInB;AAgCD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAczD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/client.js

@@ -0,0 +1,190 @@
+/**
+ * `RestClient` — thin wrapper around `fetch` that targets the
+ * `yt-builder-mcp/v1` REST namespace.
+ *
+ * Responsibilities:
+ *   - Compose final URLs (`{baseUrl}/wp-json/yt-builder-mcp/v1{path}`)
+ *   - Attach `Authorization: Bearer …`
+ *   - Encode JSON bodies + propagate `If-Match` etag headers
+ *   - Map non-2xx into `RestError` with status / `code` / message
+ *   - Map network failures into `NetworkError`
+ *
+ * The client deliberately keeps zero state beyond constructor config
+ * so each tool can hold a reference and call `.get/.post/.put/.delete`
+ * without coordinating sessions.
+ *
+ * @license MIT
+ */
+import { NetworkError, RestError } from './errors.js';
+import { WordPressPlatform, WORDPRESS_REST_NAMESPACE_PATH } from './platform/index.js';
+/**
+ * Canonical WordPress REST-namespace path. Re-exported for backward
+ * compat — new code should reach for `Platform.restNamespacePath`.
+ */
+export const REST_NAMESPACE_PATH = WORDPRESS_REST_NAMESPACE_PATH;
+export class RestClient {
+    platform;
+    baseUrl;
+    bearerToken;
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        // Dual-form: accept either a `Platform` or a legacy `baseUrl`.
+        const platform = isPlatformOptions(options)
+            ? options.platform
+            : new WordPressPlatform(options.baseUrl);
+        this.platform = platform;
+        this.baseUrl = platform.baseUrl.replace(/\/+$/, '');
+        this.bearerToken = options.bearerToken;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    /** Expose the underlying platform (used by tools that need restNamespacePath/kind). */
+    getPlatform() {
+        return this.platform;
+    }
+    get(path, options = {}) {
+        return this.request('GET', path, options);
+    }
+    post(path, options = {}) {
+        return this.request('POST', path, options);
+    }
+    put(path, options = {}) {
+        return this.request('PUT', path, options);
+    }
+    delete(path, options = {}) {
+        return this.request('DELETE', path, options);
+    }
+    async request(method, path, options = {}) {
+        const url = this.buildUrl(path);
+        const headers = {
+            Authorization: `Bearer ${this.bearerToken}`,
+            Accept: 'application/json',
+            ...(options.headers ?? {}),
+        };
+        if (options.etag !== undefined && options.etag !== '') {
+            headers['If-Match'] = options.etag;
+        }
+        const init = { method, headers };
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(options.body);
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        if (options.signal !== undefined) {
+            options.signal.addEventListener('abort', () => controller.abort());
+        }
+        init.signal = controller.signal;
+        let response;
+        try {
+            response = await this.fetchImpl(url, init);
+        }
+        catch (e) {
+            throw new NetworkError({ cause: e, url });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        const text = await response.text();
+        const parsed = parseJsonSafe(text);
+        if (!response.ok) {
+            throw new RestError({
+                status: response.status,
+                code: extractErrorCode(parsed),
+                message: extractErrorMessage(parsed, response.statusText),
+                body: parsed,
+            });
+        }
+        return parsed;
+    }
+    buildUrl(path) {
+        const normalized = path.startsWith('/') ? path : `/${path}`;
+        return `${this.baseUrl}${this.platform.restNamespacePath}${normalized}`;
+    }
+}
+/** Type guard — discriminate between the two RestClientOptions shapes. */
+function isPlatformOptions(opts) {
+    return 'platform' in opts && opts.platform !== undefined;
+}
+function parseJsonSafe(text) {
+    if (text.trim() === '')
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function extractErrorCode(body) {
+    if (body !== null && typeof body === 'object' && 'code' in body) {
+        const code = body.code;
+        if (typeof code === 'string')
+            return code;
+    }
+    return undefined;
+}
+function extractErrorMessage(body, fallback) {
+    if (body !== null && typeof body === 'object' && 'message' in body) {
+        const msg = body.message;
+        if (typeof msg === 'string' && msg !== '')
+            return msg;
+    }
+    return fallback !== '' ? fallback : 'Unknown REST error';
+}
+/**
+ * URL-encode a JSON-Pointer-style element path for use in the route.
+ *
+ * The plugin's regex captures everything after `/elements/`, so the
+ * raw `/grid/1/columns/0` path can be passed as-is — but each segment
+ * must be percent-encoded so reserved chars like `~` (used in
+ * JSON-Pointer escapes) don't collide with WordPress' router.
+ */
+export function encodeElementPath(pointer) {
+    if (pointer === '' || pointer === '/')
+        return '';
+    // Strip leading slash, split, encode each segment, rejoin.
+    // Task #39 (2026-05-29): restore literal `:` per segment so a
+    // fully-qualified pointer that embeds a per-page template id
+    // (`/templates/page:3315/layout/...`) survives the round-trip
+    // without `page%3A3315` landing in the server-side pointer
+    // assertion. Mirrors encodeTemplateId. `:` is a valid pchar
+    // (RFC 3986 §3.3) and WP REST route captures treat the segment
+    // as opaque text — leaving `:` literal is the safest restore.
+    const segments = pointer.replace(/^\//, '').split('/');
+    return segments
+        .map((s) => encodeURIComponent(s).replace(/%3A/g, ':'))
+        .join('/');
+}
+/**
+ * URL-encode a `template_id` path segment.
+ *
+ * Per RFC 3986 §3.3 `pchar = unreserved / pct-encoded / sub-delims / ":" /
+ * "@"`, the colon is a valid raw character inside a path segment. The
+ * plugin route regex on both platforms accepts it directly
+ * ({@see ElementsController::register_routes() char class
+ * `[A-Za-z0-9_:-]+`}, and the Joomla `templateId` rule
+ * `[A-Za-z0-9_:-]{1,32}`).
+ *
+ * However, WordPress' rewrite rules pass the rest of the path through to
+ * the `rest_route` query var WITHOUT percent-decoding `%3A`, so when the
+ * REST router compares the route regex against the raw rest_route value,
+ * `%3A` doesn't match `:`. We therefore percent-encode every reserved
+ * character EXCEPT `:` so URLs like `/pages/page:3290/elements` round-trip
+ * to the server with the literal colon intact.
+ *
+ * `encodeURIComponent` is normally the right choice here (path-segment
+ * safety), but it eagerly encodes `:` to `%3A` since the colon is a
+ * gen-delim outside path-segment context. We restore the literal `:`
+ * post-encode. This fix unblocks the agent flow:
+ *
+ *   pages_create → returns `template_id: "page:3290"`
+ *   element_add → route URL `/pages/page:3290/elements` MUST match.
+ *
+ * Task #35 (2026-05-29): E3 live-verify discovered the gap.
+ */
+export function encodeTemplateId(templateId) {
+    return encodeURIComponent(templateId).replace(/%3A/g, ':');
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/clients/claude-code.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Claude Code (Anthropic CLI) config writer.
+ *
+ *   All platforms: ~/.claude.json (single file)
+ *
+ * Schema mirrors Claude Desktop's `mcpServers` map:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "<name>": { "command": "npx", "args": [...], "env": {...} }
+ *     }
+ *   }
+ *
+ * @license MIT
+ */
+import { type ClientWriter } from './index.js';
+export declare const claudeCodeClient: ClientWriter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/clients/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAIH,KAAK,YAAY,EAEpB,MAAM,YAAY,CAAC;AAgBpB,eAAO,MAAM,gBAAgB,EAAE,YAuB9B,CAAC"}

package/dist/clients/claude-code.js

@@ -0,0 +1,55 @@
+/**
+ * Claude Code (Anthropic CLI) config writer.
+ *
+ *   All platforms: ~/.claude.json (single file)
+ *
+ * Schema mirrors Claude Desktop's `mcpServers` map:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "<name>": { "command": "npx", "args": [...], "env": {...} }
+ *     }
+ *   }
+ *
+ * @license MIT
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { userHome } from './home.js';
+import { detectInServerMap, patchJsonFile, removeFromServerMap, } from './index.js';
+function configPath() {
+    return join(userHome(), '.claude.json');
+}
+/**
+ * Detection: either the user-config file already exists, or the
+ * `~/.claude/` directory does (Claude Code creates it on first run
+ * for skills, transcripts, etc., even before the JSON file lands).
+ */
+function isDetected() {
+    const home = userHome();
+    return existsSync(join(home, '.claude.json')) || existsSync(join(home, '.claude'));
+}
+export const claudeCodeClient = {
+    id: 'claude-code',
+    label: 'Claude Code',
+    configPath,
+    isDetected,
+    apply: async (serverName, config) => {
+        await patchJsonFile(configPath(), (current) => {
+            const servers = current.mcpServers !== null &&
+                typeof current.mcpServers === 'object' &&
+                !Array.isArray(current.mcpServers)
+                ? { ...current.mcpServers }
+                : {};
+            servers[serverName] = {
+                command: config.command,
+                args: config.args,
+                env: config.env,
+            };
+            return { ...current, mcpServers: servers };
+        });
+    },
+    detect: () => detectInServerMap(configPath(), 'mcpServers'),
+    remove: () => removeFromServerMap(configPath(), 'mcpServers'),
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/clients/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACH,iBAAiB,EACjB,aAAa,EACb,mBAAmB,GAGtB,MAAM,YAAY,CAAC;AAEpB,SAAS,UAAU;IACf,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU;IACf,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC1C,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,aAAa;IACpB,UAAU;IACV,UAAU;IACV,KAAK,EAAE,KAAK,EAAE,UAAkB,EAAE,MAAuB,EAAE,EAAE;QACzD,MAAM,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE;YAC1C,MAAM,OAAO,GACT,OAAO,CAAC,UAAU,KAAK,IAAI;gBAC3B,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;gBACtC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9B,CAAC,CAAC,EAAE,GAAI,OAAO,CAAC,UAAsC,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,UAAU,CAAC,GAAG;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;aAClB,CAAC;YACF,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC;IAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC;CAChE,CAAC"}

package/dist/clients/claude-desktop.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Claude Desktop config writer.
+ *
+ *   macOS:    ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   Windows:  %APPDATA%\Claude\claude_desktop_config.json
+ *   Linux:    ~/.config/Claude/claude_desktop_config.json (unofficial)
+ *
+ * Schema:
+ *   {
+ *     "mcpServers": {
+ *       "<name>": { "command": "npx", "args": [...], "env": {...} }
+ *     }
+ *   }
+ *
+ * @license MIT
+ */
+import { type ClientWriter } from './index.js';
+export declare const claudeDesktopClient: ClientWriter;
+//# sourceMappingURL=claude-desktop.d.ts.map

package/dist/clients/claude-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAIH,KAAK,YAAY,EAEpB,MAAM,YAAY,CAAC;AAgBpB,eAAO,MAAM,mBAAmB,EAAE,YAuBjC,CAAC"}

package/dist/clients/claude-desktop.js

@@ -0,0 +1,58 @@
+/**
+ * Claude Desktop config writer.
+ *
+ *   macOS:    ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   Windows:  %APPDATA%\Claude\claude_desktop_config.json
+ *   Linux:    ~/.config/Claude/claude_desktop_config.json (unofficial)
+ *
+ * Schema:
+ *   {
+ *     "mcpServers": {
+ *       "<name>": { "command": "npx", "args": [...], "env": {...} }
+ *     }
+ *   }
+ *
+ * @license MIT
+ */
+import { existsSync } from 'node:fs';
+import { platform } from 'node:os';
+import { join } from 'node:path';
+import { userHome } from './home.js';
+import { detectInServerMap, patchJsonFile, removeFromServerMap, } from './index.js';
+function configPath() {
+    const home = userHome();
+    switch (platform()) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+        case 'win32': {
+            const appData = process.env.APPDATA ?? join(home, 'AppData', 'Roaming');
+            return join(appData, 'Claude', 'claude_desktop_config.json');
+        }
+        default:
+            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+    }
+}
+export const claudeDesktopClient = {
+    id: 'claude-desktop',
+    label: 'Claude Desktop',
+    configPath,
+    isDetected: () => existsSync(configPath()),
+    apply: async (serverName, config) => {
+        await patchJsonFile(configPath(), (current) => {
+            const servers = current.mcpServers !== null &&
+                typeof current.mcpServers === 'object' &&
+                !Array.isArray(current.mcpServers)
+                ? { ...current.mcpServers }
+                : {};
+            servers[serverName] = {
+                command: config.command,
+                args: config.args,
+                env: config.env,
+            };
+            return { ...current, mcpServers: servers };
+        });
+    },
+    detect: () => detectInServerMap(configPath(), 'mcpServers'),
+    remove: () => removeFromServerMap(configPath(), 'mcpServers'),
+};
+//# sourceMappingURL=claude-desktop.js.map

package/dist/clients/claude-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACH,iBAAiB,EACjB,aAAa,EACb,mBAAmB,GAGtB,MAAM,YAAY,CAAC;AAEpB,SAAS,UAAU;IACf,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,QAAQ,QAAQ,EAAE,EAAE,CAAC;QACjB,KAAK,QAAQ;YACT,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;QAChG,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;QACjE,CAAC;QACD;YACI,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IAC7E,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC7C,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,gBAAgB;IACvB,UAAU;IACV,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IAC1C,KAAK,EAAE,KAAK,EAAE,UAAkB,EAAE,MAAuB,EAAE,EAAE;QACzD,MAAM,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE;YAC1C,MAAM,OAAO,GACT,OAAO,CAAC,UAAU,KAAK,IAAI;gBAC3B,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;gBACtC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC9B,CAAC,CAAC,EAAE,GAAI,OAAO,CAAC,UAAsC,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,UAAU,CAAC,GAAG;gBAClB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;aAClB,CAAC;YACF,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACP,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC;IAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,EAAE,YAAY,CAAC;CAChE,CAAC"}

package/dist/clients/cline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cline MCP config writer.
+ *
+ * Cline ships as the VS Code extension `saoudrizwan.claude-dev`. Per
+ * Cline's docs (`docs.cline.bot` "MCP / Configuration"), the per-user
+ * MCP server registry lives at
+ * `<vsCodeUserDir>/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
+ *
+ * VS Code's `<vsCodeUserDir>` is:
+ *   macOS:    ~/Library/Application Support/Code/User
+ *   Linux:    ~/.config/Code/User
+ *   Windows:  %APPDATA%\Code\User
+ *
+ * Schema mirrors Claude Desktop's `mcpServers` map:
+ *
+ *   {
+ *     "mcpServers": {
+ *       "<name>": { "command": "npx", "args": [...], "env": {...} }
+ *     }
+ *   }
+ *
+ * @license MIT
+ */
+import { type ClientWriter } from './index.js';
+export declare const clineClient: ClientWriter;
+//# sourceMappingURL=cline.d.ts.map

package/dist/clients/cline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../src/clients/cline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EAIH,KAAK,YAAY,EAEpB,MAAM,YAAY,CAAC;AA0CpB,eAAO,MAAM,WAAW,EAAE,YAuBzB,CAAC"}