experimental-ash 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/src/public/channels/slack/index.d.ts

@@ -1,15 +1,15 @@
 /**
- * Convenience factory for the Slack channel.
+ * Convenience factory for the Slack route.
  *
- * Returns a `Channel` whose `fetch` handler verifies the Slack request
+ * Returns a `Route` whose `fetch` handler verifies the Slack request
  * (via the chat SDK), parses the inbound mention, projects the verified
  * Slack identity into an Ash-owned {@link SlackEventContext}, runs the
- * required {@link SlackChannelInput.auth} resolver to produce the
+ * required {@link SlackRouteInput.auth} resolver to produce the
  * principal, and dispatches via `agent.deliver()` (with a fallback to
  * `agent.run()`) under that principal.
  *
  * This is a *library helper*, not a framework default. The framework
- * only ships the HTTP message + run-stream channel pair (see
+ * only ships the HTTP message + session-stream route pair (see
  * `experimental-ash/channels/http`). Authors who want a Slack bot
  * create their own file under `agent/channels/` and export the result
  * of this factory.
@@ -17,9 +17,9 @@
  * @example
  * ```ts
  * // agent/channels/slack.ts → POST /slack
- * import { slackChannel, slackUser } from "experimental-ash/channels/slack";
+ * import { slackRoute, slackUser } from "experimental-ash/channels/slack";
  *
- * export default slackChannel({
+ * export default slackRoute({
  *   credentials: {
  *     botToken: process.env.SLACK_BOT_TOKEN!,
  *     signingSecret: process.env.SLACK_SIGNING_SECRET!,
@@ -34,8 +34,12 @@
  * request to `chat.webhooks.slack(request)` which performs signature
  * verification, event parsing, and dispatch.
  */
-import { type Channel } from "../../definitions/channel.js";
-import { type AuthFn } from "../auth.js";
+import { SlackChannel, type SlackChannelState, type SlackUserContext } from "../../../channel/slack-channel.js";
+import type { Channel, ChannelClass } from "../../../channel/types.js";
+import { type Route } from "../../definitions/channel.js";
+import type { AuthFn } from "../auth.js";
+export type { SlackChannelState, SlackUserContext };
+export { SlackChannel };
 /**
  * Slack credentials and signing secret consumed by the underlying chat
  * SDK. Both fields are optional — when omitted, the underlying
@@ -43,7 +47,7 @@ import { type AuthFn } from "../auth.js";
  * defaults (`SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`).
  *
  * This shape is named `credentials` (rather than `auth`) so the slot
- * stays distinct from the inbound {@link SlackChannelInput.auth}
+ * stays distinct from the inbound {@link SlackRouteInput.auth}
  * resolver, which controls the *principal* the framework attaches to
  * each Slack-delivered turn.
  */
@@ -51,12 +55,16 @@ export interface SlackChannelCredentials {
     readonly botToken?: string;
     readonly signingSecret?: string;
 }
+/**
+ * Classification of the Slack actor that authored one inbound mention.
+ */
+export type SlackAuthorType = "user" | "bot";
 /**
  * Ash-owned projection of one verified inbound Slack mention.
  *
- * Constructed by {@link slackChannel} inside the chat SDK's
+ * Constructed by {@link slackRoute} inside the chat SDK's
  * `onNewMention` callback after the underlying signature check has
- * passed. It carries everything an {@link SlackChannelInput.auth}
+ * passed. It carries everything an {@link SlackRouteInput.auth}
  * resolver needs to derive a {@link SessionAuthContext} for the
  * delivered turn — without exposing any chat SDK types (CLAUDE.md item
  * 8).
@@ -75,8 +83,23 @@ export interface SlackEventContext {
      * resolver that requires it explicitly.
      */
     readonly teamId?: string;
-    /** Slack user id of the message author, e.g. `U0123ABC`. */
+    /** Whether the mention came from a human user or another bot. */
+    readonly authorType: SlackAuthorType;
+    /**
+     * Slack actor id of the message author, e.g. `U0123ABC` for users or
+     * `B0123ABC` for bot-authored messages.
+     */
     readonly userId: string;
+    /**
+     * Slack handle of the message author, e.g. `jane.smith`. Populated
+     * by the chat SDK from the Slack `users.info` API response.
+     */
+    readonly userName: string;
+    /**
+     * Display name of the message author, e.g. `Jane Smith`. Populated
+     * by the chat SDK from the Slack `users.info` API response.
+     */
+    readonly fullName: string;
     /** Slack channel id where the mention happened, e.g. `C0123ABC`. */
     readonly channelId: string;
     /** Thread root timestamp identifying the conversation. */
@@ -85,20 +108,44 @@ export interface SlackEventContext {
     readonly text: string;
     /** Slack event timestamp of this specific mention. */
     readonly eventTs: string;
+    /**
+     * Raw Slack event type, e.g. `app_mention`, `message`, or
+     * `reaction_added`. Optional because some test fixtures and edge-case
+     * payloads omit the field.
+     */
+    readonly slackEventType?: string;
 }
 /**
- * Input for {@link slackChannel}.
+ * Factory for the channel instance used when {@link slackRoute} starts a new
+ * Slack-backed session.
  *
- * Unlike the HTTP channel factories, `auth` is **optional** here. The
- * chat SDK always hands the channel a verified Slack identity, and the
+ * The route passes the standard Slack channel state (`botToken` and
+ * `serializedThread`) into the factory. Authors can return the framework's
+ * default {@link SlackChannel}, a subclass, or any other registered
+ * {@link Channel} implementation that composes Slack-specific behavior such as
+ * context seeding or custom delivery policy.
+ *
+ * The constructor state should stay immutable after the session starts. Use
+ * `onDeliver(...)` and durable context for mutable per-session data.
+ *
+ * When omitted, {@link slackRoute} constructs a plain {@link SlackChannel}.
+ */
+export interface SlackRouteChannelClass<C extends Channel = Channel> extends ChannelClass<C> {
+    new (state: SlackChannelState): C;
+}
+/**
+ * Input for {@link slackRoute}.
+ *
+ * Unlike the HTTP route factories, `auth` is **optional** here. The
+ * chat SDK always hands the route a verified Slack identity, and the
  * canonical projection of that identity into a `SessionAuthContext` is
- * stable enough to ship as a default — see {@link slackUser}. Channels
+ * stable enough to ship as a default — see {@link slackUser}. Routes
  * that need a custom projection (DB lookups, workspace allowlists,
- * cross-workspace mapping) pass their own {@link AuthFn}; channels that
+ * cross-workspace mapping) pass their own {@link AuthFn}; routes that
  * want to drop the principal entirely pass `none()` from
  * `experimental-ash/channels/auth`.
  */
-export interface SlackChannelInput {
+export interface SlackRouteInput {
     /**
      * Outbound credentials and signing secret for the chat SDK. Renamed
      * from the previous `auth` field.
@@ -109,27 +156,47 @@ export interface SlackChannelInput {
      * bot's `userName`. Defaults to `"ash-agent"`.
      */
     readonly botName?: string;
+    /**
+     * Optional channel class used for new Slack-backed sessions.
+     *
+     * Use this when you want to keep the stock Slack webhook/auth parsing from
+     * {@link slackRoute} but need a custom channel implementation for
+     * `onDeliver()` or `onEvent()`. The class constructor receives the
+     * framework's default Slack channel state for the current thread and returns
+     * the channel object that `agent.run()` should persist with the session.
+     * Stable transport identity belongs on that serialized state; mutable
+     * session-scoped data belongs in durable context or `session.internal`.
+     *
+     * The route helper automatically declares the class on the route's
+     * `serializableChannels` list so the runtime can rehydrate it after
+     * workflow boundaries. No global registration is needed.
+     */
+    readonly channel?: SlackRouteChannelClass;
     /**
      * Optional projection of the verified Slack identity into a
      * {@link SessionAuthContext}. Defaults to {@link slackUser}, which
-     * builds the standard `slack:<teamId>:<userId>` principal. The
-     * resolver runs once per inbound mention after signature verification
-     * has passed. Returning a `SessionAuthContext` attaches the
-     * principal; returning `null` drops the message (logged); returning
-     * `undefined` dispatches with no principal attached.
+     * builds the standard human Slack principal and maps bot-authored
+     * mentions onto a service principal. The resolver runs once per
+     * inbound mention after signature verification has passed. Returning
+     * a `SessionAuthContext` attaches the principal; returning `null`
+     * drops the message (logged); returning `undefined` dispatches with
+     * no principal attached.
      */
     readonly auth?: AuthFn<SlackEventContext>;
 }
 /**
- * Default {@link AuthFn} for the Slack channel.
+ * Default {@link AuthFn} for the Slack route.
+ *
+ * Builds a Slack-scoped principal from the verified mention. Human
+ * mentions become `user` principals; bot-authored mentions become
+ * `service` principals so authored routes can distinguish automation
+ * callers from people.
  *
- * Builds a Slack-scoped principal from the verified mention. When the
- * inbound event carries a workspace id, the principal is
- * `slack:<teamId>:<userId>` (globally unique across workspaces, the
- * right default for multi-workspace deployments). When `teamId` is
- * absent — the common single-workspace case — the principal falls back
- * to `slack:<userId>`, which is unique within the only workspace the
- * bot ever sees.
+ * When the inbound event carries a workspace id, human principals use
+ * `slack:<teamId>:<userId>` and bot principals use
+ * `slack:<teamId>:bot:<userId>`. When `teamId` is absent — the common
+ * single-workspace case — the identifiers fall back to
+ * `slack:<userId>` and `slack:bot:<userId>`.
  *
  * Use a hand-written {@link AuthFn} when you need richer behavior:
  * looking up internal user ids, gating on workspace allowlists, or
@@ -137,15 +204,15 @@ export interface SlackChannelInput {
  */
 export declare function slackUser(): AuthFn<SlackEventContext>;
 /**
- * Returns the framework's default Slack {@link Channel} implementation.
+ * Returns the framework's default Slack {@link Route} implementation.
  *
- * The returned channel handles `POST` Slack webhooks. The URL path is
- * derived from the channel file's location under `agent/channels/`.
+ * The returned route handles `POST` Slack webhooks. The URL path is
+ * derived from the route file's location under `agent/channels/`.
  *
- * `input` is optional — `slackChannel()` is equivalent to
- * `slackChannel({ auth: slackUser() })` and reads `SLACK_BOT_TOKEN` /
+ * `input` is optional — `slackRoute()` is equivalent to
+ * `slackRoute({ auth: slackUser() })` and reads `SLACK_BOT_TOKEN` /
  * `SLACK_SIGNING_SECRET` from the environment via the chat SDK's own
  * defaults.
  */
-export declare function slackChannel(input?: SlackChannelInput): Channel;
+export declare function slackRoute(input?: SlackRouteInput): Route;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/public/channels/slack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/public/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAqBrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,iBAAsB,GAAG,OAAO,CA2GnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/public/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAsB,MAAM,2BAA2B,CAAC;AAE3F,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC1F,KAAK,KAAK,EAAE,iBAAiB,GAAG,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAAC,iBAAiB,CAAC,CA+BrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAE,eAAoB,GAAG,KAAK,CA2J7D"}

package/dist/src/public/channels/slack/index.js

@@ -1,15 +1,15 @@
 /**
- * Convenience factory for the Slack channel.
+ * Convenience factory for the Slack route.
  *
- * Returns a `Channel` whose `fetch` handler verifies the Slack request
+ * Returns a `Route` whose `fetch` handler verifies the Slack request
  * (via the chat SDK), parses the inbound mention, projects the verified
  * Slack identity into an Ash-owned {@link SlackEventContext}, runs the
- * required {@link SlackChannelInput.auth} resolver to produce the
+ * required {@link SlackRouteInput.auth} resolver to produce the
  * principal, and dispatches via `agent.deliver()` (with a fallback to
  * `agent.run()`) under that principal.
  *
  * This is a *library helper*, not a framework default. The framework
- * only ships the HTTP message + run-stream channel pair (see
+ * only ships the HTTP message + session-stream route pair (see
  * `experimental-ash/channels/http`). Authors who want a Slack bot
  * create their own file under `agent/channels/` and export the result
  * of this factory.
@@ -17,9 +17,9 @@
  * @example
  * ```ts
  * // agent/channels/slack.ts → POST /slack
- * import { slackChannel, slackUser } from "experimental-ash/channels/slack";
+ * import { slackRoute, slackUser } from "experimental-ash/channels/slack";
  *
- * export default slackChannel({
+ * export default slackRoute({
  *   credentials: {
  *     botToken: process.env.SLACK_BOT_TOKEN!,
  *     signingSecret: process.env.SLACK_SIGNING_SECRET!,
@@ -34,19 +34,22 @@
  * request to `chat.webhooks.slack(request)` which performs signature
  * verification, event parsing, and dispatch.
  */
-import { SlackChannelEmitter } from "../../../channel/slack-emitter.js";
-import { defineChannel } from "../../definitions/channel.js";
-import { withAuth } from "../auth.js";
+import { SlackChannel, } from "../../../channel/slack-channel.js";
+import { defineRoute } from "../../definitions/channel.js";
+export { SlackChannel };
 /**
- * Default {@link AuthFn} for the Slack channel.
+ * Default {@link AuthFn} for the Slack route.
  *
- * Builds a Slack-scoped principal from the verified mention. When the
- * inbound event carries a workspace id, the principal is
- * `slack:<teamId>:<userId>` (globally unique across workspaces, the
- * right default for multi-workspace deployments). When `teamId` is
- * absent — the common single-workspace case — the principal falls back
- * to `slack:<userId>`, which is unique within the only workspace the
- * bot ever sees.
+ * Builds a Slack-scoped principal from the verified mention. Human
+ * mentions become `user` principals; bot-authored mentions become
+ * `service` principals so authored routes can distinguish automation
+ * callers from people.
+ *
+ * When the inbound event carries a workspace id, human principals use
+ * `slack:<teamId>:<userId>` and bot principals use
+ * `slack:<teamId>:bot:<userId>`. When `teamId` is absent — the common
+ * single-workspace case — the identifiers fall back to
+ * `slack:<userId>` and `slack:bot:<userId>`.
  *
  * Use a hand-written {@link AuthFn} when you need richer behavior:
  * looking up internal user ids, gating on workspace allowlists, or
@@ -55,44 +58,61 @@ import { withAuth } from "../auth.js";
 export function slackUser() {
     return (event) => {
         const attributes = {
+            author_type: event.authorType,
             channel_id: event.channelId,
+            full_name: event.fullName,
             thread_ts: event.threadTs,
             user_id: event.userId,
+            user_name: event.userName,
         };
         if (event.teamId !== undefined) {
             attributes.team_id = event.teamId;
         }
+        const principalId = event.teamId !== undefined
+            ? event.authorType === "bot"
+                ? `slack:${event.teamId}:bot:${event.userId}`
+                : `slack:${event.teamId}:${event.userId}`
+            : event.authorType === "bot"
+                ? `slack:bot:${event.userId}`
+                : `slack:${event.userId}`;
         return {
             attributes,
             authenticator: "slack-webhook",
             issuer: event.teamId !== undefined ? `slack:${event.teamId}` : "slack",
-            principalId: event.teamId !== undefined
-                ? `slack:${event.teamId}:${event.userId}`
-                : `slack:${event.userId}`,
-            principalType: "user",
+            principalId,
+            principalType: event.authorType === "bot" ? "service" : "user",
         };
     };
 }
 /**
- * Returns the framework's default Slack {@link Channel} implementation.
+ * Returns the framework's default Slack {@link Route} implementation.
  *
- * The returned channel handles `POST` Slack webhooks. The URL path is
- * derived from the channel file's location under `agent/channels/`.
+ * The returned route handles `POST` Slack webhooks. The URL path is
+ * derived from the route file's location under `agent/channels/`.
  *
- * `input` is optional — `slackChannel()` is equivalent to
- * `slackChannel({ auth: slackUser() })` and reads `SLACK_BOT_TOKEN` /
+ * `input` is optional — `slackRoute()` is equivalent to
+ * `slackRoute({ auth: slackUser() })` and reads `SLACK_BOT_TOKEN` /
  * `SLACK_SIGNING_SECRET` from the environment via the chat SDK's own
  * defaults.
  */
-export function slackChannel(input = {}) {
+export function slackRoute(input = {}) {
     const resolveAuth = input.auth ?? slackUser();
-    return defineChannel({
+    if (input.channel !== undefined && !(input.channel.prototype instanceof SlackChannel)) {
+        throw new TypeError("slackRoute: `channel` must extend `SlackChannel`.");
+    }
+    if (input.channel !== undefined &&
+        input.channel !== SlackChannel &&
+        input.channel.kind === SlackChannel.kind) {
+        throw new TypeError('slackRoute: custom channel classes must declare a unique static `kind` instead of inheriting "slack".');
+    }
+    return defineRoute({
         method: "POST",
+        serializableChannels: input.channel !== undefined ? [input.channel] : undefined,
         async fetch(request, ctx) {
             // Dynamically import the chat SDK so the public surface stays free
             // of any third-party type leakage (CLAUDE.md item 8). The dynamic
             // imports also let bundlers tree-shake Slack support out of agents
-            // that never construct a slackChannel.
+            // that never construct a slackRoute.
             const [slackModule, stateModule, chatModule] = (await Promise.all([
                 import("@chat-adapter/slack"),
                 import("@chat-adapter/state-memory"),
@@ -148,24 +168,49 @@ export function slackChannel(input = {}) {
                     return;
                 }
                 // resolved is either a SessionAuthContext (authenticated) or
-                // undefined (anonymous, allowed through). withAuth(ctx, null)
-                // is safe to call in either case — it ensures dispatched
-                // agent.run/deliver carry the verified principal (or explicit
-                // null) without the inner emitter having to know which path ran.
+                // undefined (anonymous, allowed through).
                 const sessionAuth = resolved ?? null;
-                const authedCtx = withAuth(ctx, sessionAuth);
                 try {
-                    await authedCtx.agent.deliver({
+                    await ctx.agent.deliver({
+                        auth: sessionAuth,
                         continuationToken,
                         payload: { message: event.text },
                     });
                 }
                 catch {
-                    const handle = await authedCtx.agent.run({
-                        channelEmitter: new SlackChannelEmitter({
-                            botToken: input.credentials?.botToken,
-                            serializedThread: thread.toJSON(),
-                        }),
+                    // Only direct `app_mention` events are allowed to open a new
+                    // session. Other subscribed Slack events may continue an
+                    // existing session, but if no session exists yet we drop them
+                    // instead of treating every event as a root trigger.
+                    if (event.slackEventType !== "app_mention") {
+                        console.warn("[slack] dropped non-app mention without active session", {
+                            channelId: event.channelId,
+                            eventType: event.slackEventType,
+                            threadTs: event.threadTs,
+                        });
+                        return;
+                    }
+                    const userContext = {
+                        channelId: event.channelId,
+                        fullName: event.fullName,
+                        teamId: event.teamId,
+                        threadTs: event.threadTs,
+                        userId: event.userId,
+                        userName: event.userName,
+                    };
+                    const handle = await ctx.agent.run({
+                        auth: sessionAuth,
+                        channel: input.channel !== undefined
+                            ? new input.channel({
+                                botToken: input.credentials?.botToken,
+                                serializedThread: thread.toJSON(),
+                                userContext,
+                            })
+                            : new SlackChannel({
+                                botToken: input.credentials?.botToken,
+                                serializedThread: thread.toJSON(),
+                                userContext,
+                            }),
                         continuationToken,
                         input: { message: event.text },
                         mode: "conversation",
@@ -174,6 +219,13 @@ export function slackChannel(input = {}) {
                     ctx.waitUntil(handle.result);
                 }
             });
+            // Slack sends interaction payloads (button clicks, select menus) as
+            // form-encoded data, while Events API payloads are JSON. Detect and
+            // handle interactions before delegating to the Chat SDK.
+            const contentType = request.headers.get("content-type") ?? "";
+            if (contentType.includes("application/x-www-form-urlencoded")) {
+                return await handleSlackInteraction(request, ctx);
+            }
             return await chat.webhooks.slack(request, {
                 waitUntil: ctx.waitUntil,
             });
@@ -197,12 +249,6 @@ export function slackChannel(input = {}) {
  */
 function projectSlackMention(input) {
     const { message } = input;
-    // Drop bot-authored mentions outright — `slack:<teamId>:B...` is not
-    // a stable user principal. The chat SDK already filters self-bot
-    // messages; this guards against mentions from third-party bots.
-    if (message.author.isBot === true) {
-        return { ok: false, missing: ["author.isBot"] };
-    }
     // user id and event ts come straight off the typed Message fields
     // the chat SDK populated when parsing the inbound webhook.
     // `message.author.userId` defaults to "unknown" when the underlying
@@ -213,8 +259,13 @@ function projectSlackMention(input) {
     // it from the typed raw payload when present. Optional: single-
     // workspace bots don't need it, and the default `slackUser()`
     // resolver falls back to `slack:<userId>` when teamId is absent.
-    const raw = message.raw !== null && typeof message.raw === "object" ? message.raw : null;
+    const raw = message.raw;
     const teamId = raw?.team_id ?? raw?.team;
+    const slackEventType = raw?.type;
+    let authorType = "user";
+    if (message.author.isBot === true || raw?.bot_id !== undefined) {
+        authorType = "bot";
+    }
     const missing = [];
     if (!userId)
         missing.push("user");
@@ -224,15 +275,85 @@ function projectSlackMention(input) {
         return { ok: false, missing };
     }
     const event = {
+        authorType,
         channelId: input.channel,
         eventTs,
+        fullName: message.author.fullName,
         text: message.text,
         threadTs: input.threadTs,
         userId,
+        userName: message.author.userName,
     };
     if (teamId !== undefined) {
         event.teamId = teamId;
     }
+    if (slackEventType !== undefined) {
+        event.slackEventType = slackEventType;
+    }
     return { ok: true, event };
 }
+/**
+ * Handles Slack interaction payloads (button clicks, select menus)
+ * arriving at the same webhook URL as Events API payloads.
+ *
+ * Slack sends interaction payloads as `application/x-www-form-urlencoded`
+ * with a `payload` JSON field. This function parses the payload, maps
+ * actions to {@link InputResponse} objects, and delivers them to the
+ * parked session.
+ */
+async function handleSlackInteraction(request, ctx) {
+    let payload;
+    try {
+        const body = await request.formData();
+        const raw = body.get("payload");
+        if (typeof raw !== "string") {
+            return new Response("ok", { status: 200 });
+        }
+        payload = JSON.parse(raw);
+    }
+    catch {
+        return new Response("ok", { status: 200 });
+    }
+    if (payload.type !== "block_actions") {
+        return new Response("ok", { status: 200 });
+    }
+    const channel = payload.channel?.id ?? payload.container?.channel_id;
+    const threadTs = payload.message?.thread_ts ?? payload.message?.ts ?? payload.container?.thread_ts;
+    if (channel === undefined || threadTs === undefined) {
+        return new Response("ok", { status: 200 });
+    }
+    const continuationToken = `slack:${channel}:${threadTs}`;
+    const inputResponses = [];
+    for (const action of payload.actions ?? []) {
+        if (action.type === "button") {
+            const requestId = action.value;
+            if (requestId === undefined) {
+                continue;
+            }
+            inputResponses.push({ requestId, optionId: action.action_id });
+        }
+        else if (action.type === "static_select" || action.type === "external_select") {
+            const optionId = action.selected_option?.value;
+            if (optionId === undefined) {
+                continue;
+            }
+            const requestId = action.action_id.startsWith("select_")
+                ? action.action_id.slice(7)
+                : action.action_id;
+            inputResponses.push({ requestId, optionId });
+        }
+    }
+    if (inputResponses.length > 0) {
+        try {
+            await ctx.agent.deliver({
+                continuationToken,
+                payload: { inputResponses },
+            });
+        }
+        catch (error) {
+            console.error("[ash] Slack interaction deliver failed.", error);
+        }
+    }
+    return new Response("ok", { status: 200 });
+}
 //# sourceMappingURL=index.js.map

package/dist/src/public/channels/slack/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/public/channels/slack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAgB,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAe,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyFnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,UAAU,GAA2B;YACzC,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,SAAS,EAAE,KAAK,CAAC,QAAQ;YACzB,OAAO,EAAE,KAAK,CAAC,MAAM;SACtB,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QACpC,CAAC;QACD,OAAO;YACL,UAAU;YACV,aAAa,EAAE,eAAe;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO;YACtE,WAAW,EACT,KAAK,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE;gBACzC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,EAAE;YAC7B,aAAa,EAAE,MAAM;SACtB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B,EAAE;IACxD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;IAC9C,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,MAAM;QACd,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG;YACtB,mEAAmE;YACnE,kEAAkE;YAClE,mEAAmE;YACnE,uCAAuC;YACvC,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChE,MAAM,CAAC,qBAAqB,CAAC;gBAC7B,MAAM,CAAC,4BAA4B,CAAC;gBACpC,MAAM,CAAC,MAAM,CAAC;aACf,CAAC,CAID,CAAC;YAEF,MAAM,OAAO,GAAG,WAAW,CAAC,kBAAkB,CAAC;gBAC7C,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ;gBACrC,aAAa,EAAE,KAAK,CAAC,WAAW,EAAE,aAAa;gBAC/C,QAAQ,EAAE,KAAK,CAAC,OAAO;aACxB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC;gBAC/B,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;gBAC5B,KAAK,EAAE,WAAW,CAAC,iBAAiB,EAAE;gBACtC,QAAQ,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW;aACvC,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAExB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;gBAC1C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAChE,MAAM,iBAAiB,GAAG,SAAS,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAEzD,MAAM,UAAU,GAAG,mBAAmB,CAAC;oBACrC,OAAO;oBACP,OAAO;oBACP,QAAQ;iBACT,CAAC,CAAC;gBACH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;oBACnB,2DAA2D;oBAC3D,6DAA6D;oBAC7D,2DAA2D;oBAC3D,iDAAiD;oBACjD,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE;wBACrE,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,QAAQ,EAAE,MAAM,CAAC,EAAE;qBACpB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;gBAE/B,IAAI,QAA+C,CAAC;gBACpD,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;gBACtC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE;wBAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;wBAC7D,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,OAAO,CAAC,IAAI,CAAC,yCAAyC,EAAE;wBACtD,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,6DAA6D;gBAC7D,8DAA8D;gBAC9D,yDAAyD;gBACzD,8DAA8D;gBAC9D,iEAAiE;gBACjE,MAAM,WAAW,GAA8B,QAAQ,IAAI,IAAI,CAAC;gBAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBAE7C,IAAI,CAAC;oBACH,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;wBAC5B,iBAAiB;wBACjB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;qBACjC,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;wBACvC,cAAc,EAAE,IAAI,mBAAmB,CAAC;4BACtC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ;4BACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;yBAClC,CAAC;wBACF,iBAAiB;wBACjB,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;wBAC9B,IAAI,EAAE,cAAc;wBACpB,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE;qBAC/B,CAAC,CAAC;oBACH,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;gBACxC,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AA0BD;;;;;;;;;;;;;;GAcG;AACH,SAAS,mBAAmB,CAAC,KAI5B;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE1B,qEAAqE;IACrE,iEAAiE;IACjE,gEAAgE;IAChE,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,kEAAkE;IAClE,2DAA2D;IAC3D,oEAAoE;IACpE,iEAAiE;IACjE,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC;IAEnC,oEAAoE;IACpE,gEAAgE;IAChE,8DAA8D;IAC9D,iEAAiE;IACjE,MAAM,GAAG,GACP,OAAO,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,OAAO,CAAC,GAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,MAAM,MAAM,GAAG,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,IAAI,CAAC;IAEzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,KAAK,GAAuE;QAChF,SAAS,EAAE,KAAK,CAAC,OAAO;QACxB,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM;KACP,CAAC;IACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/public/channels/slack/index.ts"],"names":[],"mappings":"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"}

package/dist/src/public/channels/slack/lowlevel.d.ts

@@ -1,15 +1,15 @@
 /**
  * Lower-level Slack channel primitives for users who write their own
- * `fetch` handler instead of using the {@link slackChannel} convenience
+ * `fetch` handler instead of using the {@link slackRoute} convenience
  * factory.
  *
  * Today this just re-exports the framework's default
- * {@link SlackChannelEmitter} so handcrafted Slack channels can still rely
+ * {@link SlackChannel} so handcrafted Slack routes can still rely
  * on the standard reply behavior. Future additions
  * (`verifySlackSignature`, `parseSlackEvent`, typed `SlackEvent` unions)
- * will live alongside the emitter and remain Ash-owned implementations
+ * will live alongside the channel and remain Ash-owned implementations
  * rather than re-exports of `@chat-adapter/slack` (CLAUDE.md item 8).
  */
-export type { SlackChannelEmitterState } from "../../../channel/slack-emitter.js";
-export { SlackChannelEmitter } from "../../../channel/slack-emitter.js";
+export type { SlackChannelState } from "../../../channel/slack-channel.js";
+export { SlackChannel } from "../../../channel/slack-channel.js";
 //# sourceMappingURL=lowlevel.d.ts.map

package/dist/src/public/channels/slack/lowlevel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lowlevel.d.ts","sourceRoot":"","sources":["../../../../../src/public/channels/slack/lowlevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"lowlevel.d.ts","sourceRoot":"","sources":["../../../../../src/public/channels/slack/lowlevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC"}