@kodelyth/feishu 2026.5.42 → 2026.6.2

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 (192) hide show
  1. package/klaw.plugin.json +1712 -47
  2. package/package.json +19 -6
  3. package/api.ts +0 -32
  4. package/channel-entry.ts +0 -20
  5. package/channel-plugin-api.ts +0 -1
  6. package/contract-api.ts +0 -16
  7. package/index.ts +0 -82
  8. package/runtime-api.ts +0 -52
  9. package/secret-contract-api.ts +0 -5
  10. package/security-contract-api.ts +0 -1
  11. package/session-key-api.ts +0 -1
  12. package/setup-api.ts +0 -3
  13. package/setup-entry.test.ts +0 -19
  14. package/setup-entry.ts +0 -13
  15. package/src/accounts.test.ts +0 -480
  16. package/src/accounts.ts +0 -333
  17. package/src/agent-config.ts +0 -21
  18. package/src/app-registration.ts +0 -331
  19. package/src/approval-auth.test.ts +0 -24
  20. package/src/approval-auth.ts +0 -25
  21. package/src/async.test.ts +0 -35
  22. package/src/async.ts +0 -104
  23. package/src/audio-preflight.runtime.ts +0 -9
  24. package/src/bitable.test.ts +0 -136
  25. package/src/bitable.ts +0 -762
  26. package/src/bot-content.ts +0 -485
  27. package/src/bot-group-name.test.ts +0 -116
  28. package/src/bot-runtime-api.ts +0 -12
  29. package/src/bot-sender-name.ts +0 -125
  30. package/src/bot.broadcast.test.ts +0 -523
  31. package/src/bot.card-action.test.ts +0 -552
  32. package/src/bot.checkBotMentioned.test.ts +0 -265
  33. package/src/bot.helpers.test.ts +0 -135
  34. package/src/bot.stripBotMention.test.ts +0 -126
  35. package/src/bot.test.ts +0 -3671
  36. package/src/bot.ts +0 -1703
  37. package/src/card-action.ts +0 -447
  38. package/src/card-interaction.test.ts +0 -131
  39. package/src/card-interaction.ts +0 -159
  40. package/src/card-test-helpers.ts +0 -54
  41. package/src/card-ux-approval.ts +0 -65
  42. package/src/card-ux-launcher.test.ts +0 -106
  43. package/src/card-ux-launcher.ts +0 -121
  44. package/src/card-ux-shared.ts +0 -33
  45. package/src/channel-runtime-api.ts +0 -16
  46. package/src/channel.runtime.ts +0 -47
  47. package/src/channel.test.ts +0 -1151
  48. package/src/channel.ts +0 -1423
  49. package/src/chat-schema.ts +0 -25
  50. package/src/chat.test.ts +0 -240
  51. package/src/chat.ts +0 -188
  52. package/src/client-timeout.ts +0 -42
  53. package/src/client.test.ts +0 -447
  54. package/src/client.ts +0 -262
  55. package/src/comment-dispatcher-runtime-api.ts +0 -6
  56. package/src/comment-dispatcher.test.ts +0 -185
  57. package/src/comment-dispatcher.ts +0 -107
  58. package/src/comment-handler-runtime-api.ts +0 -3
  59. package/src/comment-handler.test.ts +0 -592
  60. package/src/comment-handler.ts +0 -303
  61. package/src/comment-reaction.test.ts +0 -138
  62. package/src/comment-reaction.ts +0 -259
  63. package/src/comment-shared.test.ts +0 -183
  64. package/src/comment-shared.ts +0 -406
  65. package/src/comment-target.ts +0 -44
  66. package/src/config-schema.test.ts +0 -326
  67. package/src/config-schema.ts +0 -335
  68. package/src/conversation-id.test.ts +0 -18
  69. package/src/conversation-id.ts +0 -199
  70. package/src/dedup-runtime-api.ts +0 -1
  71. package/src/dedup.ts +0 -141
  72. package/src/dedupe-key.ts +0 -72
  73. package/src/directory.static.ts +0 -61
  74. package/src/directory.test.ts +0 -141
  75. package/src/directory.ts +0 -124
  76. package/src/doc-schema.ts +0 -182
  77. package/src/docx-batch-insert.test.ts +0 -116
  78. package/src/docx-batch-insert.ts +0 -223
  79. package/src/docx-color-text.ts +0 -154
  80. package/src/docx-table-ops.test.ts +0 -53
  81. package/src/docx-table-ops.ts +0 -316
  82. package/src/docx-types.ts +0 -38
  83. package/src/docx.account-selection.test.ts +0 -95
  84. package/src/docx.test.ts +0 -701
  85. package/src/docx.ts +0 -1596
  86. package/src/drive-schema.ts +0 -92
  87. package/src/drive.test.ts +0 -1237
  88. package/src/drive.ts +0 -829
  89. package/src/dynamic-agent.test.ts +0 -155
  90. package/src/dynamic-agent.ts +0 -143
  91. package/src/event-types.ts +0 -45
  92. package/src/external-keys.test.ts +0 -20
  93. package/src/external-keys.ts +0 -19
  94. package/src/lifecycle.test-support.ts +0 -220
  95. package/src/media.test.ts +0 -955
  96. package/src/media.ts +0 -1105
  97. package/src/mention-target.types.ts +0 -5
  98. package/src/mention.ts +0 -114
  99. package/src/message-action-contract.ts +0 -13
  100. package/src/monitor-state-runtime-api.ts +0 -7
  101. package/src/monitor-transport-runtime-api.ts +0 -10
  102. package/src/monitor.account.ts +0 -492
  103. package/src/monitor.acp-init-failure.lifecycle.test-support.ts +0 -219
  104. package/src/monitor.bot-identity.ts +0 -86
  105. package/src/monitor.bot-menu-handler.ts +0 -165
  106. package/src/monitor.bot-menu.lifecycle.test-support.ts +0 -224
  107. package/src/monitor.bot-menu.test.ts +0 -188
  108. package/src/monitor.broadcast.reply-once.lifecycle.test-support.ts +0 -264
  109. package/src/monitor.card-action.lifecycle.test-support.ts +0 -421
  110. package/src/monitor.cleanup.test.ts +0 -383
  111. package/src/monitor.comment-notice-handler.ts +0 -105
  112. package/src/monitor.comment.test.ts +0 -967
  113. package/src/monitor.comment.ts +0 -1386
  114. package/src/monitor.lifecycle.test.ts +0 -4
  115. package/src/monitor.message-handler.ts +0 -350
  116. package/src/monitor.reaction.lifecycle.test-support.ts +0 -68
  117. package/src/monitor.reaction.test.ts +0 -739
  118. package/src/monitor.startup.test.ts +0 -213
  119. package/src/monitor.startup.ts +0 -74
  120. package/src/monitor.state.defaults.test.ts +0 -46
  121. package/src/monitor.state.ts +0 -170
  122. package/src/monitor.synthetic-error.ts +0 -18
  123. package/src/monitor.test-mocks.ts +0 -46
  124. package/src/monitor.transport.ts +0 -451
  125. package/src/monitor.ts +0 -100
  126. package/src/monitor.webhook-e2e.test.ts +0 -279
  127. package/src/monitor.webhook-security.test.ts +0 -389
  128. package/src/monitor.webhook.test-helpers.ts +0 -116
  129. package/src/outbound-runtime-api.ts +0 -1
  130. package/src/outbound.test.ts +0 -1118
  131. package/src/outbound.ts +0 -785
  132. package/src/perm-schema.ts +0 -52
  133. package/src/perm.ts +0 -170
  134. package/src/pins.ts +0 -108
  135. package/src/policy.test.ts +0 -223
  136. package/src/policy.ts +0 -318
  137. package/src/post.test.ts +0 -105
  138. package/src/post.ts +0 -275
  139. package/src/probe.test.ts +0 -283
  140. package/src/probe.ts +0 -166
  141. package/src/processing-claims.ts +0 -59
  142. package/src/qr-terminal.ts +0 -1
  143. package/src/reactions.ts +0 -123
  144. package/src/reasoning-preview.test.ts +0 -113
  145. package/src/reasoning-preview.ts +0 -28
  146. package/src/reply-dispatcher-runtime-api.ts +0 -7
  147. package/src/reply-dispatcher.test.ts +0 -1513
  148. package/src/reply-dispatcher.ts +0 -748
  149. package/src/runtime.ts +0 -9
  150. package/src/secret-contract.ts +0 -145
  151. package/src/secret-input.ts +0 -1
  152. package/src/security-audit-shared.ts +0 -69
  153. package/src/security-audit.test.ts +0 -59
  154. package/src/security-audit.ts +0 -1
  155. package/src/send-result.ts +0 -80
  156. package/src/send-target.test.ts +0 -86
  157. package/src/send-target.ts +0 -35
  158. package/src/send.reply-fallback.test.ts +0 -417
  159. package/src/send.test.ts +0 -621
  160. package/src/send.ts +0 -861
  161. package/src/sequential-key.test.ts +0 -72
  162. package/src/sequential-key.ts +0 -25
  163. package/src/sequential-queue.test.ts +0 -165
  164. package/src/sequential-queue.ts +0 -86
  165. package/src/session-conversation.ts +0 -42
  166. package/src/session-route.ts +0 -48
  167. package/src/setup-core.ts +0 -51
  168. package/src/setup-surface.test.ts +0 -484
  169. package/src/setup-surface.ts +0 -618
  170. package/src/streaming-card.test.ts +0 -397
  171. package/src/streaming-card.ts +0 -571
  172. package/src/subagent-hooks.test.ts +0 -627
  173. package/src/subagent-hooks.ts +0 -413
  174. package/src/targets.ts +0 -97
  175. package/src/test-support/lifecycle-test-support.ts +0 -454
  176. package/src/thread-bindings.test.ts +0 -180
  177. package/src/thread-bindings.ts +0 -331
  178. package/src/tool-account-routing.test.ts +0 -250
  179. package/src/tool-account.test.ts +0 -44
  180. package/src/tool-account.ts +0 -93
  181. package/src/tool-factory-test-harness.ts +0 -79
  182. package/src/tool-result.test.ts +0 -32
  183. package/src/tool-result.ts +0 -16
  184. package/src/tools-config.test.ts +0 -21
  185. package/src/tools-config.ts +0 -22
  186. package/src/types.ts +0 -106
  187. package/src/typing.test.ts +0 -144
  188. package/src/typing.ts +0 -214
  189. package/src/wiki-schema.ts +0 -69
  190. package/src/wiki.ts +0 -270
  191. package/subagent-hooks-api.ts +0 -31
  192. package/tsconfig.json +0 -16
@@ -1,397 +0,0 @@
1
- import { afterAll, afterEach, beforeEach, describe, expect, it, vi } from "vitest";
2
-
3
- const fetchWithSsrFGuardMock = vi.hoisted(() => vi.fn());
4
-
5
- vi.mock("klaw/plugin-sdk/ssrf-runtime", () => ({
6
- fetchWithSsrFGuard: fetchWithSsrFGuardMock,
7
- }));
8
-
9
- import {
10
- FeishuStreamingSession,
11
- mergeStreamingText,
12
- resolveStreamingCardSendMode,
13
- } from "./streaming-card.js";
14
-
15
- type StreamingSessionState = {
16
- cardId: string;
17
- messageId: string;
18
- sequence: number;
19
- currentText: string;
20
- sentText: string;
21
- hasNote: boolean;
22
- };
23
-
24
- function setStreamingSessionInternals(
25
- session: FeishuStreamingSession,
26
- values: {
27
- state: StreamingSessionState;
28
- lastUpdateTime?: number;
29
- },
30
- ): void {
31
- const internals = session as unknown as {
32
- state: StreamingSessionState;
33
- lastUpdateTime: number;
34
- };
35
- internals.state = values.state;
36
- if (values.lastUpdateTime !== undefined) {
37
- internals.lastUpdateTime = values.lastUpdateTime;
38
- }
39
- }
40
-
41
- describe("FeishuStreamingSession", () => {
42
- afterAll(() => {
43
- vi.doUnmock("klaw/plugin-sdk/ssrf-runtime");
44
- vi.resetModules();
45
- });
46
-
47
- beforeEach(() => {
48
- vi.useRealTimers();
49
- fetchWithSsrFGuardMock.mockReset();
50
- });
51
-
52
- afterEach(() => {
53
- vi.useRealTimers();
54
- });
55
-
56
- function mockFetches(
57
- updateBodies: string[],
58
- failedContentUpdateIndexes: ReadonlySet<number> = new Set<number>(),
59
- replaceBodies: string[] = [],
60
- failedContentUpdateStatuses: ReadonlyMap<number, number> = new Map<number, number>(),
61
- failedReplaceStatuses: ReadonlyMap<number, number> = new Map<number, number>(),
62
- ): void {
63
- fetchWithSsrFGuardMock.mockImplementation(
64
- async ({ url, init }: { url: string; init?: { body?: string } }) => {
65
- const release = vi.fn(async () => {});
66
- let ok = true;
67
- let status = 200;
68
- if (url.includes("/auth/")) {
69
- return {
70
- response: {
71
- ok: true,
72
- json: async () => ({
73
- code: 0,
74
- msg: "ok",
75
- tenant_access_token: "token",
76
- expire: 7200,
77
- }),
78
- },
79
- release,
80
- };
81
- }
82
- if (url.includes("/elements/content/content")) {
83
- const updateIndex = updateBodies.length;
84
- updateBodies.push(init?.body ?? "");
85
- if (failedContentUpdateIndexes.has(updateIndex)) {
86
- throw new Error(`content update ${updateIndex} failed`);
87
- }
88
- const failedStatus = failedContentUpdateStatuses.get(updateIndex);
89
- if (failedStatus !== undefined) {
90
- ok = false;
91
- status = failedStatus;
92
- }
93
- } else if (url.includes("/elements/content")) {
94
- const replaceIndex = replaceBodies.length;
95
- replaceBodies.push(init?.body ?? "");
96
- const failedStatus = failedReplaceStatuses.get(replaceIndex);
97
- if (failedStatus !== undefined) {
98
- ok = false;
99
- status = failedStatus;
100
- }
101
- }
102
- return {
103
- response: {
104
- ok,
105
- status,
106
- json: async () => ({ code: 0, msg: "ok" }),
107
- },
108
- release,
109
- };
110
- },
111
- );
112
- }
113
-
114
- it("flushes throttled pending text after the throttle window", async () => {
115
- vi.useFakeTimers();
116
- vi.setSystemTime(1_000);
117
- const updateBodies: string[] = [];
118
- mockFetches(updateBodies);
119
-
120
- const session = new FeishuStreamingSession({} as never, {
121
- appId: "app_pending_flush",
122
- appSecret: "secret",
123
- });
124
- setStreamingSessionInternals(session, {
125
- state: {
126
- cardId: "card_1",
127
- messageId: "om_1",
128
- sequence: 1,
129
- currentText: "hello",
130
- sentText: "hello",
131
- hasNote: false,
132
- },
133
- lastUpdateTime: 1_000,
134
- });
135
-
136
- await session.update("hello small");
137
- expect(updateBodies).toHaveLength(0);
138
-
139
- await vi.advanceTimersByTimeAsync(160);
140
-
141
- expect(updateBodies).toHaveLength(1);
142
- expect(JSON.parse(updateBodies[0] ?? "{}")).toEqual({
143
- content: " small",
144
- sequence: 2,
145
- uuid: "s_card_1_2",
146
- });
147
- });
148
-
149
- it("pushes natural-boundary updates immediately inside the throttle window", async () => {
150
- vi.useFakeTimers();
151
- vi.setSystemTime(2_000);
152
- const updateBodies: string[] = [];
153
- mockFetches(updateBodies);
154
-
155
- const session = new FeishuStreamingSession({} as never, {
156
- appId: "app_boundary_flush",
157
- appSecret: "secret",
158
- });
159
- setStreamingSessionInternals(session, {
160
- state: {
161
- cardId: "card_2",
162
- messageId: "om_2",
163
- sequence: 1,
164
- currentText: "hello",
165
- sentText: "hello",
166
- hasNote: false,
167
- },
168
- lastUpdateTime: 2_000,
169
- });
170
-
171
- await session.update("hello!");
172
-
173
- expect(updateBodies).toHaveLength(1);
174
- expect(JSON.parse(updateBodies[0] ?? "{}")).toEqual({
175
- content: "!",
176
- sequence: 2,
177
- uuid: "s_card_2_2",
178
- });
179
- });
180
-
181
- it("retries unsent suffix content after a failed delta update", async () => {
182
- vi.useFakeTimers();
183
- vi.setSystemTime(3_000);
184
- const updateBodies: string[] = [];
185
- mockFetches(updateBodies, new Set([0]));
186
-
187
- const session = new FeishuStreamingSession({} as never, {
188
- appId: "app_failed_delta_retry",
189
- appSecret: "secret",
190
- });
191
- setStreamingSessionInternals(session, {
192
- state: {
193
- cardId: "card_3",
194
- messageId: "om_3",
195
- sequence: 1,
196
- currentText: "hello",
197
- sentText: "hello",
198
- hasNote: false,
199
- },
200
- lastUpdateTime: 2_000,
201
- });
202
-
203
- await session.update("hello world");
204
- await session.update("hello world!");
205
-
206
- expect(updateBodies).toHaveLength(2);
207
- expect(JSON.parse(updateBodies[0] ?? "{}")).toEqual({
208
- content: " world",
209
- sequence: 2,
210
- uuid: "s_card_3_2",
211
- });
212
- expect(JSON.parse(updateBodies[1] ?? "{}")).toEqual({
213
- content: " world!",
214
- sequence: 3,
215
- uuid: "s_card_3_3",
216
- });
217
- });
218
-
219
- it("retries unsent suffix content after a non-OK delta update", async () => {
220
- vi.useFakeTimers();
221
- vi.setSystemTime(3_500);
222
- const updateBodies: string[] = [];
223
- mockFetches(updateBodies, new Set<number>(), [], new Map([[0, 429]]));
224
-
225
- const session = new FeishuStreamingSession({} as never, {
226
- appId: "app_non_ok_delta_retry",
227
- appSecret: "secret",
228
- });
229
- setStreamingSessionInternals(session, {
230
- state: {
231
- cardId: "card_5",
232
- messageId: "om_5",
233
- sequence: 1,
234
- currentText: "hello",
235
- sentText: "hello",
236
- hasNote: false,
237
- },
238
- lastUpdateTime: 2_000,
239
- });
240
-
241
- await session.update("hello world");
242
- await session.update("hello world!");
243
-
244
- expect(updateBodies).toHaveLength(2);
245
- expect(JSON.parse(updateBodies[0] ?? "{}")).toEqual({
246
- content: " world",
247
- sequence: 2,
248
- uuid: "s_card_5_2",
249
- });
250
- expect(JSON.parse(updateBodies[1] ?? "{}")).toEqual({
251
- content: " world!",
252
- sequence: 3,
253
- uuid: "s_card_5_3",
254
- });
255
- });
256
-
257
- it("replaces content when final text removes transient streamed status", async () => {
258
- vi.useFakeTimers();
259
- vi.setSystemTime(4_000);
260
- const updateBodies: string[] = [];
261
- const replaceBodies: string[] = [];
262
- mockFetches(updateBodies, new Set<number>(), replaceBodies);
263
-
264
- const session = new FeishuStreamingSession({} as never, {
265
- appId: "app_final_rewrite",
266
- appSecret: "secret",
267
- });
268
- setStreamingSessionInternals(session, {
269
- state: {
270
- cardId: "card_4",
271
- messageId: "om_4",
272
- sequence: 1,
273
- currentText: "🔎 Web Search\n\nfinal answer",
274
- sentText: "🔎 Web Search\n\nfinal answer",
275
- hasNote: false,
276
- },
277
- lastUpdateTime: 3_000,
278
- });
279
-
280
- await session.close("final answer");
281
-
282
- expect(updateBodies).toHaveLength(0);
283
- expect(replaceBodies).toHaveLength(1);
284
- const replacePayload = JSON.parse(replaceBodies[0] ?? "{}") as {
285
- element?: string;
286
- sequence?: number;
287
- uuid?: string;
288
- };
289
- expect({
290
- ...replacePayload,
291
- element: JSON.parse(replacePayload.element ?? "{}"),
292
- }).toEqual({
293
- element: {
294
- tag: "markdown",
295
- content: "final answer",
296
- element_id: "content",
297
- },
298
- sequence: 2,
299
- uuid: "r_card_4_2",
300
- });
301
- });
302
-
303
- it("logs a final replacement failure when CardKit returns non-OK", async () => {
304
- vi.useFakeTimers();
305
- vi.setSystemTime(4_500);
306
- const updateBodies: string[] = [];
307
- const replaceBodies: string[] = [];
308
- mockFetches(
309
- updateBodies,
310
- new Set<number>(),
311
- replaceBodies,
312
- new Map<number, number>(),
313
- new Map([[0, 500]]),
314
- );
315
- const log = vi.fn();
316
-
317
- const session = new FeishuStreamingSession(
318
- {} as never,
319
- {
320
- appId: "app_final_rewrite_non_ok",
321
- appSecret: "secret",
322
- },
323
- log,
324
- );
325
- setStreamingSessionInternals(session, {
326
- state: {
327
- cardId: "card_6",
328
- messageId: "om_6",
329
- sequence: 1,
330
- currentText: "working\n\nfinal answer",
331
- sentText: "working\n\nfinal answer",
332
- hasNote: false,
333
- },
334
- lastUpdateTime: 3_000,
335
- });
336
-
337
- await session.close("final answer");
338
-
339
- expect(updateBodies).toHaveLength(0);
340
- expect(replaceBodies).toHaveLength(1);
341
- expect(log).toHaveBeenCalledWith(
342
- "Final replace failed: Error: Replace card content failed with HTTP 500",
343
- );
344
- });
345
- });
346
-
347
- describe("mergeStreamingText", () => {
348
- it("prefers the latest full text when it already includes prior text", () => {
349
- expect(mergeStreamingText("hello", "hello world")).toBe("hello world");
350
- });
351
-
352
- it("keeps previous text when the next partial is empty or redundant", () => {
353
- expect(mergeStreamingText("hello", "")).toBe("hello");
354
- expect(mergeStreamingText("hello world", "hello")).toBe("hello world");
355
- });
356
-
357
- it("appends fragmented chunks without injecting newlines", () => {
358
- expect(mergeStreamingText("hello wor", "ld")).toBe("hello world");
359
- expect(mergeStreamingText("line1", "line2")).toBe("line1line2");
360
- });
361
-
362
- it("merges overlap between adjacent partial snapshots", () => {
363
- expect(mergeStreamingText("好的,让我", "让我再读取一遍")).toBe("好的,让我再读取一遍");
364
- expect(mergeStreamingText("revision_id: 552", "2,一点变化都没有")).toBe(
365
- "revision_id: 552,一点变化都没有",
366
- );
367
- expect(mergeStreamingText("abc", "cabc")).toBe("cabc");
368
- });
369
- });
370
-
371
- describe("resolveStreamingCardSendMode", () => {
372
- it("prefers message.reply when reply target and root id both exist", () => {
373
- expect(
374
- resolveStreamingCardSendMode({
375
- replyToMessageId: "om_parent",
376
- rootId: "om_topic_root",
377
- }),
378
- ).toBe("reply");
379
- });
380
-
381
- it("falls back to root create when reply target is absent", () => {
382
- expect(
383
- resolveStreamingCardSendMode({
384
- rootId: "om_topic_root",
385
- }),
386
- ).toBe("root_create");
387
- });
388
-
389
- it("uses create mode when no reply routing fields are provided", () => {
390
- expect(resolveStreamingCardSendMode()).toBe("create");
391
- expect(
392
- resolveStreamingCardSendMode({
393
- replyInThread: true,
394
- }),
395
- ).toBe("create");
396
- });
397
- });