ema-mcp-toolkit 0.2.0

package/dist/syncOptions.js

@@ -0,0 +1,216 @@
+/**
+ * Sync Options Configuration
+ *
+ * Hierarchical configuration for sync behavior, loaded from:
+ * 1. .ema.yaml in repo root (shared team defaults)
+ * 2. ~/.ema.yaml in user home (personal overrides)
+ * 3. Tool parameters (runtime overrides)
+ *
+ * Resolution order (lowest → highest priority):
+ * Built-in defaults → defaults → targets[env] → personas[name] → tool params
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import yaml from "js-yaml";
+import { z } from "zod";
+// ─────────────────────────────────────────────────────────────────────────────
+// Schema
+// ─────────────────────────────────────────────────────────────────────────────
+const SyncBehaviorSchema = z.object({
+    sync_status: z.boolean().optional(),
+    dry_run: z.boolean().optional(),
+}).strict();
+const RoutingRuleSchema = z.object({
+    match: z.object({
+        names: z.array(z.string()).optional().default([]),
+        ids: z.array(z.string()).optional().default([]),
+    }).strict(),
+    targets: z.array(z.string()).min(1),
+}).strict();
+const SyncOptionsConfigSchema = z.object({
+    defaults: SyncBehaviorSchema.optional().default({}),
+    targets: z.record(SyncBehaviorSchema).optional().default({}),
+    personas: z.record(SyncBehaviorSchema).optional().default({}),
+    routing: z.array(RoutingRuleSchema).optional().default([]),
+}).strict();
+// ─────────────────────────────────────────────────────────────────────────────
+// Built-in defaults
+// ─────────────────────────────────────────────────────────────────────────────
+const BUILTIN_DEFAULTS = {
+    sync_status: false,
+    dry_run: false,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Config loading
+// ─────────────────────────────────────────────────────────────────────────────
+let cachedSyncOptions = null;
+function loadYamlFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf8");
+        return yaml.load(content);
+    }
+    catch {
+        return null;
+    }
+}
+function findRepoRoot() {
+    // Start from current working directory and look for .git or package.json
+    let dir = process.cwd();
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, ".git")) || fs.existsSync(path.join(dir, "package.json"))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return process.cwd();
+}
+/**
+ * Load and merge sync options from all config sources.
+ * Caches result for performance.
+ */
+export function loadSyncOptions() {
+    if (cachedSyncOptions)
+        return cachedSyncOptions;
+    const repoRoot = findRepoRoot();
+    const homeDir = os.homedir();
+    // Load from repo .ema.yaml
+    const repoConfigPath = path.join(repoRoot, ".ema.yaml");
+    const repoConfig = loadYamlFile(repoConfigPath);
+    // Load from ~/.ema.yaml
+    const userConfigPath = path.join(homeDir, ".ema.yaml");
+    const userConfig = loadYamlFile(userConfigPath);
+    // Merge configs (user overrides repo)
+    const merged = {
+        defaults: {},
+        targets: {},
+        personas: {},
+        routing: [],
+    };
+    // Apply repo config
+    if (repoConfig && typeof repoConfig === "object") {
+        const parsed = SyncOptionsConfigSchema.safeParse(repoConfig);
+        if (parsed.success) {
+            merged.defaults = { ...merged.defaults, ...parsed.data.defaults };
+            merged.targets = { ...merged.targets, ...parsed.data.targets };
+            merged.personas = { ...merged.personas, ...parsed.data.personas };
+            merged.routing = [...(parsed.data.routing ?? [])];
+        }
+    }
+    // Apply user config (overrides repo)
+    if (userConfig && typeof userConfig === "object") {
+        const parsed = SyncOptionsConfigSchema.safeParse(userConfig);
+        if (parsed.success) {
+            merged.defaults = { ...merged.defaults, ...parsed.data.defaults };
+            // Deep merge targets
+            for (const [env, behavior] of Object.entries(parsed.data.targets ?? {})) {
+                merged.targets[env] = { ...merged.targets[env], ...behavior };
+            }
+            // Deep merge personas
+            for (const [name, behavior] of Object.entries(parsed.data.personas ?? {})) {
+                merged.personas[name] = { ...merged.personas[name], ...behavior };
+            }
+            // Prepend user routing rules (higher priority)
+            merged.routing = [...(parsed.data.routing ?? []), ...merged.routing];
+        }
+    }
+    cachedSyncOptions = merged;
+    return merged;
+}
+/**
+ * Clear the cached sync options (for testing or config reload).
+ */
+export function clearSyncOptionsCache() {
+    cachedSyncOptions = null;
+}
+/**
+ * Resolve sync behavior for a specific persona and target environment.
+ *
+ * Resolution order (lowest → highest priority):
+ * 1. Built-in defaults
+ * 2. Config defaults
+ * 3. Config targets[targetEnv]
+ * 4. Config personas[personaName]
+ * 5. Runtime overrides (passed as parameter)
+ */
+export function resolveSyncBehavior(opts) {
+    const { personaName, targetEnv, overrides } = opts;
+    const config = loadSyncOptions();
+    // Start with built-in defaults
+    const resolved = { ...BUILTIN_DEFAULTS };
+    // Apply config defaults
+    if (config.defaults) {
+        if (config.defaults.sync_status !== undefined)
+            resolved.sync_status = config.defaults.sync_status;
+        if (config.defaults.dry_run !== undefined)
+            resolved.dry_run = config.defaults.dry_run;
+    }
+    // Apply target env overrides
+    const targetConfig = config.targets?.[targetEnv];
+    if (targetConfig) {
+        if (targetConfig.sync_status !== undefined)
+            resolved.sync_status = targetConfig.sync_status;
+        if (targetConfig.dry_run !== undefined)
+            resolved.dry_run = targetConfig.dry_run;
+    }
+    // Apply persona overrides
+    if (personaName) {
+        const personaConfig = config.personas?.[personaName];
+        if (personaConfig) {
+            if (personaConfig.sync_status !== undefined)
+                resolved.sync_status = personaConfig.sync_status;
+            if (personaConfig.dry_run !== undefined)
+                resolved.dry_run = personaConfig.dry_run;
+        }
+    }
+    // Apply runtime overrides
+    if (overrides) {
+        if (overrides.sync_status !== undefined)
+            resolved.sync_status = overrides.sync_status;
+        if (overrides.dry_run !== undefined)
+            resolved.dry_run = overrides.dry_run;
+    }
+    return resolved;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Routing
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Check if a string matches a glob pattern (simple implementation).
+ * Supports * as wildcard.
+ */
+function matchGlob(pattern, value) {
+    const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+    return regex.test(value);
+}
+/**
+ * Get target environments for a persona based on routing rules.
+ */
+export function getRoutingTargets(personaName, personaId) {
+    const config = loadSyncOptions();
+    const targets = new Set();
+    for (const rule of config.routing ?? []) {
+        // Check name patterns
+        for (const pattern of rule.match.names ?? []) {
+            if (matchGlob(pattern, personaName)) {
+                rule.targets.forEach((t) => targets.add(t));
+                break;
+            }
+        }
+        // Check IDs
+        if (rule.match.ids?.includes(personaId)) {
+            rule.targets.forEach((t) => targets.add(t));
+        }
+    }
+    return [...targets];
+}
+/**
+ * Validate sync options config.
+ */
+export function validateSyncOptions(input) {
+    const result = SyncOptionsConfigSchema.safeParse(input);
+    if (!result.success) {
+        return { ok: false, errors: result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`) };
+    }
+    return { ok: true, config: result.data };
+}

package/dist/ui.js

@@ -0,0 +1,334 @@
+export function uiHtml() {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Ema Agent Sync – Config Wizard</title>
+    <style>
+      body { font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial; margin: 24px; color: #111; }
+      .row { display: flex; gap: 16px; flex-wrap: wrap; }
+      .card { border: 1px solid #e5e7eb; border-radius: 12px; padding: 16px; max-width: 1100px; }
+      .card h2 { margin: 0 0 8px 0; font-size: 16px; }
+      label { display: block; font-size: 12px; color: #374151; margin-top: 10px; }
+      input, textarea, select { width: 100%; padding: 8px; border: 1px solid #d1d5db; border-radius: 8px; }
+      textarea { min-height: 120px; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; }
+      button { padding: 8px 12px; border-radius: 10px; border: 1px solid #d1d5db; background: #fff; cursor: pointer; }
+      button.primary { background: #111827; color: #fff; border-color: #111827; }
+      .muted { color: #6b7280; font-size: 12px; }
+      .danger { color: #b91c1c; }
+      .ok { color: #047857; }
+      .grid2 { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+      .env { border: 1px dashed #d1d5db; border-radius: 12px; padding: 12px; margin-top: 12px; }
+      .envHeader { display: flex; justify-content: space-between; align-items: center; gap: 10px; }
+      .pill { font-size: 12px; padding: 2px 8px; border-radius: 999px; border: 1px solid #d1d5db; }
+      .footer { margin-top: 16px; display: flex; gap: 10px; flex-wrap: wrap; align-items: center; }
+      .small { font-size: 12px; }
+    </style>
+  </head>
+  <body>
+    <h1 style="margin:0 0 6px 0;">Ema Agent Sync – Config Wizard</h1>
+    <div class="muted">Build and validate a <code>config.yaml</code> for the sync service. Tokens are referenced by env var name (not stored).</div>
+
+    <div class="card" style="margin-top:16px;">
+      <h2>Global settings</h2>
+      <div class="grid2">
+        <div>
+          <label>stateDbPath</label>
+          <input id="stateDbPath" value="./ema-agent-sync.sqlite3" />
+        </div>
+        <div>
+          <label>dryRun</label>
+          <select id="dryRun">
+            <option value="false" selected>false</option>
+            <option value="true">true</option>
+          </select>
+        </div>
+        <div>
+          <label>scheduler.intervalSeconds</label>
+          <input id="intervalSeconds" type="number" value="300" />
+          <div class="muted">If set, cron is ignored.</div>
+        </div>
+        <div>
+          <label>scheduler.cron (optional)</label>
+          <input id="cron" placeholder='*/5 * * * *' />
+        </div>
+        <div>
+          <label>eventSharedSecretEnv (optional)</label>
+          <input id="eventSharedSecretEnv" placeholder="EMA_SYNC_EVENT_SECRET" />
+          <div class="muted">If set, <code>/events/persona-changed</code> requires header <code>x-ema-sync-secret</code>.</div>
+        </div>
+      </div>
+    </div>
+
+    <div class="card" style="margin-top:16px;">
+      <h2>Environments (exactly one must be master)</h2>
+      <div id="envList"></div>
+      <div class="footer">
+        <button id="addEnv">Add environment</button>
+        <div class="muted">Each env needs: name, userId, baseUrl, bearerTokenEnv. Select exactly one master.</div>
+      </div>
+    </div>
+
+    <div class="card" style="margin-top:16px;">
+      <h2>Routing rules</h2>
+      <div class="muted">Select which master persona IDs sync to which target envs. For creates in replicas, provide createTemplateId.</div>
+      <div id="routeList"></div>
+      <div class="footer">
+        <button id="addRoute">Add routing rule</button>
+      </div>
+    </div>
+
+    <div class="card" style="margin-top:16px;">
+      <h2>Generated config</h2>
+      <div class="row">
+        <button class="primary" id="validate">Validate</button>
+        <button id="download">Download config.yaml</button>
+        <button id="save">Save to server</button>
+        <button id="copy">Copy YAML</button>
+        <span id="status" class="small muted"></span>
+      </div>
+      <label>YAML</label>
+      <textarea id="yaml" spellcheck="false"></textarea>
+      <label>Env exports (optional helper)</label>
+      <textarea id="exports" spellcheck="false"></textarea>
+    </div>
+
+    <script type="module" src="/ui/app.js"></script>
+  </body>
+</html>`;
+}
+export function uiJs() {
+    return `
+const $ = (id) => document.getElementById(id);
+
+let envs = [
+  { name: "prod", userId: "prod-user", baseUrl: "https://YOUR-PROD-EMA-BASE-URL", bearerTokenEnv: "EMA_PROD_BEARER_TOKEN", isMaster: true },
+  { name: "staging", userId: "staging-user", baseUrl: "https://YOUR-STAGING-EMA-BASE-URL", bearerTokenEnv: "EMA_STAGING_BEARER_TOKEN", isMaster: false },
+];
+let routes = [
+  { personaIds: ["550e8400-e29b-41d4-a716-446655440000"], targetEnvs: ["staging"], createTemplateId: "TEMPLATE-UUID-HERE" }
+];
+
+function renderEnvs() {
+  const root = $("envList");
+  root.innerHTML = "";
+  envs.forEach((e, idx) => {
+    const div = document.createElement("div");
+    div.className = "env";
+    div.innerHTML = \`
+      <div class="envHeader">
+        <div>
+          <span class="pill">\${e.isMaster ? "MASTER" : "REPLICA"}</span>
+          <span class="muted">#\${idx + 1}</span>
+        </div>
+        <div class="row" style="margin:0;">
+          <button data-action="setMaster">Set as master</button>
+          <button data-action="remove">Remove</button>
+        </div>
+      </div>
+      <div class="grid2">
+        <div><label>name</label><input data-k="name" value="\${escapeHtml(e.name)}" /></div>
+        <div><label>userId</label><input data-k="userId" value="\${escapeHtml(e.userId)}" /></div>
+        <div><label>baseUrl</label><input data-k="baseUrl" value="\${escapeHtml(e.baseUrl)}" /></div>
+        <div><label>bearerTokenEnv</label><input data-k="bearerTokenEnv" value="\${escapeHtml(e.bearerTokenEnv)}" /></div>
+      </div>
+    \`;
+    div.addEventListener("input", (ev) => {
+      const t = ev.target;
+      if (!(t instanceof HTMLInputElement)) return;
+      const k = t.getAttribute("data-k");
+      if (!k) return;
+      envs[idx] = { ...envs[idx], [k]: t.value };
+      refreshOutputs();
+    });
+    div.querySelector("[data-action='setMaster']").addEventListener("click", () => {
+      envs = envs.map((x, i) => ({ ...x, isMaster: i === idx }));
+      renderEnvs();
+      refreshOutputs();
+    });
+    div.querySelector("[data-action='remove']").addEventListener("click", () => {
+      envs.splice(idx, 1);
+      if (!envs.some((x) => x.isMaster) && envs.length > 0) envs[0].isMaster = true;
+      renderEnvs();
+      refreshOutputs();
+    });
+    root.appendChild(div);
+  });
+}
+
+function renderRoutes() {
+  const root = $("routeList");
+  root.innerHTML = "";
+  routes.forEach((r, idx) => {
+    const div = document.createElement("div");
+    div.className = "env";
+    div.innerHTML = \`
+      <div class="envHeader">
+        <div><span class="pill">RULE</span> <span class="muted">#\${idx + 1}</span></div>
+        <div><button data-action="remove">Remove</button></div>
+      </div>
+      <div class="grid2">
+        <div>
+          <label>personaIds (one per line)</label>
+          <textarea data-k="personaIds" spellcheck="false">\${(r.personaIds ?? []).join("\\n")}</textarea>
+          <label>nameGlobs (one per line, e.g. ema-*)</label>
+          <textarea data-k="nameGlobs" spellcheck="false">\${(r.nameGlobs ?? []).join("\\n")}</textarea>
+          <label>namePrefixes (one per line, e.g. ema-)</label>
+          <textarea data-k="namePrefixes" spellcheck="false">\${(r.namePrefixes ?? []).join("\\n")}</textarea>
+          <label>nameRegexes (one per line, JS regex, e.g. ^(ema-|x|yy|z))</label>
+          <textarea data-k="nameRegexes" spellcheck="false">\${(r.nameRegexes ?? []).join("\\n")}</textarea>
+        </div>
+        <div>
+          <label>targetEnvs (comma separated)</label>
+          <input data-k="targetEnvs" value="\${escapeHtml((r.targetEnvs ?? []).join(", "))}" />
+          <label>createTemplateId (required if target persona missing)</label>
+          <input data-k="createTemplateId" value="\${escapeHtml(r.createTemplateId ?? "")}" />
+        </div>
+      </div>
+    \`;
+    div.addEventListener("input", (ev) => {
+      const t = ev.target;
+      if (t instanceof HTMLTextAreaElement) {
+        const k = t.getAttribute("data-k");
+        if (!k) return;
+        const arr = t.value.split(/\\r?\\n/).map((s) => s.trim()).filter(Boolean);
+        if (k === "personaIds" || k === "nameGlobs" || k === "namePrefixes" || k === "nameRegexes") {
+          routes[idx] = { ...routes[idx], [k]: arr };
+          refreshOutputs();
+          return;
+        }
+      }
+      if (!(t instanceof HTMLInputElement)) return;
+      const k = t.getAttribute("data-k");
+      if (!k) return;
+      if (k === "targetEnvs") {
+        routes[idx] = { ...routes[idx], targetEnvs: t.value.split(",").map((s) => s.trim()).filter(Boolean) };
+      } else if (k === "createTemplateId") {
+        routes[idx] = { ...routes[idx], createTemplateId: t.value.trim() || undefined };
+      }
+      refreshOutputs();
+    });
+    div.querySelector("[data-action='remove']").addEventListener("click", () => {
+      routes.splice(idx, 1);
+      renderRoutes();
+      refreshOutputs();
+    });
+    root.appendChild(div);
+  });
+}
+
+function buildConfigJson() {
+  const stateDbPath = $("stateDbPath").value.trim() || "./ema-agent-sync.sqlite3";
+  const dryRun = $("dryRun").value === "true";
+  const intervalSeconds = Number($("intervalSeconds").value || "300");
+  const cron = $("cron").value.trim() || undefined;
+  const eventSharedSecretEnv = $("eventSharedSecretEnv").value.trim() || undefined;
+
+  return {
+    dryRun,
+    stateDbPath,
+    environments: envs.map((e) => ({
+      name: e.name.trim(),
+      userId: e.userId.trim(),
+      baseUrl: e.baseUrl.trim(),
+      bearerTokenEnv: e.bearerTokenEnv.trim(),
+      isMaster: !!e.isMaster,
+    })),
+    scheduler: cron ? { cron } : { intervalSeconds },
+    routing: routes.map((r) => ({
+      personaIds: (r.personaIds ?? []).filter(Boolean),
+      nameGlobs: (r.nameGlobs ?? []).filter(Boolean),
+      namePrefixes: (r.namePrefixes ?? []).filter(Boolean),
+      nameRegexes: (r.nameRegexes ?? []).filter(Boolean),
+      targetEnvs: (r.targetEnvs ?? []).filter(Boolean),
+      ...(r.createTemplateId ? { createTemplateId: r.createTemplateId } : {}),
+    })),
+    ...(eventSharedSecretEnv ? { eventSharedSecretEnv } : {}),
+  };
+}
+
+async function refreshOutputs() {
+  const cfg = buildConfigJson();
+  // YAML comes from server so it matches backend rendering exactly
+  const resp = await fetch("/api/config/yaml", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(cfg) });
+  const data = await resp.json();
+  $("yaml").value = data.yaml ?? "";
+
+  const exports = cfg.environments.map((e) => \`export \${e.bearerTokenEnv}="..."\`).join("\\n");
+  $("exports").value = exports + (cfg.eventSharedSecretEnv ? "\\n" + \`export \${cfg.eventSharedSecretEnv}="..."\` : "");
+}
+
+function escapeHtml(s) {
+  return String(s ?? "").replace(/[&<>\\"']/g, (c) => ({ "&":"&amp;","<":"&lt;",">":"&gt;","\\"":"&quot;","'":"&#39;" }[c]));
+}
+
+$("addEnv").addEventListener("click", () => {
+  envs.push({ name: "new-env", userId: "user", baseUrl: "https://YOUR-EMA-BASE-URL", bearerTokenEnv: "EMA_BEARER_TOKEN", isMaster: envs.length === 0 });
+  renderEnvs();
+  refreshOutputs();
+});
+
+$("addRoute").addEventListener("click", () => {
+  routes.push({ personaIds: [], nameGlobs: [], namePrefixes: [], nameRegexes: [], targetEnvs: [] });
+  renderRoutes();
+  refreshOutputs();
+});
+
+$("validate").addEventListener("click", async () => {
+  const cfg = buildConfigJson();
+  const resp = await fetch("/api/config/validate", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(cfg) });
+  const data = await resp.json();
+  const status = $("status");
+  if (data.ok) {
+    status.textContent = "Valid configuration.";
+    status.className = "small ok";
+  } else {
+    status.textContent = "Invalid: " + (data.errors ?? []).join("; ");
+    status.className = "small danger";
+  }
+});
+
+$("download").addEventListener("click", () => {
+  const blob = new Blob([$("yaml").value], { type: "text/yaml" });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = "config.yaml";
+  a.click();
+  URL.revokeObjectURL(url);
+});
+
+$("save").addEventListener("click", async () => {
+  const cfg = buildConfigJson();
+  const resp = await fetch("/api/config/save", {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "x-config-path": "./config.yaml" },
+    body: JSON.stringify(cfg),
+  });
+  const data = await resp.json();
+  const status = $("status");
+  if (data.ok) {
+    status.textContent = "Saved to " + data.savedTo + ". Restart the service to load it.";
+    status.className = "small ok";
+  } else {
+    status.textContent = "Save failed: " + (data.errors ?? []).join("; ");
+    status.className = "small danger";
+  }
+});
+
+$("copy").addEventListener("click", async () => {
+  await navigator.clipboard.writeText($("yaml").value);
+  const status = $("status");
+  status.textContent = "Copied to clipboard.";
+  status.className = "small ok";
+});
+
+// Global settings changes
+["stateDbPath", "dryRun", "intervalSeconds", "cron", "eventSharedSecretEnv"].forEach((id) => $(id).addEventListener("input", refreshOutputs));
+
+renderEnvs();
+renderRoutes();
+refreshOutputs();
+`;
+}