eve 0.86.0 → 0.88.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 (282) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +1 -1
  3. package/dist/src/acp/adapter.d.ts +2 -26
  4. package/dist/src/acp/adapter.js +1 -1
  5. package/dist/src/acp/server.d.ts +0 -3
  6. package/dist/src/ai/decision-adapter.d.ts +5 -3
  7. package/dist/src/ai/decision-adapter.js +1 -1
  8. package/dist/src/ai/decision-types.d.ts +4 -3
  9. package/dist/src/channel/adapter.d.ts +0 -14
  10. package/dist/src/channel/auth/definitions.d.ts +0 -4
  11. package/dist/src/channel/channel-address.d.ts +1 -1
  12. package/dist/src/channel/channel-address.js +1 -1
  13. package/dist/src/channel/channel-operations.d.ts +2 -2
  14. package/dist/src/channel/channel-operations.js +1 -1
  15. package/dist/src/channel/prompt-queue.d.ts +0 -2
  16. package/dist/src/channel/session-not-active-error.d.ts +10 -5
  17. package/dist/src/channel/session-not-active-error.js +1 -1
  18. package/dist/src/channel/session-stranded-error.d.ts +1 -1
  19. package/dist/src/channel/session.d.ts +3 -4
  20. package/dist/src/channel/session.js +1 -1
  21. package/dist/src/channel/types.d.ts +5 -14
  22. package/dist/src/chunks/{use-eve-agent-B2jCfcnG.js → use-eve-agent-BExXjBv6.js} +82 -72
  23. package/dist/src/chunks/{use-eve-agent-DCLFi26P.js → use-eve-agent-C0KHCyb9.js} +82 -72
  24. package/dist/src/cli/dev/command-options.d.ts +4 -4
  25. package/dist/src/cli/dev/command.js +1 -1
  26. package/dist/src/cli/dev/tui/runner.js +1 -1
  27. package/dist/src/cli/dev/tui/test/fake-eve-server.js +1 -1
  28. package/dist/src/cli/dev/tui/tool-format.d.ts +2 -2
  29. package/dist/src/cli/dev/ui-options.d.ts +4 -4
  30. package/dist/src/cli/dev/ui-options.js +1 -1
  31. package/dist/src/client/agent-info-error.d.ts +4 -1
  32. package/dist/src/client/agent-info-error.js +1 -1
  33. package/dist/src/client/agent-session.d.ts +1 -4
  34. package/dist/src/client/agent-session.js +1 -1
  35. package/dist/src/client/agent-stream-follower.js +1 -1
  36. package/dist/src/client/client-error.d.ts +13 -4
  37. package/dist/src/client/client-error.js +1 -1
  38. package/dist/src/client/delivery.d.ts +2 -17
  39. package/dist/src/client/health-response-error.d.ts +4 -1
  40. package/dist/src/client/health-response-error.js +1 -1
  41. package/dist/src/client/index.d.ts +5 -3
  42. package/dist/src/client/index.js +1 -1
  43. package/dist/src/client/open-stream.d.ts +7 -12
  44. package/dist/src/client/open-stream.js +1 -1
  45. package/dist/src/client/session-controls.d.ts +2 -2
  46. package/dist/src/client/session-controls.js +1 -1
  47. package/dist/src/client/session-event-stream.d.ts +2 -2
  48. package/dist/src/client/session-event-stream.js +1 -1
  49. package/dist/src/client/session-store.d.ts +2 -6
  50. package/dist/src/client/session-store.js +1 -1
  51. package/dist/src/client/session.d.ts +4 -13
  52. package/dist/src/client/session.js +1 -1
  53. package/dist/src/client/sessions.d.ts +3 -6
  54. package/dist/src/client/types.d.ts +23 -32
  55. package/dist/src/compiled/.vendor-stamp.json +3 -3
  56. package/dist/src/compiled/@vercel/agent-runs/LICENSE +202 -0
  57. package/dist/src/compiler/manifest.js +1 -1
  58. package/dist/src/compiler/normalize-agent-config.js +1 -1
  59. package/dist/src/compiler/normalize-connection.d.ts +1 -1
  60. package/dist/src/compiler/normalize-connection.js +1 -1
  61. package/dist/src/compiler/normalize-instructions.js +1 -1
  62. package/dist/src/compiler/normalize-skill.js +1 -1
  63. package/dist/src/compiler/resolve-workspace-subagent.js +1 -1
  64. package/dist/src/context/memory-tools.d.ts +9 -5
  65. package/dist/src/discover/sandbox.js +1 -1
  66. package/dist/src/dynamic/definition.d.ts +11 -5
  67. package/dist/src/dynamic/definition.js +1 -1
  68. package/dist/src/evals/mock-model.d.ts +1 -1
  69. package/dist/src/evals/session-manager.d.ts +0 -2
  70. package/dist/src/evals/session.d.ts +1 -11
  71. package/dist/src/evals/session.js +1 -1
  72. package/dist/src/eve-channel/index.js +1 -1
  73. package/dist/src/eve-channel/support.js +1 -1
  74. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  75. package/dist/src/execution/effective-agent-config.js +1 -1
  76. package/dist/src/execution/sandbox/bindings/just-bash-runtime.d.ts +1 -2
  77. package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
  78. package/dist/src/execution/sandbox/bindings/just-bash.js +1 -1
  79. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  80. package/dist/src/extensions/git/extension/extension.d.ts +5 -2
  81. package/dist/src/extensions/git/extension/extension.js +1 -1
  82. package/dist/src/extensions/git/extension/instructions/github.js +1 -1
  83. package/dist/src/extensions/git/extension/lib/connect-user-auth.d.ts +15 -0
  84. package/dist/src/extensions/git/extension/lib/connect-user-auth.js +1 -0
  85. package/dist/src/extensions/git/extension/lib/gh-tool.d.ts +8 -1
  86. package/dist/src/extensions/git/extension/lib/gh-tool.js +1 -1
  87. package/dist/src/extensions/git/extension/lib/github-guidance.d.ts +2 -1
  88. package/dist/src/extensions/git/extension/lib/github-guidance.js +14 -1
  89. package/dist/src/extensions/git/extension/lib/github-shell.d.ts +12 -4
  90. package/dist/src/extensions/git/extension/lib/github-shell.js +1 -1
  91. package/dist/src/instrumentation/ai-sdk-telemetry.d.ts +0 -2
  92. package/dist/src/instrumentation/providers.d.ts +1 -38
  93. package/dist/src/instrumentation/providers.js +1 -1
  94. package/dist/src/instrumentation/setup-context.d.ts +1 -7
  95. package/dist/src/internal/application/package.d.ts +1 -0
  96. package/dist/src/internal/application/package.js +1 -1
  97. package/dist/src/internal/application/stamped-package-version.js +1 -1
  98. package/dist/src/internal/authored-definition/core.js +1 -1
  99. package/dist/src/internal/authored-definition/schema-backed.js +1 -1
  100. package/dist/src/internal/classify-model-routing.d.ts +2 -3
  101. package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
  102. package/dist/src/internal/runtime-model.d.ts +9 -4
  103. package/dist/src/internal/runtime-model.js +1 -1
  104. package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
  105. package/dist/src/internal/workflow-bundle/builder-support.d.ts +1 -1
  106. package/dist/src/internal/workflow-bundle/builder-support.js +1 -1
  107. package/dist/src/internal/workflow-bundle/workflow-transformer.js +1 -1
  108. package/dist/src/models/auto.js +1 -1
  109. package/dist/src/protocol/delivery.d.ts +1 -0
  110. package/dist/src/protocol/reset-session.d.ts +0 -2
  111. package/dist/src/protocol/routes.d.ts +9 -2
  112. package/dist/src/protocol/routes.js +1 -1
  113. package/dist/src/public/channels/chat-sdk/chatSdkChannel.d.ts +1 -22
  114. package/dist/src/public/channels/discord/discordChannel.d.ts +3 -12
  115. package/dist/src/public/channels/discord/gateway/{index.d.ts → relay.d.ts} +2 -2
  116. package/dist/src/public/channels/discord/gateway/relay.js +1 -0
  117. package/dist/src/public/channels/discord/messages.d.ts +4 -4
  118. package/dist/src/public/channels/github/state.d.ts +0 -2
  119. package/dist/src/public/channels/index.d.ts +1 -2
  120. package/dist/src/public/channels/index.js +1 -1
  121. package/dist/src/public/channels/linear/index.d.ts +1 -1
  122. package/dist/src/public/channels/linear/index.js +1 -1
  123. package/dist/src/public/channels/linear/linearChannel.d.ts +0 -5
  124. package/dist/src/public/channels/linq/index.d.ts +1 -1
  125. package/dist/src/public/channels/linq/linqChannel.d.ts +7 -5
  126. package/dist/src/public/channels/photon/index.d.ts +1 -1
  127. package/dist/src/public/channels/photon/photonIMessageChannel.d.ts +15 -4
  128. package/dist/src/public/channels/slack/api.d.ts +1 -1
  129. package/dist/src/public/channels/slack/api.js +1 -1
  130. package/dist/src/public/channels/slack/app-manifest.d.ts +4 -0
  131. package/dist/src/public/channels/slack/app-manifest.js +1 -1
  132. package/dist/src/public/channels/slack/auth.d.ts +1 -0
  133. package/dist/src/public/channels/slack/auth.js +1 -1
  134. package/dist/src/public/channels/slack/blocks.d.ts +1 -1
  135. package/dist/src/public/channels/slack/blocks.js +2 -2
  136. package/dist/src/public/channels/slack/cards.d.ts +2 -297
  137. package/dist/src/public/channels/slack/cards.js +1 -1
  138. package/dist/src/public/channels/slack/defaults.js +1 -1
  139. package/dist/src/public/channels/slack/inbound.d.ts +7 -0
  140. package/dist/src/public/channels/slack/index.d.ts +3 -2
  141. package/dist/src/public/channels/slack/index.js +1 -1
  142. package/dist/src/public/channels/slack/model-context.d.ts +3 -2
  143. package/dist/src/public/channels/slack/model-context.js +3 -3
  144. package/dist/src/public/channels/slack/session-operations.d.ts +2 -2
  145. package/dist/src/public/channels/slack/session-operations.js +1 -1
  146. package/dist/src/public/channels/slack/slackChannel.d.ts +37 -72
  147. package/dist/src/public/channels/slack/slackChannel.js +1 -1
  148. package/dist/src/public/channels/slack/user-info.d.ts +64 -0
  149. package/dist/src/public/channels/slack/user-info.js +1 -0
  150. package/dist/src/public/channels/teams/teamsChannel.d.ts +4 -3
  151. package/dist/src/public/channels/telegram/hitl.d.ts +2 -9
  152. package/dist/src/public/channels/telegram/index.d.ts +1 -1
  153. package/dist/src/public/channels/telegram/telegramChannel.d.ts +0 -2
  154. package/dist/src/public/channels/twilio/twilioChannel.d.ts +0 -2
  155. package/dist/src/public/channels/undelivered-reply.d.ts +0 -5
  156. package/dist/src/public/definitions/agent.d.ts +15 -7
  157. package/dist/src/public/definitions/agent.js +1 -1
  158. package/dist/src/public/definitions/channel.d.ts +7 -5
  159. package/dist/src/public/definitions/channel.js +1 -1
  160. package/dist/src/public/definitions/connections/protocol.d.ts +1 -7
  161. package/dist/src/public/definitions/connections/protocol.js +1 -1
  162. package/dist/src/public/experimental/channels/discord/gateway.d.ts +1 -0
  163. package/dist/src/public/experimental/channels/discord/gateway.js +1 -0
  164. package/dist/src/public/experimental/sandbox/just-bash.d.ts +1 -0
  165. package/dist/src/public/experimental/sandbox/just-bash.js +1 -0
  166. package/dist/src/public/experimental/workspace/index.d.ts +1 -0
  167. package/dist/src/public/experimental/workspace/index.js +1 -0
  168. package/dist/src/public/index.d.ts +2 -2
  169. package/dist/src/public/index.js +1 -1
  170. package/dist/src/public/instrumentation/otel.d.ts +1 -1
  171. package/dist/src/public/instrumentation/provider.d.ts +1 -1
  172. package/dist/src/public/instrumentation/provider.js +1 -1
  173. package/dist/src/public/memory/file/backend.d.ts +1 -1
  174. package/dist/src/public/memory/file/backends/in-memory.js +1 -1
  175. package/dist/src/public/memory/file/backends/vercel-blob.js +1 -1
  176. package/dist/src/public/memory/file/provider.js +1 -1
  177. package/dist/src/public/memory/index.d.ts +3 -11
  178. package/dist/src/public/models/anthropic/index.d.ts +1 -1
  179. package/dist/src/public/models/index.d.ts +1 -0
  180. package/dist/src/public/models/openai/index.d.ts +2 -2
  181. package/dist/src/public/next/index.d.ts +2 -2
  182. package/dist/src/public/sandbox/just-bash-sandbox.d.ts +27 -20
  183. package/dist/src/public/sandbox/just-bash.d.ts +0 -1
  184. package/dist/src/public/sessions/index.d.ts +1 -0
  185. package/dist/src/public/sessions/index.js +1 -1
  186. package/dist/src/public/tools/index.d.ts +1 -1
  187. package/dist/src/public/tools/index.js +1 -1
  188. package/dist/src/public/workflow/api.d.ts +25 -0
  189. package/dist/src/public/workflow/api.js +1 -0
  190. package/dist/src/public/workflow/index.d.ts +76 -0
  191. package/dist/src/public/workflow/index.js +1 -0
  192. package/dist/src/public/workflow-modules.d.ts +2 -17
  193. package/dist/src/react/use-eve-agent.d.ts +3 -2
  194. package/dist/src/react/use-eve-agent.js +1 -1
  195. package/dist/src/reactions/kinds/model.js +1 -1
  196. package/dist/src/runtime/agent/resolve-model.js +1 -1
  197. package/dist/src/runtime/resolve-agent.js +1 -1
  198. package/dist/src/runtime/resolve-dynamic.js +1 -1
  199. package/dist/src/runtime/subagents/dynamic-agent-config.js +1 -1
  200. package/dist/src/runtime/subagents/workflow.js +1 -1
  201. package/dist/src/sandbox/providers/default.js +1 -1
  202. package/dist/src/self-modification/extension/subagents/agent/agent.d.ts +2 -2
  203. package/dist/src/self-modification/sandbox.js +1 -1
  204. package/dist/src/setup/integrations/discord/daemon.js +2 -2
  205. package/dist/src/setup/scaffold/create/project.js +2 -2
  206. package/dist/src/setup/scaffold/create/web-template.d.ts +2 -2
  207. package/dist/src/setup/scaffold/create/web-template.js +2 -2
  208. package/dist/src/setup/verified-remote-agent.d.ts +1 -3
  209. package/dist/src/shared/agent-definition.d.ts +18 -9
  210. package/dist/src/shared/eve-error.d.ts +22 -0
  211. package/dist/src/shared/eve-error.js +1 -0
  212. package/dist/src/shared/session.d.ts +2 -2
  213. package/dist/src/shared/token-usage.d.ts +7 -1
  214. package/dist/src/svelte/index.js +1 -1
  215. package/dist/src/svelte/use-eve-agent.d.ts +2 -1
  216. package/dist/src/svelte/use-eve-agent.js +1 -1
  217. package/dist/src/tools/definition.d.ts +7 -5
  218. package/dist/src/tools/definition.js +1 -1
  219. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  220. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  221. package/dist/src/tracing/eve/batch-span-processor.d.ts +1 -1
  222. package/dist/src/tracing/eve/content-span-processor.d.ts +1 -19
  223. package/dist/src/tracing/eve/otel-configuration.d.ts +6 -0
  224. package/dist/src/tracing/eve/otel-declaration.d.ts +6 -19
  225. package/dist/src/tracing/eve/span-export-policy.d.ts +0 -2
  226. package/dist/src/tracing/local/instrumentation-runtime.d.ts +0 -3
  227. package/dist/src/tracing/local/traces.d.ts +0 -13
  228. package/dist/src/vue/index.js +1 -1
  229. package/dist/src/vue/use-eve-agent.d.ts +3 -2
  230. package/dist/src/vue/use-eve-agent.js +1 -1
  231. package/docs/agent-config.md +15 -11
  232. package/docs/channels/custom.mdx +26 -10
  233. package/docs/channels/discord.mdx +10 -10
  234. package/docs/channels/eve.mdx +14 -8
  235. package/docs/channels/linear.mdx +11 -0
  236. package/docs/channels/linq.mdx +5 -1
  237. package/docs/channels/photon.mdx +6 -1
  238. package/docs/channels/slack.mdx +141 -15
  239. package/docs/channels/telegram.mdx +6 -0
  240. package/docs/code-extension.mdx +76 -12
  241. package/docs/concepts/default-harness.md +2 -2
  242. package/docs/concepts/execution-model-and-durability.mdx +11 -11
  243. package/docs/concepts/security-model.md +2 -2
  244. package/docs/concepts/sessions-runs-and-streaming.md +23 -10
  245. package/docs/concepts/upgrade-to-v27-events.md +2 -1
  246. package/docs/connections/overview.mdx +4 -0
  247. package/docs/evals/reporters.mdx +21 -0
  248. package/docs/extensions.md +12 -0
  249. package/docs/getting-started.mdx +5 -1
  250. package/docs/guides/auth-and-route-protection.md +1 -1
  251. package/docs/guides/client/continuations.mdx +12 -10
  252. package/docs/guides/client/messages.mdx +24 -1
  253. package/docs/guides/client/overview.mdx +8 -6
  254. package/docs/guides/client/streaming.mdx +24 -6
  255. package/docs/guides/decide.md +3 -3
  256. package/docs/guides/deployment/vercel.mdx +1 -1
  257. package/docs/guides/dev-tui.md +2 -2
  258. package/docs/guides/frontend/overview.mdx +1 -1
  259. package/docs/guides/frontend/use-eve-agent-svelte.mdx +13 -11
  260. package/docs/guides/frontend/use-eve-agent-vue.mdx +13 -11
  261. package/docs/guides/frontend/use-eve-agent.mdx +4 -4
  262. package/docs/guides/instrumentation/otel.mdx +3 -1
  263. package/docs/guides/prepare-for-1-0.md +255 -0
  264. package/docs/guides/remote-agents.md +22 -20
  265. package/docs/instructions.mdx +1 -1
  266. package/docs/memory/custom-provider.md +1 -1
  267. package/docs/memory/file.md +11 -2
  268. package/docs/meta.json +1 -0
  269. package/docs/reference/agent-files.md +17 -17
  270. package/docs/reference/cli.md +14 -9
  271. package/docs/reference/typescript-api.md +46 -20
  272. package/docs/sandbox/custom-providers.mdx +2 -0
  273. package/docs/sandbox/default.mdx +6 -6
  274. package/docs/sandbox/index.mdx +5 -5
  275. package/docs/sandbox/just-bash.mdx +30 -21
  276. package/docs/subagents/index.mdx +4 -4
  277. package/docs/tools/human-in-the-loop.md +1 -1
  278. package/docs/tools/workflows.mdx +52 -8
  279. package/docs/tutorial/first-agent.mdx +1 -1
  280. package/package.json +36 -9
  281. package/dist/CHANGELOG.md +0 -38
  282. package/dist/src/public/channels/discord/gateway/index.js +0 -1
@@ -4,6 +4,7 @@ export type { SlackAttachment, SlackAuthor, SlackEvent, SlackEventEnvelope, Slac
4
4
  export { callSlackApi, resolveSlackBotToken, slackCodeChannelContinuationToken, slackContinuationToken, type SlackPostInput, type SlackPostedMessage, type SlackBotTokenContext, type SlackThreadMessage, type SlackUploadFilesOptions, type SlackUploadFilesResult, } from "#public/channels/slack/api.js";
5
5
  export { type SlackFetch, type SlackTransportOptions } from "#public/channels/slack/transport.js";
6
6
  export { defaultSlackAuth } from "#public/channels/slack/defaults.js";
7
+ export { type SlackUserInfo } from "#public/channels/slack/user-info.js";
7
8
  export { postCompletedSlackReply, type SlackCompletedReply, } from "#public/channels/slack/reply-delivery.js";
8
9
  export { defineSlackRenderer, type SlackCardMessage, type SlackInteractionCard, type SlackInteractionCardParts, type SlackRenderer, type SlackRendererEvents, type SlackRenderHandler, type SlackRenderNext, } from "#public/channels/slack/renderers.js";
9
10
  export type { TaskCard } from "#channel/task-card.js";
@@ -17,5 +18,5 @@ export { answerFromSlackAction, ANSWER_ACTION_PREFIX, renderInteractionBlocks, t
17
18
  * The chat SDK runtime (`Chat`, `Thread`, `Adapter`, etc.) is not
18
19
  * imported and not reachable through this entry point.
19
20
  */
20
- export { Actions, Button, Card, CardLink, CardText, Divider, ExternalSelect, Field, Fields, Image, LinkButton, Modal, RadioSelect, Section, Select, SelectOption, Table, TextInput, cardChildToFallbackText, isCardElement, } from "#public/channels/slack/cards.js";
21
- export type { ActionsElement, ButtonElement, ButtonOptions, ButtonProps, ButtonStyle, CardChild, CardElement, CardJSXElement, CardJSXProps, CardLinkProps, CardOptions, CardProps, ChatElement, ContainerProps, DividerElement, DividerProps, ExternalSelectElement, ExternalSelectOptions, ExternalSelectProps, FieldElement, FieldProps, FieldsElement, FileUpload, ImageElement, ImageProps, LinkButtonElement, LinkButtonOptions, LinkButtonProps, LinkElement, ModalChild, ModalElement, ModalOptions, ModalProps, PostableCard, RadioSelectElement, RadioSelectOptions, SectionElement, SelectElement, SelectOptionElement, SelectOptionProps, SelectOptions, SelectProps, TableAlignment, TableElement, TableOptions, TextElement, TextInputElement, TextInputOptions, TextInputProps, TextProps, TextStyle, } from "#public/channels/slack/cards.js";
21
+ export { Actions, Button, Card, CardLink, CardText, Divider, Field, Fields, Image, LinkButton, RadioSelect, Section, Select, SelectOption, Table, } from "#public/channels/slack/cards.js";
22
+ export type { ActionsElement, ButtonElement, ButtonOptions, ButtonStyle, CardChild, CardElement, CardOptions, DividerElement, FieldElement, FieldsElement, FileUpload, ImageElement, LinkButtonElement, LinkButtonOptions, LinkElement, PostableCard, RadioSelectElement, RadioSelectOptions, SectionElement, SelectElement, SelectOptionElement, SelectOptions, TableAlignment, TableElement, TableOptions, TextElement, TextStyle, } from "#public/channels/slack/cards.js";
@@ -1 +1 @@
1
- import{callSlackApi,resolveSlackBotToken,slackCodeChannelContinuationToken,slackContinuationToken}from"#public/channels/slack/api.js";import{Actions,Button,Card,CardLink,CardText,Divider,ExternalSelect,Field,Fields,Image,LinkButton,Modal,RadioSelect,Section,Select,SelectOption,Table,TextInput,cardChildToFallbackText,isCardElement}from"#public/channels/slack/cards.js";import{cardToBlocks,cardToFallbackText}from"#public/channels/slack/blocks.js";import{postCompletedSlackReply}from"#public/channels/slack/reply-delivery.js";import{openCodeChannel}from"#public/channels/slack/open-code-channel.js";import{slackChannel}from"#public/channels/slack/slackChannel.js";import{defaultSlackAuth}from"#public/channels/slack/defaults.js";import{defineSlackRenderer}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{ANSWER_ACTION_PREFIX,answerFromSlackAction,renderInteractionBlocks}from"#public/channels/slack/hitl.js";export{ANSWER_ACTION_PREFIX,Actions,Button,Card,CardLink,CardText,Divider,ExternalSelect,Field,Fields,Image,LinkButton,Modal,RadioSelect,Section,Select,SelectOption,Table,TextInput,answerFromSlackAction,callSlackApi,cardChildToFallbackText,cardToBlocks,cardToFallbackText,defaultSlackAuth,defineSlackRenderer,isCardElement,loadThreadContextMessages,openCodeChannel,postCompletedSlackReply,renderInteractionBlocks,resolveSlackBotToken,slackChannel,slackCodeChannelContinuationToken,slackContinuationToken};
1
+ import{callSlackApi,resolveSlackBotToken,slackCodeChannelContinuationToken,slackContinuationToken}from"#public/channels/slack/api.js";import{cardToBlocks,cardToFallbackText}from"#public/channels/slack/blocks.js";import{postCompletedSlackReply}from"#public/channels/slack/reply-delivery.js";import{openCodeChannel}from"#public/channels/slack/open-code-channel.js";import{slackChannel}from"#public/channels/slack/slackChannel.js";import{defaultSlackAuth}from"#public/channels/slack/defaults.js";import{defineSlackRenderer}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{ANSWER_ACTION_PREFIX,answerFromSlackAction,renderInteractionBlocks}from"#public/channels/slack/hitl.js";import{Actions,Button,Card,CardLink,CardText,Divider,Field,Fields,Image,LinkButton,RadioSelect,Section,Select,SelectOption,Table}from"#public/channels/slack/cards.js";export{ANSWER_ACTION_PREFIX,Actions,Button,Card,CardLink,CardText,Divider,Field,Fields,Image,LinkButton,RadioSelect,Section,Select,SelectOption,Table,answerFromSlackAction,callSlackApi,cardToBlocks,cardToFallbackText,defaultSlackAuth,defineSlackRenderer,loadThreadContextMessages,openCodeChannel,postCompletedSlackReply,renderInteractionBlocks,resolveSlackBotToken,slackChannel,slackCodeChannelContinuationToken,slackContinuationToken};
@@ -1,5 +1,6 @@
1
1
  import type { SlackThreadMessage } from "#public/channels/slack/api.js";
2
2
  import type { SlackInboundContext } from "#public/channels/slack/inbound.js";
3
+ import type { SlackUserInfo } from "#public/channels/slack/user-info.js";
3
4
  import type { SessionHistoryMessage } from "#shared/session-history.js";
4
5
  /** Renders the triggering inbound Slack message as one attributed block. */
5
6
  export declare function formatSlackInboundMessage(context: SlackInboundContext, message: {
@@ -10,10 +11,10 @@ export declare function formatSlackInboundMessage(context: SlackInboundContext,
10
11
  * Renders fetched Slack replies as explicitly attributed background context.
11
12
  * Returns `undefined` when there are no messages to add to the turn.
12
13
  */
13
- export declare function formatSlackThreadContext(messages: readonly SlackThreadMessage[]): string | undefined;
14
+ export declare function formatSlackThreadContext(messages: readonly SlackThreadMessage[], users?: ReadonlyMap<string, SlackUserInfo>): string | undefined;
14
15
  /**
15
16
  * Maps fetched thread replies to seeded session history. This app's own replies become assistant
16
17
  * turns; everyone else stays an attributed user message. Slack shows rendered output, so assistant
17
18
  * turns approximate what the model said.
18
19
  */
19
- export declare function slackThreadSessionHistory(messages: readonly SlackThreadMessage[]): SessionHistoryMessage[];
20
+ export declare function slackThreadSessionHistory(messages: readonly SlackThreadMessage[], users?: ReadonlyMap<string, SlackUserInfo>): SessionHistoryMessage[];
@@ -1,3 +1,3 @@
1
- import{slackMrkdwnToGfm}from"#public/channels/slack/mrkdwn.js";function formatSlackModelMessage(e){return[`<slack_message>`,`sender_type: ${e.senderType}`,...e.senderId?[`sender_id: ${e.senderId}`]:[],...e.botUserId?[`bot_user_id: ${e.botUserId}`]:[],...e.isMentioned===void 0?[]:[`is_mentioned: ${e.isMentioned}`],...e.channelId?[`channel_id: ${e.channelId}`]:[],`thread_ts: ${e.threadTs}`,`message_ts: ${e.ts}`,...e.teamId?[`team_id: ${e.teamId}`]:[],`<content>`,e.content,`</content>`,`</slack_message>`].join(`
2
- `)}function formatSlackInboundMessage(e,t){return formatSlackModelMessage({botUserId:e.botUserId,channelId:e.channelId,content:slackModelContent(t.text),isMentioned:e.isMentioned,senderId:e.userId||void 0,senderType:e.userId?`user`:`unknown`,teamId:e.teamId,threadTs:e.threadTs,ts:t.ts})}function slackModelContent(e){let t=[],n=`eve_slack_user_mention_`;for(;e.includes(n);)n+=`_`;let r=e.replace(/<@[A-Z0-9_]+(?:\|[^>\r\n]+)?>/giu,e=>{let r=`${n}${t.length}\uE001`;return t.push(e),r}),i=slackMrkdwnToGfm(r);for(let[e,r]of t.entries())i=i.replaceAll(`${n}${e}\uE001`,r);return i}function formatSlackThreadContext(e){if(e.length!==0)return[`<slack_thread_context>`,...e.map(e=>formatSlackModelMessage({content:e.markdown,senderId:e.user??e.botId,senderType:slackThreadSenderType(e),threadTs:e.threadTs,ts:e.ts})),`</slack_thread_context>`].join(`
3
- `)}function slackThreadSenderType(e){return e.isMe?`agent`:e.botId?`bot`:e.user?`user`:`unknown`}function slackThreadSessionHistory(e){return e.flatMap(e=>slackThreadHistoryMessage(e)??[])}function slackThreadHistoryMessage(e){if(e.markdown.trim().length!==0)return e.isMe?{id:e.ts,role:`assistant`,text:e.markdown}:{id:e.ts,role:`user`,text:formatSlackModelMessage({content:e.markdown,senderId:e.user??e.botId,senderType:slackThreadSenderType(e),threadTs:e.threadTs,ts:e.ts})}}export{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory};
1
+ import{slackMrkdwnToGfm}from"#public/channels/slack/mrkdwn.js";function formatSlackModelMessage(e){let t=e.senderInfo,n=[...e.botUserId?[`id: ${e.botUserId}`]:[],...e.isMentioned===void 0?[]:[`mentioned: ${e.isMentioned}`]];return[`<slack_message>`,`<sender>`,`type: ${e.senderType}`,...e.senderId?[`id: ${e.senderId}`]:[],...t?.displayName?[`display_name: ${oneLine(t.displayName)}`]:[],...t?.realName?[`real_name: ${oneLine(t.realName)}`]:[],...t?.email?[`email: ${oneLine(t.email)}`]:[],`</sender>`,...n.length>0?[`<bot>`,...n,`</bot>`]:[],`<thread>`,...e.teamId?[`team_id: ${e.teamId}`]:[],...e.channelId?[`channel_id: ${e.channelId}`]:[],`thread_ts: ${e.threadTs}`,`message_ts: ${e.ts}`,`</thread>`,`<content>`,e.content,`</content>`,`</slack_message>`].join(`
2
+ `)}function oneLine(e){return e.replace(/[\r\n]+/gu,` `)}function formatSlackInboundMessage(e,t){let n={...e.displayName&&{displayName:e.displayName},...e.fullName&&{realName:e.fullName},...e.email&&{email:e.email}};return formatSlackModelMessage({botUserId:e.botUserId,channelId:e.channelId,content:slackModelContent(t.text),isMentioned:e.isMentioned,senderId:e.userId||void 0,senderInfo:n,senderType:e.userId?`user`:`unknown`,teamId:e.teamId,threadTs:e.threadTs,ts:t.ts})}function slackModelContent(e){let t=[],n=`eve_slack_user_mention_`;for(;e.includes(n);)n+=`_`;let r=e.replace(/<@[A-Z0-9_]+(?:\|[^>\r\n]+)?>/giu,e=>{let r=`${n}${t.length}\uE001`;return t.push(e),r}),i=slackMrkdwnToGfm(r);for(let[e,r]of t.entries())i=i.replaceAll(`${n}${e}\uE001`,r);return i}function formatSlackThreadContext(e,t){if(e.length!==0)return[`<slack_thread_context>`,...e.map(e=>formatSlackThreadMessage(e,t)),`</slack_thread_context>`].join(`
3
+ `)}function formatSlackThreadMessage(e,t){return formatSlackModelMessage({content:e.markdown,senderId:e.user??e.botId,senderInfo:e.user?t?.get(e.user):void 0,senderType:slackThreadSenderType(e),threadTs:e.threadTs,ts:e.ts})}function slackThreadSenderType(e){return e.isMe?`agent`:e.botId?`bot`:e.user?`user`:`unknown`}function slackThreadSessionHistory(e,t){return e.flatMap(e=>slackThreadHistoryMessage(e,t)??[])}function slackThreadHistoryMessage(e,t){if(e.markdown.trim().length!==0)return e.isMe?{id:e.ts,role:`assistant`,text:e.markdown}:{id:e.ts,role:`user`,text:formatSlackThreadMessage(e,t)}}export{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory};
@@ -21,9 +21,9 @@ export interface SlackSessionOperations {
21
21
  }): ReturnType<SlackSource["cancel"]>;
22
22
  compact(): ReturnType<SlackSource["compact"]>;
23
23
  clear(): ReturnType<SlackSource["clear"]>;
24
- reset(options?: {
24
+ end(options?: {
25
25
  readonly reason?: string;
26
- }): ReturnType<SlackSource["reset"]>;
26
+ }): ReturnType<SlackSource["end"]>;
27
27
  resolveSession(): ReturnType<ChannelResolveSession>;
28
28
  }
29
29
  /** Binds Slack state and default auth needed only when a message creates a session. */
@@ -1 +1 @@
1
- function bindSlackSessionOperations(e){let t=e.from(e.address),auth=t=>t===void 0?e.defaultAuth:t;return{async send(n,r={}){return await t.send(n,{...r,auth:auth(r.auth),state:e.state})},async respond(n,r={}){return await t.respond(n,{...r,auth:auth(r.auth),state:withSlackResponder(r.state,e.state.triggeringUserId)})},async cancel(e){return await t.cancel(e)},async compact(){return await t.compact()},async clear(){return await t.clear()},async reset(e){return await t.reset(e)},async resolveSession(){return await e.resolveSession(e.address)}}}function withSlackResponder(e,t){return t?{...e,triggeringUserId:t}:e}export{bindSlackSessionOperations,withSlackResponder};
1
+ function bindSlackSessionOperations(e){let t=e.from(e.address),auth=t=>t===void 0?e.defaultAuth:t;return{async send(n,r={}){return await t.send(n,{...r,auth:auth(r.auth),state:e.state})},async respond(n,r={}){return await t.respond(n,{...r,auth:auth(r.auth),state:withSlackResponder(r.state,e.state.triggeringUserId)})},async cancel(e){return await t.cancel(e)},async compact(){return await t.compact()},async clear(){return await t.clear()},async end(e){return await t.end(e)},async resolveSession(){return await e.resolveSession(e.address)}}}function withSlackResponder(e,t){return t?{...e,triggeringUserId:t}:e}export{bindSlackSessionOperations,withSlackResponder};
@@ -6,7 +6,6 @@ import type { ChannelResolveSession, ChannelSource } from "#channel/channel-oper
6
6
  import type { Delivery } from "#shared/delivery.js";
7
7
  import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
8
8
  import type { VercelConnectMetadata } from "#shared/vercel-connect-metadata.js";
9
- import type { CardElement } from "#public/channels/slack/cards.js";
10
9
  import type { BlockKitBlock } from "#public/channels/slack/blocks.js";
11
10
  import type { SlackHitlRoute } from "#public/channels/slack/hitl.js";
12
11
  import type { SessionContext } from "#public/definitions/callback-context.js";
@@ -14,12 +13,11 @@ import type { SessionHistoryMessage } from "#shared/session-history.js";
14
13
  import type { ChannelContinuationOps } from "#public/definitions/channel.js";
15
14
  import type { Answer, StrictAnswers, ValidatedAnswer } from "#shared/input.js";
16
15
  import type { Interaction } from "#channel/interaction-prompts.js";
17
- import { type SlackBotToken, type SlackHandle, type SlackThread, type SlackWorkspaceHandle } from "#public/channels/slack/api.js";
16
+ import { type SlackBotToken, type SlackHandle, type SlackThread, type SlackPostInput, type SlackWorkspaceHandle } from "#public/channels/slack/api.js";
18
17
  import { type SlackTransportOptions } from "#public/channels/slack/transport.js";
19
18
  import { type SlackRenderedEvent, type SlackRenderer } from "#public/channels/slack/renderers.js";
20
- import { type SlackTaskCardState } from "#public/channels/slack/task-card.js";
21
- import type { SlackThreadStatus } from "#public/channels/slack/thread-status.js";
22
19
  import { type SlackEvent, type SlackEventEnvelope, type SlackMessage } from "#public/channels/slack/inbound.js";
20
+ import { type SlackUsersOption } from "#public/channels/slack/user-info.js";
23
21
  import { type LoadThreadContextMessagesOptions } from "#public/channels/slack/thread.js";
24
22
  import { type SlackSessionOperations } from "#public/channels/slack/session-operations.js";
25
23
  import { type UploadPolicyInput } from "#public/channels/upload-policy.js";
@@ -125,18 +123,6 @@ export interface SlackChannelState extends UndeliveredReplyState {
125
123
  threadTs: string | null;
126
124
  /** Whether this session serves a Slack code channel. */
127
125
  codeChannel?: boolean;
128
- /**
129
- * In a code channel, the thread of the message the current turn answers;
130
- * `null` posts top-level.
131
- * @internal
132
- */
133
- replyThreadTs?: string | null;
134
- /**
135
- * In a code channel, the thread of the latest delivered message, which the
136
- * next turn replies in.
137
- * @internal
138
- */
139
- pendingReplyThreadTs?: string | null;
140
126
  /** Slack team id, when the inbound event carried one. */
141
127
  teamId: string | null;
142
128
  /** Slack message ts that triggered the active turn. */
@@ -149,59 +135,12 @@ export interface SlackChannelState extends UndeliveredReplyState {
149
135
  * recipients through `slackUsersByPrincipal` instead.
150
136
  */
151
137
  triggeringUserId?: string | null;
152
- /**
153
- * Buffered narration from a `content.completed` event (`phase: "narration"`). The default `call.requested` handler uses the
154
- * first non-empty line as the next typing indicator, surfacing the
155
- * model's pre-tool narration instead of the action label. Cleared at
156
- * `turn.started` and after use.
157
- */
158
- pendingToolCallMessage?: string | null;
159
- /**
160
- * The thread status the default renderer last set. A later model step shows
161
- * it again, as does a new task card, which Slack clears the status for.
162
- */
163
- threadStatus?: SlackThreadStatus | null;
164
- /**
165
- * Connection name to Slack message ts. Each entry is the public
166
- * link-free status post created by the default
167
- * sign-in `interaction.opened` handler; the matching
168
- * sign-in `interaction.settled` handler edits it in place to surface the
169
- * resolution outcome.
170
- */
171
- pendingAuthMessageTs?: Record<string, string>;
172
- /**
173
- * The messages holding open or recently answered approvals, questions, and budget prompts.
174
- * Each is updated as its requests change and forgotten once all of them settle. eve ignores
175
- * the `pendingApprovalCards` field that earlier versions wrote, so cards posted before an
176
- * upgrade keep their buttons.
177
- */
178
- interactionCards?: readonly SlackInteractionCardRecord[];
179
- /**
180
- * Each recent turn's tool calls and the task card eve last wrote for it, by
181
- * turn id. The default `turn.paused` handler names the working tasks.
182
- */
183
- taskCards?: Record<string, SlackTaskCardState> | null;
184
- /**
185
- * Tasks that settled since the turn's last model step: each named agent, or
186
- * `null` for another task. The default `step.started` handler shows
187
- * `Reviewing results...` for the step that reads them.
188
- */
189
- pendingTaskResults?: {
190
- readonly names: readonly (string | null)[];
191
- readonly turnId: string;
192
- } | null;
193
138
  /**
194
139
  * Principal id to Slack user id, recorded as each message or input response
195
140
  * is delivered. Default handlers use it to address the principal named on
196
141
  * sign-in `interaction.opened` and approval events.
197
142
  */
198
143
  slackUsersByPrincipal?: Record<string, string>;
199
- /**
200
- * Whether eve has posted in this thread. Once it has, deleting the root
201
- * leaves a tombstone that keeps the thread, so the final reply skips the
202
- * deleted-root check.
203
- */
204
- postedInThread?: boolean;
205
144
  }
206
145
  /**
207
146
  * Per-session metadata attached to tracing spans, projected by the
@@ -285,13 +224,14 @@ export interface SlackCodeChannelTarget {
285
224
  }
286
225
  /**
287
226
  * Pre-agent post issued by `slackChannel().receive` when the caller
288
- * provides `target.initialMessage`. Mirrors `ctx.thread.post`'s card
289
- * variant so the same `Card({...})` construction can be reused.
227
+ * provides `target.initialMessage`. Accepts the same explicit message forms
228
+ * as `ctx.thread.post`: Markdown, text, blocks, or a card, plus optional files.
229
+ *
230
+ * Unlike `thread.post({ text, files })`, which sends one message with the files
231
+ * attached, this posts the root message first and then uploads files as a
232
+ * threaded reply. Upload failures are logged, not thrown, so the run still starts.
290
233
  */
291
- export interface SlackInitialMessage {
292
- readonly card: CardElement;
293
- readonly fallbackText?: string;
294
- }
234
+ export type SlackInitialMessage = SlackPostInput;
295
235
  /**
296
236
  * Options for one turn requested by a generic Slack event handler.
297
237
  */
@@ -347,11 +287,11 @@ export interface SlackInboundEventContext {
347
287
  clear(input: {
348
288
  readonly target: SlackSessionTarget;
349
289
  }): ReturnType<ChannelSource<SlackChannelState>["clear"]>;
350
- /** Resets the current session for one Slack thread. */
351
- reset(input: {
290
+ /** Retires the current session for one Slack thread without creating a replacement. */
291
+ end(input: {
352
292
  readonly reason?: string;
353
293
  readonly target: SlackSessionTarget;
354
- }): ReturnType<ChannelSource<SlackChannelState>["reset"]>;
294
+ }): ReturnType<ChannelSource<SlackChannelState>["end"]>;
355
295
  /** Resolves the current session for one Slack thread. */
356
296
  resolveSession(input: {
357
297
  readonly target: SlackSessionTarget;
@@ -592,6 +532,31 @@ export interface SlackChannelConfig {
592
532
  * option to avoid fetching thread history.
593
533
  */
594
534
  readonly threadContext?: LoadThreadContextMessagesOptions;
535
+ /**
536
+ * Adds to what eve attaches to each model-visible `<slack_message>`.
537
+ */
538
+ readonly messageContext?: {
539
+ /**
540
+ * Looks up each human sender with `users.info` and adds `display_name`
541
+ * and `real_name` to their `<sender>` block, plus `email` with
542
+ * `email: true` (`name: false` leaves names out), including
543
+ * `threadContext` replies. The triggering author
544
+ * is also written to `message.author` (`fullName`, `displayName`,
545
+ * `email`) and to the default Slack auth attributes: before
546
+ * `onAppMention` and `onDirectMessage` run, and for other channel
547
+ * messages only once a hook delivers them.
548
+ *
549
+ * `true` caches results in memory per workspace and user for an hour.
550
+ * `resolve(user, next)` owns caching instead; `next()` is the uncached
551
+ * `users.info` call. A lookup that fails or takes over two seconds is
552
+ * left out, and the message is still delivered.
553
+ *
554
+ * Adds the `users:read` scope to the app manifest, and `users:read.email`
555
+ * with `email: true`. Off by default: names and emails then reach model
556
+ * context, session history, and traces.
557
+ */
558
+ readonly users?: SlackUsersOption;
559
+ };
595
560
  /**
596
561
  * Handles human-authored Slack messages. Specialized `onAppMention` and
597
562
  * `onDirectMessage` handlers take precedence for their event types. Other
@@ -1 +1 @@
1
- import{markEventHandled}from"./utils.js";import{createHash}from"node:crypto";import{toSessionSendOptions}from"#channel/session.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackCodeChannelContinuationToken,slackContinuationToken,slackSessionToken}from"#public/channels/slack/api.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{createSlackCodeChannel,isSlackCodeChannel,isSlackCodeChannelOriginContext,setSlackCodeChannelStatus}from"#public/channels/slack/code-channel.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultInteractionEvents,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeInteractionCards,composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,codeChannel:e.codeChannel===!0,replyThreadTs:()=>e.replyThreadTs??void 0,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken({channelId:e.channelId,threadTs:n}))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),i=e.onAnswers??defaultOnAnswers,a=composeInteractionCards(e.renderers??[]),o=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,...defaultInteractionEvents(e.approvalChannel,a)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),s=o.events[`turn.started`],c=withTaskCards({...o.events,"content.completed":withFinalReplyDelivery(o.events[`content.completed`]),async"turn.started"(e,t){let{channel:n}=t,r=slackUserIdFromAuthContext(t.session.auth.current);r!==void 0&&(n.state.triggeringUserId=r),n.state.pendingReplyThreadTs!==void 0&&(n.state.replyThreadTs=n.state.pendingReplyThreadTs,n.state.pendingReplyThreadTs=void 0),await s?.(e,t)}},o.taskCard),l=new Set,u=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},interactionCards:[],slackUsersByPrincipal:{}},fetchFile:r,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null,installationTeamId:e.installationTeamId??null,triggeringMessageTs:e.triggeringMessageTs??null,...e.codeChannel===!0&&{codeChannel:!0}}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),followReplyThread(t.state,e),followTriggeringMessage(t.state,e),withUndeliveredReplyNote(t.state,e,`Slack`)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,a)=>{let{waitUntil:s}=a,{from:c,resolveSession:u}=a,d=await verifyInbound(r,e.credentials);return d===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(d,{from:c,resolveSession:u,waitUntil:s},{api:t,config:e,onAnswers:i}):handleEventPost({api:t,body:d,from:c,resolveSession:u,waitUntil:s,config:e,received:o.received,uploadPolicy:n,handledEvents:l,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,codeChannels:e.codeChannels===!0,credentials:e.credentials})},events:c}),d=e.credentials,f=defineSlackAppManifest({botName:e.botName,codeChannels:e.codeChannels===!0});return setChannelBuildMetadata(u,e=>({externalCredentials:d?.vercelConnect,manifest:f.build(e)})),u}function defaultOnAnswers(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let{message:n,target:r,...i}=e,a=r,o=a.channelId;if(!o||typeof o!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let s=typeof a.threadTs==`string`?a.threadTs:``,c=typeof a.installationTeamId==`string`?a.installationTeamId:t.installationTeamId,l=a.initialMessage;if(l&&s.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");if(a.codeChannel!==void 0){if(!t.codeChannels)throw Error("slackChannel().receive: set `codeChannels: true` on slackChannel() to open code channels.");if(l||s.length>0)throw Error("slackChannel().receive: `codeChannel` can't be combined with `threadTs` or `initialMessage`.");return await receiveInNewCodeChannel(e,t,{codeChannel:a.codeChannel,installationTeamId:c,originChannelId:o})}let u=s;if(l){let{thread:e}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:o,threadTs:``,installationTeamId:c,teamId:t.teamId}),n={card:l.card};l.fallbackText!==void 0&&(n.fallbackText=l.fallbackText),u=(await e.post(n)).id}let d=u||(i.idempotencyKey===void 0?crypto.randomUUID():threadlessIdentityFromKey(i.idempotencyKey)),f=a.audience===void 0?void 0:normalizeChannelAudience(a.audience),p={channelId:o,installationTeamId:c??null,threadTs:u||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return f!==void 0&&(p.audience=f),t.from(slackContinuationToken({channelId:o,threadTs:d})).send(n,{...i,state:p})}function threadlessIdentityFromKey(e){return`key-${createHash(`sha256`).update(e).digest(`hex`).slice(0,32)}`}async function receiveInNewCodeChannel(e,t,n){let{codeChannel:r,installationTeamId:i,originChannelId:a}=n,{request:o}=buildSlackWorkspaceHandle({api:t.api,botToken:t.credentials?.botToken,installationTeamId:i,teamId:t.teamId}),s=await openSlackCodeChannel({auth:e.auth,installationTeamId:i,name:r.name,originChannelId:a,originTs:r.originTs,request:o,teamId:t.teamId,triggeringUserId:t.triggeringUserId??slackUserIdFromAuthContext(e.auth)}),{message:c,target:l,...u}=e;return await t.from(s.address).send(c,{...u,auth:s.auth,state:s.state})}async function openSlackCodeChannel(e){let{channelId:t,isPrivate:n}=await createSlackCodeChannel({name:e.name??``,originChannelId:e.originChannelId,originTs:e.originTs,requester:e.auth?.principalId??`anonymous`,request:e.request});return{address:slackCodeChannelContinuationToken(t),auth:codeChannelAuth(e.auth,t),channelId:t,state:{audience:n?`private`:`public`,channelId:t,codeChannel:!0,installationTeamId:e.installationTeamId??null,replyThreadTs:null,teamId:e.teamId??null,threadTs:null,triggeringUserId:e.triggeringUserId??null}}}function codeChannelAuth(e,t){if(e?.authenticator!==`slack-webhook`)return e;let{thread_ts:n,...r}=e.attributes;return{...e,attributes:{...r,channel_id:t}}}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),c=r.event,l=c.channel;if(t.codeChannels===!0&&c.type===`agent_session_stopped`&&typeof l==`string`){if(isDuplicateEvent(r,n.retry,e.handledEvents))return new Response(`ok`);let i=buildSlackWorkspaceHandle({api:e.api,botToken:t.credentials?.botToken,installationTeamId:s,teamId:typeof r.team_id==`string`?r.team_id:void 0}).request,a=t.onEvent;return e.waitUntil((async()=>{if(c.thread_ts!==void 0&&!await isSlackCodeChannel(l,i)){if(a===void 0)return;await dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,codeChannels:!0,credentials:t.credentials,envelope:r,handler:a,installationTeamId:s});return}await cancelledARunningTurn(e.from,l)||await setSlackCodeChannelStatus(i,l,`active`)})().catch(e=>{logError(log,`agent_session_stopped handling failed`,e,{channelId:l})})),new Response(`ok`)}let u=null,d=null,dispatchMessage=(n,r,c,l)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,codeChannelOnly:l,detectCodeChannels:t.codeChannels===!0,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onAnswers===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?d=dispatchMessage(e,r,defaultOnMessage):u=dispatchMessage(e,r,n)}}let f=t.onMessage;if(u===null&&f!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(u=dispatchMessage(`channel_message`,e,f))}let p=t.onEvent,m=p===void 0?void 0:()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,codeChannels:t.codeChannels===!0,envelope:r,handler:p,installationTeamId:s});if(u===null&&d===null&&t.codeChannels===!0){let e=parseMessageEvent(r);if(e!==null&&e.author?.isBot===!1&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&!isSlackCodeChannelOriginContext(e.raw)&&(a===void 0||!e.text.includes(`<@${a}`))){let n=t.onAppMention;n===void 0?d=dispatchMessage(`channel_message`,e,defaultOnMessage,{}):u=dispatchMessage(`channel_message`,e,n,{otherwise:m})}}return u??=m??d,u===null||isDuplicateEvent(r,n.retry,e.handledEvents)||e.waitUntil(u()),new Response(`ok`)}function isDuplicateEvent(e,t,n){let r=e.event_id;return r?n.has(r)?(log.warn(`received a duplicate event`,{event_id:r,event_time:e.event_time,retry_num:t?.num??`(null)`,retry_reason:t?.reason??`(null)`}),!0):(markEventHandled(r,n),!1):!1}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=e.message.author,n=buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:e.message.teamId}).request,r,conversationRequest=(e,t)=>e===`conversations.info`?r??=n(e,t):n(e,t),i=e.detectCodeChannels&&e.kind!==`direct_message`&&await isSlackCodeChannel(e.message.channelId,conversationRequest);if(!i&&e.codeChannelOnly!==void 0){await e.codeChannelOnly.otherwise?.();return}let a=i?``:e.message.threadTs,o=e.message.threadTs!==e.message.ts,s=i&&o?e.message.threadTs:null,c=i?slackCodeChannelContinuationToken(e.message.channelId):slackContinuationToken({channelId:e.message.channelId,threadTs:a}),{thread:l,slack:u}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:a,codeChannel:i,replyThreadTs:()=>s??void 0,threadHasReplies:o,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),d={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:a||null,triggeringMessageTs:e.message.ts,triggeringUserId:t?.userId??null,...i&&{codeChannel:!0,replyThreadTs:s}},f=t===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,fullName:t.fullName,installationTeamId:e.installationTeamId,isBot:t.isBot,teamId:e.message.teamId,threadTs:a,userId:t.userId,userName:t.userName}),p=bindSlackSessionOperations({address:c,defaultAuth:f,from:e.from,resolveSession:e.resolveSession,state:d}),m,isDMOrPrivateChannel=()=>m??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:conversationRequest}),openCodeChannel=async(t={})=>{if(!e.detectCodeChannels)throw Error("ctx.openCodeChannel(): set `codeChannels: true` on slackChannel() to open code channels.");if(i)throw Error(`ctx.openCodeChannel(): this message is already in a code channel.`);return await openCodeChannelFromMessage({defaultAuth:f,from:e.from,installationTeamId:e.installationTeamId,message:e.message,name:t.name,request:n,resolveSession:e.resolveSession})},h=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),g={...p,isBotMentioned:()=>h,isDMOrPrivateChannel,isSubscribed:async()=>await p.resolveSession()!==void 0,openCodeChannel,slack:u,thread:l},_=e.kind!==`channel_message`&&!i?acknowledgeMessage(e.received,e.message,{slack:u,thread:l}):void 0,v;try{v=await e.handler(g,e.message)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(v==null){_!==void 0&&(await _,await l.startTyping());return}await(_??acknowledgeMessage(e.received,e.message,{slack:u,thread:l}));let y=await isDMOrPrivateChannel();d.audience=e.kind===`direct_message`||y?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:y,isMentioned:h,message:e.message,resolvesTypedInput:e.resolvesTypedInput,result:v,sessionOperations:p,thread:l,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy})}async function openCodeChannelFromMessage(e){let t=await openSlackCodeChannel({auth:e.defaultAuth,installationTeamId:e.installationTeamId,name:e.name,originChannelId:e.message.channelId,originTs:e.message.ts,request:e.request,teamId:e.message.teamId,triggeringUserId:e.message.author?.userId}),n=bindSlackSessionOperations({address:t.address,defaultAuth:t.auth,from:e.from,resolveSession:e.resolveSession,state:t.state}),moved=e=>e?.auth?{...e,auth:codeChannelAuth(e.auth,t.channelId)}:e;return{...n,channelId:t.channelId,send:(e,t)=>n.send(e,moved(t)),respond:(e,t)=>n.respond(e,moved(t))}}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackSessionToken(t)),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,reset:({reason:e,target:t})=>sourceFor(t).reset({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackSessionToken(t)),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:async(t,r)=>await receiveOnSlack({...toSessionSendOptions(r),target:r.target,message:t},{from:e.from,api:e.api,codeChannels:e.codeChannels,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(e,{signingSecret:t?.signingSecret??(t?.webhookVerifier?void 0:process.env.SLACK_SIGNING_SECRET),webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`slack inbound verification failed`,{error:e}),null}}async function deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=i?void 0:formatSlackThreadContext(r),o=e.result.history??(i?slackThreadSessionHistory(r):void 0),s=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),c={botUserId:e.botUserId,channelId:t.channelId,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},l=formatSlackInboundMessage(c,t),u=buildSlackTurnMessage(a===void 0?l:`${a}\n\n${l}`,s),d=e.result.context??[],f=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,p=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,m=attachInputText({auth:e.result.auth,title:f,...d.length>0&&{context:d},...o!==void 0&&{history:o}},s.length===0?p:void 0);await e.sessionOperations.send(u,m)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}async function cancelledARunningTurn(e,t){try{let{outcome:n}=await(await e(slackCodeChannelContinuationToken(t)).cancel()).result({signal:AbortSignal.timeout(1e4)});return n!==`ignored`}catch(e){if(e instanceof SessionNotActiveError)return!1;throw e}}function followReplyThread(e,t){t.message!==void 0&&e.codeChannel===!0&&(e.pendingReplyThreadTs=t.state?.replyThreadTs??null)}function followTriggeringMessage(e,t){if(t.message===void 0)return;let n=t.state?.triggeringMessageTs;typeof n==`string`&&(e.triggeringMessageTs=n)}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};
1
+ import{markEventHandled}from"./utils.js";import{createHash}from"node:crypto";import{toSessionSendOptions}from"#channel/session.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackCodeChannelContinuationToken,slackContinuationToken,slackSessionToken}from"#public/channels/slack/api.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{createSlackCodeChannel,isSlackCodeChannel,isSlackCodeChannelOriginContext,setSlackCodeChannelStatus}from"#public/channels/slack/code-channel.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultInteractionEvents,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeInteractionCards,composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{createSlackUserResolver,resolveSlackUsers,withSlackUserInfo}from"#public/channels/slack/user-info.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,codeChannel:e.codeChannel===!0,replyThreadTs:()=>e.replyThreadTs??void 0,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken({channelId:e.channelId,threadTs:n}))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=e.messageContext?.users,i=createSlackUserResolver(r),a=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),o=e.onAnswers??defaultOnAnswers,s=composeInteractionCards(e.renderers??[]),c=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,...defaultInteractionEvents(e.approvalChannel,s)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),l=c.events[`turn.started`],u=withTaskCards({...c.events,"content.completed":withFinalReplyDelivery(c.events[`content.completed`]),async"turn.started"(e,t){let{channel:n}=t,r=slackUserIdFromAuthContext(t.session.auth.current);r!==void 0&&(n.state.triggeringUserId=r),n.state.pendingReplyThreadTs!==void 0&&(n.state.replyThreadTs=n.state.pendingReplyThreadTs,n.state.pendingReplyThreadTs=void 0),await l?.(e,t)}},c.taskCard),d=new Set,f=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},interactionCards:[],slackUsersByPrincipal:{}},fetchFile:a,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null,installationTeamId:e.installationTeamId??null,triggeringMessageTs:e.triggeringMessageTs??null,...e.codeChannel===!0&&{codeChannel:!0}}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),followReplyThread(t.state,e),followTriggeringMessage(t.state,e),withUndeliveredReplyNote(t.state,e,`Slack`)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,a)=>{let{waitUntil:s}=a,{from:l,resolveSession:u}=a,f=await verifyInbound(r,e.credentials);return f===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(f,{from:l,resolveSession:u,waitUntil:s},{api:t,config:e,onAnswers:o}):handleEventPost({api:t,body:f,from:l,resolveSession:u,waitUntil:s,config:e,received:c.received,userResolver:i,uploadPolicy:n,handledEvents:d,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,codeChannels:e.codeChannels===!0,credentials:e.credentials})},events:u}),p=e.credentials,m=defineSlackAppManifest({botName:e.botName,codeChannels:e.codeChannels===!0,users:i!==void 0,userEmails:typeof r==`object`&&r.email===!0});return setChannelBuildMetadata(f,e=>({externalCredentials:p?.vercelConnect,manifest:m.build(e)})),f}function defaultOnAnswers(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let{message:n,target:r,...i}=e,a=r,o=a.channelId;if(!o||typeof o!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let s=typeof a.threadTs==`string`?a.threadTs:``,c=typeof a.installationTeamId==`string`?a.installationTeamId:t.installationTeamId,l=a.initialMessage;if(l&&s.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");if(a.codeChannel!==void 0){if(!t.codeChannels)throw Error("slackChannel().receive: set `codeChannels: true` on slackChannel() to open code channels.");if(l||s.length>0)throw Error("slackChannel().receive: `codeChannel` can't be combined with `threadTs` or `initialMessage`.");return await receiveInNewCodeChannel(e,t,{codeChannel:a.codeChannel,installationTeamId:c,originChannelId:o})}let u=s;if(l){let{thread:e,slack:n}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:o,threadTs:``,installationTeamId:c,teamId:t.teamId}),{files:r,...i}=l;if(u=(await e.post(i)).id,r?.length)try{await n.uploadFiles(r)}catch(e){log.warn(`file upload after initial message post failed`,{error:e})}}let d=u||(i.idempotencyKey===void 0?crypto.randomUUID():threadlessIdentityFromKey(i.idempotencyKey)),f=a.audience===void 0?void 0:normalizeChannelAudience(a.audience),p={channelId:o,installationTeamId:c??null,threadTs:u||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return f!==void 0&&(p.audience=f),t.from(slackContinuationToken({channelId:o,threadTs:d})).send(n,{...i,state:p})}function threadlessIdentityFromKey(e){return`key-${createHash(`sha256`).update(e).digest(`hex`).slice(0,32)}`}async function receiveInNewCodeChannel(e,t,n){let{codeChannel:r,installationTeamId:i,originChannelId:a}=n,{request:o}=buildSlackWorkspaceHandle({api:t.api,botToken:t.credentials?.botToken,installationTeamId:i,teamId:t.teamId}),s=await openSlackCodeChannel({auth:e.auth,installationTeamId:i,name:r.name,originChannelId:a,originTs:r.originTs,request:o,teamId:t.teamId,triggeringUserId:t.triggeringUserId??slackUserIdFromAuthContext(e.auth)}),{message:c,target:l,...u}=e;return await t.from(s.address).send(c,{...u,auth:s.auth,state:s.state})}async function openSlackCodeChannel(e){let{channelId:t,isPrivate:n}=await createSlackCodeChannel({name:e.name??``,originChannelId:e.originChannelId,originTs:e.originTs,requester:e.auth?.principalId??`anonymous`,request:e.request});return{address:slackCodeChannelContinuationToken(t),auth:codeChannelAuth(e.auth,t),channelId:t,state:{audience:n?`private`:`public`,channelId:t,codeChannel:!0,installationTeamId:e.installationTeamId??null,replyThreadTs:null,teamId:e.teamId??null,threadTs:null,triggeringUserId:e.triggeringUserId??null}}}function codeChannelAuth(e,t){if(e?.authenticator!==`slack-webhook`)return e;let{thread_ts:n,...r}=e.attributes;return{...e,attributes:{...r,channel_id:t}}}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),c=r.event,l=c.channel;if(t.codeChannels===!0&&c.type===`agent_session_stopped`&&typeof l==`string`){if(isDuplicateEvent(r,n.retry,e.handledEvents))return new Response(`ok`);let i=buildSlackWorkspaceHandle({api:e.api,botToken:t.credentials?.botToken,installationTeamId:s,teamId:typeof r.team_id==`string`?r.team_id:void 0}).request,a=t.onEvent;return e.waitUntil((async()=>{if(c.thread_ts!==void 0&&!await isSlackCodeChannel(l,i)){if(a===void 0)return;await dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,codeChannels:!0,credentials:t.credentials,envelope:r,handler:a,installationTeamId:s});return}await cancelledARunningTurn(e.from,l)||await setSlackCodeChannelStatus(i,l,`active`)})().catch(e=>{logError(log,`agent_session_stopped handling failed`,e,{channelId:l})})),new Response(`ok`)}let u=null,d=null,dispatchMessage=(n,r,c,l)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,codeChannelOnly:l,detectCodeChannels:t.codeChannels===!0,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onAnswers===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy,userResolver:e.userResolver});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?d=dispatchMessage(e,r,defaultOnMessage):u=dispatchMessage(e,r,n)}}let f=t.onMessage;if(u===null&&f!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(u=dispatchMessage(`channel_message`,e,f))}let p=t.onEvent,m=p===void 0?void 0:()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,codeChannels:t.codeChannels===!0,envelope:r,handler:p,installationTeamId:s});if(u===null&&d===null&&t.codeChannels===!0){let e=parseMessageEvent(r);if(e!==null&&e.author?.isBot===!1&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&!isSlackCodeChannelOriginContext(e.raw)&&(a===void 0||!e.text.includes(`<@${a}`))){let n=t.onAppMention;n===void 0?d=dispatchMessage(`channel_message`,e,defaultOnMessage,{}):u=dispatchMessage(`channel_message`,e,n,{otherwise:m})}}return u??=m??d,u===null||isDuplicateEvent(r,n.retry,e.handledEvents)||e.waitUntil(u()),new Response(`ok`)}function isDuplicateEvent(e,t,n){let r=e.event_id;return r?n.has(r)?(log.warn(`received a duplicate event`,{event_id:r,event_time:e.event_time,retry_num:t?.num??`(null)`,retry_reason:t?.reason??`(null)`}),!0):(markEventHandled(r,n),!1):!1}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:e.message.teamId}).request,n={request:t,teamId:e.installationTeamId??e.message.teamId},r,resolveMessage=()=>r??=e.userResolver===void 0?Promise.resolve(e.message):withSlackUserInfo(e.message,e.userResolver,n),i=e.kind===`channel_message`?e.message:await resolveMessage(),a=i.author,o,conversationRequest=(e,n)=>e===`conversations.info`?o??=t(e,n):t(e,n),s=e.detectCodeChannels&&e.kind!==`direct_message`&&await isSlackCodeChannel(e.message.channelId,conversationRequest);if(!s&&e.codeChannelOnly!==void 0){await e.codeChannelOnly.otherwise?.();return}let c=s?``:e.message.threadTs,l=e.message.threadTs!==e.message.ts,u=s&&l?e.message.threadTs:null,d=s?slackCodeChannelContinuationToken(e.message.channelId):slackContinuationToken({channelId:e.message.channelId,threadTs:c}),{thread:f,slack:p}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:c,codeChannel:s,replyThreadTs:()=>u??void 0,threadHasReplies:l,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),m={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:c||null,triggeringMessageTs:e.message.ts,triggeringUserId:a?.userId??null,...s&&{codeChannel:!0,replyThreadTs:u}},h=a===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,email:a.email,fullName:a.fullName,installationTeamId:e.installationTeamId,isBot:a.isBot,teamId:e.message.teamId,threadTs:c,userId:a.userId,userName:a.userName}),g=bindSlackSessionOperations({address:d,defaultAuth:h,from:e.from,resolveSession:e.resolveSession,state:m}),_,isDMOrPrivateChannel=()=>_??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:conversationRequest}),openCodeChannel=async(n={})=>{if(!e.detectCodeChannels)throw Error("ctx.openCodeChannel(): set `codeChannels: true` on slackChannel() to open code channels.");if(s)throw Error(`ctx.openCodeChannel(): this message is already in a code channel.`);return await openCodeChannelFromMessage({defaultAuth:h,from:e.from,installationTeamId:e.installationTeamId,message:e.message,name:n.name,request:t,resolveSession:e.resolveSession})},v=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),y={...g,isBotMentioned:()=>v,isDMOrPrivateChannel,isSubscribed:async()=>await g.resolveSession()!==void 0,openCodeChannel,slack:p,thread:f},b=e.kind!==`channel_message`&&!s?acknowledgeMessage(e.received,e.message,{slack:p,thread:f}):void 0,x;try{x=await e.handler(y,i)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(x==null){b!==void 0&&(await b,await f.startTyping());return}await(b??acknowledgeMessage(e.received,e.message,{slack:p,thread:f}));let S=await isDMOrPrivateChannel();m.audience=e.kind===`direct_message`||S?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:S,isMentioned:v,message:await resolveMessage(),resolvesTypedInput:e.resolvesTypedInput,result:x,sessionOperations:g,thread:f,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy,users:e.userResolver&&{resolver:e.userResolver,...n}})}async function openCodeChannelFromMessage(e){let t=await openSlackCodeChannel({auth:e.defaultAuth,installationTeamId:e.installationTeamId,name:e.name,originChannelId:e.message.channelId,originTs:e.message.ts,request:e.request,teamId:e.message.teamId,triggeringUserId:e.message.author?.userId}),n=bindSlackSessionOperations({address:t.address,defaultAuth:t.auth,from:e.from,resolveSession:e.resolveSession,state:t.state}),moved=e=>e?.auth?{...e,auth:codeChannelAuth(e.auth,t.channelId)}:e;return{...n,channelId:t.channelId,send:(e,t)=>n.send(e,moved(t)),respond:(e,t)=>n.respond(e,moved(t))}}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackSessionToken(t)),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,end:({reason:e,target:t})=>sourceFor(t).end({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackSessionToken(t)),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:async(t,r)=>await receiveOnSlack({...toSessionSendOptions(r),target:r.target,message:t},{from:e.from,api:e.api,codeChannels:e.codeChannels,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(e,{signingSecret:t?.signingSecret??(t?.webhookVerifier?void 0:process.env.SLACK_SIGNING_SECRET),webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`slack inbound verification failed`,{error:e}),null}}async function deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=e.users===void 0?void 0:await resolveSlackUsers(e.users.resolver,{request:e.users.request,teamId:e.users.teamId,userIds:r.flatMap(e=>e.user?[e.user]:[])}),o=i?void 0:formatSlackThreadContext(r,a),s=e.result.history??(i?slackThreadSessionHistory(r,a):void 0),c=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),l={botUserId:e.botUserId,channelId:t.channelId,displayName:t.author?.displayName,email:t.author?.email,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},u=formatSlackInboundMessage(l,t),d=buildSlackTurnMessage(o===void 0?u:`${o}\n\n${u}`,c),f=e.result.context??[],p=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,m=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,h=attachInputText({auth:e.result.auth,title:p,...f.length>0&&{context:f},...s!==void 0&&{history:s}},c.length===0?m:void 0);await e.sessionOperations.send(d,h)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}async function cancelledARunningTurn(e,t){try{let{outcome:n}=await(await e(slackCodeChannelContinuationToken(t)).cancel()).result({signal:AbortSignal.timeout(1e4)});return n!==`ignored`}catch(e){if(e instanceof SessionNotActiveError)return!1;throw e}}function followReplyThread(e,t){t.message!==void 0&&e.codeChannel===!0&&(e.pendingReplyThreadTs=t.state?.replyThreadTs??null)}function followTriggeringMessage(e,t){if(t.message===void 0)return;let n=t.state?.triggeringMessageTs;typeof n==`string`&&(e.triggeringMessageTs=n)}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};
@@ -0,0 +1,64 @@
1
+ import type { SlackRequest } from "#public/channels/slack/code-channel.js";
2
+ import type { SlackMessage } from "#public/channels/slack/inbound.js";
3
+ /** Slack profile fields `messageContext.users` adds to a message's sender. */
4
+ export interface SlackUserInfo {
5
+ /** Rendered as the sender's `display_name`. Kept unless `messageContext.users.name` is `false`. */
6
+ readonly displayName?: string;
7
+ /** Rendered as the sender's `real_name`, and set as `message.author.fullName`. Kept unless `name` is `false`. */
8
+ readonly realName?: string;
9
+ /** Rendered as the sender's `email`. Kept only with `messageContext.users.email`. */
10
+ readonly email?: string;
11
+ }
12
+ /** The `messageContext.users` option of `slackChannel()`. */
13
+ export type SlackUsersOption = boolean | {
14
+ /**
15
+ * Adds each sender's display and real names. Defaults to `true`; set
16
+ * `false` with `email: true` to add emails only.
17
+ */
18
+ readonly name?: boolean;
19
+ /** Adds each sender's email. Needs the `users:read.email` scope. */
20
+ readonly email?: boolean;
21
+ /**
22
+ * Resolves one user, for example from your own cache. `next()` is eve's
23
+ * uncached `users.info` call and throws when Slack rejects it. Return
24
+ * `undefined` to leave the user's profile fields out.
25
+ */
26
+ readonly resolve?: (user: {
27
+ readonly userId: string;
28
+ /**
29
+ * Workspace whose app installation received the message, falling
30
+ * back to the message's team: `message.installationTeamId ??
31
+ * message.teamId`. Slack user ids are scoped to it, so key caches on
32
+ * it rather than on `message.teamId`.
33
+ */
34
+ readonly teamId: string | undefined;
35
+ }, next: () => Promise<SlackUserInfo>) => Promise<SlackUserInfo | undefined>;
36
+ };
37
+ /** Looks up Slack users for one channel. Never throws; a failure resolves to `undefined`. */
38
+ export type SlackUserResolver = (input: {
39
+ readonly userId: string;
40
+ readonly teamId: string | undefined;
41
+ readonly request: SlackRequest;
42
+ }) => Promise<SlackUserInfo | undefined>;
43
+ /**
44
+ * Builds the resolver for `messageContext.users`, or `undefined` when it adds
45
+ * no fields. Without an authored `resolve`, `users.info` results are cached in
46
+ * memory per workspace and user for an hour, and failures for a minute. Each
47
+ * Slack channel builds its own, so a profile fetched with one app's scopes
48
+ * never reaches another app in the same process.
49
+ */
50
+ export declare function createSlackUserResolver(option: SlackUsersOption | undefined, now?: () => number): SlackUserResolver | undefined;
51
+ /**
52
+ * Resolves each distinct user, the first {@link MAX_LOOKUPS_PER_MESSAGE} only.
53
+ * A failed or empty lookup leaves that user out of the map.
54
+ */
55
+ export declare function resolveSlackUsers(resolver: SlackUserResolver, input: {
56
+ readonly userIds: readonly string[];
57
+ readonly teamId: string | undefined;
58
+ readonly request: SlackRequest;
59
+ }): Promise<ReadonlyMap<string, SlackUserInfo>>;
60
+ /** Returns `message` with its human author's resolved profile fields, or unchanged. */
61
+ export declare function withSlackUserInfo(message: SlackMessage, resolver: SlackUserResolver, input: {
62
+ readonly teamId: string | undefined;
63
+ readonly request: SlackRequest;
64
+ }): Promise<SlackMessage>;
@@ -0,0 +1 @@
1
+ import{createLogger,logError}from"#internal/logging.js";const log=createLogger(`slack.user-info`);function createSlackUserResolver(e,t=Date.now){if(e===void 0||e===!1)return;let n=e===!0||e.name!==!1,r=e!==!0&&e.email===!0;if(!n&&!r)return;let i=e===!0?void 0:e.resolve,a=new Map,o=i===void 0?({userId:e,teamId:n,request:r})=>{let i=`${n??``}:${e}`,o=a.get(i);if(o!==void 0&&o.expiresAt>t())return o.profile;if(a.delete(i),a.size>=1e3){let e=a.keys().next().value;e!==void 0&&a.delete(e)}let s=t(),c=fetchSlackUserInfo(e,r).catch(t=>{logError(log,`Slack user lookup failed; omitting it`,t,{userId:e}),a.get(i)?.profile===c&&a.set(i,{expiresAt:s+6e4,profile:c})});return a.set(i,{expiresAt:s+36e5,profile:c}),c}:({userId:e,teamId:t,request:n})=>i({userId:e,teamId:t},()=>fetchSlackUserInfo(e,n));return async e=>{let t;try{let i=await Promise.race([o(e),new Promise(n=>{t=setTimeout(()=>{log.warn(`Slack user lookup timed out; omitting it`,{userId:e.userId}),n(void 0)},2e3)})]);if(i===void 0)return;let{displayName:a,realName:s,email:c}=i;return{...n&&a&&{displayName:a},...n&&s&&{realName:s},...r&&c&&{email:c}}}catch(t){logError(log,`Slack user lookup threw; omitting it`,t,{userId:e.userId});return}finally{clearTimeout(t)}}}async function resolveSlackUsers(e,t){let n=[...new Set(t.userIds)].slice(0,20),r=await Promise.all(n.map(async n=>{let r=await e({userId:n,teamId:t.teamId,request:t.request});return r===void 0?[]:[[n,r]]}));return new Map(r.flat())}async function withSlackUserInfo(e,t,n){let r=e.author;if(r===void 0||r.isBot)return e;let i=await t({userId:r.userId,...n});return i===void 0?e:{...e,author:{...r,fullName:i.realName??r.fullName,...i.displayName&&{displayName:i.displayName},...i.email&&{email:i.email}}}}async function fetchSlackUserInfo(e,t){let n=await t(`users.info`,{user:e});if(n.ok!==!0){let e=typeof n.error==`string`?n.error:`unknown_error`;throw Error(e===`missing_scope`?`Slack users.info failed with missing_scope: add the users:read scope (and users:read.email for emails), then reinstall the Slack app.`:`Slack users.info failed with ${e}.`)}return userInfoFromSlack(n.user)}function userInfoFromSlack(e){if(typeof e!=`object`||!e)return{};let t=e,n=typeof t.profile==`object`&&t.profile!==null?t.profile:{},r=nonEmpty(n.display_name),i=nonEmpty(n.real_name)??nonEmpty(t.real_name),a=nonEmpty(n.email);return{...r&&{displayName:r},...i&&{realName:i},...a&&{email:a}}}function nonEmpty(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{createSlackUserResolver,resolveSlackUsers,withSlackUserInfo};
@@ -52,9 +52,10 @@ export interface TeamsChannelState {
52
52
  tenantId: string | null;
53
53
  /** User account that triggered the latest turn/session. */
54
54
  triggeringUser: TeamsChannelAccount | null;
55
- /** What the default sign-in flow posted for each open sign-in, by connection name. */
56
- pendingAuthActivityIds?: Record<string, string>;
57
- pendingPromptCards?: Record<string, TeamsPendingPromptCard>;
55
+ /**
56
+ * Teams account behind each principal that sent a message or answer. The
57
+ * default handlers name who decided an approval and whom a sign-in is for.
58
+ */
58
59
  approvalResponderAccounts?: Record<string, TeamsChannelAccount>;
59
60
  }
60
61
  /** Teams channel credentials. */
@@ -17,17 +17,10 @@ export declare const TELEGRAM_CALLBACK_RESPONSE_PREFIX = "telegram_callback:";
17
17
  /** Synthetic request id prefix the deliver hook uses for replies to ForceReply prompts. */
18
18
  export declare const TELEGRAM_REPLY_RESPONSE_PREFIX = "telegram_reply:";
19
19
  /**
20
- * Durable HITL state. `hitlCallbacks` maps compact callback ids to their stored
21
- * `Answer`. `nextHitlCallbackId` is the monotonic id counter.
22
- * `pendingFreeformReplies` maps a posted prompt's message id to the awaiting
23
- * requestId.
20
+ * Durable state the Telegram channel keeps for posted input requests. Telegram
21
+ * caps `callback_data` at 64 bytes, so buttons carry compact ids instead of answers.
24
22
  */
25
23
  export interface TelegramHitlState {
26
- hitlCallbacks?: Record<string, Answer>;
27
- nextHitlCallbackId?: number;
28
- pendingFreeformReplies?: Record<string, string>;
29
- /** Posted prompts with inline keyboards, keyed by requestId, until eve resolves them. */
30
- hitlPrompts?: Record<string, TelegramHitlPrompt>;
31
24
  }
32
25
  /** What a posted prompt needs so its message can be edited once eve resolves it. */
33
26
  export interface TelegramHitlPrompt {
@@ -12,6 +12,6 @@ export interface TelegramInstrumentationMetadata extends Record<string, unknown>
12
12
  export { telegramChannel, type TelegramChannel, type TelegramChannelConfig, type TelegramChannelContext, type TelegramChannelCredentials, type TelegramChannelEvents, type TelegramChannelState, type TelegramContext, type TelegramEventContext, type TelegramHandle, type TelegramInboundResult, type TelegramReceiveTarget, } from "#public/channels/telegram/telegramChannel.js";
13
13
  export { telegramContinuationToken, type TelegramApiOptions, type TelegramApiResponse, type TelegramBotToken, type TelegramEphemeralMessageParameters, type TelegramFetch, type TelegramMessageBody, type TelegramMessageResult, } from "#public/channels/telegram/api.js";
14
14
  export { type TelegramAttachment, type TelegramCallbackQuery, type TelegramChat, type TelegramChatType, type TelegramInboundContext, type TelegramMessage, type TelegramMessageReference, type TelegramUpdate, type TelegramUser, } from "#public/channels/telegram/inbound.js";
15
- export { type TelegramHitlState, type TelegramInteractionMessage, } from "#public/channels/telegram/hitl.js";
15
+ export { type TelegramInteractionMessage } from "#public/channels/telegram/hitl.js";
16
16
  export { defaultTelegramAuth } from "#public/channels/telegram/defaults.js";
17
17
  export { type TelegramWebhookSecretToken, type TelegramWebhookVerifier, } from "#public/channels/telegram/verify.js";
@@ -42,8 +42,6 @@ export interface TelegramChannelState extends TelegramHitlState {
42
42
  * reads it from delivery state to answer a pending ForceReply prompt.
43
43
  */
44
44
  replyToBotMessageId?: string | null;
45
- /** Public authorization status messages, keyed by connection name. */
46
- pendingAuthMessageIds?: Record<string, string>;
47
45
  }
48
46
  /** Telegram channel credentials. `webhookVerifier` is a custom inbound webhook verifier for forwarded webhooks. */
49
47
  /** Target for `receive(telegram, { target })` proactive sessions. `chatId` is required. `conversationId` resumes an existing thread; `initialMessage` posts a seed message and starts a new thread from it. The two are mutually exclusive: supplying both throws. */
@@ -30,8 +30,6 @@ export interface TwilioChannelState extends PromptQueueState {
30
30
  lastMessageSid?: string | null;
31
31
  /** Most recent inbound Call SID when this session was started by voice. */
32
32
  lastCallSid?: string | null;
33
- /** The sign-ins the default flow sent a prompt for, by connection name. */
34
- pendingSignIns?: Record<string, string>;
35
33
  }
36
34
  /** Per-session instrumentation snapshot for Twilio runtime telemetry. Reports the active phone-number pair and the most recent message and call SIDs. */
37
35
  export interface TwilioInstrumentationMetadata extends Record<string, unknown> {
@@ -2,11 +2,6 @@ import type { ChannelDelivery } from "#shared/channel-delivery.js";
2
2
  import { type Logger } from "#internal/logging.js";
3
3
  /** Channel state that remembers a final reply the user never saw. */
4
4
  export interface UndeliveredReplyState {
5
- /**
6
- * Error id of a final reply that never reached the user. The next delivered
7
- * message tells the model the reply was not seen, then clears it.
8
- */
9
- undeliveredReplyErrorId?: string | null;
10
5
  }
11
6
  /** Where a channel's final reply failed, and how to post a notice there. */
12
7
  export interface UndeliveredReplySurface {
@@ -2,6 +2,12 @@ import type { PublicAgentDefinition, PublicAgentStaticModelDefinition } from "#s
2
2
  import type { ExactDefinition } from "#public/definitions/exact.js";
3
3
  import type { RemoteAgentDefinition } from "#public/definitions/remote-agent.js";
4
4
  import { defineDynamic as defineDynamicBase } from "#dynamic/definition.js";
5
+ /**
6
+ * Cross-instance brand stamped by {@link defineAgent}. The compiler rejects an `agent.ts` export
7
+ * without it, so a plain object can't pass for an agent definition. `Symbol.for` lets the
8
+ * compiler's module copy and the author's import share the key; a symbol key stays out of the
9
+ * `Object.keys`-based shape validators.
10
+ */
5
11
  declare const DEFINED_AGENT: unique symbol;
6
12
  export type { AgentModelOptionsDefinition, AgentReasoningDefinition, AgentBuildDefinition, AgentExperimentalDefinition, AgentLimitsDefinition, SessionUsageLimit, PublicAgentModelSelectionDefinition as AgentModelSelectionDefinition, AgentWorkflowDefinition, AgentWorkflowRetentionDefinition, AgentWorkflowWorldDefinition, PublicAgentModelDefinition as AgentModelDefinition, PublicAgentStaticModelDefinition as AgentStaticModelDefinition, PublicAgentCompactionDefinition as AgentCompactionDefinition, } from "#shared/agent-definition.js";
7
13
  /**
@@ -15,19 +21,19 @@ export type { AgentModelOptionsDefinition, AgentReasoningDefinition, AgentBuildD
15
21
  * channel uses to gate its `fetch` handler.
16
22
  */
17
23
  export type AgentDefinition = PublicAgentDefinition;
18
- /** Literal-preserving value returned by {@link defineAgent}. */
24
+ /** Literal-preserving value returned by {@link defineAgent}, carrying its brand. */
19
25
  export type DefinedAgent<TAgent extends AgentDefinition = AgentDefinition> = TAgent & {
20
26
  readonly [DEFINED_AGENT]: true;
21
27
  };
22
28
  /**
23
- * Agent configuration returned by a dynamic subagent resolver. The description
24
- * tells the parent agent when to delegate.
29
+ * Agent configuration returned by a dynamic subagent resolver: `defineAgent({ description, model })`.
30
+ * The description tells the parent agent when to delegate.
25
31
  */
26
- export type DynamicLocalSubagentDefinition = Extract<AgentDefinition, {
32
+ export type DynamicLocalSubagentDefinition = DefinedAgent<Extract<AgentDefinition, {
27
33
  readonly model: PublicAgentStaticModelDefinition;
28
34
  }> & {
29
35
  readonly description: string;
30
- };
36
+ }>;
31
37
  /** Definition a dynamic subagent resolver may select at runtime. */
32
38
  export type DynamicSubagentDefinition = DynamicLocalSubagentDefinition | RemoteAgentDefinition;
33
39
  /** What a dynamic subagent resolves to: the subagent, or `null` to omit it. */
@@ -48,8 +54,8 @@ export type DynamicSubagentResult = DynamicSubagentDefinition | null;
48
54
  */
49
55
  export declare const defineDynamic: typeof defineDynamicBase;
50
56
  /**
51
- * Defines the agent configuration authored in `agent.ts` and returns it
52
- * unchanged, preserving its literal type.
57
+ * Defines the agent configuration authored in `agent.ts`. Returns the same object, preserving its
58
+ * literal type, stamped with the brand the compiler requires: a plain object export is rejected.
53
59
  *
54
60
  * TypeScript checks the argument against {@link AgentDefinition}: any key outside
55
61
  * that shape is a compile error. The compiler derives identity (the agent name)
@@ -57,3 +63,5 @@ export declare const defineDynamic: typeof defineDynamicBase;
57
63
  * basename), so do not author a `name` field.
58
64
  */
59
65
  export declare function defineAgent<TAgent extends AgentDefinition>(definition: ExactDefinition<TAgent, AgentDefinition>): DefinedAgent<TAgent>;
66
+ /** Whether `value` came from {@link defineAgent}. */
67
+ export declare function isDefinedAgent(value: unknown): value is DefinedAgent;
@@ -1 +1 @@
1
- import{defineDynamic as defineDynamic$1}from"#dynamic/definition.js";const defineDynamic=defineDynamic$1;function defineAgent(e){return e}export{defineAgent,defineDynamic};
1
+ import{defineDynamic as defineDynamic$1}from"#dynamic/definition.js";const DEFINED_AGENT=Symbol.for(`eve.defined-agent`),defineDynamic=defineDynamic$1;function defineAgent(e){return Object.defineProperty(e,DEFINED_AGENT,{configurable:!0,value:!0}),e}function isDefinedAgent(e){return typeof e==`object`&&!!e&&Reflect.get(e,DEFINED_AGENT)===!0}export{defineAgent,defineDynamic,isDefinedAgent};
@@ -18,7 +18,7 @@ import type { FactPosition } from "#protocol/session-events/envelope.js";
18
18
  import { type SessionView } from "#protocol/session-projection/session-view.js";
19
19
  import type { GenericChannelDefinition, GenericReceiveInput } from "#shared/channel-definition.js";
20
20
  declare const CHANNEL_METADATA_TYPE: unique symbol;
21
- export type { CancelTurnResult, ClearSessionResult, CompactSessionResult, ResetSessionResult, SessionCallback, TurnPolicy, } from "#channel/types.js";
21
+ export type { CancelTurnResult, ClearSessionResult, CompactSessionResult, EndSessionResult, SessionCallback, TurnPolicy, } from "#channel/types.js";
22
22
  export { SessionStrandedError } from "#channel/session-stranded-error.js";
23
23
  export type { Session } from "#channel/session.js";
24
24
  export type { ChannelAudience } from "#shared/channel-audience.js";
@@ -77,16 +77,18 @@ export interface RouteContext {
77
77
  readonly requestIp: string | null;
78
78
  }
79
79
  /**
80
- * Marker discriminator written into every {@link DisabledRouteSentinel}.
80
+ * Cross-instance brand on a {@link DisabledRouteSentinel}. `Symbol.for` lets the compiler's module
81
+ * copy and the author's import share the key; keeping it unexported makes the sentinel opaque, so
82
+ * only {@link disableRoute} produces one.
81
83
  */
82
- declare const DISABLED_ROUTE_SENTINEL_KIND = "eve:disabled-channel";
84
+ declare const DISABLED_ROUTE: unique symbol;
83
85
  /**
84
- * Marker value returned from {@link disableRoute}. Export this as the
86
+ * Opaque value returned from {@link disableRoute}. Export this as the
85
87
  * default export of a file in `agent/channels/` to remove the framework
86
88
  * default route whose logical name matches the file's slug path.
87
89
  */
88
90
  export interface DisabledRouteSentinel {
89
- readonly kind: typeof DISABLED_ROUTE_SENTINEL_KIND;
91
+ readonly [DISABLED_ROUTE]: true;
90
92
  }
91
93
  /**
92
94
  * Returns a sentinel that disables the framework route whose logical name