@zhin.js/adapter-slack 6.0.13 → 7.0.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## 7.0.0
+
+### Patch Changes
+
+- f2c532f: Expose exact per-Endpoint message operations through one validated Adapter capability model, route Core control calls through declared active capabilities, and connect existing recall, edit, reaction, and typing implementations across platform adapters.
+- Updated dependencies [b10d058]
+- Updated dependencies [f2c532f]
+- Updated dependencies [3dbf990]
+  - @zhin.js/host-http@1.0.12
+  - @zhin.js/adapter@1.2.0
+  - @zhin.js/core@1.5.13
+  - @zhin.js/agent@1.1.15
+  - zhin.js@6.0.13
+
+## 6.0.14
+
+### Patch Changes
+
+- 5969c5b: Add SideEventGateway so adapters forward notice/request/system into HandlerIndex. HandlerContext now exposes only generation-safe capabilities and prompt ports; live Endpoint escape hatches are removed.
+- Updated dependencies [5969c5b]
+- Updated dependencies [d336a3f]
+- Updated dependencies [0c82a7e]
+- Updated dependencies [b9217e4]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [974772e]
+- Updated dependencies [5969c5b]
+- Updated dependencies [5969c5b]
+- Updated dependencies [2f786bd]
+- Updated dependencies [63d89f9]
+- Updated dependencies [71c7cdd]
+- Updated dependencies [3cca0ea]
+- Updated dependencies [1312ca0]
+- Updated dependencies [985fa22]
+- Updated dependencies [04b861d]
+- Updated dependencies [a23d544]
+- Updated dependencies [8cddabf]
+- Updated dependencies [dbe5081]
+  - @zhin.js/im-contract@1.0.4
+  - @zhin.js/core@1.5.12
+  - @zhin.js/adapter@1.1.11
+  - @zhin.js/agent@1.1.14
+  - @zhin.js/host-http@1.0.11
+  - @zhin.js/command@1.0.15
+  - zhin.js@6.0.12
+  - @zhin.js/permission@1.0.3
+
 ## 6.0.13
 
 ### Patch Changes

package/adapters/slack.js

@@ -3,7 +3,7 @@
  * Convention entry: discover `adapters/slack.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { SlackEndpoint } from "../lib/endpoint.js";
 import { resolveSlackConfig, } from "../lib/protocol.js";
@@ -11,6 +11,7 @@ import { slackRuntimeStateToken } from "../lib/slack-runtime-state.js";
 export { SlackEndpoint } from "../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
+    operations: ['recall', 'edit', 'reaction'],
     // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
     // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
     // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
@@ -29,6 +30,7 @@ export default defineAdapter({
             return new SlackEndpoint({
                 id: context.id,
                 gateway: context.use(messageGatewayToken),
+                sideEvents: context.use(sideEventGatewayToken),
                 http: context.use(httpHostToken),
                 config,
             });
@@ -36,6 +38,7 @@ export default defineAdapter({
         return new SlackEndpoint({
             id: context.id,
             gateway: context.use(messageGatewayToken),
+            sideEvents: context.use(sideEventGatewayToken),
             config,
         });
     },

package/adapters/slack.ts

@@ -2,7 +2,7 @@
  * Convention entry: discover `adapters/slack.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { SlackEndpoint } from '../src/endpoint.js';
 import {
@@ -16,6 +16,7 @@ export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '
 
 export default defineAdapter<SlackAdapterConfig>({
   capabilities: ['inbound', 'outbound'],
+  operations: ['recall', 'edit', 'reaction'],
   // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
   // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
   // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
@@ -34,6 +35,7 @@ export default defineAdapter<SlackAdapterConfig>({
       return new SlackEndpoint({
         id: context.id,
         gateway: context.use(messageGatewayToken),
+        sideEvents: context.use(sideEventGatewayToken),
         http: context.use(httpHostToken),
         config,
       });
@@ -41,6 +43,7 @@ export default defineAdapter<SlackAdapterConfig>({
     return new SlackEndpoint({
       id: context.id,
       gateway: context.use(messageGatewayToken),
+      sideEvents: context.use(sideEventGatewayToken),
       config,
     });
   },

package/lib/endpoint.d.ts

@@ -1,5 +1,5 @@
-import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { EndpointControl, EndpointInstance, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from 'zhin.js';
 import { type ResolvedSlackConfig, type SlackEvent, type SlackInteractionPayload, type SlackMessageEvent, type SlackSlashCommand } from './protocol.js';
@@ -118,6 +118,7 @@ export interface SlackWebClientLike extends SlackChatClient {
 export interface SlackEndpointOptions {
     readonly id: CapabilityId;
     readonly gateway: MessageGateway;
+    readonly sideEvents?: SideEventGateway;
     readonly config: ResolvedSlackConfig;
     readonly http?: HttpHost;
     readonly createClient?: (token: string) => SlackWebClientLike;
@@ -129,6 +130,7 @@ export interface SlackEndpointOptions {
 export declare class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     #private;
     readonly management: EndpointManagement;
+    readonly control: EndpointControl;
     constructor(options: SlackEndpointOptions);
     /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
     get name(): string;

package/lib/endpoint.js

@@ -12,6 +12,7 @@ import { normalizeSlackReactionName } from './slack-reaction.js';
 import { postSlackEphemeral } from './slack-response-url.js';
 import { editSlackContent, sendSlackContent } from './slack-outbound.js';
 import { registerSlackWebhookRoutes } from './webhook.js';
+import { receiveSlackSideEvent } from './side-event-dispatch.js';
 export class SlackEndpoint {
     #logger;
     #options;
@@ -25,6 +26,35 @@ export class SlackEndpoint {
     #started = false;
     #unregisterAgent;
     management = createSlackEndpointManagement(this);
+    control = Object.freeze({
+        recall: async (message) => {
+            const ref = this.resolveMessageRef(message.id, message.conversation.id);
+            if (!ref || !this.#client)
+                return;
+            await this.#client.chat.delete(ref);
+        },
+        edit: async (message, content) => {
+            const ref = this.resolveMessageRef(message.id, message.conversation.id);
+            if (!ref)
+                return null;
+            await this.editMessage(ref.channel, ref.ts, content);
+            return message.id;
+        },
+        addReaction: async (message, emoji) => {
+            const ref = this.resolveMessageRef(message.id, message.conversation.id);
+            if (!ref)
+                return null;
+            const reaction = normalizeSlackReactionName(emoji);
+            await this.addReaction(ref.channel, ref.ts, reaction);
+            return reaction;
+        },
+        removeReaction: async (message, reactionId) => {
+            const ref = this.resolveMessageRef(message.id, message.conversation.id);
+            if (!ref)
+                return;
+            await this.removeReaction(ref.channel, ref.ts, reactionId);
+        },
+    });
     constructor(options) {
         this.#logger = getAdapterLogger('slack', options.config.id);
         this.#options = options;
@@ -216,7 +246,12 @@ export class SlackEndpoint {
     handleEnvelope(body) {
         const envelope = body;
         if (envelope?.type === 'event_callback' && envelope.event) {
-            this.admit(envelope.event);
+            const event = envelope.event;
+            if (event.type !== 'message' && event.type !== 'app_mention') {
+                receiveSlackSideEvent(this.#options.sideEvents, String(this.#options.id), this.#options.config.id, event, this.#logger);
+                return;
+            }
+            this.admit(event);
         }
     }
     trackMessageChannel(ts, channel) {

package/lib/side-event-dispatch.d.ts

@@ -0,0 +1,4 @@
+import type { SideEventGateway } from '@zhin.js/core/runtime';
+import { type getAdapterLogger } from '@zhin.js/logger';
+import type { SlackEvent } from './protocol.js';
+export declare function receiveSlackSideEvent(sideEvents: SideEventGateway | undefined, endpointKey: string, configId: string, event: SlackEvent, logger: ReturnType<typeof getAdapterLogger>): void;

package/lib/side-event-dispatch.js

@@ -0,0 +1,45 @@
+import { buildNotice, mapNoticeParts, senderFromId, SLACK_NOTICE_PARTS_MAP } from '@zhin.js/core';
+import { formatCompact } from '@zhin.js/logger';
+export function receiveSlackSideEvent(sideEvents, endpointKey, configId, event, logger) {
+    if (!sideEvents)
+        return;
+    const eventType = String(event.type ?? '');
+    if (!Object.prototype.hasOwnProperty.call(SLACK_NOTICE_PARTS_MAP, eventType))
+        return;
+    const record = event;
+    const parts = mapNoticeParts('slack', eventType);
+    const channel = typeof record.channel === 'string' ? record.channel : undefined;
+    const user = typeof record.user === 'string' ? record.user : undefined;
+    const sceneId = channel ?? user ?? configId;
+    const dedupeKey = [
+        eventType,
+        channel ?? '',
+        user ?? '',
+        String(record.ts ?? record.event_ts ?? ''),
+    ].join(':');
+    void sideEvents.receiveNotice(buildNotice(record, {
+        $id: `slack:${dedupeKey}`,
+        $adapter: 'slack',
+        $endpoint: configId,
+        $type: 'notice',
+        $scene_id: sceneId,
+        $scene_type: parts.scene_type,
+        $sub_type: parts.sub_type,
+        $actor: senderFromId(user),
+        $target: senderFromId(typeof record.item_user === 'string' ? record.item_user : undefined),
+        $timestamp: toMillis(record.event_ts ?? record.ts),
+    })).catch((err) => {
+        logger.warn(formatCompact({
+            op: 'slack_side_event_failed',
+            endpoint: configId,
+            event: eventType,
+            error: err instanceof Error ? err.message : String(err),
+        }));
+    });
+}
+function toMillis(time) {
+    const value = Number(time);
+    if (!Number.isFinite(value) || value <= 0)
+        return Date.now();
+    return value < 1e12 ? Math.round(value * 1000) : Math.round(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "6.0.13",
+  "version": "7.0.0",
   "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,21 +34,21 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.7",
     "@slack/web-api": "^7.19.0",
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/core": "1.5.13",
+    "@zhin.js/host-http": "1.0.12",
+    "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.10",
-    "@zhin.js/agent": "1.1.13",
-    "@zhin.js/command": "1.0.14",
-    "@zhin.js/core": "1.5.11",
-    "@zhin.js/host-http": "1.0.10",
-    "@zhin.js/permission": "1.0.2",
-    "zhin.js": "6.0.11"
+    "@zhin.js/adapter": "1.2.0",
+    "@zhin.js/agent": "1.1.15",
+    "@zhin.js/command": "1.0.15",
+    "@zhin.js/core": "1.5.13",
+    "@zhin.js/host-http": "1.0.12",
+    "@zhin.js/permission": "1.0.3",
+    "zhin.js": "6.0.13"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -69,8 +69,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.13",
-    "zhin.js": "6.0.11"
+    "@zhin.js/agent": "1.1.15",
+    "zhin.js": "6.0.13"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -6,11 +6,12 @@ import { WebClient } from '@slack/web-api';
 import type {
   EndpointFriend,
   EndpointGroup,
+  EndpointControl,
   EndpointInstance,
   EndpointManagement,
   EndpointSendRequest,
 } from 'zhin.js/adapter';
-import type { MessageGateway } from '@zhin.js/core/runtime';
+import type { MessageGateway, SideEventGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from 'zhin.js';
@@ -37,6 +38,7 @@ import { normalizeSlackReactionName } from './slack-reaction.js';
 import { postSlackEphemeral } from './slack-response-url.js';
 import { editSlackContent, sendSlackContent, type SlackChatClient } from './slack-outbound.js';
 import { registerSlackWebhookRoutes, type SlackWebhookHandler } from './webhook.js';
+import { receiveSlackSideEvent } from './side-event-dispatch.js';
 
 export interface SlackSocketLike {
   on(
@@ -91,6 +93,7 @@ export interface SlackWebClientLike extends SlackChatClient {
 export interface SlackEndpointOptions {
   readonly id: CapabilityId;
   readonly gateway: MessageGateway;
+  readonly sideEvents?: SideEventGateway;
   readonly config: ResolvedSlackConfig;
   readonly http?: HttpHost;
   readonly createClient?: (token: string) => SlackWebClientLike;
@@ -114,6 +117,31 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
   #started = false;
   #unregisterAgent?: () => void;
   readonly management: EndpointManagement = createSlackEndpointManagement(this);
+  readonly control: EndpointControl = Object.freeze<EndpointControl>({
+    recall: async (message) => {
+      const ref = this.resolveMessageRef(message.id, message.conversation.id);
+      if (!ref || !this.#client) return;
+      await this.#client.chat.delete(ref);
+    },
+    edit: async (message, content) => {
+      const ref = this.resolveMessageRef(message.id, message.conversation.id);
+      if (!ref) return null;
+      await this.editMessage(ref.channel, ref.ts, content);
+      return message.id;
+    },
+    addReaction: async (message, emoji) => {
+      const ref = this.resolveMessageRef(message.id, message.conversation.id);
+      if (!ref) return null;
+      const reaction = normalizeSlackReactionName(emoji);
+      await this.addReaction(ref.channel, ref.ts, reaction);
+      return reaction;
+    },
+    removeReaction: async (message, reactionId) => {
+      const ref = this.resolveMessageRef(message.id, message.conversation.id);
+      if (!ref) return;
+      await this.removeReaction(ref.channel, ref.ts, reactionId);
+    },
+  });
 
   constructor(options: SlackEndpointOptions) {
     this.#logger = getAdapterLogger('slack', options.config.id);
@@ -316,7 +344,18 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
   handleEnvelope(body: unknown): void {
     const envelope = body as SlackEventEnvelope;
     if (envelope?.type === 'event_callback' && envelope.event) {
-      this.admit(envelope.event);
+      const event = envelope.event;
+      if (event.type !== 'message' && event.type !== 'app_mention') {
+        receiveSlackSideEvent(
+          this.#options.sideEvents,
+          String(this.#options.id),
+          this.#options.config.id,
+          event,
+          this.#logger,
+        );
+        return;
+      }
+      this.admit(event);
     }
   }
 

package/src/side-event-dispatch.ts

@@ -0,0 +1,54 @@
+import { buildNotice, mapNoticeParts, senderFromId, SLACK_NOTICE_PARTS_MAP } from '@zhin.js/core';
+import type { SideEventGateway } from '@zhin.js/core/runtime';
+import { formatCompact, type getAdapterLogger } from '@zhin.js/logger';
+import type { SlackEvent } from './protocol.js';
+
+export function receiveSlackSideEvent(
+  sideEvents: SideEventGateway | undefined,
+  endpointKey: string,
+  configId: string,
+  event: SlackEvent,
+  logger: ReturnType<typeof getAdapterLogger>,
+): void {
+  if (!sideEvents) return;
+  const eventType = String(event.type ?? '');
+  if (!Object.prototype.hasOwnProperty.call(SLACK_NOTICE_PARTS_MAP, eventType)) return;
+  const record = event as Record<string, unknown>;
+  const parts = mapNoticeParts('slack', eventType);
+  const channel = typeof record.channel === 'string' ? record.channel : undefined;
+  const user = typeof record.user === 'string' ? record.user : undefined;
+  const sceneId = channel ?? user ?? configId;
+  const dedupeKey = [
+    eventType,
+    channel ?? '',
+    user ?? '',
+    String(record.ts ?? record.event_ts ?? ''),
+  ].join(':');
+  void sideEvents.receiveNotice(buildNotice(record, {
+    $id: `slack:${dedupeKey}`,
+    $adapter: 'slack' as never,
+    $endpoint: configId,
+    $type: 'notice',
+    $scene_id: sceneId,
+    $scene_type: parts.scene_type,
+    $sub_type: parts.sub_type,
+    $actor: senderFromId(user),
+    $target: senderFromId(
+      typeof record.item_user === 'string' ? record.item_user : undefined,
+    ),
+    $timestamp: toMillis(record.event_ts ?? record.ts),
+  })).catch((err) => {
+    logger.warn(formatCompact({
+      op: 'slack_side_event_failed',
+      endpoint: configId,
+      event: eventType,
+      error: err instanceof Error ? err.message : String(err),
+    }));
+  });
+}
+
+function toMillis(time: unknown): number {
+  const value = Number(time);
+  if (!Number.isFinite(value) || value <= 0) return Date.now();
+  return value < 1e12 ? Math.round(value * 1000) : Math.round(value);
+}