@joshuaswarren/openclaw-engram 9.2.5 → 9.2.6

package/dist/index.js

@@ -8240,6 +8240,174 @@ function validateRequest(schemaName, body) {
   return { success: false, error: formatZodError(result.error) };
 }
 
+// src/adapters/claude-code.ts
+var ClaudeCodeAdapter = class {
+  id = "claude-code";
+  matches(context) {
+    const clientName = context.clientInfo?.name?.toLowerCase() ?? "";
+    if (clientName.includes("claude")) return true;
+    const sessionHeader = headerValue(context.headers, "x-claude-session-id");
+    if (sessionHeader) return true;
+    return false;
+  }
+  resolveIdentity(context) {
+    const sessionId = headerValue(context.headers, "x-claude-session-id");
+    const projectPath = headerValue(context.headers, "x-claude-project-path");
+    const namespace = projectPath ? slugify(projectPath) : "claude-code";
+    const principal = headerValue(context.headers, "x-engram-principal") || context.clientInfo?.name || "claude-code";
+    return {
+      namespace,
+      principal,
+      sessionKey: sessionId ?? context.sessionKey,
+      adapterId: this.id
+    };
+  }
+};
+function headerValue(headers, key) {
+  const raw = headers[key];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function slugify(s) {
+  let slug = s.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+  let start = 0;
+  while (start < slug.length && slug[start] === "-") start++;
+  let end = slug.length;
+  while (end > start && slug[end - 1] === "-") end--;
+  return slug.slice(start, end).slice(0, 80) || "claude-code";
+}
+
+// src/adapters/codex.ts
+var CodexAdapter = class {
+  id = "codex";
+  matches(context) {
+    const clientName = context.clientInfo?.name?.toLowerCase() ?? "";
+    if (clientName.includes("codex")) return true;
+    const agentHeader = headerValue2(context.headers, "x-codex-agent-name");
+    if (agentHeader) return true;
+    return false;
+  }
+  resolveIdentity(context) {
+    const agentName = headerValue2(context.headers, "x-codex-agent-name");
+    const projectDir = headerValue2(context.headers, "x-codex-project-dir");
+    const namespace = projectDir ? slugify2(projectDir) : "codex";
+    const principal = headerValue2(context.headers, "x-engram-principal") || agentName || context.clientInfo?.name || "codex";
+    return {
+      namespace,
+      principal,
+      sessionKey: context.sessionKey,
+      adapterId: this.id
+    };
+  }
+};
+function headerValue2(headers, key) {
+  const raw = headers[key];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function slugify2(s) {
+  let slug = s.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+  let start = 0;
+  while (start < slug.length && slug[start] === "-") start++;
+  let end = slug.length;
+  while (end > start && slug[end - 1] === "-") end--;
+  return slug.slice(start, end).slice(0, 80) || "codex";
+}
+
+// src/adapters/replit.ts
+var ReplitAdapter = class {
+  id = "replit";
+  matches(context) {
+    if (headerValue3(context.headers, "x-replit-project-id")) return true;
+    if (headerValue3(context.headers, "x-replit-user-id")) return true;
+    return false;
+  }
+  resolveIdentity(context) {
+    const projectId = headerValue3(context.headers, "x-replit-project-id");
+    const userId = headerValue3(context.headers, "x-replit-user-id");
+    const namespace = projectId ? `replit-${sanitizeId(projectId)}` : "replit";
+    const principal = headerValue3(context.headers, "x-engram-principal") || (userId ? `replit-user-${sanitizeId(userId)}` : "replit-agent");
+    return {
+      namespace,
+      principal,
+      sessionKey: context.sessionKey,
+      adapterId: this.id
+    };
+  }
+};
+function headerValue3(headers, key) {
+  const raw = headers[key];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function sanitizeId(s) {
+  return s.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 64);
+}
+
+// src/adapters/hermes.ts
+var HermesAdapter = class {
+  id = "hermes";
+  matches(context) {
+    if (headerValue4(context.headers, "x-hermes-session-id")) return true;
+    if (headerValue4(context.headers, "x-hermes-profile")) return true;
+    return false;
+  }
+  resolveIdentity(context) {
+    const sessionId = headerValue4(context.headers, "x-hermes-session-id");
+    const profile = headerValue4(context.headers, "x-hermes-profile");
+    const namespace = profile ? slugify3(profile) : "hermes";
+    const principal = headerValue4(context.headers, "x-engram-principal") || profile || "hermes-agent";
+    return {
+      namespace,
+      principal,
+      sessionKey: sessionId ?? context.sessionKey,
+      adapterId: this.id
+    };
+  }
+};
+function headerValue4(headers, key) {
+  const raw = headers[key];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function slugify3(s) {
+  let slug = s.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+  let start = 0;
+  while (start < slug.length && slug[start] === "-") start++;
+  let end = slug.length;
+  while (end > start && slug[end - 1] === "-") end--;
+  return slug.slice(start, end).slice(0, 80) || "hermes";
+}
+
+// src/adapters/registry.ts
+var AdapterRegistry = class {
+  adapters;
+  constructor(adapters) {
+    this.adapters = adapters ?? [
+      new HermesAdapter(),
+      new ReplitAdapter(),
+      new CodexAdapter(),
+      new ClaudeCodeAdapter()
+    ];
+  }
+  /**
+   * Try each adapter in order. Return the first match, or null if
+   * no adapter recognizes the request context.
+   */
+  resolve(context) {
+    for (const adapter of this.adapters) {
+      if (adapter.matches(context)) {
+        return adapter.resolveIdentity(context);
+      }
+    }
+    return null;
+  }
+  /** List registered adapter IDs */
+  list() {
+    return this.adapters.map((a) => a.id);
+  }
+};
+
 // src/access-http.ts
 function resolveDefaultAdminConsolePublicDir() {
   const candidates = [
@@ -8302,6 +8470,7 @@ var EngramAccessHttpServer = class {
   adminConsoleEnabled;
   adminConsolePublicDir;
   trustPrincipalHeader;
+  adapterRegistry;
   writeRequestTimestamps = [];
   mcpServer;
   server = null;
@@ -8316,6 +8485,7 @@ var EngramAccessHttpServer = class {
     this.adminConsoleEnabled = options.adminConsoleEnabled !== false;
     this.adminConsolePublicDir = options.adminConsolePublicDir ?? defaultAdminConsolePublicDir;
     this.trustPrincipalHeader = options.trustPrincipalHeader === true;
+    this.adapterRegistry = options.enableAdapters !== false ? options.adapterRegistry ?? new AdapterRegistry() : null;
     this.mcpServer = new EngramMcpServer(this.service, { principal: options.principal });
   }
   async start() {
@@ -8386,10 +8556,20 @@ var EngramAccessHttpServer = class {
       maxBodyBytes: this.maxBodyBytes
     };
   }
+  /**
+   * Resolve the adapter identity for the incoming request.
+   * Returns null if no adapter matches or adapters are disabled.
+   */
+  resolveAdapterIdentity(req) {
+    if (!this.adapterRegistry) return null;
+    return this.adapterRegistry.resolve({
+      headers: req.headers
+    });
+  }
   resolveRequestPrincipal(req) {
     if (this.trustPrincipalHeader) {
-      const headerValue = req.headers["x-engram-principal"];
-      const raw = Array.isArray(headerValue) ? headerValue[0] : headerValue;
+      const headerValue5 = req.headers["x-engram-principal"];
+      const raw = Array.isArray(headerValue5) ? headerValue5[0] : headerValue5;
       if (typeof raw === "string") {
         const trimmed = raw.trim();
         if (trimmed.length > 0) {
@@ -8397,6 +8577,10 @@ var EngramAccessHttpServer = class {
         }
       }
     }
+    const adapterIdentity = this.resolveAdapterIdentity(req);
+    if (adapterIdentity) {
+      return adapterIdentity.principal;
+    }
     return this.authenticatedPrincipal;
   }
   async handle(req, res, correlationId) {
@@ -8423,6 +8607,15 @@ var EngramAccessHttpServer = class {
       this.respondJson(res, 200, await this.service.health());
       return;
     }
+    if (req.method === "GET" && pathname === "/engram/v1/adapters") {
+      const identity = this.resolveAdapterIdentity(req);
+      this.respondJson(res, 200, {
+        adaptersEnabled: this.adapterRegistry !== null,
+        registered: this.adapterRegistry?.list() ?? [],
+        resolved: identity
+      });
+      return;
+    }
     if (req.method === "POST" && pathname === "/engram/v1/recall") {
       const body = await this.readValidatedBody(req, "recall");
       const response = await this.service.recall({