@brainmcp/brainmcp 0.1.12 → 0.1.14

package/dist/runtime/doctor-checks.js

@@ -0,0 +1,233 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { validateCredentialsRecord, validatePreferencesRecord, } from '../lib/cli-contracts.js';
+import { getBrainHome, getCurrentAccountId, readSafeJson, resolveStateDir } from './storage.js';
+import { listInstalledRuntimes } from './installer.js';
+import { listQueueItems } from './queue.js';
+import { createPlatformVault, LEGACY_VAULT_ACCOUNT, vaultAccountKey } from '../lib/vault.js';
+import { describeMisdirectedCompanionApi, resolveCompanionApiUrl } from '../lib/endpoints.js';
+export async function checkCredentialHealth(baseDir, options) {
+    const home = baseDir ?? getBrainHome();
+    const stateDir = resolveStateDir(home);
+    const credPath = path.join(stateDir, 'credentials.json');
+    const backendMarker = path.join(stateDir, 'credentials.backend.json');
+    const markerPresent = fs.existsSync(backendMarker);
+    if (fs.existsSync(credPath)) {
+        return readFileCredentialHealth(credPath);
+    }
+    const vault = options?.vault ?? (options?.probeVault ? createPlatformVault() : null);
+    if (vault && markerPresent) {
+        try {
+            if (await vault.isAvailable()) {
+                const accountId = getCurrentAccountId(home);
+                const raw = await vault.getSecret(accountId ? vaultAccountKey(accountId) : LEGACY_VAULT_ACCOUNT);
+                if (raw) {
+                    try {
+                        const parsed = JSON.parse(raw);
+                        if (parsed.authType === 'oauth' || parsed.type === 'oauth') {
+                            return oauthGrantHealth(parsed, 'OS credential vault');
+                        }
+                        return {
+                            name: 'credential health',
+                            passed: true,
+                            detail: 'OAuth grant stored in the OS credential vault',
+                        };
+                    }
+                    catch {
+                        return {
+                            name: 'credential health',
+                            passed: false,
+                            detail: 'OS vault secret is unreadable',
+                            repairGuidance: 'Run "brainmcp login --force" to recreate credentials',
+                        };
+                    }
+                }
+            }
+        }
+        catch {
+            // Fall through to marker / empty handling; never leak vault errors.
+        }
+    }
+    if (markerPresent) {
+        return {
+            name: 'credential health',
+            passed: false,
+            detail: 'OS vault marker present but no readable grant',
+            repairGuidance: 'Run "brainmcp login --force" to recreate credentials',
+        };
+    }
+    return {
+        name: 'credential health',
+        passed: true,
+        detail: 'no credentials stored (run brainmcp login)',
+        repairGuidance: 'Run "brainmcp login" to connect your agent to BrainMCP',
+    };
+}
+function oauthGrantHealth(raw, location) {
+    const scopes = Array.isArray(raw.scopes)
+        ? raw.scopes.filter((item) => typeof item === 'string')
+        : [];
+    const isExpired = typeof raw.expiresAt === 'string' ? new Date(raw.expiresAt).getTime() < Date.now() : false;
+    return {
+        name: 'credential health',
+        passed: !isExpired,
+        detail: `OAuth grant (${scopes.join(', ') || 'no scopes'}) ${isExpired ? 'expired' : 'valid'} in ${location}`,
+        repairGuidance: isExpired ? 'Run "brainmcp login" to refresh OAuth grant' : undefined,
+    };
+}
+function readFileCredentialHealth(credPath) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(credPath, 'utf8'));
+        const kind = raw.type ?? raw.authType;
+        if (kind === 'oauth') {
+            return oauthGrantHealth(raw, 'credentials.json');
+        }
+        if (kind === 'service') {
+            return {
+                name: 'credential health',
+                passed: true,
+                detail: `service token for workspace ${String(raw.workspaceId ?? 'unspecified')}`,
+            };
+        }
+        const creds = readSafeJson(credPath, validateCredentialsRecord);
+        if (!creds) {
+            return {
+                name: 'credential health',
+                passed: false,
+                detail: 'empty or unreadable credentials file',
+                repairGuidance: 'Run "brainmcp login --force" to recreate credentials',
+            };
+        }
+        return {
+            name: 'credential health',
+            passed: true,
+            detail: `credentials stored (${creds.type})`,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'credential health',
+            passed: false,
+            detail: `invalid credentials schema: ${err instanceof Error ? err.message : String(err)}`,
+            repairGuidance: 'Run "brainmcp login --force" to reset corrupt credentials',
+        };
+    }
+}
+export function checkRuntimeDrift(expectedVersion = '0.1.13', baseDir) {
+    const installed = listInstalledRuntimes(baseDir);
+    if (installed.length === 0) {
+        return {
+            name: 'runtime bundle',
+            passed: true, // Optional until hooks installed
+            detail: 'no hook runtime bundle installed in ~/.brainmcp/runtime',
+            repairGuidance: 'Run "brainmcp init" to install current runtime bundle',
+        };
+    }
+    const hasCurrent = installed.some((r) => r.version === expectedVersion);
+    if (hasCurrent) {
+        return {
+            name: 'runtime bundle',
+            passed: true,
+            detail: `version v${expectedVersion} installed and up to date`,
+        };
+    }
+    const versions = installed.map((r) => `v${r.version}`).join(', ');
+    return {
+        name: 'runtime bundle',
+        passed: false,
+        detail: `runtime drift detected: installed [${versions}], current CLI is v${expectedVersion}`,
+        repairGuidance: 'Run "brainmcp init" to update runtime to current version',
+    };
+}
+export function checkConsentPreferences(baseDir) {
+    const prefPath = path.join(resolveStateDir(baseDir), 'preferences.json');
+    if (!fs.existsSync(prefPath)) {
+        return {
+            name: 'capture consent',
+            passed: true,
+            detail: 'default preferences (capture disabled by default)',
+        };
+    }
+    try {
+        const prefs = readSafeJson(prefPath, validatePreferencesRecord);
+        if (!prefs) {
+            return {
+                name: 'capture consent',
+                passed: false,
+                detail: 'unreadable preferences file',
+                repairGuidance: 'Run "brainmcp login" to reconfigure preferences',
+            };
+        }
+        const capture = prefs.consent.captureEnabled ? 'enabled' : 'disabled';
+        const prompts = prefs.consent.includePrompts ? 'with prompts' : 'no prompts';
+        return {
+            name: 'capture consent',
+            passed: true,
+            detail: `capture ${capture} (${prompts}) under policy ${prefs.consent.policyVersion}`,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'capture consent',
+            passed: false,
+            detail: `corrupt preferences: ${err instanceof Error ? err.message : String(err)}`,
+            repairGuidance: 'Delete the current account preferences file under ~/.brainmcp/accounts/ or reconfigure with "brainmcp login"',
+        };
+    }
+}
+export function checkCompanionApiTarget(env = process.env) {
+    try {
+        const apiUrl = resolveCompanionApiUrl(env);
+        const misdirected = describeMisdirectedCompanionApi(apiUrl);
+        if (misdirected) {
+            return {
+                name: 'companion API origin',
+                passed: false,
+                detail: misdirected,
+                repairGuidance: 'Unset BRAINMCP_API_URL or set it to https://api.brainmcp.ai',
+            };
+        }
+        return {
+            name: 'companion API origin',
+            passed: true,
+            detail: `REST ${apiUrl} (OAuth discovery stays on the MCP origin unless BRAINMCP_OAUTH_ISSUER is set)`,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'companion API origin',
+            passed: false,
+            detail: err instanceof Error ? err.message : String(err),
+            repairGuidance: 'Unset BRAINMCP_API_URL or set it to https://api.brainmcp.ai',
+        };
+    }
+}
+export function checkQueueStatus(baseDir) {
+    try {
+        const items = listQueueItems(baseDir);
+        const pending = items.filter((i) => i.status === 'pending');
+        const failed = items.filter((i) => i.status === 'failed' || i.status === 'delivery_unknown');
+        if (items.length === 0) {
+            return {
+                name: 'capture queue',
+                passed: true,
+                detail: 'queue clean (0 pending items)',
+            };
+        }
+        const hasFailed = failed.length > 0;
+        return {
+            name: 'capture queue',
+            passed: !hasFailed,
+            detail: `${pending.length} pending, ${failed.length} failed out of ${items.length} total`,
+            repairGuidance: hasFailed ? 'Run "brainmcp capture purge-local" to clear failed items' : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'capture queue',
+            passed: false,
+            detail: `error reading queue: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=doctor-checks.js.map

package/dist/runtime/doctor-checks.js.map

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

package/dist/runtime/flush.d.ts

@@ -0,0 +1,30 @@
+import type { CaptureTrigger } from '../lib/cli-contracts.js';
+import type { ApiClient } from '../lib/api-client.js';
+import type { StoredCredentials } from '../lib/credentials.js';
+export declare const MAX_CAPTURE_QUEUE_ITEMS = 50;
+export declare const MAX_CAPTURE_QUEUE_BYTES: number;
+export declare const MAX_CAPTURE_ATTEMPTS = 8;
+export type CaptureRetryClass = 'retryable' | 'non_retryable' | 'auth_required' | 'terminal';
+export declare function apiCaptureTrigger(trigger: CaptureTrigger): 'manual' | 'precompact' | 'session_end';
+export declare function classifyCaptureFailure(status: number | null, message?: string): CaptureRetryClass;
+export declare function nextRetryAt(attempts: number, now?: number, jitterMs?: number): string;
+export declare function queueByteSize(baseDir?: string): number;
+export declare function canEnqueueCapture(baseDir?: string): boolean;
+export interface FlushCaptureOptions {
+    apiClient: ApiClient;
+    baseDir?: string;
+    now?: number;
+    signal?: AbortSignal;
+    includeManual?: boolean;
+    /** Current hook project policy. Omit only for an explicit manual flush. */
+    allowAutomatic?: boolean;
+    credentials?: StoredCredentials | null;
+    digestId?: string;
+}
+export interface FlushCaptureResult {
+    sent: number;
+    failed: number;
+    skipped: number;
+    unknown: number;
+}
+export declare function flushCaptureQueue(options: FlushCaptureOptions): Promise<FlushCaptureResult>;

package/dist/runtime/flush.js

@@ -0,0 +1,193 @@
+import { listQueueItems, updateQueueItem, getQueueDir } from './queue.js';
+import { logRuntimeEvent } from './diagnostics.js';
+import { readPreferences, resolveStateDir } from './storage.js';
+import { withSessionLock } from './lock.js';
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+export const MAX_CAPTURE_QUEUE_ITEMS = 50;
+export const MAX_CAPTURE_QUEUE_BYTES = 10 * 1024 * 1024;
+export const MAX_CAPTURE_ATTEMPTS = 8;
+const BACKOFF_MS = [1_000, 2_000, 4_000, 8_000, 16_000, 32_000, 32_000, 32_000];
+export function apiCaptureTrigger(trigger) {
+    if (trigger === 'pre_compact')
+        return 'precompact';
+    return trigger;
+}
+export function classifyCaptureFailure(status, message) {
+    if (status === 401 || /unauthorized|invalid_token|auth_required/i.test(message ?? '')) {
+        return 'auth_required';
+    }
+    if (status === 403 || /missing required MCP OAuth scope/i.test(message ?? '')) {
+        return 'terminal';
+    }
+    if (status === 400 || (status !== null && status >= 400 && status < 500 && status !== 429)) {
+        return 'non_retryable';
+    }
+    if (status === 429 || (status !== null && status >= 500) || status === null) {
+        return 'retryable';
+    }
+    return 'retryable';
+}
+export function nextRetryAt(attempts, now = Date.now(), jitterMs = Math.floor(Math.random() * 500)) {
+    const base = BACKOFF_MS[Math.min(Math.max(attempts, 1), BACKOFF_MS.length) - 1] ?? 32_000;
+    return new Date(now + base + jitterMs).toISOString();
+}
+export function queueByteSize(baseDir) {
+    const dir = getQueueDir(baseDir);
+    let total = 0;
+    for (const entry of fs.readdirSync(dir)) {
+        if (!entry.endsWith('.json'))
+            continue;
+        try {
+            total += fs.statSync(path.join(dir, entry)).size;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return total;
+}
+export function canEnqueueCapture(baseDir) {
+    const items = listQueueItems(baseDir).filter((item) => item.status === 'pending' || item.status === 'sending' || item.status === 'delivery_unknown');
+    if (items.length >= MAX_CAPTURE_QUEUE_ITEMS)
+        return false;
+    return queueByteSize(baseDir) < MAX_CAPTURE_QUEUE_BYTES;
+}
+async function postDigest(apiClient, item, signal, beforeSend) {
+    try {
+        await apiClient.request(`/api/workspaces/${item.workspaceId}/digests`, {
+            method: 'POST',
+            body: {
+                clientDigestId: item.digestId,
+                trigger: apiCaptureTrigger(item.captureTrigger),
+                capturePolicyVersion: item.policyVersion,
+                digestText: item.digestText.trim() || 'Session capture with no assistant summary.',
+                source: 'mcp_tool',
+            },
+            signal,
+            expectedAuthorizationId: item.authorizationId,
+            beforeSend,
+            timeoutMs: 5_000,
+        });
+        return { ok: true, status: 200 };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const statusFromError = error && typeof error === 'object' && 'status' in error && typeof error.status === 'number'
+            ? error.status
+            : null;
+        const statusMatch = message.match(/status (\d{3})/i);
+        const status = statusFromError ?? (statusMatch ? Number(statusMatch[1]) : null);
+        return { ok: false, status, message };
+    }
+}
+export async function flushCaptureQueue(options) {
+    // Pin this run to one physical account namespace, including completion after
+    // another process switches the active account.
+    options = { ...options, baseDir: resolveStateDir(options.baseDir) };
+    const result = { sent: 0, failed: 0, skipped: 0, unknown: 0 };
+    const now = options.now ?? Date.now();
+    const items = listQueueItems(options.baseDir);
+    const credentials = options.credentials === undefined
+        ? await options.apiClient.getEffectiveCredentials()
+        : options.credentials;
+    for (const item of items) {
+        if (options.signal?.aborted)
+            break;
+        if (options.digestId && item.digestId !== options.digestId)
+            continue;
+        if (item.status === 'delivered' || item.status === 'cancelled' || item.status === 'failed') {
+            result.skipped += 1;
+            continue;
+        }
+        if (item.nextRetryAt && Date.parse(item.nextRetryAt) > now) {
+            result.skipped += 1;
+            continue;
+        }
+        if (!options.includeManual && item.captureTrigger === 'manual') {
+            // Manual items are sent by `capture now`, not background hooks.
+            continue;
+        }
+        const isAutomatic = item.captureTrigger !== 'manual';
+        const consentStillMatches = () => {
+            const prefs = readPreferences(options.baseDir);
+            return prefs?.consent?.captureEnabled === true &&
+                (!isAutomatic || options.allowAutomatic === true) &&
+                item.consentRevision !== undefined && item.consentRevision === (prefs.consent.revision ?? 0) &&
+                (!isAutomatic || item.workspaceId === prefs.enabledWorkspaceId);
+        };
+        if (isAutomatic) {
+            if (!consentStillMatches()) {
+                if (item.status === 'pending') {
+                    updateQueueItem(item.digestId, { status: 'cancelled', lastError: 'Capture consent or project policy changed before delivery' }, options.baseDir);
+                }
+                result.skipped += 1;
+                continue;
+            }
+        }
+        const currentAuthorizationId = credentials?.authType === 'oauth' ? credentials.authorizationId : undefined;
+        if (!item.authorizationId || !currentAuthorizationId || item.authorizationId !== currentAuthorizationId) {
+            updateQueueItem(item.digestId, { status: 'cancelled', lastError: 'Capture item belongs to a different or unknown authorization' }, options.baseDir);
+            result.skipped += 1;
+            continue;
+        }
+        if (!credentials?.scopes?.includes('digests:write') || !credentials.workspaces?.includes(item.workspaceId)) {
+            result.skipped += 1;
+            continue;
+        }
+        const owner = randomUUID();
+        const claimed = await withSessionLock('capture-queue', () => {
+            const current = listQueueItems(options.baseDir).find((queued) => queued.digestId === item.digestId);
+            if (!current || ['delivered', 'cancelled', 'failed'].includes(current.status) ||
+                (current.deliveryLease && Date.parse(current.deliveryLease.expiresAt) > Date.now()) ||
+                (current.nextRetryAt && Date.parse(current.nextRetryAt) > now) ||
+                !consentStillMatches() || options.signal?.aborted)
+                return null;
+            return updateQueueItem(item.digestId, { status: 'sending',
+                deliveryLease: { owner, expiresAt: new Date(Date.now() + 10_000).toISOString() } }, options.baseDir);
+        }, { baseDir: options.baseDir, timeoutMs: 250 });
+        if (!claimed) {
+            result.skipped += 1;
+            continue;
+        }
+        const finish = (updates) => withSessionLock('capture-queue', () => {
+            const current = listQueueItems(options.baseDir).find((queued) => queued.digestId === item.digestId);
+            if (current?.deliveryLease?.owner !== owner)
+                return;
+            updateQueueItem(item.digestId, { ...updates, deliveryLease: undefined }, options.baseDir);
+        }, { baseDir: options.baseDir, timeoutMs: 250 });
+        const response = await postDigest(options.apiClient, claimed, options.signal, consentStillMatches);
+        if (response.ok) {
+            await finish({ status: 'delivered', deliveredAt: new Date().toISOString(), lastError: undefined, nextRetryAt: undefined });
+            result.sent += 1;
+            continue;
+        }
+        const klass = classifyCaptureFailure(response.status, response.message);
+        if (klass === 'auth_required' || klass === 'terminal' || klass === 'non_retryable') {
+            await finish({ status: 'failed', lastError: response.message ?? 'non-retryable capture failure', attempts: claimed.attempts + 1 });
+            result.failed += 1;
+            continue;
+        }
+        const attempts = claimed.attempts + 1;
+        if (attempts >= MAX_CAPTURE_ATTEMPTS) {
+            await finish({ status: 'failed', attempts, lastError: response.message ?? 'retry limit reached' });
+            result.failed += 1;
+            continue;
+        }
+        const unknown = response.status === null;
+        await finish({
+            status: unknown ? 'delivery_unknown' : 'pending',
+            attempts,
+            nextRetryAt: nextRetryAt(attempts, now),
+            lastError: response.message,
+        });
+        if (unknown)
+            result.unknown += 1;
+        else
+            result.failed += 1;
+    }
+    logRuntimeEvent('info', 'capture_flush', { ...result }, options.baseDir);
+    return result;
+}
+//# sourceMappingURL=flush.js.map

package/dist/runtime/flush.js.map

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

package/dist/runtime/hook-dispatcher.d.ts

@@ -0,0 +1,31 @@
+import { type HookEvent } from '../lib/cli-contracts.js';
+import { ApiClient } from '../lib/api-client.js';
+import { type StoredCredentials } from '../lib/credentials.js';
+export declare const MAX_STDIN_BYTES: number;
+export declare const DEFAULT_EVENT_TIMEOUT_MS = 1000;
+export declare const SESSION_END_TIMEOUT_MS = 3000;
+export interface HookDispatchResult {
+    handled: boolean;
+    emptyFallback: boolean;
+    outputPayload?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Strict bounded stdin reader with length check.
+ */
+export declare function readBoundedStdin(stream?: NodeJS.ReadableStream, maxBytes?: number, signal?: AbortSignal): Promise<string>;
+/**
+ * Dispatches a normalized HookEvent under deadline/abort control (AHI-053).
+ * Always fails open with empty success on error or timeout.
+ *
+ * Stop/SessionStop never queues or flushes digests (AHI-D03).
+ * Capture queue writes require user-local consent (AHI-D01) and are further
+ * restrictable by project `.brainmcp.json` (AHI-D02).
+ */
+export declare function dispatchHookEvent(event: HookEvent, options?: {
+    baseDir?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    apiClient?: ApiClient;
+    credentials?: StoredCredentials | null;
+}): Promise<HookDispatchResult>;