hmem-mcp 1.1.0

package/dist/json-parser.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+export function parseRequestFile(filePath, log) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const req = JSON.parse(raw);
+        // Extract Request_ID from filename if not in JSON
+        if (!req.Request_ID) {
+            const basename = path.basename(filePath, ".json");
+            // REQ_CODER_1 → CODER_1
+            req.Request_ID = basename.replace(/^REQ_/, "");
+        }
+        // Set defaults
+        req.Type = req.Type || "LAUNCH_AGENT";
+        req.Depth = req.Depth ?? 0;
+        // Terminate_After: Only set if explicitly specified in JSON.
+        // Template merger and agent-manager set the default later.
+        // An early default here would override template values (e.g. Terminate_After: false).
+        req._RequestFile = filePath;
+        return req;
+    }
+    catch (e) {
+        log.error(`JSON parse failed: ${filePath}: ${e}`);
+        return null;
+    }
+}
+const VALID_TOOLS = new Set(["opencode", "opencode-run", "gemini-cli", "claude"]);
+const SAFE_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+const MAX_COMMAND_LENGTH = 50_000; // 50KB max
+export function validateRequest(req, maxDepth, log) {
+    const id = req.Agent_ID || "?";
+    if (req.Type === "LAUNCH_AGENT") {
+        if (!req.Command) {
+            log.error(`${id}: No command specified`);
+            return false;
+        }
+        if ((req.Depth ?? 0) > maxDepth) {
+            log.error(`${id}: Spawn-Depth ${req.Depth} > Max ${maxDepth}`);
+            return false;
+        }
+    }
+    // Agent_ID: only safe characters
+    if (req.Agent_ID && !SAFE_ID_PATTERN.test(req.Agent_ID)) {
+        log.error(`${id}: Agent_ID contains invalid characters (allowed: A-Z, 0-9, _, -)`);
+        return false;
+    }
+    // Tool: must be known
+    if (req.Tool && !VALID_TOOLS.has(req.Tool)) {
+        log.error(`${id}: Unknown tool '${req.Tool}' (allowed: ${[...VALID_TOOLS].join(", ")})`);
+        return false;
+    }
+    // Command: length limit
+    if (req.Command && req.Command.length > MAX_COMMAND_LENGTH) {
+        log.error(`${id}: Command too long (${req.Command.length} > ${MAX_COMMAND_LENGTH} bytes)`);
+        return false;
+    }
+    // Depth: must be non-negative
+    if (req.Depth !== undefined && (req.Depth < 0 || !Number.isInteger(req.Depth))) {
+        log.error(`${id}: Invalid depth ${req.Depth} (must be >= 0 and an integer)`);
+        return false;
+    }
+    return true;
+}

package/dist/logger.d.ts

@@ -0,0 +1,21 @@
+export interface LogContext {
+    agent_id?: string;
+    pid?: number;
+    tool?: string;
+    model?: string;
+    [key: string]: string | number | boolean | undefined;
+}
+export declare class Logger {
+    private logFile;
+    private maxBytes;
+    private jsonMode;
+    private minLevel;
+    constructor(logDir: string, maxBytes: number, jsonMode?: boolean, minLevelStr?: string);
+    info(msg: string, ctx?: LogContext): void;
+    warn(msg: string, ctx?: LogContext): void;
+    error(msg: string, ctx?: LogContext): void;
+    action(msg: string, ctx?: LogContext): void;
+    debug(msg: string, ctx?: LogContext): void;
+    private write;
+    private rotate;
+}

package/dist/logger.js

@@ -0,0 +1,78 @@
+import fs from "node:fs";
+import path from "node:path";
+const LEVEL_PRIORITY = {
+    DEBUG: 0,
+    INFO: 1,
+    ACTION: 1,
+    WARN: 2,
+    ERROR: 3,
+};
+export class Logger {
+    logFile;
+    maxBytes;
+    jsonMode;
+    minLevel;
+    constructor(logDir, maxBytes, jsonMode = false, minLevelStr = "info") {
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        this.logFile = path.join(logDir, "council_log.txt");
+        this.maxBytes = maxBytes;
+        this.jsonMode = jsonMode;
+        this.minLevel = LEVEL_PRIORITY[minLevelStr.toUpperCase()] ?? 1;
+    }
+    info(msg, ctx) { this.write("INFO", msg, ctx); }
+    warn(msg, ctx) { this.write("WARN", msg, ctx); }
+    error(msg, ctx) { this.write("ERROR", msg, ctx); }
+    action(msg, ctx) { this.write("ACTION", msg, ctx); }
+    debug(msg, ctx) { this.write("DEBUG", msg, ctx); }
+    write(level, msg, ctx) {
+        const priority = LEVEL_PRIORITY[level] ?? 1;
+        if (priority < this.minLevel)
+            return;
+        let line;
+        if (this.jsonMode) {
+            const entry = {
+                ts: new Date().toISOString(),
+                level,
+                msg,
+            };
+            // Agent-Kontext als separate Felder
+            if (ctx) {
+                for (const [k, v] of Object.entries(ctx)) {
+                    if (v !== undefined)
+                        entry[k] = v;
+                }
+            }
+            line = JSON.stringify(entry) + "\n";
+        }
+        else {
+            const ts = new Date().toISOString().replace("T", " ").slice(0, 19);
+            const ctxStr = ctx?.agent_id ? ` [${ctx.agent_id}]` : "";
+            line = `[${ts}] [${level}]${ctxStr} ${msg}\n`;
+        }
+        try {
+            this.rotate();
+            fs.appendFileSync(this.logFile, line, "utf-8");
+        }
+        catch (e) {
+            process.stderr.write(`Logger error: ${e}\n`);
+        }
+    }
+    rotate() {
+        try {
+            if (!fs.existsSync(this.logFile))
+                return;
+            const stat = fs.statSync(this.logFile);
+            if (stat.size < this.maxBytes)
+                return;
+            const ts = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+            const archive = this.logFile.replace(".txt", `_${ts}.txt`);
+            fs.renameSync(this.logFile, archive);
+        }
+        catch {
+            // Rotation fehlgeschlagen — weiter loggen
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * hmem — Humanlike Memory MCP Server.
+ *
+ * Provides persistent, hierarchical memory for AI agents via MCP.
+ * SQLite-backed, 5-level lazy loading, role-based access control.
+ *
+ * Environment variables:
+ *   HMEM_PROJECT_DIR         — Root directory where .hmem files are stored (required)
+ *   HMEM_AGENT_ID            — Agent identifier (optional; defaults to memory.hmem)
+ *   HMEM_AGENT_ROLE          — Role: worker | al | pl | ceo (default: worker)
+ *   HMEM_AUDIT_STATE_PATH    — Path to audit_state.json (default: {PROJECT_DIR}/audit_state.json)
+ *
+ * Legacy fallbacks (Das Althing):
+ *   COUNCIL_PROJECT_DIR, COUNCIL_AGENT_ID, COUNCIL_AGENT_ROLE
+ */
+export {};