zellij-org/zellij · error

freshly transmitted image is mapped

Error message

freshly transmitted image is mapped

What it means

Error "freshly transmitted image is mapped" thrown in zellij-org/zellij.

Source

Thrown at zellij-server/src/panes/grid.rs:3869

                match self.kitty_grid.transmit(&command, image) {
                    Ok(assigned_id) => Ok(KittyReplyData {
                        image_id: Some(assigned_id),
                        image_number: command.image_number,
                        placement_id: command.placement_id,
                        quiet: command.quiet,
                    }),
                    Err(e) => Err(e),
                }
            },
            KittyAction::TransmitAndDisplay | KittyAction::Display => {
                let resolved = if command.action == KittyAction::TransmitAndDisplay {
                    match command.image.clone() {
                        Some(image) => self.kitty_grid.transmit(&command, image).map(|id| {
                            let internal = *self
                                .kitty_grid
                                .pane_image_id_map()
                                .get(&id)
                                .expect("freshly transmitted image is mapped");
                            (id, internal)
                        }),
                        None => Err(KittyError {
                            code: KittyErrorCode::Einval,
                            message: "missing image data".to_owned(),
                            image_id: command.image_id,
                            image_number: command.image_number,
                            placement_id: command.placement_id,
                            quiet: command.quiet,
                        }),
                    }
                } else {
                    self.kitty_grid.resolve_display_target(&command)
                };
                let (pane_image_id, internal) = match resolved {
                    Ok(resolved) => resolved,
                    Err(e) => return Err(e),
                };

View on GitHub (pinned to e839bfffa5)

Solutions

1. This is an internal invariant violation; report it with steps to reproduce.
2. Restart the session to clear the pane state.

When it happens

Trigger: Occurs at zellij-server/src/panes/grid.rs:3533 when the operation fails: "freshly transmitted image is mapped". Currently there is no defensive handling preventing or contextualizing this failure before it surfaces.

Common situations: Internal graphics-protocol state inconsistency (e.g. Sixel/kitty image handling).

AI-assisted analysis of zellij-org/zellij@e839bfffa5 (2026-08-19). Data as JSON: /api/errors/ed143f59bfa5066a. Report an issue: GitHub.