@engramprotocol/mcp-server 0.9.1 → 0.10.1

package/README.md

@@ -2,51 +2,62 @@
 
 MCP wrapper around the EML HTTP API. Exposes the Engram Protocol as MCP tools for Claude Code (and other MCP clients) — stdio transport, Bearer token auth against `api.engramprotocol.io`.
 
-## Install + Run
+Request an API token: **parsley_22bonds@icloud.com**
+
+## Install
 
 ```bash
-npx @engramprotocol/mcp-server --url <api-url> --token <bearer>
+EML_API_TOKEN=eml_<prefix><secret> \
+  npx @engramprotocol/mcp-server setup install
 ```
 
-or via env vars:
+The installer:
+- Verifies the token against `/stats` before storing
+- Writes `~/.eml/config` (chmod 600) with URL + token + client-version
+- Registers the `engramprotocol` MCP server via `claude mcp add` (user scope, stdio transport, semver-range-pinned to `@~0.10`)
+- Adds two hooks to `~/.claude/settings.json` (see [Hooks](#hooks) below):
+  - **SessionStart** → loads your brain at session start (identity, rules, decisions, status, tasks, protocol conventions)
+  - **UserPromptSubmit** → light mid-session reminder on turn 1, every 5 turns, or after >1h pause
+- Adds two permissions: `mcp__engramprotocol__*` (skip per-call prompt for EML tools) and `Bash(npx @engramprotocol/mcp-server setup *)` (let the agent auto-execute `setup update` when prompted)
+- Performs a final `/stats` round-trip as smoke test
+
+A backup of `~/.claude/settings.json` is created first (pattern `.pre-eml-install-YYYY-MM-DD-HH-MM-SS.bak`).
+
+### Update
 
 ```bash
-EML_API_URL=https://api.engramprotocol.io \
-EML_API_TOKEN=eml_<prefix><secret> \
-npx @engramprotocol/mcp-server
+npx @engramprotocol/mcp-server@latest setup update
 ```
 
-## Claude Code config
+Refreshes hook templates (marker-aware — preserves files you customised), bumps `EML_CLIENT_VERSION` in `~/.eml/config`. Idempotent. The `@latest` suffix busts the npx cache so you actually get the new version.
 
-The recommended way is via `claude mcp add`:
+### Uninstall
 
 ```bash
-claude mcp add engramprotocol \
-  --env EML_API_URL=https://api.engramprotocol.io \
-  --env EML_API_TOKEN=eml_<prefix><secret> \
-  -- npx -y @engramprotocol/mcp-server
+npx @engramprotocol/mcp-server setup uninstall
 ```
 
-Or directly in `~/.claude/settings.json` (or your client's MCP config path):
-
-```json
-{
-  "mcpServers": {
-    "engramprotocol": {
-      "command": "npx",
-      "args": ["-y", "@engramprotocol/mcp-server"],
-      "env": {
-        "EML_API_URL": "https://api.engramprotocol.io",
-        "EML_API_TOKEN": "eml_<prefix><secret>"
-      }
-    }
-  }
-}
-```
+Removes the MCP registration, the two managed hook entries, the two managed permission entries, and `~/.eml/hooks/`. Your own hooks and permissions are untouched. `~/.eml/config` is kept by default (asks for confirmation before delete — it contains your token).
+
+## Hooks
+
+Two bash hooks land in `~/.eml/hooks/`:
+
+### `session_start_boot.sh` (SessionStart event)
+- Sources `~/.eml/config`, POSTs to `/boot`, prints the returned markdown to stdout
+- Claude Code injects that stdout into model context — **invisible in chat** but reaches the model (verified empirically; behavior decided 2026-05-15)
+- Performs an update-banner check: if `EML_CLIENT_VERSION` from config differs from `/boot.version`, emits a banner pointing to `setup update`
+- Fail-soft: missing config, missing vars, or unreachable server emits a warning and exits 0 — session continues without brain
+
+### `user_prompt_submit_reminder.sh` (UserPromptSubmit event)
+- Local only, no HTTP
+- Triggers a 5-bullet reminder on turn 1, every 5 turns, or after >1h pause
+- Per-session turn counter at `/tmp/eml-turns/<session_id>`
+- Reminder content is a heredoc inside the script — refreshed via `setup update`
 
-Request api token via email: parsley_22bonds@icloud.com
+Both hooks log to `~/.eml/logs/<event>-YYYY-MM-DD.log` (self-rotating per day) and carry a `# managed-by: engramprotocol-setup` marker line that lets `setup update` / `setup uninstall` identify which files they own.
 
-## Tools (v0.9.1)
+## Tools (v0.10.0)
 
 All tools have an `eml_` prefix. Total: **17 tools**.
 
@@ -54,7 +65,7 @@ All tools have an `eml_` prefix. Total: **17 tools**.
 
 | Tool | HTTP endpoint | Use case |
 |---|---|---|
-| `eml_boot` | `POST /boot` | Identity + status + open tasks at session start |
+| `eml_boot` | `POST /boot` | Manual brain-reload (SessionStart-Hook does this automatically at session start) |
 | `eml_recall` | `POST /recall` | Topic search (FTS5 + recency) |
 
 ### Write (typed)
@@ -64,14 +75,14 @@ All tools have an `eml_` prefix. Total: **17 tools**.
 | `eml_decide` | `POST /context` (type=decision) | Record a deliberate, documented decision |
 | `eml_set_status` | `POST /context` (type=status) | Set current status for a scope (auto-supersedes old active status) |
 | `eml_track_task` | `POST /context` (type=task) | Plan/track a task with priority + due date |
-| `eml_note` | `POST /context` (kind-discriminated) | Sammelfach for rule/profile/event/reference/log |
+| `eml_note` | `POST /context` (kind-discriminated) | Catch-all for rule/profile/event/reference/log |
 
 ### Read / Find
 
 | Tool | HTTP endpoint | Use case |
 |---|---|---|
 | `eml_show` | `GET /brain-state?scope=` | Curated snapshot for any scope |
-| `eml_list` | `GET /list[/mode]` | Filter-based engram list |
+| `eml_list` | `GET /list` | Filter-based engram list |
 | `eml_get` | `GET /engram/:id` | Single engram + relations |
 | `eml_projects` | `GET /projects` | List projects (filter: status) |
 | `eml_entities` | `GET /entities` | List entities (filter: kind) |
@@ -92,12 +103,12 @@ All tools have an `eml_` prefix. Total: **17 tools**.
 | `eml_entity_create` | `POST /entity` | Register an entity (required before `scope=entity.<id>`) |
 | `eml_entity_update` | `PUT /entity/:id` | Patch entity fields |
 
-### Intentionally not exposed (v0.9.1)
+### Intentionally not exposed (v0.10.0)
 
 - `eml_relate` — available via HTTP API directly
-- `eml_confirm_review` — deferred to brain-hygiene cluster (post-v0.9.1)
-- Epistemic-mode write tools (observation/hypothesis/assessment/prediction/pattern) — available via HTTP API
-- `eml_session_get` — deferred to v0.9.2 (cross-session awareness)
+- `eml_confirm_review` — deferred to brain-hygiene cluster
+- Epistemic-mode write tools (observation/hypothesis/assessment/prediction/pattern) — Alpha-state, available via HTTP API
+- Session-Awareness tools — deferred to its own future version
 - `eml_*_delete` — by design not in the agent action space; cleanup is operator-only
 
 ## Error handling

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@engramprotocol/mcp-server",
-  "version": "0.9.1",
-  "description": "MCP wrapper for the EML HTTP API — exposes the Engram Protocol as MCP tools for Claude Code and other MCP clients",
+  "version": "0.10.1",
+  "description": "MCP wrapper for the EML HTTP API — exposes the Engram Protocol as MCP tools for Claude Code and other MCP clients. Includes setup-mode for one-shot install/update/uninstall.",
   "license": "MIT",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",
   "bin": {
-    "eml-mcp-server": "./dist/cli.js"
+    "eml-mcp-server": "./dist/cli.js",
+    "mcp-server": "./dist/cli.js"
   },
   "files": [
     "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],

package/templates/hooks/session_start_boot.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# managed-by: engramprotocol-setup
+#
+# SessionStart-Hook: loads the EML brain into Claude Code's session context.
+# Output is invisible-in-chat but reaches the model's context (verified empirically
+# via spike 2026-05-15 — see brain decision dc5a9ad5).
+#
+# Layout: 7 sections — safety+constants, log+stdin, config check, sanity, /boot
+# call, update-banner check, emit markdown.
+
+set -eu
+
+# --- 1. Safety + Constants -------------------------------------------------
+CONFIG="$HOME/.eml/config"
+LOG_DIR="$HOME/.eml/logs"
+
+# --- 2. Log setup + stdin capture ------------------------------------------
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/session-start-$(date -u +%Y-%m-%d).log"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+STDIN=$(cat || true)
+echo "[$TS] fired (pid=$$) stdin=$STDIN" >> "$LOG_FILE"
+
+# --- 3. Config check + source ----------------------------------------------
+if [ ! -f "$CONFIG" ]; then
+  echo "⚠️ EML config missing at $CONFIG — run 'npx @engramprotocol/mcp-server setup'"
+  echo "[$TS] FAIL config missing" >> "$LOG_FILE"
+  exit 0
+fi
+. "$CONFIG"
+
+# --- 4. Sanity: required vars ----------------------------------------------
+if [ -z "${EML_URL:-}" ] || [ -z "${EML_API_TOKEN:-}" ]; then
+  echo "⚠️ EML config incomplete — EML_URL or EML_API_TOKEN missing in $CONFIG"
+  echo "[$TS] FAIL incomplete config" >> "$LOG_FILE"
+  exit 0
+fi
+
+# --- 5. Call /boot ---------------------------------------------------------
+RESPONSE=$(curl -fsS -m 8 \
+  -H "Authorization: Bearer $EML_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -X POST -d '{}' \
+  "$EML_URL/boot" 2>>"$LOG_FILE") || {
+  echo "⚠️ EML Boot failed — server unreachable or auth error. See $LOG_FILE"
+  echo "[$TS] FAIL curl non-zero" >> "$LOG_FILE"
+  exit 0
+}
+
+# --- 6. Update-banner check ------------------------------------------------
+SERVER_VER=$(echo "$RESPONSE" | jq -r '.version // empty')
+if [ -n "${EML_CLIENT_VERSION:-}" ] && [ -n "$SERVER_VER" ] && [ "$EML_CLIENT_VERSION" != "$SERVER_VER" ]; then
+  cat <<EOF
+## ⚠️ Update Available
+- @engramprotocol/mcp-server: $EML_CLIENT_VERSION → $SERVER_VER available
+- **Run** \`npx @engramprotocol/mcp-server setup update\`, **or ask me to update for you** — I'll run it on your behalf.
+
+EOF
+fi
+
+# --- 7. Emit boot markdown + log success -----------------------------------
+echo "$RESPONSE" | jq -r '.markdown'
+echo "[$TS] OK ver=$SERVER_VER bytes=$(echo "$RESPONSE" | wc -c)" >> "$LOG_FILE"

package/templates/hooks/user_prompt_submit_reminder.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# managed-by: engramprotocol-setup
+#
+# UserPromptSubmit-Hook: Mid-session reminder to keep the model anchored in EML
+# patterns. Claude Code fires this hook on every user message. The hook decides
+# whether to print the reminder (when a trigger condition matches) or stay silent.
+#
+# Triggers (any one suffices):
+#   - turn == 1     (initial reminder at session start; SessionStart-Hook already
+#                    loaded SYSTEM_RULES + brain state, so one reinforcement is enough)
+#   - turn % 5 == 0 (every 5th turn — anti-drift cadence)
+#   - counter file mtime > 1h ago (session resumed after pause)
+#
+# State files (per v0.10.0-PROPOSAL B.4.1):
+#   /tmp/eml-turns/<session_id>          turn counter
+#   ~/.eml/logs/user-prompt-submit-*.log debug log (self-rotating per day)
+#
+# Local-only, no HTTP. Reminder content lives inline as heredoc — single source of
+# truth, evolves with the npm-package via `setup update`.
+
+set -eu
+
+LOG_DIR="$HOME/.eml/logs"
+TURNS_DIR="/tmp/eml-turns"
+
+mkdir -p "$LOG_DIR" "$TURNS_DIR"
+LOG_FILE="$LOG_DIR/user-prompt-submit-$(date -u +%Y-%m-%d).log"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+# --- 1. Parse stdin for session_id -----------------------------------------
+STDIN=$(cat || true)
+SESSION_ID=$(echo "$STDIN" | jq -r '.session_id // empty' 2>/dev/null || true)
+
+if [ -z "$SESSION_ID" ]; then
+  echo "[$TS] no session_id in stdin, silent" >> "$LOG_FILE"
+  exit 0
+fi
+
+COUNTER_FILE="$TURNS_DIR/$SESSION_ID"
+
+# --- 2. Read counter + detect long pause -----------------------------------
+RESUMED_AFTER_PAUSE=0
+if [ -f "$COUNTER_FILE" ]; then
+  TURN=$(cat "$COUNTER_FILE" 2>/dev/null || echo 0)
+  # mtime — macOS uses `stat -f %m`, Linux uses `stat -c %Y`
+  MTIME=$(stat -f %m "$COUNTER_FILE" 2>/dev/null || stat -c %Y "$COUNTER_FILE" 2>/dev/null || echo 0)
+  NOW=$(date +%s)
+  ELAPSED=$((NOW - MTIME))
+  if [ "$ELAPSED" -gt 3600 ]; then RESUMED_AFTER_PAUSE=1; fi
+else
+  TURN=0
+fi
+
+TURN=$((TURN + 1))
+echo "$TURN" > "$COUNTER_FILE"
+
+# --- 3. Trigger decision ---------------------------------------------------
+SHOULD_REMIND=0
+if [ "$TURN" -eq 1 ]; then SHOULD_REMIND=1; fi
+if [ "$((TURN % 5))" -eq 0 ]; then SHOULD_REMIND=1; fi
+if [ "$RESUMED_AFTER_PAUSE" -eq 1 ]; then SHOULD_REMIND=1; fi
+
+if [ "$SHOULD_REMIND" -eq 0 ]; then
+  echo "[$TS] silent turn=$TURN sid=$SESSION_ID" >> "$LOG_FILE"
+  exit 0
+fi
+
+# --- 4. Emit reminder (invisible-in-chat, in-model-context per Spike-2) ----
+cat <<'EOF'
+[EML Reminder]
+- Store-worthy moments (decisions, status changes, tasks, events, feedback rules) → use the matching typed tool (eml_decide / eml_set_status / eml_track_task / eml_note).
+- Question about customer / project / topic? eml_recall or eml_show first — don't guess from conversation memory.
+- Before write: matching active engram exists? skip, or supersede via eml_update (don't duplicate).
+- Routine updates: act + inform in 1-2 lines, no permission-asking.
+- EML brain is the canonical knowledge base — check it before falling back to conversation memory.
+EOF
+
+echo "[$TS] OK turn=$TURN sid=$SESSION_ID reminded (pause=$RESUMED_AFTER_PAUSE)" >> "$LOG_FILE"

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const server_1 = require("./server");
-function parseArgs(argv) {
-    const out = {};
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === '--help' || a === '-h') {
-            out.help = true;
-            continue;
-        }
-        if (a === '--url') {
-            out.url = argv[++i];
-            continue;
-        }
-        if (a === '--token') {
-            out.token = argv[++i];
-            continue;
-        }
-        if (a === '--name') {
-            out.name = argv[++i];
-            continue;
-        }
-    }
-    return out;
-}
-function printHelpAndExit(code) {
-    const msg = `eml-mcp-server — MCP wrapper for the EML HTTP API
-
-Usage:
-  eml-mcp-server --url <api-url> --token <bearer> [--name <client-name>]
-
-Args:
-  --url     EML_API_URL      EML API URL (e.g. http://localhost:3117)
-  --token   EML_API_TOKEN    Bearer token (eml_<prefix><secret>)
-  --name    EML_CLIENT_NAME  Client name in server logs (default: eml-mcp-server)
-  --help
-
-Example — Claude Code MCP config:
-  {
-    "mcpServers": {
-      "engramprotocol": {
-        "command": "npx",
-        "args": ["-y", "@engramprotocol/mcp-server"],
-        "env": {
-          "EML_API_URL": "https://api.engramprotocol.io",
-          "EML_API_TOKEN": "eml_..."
-        }
-      }
-    }
-  }
-`;
-    process.stderr.write(msg);
-    process.exit(code);
-}
-async function main() {
-    const args = parseArgs(process.argv.slice(2));
-    if (args.help)
-        printHelpAndExit(0);
-    const url = args.url ?? process.env.EML_API_URL;
-    const token = args.token ?? process.env.EML_API_TOKEN;
-    const clientName = args.name ?? process.env.EML_CLIENT_NAME ?? 'eml-mcp-server';
-    if (!url || !token) {
-        process.stderr.write('Error: --url + --token (or EML_API_URL + EML_API_TOKEN) are required.\n\n');
-        printHelpAndExit(1);
-    }
-    try {
-        await (0, server_1.startMcpServer)({ url, token, clientName });
-        process.stderr.write(`[eml-mcp-server] connected, stdio-transport ready (${clientName} → ${url})\n`);
-    }
-    catch (err) {
-        const e = err;
-        process.stderr.write(`[eml-mcp-server] startup failed: ${e.message}\n`);
-        process.exit(1);
-    }
-}
-main();
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,qCAAyC;AAuBzC,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAY,EAAE,CAAA;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAC,SAAQ;QAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,OAAO,EAAI,CAAC;YAAC,GAAG,CAAC,GAAG,GAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxD,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxD,IAAI,CAAC,KAAK,QAAQ,EAAG,CAAC;YAAC,GAAG,CAAC,IAAI,GAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAAC,SAAQ;QAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAA;IACC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,IAAI,IAAI,CAAC,IAAI;QAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB,CAAA;IAE/E,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAA;QACjG,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAA,uBAAc,EAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,UAAU,MAAM,GAAG,KAAK,CAAC,CAAA;IACtG,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAAY,CAAA;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAA;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAA"}

package/dist/http-client.d.ts

@@ -1,33 +0,0 @@
-/**
- * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
- *
- * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
- * server ships as a small npm package (`@engramprotocol/mcp-server`) that
- * only needs the SDK + zod + this file.
- *
- * Error handling: all failures throw `EmlApiError`. Tools catch it in the
- * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
- * "Error handling — two channels").
- */
-export interface HttpClientOptions {
-    url: string;
-    token: string;
-    timeoutMs?: number;
-}
-export declare class EmlApiError extends Error {
-    status: number;
-    body: unknown;
-    constructor(status: number, body: unknown, message: string);
-}
-export declare class HttpClient {
-    private readonly baseUrl;
-    private readonly headers;
-    private readonly timeoutMs;
-    constructor(opts: HttpClientOptions);
-    get(path: string, query?: Record<string, string | number | undefined>): Promise<unknown>;
-    post(path: string, body?: unknown): Promise<unknown>;
-    put(path: string, body?: unknown): Promise<unknown>;
-    private buildPath;
-    private request;
-}
-//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,WAAY,SAAQ,KAAK;IAE3B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,OAAO;gBADb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,EAAE,iBAAiB;IAS7B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzD,OAAO,CAAC,SAAS;YAUH,OAAO;CA+BtB"}

package/dist/http-client.js

@@ -1,106 +0,0 @@
-"use strict";
-/**
- * Thin fetch wrapper for the EML HTTP API (v0.9-PROPOSAL §6.2).
- *
- * Deliberately lives without an `@engramprotocol/core` dependency — the MCP
- * server ships as a small npm package (`@engramprotocol/mcp-server`) that
- * only needs the SDK + zod + this file.
- *
- * Error handling: all failures throw `EmlApiError`. Tools catch it in the
- * handler and map to an `isError: true` result (see v0.9-PROPOSAL §6.4
- * "Error handling — two channels").
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpClient = exports.EmlApiError = void 0;
-class EmlApiError extends Error {
-    status;
-    body;
-    constructor(status, body, message) {
-        super(message);
-        this.status = status;
-        this.body = body;
-        this.name = 'EmlApiError';
-    }
-}
-exports.EmlApiError = EmlApiError;
-class HttpClient {
-    baseUrl;
-    headers;
-    timeoutMs;
-    constructor(opts) {
-        this.baseUrl = opts.url.replace(/\/+$/, '');
-        this.headers = {
-            'Authorization': `Bearer ${opts.token}`,
-            'Content-Type': 'application/json',
-        };
-        this.timeoutMs = opts.timeoutMs ?? 30_000;
-    }
-    async get(path, query) {
-        return this.request('GET', this.buildPath(path, query));
-    }
-    async post(path, body) {
-        return this.request('POST', path, body);
-    }
-    async put(path, body) {
-        return this.request('PUT', path, body);
-    }
-    buildPath(path, query) {
-        if (!query)
-            return path;
-        const params = [];
-        for (const [k, v] of Object.entries(query)) {
-            if (v === undefined || v === null)
-                continue;
-            params.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
-        }
-        return params.length ? `${path}?${params.join('&')}` : path;
-    }
-    async request(method, path, body) {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-        try {
-            const res = await fetch(`${this.baseUrl}${path}`, {
-                method,
-                headers: this.headers,
-                body: body !== undefined ? JSON.stringify(body) : undefined,
-                signal: controller.signal,
-            });
-            const text = await res.text();
-            let parsed = null;
-            if (text) {
-                try {
-                    parsed = JSON.parse(text);
-                }
-                catch {
-                    parsed = text;
-                }
-            }
-            if (!res.ok) {
-                const msg = extractErrorMessage(parsed) ?? `HTTP ${res.status}`;
-                throw new EmlApiError(res.status, parsed, `${method} ${path} → ${res.status}: ${msg}`);
-            }
-            return parsed;
-        }
-        catch (err) {
-            if (err instanceof EmlApiError)
-                throw err;
-            const e = err;
-            if (e.name === 'AbortError') {
-                throw new EmlApiError(0, null, `${method} ${path} timed out after ${this.timeoutMs}ms`);
-            }
-            throw new EmlApiError(0, null, `${method} ${path} failed: ${e.message}`);
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    }
-}
-exports.HttpClient = HttpClient;
-function extractErrorMessage(body) {
-    if (body && typeof body === 'object' && 'error' in body) {
-        const e = body.error;
-        return typeof e === 'string' ? e : JSON.stringify(e);
-    }
-    return null;
-}
-//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/server.d.ts

@@ -1,18 +0,0 @@
-/**
- * MCP server setup (v0.9-PROPOSAL §6).
- *
- * Single-mode HTTP client (no embedded SQLite). Self-host uses the same
- * invocation, just with `--url http://localhost:3117`.
- *
- * Stdio transport: local process spawned by Claude Code's MCP config.
- * Capabilities: tools only (static, listChanged=false). Resources/prompts
- * are v0.9.x polish.
- */
-export interface McpServerOptions {
-    url: string;
-    token: string;
-    clientName?: string;
-    serverVersion?: string;
-}
-export declare function startMcpServer(opts: McpServerOptions): Promise<void>;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1E"}

package/dist/server.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startMcpServer = startMcpServer;
-const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const http_client_1 = require("./http-client");
-const tools_1 = require("./tools");
-async function startMcpServer(opts) {
-    const httpClient = new http_client_1.HttpClient({ url: opts.url, token: opts.token });
-    const server = new mcp_js_1.McpServer({
-        name: opts.clientName ?? 'eml-mcp-server',
-        version: opts.serverVersion ?? '0.9.0',
-    });
-    (0, tools_1.registerAllTools)(server, httpClient);
-    const transport = new stdio_js_1.StdioServerTransport();
-    await server.connect(transport);
-}
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;AAuBA,wCAYC;AAnCD,oEAAmE;AACnE,wEAAgF;AAChF,+CAA0C;AAC1C,mCAA0C;AAoBnC,KAAK,UAAU,cAAc,CAAC,IAAsB;IACzD,MAAM,UAAU,GAAG,IAAI,wBAAU,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAEvE,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB;QACzC,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,OAAO;KACvC,CAAC,CAAA;IAEF,IAAA,wBAAgB,EAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAEpC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC"}

package/dist/tools/_helpers.d.ts

@@ -1,18 +0,0 @@
-/**
- * Tool handler wrapper (v0.9-PROPOSAL §6.4 "Error handling — two channels").
- *
- * - 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.
- *
- * 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<{
-        type: 'text';
-        text: string;
-    }>;
-    isError?: boolean;
-}>;
-//# sourceMappingURL=_helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../src/tools/_helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAC,CAoBD"}

package/dist/tools/_helpers.js

@@ -1,37 +0,0 @@
-"use strict";
-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 — two channels").
- *
- * - 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.
- *
- * 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 {
-        const result = await fn();
-        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
-    }
-    catch (err) {
-        if (err instanceof http_client_1.EmlApiError) {
-            return {
-                isError: true,
-                content: [{
-                        type: 'text',
-                        text: `EML API error (HTTP ${err.status}): ${err.message}`,
-                    }],
-            };
-        }
-        const e = err;
-        return {
-            isError: true,
-            content: [{ type: 'text', text: `Tool execution failed: ${e.message}` }],
-        };
-    }
-}
-//# sourceMappingURL=_helpers.js.map