@bamdra/bamdra-user-bind 0.1.2 → 0.1.4

package/dist/index.js

@@ -42,16 +42,16 @@ var GLOBAL_API_KEY = "__OPENCLAW_BAMDRA_USER_BIND__";
 var PROFILE_SKILL_ID = "bamdra-user-bind-profile";
 var ADMIN_SKILL_ID = "bamdra-user-bind-admin";
 var SELF_TOOL_NAMES = [
-  "user_bind_get_my_profile",
-  "user_bind_update_my_profile",
-  "user_bind_refresh_my_binding"
+  "bamdra_user_bind_get_my_profile",
+  "bamdra_user_bind_update_my_profile",
+  "bamdra_user_bind_refresh_my_binding"
 ];
 var ADMIN_TOOL_NAMES = [
-  "user_bind_admin_query",
-  "user_bind_admin_edit",
-  "user_bind_admin_merge",
-  "user_bind_admin_list_issues",
-  "user_bind_admin_sync"
+  "bamdra_user_bind_admin_query",
+  "bamdra_user_bind_admin_edit",
+  "bamdra_user_bind_admin_merge",
+  "bamdra_user_bind_admin_list_issues",
+  "bamdra_user_bind_admin_sync"
 ];
 var TABLES = {
   profiles: "bamdra_user_bind_profiles",
@@ -59,6 +59,17 @@ var TABLES = {
   issues: "bamdra_user_bind_issues",
   audits: "bamdra_user_bind_audits"
 };
+var REQUIRED_FEISHU_IDENTITY_SCOPES = [
+  "contact:user.employee_id:readonly",
+  "contact:user.base:readonly"
+];
+function logUserBindEvent(event, details = {}) {
+  try {
+    console.info("[bamdra-user-bind]", event, JSON.stringify(details));
+  } catch {
+    console.info("[bamdra-user-bind]", event);
+  }
+}
 var UserBindStore = class {
   constructor(dbPath, exportPath, profileMarkdownRoot) {
     this.dbPath = dbPath;
@@ -412,6 +423,8 @@ var UserBindRuntime = class {
   config;
   sessionCache = /* @__PURE__ */ new Map();
   bindingCache = /* @__PURE__ */ new Map();
+  feishuScopeStatus = null;
+  bitableMirror = null;
   close() {
     this.store.close();
   }
@@ -446,13 +459,26 @@ var UserBindRuntime = class {
     const binding = this.store.findBinding(parsed.channelType, parsed.openId);
     let userId = binding?.userId ?? null;
     let source = binding?.source ?? "local";
-    if (!userId && parsed.channelType === "feishu" && parsed.openId) {
-      const remote = await this.tryResolveFeishuUser(parsed.openId);
-      if (remote?.userId) {
-        userId = remote.userId;
-        source = remote.source;
-      } else {
-        this.store.recordIssue("feishu-resolution", `Failed to resolve real user id for ${parsed.openId}`);
+    let remoteProfilePatch = {};
+    if (parsed.channelType === "feishu" && parsed.openId) {
+      const scopeStatus = await this.ensureFeishuScopeStatus();
+      if (scopeStatus.missingIdentityScopes.length > 0) {
+        const details = `Missing Feishu scopes: ${scopeStatus.missingIdentityScopes.join(", ")}`;
+        logUserBindEvent("feishu-scope-missing", {
+          openId: parsed.openId,
+          missingScopes: scopeStatus.missingIdentityScopes
+        });
+        this.store.recordIssue("feishu-scope-missing", details);
+      }
+      if (!userId) {
+        const remote = await this.tryResolveFeishuUser(parsed.openId);
+        if (remote?.userId) {
+          userId = remote.userId;
+          source = remote.source;
+          remoteProfilePatch = remote.profilePatch;
+        } else {
+          this.store.recordIssue("feishu-resolution", `Failed to resolve real user id for ${parsed.openId}`);
+        }
       }
     }
     if (!userId) {
@@ -465,7 +491,8 @@ var UserBindRuntime = class {
       openId: parsed.openId,
       source,
       profilePatch: {
-        name: parsed.senderName
+        name: parsed.senderName,
+        ...remoteProfilePatch
       }
     });
     const identity = {
@@ -483,6 +510,9 @@ var UserBindRuntime = class {
       expiresAt: Date.now() + this.config.cacheTtlMs,
       identity
     });
+    if (parsed.channelType === "feishu") {
+      await this.syncFeishuMirror(identity);
+    }
     return identity;
   }
   async getMyProfile(context) {
@@ -609,7 +639,7 @@ var UserBindRuntime = class {
       return;
     }
     registerTool({
-      name: "user_bind_get_my_profile",
+      name: "bamdra_user_bind_get_my_profile",
       description: "Get the current user's bound profile",
       parameters: {
         type: "object",
@@ -621,7 +651,7 @@ var UserBindRuntime = class {
       execute: async (_id, params) => asTextResult(await this.getMyProfile(params))
     });
     registerTool({
-      name: "user_bind_update_my_profile",
+      name: "bamdra_user_bind_update_my_profile",
       description: "Update the current user's own profile fields",
       parameters: {
         type: "object",
@@ -640,7 +670,7 @@ var UserBindRuntime = class {
       execute: async (_id, params) => asTextResult(await this.updateMyProfile(params, sanitizeProfilePatch(params)))
     });
     registerTool({
-      name: "user_bind_refresh_my_binding",
+      name: "bamdra_user_bind_refresh_my_binding",
       description: "Refresh the current user's identity binding",
       parameters: {
         type: "object",
@@ -654,7 +684,7 @@ var UserBindRuntime = class {
     for (const toolName of ADMIN_TOOL_NAMES) {
       registerTool({
         name: toolName,
-        description: `Administrative natural-language tool for ${toolName.replace("user_bind_admin_", "")}`,
+        description: `Administrative natural-language tool for ${toolName.replace("bamdra_user_bind_admin_", "")}`,
         parameters: {
           type: "object",
           additionalProperties: false,
@@ -679,9 +709,11 @@ var UserBindRuntime = class {
   async tryResolveFeishuUser(openId) {
     const executor = this.host.callTool ?? this.host.invokeTool;
     if (typeof executor !== "function") {
+      logUserBindEvent("feishu-resolution-skipped", { reason: "tool-executor-unavailable" });
       return null;
     }
     try {
+      logUserBindEvent("feishu-resolution-start", { openId });
       const result = await executor.call(this.host, "feishu_user_get", {
         user_id_type: "open_id",
         user_id: openId
@@ -691,12 +723,161 @@ var UserBindRuntime = class {
         ["user", "user_id"],
         ["data", "user_id"]
       ]);
-      return candidate ? { userId: candidate, source: "feishu-api" } : null;
+      if (!candidate) {
+        logUserBindEvent("feishu-resolution-empty", { openId });
+        return null;
+      }
+      logUserBindEvent("feishu-resolution-success", { openId, userId: candidate });
+      return {
+        userId: candidate,
+        source: "feishu-api",
+        profilePatch: {
+          name: extractDeepString(result, [["data", "user", "name"], ["user", "name"]]),
+          email: extractDeepString(result, [["data", "user", "email"], ["user", "email"]]),
+          avatar: extractDeepString(result, [["data", "user", "avatar", "avatar_origin"], ["user", "avatar", "avatar_origin"]])
+        }
+      };
     } catch (error) {
-      this.store.recordIssue("feishu-resolution", error instanceof Error ? error.message : String(error));
+      const message = error instanceof Error ? error.message : String(error);
+      logUserBindEvent("feishu-resolution-failed", { openId, message });
+      this.store.recordIssue("feishu-resolution", message);
       return null;
     }
   }
+  async ensureFeishuScopeStatus() {
+    if (this.feishuScopeStatus) {
+      return this.feishuScopeStatus;
+    }
+    const executor = this.host.callTool ?? this.host.invokeTool;
+    if (typeof executor !== "function") {
+      this.feishuScopeStatus = {
+        scopes: [],
+        missingIdentityScopes: [...REQUIRED_FEISHU_IDENTITY_SCOPES],
+        hasDocumentAccess: false
+      };
+      return this.feishuScopeStatus;
+    }
+    try {
+      const result = await executor.call(this.host, "feishu_app_scopes", {});
+      const scopes = extractScopes(result);
+      this.feishuScopeStatus = {
+        scopes,
+        missingIdentityScopes: REQUIRED_FEISHU_IDENTITY_SCOPES.filter((scope) => !scopes.includes(scope)),
+        hasDocumentAccess: scopes.some((scope) => scope.startsWith("bitable:") || scope.startsWith("drive:") || scope.startsWith("docx:") || scope.startsWith("docs:"))
+      };
+      logUserBindEvent("feishu-scopes-read", this.feishuScopeStatus);
+      return this.feishuScopeStatus;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logUserBindEvent("feishu-scopes-failed", { message });
+      this.store.recordIssue("feishu-scope-read", message);
+      this.feishuScopeStatus = {
+        scopes: [],
+        missingIdentityScopes: [...REQUIRED_FEISHU_IDENTITY_SCOPES],
+        hasDocumentAccess: false
+      };
+      return this.feishuScopeStatus;
+    }
+  }
+  async syncFeishuMirror(identity) {
+    const scopeStatus = await this.ensureFeishuScopeStatus();
+    if (!scopeStatus.hasDocumentAccess) {
+      return;
+    }
+    const executor = this.host.callTool ?? this.host.invokeTool;
+    if (typeof executor !== "function") {
+      return;
+    }
+    try {
+      const mirror = await this.ensureFeishuBitableMirror(executor.bind(this.host));
+      if (!mirror.appToken || !mirror.tableId) {
+        return;
+      }
+      const existing = await executor.call(this.host, "feishu_bitable_list_records", {
+        app_token: mirror.appToken,
+        table_id: mirror.tableId
+      });
+      const recordId = findBitableRecordId(existing, identity.userId);
+      const fields = {
+        user_id: identity.userId,
+        channel_type: identity.channelType,
+        open_id: identity.senderOpenId,
+        name: identity.profile.name,
+        nickname: identity.profile.nickname,
+        preferences: identity.profile.preferences,
+        personality: identity.profile.personality,
+        role: identity.profile.role,
+        timezone: identity.profile.timezone,
+        email: identity.profile.email,
+        avatar: identity.profile.avatar
+      };
+      if (recordId) {
+        await executor.call(this.host, "feishu_bitable_update_record", {
+          app_token: mirror.appToken,
+          table_id: mirror.tableId,
+          record_id: recordId,
+          fields
+        });
+      } else {
+        await executor.call(this.host, "feishu_bitable_create_record", {
+          app_token: mirror.appToken,
+          table_id: mirror.tableId,
+          fields
+        });
+      }
+      logUserBindEvent("feishu-bitable-sync-success", { userId: identity.userId });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logUserBindEvent("feishu-bitable-sync-failed", { userId: identity.userId, message });
+      this.store.recordIssue("feishu-bitable-sync", message, identity.userId);
+    }
+  }
+  async ensureFeishuBitableMirror(executor) {
+    if (this.bitableMirror?.appToken && this.bitableMirror?.tableId) {
+      return this.bitableMirror;
+    }
+    try {
+      const app = await executor("feishu_bitable_create_app", { name: "Bamdra User Bind" });
+      const appToken = extractDeepString(app, [
+        ["data", "app", "app_token"],
+        ["data", "app_token"],
+        ["app", "app_token"],
+        ["app_token"]
+      ]);
+      if (!appToken) {
+        return { appToken: null, tableId: null };
+      }
+      const meta = await executor("feishu_bitable_get_meta", { app_token: appToken });
+      const tableId = extractDeepString(meta, [
+        ["data", "tables", "0", "table_id"],
+        ["data", "items", "0", "table_id"],
+        ["tables", "0", "table_id"]
+      ]);
+      if (!tableId) {
+        this.store.recordIssue("feishu-bitable-init", "Unable to determine users table id from Feishu bitable metadata");
+        return { appToken, tableId: null };
+      }
+      for (const fieldName of ["user_id", "channel_type", "open_id", "name", "nickname", "preferences", "personality", "role", "timezone", "email", "avatar"]) {
+        try {
+          await executor("feishu_bitable_create_field", {
+            app_token: appToken,
+            table_id: tableId,
+            field_name: fieldName,
+            type: 1
+          });
+        } catch {
+        }
+      }
+      this.bitableMirror = { appToken, tableId };
+      logUserBindEvent("feishu-bitable-ready", this.bitableMirror);
+      return this.bitableMirror;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logUserBindEvent("feishu-bitable-init-failed", { message });
+      this.store.recordIssue("feishu-bitable-init", message);
+      return { appToken: null, tableId: null };
+    }
+  }
 };
 function createUserBindPlugin(api) {
   return new UserBindRuntime(api, api.pluginConfig ?? api.config ?? api.plugin?.config);
@@ -885,12 +1066,20 @@ function mapProfileRow(row) {
 }
 function parseIdentityContext(context) {
   const record = context && typeof context === "object" ? context : {};
-  const sender = record.sender && typeof record.sender === "object" ? record.sender : {};
-  const message = record.message && typeof record.message === "object" ? record.message : {};
-  const sessionId = asNullableString(record.sessionId) ?? asNullableString(record.sessionKey) ?? asNullableString(record.session?.id) ?? asNullableString(record.context?.sessionId);
-  const channelType = asNullableString(record.channelType) ?? asNullableString(record.channel?.type) ?? asNullableString(message.channel?.type) ?? asNullableString(record.provider);
-  const openId = asNullableString(sender.id) ?? asNullableString(sender.open_id) ?? asNullableString(sender.openId) ?? asNullableString(message.sender?.id);
-  const senderName = asNullableString(sender.name) ?? asNullableString(sender.display_name) ?? asNullableString(message.sender?.name);
+  const sender = findNestedRecord(record, ["sender"], ["message", "sender"], ["event", "sender"], ["payload", "sender"]);
+  const message = findNestedRecord(record, ["message"], ["event", "message"], ["payload", "message"]);
+  const session = findNestedRecord(record, ["session"], ["context", "session"]);
+  const channel = findNestedRecord(record, ["channel"], ["message", "channel"], ["event", "channel"], ["payload", "channel"]);
+  const metadataText = asNullableString(record.text) ?? asNullableString(message.text) ?? asNullableString(record.content) ?? asNullableString(findNestedValue(record, ["message", "content", "text"]));
+  const conversationInfo = metadataText ? extractTaggedJsonBlock(metadataText, "Conversation info (untrusted metadata)") : null;
+  const senderInfo = metadataText ? extractTaggedJsonBlock(metadataText, "Sender (untrusted metadata)") : null;
+  const senderIdFromText = metadataText ? extractRegexValue(metadataText, /"sender_id"\s*:\s*"([^"]+)"/) : null;
+  const senderNameFromText = metadataText ? extractRegexValue(metadataText, /"sender"\s*:\s*"([^"]+)"/) : null;
+  const senderNameFromMessageLine = metadataText ? extractRegexValue(metadataText, /\]\s*([^\n:：]{1,40})\s*[:：]/) : null;
+  const sessionId = asNullableString(record.sessionId) ?? asNullableString(record.sessionKey) ?? asNullableString(session.id) ?? asNullableString(record.context?.sessionId) ?? asNullableString(conversationInfo?.session_id) ?? asNullableString(conversationInfo?.message_id);
+  const channelType = asNullableString(record.channelType) ?? asNullableString(channel.type) ?? asNullableString(record.provider) ?? asNullableString(conversationInfo?.provider) ?? inferChannelTypeFromSessionId(sessionId);
+  const openId = asNullableString(sender.id) ?? asNullableString(sender.open_id) ?? asNullableString(sender.openId) ?? asNullableString(sender.user_id) ?? asNullableString(senderInfo?.id) ?? asNullableString(conversationInfo?.sender_id) ?? senderIdFromText ?? extractOpenIdFromSessionId(sessionId);
+  const senderName = asNullableString(sender.name) ?? asNullableString(sender.display_name) ?? asNullableString(senderInfo?.name) ?? asNullableString(conversationInfo?.sender) ?? senderNameFromText ?? senderNameFromMessageLine;
   return {
     sessionId,
     channelType,
@@ -898,6 +1087,67 @@ function parseIdentityContext(context) {
     senderName
   };
 }
+function findNestedRecord(root, ...paths) {
+  for (const path of paths) {
+    const value = findNestedValue(root, path);
+    if (value && typeof value === "object") {
+      return value;
+    }
+  }
+  return {};
+}
+function findNestedValue(root, path) {
+  let current = root;
+  for (const part of path) {
+    if (!current || typeof current !== "object") {
+      return null;
+    }
+    current = current[part];
+  }
+  return current;
+}
+function extractTaggedJsonBlock(text, label) {
+  const start = text.indexOf(label);
+  if (start < 0) {
+    return null;
+  }
+  const block = text.slice(start).match(/```json\s*([\s\S]*?)\s*```/i);
+  if (!block) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(block[1]);
+    return parsed && typeof parsed === "object" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function inferChannelTypeFromSessionId(sessionId) {
+  if (!sessionId) {
+    return null;
+  }
+  if (sessionId.includes(":feishu:")) {
+    return "feishu";
+  }
+  if (sessionId.includes(":telegram:")) {
+    return "telegram";
+  }
+  if (sessionId.includes(":whatsapp:")) {
+    return "whatsapp";
+  }
+  return null;
+}
+function extractRegexValue(text, pattern) {
+  const match = text.match(pattern);
+  return match?.[1]?.trim() || null;
+}
+function extractOpenIdFromSessionId(sessionId) {
+  if (!sessionId) {
+    return null;
+  }
+  const match = sessionId.match(/:([A-Za-z0-9_-]+)$/);
+  return match?.[1] ?? null;
+}
 function getAgentIdFromContext(context) {
   const record = context && typeof context === "object" ? context : {};
   return asNullableString(record.agentId) ?? asNullableString(record.agent?.id) ?? asNullableString(record.agent?.name);
@@ -1141,6 +1391,60 @@ function ensureArrayIncludes(parent, key, value) {
   parent[key] = current;
   return true;
 }
+function extractScopes(result) {
+  const candidates = [
+    findNestedValue(result, ["data", "scopes"]),
+    findNestedValue(result, ["scopes"]),
+    findNestedValue(result, ["data", "items"])
+  ];
+  for (const candidate of candidates) {
+    if (!Array.isArray(candidate)) {
+      continue;
+    }
+    const scopes = candidate.map((item) => {
+      if (typeof item === "string") {
+        return item;
+      }
+      if (item && typeof item === "object") {
+        const record = item;
+        const scope = record.scope ?? record.name;
+        return typeof scope === "string" ? scope : "";
+      }
+      return "";
+    }).filter(Boolean);
+    if (scopes.length > 0) {
+      return scopes;
+    }
+  }
+  return [];
+}
+function findBitableRecordId(result, userId) {
+  const candidates = [
+    findNestedValue(result, ["data", "items"]),
+    findNestedValue(result, ["items"]),
+    findNestedValue(result, ["data", "records"])
+  ];
+  for (const candidate of candidates) {
+    if (!Array.isArray(candidate)) {
+      continue;
+    }
+    for (const item of candidate) {
+      if (!item || typeof item !== "object") {
+        continue;
+      }
+      const record = item;
+      const fields = record.fields && typeof record.fields === "object" ? record.fields : {};
+      if (String(fields.user_id ?? "") !== userId) {
+        continue;
+      }
+      const recordId = record.record_id ?? record.recordId ?? record.id;
+      if (typeof recordId === "string" && recordId.trim()) {
+        return recordId;
+      }
+    }
+  }
+  return null;
+}
 function getConfiguredAgentId(agent) {
   return asNullableString(agent.id) ?? asNullableString(agent.name) ?? asNullableString(agent.agentId);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamdra/bamdra-user-bind",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Identity resolution, user profile binding, and admin-safe profile tools for OpenClaw channels.",
   "license": "MIT",
   "homepage": "https://www.bamdra.com",