@engramprotocol/mcp-server 0.9.0 → 0.10.0

package/dist/setup/uninstall.js

@@ -0,0 +1,120 @@
+"use strict";
+// Setup-mode uninstall flow. Implements v0.10.0-PROPOSAL C.5 §Uninstall flow.
+//
+// Removes all engramprotocol-managed entries from Claude Code config and removes
+// the hook scripts. User's non-EML hooks, permissions, and settings remain untouched.
+// ~/.eml/config is kept by default (user data — confirmed before delete).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUninstall = runUninstall;
+const fs = __importStar(require("fs"));
+const _helpers_1 = require("./_helpers");
+function log(msg) {
+    process.stderr.write(msg + '\n');
+}
+const MCP_PERMISSION = `mcp__${_helpers_1.MCP_SERVER_NAME}__*`;
+const BASH_PERMISSION = `Bash(npx @engramprotocol/mcp-server setup *)`;
+async function runUninstall(_argv) {
+    log('Engram Protocol — Setup (uninstall)\n');
+    log('Will remove:');
+    log(`  • Hook entries in ${_helpers_1.CLAUDE_SETTINGS} that reference ${_helpers_1.EML_HOOKS_DIR}`);
+    log(`  • Permission entries: ${MCP_PERMISSION}, ${BASH_PERMISSION}`);
+    log(`  • MCP server registration "${_helpers_1.MCP_SERVER_NAME}" (via \`claude mcp remove\`)`);
+    log(`  • ${_helpers_1.EML_HOOKS_DIR} (hook scripts)`);
+    log(`  • ${_helpers_1.EML_CONFIG} (only after explicit confirmation — contains token)`);
+    log('');
+    const ok = await (0, _helpers_1.promptConfirm)('Proceed?', false);
+    if (!ok) {
+        log('\nCancelled. No changes made.');
+        return;
+    }
+    // --- 1. settings.json — backup + remove managed entries -------------------
+    if (fs.existsSync(_helpers_1.CLAUDE_SETTINGS)) {
+        const backupPath = (0, _helpers_1.backupSettings)();
+        log(`\n  ℹ Backup: ${backupPath}`);
+        const settings = (0, _helpers_1.readSettings)();
+        const hooksRemoved = (0, _helpers_1.removeHooksByCommandPrefix)(settings, _helpers_1.EML_HOOKS_DIR);
+        log(`  ✓ Removed ${hooksRemoved} hook entr${hooksRemoved === 1 ? 'y' : 'ies'}`);
+        const permsRemoved = (0, _helpers_1.removePermissions)(settings, (e) => e === MCP_PERMISSION || e === BASH_PERMISSION);
+        log(`  ✓ Removed ${permsRemoved} permission entr${permsRemoved === 1 ? 'y' : 'ies'}`);
+        (0, _helpers_1.writeSettings)(settings);
+        log(`  ✓ ${_helpers_1.CLAUDE_SETTINGS} updated`);
+    }
+    else {
+        log(`  ℹ ${_helpers_1.CLAUDE_SETTINGS} not found — nothing to clean there`);
+    }
+    // --- 2. claude mcp remove -------------------------------------------------
+    const remove = (0, _helpers_1.claudeCli)(['mcp', 'remove', _helpers_1.MCP_SERVER_NAME]);
+    if (remove.status === 0) {
+        log(`  ✓ MCP server "${_helpers_1.MCP_SERVER_NAME}" removed`);
+    }
+    else {
+        log(`  ℹ \`claude mcp remove ${_helpers_1.MCP_SERVER_NAME}\` returned non-zero (likely already absent)`);
+    }
+    // --- 3. ~/.eml/hooks/ -----------------------------------------------------
+    if (fs.existsSync(_helpers_1.EML_HOOKS_DIR)) {
+        fs.rmSync(_helpers_1.EML_HOOKS_DIR, { recursive: true, force: true });
+        log(`  ✓ Removed ${_helpers_1.EML_HOOKS_DIR}`);
+    }
+    else {
+        log(`  ℹ ${_helpers_1.EML_HOOKS_DIR} not found — already gone`);
+    }
+    // --- 4. ~/.eml/config — confirm before delete -----------------------------
+    if (fs.existsSync(_helpers_1.EML_CONFIG)) {
+        log('');
+        const deleteConfig = await (0, _helpers_1.promptConfirm)(`Delete ${_helpers_1.EML_CONFIG} (contains your API token)?`, false);
+        if (deleteConfig) {
+            fs.rmSync(_helpers_1.EML_CONFIG);
+            log(`  ✓ Removed ${_helpers_1.EML_CONFIG}`);
+            // ~/.eml/ — remove if empty
+            try {
+                if (fs.readdirSync(_helpers_1.EML_DIR).length === 0) {
+                    fs.rmdirSync(_helpers_1.EML_DIR);
+                    log(`  ✓ Removed empty ${_helpers_1.EML_DIR}`);
+                }
+            }
+            catch { /* logs subdir or similar exists — leave as-is */ }
+        }
+        else {
+            log(`  ℹ Kept ${_helpers_1.EML_CONFIG}`);
+        }
+    }
+    log(`
+✅ Uninstall complete.
+
+Restart Claude Code for the changes to take full effect.
+`);
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/setup/uninstall.js.map

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

package/dist/setup/update.d.ts

@@ -0,0 +1,2 @@
+export declare function runUpdate(_argv: string[]): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/setup/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/setup/update.ts"],"names":[],"mappings":"AAwCA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE9D"}

package/dist/setup/update.js

@@ -0,0 +1,130 @@
+"use strict";
+// Setup-mode update flow. Implements v0.10.0-PROPOSAL C.5 §Update flow.
+//
+// What this does:
+//   - Refreshes EML_CLIENT_VERSION in ~/.eml/config to match the currently-installed
+//     package version (so the hook's banner-check sees the right version)
+//   - Overwrites hook templates in ~/.eml/hooks/ from the current package's templates/
+//     (marker-aware: skips files that the user has customized — no marker present)
+//   - Verifies that ~/.claude/settings.json still has the managed entries
+//
+// What this does NOT do:
+//   - Refresh the npm package itself. That's the user's responsibility (typically via
+//     `npx @engramprotocol/mcp-server@latest setup update` to bust npx cache).
+//     If the package version hasn't changed when `setup update` runs, it's a no-op
+//     except for config-bump and template-overwrite (idempotent).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUpdate = runUpdate;
+const fs = __importStar(require("fs"));
+const _helpers_1 = require("./_helpers");
+function log(msg) {
+    process.stderr.write(msg + '\n');
+}
+function fail(msg, code = 1) {
+    log(`\n❌ ${msg}`);
+    process.exit(code);
+}
+async function runUpdate(_argv) {
+    log('Engram Protocol — Setup (update)');
+    // --- 1. Read existing config ---------------------------------------------
+    const cfg = (0, _helpers_1.readConfig)();
+    if (!cfg) {
+        fail(`No installation found at ${_helpers_1.EML_CONFIG}. Run \`setup install\` first.`);
+    }
+    if (!cfg.EML_URL || !cfg.EML_API_TOKEN) {
+        fail(`Config at ${_helpers_1.EML_CONFIG} is incomplete (missing EML_URL or EML_API_TOKEN). Re-run \`setup install\`.`);
+    }
+    const oldVersion = cfg.EML_CLIENT_VERSION || '(unset)';
+    const newVersion = (0, _helpers_1.pkgVersion)();
+    log(`  Current installed version: ${oldVersion}`);
+    log(`  This package's version:    ${newVersion}`);
+    if (oldVersion === newVersion) {
+        log('  → Config already at this version; will still refresh templates (idempotent).');
+    }
+    // --- 2. Update config (bump EML_CLIENT_VERSION) --------------------------
+    (0, _helpers_1.writeConfig)({ ...cfg, EML_CLIENT_VERSION: newVersion });
+    log(`  ✓ ${_helpers_1.EML_CONFIG} EML_CLIENT_VERSION → ${newVersion}`);
+    // --- 3. Hook templates: overwrite (marker-aware) -------------------------
+    log('\nHook templates:');
+    fs.mkdirSync(_helpers_1.EML_HOOKS_DIR, { recursive: true });
+    for (const tpl of _helpers_1.HOOK_TEMPLATES) {
+        const installedPath = `${_helpers_1.EML_HOOKS_DIR}/${tpl.filename}`;
+        if (fs.existsSync(installedPath)) {
+            const current = fs.readFileSync(installedPath, 'utf-8');
+            if (!(0, _helpers_1.hasMarker)(current)) {
+                log(`  ⚠ skip ${installedPath} — user-customized (no \`${_helpers_1.MANAGED_BY_MARKER}\` marker). Manual review needed.`);
+                continue;
+            }
+        }
+        (0, _helpers_1.installTemplate)(tpl.filename);
+        log(`  ✓ ${installedPath}`);
+    }
+    // --- 4. Settings.json sanity check ---------------------------------------
+    log('\nSettings.json sanity check:');
+    if (!fs.existsSync(_helpers_1.CLAUDE_SETTINGS)) {
+        log(`  ⚠ ${_helpers_1.CLAUDE_SETTINGS} missing — was the install completed? Run \`setup install\` again.`);
+    }
+    else {
+        const settings = (0, _helpers_1.readSettings)();
+        const allow = settings.permissions?.allow ?? [];
+        const hasMcpPerm = allow.includes(`mcp__${_helpers_1.MCP_SERVER_NAME}__*`);
+        if (hasMcpPerm)
+            log(`  ✓ mcp__${_helpers_1.MCP_SERVER_NAME}__* present in permissions.allow`);
+        else
+            log(`  ⚠ mcp__${_helpers_1.MCP_SERVER_NAME}__* missing from permissions.allow — run \`setup install\` to restore`);
+        let hookEntries = 0;
+        for (const event of Object.keys(settings.hooks ?? {})) {
+            const arr = settings.hooks[event] ?? [];
+            for (const e of arr) {
+                for (const h of e.hooks ?? []) {
+                    if (typeof h.command === 'string' && h.command.includes(_helpers_1.EML_HOOKS_DIR))
+                        hookEntries += 1;
+                }
+            }
+        }
+        log(`  ${hookEntries > 0 ? '✓' : '⚠'} ${hookEntries} hook entries reference ${_helpers_1.EML_HOOKS_DIR}`);
+    }
+    log(`
+✅ Update complete.
+
+Note: this updates the local config + hook templates of the currently-running setup-mode.
+If you ran an old version via npx cache, run again with @latest to force a fresh download:
+  npx @engramprotocol/mcp-server@latest setup update
+
+Restart Claude Code for changes to take effect.
+`);
+}
+//# sourceMappingURL=update.js.map

package/dist/setup/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/setup/update.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,EAAE;AACF,kBAAkB;AAClB,qFAAqF;AACrF,0EAA0E;AAC1E,uFAAuF;AACvF,mFAAmF;AACnF,0EAA0E;AAC1E,EAAE;AACF,yBAAyB;AACzB,sFAAsF;AACtF,+EAA+E;AAC/E,mFAAmF;AACnF,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BlE,8BAyEC;AAlGD,uCAAwB;AACxB,yCAamB;AAEnB,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,IAAI,GAAG,CAAC;IACjC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;IACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,KAAe;IAC7C,GAAG,CAAC,kCAAkC,CAAC,CAAA;IAEvC,4EAA4E;IAC5E,MAAM,GAAG,GAAG,IAAA,qBAAU,GAAE,CAAA;IACxB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,4BAA4B,qBAAU,gCAAgC,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACvC,IAAI,CAAC,aAAa,qBAAU,8EAA8E,CAAC,CAAA;IAC7G,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAA;IACtD,MAAM,UAAU,GAAG,IAAA,qBAAU,GAAE,CAAA;IAC/B,GAAG,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAA;IACjD,GAAG,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAA;IACjD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,GAAG,CAAC,gFAAgF,CAAC,CAAA;IACvF,CAAC;IAED,4EAA4E;IAC5E,IAAA,sBAAW,EAAC,EAAE,GAAG,GAAG,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC,CAAA;IACvD,GAAG,CAAC,OAAO,qBAAU,yBAAyB,UAAU,EAAE,CAAC,CAAA;IAE3D,4EAA4E;IAC5E,GAAG,CAAC,mBAAmB,CAAC,CAAA;IACxB,EAAE,CAAC,SAAS,CAAC,wBAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,KAAK,MAAM,GAAG,IAAI,yBAAc,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,GAAG,wBAAa,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAA;QAExD,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;YACvD,IAAI,CAAC,IAAA,oBAAS,EAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,YAAY,aAAa,4BAA4B,4BAAiB,mCAAmC,CAAC,CAAA;gBAC9G,SAAQ;YACV,CAAC;QACH,CAAC;QACD,IAAA,0BAAe,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7B,GAAG,CAAC,OAAO,aAAa,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,4EAA4E;IAC5E,GAAG,CAAC,+BAA+B,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAAe,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,OAAO,0BAAe,oEAAoE,CAAC,CAAA;IACjG,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,IAAA,uBAAY,GAAE,CAAA;QAC/B,MAAM,KAAK,GAAI,QAAQ,CAAC,WAAW,EAAE,KAA8B,IAAI,EAAE,CAAA;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,0BAAe,KAAK,CAAC,CAAA;QAC/D,IAAI,UAAU;YAAE,GAAG,CAAC,YAAY,0BAAe,kCAAkC,CAAC,CAAA;;YAC7E,GAAG,CAAC,YAAY,0BAAe,uEAAuE,CAAC,CAAA;QAE5G,IAAI,WAAW,GAAG,CAAC,CAAA;QACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,GAAG,GAAI,QAAQ,CAAC,KAAwE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;YAC3G,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;gBACpB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;oBAC9B,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,wBAAa,CAAC;wBAAE,WAAW,IAAI,CAAC,CAAA;gBAC1F,CAAC;YACH,CAAC;QACH,CAAC;QACD,GAAG,CAAC,KAAK,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,2BAA2B,wBAAa,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,GAAG,CAAC;;;;;;;;CAQL,CAAC,CAAA;AACF,CAAC"}

package/dist/tools/_helpers.d.ts

@@ -1,12 +1,12 @@
 /**
- * Tool-Handler-Wrapper (v0.9-PROPOSAL §6.4 "Error-Handling — zwei Kanäle").
+ * Tool handler wrapper (v0.9-PROPOSAL §6.4 "Error handling — two channels").
  *
- * - Backend-Fehler (z.B. 401/500) → `isError: true` mit Message für das LLM
- *   (idealerweise selbst-korrigierbar formuliert)
- * - Protocol-Errors (malformed Request, unknown Tool) bleiben dem SDK
+ * - Backend errors (e.g. 401/500) → `isError: true` with a message for the
+ *   LLM (ideally phrased so the model can self-correct).
+ * - Protocol errors (malformed request, unknown tool) are left to the SDK.
  *
- * Der CallToolResult-Type kommt vom SDK; wir geben nur das Plain-Object
- * zurück — kein Type-Assert hier nötig (das erledigt registerTool).
+ * The CallToolResult type comes from the SDK; we just return the plain object —
+ * no type assertion needed (registerTool handles that).
  */
 export declare function callTool<T>(fn: () => Promise<T>): Promise<{
     content: Array<{

package/dist/tools/_helpers.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.callTool = callTool;
 const http_client_1 = require("../http-client");
 /**
- * Tool-Handler-Wrapper (v0.9-PROPOSAL §6.4 "Error-Handling — zwei Kanäle").
+ * Tool handler wrapper (v0.9-PROPOSAL §6.4 "Error handling — two channels").
  *
- * - Backend-Fehler (z.B. 401/500) → `isError: true` mit Message für das LLM
- *   (idealerweise selbst-korrigierbar formuliert)
- * - Protocol-Errors (malformed Request, unknown Tool) bleiben dem SDK
+ * - Backend errors (e.g. 401/500) → `isError: true` with a message for the
+ *   LLM (ideally phrased so the model can self-correct).
+ * - Protocol errors (malformed request, unknown tool) are left to the SDK.
  *
- * Der CallToolResult-Type kommt vom SDK; wir geben nur das Plain-Object
- * zurück — kein Type-Assert hier nötig (das erledigt registerTool).
+ * The CallToolResult type comes from the SDK; we just return the plain object —
+ * no type assertion needed (registerTool handles that).
  */
 async function callTool(fn) {
     try {

package/dist/tools/boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAuB1E"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAgB1E"}

package/dist/tools/boot.js

@@ -6,16 +6,11 @@ const _helpers_1 = require("./_helpers");
 function registerBootTool(server, http) {
     server.registerTool('eml_boot', {
         title: 'Boot Brain',
-        description: 'Lädt die Boot-Sicht des Brains: Identity (profile/rule), aktueller Status, ' +
-            'Open Tasks, Recent Logs, Brain-Hygiene-Reviews. Am Anfang jeder Session aufrufen, ' +
-            'um Kontext nachzuladen — der returned Markdown ist direkt für Context-Window geeignet.',
+        description: 'Manual brain-reload — returns the same markdown the SessionStart-Hook ' +
+            'delivers automatically. Use mid-session to refresh brain state.',
         inputSchema: {
-            agent: zod_1.z.string().optional().describe('Agent-ID (z.B. "motti", "default"). Wenn weggelassen, nimmt der Server den Brain-Namen als Default.'),
-            caller: zod_1.z.string().optional().describe('Wer den Boot triggert (default: gleicher Wert wie agent).'),
+            agent: zod_1.z.string().optional().describe('Agent ID (e.g. "motti", "default"). If omitted, the server uses the brain name as default.'),
         },
-    }, async (args) => (0, _helpers_1.callTool)(() => http.post('/boot', {
-        agent: args.agent,
-        caller: args.caller ?? args.agent,
-    })));
+    }, async (args) => (0, _helpers_1.callTool)(() => http.post('/boot', { agent: args.agent })));
 }
 //# sourceMappingURL=boot.js.map

package/dist/tools/boot.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":";;AAKA,4CAuBC;AA5BD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,IAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,6EAA6E;YAC7E,oFAAoF;YACpF,wFAAwF;QAC1F,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,qGAAqG,CACtG;YACD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,2DAA2D,CAC5D;SACF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;QAChD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK;KAClC,CAAC,CAAC,CACJ,CAAA;AACH,CAAC"}
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":";;AAKA,4CAgBC;AArBD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,IAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,wEAAwE;YACxE,iEAAiE;QACnE,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,4FAA4F,CAC7F;SACF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAC1E,CAAA;AACH,CAAC"}

package/dist/tools/decide.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HttpClient } from '../http-client';
+/**
+ * v0.9 Cluster 4 step 3: typed write tool for decision engrams.
+ *
+ * Properties (decision_type/rationale/alternatives/expires_at/review_due_at)
+ * are exposed as top-level tool params, packed into a `properties` object
+ * by the tool, and posted to /context.
+ *
+ * review_due_at: server default is 60d if unset (brain hygiene).
+ */
+export declare function registerDecideTool(server: McpServer, http: HttpClient): void;
+//# sourceMappingURL=decide.d.ts.map

package/dist/tools/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/tools/decide.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAOhD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAwC5E"}

package/dist/tools/decide.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDecideTool = registerDecideTool;
+const zod_1 = require("zod");
+const _helpers_1 = require("./_helpers");
+const DECISION_TYPES = ['strategic', 'architectural', 'operational', 'roadmap'];
+const SIGNIFICANCE = ['critical', 'high', 'normal', 'low', 'trivial'];
+const STATUSES = ['planned', 'active', 'superseded', 'invalidated', 'expired', 'resolved'];
+/**
+ * v0.9 Cluster 4 step 3: typed write tool for decision engrams.
+ *
+ * Properties (decision_type/rationale/alternatives/expires_at/review_due_at)
+ * are exposed as top-level tool params, packed into a `properties` object
+ * by the tool, and posted to /context.
+ *
+ * review_due_at: server default is 60d if unset (brain hygiene).
+ */
+function registerDecideTool(server, http) {
+    server.registerTool('eml_decide', {
+        title: 'Record Decision',
+        description: 'Records a deliberate, documented decision. Trigger: explicit ' +
+            '"we decide X", "Decision: Y" — NOT for speculation or open ' +
+            'questions. Decisions are the backbone of brain memory.',
+        inputSchema: {
+            content: zod_1.z.string().describe('The decision itself (1-3 sentences, what was decided).'),
+            scope: zod_1.z.string().describe('global | project.<id> | entity.<id> | agent.<id> | user.<id>'),
+            subject: zod_1.z.string().optional().describe('Slug for the decision (for later recall).'),
+            decision_type: zod_1.z.enum(DECISION_TYPES).optional(),
+            rationale: zod_1.z.string().optional().describe('Why this was decided.'),
+            alternatives: zod_1.z.array(zod_1.z.string()).optional().describe('Rejected alternatives.'),
+            expires_at: zod_1.z.string().optional().describe('ISO date: hard lifecycle, obsolete from then on.'),
+            review_due_at: zod_1.z.string().optional().describe('ISO date: next review (server default 60d).'),
+            significance: zod_1.z.enum(SIGNIFICANCE).optional(),
+            status: zod_1.z.enum(STATUSES).optional().describe('Default "active".'),
+        },
+    }, async (args) => (0, _helpers_1.callTool)(() => {
+        const properties = {};
+        if (args.decision_type !== undefined)
+            properties.decision_type = args.decision_type;
+        if (args.rationale !== undefined)
+            properties.rationale = args.rationale;
+        if (args.alternatives !== undefined)
+            properties.alternatives = args.alternatives;
+        if (args.expires_at !== undefined)
+            properties.expires_at = args.expires_at;
+        if (args.review_due_at !== undefined)
+            properties.review_due_at = args.review_due_at;
+        return http.post('/context', {
+            content: args.content,
+            type: 'decision',
+            scope: args.scope,
+            subject: args.subject,
+            status: args.status,
+            significance: args.significance,
+            properties: Object.keys(properties).length > 0 ? properties : undefined,
+        });
+    }));
+}
+//# sourceMappingURL=decide.js.map

package/dist/tools/decide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../src/tools/decide.ts"],"names":[],"mappings":";;AAkBA,gDAwCC;AA1DD,6BAAuB;AAGvB,yCAAqC;AAErC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,CAAU,CAAA;AACxF,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAU,CAAA;AAC9E,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AAEnG;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAAC,MAAiB,EAAE,IAAgB;IACpE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,+DAA+D;YAC/D,6DAA6D;YAC7D,wDAAwD;QAC1D,WAAW,EAAE;YACX,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACtF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;YAC1F,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACpF,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;YAChD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAClE,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC/E,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YAC9F,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAC5F,YAAY,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;YAC7C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SAClE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,UAAU,GAA4B,EAAE,CAAA;QAC9C,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;QACnF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;QACvE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;QAChF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QAC1E,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS;YAAE,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;QACnF,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC,CAAA;IACJ,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/tools/entity.d.ts

@@ -1,7 +1,11 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { HttpClient } from '../http-client';
+/**
+ * v0.9 Cluster 4 step 3: list all entities, optionally filtered by kind.
+ * Replaces the earlier `eml_entity_list` with clearer naming + symmetry to
+ * `eml_projects` (container inventory).
+ */
+export declare function registerEntitiesTool(server: McpServer, http: HttpClient): void;
 export declare function registerEntityCreateTool(server: McpServer, http: HttpClient): void;
-export declare function registerEntityListTool(server: McpServer, http: HttpClient): void;
-export declare function registerEntityGetTool(server: McpServer, http: HttpClient): void;
 export declare function registerEntityUpdateTool(server: McpServer, http: HttpClient): void;
 //# sourceMappingURL=entity.d.ts.map

package/dist/tools/entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/tools/entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAKhD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAkBlF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAYhF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAY/E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAkBlF"}
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/tools/entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAKhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAe9E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAmBlF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAmBlF"}

package/dist/tools/entity.js

@@ -1,48 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEntitiesTool = registerEntitiesTool;
 exports.registerEntityCreateTool = registerEntityCreateTool;
-exports.registerEntityListTool = registerEntityListTool;
-exports.registerEntityGetTool = registerEntityGetTool;
 exports.registerEntityUpdateTool = registerEntityUpdateTool;
 const zod_1 = require("zod");
 const _helpers_1 = require("./_helpers");
 const ENTITY_KINDS = ['person', 'org', 'asset', 'subject'];
+/**
+ * v0.9 Cluster 4 step 3: list all entities, optionally filtered by kind.
+ * Replaces the earlier `eml_entity_list` with clearer naming + symmetry to
+ * `eml_projects` (container inventory).
+ */
+function registerEntitiesTool(server, http) {
+    server.registerTool('eml_entities', {
+        title: 'List Entities',
+        description: 'Lists all entities in the brain (external persons / organisations / ' +
+            'assets / subjects), optionally filtered by kind. For "which external ' +
+            'persons / orgs are in the brain?".',
+        inputSchema: {
+            kind: zod_1.z.enum(ENTITY_KINDS).optional().describe('Default: all.'),
+        },
+    }, async (args) => (0, _helpers_1.callTool)(() => http.get('/entities', args.kind ? { kind: args.kind } : undefined)));
+}
 function registerEntityCreateTool(server, http) {
     server.registerTool('eml_entity_create', {
         title: 'Create Entity',
-        description: 'Registriert eine Entity (externer Mensch / Organisation / Asset / Subject). ' +
-            'Pflicht VOR dem ersten Engram mit scope=entity.<id> — sonst schlägt der ' +
-            'scope-Existence-Check fehl.',
+        description: 'Registers an entity (external person / organisation / asset / subject). ' +
+            'Required BEFORE the first engram with scope=entity.<id> — otherwise ' +
+            'the scope-existence check fails. Trigger: "new client/contact", ' +
+            '"registering external organization X".',
         inputSchema: {
-            id: zod_1.z.string().describe('Slug-style ID, z.B. "lasse" oder "anthropic".'),
+            id: zod_1.z.string().describe('Slug-style ID, e.g. "lasse" or "anthropic".'),
             name: zod_1.z.string(),
             kind: zod_1.z.enum(ENTITY_KINDS),
             description: zod_1.z.string().optional(),
         },
     }, async (args) => (0, _helpers_1.callTool)(() => http.post('/entity', args)));
 }
-function registerEntityListTool(server, http) {
-    server.registerTool('eml_entity_list', {
-        title: 'List Entities',
-        description: 'Listet alle Entities, optional gefiltert nach kind.',
-        inputSchema: {
-            kind: zod_1.z.enum(ENTITY_KINDS).optional(),
-        },
-    }, async (args) => (0, _helpers_1.callTool)(() => http.get('/entities', args.kind ? { kind: args.kind } : undefined)));
-}
-function registerEntityGetTool(server, http) {
-    server.registerTool('eml_entity_get', {
-        title: 'Get Entity',
-        description: 'Holt eine Entity per ID.',
-        inputSchema: {
-            id: zod_1.z.string(),
-        },
-    }, async (args) => (0, _helpers_1.callTool)(() => http.get(`/entity/${args.id}`)));
-}
 function registerEntityUpdateTool(server, http) {
     server.registerTool('eml_entity_update', {
         title: 'Update Entity',
-        description: 'Patch Entity-Felder (name/kind/description).',
+        description: 'Patch entity fields. Trigger: name change, description refinement.',
         inputSchema: {
             id: zod_1.z.string(),
             name: zod_1.z.string().optional(),

package/dist/tools/entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/tools/entity.ts"],"names":[],"mappings":";;AAOA,4DAkBC;AAED,wDAYC;AAED,sDAYC;AAED,4DAkBC;AAzED,6BAAuB;AAGvB,yCAAqC;AAErC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAU,CAAA;AAEnE,SAAgB,wBAAwB,CAAC,MAAiB,EAAE,IAAgB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,8EAA8E;YAC9E,0EAA0E;YAC1E,6BAA6B;QAC/B,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YACxE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAA;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAC,MAAiB,EAAE,IAAgB;IACxE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE;YACX,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;SACtC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACnG,CAAA;AACH,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAiB,EAAE,IAAgB;IACvE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;SACf;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAC/D,CAAA;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAiB,EAAE,IAAgB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;YACrC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/tools/entity.ts"],"names":[],"mappings":";;AAYA,oDAeC;AAED,4DAmBC;AAED,4DAmBC;AArED,6BAAuB;AAGvB,yCAAqC;AAErC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAU,CAAA;AAEnE;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,IAAgB;IACtE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,sEAAsE;YACtE,uEAAuE;YACvE,oCAAoC;QACtC,WAAW,EAAE;YACX,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;SAChE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACnG,CAAA;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAiB,EAAE,IAAgB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,0EAA0E;YAC1E,sEAAsE;YACtE,kEAAkE;YAClE,wCAAwC;QAC1C,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YACtE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAA;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAAiB,EAAE,IAAgB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,oEAAoE;QACtE,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;YACrC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAA;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/tools/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAyBzE"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAiBzE"}

package/dist/tools/get.js

@@ -6,22 +6,16 @@ const _helpers_1 = require("./_helpers");
 function registerGetTool(server, http) {
     server.registerTool('eml_get', {
         title: 'Get Engram',
-        description: 'Holt einen Engram per ID inkl. optionaler Relations. Mode-Variante ' +
-            '(/epistemic/:id, /context/:id) erzwingt mode-konsistente Lookups.',
+        description: 'Fetch one engram by ID, optionally with its relations.',
         inputSchema: {
-            id: zod_1.z.string().describe('Engram-ID (UUID).'),
-            mode: zod_1.z.enum(['epistemic', 'context']).optional().describe('Wenn gesetzt: lookup über mode-spezifischen Endpoint (404 wenn falscher Mode).'),
+            id: zod_1.z.string().describe('Engram ID (UUID).'),
             with_relations: zod_1.z.boolean().optional().describe('Default true.'),
-            caller: zod_1.z.string().optional(),
         },
     }, async (args) => (0, _helpers_1.callTool)(() => {
-        const path = args.mode ? `/${args.mode}/${args.id}` : `/engram/${args.id}`;
         const params = {};
         if (args.with_relations !== undefined)
             params.with_relations = String(args.with_relations);
-        if (args.caller)
-            params.caller = args.caller;
-        return http.get(path, params);
+        return http.get(`/engram/${args.id}`, params);
     }));
 }
 //# sourceMappingURL=get.js.map

package/dist/tools/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":";;AAKA,0CAyBC;AA9BD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,eAAe,CAAC,MAAiB,EAAE,IAAgB;IACjE,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,qEAAqE;YACrE,mEAAmE;QACrE,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5C,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxD,gFAAgF,CACjF;YACD,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YAChE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAA;QAC1E,MAAM,MAAM,GAAgD,EAAE,CAAA;QAC9D,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC1F,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/B,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":";;AAKA,0CAiBC;AAtBD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,eAAe,CAAC,MAAiB,EAAE,IAAgB;IACjE,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5C,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;SACjE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAgD,EAAE,CAAA;QAC9D,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC1F,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -1,11 +1,26 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { HttpClient } from '../http-client';
 /**
- * Registriert alle 13 Tools (v0.9-PROPOSAL §6.4).
+ * v0.9.1 — 17-tool set.
  *
- * Reihenfolge nicht semantisch — beeinflusst nur die `tools/list`-Order.
- * Boot/Recall sind die meist-genutzten, daher zuerst.
+ * Tool categories:
+ *   - Boot/Recall (2): eml_boot, eml_recall
+ *   - Typed write (4): eml_decide, eml_set_status, eml_track_task, eml_note
+ *   - Read/Find (5): eml_show, eml_list, eml_get, eml_projects, eml_entities
+ *   - Self-awareness (1): eml_stats
+ *   - Edit (1): eml_update
+ *   - Project CRUD (2): eml_project_create, eml_project_update
+ *   - Entity CRUD (2): eml_entity_create, eml_entity_update
+ *
+ * Intentionally not exposed in v0.9.1:
+ *   - eml_relate (HTTP-only power use)
+ *   - eml_confirm_review (brain-hygiene cluster, post-v0.9.1)
+ *   - eml_session_get (→ v0.9.2 with cross-session awareness)
+ *   - eml_epistemic_store / eml_context_store (replaced by typed tools)
+ *
+ * Order is not semantic — only affects the `tools/list` ordering.
+ * Boot/Recall come first because they're the most-used.
  */
 export declare function registerAllTools(server: McpServer, http: HttpClient): void;
-export declare const TOOL_NAMES: readonly ["eml_boot", "eml_recall", "eml_epistemic_store", "eml_context_store", "eml_list", "eml_get", "eml_relate", "eml_update", "eml_confirm_review", "eml_entity_create", "eml_entity_list", "eml_entity_get", "eml_entity_update"];
+export declare const TOOL_NAMES: readonly ["eml_boot", "eml_recall", "eml_decide", "eml_set_status", "eml_track_task", "eml_note", "eml_show", "eml_list", "eml_get", "eml_projects", "eml_entities", "eml_stats", "eml_update", "eml_project_create", "eml_project_update", "eml_entity_create", "eml_entity_update"];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAkBhD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAc1E;AAED,eAAO,MAAM,UAAU,yOAMb,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAwBhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAkB1E;AAED,eAAO,MAAM,UAAU,uRAQb,CAAA"}