@mnemonik/shared 7.97.1 → 7.98.0

package/dist/hookRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"hookRuntime.js","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAAI,GAA0B,EAAE;IAEhC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,IAAI,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;YAC7B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAoB;oBAChC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,WAAW,EAAE,SAAS;iBACvB,CAAC;gBACF,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,QAAkB;IAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAyC,CAAC;IACzD,IAAI,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACtF,MAAM,CAAC,KAAK,CACV,mFAAmF;YACjF,qEAAqE;YACrE,0GAA0G,CAC7G,CAAC;QACF,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"hookRuntime.js","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"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"}

package/dist/hookTimeouts.d.ts

@@ -6,11 +6,11 @@
  * `@mnemonik/codex-hooks`, `@mnemonik/cursor-hooks`). Before the
  * 2026-05-16 audit Finding #7 cross-cutting cleanup, each package
  * declared its own copy of these constants and a near-identical
- * `withTimeout` helper — coordinating a budget change required three
+ * `withTimeout` helper - coordinating a budget change required three
  * synchronised edits with no enforcement that the values matched.
  *
  * Surface is intentionally minimal: small constants + a single helper
- * function. No fetch wrappers here — request shaping stays per-package
+ * function. No fetch wrappers here - request shaping stays per-package
  * because each host expresses its hook payloads differently.
  */
 /**
@@ -19,8 +19,8 @@
  * The bootstrap digest is delivered over `injections`, so it rides this 2s
  * budget. That is intentional and sufficient: on a warm cache
  * (HooksDispatcher.buildBootstrapDigestPayload) delivery is a Redis GET plus
- * render; on a cold cache the delivery path awaits buildColdFloorDigest — a
- * parallel Promise.all of cheap DB reads raced under a 1500ms sub-budget —
+ * render; on a cold cache the delivery path awaits buildColdFloorDigest - a
+ * parallel Promise.all of cheap DB reads raced under a 1500ms sub-budget -
  * and may return an enriched floor digest. The static `session_bootstrap`
  * directive is the fallback only when the floor is entirely empty (or the
  * floor fetch times out). A full synthesis build is fired in the background
@@ -36,7 +36,7 @@ export declare const TELEMETRY_TIMEOUT_MS = 500;
 export declare const POST_TOOL_TIMEOUT_MS = 1500;
 /**
  * beforeMCPExecution gate budget. This is the ONLY synchronous, user-facing
- * gate — the user waits on it before every MCP tool call — so it fails open
+ * gate - the user waits on it before every MCP tool call - so it fails open
  * faster than the background critical fetch (FETCH_TIMEOUT_MS = 2000). A
  * precheck slower than 1s is not worth blocking the tool call for; on a
  * degraded server we drop the gate rather than stall the user.
@@ -45,7 +45,7 @@ export declare const MCP_PRECHECK_TIMEOUT_MS = 1000;
 /**
  * Spawn an `AbortController` tied to a timeout. Returns the signal plus a
  * `cleanup` function the caller MUST invoke (in `finally`) to clear the
- * timer when the request finishes naturally — otherwise the timer leaks
+ * timer when the request finishes naturally - otherwise the timer leaks
  * for the timeout duration.
  *
  * Identical signature to the inlined `withTimeout` that each hook package

package/dist/hookTimeouts.js

@@ -6,11 +6,11 @@
  * `@mnemonik/codex-hooks`, `@mnemonik/cursor-hooks`). Before the
  * 2026-05-16 audit Finding #7 cross-cutting cleanup, each package
  * declared its own copy of these constants and a near-identical
- * `withTimeout` helper — coordinating a budget change required three
+ * `withTimeout` helper - coordinating a budget change required three
  * synchronised edits with no enforcement that the values matched.
  *
  * Surface is intentionally minimal: small constants + a single helper
- * function. No fetch wrappers here — request shaping stays per-package
+ * function. No fetch wrappers here - request shaping stays per-package
  * because each host expresses its hook payloads differently.
  */
 /**
@@ -19,8 +19,8 @@
  * The bootstrap digest is delivered over `injections`, so it rides this 2s
  * budget. That is intentional and sufficient: on a warm cache
  * (HooksDispatcher.buildBootstrapDigestPayload) delivery is a Redis GET plus
- * render; on a cold cache the delivery path awaits buildColdFloorDigest — a
- * parallel Promise.all of cheap DB reads raced under a 1500ms sub-budget —
+ * render; on a cold cache the delivery path awaits buildColdFloorDigest - a
+ * parallel Promise.all of cheap DB reads raced under a 1500ms sub-budget -
  * and may return an enriched floor digest. The static `session_bootstrap`
  * directive is the fallback only when the floor is entirely empty (or the
  * floor fetch times out). A full synthesis build is fired in the background
@@ -36,7 +36,7 @@ export const TELEMETRY_TIMEOUT_MS = 500;
 export const POST_TOOL_TIMEOUT_MS = 1500;
 /**
  * beforeMCPExecution gate budget. This is the ONLY synchronous, user-facing
- * gate — the user waits on it before every MCP tool call — so it fails open
+ * gate - the user waits on it before every MCP tool call - so it fails open
  * faster than the background critical fetch (FETCH_TIMEOUT_MS = 2000). A
  * precheck slower than 1s is not worth blocking the tool call for; on a
  * degraded server we drop the gate rather than stall the user.
@@ -45,7 +45,7 @@ export const MCP_PRECHECK_TIMEOUT_MS = 1000;
 /**
  * Spawn an `AbortController` tied to a timeout. Returns the signal plus a
  * `cleanup` function the caller MUST invoke (in `finally`) to clear the
- * timer when the request finishes naturally — otherwise the timer leaks
+ * timer when the request finishes naturally - otherwise the timer leaks
  * for the timeout duration.
  *
  * Identical signature to the inlined `withTimeout` that each hook package

package/dist/hostAdapter.d.ts

@@ -0,0 +1,135 @@
+import { type WindowsBinary } from './hostBinary.js';
+export type HostName = 'claude-code' | 'codex' | 'cursor' | 'grok' | 'vscode-copilot';
+export interface Target {
+    component: 'hooks' | 'mcp';
+    scope: 'user' | 'project';
+    projectRoot?: string;
+    /** Absolute dispatcher path, already verified by the CLI runtime store. */
+    runtimeEntry: string;
+    /** CLI artifact directory containing current and versioned manifests. */
+    runtimeRoot: string;
+    /** Non-secret hook component family recorded by the CLI installer. */
+    credentialFamily: string;
+    /** Config paths known to have been absent before Mnemonik first wrote them. */
+    createdFiles?: string[];
+    /** Verified first-install config backups supplied by the ownership journal. */
+    originalFiles?: Record<string, Buffer | null>;
+}
+export interface FileChange {
+    path: string;
+    content: Buffer;
+    mode?: number;
+    remove?: true;
+}
+export interface AdapterWriter {
+    stage(change: FileChange): Promise<void>;
+}
+export interface Grant {
+    installationId?: string;
+    id: string;
+    account: string;
+    scopes: string[];
+}
+export interface Inspection {
+    resolvedPath?: string;
+    declarationPath?: string;
+    authenticatedTools: boolean;
+    grant?: Grant;
+    declarationPresent: boolean;
+    enableRequired?: boolean;
+    trustPending?: boolean;
+    trustDeclined?: boolean;
+    otherScopes?: {
+        scope: Target['scope'];
+        path: string;
+    }[];
+}
+export interface HostPlan {
+    changes: FileChange[];
+    staging: 'inactive' | 'additive';
+    requestedScope: string;
+    effectiveScope: string;
+    version: string;
+    artifactDigest: string;
+}
+export interface HostAdapter {
+    name: HostName;
+    detect(): Promise<{
+        supported: boolean;
+        version: string;
+        reason?: string;
+        resolvedPath?: string;
+        searchedLocations?: string[];
+    }>;
+    capabilities(): {
+        scopes: string[];
+        revoke: boolean;
+        components: Target['component'][];
+        nativeConnect: boolean;
+        nativeListing?: boolean;
+    };
+    inspect(target?: Target): Promise<Inspection>;
+    plan(target?: Target): Promise<HostPlan>;
+    install(writer: AdapterWriter, target: Target): Promise<void>;
+    update(writer: AdapterWriter, target: Target): Promise<void>;
+    repair(writer: AdapterWriter, target: Target): Promise<void>;
+    /** Always return the recovery instruction, including after a native action. */
+    launch(input?: {
+        signedIn: boolean;
+    }): Promise<string>;
+    /** Run the host's native MCP enable action once and return its recovery instruction. */
+    enable?(): Promise<string>;
+    verify(target?: Target): Promise<Inspection>;
+    uninstall(writer: AdapterWriter, target: Target): Promise<void>;
+    revoke?(grant: Grant): Promise<boolean>;
+    revokeAction: string;
+}
+export interface AdapterDependencies {
+    platform?: NodeJS.Platform;
+    binaryExists?: (file: string) => Promise<boolean>;
+    target?: Target;
+    env?: NodeJS.ProcessEnv;
+    /** Verified package provenance supplied by the CLI, never inferred from config. */
+    version?: string;
+    artifactDigest?: string;
+    execFile?: (file: string, args: string[], options: {
+        env: NodeJS.ProcessEnv;
+        cwd?: string;
+        timeout: number;
+        maxBuffer: number;
+        windowsHide: boolean;
+        windowsVerbatimArguments?: boolean;
+    }) => Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/** Common read/propose/stage lifecycle; the host's installer still owns its bytes. */
+export declare function createFileHostAdapter(deps: AdapterDependencies, host: {
+    name: HostName;
+    binary: string;
+    windowsBinary: WindowsBinary;
+    vendorMatch: RegExp;
+    instruction: string;
+    signedInInstruction?: string;
+    mcp?: {
+        path(target: Target): string;
+        format: 'json' | 'toml';
+        type?: 'http';
+    };
+    nativeConnect?: boolean;
+    nativeListing?: boolean;
+    desktopPaths?: string[];
+    nativeEnable?: string[];
+    nativeLogout?: boolean;
+    revokeAction?: string;
+    path(target: Target): string;
+    present(target: Target): Promise<boolean>;
+    changes(target: Target, install: boolean): Promise<FileChange[]>;
+    classifyVersion?: (output: string) => {
+        supported: boolean;
+        version: string;
+        reason?: string;
+    };
+}): HostAdapter;
+//# sourceMappingURL=hostAdapter.d.ts.map

package/dist/hostAdapter.d.ts.map

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

package/dist/hostAdapter.js

@@ -0,0 +1,323 @@
+import { createHostBinary, HostBinaryNotFoundError, quoteHostArgument, } from './hostBinary.js';
+import { apiOrigin } from './apiOrigin.js';
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { isAbsolute } from 'node:path';
+import { isDeepStrictEqual, promisify, stripVTControlCharacters } from 'node:util';
+/** Common read/propose/stage lifecycle; the host's installer still owns its bytes. */
+export function createFileHostAdapter(deps, host) {
+    const emptyConfiguration = (content) => {
+        if (!content.toString().trim())
+            return true;
+        try {
+            const config = JSON.parse(content.toString());
+            return Object.entries(config).every(([key, value]) => (['hooks', 'mcpServers'].includes(key) &&
+                !!value &&
+                typeof value === 'object' &&
+                !Array.isArray(value) &&
+                Object.keys(value).length === 0) ||
+                (key === 'version' && value === 1));
+        }
+        catch {
+            return false;
+        }
+    };
+    const run = deps.execFile ?? promisify(execFile);
+    const ownedTarget = deps.env?.MNEMONIK_CLI_OWNED_TARGET === '1';
+    const targetFor = (target = deps.target) => {
+        if (!target ||
+            !['hooks', 'mcp'].includes(target.component) ||
+            !['user', 'project'].includes(target.scope) ||
+            (target.component === 'hooks' && !isAbsolute(target.runtimeEntry)) ||
+            (target.component === 'hooks' && host.name === 'codex' && !isAbsolute(target.runtimeRoot)) ||
+            (target.scope === 'project' && (!target.projectRoot || !isAbsolute(target.projectRoot))))
+            throw new Error('invalid_target');
+        return target;
+    };
+    // Validate host configuration before any native command can run.
+    const nativeEnable = host.nativeEnable;
+    for (const argument of nativeEnable ?? [])
+        quoteHostArgument(argument);
+    const binary = createHostBinary(deps, host.binary, host.windowsBinary, run, host.desktopPaths);
+    let resolvedPath;
+    let detection;
+    const detect = () => (detection ??= (async () => {
+        try {
+            resolvedPath = await binary.resolve();
+            const result = await binary.execute(['--version']);
+            resolvedPath = await binary.resolve();
+            const output = stripVTControlCharacters(`${result.stdout}\n${result.stderr}`).trim();
+            const version = output.match(/\b\d+\.\d+\.\d+(?:-[\w.-]+)?\b/)?.[0] ?? '';
+            if (output && !host.vendorMatch.test(output))
+                return { supported: false, version, reason: 'wrong_vendor', resolvedPath };
+            if (host.classifyVersion)
+                return { ...host.classifyVersion(output), resolvedPath };
+            if (version)
+                return { supported: true, version, resolvedPath };
+        }
+        catch (error) {
+            if (error instanceof HostBinaryNotFoundError) {
+                resolvedPath = undefined;
+                detection = undefined;
+                return {
+                    supported: false,
+                    version: '',
+                    reason: 'not_found',
+                    searchedLocations: error.searchedLocations,
+                };
+            }
+            /* Detection is read-only and otherwise fails closed. */
+        }
+        // Not cached: an absent or unreadable binary may be installed later in
+        // this process, and the next detect() must look again.
+        detection = undefined;
+        return {
+            supported: false,
+            version: '',
+            reason: 'unverified_version',
+            ...(resolvedPath ? { resolvedPath } : {}),
+        };
+    })());
+    const execute = async (args, target) => {
+        const check = await detect();
+        if (!check.supported)
+            throw new Error(`${check.reason}: ${check.resolvedPath ?? host.binary}`);
+        return binary.execute(args, target?.projectRoot);
+    };
+    const path = (target) => target.component === 'mcp' && host.mcp ? host.mcp.path(target) : host.path(target);
+    const mcp = async (target, install) => {
+        if (!host.mcp)
+            throw new Error('unsupported_component');
+        const file = path(target);
+        const raw = await readFile(file, 'utf8').catch((error) => {
+            if (error.code === 'ENOENT')
+                return '';
+            throw error;
+        });
+        const url = `${apiOrigin(deps.env)}/mcp`;
+        let content;
+        if (host.mcp.format === 'json') {
+            const config = JSON.parse(raw || '{}');
+            if (!config ||
+                typeof config !== 'object' ||
+                Array.isArray(config) ||
+                (config.mcpServers !== undefined &&
+                    (!config.mcpServers ||
+                        typeof config.mcpServers !== 'object' ||
+                        Array.isArray(config.mcpServers))))
+                throw new Error('invalid_mcp_config');
+            const servers = config.mcpServers ?? {};
+            const expected = { ...(host.mcp.type ? { type: host.mcp.type } : {}), url };
+            const current = servers.mnemonik;
+            const exact = !!current &&
+                typeof current === 'object' &&
+                !Array.isArray(current) &&
+                Object.keys(current).length === Object.keys(expected).length &&
+                Object.entries(expected).every(([key, value]) => current[key] === value);
+            if (install === undefined)
+                return exact ? [{ path: file, content: Buffer.from(raw) }] : [];
+            if (!install && !Object.hasOwn(servers, 'mnemonik'))
+                return [];
+            if (Object.hasOwn(servers, 'mnemonik') && !exact && !ownedTarget)
+                throw new Error('mcp_name_conflict');
+            if (install)
+                servers.mnemonik = expected;
+            else
+                delete servers.mnemonik;
+            config.mcpServers = servers;
+            content = JSON.stringify(config, null, 2) + '\n';
+        }
+        else {
+            // Preserve unrelated TOML bytes. Refuse layouts whose table boundaries are ambiguous.
+            if (/'''|"""/.test(raw) ||
+                /^\s*(?:mcp_servers\s*=|mcp_servers\s*\.)/m.test(raw) ||
+                /=\s*\[[^\]\n]*$/m.test(raw))
+                throw new Error('unsupported_mcp_toml_layout');
+            if (/^\s*\[\s*["']?mcp_servers["']?\s*\]/m.test(raw) ||
+                /^\s*\[\[\s*["']?mcp_servers/m.test(raw))
+                throw new Error('unsupported_mcp_toml_layout');
+            const table = /^\s*\[\s*(?:mcp_servers|"mcp_servers"|'mcp_servers')\s*\.\s*(?:mnemonik|"mnemonik"|'mnemonik')(?:\s*\.[^\]]+)?\s*\]\s*(?:#.*)?$/;
+            let owned = false;
+            let found = false;
+            let connected = false;
+            const kept = [];
+            for (const line of raw.match(/[^\n]*\n|[^\n]+$/g) ?? []) {
+                const text = line.trimEnd();
+                if (/^\s*\[/.test(text))
+                    owned = table.test(text);
+                if (owned) {
+                    found = true;
+                    connected ||= text.match(/^\s*url\s*=\s*["']([^"']+)["']\s*(?:#.*)?$/)?.[1] === url;
+                }
+                else
+                    kept.push(line);
+            }
+            if (install === undefined)
+                return connected ? [{ path: file, content: Buffer.from(raw) }] : [];
+            if (!install && !found)
+                return [];
+            if (found && !connected && !ownedTarget)
+                throw new Error('mcp_name_conflict');
+            content = kept.join('');
+            if (install)
+                content += `${content && !content.endsWith('\n') ? '\n' : ''}[mcp_servers.mnemonik]\nurl = "${url}"\n`;
+        }
+        return [{ path: file, content: Buffer.from(content) }];
+    };
+    const present = async (target) => target.component === 'mcp' ? (await mcp(target)).length > 0 : host.present(target);
+    const changes = (target, install) => target.component === 'mcp' ? mcp(target, install) : host.changes(target, install);
+    const inspect = async (input) => {
+        const target = targetFor(input);
+        const other = { ...target, scope: target.scope === 'user' ? 'project' : 'user' };
+        const otherScopes = [];
+        if ((other.scope === 'user' || other.projectRoot) &&
+            path(other) !== path(target) &&
+            (await present(other)))
+            otherScopes.push({ scope: other.scope, path: path(other) });
+        let authenticatedTools = false;
+        if (target.component === 'mcp' && host.nativeListing !== false) {
+            try {
+                const { stdout } = await execute(['mcp', 'list'], target);
+                // Native listing corroborates authentication; the CLI separately proves the live account grant.
+                // No qualified listing currently prints a server grant/account: do not invent one.
+                const origin = apiOrigin(deps.env).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                const connected = new RegExp(String.raw `^\s*mnemonik(?:\s*:|\s+)\s*(?:${origin}/mcp(?:\s+\(HTTP\))?\s*-\s*)?[✓✔√]?\s*Connected\s*$`, 'i');
+                const lines = stripVTControlCharacters(stdout).split(/\r?\n/);
+                authenticatedTools = lines.some((line) => connected.test(line));
+                if (host.name === 'codex') {
+                    const oauth = new RegExp(String.raw `^\s*mnemonik\s+${origin}/mcp\s+-\s+enabled\s+OAuth\s*$`);
+                    authenticatedTools ||= stripVTControlCharacters(stdout)
+                        .split(/\r?\n/)
+                        .some((line) => oauth.test(line));
+                }
+                if (host.name === 'grok' && !authenticatedTools) {
+                    const { stdout: doctor } = await execute(['mcp', 'doctor', '--json'], target);
+                    const result = JSON.parse(doctor);
+                    authenticatedTools =
+                        Array.isArray(result.servers) &&
+                            result.servers.some((server) => server.name === 'mnemonik' &&
+                                server.transport === 'http' &&
+                                server.target === `${apiOrigin(deps.env)}/mcp` &&
+                                server.healthy === true &&
+                                Array.isArray(server.checks) &&
+                                server.checks.some((check) => check.label === 'handshake OK' && check.passed === true));
+                }
+            }
+            catch {
+                /* Missing CLI, timeout or unqualified output leaves authentication unproven. */
+            }
+        }
+        return {
+            resolvedPath: await binary.resolve().catch(() => undefined),
+            ...(host.nativeListing === false ? { declarationPath: path(target) } : {}),
+            declarationPresent: await present(target),
+            authenticatedTools,
+            otherScopes,
+        };
+    };
+    const plan = async (input) => {
+        const target = targetFor(input);
+        return {
+            changes: await changes(target, true),
+            staging: 'inactive',
+            requestedScope: target.scope,
+            effectiveScope: target.scope,
+            version: deps.version ?? '',
+            artifactDigest: deps.artifactDigest ?? '',
+        };
+    };
+    const install = async (writer, target) => {
+        for (const change of (await plan(target)).changes)
+            await writer.stage(change);
+    };
+    const signedInInstruction = host.signedInInstruction ?? `${host.name} is already signed in to Mnemonik.`;
+    return {
+        name: host.name,
+        detect,
+        capabilities: () => ({
+            scopes: ['user', 'project'],
+            revoke: !!host.nativeLogout,
+            components: host.mcp ? ['hooks', 'mcp'] : ['hooks'],
+            nativeConnect: !!host.nativeConnect,
+            ...(host.nativeListing === false ? { nativeListing: false } : {}),
+        }),
+        inspect,
+        plan,
+        install,
+        // Updating and repairing both replace owned entries through plan + install.
+        update: install,
+        repair: install,
+        launch: async ({ signedIn = false } = {}) => {
+            if (host.nativeConnect && !signedIn) {
+                try {
+                    await execute(['mcp', 'login', 'mnemonik'], deps.target);
+                }
+                catch {
+                    /* The recovery instruction remains usable when native login is unavailable. */
+                }
+            }
+            return signedIn ? signedInInstruction : host.instruction;
+        },
+        ...(nativeEnable
+            ? {
+                enable: async () => {
+                    try {
+                        await execute(nativeEnable, deps.target);
+                    }
+                    catch {
+                        /* The post-enable listing supplies the actionable result. */
+                    }
+                    return signedInInstruction;
+                },
+            }
+            : {}),
+        verify: inspect,
+        async uninstall(writer, target) {
+            const owned = targetFor(target);
+            for (const change of await changes(owned, false)) {
+                if (owned.originalFiles && Object.hasOwn(owned.originalFiles, change.path)) {
+                    const original = owned.originalFiles[change.path];
+                    if (change.path.endsWith('.json')) {
+                        const before = JSON.parse(original
+                            ?.toString()
+                            .replace(/^\uFEFF/, '')
+                            .trim() || '{}');
+                        const after = JSON.parse(change.content.toString());
+                        for (const key of ['hooks', 'mcpServers'])
+                            if (!Object.hasOwn(before, key) && after[key] && Object.keys(after[key]).length === 0)
+                                delete after[key];
+                        change.content =
+                            original && isDeepStrictEqual(before, after)
+                                ? original
+                                : Buffer.from(JSON.stringify(after, null, 2) + '\n');
+                    }
+                    else if (original &&
+                        change.content.toString().trimEnd() === original.toString().trimEnd())
+                        change.content = original;
+                }
+                await writer.stage({
+                    ...change,
+                    ...(owned.createdFiles?.includes(change.path) && emptyConfiguration(change.content)
+                        ? { remove: true }
+                        : {}),
+                });
+            }
+        },
+        ...(host.nativeLogout
+            ? {
+                revoke: async () => {
+                    try {
+                        await execute(['mcp', 'logout', 'mnemonik'], deps.target);
+                        return true;
+                    }
+                    catch {
+                        return false;
+                    }
+                },
+            }
+            : {}),
+        revokeAction: host.revokeAction ??
+            `Open ${host.name} connection settings and revoke the Mnemonik connection.`,
+    };
+}
+//# sourceMappingURL=hostAdapter.js.map

package/dist/hostAdapter.js.map

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

package/dist/hostBinary.d.ts

@@ -0,0 +1,29 @@
+import type { AdapterDependencies } from './hostAdapter.js';
+export interface WindowsBinary {
+    locations: [environmentVariable: string, relativePath: string][];
+    extensions: string[];
+    productVersion?: boolean;
+}
+/** Native locations shared by preflight discovery and verified host adapters. */
+export declare function hostBinaryDescriptor(host: 'claude-code' | 'codex' | 'cursor', deps?: Pick<AdapterDependencies, 'env' | 'platform'>): {
+    binary: string;
+    windowsBinary: WindowsBinary;
+    desktopPaths?: string[];
+};
+export declare class HostBinaryNotFoundError extends Error {
+    readonly searchedLocations: string[];
+    constructor(searchedLocations: string[]);
+}
+/** cmd parses shell syntax even with execFile's shell:false. Only fixed, safe arguments.
+ * Parentheses are ordinary inside a quoted token, and a profile path may carry
+ * them (`C:\\Users\\Jane (Admin)\\...`). */
+export declare function quoteHostArgument(value: string): string;
+export declare function createHostBinary(deps: AdapterDependencies, name: string, windows: WindowsBinary, run: NonNullable<AdapterDependencies['execFile']>, desktopPaths?: string[]): {
+    resolve: () => Promise<string>;
+    findOnDisk(): Promise<string | undefined>;
+    execute(args: string[], cwd?: string): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+};
+//# sourceMappingURL=hostBinary.d.ts.map

package/dist/hostBinary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostBinary.d.ts","sourceRoot":"","sources":["../src/hostBinary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,CAAC,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,GAAG,OAAO,GAAG,QAAQ,EACxC,IAAI,GAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,UAAU,CAAM,GACvD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,aAAa,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAgD3E;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE;IAAhD,YAAqB,iBAAiB,EAAE,MAAM,EAAE,EAE/C;CACF;AAED;;4CAE4C;AAC5C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,WAAW,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,EACjD,YAAY,GAAE,MAAM,EAAO;;kBAqDL,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;kBAuB3B,MAAM,EAAE,QAAQ,MAAM;;;;EA4C7C"}