Skip to content

vllm.v1.attention.backends.mamba_attn

Classes:

BaseMambaAttentionMetadataBuilder

Bases: AttentionMetadataBuilder[M], ABC

Methods:

  • build

    Default build implementation for Mamba-like attention backends.

  • build_for_cudagraph_capture

    This method builds the metadata for full cudagraph capture.

Source code in vllm/v1/attention/backends/mamba_attn.py
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
class BaseMambaAttentionMetadataBuilder(AttentionMetadataBuilder[M], abc.ABC):
    kv_cache_spec: MambaSpec
    metadata_cls: type[M]
    reorder_batch_threshold: int = 1
    _cudagraph_support: ClassVar[AttentionCGSupport] = AttentionCGSupport.UNIFORM_BATCH

    # Will be disabled if speculative decoding is used
    supports_update_block_table: bool = True

    def __init__(
        self,
        kv_cache_spec: MambaSpec,
        layer_names: list[str],
        vllm_config: VllmConfig,
        device: torch.device,
    ):
        super().__init__(kv_cache_spec, layer_names, vllm_config, device)

        # Enable speculative decoding support
        self.speculative_config = vllm_config.speculative_config
        self.compilation_config = vllm_config.compilation_config
        self.num_spec_tokens: int = vllm_config.num_speculative_tokens
        self.use_spec_decode = self.num_spec_tokens > 0
        self.use_replayssm = vllm_config.cache_config.use_replayssm
        self.replayssm_buffer_len = vllm_config.cache_config.replayssm_buffer_len

        scheduler_config = vllm_config.scheduler_config
        self.decode_cudagraph_max_bs: int = scheduler_config.max_num_seqs
        if self.compilation_config.max_cudagraph_capture_size is not None:
            self.decode_cudagraph_max_bs = min(
                self.decode_cudagraph_max_bs,
                self.compilation_config.max_cudagraph_capture_size,
            )

        if self.vllm_config.cache_config.mamba_cache_mode == "all":
            max_num_blocks = (
                cdiv(
                    self.vllm_config.model_config.max_model_len,
                    kv_cache_spec.block_size,
                )
                + kv_cache_spec.num_speculative_blocks
            )
            # TODO: reduce this size as needed for decode-only cudagraph capture
            self.state_indices_tensor_d: torch.Tensor = torch.empty(
                (
                    self.decode_cudagraph_max_bs,
                    max_num_blocks,
                ),
                dtype=torch.int32,
                device=device,
            )
            self.block_idx_last_scheduled_token: torch.Tensor = torch.empty(
                (self.decode_cudagraph_max_bs,),
                dtype=torch.int32,
                device=device,
            )
            self.block_idx_last_computed_token: torch.Tensor = torch.empty(
                (self.decode_cudagraph_max_bs,),
                dtype=torch.int32,
                device=device,
            )
            if self.use_spec_decode:
                self.block_idx_last_scheduled_token_prev_step: torch.Tensor = (
                    torch.empty(
                        (self.decode_cudagraph_max_bs,),
                        dtype=torch.int32,
                        device=device,
                    )
                )
        else:
            self.state_indices_tensor_d = torch.empty(
                (self.decode_cudagraph_max_bs, 1 + self.num_spec_tokens),
                dtype=torch.int32,
                device=device,
            )

        # For speculative decoding, we need to store the following buffers
        # for CUDA graph capture during decode
        if self.num_spec_tokens > 0:
            self.decode_num_accepted_tokens: torch.Tensor = torch.empty(
                (self.decode_cudagraph_max_bs,),
                dtype=torch.int32,
                device=device,
            )
        # ReplaySSM standard-decode CUDA-graph buffers: per-row ring cursor,
        # flush flag, and the k^T q precompute scratch.
        if self.use_replayssm:
            self.decode_write_pos_d: torch.Tensor = torch.empty(
                (self.decode_cudagraph_max_bs,),
                dtype=torch.int32,
                device=device,
            )
            self.decode_is_flush_d: torch.Tensor = torch.empty(
                (self.decode_cudagraph_max_bs,),
                dtype=torch.int8,
                device=device,
            )
            # B_cache shape = (ngroups, replayssm_buffer_len, dstate); the page
            # layout is (conv_state, ssm_state, x_cache, dt_cache, B_cache).
            bc_ngroups = kv_cache_spec.shapes[4][0]
            bc_scratch_bs = max(
                self.decode_cudagraph_max_bs, scheduler_config.max_num_seqs
            )
            self.decode_bc_pre_scratch: torch.Tensor = torch.empty(
                (
                    bc_scratch_bs,
                    bc_ngroups,
                    self.replayssm_buffer_len,
                ),
                dtype=torch.float32,
                device=device,
            )
        else:
            self.decode_bc_pre_scratch = None

        self._init_reorder_batch_threshold(1, self.use_spec_decode)
        if self.use_spec_decode:
            self.supports_update_block_table = False

    def build_for_cudagraph_capture(
        self, common_attn_metadata: CommonAttentionMetadata
    ) -> M:
        """
        This method builds the metadata for full cudagraph capture.
        Currently, only decode is supported for full cudagraphs with Mamba.
        """
        m = common_attn_metadata

        assert (
            m.max_query_len <= 1 + self.num_spec_tokens
            and m.num_reqs <= self.decode_cudagraph_max_bs
        ), (
            "Mamba only supports decode-only full CUDAGraph capture. "
            "Make sure all cudagraph capture sizes <= max_num_seq."
        )

        assert m.max_query_len == 1 + self.num_spec_tokens  # decode-only

        num_accepted_tokens = None
        if self.num_spec_tokens > 0:
            num_accepted_tokens = torch.diff(m.query_start_loc)

        prev_last_scheduled_idx = None
        if (
            self.use_spec_decode
            and self.vllm_config.cache_config.mamba_cache_mode == "all"
        ):
            prev_last_scheduled_idx = torch.zeros(
                (m.num_reqs,),
                dtype=torch.int32,
                device=m.query_start_loc.device,
            )

        return self.build(
            0,
            m,
            num_accepted_tokens=num_accepted_tokens,
            prev_last_scheduled_idx=prev_last_scheduled_idx,
        )

    def build(
        self,
        common_prefix_len: int,
        common_attn_metadata: CommonAttentionMetadata,
        fast_build: bool = False,
        *,
        num_accepted_tokens: torch.Tensor | None = None,
        prev_last_scheduled_idx: torch.Tensor | None = None,
        **kwargs: Any,
    ) -> M:
        """
        Default build implementation for Mamba-like attention backends.
        Subclasses (e.g., Mamba2) can override to add additional metadata.
        """
        return self._compute_common_metadata(
            common_attn_metadata,
            num_accepted_tokens=num_accepted_tokens,
            prev_last_scheduled_idx=prev_last_scheduled_idx,
        )

    def _compute_chunk_metadata(
        self,
        chunk_size: int,
        num_prefills: int,
        num_computed_tokens_p_cpu: torch.Tensor,
        query_start_loc_p_cpu: torch.Tensor,
    ) -> tuple[list[int], list[int], list[int]]:
        """
        Compute chunk-specific metadata for Mamba models.

        The code below carefully constructs the chunks such that:
        1. Chunks contain tokens from a *single* sequence only.
        2. For every sequence, we are guaranteed that we can
           retrieve the mamba state *every* chunk_size tokens.
        Constraint (1) dramatically simplifies the mamba kernels.
        Constraint (2) dramatically simplifies the implementation
        of prefix caching for mamba (wip). We need to take care
        of the interaction with chunked prefill in order to
        satisfy constraint (2).
        """
        # TODO (tdoublep): This code could probably be optimized.
        cu_chunk_seqlen = []
        seq_idx = []
        last_chunk_indices = []
        seqlen_pos = 0

        for req_idx in range(num_prefills):
            this_num_computed = num_computed_tokens_p_cpu[req_idx].item()
            this_new_tokens = (
                query_start_loc_p_cpu[req_idx + 1].item()
                - query_start_loc_p_cpu[req_idx].item()
            )

            # if computed tokens are not chunk-aligned, use the first
            # chunk to finish it off
            if this_num_computed % chunk_size != 0:
                seq_idx.append(req_idx)
                cu_chunk_seqlen.append(seqlen_pos)
                # how many tokens to finish the chunk?
                chunk_len = (
                    cdiv(this_num_computed, chunk_size) * chunk_size - this_num_computed
                )
                # we can only use at most this_new_tokens
                chunk_len = min(chunk_len, this_new_tokens)
                seqlen_pos += chunk_len
                this_new_tokens -= chunk_len

            n_chunks = cdiv(this_new_tokens, chunk_size)
            for chunk in range(n_chunks):
                seq_idx.append(req_idx)
                cu_chunk_seqlen.append(seqlen_pos)
                chunk_len = min(chunk_size, this_new_tokens)
                seqlen_pos += chunk_len
                this_new_tokens -= chunk_len

            assert this_new_tokens == 0
            last_chunk_indices.append(len(cu_chunk_seqlen) - 1)

        cu_chunk_seqlen.append(seqlen_pos)

        return cu_chunk_seqlen, seq_idx, last_chunk_indices

    def _prefill_cpu_metadata(
        self,
        common: M,
        common_attn_metadata: CommonAttentionMetadata,
    ) -> tuple[torch.Tensor, torch.Tensor]:
        """Prefill context lengths and query offsets, from CPU data only.

        `seq_lens_cpu_upper_bound` is precise for prefill rows in all modes
        (including async spec decode), so this avoids the D2H sync that
        `compute_num_computed_tokens().cpu()` would force.

        Returns (num_computed_tokens_p_cpu, query_start_loc_p_cpu).
        """
        seq_lens_cpu = common_attn_metadata.seq_lens_cpu_upper_bound
        assert seq_lens_cpu is not None
        num_reqs = common.num_reqs
        num_prefills = common.num_prefills
        query_start_loc_p_cpu = (
            common_attn_metadata.query_start_loc_cpu[-num_prefills - 1 :]
            - common.num_decode_tokens
        )
        prefill_query_lens_cpu = query_start_loc_p_cpu[1:] - query_start_loc_p_cpu[:-1]
        num_computed_tokens_p_cpu = (
            seq_lens_cpu[num_reqs - num_prefills : num_reqs] - prefill_query_lens_cpu
        )
        return num_computed_tokens_p_cpu, query_start_loc_p_cpu

    def _build_chunk_metadata_tensors(
        self,
        chunk_size: int,
        common: M,
        common_attn_metadata: CommonAttentionMetadata,
    ) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
        """
        Compute chunk metadata and return as device tensors.
        Returns (cu_chunk_seqlen_p, seq_idx_p, last_chunk_indices_p).
        """
        num_prefills = common.num_prefills

        num_computed_tokens_p_cpu, query_start_loc_p_cpu = self._prefill_cpu_metadata(
            common, common_attn_metadata
        )

        cu_chunk_seqlen, seq_idx, last_chunk_indices = self._compute_chunk_metadata(
            chunk_size,
            num_prefills,
            num_computed_tokens_p_cpu,
            query_start_loc_p_cpu,
        )

        device = common_attn_metadata.query_start_loc.device
        # Build on pinned CPU and upload non-blocking to avoid the synchronous
        # H2D copy that `torch.as_tensor(list, device=cuda)` would force.
        cu_chunk_seqlen_p = async_tensor_h2d(
            cu_chunk_seqlen, dtype=torch.int32, device=device
        )
        seq_idx_p = async_tensor_h2d(seq_idx, dtype=torch.int32, device=device)
        last_chunk_indices_p = async_tensor_h2d(
            last_chunk_indices, dtype=torch.int32, device=device
        )
        return cu_chunk_seqlen_p, seq_idx_p, last_chunk_indices_p

    def _compute_prefix_caching_block_indices(
        self,
        common_attn_metadata: CommonAttentionMetadata,
        mamba_block_size: int,
    ) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
        num_computed_tokens = common_attn_metadata.compute_num_computed_tokens()
        # Block index of the last computed token
        block_idx_last_computed_token = (
            torch.div(
                num_computed_tokens + mamba_block_size - 1,
                mamba_block_size,
                rounding_mode="floor",
            )
            - 1
        )
        # which is <= block index for the first scheduled token
        block_idx_first_scheduled_token = (
            torch.div(
                num_computed_tokens + mamba_block_size,
                mamba_block_size,
                rounding_mode="floor",
            )
            - 1
        )
        # which is <= block index of the last scheduled token
        block_idx_last_scheduled_token = (
            torch.div(
                common_attn_metadata.seq_lens + mamba_block_size - 1,
                mamba_block_size,
                rounding_mode="floor",
            )
            - 1
        )
        # -1 in case it's non-computed and causes later issues with indexing
        block_idx_last_computed_token.clamp_(min=0)
        # -1 in the case we have a padded request (0 seq-len)
        block_idx_last_scheduled_token.clamp_(min=0)

        return (
            block_idx_last_computed_token,
            block_idx_first_scheduled_token,
            block_idx_last_scheduled_token,
        )

    def _compute_common_metadata(
        self,
        common_attn_metadata: CommonAttentionMetadata,
        *,
        num_accepted_tokens: torch.Tensor | None = None,
        prev_last_scheduled_idx: torch.Tensor | None = None,
    ) -> M:
        """
        Compute metadata common to both Mamba1 and Mamba2.
        """
        num_reqs = common_attn_metadata.num_reqs

        # Treat multi-token queries as decode requests when
        # speculative decoding is enabled. Otherwise, use the
        # default decode threshold to prevent misclassification
        # of prefill queries as decode requests.
        decode_threshold = (
            self.reorder_batch_threshold if num_accepted_tokens is not None else 1
        )

        # FULL-CG dispatch is shape-based, so one-token prefills with
        # prior Mamba state can replay a decode graph while `is_prefilling`
        # is still true. Treat them as decode/update rows. This is required
        # for NIXL disagg's h(N-1)->N recompute path and for sporadic
        # final single-token prefill chunks that land in a `uniform` FULL-CG
        # batch. Relies on `reorder` putting short extends before pure prefills.
        is_prefilling = common_attn_metadata.is_prefilling
        assert is_prefilling is not None
        seq_lens_cpu = common_attn_metadata.seq_lens_cpu_upper_bound
        assert seq_lens_cpu is not None
        query_lens_cpu = torch.diff(common_attn_metadata.query_start_loc_cpu)
        single_token_prefill_rows = is_prefilling & (query_lens_cpu == 1)
        # First-token prefills have no prior Mamba state and must stay prefills.
        has_prior_state = seq_lens_cpu > 1
        prefill_to_decode = single_token_prefill_rows & has_prior_state
        if torch.any(prefill_to_decode).item():
            # ReplaySSM handles these rows as single-token flushes (see the
            # write-position derivation below), same as the baseline decode path.
            is_prefilling = is_prefilling.clone()
            is_prefilling[prefill_to_decode] = False
            common_attn_metadata = common_attn_metadata.replace(
                is_prefilling=is_prefilling
            )

        num_decodes, num_prefills, num_decode_tokens, num_prefill_tokens = (
            split_decodes_and_prefills(
                common_attn_metadata,
                decode_threshold=decode_threshold,
                treat_short_extends_as_decodes=False,
            )
        )

        # Need flags to indicate if there are initial states
        has_initial_states_p = None
        query_start_loc_p = None
        query_start_loc_d = None
        num_computed_tokens = None
        num_computed_tokens_p = None

        # for prefix caching
        block_idx_first_scheduled_token = None
        block_idx_first_scheduled_token_p = None
        block_idx_last_computed_token = None
        block_idx_last_scheduled_token = None
        block_idx_last_scheduled_token_prev_step = None

        # for causal_conv1d
        nums_dict, batch_ptr, token_chunk_offset_ptr = None, None, None
        write_pos_d = None
        is_flush_d = None

        if self.vllm_config.cache_config.mamba_cache_mode == "all":
            num_computed_tokens = common_attn_metadata.compute_num_computed_tokens()

            # Return a tensor of shape (#requests, #max blocks)
            state_indices_tensor = common_attn_metadata.block_table_tensor
            # Additional cache-related variables:
            mamba_block_size = self.kv_cache_spec.block_size
            (
                block_idx_last_computed_token,
                block_idx_first_scheduled_token,
                block_idx_last_scheduled_token,
            ) = self._compute_prefix_caching_block_indices(
                common_attn_metadata, mamba_block_size
            )
            if self.use_spec_decode and prev_last_scheduled_idx is not None:
                fallback = (num_computed_tokens - 1) // mamba_block_size
                fallback.clamp_(min=0)
                block_idx_last_scheduled_token_prev_step = torch.where(
                    prev_last_scheduled_idx >= 0,
                    prev_last_scheduled_idx,
                    fallback,
                )
        else:
            state_indices_tensor = mamba_get_block_table_tensor(
                common_attn_metadata.block_table_tensor,
                common_attn_metadata.seq_lens,
                self.kv_cache_spec,
                self.vllm_config.cache_config.mamba_cache_mode,
            )

        if state_indices_tensor.dim() == 1:
            state_indices_tensor = state_indices_tensor.unsqueeze(-1)

        state_indices_tensor_d, state_indices_tensor_p = torch.split(
            state_indices_tensor,
            [num_decodes, num_prefills],
            dim=0,
        )
        if self.vllm_config.cache_config.mamba_cache_mode != "all":
            state_indices_tensor_d = state_indices_tensor_d[
                :, : 1 + self.num_spec_tokens
            ]
            state_indices_tensor_p = state_indices_tensor_p[:, 0]

        # Sometimes even with specdec enabled we get single-token prefill chunks that
        # should be treated as decodes but don't have num_accepted_tokens set.
        # These should be fine to process as non-spec decodes since there's only
        # one token, so no risk of placing accepted tokens in the wrong slot.
        if num_decodes > 0 and self.use_spec_decode and num_accepted_tokens is not None:
            query_start_loc_d = common_attn_metadata.query_start_loc[: num_decodes + 1]
            num_accepted_tokens = num_accepted_tokens[:num_decodes]

        if num_prefills > 0:
            if num_computed_tokens is None:
                num_computed_tokens = common_attn_metadata.compute_num_computed_tokens()

            query_start_loc_p_cpu = (
                common_attn_metadata.query_start_loc_cpu[-num_prefills - 1 :]
                - num_decode_tokens
            )
            query_start_loc_p = (
                common_attn_metadata.query_start_loc[-num_prefills - 1 :]
                - num_decode_tokens
            )
            has_initial_states_p = (
                num_computed_tokens[num_reqs - num_prefills : num_reqs] > 0
            )

            nums_dict, batch_ptr, token_chunk_offset_ptr = (
                compute_causal_conv1d_metadata(
                    query_start_loc_p_cpu,
                    device=common_attn_metadata.query_start_loc.device,
                )
            )

            if self.vllm_config.cache_config.mamba_cache_mode == "all":
                assert num_computed_tokens is not None
                num_computed_tokens_p = num_computed_tokens[
                    num_reqs - num_prefills : num_reqs
                ]
                assert block_idx_first_scheduled_token is not None
                block_idx_first_scheduled_token_p = block_idx_first_scheduled_token[
                    num_reqs - num_prefills : num_reqs
                ]

        if self.use_replayssm and num_decodes > 0:
            decode_base_cpu = common_attn_metadata.replayssm_decode_base_cpu
            num_computed_tokens_cpu = common_attn_metadata._num_computed_tokens_cpu
            if decode_base_cpu is None or num_computed_tokens_cpu is None:
                raise ValueError(
                    "--use-replayssm requires CPU decode-base and "
                    "computed-token counts to derive decode write positions"
                )
            num_computed_d = num_computed_tokens_cpu[:num_decodes]
            decode_base_d = decode_base_cpu[:num_decodes]
            align_mode = self.vllm_config.cache_config.mamba_cache_mode == "align"
            block_size = self.kv_cache_spec.block_size
            if align_mode:
                # After a boundary the align copy leaves an exact checkpoint at
                # the block start and the new block's ring restarts empty, so
                # re-anchor there; max() keeps the prompt-end anchor for the
                # first (partial) block.
                effective_base = torch.maximum(
                    decode_base_d, (num_computed_d // block_size) * block_size
                )
            else:
                effective_base = decode_base_d
            # write_pos counts decode steps since the ring's last full-state
            # write (the anchor), so a resumed request re-anchors correctly.
            decode_steps_cpu = num_computed_d - effective_base
            query_lens_cpu = (
                common_attn_metadata.query_start_loc_cpu[1 : num_decodes + 1]
                - common_attn_metadata.query_start_loc_cpu[:num_decodes]
            )
            valid_decode_rows = query_lens_cpu > 0
            # A single-token prefill row replayed as decode (query_len==1 with
            # prior state) has decode_steps < 0; force it to a one-token flush
            # (write_pos=0, is_flush=1). The flush branch reads an empty history
            # window, so it applies exactly one recurrence step off the checkpoint
            # -- identical to the baseline decode kernel for that row. The split
            # (treat_short_extends_as_decodes=False) admits only such rows here.
            leftover_prompt = valid_decode_rows & (decode_steps_cpu < 0)
            decode_steps_cpu = torch.where(
                valid_decode_rows & ~leftover_prompt,
                decode_steps_cpu,
                torch.zeros_like(decode_steps_cpu),
            )
            write_pos_cpu = torch.remainder(decode_steps_cpu, self.replayssm_buffer_len)
            is_flush_cpu = (
                write_pos_cpu == self.replayssm_buffer_len - 1
            ) | leftover_prompt
            if align_mode:
                # Force a flush on the step completing a mamba block so the exact
                # boundary state is materialized for prefix caching.
                is_flush_cpu = is_flush_cpu | (
                    valid_decode_rows
                    & ((num_computed_d + query_lens_cpu) % block_size == 0)
                )
            is_flush_cpu = is_flush_cpu.to(torch.int8)
            write_pos_d = async_tensor_h2d(
                write_pos_cpu.to(torch.int32).tolist(),
                dtype=torch.int32,
                device=common_attn_metadata.query_start_loc.device,
            )
            is_flush_d = async_tensor_h2d(
                is_flush_cpu.tolist(),
                dtype=torch.int8,
                device=common_attn_metadata.query_start_loc.device,
            )

        bc_pre_scratch = None
        if (
            self.use_replayssm
            and self.decode_bc_pre_scratch is not None
            and num_decodes > 0
        ):
            bc_pre_scratch = self.decode_bc_pre_scratch[:num_decodes]

        metadata = self.metadata_cls(
            num_prefills=num_prefills,
            num_prefill_tokens=num_prefill_tokens,
            num_decodes=num_decodes,
            num_decode_tokens=num_decode_tokens,
            query_start_loc_p=query_start_loc_p,
            has_initial_states_p=has_initial_states_p,
            state_indices_tensor_p=state_indices_tensor_p,
            state_indices_tensor_d=state_indices_tensor_d,
            write_pos_d=write_pos_d,
            is_flush_d=is_flush_d,
            bc_pre_scratch=bc_pre_scratch,
            num_accepted_tokens=num_accepted_tokens,
            query_start_loc_d=query_start_loc_d,
            block_idx_last_scheduled_token=block_idx_last_scheduled_token,
            block_idx_first_scheduled_token_p=block_idx_first_scheduled_token_p,
            block_idx_last_computed_token=block_idx_last_computed_token,
            block_idx_last_scheduled_token_prev_step=(
                block_idx_last_scheduled_token_prev_step
            ),
            num_computed_tokens_p=num_computed_tokens_p,
            num_reqs=num_reqs,
            seq_lens=common_attn_metadata.seq_lens,
            nums_dict=nums_dict,
            batch_ptr=batch_ptr,
            token_chunk_offset_ptr=token_chunk_offset_ptr,
        )

        return self._update_metadata_for_cudagraph_capture(metadata)

    def _update_metadata_for_cudagraph_capture(
        self,
        metadata: M,
    ) -> M:
        """
        Update the metadata for cudagraph capture.
        Currently, only decode is supported for full cudagraphs with Mamba.
        """
        state_indices_tensor_d = metadata.state_indices_tensor_d
        query_start_loc_d = metadata.query_start_loc_d
        num_accepted_tokens = metadata.num_accepted_tokens
        block_idx_last_scheduled_token = metadata.block_idx_last_scheduled_token
        block_idx_last_computed_token = metadata.block_idx_last_computed_token
        block_idx_last_scheduled_token_prev_step = (
            metadata.block_idx_last_scheduled_token_prev_step
        )
        write_pos_d = metadata.write_pos_d
        is_flush_d = metadata.is_flush_d
        bc_pre_scratch = metadata.bc_pre_scratch
        if (
            metadata.num_prefills == 0
            and metadata.num_decodes <= self.decode_cudagraph_max_bs
            and self.compilation_config.cudagraph_mode.has_full_cudagraphs()
        ):
            padded_bs = metadata.num_reqs
            self.state_indices_tensor_d[: metadata.num_decodes].copy_(
                state_indices_tensor_d, non_blocking=True
            )
            state_indices_tensor_d = self.state_indices_tensor_d[:padded_bs]
            state_indices_tensor_d[metadata.num_decodes :] = NULL_BLOCK_ID

            if self.use_spec_decode and num_accepted_tokens is not None:
                assert query_start_loc_d is not None
                query_start_loc_d = query_start_loc_d[: padded_bs + 1]
                self.decode_num_accepted_tokens[: metadata.num_decodes].copy_(
                    num_accepted_tokens, non_blocking=True
                )
                num_accepted_tokens = self.decode_num_accepted_tokens[:padded_bs]
                num_accepted_tokens[metadata.num_decodes :] = (
                    1  # pad with 1st slot index
                )

            if self.vllm_config.cache_config.mamba_cache_mode == "all":
                assert block_idx_last_scheduled_token is not None
                assert block_idx_last_computed_token is not None
                self.block_idx_last_scheduled_token[: metadata.num_decodes].copy_(
                    block_idx_last_scheduled_token[: metadata.num_decodes],
                    non_blocking=True,
                )
                block_idx_last_scheduled_token = self.block_idx_last_scheduled_token[
                    :padded_bs
                ]
                block_idx_last_scheduled_token[metadata.num_decodes :] = 0

                self.block_idx_last_computed_token[: metadata.num_decodes].copy_(
                    block_idx_last_computed_token[: metadata.num_decodes],
                    non_blocking=True,
                )
                block_idx_last_computed_token = self.block_idx_last_computed_token[
                    :padded_bs
                ]
                block_idx_last_computed_token[metadata.num_decodes :] = 0

                if (
                    self.use_spec_decode
                    and block_idx_last_scheduled_token_prev_step is not None
                ):
                    self.block_idx_last_scheduled_token_prev_step[
                        : metadata.num_decodes
                    ].copy_(
                        block_idx_last_scheduled_token_prev_step[
                            : metadata.num_decodes
                        ],
                        non_blocking=True,
                    )
                    block_idx_last_scheduled_token_prev_step = (
                        self.block_idx_last_scheduled_token_prev_step[:padded_bs]
                    )
                    block_idx_last_scheduled_token_prev_step[metadata.num_decodes :] = 0

            if self.use_replayssm:
                assert write_pos_d is not None
                assert is_flush_d is not None
                self.decode_write_pos_d[: metadata.num_decodes].copy_(
                    write_pos_d[: metadata.num_decodes],
                    non_blocking=True,
                )
                write_pos_d = self.decode_write_pos_d[:padded_bs]
                write_pos_d[metadata.num_decodes :] = 0

                self.decode_is_flush_d[: metadata.num_decodes].copy_(
                    is_flush_d[: metadata.num_decodes],
                    non_blocking=True,
                )
                is_flush_d = self.decode_is_flush_d[:padded_bs]
                is_flush_d[metadata.num_decodes :] = 0

                if self.decode_bc_pre_scratch is not None:
                    bc_pre_scratch = self.decode_bc_pre_scratch[:padded_bs]

        return replace(
            metadata,
            state_indices_tensor_d=state_indices_tensor_d,
            query_start_loc_d=query_start_loc_d,
            num_accepted_tokens=num_accepted_tokens,
            write_pos_d=write_pos_d,
            is_flush_d=is_flush_d,
            bc_pre_scratch=bc_pre_scratch,
            block_idx_last_scheduled_token=block_idx_last_scheduled_token,
            block_idx_last_computed_token=block_idx_last_computed_token,
            block_idx_last_scheduled_token_prev_step=(
                block_idx_last_scheduled_token_prev_step
            ),
        )

    def update_block_table(
        self,
        metadata: M,
        blk_table: torch.Tensor,
        slot_mapping: torch.Tensor,
    ) -> M:
        state_indices_tensor = mamba_get_block_table_tensor(
            blk_table,
            metadata.seq_lens,
            self.kv_cache_spec,
            self.vllm_config.cache_config.mamba_cache_mode,
        )
        if state_indices_tensor.dim() == 1:
            state_indices_tensor = state_indices_tensor.unsqueeze(-1)

        assert (
            metadata.num_prefills + metadata.num_decodes
            == state_indices_tensor.shape[0]
        ), (
            "Mismatch in number of requests when updating block table."
            f" Expected {metadata.num_prefills + metadata.num_decodes}, "
            f"got {state_indices_tensor.shape[0]}."
        )

        state_indices_tensor_d, state_indices_tensor_p = torch.split(
            state_indices_tensor,
            [metadata.num_decodes, metadata.num_prefills],
            dim=0,
        )
        if self.vllm_config.cache_config.mamba_cache_mode != "all":
            state_indices_tensor_d = state_indices_tensor_d[
                :, : 1 + self.num_spec_tokens
            ]
            state_indices_tensor_p = state_indices_tensor_p[:, 0]

        new_metadata = replace(
            metadata,
            state_indices_tensor_d=state_indices_tensor_d,
            state_indices_tensor_p=state_indices_tensor_p,
        )

        return self._update_metadata_for_cudagraph_capture(new_metadata)

_build_chunk_metadata_tensors(chunk_size, common, common_attn_metadata)

Compute chunk metadata and return as device tensors. Returns (cu_chunk_seqlen_p, seq_idx_p, last_chunk_indices_p).

Source code in vllm/v1/attention/backends/mamba_attn.py
def _build_chunk_metadata_tensors(
    self,
    chunk_size: int,
    common: M,
    common_attn_metadata: CommonAttentionMetadata,
) -> tuple[torch.Tensor, torch.Tensor, torch.Tensor]:
    """
    Compute chunk metadata and return as device tensors.
    Returns (cu_chunk_seqlen_p, seq_idx_p, last_chunk_indices_p).
    """
    num_prefills = common.num_prefills

    num_computed_tokens_p_cpu, query_start_loc_p_cpu = self._prefill_cpu_metadata(
        common, common_attn_metadata
    )

    cu_chunk_seqlen, seq_idx, last_chunk_indices = self._compute_chunk_metadata(
        chunk_size,
        num_prefills,
        num_computed_tokens_p_cpu,
        query_start_loc_p_cpu,
    )

    device = common_attn_metadata.query_start_loc.device
    # Build on pinned CPU and upload non-blocking to avoid the synchronous
    # H2D copy that `torch.as_tensor(list, device=cuda)` would force.
    cu_chunk_seqlen_p = async_tensor_h2d(
        cu_chunk_seqlen, dtype=torch.int32, device=device
    )
    seq_idx_p = async_tensor_h2d(seq_idx, dtype=torch.int32, device=device)
    last_chunk_indices_p = async_tensor_h2d(
        last_chunk_indices, dtype=torch.int32, device=device
    )
    return cu_chunk_seqlen_p, seq_idx_p, last_chunk_indices_p

_compute_chunk_metadata(chunk_size, num_prefills, num_computed_tokens_p_cpu, query_start_loc_p_cpu)

Compute chunk-specific metadata for Mamba models.

The code below carefully constructs the chunks such that: 1. Chunks contain tokens from a single sequence only. 2. For every sequence, we are guaranteed that we can retrieve the mamba state every chunk_size tokens. Constraint (1) dramatically simplifies the mamba kernels. Constraint (2) dramatically simplifies the implementation of prefix caching for mamba (wip). We need to take care of the interaction with chunked prefill in order to satisfy constraint (2).

Source code in vllm/v1/attention/backends/mamba_attn.py
def _compute_chunk_metadata(
    self,
    chunk_size: int,
    num_prefills: int,
    num_computed_tokens_p_cpu: torch.Tensor,
    query_start_loc_p_cpu: torch.Tensor,
) -> tuple[list[int], list[int], list[int]]:
    """
    Compute chunk-specific metadata for Mamba models.

    The code below carefully constructs the chunks such that:
    1. Chunks contain tokens from a *single* sequence only.
    2. For every sequence, we are guaranteed that we can
       retrieve the mamba state *every* chunk_size tokens.
    Constraint (1) dramatically simplifies the mamba kernels.
    Constraint (2) dramatically simplifies the implementation
    of prefix caching for mamba (wip). We need to take care
    of the interaction with chunked prefill in order to
    satisfy constraint (2).
    """
    # TODO (tdoublep): This code could probably be optimized.
    cu_chunk_seqlen = []
    seq_idx = []
    last_chunk_indices = []
    seqlen_pos = 0

    for req_idx in range(num_prefills):
        this_num_computed = num_computed_tokens_p_cpu[req_idx].item()
        this_new_tokens = (
            query_start_loc_p_cpu[req_idx + 1].item()
            - query_start_loc_p_cpu[req_idx].item()
        )

        # if computed tokens are not chunk-aligned, use the first
        # chunk to finish it off
        if this_num_computed % chunk_size != 0:
            seq_idx.append(req_idx)
            cu_chunk_seqlen.append(seqlen_pos)
            # how many tokens to finish the chunk?
            chunk_len = (
                cdiv(this_num_computed, chunk_size) * chunk_size - this_num_computed
            )
            # we can only use at most this_new_tokens
            chunk_len = min(chunk_len, this_new_tokens)
            seqlen_pos += chunk_len
            this_new_tokens -= chunk_len

        n_chunks = cdiv(this_new_tokens, chunk_size)
        for chunk in range(n_chunks):
            seq_idx.append(req_idx)
            cu_chunk_seqlen.append(seqlen_pos)
            chunk_len = min(chunk_size, this_new_tokens)
            seqlen_pos += chunk_len
            this_new_tokens -= chunk_len

        assert this_new_tokens == 0
        last_chunk_indices.append(len(cu_chunk_seqlen) - 1)

    cu_chunk_seqlen.append(seqlen_pos)

    return cu_chunk_seqlen, seq_idx, last_chunk_indices

_compute_common_metadata(common_attn_metadata, *, num_accepted_tokens=None, prev_last_scheduled_idx=None)

Compute metadata common to both Mamba1 and Mamba2.

Source code in vllm/v1/attention/backends/mamba_attn.py
def _compute_common_metadata(
    self,
    common_attn_metadata: CommonAttentionMetadata,
    *,
    num_accepted_tokens: torch.Tensor | None = None,
    prev_last_scheduled_idx: torch.Tensor | None = None,
) -> M:
    """
    Compute metadata common to both Mamba1 and Mamba2.
    """
    num_reqs = common_attn_metadata.num_reqs

    # Treat multi-token queries as decode requests when
    # speculative decoding is enabled. Otherwise, use the
    # default decode threshold to prevent misclassification
    # of prefill queries as decode requests.
    decode_threshold = (
        self.reorder_batch_threshold if num_accepted_tokens is not None else 1
    )

    # FULL-CG dispatch is shape-based, so one-token prefills with
    # prior Mamba state can replay a decode graph while `is_prefilling`
    # is still true. Treat them as decode/update rows. This is required
    # for NIXL disagg's h(N-1)->N recompute path and for sporadic
    # final single-token prefill chunks that land in a `uniform` FULL-CG
    # batch. Relies on `reorder` putting short extends before pure prefills.
    is_prefilling = common_attn_metadata.is_prefilling
    assert is_prefilling is not None
    seq_lens_cpu = common_attn_metadata.seq_lens_cpu_upper_bound
    assert seq_lens_cpu is not None
    query_lens_cpu = torch.diff(common_attn_metadata.query_start_loc_cpu)
    single_token_prefill_rows = is_prefilling & (query_lens_cpu == 1)
    # First-token prefills have no prior Mamba state and must stay prefills.
    has_prior_state = seq_lens_cpu > 1
    prefill_to_decode = single_token_prefill_rows & has_prior_state
    if torch.any(prefill_to_decode).item():
        # ReplaySSM handles these rows as single-token flushes (see the
        # write-position derivation below), same as the baseline decode path.
        is_prefilling = is_prefilling.clone()
        is_prefilling[prefill_to_decode] = False
        common_attn_metadata = common_attn_metadata.replace(
            is_prefilling=is_prefilling
        )

    num_decodes, num_prefills, num_decode_tokens, num_prefill_tokens = (
        split_decodes_and_prefills(
            common_attn_metadata,
            decode_threshold=decode_threshold,
            treat_short_extends_as_decodes=False,
        )
    )

    # Need flags to indicate if there are initial states
    has_initial_states_p = None
    query_start_loc_p = None
    query_start_loc_d = None
    num_computed_tokens = None
    num_computed_tokens_p = None

    # for prefix caching
    block_idx_first_scheduled_token = None
    block_idx_first_scheduled_token_p = None
    block_idx_last_computed_token = None
    block_idx_last_scheduled_token = None
    block_idx_last_scheduled_token_prev_step = None

    # for causal_conv1d
    nums_dict, batch_ptr, token_chunk_offset_ptr = None, None, None
    write_pos_d = None
    is_flush_d = None

    if self.vllm_config.cache_config.mamba_cache_mode == "all":
        num_computed_tokens = common_attn_metadata.compute_num_computed_tokens()

        # Return a tensor of shape (#requests, #max blocks)
        state_indices_tensor = common_attn_metadata.block_table_tensor
        # Additional cache-related variables:
        mamba_block_size = self.kv_cache_spec.block_size
        (
            block_idx_last_computed_token,
            block_idx_first_scheduled_token,
            block_idx_last_scheduled_token,
        ) = self._compute_prefix_caching_block_indices(
            common_attn_metadata, mamba_block_size
        )
        if self.use_spec_decode and prev_last_scheduled_idx is not None:
            fallback = (num_computed_tokens - 1) // mamba_block_size
            fallback.clamp_(min=0)
            block_idx_last_scheduled_token_prev_step = torch.where(
                prev_last_scheduled_idx >= 0,
                prev_last_scheduled_idx,
                fallback,
            )
    else:
        state_indices_tensor = mamba_get_block_table_tensor(
            common_attn_metadata.block_table_tensor,
            common_attn_metadata.seq_lens,
            self.kv_cache_spec,
            self.vllm_config.cache_config.mamba_cache_mode,
        )

    if state_indices_tensor.dim() == 1:
        state_indices_tensor = state_indices_tensor.unsqueeze(-1)

    state_indices_tensor_d, state_indices_tensor_p = torch.split(
        state_indices_tensor,
        [num_decodes, num_prefills],
        dim=0,
    )
    if self.vllm_config.cache_config.mamba_cache_mode != "all":
        state_indices_tensor_d = state_indices_tensor_d[
            :, : 1 + self.num_spec_tokens
        ]
        state_indices_tensor_p = state_indices_tensor_p[:, 0]

    # Sometimes even with specdec enabled we get single-token prefill chunks that
    # should be treated as decodes but don't have num_accepted_tokens set.
    # These should be fine to process as non-spec decodes since there's only
    # one token, so no risk of placing accepted tokens in the wrong slot.
    if num_decodes > 0 and self.use_spec_decode and num_accepted_tokens is not None:
        query_start_loc_d = common_attn_metadata.query_start_loc[: num_decodes + 1]
        num_accepted_tokens = num_accepted_tokens[:num_decodes]

    if num_prefills > 0:
        if num_computed_tokens is None:
            num_computed_tokens = common_attn_metadata.compute_num_computed_tokens()

        query_start_loc_p_cpu = (
            common_attn_metadata.query_start_loc_cpu[-num_prefills - 1 :]
            - num_decode_tokens
        )
        query_start_loc_p = (
            common_attn_metadata.query_start_loc[-num_prefills - 1 :]
            - num_decode_tokens
        )
        has_initial_states_p = (
            num_computed_tokens[num_reqs - num_prefills : num_reqs] > 0
        )

        nums_dict, batch_ptr, token_chunk_offset_ptr = (
            compute_causal_conv1d_metadata(
                query_start_loc_p_cpu,
                device=common_attn_metadata.query_start_loc.device,
            )
        )

        if self.vllm_config.cache_config.mamba_cache_mode == "all":
            assert num_computed_tokens is not None
            num_computed_tokens_p = num_computed_tokens[
                num_reqs - num_prefills : num_reqs
            ]
            assert block_idx_first_scheduled_token is not None
            block_idx_first_scheduled_token_p = block_idx_first_scheduled_token[
                num_reqs - num_prefills : num_reqs
            ]

    if self.use_replayssm and num_decodes > 0:
        decode_base_cpu = common_attn_metadata.replayssm_decode_base_cpu
        num_computed_tokens_cpu = common_attn_metadata._num_computed_tokens_cpu
        if decode_base_cpu is None or num_computed_tokens_cpu is None:
            raise ValueError(
                "--use-replayssm requires CPU decode-base and "
                "computed-token counts to derive decode write positions"
            )
        num_computed_d = num_computed_tokens_cpu[:num_decodes]
        decode_base_d = decode_base_cpu[:num_decodes]
        align_mode = self.vllm_config.cache_config.mamba_cache_mode == "align"
        block_size = self.kv_cache_spec.block_size
        if align_mode:
            # After a boundary the align copy leaves an exact checkpoint at
            # the block start and the new block's ring restarts empty, so
            # re-anchor there; max() keeps the prompt-end anchor for the
            # first (partial) block.
            effective_base = torch.maximum(
                decode_base_d, (num_computed_d // block_size) * block_size
            )
        else:
            effective_base = decode_base_d
        # write_pos counts decode steps since the ring's last full-state
        # write (the anchor), so a resumed request re-anchors correctly.
        decode_steps_cpu = num_computed_d - effective_base
        query_lens_cpu = (
            common_attn_metadata.query_start_loc_cpu[1 : num_decodes + 1]
            - common_attn_metadata.query_start_loc_cpu[:num_decodes]
        )
        valid_decode_rows = query_lens_cpu > 0
        # A single-token prefill row replayed as decode (query_len==1 with
        # prior state) has decode_steps < 0; force it to a one-token flush
        # (write_pos=0, is_flush=1). The flush branch reads an empty history
        # window, so it applies exactly one recurrence step off the checkpoint
        # -- identical to the baseline decode kernel for that row. The split
        # (treat_short_extends_as_decodes=False) admits only such rows here.
        leftover_prompt = valid_decode_rows & (decode_steps_cpu < 0)
        decode_steps_cpu = torch.where(
            valid_decode_rows & ~leftover_prompt,
            decode_steps_cpu,
            torch.zeros_like(decode_steps_cpu),
        )
        write_pos_cpu = torch.remainder(decode_steps_cpu, self.replayssm_buffer_len)
        is_flush_cpu = (
            write_pos_cpu == self.replayssm_buffer_len - 1
        ) | leftover_prompt
        if align_mode:
            # Force a flush on the step completing a mamba block so the exact
            # boundary state is materialized for prefix caching.
            is_flush_cpu = is_flush_cpu | (
                valid_decode_rows
                & ((num_computed_d + query_lens_cpu) % block_size == 0)
            )
        is_flush_cpu = is_flush_cpu.to(torch.int8)
        write_pos_d = async_tensor_h2d(
            write_pos_cpu.to(torch.int32).tolist(),
            dtype=torch.int32,
            device=common_attn_metadata.query_start_loc.device,
        )
        is_flush_d = async_tensor_h2d(
            is_flush_cpu.tolist(),
            dtype=torch.int8,
            device=common_attn_metadata.query_start_loc.device,
        )

    bc_pre_scratch = None
    if (
        self.use_replayssm
        and self.decode_bc_pre_scratch is not None
        and num_decodes > 0
    ):
        bc_pre_scratch = self.decode_bc_pre_scratch[:num_decodes]

    metadata = self.metadata_cls(
        num_prefills=num_prefills,
        num_prefill_tokens=num_prefill_tokens,
        num_decodes=num_decodes,
        num_decode_tokens=num_decode_tokens,
        query_start_loc_p=query_start_loc_p,
        has_initial_states_p=has_initial_states_p,
        state_indices_tensor_p=state_indices_tensor_p,
        state_indices_tensor_d=state_indices_tensor_d,
        write_pos_d=write_pos_d,
        is_flush_d=is_flush_d,
        bc_pre_scratch=bc_pre_scratch,
        num_accepted_tokens=num_accepted_tokens,
        query_start_loc_d=query_start_loc_d,
        block_idx_last_scheduled_token=block_idx_last_scheduled_token,
        block_idx_first_scheduled_token_p=block_idx_first_scheduled_token_p,
        block_idx_last_computed_token=block_idx_last_computed_token,
        block_idx_last_scheduled_token_prev_step=(
            block_idx_last_scheduled_token_prev_step
        ),
        num_computed_tokens_p=num_computed_tokens_p,
        num_reqs=num_reqs,
        seq_lens=common_attn_metadata.seq_lens,
        nums_dict=nums_dict,
        batch_ptr=batch_ptr,
        token_chunk_offset_ptr=token_chunk_offset_ptr,
    )

    return self._update_metadata_for_cudagraph_capture(metadata)

_prefill_cpu_metadata(common, common_attn_metadata)

Prefill context lengths and query offsets, from CPU data only.

seq_lens_cpu_upper_bound is precise for prefill rows in all modes (including async spec decode), so this avoids the D2H sync that compute_num_computed_tokens().cpu() would force.

Returns (num_computed_tokens_p_cpu, query_start_loc_p_cpu).

Source code in vllm/v1/attention/backends/mamba_attn.py
def _prefill_cpu_metadata(
    self,
    common: M,
    common_attn_metadata: CommonAttentionMetadata,
) -> tuple[torch.Tensor, torch.Tensor]:
    """Prefill context lengths and query offsets, from CPU data only.

    `seq_lens_cpu_upper_bound` is precise for prefill rows in all modes
    (including async spec decode), so this avoids the D2H sync that
    `compute_num_computed_tokens().cpu()` would force.

    Returns (num_computed_tokens_p_cpu, query_start_loc_p_cpu).
    """
    seq_lens_cpu = common_attn_metadata.seq_lens_cpu_upper_bound
    assert seq_lens_cpu is not None
    num_reqs = common.num_reqs
    num_prefills = common.num_prefills
    query_start_loc_p_cpu = (
        common_attn_metadata.query_start_loc_cpu[-num_prefills - 1 :]
        - common.num_decode_tokens
    )
    prefill_query_lens_cpu = query_start_loc_p_cpu[1:] - query_start_loc_p_cpu[:-1]
    num_computed_tokens_p_cpu = (
        seq_lens_cpu[num_reqs - num_prefills : num_reqs] - prefill_query_lens_cpu
    )
    return num_computed_tokens_p_cpu, query_start_loc_p_cpu

_update_metadata_for_cudagraph_capture(metadata)

Update the metadata for cudagraph capture. Currently, only decode is supported for full cudagraphs with Mamba.

Source code in vllm/v1/attention/backends/mamba_attn.py
def _update_metadata_for_cudagraph_capture(
    self,
    metadata: M,
) -> M:
    """
    Update the metadata for cudagraph capture.
    Currently, only decode is supported for full cudagraphs with Mamba.
    """
    state_indices_tensor_d = metadata.state_indices_tensor_d
    query_start_loc_d = metadata.query_start_loc_d
    num_accepted_tokens = metadata.num_accepted_tokens
    block_idx_last_scheduled_token = metadata.block_idx_last_scheduled_token
    block_idx_last_computed_token = metadata.block_idx_last_computed_token
    block_idx_last_scheduled_token_prev_step = (
        metadata.block_idx_last_scheduled_token_prev_step
    )
    write_pos_d = metadata.write_pos_d
    is_flush_d = metadata.is_flush_d
    bc_pre_scratch = metadata.bc_pre_scratch
    if (
        metadata.num_prefills == 0
        and metadata.num_decodes <= self.decode_cudagraph_max_bs
        and self.compilation_config.cudagraph_mode.has_full_cudagraphs()
    ):
        padded_bs = metadata.num_reqs
        self.state_indices_tensor_d[: metadata.num_decodes].copy_(
            state_indices_tensor_d, non_blocking=True
        )
        state_indices_tensor_d = self.state_indices_tensor_d[:padded_bs]
        state_indices_tensor_d[metadata.num_decodes :] = NULL_BLOCK_ID

        if self.use_spec_decode and num_accepted_tokens is not None:
            assert query_start_loc_d is not None
            query_start_loc_d = query_start_loc_d[: padded_bs + 1]
            self.decode_num_accepted_tokens[: metadata.num_decodes].copy_(
                num_accepted_tokens, non_blocking=True
            )
            num_accepted_tokens = self.decode_num_accepted_tokens[:padded_bs]
            num_accepted_tokens[metadata.num_decodes :] = (
                1  # pad with 1st slot index
            )

        if self.vllm_config.cache_config.mamba_cache_mode == "all":
            assert block_idx_last_scheduled_token is not None
            assert block_idx_last_computed_token is not None
            self.block_idx_last_scheduled_token[: metadata.num_decodes].copy_(
                block_idx_last_scheduled_token[: metadata.num_decodes],
                non_blocking=True,
            )
            block_idx_last_scheduled_token = self.block_idx_last_scheduled_token[
                :padded_bs
            ]
            block_idx_last_scheduled_token[metadata.num_decodes :] = 0

            self.block_idx_last_computed_token[: metadata.num_decodes].copy_(
                block_idx_last_computed_token[: metadata.num_decodes],
                non_blocking=True,
            )
            block_idx_last_computed_token = self.block_idx_last_computed_token[
                :padded_bs
            ]
            block_idx_last_computed_token[metadata.num_decodes :] = 0

            if (
                self.use_spec_decode
                and block_idx_last_scheduled_token_prev_step is not None
            ):
                self.block_idx_last_scheduled_token_prev_step[
                    : metadata.num_decodes
                ].copy_(
                    block_idx_last_scheduled_token_prev_step[
                        : metadata.num_decodes
                    ],
                    non_blocking=True,
                )
                block_idx_last_scheduled_token_prev_step = (
                    self.block_idx_last_scheduled_token_prev_step[:padded_bs]
                )
                block_idx_last_scheduled_token_prev_step[metadata.num_decodes :] = 0

        if self.use_replayssm:
            assert write_pos_d is not None
            assert is_flush_d is not None
            self.decode_write_pos_d[: metadata.num_decodes].copy_(
                write_pos_d[: metadata.num_decodes],
                non_blocking=True,
            )
            write_pos_d = self.decode_write_pos_d[:padded_bs]
            write_pos_d[metadata.num_decodes :] = 0

            self.decode_is_flush_d[: metadata.num_decodes].copy_(
                is_flush_d[: metadata.num_decodes],
                non_blocking=True,
            )
            is_flush_d = self.decode_is_flush_d[:padded_bs]
            is_flush_d[metadata.num_decodes :] = 0

            if self.decode_bc_pre_scratch is not None:
                bc_pre_scratch = self.decode_bc_pre_scratch[:padded_bs]

    return replace(
        metadata,
        state_indices_tensor_d=state_indices_tensor_d,
        query_start_loc_d=query_start_loc_d,
        num_accepted_tokens=num_accepted_tokens,
        write_pos_d=write_pos_d,
        is_flush_d=is_flush_d,
        bc_pre_scratch=bc_pre_scratch,
        block_idx_last_scheduled_token=block_idx_last_scheduled_token,
        block_idx_last_computed_token=block_idx_last_computed_token,
        block_idx_last_scheduled_token_prev_step=(
            block_idx_last_scheduled_token_prev_step
        ),
    )

build(common_prefix_len, common_attn_metadata, fast_build=False, *, num_accepted_tokens=None, prev_last_scheduled_idx=None, **kwargs)

Default build implementation for Mamba-like attention backends. Subclasses (e.g., Mamba2) can override to add additional metadata.

Source code in vllm/v1/attention/backends/mamba_attn.py
def build(
    self,
    common_prefix_len: int,
    common_attn_metadata: CommonAttentionMetadata,
    fast_build: bool = False,
    *,
    num_accepted_tokens: torch.Tensor | None = None,
    prev_last_scheduled_idx: torch.Tensor | None = None,
    **kwargs: Any,
) -> M:
    """
    Default build implementation for Mamba-like attention backends.
    Subclasses (e.g., Mamba2) can override to add additional metadata.
    """
    return self._compute_common_metadata(
        common_attn_metadata,
        num_accepted_tokens=num_accepted_tokens,
        prev_last_scheduled_idx=prev_last_scheduled_idx,
    )

build_for_cudagraph_capture(common_attn_metadata)

This method builds the metadata for full cudagraph capture. Currently, only decode is supported for full cudagraphs with Mamba.

Source code in vllm/v1/attention/backends/mamba_attn.py
def build_for_cudagraph_capture(
    self, common_attn_metadata: CommonAttentionMetadata
) -> M:
    """
    This method builds the metadata for full cudagraph capture.
    Currently, only decode is supported for full cudagraphs with Mamba.
    """
    m = common_attn_metadata

    assert (
        m.max_query_len <= 1 + self.num_spec_tokens
        and m.num_reqs <= self.decode_cudagraph_max_bs
    ), (
        "Mamba only supports decode-only full CUDAGraph capture. "
        "Make sure all cudagraph capture sizes <= max_num_seq."
    )

    assert m.max_query_len == 1 + self.num_spec_tokens  # decode-only

    num_accepted_tokens = None
    if self.num_spec_tokens > 0:
        num_accepted_tokens = torch.diff(m.query_start_loc)

    prev_last_scheduled_idx = None
    if (
        self.use_spec_decode
        and self.vllm_config.cache_config.mamba_cache_mode == "all"
    ):
        prev_last_scheduled_idx = torch.zeros(
            (m.num_reqs,),
            dtype=torch.int32,
            device=m.query_start_loc.device,
        )

    return self.build(
        0,
        m,
        num_accepted_tokens=num_accepted_tokens,
        prev_last_scheduled_idx=prev_last_scheduled_idx,
    )