@zhin.js/adapter-slack 4.0.0 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +207 -98
  3. package/{skills/slack → agent}/PERMITS.md +1 -1
  4. package/{skills/slack/SKILL.md → agent/skills/slack.md} +2 -0
  5. package/agent/tools/add_reaction.ts +26 -0
  6. package/agent/tools/archive_channel.ts +24 -0
  7. package/agent/tools/edit_message.ts +27 -0
  8. package/agent/tools/invite_to_channel.ts +26 -0
  9. package/agent/tools/pin_message.ts +26 -0
  10. package/agent/tools/remove_reaction.ts +26 -0
  11. package/agent/tools/set_purpose.ts +26 -0
  12. package/agent/tools/set_topic.ts +26 -0
  13. package/agent/tools/unarchive.ts +24 -0
  14. package/agent/tools/unpin_message.ts +26 -0
  15. package/agent/tools/user_info.ts +31 -0
  16. package/lib/agent/tools/add_reaction.js +21 -0
  17. package/lib/agent/tools/add_reaction.js.map +1 -0
  18. package/lib/agent/tools/archive_channel.js +21 -0
  19. package/lib/agent/tools/archive_channel.js.map +1 -0
  20. package/lib/agent/tools/edit_message.js +22 -0
  21. package/lib/agent/tools/edit_message.js.map +1 -0
  22. package/lib/agent/tools/invite_to_channel.js +22 -0
  23. package/lib/agent/tools/invite_to_channel.js.map +1 -0
  24. package/lib/agent/tools/pin_message.js +22 -0
  25. package/lib/agent/tools/pin_message.js.map +1 -0
  26. package/lib/agent/tools/remove_reaction.js +21 -0
  27. package/lib/agent/tools/remove_reaction.js.map +1 -0
  28. package/lib/agent/tools/set_purpose.js +22 -0
  29. package/lib/agent/tools/set_purpose.js.map +1 -0
  30. package/lib/agent/tools/set_topic.js +22 -0
  31. package/lib/agent/tools/set_topic.js.map +1 -0
  32. package/lib/agent/tools/unarchive.js +21 -0
  33. package/lib/agent/tools/unarchive.js.map +1 -0
  34. package/lib/agent/tools/unpin_message.js +22 -0
  35. package/lib/agent/tools/unpin_message.js.map +1 -0
  36. package/lib/agent/tools/user_info.js +28 -0
  37. package/lib/agent/tools/user_info.js.map +1 -0
  38. package/lib/{adapter.js → src/adapter.js} +23 -6
  39. package/lib/src/adapter.js.map +1 -0
  40. package/lib/src/endpoint.js +312 -0
  41. package/lib/src/endpoint.js.map +1 -0
  42. package/lib/src/event-dispatcher.js +233 -0
  43. package/lib/src/event-dispatcher.js.map +1 -0
  44. package/lib/src/index.js +51 -0
  45. package/lib/src/index.js.map +1 -0
  46. package/lib/src/markdown-to-mrkdwn.js +61 -0
  47. package/lib/src/markdown-to-mrkdwn.js.map +1 -0
  48. package/lib/src/mrkdwn-to-markdown.js +31 -0
  49. package/lib/src/mrkdwn-to-markdown.js.map +1 -0
  50. package/lib/{platform-permit.js → src/platform-permit.js} +5 -2
  51. package/lib/src/platform-permit.js.map +1 -0
  52. package/lib/src/segment-mapper.js +2 -0
  53. package/lib/src/segment-mapper.js.map +1 -0
  54. package/lib/src/signing.js +21 -0
  55. package/lib/src/signing.js.map +1 -0
  56. package/lib/src/slack-agent-deps.js +10 -0
  57. package/lib/src/slack-agent-deps.js.map +1 -0
  58. package/lib/src/slack-inbound-filter.js +47 -0
  59. package/lib/src/slack-inbound-filter.js.map +1 -0
  60. package/lib/src/slack-inbound.js +127 -0
  61. package/lib/src/slack-inbound.js.map +1 -0
  62. package/lib/src/slack-message-ref.js +18 -0
  63. package/lib/src/slack-message-ref.js.map +1 -0
  64. package/lib/src/slack-outbound.js +223 -0
  65. package/lib/src/slack-outbound.js.map +1 -0
  66. package/lib/src/slack-reaction.js +27 -0
  67. package/lib/src/slack-reaction.js.map +1 -0
  68. package/lib/src/slack-response-url.js +17 -0
  69. package/lib/src/slack-response-url.js.map +1 -0
  70. package/lib/src/slack-side-events.js +64 -0
  71. package/lib/src/slack-side-events.js.map +1 -0
  72. package/lib/src/transport-http.js +83 -0
  73. package/lib/src/transport-http.js.map +1 -0
  74. package/lib/src/transport-socket.js +68 -0
  75. package/lib/src/transport-socket.js.map +1 -0
  76. package/lib/src/types.js +5 -0
  77. package/lib/src/types.js.map +1 -0
  78. package/package.json +25 -7
  79. package/src/adapter.ts +32 -10
  80. package/src/endpoint.ts +209 -603
  81. package/src/event-dispatcher.ts +255 -0
  82. package/src/index.ts +31 -239
  83. package/src/markdown-to-mrkdwn.ts +58 -0
  84. package/src/mrkdwn-to-markdown.ts +29 -0
  85. package/src/platform-permit.ts +3 -4
  86. package/src/segment-mapper.ts +1 -0
  87. package/src/signing.ts +28 -0
  88. package/src/slack-agent-deps.ts +22 -0
  89. package/src/slack-inbound-filter.ts +60 -0
  90. package/src/slack-inbound.ts +140 -0
  91. package/src/slack-message-ref.ts +18 -0
  92. package/src/slack-outbound.ts +269 -0
  93. package/src/slack-reaction.ts +23 -0
  94. package/src/slack-response-url.ts +26 -0
  95. package/src/slack-side-events.ts +74 -0
  96. package/src/transport-http.ts +95 -0
  97. package/src/transport-socket.ts +77 -0
  98. package/src/types.ts +99 -4
  99. package/lib/adapter.d.ts +0 -18
  100. package/lib/adapter.d.ts.map +0 -1
  101. package/lib/adapter.js.map +0 -1
  102. package/lib/endpoint.d.ts +0 -108
  103. package/lib/endpoint.d.ts.map +0 -1
  104. package/lib/endpoint.js +0 -673
  105. package/lib/endpoint.js.map +0 -1
  106. package/lib/index.d.ts +0 -10
  107. package/lib/index.d.ts.map +0 -1
  108. package/lib/index.js +0 -252
  109. package/lib/index.js.map +0 -1
  110. package/lib/platform-permit.d.ts +0 -17
  111. package/lib/platform-permit.d.ts.map +0 -1
  112. package/lib/platform-permit.js.map +0 -1
  113. package/lib/types.d.ts +0 -17
  114. package/lib/types.d.ts.map +0 -1
  115. package/lib/types.js +0 -2
  116. package/lib/types.js.map +0 -1
@@ -0,0 +1,27 @@
1
+ /** 将 activity-feedback / 工具入参规范为 Slack reactions.add 的 name(不含冒号) */
2
+ const UNICODE_TO_SLACK = {
3
+ '⏳': 'hourglass_flowing_sand',
4
+ '✅': 'white_check_mark',
5
+ '❌': 'x',
6
+ '⏰': 'alarm_clock',
7
+ '🤔': 'thinking_face',
8
+ '👀': 'eyes',
9
+ };
10
+ export function normalizeSlackReactionName(emoji) {
11
+ const trimmed = emoji.trim();
12
+ if (!trimmed)
13
+ return 'hourglass_flowing_sand';
14
+ if (UNICODE_TO_SLACK[trimmed])
15
+ return UNICODE_TO_SLACK[trimmed];
16
+ if (trimmed.startsWith(':') && trimmed.endsWith(':') && trimmed.length > 2) {
17
+ return trimmed.slice(1, -1);
18
+ }
19
+ let start = 0;
20
+ let end = trimmed.length;
21
+ while (start < end && trimmed[start] === ':')
22
+ start++;
23
+ while (end > start && trimmed[end - 1] === ':')
24
+ end--;
25
+ return trimmed.slice(start, end);
26
+ }
27
+ //# sourceMappingURL=slack-reaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slack-reaction.js","sourceRoot":"","sources":["../../src/slack-reaction.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,gBAAgB,GAA2B;IAC/C,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,kBAAkB;IACvB,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,aAAa;IAClB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,wBAAwB,CAAC;IAC9C,IAAI,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAE,CAAC;IACjE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IACzB,OAAO,KAAK,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,CAAC;IACtD,OAAO,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,EAAE,CAAC;IACtD,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}
@@ -0,0 +1,17 @@
1
+ export function postSlackEphemeral(responseUrl, text, logger) {
2
+ if (!responseUrl?.trim())
3
+ return;
4
+ const body = JSON.stringify({
5
+ response_type: 'ephemeral',
6
+ text,
7
+ replace_original: false,
8
+ });
9
+ fetch(responseUrl, {
10
+ method: 'POST',
11
+ headers: { 'Content-Type': 'application/json' },
12
+ body,
13
+ }).catch((err) => {
14
+ logger?.debug(`Slack response_url failed: ${err instanceof Error ? err.message : String(err)}`);
15
+ });
16
+ }
17
+ //# sourceMappingURL=slack-response-url.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slack-response-url.js","sourceRoot":"","sources":["../../src/slack-response-url.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,IAAY,EACZ,MAAe;IAEf,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;QAAE,OAAO;IAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,aAAa,EAAE,WAAW;QAC1B,IAAI;QACJ,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;IAEH,KAAK,CAAC,WAAW,EAAE;QACjB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI;KACL,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,MAAM,EAAE,KAAK,CAAC,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Slack 事件 → zhin Notice 映射
3
+ */
4
+ import { mapNoticeParts, buildNotice, senderFromId } from 'zhin.js';
5
+ export function isSlackNoticeEvent(eventType) {
6
+ return SLACK_NOTICE_EVENT_TYPES.has(eventType);
7
+ }
8
+ const SLACK_NOTICE_EVENT_TYPES = new Set([
9
+ 'member_joined_channel',
10
+ 'member_left_channel',
11
+ 'reaction_added',
12
+ 'reaction_removed',
13
+ 'message_deleted',
14
+ 'channel_archive',
15
+ 'channel_unarchive',
16
+ 'channel_rename',
17
+ 'channel_created',
18
+ 'channel_deleted',
19
+ 'pin_added',
20
+ 'pin_removed',
21
+ 'app_home_opened',
22
+ 'team_join',
23
+ ]);
24
+ export function formatSlackNotice(event, endpointName) {
25
+ const eventType = event.type;
26
+ const { scene_type, sub_type } = mapNoticeParts('slack', eventType);
27
+ const channelId = resolveNoticeChannelId(event);
28
+ const ts = event.event_ts
29
+ ? parseFloat(event.event_ts) * 1000
30
+ : Date.now();
31
+ const actorId = event.user ?? event.inviter;
32
+ const targetId = event.item_user ??
33
+ event.user ??
34
+ undefined;
35
+ return buildNotice(event, {
36
+ $id: resolveSlackSideEventDedupeKey(event),
37
+ $adapter: 'slack',
38
+ $endpoint: endpointName,
39
+ $type: 'notice',
40
+ $scene_id: channelId,
41
+ $scene_type: scene_type,
42
+ $sub_type: sub_type,
43
+ $actor: senderFromId(actorId),
44
+ $target: actorId !== targetId ? senderFromId(targetId) : undefined,
45
+ $timestamp: ts,
46
+ });
47
+ }
48
+ export function resolveSlackSideEventDedupeKey(event) {
49
+ const ts = event.event_ts ?? event.ts ?? '';
50
+ const type = event.type;
51
+ const channel = event.channel ?? '';
52
+ const user = event.user ?? '';
53
+ return `slack:${ts}_${type}_${channel}_${user}`;
54
+ }
55
+ function resolveNoticeChannelId(event) {
56
+ if (event.channel)
57
+ return String(event.channel);
58
+ const item = event.item;
59
+ if (item?.channel)
60
+ return String(item.channel);
61
+ const channel = event.channel_id ?? event.channel?.id;
62
+ return channel ? String(channel) : '';
63
+ }
64
+ //# sourceMappingURL=slack-side-events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slack-side-events.js","sourceRoot":"","sources":["../../src/slack-side-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGpE,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,uBAAuB;IACvB,qBAAqB;IACrB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,YAAoB;IAEpB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ;QACvB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI;QACnC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAEf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,IAAK,KAAa,CAAC,OAAO,CAAC;IACrD,MAAM,QAAQ,GACX,KAAa,CAAC,SAAS;QACvB,KAAa,CAAC,IAAI;QACnB,SAAS,CAAC;IAEZ,OAAO,WAAW,CAAC,KAAK,EAAE;QACxB,GAAG,EAAE,8BAA8B,CAAC,KAAK,CAAC;QAC1C,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAClE,UAAU,EAAE,EAAE;KACf,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAiB;IAC9D,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,OAAO,SAAS,EAAE,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAiB;IAC/C,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAI,KAAa,CAAC,IAAI,CAAC;IACjC,IAAI,IAAI,EAAE,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAI,KAAa,CAAC,UAAU,IAAK,KAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACxE,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * HTTP 传输 — 在 zhin Router 上注册 /slack/events webhook
3
+ */
4
+ import { verifySlackSignature } from './signing.js';
5
+ export class SlackHttpTransport {
6
+ config;
7
+ dispatcher;
8
+ logger;
9
+ constructor(config, dispatcher, logger) {
10
+ this.config = config;
11
+ this.dispatcher = dispatcher;
12
+ this.logger = logger;
13
+ }
14
+ registerRoutes(router) {
15
+ const signingSecret = this.config.signingSecret;
16
+ router.post('/slack/events', async (ctx) => {
17
+ const rawBody = await this.getRawBody(ctx);
18
+ const timestamp = ctx.get?.('X-Slack-Request-Timestamp') ?? ctx.headers?.['x-slack-request-timestamp'] ?? '';
19
+ const signature = ctx.get?.('X-Slack-Signature') ?? ctx.headers?.['x-slack-signature'] ?? '';
20
+ if (!verifySlackSignature(signingSecret, rawBody, timestamp, signature)) {
21
+ ctx.status = 401;
22
+ ctx.body = 'Invalid signature';
23
+ return;
24
+ }
25
+ const contentType = ctx.get?.('content-type') ?? ctx.headers?.['content-type'] ?? '';
26
+ let body;
27
+ if (contentType.includes('application/x-www-form-urlencoded')) {
28
+ const params = new URLSearchParams(rawBody);
29
+ const payloadStr = params.get('payload');
30
+ if (payloadStr) {
31
+ body = JSON.parse(payloadStr);
32
+ ctx.status = 200;
33
+ ctx.body = '';
34
+ this.handleInteraction(body);
35
+ return;
36
+ }
37
+ body = Object.fromEntries(params);
38
+ if (body.command) {
39
+ ctx.status = 200;
40
+ ctx.body = '';
41
+ this.dispatcher.routeSlashCommand(body);
42
+ return;
43
+ }
44
+ }
45
+ else {
46
+ body = JSON.parse(rawBody);
47
+ }
48
+ const envelope = body;
49
+ if (envelope.type === 'url_verification') {
50
+ ctx.status = 200;
51
+ ctx.body = { challenge: envelope.challenge };
52
+ return;
53
+ }
54
+ if (envelope.type === 'event_callback' && envelope.event) {
55
+ ctx.status = 200;
56
+ ctx.body = '';
57
+ this.dispatcher.routeEvent(envelope.event);
58
+ return;
59
+ }
60
+ ctx.status = 200;
61
+ ctx.body = '';
62
+ });
63
+ }
64
+ async getRawBody(ctx) {
65
+ if (ctx.request?.rawBody)
66
+ return ctx.request.rawBody;
67
+ if (typeof ctx.request?.body === 'string')
68
+ return ctx.request.body;
69
+ if (ctx.req) {
70
+ return new Promise((resolve, reject) => {
71
+ let data = '';
72
+ ctx.req.on('data', (chunk) => { data += chunk.toString(); });
73
+ ctx.req.on('end', () => resolve(data));
74
+ ctx.req.on('error', reject);
75
+ });
76
+ }
77
+ return JSON.stringify(ctx.request?.body ?? {});
78
+ }
79
+ handleInteraction(payload) {
80
+ this.dispatcher.routeInteraction(payload);
81
+ }
82
+ }
83
+ //# sourceMappingURL=transport-http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport-http.js","sourceRoot":"","sources":["../../src/transport-http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Socket Mode 传输 — 包装 @slack/socket-mode SocketModeClient
3
+ */
4
+ import { SocketModeClient } from '@slack/socket-mode';
5
+ export class SlackSocketTransport {
6
+ config;
7
+ dispatcher;
8
+ logger;
9
+ socketClient;
10
+ connected = false;
11
+ constructor(config, dispatcher, logger) {
12
+ this.config = config;
13
+ this.dispatcher = dispatcher;
14
+ this.logger = logger;
15
+ if (!config.appToken) {
16
+ throw new Error('Socket Mode requires appToken (xapp-...)');
17
+ }
18
+ this.socketClient = new SocketModeClient({
19
+ appToken: config.appToken,
20
+ clientPingTimeout: config.clientPingTimeout ?? 15_000,
21
+ });
22
+ }
23
+ async connect() {
24
+ this.socketClient.on('slack_event', async ({ ack, body }) => {
25
+ await ack();
26
+ this.handleEnvelope(body);
27
+ });
28
+ this.socketClient.on('interactive', async ({ ack, body }) => {
29
+ await ack();
30
+ this.handleInteraction(body);
31
+ });
32
+ this.socketClient.on('slash_commands', async ({ ack, body }) => {
33
+ await ack();
34
+ this.handleSlashCommand(body);
35
+ });
36
+ await this.socketClient.start();
37
+ this.connected = true;
38
+ }
39
+ async disconnect() {
40
+ if (!this.connected)
41
+ return;
42
+ try {
43
+ await this.socketClient.disconnect();
44
+ }
45
+ catch { /* ignore */ }
46
+ this.connected = false;
47
+ }
48
+ get isConnected() { return this.connected; }
49
+ handleEnvelope(body) {
50
+ const envelope = body;
51
+ if (envelope?.type === 'event_callback' && envelope.event) {
52
+ this.dispatcher.routeEvent(envelope.event);
53
+ }
54
+ }
55
+ handleInteraction(body) {
56
+ const payload = body;
57
+ if (payload?.type) {
58
+ this.dispatcher.routeInteraction(payload);
59
+ }
60
+ }
61
+ handleSlashCommand(body) {
62
+ const cmd = body;
63
+ if (cmd?.command) {
64
+ this.dispatcher.routeSlashCommand(cmd);
65
+ }
66
+ }
67
+ }
68
+ //# sourceMappingURL=transport-socket.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport-socket.js","sourceRoot":"","sources":["../../src/transport-socket.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,OAAO,oBAAoB;IAKrB;IACA;IACA;IANF,YAAY,CAAmB;IAC/B,SAAS,GAAG,KAAK,CAAC;IAE1B,YACU,MAA2B,EAC3B,UAAgC,EAChC,MAAc;QAFd,WAAM,GAAN,MAAM,CAAqB;QAC3B,eAAU,GAAV,UAAU,CAAsB;QAChC,WAAM,GAAN,MAAM,CAAQ;QAEtB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,gBAAgB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,MAAM;SACtD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;YAC1D,MAAM,GAAG,EAAE,CAAC;YACZ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;YAC1D,MAAM,GAAG,EAAE,CAAC;YACZ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;YAC7D,MAAM,GAAG,EAAE,CAAC;YACZ,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,IAAI,WAAW,KAAc,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7C,cAAc,CAAC,IAAa;QAClC,MAAM,QAAQ,GAAG,IAA0B,CAAC;QAC5C,IAAI,QAAQ,EAAE,IAAI,KAAK,gBAAgB,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,IAAa;QACrC,MAAM,OAAO,GAAG,IAA+B,CAAC;QAChD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,IAAa;QACtC,MAAM,GAAG,GAAG,IAAyB,CAAC;QACtC,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Slack 适配器类型定义
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zhin.js/adapter-slack",
3
- "version": "4.0.0",
3
+ "version": "4.1.0",
4
4
  "description": "Zhin.js adapter for Slack",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
@@ -32,23 +32,41 @@
32
32
  "directory": "plugins/adapters/slack"
33
33
  },
34
34
  "dependencies": {
35
- "@slack/bolt": "^4.7.3",
36
- "@slack/web-api": "^7.17.0"
35
+ "@slack/socket-mode": "^2.0.3",
36
+ "@slack/web-api": "^7.17.0",
37
+ "@zhin.js/logger": "1.0.74"
37
38
  },
38
39
  "devDependencies": {
39
- "@types/node": "^25.9.2",
40
+ "@types/node": "^26.1.0",
40
41
  "typescript": "^6.0.3",
41
- "zhin.js": "4.1.0"
42
+ "zod": "^4.4.3",
43
+ "@zhin.js/host-router": "2.0.3",
44
+ "zhin.js": "4.1.2",
45
+ "@zhin.js/agent": "1.0.3"
42
46
  },
43
47
  "peerDependencies": {
44
- "zhin.js": "4.1.0"
48
+ "zod": "^4.0.0",
49
+ "zhin.js": "4.1.2",
50
+ "@zhin.js/agent": "1.0.3",
51
+ "@zhin.js/host-router": "2.0.3"
52
+ },
53
+ "peerDependenciesMeta": {
54
+ "@zhin.js/host-router": {
55
+ "optional": true
56
+ },
57
+ "@zhin.js/agent": {
58
+ "optional": true
59
+ },
60
+ "zod": {
61
+ "optional": true
62
+ }
45
63
  },
46
64
  "files": [
47
65
  "src",
48
66
  "lib",
67
+ "agent",
49
68
  "client",
50
69
  "dist",
51
- "skills",
52
70
  "plugin.yml",
53
71
  "README.md",
54
72
  "CHANGELOG.md"
package/src/adapter.ts CHANGED
@@ -1,32 +1,55 @@
1
1
  /**
2
2
  * Slack 适配器
3
3
  */
4
- import { Adapter,
5
- Plugin, OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL } from 'zhin.js';
6
- import { SlackEndpoint } from "./endpoint.js";
7
- import type { SlackEndpointConfig } from "./types.js";
4
+ import { Adapter, Plugin, OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL, type EditMessageOptions } from 'zhin.js';
5
+ import { SlackEndpoint } from './endpoint.js';
6
+ import type { SlackEndpointConfig } from './types.js';
8
7
 
9
8
  export class SlackAdapter extends Adapter<SlackEndpoint> {
10
9
  static override readonly capabilities = ['inbound', 'outbound'] as const;
11
10
  static override outboundRichSegmentPolicy = OUTBOUND_RICH_SEGMENT_POLICY_IM_FULL;
11
+ static override interactivePolicy = 'native' as const;
12
12
 
13
13
  constructor(plugin: Plugin) {
14
- super(plugin, "slack", []);
14
+ super(plugin, 'slack', []);
15
15
  }
16
16
 
17
17
  createEndpoint(config: SlackEndpointConfig): SlackEndpoint {
18
18
  return new SlackEndpoint(this, config);
19
19
  }
20
20
 
21
- // ── IGroupManagement 标准群管方法 ──────────────────────────────────
21
+ async editMessage(options: EditMessageOptions): Promise<string>;
22
+ async editMessage(endpointId: string, channel: string, messageId: string, content: EditMessageOptions['content']): Promise<void>;
23
+ async editMessage(
24
+ arg1: EditMessageOptions | string,
25
+ channel?: string,
26
+ messageId?: string,
27
+ content?: EditMessageOptions['content'],
28
+ ): Promise<string | void> {
29
+ if (typeof arg1 === 'object') {
30
+ return super.editMessage(arg1);
31
+ }
32
+ const endpoint = this.endpoints.get(arg1);
33
+ if (!endpoint) throw new Error(`Endpoint ${arg1} 不存在`);
34
+ await endpoint.$editMessage({
35
+ messageId: messageId!,
36
+ context: 'slack',
37
+ endpoint: arg1,
38
+ id: channel!,
39
+ type: 'group',
40
+ content: content!,
41
+ });
42
+ }
43
+
44
+ // ── ISceneManagement 标准群管方法 ──────────────────────────────────
22
45
 
23
- async kickMember(endpointId: string, sceneId: string, userId: string) {
46
+ async removeMember(endpointId: string, sceneId: string, userId: string) {
24
47
  const endpoint = this.endpoints.get(endpointId);
25
48
  if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
26
49
  return endpoint.kickFromChannel(sceneId, userId);
27
50
  }
28
51
 
29
- async setGroupName(endpointId: string, sceneId: string, name: string) {
52
+ async renameScene(endpointId: string, sceneId: string, name: string) {
30
53
  const endpoint = this.endpoints.get(endpointId);
31
54
  if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
32
55
  return endpoint.renameChannel(sceneId, name);
@@ -38,7 +61,7 @@ export class SlackAdapter extends Adapter<SlackEndpoint> {
38
61
  return endpoint.getChannelMembers(sceneId);
39
62
  }
40
63
 
41
- async getGroupInfo(endpointId: string, sceneId: string) {
64
+ async getSceneInfo(endpointId: string, sceneId: string) {
42
65
  const endpoint = this.endpoints.get(endpointId);
43
66
  if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
44
67
  return endpoint.getChannelInfo(sceneId);
@@ -49,5 +72,4 @@ export class SlackAdapter extends Adapter<SlackEndpoint> {
49
72
  async start(): Promise<void> {
50
73
  await super.start();
51
74
  }
52
-
53
75
  }