@kodelyth/feishu 2026.5.39 → 2026.5.42

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 (238) hide show
  1. package/api.ts +32 -0
  2. package/channel-entry.ts +20 -0
  3. package/channel-plugin-api.ts +1 -0
  4. package/contract-api.ts +16 -0
  5. package/dist/accounts-D0ow-lRb.js +429 -0
  6. package/dist/api.js +2308 -0
  7. package/dist/app-registration-DBSnysKJ.js +184 -0
  8. package/dist/audio-preflight.runtime-Dpjbn-7r.js +7 -0
  9. package/dist/channel-13WQvQ0u.js +2115 -0
  10. package/dist/channel-entry.js +22 -0
  11. package/dist/channel-plugin-api.js +2 -0
  12. package/dist/channel.runtime-JMJonrJ4.js +729 -0
  13. package/dist/client-D1pzbBGo.js +157 -0
  14. package/dist/contract-api.js +9 -0
  15. package/dist/conversation-id-_58ecqlx.js +139 -0
  16. package/dist/drive-CgHOluXx.js +883 -0
  17. package/dist/index.js +68 -0
  18. package/dist/monitor-oWptK0zL.js +60 -0
  19. package/dist/monitor.account-DHaWlslg.js +5207 -0
  20. package/dist/monitor.state-C211a4tX.js +100 -0
  21. package/dist/probe-CF4duEpK.js +149 -0
  22. package/dist/rolldown-runtime-DUslC3ob.js +14 -0
  23. package/dist/runtime-DSh5rL_d.js +8 -0
  24. package/dist/runtime-api.js +14 -0
  25. package/dist/secret-contract-NSee-WzN.js +119 -0
  26. package/dist/secret-contract-api.js +2 -0
  27. package/dist/security-audit-DWVC0vSK.js +11 -0
  28. package/dist/security-audit-shared-Dpcwxeft.js +38 -0
  29. package/dist/security-contract-api.js +2 -0
  30. package/dist/send-DfZuV4Fi.js +1212 -0
  31. package/dist/session-conversation-Duaukbnl.js +27 -0
  32. package/dist/session-key-api.js +2 -0
  33. package/dist/setup-api.js +2 -0
  34. package/dist/setup-entry.js +15 -0
  35. package/dist/subagent-hooks-Dtegs0kh.js +235 -0
  36. package/dist/subagent-hooks-api.js +23 -0
  37. package/dist/targets-DFskxX4p.js +48 -0
  38. package/dist/thread-bindings-DI7lVSOE.js +222 -0
  39. package/index.ts +82 -0
  40. package/klaw.plugin.json +47 -1712
  41. package/package.json +4 -4
  42. package/runtime-api.ts +52 -0
  43. package/secret-contract-api.ts +5 -0
  44. package/security-contract-api.ts +1 -0
  45. package/session-key-api.ts +1 -0
  46. package/setup-api.ts +3 -0
  47. package/setup-entry.test.ts +19 -0
  48. package/setup-entry.ts +13 -0
  49. package/src/accounts.test.ts +480 -0
  50. package/src/accounts.ts +333 -0
  51. package/src/agent-config.ts +21 -0
  52. package/src/app-registration.ts +331 -0
  53. package/src/approval-auth.test.ts +24 -0
  54. package/src/approval-auth.ts +25 -0
  55. package/src/async.test.ts +35 -0
  56. package/src/async.ts +104 -0
  57. package/src/audio-preflight.runtime.ts +9 -0
  58. package/src/bitable.test.ts +136 -0
  59. package/src/bitable.ts +762 -0
  60. package/src/bot-content.ts +485 -0
  61. package/src/bot-group-name.test.ts +116 -0
  62. package/src/bot-runtime-api.ts +12 -0
  63. package/src/bot-sender-name.ts +125 -0
  64. package/src/bot.broadcast.test.ts +523 -0
  65. package/src/bot.card-action.test.ts +552 -0
  66. package/src/bot.checkBotMentioned.test.ts +265 -0
  67. package/src/bot.helpers.test.ts +135 -0
  68. package/src/bot.stripBotMention.test.ts +126 -0
  69. package/src/bot.test.ts +3671 -0
  70. package/src/bot.ts +1703 -0
  71. package/src/card-action.ts +447 -0
  72. package/src/card-interaction.test.ts +131 -0
  73. package/src/card-interaction.ts +159 -0
  74. package/src/card-test-helpers.ts +54 -0
  75. package/src/card-ux-approval.ts +65 -0
  76. package/src/card-ux-launcher.test.ts +106 -0
  77. package/src/card-ux-launcher.ts +121 -0
  78. package/src/card-ux-shared.ts +33 -0
  79. package/src/channel-runtime-api.ts +16 -0
  80. package/src/channel.runtime.ts +47 -0
  81. package/src/channel.test.ts +1151 -0
  82. package/src/channel.ts +1423 -0
  83. package/src/chat-schema.ts +25 -0
  84. package/src/chat.test.ts +240 -0
  85. package/src/chat.ts +188 -0
  86. package/src/client-timeout.ts +42 -0
  87. package/src/client.test.ts +447 -0
  88. package/src/client.ts +262 -0
  89. package/src/comment-dispatcher-runtime-api.ts +6 -0
  90. package/src/comment-dispatcher.test.ts +185 -0
  91. package/src/comment-dispatcher.ts +107 -0
  92. package/src/comment-handler-runtime-api.ts +3 -0
  93. package/src/comment-handler.test.ts +592 -0
  94. package/src/comment-handler.ts +303 -0
  95. package/src/comment-reaction.test.ts +138 -0
  96. package/src/comment-reaction.ts +259 -0
  97. package/src/comment-shared.test.ts +183 -0
  98. package/src/comment-shared.ts +406 -0
  99. package/src/comment-target.ts +44 -0
  100. package/src/config-schema.test.ts +326 -0
  101. package/src/config-schema.ts +335 -0
  102. package/src/conversation-id.test.ts +18 -0
  103. package/src/conversation-id.ts +199 -0
  104. package/src/dedup-runtime-api.ts +1 -0
  105. package/src/dedup.ts +141 -0
  106. package/src/dedupe-key.ts +72 -0
  107. package/src/directory.static.ts +61 -0
  108. package/src/directory.test.ts +141 -0
  109. package/src/directory.ts +124 -0
  110. package/src/doc-schema.ts +182 -0
  111. package/src/docx-batch-insert.test.ts +116 -0
  112. package/src/docx-batch-insert.ts +223 -0
  113. package/src/docx-color-text.ts +154 -0
  114. package/src/docx-table-ops.test.ts +53 -0
  115. package/src/docx-table-ops.ts +316 -0
  116. package/src/docx-types.ts +38 -0
  117. package/src/docx.account-selection.test.ts +95 -0
  118. package/src/docx.test.ts +701 -0
  119. package/src/docx.ts +1596 -0
  120. package/src/drive-schema.ts +92 -0
  121. package/src/drive.test.ts +1237 -0
  122. package/src/drive.ts +829 -0
  123. package/src/dynamic-agent.test.ts +155 -0
  124. package/src/dynamic-agent.ts +143 -0
  125. package/src/event-types.ts +45 -0
  126. package/src/external-keys.test.ts +20 -0
  127. package/src/external-keys.ts +19 -0
  128. package/src/lifecycle.test-support.ts +220 -0
  129. package/src/media.test.ts +955 -0
  130. package/src/media.ts +1105 -0
  131. package/src/mention-target.types.ts +5 -0
  132. package/src/mention.ts +114 -0
  133. package/src/message-action-contract.ts +13 -0
  134. package/src/monitor-state-runtime-api.ts +7 -0
  135. package/src/monitor-transport-runtime-api.ts +10 -0
  136. package/src/monitor.account.ts +492 -0
  137. package/src/monitor.acp-init-failure.lifecycle.test-support.ts +219 -0
  138. package/src/monitor.bot-identity.ts +86 -0
  139. package/src/monitor.bot-menu-handler.ts +165 -0
  140. package/src/monitor.bot-menu.lifecycle.test-support.ts +224 -0
  141. package/src/monitor.bot-menu.test.ts +188 -0
  142. package/src/monitor.broadcast.reply-once.lifecycle.test-support.ts +264 -0
  143. package/src/monitor.card-action.lifecycle.test-support.ts +421 -0
  144. package/src/monitor.cleanup.test.ts +383 -0
  145. package/src/monitor.comment-notice-handler.ts +105 -0
  146. package/src/monitor.comment.test.ts +967 -0
  147. package/src/monitor.comment.ts +1386 -0
  148. package/src/monitor.lifecycle.test.ts +4 -0
  149. package/src/monitor.message-handler.ts +350 -0
  150. package/src/monitor.reaction.lifecycle.test-support.ts +68 -0
  151. package/src/monitor.reaction.test.ts +739 -0
  152. package/src/monitor.startup.test.ts +213 -0
  153. package/src/monitor.startup.ts +74 -0
  154. package/src/monitor.state.defaults.test.ts +46 -0
  155. package/src/monitor.state.ts +170 -0
  156. package/src/monitor.synthetic-error.ts +18 -0
  157. package/src/monitor.test-mocks.ts +46 -0
  158. package/src/monitor.transport.ts +451 -0
  159. package/src/monitor.ts +100 -0
  160. package/src/monitor.webhook-e2e.test.ts +279 -0
  161. package/src/monitor.webhook-security.test.ts +389 -0
  162. package/src/monitor.webhook.test-helpers.ts +116 -0
  163. package/src/outbound-runtime-api.ts +1 -0
  164. package/src/outbound.test.ts +1118 -0
  165. package/src/outbound.ts +785 -0
  166. package/src/perm-schema.ts +52 -0
  167. package/src/perm.ts +170 -0
  168. package/src/pins.ts +108 -0
  169. package/src/policy.test.ts +223 -0
  170. package/src/policy.ts +318 -0
  171. package/src/post.test.ts +105 -0
  172. package/src/post.ts +275 -0
  173. package/src/probe.test.ts +283 -0
  174. package/src/probe.ts +166 -0
  175. package/src/processing-claims.ts +59 -0
  176. package/src/qr-terminal.ts +1 -0
  177. package/src/reactions.ts +123 -0
  178. package/src/reasoning-preview.test.ts +113 -0
  179. package/src/reasoning-preview.ts +28 -0
  180. package/src/reply-dispatcher-runtime-api.ts +7 -0
  181. package/src/reply-dispatcher.test.ts +1513 -0
  182. package/src/reply-dispatcher.ts +748 -0
  183. package/src/runtime.ts +9 -0
  184. package/src/secret-contract.ts +145 -0
  185. package/src/secret-input.ts +1 -0
  186. package/src/security-audit-shared.ts +69 -0
  187. package/src/security-audit.test.ts +59 -0
  188. package/src/security-audit.ts +1 -0
  189. package/src/send-result.ts +80 -0
  190. package/src/send-target.test.ts +86 -0
  191. package/src/send-target.ts +35 -0
  192. package/src/send.reply-fallback.test.ts +417 -0
  193. package/src/send.test.ts +621 -0
  194. package/src/send.ts +861 -0
  195. package/src/sequential-key.test.ts +72 -0
  196. package/src/sequential-key.ts +25 -0
  197. package/src/sequential-queue.test.ts +165 -0
  198. package/src/sequential-queue.ts +86 -0
  199. package/src/session-conversation.ts +42 -0
  200. package/src/session-route.ts +48 -0
  201. package/src/setup-core.ts +51 -0
  202. package/src/setup-surface.test.ts +484 -0
  203. package/src/setup-surface.ts +618 -0
  204. package/src/streaming-card.test.ts +397 -0
  205. package/src/streaming-card.ts +571 -0
  206. package/src/subagent-hooks.test.ts +627 -0
  207. package/src/subagent-hooks.ts +413 -0
  208. package/src/targets.ts +97 -0
  209. package/src/test-support/lifecycle-test-support.ts +454 -0
  210. package/src/thread-bindings.test.ts +180 -0
  211. package/src/thread-bindings.ts +331 -0
  212. package/src/tool-account-routing.test.ts +250 -0
  213. package/src/tool-account.test.ts +44 -0
  214. package/src/tool-account.ts +93 -0
  215. package/src/tool-factory-test-harness.ts +79 -0
  216. package/src/tool-result.test.ts +32 -0
  217. package/src/tool-result.ts +16 -0
  218. package/src/tools-config.test.ts +21 -0
  219. package/src/tools-config.ts +22 -0
  220. package/src/types.ts +106 -0
  221. package/src/typing.test.ts +144 -0
  222. package/src/typing.ts +214 -0
  223. package/src/wiki-schema.ts +69 -0
  224. package/src/wiki.ts +270 -0
  225. package/subagent-hooks-api.ts +31 -0
  226. package/tsconfig.json +16 -0
  227. package/api.js +0 -7
  228. package/channel-entry.js +0 -7
  229. package/channel-plugin-api.js +0 -7
  230. package/contract-api.js +0 -7
  231. package/index.js +0 -7
  232. package/runtime-api.js +0 -7
  233. package/secret-contract-api.js +0 -7
  234. package/security-contract-api.js +0 -7
  235. package/session-key-api.js +0 -7
  236. package/setup-api.js +0 -7
  237. package/setup-entry.js +0 -7
  238. package/subagent-hooks-api.js +0 -7
@@ -0,0 +1,27 @@
1
+ import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-_58ecqlx.js";
2
+ //#region extensions/feishu/src/session-conversation.ts
3
+ function resolveFeishuParentConversationCandidates(rawId) {
4
+ const parsed = parseFeishuConversationId({ conversationId: rawId });
5
+ if (!parsed) return [];
6
+ switch (parsed.scope) {
7
+ case "group_topic_sender": return [buildFeishuConversationId({
8
+ chatId: parsed.chatId,
9
+ scope: "group_topic",
10
+ topicId: parsed.topicId
11
+ }), parsed.chatId];
12
+ case "group_topic":
13
+ case "group_sender": return [parsed.chatId];
14
+ default: return [];
15
+ }
16
+ }
17
+ function resolveFeishuSessionConversation(params) {
18
+ const parsed = parseFeishuConversationId({ conversationId: params.rawId });
19
+ if (!parsed) return null;
20
+ return {
21
+ id: parsed.canonicalConversationId,
22
+ baseConversationId: parsed.chatId,
23
+ parentConversationCandidates: resolveFeishuParentConversationCandidates(parsed.canonicalConversationId)
24
+ };
25
+ }
26
+ //#endregion
27
+ export { resolveFeishuSessionConversation as t };
@@ -0,0 +1,2 @@
1
+ import { t as resolveFeishuSessionConversation } from "./session-conversation-Duaukbnl.js";
2
+ export { resolveFeishuSessionConversation as resolveSessionConversation };
@@ -0,0 +1,2 @@
1
+ import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-13WQvQ0u.js";
2
+ export { feishuPlugin, feishuSetupAdapter, feishuSetupWizard };
@@ -0,0 +1,15 @@
1
+ import { defineBundledChannelSetupEntry } from "klaw/plugin-sdk/channel-entry-contract";
2
+ //#region extensions/feishu/setup-entry.ts
3
+ var setup_entry_default = defineBundledChannelSetupEntry({
4
+ importMetaUrl: import.meta.url,
5
+ plugin: {
6
+ specifier: "./setup-api.js",
7
+ exportName: "feishuPlugin"
8
+ },
9
+ secrets: {
10
+ specifier: "./secret-contract-api.js",
11
+ exportName: "channelSecrets"
12
+ }
13
+ });
14
+ //#endregion
15
+ export { setup_entry_default as default };
@@ -0,0 +1,235 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
2
+ import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-_58ecqlx.js";
3
+ import { r as normalizeFeishuTarget } from "./targets-DFskxX4p.js";
4
+ import { n as getFeishuThreadBindingManager } from "./thread-bindings-DI7lVSOE.js";
5
+ import { normalizeOptionalLowercaseString, normalizeOptionalString } from "klaw/plugin-sdk/string-coerce-runtime";
6
+ //#region extensions/feishu/src/subagent-hooks.ts
7
+ var subagent_hooks_exports = /* @__PURE__ */ __exportAll({
8
+ handleFeishuSubagentDeliveryTarget: () => handleFeishuSubagentDeliveryTarget,
9
+ handleFeishuSubagentEnded: () => handleFeishuSubagentEnded,
10
+ handleFeishuSubagentSpawning: () => handleFeishuSubagentSpawning
11
+ });
12
+ function summarizeError(err) {
13
+ if (err instanceof Error) return err.message;
14
+ if (typeof err === "string") return err;
15
+ return "error";
16
+ }
17
+ function stripProviderPrefix(raw) {
18
+ return raw.replace(/^(feishu|lark):/i, "").trim();
19
+ }
20
+ function resolveFeishuRequesterConversation(params) {
21
+ const manager = getFeishuThreadBindingManager(params.accountId);
22
+ if (!manager) return null;
23
+ const rawTo = params.to?.trim();
24
+ const withoutProviderPrefix = rawTo ? stripProviderPrefix(rawTo) : "";
25
+ const normalizedTarget = rawTo ? normalizeFeishuTarget(rawTo) : null;
26
+ const threadId = params.threadId != null && params.threadId !== "" ? String(params.threadId).trim() : "";
27
+ const isChatTarget = /^(chat|group|channel):/i.test(withoutProviderPrefix);
28
+ const parsedRequesterTopic = normalizedTarget && threadId && isChatTarget ? parseFeishuConversationId({
29
+ conversationId: buildFeishuConversationId({
30
+ chatId: normalizedTarget,
31
+ scope: "group_topic",
32
+ topicId: threadId
33
+ }),
34
+ parentConversationId: normalizedTarget
35
+ }) : null;
36
+ const requesterSessionKey = params.requesterSessionKey?.trim();
37
+ if (requesterSessionKey) {
38
+ const existingBindings = manager.listBySessionKey(requesterSessionKey);
39
+ if (existingBindings.length === 1) {
40
+ const existing = existingBindings[0];
41
+ return {
42
+ accountId: existing.accountId,
43
+ conversationId: existing.conversationId,
44
+ parentConversationId: existing.parentConversationId
45
+ };
46
+ }
47
+ if (existingBindings.length > 1) {
48
+ if (rawTo && normalizedTarget && !threadId && !isChatTarget) {
49
+ const directMatches = existingBindings.filter((entry) => entry.accountId === manager.accountId && entry.conversationId === normalizedTarget && !entry.parentConversationId);
50
+ if (directMatches.length === 1) {
51
+ const existing = directMatches[0];
52
+ return {
53
+ accountId: existing.accountId,
54
+ conversationId: existing.conversationId,
55
+ parentConversationId: existing.parentConversationId
56
+ };
57
+ }
58
+ return null;
59
+ }
60
+ if (parsedRequesterTopic) {
61
+ const matchingTopicBindings = existingBindings.filter((entry) => {
62
+ const parsed = parseFeishuConversationId({
63
+ conversationId: entry.conversationId,
64
+ parentConversationId: entry.parentConversationId
65
+ });
66
+ return parsed?.chatId === parsedRequesterTopic.chatId && parsed?.topicId === parsedRequesterTopic.topicId;
67
+ });
68
+ if (matchingTopicBindings.length === 1) {
69
+ const existing = matchingTopicBindings[0];
70
+ return {
71
+ accountId: existing.accountId,
72
+ conversationId: existing.conversationId,
73
+ parentConversationId: existing.parentConversationId
74
+ };
75
+ }
76
+ const senderScopedTopicBindings = matchingTopicBindings.filter((entry) => {
77
+ return parseFeishuConversationId({
78
+ conversationId: entry.conversationId,
79
+ parentConversationId: entry.parentConversationId
80
+ })?.scope === "group_topic_sender";
81
+ });
82
+ if (senderScopedTopicBindings.length === 1 && matchingTopicBindings.length === senderScopedTopicBindings.length) {
83
+ const existing = senderScopedTopicBindings[0];
84
+ return {
85
+ accountId: existing.accountId,
86
+ conversationId: existing.conversationId,
87
+ parentConversationId: existing.parentConversationId
88
+ };
89
+ }
90
+ return null;
91
+ }
92
+ }
93
+ }
94
+ if (!rawTo) return null;
95
+ if (!normalizedTarget) return null;
96
+ if (threadId) {
97
+ if (!isChatTarget) return null;
98
+ return {
99
+ accountId: manager.accountId,
100
+ conversationId: buildFeishuConversationId({
101
+ chatId: normalizedTarget,
102
+ scope: "group_topic",
103
+ topicId: threadId
104
+ }),
105
+ parentConversationId: normalizedTarget
106
+ };
107
+ }
108
+ if (isChatTarget) return null;
109
+ return {
110
+ accountId: manager.accountId,
111
+ conversationId: normalizedTarget
112
+ };
113
+ }
114
+ function resolveFeishuDeliveryOrigin(params) {
115
+ const deliveryTo = params.deliveryTo?.trim();
116
+ const deliveryThreadId = params.deliveryThreadId?.trim();
117
+ if (deliveryTo) return {
118
+ channel: "feishu",
119
+ accountId: params.accountId,
120
+ to: deliveryTo,
121
+ ...deliveryThreadId ? { threadId: deliveryThreadId } : {}
122
+ };
123
+ const parsed = parseFeishuConversationId({
124
+ conversationId: params.conversationId,
125
+ parentConversationId: params.parentConversationId
126
+ });
127
+ if (parsed?.topicId) return {
128
+ channel: "feishu",
129
+ accountId: params.accountId,
130
+ to: `chat:${params.parentConversationId?.trim() || parsed.chatId}`,
131
+ threadId: parsed.topicId
132
+ };
133
+ return {
134
+ channel: "feishu",
135
+ accountId: params.accountId,
136
+ to: `user:${params.conversationId}`
137
+ };
138
+ }
139
+ function resolveMatchingChildBinding(params) {
140
+ const manager = getFeishuThreadBindingManager(params.accountId);
141
+ if (!manager) return null;
142
+ const childBindings = manager.listBySessionKey(params.childSessionKey.trim());
143
+ if (childBindings.length === 0) return null;
144
+ const requesterConversation = resolveFeishuRequesterConversation({
145
+ accountId: manager.accountId,
146
+ to: params.requesterOrigin?.to,
147
+ threadId: params.requesterOrigin?.threadId,
148
+ requesterSessionKey: params.requesterSessionKey
149
+ });
150
+ if (requesterConversation) {
151
+ const matched = childBindings.find((entry) => entry.accountId === requesterConversation.accountId && entry.conversationId === requesterConversation.conversationId && normalizeOptionalString(entry.parentConversationId) === normalizeOptionalString(requesterConversation.parentConversationId));
152
+ if (matched) return matched;
153
+ }
154
+ return childBindings.length === 1 ? childBindings[0] : null;
155
+ }
156
+ async function handleFeishuSubagentSpawning(event, ctx) {
157
+ if (!event.threadRequested) return;
158
+ if (normalizeOptionalLowercaseString(event.requester?.channel) !== "feishu") return;
159
+ const manager = getFeishuThreadBindingManager(event.requester?.accountId);
160
+ if (!manager) return {
161
+ status: "error",
162
+ error: "Feishu current-conversation binding is unavailable because the Feishu account monitor is not active."
163
+ };
164
+ const conversation = resolveFeishuRequesterConversation({
165
+ accountId: event.requester?.accountId,
166
+ to: event.requester?.to,
167
+ threadId: event.requester?.threadId,
168
+ requesterSessionKey: ctx.requesterSessionKey
169
+ });
170
+ if (!conversation) return {
171
+ status: "error",
172
+ error: "Feishu current-conversation binding is only available in direct messages or topic conversations."
173
+ };
174
+ try {
175
+ const binding = manager.bindConversation({
176
+ conversationId: conversation.conversationId,
177
+ parentConversationId: conversation.parentConversationId,
178
+ targetKind: "subagent",
179
+ targetSessionKey: event.childSessionKey,
180
+ metadata: {
181
+ agentId: event.agentId,
182
+ label: event.label,
183
+ boundBy: "system",
184
+ deliveryTo: event.requester?.to,
185
+ deliveryThreadId: event.requester?.threadId != null && event.requester.threadId !== "" ? String(event.requester.threadId) : void 0
186
+ }
187
+ });
188
+ if (!binding) return {
189
+ status: "error",
190
+ error: "Unable to bind this Feishu conversation to the spawned subagent session. Session mode is unavailable for this target."
191
+ };
192
+ return {
193
+ status: "ok",
194
+ threadBindingReady: true,
195
+ deliveryOrigin: resolveFeishuDeliveryOrigin({
196
+ conversationId: binding.conversationId,
197
+ parentConversationId: binding.parentConversationId,
198
+ accountId: binding.accountId,
199
+ deliveryTo: binding.deliveryTo,
200
+ deliveryThreadId: binding.deliveryThreadId
201
+ })
202
+ };
203
+ } catch (err) {
204
+ return {
205
+ status: "error",
206
+ error: `Feishu conversation bind failed: ${summarizeError(err)}`
207
+ };
208
+ }
209
+ }
210
+ function handleFeishuSubagentDeliveryTarget(event) {
211
+ if (!event.expectsCompletionMessage) return;
212
+ if (normalizeOptionalLowercaseString(event.requesterOrigin?.channel) !== "feishu") return;
213
+ const binding = resolveMatchingChildBinding({
214
+ accountId: event.requesterOrigin?.accountId,
215
+ childSessionKey: event.childSessionKey,
216
+ requesterSessionKey: event.requesterSessionKey,
217
+ requesterOrigin: {
218
+ to: event.requesterOrigin?.to,
219
+ threadId: event.requesterOrigin?.threadId
220
+ }
221
+ });
222
+ if (!binding) return;
223
+ return { origin: resolveFeishuDeliveryOrigin({
224
+ conversationId: binding.conversationId,
225
+ parentConversationId: binding.parentConversationId,
226
+ accountId: binding.accountId,
227
+ deliveryTo: binding.deliveryTo,
228
+ deliveryThreadId: binding.deliveryThreadId
229
+ }) };
230
+ }
231
+ function handleFeishuSubagentEnded(event) {
232
+ getFeishuThreadBindingManager(event.accountId)?.unbindBySessionKey(event.targetSessionKey);
233
+ }
234
+ //#endregion
235
+ export { subagent_hooks_exports as i, handleFeishuSubagentEnded as n, handleFeishuSubagentSpawning as r, handleFeishuSubagentDeliveryTarget as t };
@@ -0,0 +1,23 @@
1
+ import { n as handleFeishuSubagentEnded, r as handleFeishuSubagentSpawning, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-Dtegs0kh.js";
2
+ //#region extensions/feishu/subagent-hooks-api.ts
3
+ let feishuSubagentHooksPromise = null;
4
+ function loadFeishuSubagentHooksModule() {
5
+ feishuSubagentHooksPromise ??= import("./subagent-hooks-Dtegs0kh.js").then((n) => n.i);
6
+ return feishuSubagentHooksPromise;
7
+ }
8
+ function registerFeishuSubagentHooks(api) {
9
+ api.on("subagent_spawning", async (event, ctx) => {
10
+ const { handleFeishuSubagentSpawning } = await loadFeishuSubagentHooksModule();
11
+ return await handleFeishuSubagentSpawning(event, ctx);
12
+ });
13
+ api.on("subagent_delivery_target", async (event) => {
14
+ const { handleFeishuSubagentDeliveryTarget } = await loadFeishuSubagentHooksModule();
15
+ return handleFeishuSubagentDeliveryTarget(event);
16
+ });
17
+ api.on("subagent_ended", async (event) => {
18
+ const { handleFeishuSubagentEnded } = await loadFeishuSubagentHooksModule();
19
+ handleFeishuSubagentEnded(event);
20
+ });
21
+ }
22
+ //#endregion
23
+ export { handleFeishuSubagentDeliveryTarget, handleFeishuSubagentEnded, handleFeishuSubagentSpawning, registerFeishuSubagentHooks };
@@ -0,0 +1,48 @@
1
+ import { normalizeLowercaseStringOrEmpty } from "klaw/plugin-sdk/string-coerce-runtime";
2
+ //#region extensions/feishu/src/targets.ts
3
+ const CHAT_ID_PREFIX = "oc_";
4
+ const OPEN_ID_PREFIX = "ou_";
5
+ const USER_ID_REGEX = /^[a-zA-Z0-9_-]+$/;
6
+ function stripProviderPrefix(raw) {
7
+ return raw.replace(/^(feishu|lark):/i, "").trim();
8
+ }
9
+ function detectIdType(id) {
10
+ const trimmed = id.trim();
11
+ if (trimmed.startsWith(CHAT_ID_PREFIX)) return "chat_id";
12
+ if (trimmed.startsWith(OPEN_ID_PREFIX)) return "open_id";
13
+ if (USER_ID_REGEX.test(trimmed)) return "user_id";
14
+ return null;
15
+ }
16
+ function normalizeFeishuTarget(raw) {
17
+ const trimmed = raw.trim();
18
+ if (!trimmed) return null;
19
+ const withoutProvider = stripProviderPrefix(trimmed);
20
+ const lowered = normalizeLowercaseStringOrEmpty(withoutProvider);
21
+ if (lowered.startsWith("chat:")) return withoutProvider.slice(5).trim() || null;
22
+ if (lowered.startsWith("group:")) return withoutProvider.slice(6).trim() || null;
23
+ if (lowered.startsWith("channel:")) return withoutProvider.slice(8).trim() || null;
24
+ if (lowered.startsWith("user:")) return withoutProvider.slice(5).trim() || null;
25
+ if (lowered.startsWith("dm:")) return withoutProvider.slice(3).trim() || null;
26
+ if (lowered.startsWith("open_id:")) return withoutProvider.slice(8).trim() || null;
27
+ return withoutProvider;
28
+ }
29
+ function resolveReceiveIdType(id) {
30
+ const trimmed = id.trim();
31
+ const lowered = normalizeLowercaseStringOrEmpty(trimmed);
32
+ if (lowered.startsWith("chat:") || lowered.startsWith("group:") || lowered.startsWith("channel:")) return "chat_id";
33
+ if (lowered.startsWith("open_id:")) return "open_id";
34
+ if (lowered.startsWith("user:") || lowered.startsWith("dm:")) return trimmed.replace(/^(user|dm):/i, "").trim().startsWith(OPEN_ID_PREFIX) ? "open_id" : "user_id";
35
+ if (trimmed.startsWith(CHAT_ID_PREFIX)) return "chat_id";
36
+ if (trimmed.startsWith(OPEN_ID_PREFIX)) return "open_id";
37
+ return "user_id";
38
+ }
39
+ function looksLikeFeishuId(raw) {
40
+ const trimmed = stripProviderPrefix(raw.trim());
41
+ if (!trimmed) return false;
42
+ if (/^(chat|group|channel|user|dm|open_id):/i.test(trimmed)) return true;
43
+ if (trimmed.startsWith(CHAT_ID_PREFIX)) return true;
44
+ if (trimmed.startsWith(OPEN_ID_PREFIX)) return true;
45
+ return false;
46
+ }
47
+ //#endregion
48
+ export { resolveReceiveIdType as i, looksLikeFeishuId as n, normalizeFeishuTarget as r, detectIdType as t };
@@ -0,0 +1,222 @@
1
+ import { normalizeOptionalString } from "klaw/plugin-sdk/string-coerce-runtime";
2
+ import { registerSessionBindingAdapter, resolveThreadBindingConversationIdFromBindingId, resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel, unregisterSessionBindingAdapter } from "klaw/plugin-sdk/conversation-runtime";
3
+ import { normalizeAccountId, resolveAgentIdFromSessionKey } from "klaw/plugin-sdk/routing";
4
+ //#region extensions/feishu/src/thread-bindings.ts
5
+ const FEISHU_THREAD_BINDINGS_STATE_KEY = Symbol.for("klaw.feishuThreadBindingsState");
6
+ let state;
7
+ function getState() {
8
+ if (!state) {
9
+ const globalStore = globalThis;
10
+ state = globalStore[FEISHU_THREAD_BINDINGS_STATE_KEY] ?? {
11
+ managersByAccountId: /* @__PURE__ */ new Map(),
12
+ bindingsByAccountConversation: /* @__PURE__ */ new Map()
13
+ };
14
+ globalStore[FEISHU_THREAD_BINDINGS_STATE_KEY] = state;
15
+ }
16
+ return state;
17
+ }
18
+ function resolveBindingKey(params) {
19
+ return `${params.accountId}:${params.conversationId}`;
20
+ }
21
+ function toSessionBindingTargetKind(raw) {
22
+ return raw === "subagent" ? "subagent" : "session";
23
+ }
24
+ function toFeishuTargetKind(raw) {
25
+ return raw === "subagent" ? "subagent" : "acp";
26
+ }
27
+ function toSessionBindingRecord(record, defaults) {
28
+ const idleExpiresAt = defaults.idleTimeoutMs > 0 ? record.lastActivityAt + defaults.idleTimeoutMs : void 0;
29
+ const maxAgeExpiresAt = defaults.maxAgeMs > 0 ? record.boundAt + defaults.maxAgeMs : void 0;
30
+ const expiresAt = idleExpiresAt != null && maxAgeExpiresAt != null ? Math.min(idleExpiresAt, maxAgeExpiresAt) : idleExpiresAt ?? maxAgeExpiresAt;
31
+ return {
32
+ bindingId: resolveBindingKey({
33
+ accountId: record.accountId,
34
+ conversationId: record.conversationId
35
+ }),
36
+ targetSessionKey: record.targetSessionKey,
37
+ targetKind: toSessionBindingTargetKind(record.targetKind),
38
+ conversation: {
39
+ channel: "feishu",
40
+ accountId: record.accountId,
41
+ conversationId: record.conversationId,
42
+ parentConversationId: record.parentConversationId
43
+ },
44
+ status: "active",
45
+ boundAt: record.boundAt,
46
+ expiresAt,
47
+ metadata: {
48
+ agentId: record.agentId,
49
+ label: record.label,
50
+ boundBy: record.boundBy,
51
+ deliveryTo: record.deliveryTo,
52
+ deliveryThreadId: record.deliveryThreadId,
53
+ lastActivityAt: record.lastActivityAt,
54
+ idleTimeoutMs: defaults.idleTimeoutMs,
55
+ maxAgeMs: defaults.maxAgeMs
56
+ }
57
+ };
58
+ }
59
+ function createFeishuThreadBindingManager(params) {
60
+ const accountId = normalizeAccountId(params.accountId);
61
+ const existing = getState().managersByAccountId.get(accountId);
62
+ if (existing) return existing;
63
+ const idleTimeoutMs = resolveThreadBindingIdleTimeoutMsForChannel({
64
+ cfg: params.cfg,
65
+ channel: "feishu",
66
+ accountId
67
+ });
68
+ const maxAgeMs = resolveThreadBindingMaxAgeMsForChannel({
69
+ cfg: params.cfg,
70
+ channel: "feishu",
71
+ accountId
72
+ });
73
+ const manager = {
74
+ accountId,
75
+ getByConversationId: (conversationId) => getState().bindingsByAccountConversation.get(resolveBindingKey({
76
+ accountId,
77
+ conversationId
78
+ })),
79
+ listBySessionKey: (targetSessionKey) => [...getState().bindingsByAccountConversation.values()].filter((record) => record.accountId === accountId && record.targetSessionKey === targetSessionKey),
80
+ bindConversation: ({ conversationId, parentConversationId, targetKind, targetSessionKey, metadata }) => {
81
+ const normalizedConversationId = conversationId.trim();
82
+ const normalizedTargetSessionKey = targetSessionKey.trim();
83
+ if (!normalizedConversationId || !normalizedTargetSessionKey) return null;
84
+ const existing = getState().bindingsByAccountConversation.get(resolveBindingKey({
85
+ accountId,
86
+ conversationId: normalizedConversationId
87
+ }));
88
+ const now = Date.now();
89
+ const record = {
90
+ accountId,
91
+ conversationId: normalizedConversationId,
92
+ parentConversationId: normalizeOptionalString(parentConversationId) ?? existing?.parentConversationId,
93
+ deliveryTo: typeof metadata?.deliveryTo === "string" && metadata.deliveryTo.trim() ? metadata.deliveryTo.trim() : existing?.deliveryTo,
94
+ deliveryThreadId: typeof metadata?.deliveryThreadId === "string" && metadata.deliveryThreadId.trim() ? metadata.deliveryThreadId.trim() : existing?.deliveryThreadId,
95
+ targetKind: toFeishuTargetKind(targetKind),
96
+ targetSessionKey: normalizedTargetSessionKey,
97
+ agentId: typeof metadata?.agentId === "string" && metadata.agentId.trim() ? metadata.agentId.trim() : existing?.agentId ?? resolveAgentIdFromSessionKey(normalizedTargetSessionKey),
98
+ label: typeof metadata?.label === "string" && metadata.label.trim() ? metadata.label.trim() : existing?.label,
99
+ boundBy: typeof metadata?.boundBy === "string" && metadata.boundBy.trim() ? metadata.boundBy.trim() : existing?.boundBy,
100
+ boundAt: now,
101
+ lastActivityAt: now
102
+ };
103
+ getState().bindingsByAccountConversation.set(resolveBindingKey({
104
+ accountId,
105
+ conversationId: normalizedConversationId
106
+ }), record);
107
+ return record;
108
+ },
109
+ touchConversation: (conversationId, at = Date.now()) => {
110
+ const key = resolveBindingKey({
111
+ accountId,
112
+ conversationId
113
+ });
114
+ const existingRecord = getState().bindingsByAccountConversation.get(key);
115
+ if (!existingRecord) return null;
116
+ const updated = {
117
+ ...existingRecord,
118
+ lastActivityAt: at
119
+ };
120
+ getState().bindingsByAccountConversation.set(key, updated);
121
+ return updated;
122
+ },
123
+ unbindConversation: (conversationId) => {
124
+ const key = resolveBindingKey({
125
+ accountId,
126
+ conversationId
127
+ });
128
+ const existingRecord = getState().bindingsByAccountConversation.get(key);
129
+ if (!existingRecord) return null;
130
+ getState().bindingsByAccountConversation.delete(key);
131
+ return existingRecord;
132
+ },
133
+ unbindBySessionKey: (targetSessionKey) => {
134
+ const removed = [];
135
+ for (const record of getState().bindingsByAccountConversation.values()) {
136
+ if (record.accountId !== accountId || record.targetSessionKey !== targetSessionKey) continue;
137
+ getState().bindingsByAccountConversation.delete(resolveBindingKey({
138
+ accountId,
139
+ conversationId: record.conversationId
140
+ }));
141
+ removed.push(record);
142
+ }
143
+ return removed;
144
+ },
145
+ stop: () => {
146
+ for (const key of getState().bindingsByAccountConversation.keys()) if (key.startsWith(`${accountId}:`)) getState().bindingsByAccountConversation.delete(key);
147
+ getState().managersByAccountId.delete(accountId);
148
+ unregisterSessionBindingAdapter({
149
+ channel: "feishu",
150
+ accountId,
151
+ adapter: sessionBindingAdapter
152
+ });
153
+ }
154
+ };
155
+ const sessionBindingAdapter = {
156
+ channel: "feishu",
157
+ accountId,
158
+ capabilities: { placements: ["current"] },
159
+ bind: async (input) => {
160
+ if (input.conversation.channel !== "feishu" || input.placement === "child") return null;
161
+ const bound = manager.bindConversation({
162
+ conversationId: input.conversation.conversationId,
163
+ parentConversationId: input.conversation.parentConversationId,
164
+ targetKind: input.targetKind,
165
+ targetSessionKey: input.targetSessionKey,
166
+ metadata: input.metadata
167
+ });
168
+ return bound ? toSessionBindingRecord(bound, {
169
+ idleTimeoutMs,
170
+ maxAgeMs
171
+ }) : null;
172
+ },
173
+ listBySession: (targetSessionKey) => manager.listBySessionKey(targetSessionKey).map((entry) => toSessionBindingRecord(entry, {
174
+ idleTimeoutMs,
175
+ maxAgeMs
176
+ })),
177
+ resolveByConversation: (ref) => {
178
+ if (ref.channel !== "feishu") return null;
179
+ const found = manager.getByConversationId(ref.conversationId);
180
+ return found ? toSessionBindingRecord(found, {
181
+ idleTimeoutMs,
182
+ maxAgeMs
183
+ }) : null;
184
+ },
185
+ touch: (bindingId, at) => {
186
+ const conversationId = resolveThreadBindingConversationIdFromBindingId({
187
+ accountId,
188
+ bindingId
189
+ });
190
+ if (conversationId) manager.touchConversation(conversationId, at);
191
+ },
192
+ unbind: async (input) => {
193
+ if (input.targetSessionKey?.trim()) return manager.unbindBySessionKey(input.targetSessionKey.trim()).map((entry) => toSessionBindingRecord(entry, {
194
+ idleTimeoutMs,
195
+ maxAgeMs
196
+ }));
197
+ const conversationId = resolveThreadBindingConversationIdFromBindingId({
198
+ accountId,
199
+ bindingId: input.bindingId
200
+ });
201
+ if (!conversationId) return [];
202
+ const removed = manager.unbindConversation(conversationId);
203
+ return removed ? [toSessionBindingRecord(removed, {
204
+ idleTimeoutMs,
205
+ maxAgeMs
206
+ })] : [];
207
+ }
208
+ };
209
+ registerSessionBindingAdapter(sessionBindingAdapter);
210
+ getState().managersByAccountId.set(accountId, manager);
211
+ return manager;
212
+ }
213
+ function getFeishuThreadBindingManager(accountId) {
214
+ return getState().managersByAccountId.get(normalizeAccountId(accountId)) ?? null;
215
+ }
216
+ const testing = { resetFeishuThreadBindingsForTests() {
217
+ for (const manager of getState().managersByAccountId.values()) manager.stop();
218
+ getState().managersByAccountId.clear();
219
+ getState().bindingsByAccountConversation.clear();
220
+ } };
221
+ //#endregion
222
+ export { getFeishuThreadBindingManager as n, testing as r, createFeishuThreadBindingManager as t };
package/index.ts ADDED
@@ -0,0 +1,82 @@
1
+ import {
2
+ defineBundledChannelEntry,
3
+ loadBundledEntryExportSync,
4
+ } from "klaw/plugin-sdk/channel-entry-contract";
5
+ import type { KlawPluginApi } from "klaw/plugin-sdk/channel-entry-contract";
6
+ import { registerFeishuSubagentHooks } from "./subagent-hooks-api.js";
7
+
8
+ function registerFeishuDocTools(api: KlawPluginApi) {
9
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
10
+ specifier: "./api.js",
11
+ exportName: "registerFeishuDocTools",
12
+ });
13
+ register(api);
14
+ }
15
+
16
+ function registerFeishuChatTools(api: KlawPluginApi) {
17
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
18
+ specifier: "./api.js",
19
+ exportName: "registerFeishuChatTools",
20
+ });
21
+ register(api);
22
+ }
23
+
24
+ function registerFeishuWikiTools(api: KlawPluginApi) {
25
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
26
+ specifier: "./api.js",
27
+ exportName: "registerFeishuWikiTools",
28
+ });
29
+ register(api);
30
+ }
31
+
32
+ function registerFeishuDriveTools(api: KlawPluginApi) {
33
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
34
+ specifier: "./api.js",
35
+ exportName: "registerFeishuDriveTools",
36
+ });
37
+ register(api);
38
+ }
39
+
40
+ function registerFeishuPermTools(api: KlawPluginApi) {
41
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
42
+ specifier: "./api.js",
43
+ exportName: "registerFeishuPermTools",
44
+ });
45
+ register(api);
46
+ }
47
+
48
+ function registerFeishuBitableTools(api: KlawPluginApi) {
49
+ const register = loadBundledEntryExportSync<(api: KlawPluginApi) => void>(import.meta.url, {
50
+ specifier: "./api.js",
51
+ exportName: "registerFeishuBitableTools",
52
+ });
53
+ register(api);
54
+ }
55
+
56
+ export default defineBundledChannelEntry({
57
+ id: "feishu",
58
+ name: "Feishu",
59
+ description: "Feishu/Lark channel plugin",
60
+ importMetaUrl: import.meta.url,
61
+ plugin: {
62
+ specifier: "./channel-plugin-api.js",
63
+ exportName: "feishuPlugin",
64
+ },
65
+ secrets: {
66
+ specifier: "./secret-contract-api.js",
67
+ exportName: "channelSecrets",
68
+ },
69
+ runtime: {
70
+ specifier: "./runtime-api.js",
71
+ exportName: "setFeishuRuntime",
72
+ },
73
+ registerFull(api) {
74
+ registerFeishuSubagentHooks(api);
75
+ registerFeishuDocTools(api);
76
+ registerFeishuChatTools(api);
77
+ registerFeishuWikiTools(api);
78
+ registerFeishuDriveTools(api);
79
+ registerFeishuPermTools(api);
80
+ registerFeishuBitableTools(api);
81
+ },
82
+ });