yoke-mcp 0.1.0

package/dist/doctor.js

@@ -0,0 +1,178 @@
+// Checks every link in the chain, and says which one is broken.
+//
+// There are four things between a tool call and a tab, and any of them can be
+// the reason nothing works: the build, the host registration, Chrome having
+// spawned the host, and the extension answering. A single "not reachable" tells
+// you none of that, so this reports each link separately and names the next
+// action rather than leaving it to be guessed.
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { browserDirs, EXTENSION_ID, HOST_NAME } from './install.js';
+import { endpointPath } from './socket-path.js';
+import { ask } from './socket-client.js';
+const extensionRoot = () => join(dirname(fileURLToPath(import.meta.url)), '..');
+/** Is the compiled host actually on disk, and executable by Chrome? */
+function checkBuild() {
+    const host = join(dirname(fileURLToPath(import.meta.url)), 'native-host.js');
+    if (!existsSync(host)) {
+        return { ok: false, label: 'build', detail: `${host} is missing`, fix: 'npm run build' };
+    }
+    // Chrome executes this path directly, so a missing execute bit is fatal and
+    // silent: Chrome simply never starts the host.
+    const executable = (statSync(host).mode & 0o111) !== 0;
+    return executable
+        ? { ok: true, label: 'build', detail: 'the host is built and executable' }
+        : { ok: false, label: 'build', detail: 'the host is not executable', fix: `chmod +x ${host}` };
+}
+/**
+ * Is the host registered, and does the registration agree with this build?
+ *
+ * Two ways this goes wrong quietly: the manifest points at a path that no longer
+ * exists, or it allowlists a different extension id, in which case Chrome
+ * refuses the connection without telling anybody why.
+ */
+function checkRegistration() {
+    const dirs = browserDirs();
+    if (dirs.length === 0) {
+        return {
+            ok: true,
+            label: 'registration',
+            detail: 'this platform registers the host in the registry, which is not checked here',
+        };
+    }
+    const found = [];
+    const problems = [];
+    for (const [browser, dir] of dirs) {
+        const file = join(dir, `${HOST_NAME}.json`);
+        if (!existsSync(file)) {
+            continue;
+        }
+        let manifest;
+        try {
+            manifest = JSON.parse(readFileSync(file, 'utf8'));
+        }
+        catch {
+            problems.push(`${browser}: the manifest is not valid JSON`);
+            continue;
+        }
+        if (!existsSync(manifest.path)) {
+            problems.push(`${browser}: points at ${manifest.path}, which does not exist`);
+            continue;
+        }
+        // The launcher names an absolute interpreter precisely so Chrome does not
+        // need a PATH. If that interpreter has since moved, Chrome fails with
+        // nothing but "Native host has exited", so it is checked here instead.
+        const launcher = readFileSync(manifest.path, 'utf8');
+        const interpreter = /exec "([^"]+)"|"([^"]+)" "/.exec(launcher);
+        const node = interpreter?.[1] ?? interpreter?.[2];
+        if (node && !existsSync(node)) {
+            problems.push(`${browser}: its launcher runs ${node}, which no longer exists`);
+            continue;
+        }
+        if (!manifest.allowed_origins.includes(`chrome-extension://${EXTENSION_ID}/`)) {
+            problems.push(`${browser}: allowlists ${manifest.allowed_origins.join(', ')}, not ${EXTENSION_ID}`);
+            continue;
+        }
+        found.push(browser);
+    }
+    if (problems.length > 0) {
+        return { ok: false, label: 'registration', detail: problems.join('; '), fix: 'yoke install' };
+    }
+    if (found.length === 0) {
+        return {
+            ok: false,
+            label: 'registration',
+            detail: 'no browser has the host registered',
+            fix: 'yoke install',
+        };
+    }
+    return { ok: true, label: 'registration', detail: `registered for ${found.join(', ')}` };
+}
+/**
+ * Has Chrome started the host?
+ *
+ * The socket exists only while the host runs, and Chrome only runs it while the
+ * extension holds the port open. So an absent socket almost always means the
+ * extension is not loaded or its service worker is asleep.
+ */
+function checkSocket() {
+    const socket = endpointPath();
+    if (process.platform === 'win32') {
+        return { ok: true, label: 'host running', detail: 'named pipes cannot be probed by existence; the ping below is the real check' };
+    }
+    return existsSync(socket)
+        ? { ok: true, label: 'host running', detail: socket }
+        : {
+            ok: false,
+            label: 'host running',
+            detail: `no socket at ${socket}`,
+            fix: `load ${join(extensionRoot(), 'extension')} at chrome://extensions with Developer mode on`,
+        };
+}
+/** Does the extension itself answer? */
+async function checkPing() {
+    try {
+        const { extension } = await ask('ping', {}, { timeoutMs: 3_000 });
+        return { ok: true, label: 'extension', detail: `answered, version ${extension}` };
+    }
+    catch (failure) {
+        return {
+            ok: false,
+            label: 'extension',
+            detail: failure instanceof Error ? failure.message : String(failure),
+            fix: 'open chrome://extensions and check the service worker is running',
+        };
+    }
+}
+/**
+ * The acceptance test for the whole project: every tab, not a group's worth.
+ *
+ * Reported as a count and as how many sit outside any group, because the second
+ * number is the one a tab-group-scoped bridge cannot see at all.
+ */
+async function checkTabs() {
+    try {
+        const { tabs } = await ask('listTabs', {}, { timeoutMs: 5_000 });
+        const ungrouped = tabs.filter((tab) => tab.groupId === -1).length;
+        return {
+            ok: tabs.length > 0,
+            label: 'tabs visible',
+            detail: `${tabs.length} tab(s), ${ungrouped} of them in no tab group`,
+        };
+    }
+    catch (failure) {
+        return {
+            ok: false,
+            label: 'tabs visible',
+            detail: failure instanceof Error ? failure.message : String(failure),
+        };
+    }
+}
+/** Runs the checks in order, stopping the remote ones once a local one fails. */
+export async function doctor() {
+    const checks = [checkBuild(), checkRegistration(), checkSocket()];
+    // No point asking the extension anything when the socket is not even there:
+    // the answer would be the same timeout dressed up as two failures.
+    if (checks.every((check) => check.ok)) {
+        checks.push(await checkPing());
+        if (checks[checks.length - 1]?.ok) {
+            checks.push(await checkTabs());
+        }
+    }
+    return checks;
+}
+export function render(checks) {
+    const lines = checks.map((check) => {
+        const mark = check.ok ? 'ok  ' : 'FAIL';
+        const fix = check.ok || !check.fix ? '' : `\n        fix: ${check.fix}`;
+        return `${mark}  ${check.label.padEnd(14)} ${check.detail}${fix}`;
+    });
+    const broken = checks.find((check) => !check.ok);
+    lines.push('');
+    lines.push(broken
+        ? `Not working yet. The first thing to fix is "${broken.label}".`
+        : 'Working. Every link in the chain answered.');
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/install.d.ts

@@ -0,0 +1,47 @@
+export declare const HOST_NAME = "io.github.hamzahamidi.yoke";
+/**
+ * Derived from the public key pinned in the extension's manifest. Chrome computes
+ * it the same way, so a mismatch means the extension was built with a different
+ * key and native messaging will refuse to connect.
+ */
+export declare const EXTENSION_ID = "oceljemfocgfidhhdlbojkbkmlbfclna";
+export interface HostManifest {
+    name: string;
+    description: string;
+    path: string;
+    type: 'stdio';
+    allowed_origins: string[];
+}
+export interface InstallResult {
+    written: Array<[browser: string, file: string]>;
+    skipped: Array<[browser: string, reason: string]>;
+    extensionId: string;
+    hostName: string;
+    platform: NodeJS.Platform;
+}
+/**
+ * Where each browser looks for host manifests.
+ *
+ * Per-user directories only. A system-wide install needs root and would register
+ * the host for every account on the machine, which is not something a command
+ * line should arrange on someone's behalf.
+ */
+export declare function browserDirs(platform?: NodeJS.Platform, home?: string): Array<[browser: string, dir: string]>;
+export declare const manifestFor: (hostPath: string) => HostManifest;
+/**
+ * Writes the manifest into every browser directory whose parent already exists.
+ *
+ * Only where the browser is actually installed: creating a Brave directory on a
+ * machine with no Brave leaves litter for something that is not there.
+ */
+export declare function install({ hostPath, platform, home, }: {
+    hostPath: string;
+    platform?: NodeJS.Platform;
+    home?: string;
+}): InstallResult;
+export declare function uninstall({ platform, home, }?: {
+    platform?: NodeJS.Platform;
+    home?: string;
+}): {
+    removed: Array<[string, string]>;
+};

package/dist/install.js

@@ -0,0 +1,165 @@
+// Registering the native messaging host with the browsers on this machine.
+//
+// Chrome will only launch a host declared in a manifest at a fixed path, and will
+// only connect an extension whose id appears in that manifest's allowed_origins.
+// Both halves are why this exists: the id is pinned by the key in the
+// extension's manifest, and this manifest has to be written into each browser's
+// own directory.
+import { chmodSync, existsSync, mkdirSync, realpathSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+// Reverse DNS on the GitHub namespace rather than a domain, because that is the
+// ownership actually demonstrable here. Chrome reads this string by exact match
+// from a file on the user's disk, so changing it breaks every existing install.
+export const HOST_NAME = 'io.github.hamzahamidi.yoke';
+/**
+ * Derived from the public key pinned in the extension's manifest. Chrome computes
+ * it the same way, so a mismatch means the extension was built with a different
+ * key and native messaging will refuse to connect.
+ */
+export const EXTENSION_ID = 'oceljemfocgfidhhdlbojkbkmlbfclna';
+/**
+ * Where each browser looks for host manifests.
+ *
+ * Per-user directories only. A system-wide install needs root and would register
+ * the host for every account on the machine, which is not something a command
+ * line should arrange on someone's behalf.
+ */
+export function browserDirs(platform = process.platform, home = homedir()) {
+    if (platform === 'darwin') {
+        const support = join(home, 'Library', 'Application Support');
+        return [
+            ['Chrome', join(support, 'Google', 'Chrome', 'NativeMessagingHosts')],
+            ['Chrome Beta', join(support, 'Google', 'Chrome Beta', 'NativeMessagingHosts')],
+            ['Chromium', join(support, 'Chromium', 'NativeMessagingHosts')],
+            ['Edge', join(support, 'Microsoft Edge', 'NativeMessagingHosts')],
+            ['Brave', join(support, 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts')],
+        ];
+    }
+    if (platform === 'win32') {
+        // Windows declares this in the registry rather than on disk, so the caller
+        // is told what to do instead of being silently skipped.
+        return [];
+    }
+    const config = process.env['XDG_CONFIG_HOME'] ?? join(home, '.config');
+    return [
+        ['Chrome', join(config, 'google-chrome', 'NativeMessagingHosts')],
+        ['Chromium', join(config, 'chromium', 'NativeMessagingHosts')],
+        ['Edge', join(config, 'microsoft-edge', 'NativeMessagingHosts')],
+        ['Brave', join(config, 'BraveSoftware', 'Brave-Browser', 'NativeMessagingHosts')],
+    ];
+}
+/**
+ * Writes a launcher that runs the host with an absolute node path.
+ *
+ * Chrome executes the manifest's `path` directly, and a Chrome started from the
+ * Dock or Finder inherits a minimal PATH: on macOS typically
+ * /usr/bin:/bin:/usr/sbin:/sbin. A `#!/usr/bin/env node` shebang therefore fails
+ * to resolve for anyone whose node came from Homebrew, nvm, asdf or Volta, which
+ * is nearly everyone, and the failure surfaces only as "Native host has exited".
+ * Baking in the interpreter that is running this install removes the guess.
+ */
+/**
+ * A node path that survives a node upgrade, where one can be proven identical.
+ *
+ * process.execPath is exact but versioned: under Homebrew it reads
+ * /opt/homebrew/Cellar/node/26.5.1/bin/node, a path `brew upgrade node` deletes.
+ * The launcher would then point at nothing, and Chrome reports that only as
+ * "Native host has exited". A stable symlink to the same file does not move, so
+ * it is preferred, but only when realpath proves it resolves to the same binary:
+ * guessing a path that happens to exist could pin a different node version.
+ */
+function stableNodePath() {
+    const exact = process.execPath;
+    let resolved;
+    try {
+        resolved = realpathSync(exact);
+    }
+    catch {
+        return exact;
+    }
+    const candidates = [
+        '/opt/homebrew/bin/node',
+        '/usr/local/bin/node',
+        join(homedir(), '.volta', 'bin', 'node'),
+        '/usr/bin/node',
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (realpathSync(candidate) === resolved) {
+                return candidate;
+            }
+        }
+        catch { /* not installed, try the next */ }
+    }
+    return exact;
+}
+function writeLauncher(hostPath, nodePath = stableNodePath()) {
+    if (process.platform === 'win32') {
+        // Chrome runs .bat through the shell, and %~dp0 keeps it relocatable.
+        const batch = join(dirname(hostPath), 'yoke-host.bat');
+        writeFileSync(batch, `@echo off\r\n"${nodePath}" "${hostPath}" %*\r\n`);
+        return batch;
+    }
+    const launcher = join(dirname(hostPath), 'yoke-host.sh');
+    writeFileSync(launcher, `#!/bin/sh\nexec "${nodePath}" "${hostPath}" "$@"\n`, { mode: 0o755 });
+    chmodSync(launcher, 0o755);
+    return launcher;
+}
+export const manifestFor = (hostPath) => ({
+    name: HOST_NAME,
+    description: 'yoke native messaging host',
+    path: hostPath,
+    type: 'stdio',
+    allowed_origins: [`chrome-extension://${EXTENSION_ID}/`],
+});
+/**
+ * Writes the manifest into every browser directory whose parent already exists.
+ *
+ * Only where the browser is actually installed: creating a Brave directory on a
+ * machine with no Brave leaves litter for something that is not there.
+ */
+export function install({ hostPath, platform = process.platform, home = homedir(), }) {
+    if (!existsSync(hostPath)) {
+        throw new Error(`the host script is not at ${hostPath}`);
+    }
+    try {
+        chmodSync(hostPath, 0o755);
+    }
+    catch { /* read-only install; reported below */ }
+    // The manifest points at a launcher rather than at the host, so Chrome never
+    // has to find node on a PATH it does not have.
+    const launcher = writeLauncher(hostPath);
+    const body = `${JSON.stringify(manifestFor(launcher), null, 2)}\n`;
+    const written = [];
+    const skipped = [];
+    for (const [browser, dir] of browserDirs(platform, home)) {
+        if (!existsSync(dirname(dir))) {
+            skipped.push([browser, 'not installed']);
+            continue;
+        }
+        try {
+            mkdirSync(dir, { recursive: true });
+            const file = join(dir, `${HOST_NAME}.json`);
+            writeFileSync(file, body);
+            written.push([browser, file]);
+        }
+        catch (failure) {
+            skipped.push([browser, failure instanceof Error ? failure.message : String(failure)]);
+        }
+    }
+    return { written, skipped, extensionId: EXTENSION_ID, hostName: HOST_NAME, platform };
+}
+export function uninstall({ platform = process.platform, home = homedir(), } = {}) {
+    const removed = [];
+    for (const [browser, dir] of browserDirs(platform, home)) {
+        const file = join(dir, `${HOST_NAME}.json`);
+        try {
+            unlinkSync(file);
+            removed.push([browser, file]);
+        }
+        catch { /* not there */ }
+    }
+    return { removed };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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