eve 0.89.0 → 0.91.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 (247) hide show
  1. package/CHANGELOG.md +39 -9
  2. package/dist/src/channel/adapter.d.ts +12 -3
  3. package/dist/src/channel/adapter.js +1 -1
  4. package/dist/src/channel/auth/definitions.d.ts +7 -20
  5. package/dist/src/channel/auth/definitions.js +1 -1
  6. package/dist/src/channel/auth/http-basic.js +1 -1
  7. package/dist/src/channel/auth/jwt-ecdsa.js +1 -1
  8. package/dist/src/channel/auth/jwt-hmac.js +1 -1
  9. package/dist/src/channel/auth/oidc.js +1 -1
  10. package/dist/src/channel/auth/result.d.ts +2 -3
  11. package/dist/src/channel/auth/result.js +1 -1
  12. package/dist/src/channel/channel-address.d.ts +1 -1
  13. package/dist/src/channel/channel-address.js +1 -1
  14. package/dist/src/channel/channel-operations.d.ts +1 -1
  15. package/dist/src/channel/schedule.js +1 -1
  16. package/dist/src/channel/types.d.ts +2 -0
  17. package/dist/src/chunks/{use-eve-agent-Bbl4H5aA.js → use-eve-agent-Bwloorf8.js} +77 -63
  18. package/dist/src/chunks/{use-eve-agent-CNpxgKEH.js → use-eve-agent-XCB0-tLX.js} +77 -63
  19. package/dist/src/cli/dev/environment.js +1 -1
  20. package/dist/src/cli/dev/tui/prompt-commands.d.ts +1 -1
  21. package/dist/src/cli/dev/tui/remote-connection-probe.js +1 -1
  22. package/dist/src/cli/dev/tui/remote-connection-types.d.ts +1 -0
  23. package/dist/src/cli/dev/tui/runner.js +2 -2
  24. package/dist/src/cli/dev/tui/status-line.d.ts +2 -2
  25. package/dist/src/cli/dev/tui/status-line.js +1 -1
  26. package/dist/src/client/agent-info-schema.d.ts +341 -326
  27. package/dist/src/client/agent-info-schema.js +1 -1
  28. package/dist/src/client/agent-info-types.d.ts +13 -10
  29. package/dist/src/client/client-error.d.ts +1 -1
  30. package/dist/src/client/client.d.ts +5 -3
  31. package/dist/src/client/client.js +1 -1
  32. package/dist/src/client/session.d.ts +1 -1
  33. package/dist/src/compiled/.vendor-stamp.json +1 -1
  34. package/dist/src/evals/target.js +1 -1
  35. package/dist/src/eve-channel/auth.d.ts +19 -0
  36. package/dist/src/eve-channel/auth.js +1 -0
  37. package/dist/src/eve-channel/index.d.ts +1 -0
  38. package/dist/src/eve-channel/index.js +1 -1
  39. package/dist/src/eve-channel/types.d.ts +23 -4
  40. package/dist/src/execution/catalog/connection-entry.js +1 -1
  41. package/dist/src/execution/coordination-dispatch-shared.js +1 -1
  42. package/dist/src/execution/dynamic-workflow/tool.js +1 -1
  43. package/dist/src/execution/proxied-deliver-step.js +1 -1
  44. package/dist/src/execution/sandbox/bash.js +2 -2
  45. package/dist/src/execution/session/active-turn.js +1 -1
  46. package/dist/src/execution/session/admission.d.ts +6 -0
  47. package/dist/src/execution/session/admission.js +1 -1
  48. package/dist/src/execution/session/delivery-facts.js +1 -1
  49. package/dist/src/execution/session/next-input.d.ts +2 -2
  50. package/dist/src/execution/session/next-input.js +1 -1
  51. package/dist/src/execution/session/program.js +1 -1
  52. package/dist/src/execution/session-inbox/inbox.d.ts +2 -2
  53. package/dist/src/execution/session-inbox/inbox.js +1 -1
  54. package/dist/src/execution/session-inbox/protocol.js +1 -1
  55. package/dist/src/execution/tools/agent-router-workflow.js +1 -1
  56. package/dist/src/harness/compaction/engine.js +2 -2
  57. package/dist/src/harness/current-messages.js +1 -1
  58. package/dist/src/harness/emission.d.ts +3 -0
  59. package/dist/src/harness/emission.js +1 -1
  60. package/dist/src/harness/facts.d.ts +5 -2
  61. package/dist/src/harness/facts.js +1 -1
  62. package/dist/src/harness/model-call/call.d.ts +7 -1
  63. package/dist/src/harness/model-call/call.js +3 -1
  64. package/dist/src/harness/provider-tool-history.d.ts +8 -0
  65. package/dist/src/harness/provider-tool-history.js +1 -1
  66. package/dist/src/harness/session-machine/transitions.d.ts +3 -2
  67. package/dist/src/harness/step/after-model.js +1 -1
  68. package/dist/src/harness/step/context.js +1 -1
  69. package/dist/src/harness/step/intake.js +1 -1
  70. package/dist/src/harness/step/prompt.js +1 -1
  71. package/dist/src/harness/tool-history-repair.d.ts +2 -0
  72. package/dist/src/harness/tool-history-repair.js +1 -1
  73. package/dist/src/harness/tool-loop.js +1 -1
  74. package/dist/src/internal/application/stamped-package-version.js +1 -1
  75. package/dist/src/internal/authored-module-graph.js +1 -1
  76. package/dist/src/internal/nitro/routes/agent-info/build-agent-info-response.d.ts +2 -2
  77. package/dist/src/protocol/routes.d.ts +7 -1
  78. package/dist/src/protocol/routes.js +1 -1
  79. package/dist/src/protocol/session-events/families/delivery.d.ts +5 -3
  80. package/dist/src/protocol/session-events/families/delivery.js +1 -1
  81. package/dist/src/protocol/session-projection/fold.js +1 -1
  82. package/dist/src/public/channels/discord/hitl.js +1 -1
  83. package/dist/src/public/channels/github/githubChannel.js +1 -1
  84. package/dist/src/public/channels/github/state.d.ts +7 -0
  85. package/dist/src/public/channels/github/state.js +1 -1
  86. package/dist/src/public/channels/mcp.js +1 -1
  87. package/dist/src/public/channels/slack/hitl.d.ts +2 -1
  88. package/dist/src/public/channels/slack/hitl.js +3 -3
  89. package/dist/src/public/channels/slack/interaction-cards.js +1 -1
  90. package/dist/src/public/channels/slack/request-card-render.js +1 -1
  91. package/dist/src/public/channels/teams/hitl.js +1 -1
  92. package/dist/src/public/channels/teams/verify.js +1 -1
  93. package/dist/src/public/channels/telegram/telegramChannel.js +1 -1
  94. package/dist/src/public/connections/index.d.ts +1 -1
  95. package/dist/src/public/definitions/channel.js +1 -1
  96. package/dist/src/public/definitions/connections/tool-call.d.ts +2 -2
  97. package/dist/src/public/definitions/hook.d.ts +90 -7
  98. package/dist/src/public/definitions/hook.js +1 -1
  99. package/dist/src/public/hooks/index.d.ts +3 -2
  100. package/dist/src/reactions/continuation.d.ts +19 -0
  101. package/dist/src/reactions/continuation.js +1 -0
  102. package/dist/src/reactions/frame.js +1 -1
  103. package/dist/src/reactions/intents.d.ts +10 -4
  104. package/dist/src/reactions/intents.js +1 -1
  105. package/dist/src/reactions/kinds/hook.js +1 -1
  106. package/dist/src/reactions/runner.js +1 -1
  107. package/dist/src/reactions/state.d.ts +15 -2
  108. package/dist/src/reactions/state.js +1 -1
  109. package/dist/src/runtime/channels/registry.d.ts +2 -2
  110. package/dist/src/runtime/channels/registry.js +1 -1
  111. package/dist/src/runtime/connections/approval-scope.d.ts +9 -0
  112. package/dist/src/runtime/connections/approval-scope.js +1 -0
  113. package/dist/src/runtime/connections/mcp-client.d.ts +1 -1
  114. package/dist/src/runtime/connections/mcp-client.js +1 -1
  115. package/dist/src/runtime/connections/provided-arguments.js +1 -1
  116. package/dist/src/runtime/resolve-connection.js +1 -1
  117. package/dist/src/runtime/subagents/workflow.js +1 -1
  118. package/dist/src/setup/primitives/open-url.js +1 -1
  119. package/dist/src/setup/scaffold/create/project.js +1 -1
  120. package/dist/src/shared/agent-info-access.d.ts +5 -0
  121. package/dist/src/shared/agent-info-access.js +1 -0
  122. package/dist/src/shared/connection-types.d.ts +21 -4
  123. package/dist/src/shared/value-delta.d.ts +5 -4
  124. package/dist/src/shared/value-delta.js +1 -1
  125. package/dist/src/svelte/index.js +1 -1
  126. package/dist/src/svelte/use-eve-agent.js +1 -1
  127. package/dist/src/tools/provided/ask-question-workflow.js +1 -1
  128. package/dist/src/tools/provided/sleep-workflow.js +1 -1
  129. package/dist/src/tools/provided/web-fetch.js +1 -1
  130. package/dist/src/vue/index.js +1 -1
  131. package/dist/src/vue/use-eve-agent.js +1 -1
  132. package/docs/agent-config.md +199 -222
  133. package/docs/channels/chat-sdk.mdx +60 -64
  134. package/docs/channels/custom.mdx +265 -280
  135. package/docs/channels/discord.mdx +176 -123
  136. package/docs/channels/eve.mdx +136 -204
  137. package/docs/channels/github.mdx +24 -22
  138. package/docs/channels/linear.mdx +30 -30
  139. package/docs/channels/linq.mdx +25 -13
  140. package/docs/channels/mcp.mdx +154 -116
  141. package/docs/channels/overview.mdx +31 -32
  142. package/docs/channels/photon.mdx +32 -56
  143. package/docs/channels/slack.mdx +538 -375
  144. package/docs/channels/teams.mdx +40 -26
  145. package/docs/channels/telegram.mdx +13 -13
  146. package/docs/channels/twilio.mdx +11 -11
  147. package/docs/code-extension.mdx +40 -42
  148. package/docs/concepts/built-in-tools.md +89 -57
  149. package/docs/concepts/context-control.md +20 -20
  150. package/docs/concepts/default-harness.md +20 -36
  151. package/docs/concepts/execution-model-and-durability.mdx +96 -160
  152. package/docs/concepts/project-structure.mdx +21 -14
  153. package/docs/concepts/security-model.md +27 -27
  154. package/docs/concepts/sessions-runs-and-streaming.md +184 -194
  155. package/docs/concepts/state.md +7 -15
  156. package/docs/connections/mcp.mdx +109 -93
  157. package/docs/connections/openapi.mdx +57 -59
  158. package/docs/connections/overview.mdx +205 -170
  159. package/docs/evals/assertions.mdx +36 -29
  160. package/docs/evals/cases.mdx +38 -42
  161. package/docs/evals/judge.mdx +21 -29
  162. package/docs/evals/overview.mdx +42 -38
  163. package/docs/evals/reporters.mdx +54 -27
  164. package/docs/evals/running.mdx +15 -8
  165. package/docs/evals/targets.mdx +17 -18
  166. package/docs/evals/tool-stubs.mdx +111 -97
  167. package/docs/experimental/dynamic-schedules.mdx +118 -63
  168. package/docs/extensions.md +58 -65
  169. package/docs/getting-started.mdx +4 -6
  170. package/docs/guides/auth-and-route-protection.md +100 -70
  171. package/docs/guides/client/continuations.mdx +23 -26
  172. package/docs/guides/client/messages.mdx +47 -66
  173. package/docs/guides/client/output-schema.mdx +8 -8
  174. package/docs/guides/client/overview.mdx +47 -41
  175. package/docs/guides/client/streaming.mdx +62 -71
  176. package/docs/guides/decide.md +24 -79
  177. package/docs/guides/deployment/meta.json +1 -1
  178. package/docs/guides/deployment/overview.md +27 -18
  179. package/docs/guides/deployment/self-hosted-operations.md +99 -0
  180. package/docs/guides/deployment/self-hosting.md +63 -80
  181. package/docs/guides/deployment/vercel.mdx +31 -27
  182. package/docs/guides/deployment/workflow-worlds.md +100 -0
  183. package/docs/guides/dev-tui.md +48 -41
  184. package/docs/guides/dynamic-capabilities.md +49 -50
  185. package/docs/guides/frontend/nextjs.mdx +2 -2
  186. package/docs/guides/frontend/nuxt.mdx +11 -11
  187. package/docs/guides/frontend/overview.mdx +1 -1
  188. package/docs/guides/frontend/sveltekit.mdx +11 -11
  189. package/docs/guides/frontend/tanstack.mdx +16 -16
  190. package/docs/guides/frontend/use-eve-agent-svelte.mdx +21 -21
  191. package/docs/guides/frontend/use-eve-agent-vue.mdx +22 -22
  192. package/docs/guides/frontend/use-eve-agent.mdx +25 -25
  193. package/docs/guides/hooks.md +152 -106
  194. package/docs/guides/instrumentation/agent-runs.mdx +26 -30
  195. package/docs/guides/instrumentation/instrumentation.mdx +49 -76
  196. package/docs/guides/instrumentation/meta.json +1 -1
  197. package/docs/guides/instrumentation/otel.mdx +113 -179
  198. package/docs/guides/prepare-for-1-0.md +23 -1
  199. package/docs/guides/remote-agents.md +125 -187
  200. package/docs/guides/self-modification.md +18 -18
  201. package/docs/guides/session-context.md +16 -16
  202. package/docs/install-integrations.mdx +26 -24
  203. package/docs/instructions.mdx +37 -42
  204. package/docs/memory/custom-provider.md +35 -41
  205. package/docs/memory/file.md +93 -76
  206. package/docs/memory/overview.mdx +145 -156
  207. package/docs/patterns/durable-cross-channel-notifications.md +15 -19
  208. package/docs/patterns/dynamic-scheduling.md +19 -23
  209. package/docs/patterns/multi-tenant-approvals.md +17 -22
  210. package/docs/patterns/multi-tenant-auth.md +43 -42
  211. package/docs/patterns/multi-tenant-memory.md +39 -36
  212. package/docs/patterns/voice-notes.md +3 -3
  213. package/docs/protocols/acp.md +13 -13
  214. package/docs/protocols/ucp.mdx +7 -7
  215. package/docs/reference/agent-files.md +6 -6
  216. package/docs/reference/cli.md +99 -98
  217. package/docs/reference/telemetry.md +1 -1
  218. package/docs/reference/typescript-api.md +52 -53
  219. package/docs/responsible-use.md +2 -2
  220. package/docs/sandbox/custom-providers.mdx +60 -56
  221. package/docs/sandbox/default.mdx +23 -24
  222. package/docs/sandbox/docker.mdx +16 -10
  223. package/docs/sandbox/index.mdx +93 -61
  224. package/docs/sandbox/just-bash.mdx +17 -11
  225. package/docs/sandbox/troubleshooting.mdx +29 -23
  226. package/docs/sandbox/vercel.mdx +45 -52
  227. package/docs/schedules.mdx +65 -54
  228. package/docs/skills.mdx +74 -49
  229. package/docs/subagents/index.mdx +97 -136
  230. package/docs/tools/human-in-the-loop.md +160 -90
  231. package/docs/tools/meta.json +1 -1
  232. package/docs/tools/overview.mdx +229 -237
  233. package/docs/tools/tasks.md +118 -117
  234. package/docs/tools/workflows.mdx +447 -543
  235. package/docs/tutorial/connect-a-warehouse.mdx +11 -13
  236. package/docs/tutorial/first-agent.mdx +14 -16
  237. package/docs/tutorial/guard-the-spend.mdx +6 -8
  238. package/docs/tutorial/how-it-runs.mdx +8 -8
  239. package/docs/tutorial/query-sample-data.mdx +8 -8
  240. package/docs/tutorial/remember-definitions.mdx +4 -4
  241. package/docs/tutorial/run-analysis.mdx +20 -22
  242. package/docs/tutorial/ship-it.mdx +19 -19
  243. package/docs/tutorial/team-playbooks.mdx +9 -9
  244. package/docs/use-cases.mdx +13 -11
  245. package/package.json +1 -1
  246. package/docs/guides/instrumentation/migration.md +0 -96
  247. package/docs/tools/tasks-upgrade.md +0 -218
@@ -3,9 +3,9 @@ import type { AgentInfoManifestData } from "#internal/nitro/routes/agent-info/lo
3
3
  import { type GatewayCredentialPresence } from "#internal/resolve-model-endpoint-status.js";
4
4
  import type { ChatGptAuthState } from "#public/models/openai/chatgpt/token-broker.js";
5
5
  export type AgentInfoResponse = AgentInfoResult;
6
- /** Projects v4 exclusively from the effective compiled graph. */
6
+ /** Projects agent info exclusively from the effective compiled graph. */
7
7
  export declare function buildAgentInfoResponse(data: AgentInfoManifestData, input: {
8
- readonly mode: AgentInfoResponse["mode"];
8
+ readonly mode: "development" | "production";
9
9
  readonly gatewayCredentials: GatewayCredentialPresence;
10
10
  readonly chatgptAuth?: ChatGptAuthState;
11
11
  }): AgentInfoResponse;
@@ -12,9 +12,15 @@ export declare const EVE_HEALTH_ROUTE_PATH = "/eve/v1/health";
12
12
  /**
13
13
  * Stable framework-owned route exposing the JSON inspection payload for
14
14
  * the current agent. The eve channel registers and authenticates this route
15
- * with the same `auth` input as its session routes.
15
+ * with the same `auth` input as its session routes, then serves operator
16
+ * principals (`service`, `runtime`, or `local-dev`) unless the auth result
17
+ * sets `allowAgentInfo`.
16
18
  */
17
19
  export declare const EVE_INFO_ROUTE_PATH = "/eve/v1/info";
20
+ /** Error code the info route returns with `403` to a caller it does not serve. */
21
+ export declare const AGENT_INFO_FORBIDDEN_CODE = "info_forbidden";
22
+ /** Why the info route refused a caller and how to grant access; shared by server and clients. */
23
+ export declare const AGENT_INFO_FORBIDDEN_MESSAGE = "Agent info is served only to operator credentials (principalType \"service\", \"runtime\", or \"local-dev\"). Authenticate as a service principal, for example with Vercel OIDC, or return allowAgentInfo: true from the eve channel's auth for this caller.";
18
24
  /** Stable route for creating ID-addressed sessions. */
19
25
  export declare const EVE_SESSION_ROUTE_PATH = "/eve/v1/session";
20
26
  /** Stable route pattern for preparing or delivering input to one exact session ID. */
@@ -1 +1 @@
1
- const EVE_ROUTE_PREFIX=`/eve/v1`,EVE_PRODUCTION_CRON_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/cron/:token`,EVE_HEALTH_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/health`,EVE_INFO_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/info`,EVE_SESSION_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/session`,EVE_SESSION_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId`,EVE_SESSION_CANCEL_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/cancel`,EVE_SESSION_COMPACT_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/compact`,EVE_SESSION_CLEAR_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/clear`,EVE_SESSION_END_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/end`,EVE_SESSION_RESET_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/reset`,EVE_SESSION_STUBS_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/stubs`,EVE_SESSION_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/stream`,EVE_DESCENDANT_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/descendants/stream`;function createEveDescendantStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/descendants/stream`}const EVE_SUBAGENT_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:parentSessionId/subagents/:callId/:childSessionId/stream`,EVE_DEV_DISPATCH_SCHEDULE_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/dev/schedules/:scheduleId`,EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/dev/runtime-artifacts`,EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`,EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`,EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;function createEveDevDispatchSchedulePath(e){return`${EVE_ROUTE_PREFIX}/dev/schedules/${encodeURIComponent(e)}`}const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`,EVE_CALLBACK_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/callback/:token`;function createEveSessionRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}`}function createEveSessionCancelRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/cancel`}function createEveSubagentStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e.parentSessionId)}/subagents/${encodeURIComponent(e.callId)}/${encodeURIComponent(e.childSessionId)}/stream`}function createEveSessionCompactRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/compact`}function createEveSessionClearRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/clear`}function createEveSessionEndRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/end`}function createEveSessionResetRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/reset`}function createEveSessionStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/stream`}function createEveConnectionCallbackRoutePath(e,t,n){return`${EVE_ROUTE_PREFIX}/connections/${encodeURIComponent(e)}/callback/${encodeURIComponent(t)}/${encodeURIComponent(n)}`}function createEveCallbackRoutePath(e){return`${EVE_ROUTE_PREFIX}/callback/${encodeURIComponent(e)}`}function createEveSessionStubsRoutePath(e){return`${createEveSessionRoutePath(e)}/stubs`}export{EVE_CALLBACK_ROUTE_PATTERN,EVE_CONNECTION_CALLBACK_ROUTE_PATTERN,EVE_DESCENDANT_STREAM_ROUTE_PATTERN,EVE_DEV_DISPATCH_SCHEDULE_ROUTE_PATTERN,EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH,EVE_HEALTH_ROUTE_PATH,EVE_INFO_ROUTE_PATH,EVE_PRODUCTION_CRON_ROUTE_PATTERN,EVE_ROUTE_PREFIX,EVE_SESSION_CANCEL_ROUTE_PATTERN,EVE_SESSION_CLEAR_ROUTE_PATTERN,EVE_SESSION_COMPACT_ROUTE_PATTERN,EVE_SESSION_END_ROUTE_PATTERN,EVE_SESSION_RESET_ROUTE_PATTERN,EVE_SESSION_ROUTE_PATH,EVE_SESSION_ROUTE_PATTERN,EVE_SESSION_STREAM_ROUTE_PATTERN,EVE_SESSION_STUBS_ROUTE_PATTERN,EVE_SUBAGENT_STREAM_ROUTE_PATTERN,createEveCallbackRoutePath,createEveConnectionCallbackRoutePath,createEveDescendantStreamRoutePath,createEveDevDispatchSchedulePath,createEveSessionCancelRoutePath,createEveSessionClearRoutePath,createEveSessionCompactRoutePath,createEveSessionEndRoutePath,createEveSessionResetRoutePath,createEveSessionRoutePath,createEveSessionStreamRoutePath,createEveSessionStubsRoutePath,createEveSubagentStreamRoutePath};
1
+ const EVE_ROUTE_PREFIX=`/eve/v1`,EVE_PRODUCTION_CRON_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/cron/:token`,EVE_HEALTH_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/health`,EVE_INFO_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/info`,AGENT_INFO_FORBIDDEN_CODE=`info_forbidden`,AGENT_INFO_FORBIDDEN_MESSAGE=`Agent info is served only to operator credentials (principalType "service", "runtime", or "local-dev"). Authenticate as a service principal, for example with Vercel OIDC, or return allowAgentInfo: true from the eve channel's auth for this caller.`,EVE_SESSION_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/session`,EVE_SESSION_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId`,EVE_SESSION_CANCEL_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/cancel`,EVE_SESSION_COMPACT_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/compact`,EVE_SESSION_CLEAR_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/clear`,EVE_SESSION_END_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/end`,EVE_SESSION_RESET_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/reset`,EVE_SESSION_STUBS_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/stubs`,EVE_SESSION_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/stream`,EVE_DESCENDANT_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:sessionId/descendants/stream`;function createEveDescendantStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/descendants/stream`}const EVE_SUBAGENT_STREAM_ROUTE_PATTERN=`${EVE_SESSION_ROUTE_PATH}/:parentSessionId/subagents/:callId/:childSessionId/stream`,EVE_DEV_DISPATCH_SCHEDULE_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/dev/schedules/:scheduleId`,EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH=`${EVE_ROUTE_PREFIX}/dev/runtime-artifacts`,EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/rebuild`,EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/suspend`,EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH=`${EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH}/resume`;function createEveDevDispatchSchedulePath(e){return`${EVE_ROUTE_PREFIX}/dev/schedules/${encodeURIComponent(e)}`}const EVE_CONNECTION_CALLBACK_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/connections/:name/callback/:attemptId/:token`,EVE_CALLBACK_ROUTE_PATTERN=`${EVE_ROUTE_PREFIX}/callback/:token`;function createEveSessionRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}`}function createEveSessionCancelRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/cancel`}function createEveSubagentStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e.parentSessionId)}/subagents/${encodeURIComponent(e.callId)}/${encodeURIComponent(e.childSessionId)}/stream`}function createEveSessionCompactRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/compact`}function createEveSessionClearRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/clear`}function createEveSessionEndRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/end`}function createEveSessionResetRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/reset`}function createEveSessionStreamRoutePath(e){return`${EVE_SESSION_ROUTE_PATH}/${encodeURIComponent(e)}/stream`}function createEveConnectionCallbackRoutePath(e,t,n){return`${EVE_ROUTE_PREFIX}/connections/${encodeURIComponent(e)}/callback/${encodeURIComponent(t)}/${encodeURIComponent(n)}`}function createEveCallbackRoutePath(e){return`${EVE_ROUTE_PREFIX}/callback/${encodeURIComponent(e)}`}function createEveSessionStubsRoutePath(e){return`${createEveSessionRoutePath(e)}/stubs`}export{AGENT_INFO_FORBIDDEN_CODE,AGENT_INFO_FORBIDDEN_MESSAGE,EVE_CALLBACK_ROUTE_PATTERN,EVE_CONNECTION_CALLBACK_ROUTE_PATTERN,EVE_DESCENDANT_STREAM_ROUTE_PATTERN,EVE_DEV_DISPATCH_SCHEDULE_ROUTE_PATTERN,EVE_DEV_RUNTIME_ARTIFACTS_REBUILD_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_RESUME_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_ROUTE_PATH,EVE_DEV_RUNTIME_ARTIFACTS_SUSPEND_ROUTE_PATH,EVE_HEALTH_ROUTE_PATH,EVE_INFO_ROUTE_PATH,EVE_PRODUCTION_CRON_ROUTE_PATTERN,EVE_ROUTE_PREFIX,EVE_SESSION_CANCEL_ROUTE_PATTERN,EVE_SESSION_CLEAR_ROUTE_PATTERN,EVE_SESSION_COMPACT_ROUTE_PATTERN,EVE_SESSION_END_ROUTE_PATTERN,EVE_SESSION_RESET_ROUTE_PATTERN,EVE_SESSION_ROUTE_PATH,EVE_SESSION_ROUTE_PATTERN,EVE_SESSION_STREAM_ROUTE_PATTERN,EVE_SESSION_STUBS_ROUTE_PATTERN,EVE_SUBAGENT_STREAM_ROUTE_PATTERN,createEveCallbackRoutePath,createEveConnectionCallbackRoutePath,createEveDescendantStreamRoutePath,createEveDevDispatchSchedulePath,createEveSessionCancelRoutePath,createEveSessionClearRoutePath,createEveSessionCompactRoutePath,createEveSessionEndRoutePath,createEveSessionResetRoutePath,createEveSessionRoutePath,createEveSessionStreamRoutePath,createEveSessionStubsRoutePath,createEveSubagentStreamRoutePath};
@@ -1,13 +1,15 @@
1
1
  import { z } from "#compiled/zod/index.js";
2
2
  import type { Envelope, Principal, UserPart } from "../envelope.js";
3
3
  /**
4
- * Where a delivery came from: a channel (with the schedule that sent it), a control, or a
5
- * sign-in callback. The set is open. A parent session records which of its calls sent a child's
6
- * delivery on its own `child.sent`.
4
+ * Where a delivery came from: a channel (with the schedule or hook that sent it), a control, or a
5
+ * sign-in callback. A hook's `ctx.continue()` names the hook's slug and the session's channel.
6
+ * The set is open. A parent session records which of its calls sent a child's delivery on its own
7
+ * `child.sent`.
7
8
  */
8
9
  export type DeliverySource = {
9
10
  readonly channel: string;
10
11
  readonly scheduleId?: string;
12
+ readonly hook?: string;
11
13
  } | {
12
14
  readonly control: string;
13
15
  } | {
@@ -1 +1 @@
1
- import{conforming,envelopeOf,id,known,principal,userPart}from"../common.js";import{z}from"#compiled/zod/index.js";const deliverySource=conforming()(z.union([z.object({channel:z.string(),scheduleId:z.string().optional()}),z.object({control:z.string()}),z.object({callback:z.string()})])),importedMessage=conforming()(z.object({id:z.string().optional(),role:z.enum([`user`,`assistant`]),text:z.string()})),deliverySchemas={"delivery.admitted":envelopeOf(`delivery.admitted`,conforming()(z.object({deliveryId:id,principal:principal.optional(),source:deliverySource.optional()}))),"delivery.consumed":envelopeOf(`delivery.consumed`,conforming()(z.object({deliveryId:id,history:z.array(importedMessage).optional(),parts:z.array(userPart),turnId:id}))),"delivery.settled":envelopeOf(`delivery.settled`,conforming()(z.object({deliveryId:id,outcome:known(),reason:z.string().optional(),turnId:id.optional()})))};export{deliverySchemas};
1
+ import{conforming,envelopeOf,id,known,principal,userPart}from"../common.js";import{z}from"#compiled/zod/index.js";const deliverySource=conforming()(z.union([z.object({channel:z.string(),scheduleId:z.string().optional(),hook:z.string().optional()}),z.object({control:z.string()}),z.object({callback:z.string()})])),importedMessage=conforming()(z.object({id:z.string().optional(),role:z.enum([`user`,`assistant`]),text:z.string()})),deliverySchemas={"delivery.admitted":envelopeOf(`delivery.admitted`,conforming()(z.object({deliveryId:id,principal:principal.optional(),source:deliverySource.optional()}))),"delivery.consumed":envelopeOf(`delivery.consumed`,conforming()(z.object({deliveryId:id,history:z.array(importedMessage).optional(),parts:z.array(userPart),turnId:id}))),"delivery.settled":envelopeOf(`delivery.settled`,conforming()(z.object({deliveryId:id,outcome:known(),reason:z.string().optional(),turnId:id.optional()})))};export{deliverySchemas};
@@ -1 +1 @@
1
- import{FACT_CATALOG,isFactType,isProgressType}from"#protocol/session-events/catalog.js";import{isOpen,parentOf,refOf,tableOf,turnOf}from"#protocol/session-projection/tree.js";import{isObject}from"#protocol/session-events/json.js";const ZERO={cacheReadTokens:0,cacheWriteTokens:0,inputTokens:0,outputTokens:0};function dictionary(e){return Object.assign(Object.create(null),e)}function emptySessionView(){return{calls:dictionary(),changes:dictionary(),children:dictionary(),deliveries:dictionary(),interactions:dictionary(),parts:dictionary(),position:0,responses:dictionary(),runs:dictionary(),session:{status:`new`,turnCount:0},tasks:dictionary(),turns:dictionary(),usage:{byKind:dictionary(),total:ZERO}}}function emptyPreviews(){return{calls:dictionary(),parts:dictionary()}}function foldLine(e,t,n,r={}){let i=e;if(n<i.position)return;r.retention===`operational`&&prune(i,r.keep),i.position=n+1;let a=r.previews;if(`progress`in t){a!==void 0&&foldProgress(i,a,t.progress);return}if(Array.isArray(t.facts))for(let e of t.facts)foldFact(i,a,e,{at:t.at,position:n})}function foldLines(e,t,n,r={}){let i=n;for(let n of t)foldLine(e,n,i,r),i+=1}function foldEvents(e,t,n={}){let r=0;for(;r<t.length;){let i=t[r].meta.position.line,a=r+1;for(;a<t.length&&t[a].meta.position.line===i;)a+=1;let o=t.slice(r,a);if(o.at(-1).meta.endOfLine===!1)return t.slice(r);let s=o[0];foldLine(e,o.length===1&&isProgressType(s.type)?{progress:s}:{at:s.meta.at,facts:o},i,n),r=a}return[]}function viewOfEvents(e){let t=emptySessionView(),n=emptyPreviews();return foldEvents(t,e,{previews:n}),{previews:n,view:t}}function copyView(e){return{...e,calls:dictionary(e.calls),changes:dictionary(e.changes),children:dictionary(e.children),deliveries:dictionary(e.deliveries),interactions:dictionary(e.interactions),parts:dictionary(e.parts),responses:dictionary(e.responses),runs:dictionary(e.runs),tasks:dictionary(e.tasks),turns:dictionary(e.turns)}}function foldReceivedEvent(e,t,n){let r=e,i=t.meta?.position?.line??r.position;if(i<r.position)return;let a=n;isFactType(t.type)?foldFact(r,a,t,{at:t.meta?.at??``,position:i}):a!==void 0&&isProgressType(t.type)&&foldProgress(r,a,t),t.meta?.endOfLine!==!1&&(r.position=i+1)}function foldFact(e,t,n,r){if(typeof n!=`object`||!n)return;let i=n;if(isFactType(i.type)&&i.data!==null&&typeof i.data==`object`&&e.session.status!==`ended`&&(i.type!==`model.requested`&&i.type!==`call.requested`&&i.type!==`child.opened`||isObject(i.data.owner))){if(foldLifecycle(e,i,{introducedAt:r.position,startedAt:r.at},r)){foldSpecifics(e,t,i,r);return}switch(i.type){case`session.started`:{if(e.session.status!==`new`)return;let{parent:t,runtime:n}=i.data;e.session={...e.session,parent:t,runtime:n,startedAt:r.at,status:`open`};return}case`session.ended`:{let{cause:t,error:n,outcome:a}=i.data;if(typeof a!=`string`)return;e.session={...e.session,cause:t,closedAt:r.position,endedAt:r.at,error:n,outcome:a,status:`ended`};return}case`child.sent`:{let{callId:t,childDeliveryId:n,sessionId:r}=i.data,a=e.children[r];if(a===void 0||a.deliveries?.some(e=>e.deliveryId===n))return;e.children[r]={...a,deliveries:[...a.deliveries??[],{callId:t,deliveryId:n}]};return}case`usage.recorded`:{let{kind:t,owner:n,usage:r}=i.data;if(typeof r!=`object`||!r||(e.usage=addToTotals(e.usage,t,r),!isObject(n)))return;if(`runId`in n){let t=e.runs[n.runId];t!==void 0&&(e.runs[t.runId]={...t,usage:addUsage(t.usage,r)})}else if(`callId`in n){let t=e.calls[n.callId];t!==void 0&&(e.calls[t.callId]={...t,usage:addUsage(t.usage,r)})}return}}}}const LIFECYCLE={"call.requested":{status:`requested`,table:`calls`},"call.settled":{status:`settled`,table:`calls`},"call.started":{from:`requested`,status:`running`,table:`calls`},"child.opened":{table:`children`},"content.completed":{table:`parts`},"context.settled":{status:`settled`,table:`changes`},"context.started":{status:`running`,table:`changes`},"delivery.admitted":{status:`admitted`,table:`deliveries`},"delivery.consumed":{from:`admitted`,omit:[`history`],status:`consumed`,table:`deliveries`},"delivery.settled":{status:`settled`,table:`deliveries`},"interaction.opened":{status:`open`,table:`interactions`},"interaction.settled":{status:`settled`,table:`interactions`},"model.requested":{status:`requested`,table:`runs`},"model.settled":{status:`settled`,table:`runs`},"model.started":{status:`running`,table:`runs`},"response.admitted":{from:`submitted`,status:`admitted`,table:`responses`},"response.settled":{status:`settled`,table:`responses`},"response.submitted":{status:`submitted`,table:`responses`},"task.ended":{status:`ended`,table:`tasks`},"task.started":{status:`running`,table:`tasks`},"turn.settled":{rename:{cause:`endedBy`},status:`settled`,table:`turns`},"turn.started":{omit:[`trace`],status:`running`,table:`turns`}},FOLD_FIELDS=new Set([`introducedAt`,`startedAt`,`closedAt`,`endedAt`,`consumedAt`,`step`,`runs`,`status`]);function foldLifecycle(e,t,n,r){let i=LIFECYCLE[t.type];if(i===void 0)return!1;let{idField:a,role:o}=FACT_CATALOG[t.type],s=Object.fromEntries(Object.entries(t.data).flatMap(([e,t])=>i.omit?.includes(e)===!0||FOLD_FIELDS.has(e)?[]:[[i.rename?.[e]??e,t]])),c=s[a];if(typeof c!=`string`)return!1;let l=e[i.table],u=l[c],d=i.status===void 0?{}:{status:i.status},closed=e=>e.status===`settled`||e.status===`ended`;switch(o){case`introduces`:case`complete`:return u===void 0&&(l[c]={...n,...s,...d},!0);case`updates`:return u===void 0||(i.from===void 0?closed(u):u.status!==i.from)?!1:(l[c]={...u,...s,...d},!0);case`terminal`:return u===void 0||closed(u)||typeof s.outcome!=`string`?!1:(l[c]={...u,...s,closedAt:r.position,endedAt:r.at,...d},!0);default:return!1}}function foldSpecifics(e,t,n,r){switch(n.type){case`delivery.consumed`:{let t=e.deliveries[n.data.deliveryId];e.deliveries[t.deliveryId]={...t,consumedAt:r.position};return}case`turn.started`:e.session={...e.session,latestTurnId:n.data.turnId,turnCount:e.session.turnCount+1},delete e.selection;return;case`model.requested`:{let{owner:t,runId:r}=n.data,i=`turnId`in t?e.turns[t.turnId]:void 0;if(i===void 0)return;let a=i.runs??0;e.turns[i.turnId]={...i,runs:a+1},e.runs[r]={...e.runs[r],step:a};return}case`model.settled`:t!==void 0&&dropRunPreviews(e,t,n.data.runId);return;case`call.requested`:case`call.settled`:t!==void 0&&delete t.calls[n.data.callId];return;case`content.completed`:{let{partId:r,phase:i,runId:a}=n.data;t!==void 0&&delete t.parts[r];let o=e.runs[a]?.owner,s=o!==void 0&&`turnId`in o?e.turns[o.turnId]:void 0;if(i===`reply`&&s!==void 0&&s.status!==`settled`){let t=(s.reply??[]).filter(t=>e.parts[t]?.runId===a);e.turns[s.turnId]={...s,reply:[...t,r]}}return}case`context.settled`:{let{outcome:t,selects:r}=n.data;t===`completed`&&`selects`in n.data&&r!==void 0&&(e.selection=r);return}}}function foldProgress(e,t,n){if(typeof n!=`object`||!n)return;let r=n;if(isProgressType(r.type)&&r.data!==null&&typeof r.data==`object`&&e.session.status!==`ended`)switch(r.type){case`content.delta`:{let{delta:n,kind:i,partId:a}=r.data;if(e.parts[a]!==void 0||typeof n!=`string`)return;let o=t.parts[a];o===void 0?i!==void 0&&(t.parts[a]={kind:i,partId:a,runId:r.scope?.runId,text:n}):t.parts[a]={...o,text:o.text+n};return}case`call.input`:{let{callId:n,delta:i,kind:a,name:o}=r.data;if(e.calls[n]!==void 0||typeof i!=`string`)return;let s=t.calls[n];if(s!==void 0)t.calls[n]={...s,input:s.input+i};else if(o!==void 0){let e={callId:n,input:i,name:o,runId:r.scope?.runId};t.calls[n]=a===void 0?e:{...e,kind:a}}return}case`call.progress`:{let{callId:n,output:i,label:a}=r.data,o=e.calls[n];if(o===void 0||o.status===`settled`)return;let s=t.calls[n];t.calls[n]={callId:n,input:s?.input??``,name:o.capability.name,output:i,runId:`runId`in o.owner?o.owner.runId:void 0,...a!==void 0&&{label:a}};return}}}function dropRunPreviews(e,t,n){for(let[e,r]of Object.entries(t.parts))r.runId===n&&delete t.parts[e];for(let[r,i]of Object.entries(t.calls))i.runId===n&&e.calls[r]===void 0&&delete t.calls[r]}function prune(e,t){let n=new Set,pinPath=t=>{let r=t===void 0?[]:[t];for(;r.length>0;){let t=r.pop(),i=`${tableOf(t.family)}:${t.id}`;if(n.has(i))continue;n.add(i);let a=parentOf(e,t);a!==void 0&&r.push(a);let o=t.family===`call`?refOf(e.calls[t.id]?.owner):void 0;o!==void 0&&r.push(o)}};for(let t of[`call`,`run`,`change`,`interaction`,`delivery`])for(let n of Object.keys(e[tableOf(t)]))isOpen(e,{family:t,id:n})&&pinPath({family:t,id:n});for(let t of Object.values(e.responses))t.status!==`settled`&&(pinPath({family:`response`,id:t.responseId}),pinPath({family:`delivery`,id:t.deliveryId}));let r=liveTurns(e),i=e.session.latestTurnId;for(let t of(i===void 0?void 0:e.turns[i]?.reply)??[])n.add(`parts:${t}`);let retained=(i,a)=>{if(n.has(`${tableOf(i)}:${a}`)||t?.(tableOf(i),a)===!0)return!0;let o=i===`part`?void 0:turnOf(e,{family:i,id:a});return o!==void 0&&r.has(o)},dropWhere=(e,t,n)=>{for(let[r,i]of Object.entries(t))n(i)&&!retained(e,r)&&delete t[r]};dropWhere(`delivery`,e.deliveries,e=>e.status===`settled`),dropWhere(`turn`,e.turns,e=>e.status===`settled`),dropWhere(`run`,e.runs,e=>e.status===`settled`),dropWhere(`part`,e.parts,()=>!0),dropWhere(`call`,e.calls,e=>e.status===`settled`),dropWhere(`task`,e.tasks,e=>e.status===`ended`),dropWhere(`interaction`,e.interactions,e=>e.status===`settled`),dropWhere(`response`,e.responses,e=>e.status===`settled`),dropWhere(`change`,e.changes,e=>e.status===`settled`);for(let[t,n]of Object.entries(e.children))(`callId`in n.owner?e.calls[n.owner.callId]:e.tasks[n.owner.taskId])===void 0?delete e.children[t]:n.deliveries!==void 0&&(e.children[t]={...n,deliveries:void 0});for(let t of Object.values(e.calls))t.status===`settled`&&!n.has(`calls:${t.callId}`)&&withholdLarge(e,t)}function liveTurns(e){let t=new Set;e.session.latestTurnId!==void 0&&t.add(e.session.latestTurnId);for(let n of Object.values(e.calls)){if(n.status===`settled`)continue;let r=turnOf(e,{family:`call`,id:n.callId});r!==void 0&&t.add(r)}return t}const MAX_KEPT_VALUE_LENGTH=16384;function withholdLarge(e,t){let size=e=>e===void 0?0:JSON.stringify(e)?.length??0,n=size(t.input),r=size(t.output);if(n<=MAX_KEPT_VALUE_LENGTH&&r<=MAX_KEPT_VALUE_LENGTH)return;let{input:i,output:a,...o}=t;e.calls[t.callId]={...o,...n<=MAX_KEPT_VALUE_LENGTH?{input:i}:{inputRef:{size:n,mediaType:`application/json`}},...r<=MAX_KEPT_VALUE_LENGTH?a===void 0?{}:{output:a}:{outputRef:{size:r,mediaType:`application/json`}}}}function addUsage(e,t){if(e===void 0)return t;let n={cacheReadTokens:e.cacheReadTokens+t.cacheReadTokens,cacheWriteTokens:e.cacheWriteTokens+t.cacheWriteTokens,inputTokens:e.inputTokens+t.inputTokens,outputTokens:e.outputTokens+t.outputTokens};return(e.costUsd!==void 0||t.costUsd!==void 0)&&(n.costUsd=(e.costUsd??0)+(t.costUsd??0)),n}function addToTotals(e,t,n){return{byKind:dictionary({...e.byKind,[t]:addUsage(e.byKind[t],n)}),total:addUsage(e.total,n)}}export{copyView,emptyPreviews,emptySessionView,foldEvents,foldLine,foldLines,foldReceivedEvent,viewOfEvents};
1
+ import{FACT_CATALOG,isFactType,isProgressType}from"#protocol/session-events/catalog.js";import{isOpen,parentOf,refOf,tableOf,turnOf}from"#protocol/session-projection/tree.js";import{isObject}from"#protocol/session-events/json.js";const ZERO={cacheReadTokens:0,cacheWriteTokens:0,inputTokens:0,outputTokens:0};function dictionary(e){return Object.assign(Object.create(null),e)}function emptySessionView(){return{calls:dictionary(),changes:dictionary(),children:dictionary(),deliveries:dictionary(),interactions:dictionary(),parts:dictionary(),position:0,responses:dictionary(),runs:dictionary(),session:{status:`new`,turnCount:0},tasks:dictionary(),turns:dictionary(),usage:{byKind:dictionary(),total:ZERO}}}function emptyPreviews(){return{calls:dictionary(),parts:dictionary()}}function foldLine(e,t,n,r={}){let i=e;if(n<i.position)return;r.retention===`operational`&&prune(i,r.keep),i.position=n+1;let a=r.previews;if(`progress`in t){a!==void 0&&foldProgress(i,a,t.progress);return}if(Array.isArray(t.facts))for(let e of t.facts)foldFact(i,a,e,{at:t.at,position:n})}function foldLines(e,t,n,r={}){let i=n;for(let n of t)foldLine(e,n,i,r),i+=1}function foldEvents(e,t,n={}){let r=0;for(;r<t.length;){let i=t[r].meta.position.line,a=r+1;for(;a<t.length&&t[a].meta.position.line===i;)a+=1;let o=t.slice(r,a);if(o.at(-1).meta.endOfLine===!1)return t.slice(r);let s=o[0];foldLine(e,o.length===1&&isProgressType(s.type)?{progress:s}:{at:s.meta.at,facts:o},i,n),r=a}return[]}function viewOfEvents(e){let t=emptySessionView(),n=emptyPreviews();return foldEvents(t,e,{previews:n}),{previews:n,view:t}}function copyView(e){return{...e,calls:dictionary(e.calls),changes:dictionary(e.changes),children:dictionary(e.children),deliveries:dictionary(e.deliveries),interactions:dictionary(e.interactions),parts:dictionary(e.parts),responses:dictionary(e.responses),runs:dictionary(e.runs),tasks:dictionary(e.tasks),turns:dictionary(e.turns)}}function foldReceivedEvent(e,t,n){let r=e,i=t.meta?.position?.line??r.position;if(i<r.position)return;let a=n;isFactType(t.type)?foldFact(r,a,t,{at:t.meta?.at??``,position:i}):a!==void 0&&isProgressType(t.type)&&foldProgress(r,a,t),t.meta?.endOfLine!==!1&&(r.position=i+1)}function foldFact(e,t,n,r){if(typeof n!=`object`||!n)return;let i=n;if(isFactType(i.type)&&i.data!==null&&typeof i.data==`object`&&e.session.status!==`ended`&&(i.type!==`model.requested`&&i.type!==`call.requested`&&i.type!==`child.opened`||isObject(i.data.owner))){if(foldLifecycle(e,i,{introducedAt:r.position,startedAt:r.at},r)){foldSpecifics(e,t,i,r);return}switch(i.type){case`session.started`:{if(e.session.status!==`new`)return;let{parent:t,runtime:n}=i.data;e.session={...e.session,parent:t,runtime:n,startedAt:r.at,status:`open`};return}case`session.ended`:{let{cause:t,error:n,outcome:a}=i.data;if(typeof a!=`string`)return;e.session={...e.session,cause:t,closedAt:r.position,endedAt:r.at,error:n,outcome:a,status:`ended`};return}case`child.sent`:{let{callId:t,childDeliveryId:n,sessionId:r}=i.data,a=e.children[r];if(a===void 0||a.deliveries?.some(e=>e.deliveryId===n))return;e.children[r]={...a,deliveries:[...a.deliveries??[],{callId:t,deliveryId:n}]};return}case`usage.recorded`:{let{kind:t,owner:n,usage:r}=i.data;if(typeof r!=`object`||!r||(e.usage=addToTotals(e.usage,t,r),!isObject(n)))return;if(`runId`in n){let t=e.runs[n.runId];t!==void 0&&(e.runs[t.runId]={...t,usage:addUsage(t.usage,r)})}else if(`callId`in n){let t=e.calls[n.callId];t!==void 0&&(e.calls[t.callId]={...t,usage:addUsage(t.usage,r)})}return}}}}const LIFECYCLE={"call.requested":{status:`requested`,table:`calls`},"call.settled":{status:`settled`,table:`calls`},"call.started":{from:`requested`,status:`running`,table:`calls`},"child.opened":{table:`children`},"content.completed":{table:`parts`},"context.settled":{status:`settled`,table:`changes`},"context.started":{status:`running`,table:`changes`},"delivery.admitted":{status:`admitted`,table:`deliveries`},"delivery.consumed":{from:`admitted`,omit:[`history`],status:`consumed`,table:`deliveries`},"delivery.settled":{status:`settled`,table:`deliveries`},"interaction.opened":{status:`open`,table:`interactions`},"interaction.settled":{status:`settled`,table:`interactions`},"model.requested":{status:`requested`,table:`runs`},"model.settled":{status:`settled`,table:`runs`},"model.started":{status:`running`,table:`runs`},"response.admitted":{from:`submitted`,status:`admitted`,table:`responses`},"response.settled":{status:`settled`,table:`responses`},"response.submitted":{status:`submitted`,table:`responses`},"task.ended":{status:`ended`,table:`tasks`},"task.started":{status:`running`,table:`tasks`},"turn.settled":{rename:{cause:`endedBy`},status:`settled`,table:`turns`},"turn.started":{omit:[`trace`],status:`running`,table:`turns`}},FOLD_FIELDS=new Set([`introducedAt`,`startedAt`,`closedAt`,`endedAt`,`consumedAt`,`step`,`runs`,`status`]);function foldLifecycle(e,t,n,r){let i=LIFECYCLE[t.type];if(i===void 0)return!1;let{idField:a,role:o}=FACT_CATALOG[t.type],s=Object.fromEntries(Object.entries(t.data).flatMap(([e,t])=>i.omit?.includes(e)===!0||FOLD_FIELDS.has(e)?[]:[[i.rename?.[e]??e,t]])),c=s[a];if(typeof c!=`string`)return!1;let l=e[i.table],u=l[c],d=i.status===void 0?{}:{status:i.status},closed=e=>e.status===`settled`||e.status===`ended`;switch(o){case`introduces`:case`complete`:return u===void 0&&(l[c]={...n,...s,...d},!0);case`updates`:return u===void 0||(i.from===void 0?closed(u):u.status!==i.from)?!1:(l[c]={...u,...s,...d},!0);case`terminal`:return u===void 0||closed(u)||typeof s.outcome!=`string`?!1:(l[c]={...u,...s,closedAt:r.position,endedAt:r.at,...d},!0);default:return!1}}function foldSpecifics(e,t,n,r){switch(n.type){case`delivery.consumed`:{let t=e.deliveries[n.data.deliveryId];e.deliveries[t.deliveryId]={...t,consumedAt:r.position};return}case`turn.started`:e.session={...e.session,latestTurnId:n.data.turnId,turnCount:e.session.turnCount+1},delete e.selection;return;case`model.requested`:{let{owner:t,runId:r}=n.data,i=`turnId`in t?e.turns[t.turnId]:void 0;if(i===void 0)return;let a=i.runs??0;e.turns[i.turnId]={...i,runs:a+1},e.runs[r]={...e.runs[r],step:a};return}case`model.settled`:t!==void 0&&dropRunPreviews(e,t,n.data.runId);return;case`call.requested`:case`call.settled`:t!==void 0&&delete t.calls[n.data.callId];return;case`content.completed`:{let{partId:r,phase:i,runId:a}=n.data;t!==void 0&&delete t.parts[r];let o=e.runs[a]?.owner,s=o!==void 0&&`turnId`in o?e.turns[o.turnId]:void 0;if(i===`reply`&&s!==void 0&&s.status!==`settled`){let t=(s.reply??[]).filter(t=>e.parts[t]?.runId===a);e.turns[s.turnId]={...s,reply:[...t,r]}}return}case`context.settled`:{let{outcome:t,selects:r}=n.data;t===`completed`&&`selects`in n.data&&r!==void 0&&(e.selection=r);return}}}function foldProgress(e,t,n){if(typeof n!=`object`||!n)return;let r=n;if(isProgressType(r.type)&&r.data!==null&&typeof r.data==`object`&&e.session.status!==`ended`)switch(r.type){case`content.delta`:{let{delta:n,kind:i,partId:a}=r.data;if(e.parts[a]!==void 0||typeof n!=`string`)return;let o=t.parts[a];o===void 0?i!==void 0&&(t.parts[a]={kind:i,partId:a,runId:r.scope?.runId,text:n}):t.parts[a]={...o,text:o.text+n};return}case`call.input`:{let{callId:n,delta:i,kind:a,name:o}=r.data;if(e.calls[n]!==void 0||typeof i!=`string`)return;let s=t.calls[n];if(s!==void 0)t.calls[n]={...s,input:s.input+i};else if(o!==void 0){let e={callId:n,input:i,name:o,runId:r.scope?.runId};t.calls[n]=a===void 0?e:{...e,kind:a}}return}case`call.progress`:{let{callId:n,output:i,label:a}=r.data,o=e.calls[n];if(o===void 0||o.status===`settled`)return;let s=t.calls[n];t.calls[n]={callId:n,input:s?.input??``,name:o.capability.name,output:i,runId:`runId`in o.owner?o.owner.runId:void 0,...a!==void 0&&{label:a}};return}}}function dropRunPreviews(e,t,n){for(let[e,r]of Object.entries(t.parts))r.runId===n&&delete t.parts[e];for(let[r,i]of Object.entries(t.calls))i.runId===n&&e.calls[r]===void 0&&delete t.calls[r]}function prune(e,t){let n=new Set,pinPath=t=>{let r=t===void 0?[]:[t];for(;r.length>0;){let t=r.pop(),i=`${tableOf(t.family)}:${t.id}`;if(n.has(i))continue;n.add(i);let a=parentOf(e,t);a!==void 0&&r.push(a);let o=t.family===`call`?refOf(e.calls[t.id]?.owner):void 0;o!==void 0&&r.push(o)}};for(let t of[`call`,`run`,`change`,`interaction`,`delivery`])for(let n of Object.keys(e[tableOf(t)]))isOpen(e,{family:t,id:n})&&pinPath({family:t,id:n});for(let t of Object.values(e.responses))t.status!==`settled`&&(pinPath({family:`response`,id:t.responseId}),pinPath({family:`delivery`,id:t.deliveryId}));let r=liveTurns(e),i=e.session.latestTurnId;for(let t of(i===void 0?void 0:e.turns[i]?.reply)??[])n.add(`parts:${t}`);let retained=(i,a)=>{if(n.has(`${tableOf(i)}:${a}`)||t?.(tableOf(i),a)===!0)return!0;let o=i===`part`?void 0:i===`delivery`?e.deliveries[a]?.turnId:turnOf(e,{family:i,id:a});return o!==void 0&&r.has(o)},dropWhere=(e,t,n)=>{for(let[r,i]of Object.entries(t))n(i)&&!retained(e,r)&&delete t[r]};dropWhere(`delivery`,e.deliveries,e=>e.status===`settled`),dropWhere(`turn`,e.turns,e=>e.status===`settled`),dropWhere(`run`,e.runs,e=>e.status===`settled`),dropWhere(`part`,e.parts,()=>!0),dropWhere(`call`,e.calls,e=>e.status===`settled`),dropWhere(`task`,e.tasks,e=>e.status===`ended`),dropWhere(`interaction`,e.interactions,e=>e.status===`settled`),dropWhere(`response`,e.responses,e=>e.status===`settled`),dropWhere(`change`,e.changes,e=>e.status===`settled`);for(let[t,n]of Object.entries(e.children))(`callId`in n.owner?e.calls[n.owner.callId]:e.tasks[n.owner.taskId])===void 0?delete e.children[t]:n.deliveries!==void 0&&(e.children[t]={...n,deliveries:void 0});for(let t of Object.values(e.calls))t.status===`settled`&&!n.has(`calls:${t.callId}`)&&withholdLarge(e,t)}function liveTurns(e){let t=new Set;e.session.latestTurnId!==void 0&&t.add(e.session.latestTurnId);for(let n of Object.values(e.calls)){if(n.status===`settled`)continue;let r=turnOf(e,{family:`call`,id:n.callId});r!==void 0&&t.add(r)}return t}const MAX_KEPT_VALUE_LENGTH=16384;function withholdLarge(e,t){let size=e=>e===void 0?0:JSON.stringify(e)?.length??0,n=size(t.input),r=size(t.output);if(n<=MAX_KEPT_VALUE_LENGTH&&r<=MAX_KEPT_VALUE_LENGTH)return;let{input:i,output:a,...o}=t;e.calls[t.callId]={...o,...n<=MAX_KEPT_VALUE_LENGTH?{input:i}:{inputRef:{size:n,mediaType:`application/json`}},...r<=MAX_KEPT_VALUE_LENGTH?a===void 0?{}:{output:a}:{outputRef:{size:r,mediaType:`application/json`}}}}function addUsage(e,t){if(e===void 0)return t;let n={cacheReadTokens:e.cacheReadTokens+t.cacheReadTokens,cacheWriteTokens:e.cacheWriteTokens+t.cacheWriteTokens,inputTokens:e.inputTokens+t.inputTokens,outputTokens:e.outputTokens+t.outputTokens};return(e.costUsd!==void 0||t.costUsd!==void 0)&&(n.costUsd=(e.costUsd??0)+(t.costUsd??0)),n}function addToTotals(e,t,n){return{byKind:dictionary({...e.byKind,[t]:addUsage(e.byKind[t],n)}),total:addUsage(e.total,n)}}export{copyView,emptyPreviews,emptySessionView,foldEvents,foldLine,foldLines,foldReceivedEvent,viewOfEvents};
@@ -1 +1 @@
1
- import{parseAnswer}from"#shared/input.js";import{DISCORD_INTERACTION_RESPONSE_TYPE}from"#public/channels/discord/inbound.js";import{chunk,truncate}from"#public/channels/text.js";const DISCORD_COMPONENT_TYPE={ACTION_ROW:1,BUTTON:2,STRING_SELECT:3,TEXT_INPUT:4},DISCORD_HITL_CUSTOM_ID_PREFIX=`eve_input:`,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX=`eve_input_freeform:`,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID=`eve_freeform_text`;function renderInteractionComponents(e){let t=e.request.options,n=e.request.allowFreeform===!0||!t||t.length===0;return t&&t.length>0&&e.request.display===`select`?[{components:[{custom_id:encodeHitlCustomId(DISCORD_HITL_CUSTOM_ID_PREFIX,{requestId:e.interactionId}),options:t.slice(0,25).map(e=>{let t={label:truncate(e.label,100),value:truncate(e.id,100)};return e.description!==void 0&&(t.description=truncate(e.description,100)),t}),placeholder:`Choose an option`,type:DISCORD_COMPONENT_TYPE.STRING_SELECT}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}]:t&&t.length>0?chunk(t.slice(0,25),5).map(t=>({components:t.map(t=>({custom_id:encodeHitlCustomId(DISCORD_HITL_CUSTOM_ID_PREFIX,{optionId:t.id,requestId:e.interactionId}),label:truncate(t.label,80),style:toDiscordButtonStyle(t.style),type:DISCORD_COMPONENT_TYPE.BUTTON})),type:DISCORD_COMPONENT_TYPE.ACTION_ROW})):n?[{components:[{custom_id:encodeHitlCustomId(DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,{requestId:e.interactionId}),label:`Type your answer`,style:1,type:DISCORD_COMPONENT_TYPE.BUTTON}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}]:[]}function buildFreeformModalResponse(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX);if(!t)throw Error(`discordChannel: freeform custom_id is malformed.`);return{data:{components:[{components:[{custom_id:DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,label:`Answer`,max_length:4e3,min_length:1,placeholder:`Type your answer here...`,required:!0,style:2,type:DISCORD_COMPONENT_TYPE.TEXT_INPUT}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}],custom_id:encodeHitlCustomId(DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,{requestId:t.requestId}),title:truncate(e.prompt??`Your answer`,45)},type:DISCORD_INTERACTION_RESPONSE_TYPE.MODAL}}function isDiscordFreeformComponent(e){return decodeHitlCustomId(e,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX)!==null}function deriveComponentAnswers(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_CUSTOM_ID_PREFIX);if(!t)return[];if(t.optionId!==void 0)return[parseAnswer({interactionId:t.requestId,optionId:t.optionId})];let n=e.values[0];return n===void 0?[]:[parseAnswer({interactionId:t.requestId,optionId:n})]}function deriveModalAnswers(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX),n=e.textInputs[DISCORD_HITL_FREEFORM_TEXT_INPUT_ID];return!t||n===void 0?[]:[parseAnswer({interactionId:t.requestId,text:n})]}function encodeHitlCustomId(e,t){let n=t.optionId===void 0?[t.requestId]:[t.requestId,t.optionId],r=`${e}${JSON.stringify(n)}`;if(r.length>100)throw Error(`discordChannel: HITL custom_id exceeded Discord's 100-character limit.`);return r}function decodeHitlCustomId(e,t){if(!e.startsWith(t))return null;let n;try{n=JSON.parse(e.slice(t.length))}catch{return null}if(!Array.isArray(n)||n.length<1||n.length>2)return null;let[r,i]=n;return typeof r!=`string`||r.length===0?null:i===void 0?{requestId:r}:typeof i==`string`?{optionId:i,requestId:r}:null}function toDiscordButtonStyle(e){return e===`primary`?1:e===`danger`?4:2}export{DISCORD_COMPONENT_TYPE,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,buildFreeformModalResponse,deriveComponentAnswers,deriveModalAnswers,isDiscordFreeformComponent,renderInteractionComponents};
1
+ import{parseAnswer}from"#shared/input.js";import{DISCORD_INTERACTION_RESPONSE_TYPE}from"#public/channels/discord/inbound.js";import{chunk,truncate}from"#public/channels/text.js";const DISCORD_COMPONENT_TYPE={ACTION_ROW:1,BUTTON:2,STRING_SELECT:3,TEXT_INPUT:4},DISCORD_HITL_CUSTOM_ID_PREFIX=`eve_input:`,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX=`eve_input_freeform:`,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID=`eve_freeform_text`;function renderInteractionComponents(e){let t=e.request.options,n=e.request.allowFreeform===!0||!t||t.length===0;return t&&t.length>0&&e.request.display===`select`?[{components:[{custom_id:encodeHitlCustomId(DISCORD_HITL_CUSTOM_ID_PREFIX,{requestId:e.interactionId}),options:t.slice(0,25).map(e=>{let t={label:truncate(e.label,100),value:selectOptionValue(e.id)};return e.description!==void 0&&(t.description=truncate(e.description,100)),t}),placeholder:`Choose an option`,type:DISCORD_COMPONENT_TYPE.STRING_SELECT}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}]:t&&t.length>0?chunk(t.slice(0,25),5).map(t=>({components:t.map(t=>({custom_id:encodeHitlCustomId(DISCORD_HITL_CUSTOM_ID_PREFIX,{optionId:t.id,requestId:e.interactionId}),label:truncate(t.label,80),style:toDiscordButtonStyle(t.style),type:DISCORD_COMPONENT_TYPE.BUTTON})),type:DISCORD_COMPONENT_TYPE.ACTION_ROW})):n?[{components:[{custom_id:encodeHitlCustomId(DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,{requestId:e.interactionId}),label:`Type your answer`,style:1,type:DISCORD_COMPONENT_TYPE.BUTTON}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}]:[]}function buildFreeformModalResponse(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX);if(!t)throw Error(`discordChannel: freeform custom_id is malformed.`);return{data:{components:[{components:[{custom_id:DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,label:`Answer`,max_length:4e3,min_length:1,placeholder:`Type your answer here...`,required:!0,style:2,type:DISCORD_COMPONENT_TYPE.TEXT_INPUT}],type:DISCORD_COMPONENT_TYPE.ACTION_ROW}],custom_id:encodeHitlCustomId(DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,{requestId:t.requestId}),title:truncate(e.prompt??`Your answer`,45)},type:DISCORD_INTERACTION_RESPONSE_TYPE.MODAL}}function isDiscordFreeformComponent(e){return decodeHitlCustomId(e,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX)!==null}function deriveComponentAnswers(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_CUSTOM_ID_PREFIX);if(!t)return[];if(t.optionId!==void 0)return[parseAnswer({interactionId:t.requestId,optionId:t.optionId})];let n=e.values[0];return n===void 0?[]:[parseAnswer({interactionId:t.requestId,optionId:n})]}function deriveModalAnswers(e){let t=decodeHitlCustomId(e.customId,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX),n=e.textInputs[DISCORD_HITL_FREEFORM_TEXT_INPUT_ID];return!t||n===void 0?[]:[parseAnswer({interactionId:t.requestId,text:n})]}function encodeHitlCustomId(e,t){let n=t.optionId===void 0?[t.requestId]:[t.requestId,t.optionId],r=`${e}${JSON.stringify(n)}`;if(r.length>100)throw Error(`discordChannel: HITL custom_id exceeded Discord's 100-character limit.`);return r}function decodeHitlCustomId(e,t){if(!e.startsWith(t))return null;let n;try{n=JSON.parse(e.slice(t.length))}catch{return null}if(!Array.isArray(n)||n.length<1||n.length>2)return null;let[r,i]=n;return typeof r!=`string`||r.length===0?null:i===void 0?{requestId:r}:typeof i==`string`?{optionId:i,requestId:r}:null}function selectOptionValue(e){if(e.length>100)throw Error(`discordChannel: select option ids must be at most 100 characters, Discord's option value limit.`);return e}function toDiscordButtonStyle(e){return e===`primary`?1:e===`danger`?4:2}export{DISCORD_COMPONENT_TYPE,DISCORD_HITL_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_CUSTOM_ID_PREFIX,DISCORD_HITL_FREEFORM_TEXT_INPUT_ID,buildFreeformModalResponse,deriveComponentAnswers,deriveModalAnswers,isDiscordFreeformComponent,renderInteractionComponents};
@@ -1 +1 @@
1
- import{createLogger}from"#internal/logging.js";import{readNonEmptyString}from"#shared/guards.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{createGitHubBotNameResolver}from"#public/channels/github/auth.js";import{getGitHubRepository}from"#public/channels/github/api.js";import{parseGitHubWebhookEvent}from"#public/channels/github/inbound.js";import{buildGitHubBinding}from"#public/channels/github/binding.js";import{continuationTokenFromState,conversationFromState,initialGitHubState,stateFromReceiveTarget}from"#public/channels/github/state.js";import{GITHUB_CHANNEL_DEFAULT_ROUTE}from"#public/channels/github/constants.js";import{createDefaultEvents,defaultOnComment}from"#public/channels/github/defaults.js";import{dispatchCheckRun,dispatchCheckSuite,dispatchIssue,dispatchIssueComment,dispatchPullRequest,dispatchPullRequestReviewComment,dispatchWorkflowRun}from"#public/channels/github/dispatch.js";import{verifyGitHubRequest}from"#public/channels/github/verify.js";const log=createLogger(`github.channel`);function githubChannel(e={}){let t=createGitHubBotNameResolver({botName:e.botName,credentials:e.credentials}),n={botName:t},r={...createDefaultEvents({api:e.api,botName:t,credentials:e.credentials,progress:e.progress}),...e.events};return defineChannel({turnPolicy:e.turnPolicy,state:initialGitHubState(),context(t,n){return rebuildGitHubContext(t,n,e)},routes:[POST(e.route??GITHUB_CHANNEL_DEFAULT_ROUTE,async(r,{from:i,waitUntil:a})=>{let o=await verifyInbound(r,e.credentials);if(o===null)return new Response(`unauthorized`,{status:401});let s=missingGitHubWebhookHeaders(r.headers),c;try{c=parseGitHubWebhookEvent({body:o,contentType:r.headers.get(`content-type`)??void 0,headers:r.headers})}catch(e){return log.warn(`inbound GitHub body is not valid JSON`,{error:e}),jsonOk({ignored:!0,ok:!0})}return c===null?(s.length>0&&log.warn(`GitHub webhook ignored because standard headers were missing`,{missingHeaders:s}),jsonOk({ignored:!0,ok:!0})):(s.length>0&&log.warn(`GitHub webhook missing standard headers; inferred metadata from payload`,{deliveryId:c.delivery.id,event:c.delivery.event,missingHeaders:s,repository:c.repository.fullName}),c.kind===`ping`?jsonOk({ok:!0}):c.kind===`issue_comment`&&c.action===`created`?(a(dispatchIssueComment({botName:t,config:e,event:c,handler:e.onComment??((e,t)=>defaultOnComment(e,t,n)),from:i})),jsonOk({ok:!0})):c.kind===`pull_request_review_comment`&&c.action===`created`?(a(dispatchPullRequestReviewComment({botName:t,config:e,event:c,handler:e.onComment??((e,t)=>defaultOnComment(e,t,n)),from:i})),jsonOk({ok:!0})):c.kind===`issues`&&e.onIssue!==void 0?(a(dispatchIssue({botName:t,config:e,event:c,handler:e.onIssue,from:i})),jsonOk({ok:!0})):c.kind===`pull_request`&&e.onPullRequest!==void 0?(a(dispatchPullRequest({botName:t,config:e,event:c,handler:e.onPullRequest,from:i})),jsonOk({ok:!0})):c.kind===`check_suite`&&e.onCheckSuite!==void 0?(a(dispatchCheckSuite({botName:t,config:e,event:c,handler:e.onCheckSuite,from:i})),jsonOk({ok:!0})):c.kind===`check_run`&&e.onCheckRun!==void 0?(a(dispatchCheckRun({botName:t,config:e,event:c,handler:e.onCheckRun,from:i})),jsonOk({ok:!0})):c.kind===`workflow_run`&&e.onWorkflowRun!==void 0?(a(dispatchWorkflowRun({botName:t,config:e,event:c,handler:e.onWorkflowRun,from:i})),jsonOk({ok:!0})):jsonOk({ignored:!0,ok:!0}))})],async receive({message:t,target:n,...r},{from:i}){let a=n,o=readNonEmptyString(a.owner),s=readNonEmptyString(a.repo);if(o===void 0||s===void 0)throw Error(`githubChannel().receive requires target.owner and target.repo.`);if([a.issueNumber!==void 0,a.pullRequestNumber!==void 0].filter(Boolean).length!==1)throw Error(`githubChannel().receive requires exactly one of issueNumber or pullRequestNumber.`);let c=a.repositoryId??(await getGitHubRepository({api:e.api,credentials:e.credentials,installationId:a.installationId,owner:o,repo:s})).id,l=stateFromReceiveTarget({target:a,owner:o,repo:s,repositoryId:c});if(a.initialMessage!==void 0){let{thread:t}=buildGitHubBinding({config:e,state:l});await t.post(a.initialMessage)}return i(continuationTokenFromState(l)).send(t,{...r,state:l})},events:r})}function rebuildGitHubContext(e,t,n){let r=buildGitHubBinding({config:n,state:e});return{conversation:conversationFromState(e),github:r.github,repository:r.github.repository,state:e,thread:r.thread}}async function verifyInbound(e,t){try{return await verifyGitHubRequest(e,{webhookSecret:t?.webhookSecret,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`github inbound verification failed`,{error:e}),null}}function missingGitHubWebhookHeaders(e){return[`x-github-event`,`x-github-delivery`].filter(t=>{let n=e.get(t);return n===null||n.trim().length===0})}function jsonOk(e){return new Response(JSON.stringify(e),{headers:{"content-type":`application/json; charset=utf-8`},status:200})}export{githubChannel};
1
+ import{createLogger}from"#internal/logging.js";import{readNonEmptyString}from"#shared/guards.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{createGitHubBotNameResolver}from"#public/channels/github/auth.js";import{getGitHubRepository}from"#public/channels/github/api.js";import{parseGitHubWebhookEvent}from"#public/channels/github/inbound.js";import{buildGitHubBinding}from"#public/channels/github/binding.js";import{applyDeliveredGitHubState,continuationTokenFromState,conversationFromState,initialGitHubState,stateFromReceiveTarget}from"#public/channels/github/state.js";import{GITHUB_CHANNEL_DEFAULT_ROUTE}from"#public/channels/github/constants.js";import{createDefaultEvents,defaultOnComment}from"#public/channels/github/defaults.js";import{dispatchCheckRun,dispatchCheckSuite,dispatchIssue,dispatchIssueComment,dispatchPullRequest,dispatchPullRequestReviewComment,dispatchWorkflowRun}from"#public/channels/github/dispatch.js";import{verifyGitHubRequest}from"#public/channels/github/verify.js";const log=createLogger(`github.channel`);function githubChannel(e={}){let t=createGitHubBotNameResolver({botName:e.botName,credentials:e.credentials}),n={botName:t},r={...createDefaultEvents({api:e.api,botName:t,credentials:e.credentials,progress:e.progress}),...e.events};return defineChannel({turnPolicy:e.turnPolicy,state:initialGitHubState(),context(t,n){return rebuildGitHubContext(t,n,e)},deliver(e,t){applyDeliveredGitHubState(t.state,e.state)},routes:[POST(e.route??GITHUB_CHANNEL_DEFAULT_ROUTE,async(r,{from:i,waitUntil:a})=>{let o=await verifyInbound(r,e.credentials);if(o===null)return new Response(`unauthorized`,{status:401});let s=missingGitHubWebhookHeaders(r.headers),c;try{c=parseGitHubWebhookEvent({body:o,contentType:r.headers.get(`content-type`)??void 0,headers:r.headers})}catch(e){return log.warn(`inbound GitHub body is not valid JSON`,{error:e}),jsonOk({ignored:!0,ok:!0})}return c===null?(s.length>0&&log.warn(`GitHub webhook ignored because standard headers were missing`,{missingHeaders:s}),jsonOk({ignored:!0,ok:!0})):(s.length>0&&log.warn(`GitHub webhook missing standard headers; inferred metadata from payload`,{deliveryId:c.delivery.id,event:c.delivery.event,missingHeaders:s,repository:c.repository.fullName}),c.kind===`ping`?jsonOk({ok:!0}):c.kind===`issue_comment`&&c.action===`created`?(a(dispatchIssueComment({botName:t,config:e,event:c,handler:e.onComment??((e,t)=>defaultOnComment(e,t,n)),from:i})),jsonOk({ok:!0})):c.kind===`pull_request_review_comment`&&c.action===`created`?(a(dispatchPullRequestReviewComment({botName:t,config:e,event:c,handler:e.onComment??((e,t)=>defaultOnComment(e,t,n)),from:i})),jsonOk({ok:!0})):c.kind===`issues`&&e.onIssue!==void 0?(a(dispatchIssue({botName:t,config:e,event:c,handler:e.onIssue,from:i})),jsonOk({ok:!0})):c.kind===`pull_request`&&e.onPullRequest!==void 0?(a(dispatchPullRequest({botName:t,config:e,event:c,handler:e.onPullRequest,from:i})),jsonOk({ok:!0})):c.kind===`check_suite`&&e.onCheckSuite!==void 0?(a(dispatchCheckSuite({botName:t,config:e,event:c,handler:e.onCheckSuite,from:i})),jsonOk({ok:!0})):c.kind===`check_run`&&e.onCheckRun!==void 0?(a(dispatchCheckRun({botName:t,config:e,event:c,handler:e.onCheckRun,from:i})),jsonOk({ok:!0})):c.kind===`workflow_run`&&e.onWorkflowRun!==void 0?(a(dispatchWorkflowRun({botName:t,config:e,event:c,handler:e.onWorkflowRun,from:i})),jsonOk({ok:!0})):jsonOk({ignored:!0,ok:!0}))})],async receive({message:t,target:n,...r},{from:i}){let a=n,o=readNonEmptyString(a.owner),s=readNonEmptyString(a.repo);if(o===void 0||s===void 0)throw Error(`githubChannel().receive requires target.owner and target.repo.`);if([a.issueNumber!==void 0,a.pullRequestNumber!==void 0].filter(Boolean).length!==1)throw Error(`githubChannel().receive requires exactly one of issueNumber or pullRequestNumber.`);let c=a.repositoryId??(await getGitHubRepository({api:e.api,credentials:e.credentials,installationId:a.installationId,owner:o,repo:s})).id,l=stateFromReceiveTarget({target:a,owner:o,repo:s,repositoryId:c});if(a.initialMessage!==void 0){let{thread:t}=buildGitHubBinding({config:e,state:l});await t.post(a.initialMessage)}return i(continuationTokenFromState(l)).send(t,{...r,state:l})},events:r})}function rebuildGitHubContext(e,t,n){let r=buildGitHubBinding({config:n,state:e});return{conversation:conversationFromState(e),github:r.github,repository:r.github.repository,state:e,thread:r.thread}}async function verifyInbound(e,t){try{return await verifyGitHubRequest(e,{webhookSecret:t?.webhookSecret,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`github inbound verification failed`,{error:e}),null}}function missingGitHubWebhookHeaders(e){return[`x-github-event`,`x-github-delivery`].filter(t=>{let n=e.get(t);return n===null||n.trim().length===0})}function jsonOk(e){return new Response(JSON.stringify(e),{headers:{"content-type":`application/json; charset=utf-8`},status:200})}export{githubChannel};
@@ -57,6 +57,13 @@ export declare function stateFromReceiveTarget(input: {
57
57
  readonly repo: string;
58
58
  readonly repositoryId: number;
59
59
  }): GitHubChannelState;
60
+ /**
61
+ * Applies what a later delivery's event says to the session's state: the head
62
+ * it was pushed to and the comment that triggered it. A field the event does
63
+ * not carry (null) is applied as null, so the next checkout resolves the
64
+ * current head from the API instead of reusing the last checkout's sha.
65
+ */
66
+ export declare function applyDeliveredGitHubState(state: GitHubChannelState, delivered: Partial<GitHubChannelState> | undefined): void;
60
67
  /** Reconstructs the channel-local GitHub conversation reference from state. */
61
68
  export declare function conversationFromState(state: GitHubChannelState): GitHubConversationRef;
62
69
  /** Builds the channel-local continuation token from durable state. */
@@ -1 +1 @@
1
- import{githubContinuationToken}from"#public/channels/github/inbound.js";function initialGitHubState(){return{baseRef:null,baseSha:null,checkoutPath:null,conversationKind:`issue`,defaultBranch:null,headRef:null,headSha:null,installationId:null,issueNumber:null,owner:``,pullRequestNumber:null,repo:``,repositoryId:0,reviewCommentId:null,reviewThreadRootCommentId:null,triggeringCommentId:null,triggeringUserLogin:null}}function stateFromIssueCommentEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:e.conversation.kind,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,issueNumber:e.comment.issueNumber,owner:e.repository.owner,pullRequestNumber:e.comment.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,triggeringCommentId:e.comment.id,triggeringUserLogin:e.sender.login}}function stateFromPullRequestReviewCommentEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:`review_thread`,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,owner:e.repository.owner,pullRequestNumber:e.comment.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,reviewCommentId:e.comment.id,reviewThreadRootCommentId:e.comment.reviewThreadRootCommentId,triggeringCommentId:e.comment.id,triggeringUserLogin:e.sender.login}}function stateFromIssueEvent(e){return{...initialGitHubState(),conversationKind:`issue`,installationId:e.installationId??null,issueNumber:e.issue.issueNumber,owner:e.repository.owner,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromPullRequestEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:`pull_request`,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,issueNumber:e.pullRequest.pullRequestNumber,owner:e.repository.owner,pullRequestNumber:e.pullRequest.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromCiEvent(e){let t=ciPayload(e),n=t.pullRequests[0]??null;return{...initialGitHubState(),conversationKind:`pull_request`,headSha:t.headSha,installationId:e.installationId??null,issueNumber:n,owner:e.repository.owner,pullRequestNumber:n,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromReceiveTarget(e){let{target:t}=e,n=t.pullRequestNumber===void 0?`issue`:`pull_request`;return{...initialGitHubState(),conversationKind:n,installationId:t.installationId??null,issueNumber:n===`issue`?t.issueNumber??null:t.pullRequestNumber??null,owner:e.owner,pullRequestNumber:t.pullRequestNumber??null,repo:e.repo,repositoryId:e.repositoryId}}function conversationFromState(e){return{issueNumber:e.issueNumber,kind:e.conversationKind,pullRequestNumber:e.pullRequestNumber}}function continuationTokenFromState(e){return githubContinuationToken({conversationKind:e.conversationKind,issueNumber:e.issueNumber,pullRequestNumber:e.pullRequestNumber,repositoryId:e.repositoryId,reviewThreadRootCommentId:e.reviewThreadRootCommentId})}function ciPayload(e){return e.kind===`check_suite`?e.checkSuite:e.kind===`check_run`?e.checkRun:e.workflowRun}export{continuationTokenFromState,conversationFromState,initialGitHubState,stateFromCiEvent,stateFromIssueCommentEvent,stateFromIssueEvent,stateFromPullRequestEvent,stateFromPullRequestReviewCommentEvent,stateFromReceiveTarget};
1
+ import{githubContinuationToken}from"#public/channels/github/inbound.js";function initialGitHubState(){return{baseRef:null,baseSha:null,checkoutPath:null,conversationKind:`issue`,defaultBranch:null,headRef:null,headSha:null,installationId:null,issueNumber:null,owner:``,pullRequestNumber:null,repo:``,repositoryId:0,reviewCommentId:null,reviewThreadRootCommentId:null,triggeringCommentId:null,triggeringUserLogin:null}}function stateFromIssueCommentEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:e.conversation.kind,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,issueNumber:e.comment.issueNumber,owner:e.repository.owner,pullRequestNumber:e.comment.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,triggeringCommentId:e.comment.id,triggeringUserLogin:e.sender.login}}function stateFromPullRequestReviewCommentEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:`review_thread`,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,owner:e.repository.owner,pullRequestNumber:e.comment.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,reviewCommentId:e.comment.id,reviewThreadRootCommentId:e.comment.reviewThreadRootCommentId,triggeringCommentId:e.comment.id,triggeringUserLogin:e.sender.login}}function stateFromIssueEvent(e){return{...initialGitHubState(),conversationKind:`issue`,installationId:e.installationId??null,issueNumber:e.issue.issueNumber,owner:e.repository.owner,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromPullRequestEvent(e){return{...initialGitHubState(),baseRef:e.baseRef,baseSha:e.baseSha,conversationKind:`pull_request`,defaultBranch:e.defaultBranch,headRef:e.headRef,headSha:e.headSha,installationId:e.installationId??null,issueNumber:e.pullRequest.pullRequestNumber,owner:e.repository.owner,pullRequestNumber:e.pullRequest.pullRequestNumber,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromCiEvent(e){let t=ciPayload(e),n=t.pullRequests[0]??null;return{...initialGitHubState(),conversationKind:`pull_request`,headSha:t.headSha,installationId:e.installationId??null,issueNumber:n,owner:e.repository.owner,pullRequestNumber:n,repo:e.repository.name,repositoryId:e.repository.id,triggeringUserLogin:e.sender.login}}function stateFromReceiveTarget(e){let{target:t}=e,n=t.pullRequestNumber===void 0?`issue`:`pull_request`;return{...initialGitHubState(),conversationKind:n,installationId:t.installationId??null,issueNumber:n===`issue`?t.issueNumber??null:t.pullRequestNumber??null,owner:e.owner,pullRequestNumber:t.pullRequestNumber??null,repo:e.repo,repositoryId:e.repositoryId}}const DELIVERED_EVENT_FIELDS=[`baseRef`,`baseSha`,`defaultBranch`,`headRef`,`headSha`,`reviewCommentId`,`triggeringCommentId`,`triggeringUserLogin`];function applyDeliveredGitHubState(e,t){if(t!==void 0)for(let n of DELIVERED_EVENT_FIELDS)n in t&&Object.assign(e,{[n]:t[n]??null})}function conversationFromState(e){return{issueNumber:e.issueNumber,kind:e.conversationKind,pullRequestNumber:e.pullRequestNumber}}function continuationTokenFromState(e){return githubContinuationToken({conversationKind:e.conversationKind,issueNumber:e.issueNumber,pullRequestNumber:e.pullRequestNumber,repositoryId:e.repositoryId,reviewThreadRootCommentId:e.reviewThreadRootCommentId})}function ciPayload(e){return e.kind===`check_suite`?e.checkSuite:e.kind===`check_run`?e.checkRun:e.workflowRun}export{applyDeliveredGitHubState,continuationTokenFromState,conversationFromState,initialGitHubState,stateFromCiEvent,stateFromIssueCommentEvent,stateFromIssueEvent,stateFromPullRequestEvent,stateFromPullRequestReviewCommentEvent,stateFromReceiveTarget};
@@ -1 +1 @@
1
- import{z}from"#compiled/zod/index.js";import{answerSchema}from"#shared/input.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{parseJsonObject}from"#shared/json.js";import{DELETE,GET,HEAD,OPTIONS,POST,defineChannel}from"#public/definitions/channel.js";import{readAgentInfoRouteResponse,readRouteChannelName,readRouteSessionCreator,readSkillFileSource}from"#internal/nitro/routes/channel-route-context.js";import{sessionAuthFromResult}from"#channel/auth/result.js";import{routeAuth}from"#public/channels/auth.js";import{interactionJsonSchema}from"#protocol/interaction-json.js";import{escapeAuthChallengeParameter,readOAuthResourceOptions}from"#channel/auth/definitions.js";import{McpToolOperationError,createMcpStreamableHttpServer,defineMcpTool}from"#internal/mcp/streamable-http-server.js";import{WorkflowAgentInvocationExecution}from"#internal/invocation/workflow-execution.js";import{MCP_TOOL_SESSIONS_EXTENSION,createPublishedTools}from"#internal/mcp/published-tools.js";import{resolveMcpRequestPrincipals}from"#internal/mcp/forwarded-principal-header.js";import{createMcpSkillsFeature}from"#internal/mcp/skills.js";import{validateMcpHttpRequest,validateMcpMetadataRequest}from"#internal/mcp/http-security.js";import{createMcpProtectedResourceMetadata,createMcpResourceChallenge}from"#internal/mcp/protected-resource.js";function mcpChannel(e){if(e?.auth===void 0)throw Error(`mcpChannel requires auth. Use none() for explicit public access.`);let t={agent:e.agent??!0,skills:e.skills??!1,tools:e.tools??!1};if(!t.agent&&!t.tools&&!t.skills)throw Error(`mcpChannel publishes nothing with agent, tools, and skills all false. Enable one.`);let n=e.route??`/eve/v1/mcp`,r=readOAuthResourceOptions(e.auth),handle=async(n,i)=>await authenticateMcpRequest(n,i,e,r,t),i=[GET(n,handle),POST(n,handle),DELETE(n,handle)];return r!==void 0&&i.unshift(...protectedResourceMetadataRoutes(r,n)),defineChannel({routes:i})}function protectedResourceMetadataRoutes(e,t){let n=protectedResourceMetadataPath(e,t);return[GET(n,async n=>protectedResourceMetadataResponse(n,e,t,!1)),HEAD(n,async n=>protectedResourceMetadataResponse(n,e,t,!0)),OPTIONS(n,async e=>protectedResourceMetadataOptionsResponse(e))]}function protectedResourceMetadataPath(e,t){if(e.metadataPath!==void 0)return e.metadataPath;let n=e.resource===void 0?t:new URL(e.resource).pathname;return n===`/`?`/.well-known/oauth-protected-resource`:`/.well-known/oauth-protected-resource${n}`}function protectedResourceMetadataResponse(e,t,n,r){let i=validateMcpMetadataRequest(e);if(i!==void 0)return i;let a=t.resource??new URL(n,new URL(e.url).origin).toString(),o=t.issuer===void 0?t.authorizationServers:[t.issuer],s=Response.json(createMcpProtectedResourceMetadata({authorizationServers:o,resource:a,scopesSupported:t.scopes}),{headers:{"access-control-allow-origin":`*`,"cache-control":`no-store`}});return r?new Response(null,{headers:s.headers,status:s.status}):s}function protectedResourceMetadataOptionsResponse(e){let t=validateMcpMetadataRequest(e);if(t!==void 0)return t;let n=new Headers({"access-control-allow-methods":`GET, HEAD, OPTIONS`,"access-control-allow-origin":`*`,"cache-control":`no-store`}),r=e.headers.get(`access-control-request-headers`);return r!==null&&(n.set(`access-control-allow-headers`,r),n.set(`vary`,`Access-Control-Request-Headers`)),new Response(null,{headers:n,status:204})}function addResourceChallenge(e,t,n){if(e.status!==401&&e.status!==403)return e;let r=protectedResourceMetadataPath(n,new URL(t.url).pathname),i=n.resource??new URL(t.url).origin,a=new URL(r,i).toString(),o=new Headers(e.headers),s=o.get(`www-authenticate`);if(e.status===401)o.set(`www-authenticate`,mergeMcpBearerChallenge(s,a,n.scopes));else{let t=augmentInsufficientScopeChallenge(s,a);if(t===void 0)return e;o.set(`www-authenticate`,t)}return new Response(e.body,{headers:o,status:e.status,statusText:e.statusText})}function mergeMcpBearerChallenge(e,t,n){let r=parseAuthChallenges(e),i=r.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`))??r.find(e=>e.scheme.toLowerCase()===`bearer`);return replaceBearerChallenges(r,i,i===void 0?createMcpResourceChallenge(t,n):augmentBearerChallenge(i.value,t,n))}function augmentInsufficientScopeChallenge(e,t){let n=parseAuthChallenges(e),r=n.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`,`insufficient_scope`));if(r!==void 0)return replaceBearerChallenges(n,r,augmentBearerChallenge(r.value,t))}function replaceBearerChallenges(e,t,n){let r=[],i=!1;for(let a of e){if(a.scheme.toLowerCase()!==`bearer`){r.push(a.value);continue}!i&&a===t&&(r.push(n),i=!0)}return i||r.push(n),r.join(`, `)}function augmentBearerChallenge(e,t,n){let r=e;return hasAuthParameter(r,`resource_metadata`)||(r=appendAuthParameter(r,`resource_metadata`,t)),n?.length&&!hasAuthParameter(r,`scope`)&&(r=appendAuthParameter(r,`scope`,n.join(` `))),r}function appendAuthParameter(e,t,n){return`${e}${e.trim().toLowerCase()===`bearer`?` `:`, `}${t}="${escapeAuthChallengeParameter(n)}"`}function hasAuthParameter(e,t,n){let r=t.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);if(n===void 0)return RegExp(`(?:^|[\\s,])${r}\\s*=`,`i`).test(e);let i=n.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);return RegExp(`(?:^|[\\s,])${r}\\s*=\\s*(?:"${i}"|${i})(?=$|[\\s,])`,`i`).test(e)}function parseAuthChallenges(e){if(e===null)return[];let t=[];for(let n of splitQuotedHeaderList(e)){let e=readChallengeScheme(n);if(e!==void 0){t.push({scheme:e,value:n});continue}let r=t.at(-1);r!==void 0&&(r.value+=`, ${n}`)}return t}function splitQuotedHeaderList(e){let t=[],n=!1,r=!1,i=0;for(let a=0;a<e.length;a++){let o=e[a];if(n)n=!1;else if(o===`\\`)n=!0;else if(o===`"`)r=!r;else if(o===`,`&&!r){let n=e.slice(i,a).trim();n.length>0&&t.push(n),i=a+1}}let a=e.slice(i).trim();return a.length>0&&t.push(a),t}function readChallengeScheme(e){let t=/^([!#$%&'*+\-.^_`|~0-9A-Za-z]+)(?:\s+|$)/.exec(e);if(t===null)return;let n=t[1];if(n!==void 0)return e.slice(n.length).trimStart().startsWith(`=`)?void 0:n}async function authenticateMcpRequest(e,t,n,r,i){let a=validateMcpHttpRequest(e);if(a!==void 0)return a;let o=await routeAuth(e,n.auth);if(o instanceof Response)return r===void 0?o:addResourceChallenge(o,e,r);let s=sessionAuthFromResult(o),c=await resolveMcpRequestPrincipals(e,s,n.trustedForwarders);return c instanceof Response?c:await handleMcpRequest(e,t,s,c,i)}async function handleMcpRequest(e,t,n,r,i){let a=readRouteSessionCreator(t),o=readRouteChannelName(t),s=readAgentInfoRouteResponse(t);if(o===void 0||a===void 0||s===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});let c=await s();if(!c.ok)return c;let l=await c.json();if(typeof l.agent?.name!=`string`)return Response.json({error:`MCP requires compiled agent metadata.`},{status:500});let u=typeof l.agent.description==`string`?l.agent.description:void 0,d=new WorkflowAgentInvocationExecution({createSession:a,from:t.from}),f=i.agent?createInvocationTools(d,u,n.authenticator===`none`&&n.principalType===`anonymous`):[],p=i.tools||i.skills?await t.describe():void 0,m=i.tools&&p!==void 0?createPublishedTools({invokeTool:t.invokeTool,principals:r,reserved:new Set(f.map(e=>e.name)),tools:p.tools}):[],h=[];if(i.tools&&h.push({capabilities:{extensions:{[MCP_TOOL_SESSIONS_EXTENSION]:{}}},register(){}}),i.skills&&p!==void 0){let e=readSkillFileSource(t);if(e===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});h.push(createMcpSkillsFeature({files:e,skills:p.skills}))}return await createMcpStreamableHttpServer({authenticate:async()=>n,features:h,instructions:i.agent?MCP_SERVER_INSTRUCTIONS:void 0,name:l.agent.name,tools:i.agent||i.tools?[...f,...m]:void 0,version:resolveInstalledPackageInfo().version})(e)}const MCP_SERVER_INSTRUCTIONS=[`Each invocation is one durable agent task.`,`Call agent_start once per task and keep the returned invocationId.`,`Poll agent_get, waiting at least pollAfterMs between calls, until status is completed, failed, or cancelled.`,`If status is input_required, answer all non-sign-in interactions in one agent_update by interactionId; repeating accepted answers is safe.`,`For sign-in interactions, follow signIn instructions outside agent_update and keep polling.`,`isError on a tool result means your call was rejected; a failed status means the task failed.`,`agent_start is not idempotent and a lost response leaves no invocationId, so ask the user before starting again.`,`Work continues after your connection drops; agent_cancel stops it, then poll until any terminal status.`].join(` `);function createInvocationTools(e,t,n){let r=n?` On this public channel, the invocation ID is a bearer capability until workflow retention expires.`:``,i=`Starts durable work and returns an invocation handle immediately. Call once per task; keep invocationId and poll agent_get. Not idempotent: if the response is lost, ask the user before starting again rather than retrying.${r}`;return[defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:t===void 0?i:`${t} ${i}`,inputSchema:z.strictObject({message:utf8Bounded(MAX_MESSAGE_BYTES).min(1)}),name:`agent_start`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(await e.create({auth:n.auth,message:t.message}))}}),defineMcpTool({definition:{annotations:{destructiveHint:!1,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!0},description:`Reads complete durable invocation state. Wait at least pollAfterMs between calls. While working, statusMessage, when present, describes the current activity. Terminal statuses are completed, failed, and cancelled. input_required includes questions, approvals, and sign-ins. Answer questions and approvals with agent_update; follow sign-in instructions and poll for sign-ins.${r}`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_get`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.read({auth:n.auth,invocationId:t.invocationId})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:`Answers the pending input batch on an input_required invocation. Include one response per entry in interactions, naming it by its key as interactionId, in a single call; partial batches are rejected. Returns the current invocation state; repeating the same accepted answers is safe.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS),responses:z.array(MCP_INPUT_RESPONSE_SCHEMA).min(1).max(MAX_RESPONSES_PER_UPDATE)}),name:`agent_update`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredMutation(await e.update({auth:n.auth,invocationId:t.invocationId,responses:t.responses})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!1},description:`Requests cooperative cancellation of a non-terminal invocation. Cancellation is asynchronous and can race with completion: poll agent_get until status is terminal (cancelled, completed, or failed). Safe to call repeatedly.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_cancel`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.cancel({auth:n.auth,invocationId:t.invocationId})))}})]}const INVOCATION_NOT_FOUND=`Invocation not found. It may have expired or belong to another caller.`;function requiredInvocation(e){if(e===void 0)throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND);return e}function requiredMutation(e){switch(e.type){case`success`:return e.invocation;case`conflict`:throw new McpToolOperationError(`conflict`,`${e.message} Call agent_get to read the current state before answering again.`);case`not_found`:throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND)}}function invocationResult(e){let t=parseJsonObject({...e,status:e.status===`awaiting-input`?`input_required`:e.status});return{content:[{text:JSON.stringify(t),type:`text`}],structuredContent:t}}const MAX_MESSAGE_BYTES=65536,MAX_ID_CHARS=256,MAX_RESPONSES_PER_UPDATE=64;function utf8Bounded(e){let t=new TextEncoder;return z.string().refine(n=>t.encode(n).byteLength<=e,{message:`must be at most ${String(e)} bytes when UTF-8 encoded`})}const MCP_INPUT_RESPONSE_SCHEMA=answerSchema.safeExtend({optionId:z.string().max(256).optional(),interactionId:z.string().min(1).max(256),text:utf8Bounded(16384).optional()}),AGENT_INVOCATION_BASE_SCHEMA=z.strictObject({sessionEnded:z.boolean(),createdAt:z.iso.datetime(),expiresAt:z.iso.datetime().optional(),invocationId:z.string()}),AGENT_INVOCATION_OUTPUT_SCHEMA=z.discriminatedUnion(`status`,[AGENT_INVOCATION_BASE_SCHEMA.extend({pollAfterMs:z.number().int().nonnegative(),result:z.json().optional(),status:z.literal(`working`),statusMessage:z.string().optional()}),AGENT_INVOCATION_BASE_SCHEMA.extend({interactions:z.record(z.string(),interactionJsonSchema),pollAfterMs:z.number().int().nonnegative().optional(),result:z.json().optional(),status:z.literal(`input_required`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({result:z.json().optional(),status:z.literal(`completed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({error:z.strictObject({code:z.number().int(),data:z.json().optional(),message:z.string()}),status:z.literal(`failed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({status:z.literal(`cancelled`)})]);export{mcpChannel};
1
+ import{z}from"#compiled/zod/index.js";import{answerSchema}from"#shared/input.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{parseJsonObject}from"#shared/json.js";import{DELETE,GET,HEAD,OPTIONS,POST,defineChannel}from"#public/definitions/channel.js";import{routeAuth}from"#public/channels/auth.js";import{readAgentInfoRouteResponse,readRouteChannelName,readRouteSessionCreator,readSkillFileSource}from"#internal/nitro/routes/channel-route-context.js";import{sessionAuthFromResult}from"#channel/auth/result.js";import{escapeAuthChallengeParameter,readOAuthResourceOptions}from"#channel/auth/definitions.js";import{interactionJsonSchema}from"#protocol/interaction-json.js";import{McpToolOperationError,createMcpStreamableHttpServer,defineMcpTool}from"#internal/mcp/streamable-http-server.js";import{WorkflowAgentInvocationExecution}from"#internal/invocation/workflow-execution.js";import{MCP_TOOL_SESSIONS_EXTENSION,createPublishedTools}from"#internal/mcp/published-tools.js";import{resolveMcpRequestPrincipals}from"#internal/mcp/forwarded-principal-header.js";import{createMcpSkillsFeature}from"#internal/mcp/skills.js";import{validateMcpHttpRequest,validateMcpMetadataRequest}from"#internal/mcp/http-security.js";import{createMcpProtectedResourceMetadata,createMcpResourceChallenge}from"#internal/mcp/protected-resource.js";function mcpChannel(e){if(e?.auth===void 0)throw Error(`mcpChannel requires auth. Use none() for explicit public access.`);let t={agent:e.agent??!0,skills:e.skills??!1,tools:e.tools??!1};if(!t.agent&&!t.tools&&!t.skills)throw Error(`mcpChannel publishes nothing with agent, tools, and skills all false. Enable one.`);let n=e.route??`/eve/v1/mcp`,r=readOAuthResourceOptions(e.auth),handle=async(n,i)=>await authenticateMcpRequest(n,i,e,r,t),i=[GET(n,handle),POST(n,handle),DELETE(n,handle)];return r!==void 0&&i.unshift(...protectedResourceMetadataRoutes(r,n)),defineChannel({routes:i})}function protectedResourceMetadataRoutes(e,t){let n=protectedResourceMetadataPath(e,t);return[GET(n,async n=>protectedResourceMetadataResponse(n,e,t,!1)),HEAD(n,async n=>protectedResourceMetadataResponse(n,e,t,!0)),OPTIONS(n,async e=>protectedResourceMetadataOptionsResponse(e))]}function protectedResourceMetadataPath(e,t){if(e.metadataPath!==void 0)return e.metadataPath;let n=e.resource===void 0?t:new URL(e.resource).pathname;return n===`/`?`/.well-known/oauth-protected-resource`:`/.well-known/oauth-protected-resource${n}`}function protectedResourceMetadataResponse(e,t,n,r){let i=validateMcpMetadataRequest(e);if(i!==void 0)return i;let a=t.resource??new URL(n,new URL(e.url).origin).toString(),o=t.issuer===void 0?t.authorizationServers:[t.issuer],s=Response.json(createMcpProtectedResourceMetadata({authorizationServers:o,resource:a,scopesSupported:t.scopes}),{headers:{"access-control-allow-origin":`*`,"cache-control":`no-store`}});return r?new Response(null,{headers:s.headers,status:s.status}):s}function protectedResourceMetadataOptionsResponse(e){let t=validateMcpMetadataRequest(e);if(t!==void 0)return t;let n=new Headers({"access-control-allow-methods":`GET, HEAD, OPTIONS`,"access-control-allow-origin":`*`,"cache-control":`no-store`}),r=e.headers.get(`access-control-request-headers`);return r!==null&&(n.set(`access-control-allow-headers`,r),n.set(`vary`,`Access-Control-Request-Headers`)),new Response(null,{headers:n,status:204})}function addResourceChallenge(e,t,n){if(e.status!==401&&e.status!==403)return e;let r=protectedResourceMetadataPath(n,new URL(t.url).pathname),i=n.resource??new URL(t.url).origin,a=new URL(r,i).toString(),o=new Headers(e.headers),s=o.get(`www-authenticate`);if(e.status===401)o.set(`www-authenticate`,mergeMcpBearerChallenge(s,a,n.scopes));else{let t=augmentInsufficientScopeChallenge(s,a);if(t===void 0)return e;o.set(`www-authenticate`,t)}return new Response(e.body,{headers:o,status:e.status,statusText:e.statusText})}function mergeMcpBearerChallenge(e,t,n){let r=parseAuthChallenges(e),i=r.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`))??r.find(e=>e.scheme.toLowerCase()===`bearer`);return replaceBearerChallenges(r,i,i===void 0?createMcpResourceChallenge(t,n):augmentBearerChallenge(i.value,t,n))}function augmentInsufficientScopeChallenge(e,t){let n=parseAuthChallenges(e),r=n.find(e=>e.scheme.toLowerCase()===`bearer`&&hasAuthParameter(e.value,`error`,`insufficient_scope`));if(r!==void 0)return replaceBearerChallenges(n,r,augmentBearerChallenge(r.value,t))}function replaceBearerChallenges(e,t,n){let r=[],i=!1;for(let a of e){if(a.scheme.toLowerCase()!==`bearer`){r.push(a.value);continue}!i&&a===t&&(r.push(n),i=!0)}return i||r.push(n),r.join(`, `)}function augmentBearerChallenge(e,t,n){let r=e;return hasAuthParameter(r,`resource_metadata`)||(r=appendAuthParameter(r,`resource_metadata`,t)),n?.length&&!hasAuthParameter(r,`scope`)&&(r=appendAuthParameter(r,`scope`,n.join(` `))),r}function appendAuthParameter(e,t,n){return`${e}${e.trim().toLowerCase()===`bearer`?` `:`, `}${t}="${escapeAuthChallengeParameter(n)}"`}function hasAuthParameter(e,t,n){let r=t.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);if(n===void 0)return RegExp(`(?:^|[\\s,])${r}\\s*=`,`i`).test(e);let i=n.replaceAll(/[.*+?^${}()|[\]\\]/g,`\\$&`);return RegExp(`(?:^|[\\s,])${r}\\s*=\\s*(?:"${i}"|${i})(?=$|[\\s,])`,`i`).test(e)}function parseAuthChallenges(e){if(e===null)return[];let t=[];for(let n of splitQuotedHeaderList(e)){let e=readChallengeScheme(n);if(e!==void 0){t.push({scheme:e,value:n});continue}let r=t.at(-1);r!==void 0&&(r.value+=`, ${n}`)}return t}function splitQuotedHeaderList(e){let t=[],n=!1,r=!1,i=0;for(let a=0;a<e.length;a++){let o=e[a];if(n)n=!1;else if(o===`\\`)n=!0;else if(o===`"`)r=!r;else if(o===`,`&&!r){let n=e.slice(i,a).trim();n.length>0&&t.push(n),i=a+1}}let a=e.slice(i).trim();return a.length>0&&t.push(a),t}function readChallengeScheme(e){let t=/^([!#$%&'*+\-.^_`|~0-9A-Za-z]+)(?:\s+|$)/.exec(e);if(t===null)return;let n=t[1];if(n!==void 0)return e.slice(n.length).trimStart().startsWith(`=`)?void 0:n}async function authenticateMcpRequest(e,t,n,r,i){let a=validateMcpHttpRequest(e);if(a!==void 0)return a;let o=await routeAuth(e,n.auth);if(o instanceof Response)return r===void 0?o:addResourceChallenge(o,e,r);let s=sessionAuthFromResult(o),c=await resolveMcpRequestPrincipals(e,s,n.trustedForwarders);return c instanceof Response?c:await handleMcpRequest(e,t,s,c,i)}async function handleMcpRequest(e,t,n,r,i){let a=readRouteSessionCreator(t),o=readRouteChannelName(t),s=readAgentInfoRouteResponse(t);if(o===void 0||a===void 0||s===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});let c=await s();if(!c.ok)return c;let l=await c.json();if(typeof l.agent?.name!=`string`)return Response.json({error:`MCP requires compiled agent metadata.`},{status:500});let u=typeof l.agent.description==`string`?l.agent.description:void 0,d=new WorkflowAgentInvocationExecution({createSession:a,from:t.from}),f=i.agent?createInvocationTools(d,u,n.authenticator===`none`&&n.principalType===`anonymous`):[],p=i.tools||i.skills?await t.describe():void 0,m=i.tools&&p!==void 0?createPublishedTools({invokeTool:t.invokeTool,principals:r,reserved:new Set(f.map(e=>e.name)),tools:p.tools}):[],h=[];if(i.tools&&h.push({capabilities:{extensions:{[MCP_TOOL_SESSIONS_EXTENSION]:{}}},register(){}}),i.skills&&p!==void 0){let e=readSkillFileSource(t);if(e===void 0)return Response.json({error:`MCP requires agent route context.`},{status:500});h.push(createMcpSkillsFeature({files:e,skills:p.skills}))}return await createMcpStreamableHttpServer({authenticate:async()=>n,features:h,instructions:i.agent?MCP_SERVER_INSTRUCTIONS:void 0,name:l.agent.name,tools:i.agent||i.tools?[...f,...m]:void 0,version:resolveInstalledPackageInfo().version})(e)}const MCP_SERVER_INSTRUCTIONS=[`Each invocation is one durable agent task.`,`Call agent_start once per task and keep the returned invocationId.`,`Poll agent_get, waiting at least pollAfterMs between calls, until status is completed, failed, or cancelled.`,`If status is input_required, answer all non-sign-in interactions in one agent_update by interactionId; repeating accepted answers is safe.`,`For sign-in interactions, follow signIn instructions outside agent_update and keep polling.`,`isError on a tool result means your call was rejected; a failed status means the task failed.`,`agent_start is not idempotent and a lost response leaves no invocationId, so ask the user before starting again.`,`Work continues after your connection drops; agent_cancel stops it, then poll until any terminal status.`].join(` `);function createInvocationTools(e,t,n){let r=n?` On this public channel, the invocation ID is a bearer capability until workflow retention expires.`:``,i=`Starts durable work and returns an invocation handle immediately. Call once per task; keep invocationId and poll agent_get. Not idempotent: if the response is lost, ask the user before starting again rather than retrying.${r}`;return[defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:t===void 0?i:`${t} ${i}`,inputSchema:z.strictObject({message:utf8Bounded(MAX_MESSAGE_BYTES).min(1)}),name:`agent_start`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(await e.create({auth:n.auth,message:t.message}))}}),defineMcpTool({definition:{annotations:{destructiveHint:!1,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!0},description:`Reads complete durable invocation state. Wait at least pollAfterMs between calls. While working, statusMessage, when present, describes the current activity. Terminal statuses are completed, failed, and cancelled. input_required includes questions, approvals, and sign-ins. Answer questions and approvals with agent_update; follow sign-in instructions and poll for sign-ins.${r}`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_get`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.read({auth:n.auth,invocationId:t.invocationId})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!1,openWorldHint:!0,readOnlyHint:!1},description:`Answers the pending input batch on an input_required invocation. Include one response per entry in interactions, naming it by its key as interactionId, in a single call; partial batches are rejected. Returns the current invocation state; repeating the same accepted answers is safe.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS),responses:z.array(MCP_INPUT_RESPONSE_SCHEMA).min(1).max(MAX_RESPONSES_PER_UPDATE)}),name:`agent_update`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredMutation(await e.update({auth:n.auth,invocationId:t.invocationId,responses:t.responses})))}}),defineMcpTool({definition:{annotations:{destructiveHint:!0,idempotentHint:!0,openWorldHint:!1,readOnlyHint:!1},description:`Requests cooperative cancellation of a non-terminal invocation. Cancellation is asynchronous and can race with completion: poll agent_get until status is terminal (cancelled, completed, or failed). Safe to call repeatedly.`,inputSchema:z.strictObject({invocationId:z.string().min(1).max(MAX_ID_CHARS)}),name:`agent_cancel`,outputSchema:AGENT_INVOCATION_OUTPUT_SCHEMA},async call(t,n){return invocationResult(requiredInvocation(await e.cancel({auth:n.auth,invocationId:t.invocationId})))}})]}const INVOCATION_NOT_FOUND=`Invocation not found. It may have expired or belong to another caller.`;function requiredInvocation(e){if(e===void 0)throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND);return e}function requiredMutation(e){switch(e.type){case`success`:return e.invocation;case`conflict`:throw new McpToolOperationError(`conflict`,`${e.message} Call agent_get to read the current state before answering again.`);case`not_found`:throw new McpToolOperationError(`not_found`,INVOCATION_NOT_FOUND)}}function invocationResult(e){let t=parseJsonObject({...e,status:e.status===`awaiting-input`?`input_required`:e.status});return{content:[{text:JSON.stringify(t),type:`text`}],structuredContent:t}}const MAX_MESSAGE_BYTES=65536,MAX_ID_CHARS=256,MAX_RESPONSES_PER_UPDATE=64;function utf8Bounded(e){let t=new TextEncoder;return z.string().refine(n=>t.encode(n).byteLength<=e,{message:`must be at most ${String(e)} bytes when UTF-8 encoded`})}const MCP_INPUT_RESPONSE_SCHEMA=answerSchema.safeExtend({optionId:z.string().max(256).optional(),interactionId:z.string().min(1).max(256),text:utf8Bounded(16384).optional()}),AGENT_INVOCATION_BASE_SCHEMA=z.strictObject({sessionEnded:z.boolean(),createdAt:z.iso.datetime(),expiresAt:z.iso.datetime().optional(),invocationId:z.string()}),AGENT_INVOCATION_OUTPUT_SCHEMA=z.discriminatedUnion(`status`,[AGENT_INVOCATION_BASE_SCHEMA.extend({pollAfterMs:z.number().int().nonnegative(),result:z.json().optional(),status:z.literal(`working`),statusMessage:z.string().optional()}),AGENT_INVOCATION_BASE_SCHEMA.extend({interactions:z.record(z.string(),interactionJsonSchema),pollAfterMs:z.number().int().nonnegative().optional(),result:z.json().optional(),status:z.literal(`input_required`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({result:z.json().optional(),status:z.literal(`completed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({error:z.strictObject({code:z.number().int(),data:z.json().optional(),message:z.string()}),status:z.literal(`failed`)}),AGENT_INVOCATION_BASE_SCHEMA.extend({status:z.literal(`cancelled`)})]);export{mcpChannel};
@@ -143,7 +143,8 @@ export type HitlFreeformModalMetadata = SlackSessionTarget & {
143
143
  /**
144
144
  * Builds the `views.open` payload for the freeform-answer modal. The
145
145
  * triggering `prompt` is preserved as a header section so the user can
146
- * re-read what they're answering inside the modal.
146
+ * re-read what they're answering inside the modal. `prompt` is the posted
147
+ * card's mrkdwn, which was escaped when the card was rendered.
147
148
  *
148
149
  * Title is auto-truncated to the Slack modal-title limit.
149
150
  */
@@ -1,4 +1,4 @@
1
- import{parseAnswer}from"#shared/input.js";import{truncate}from"#public/channels/text.js";import{SLACK_SECTION_TEXT_MAX_LENGTH,truncateCardBodyText,truncateModalTitle,truncatePlainText,truncateSectionText}from"#public/channels/slack/limits.js";const ANSWER_ACTION_PREFIX=`eve_input:`,HITL_FREEFORM_ACTION_PREFIX=`eve_input_freeform:`,HITL_FREEFORM_MODAL_CALLBACK_ID=`eve_input_freeform_submit`,HITL_FREEFORM_MODAL_BLOCK_ID=`eve_freeform_block`,HITL_FREEFORM_MODAL_ACTION_ID=`eve_freeform_text`,HITL_ROUTE_PREFIX=`${ANSWER_ACTION_PREFIX}route:`,HITL_CODE_CHANNEL_ROUTE_PREFIX=`${ANSWER_ACTION_PREFIX}code:`,BUTTON_ACTION_ID_RE=/^(?:(?<kind>tool-approval):)?(?<requestId>.+):button:\d+$/u,TOOL_INPUT_SUFFIX="\n```",answerFromSlackAction=e=>decodeHitlResponse(e);function decodeHitlResponse(e){let t=decodeHitlActionId(e.actionId);if(t===null)return null;let n=e.selectedOptionValue??e.value;if(n===void 0||e.value!==void 0&&!t.button)return null;let r={response:parseAnswer({interactionId:t.requestId,optionId:n})};return t.kind!==void 0&&(r.kind=t.kind),t.route!==void 0&&(r.route=t.route),r}function splitEncodedRequest(e){return e.startsWith(`tool-approval:`)?{kind:`tool-approval`,requestId:e.slice(14)}:{requestId:e}}function isHitlAction(e){return e.startsWith(ANSWER_ACTION_PREFIX)}function decodeHitlActionId(e){if(!e.startsWith(`eve_input:`))return null;let t=e.slice(10),n;if(t.startsWith(`route:`)){t=t.slice(6);let e=t.indexOf(`:`),r=t.indexOf(`:`,e+1);if(e<=0||r<=e+1)return null;n={channelId:t.slice(0,e),threadTs:t.slice(e+1,r)},t=t.slice(r+1)}else if(t.startsWith(`code:`)){t=t.slice(5);let e=t.indexOf(`:`);if(e<=0)return null;n={channelId:t.slice(0,e),codeChannel:!0},t=t.slice(e+1)}let r=BUTTON_ACTION_ID_RE.exec(t),i=splitEncodedRequest(r?.groups?.requestId??t);if(!i.requestId)return null;let a=r?.groups?.kind===`tool-approval`?`tool-approval`:i.kind,o={button:r!==null,requestId:i.requestId};return a!==void 0&&(o.kind=a),n!==void 0&&(o.route=n),o}function encodeHitlActionId(e,t){let n=`${e.request.kind===`approval`?`tool-approval:`:``}${e.interactionId}`;return t===void 0?`${ANSWER_ACTION_PREFIX}${n}`:t.codeChannel===!0?`${HITL_CODE_CHANNEL_ROUTE_PREFIX}${t.channelId}:${n}`:`${HITL_ROUTE_PREFIX}${t.channelId}:${t.threadTs}:${n}`}function renderInteractionBlocks(e,t){let n={text:{text:truncateSectionText(e.request.prompt),type:`mrkdwn`},type:`section`},r=renderInteractionDetailBlocks(e),i=encodeHitlActionId(e,t),a=e.request.options,o=e.request.allowFreeform===!0||!a||a.length===0;if(a&&a.length>0&&e.request.display===`select`){let e=a.length<=6?{type:`radio_buttons`,action_id:i,options:a.map(buildOption)}:{type:`static_select`,action_id:i,options:a.map(buildOption),placeholder:{type:`plain_text`,text:`Choose an option`}};return[n,...r,{type:`actions`,elements:[e]}]}if(a&&a.length>0){let t=renderInteractionCardBlock(e,i),n=renderToolInputContainerBlock(e);return n===void 0?[t]:[t,n]}if(o){let t=i.replace(ANSWER_ACTION_PREFIX,HITL_FREEFORM_ACTION_PREFIX);return[n,...r,{type:`actions`,elements:[{type:`button`,action_id:t,text:{type:`plain_text`,text:`Type your answer`},style:`primary`,value:e.interactionId}]}]}return[n]}function renderInteractionPostParts(e,t){let n=renderInteractionBlocks(e,t),[r,...i]=n;return!isApprovalRequest(e)||r===void 0||!isBlockType(r,`card`)||i.length===0?{controls:{blocks:n,text:formatInteractionFallbackText(e)}}:{controls:{blocks:[r],text:e.request.prompt},details:{blocks:i,text:formatInteractionFallbackText(e)}}}function formatInteractionFallbackText(e){let t=formatToolInputDetails(e);return t===void 0?e.request.prompt:`${e.request.prompt}\n${t}`}function buildFreeformModalView(e){let t=e.prompt?truncateModalTitle(e.prompt):`Your answer`,n=e.prompt?[{type:`section`,text:{type:`mrkdwn`,text:truncateSectionText(e.prompt)}}]:[];return{type:`modal`,callback_id:HITL_FREEFORM_MODAL_CALLBACK_ID,private_metadata:JSON.stringify(e.metadata),title:{type:`plain_text`,text:t},submit:{type:`plain_text`,text:`Submit`},close:{type:`plain_text`,text:`Cancel`},blocks:[...n,{type:`input`,block_id:HITL_FREEFORM_MODAL_BLOCK_ID,element:{type:`plain_text_input`,action_id:HITL_FREEFORM_MODAL_ACTION_ID,multiline:!0,placeholder:{type:`plain_text`,text:`Type your answer here...`}},label:{type:`plain_text`,text:`Answer`}}]}}function isFreeformAction(e){return e.startsWith(HITL_FREEFORM_ACTION_PREFIX)}function decodeFreeformHitlActionId(e){return isFreeformAction(e)?decodeHitlActionId(`${ANSWER_ACTION_PREFIX}${e.slice(19)}`):null}function buildCardButton(e,t,n){let r={type:`button`,text:{type:`plain_text`,text:truncatePlainText(e.label),emoji:!1},action_id:`${t}:button:${n}`,value:e.id};return(e.style===`primary`||e.style===`danger`)&&(r.style=e.style),r}function buildOption(e){let t={text:{text:truncatePlainText(e.label),type:`plain_text`},value:e.id},n=truncatePlainText(e.description);return n&&n.length>0&&(t.description={text:n,type:`plain_text`}),t}function renderInteractionCardBlock(e,t){let n={type:`card`,body:{type:`mrkdwn`,text:truncateCardBodyText(`*${e.request.prompt}*`),verbatim:!1},actions:cardButtonOptions(e).map((e,n)=>buildCardButton(e,t,n))};return isApprovalRequest(e)&&(n.subtext={type:`mrkdwn`,text:`I've paused until someone approves or denies.`}),n}function cardButtonOptions(e){let t=e.request.options??[];if(!isApprovalRequest(e))return t.map(toCardButtonOption);let n=t.find(e=>e.id===`approve`),r=t.find(e=>e.id===`deny`);return!n||!r?t.map(toCardButtonOption):[{id:r.id,label:`Deny`},{id:n.id,label:`Approve`,style:`primary`}]}function toCardButtonOption(e){let t={id:e.id,label:e.label};return e.style===`primary`||e.style===`danger`?{...t,style:e.style}:t}function buildAnsweredBlocks(e){let t=[];for(let n of e.promptBlocks)n!=null&&t.push(n);let n=truncate(e.answerLabel,SLACK_SECTION_TEXT_MAX_LENGTH-20-1);return t.push({type:`section`,text:{type:`mrkdwn`,text:`:white_check_mark: *${n}*`}}),e.userId&&e.userId.length>0&&t.push({type:`context`,elements:[{type:`mrkdwn`,text:`Answered by <@${e.userId}>`}]}),t}function renderInteractionDetailBlocks(e){let t=formatToolInputDetails(e);return t===void 0?[]:[{type:`section`,text:{type:`mrkdwn`,text:t}}]}function renderToolInputContainerBlock(e){let t=formatToolInputContainerText(e);if(t!==void 0)return{type:`container`,title:{type:`plain_text`,text:`Tool input`},is_collapsible:!0,default_collapsed:!0,child_blocks:[{type:`section`,text:{type:`mrkdwn`,text:t}}]}}function formatToolInputContainerText(e){if(!isApprovalRequest(e))return;let t=JSON.stringify(e.call?.input??{},null,2);if(t===`{}`)return;let n=SLACK_SECTION_TEXT_MAX_LENGTH-4-4;return`\`\`\`
2
- ${truncate(t,n)}${TOOL_INPUT_SUFFIX}`}function formatToolInputDetails(e){if(!isApprovalRequest(e))return;let t=JSON.stringify(e.call?.input??{},null,2);if(t===`{}`)return;let n=SLACK_SECTION_TEXT_MAX_LENGTH-17-4;return`*Tool input*
1
+ import{parseAnswer}from"#shared/input.js";import{truncate}from"#public/channels/text.js";import{SLACK_SECTION_TEXT_MAX_LENGTH,truncateCardBodyText,truncateModalTitle,truncatePlainText,truncateSectionText}from"#public/channels/slack/limits.js";import{escapeSlackText,unescapeSlackText}from"#compiled/@chat-adapter/slack/format.js";const ANSWER_ACTION_PREFIX=`eve_input:`,HITL_FREEFORM_ACTION_PREFIX=`eve_input_freeform:`,HITL_FREEFORM_MODAL_CALLBACK_ID=`eve_input_freeform_submit`,HITL_FREEFORM_MODAL_BLOCK_ID=`eve_freeform_block`,HITL_FREEFORM_MODAL_ACTION_ID=`eve_freeform_text`,HITL_ROUTE_PREFIX=`${ANSWER_ACTION_PREFIX}route:`,HITL_CODE_CHANNEL_ROUTE_PREFIX=`${ANSWER_ACTION_PREFIX}code:`,BUTTON_ACTION_ID_RE=/^(?:(?<kind>tool-approval):)?(?<requestId>.+):button:\d+$/u,TOOL_INPUT_SUFFIX="\n```",answerFromSlackAction=e=>decodeHitlResponse(e);function decodeHitlResponse(e){let t=decodeHitlActionId(e.actionId);if(t===null)return null;let n=e.selectedOptionValue??e.value;if(n===void 0||e.value!==void 0&&!t.button)return null;let r={response:parseAnswer({interactionId:t.requestId,optionId:n})};return t.kind!==void 0&&(r.kind=t.kind),t.route!==void 0&&(r.route=t.route),r}function splitEncodedRequest(e){return e.startsWith(`tool-approval:`)?{kind:`tool-approval`,requestId:e.slice(14)}:{requestId:e}}function isHitlAction(e){return e.startsWith(ANSWER_ACTION_PREFIX)}function decodeHitlActionId(e){if(!e.startsWith(`eve_input:`))return null;let t=e.slice(10),n;if(t.startsWith(`route:`)){t=t.slice(6);let e=t.indexOf(`:`),r=t.indexOf(`:`,e+1);if(e<=0||r<=e+1)return null;n={channelId:t.slice(0,e),threadTs:t.slice(e+1,r)},t=t.slice(r+1)}else if(t.startsWith(`code:`)){t=t.slice(5);let e=t.indexOf(`:`);if(e<=0)return null;n={channelId:t.slice(0,e),codeChannel:!0},t=t.slice(e+1)}let r=BUTTON_ACTION_ID_RE.exec(t),i=splitEncodedRequest(r?.groups?.requestId??t);if(!i.requestId)return null;let a=r?.groups?.kind===`tool-approval`?`tool-approval`:i.kind,o={button:r!==null,requestId:i.requestId};return a!==void 0&&(o.kind=a),n!==void 0&&(o.route=n),o}function encodeHitlActionId(e,t){let n=`${e.request.kind===`approval`?`tool-approval:`:``}${e.interactionId}`;return t===void 0?`${ANSWER_ACTION_PREFIX}${n}`:t.codeChannel===!0?`${HITL_CODE_CHANNEL_ROUTE_PREFIX}${t.channelId}:${n}`:`${HITL_ROUTE_PREFIX}${t.channelId}:${t.threadTs}:${n}`}function renderInteractionBlocks(e,t){let n={text:{text:truncateSectionText(escapeSlackText(e.request.prompt)),type:`mrkdwn`},type:`section`},r=renderInteractionDetailBlocks(e),i=encodeHitlActionId(e,t),a=e.request.options,o=e.request.allowFreeform===!0||!a||a.length===0;if(a&&a.length>0&&e.request.display===`select`){let e=a.length<=6?{type:`radio_buttons`,action_id:i,options:a.map(buildOption)}:{type:`static_select`,action_id:i,options:a.map(buildOption),placeholder:{type:`plain_text`,text:`Choose an option`}};return[n,...r,{type:`actions`,elements:[e]}]}if(a&&a.length>0){let t=renderInteractionCardBlock(e,i),n=renderToolInputContainerBlock(e);return n===void 0?[t]:[t,n]}if(o){let t=i.replace(ANSWER_ACTION_PREFIX,HITL_FREEFORM_ACTION_PREFIX);return[n,...r,{type:`actions`,elements:[{type:`button`,action_id:t,text:{type:`plain_text`,text:`Type your answer`},style:`primary`,value:e.interactionId}]}]}return[n]}function renderInteractionPostParts(e,t){let n=renderInteractionBlocks(e,t),[r,...i]=n;return!isApprovalRequest(e)||r===void 0||!isBlockType(r,`card`)||i.length===0?{controls:{blocks:n,text:formatInteractionFallbackText(e)}}:{controls:{blocks:[r],text:escapeSlackText(e.request.prompt)},details:{blocks:i,text:formatInteractionFallbackText(e)}}}function formatInteractionFallbackText(e){let t=escapeSlackText(e.request.prompt),n=formatToolInputDetails(e);return n===void 0?t:`${t}\n${n}`}function buildFreeformModalView(e){let t=e.prompt?truncateModalTitle(unescapeSlackText(e.prompt)):`Your answer`,n=e.prompt?[{type:`section`,text:{type:`mrkdwn`,text:truncateSectionText(e.prompt)}}]:[];return{type:`modal`,callback_id:HITL_FREEFORM_MODAL_CALLBACK_ID,private_metadata:JSON.stringify(e.metadata),title:{type:`plain_text`,text:t},submit:{type:`plain_text`,text:`Submit`},close:{type:`plain_text`,text:`Cancel`},blocks:[...n,{type:`input`,block_id:HITL_FREEFORM_MODAL_BLOCK_ID,element:{type:`plain_text_input`,action_id:HITL_FREEFORM_MODAL_ACTION_ID,multiline:!0,placeholder:{type:`plain_text`,text:`Type your answer here...`}},label:{type:`plain_text`,text:`Answer`}}]}}function isFreeformAction(e){return e.startsWith(HITL_FREEFORM_ACTION_PREFIX)}function decodeFreeformHitlActionId(e){return isFreeformAction(e)?decodeHitlActionId(`${ANSWER_ACTION_PREFIX}${e.slice(19)}`):null}function buildCardButton(e,t,n){let r={type:`button`,text:{type:`plain_text`,text:truncatePlainText(e.label),emoji:!1},action_id:`${t}:button:${n}`,value:e.id};return(e.style===`primary`||e.style===`danger`)&&(r.style=e.style),r}function buildOption(e){let t={text:{text:truncatePlainText(e.label),type:`plain_text`},value:e.id},n=truncatePlainText(e.description);return n&&n.length>0&&(t.description={text:n,type:`plain_text`}),t}function renderInteractionCardBlock(e,t){let n={type:`card`,body:{type:`mrkdwn`,text:truncateCardBodyText(`*${escapeSlackText(e.request.prompt)}*`),verbatim:!1},actions:cardButtonOptions(e).map((e,n)=>buildCardButton(e,t,n))};return isApprovalRequest(e)&&(n.subtext={type:`mrkdwn`,text:`I've paused until someone approves or denies.`}),n}function cardButtonOptions(e){let t=e.request.options??[];if(!isApprovalRequest(e))return t.map(toCardButtonOption);let n=t.find(e=>e.id===`approve`),r=t.find(e=>e.id===`deny`);return!n||!r?t.map(toCardButtonOption):[{id:r.id,label:`Deny`},{id:n.id,label:`Approve`,style:`primary`}]}function toCardButtonOption(e){let t={id:e.id,label:e.label};return e.style===`primary`||e.style===`danger`?{...t,style:e.style}:t}function buildAnsweredBlocks(e){let t=[];for(let n of e.promptBlocks)n!=null&&t.push(n);let n=truncate(escapeSlackText(e.answerLabel),SLACK_SECTION_TEXT_MAX_LENGTH-20-1);return t.push({type:`section`,text:{type:`mrkdwn`,text:`:white_check_mark: *${n}*`}}),e.userId&&e.userId.length>0&&t.push({type:`context`,elements:[{type:`mrkdwn`,text:`Answered by <@${e.userId}>`}]}),t}function renderInteractionDetailBlocks(e){let t=formatToolInputDetails(e);return t===void 0?[]:[{type:`section`,text:{type:`mrkdwn`,text:t}}]}function renderToolInputContainerBlock(e){let t=formatToolInputContainerText(e);if(t!==void 0)return{type:`container`,title:{type:`plain_text`,text:`Tool input`},is_collapsible:!0,default_collapsed:!0,child_blocks:[{type:`section`,text:{type:`mrkdwn`,text:t}}]}}function formatToolInputContainerText(e){if(!isApprovalRequest(e))return;let t=JSON.stringify(e.call?.input??{},null,2);if(t===`{}`)return;let n=escapeSlackText(t),r=SLACK_SECTION_TEXT_MAX_LENGTH-4-4;return`\`\`\`
2
+ ${truncate(n,r)}${TOOL_INPUT_SUFFIX}`}function formatToolInputDetails(e){if(!isApprovalRequest(e))return;let t=JSON.stringify(e.call?.input??{},null,2);if(t===`{}`)return;let n=escapeSlackText(t),r=SLACK_SECTION_TEXT_MAX_LENGTH-17-4;return`*Tool input*
3
3
  \`\`\`
4
- ${truncate(t,n)}${TOOL_INPUT_SUFFIX}`}function isBlockType(e,t){return typeof e==`object`&&!!e&&e.type===t}function isApprovalRequest(e){return e.request.kind===`approval`}export{ANSWER_ACTION_PREFIX,HITL_FREEFORM_ACTION_PREFIX,HITL_FREEFORM_MODAL_ACTION_ID,HITL_FREEFORM_MODAL_BLOCK_ID,HITL_FREEFORM_MODAL_CALLBACK_ID,answerFromSlackAction,buildAnsweredBlocks,buildFreeformModalView,decodeFreeformHitlActionId,decodeHitlActionId,decodeHitlResponse,formatInteractionFallbackText,isFreeformAction,isHitlAction,renderInteractionBlocks,renderInteractionPostParts};
4
+ ${truncate(n,r)}${TOOL_INPUT_SUFFIX}`}function isBlockType(e,t){return typeof e==`object`&&!!e&&e.type===t}function isApprovalRequest(e){return e.request.kind===`approval`}export{ANSWER_ACTION_PREFIX,HITL_FREEFORM_ACTION_PREFIX,HITL_FREEFORM_MODAL_ACTION_ID,HITL_FREEFORM_MODAL_BLOCK_ID,HITL_FREEFORM_MODAL_CALLBACK_ID,answerFromSlackAction,buildAnsweredBlocks,buildFreeformModalView,decodeFreeformHitlActionId,decodeHitlActionId,decodeHitlResponse,formatInteractionFallbackText,isFreeformAction,isHitlAction,renderInteractionBlocks,renderInteractionPostParts};
@@ -1 +1 @@
1
- import{truncate}from"#public/channels/text.js";import{callSlackApi}from"#public/channels/slack/api.js";import{SLACK_CARD_SUBTEXT_MAX_LENGTH,truncateCardSubtext}from"#public/channels/slack/limits.js";import{buildAnsweredBlocks,isHitlAction}from"#public/channels/slack/hitl.js";function buildSettledHitlMessageBlocks(e){let t=e.messageBlocks.findIndex(t=>blockContainsActionId(t,e.actionId));if(t===-1)return buildAnsweredBlocks({promptBlocks:findPromptBlocks(e.messageBlocks),answerLabel:e.card.label,userId:e.card.userId});let n=e.messageBlocks[t],r=answeredBlocksFromActionBlock({answerLabel:e.card.label,block:n,userId:e.card.userId})??buildAnsweredBlocks({promptBlocks:promptBlocksFromActionBlock(n),answerLabel:e.card.label,userId:e.card.userId});return[...e.messageBlocks.slice(0,t),...r,...e.messageBlocks.slice(t+1)]}function findPromptBlocks(e){let t=[];for(let n of e){if(!isObjectRecord(n))continue;let e=n.type;if(e===`actions`)break;(e===`section`||e===`context`||e===`divider`||e===`image`)&&t.push(n)}return t}function blockContainsActionId(e,t){return isObjectRecord(e)?actionsContainActionId(e.elements,t)||actionsContainActionId(e.actions,t):!1}function actionsContainActionId(e,t){return Array.isArray(e)?e.some(e=>isObjectRecord(e)&&e.action_id===t):!1}function answeredBlocksFromActionBlock(e){if(!isObjectRecord(e.block)||e.block.type!==`card`)return;let{actions:t,subtext:n,...r}=e.block,i={...r,subtext:{type:`mrkdwn`,text:formatAnsweredCardSubtext(e),verbatim:!1}};return hasCardContent(i)?[i]:void 0}function formatAnsweredCardSubtext(e){let t=e.userId===void 0?``:` by <@${e.userId}>`,n=SLACK_CARD_SUBTEXT_MAX_LENGTH-20-1-t.length,r=truncate(e.answerLabel,n);return truncateCardSubtext(`:white_check_mark: *${r}*${t}`)}function promptBlocksFromActionBlock(e){if(!isObjectRecord(e)||e.type!==`card`)return[];let{actions:t,...n}=e;return hasCardContent(n)?[n]:[]}function hasCardContent(e){return e.body!==void 0||e.title!==void 0||e.hero_image!==void 0}function isObjectRecord(e){return typeof e==`object`&&!!e}async function settleHitlCard(e,t,n){let r=e.actions.find(e=>isHitlAction(e.actionId));r?.messageTs&&await updateSettledCard({blocks:buildSettledHitlMessageBlocks({actionId:r.actionId,card:n,messageBlocks:e.messageBlocks}),card:n,channelId:e.channelId,deps:t,installationTeamId:e.installationTeamId,messageTs:r.messageTs})}async function settleFreeformCard(e){await updateSettledCard({...e,blocks:buildAnsweredBlocks({promptBlocks:[],answerLabel:e.card.label,userId:e.card.userId})})}async function updateSettledCard(e){await callSlackApi({api:e.deps.api,botToken:e.deps.config.credentials?.botToken,context:{teamId:e.installationTeamId},operation:`chat.update`,body:{channel:e.channelId,ts:e.messageTs,blocks:e.blocks,text:e.card.text}})}export{answeredBlocksFromActionBlock,settleFreeformCard,settleHitlCard};
1
+ import{truncate}from"#public/channels/text.js";import{callSlackApi}from"#public/channels/slack/api.js";import{SLACK_CARD_SUBTEXT_MAX_LENGTH,truncateCardSubtext}from"#public/channels/slack/limits.js";import{escapeSlackText}from"#compiled/@chat-adapter/slack/format.js";import{buildAnsweredBlocks,isHitlAction}from"#public/channels/slack/hitl.js";function buildSettledHitlMessageBlocks(e){let t=e.messageBlocks.findIndex(t=>blockContainsActionId(t,e.actionId));if(t===-1)return buildAnsweredBlocks({promptBlocks:findPromptBlocks(e.messageBlocks),answerLabel:e.card.label,userId:e.card.userId});let n=e.messageBlocks[t],r=answeredBlocksFromActionBlock({answerLabel:e.card.label,block:n,userId:e.card.userId})??buildAnsweredBlocks({promptBlocks:promptBlocksFromActionBlock(n),answerLabel:e.card.label,userId:e.card.userId});return[...e.messageBlocks.slice(0,t),...r,...e.messageBlocks.slice(t+1)]}function findPromptBlocks(e){let t=[];for(let n of e){if(!isObjectRecord(n))continue;let e=n.type;if(e===`actions`)break;(e===`section`||e===`context`||e===`divider`||e===`image`)&&t.push(n)}return t}function blockContainsActionId(e,t){return isObjectRecord(e)?actionsContainActionId(e.elements,t)||actionsContainActionId(e.actions,t):!1}function actionsContainActionId(e,t){return Array.isArray(e)?e.some(e=>isObjectRecord(e)&&e.action_id===t):!1}function answeredBlocksFromActionBlock(e){if(!isObjectRecord(e.block)||e.block.type!==`card`)return;let{actions:t,subtext:n,...r}=e.block,i={...r,subtext:{type:`mrkdwn`,text:formatAnsweredCardSubtext(e),verbatim:!1}};return hasCardContent(i)?[i]:void 0}function formatAnsweredCardSubtext(e){let t=e.userId===void 0?``:` by <@${e.userId}>`,n=SLACK_CARD_SUBTEXT_MAX_LENGTH-20-1-t.length,r=truncate(escapeSlackText(e.answerLabel),n);return truncateCardSubtext(`:white_check_mark: *${r}*${t}`)}function promptBlocksFromActionBlock(e){if(!isObjectRecord(e)||e.type!==`card`)return[];let{actions:t,...n}=e;return hasCardContent(n)?[n]:[]}function hasCardContent(e){return e.body!==void 0||e.title!==void 0||e.hero_image!==void 0}function isObjectRecord(e){return typeof e==`object`&&!!e}async function settleHitlCard(e,t,n){let r=e.actions.find(e=>isHitlAction(e.actionId));r?.messageTs&&await updateSettledCard({blocks:buildSettledHitlMessageBlocks({actionId:r.actionId,card:n,messageBlocks:e.messageBlocks}),card:n,channelId:e.channelId,deps:t,installationTeamId:e.installationTeamId,messageTs:r.messageTs})}async function settleFreeformCard(e){await updateSettledCard({...e,blocks:buildAnsweredBlocks({promptBlocks:[],answerLabel:e.card.label,userId:e.card.userId})})}async function updateSettledCard(e){await callSlackApi({api:e.deps.api,botToken:e.deps.config.credentials?.botToken,context:{teamId:e.installationTeamId},operation:`chat.update`,body:{channel:e.channelId,ts:e.messageTs,blocks:e.blocks,text:e.card.text}})}export{answeredBlocksFromActionBlock,settleFreeformCard,settleHitlCard};
@@ -1 +1 @@
1
- import{createLogger,logError}from"#internal/logging.js";import{truncate}from"#public/channels/text.js";import{SLACK_MAX_BLOCKS_PER_MESSAGE,SLACK_SECTION_TEXT_MAX_LENGTH}from"#public/channels/slack/limits.js";import{refusedPayloadError}from"#public/channels/slack/reply-delivery.js";import{isFreeformAction,isHitlAction,renderInteractionPostParts}from"#public/channels/slack/hitl.js";import{answeredBlocksFromActionBlock}from"#public/channels/slack/interaction-cards.js";const log=createLogger(`slack.interaction-card`);function defaultInteractionCard(e,t){let{interaction:n}=e,r=renderInteractionPostParts(n,t);if(n.status===`open`&&n.answer===void 0)return r;let{label:i,text:a}=endingOf(n);return{controls:{blocks:[answeredBlocksFromActionBlock({answerLabel:i,block:r.controls.blocks[0],userId:e.answeredBy})?.[0]??answeredSection(n.request.prompt,i,e.answeredBy)],text:a}}}function endingOf(e){let{answer:t,outcome:n,request:r}=e;if(t!==void 0){let e=r.options?.find(e=>e.id===t.optionId)?.label??t.text??t.optionId??`Answered`;return{label:e,text:`Answered: ${e}`}}let i=n===`accepted`?`Accepted`:n===`declined`?`Declined`:`No longer needed`;return{label:i,text:i}}function answeredSection(e,t,n){let r=n===void 0?``:` by <@${n}>`,i=`:white_check_mark: *${truncate(t,500)}*${r}`;return{text:{text:`${truncate(e,SLACK_SECTION_TEXT_MAX_LENGTH-i.length-1)}\n${i}`,type:`mrkdwn`},type:`section`}}function renderRequestCard(e,t,n){let r=defaultInteractionCard(t,n),{interactionId:i}=t.interaction;try{let a=JSON.parse(JSON.stringify(e(t,e=>defaultInteractionCard(e,n)))),o=invalidCardReason(a,r);if(o===void 0)return{fallback:r,parts:a};log.warn(`interactionCard result rejected; using eve's default`,{interactionId:i,problem:o})}catch(e){logError(log,`interactionCard renderer failed; using eve's default`,e,{interactionId:i})}return{fallback:r,parts:r}}function invalidCardReason(e,t){for(let[t,n]of[[`controls`,e.controls],[`details`,e.details]])if(n!==void 0||t!==`details`){if(!isMessage(n))return`${t} is not a message with blocks and text`;if(n.blocks.length>SLACK_MAX_BLOCKS_PER_MESSAGE)return`${t} has more than ${SLACK_MAX_BLOCKS_PER_MESSAGE} blocks`}if(e.details!==void 0&&eveControls(e.details.blocks).length>0)return`details hold eve controls`;let n=eveControls(t.controls.blocks),r=eveControls(e.controls.blocks);if(n.length!==r.length||n.some((e,t)=>e!==r[t]))return n.length===0?`controls of an answered or settled request hold eve controls`:`controls don't hold exactly eve's controls`}function isMessage(e){if(typeof e!=`object`||!e)return!1;let{blocks:t,text:n}=e;return Array.isArray(t)&&typeof n==`string`}function compactDefault(e){let t=e.blocks.filter(e=>eveControls(e).length>0);return t.length===0?e:{...e,blocks:t}}function eveControls(e){let t=[],walk=e=>{if(Array.isArray(e)){for(let t of e)walk(t);return}if(typeof e!=`object`||!e)return;let n=e,r=n.action_id;if(typeof r==`string`&&(isHitlAction(r)||isFreeformAction(r))){let e=Array.isArray(n.options)?n.options.map(e=>e.value).sort():null;t.push(JSON.stringify([r,n.value??null,e]))}for(let t of Object.values(e))walk(t)};return walk(e),t.sort()}async function sendWithFallback(e,t,n){try{return await e(t)}catch(r){if(refusedPayloadError(r)===void 0||sameJson(t,n))throw r;return logError(log,`Slack rejected a rendered input request; sending eve's default`,r),n===void 0?void 0:await e(n)}}function sameJson(e,t){return JSON.stringify(e)===JSON.stringify(t)}export{compactDefault,defaultInteractionCard,endingOf,renderRequestCard,sameJson,sendWithFallback};
1
+ import{createLogger,logError}from"#internal/logging.js";import{truncate}from"#public/channels/text.js";import{SLACK_MAX_BLOCKS_PER_MESSAGE,SLACK_SECTION_TEXT_MAX_LENGTH}from"#public/channels/slack/limits.js";import{refusedPayloadError}from"#public/channels/slack/reply-delivery.js";import{escapeSlackText}from"#compiled/@chat-adapter/slack/format.js";import{isFreeformAction,isHitlAction,renderInteractionPostParts}from"#public/channels/slack/hitl.js";import{answeredBlocksFromActionBlock}from"#public/channels/slack/interaction-cards.js";const log=createLogger(`slack.interaction-card`);function defaultInteractionCard(e,t){let{interaction:n}=e,r=renderInteractionPostParts(n,t);if(n.status===`open`&&n.answer===void 0)return r;let{label:i,text:a}=endingOf(n);return{controls:{blocks:[answeredBlocksFromActionBlock({answerLabel:i,block:r.controls.blocks[0],userId:e.answeredBy})?.[0]??answeredSection(n.request.prompt,i,e.answeredBy)],text:a}}}function endingOf(e){let{answer:t,outcome:n,request:r}=e;if(t!==void 0){let e=r.options?.find(e=>e.id===t.optionId)?.label??t.text??t.optionId??`Answered`;return{label:e,text:`Answered: ${escapeSlackText(e)}`}}let i=n===`accepted`?`Accepted`:n===`declined`?`Declined`:`No longer needed`;return{label:i,text:i}}function answeredSection(e,t,n){let r=n===void 0?``:` by <@${n}>`,i=`:white_check_mark: *${truncate(escapeSlackText(t),500)}*${r}`;return{text:{text:`${truncate(escapeSlackText(e),SLACK_SECTION_TEXT_MAX_LENGTH-i.length-1)}\n${i}`,type:`mrkdwn`},type:`section`}}function renderRequestCard(e,t,n){let r=defaultInteractionCard(t,n),{interactionId:i}=t.interaction;try{let a=JSON.parse(JSON.stringify(e(t,e=>defaultInteractionCard(e,n)))),o=invalidCardReason(a,r);if(o===void 0)return{fallback:r,parts:a};log.warn(`interactionCard result rejected; using eve's default`,{interactionId:i,problem:o})}catch(e){logError(log,`interactionCard renderer failed; using eve's default`,e,{interactionId:i})}return{fallback:r,parts:r}}function invalidCardReason(e,t){for(let[t,n]of[[`controls`,e.controls],[`details`,e.details]])if(n!==void 0||t!==`details`){if(!isMessage(n))return`${t} is not a message with blocks and text`;if(n.blocks.length>SLACK_MAX_BLOCKS_PER_MESSAGE)return`${t} has more than ${SLACK_MAX_BLOCKS_PER_MESSAGE} blocks`}if(e.details!==void 0&&eveControls(e.details.blocks).length>0)return`details hold eve controls`;let n=eveControls(t.controls.blocks),r=eveControls(e.controls.blocks);if(n.length!==r.length||n.some((e,t)=>e!==r[t]))return n.length===0?`controls of an answered or settled request hold eve controls`:`controls don't hold exactly eve's controls`}function isMessage(e){if(typeof e!=`object`||!e)return!1;let{blocks:t,text:n}=e;return Array.isArray(t)&&typeof n==`string`}function compactDefault(e){let t=e.blocks.filter(e=>eveControls(e).length>0);return t.length===0?e:{...e,blocks:t}}function eveControls(e){let t=[],walk=e=>{if(Array.isArray(e)){for(let t of e)walk(t);return}if(typeof e!=`object`||!e)return;let n=e,r=n.action_id;if(typeof r==`string`&&(isHitlAction(r)||isFreeformAction(r))){let e=Array.isArray(n.options)?n.options.map(e=>e.value).sort():null;t.push(JSON.stringify([r,n.value??null,e]))}for(let t of Object.values(e))walk(t)};return walk(e),t.sort()}async function sendWithFallback(e,t,n){try{return await e(t)}catch(r){if(refusedPayloadError(r)===void 0||sameJson(t,n))throw r;return logError(log,`Slack rejected a rendered input request; sending eve's default`,r),n===void 0?void 0:await e(n)}}function sameJson(e,t){return JSON.stringify(e)===JSON.stringify(t)}export{compactDefault,defaultInteractionCard,endingOf,renderRequestCard,sameJson,sendWithFallback};
@@ -1 +1 @@
1
- import{isObject}from"#shared/guards.js";import{parseAnswer}from"#shared/input.js";import{parseJsonObject}from"#shared/json.js";import{truncate}from"#public/channels/text.js";import{TEAMS_ADAPTIVE_CARD_ACTION_LIMIT,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH}from"#public/channels/teams/limits.js";const TEAMS_ADAPTIVE_CARD_CONTENT_TYPE=`application/vnd.microsoft.card.adaptive`,TEAMS_HITL_DATA_KEY=`eve_input`,TEAMS_HITL_CHOICE_INPUT_ID=`eve_option`,TEAMS_HITL_FREEFORM_INPUT_ID=`eve_freeform_text`,TEAMS_HITL_REQUEST_KIND_KEY=`kind`,TEAMS_HITL_PROMPT_KEY=`prompt`;function renderInteractionMessage(e,t={}){let n=formatApprovalInput(e),r=n?truncate(n,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH):null;return{attachments:[renderInteractionAttachment(e,t)],text:r?`${e.request.prompt}\n\nTool input:\n${r}`:e.request.prompt}}function renderInteractionAttachment(e,t={}){let n=formatApprovalInput(e),r={$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,actions:renderActions(e,t.replyToActivityId),body:[{text:truncate(e.request.prompt,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextBlock`,wrap:!0},...n?[{fontType:`Monospace`,text:truncate(n,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextBlock`,wrap:!0}]:[],...renderInputs(e)],type:`AdaptiveCard`,version:t.adaptiveCardVersion??`1.5`};return{content:parseJsonObject(r),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}}function renderAnsweredInteractionMessage(e){let t=e.label?`Answered: ${e.label}`:`Answered`,n=renderSettledInputRequestMessage(e.prompt,{color:`good`,text:t});return e.includeText===!1?n:{...n,text:t}}function renderInactiveInputRequestMessage(e,t){return renderSettledInputRequestMessage(e,{text:t})}function renderSettledInputRequestMessage(e,t){let n=e===void 0?[]:[{text:truncate(e,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextBlock`,wrap:!0}];return{attachments:[{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,body:[...n,{...t,type:`TextBlock`,wrap:!0}],type:`AdaptiveCard`,version:`1.5`}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}]}}function isTeamsAnswerActivity(e){return deriveTeamsAnswers(e).length>0}function isTeamsToolApprovalResponseActivity(e){let t=readActivityValue(e);return(t&&readHitlPayload(t))?.[TEAMS_HITL_REQUEST_KIND_KEY]===`tool-approval`}function readTeamsToolApprovalPrompt(e){return isTeamsToolApprovalResponseActivity(e)?readTeamsInputPrompt(e):void 0}function readTeamsInputPrompt(e){let t=readActivityValue(e),n=(t&&readHitlPayload(t))?.[TEAMS_HITL_PROMPT_KEY];return typeof n==`string`&&n.length>0?n:void 0}function deriveTeamsAnswers(e){let t=readActivityValue(e);if(!t)return[];let n=readHitlPayload(t);if(!n)return[];let r=typeof n.requestId==`string`?n.requestId:``;if(!r)return[];let i=typeof n.optionId==`string`?n.optionId:typeof t.eve_option==`string`?t[TEAMS_HITL_CHOICE_INPUT_ID]:void 0,a=typeof t.eve_freeform_text==`string`?t[TEAMS_HITL_FREEFORM_INPUT_ID]:void 0;return i===void 0?a===void 0?[parseAnswer({interactionId:r})]:[parseAnswer({interactionId:r,text:a})]:[parseAnswer({interactionId:r,optionId:i})]}function readTeamsInputReplyToActivityId(e){let t=readActivityValue(e);if(!t)return null;let n=readHitlPayload(t);return n&&typeof n.replyToActivityId==`string`?n.replyToActivityId:null}function teamsInvokeResponse(e={}){return{statusCode:e.statusCode??200,type:`application/vnd.microsoft.activity.message`,value:e.message??`Answer received.`}}function renderInputs(e){return e.request.display===`select`&&e.request.options&&e.request.options.length>0?[{choices:e.request.options.map(e=>({title:truncate(e.label,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH),value:e.id})),id:TEAMS_HITL_CHOICE_INPUT_ID,isMultiSelect:!1,style:`compact`,type:`Input.ChoiceSet`}]:e.request.allowFreeform===!0||!e.request.options||e.request.options.length===0?[{id:TEAMS_HITL_FREEFORM_INPUT_ID,isMultiline:!0,placeholder:`Type your answer`,type:`Input.Text`}]:[]}function renderActions(e,t){let payload=n=>{let r={requestId:e.interactionId,[TEAMS_HITL_PROMPT_KEY]:truncate(e.request.prompt,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH)};return e.request.kind===`approval`&&(r[TEAMS_HITL_REQUEST_KIND_KEY]=`tool-approval`),t!==void 0&&(r.replyToActivityId=t),n!==void 0&&(r.optionId=n),r},n=e.request.options;return n&&n.length>0&&e.request.display!==`select`?n.slice(0,TEAMS_ADAPTIVE_CARD_ACTION_LIMIT).map(e=>({data:{[TEAMS_HITL_DATA_KEY]:payload(e.id)},title:truncate(e.label,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH),type:`Action.Submit`})):[{data:{[TEAMS_HITL_DATA_KEY]:payload()},title:`Submit`,type:`Action.Submit`}]}function readActivityValue(e){return e.type===`message`?readMessageValue(e):e.type===`invoke`?readInvokeValue(e):null}function readMessageValue(e){return e.value??null}function readInvokeValue(e){let t=e.value;if(!t)return null;let n=isObject(t.action)?t.action:null;return(n&&isObject(n.data)?n.data:null)??t}function readHitlPayload(e){let t=e[TEAMS_HITL_DATA_KEY];if(isObject(t))return t;let n=isObject(e.action)?e.action:null,r=(n&&isObject(n.data)?n.data:null)?.[TEAMS_HITL_DATA_KEY];return isObject(r)?r:null}function formatApprovalInput(e){if(e.request.kind!==`approval`)return null;let t=JSON.stringify(e.call?.input??{},null,2);return t===`{}`?null:t}export{TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,TEAMS_HITL_CHOICE_INPUT_ID,TEAMS_HITL_DATA_KEY,TEAMS_HITL_FREEFORM_INPUT_ID,TEAMS_HITL_PROMPT_KEY,TEAMS_HITL_REQUEST_KIND_KEY,deriveTeamsAnswers,isTeamsAnswerActivity,isTeamsToolApprovalResponseActivity,readTeamsInputPrompt,readTeamsInputReplyToActivityId,readTeamsToolApprovalPrompt,renderAnsweredInteractionMessage,renderInactiveInputRequestMessage,renderInteractionAttachment,renderInteractionMessage,teamsInvokeResponse};
1
+ import{isObject}from"#shared/guards.js";import{parseAnswer}from"#shared/input.js";import{parseJsonObject}from"#shared/json.js";import{truncate}from"#public/channels/text.js";import{TEAMS_ADAPTIVE_CARD_ACTION_LIMIT,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH}from"#public/channels/teams/limits.js";const TEAMS_ADAPTIVE_CARD_CONTENT_TYPE=`application/vnd.microsoft.card.adaptive`,TEAMS_HITL_DATA_KEY=`eve_input`,TEAMS_HITL_CHOICE_INPUT_ID=`eve_option`,TEAMS_HITL_FREEFORM_INPUT_ID=`eve_freeform_text`,TEAMS_HITL_REQUEST_KIND_KEY=`kind`,TEAMS_HITL_PROMPT_KEY=`prompt`;function literalText(e,t={}){return{inlines:[{...t.color!==void 0&&{color:t.color},...t.fontType!==void 0&&{fontType:t.fontType},text:truncate(e,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH),type:`TextRun`}],type:`RichTextBlock`}}function renderInteractionMessage(e,t={}){let n=formatApprovalInput(e),r=n?truncate(n,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH):null;return{attachments:[renderInteractionAttachment(e,t)],text:r?`${e.request.prompt}\n\nTool input:\n${r}`:e.request.prompt,textFormat:`plain`}}function renderInteractionAttachment(e,t={}){let n=formatApprovalInput(e),r={$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,actions:renderActions(e,t.replyToActivityId),body:[literalText(e.request.prompt),...n?[literalText(n,{fontType:`Monospace`})]:[],...renderInputs(e)],type:`AdaptiveCard`,version:t.adaptiveCardVersion??`1.5`};return{content:parseJsonObject(r),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}}function renderAnsweredInteractionMessage(e){let t=e.label?`Answered: ${e.label}`:`Answered`,n=renderSettledInputRequestMessage(e.prompt,{color:`good`,text:t});return e.includeText===!1?n:{...n,text:t,textFormat:`plain`}}function renderInactiveInputRequestMessage(e,t){return renderSettledInputRequestMessage(e,{text:t})}function renderSettledInputRequestMessage(e,t){let n=e===void 0?[]:[literalText(e)];return{attachments:[{content:parseJsonObject({$schema:`http://adaptivecards.io/schemas/adaptive-card.json`,body:[...n,literalText(t.text,{color:t.color})],type:`AdaptiveCard`,version:`1.5`}),contentType:TEAMS_ADAPTIVE_CARD_CONTENT_TYPE}]}}function isTeamsAnswerActivity(e){return deriveTeamsAnswers(e).length>0}function isTeamsToolApprovalResponseActivity(e){let t=readActivityValue(e);return(t&&readHitlPayload(t))?.[TEAMS_HITL_REQUEST_KIND_KEY]===`tool-approval`}function readTeamsToolApprovalPrompt(e){return isTeamsToolApprovalResponseActivity(e)?readTeamsInputPrompt(e):void 0}function readTeamsInputPrompt(e){let t=readActivityValue(e),n=(t&&readHitlPayload(t))?.[TEAMS_HITL_PROMPT_KEY];return typeof n==`string`&&n.length>0?n:void 0}function deriveTeamsAnswers(e){let t=readActivityValue(e);if(!t)return[];let n=readHitlPayload(t);if(!n)return[];let r=typeof n.requestId==`string`?n.requestId:``;if(!r)return[];let i=typeof n.optionId==`string`?n.optionId:typeof t.eve_option==`string`?t[TEAMS_HITL_CHOICE_INPUT_ID]:void 0,a=typeof t.eve_freeform_text==`string`?t[TEAMS_HITL_FREEFORM_INPUT_ID]:void 0;return i===void 0?a===void 0?[parseAnswer({interactionId:r})]:[parseAnswer({interactionId:r,text:a})]:[parseAnswer({interactionId:r,optionId:i})]}function readTeamsInputReplyToActivityId(e){let t=readActivityValue(e);if(!t)return null;let n=readHitlPayload(t);return n&&typeof n.replyToActivityId==`string`?n.replyToActivityId:null}function teamsInvokeResponse(e={}){return{statusCode:e.statusCode??200,type:`application/vnd.microsoft.activity.message`,value:e.message??`Answer received.`}}function renderInputs(e){return e.request.display===`select`&&e.request.options&&e.request.options.length>0?[{choices:e.request.options.map(e=>({title:truncate(e.label,TEAMS_ADAPTIVE_CARD_CHOICE_TITLE_MAX_LENGTH),value:e.id})),id:TEAMS_HITL_CHOICE_INPUT_ID,isMultiSelect:!1,style:`compact`,type:`Input.ChoiceSet`}]:e.request.allowFreeform===!0||!e.request.options||e.request.options.length===0?[{id:TEAMS_HITL_FREEFORM_INPUT_ID,isMultiline:!0,placeholder:`Type your answer`,type:`Input.Text`}]:[]}function renderActions(e,t){let payload=n=>{let r={requestId:e.interactionId,[TEAMS_HITL_PROMPT_KEY]:truncate(e.request.prompt,TEAMS_ADAPTIVE_CARD_TEXT_MAX_LENGTH)};return e.request.kind===`approval`&&(r[TEAMS_HITL_REQUEST_KIND_KEY]=`tool-approval`),t!==void 0&&(r.replyToActivityId=t),n!==void 0&&(r.optionId=n),r},n=e.request.options;return n&&n.length>0&&e.request.display!==`select`?n.slice(0,TEAMS_ADAPTIVE_CARD_ACTION_LIMIT).map(e=>({data:{[TEAMS_HITL_DATA_KEY]:payload(e.id)},title:truncate(e.label,TEAMS_ADAPTIVE_CARD_ACTION_TITLE_MAX_LENGTH),type:`Action.Submit`})):[{data:{[TEAMS_HITL_DATA_KEY]:payload()},title:`Submit`,type:`Action.Submit`}]}function readActivityValue(e){return e.type===`message`?readMessageValue(e):e.type===`invoke`?readInvokeValue(e):null}function readMessageValue(e){return e.value??null}function readInvokeValue(e){let t=e.value;if(!t)return null;let n=isObject(t.action)?t.action:null;return(n&&isObject(n.data)?n.data:null)??t}function readHitlPayload(e){let t=e[TEAMS_HITL_DATA_KEY];if(isObject(t))return t;let n=isObject(e.action)?e.action:null,r=(n&&isObject(n.data)?n.data:null)?.[TEAMS_HITL_DATA_KEY];return isObject(r)?r:null}function formatApprovalInput(e){if(e.request.kind!==`approval`)return null;let t=JSON.stringify(e.call?.input??{},null,2);return t===`{}`?null:t}export{TEAMS_ADAPTIVE_CARD_CONTENT_TYPE,TEAMS_HITL_CHOICE_INPUT_ID,TEAMS_HITL_DATA_KEY,TEAMS_HITL_FREEFORM_INPUT_ID,TEAMS_HITL_PROMPT_KEY,TEAMS_HITL_REQUEST_KIND_KEY,deriveTeamsAnswers,isTeamsAnswerActivity,isTeamsToolApprovalResponseActivity,readTeamsInputPrompt,readTeamsInputReplyToActivityId,readTeamsToolApprovalPrompt,renderAnsweredInteractionMessage,renderInactiveInputRequestMessage,renderInteractionAttachment,renderInteractionMessage,teamsInvokeResponse};
@@ -1 +1 @@
1
- import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{importJWK,jwtVerify}from"#compiled/jose/index.js";import{resolveTeamsAppId}from"#public/channels/teams/api.js";const log=createLogger(`teams.verify`);async function verifyTeamsRequest(e,t){let n=await e.text();if(t.webhookVerifier!==void 0){let r=await t.webhookVerifier(e,n);if(!r)throw Error(`teamsChannel: inbound webhook verifier rejected the request.`);return{body:typeof r==`string`?r:n}}let r=readBearerToken(e.headers.get(`authorization`)??``);if(!r)throw Error(`teamsChannel: inbound request missing bearer token.`);let i=await verifyTeamsJwt(r,t);if(typeof i.serviceurl!=`string`)throw Error(`teamsChannel: verified token is missing its service URL claim.`);return{body:n,serviceUrl:i.serviceurl}}async function verifyTeamsJwt(e,t){let n=await resolveTeamsAppId(t.appId),r=await loadJwks(t);return(await jwtVerify(e,async e=>{let t=selectJwk(r,e),n=typeof e.alg==`string`?e.alg:void 0;return importJWK(t,n)},{audience:n,clockTolerance:t.maxSkewSeconds??300,issuer:`https://api.botframework.com`})).payload}function readBearerToken(e){let[t,n]=e.split(/\s+/,2);return t?.toLowerCase()!==`bearer`||!n?null:n}async function loadJwks(e){let t=e.fetch??fetch,n=await t(e.jwksUrl??await loadJwksUrl(e,t),{headers:{accept:`application/json`}});if(!n.ok)throw Error(`Teams JWKS route returned HTTP ${n.status}.`);let r=await n.json();if(!isObject(r)||!Array.isArray(r.keys))throw Error(`Teams JWKS response is malformed.`);return r.keys.filter(isObject)}async function loadJwksUrl(e,t){let n=await t(e.openIdMetadataUrl??`https://login.botframework.com/v1/.well-known/openidconfiguration`,{headers:{accept:`application/json`}});if(!n.ok)throw Error(`Teams OpenID metadata route returned HTTP ${n.status}.`);let r=await n.json();if(!isObject(r)||typeof r.jwks_uri!=`string`)throw Error(`Teams OpenID metadata response is missing jwks_uri.`);return r.jwks_uri}function selectJwk(e,t){let n=typeof t.kid==`string`?t.kid:void 0,r=typeof t.x5t==`string`?t.x5t:void 0,i=e.find(e=>n!==void 0&&e.kid===n||r!==void 0&&e.x5t===r)??(e.length===1?e[0]:void 0);if(i===void 0)throw log.debug(`Teams JWT key not found`,{kid:n,x5t:r}),Error(`teamsChannel: inbound JWT key was not found in JWKS.`);return i}export{verifyTeamsJwt,verifyTeamsRequest};
1
+ import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{importJWK,jwtVerify}from"#compiled/jose/index.js";import{resolveTeamsAppId}from"#public/channels/teams/api.js";const log=createLogger(`teams.verify`),BOT_CONNECTOR_ALGORITHM=`RS256`;async function verifyTeamsRequest(e,t){let n=await e.text();if(t.webhookVerifier!==void 0){let r=await t.webhookVerifier(e,n);if(!r)throw Error(`teamsChannel: inbound webhook verifier rejected the request.`);return{body:typeof r==`string`?r:n}}let r=readBearerToken(e.headers.get(`authorization`)??``);if(!r)throw Error(`teamsChannel: inbound request missing bearer token.`);let i=await verifyTeamsJwt(r,t);if(typeof i.serviceurl!=`string`)throw Error(`teamsChannel: verified token is missing its service URL claim.`);return{body:n,serviceUrl:i.serviceurl}}async function verifyTeamsJwt(e,t){let n=await resolveTeamsAppId(t.appId),r=await loadJwks(t);return(await jwtVerify(e,async e=>importJWK(selectJwk(r,e),BOT_CONNECTOR_ALGORITHM),{algorithms:[BOT_CONNECTOR_ALGORITHM],audience:n,clockTolerance:t.maxSkewSeconds??300,issuer:`https://api.botframework.com`})).payload}function readBearerToken(e){let[t,n]=e.split(/\s+/,2);return t?.toLowerCase()!==`bearer`||!n?null:n}async function loadJwks(e){let t=e.fetch??fetch,n=await t(e.jwksUrl??await loadJwksUrl(e,t),{headers:{accept:`application/json`}});if(!n.ok)throw Error(`Teams JWKS route returned HTTP ${n.status}.`);let r=await n.json();if(!isObject(r)||!Array.isArray(r.keys))throw Error(`Teams JWKS response is malformed.`);return r.keys.filter(isObject)}async function loadJwksUrl(e,t){let n=await t(e.openIdMetadataUrl??`https://login.botframework.com/v1/.well-known/openidconfiguration`,{headers:{accept:`application/json`}});if(!n.ok)throw Error(`Teams OpenID metadata route returned HTTP ${n.status}.`);let r=await n.json();if(!isObject(r)||typeof r.jwks_uri!=`string`)throw Error(`Teams OpenID metadata response is missing jwks_uri.`);return r.jwks_uri}function selectJwk(e,t){let n=typeof t.kid==`string`?t.kid:void 0,r=typeof t.x5t==`string`?t.x5t:void 0,i=e.find(e=>n!==void 0&&e.kid===n||r!==void 0&&e.x5t===r)??(e.length===1?e[0]:void 0);if(i===void 0)throw log.debug(`Teams JWT key not found`,{kid:n,x5t:r}),Error(`teamsChannel: inbound JWT key was not found in JWKS.`);return i}export{verifyTeamsJwt,verifyTeamsRequest};
@@ -1 +1 @@
1
- import{createLogger,logError}from"#internal/logging.js";import{isCompiledChannel}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{parseJsonObject}from"#shared/json.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{INACTIVE_REQUEST_NOTICE,respondOrRetireInactivePrompt}from"#channel/inactive-prompt.js";import{formatTelegramContextBlock,parseTelegramUpdate}from"#public/channels/telegram/inbound.js";import{answerTelegramCallbackQuery,callTelegramApi,editTelegramMessageReplyMarkup,editTelegramMessageText,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramContinuationToken}from"#public/channels/telegram/api.js";import{TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX}from"#public/channels/telegram/authorization.js";import{TELEGRAM_HITL_CALLBACK_PREFIX,isTelegramSyntheticResponse,resolveTelegramAnswers,telegramCallbackAnswer,telegramReplyAnswers,telegramResolvedPromptText}from"#public/channels/telegram/hitl.js";import{defaultEvents,defaultOnMessage,defaultTelegramAuth,isTelegramBotMentioned}from"#public/channels/telegram/defaults.js";import{dispatchTelegramAuthorizationCallback}from"#public/channels/telegram/authorization-callback.js";import{buildTelegramTurnMessage,collectTelegramFileParts,createTelegramFetchFile}from"#public/channels/telegram/attachments.js";import{initialTelegramState,stateFromTelegramCallbackQuery,stateFromTelegramMessage,telegramContinuationTokenFromState}from"#public/channels/telegram/state.js";import{verifyTelegramRequest}from"#public/channels/telegram/verify.js";import{telegramInstrumentation}from"#public/channels/telegram/audience.js";const log=createLogger(`telegram.channel`);function telegramChannel(e={}){let t=mergeUploadPolicy(e.uploadPolicy),n=e.onMessage??defaultOnMessage,r={...defaultEvents,...e.events},i=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:initialTelegramState(e.botUsername),...telegramInstrumentation,fetchFile:createTelegramFetchFile({api:e.api,credentials:e.credentials,policy:t}),context(t,n){return rebuildTelegramContext(t,n,e)},routes:[POST(e.route??`/eve/v1/telegram`,async(r,{from:i,resolveSession:a,waitUntil:o})=>{let s=await verifyInbound(r,e.credentials);if(s===null)return new Response(`unauthorized`,{status:401});let c;try{c=parseJsonObject(JSON.parse(s))}catch(e){return log.warn(`inbound Telegram body is not valid JSON`,{error:e}),new Response(`ok`)}let l=parseTelegramUpdate(c);return l===null?new Response(`ok`):l.kind===`message`?(o(dispatchMessage({config:e,message:l.message,onMessage:n,uploadPolicy:t,from:i})),new Response(`ok`)):(o(dispatchCallbackQuery({config:e,query:l.callbackQuery,from:i,resolveSession:a})),new Response(`ok`))})],async receive({message:t,target:n,...r},{from:i}){let a=n,o=readChatId(a.chatId);if(o===void 0)throw Error(`telegramChannel().receive requires target.chatId.`);let s=typeof a.messageThreadId==`number`?a.messageThreadId:void 0,c=readChatId(a.conversationId),l=a.initialMessage;if(l!==void 0&&c!==void 0)throw Error("telegramChannel().receive: `conversationId` and `initialMessage` are mutually exclusive.");let u={...initialTelegramState(e.botUsername),chatId:o,conversationId:c??null,messageThreadId:s??null};return l!==void 0&&await buildTelegramHandle({config:e,state:u}).sendMessage(l),i(telegramContinuationTokenFromState(u)).send(t,{...r,state:u})},events:r});return attachTelegramDeliver(i),i}function rebuildTelegramContext(e,t,n){return{state:e,telegram:buildTelegramHandle({config:n,session:t,state:e})}}function buildTelegramHandle(e){let t=e.config.api,n=e.state,r=e.config.credentials;function anchor(t){let r=n.chatType??t.chatType??null;n.chatType===null&&t.chatType!==void 0&&(n.chatType=t.chatType),t.id&&shouldAnchorTelegramConversation(r)&&(n.conversationId=t.id,n.chatId&&e.session?.continuation?.alias(telegramContinuationToken({chatId:n.chatId,conversationId:t.id,messageThreadId:n.messageThreadId??void 0})))}async function sendOne(e){let t=await sendMessage(e);return anchor(t),t}async function sendMessage(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for outbound message.`);return sendTelegramMessage({apiBaseUrl:t?.apiBaseUrl,body:{...e,message_thread_id:e.message_thread_id??n.messageThreadId??void 0},credentials:r,fetch:t?.fetch,fileBaseUrl:t?.fileBaseUrl,chatId:i})}return{botUsername:n.botUsername??e.config.botUsername,chatId:n.chatId??``,chatType:n.chatType??void 0,conversationId:n.conversationId??void 0,messageThreadId:n.messageThreadId??void 0,answerCallbackQuery(e){return answerTelegramCallbackQuery({apiBaseUrl:t?.apiBaseUrl,callbackQueryId:e.callbackQueryId,credentials:r,fetch:t?.fetch,showAlert:e.showAlert,text:e.text})},editMessageReplyMarkup(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for reply-markup edit.`);return editTelegramMessageReplyMarkup({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup})},editMessageText(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for text edit.`);return editTelegramMessageText({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup,text:e.text})},post(e){return postTelegramMessage(e,sendOne)},postEphemeral(e,t,n){return postTelegramMessage({...typeof t==`string`?{text:t}:t,ephemeral_message_parameters:{...n?.callbackQueryId===void 0?{}:{callback_query_id:n.callbackQueryId},receiver_user_id:e}},sendMessage)},request(e,n){return callTelegramApi({apiBaseUrl:t?.apiBaseUrl,body:n,botToken:r?.botToken,fetch:t?.fetch,method:e})},sendMessage(e){return postTelegramMessage(e,sendOne)},async startTyping(e=`typing`){let i=n.chatId??``;if(i)try{await sendTelegramChatAction({action:e,apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageThreadId:n.messageThreadId??void 0})}catch(e){logError(log,`Telegram typing indicator failed — swallowed`,e,{chatId:i})}}}}function shouldAnchorTelegramConversation(e){return e===`group`||e===`supergroup`}async function postTelegramMessage(e,t){let n=typeof e==`string`?{text:e}:e,r=splitTelegramMessageText(n.text),i;for(let[e,a]of r.entries()){let r=await t(e===0?{...n,text:a}:{...n.ephemeral_message_parameters===void 0?{}:{ephemeral_message_parameters:n.ephemeral_message_parameters},text:a});i===void 0&&(i=r)}return i??{id:``,raw:null}}async function verifyInbound(e,t){try{return await verifyTelegramRequest(e,{secretToken:t?.webhookVerifier?void 0:t?.webhookSecretToken,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`telegram inbound verification failed`,{error:e}),null}}async function dispatchMessage(e){if(e.message.from?.isBot===!0)return;let t=stateFromTelegramMessage(e.message,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})},r;try{r=await e.onMessage(n,e.message)}catch(e){log.error(`message handler failed`,{error:e});return}if(r==null)return;let i=collectTelegramFileParts(e.message.attachments,e.uploadPolicy),a=buildTelegramTurnMessage(e.message,i),o=formatTelegramContextBlock({botUsername:e.config.botUsername,chatId:e.message.chat.id,chatTitle:e.message.chat.title,chatType:e.message.chat.type,isMentioned:isTelegramBotMentioned(e.message,e.config.botUsername),messageId:e.message.messageId,messageThreadId:e.message.messageThreadId,userId:e.message.from?.id,username:e.message.from?.username}),s=r.context??[];try{await e.from(telegramContinuationTokenFromState(t)).send(a,{auth:r.auth,context:[o,...s],history:r.history,state:t,title:r.title})}catch(e){log.error(`message delivery failed`,{error:e})}}async function dispatchCallbackQuery(e){let t=stateFromTelegramCallbackQuery(e.query,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})};if(e.query.data?.startsWith(TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX)===!0){await dispatchTelegramAuthorizationCallback({continuationToken:telegramContinuationTokenFromState(t),query:e.query,resolveSession:e.resolveSession,state:t,telegram:n});return}if(e.query.data?.startsWith(TELEGRAM_HITL_CALLBACK_PREFIX)===!0){let r=e.query.message,i=e.query.data,a=r&&t.chatId?await respondOrRetireInactivePrompt(()=>e.from(telegramContinuationTokenFromState(t)).respond([telegramCallbackAnswer(i)],{auth:defaultTelegramAuth({...r,from:e.query.from})}),{retirePrompt:e=>retireInactivePrompt(n,r,e)},log):void 0;try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:a?.outcome===`inactive`?INACTIVE_REQUEST_NOTICE:`Answer received.`})}catch(e){log.warn(`Telegram callback-query acknowledgement failed`,{error:e})}a?.outcome===`inactive`&&await a.retirement;return}if(e.config.onCallbackQuery!==void 0){try{await e.config.onCallbackQuery(n,e.query)}catch(e){log.error(`custom callback-query handler failed`,{error:e})}return}try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:`Unsupported action.`})}catch(e){log.warn(`Telegram unsupported callback-query acknowledgement failed`,{error:e})}}async function retireInactivePrompt(e,t,n){let r={inline_keyboard:[]};if(t.text===void 0){await e.telegram.editMessageReplyMarkup({messageId:t.messageId,replyMarkup:r});return}await e.telegram.editMessageText({messageId:t.messageId,replyMarkup:r,text:telegramResolvedPromptText(t.text,n)})}function attachTelegramDeliver(e){if(!isCompiledChannel(e))return;let t=e.adapter;t.deliver=(e,t)=>{let n=e.state,r=[...e.answers??[],...telegramReplyAnswers(n?.replyToBotMessageId,e.message)];if(r.some(isTelegramSyntheticResponse)){let n=resolveTelegramAnswers(t.state,r);return n.length>0?{answers:n,context:e.context}:e.message===void 0?void 0:{message:e.message,context:e.context}}return defaultDeliverResult(e)}}function readChatId(e){if(typeof e==`string`&&e.length>0)return e;if(typeof e==`number`&&Number.isFinite(e))return String(e)}export{telegramChannel};
1
+ import{createLogger,logError}from"#internal/logging.js";import{defaultDeliverResult}from"#channel/adapter.js";import{isCompiledChannel}from"#channel/compiled-channel.js";import{parseJsonObject}from"#shared/json.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{INACTIVE_REQUEST_NOTICE,respondOrRetireInactivePrompt}from"#channel/inactive-prompt.js";import{formatTelegramContextBlock,parseTelegramUpdate}from"#public/channels/telegram/inbound.js";import{answerTelegramCallbackQuery,callTelegramApi,editTelegramMessageReplyMarkup,editTelegramMessageText,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramContinuationToken}from"#public/channels/telegram/api.js";import{TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX}from"#public/channels/telegram/authorization.js";import{TELEGRAM_HITL_CALLBACK_PREFIX,isTelegramSyntheticResponse,resolveTelegramAnswers,telegramCallbackAnswer,telegramReplyAnswers,telegramResolvedPromptText}from"#public/channels/telegram/hitl.js";import{defaultEvents,defaultOnMessage,defaultTelegramAuth,isTelegramBotMentioned}from"#public/channels/telegram/defaults.js";import{dispatchTelegramAuthorizationCallback}from"#public/channels/telegram/authorization-callback.js";import{buildTelegramTurnMessage,collectTelegramFileParts,createTelegramFetchFile}from"#public/channels/telegram/attachments.js";import{initialTelegramState,stateFromTelegramCallbackQuery,stateFromTelegramMessage,telegramContinuationTokenFromState}from"#public/channels/telegram/state.js";import{verifyTelegramRequest}from"#public/channels/telegram/verify.js";import{telegramInstrumentation}from"#public/channels/telegram/audience.js";const log=createLogger(`telegram.channel`);function telegramChannel(e={}){let t=mergeUploadPolicy(e.uploadPolicy),n=e.onMessage??defaultOnMessage,r={...defaultEvents,...e.events},i=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:initialTelegramState(e.botUsername),...telegramInstrumentation,fetchFile:createTelegramFetchFile({api:e.api,credentials:e.credentials,policy:t}),context(t,n){return rebuildTelegramContext(t,n,e)},routes:[POST(e.route??`/eve/v1/telegram`,async(r,{from:i,resolveSession:a,waitUntil:o})=>{let s=await verifyInbound(r,e.credentials);if(s===null)return new Response(`unauthorized`,{status:401});let c;try{c=parseJsonObject(JSON.parse(s))}catch(e){return log.warn(`inbound Telegram body is not valid JSON`,{error:e}),new Response(`ok`)}let l=parseTelegramUpdate(c);return l===null?new Response(`ok`):l.kind===`message`?(o(dispatchMessage({config:e,message:l.message,onMessage:n,uploadPolicy:t,from:i})),new Response(`ok`)):(o(dispatchCallbackQuery({config:e,query:l.callbackQuery,from:i,resolveSession:a})),new Response(`ok`))})],async receive({message:t,target:n,...r},{from:i}){let a=n,o=readChatId(a.chatId);if(o===void 0)throw Error(`telegramChannel().receive requires target.chatId.`);let s=typeof a.messageThreadId==`number`?a.messageThreadId:void 0,c=readChatId(a.conversationId),l=a.initialMessage;if(l!==void 0&&c!==void 0)throw Error("telegramChannel().receive: `conversationId` and `initialMessage` are mutually exclusive.");let u={...initialTelegramState(e.botUsername),chatId:o,conversationId:c??null,messageThreadId:s??null};return l!==void 0&&await buildTelegramHandle({config:e,state:u}).sendMessage(l),i(telegramContinuationTokenFromState(u)).send(t,{...r,state:u})},events:r});return attachTelegramDeliver(i),i}function rebuildTelegramContext(e,t,n){return{state:e,telegram:buildTelegramHandle({config:n,session:t,state:e})}}function buildTelegramHandle(e){let t=e.config.api,n=e.state,r=e.config.credentials;function anchor(t){let r=n.chatType??t.chatType??null;n.chatType===null&&t.chatType!==void 0&&(n.chatType=t.chatType),t.id&&shouldAnchorTelegramConversation(r)&&(n.conversationId=t.id,n.chatId&&e.session?.continuation?.alias(telegramContinuationToken({chatId:n.chatId,conversationId:t.id,messageThreadId:n.messageThreadId??void 0})))}async function sendOne(e){let t=await sendMessage(e);return anchor(t),t}async function sendMessage(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for outbound message.`);return sendTelegramMessage({apiBaseUrl:t?.apiBaseUrl,body:{...e,message_thread_id:e.message_thread_id??n.messageThreadId??void 0},credentials:r,fetch:t?.fetch,fileBaseUrl:t?.fileBaseUrl,chatId:i})}return{botUsername:n.botUsername??e.config.botUsername,chatId:n.chatId??``,chatType:n.chatType??void 0,conversationId:n.conversationId??void 0,messageThreadId:n.messageThreadId??void 0,answerCallbackQuery(e){return answerTelegramCallbackQuery({apiBaseUrl:t?.apiBaseUrl,callbackQueryId:e.callbackQueryId,credentials:r,fetch:t?.fetch,showAlert:e.showAlert,text:e.text})},editMessageReplyMarkup(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for reply-markup edit.`);return editTelegramMessageReplyMarkup({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup})},editMessageText(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for text edit.`);return editTelegramMessageText({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup,text:e.text})},post(e){return postTelegramMessage(e,sendOne)},postEphemeral(e,t,n){return postTelegramMessage({...typeof t==`string`?{text:t}:t,ephemeral_message_parameters:{...n?.callbackQueryId===void 0?{}:{callback_query_id:n.callbackQueryId},receiver_user_id:e}},sendMessage)},request(e,n){return callTelegramApi({apiBaseUrl:t?.apiBaseUrl,body:n,botToken:r?.botToken,fetch:t?.fetch,method:e})},sendMessage(e){return postTelegramMessage(e,sendOne)},async startTyping(e=`typing`){let i=n.chatId??``;if(i)try{await sendTelegramChatAction({action:e,apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageThreadId:n.messageThreadId??void 0})}catch(e){logError(log,`Telegram typing indicator failed — swallowed`,e,{chatId:i})}}}}function shouldAnchorTelegramConversation(e){return e===`group`||e===`supergroup`}async function postTelegramMessage(e,t){let n=typeof e==`string`?{text:e}:e,r=splitTelegramMessageText(n.text),i;for(let[e,a]of r.entries()){let r=await t(e===0?{...n,text:a}:{...n.ephemeral_message_parameters===void 0?{}:{ephemeral_message_parameters:n.ephemeral_message_parameters},text:a});i===void 0&&(i=r)}return i??{id:``,raw:null}}async function verifyInbound(e,t){try{return await verifyTelegramRequest(e,{secretToken:t?.webhookVerifier?void 0:t?.webhookSecretToken,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`telegram inbound verification failed`,{error:e}),null}}async function dispatchMessage(e){if(e.message.from?.isBot===!0)return;let t=stateFromTelegramMessage(e.message,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})},r;try{r=await e.onMessage(n,e.message)}catch(e){log.error(`message handler failed`,{error:e});return}if(r==null)return;let i=collectTelegramFileParts(e.message.attachments,e.uploadPolicy),a=buildTelegramTurnMessage(e.message,i),o=formatTelegramContextBlock({botUsername:e.config.botUsername,chatId:e.message.chat.id,chatTitle:e.message.chat.title,chatType:e.message.chat.type,isMentioned:isTelegramBotMentioned(e.message,e.config.botUsername),messageId:e.message.messageId,messageThreadId:e.message.messageThreadId,userId:e.message.from?.id,username:e.message.from?.username}),s=r.context??[];try{await e.from(telegramContinuationTokenFromState(t)).send(a,{auth:r.auth,context:[o,...s],history:r.history,state:t,title:r.title})}catch(e){log.error(`message delivery failed`,{error:e})}}async function dispatchCallbackQuery(e){let t=stateFromTelegramCallbackQuery(e.query,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})};if(e.query.data?.startsWith(TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX)===!0){await dispatchTelegramAuthorizationCallback({continuationToken:telegramContinuationTokenFromState(t),query:e.query,resolveSession:e.resolveSession,state:t,telegram:n});return}if(e.query.data?.startsWith(TELEGRAM_HITL_CALLBACK_PREFIX)===!0){let r=e.query.message,i=e.query.data,a=r&&t.chatId?await respondOrRetireInactivePrompt(()=>e.from(telegramContinuationTokenFromState(t)).respond([telegramCallbackAnswer(i)],{auth:defaultTelegramAuth({...r,from:e.query.from})}),{retirePrompt:e=>retireInactivePrompt(n,r,e)},log):void 0;try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:a?.outcome===`inactive`?INACTIVE_REQUEST_NOTICE:`Answer received.`})}catch(e){log.warn(`Telegram callback-query acknowledgement failed`,{error:e})}a?.outcome===`inactive`&&await a.retirement;return}if(e.config.onCallbackQuery!==void 0){try{await e.config.onCallbackQuery(n,e.query)}catch(e){log.error(`custom callback-query handler failed`,{error:e})}return}try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:`Unsupported action.`})}catch(e){log.warn(`Telegram unsupported callback-query acknowledgement failed`,{error:e})}}async function retireInactivePrompt(e,t,n){let r={inline_keyboard:[]};if(t.text===void 0){await e.telegram.editMessageReplyMarkup({messageId:t.messageId,replyMarkup:r});return}await e.telegram.editMessageText({messageId:t.messageId,replyMarkup:r,text:telegramResolvedPromptText(t.text,n)})}function attachTelegramDeliver(e){if(!isCompiledChannel(e))return;let t=e.adapter;t.deliver=(e,t)=>{let n=e.state,r=[...e.answers??[],...telegramReplyAnswers(n?.replyToBotMessageId,e.message)];if(r.some(isTelegramSyntheticResponse)){let n=resolveTelegramAnswers(t.state,r);return n.length>0?{answers:n,context:e.context}:e.message===void 0?void 0:{message:e.message,context:e.context}}return defaultDeliverResult(e)}}function readChatId(e){if(typeof e==`string`&&e.length>0)return e;if(typeof e==`number`&&Number.isFinite(e))return String(e)}export{telegramChannel};
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Connection authoring helpers for `agent/connections/*.ts` files.
3
3
  */
4
- export type { AuthorizationCallback, AuthorizationDefinition, ConnectionAuthDefinition, ConnectionAuthResolver, ConnectionPrincipal, HeadersDefinition, InteractiveAuthorizationDefinition, NonInteractiveAuthorizationDefinition, TokenResult, ToolFilterDefinition, } from "#shared/connection-types.js";
4
+ export type { AuthorizationCallback, AuthorizationDefinition, ConnectionAuthDefinition, ConnectionCallbackContext, ConnectionAuthResolver, ConnectionPrincipal, HeadersDefinition, InteractiveAuthorizationDefinition, NonInteractiveAuthorizationDefinition, TokenResult, ToolFilterDefinition, } from "#shared/connection-types.js";
5
5
  export { defineInteractiveAuthorization } from "#shared/connection-types.js";
6
6
  export { defineDynamic, type DynamicConnectionDefinition, type DynamicConnectionResult, type DynamicConnectionSet, } from "#public/definitions/connections/dynamic.js";
7
7
  export type { DynamicContext, DynamicKey, DynamicModelContext, DynamicSentinel, DynamicTurn, Memo, Occurrence, SessionFrame, } from "#dynamic/definition.js";
@@ -1 +1 @@
1
- import{attachClientContext,readClientContext}from"#internal/client-context.js";import{attachInputText,readInputText}from"#internal/input-text.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{SessionStrandedError}from"#channel/session-stranded-error.js";import{CHANNEL_SENTINEL}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{snapshotOf}from"#protocol/session-projection/session-view.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{currentView}from"#harness/session-machine/current.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,WS}from"#channel/routes.js";import{removedEventKeyMessage}from"#public/definitions/removed-event-keys.js";import{authoringEventTypes}from"#protocol/session-events/authoring.js";import{normalizeChannelCors}from"#channel/cors.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";const DISABLED_ROUTE=Symbol.for(`eve.disabled-route`);function disableRoute(){return{[DISABLED_ROUTE]:!0}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&Reflect.get(e,DISABLED_ROUTE)===!0}function defineChannel(e){let t=buildAdapter(e),n=normalizeChannelCors(e.cors);return{__kind:CHANNEL_SENTINEL,routes:e.routes,adapter:t,cors:n,receive:e.receive,turnPolicy:e.turnPolicy}}const eventTypes=[...authoringEventTypes,`committed`];function buildAdapter(e){let t=e.state!=null,n=e.context!=null,r=e.fetchFile!==void 0,i=e.metadata,a=i!==void 0,o=e.audience,s=e.uploadPolicy===void 0?void 0:mergeUploadPolicy(e.uploadPolicy),c=t||n||a||s!==void 0||e.deliver!==void 0,l={},u=!1,d=e.events;for(let e of Object.keys(d??{})){let t=removedEventKeyMessage(e);if(t!==void 0)throw Error(`A channel handles ${t}`)}for(let e of eventTypes){let t=d?.[e];t&&(u=!0,l[e]=(e,n)=>{let{session:r,continuation:i,position:a,scope:o,view:s,...c}=n,l={...c,get continuation(){return n.continuation}},u={...buildCallbackContext(),channel:l,position:a??{index:0,line:0},view:snapshotOf(s??currentView())};return t(e,u)})}return!c&&!u&&!r?{kind:HTTP_ADAPTER_KIND,...o===void 0?void 0:{instrumentation:{audience:o}}}:{kind:`defineChannel`,state:t?{...e.state}:{},fetchFile:e.fetchFile,uploadPolicy:s,instrumentation:i===void 0&&o===void 0?void 0:{...i===void 0?void 0:{metadata(e){let{audience:t,...n}=i(e);return n}},...o===void 0?void 0:{audience:o}},createAdapterContext(t){let r=t.state,i={session:t.session,get continuation(){return t.continuation}};return{...n?e.context(r,i):{},state:r,ctx:t.ctx,session:i.session,get continuation(){return i.continuation}}},async deliver(t,n){let r=await e.deliver?.(t,n),i=defaultDeliverResult(r??t);if(i!==void 0)return attachClientContext(attachInputText(i,readInputText(t)),readClientContext(t))},...l}}export{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,SessionNotActiveError,SessionStrandedError,WS,defineChannel,disableRoute,isDisabledRouteSentinel};
1
+ import{attachClientContext,readClientContext}from"#internal/client-context.js";import{attachInputText,readInputText}from"#internal/input-text.js";import{defaultDeliverResult}from"#channel/adapter.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{SessionStrandedError}from"#channel/session-stranded-error.js";import{CHANNEL_SENTINEL}from"#channel/compiled-channel.js";import{snapshotOf}from"#protocol/session-projection/session-view.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{currentView}from"#harness/session-machine/current.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,WS}from"#channel/routes.js";import{removedEventKeyMessage}from"#public/definitions/removed-event-keys.js";import{authoringEventTypes}from"#protocol/session-events/authoring.js";import{normalizeChannelCors}from"#channel/cors.js";import{HTTP_ADAPTER_KIND}from"#channel/http.js";const DISABLED_ROUTE=Symbol.for(`eve.disabled-route`);function disableRoute(){return{[DISABLED_ROUTE]:!0}}function isDisabledRouteSentinel(e){return typeof e==`object`&&!!e&&Reflect.get(e,DISABLED_ROUTE)===!0}function defineChannel(e){let t=buildAdapter(e),n=normalizeChannelCors(e.cors);return{__kind:CHANNEL_SENTINEL,routes:e.routes,adapter:t,cors:n,receive:e.receive,turnPolicy:e.turnPolicy}}const eventTypes=[...authoringEventTypes,`committed`];function buildAdapter(e){let t=e.state!=null,n=e.context!=null,r=e.fetchFile!==void 0,i=e.metadata,a=i!==void 0,o=e.audience,s=e.uploadPolicy===void 0?void 0:mergeUploadPolicy(e.uploadPolicy),c=t||n||a||s!==void 0||e.deliver!==void 0,l={},u=!1,d=e.events;for(let e of Object.keys(d??{})){let t=removedEventKeyMessage(e);if(t!==void 0)throw Error(`A channel handles ${t}`)}for(let e of eventTypes){let t=d?.[e];t&&(u=!0,l[e]=(e,n)=>{let{session:r,continuation:i,position:a,scope:o,view:s,...c}=n,l={...c,get continuation(){return n.continuation}},u={...buildCallbackContext(),channel:l,position:a??{index:0,line:0},view:snapshotOf(s??currentView())};return t(e,u)})}return!c&&!u&&!r?{kind:HTTP_ADAPTER_KIND,...o===void 0?void 0:{instrumentation:{audience:o}}}:{kind:`defineChannel`,state:t?{...e.state}:{},fetchFile:e.fetchFile,uploadPolicy:s,instrumentation:i===void 0&&o===void 0?void 0:{...i===void 0?void 0:{metadata(e){let{audience:t,...n}=i(e);return n}},...o===void 0?void 0:{audience:o}},createAdapterContext(t){let r=t.state,i={session:t.session,get continuation(){return t.continuation}};return{...n?e.context(r,i):{},state:r,ctx:t.ctx,session:i.session,get continuation(){return i.continuation}}},async deliver(t,n){let r=await e.deliver?.(t,n),i=defaultDeliverResult(r??t);if(i!==void 0)return attachClientContext(attachInputText(i,readInputText(t)),readClientContext(t))},...l}}export{DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,SessionNotActiveError,SessionStrandedError,WS,defineChannel,disableRoute,isDisabledRouteSentinel};
@@ -1,7 +1,7 @@
1
- import type { SessionContext } from "#public/definitions/callback-context.js";
2
1
  import type { JsonValue } from "#public/types/json.js";
2
+ import type { ConnectionCallbackContext } from "#shared/connection-types.js";
3
3
  /** Context available while resolving an application-provided connection tool argument. */
4
- export type ProvidedArgumentContext = SessionContext & {
4
+ export type ProvidedArgumentContext = ConnectionCallbackContext & {
5
5
  /** Replay-stable id of the current connection tool call. */
6
6
  readonly callId: string;
7
7
  /** Bare tool or operation name published by the remote connection. */