@chrischall/mcp-utils 0.1.0

package/dist/session/index.js

@@ -0,0 +1,404 @@
+/**
+ * Session scaffolding for the MCP fleet — three related-but-distinct surfaces
+ * consolidated behind one subpath (`@chrischall/mcp-utils/session`):
+ *
+ *  1. {@link SessionRegistry} — an *ephemeral, in-memory* registry of signed-in
+ *     sessions keyed by account identity, plus {@link registerSessionTools} for
+ *     the structurally-identical `*_register_session` / `*_set_active_session` /
+ *     `*_get_session_context` MCP tool trio. Used by the realty MCPs
+ *     (zillow/redfin/compass/homes/onehome).
+ *
+ *  2. {@link SessionStore} — a *disk-persisted* store with hardened file perms
+ *     (0600 file / 0700 dir), normalized keys, and a most-recently-used "active"
+ *     pointer. Used by ofw/creditkarma/honeybook.
+ *
+ *  3. {@link TokenManager} — a bearer-token lifecycle manager: proactive refresh
+ *     inside a 5-minute skew window, reactive 401-replay, and a single-flight
+ *     semaphore so concurrent callers coalesce into ONE refresh. Used by
+ *     skylight/canvas/creditkarma/honeybook/zola.
+ *
+ * Security-sensitive by design (file perms + token-refresh races), so this is
+ * the one audited implementation the fleet shares.
+ */
+import { z } from 'zod';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { textResult } from '../response/index.js';
+/** Generate a short, collision-resistant label id. */
+function makeSessionId() {
+    return Date.now().toString(36) + randomBytes(6).toString('hex');
+}
+/**
+ * Per-process, in-memory registry of signed-in sessions. The constructor takes
+ * no arguments, so it's safe to instantiate per test. Sessions are keyed by
+ * `session_id` but de-duplicated by `account_identity`.
+ */
+export class SessionRegistry {
+    sessions = new Map();
+    activeId = null;
+    /**
+     * Register a new session, or refresh the existing one keyed by
+     * `account_identity`. The first session registered becomes the active one.
+     */
+    register(args) {
+        const identity = args.account_identity.trim();
+        if (identity.length === 0) {
+            throw new Error('register: account_identity must be non-empty.');
+        }
+        for (const existing of this.sessions.values()) {
+            if (existing.account_identity === identity) {
+                if (args.auth_mode !== undefined)
+                    existing.auth_mode = args.auth_mode;
+                existing.auth_ready = true;
+                existing.registered_at = new Date().toISOString();
+                if (args.auth_expires_at !== undefined) {
+                    existing.auth_expires_at = args.auth_expires_at;
+                }
+                return { ...existing };
+            }
+        }
+        const sess = {
+            session_id: makeSessionId(),
+            account_identity: identity,
+            auth_mode: args.auth_mode ?? 'browser_session',
+            auth_ready: true,
+            registered_at: new Date().toISOString(),
+            auth_expires_at: args.auth_expires_at ?? null,
+        };
+        this.sessions.set(sess.session_id, sess);
+        if (this.activeId === null)
+            this.activeId = sess.session_id;
+        return { ...sess };
+    }
+    /** Switch the active session. Returns `false` if the id is unknown. */
+    setActive(sessionId) {
+        if (!this.sessions.has(sessionId))
+            return false;
+        this.activeId = sessionId;
+        return true;
+    }
+    /** Look up a session by id (returns a copy, or `null`). */
+    get(sessionId) {
+        const s = this.sessions.get(sessionId);
+        return s ? { ...s } : null;
+    }
+    /** Snapshot of the full registry plus the active id. */
+    getContext() {
+        return {
+            active_session_id: this.activeId,
+            sessions: Array.from(this.sessions.values()).map((s) => ({ ...s })),
+        };
+    }
+    /** The active session id, if any. */
+    activeSessionId() {
+        return this.activeId;
+    }
+    /** Number of registered sessions. */
+    size() {
+        return this.sessions.size;
+    }
+    /**
+     * Resolve which session a tool call should route through:
+     * - `requested` set and known → it;
+     * - `requested` set but unknown → throws;
+     * - `requested` undefined → the active session;
+     * - no sessions registered → `null` (caller uses the default transport).
+     */
+    resolve(requested) {
+        if (requested !== undefined) {
+            if (!this.sessions.has(requested)) {
+                throw new Error(`Unknown session_id "${requested}". Call the get_session_context tool to see registered sessions.`);
+            }
+            return requested;
+        }
+        return this.activeId;
+    }
+    /** Clear all state. Test helper. */
+    reset() {
+        this.sessions.clear();
+        this.activeId = null;
+    }
+}
+/** Construct a fresh in-memory {@link SessionRegistry}. */
+export function createSessionRegistry() {
+    return new SessionRegistry();
+}
+/**
+ * Register the structurally-identical session tool trio against `server`,
+ * backed by `registry`. Replaces every MCP's hand-rolled `src/tools/sessions.ts`.
+ */
+export function registerSessionTools(server, registry, opts) {
+    const { prefix } = opts;
+    const label = opts.serviceLabel ?? prefix;
+    const ctxTool = `${prefix}_get_session_context`;
+    server.registerTool(`${prefix}_register_session`, {
+        title: `Register a signed-in ${label} session`,
+        description: `Register (or refresh) an authenticated ${label} session keyed by signed-in account identity. ` +
+            'Re-registering the same `account_identity` updates the existing session rather than creating a duplicate. ' +
+            'Returns the `session_id` to use when routing per-tool calls. ' +
+            'The first registered session becomes the default `active_session_id`.',
+        annotations: {
+            title: `Register a signed-in ${label} session`,
+            readOnlyHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: {
+            account_identity: z
+                .string()
+                .min(1)
+                .describe('Caller-supplied identifier for the signed-in account (typically the saved-account email).'),
+            auth_expires_at: z
+                .string()
+                .optional()
+                .describe('Optional ISO timestamp at which the session expires.'),
+        },
+    }, async ({ account_identity, auth_expires_at }) => {
+        // Pass `auth_expires_at` through as-is: `undefined` means "keep existing",
+        // never coerce with `?? null` (that would wipe a prior expiry).
+        const session = registry.register({ account_identity, auth_expires_at });
+        return textResult({ session, active_session_id: registry.activeSessionId() });
+    });
+    server.registerTool(`${prefix}_set_active_session`, {
+        title: `Set the active ${label} session`,
+        description: 'Switch which registered session subsequent tool calls route through by default. ' +
+            `Pass a \`session_id\` previously returned by \`${prefix}_register_session\`. ` +
+            'Tools that accept an explicit `session_id` parameter override this default per-call.',
+        annotations: {
+            title: `Set the active ${label} session`,
+            readOnlyHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: {
+            session_id: z.string().min(1).describe('Session id to make active.'),
+        },
+    }, async ({ session_id }) => {
+        if (!registry.setActive(session_id)) {
+            throw new Error(`Unknown session_id "${session_id}". Call ${ctxTool} to see registered sessions.`);
+        }
+        return textResult({
+            active_session_id: registry.activeSessionId(),
+            context: registry.getContext(),
+        });
+    });
+    server.registerTool(ctxTool, {
+        title: `List all registered ${label} sessions`,
+        description: 'Return the full set of registered sessions plus the current `active_session_id`. ' +
+            'When no sessions are registered, `sessions` is empty and `active_session_id` is null.',
+        annotations: {
+            title: `List all registered ${label} sessions`,
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: {},
+    }, async () => textResult(registry.getContext()));
+}
+// ===========================================================================
+// 2. Disk-persisted SessionStore
+// ===========================================================================
+/**
+ * Given a full URL or just an origin, return the origin without a trailing
+ * slash. Falls back to trimming a trailing slash for non-URL input.
+ */
+export function normalizeOrigin(input) {
+    try {
+        return new URL(input).origin.replace(/\/$/, '');
+    }
+    catch {
+        return input.replace(/\/$/, '');
+    }
+}
+/**
+ * Disk-persisted session store with hardened file permissions. Records are kept
+ * in a `Map` keyed by their normalized key, persisted as a JSON array (insertion
+ * order). The file is written with mode `0600` and its directory `0700` so other
+ * users on the machine cannot read captured credentials.
+ *
+ * `add` marks the record most-recently-used; {@link SessionStore.getActiveSession}
+ * (and `get()` with no argument) returns it, so a tool call that omits an explicit
+ * key picks up the latest session automatically.
+ */
+export class SessionStore {
+    sessions = new Map();
+    mostRecentKey = null;
+    filePath;
+    keyOf;
+    normalizeKey;
+    constructor(opts) {
+        this.filePath = opts.filePath;
+        this.keyOf = opts.keyOf;
+        this.normalizeKey = opts.normalizeKey ?? normalizeOrigin;
+        this.loadFromDisk();
+    }
+    loadFromDisk() {
+        if (!existsSync(this.filePath))
+            return;
+        try {
+            this.sessions = this.deserialize(readFileSync(this.filePath, 'utf8'));
+            const keys = Array.from(this.sessions.keys());
+            this.mostRecentKey = keys[keys.length - 1] ?? null;
+        }
+        catch {
+            this.sessions = new Map();
+            this.mostRecentKey = null;
+        }
+    }
+    /** Serialize the store to its on-disk JSON form (array, insertion order). */
+    serialize() {
+        return JSON.stringify(Array.from(this.sessions.values()), null, 2);
+    }
+    /** Parse on-disk JSON back into a keyed `Map`; empty map on invalid input. */
+    deserialize(body) {
+        const map = new Map();
+        const arr = JSON.parse(body);
+        if (!Array.isArray(arr))
+            return map;
+        for (const raw of arr) {
+            if (raw && typeof raw === 'object') {
+                const s = raw;
+                const key = this.normalizeKey(this.keyOf(s));
+                map.set(key, s);
+            }
+        }
+        return map;
+    }
+    saveToDisk() {
+        mkdirSync(dirname(this.filePath), { recursive: true });
+        writeFileSync(this.filePath, this.serialize(), { mode: 0o600 });
+        // Best-effort tighten existing file + dir (writeFileSync respects umask on
+        // pre-existing files, so re-assert 0600/0700 explicitly).
+        try {
+            chmodSync(this.filePath, 0o600);
+            chmodSync(dirname(this.filePath), 0o700);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    /** Insert or replace a record, normalizing its key and marking it active. */
+    add(session) {
+        const key = this.normalizeKey(this.keyOf(session));
+        this.sessions.set(key, session);
+        this.mostRecentKey = key;
+        this.saveToDisk();
+    }
+    /** Look up by key; with no key, returns the active (most-recent) session. */
+    get(key) {
+        if (key !== undefined)
+            return this.sessions.get(this.normalizeKey(key)) ?? null;
+        if (this.mostRecentKey !== null)
+            return this.sessions.get(this.mostRecentKey) ?? null;
+        return null;
+    }
+    /** The most-recently-added session, or `null`. */
+    getActiveSession() {
+        return this.get();
+    }
+    /** All sessions in insertion order. */
+    list() {
+        return Array.from(this.sessions.values());
+    }
+    /** Remove a session; fixes up the active pointer. Returns whether it existed. */
+    remove(key) {
+        const normalized = this.normalizeKey(key);
+        const had = this.sessions.delete(normalized);
+        if (had) {
+            if (this.mostRecentKey === normalized) {
+                const keys = Array.from(this.sessions.keys());
+                this.mostRecentKey = keys[keys.length - 1] ?? null;
+            }
+            this.saveToDisk();
+        }
+        return had;
+    }
+    /** Clear in-memory state without touching disk. Test helper. */
+    resetForTest() {
+        this.sessions.clear();
+        this.mostRecentKey = null;
+    }
+}
+// ===========================================================================
+// 3. TokenManager — bearer lifecycle (skew, proactive + reactive, race-safe)
+// ===========================================================================
+/** Refresh proactively this many ms before the access token expires. */
+export const TOKEN_REFRESH_SKEW_MS = 5 * 60 * 1000;
+/**
+ * Manages a bearer access token's lifecycle:
+ *
+ * - **Proactive:** {@link TokenManager.getAccessToken} refreshes when the token
+ *   is within `skewMs` (default 5 min) of expiry, returning a still-valid token.
+ * - **Reactive:** {@link TokenManager.withAuth} runs a request, and on a `401`
+ *   refreshes once and replays exactly once (no infinite loop).
+ * - **Race-safe:** concurrent refreshes coalesce onto a single in-flight promise
+ *   (semaphore), so a burst of callers triggers exactly ONE token exchange. The
+ *   in-flight promise is cleared on settle so a later refresh can run again.
+ */
+export class TokenManager {
+    accessToken;
+    refreshToken;
+    expiresAt;
+    refreshFn;
+    skewMs;
+    inFlight;
+    constructor(opts) {
+        this.accessToken = opts.initial.accessToken;
+        this.refreshToken = opts.initial.refreshToken;
+        this.expiresAt = opts.initial.expiresAt;
+        this.refreshFn = opts.refresh;
+        this.skewMs = opts.skewMs ?? TOKEN_REFRESH_SKEW_MS;
+    }
+    /** Whether the token is within the skew window of (or past) expiry. */
+    needsRefresh() {
+        return Date.now() >= this.expiresAt - this.skewMs;
+    }
+    /**
+     * Single-flight refresh. Concurrent callers share one in-flight promise; it is
+     * cleared on settle (success or failure) so a subsequent refresh can proceed.
+     */
+    refreshNow() {
+        if (!this.inFlight) {
+            const rt = this.refreshToken;
+            if (rt === undefined) {
+                return Promise.reject(new Error('TokenManager: cannot refresh — no refresh token is available.'));
+            }
+            this.inFlight = (async () => {
+                const tok = await this.refreshFn(rt);
+                this.accessToken = tok.accessToken;
+                if (tok.refreshToken !== undefined && tok.refreshToken !== '') {
+                    this.refreshToken = tok.refreshToken;
+                }
+                this.expiresAt = tok.expiresAt;
+            })().finally(() => {
+                this.inFlight = undefined;
+            });
+        }
+        return this.inFlight;
+    }
+    /** Get a valid access token, refreshing proactively inside the skew window. */
+    async getAccessToken() {
+        if (this.needsRefresh())
+            await this.refreshNow();
+        return this.accessToken;
+    }
+    /** Current absolute expiry (epoch ms). */
+    getExpiresAt() {
+        return this.expiresAt;
+    }
+    /**
+     * Run an authenticated request with reactive 401-replay. `call` receives a
+     * valid access token and returns a `Response`. On `401`, the token is
+     * refreshed once and `call` is invoked again exactly once.
+     */
+    async withAuth(call) {
+        let res = await call(await this.getAccessToken());
+        if (res.status === 401) {
+            await this.refreshNow();
+            res = await call(this.accessToken);
+        }
+        return res;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

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

package/dist/test/index.d.ts

@@ -0,0 +1,124 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { Mock } from 'vitest';
+/** A function that registers one or more tools onto a fresh `McpServer`. */
+export type RegisterFn = (server: McpServer) => void | Promise<void>;
+/** The connected test harness returned by {@link createTestHarness}. */
+export interface TestHarness {
+    /** The MCP client side of the in-memory transport pair. */
+    client: Client;
+    /** The MCP server the `registerFn` was applied to. */
+    server: McpServer;
+    /** Call a registered tool by name; arguments default to `{}`. */
+    callTool: (name: string, args?: Record<string, unknown>) => Promise<CallToolResult>;
+    /** List the tools the server advertises (name only). */
+    listTools: () => Promise<{
+        name: string;
+    }[]>;
+    /** Tear down both ends of the transport. Safe to call more than once. */
+    close: () => Promise<void>;
+}
+/**
+ * Create a connected `McpServer` + `Client` pair wired over
+ * `InMemoryTransport`. The byte-identical helper every MCP's `tests/helpers.ts`
+ * defines — register your tools, then drive them through the real client RPC
+ * path (schema validation, content envelopes, isError, and all).
+ */
+export declare function createTestHarness(registerFn: RegisterFn): Promise<TestHarness>;
+/**
+ * Parse the JSON body out of a tool's `CallToolResult`. Fleet tools return a
+ * single text block of `JSON.stringify(data, null, 2)`; this is the inverse.
+ * Throws a contextual error (rather than a bare `TypeError`/`SyntaxError`) when
+ * the result is empty, non-text, or not valid JSON — those are the test
+ * failures you actually want to read.
+ */
+export declare function parseToolResult<T = unknown>(result: CallToolResult): T;
+/** Options for {@link versionSyncTest}. */
+export interface VersionSyncOptions {
+    /** Directory to walk for `.ts` files (typically `<repo>/src`). */
+    srcDir: string;
+    /** Path to the `package.json` whose `version` is the source of truth. */
+    pkgPath: string;
+}
+/**
+ * The release-please drift guard. Walks `srcDir` for every line carrying an
+ * `x-release-please-version` annotation and asserts the version literal on that
+ * line matches `package.json#version`.
+ *
+ * Why this exists: a recurring footgun where a `VERSION` constant (the MCP's
+ * self-reported version + fetchproxy bridge identity) silently drifts from
+ * `package.json` because release-please's `extra-files` registration lacks the
+ * marker. resy-mcp v0.2.0 and opentable-mcp shipped this bug repeatedly.
+ *
+ * Returns the list of mismatch descriptions (`file:line → found (expected X)`).
+ * An empty array means in sync — callers assert `expect(result).toEqual([])`.
+ * Marker lines with no version literal (e.g. a docstring describing the
+ * convention) are intentionally skipped, so the test never trips on itself.
+ */
+export declare function versionSyncTest({ srcDir, pkgPath }: VersionSyncOptions): string[];
+/**
+ * The shape `@fetchproxy/bootstrap`'s `bootstrap()` resolves to: extracted
+ * browser state keyed by name. Mirrored here (rather than imported) because the
+ * bootstrap package is an optional, browser-side dep that consumers mock at the
+ * module boundary — the harness must not pull it.
+ */
+export interface BootstrapResult {
+    /** Cookie name → value. */
+    cookies: Record<string, string>;
+    /** `localStorage` key → value. */
+    localStorage: Record<string, string>;
+    /** `sessionStorage` key → value. */
+    sessionStorage: Record<string, string>;
+    /** Request headers captured during the bootstrap navigation. */
+    capturedHeaders: Record<string, string>;
+}
+/**
+ * Build a fully-shaped {@link BootstrapResult}, with empty maps as defaults and
+ * `overrides` shallow-merged on top. Keeps tests from re-declaring the four
+ * empty maps every time they only care about, say, `cookies`.
+ */
+export declare function makeBootstrapResult(overrides?: Partial<BootstrapResult>): BootstrapResult;
+/** Handle returned by {@link mockFetchproxyBootstrap}. */
+export interface FetchproxyBootstrapMock {
+    /** The spy standing in for `bootstrap()`. Assert/override per test. */
+    bootstrap: Mock<(...args: unknown[]) => Promise<BootstrapResult>>;
+    /**
+     * A module factory matching `@fetchproxy/bootstrap`'s export surface — pass
+     * to `vi.mock('@fetchproxy/bootstrap', mock.module)`.
+     */
+    module: () => {
+        bootstrap: (...args: unknown[]) => Promise<BootstrapResult>;
+    };
+    /** Clear recorded calls and restore the default resolved value. */
+    reset: () => void;
+}
+/**
+ * Mock `@fetchproxy/bootstrap` at the module boundary so tests never open a
+ * real WebSocket to a browser bridge. Returns a spy that resolves a default
+ * {@link BootstrapResult} (overridable per call via `bootstrap.mockResolvedValue`).
+ *
+ * Usage:
+ * ```ts
+ * const fp = mockFetchproxyBootstrap({ cookies: { SID: 'x' } });
+ * vi.mock('@fetchproxy/bootstrap', fp.module);
+ * // ...import the SUT, then assert on fp.bootstrap
+ * ```
+ * Because `vi.mock` is hoisted, declare the mock handle and the `vi.mock` call
+ * before importing the system under test.
+ */
+export declare function mockFetchproxyBootstrap(defaultResult?: Partial<BootstrapResult>): FetchproxyBootstrapMock;
+/**
+ * Spy on an API client's async request methods and (optionally) stub each one's
+ * resolved value. Mirrors the `vi.spyOn(client, 'request').mockResolvedValue(...)`
+ * boilerplate every tool-level test repeats.
+ *
+ * For each entry in `returns`: a spy is installed on `client[method]`. If the
+ * value is `undefined`, the spy passes through to the real implementation;
+ * otherwise it `mockResolvedValue`s the provided value. Remember to
+ * `vi.restoreAllMocks()` in `afterEach`.
+ *
+ * @returns A map of method name → installed spy, for call assertions.
+ */
+export declare function setupClientMocks<C extends object>(client: C, returns: Partial<Record<keyof C & string, unknown>>): Record<string, Mock>;
+//# sourceMappingURL=index.d.ts.map

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

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