Function onInteraction

packages/bot/src/create-bot.ts:451–515

(evt: InteractionEvent)

        }
      },
      async onInteraction(evt: InteractionEvent) {
        // Dedup guard: drop duplicate deliveries of the same event within the TTL window.
        if (evt.eventId) {
          const dupKey = `evt:${adapter.platform}:${evt.eventId}`;
          try {
            if (await backend.dedup.seen(dupKey, cfg.dedupTtl ?? 300_000))
              return;
          } catch (err) {
            console.warn(
              `[bot] dedup check failed for ${adapter.platform}; processing without dedup`,
              err,
            );
          }
        }

        const thread = makeThread(
          adapter,
          evt.replyTarget,
          evt.conversationKey,
        );
        const user = evt.user ?? { id: "" };
        const ctx: InteractionContext = {
          thread,
          message: {
            text: "",
            user,
            ref: evt.messageRef ?? { id: "" },
            platform: adapter.platform,
          },
          action: { id: evt.id, value: evt.value },
          values: {},
          user,
          platform: adapter.platform,
        };
        const openModal = makeOpenModal(
          adapter,
          evt.replyTarget,
          evt.triggerId,
        );
        if (openModal) ctx.openModal = openModal;
        // The clicked element's `value`, recovered by the registry when it
        // re-renders to find the handler. Used to resolve a HITL waiter on
        // platforms whose callback payload can't carry the value (Telegram),
        // where `evt.value` is undefined.
        let dispatchedValue: unknown;
        try {
          const explicit = interactionHandlers.get(evt.id);
          if (explicit) {
            await explicit(ctx);
          } else {
            dispatchedValue = await registry.dispatch(evt.id, ctx);
          }
        } catch (err) {
          // v1: swallow expired-action dispatches; surface anything else.
          if (!(err instanceof ActionExpiredError)) throw err;
        }
        // Resolve any HITL waiter awaiting a choice in this conversation. Prefer
        // the value carried in the event (Slack), falling back to the value the