crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/slack/slack-mention-resolver.js

@@ -0,0 +1,197 @@
+/**
+ * Slack mention resolver for team channels.
+ *
+ * Agents are not Slack users, so a message like `@sam 看一下这个` arrives as
+ * plain text. This module finds every `@name` token in a Slack message and
+ * maps it to a Crewly agent session, and for names that match nothing it
+ * offers "did you mean" suggestions (bounded Levenshtein distance) so the
+ * bridge can answer a typo instead of silently ignoring it.
+ *
+ * Pure functions, no I/O — the bridge supplies the candidate list from the
+ * team's members.
+ *
+ * @module services/slack/slack-mention-resolver
+ */
+import { SLACK_TEAM_CHANNEL_CONSTANTS } from '../../constants.js';
+/**
+ * Tokens Slack itself owns; never treated as agent names.
+ * Slack usually delivers these as `<!here>` etc., but users on some clients
+ * type them literally.
+ */
+const RESERVED_TOKENS = new Set(['here', 'channel', 'everyone', 'group']);
+/**
+ * `@name` where the `@` is not part of an email, a Slack native mention
+ * (`<@U123>`), or a doubled `@@`. Names may contain letters (any script),
+ * digits, `_`, `.` and `-`; a trailing `.`/`-` is punctuation, not name.
+ */
+const MENTION_TOKEN_RE = /(?<![\w<@])@([\p{L}\p{N}_.-]+)/gu;
+/** Native Slack user mention: `<@U0123ABC>` or `<@U0123ABC|name>`. */
+const NATIVE_MENTION_RE = /<@([UW][A-Z0-9]+)(?:\|[^>]*)?>/g;
+/**
+ * Extract the user ids of native `<@U…>` mentions, in order, deduped.
+ *
+ * @param text - Slack message text
+ * @returns Slack user ids
+ */
+export function extractNativeMentionIds(text) {
+    const seen = new Set();
+    const ids = [];
+    for (const m of (text ?? '').matchAll(NATIVE_MENTION_RE)) {
+        if (seen.has(m[1]))
+            continue;
+        seen.add(m[1]);
+        ids.push(m[1]);
+    }
+    return ids;
+}
+/**
+ * Levenshtein edit distance between two strings, compared case-insensitively.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns The minimum number of single-character edits to turn `a` into `b`
+ */
+export function levenshtein(a, b) {
+    const s = a.toLowerCase();
+    const t = b.toLowerCase();
+    if (s === t)
+        return 0;
+    if (s.length === 0)
+        return t.length;
+    if (t.length === 0)
+        return s.length;
+    let prev = Array.from({ length: t.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= s.length; i++) {
+        const cur = [i];
+        for (let j = 1; j <= t.length; j++) {
+            const cost = s[i - 1] === t[j - 1] ? 0 : 1;
+            cur[j] = Math.min(prev[j] + 1, cur[j - 1] + 1, prev[j - 1] + cost);
+        }
+        prev = cur;
+    }
+    return prev[t.length];
+}
+/**
+ * The aliases a candidate answers to: its display name, the name with
+ * whitespace removed, its full session name, and the short session
+ * segment (`crewly-alpha-sam` → `sam`, matching the orchestrator bridge's
+ * existing `@name` rule). All lower-cased.
+ *
+ * @param candidate - The agent
+ * @returns Distinct lower-case aliases
+ */
+export function candidateAliases(candidate) {
+    const out = new Set();
+    const name = (candidate.name ?? '').trim().toLowerCase();
+    if (name) {
+        out.add(name);
+        out.add(name.replace(/\s+/g, ''));
+        out.add(name.replace(/\s+/g, '-'));
+    }
+    const session = (candidate.sessionName ?? '').trim().toLowerCase();
+    if (session) {
+        out.add(session);
+        const parts = session.split('-');
+        if (parts.length >= 3)
+            out.add(parts.slice(2).join('-'));
+    }
+    out.delete('');
+    return [...out];
+}
+/**
+ * Extract the raw `@name` tokens from a message, in order, deduped
+ * case-insensitively, with Slack's reserved words removed.
+ *
+ * @param text - Slack message text
+ * @returns Tokens without the leading `@`
+ */
+export function extractMentionTokens(text) {
+    const seen = new Set();
+    const tokens = [];
+    for (const m of (text ?? '').matchAll(MENTION_TOKEN_RE)) {
+        const raw = m[1].replace(/[.-]+$/u, '');
+        if (!raw)
+            continue;
+        const key = raw.toLowerCase();
+        if (RESERVED_TOKENS.has(key) || seen.has(key))
+            continue;
+        seen.add(key);
+        tokens.push(raw);
+    }
+    return tokens;
+}
+/**
+ * Map every `@name` in `text` to an agent session.
+ *
+ * Exact (case-insensitive) alias matches win. A token that matches no
+ * alias is reported under `unknown` with up to `maxSuggestions` candidate
+ * display names within `maxDistance` edits, closest first.
+ *
+ * @param text - Slack message text
+ * @param candidates - The agents that can be mentioned (team members)
+ * @param options - Distance and suggestion caps
+ * @returns Matched sessions and unknown tokens
+ *
+ * @example
+ * ```ts
+ * resolveSlackMentions('@sam @lee 看一下', [
+ *   { name: 'Sam', sessionName: 'crewly-alpha-sam' },
+ *   { name: 'Leo', sessionName: 'crewly-alpha-leo' },
+ * ]);
+ * // → { mentions: ['crewly-alpha-sam'], unknown: [{ token: 'lee', suggestions: ['Leo'] }] }
+ * ```
+ */
+export function resolveSlackMentions(text, candidates, options = {}) {
+    const maxDistance = options.maxDistance ?? SLACK_TEAM_CHANNEL_CONSTANTS.MENTION_SUGGEST_MAX_DISTANCE;
+    const maxSuggestions = options.maxSuggestions ?? SLACK_TEAM_CHANNEL_CONSTANTS.MENTION_SUGGEST_MAX;
+    const aliasIndex = new Map();
+    for (const c of candidates) {
+        for (const alias of candidateAliases(c)) {
+            if (!aliasIndex.has(alias))
+                aliasIndex.set(alias, c);
+        }
+    }
+    const mentions = [];
+    const seenSessions = new Set();
+    const unknown = [];
+    // Real identities first: a native <@U…> mention of an agent's own bot user.
+    const byBotUserId = new Map();
+    for (const c of candidates) {
+        if (c.botUserId)
+            byBotUserId.set(c.botUserId, c);
+    }
+    for (const id of extractNativeMentionIds(text)) {
+        const hit = byBotUserId.get(id);
+        if (hit && !seenSessions.has(hit.sessionName)) {
+            seenSessions.add(hit.sessionName);
+            mentions.push(hit.sessionName);
+        }
+    }
+    for (const token of extractMentionTokens(text)) {
+        const hit = aliasIndex.get(token.toLowerCase());
+        if (hit) {
+            if (!seenSessions.has(hit.sessionName)) {
+                seenSessions.add(hit.sessionName);
+                mentions.push(hit.sessionName);
+            }
+            continue;
+        }
+        const scored = candidates
+            .map((c) => ({
+            name: c.name,
+            distance: Math.min(...candidateAliases(c).map((a) => levenshtein(token, a))),
+        }))
+            .filter((s) => s.distance <= maxDistance && s.name)
+            .sort((a, b) => a.distance - b.distance || a.name.localeCompare(b.name));
+        const suggestions = [];
+        for (const s of scored) {
+            if (!suggestions.includes(s.name))
+                suggestions.push(s.name);
+            if (suggestions.length >= maxSuggestions)
+                break;
+        }
+        unknown.push({ token, suggestions });
+    }
+    return { mentions, unknown };
+}
+//# sourceMappingURL=slack-mention-resolver.js.map

package/dist/cli/backend/src/services/slack/slack-mention-resolver.js.map

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