crewly 1.13.0 → 1.14.0

package/dist/backend/backend/src/services/slack/slack-agent-post.service.js

@@ -0,0 +1,243 @@
+/**
+ * Slack Agent Post Service — an agent starting a Slack conversation itself.
+ *
+ * Everything else in the Slack layer is reactive: a message arrives, an agent
+ * answers. This is the other direction. An agent calls the `slack-post` skill
+ * and the message goes to a channel or into a DM, under the agent's own
+ * identity when it has one.
+ *
+ * Target syntax (one string, so the skill stays a one-liner):
+ *
+ * | Target | Meaning |
+ * |---|---|
+ * | `#general`, `general` | public/private channel by name (lower-case) |
+ * | `C0123ABCD` | channel by id (upper-case) |
+ * | `D0123ABCD` | an already-open DM channel |
+ * | `@sam`, `U0123ABCD` | DM that person |
+ *
+ * Identity: an agent with a Cloud-provisioned Slack app posts with its own
+ * bot token, so a DM is a real conversation between the person and that agent.
+ * Without one it falls back to the shared Crewly bot with the agent's name and
+ * icon — visually similar, but the DM is Crewly's, not the agent's.
+ *
+ * @module services/slack/slack-agent-post.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { SLACK_AGENT_POST_CONSTANTS } from '../../constants.js';
+import { slackIdentityFor } from './slack-team-channel.service.js';
+/** Structured failure. */
+export class SlackAgentPostError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'SlackAgentPostError';
+    }
+}
+// Case is the discriminator, and it is reliable: Slack ids are uppercase,
+// while Slack forces channel names to lowercase. Matching case-insensitively
+// would swallow ordinary names — `general` is `G` followed by six
+// alphanumerics, so it would have been read as a private-channel id.
+const CHANNEL_ID_RE = /^[CG][A-Z0-9]{6,}$/;
+const DM_ID_RE = /^D[A-Z0-9]{6,}$/;
+const USER_ID_RE = /^[UW][A-Z0-9]{6,}$/;
+/**
+ * Service — see module docs.
+ */
+export class SlackAgentPostService {
+    logger;
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = LoggerService.getInstance().createComponentLogger('SlackAgentPost');
+    }
+    /**
+     * Send one agent-initiated message.
+     *
+     * @param req - Who is posting, where, and what
+     * @returns Where it landed and which identity carried it
+     * @throws {SlackAgentPostError} `validation` for bad input, `not_connected`
+     *   when Slack is not up, `target_not_found` when the channel or person
+     *   cannot be resolved, `slack_error` when Slack refuses the send
+     */
+    async post(req) {
+        const agentSession = (req.agentSession ?? '').trim();
+        const target = (req.target ?? '').trim();
+        const text = req.text ?? '';
+        if (!agentSession)
+            throw new SlackAgentPostError('validation', 'agentSession is required');
+        if (!target)
+            throw new SlackAgentPostError('validation', 'target is required');
+        if (!text.trim())
+            throw new SlackAgentPostError('validation', 'text is required');
+        if (text.length > SLACK_AGENT_POST_CONSTANTS.MAX_TEXT_LENGTH) {
+            throw new SlackAgentPostError('validation', `text exceeds ${SLACK_AGENT_POST_CONSTANTS.MAX_TEXT_LENGTH} characters`);
+        }
+        if (!this.deps.slack.isConnected()) {
+            throw new SlackAgentPostError('not_connected', 'Slack is not connected');
+        }
+        const { identity, botToken, postedAs } = await this.resolveIdentity(agentSession);
+        const { channelId, kind } = await this.resolveTarget(target, botToken);
+        let messageTs;
+        try {
+            messageTs = await this.deps.slack.sendMessage({
+                channelId,
+                text,
+                threadTs: req.threadTs,
+                // The chat-v2 mirror attributes outbound Slack replies to the
+                // orchestrator, which would misfile an agent's own post. Team-channel
+                // traffic is mirrored by its own path; this one stays Slack-only.
+                skipChatV2Mirror: true,
+                ...identity,
+            });
+        }
+        catch (err) {
+            throw new SlackAgentPostError('slack_error', this.explainSendFailure(err, kind, postedAs));
+        }
+        this.logger.info('Agent posted to Slack', {
+            agentSession,
+            channelId,
+            kind,
+            postedAs,
+            threaded: !!req.threadTs,
+            chars: text.length,
+        });
+        return { channelId, messageTs, kind, postedAs, identity: identity.username ?? agentSession };
+    }
+    /**
+     * Which identity this agent posts under: its own bot token when installed,
+     * otherwise the shared bot with the member's name and icon.
+     */
+    async resolveIdentity(agentSession) {
+        if (this.deps.identities) {
+            await this.deps.identities.load();
+            const installed = this.deps.identities.getInstalled(agentSession);
+            if (installed) {
+                const member = await this.findMember(agentSession);
+                return {
+                    identity: { botToken: installed.botToken, username: member?.name ?? agentSession },
+                    botToken: installed.botToken,
+                    postedAs: 'agent',
+                };
+            }
+        }
+        const member = await this.findMember(agentSession);
+        return { identity: slackIdentityFor(member, agentSession), postedAs: 'crewly' };
+    }
+    /** The team member behind a session, for name and avatar. */
+    async findMember(agentSession) {
+        try {
+            const teams = await this.deps.storage.getTeams();
+            for (const team of teams) {
+                const member = team.members?.find((m) => m.sessionName === agentSession);
+                if (member)
+                    return member;
+            }
+        }
+        catch (err) {
+            this.logger.debug('Could not read teams for agent identity', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return undefined;
+    }
+    /**
+     * Turn a target string into a Slack conversation id.
+     *
+     * @param target - See the table in the module docs
+     * @param botToken - Token to open the DM with, so the DM belongs to the agent
+     * @returns The conversation id and whether it is a channel or a DM
+     */
+    async resolveTarget(target, botToken) {
+        if (DM_ID_RE.test(target))
+            return { channelId: target, kind: 'dm' };
+        if (CHANNEL_ID_RE.test(target))
+            return { channelId: target, kind: 'channel' };
+        if (USER_ID_RE.test(target))
+            return { channelId: await this.openDm(target, botToken), kind: 'dm' };
+        if (target.startsWith('@')) {
+            const handle = target.slice(1);
+            const userId = await this.lookupHandle(handle);
+            if (!userId)
+                throw new SlackAgentPostError('target_not_found', `No Slack user matches "@${handle}"`);
+            return { channelId: await this.openDm(userId, botToken), kind: 'dm' };
+        }
+        const name = target.replace(/^#/, '');
+        let channel;
+        try {
+            channel = await this.deps.slack.findChannelByName(name);
+        }
+        catch (err) {
+            const text = errText(err);
+            // Resolving a name needs channels:read / groups:read. Say so, rather
+            // than handing the agent a bare Slack error code it cannot act on.
+            const hint = /missing_scope/.test(text)
+                ? ' — the app is missing channels:read; reinstall it to pick up the new scopes, or pass the channel id instead'
+                : '';
+            throw new SlackAgentPostError('slack_error', `Could not look up channel "#${name}": ${text}${hint}`);
+        }
+        if (!channel)
+            throw new SlackAgentPostError('target_not_found', `No Slack channel named "#${name}"`);
+        if (channel.isArchived)
+            throw new SlackAgentPostError('target_not_found', `Channel "#${name}" is archived`);
+        return { channelId: channel.id, kind: 'channel' };
+    }
+    async openDm(userId, botToken) {
+        try {
+            return await this.deps.slack.openDirectMessage(userId, botToken);
+        }
+        catch (err) {
+            const text = errText(err);
+            if (/missing_scope/.test(text)) {
+                throw new SlackAgentPostError('slack_error', 'Slack refused to open the DM: the app is missing the im:write scope — reinstall it to pick up the new scopes');
+            }
+            throw new SlackAgentPostError('slack_error', `Could not open a DM with ${userId}: ${text}`);
+        }
+    }
+    async lookupHandle(handle) {
+        try {
+            return await this.deps.slack.findUserByHandle(handle);
+        }
+        catch (err) {
+            throw new SlackAgentPostError('slack_error', `Could not look up "@${handle}": ${errText(err)}`);
+        }
+    }
+    /** Turn Slack's send errors into something an agent can act on. */
+    explainSendFailure(err, kind, postedAs) {
+        const text = errText(err);
+        if (/not_in_channel|channel_not_found/.test(text) && kind === 'channel') {
+            const who = postedAs === 'agent' ? "this agent's Slack bot" : 'the Crewly bot';
+            return `Slack refused the post (${text}): invite ${who} into the channel, or use a public channel (chat:write.public covers those)`;
+        }
+        if (/missing_scope/.test(text)) {
+            return `Slack refused the post (${text}): reinstall the app to pick up the new scopes`;
+        }
+        return `Slack refused the post: ${text}`;
+    }
+}
+function errText(err) {
+    if (err && typeof err === 'object') {
+        const data = err.data;
+        if (typeof data?.error === 'string')
+            return data.error;
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+let instance = null;
+/**
+ * Install the process-wide instance (composition root).
+ *
+ * @param service - The service or null
+ */
+export function setSlackAgentPostService(service) {
+    instance = service;
+}
+/**
+ * The process-wide instance, or null before wiring.
+ *
+ * @returns The service or null
+ */
+export function getSlackAgentPostService() {
+    return instance;
+}
+//# sourceMappingURL=slack-agent-post.service.js.map

package/dist/backend/backend/src/services/slack/slack-agent-post.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-agent-post.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-agent-post.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAoDnE,0BAA0B;AAC1B,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IADlB,YACkB,IAA6B,EAC7C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAyB;QAI7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,kEAAkE;AAClE,qEAAqE;AACrE,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAC3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AACnC,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACf,MAAM,CAAkB;IACxB,IAAI,CAA4B;IAEjD,YAAY,IAA+B;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,GAA0B;QACnC,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAClF,IAAI,IAAI,CAAC,MAAM,GAAG,0BAA0B,CAAC,eAAe,EAAE,CAAC;YAC7D,MAAM,IAAI,mBAAmB,CAC3B,YAAY,EACZ,gBAAgB,0BAA0B,CAAC,eAAe,aAAa,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAClF,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEvE,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;gBAC5C,SAAS;gBACT,IAAI;gBACJ,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,8DAA8D;gBAC9D,sEAAsE;gBACtE,kEAAkE;gBAClE,gBAAgB,EAAE,IAAI;gBACtB,GAAG,QAAQ;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACxC,YAAY;YACZ,SAAS;YACT,IAAI;YACJ,QAAQ;YACR,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ;YACxB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,eAAe,CAAC,YAAoB;QAKhD,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAClE,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;gBACnD,OAAO;oBACL,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,IAAI,YAAY,EAAE;oBAClF,QAAQ,EAAE,SAAS,CAAC,QAAQ;oBAC5B,QAAQ,EAAE,OAAO;iBAClB,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAClF,CAAC;IAED,6DAA6D;IACrD,KAAK,CAAC,UAAU,CAAC,YAAoB;QAC3C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC;gBACzE,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE;gBAC3D,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,QAAiB;QAC3D,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpE,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9E,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAEnG,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,2BAA2B,MAAM,GAAG,CAAC,CAAC;YACrG,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,OAAgC,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,qEAAqE;YACrE,mEAAmE;YACnE,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,6GAA6G;gBAC/G,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,mBAAmB,CAAC,aAAa,EAAE,+BAA+B,IAAI,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,4BAA4B,IAAI,GAAG,CAAC,CAAC;QACrG,IAAI,OAAO,CAAC,UAAU;YAAE,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,aAAa,IAAI,eAAe,CAAC,CAAC;QAC5G,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,QAAiB;QACpD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,mBAAmB,CAC3B,aAAa,EACb,8GAA8G,CAC/G,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,aAAa,EAAE,4BAA4B,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAc;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,mBAAmB,CAAC,aAAa,EAAE,uBAAuB,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,kBAAkB,CAAC,GAAY,EAAE,IAAsB,EAAE,QAA4B;QAC3F,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxE,MAAM,GAAG,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,OAAO,2BAA2B,IAAI,aAAa,GAAG,6EAA6E,CAAC;QACtI,CAAC;QACD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,2BAA2B,IAAI,gDAAgD,CAAC;QACzF,CAAC;QACD,OAAO,2BAA2B,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,GAAI,GAAqC,CAAC,IAAI,CAAC;QACzD,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,QAAQ,GAAiC,IAAI,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAqC;IAC5E,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/backend/backend/src/services/slack/slack-initializer.d.ts

@@ -70,6 +70,17 @@ export interface SlackInitOptions {
  * ```
  */
 export declare function initializeSlackIfConfigured(options?: SlackInitOptions): Promise<SlackInitResult>;
+/**
+ * Wire and start the Slack team-channel service (one Slack channel + one
+ * chat-v2 huddle per team). Idempotent — safe to call from both the boot
+ * path and the `/connect` route. Never throws: team channels are an
+ * optional layer on top of the orchestrator bridge, so a failure here
+ * must not take the Slack connection down with it.
+ *
+ * Dependencies are imported lazily so this module stays cheap to load in
+ * unit tests that only exercise credential resolution.
+ */
+export declare function startSlackTeamChannels(): Promise<void>;
 /**
  * Gracefully shutdown Slack integration
  *

package/dist/backend/backend/src/services/slack/slack-initializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-initializer.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAiB1D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBlE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAUnD"}
+{"version":3,"file":"slack-initializer.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAKjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,GAAG,IAAI,CAiB1D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqBlE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqD5D;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAUnD"}

package/dist/backend/backend/src/services/slack/slack-initializer.js

@@ -108,6 +108,7 @@ export async function initializeSlackIfConfigured(options) {
             bridge.setMessageQueueService(options.messageQueueService);
         }
         await bridge.initialize();
+        await startSlackTeamChannels();
         logger.info('Successfully connected');
         return { attempted: true, success: true };
     }
@@ -117,6 +118,61 @@ export async function initializeSlackIfConfigured(options) {
         return { attempted: true, success: false, error: errorMessage };
     }
 }
+/**
+ * Wire and start the Slack team-channel service (one Slack channel + one
+ * chat-v2 huddle per team). Idempotent — safe to call from both the boot
+ * path and the `/connect` route. Never throws: team channels are an
+ * optional layer on top of the orchestrator bridge, so a failure here
+ * must not take the Slack connection down with it.
+ *
+ * Dependencies are imported lazily so this module stays cheap to load in
+ * unit tests that only exercise credential resolution.
+ */
+export async function startSlackTeamChannels() {
+    try {
+        const [{ SlackTeamChannelService, getSlackTeamChannelService, setSlackTeamChannelService }, { SlackAgentIdentityService, getSlackAgentIdentityService, setSlackAgentIdentityService }, { SlackAgentPostService, getSlackAgentPostService, setSlackAgentPostService }, { getChatV2Service }, { getChatV2RealtimeDeps }, { StorageService }, { CloudClientService },] = await Promise.all([
+            import('./slack-team-channel.service.js'),
+            import('./slack-agent-identity.service.js'),
+            import('./slack-agent-post.service.js'),
+            import('../chat-v2/chat-v2.singleton.js'),
+            import('../chat-v2/chat-v2.realtime-holder.js'),
+            import('../core/storage.service.js'),
+            import('../cloud/cloud-client.service.js'),
+        ]);
+        // Real per-agent identities live behind the Cloud login; the service is
+        // always constructed and simply reports unavailable until then.
+        let identities = getSlackAgentIdentityService();
+        if (!identities) {
+            identities = new SlackAgentIdentityService({ cloud: CloudClientService.getInstance() });
+            setSlackAgentIdentityService(identities);
+        }
+        // Agent-initiated posts (the `slack-post` skill).
+        if (!getSlackAgentPostService()) {
+            setSlackAgentPostService(new SlackAgentPostService({
+                slack: getSlackService(),
+                storage: StorageService.getInstance(),
+                identities,
+            }));
+        }
+        let service = getSlackTeamChannelService();
+        if (!service) {
+            service = new SlackTeamChannelService({
+                slack: getSlackService(),
+                chat: getChatV2Service(),
+                storage: StorageService.getInstance(),
+                getDispatcher: () => getChatV2RealtimeDeps().dispatcher ?? null,
+                identities,
+            });
+            setSlackTeamChannelService(service);
+        }
+        await service.start();
+    }
+    catch (error) {
+        logger.warn('Slack team channels not started', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
 /**
  * Gracefully shutdown Slack integration
  *

package/dist/backend/backend/src/services/slack/slack-initializer.js.map

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

package/dist/backend/backend/src/services/slack/slack-mention-resolver.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 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
+ */
+/** One agent the resolver may match against. */
+export interface MentionCandidate {
+    /** Display name as configured on the team member (e.g. `Sam`). */
+    name: string;
+    /** Agent session name (e.g. `crewly-alpha-sam`). */
+    sessionName: string;
+    /**
+     * The agent's own Slack bot user id when it has a real identity. A native
+     * Slack mention arrives as `<@U…>` and is matched here first.
+     */
+    botUserId?: string;
+}
+/** An `@name` that matched no candidate, with close alternatives. */
+export interface UnknownMention {
+    /** The token as typed, without the `@`. */
+    token: string;
+    /** Candidate display names within the edit-distance cutoff, best first. */
+    suggestions: string[];
+}
+/** Result of {@link resolveSlackMentions}. */
+export interface ResolvedSlackMentions {
+    /** Session names of matched agents, in first-mention order, deduped. */
+    mentions: string[];
+    /** Tokens that matched nobody. */
+    unknown: UnknownMention[];
+}
+/** Options for {@link resolveSlackMentions}. */
+export interface ResolveSlackMentionsOptions {
+    /** Max edit distance for a suggestion (default from constants). */
+    maxDistance?: number;
+    /** Max suggestions per unknown token (default from constants). */
+    maxSuggestions?: number;
+}
+/**
+ * Extract the user ids of native `<@U…>` mentions, in order, deduped.
+ *
+ * @param text - Slack message text
+ * @returns Slack user ids
+ */
+export declare function extractNativeMentionIds(text: string): string[];
+/**
+ * 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 declare function levenshtein(a: string, b: string): number;
+/**
+ * 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 declare function candidateAliases(candidate: MentionCandidate): string[];
+/**
+ * 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 declare function extractMentionTokens(text: string): string[];
+/**
+ * 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 declare function resolveSlackMentions(text: string, candidates: MentionCandidate[], options?: ResolveSlackMentionsOptions): ResolvedSlackMentions;
+//# sourceMappingURL=slack-mention-resolver.d.ts.map

package/dist/backend/backend/src/services/slack/slack-mention-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-mention-resolver.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/slack/slack-mention-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAmBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAY3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAAE,EAC9B,OAAO,GAAE,2BAAgC,GACxC,qBAAqB,CAqDvB"}