recall-mcp-v3 3.9.3 → 3.9.5

package/dist/__tests__/first-tool-call-beacon.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for the MCP first-tool-call beacon factory (issue #66).
+ *
+ * Pinned contracts:
+ *   - First invocation calls heartbeat() with state='first_tool_call',
+ *     mcp_client from detection, clientVersion from factory opts,
+ *     transport='stdio'.
+ *   - Subsequent invocations are no-ops (process-local guard).
+ *   - Heartbeat failures are caught + logged; beacon function never throws.
+ *   - Detection failures unlock the guard for retry, never propagate.
+ *   - Permanent failure ("No auth token persisted") locks the guard;
+ *     transient failures unlock it.
+ *   - Two factories from one process each have their own guard.
+ */
+export {};
+//# sourceMappingURL=first-tool-call-beacon.test.d.ts.map

package/dist/__tests__/first-tool-call-beacon.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-tool-call-beacon.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/first-tool-call-beacon.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/first-tool-call-beacon.test.js

@@ -0,0 +1,198 @@
+/**
+ * Tests for the MCP first-tool-call beacon factory (issue #66).
+ *
+ * Pinned contracts:
+ *   - First invocation calls heartbeat() with state='first_tool_call',
+ *     mcp_client from detection, clientVersion from factory opts,
+ *     transport='stdio'.
+ *   - Subsequent invocations are no-ops (process-local guard).
+ *   - Heartbeat failures are caught + logged; beacon function never throws.
+ *   - Detection failures unlock the guard for retry, never propagate.
+ *   - Permanent failure ("No auth token persisted") locks the guard;
+ *     transient failures unlock it.
+ *   - Two factories from one process each have their own guard.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { createFirstToolCallBeacon } from '../first-tool-call-beacon.js';
+const FAKE_DETECTION = {
+    mcp_client: 'claude-code',
+    ai_provider: 'anthropic',
+    environment: 'terminal',
+    os: 'darwin',
+    transport: 'stdio',
+    confidence: 'high',
+    raw: {},
+};
+describe('createFirstToolCallBeacon', () => {
+    it('first call fires heartbeat with first_tool_call + injected detection + version', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+        });
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+        expect(heartbeatMock).toHaveBeenCalledWith({
+            state: 'first_tool_call',
+            mcpClient: 'claude-code',
+            clientVersion: '3.9.5',
+            transport: 'stdio',
+        });
+    });
+    it('second call is a no-op (process-local guard)', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+        });
+        await beacon();
+        await beacon();
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('does NOT fire detection more than once when called twice', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const detectionMock = vi.fn(() => FAKE_DETECTION);
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        await beacon();
+        await beacon();
+        expect(detectionMock).toHaveBeenCalledTimes(1);
+    });
+    it('catches and logs heartbeat failures (does not throw to caller)', async () => {
+        const heartbeatMock = vi.fn(async () => {
+            throw new Error('No auth token persisted');
+        });
+        const logMock = vi.fn();
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: logMock,
+        });
+        // Must not reject — beacon is fire-and-forget at every call site.
+        await expect(beacon()).resolves.toBeUndefined();
+        expect(logMock).toHaveBeenCalledTimes(1);
+        expect(logMock.mock.calls[0][0]).toMatch(/first_tool_call beacon.*No auth token persisted/);
+    });
+    it('locks the guard on permanent failures (no auth token) — avoids retry storm', async () => {
+        const heartbeatMock = vi.fn(async (_input) => {
+            throw new Error('No auth token persisted; run `recall-mcp-v3 auth` before sending heartbeats');
+        });
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        await beacon();
+        // No-token-persisted is stable for the life of the process; retrying
+        // would hammer the API on every CallTool without changing the answer.
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('allows retry on transient failures (network error / timeout / 5xx)', async () => {
+        let attempt = 0;
+        const heartbeatMock = vi.fn(async (_input) => {
+            attempt += 1;
+            if (attempt === 1) {
+                throw new Error('Heartbeat failed: HTTP 503 Service Unavailable — transient');
+            }
+            // Subsequent attempts succeed.
+        });
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        // Transient failure unlocks the guard so the second CallTool retries.
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('locks the guard once a transient failure eventually succeeds', async () => {
+        let attempt = 0;
+        const heartbeatMock = vi.fn(async (_input) => {
+            attempt += 1;
+            if (attempt === 1) {
+                throw new Error('Heartbeat failed: AbortError');
+            }
+            // Second call succeeds.
+        });
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        // Third call after success should NOT re-fire.
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('catches detection failures + leaves guard open for retry', async () => {
+        let detectionAttempt = 0;
+        const detectionMock = vi.fn(() => {
+            detectionAttempt += 1;
+            if (detectionAttempt === 1) {
+                throw new Error('detect failed: ENOENT');
+            }
+            return FAKE_DETECTION;
+        });
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const logMock = vi.fn();
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+            log: logMock,
+        });
+        // First call: detection throws. Must NOT reject, must NOT call heartbeat,
+        // must log + leave the guard open so a future CallTool retries.
+        await expect(beacon()).resolves.toBeUndefined();
+        expect(heartbeatMock).not.toHaveBeenCalled();
+        expect(logMock).toHaveBeenCalledTimes(1);
+        expect(logMock.mock.calls[0][0]).toMatch(/first_tool_call beacon.*detection failed.*ENOENT/);
+        // Second call: detection succeeds, heartbeat fires.
+        await beacon();
+        expect(detectionMock).toHaveBeenCalledTimes(2);
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('two factories from one process have independent guards', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const detectionMock = () => FAKE_DETECTION;
+        const beaconA = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        const beaconB = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        await beaconA();
+        await beaconB();
+        // Each beacon fires once (independent state).
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('forwards different mcp_client values from detection', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createFirstToolCallBeacon({
+            version: '3.9.5',
+            heartbeat: heartbeatMock,
+            getDetection: () => ({ ...FAKE_DETECTION, mcp_client: 'cursor' }),
+        });
+        await beacon();
+        expect(heartbeatMock.mock.calls[0][0]).toMatchObject({ mcpClient: 'cursor' });
+    });
+});
+//# sourceMappingURL=first-tool-call-beacon.test.js.map

package/dist/__tests__/first-tool-call-beacon.test.js.map

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

package/dist/__tests__/started-beacon.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for the MCP startup beacon factory (PR 7).
+ *
+ * Pinned contracts:
+ *   - First invocation calls heartbeat() with state='mcp_started',
+ *     mcp_client from detection, clientVersion from factory opts,
+ *     transport='stdio'.
+ *   - Subsequent invocations are no-ops (process-local guard).
+ *   - Heartbeat failures are caught + logged; beacon function never throws.
+ *   - The factory is independent — two factories from one process each
+ *     have their own guard.
+ */
+export {};
+//# sourceMappingURL=started-beacon.test.d.ts.map

package/dist/__tests__/started-beacon.test.d.ts.map

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

package/dist/__tests__/started-beacon.test.js

@@ -0,0 +1,200 @@
+/**
+ * Tests for the MCP startup beacon factory (PR 7).
+ *
+ * Pinned contracts:
+ *   - First invocation calls heartbeat() with state='mcp_started',
+ *     mcp_client from detection, clientVersion from factory opts,
+ *     transport='stdio'.
+ *   - Subsequent invocations are no-ops (process-local guard).
+ *   - Heartbeat failures are caught + logged; beacon function never throws.
+ *   - The factory is independent — two factories from one process each
+ *     have their own guard.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { createStartedBeacon } from '../started-beacon.js';
+const FAKE_DETECTION = {
+    mcp_client: 'claude-code',
+    ai_provider: 'anthropic',
+    environment: 'terminal',
+    os: 'darwin',
+    transport: 'stdio',
+    confidence: 'high',
+    raw: {},
+};
+describe('createStartedBeacon', () => {
+    it('first call fires heartbeat with mcp_started + injected detection + version', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+        });
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+        expect(heartbeatMock).toHaveBeenCalledWith({
+            state: 'mcp_started',
+            mcpClient: 'claude-code',
+            clientVersion: '3.9.4',
+            transport: 'stdio',
+        });
+    });
+    it('second call is a no-op (process-local guard)', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+        });
+        await beacon();
+        await beacon();
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('does NOT fire detection more than once when called twice', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const detectionMock = vi.fn(() => FAKE_DETECTION);
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        await beacon();
+        await beacon();
+        expect(detectionMock).toHaveBeenCalledTimes(1);
+    });
+    it('catches and logs heartbeat failures (does not throw to caller)', async () => {
+        const heartbeatMock = vi.fn(async () => {
+            throw new Error('No auth token persisted');
+        });
+        const logMock = vi.fn();
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: logMock,
+        });
+        // Must not reject — beacon is fire-and-forget at every call site.
+        await expect(beacon()).resolves.toBeUndefined();
+        expect(logMock).toHaveBeenCalledTimes(1);
+        expect(logMock.mock.calls[0][0]).toMatch(/mcp_started beacon.*No auth token persisted/);
+    });
+    it('locks the guard on permanent failures (no auth token) — avoids retry storm', async () => {
+        const heartbeatMock = vi.fn(async (_input) => {
+            throw new Error('No auth token persisted; run `recall-mcp-v3 auth` before sending heartbeats');
+        });
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        await beacon();
+        // No-token-persisted is stable for the life of the process; retrying
+        // would hammer the API on every request without changing the answer.
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('allows retry on transient failures (network error / timeout / 5xx)', async () => {
+        let attempt = 0;
+        const heartbeatMock = vi.fn(async (_input) => {
+            attempt += 1;
+            if (attempt === 1) {
+                throw new Error('Heartbeat failed: HTTP 503 Service Unavailable — transient');
+            }
+            // Subsequent attempts succeed.
+        });
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        // Transient failure unlocks the guard so the second request retries.
+        // A flaky moment must not permanently drop the funnel signal for the
+        // life of a long-running session.
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('locks the guard once a transient failure eventually succeeds', async () => {
+        let attempt = 0;
+        const heartbeatMock = vi.fn(async (_input) => {
+            attempt += 1;
+            if (attempt === 1) {
+                throw new Error('Heartbeat failed: AbortError');
+            }
+            // Second call succeeds.
+        });
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => FAKE_DETECTION,
+            log: () => undefined,
+        });
+        await beacon();
+        await beacon();
+        // Third call after success should NOT re-fire.
+        await beacon();
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('catches detection failures + leaves guard open for retry', async () => {
+        let detectionAttempt = 0;
+        const detectionMock = vi.fn(() => {
+            detectionAttempt += 1;
+            if (detectionAttempt === 1) {
+                throw new Error('detect failed: ENOENT');
+            }
+            return FAKE_DETECTION;
+        });
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const logMock = vi.fn();
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+            log: logMock,
+        });
+        // First call: detection throws. Must NOT reject, must NOT call heartbeat,
+        // must log + leave the guard open so a future call retries. Without this,
+        // a single transient detection error permanently drops mcp_started for
+        // the life of the process.
+        await expect(beacon()).resolves.toBeUndefined();
+        expect(heartbeatMock).not.toHaveBeenCalled();
+        expect(logMock).toHaveBeenCalledTimes(1);
+        expect(logMock.mock.calls[0][0]).toMatch(/mcp_started beacon.*detection failed.*ENOENT/);
+        // Second call: detection succeeds, heartbeat fires.
+        await beacon();
+        expect(detectionMock).toHaveBeenCalledTimes(2);
+        expect(heartbeatMock).toHaveBeenCalledTimes(1);
+    });
+    it('two factories from one process have independent guards', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const detectionMock = () => FAKE_DETECTION;
+        const beaconA = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        const beaconB = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: detectionMock,
+        });
+        await beaconA();
+        await beaconB();
+        // Each beacon fires once (independent state).
+        expect(heartbeatMock).toHaveBeenCalledTimes(2);
+    });
+    it('forwards different mcp_client values from detection', async () => {
+        const heartbeatMock = vi.fn(async (_input) => undefined);
+        const beacon = createStartedBeacon({
+            version: '3.9.4',
+            heartbeat: heartbeatMock,
+            getDetection: () => ({ ...FAKE_DETECTION, mcp_client: 'cursor' }),
+        });
+        await beacon();
+        expect(heartbeatMock.mock.calls[0][0]).toMatchObject({ mcpClient: 'cursor' });
+    });
+});
+//# sourceMappingURL=started-beacon.test.js.map

package/dist/__tests__/started-beacon.test.js.map

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

package/dist/first-tool-call-beacon.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MCP first-tool-call beacon factory — install-health funnel state
+ * `first_tool_call`, the missing piece after PR #64.
+ *
+ * PR #64 wired only `mcp_started` into ListTools/CallTool. The funnel
+ * also expects a `first_tool_call` event the first time the user (or
+ * their AI tool) actually invokes a Recall MCP tool — that's the
+ * signal that goes from "MCP is loaded" to "MCP is being used."
+ *
+ * Lives in its own module (separate from index.ts) for the same
+ * reason `started-beacon.ts` does: the MCP entry binary's bottom-of-
+ * file bootstrap (`new RecallServer(); server.run()`) runs at module-
+ * load time, so routing tests through this file keeps that side
+ * effect away from vitest workers.
+ */
+import { heartbeat } from './auth/heartbeat.js';
+import { getCachedDetection } from './detect.js';
+/**
+ * Build a once-only "first tool call" beacon callable.
+ *
+ * Calling the returned function fires `heartbeat({ state:
+ * 'first_tool_call' })` exactly once per invocation of this factory,
+ * against a permanent failure mode. Transient failures (network blip,
+ * 5xx, AbortSignal timeout, or a detection probe error) leave the
+ * guard open so the next CallTool retries.
+ *
+ * Designed to be called only from the CallTool request handler —
+ * unlike the startup beacon, ListTools enumeration alone does not
+ * count as "the user used a tool." Firing on ListTools would inflate
+ * the metric with `claude mcp list`-style enumeration commands.
+ *
+ * Failures are caught and logged to stderr; a beacon failure must
+ * never break the MCP request the user is making.
+ *
+ * Deps are injectable so tests can mock heartbeat + detection without
+ * patching modules.
+ */
+export declare function createFirstToolCallBeacon(opts: {
+    version: string;
+    heartbeat?: typeof heartbeat;
+    getDetection?: typeof getCachedDetection;
+    log?: (msg: string) => void;
+}): () => Promise<void>;
+//# sourceMappingURL=first-tool-call-beacon.d.ts.map

package/dist/first-tool-call-beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-tool-call-beacon.d.ts","sourceRoot":"","sources":["../src/first-tool-call-beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACzC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAgDtB"}

package/dist/first-tool-call-beacon.js

@@ -0,0 +1,87 @@
+/**
+ * MCP first-tool-call beacon factory — install-health funnel state
+ * `first_tool_call`, the missing piece after PR #64.
+ *
+ * PR #64 wired only `mcp_started` into ListTools/CallTool. The funnel
+ * also expects a `first_tool_call` event the first time the user (or
+ * their AI tool) actually invokes a Recall MCP tool — that's the
+ * signal that goes from "MCP is loaded" to "MCP is being used."
+ *
+ * Lives in its own module (separate from index.ts) for the same
+ * reason `started-beacon.ts` does: the MCP entry binary's bottom-of-
+ * file bootstrap (`new RecallServer(); server.run()`) runs at module-
+ * load time, so routing tests through this file keeps that side
+ * effect away from vitest workers.
+ */
+import { heartbeat } from './auth/heartbeat.js';
+import { getCachedDetection } from './detect.js';
+/**
+ * Build a once-only "first tool call" beacon callable.
+ *
+ * Calling the returned function fires `heartbeat({ state:
+ * 'first_tool_call' })` exactly once per invocation of this factory,
+ * against a permanent failure mode. Transient failures (network blip,
+ * 5xx, AbortSignal timeout, or a detection probe error) leave the
+ * guard open so the next CallTool retries.
+ *
+ * Designed to be called only from the CallTool request handler —
+ * unlike the startup beacon, ListTools enumeration alone does not
+ * count as "the user used a tool." Firing on ListTools would inflate
+ * the metric with `claude mcp list`-style enumeration commands.
+ *
+ * Failures are caught and logged to stderr; a beacon failure must
+ * never break the MCP request the user is making.
+ *
+ * Deps are injectable so tests can mock heartbeat + detection without
+ * patching modules.
+ */
+export function createFirstToolCallBeacon(opts) {
+    let fired = false;
+    const heartbeatImpl = opts.heartbeat ?? heartbeat;
+    const detectionImpl = opts.getDetection ?? getCachedDetection;
+    const logImpl = opts.log ?? ((msg) => console.error(msg));
+    return async () => {
+        if (fired)
+            return;
+        fired = true;
+        let detection;
+        try {
+            detection = detectionImpl();
+        }
+        catch (err) {
+            // Detection errors are always transient — env probing can blip
+            // on a transient FS/process read. Unlock the guard so the next
+            // CallTool retries; never let detection failure silently drop
+            // the funnel signal for the life of a long-running session.
+            const msg = err instanceof Error ? err.message : String(err);
+            fired = false;
+            logImpl(`[first_tool_call beacon] detection failed: ${msg}`);
+            return;
+        }
+        try {
+            await heartbeatImpl({
+                state: 'first_tool_call',
+                mcpClient: detection.mcp_client,
+                clientVersion: opts.version,
+                transport: 'stdio',
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Differentiate permanent from transient failures:
+            //  - "No auth token persisted" is stable for the life of this
+            //    process (user hasn't run `recall-mcp-v3 auth` yet). Keep
+            //    fired=true so we don't hammer the API on every CallTool.
+            //  - Network blips, 5xx, AbortSignal timeout are transient. Let
+            //    the next CallTool retry — a flaky moment shouldn't
+            //    permanently drop the funnel signal for a long-running
+            //    Claude Code session.
+            const isPermanent = msg.includes('No auth token persisted');
+            if (!isPermanent) {
+                fired = false;
+            }
+            logImpl(`[first_tool_call beacon] heartbeat failed: ${msg}`);
+        }
+    };
+}
+//# sourceMappingURL=first-tool-call-beacon.js.map

package/dist/first-tool-call-beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-tool-call-beacon.js","sourceRoot":"","sources":["../src/first-tool-call-beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAKzC;IACC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,IAAI,kBAAkB,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAElE,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,KAAK;YAAE,OAAO;QAClB,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,aAAa,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,+DAA+D;YAC/D,+DAA+D;YAC/D,8DAA8D;YAC9D,4DAA4D;YAC5D,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,KAAK,GAAG,KAAK,CAAC;YACd,OAAO,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,aAAa,CAAC;gBAClB,KAAK,EAAE,iBAAiB;gBACxB,SAAS,EAAE,SAAS,CAAC,UAAU;gBAC/B,aAAa,EAAE,IAAI,CAAC,OAAO;gBAC3B,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,mDAAmD;YACnD,8DAA8D;YAC9D,8DAA8D;YAC9D,8DAA8D;YAC9D,gEAAgE;YAChE,wDAAwD;YACxD,2DAA2D;YAC3D,0BAA0B;YAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAC5D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;YACD,OAAO,CACL,8CAA8C,GAAG,EAAE,CACpD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -17,6 +17,8 @@ const { version: MCP_VERSION } = require('../package.json');
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { getContext, getOrigin, getUserSessions, getHistory, getTranscripts, saveSession, logDecision, getTeamActivity, } from './tools.js';
 import { runCli } from './cli.js';
+import { createStartedBeacon } from './started-beacon.js';
+import { createFirstToolCallBeacon } from './first-tool-call-beacon.js';
 // Tool definitions
 const TOOLS = [
     {
@@ -200,6 +202,8 @@ const TOOLS = [
 ];
 class RecallServer {
     server;
+    fireStartedBeacon;
+    fireFirstToolCallBeacon;
     constructor() {
         this.server = new Server({
             name: 'recall-mcp',
@@ -209,15 +213,32 @@ class RecallServer {
                 tools: {},
             },
         });
+        this.fireStartedBeacon = createStartedBeacon({ version: MCP_VERSION });
+        this.fireFirstToolCallBeacon = createFirstToolCallBeacon({ version: MCP_VERSION });
         this.setupHandlers();
     }
     setupHandlers() {
         // List available tools
         this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            // Fire mcp_started exactly once per process. ListTools is the first
+            // method any AI tool calls after MCP initialize; firing here proves
+            // the tool actually loaded the server (not just enumerated the
+            // binary). Fire-and-forget so the response is never blocked.
+            void this.fireStartedBeacon();
             return { tools: TOOLS };
         });
         // Handle tool calls
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            // Belt-and-suspenders: some clients call CallTool without a
+            // prior ListTools (e.g., after a reconnection that skipped
+            // capability negotiation). The beacon's internal guard makes
+            // duplicate firings a cheap no-op.
+            void this.fireStartedBeacon();
+            // Fire `first_tool_call` once per process. Unlike mcp_started,
+            // this only fires from CallTool — ListTools enumeration alone
+            // is not "the user used a tool." Fire-and-forget so the
+            // response is never blocked.
+            void this.fireFirstToolCallBeacon();
             const { name, arguments: args = {} } = request.params;
             try {
                 let result;

package/dist/index.js.map

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

package/dist/started-beacon.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP startup beacon factory — install-health PR 7 / P1.E.2.
+ *
+ * Lives in its own module (separate from index.ts) so tests can import
+ * it without booting a real `RecallServer` over stdio. The MCP entry
+ * binary's bottom-of-file bootstrap (`new RecallServer(); server.run()`)
+ * runs at module-load time; routing tests through this file keeps that
+ * side effect away from vitest workers.
+ */
+import { heartbeat } from './auth/heartbeat.js';
+import { getCachedDetection } from './detect.js';
+/**
+ * Build a once-only "MCP started" beacon callable.
+ *
+ * Calling the returned function fires `heartbeat({ state: 'mcp_started' })`
+ * exactly once per invocation of this factory, against a permanent
+ * failure mode. Transient failures (network blip, 5xx, AbortSignal
+ * timeout, or a detection probe error) leave the guard open so the
+ * next request retries.
+ *
+ * Designed to be called from the first incoming MCP request handler
+ * (ListTools or CallTool) — that's what proves the AI tool actually
+ * loaded the server, not just enumerated the binary.
+ *
+ * Failures are caught and logged to stderr; a beacon failure must
+ * never break the MCP request the user is making.
+ *
+ * Deps are injectable so tests can mock heartbeat + detection without
+ * patching modules.
+ */
+export declare function createStartedBeacon(opts: {
+    version: string;
+    heartbeat?: typeof heartbeat;
+    getDetection?: typeof getCachedDetection;
+    log?: (msg: string) => void;
+}): () => Promise<void>;
+//# sourceMappingURL=started-beacon.d.ts.map

package/dist/started-beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"started-beacon.d.ts","sourceRoot":"","sources":["../src/started-beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACzC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAgDtB"}

package/dist/started-beacon.js

@@ -0,0 +1,80 @@
+/**
+ * MCP startup beacon factory — install-health PR 7 / P1.E.2.
+ *
+ * Lives in its own module (separate from index.ts) so tests can import
+ * it without booting a real `RecallServer` over stdio. The MCP entry
+ * binary's bottom-of-file bootstrap (`new RecallServer(); server.run()`)
+ * runs at module-load time; routing tests through this file keeps that
+ * side effect away from vitest workers.
+ */
+import { heartbeat } from './auth/heartbeat.js';
+import { getCachedDetection } from './detect.js';
+/**
+ * Build a once-only "MCP started" beacon callable.
+ *
+ * Calling the returned function fires `heartbeat({ state: 'mcp_started' })`
+ * exactly once per invocation of this factory, against a permanent
+ * failure mode. Transient failures (network blip, 5xx, AbortSignal
+ * timeout, or a detection probe error) leave the guard open so the
+ * next request retries.
+ *
+ * Designed to be called from the first incoming MCP request handler
+ * (ListTools or CallTool) — that's what proves the AI tool actually
+ * loaded the server, not just enumerated the binary.
+ *
+ * Failures are caught and logged to stderr; a beacon failure must
+ * never break the MCP request the user is making.
+ *
+ * Deps are injectable so tests can mock heartbeat + detection without
+ * patching modules.
+ */
+export function createStartedBeacon(opts) {
+    let fired = false;
+    const heartbeatImpl = opts.heartbeat ?? heartbeat;
+    const detectionImpl = opts.getDetection ?? getCachedDetection;
+    const logImpl = opts.log ?? ((msg) => console.error(msg));
+    return async () => {
+        if (fired)
+            return;
+        fired = true;
+        let detection;
+        try {
+            detection = detectionImpl();
+        }
+        catch (err) {
+            // Detection errors are always transient — env probing can blip on
+            // a transient FS/process read. Unlock the guard so the next request
+            // retries; never let detection failure silently drop the funnel
+            // signal for the life of a long-running session.
+            const msg = err instanceof Error ? err.message : String(err);
+            fired = false;
+            logImpl(`[mcp_started beacon] detection failed: ${msg}`);
+            return;
+        }
+        try {
+            await heartbeatImpl({
+                state: 'mcp_started',
+                mcpClient: detection.mcp_client,
+                clientVersion: opts.version,
+                transport: 'stdio',
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Differentiate permanent from transient failures:
+            //  - "No auth token persisted" is stable for the life of this
+            //    process (user hasn't run `recall-mcp-v3 auth` yet). Keep
+            //    fired=true so we don't hammer the API on every request.
+            //  - Network blips, 5xx, AbortSignal timeout are transient. Let
+            //    the next request retry — a flaky moment shouldn't
+            //    permanently drop the funnel signal for a long-running
+            //    Claude Code session.
+            const isPermanent = msg.includes('No auth token persisted');
+            if (!isPermanent) {
+                fired = false;
+            }
+            logImpl(`[mcp_started beacon] heartbeat failed: ${msg}`);
+        }
+    };
+}
+//# sourceMappingURL=started-beacon.js.map

package/dist/started-beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"started-beacon.js","sourceRoot":"","sources":["../src/started-beacon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,IAAI,kBAAkB,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAElE,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,KAAK;YAAE,OAAO;QAClB,KAAK,GAAG,IAAI,CAAC;QACb,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,aAAa,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,oEAAoE;YACpE,gEAAgE;YAChE,iDAAiD;YACjD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,KAAK,GAAG,KAAK,CAAC;YACd,OAAO,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,aAAa,CAAC;gBAClB,KAAK,EAAE,aAAa;gBACpB,SAAS,EAAE,SAAS,CAAC,UAAU;gBAC/B,aAAa,EAAE,IAAI,CAAC,OAAO;gBAC3B,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,mDAAmD;YACnD,8DAA8D;YAC9D,8DAA8D;YAC9D,6DAA6D;YAC7D,gEAAgE;YAChE,uDAAuD;YACvD,2DAA2D;YAC3D,0BAA0B;YAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;YAC5D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;YACD,OAAO,CACL,0CAA0C,GAAG,EAAE,CAChD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recall-mcp-v3",
-  "version": "3.9.3",
+  "version": "3.9.5",
   "description": "Recall MCP server for Claude Code - team memory for AI coding assistants",
   "type": "module",
   "main": "dist/index.js",