Rename ctx.notify to broadcast_raw_notification

[manzt]

The old name read like a toast helper, but the method is a low-level escape hatch that takes a fully-constructed Notification payload and puts it on the kernel's outbound stream.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
marimo-docs	Ready	Preview, Comment	May 19, 2026 1:38pm

[Copilot]

Pull request overview

Renames the low-level code-mode context method for sending fully constructed frontend Notification payloads, clarifying that it is a raw “escape hatch” rather than a higher-level UI helper.

Changes:

• Renamed ctx.notify(...) to ctx.broadcast_raw_notification(...) in code-mode transaction broadcasting.
• Expanded the method docstring to describe intended use, tradeoffs, and example notification types.

[cubic-dev-ai]

No issues found across 1 file

Architecture diagram

sequenceDiagram
    participant CM as Code Mode
    participant Kernel as Kernel
    participant Stream as Outbound Stream
    participant Frontend as Frontend UI

    Note over CM,Frontend: Code Transaction Flow
    
    CM->>CM: _apply_ops() builds doc_ops
    CM->>CM: Create Transaction from doc_ops
    CM->>CM: Apply transaction to local document
    
    CM->>Kernel: broadcast_raw_notification(NotebookDocumentTransactionNotification)
    Note over CM,Kernel: Takes fully-constructed Notification payload
    
    Kernel->>Stream: broadcast_notification(notification, stream)
    Note over Kernel: No validation, batching, or debouncing
    
    Stream-->>Frontend: Deliver transaction notification
    Frontend->>Frontend: Apply document transaction to UI state

    Note over CM,Stream: Other callers
    
    alt Enqueueing commands
        CM->>CM: enqueue_command(CommandMessage)
        CM->>Kernel: broadcast_raw_notification(…)
    end
    
    alt Banner notifications
        CM->>Kernel: broadcast_raw_notification(BannerNotification)
    end
    
    alt Alert dialogs
        CM->>Kernel: broadcast_raw_notification(AlertNotification)
    end
    
    alt Package install progress
        CM->>Kernel: broadcast_raw_notification(InstallingPackageAlertNotification)
    end
    
    alt Missing package prompts
        CM->>Kernel: broadcast_raw_notification(MissingPackageAlertNotification)
    end
    
    alt Reload notification
        CM->>Kernel: broadcast_raw_notification(ReloadNotification)
    end

    Note over CM,Frontend: All notifications flow through same path

Loading

_{Re-trigger cubic}