dsh-mnemon 0.1.0

package/lib/types/runner.d.ts

@@ -0,0 +1,29 @@
+import type { JsonValue } from './contracts.ts';
+import type { ResolvedConfig } from './config.ts';
+import { type ProcessRunner } from './process.ts';
+/** Locate the local Mnemon binary without invoking a shell. */
+export declare function findMnemonCommand(config: Pick<ResolvedConfig, 'cliPath'>): string | undefined;
+export declare class MnemonCliError extends Error {
+    readonly exitCode: number | null;
+    readonly stderr: string;
+    constructor(message: string, exitCode?: number | null, stderr?: string);
+}
+export interface MnemonRunner {
+    readonly command: string;
+    readonly commandFound: boolean;
+    readonly config: ResolvedConfig;
+    runJson(args: readonly string[], options?: {
+        signal?: AbortSignal;
+        globalFlags?: boolean;
+        store?: string;
+    }): Promise<JsonValue>;
+    runText(args: readonly string[], options?: {
+        signal?: AbortSignal;
+        globalFlags?: boolean;
+        store?: string;
+    }): Promise<string>;
+    effectiveDataDir(): string;
+    effectiveStore(): string;
+}
+export declare function createRunner(config: ResolvedConfig, processRunner?: ProcessRunner): MnemonRunner;
+//# sourceMappingURL=runner.d.ts.map

package/lib/types/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAuBlF,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAmB7F;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,EAAE,MAAM,SAAK;CAMzE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/H,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5H,gBAAgB,IAAI,MAAM,CAAA;IAC1B,cAAc,IAAI,MAAM,CAAA;CACzB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,GAAE,aAA0B,GAAG,YAAY,CAuF5G"}

package/lib/types/runner.js

@@ -0,0 +1,150 @@
+import { accessSync, constants, existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, join, resolve } from 'node:path';
+import { runProcess } from "./process.js";
+const COMMON_CLI_PATHS = [
+    '~/.local/bin/mnemon',
+    '/opt/homebrew/bin/mnemon',
+    '/usr/local/bin/mnemon',
+    '/usr/bin/mnemon',
+];
+function expandHome(path) {
+    if (path === '~')
+        return homedir();
+    return path.startsWith('~/') ? join(homedir(), path.slice(2)) : path;
+}
+function executable(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Locate the local Mnemon binary without invoking a shell. */
+export function findMnemonCommand(config) {
+    if (config.cliPath !== undefined)
+        return expandHome(config.cliPath);
+    const envPath = process.env.MNEMON_CLI_PATH?.trim();
+    if (envPath !== undefined && envPath !== '') {
+        const path = expandHome(envPath);
+        if (executable(path))
+            return path;
+    }
+    for (const directory of (process.env.PATH ?? '').split(delimiter)) {
+        if (directory === '')
+            continue;
+        for (const name of process.platform === 'win32' ? ['mnemon.exe', 'mnemon.cmd', 'mnemon'] : ['mnemon']) {
+            const path = join(directory, name);
+            if (executable(path))
+                return path;
+        }
+    }
+    for (const candidate of COMMON_CLI_PATHS) {
+        const path = expandHome(candidate);
+        if (executable(path))
+            return path;
+    }
+    return undefined;
+}
+export class MnemonCliError extends Error {
+    exitCode;
+    stderr;
+    constructor(message, exitCode = null, stderr = '') {
+        super(message);
+        this.name = 'MnemonCliError';
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+    }
+}
+export function createRunner(config, processRunner = runProcess) {
+    const found = findMnemonCommand(config);
+    const command = found ?? config.cliPath ?? 'mnemon';
+    // Mnemon 0.1.2 runs store migrations while opening the database. Serializing
+    // CLI processes prevents parallel status/viz calls during WebUI mount from
+    // racing that migration and surfacing a transient SQLITE_BUSY error.
+    let processQueue = Promise.resolve();
+    const globalArgs = (store) => {
+        const args = [];
+        if (config.storageScope !== 'global' || config.dataDir !== undefined)
+            args.push('--data-dir', effectiveDataDir());
+        if (store !== undefined)
+            args.push('--store', store);
+        else if (config.store !== undefined)
+            args.push('--store', config.store);
+        return args;
+    };
+    const effectiveDataDir = () => {
+        if (config.storageScope === 'workspace')
+            return resolve(process.cwd(), '.mnemon');
+        if (config.storageScope === 'custom')
+            return expandHome(config.dataDir);
+        return expandHome(process.env.MNEMON_DATA_DIR?.trim() || '~/.mnemon');
+    };
+    const launch = async (args, options = {}) => {
+        if (options.signal?.aborted === true)
+            throw new MnemonCliError(`mnemon command aborted: ${String(options.signal.reason ?? 'cancelled')}`);
+        const argv = options.globalFlags === false ? [...args] : [...globalArgs(options.store), ...args];
+        const processOptions = {
+            timeoutMs: config.timeoutMs,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        };
+        let result;
+        try {
+            result = await processRunner(command, argv, processOptions);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new MnemonCliError(`${detail}. Install Mnemon and ensure "mnemon" is on PATH, or set dsh-mnemon.cliPath.`);
+        }
+        if (result.exitCode !== 0) {
+            const detail = result.stderr.trim() || result.stdout.trim() || 'no output';
+            throw new MnemonCliError(`mnemon ${args.join(' ')} exited ${String(result.exitCode)}: ${detail}`, result.exitCode, result.stderr);
+        }
+        return result.stdout;
+    };
+    const execute = (args, options = {}) => {
+        const result = processQueue.then(() => launch(args, options));
+        processQueue = result.then(() => undefined, () => undefined);
+        return result;
+    };
+    return {
+        command,
+        commandFound: found !== undefined && executable(found),
+        config,
+        async runJson(args, options) {
+            const stdout = await execute(args, options);
+            try {
+                return JSON.parse(stdout);
+            }
+            catch {
+                throw new MnemonCliError(`mnemon ${args.join(' ')} returned invalid JSON`);
+            }
+        },
+        runText: execute,
+        effectiveDataDir() {
+            return effectiveDataDir();
+        },
+        effectiveStore() {
+            if (config.store !== undefined)
+                return config.store;
+            const fromEnvironment = process.env.MNEMON_STORE?.trim();
+            if (fromEnvironment !== undefined && fromEnvironment !== '')
+                return fromEnvironment;
+            const active = join(this.effectiveDataDir(), 'active');
+            if (existsSync(active)) {
+                try {
+                    const value = readFileSync(active, 'utf8').trim();
+                    if (value !== '')
+                        return value;
+                }
+                catch {
+                    // Fall through to Mnemon's own default.
+                }
+            }
+            return 'default';
+        },
+    };
+}
+//# sourceMappingURL=runner.js.map

package/lib/types/runner.js.map

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

package/lib/types/runtime-memory.d.ts

@@ -0,0 +1,104 @@
+import type { MnemonRunner } from './runner.ts';
+export declare const RUNTIME_MEMORY_VERSION = 1;
+export declare const RUNTIME_ENTRY_DELIMITER = "\n\u00A7\n";
+export declare const RUNTIME_MEMORY_LIMITS: {
+    readonly memory: number;
+    readonly user: number;
+};
+export type RuntimeMemoryTarget = keyof typeof RUNTIME_MEMORY_LIMITS;
+export type RuntimeMemoryImportance = 'critical' | 'normal' | 'low';
+export type RuntimeMemoryAction = 'add' | 'replace' | 'remove';
+export interface RuntimeMemoryEntry {
+    content: string;
+    created_at: string;
+    updated_at: string;
+    target: RuntimeMemoryTarget;
+    importance: RuntimeMemoryImportance;
+}
+export interface RuntimeMemoryUsage {
+    used: number;
+    limit: number;
+}
+export interface RuntimeMemoryTargetView extends RuntimeMemoryUsage {
+    target: RuntimeMemoryTarget;
+    entryCount: number;
+    markdownPath: string;
+}
+export interface RuntimeMemorySnapshot {
+    directory: string;
+    sourcePath: string;
+    revision: string;
+    generatedAt: string;
+    entries: RuntimeMemoryEntry[];
+    targets: Record<RuntimeMemoryTarget, RuntimeMemoryTargetView>;
+}
+export interface RuntimeMemoryCompactedEntry {
+    content: string;
+    importance: RuntimeMemoryImportance;
+}
+export interface RuntimeMemoryMutation {
+    action: RuntimeMemoryAction;
+    target: RuntimeMemoryTarget;
+    content?: string;
+    oldText?: string;
+    importance?: RuntimeMemoryImportance;
+}
+export type RuntimeMemoryMutationResult = {
+    success: true;
+    message: string;
+    target: RuntimeMemoryTarget;
+    entryCount: number;
+    usage: RuntimeMemoryUsage;
+    added?: string;
+    replaced?: {
+        from: string;
+        to: string;
+    };
+    removed?: string;
+    maintenance?: {
+        kind: 'local-compaction' | 'mnemon-archive';
+        runId: string;
+        provider: string;
+        summary: string;
+        memoryBodyIds: string[];
+    };
+};
+export declare class RuntimeMemoryCapacityError extends Error {
+    readonly target: RuntimeMemoryTarget;
+    readonly used: number;
+    readonly projected: number;
+    readonly limit: number;
+    constructor(target: RuntimeMemoryTarget, used: number, projected: number, limit: number);
+}
+export declare class RuntimeMemoryConflictError extends Error {
+    constructor();
+}
+/**
+ * Single authority for hot memory. JSON is the durable source of truth;
+ * Markdown files are deterministic projections consumed by prompt assembly.
+ */
+export declare class RuntimeMemoryController {
+    private readonly now;
+    readonly directory: string;
+    readonly sourcePath: string;
+    readonly memoryPath: string;
+    readonly userPath: string;
+    readonly lockPath: string;
+    private queue;
+    constructor(runner: Pick<MnemonRunner, 'effectiveDataDir'>, now?: () => Date);
+    snapshot(): RuntimeMemorySnapshot;
+    contextText(): string;
+    mutate(request: RuntimeMemoryMutation): Promise<RuntimeMemoryMutationResult>;
+    /** Apply an LLM-produced compaction only to the exact snapshot it reviewed. */
+    compactTarget(expectedRevision: string, target: RuntimeMemoryTarget, compacted: RuntimeMemoryCompactedEntry[], maxBytes?: number): Promise<RuntimeMemorySnapshot>;
+    private initialize;
+    private mutateLocked;
+    private result;
+    private targetView;
+    private snapshotUnlocked;
+    private readSource;
+    private persist;
+    private repairProjections;
+    private withLock;
+}
+//# sourceMappingURL=runtime-memory.d.ts.map

package/lib/types/runtime-memory.d.ts.map

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