@marimo-team/islands 0.24.3-dev50 → 0.24.3-dev52

package/dist/{ErrorBoundary-BW0xr_AR.js → ErrorBoundary-Bfp74qVG.js}

@@ -135,7 +135,7 @@ function F(e) {
 }
 //#endregion
 //#region src/components/editor/boundary/ErrorBoundary.tsx
-var I = (0, T.lazy)(() => import("./feedback-button-BAHeJT2Q.js").then((e) => ({ default: e.FeedbackModal }))), L = (e) => {
+var I = (0, T.lazy)(() => import("./feedback-button-D_YQdd5e.js").then((e) => ({ default: e.FeedbackModal }))), L = (e) => {
 	let t = (0, w.c)(2), n;
 	return t[0] === e.children ? n = t[1] : (n = /* @__PURE__ */ (0, j.jsx)(O, {
 		FallbackComponent: R,

package/dist/{code-visibility-BdKqYmPi.js → code-visibility-qtEE1_Zi.js}

@@ -18,7 +18,7 @@ function x() {
 		return e.warn("Failed to get version from mount config"), null;
 	}
 }
-var S = x() || "0.24.3-dev50", C = u(S), w = u(!0);
+var S = x() || "0.24.3-dev52", C = u(S), w = u(!0);
 u(null);
 //#endregion
 //#region src/core/wasm/state.ts

package/dist/{common-D9PY0k7A.js → common-BmP252R5.js}

@@ -12,7 +12,7 @@ import { t as dt } from "./check-B7cIK6gb.js";
 import { A as ft, C as pt, D as mt, M as ht, O as gt, S as _t, _ as vt, b as yt, c as bt, d as xt, g as St, h as Ct, i as wt, m as Tt, n as Et, p as Dt, s as Ot, t as kt, u as At, v as jt, y as Mt } from "./select-C6plhmZr.js";
 import { $ as Nt, $t as Pt, A as Ft, At as It, B as Lt, Bt as Rt, Ct as zt, D as Bt, Dt as Vt, E as Ht, Et as Ut, F as Wt, Ft as Gt, G as Kt, Gt as qt, H as Jt, Ht as Yt, I as Xt, It as Zt, Jt as Qt, K as $t, Kt as en, L as tn, Lt as nn, M as rn, Mt as an, N as on, Nt as sn, O as cn, Ot as ln, P as un, Pt as dn, Q as fn, Qt as pn, R as mn, Rt as hn, S as gn, St as _n, T as vn, Tt as yn, U as bn, Ut as xn, V as Sn, Vt as Cn, W as wn, Wt as Tn, X as En, Xt as Dn, Y as On, Yt as kn, Z as An, Zt as jn, _ as Mn, _t as Nn, a as Pn, an as Fn, b as In, bt as Ln, cn as Rn, ct as zn, d as Bn, dn as Vn, dt as Hn, en as Un, et as Wn, f as Gn, fn as Kn, ft as qn, gt as Jn, h as Yn, ht as Xn, i as Zn, it as Qn, j as $n, jt as er, k as tr, kt as nr, l as rr, ln as ir, lt as ar, mt as or, n as sr, nn as cr, nt as lr, o as ur, on as dr, ot as fr, pn as pr, pt as mr, qt as hr, rn as gr, rt as _r, s as vr, sn as yr, st as br, t as xr, tn as Sr, tt as Cr, u as wr, un as Tr, ut as Er, vt as Dr, w as Or, wt as kr, x as Ar, xt as jr, y as Mr, yt as Nr, z as Pr, zt as Fr } from "./dropdown-menu-CZgjYSAh.js";
 import { _ as Ir, a as Lr, c as Rr, d as zr, i as Br, n as Vr, o as Hr, p as Ur, r as Wr, s as Gr, t as Kr } from "./toDate-WXg1yLcI.js";
-import { n as qr, t as Jr } from "./ErrorBoundary-BW0xr_AR.js";
+import { n as qr, t as Jr } from "./ErrorBoundary-Bfp74qVG.js";
 import { t as Yr } from "./clsx-CoeGtWvn.js";
 import { t as Xr } from "./react-dom-BUgJ-ab_.js";
 import { t as Zr } from "./jsx-runtime-DgDPJV9S.js";

package/dist/{data-grid-overlay-editor-BZiw7m3d.js → data-grid-overlay-editor-DtaTjDfe.js}

@@ -2,7 +2,7 @@ import { a as e } from "./rolldown-runtime-Cb76FRpK.js";
 import { t } from "./react-ofJbxM4x.js";
 import { t as n } from "./react-dom-BUgJ-ab_.js";
 import { c as r, l as i, u as a } from "./data-grid-types-BucVmDDp.js";
-import { a as o, i as s, n as c, r as l } from "./glide-data-editor-Bp9hhneH.js";
+import { a as o, i as s, n as c, r as l } from "./glide-data-editor-CV4eSJ7N.js";
 //#region ../node_modules/.pnpm/@glideapps+glide-data-grid@6.0.4-alpha24_lodash@4.17.21_marked@15.0.12_react-dom@19.2.8_b9e6aec46d952f631ce71b0585d2a8e5/node_modules/@glideapps/glide-data-grid/dist/esm/internal/data-grid-overlay-editor/data-grid-overlay-editor-style.js
 var u = /* @__PURE__ */ e(t(), 1), d = /* @__PURE__ */ e(n(), 1), f = /*#__PURE__*/ o("div")({
 	name: "DataGridOverlayEditorStyle",

package/dist/{feedback-button-BAHeJT2Q.js → feedback-button-D_YQdd5e.js}

@@ -5,12 +5,12 @@ import { t as i } from "./compiler-runtime-Cj8ZWiNS.js";
 import { t as a } from "./copy-icon-CLdENY__.js";
 import { Bt as o, H as s, Ht as c, L as l, Ot as u, V as d, d as f, hn as p } from "./cells-BSgNCBZ8.js";
 import { b as m } from "./select-C6plhmZr.js";
-import { n as h, t as ee } from "./globals-BUgvsAck.js";
+import { n as h, t as ee } from "./globals-DdrpcXQY.js";
 import { t as g } from "./jsx-runtime-DgDPJV9S.js";
 import { C as _, _ as te, i as v } from "./useTheme-DzXmYZ5V.js";
 import { a as ne, i as re, n as ie, r as ae } from "./dialog-CgNq6y9-.js";
 import { t as oe } from "./useAsyncData-BD6AStMt.js";
-import { t as se } from "./code-visibility-BdKqYmPi.js";
+import { t as se } from "./code-visibility-qtEE1_Zi.js";
 import { i as ce, n as le } from "./error-entries-iJn-Nryx.js";
 //#region src/components/ui/skeleton.tsx
 var y = /* @__PURE__ */ e(r(), 1), b = i(), x = g(), ue = (e) => {

package/dist/{glide-data-editor-Bp9hhneH.js → glide-data-editor-CV4eSJ7N.js}

@@ -6,7 +6,7 @@ import { i as s, n as c, r as l } from "./copy-icon-CLdENY__.js";
 import { C as u, c as d, i as f, n as p, s as m, t as h, x as g } from "./select-C6plhmZr.js";
 import { d as _, h as v, i as y, l as b, n as x, o as S, s as C, t as w, u as T } from "./dropdown-menu-CZgjYSAh.js";
 import { c as E, d as D, l as O, n as k, o as A, s as ee, t as j, u as te } from "./glide-utils-B3rUT5PI.js";
-import { n as ne, t as re } from "./ErrorBoundary-BW0xr_AR.js";
+import { n as ne, t as re } from "./ErrorBoundary-Bfp74qVG.js";
 import { t as M } from "./react-dom-BUgJ-ab_.js";
 import { t as N } from "./jsx-runtime-DgDPJV9S.js";
 import { t as ie } from "./label-BJ49YTvk.js";
@@ -7062,7 +7062,7 @@ function rs(e, t, n, r, i) {
 }
 //#endregion
 //#region ../node_modules/.pnpm/@glideapps+glide-data-grid@6.0.4-alpha24_lodash@4.17.21_marked@15.0.12_react-dom@19.2.8_b9e6aec46d952f631ce71b0585d2a8e5/node_modules/@glideapps/glide-data-grid/dist/esm/data-editor/data-editor.js
-var is = /* @__PURE__ */ e(_r(), 1), as = /* @__PURE__ */ e(xr(), 1), os = K.lazy(async () => await import("./data-grid-overlay-editor-BZiw7m3d.js")), ss = 0;
+var is = /* @__PURE__ */ e(_r(), 1), as = /* @__PURE__ */ e(xr(), 1), os = K.lazy(async () => await import("./data-grid-overlay-editor-DtaTjDfe.js")), ss = 0;
 function cs(e) {
 	return (0, is.default)((0, as.default)((0, as.default)(e).filter((e) => e.span !== void 0).map((e) => (0, Za.default)((e.span?.[0] ?? 0) + 1, (e.span?.[1] ?? 0) + 1))));
 }
@@ -9293,7 +9293,7 @@ function Vs(e, t, n, r, i) {
 }
 //#endregion
 //#region ../node_modules/.pnpm/@glideapps+glide-data-grid@6.0.4-alpha24_lodash@4.17.21_marked@15.0.12_react-dom@19.2.8_b9e6aec46d952f631ce71b0585d2a8e5/node_modules/@glideapps/glide-data-grid/dist/esm/cells/number-cell.js
-var Hs = K.lazy(async () => await import("./number-overlay-editor-C743iqsh.js")), Us = {
+var Hs = K.lazy(async () => await import("./number-overlay-editor-DXWRr4gK.js")), Us = {
 	getAccessibilityString: (e) => e.data?.toString() ?? "",
 	kind: W.Number,
 	needsHover: (e) => e.hoverEffect === !0,

package/dist/{globals-BUgvsAck.js → globals-DdrpcXQY.js}

@@ -1,6 +1,6 @@
 import { g as e } from "./tooltip-qB8NlSqV.js";
 import { _ as t } from "./useTheme-DzXmYZ5V.js";
-import { r as n } from "./code-visibility-BdKqYmPi.js";
+import { r as n } from "./code-visibility-qtEE1_Zi.js";
 var r = e("triangle-alert", [
 	["path", {
 		d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3",

package/dist/main.js

@@ -7,7 +7,7 @@ import { C as T, F as E, G as D, I as O, J as k, K as A, L as j, P as M, R as N,
 import { a as se, f as ce, g as V, i as le, n as ue, o as de, p as fe, r as pe, t as me } from "./tooltip-qB8NlSqV.js";
 import { $ as he, $t as ge, At as _e, B as ve, C as ye, D as be, Dt as xe, F as Se, G as Ce, Gt as we, I as Te, J as Ee, L as De, Mt as Oe, Nt as ke, O as Ae, Ot as je, P as Me, Q as Ne, Qt as Pe, S as Fe, T as Ie, Tt as Le, U as Re, Ut as ze, W as Be, Wt as Ve, X as He, Xt as Ue, Y as We, Yt as Ge, Zt as Ke, _n as qe, _t as Je, an as Ye, bn as Xe, c as Ze, cn as Qe, ct as $e, d as et, dn as tt, dt as nt, f as rt, fn as it, ft as at, g as ot, gn as st, gt as ct, h as lt, in as ut, it as dt, jt as ft, k as pt, kt as mt, l as ht, m as gt, mn as _t, n as vt, o as yt, on as bt, p as xt, pn as St, pt as Ct, q as wt, qt as Tt, r as Et, rn as Dt, rt as Ot, u as kt, v as At, w as jt, xt as Mt, yn as Nt, zt as Pt } from "./cells-BSgNCBZ8.js";
 import { D as Ft, E as It, O as Lt, S as Rt, T as zt, _ as Bt, a as Vt, c as Ht, d as Ut, f as Wt, g as Gt, h as Kt, i as qt, l as Jt, m as Yt, n as Xt, o as Zt, p as Qt, r as $t, s as en, t as tn, u as nn, v as rn, w as an, x as on, y as sn } from "./spec-CAYwFeV6.js";
-import { $t as cn, A as ln, At as un, B as dn, Bt as fn, C as pn, Ct as mn, D as hn, Dt as gn, E as _n, Et as vn, F as yn, Ft as bn, G as xn, Gt as Sn, H as Cn, Ht as wn, I as Tn, It as En, J as Dn, Jt as On, K as kn, Kt as An, L as jn, Lt as Mn, M as Nn, Mt as Pn, N as Fn, Nt as In, O as Ln, Ot as Rn, P as zn, Pt as Bn, Qt as Vn, R as Hn, Rt as Un, S as Wn, St as Gn, T as Kn, Tt as qn, U as Jn, Ut as Yn, V as Xn, Vt as Zn, W as Qn, Wt as $n, X as er, Xt as tr, Y as nr, Yt as rr, Zt as ir, _ as ar, _t as or, an as sr, at as cr, b as lr, c as ur, cn as dr, ct as fr, d as pr, dn as mr, dt as hr, en as gr, et as _r, f as vr, fn as yr, ft as br, g as xr, gt as Sr, h as Cr, hn as wr, ht as Tr, in as Er, it as Dr, j as Or, jt as kr, k as Ar, kt as jr, ln as Mr, lt as Nr, m as Pr, mn as Fr, mt as Ir, nn as Lr, nt as Rr, ot as zr, p as Br, pn as Vr, pt as Hr, q as Ur, qt as Wr, r as Gr, rn as Kr, rt as qr, sn as Jr, st as Yr, t as Xr, tn as Zr, tt as Qr, u as $r, un as ei, ut as ti, v as ni, vt as ri, w as ii, wt as ai, x as oi, y as si, yt as ci, z as li, zt as ui } from "./common-D9PY0k7A.js";
+import { $t as cn, A as ln, At as un, B as dn, Bt as fn, C as pn, Ct as mn, D as hn, Dt as gn, E as _n, Et as vn, F as yn, Ft as bn, G as xn, Gt as Sn, H as Cn, Ht as wn, I as Tn, It as En, J as Dn, Jt as On, K as kn, Kt as An, L as jn, Lt as Mn, M as Nn, Mt as Pn, N as Fn, Nt as In, O as Ln, Ot as Rn, P as zn, Pt as Bn, Qt as Vn, R as Hn, Rt as Un, S as Wn, St as Gn, T as Kn, Tt as qn, U as Jn, Ut as Yn, V as Xn, Vt as Zn, W as Qn, Wt as $n, X as er, Xt as tr, Y as nr, Yt as rr, Zt as ir, _ as ar, _t as or, an as sr, at as cr, b as lr, c as ur, cn as dr, ct as fr, d as pr, dn as mr, dt as hr, en as gr, et as _r, f as vr, fn as yr, ft as br, g as xr, gt as Sr, h as Cr, hn as wr, ht as Tr, in as Er, it as Dr, j as Or, jt as kr, k as Ar, kt as jr, ln as Mr, lt as Nr, m as Pr, mn as Fr, mt as Ir, nn as Lr, nt as Rr, ot as zr, p as Br, pn as Vr, pt as Hr, q as Ur, qt as Wr, r as Gr, rn as Kr, rt as qr, sn as Jr, st as Yr, t as Xr, tn as Zr, tt as Qr, u as $r, un as ei, ut as ti, v as ni, vt as ri, w as ii, wt as ai, x as oi, y as si, yt as ci, z as li, zt as ui } from "./common-BmP252R5.js";
 import { c as di, i as fi, n as pi, o as mi, t as hi } from "./useLifecycle-DPgiiwwU.js";
 import { t as gi } from "./check-B7cIK6gb.js";
 import { A as _i, C as vi, D as yi, E as bi, M as xi, O as Si, S as Ci, T as wi, a as Ti, b as Ei, c as Di, i as Oi, k as ki, l as Ai, n as ji, o as Mi, r as Ni, s as Pi, t as Fi, w as Ii, x as Li } from "./select-C6plhmZr.js";
@@ -15,8 +15,8 @@ import { B as Ri, C as zi, J as Bi, Mt as Vi, Nt as Hi, S as Ui, Vt as Wi, W as
 import { _ as ha, c as ga, d as _a, f as va, g as ya, h as ba, m as xa, u as Sa, v as Ca } from "./toDate-WXg1yLcI.js";
 import { a as wa, c as Ta, d as Ea, f as Da, i as Oa, l as ka, n as Aa, o as ja, r as Ma, s as Na, t as Pa } from "./process-output-DFe2tVIY.js";
 import { a as Fa, c as Ia, d as La, i as Ra, l as za, r as Ba, u as Va } from "./glide-utils-B3rUT5PI.js";
-import { n as Ha, t as Ua } from "./ErrorBoundary-BW0xr_AR.js";
-import { n as Wa, t as Ga } from "./globals-BUgvsAck.js";
+import { n as Ha, t as Ua } from "./ErrorBoundary-Bfp74qVG.js";
+import { n as Wa, t as Ga } from "./globals-DdrpcXQY.js";
 import { t as Ka } from "./react-dom-BUgJ-ab_.js";
 import { t as qa } from "./jsx-runtime-DgDPJV9S.js";
 import { B as Ja, C as H, Ct as Ya, D as Xa, E as Za, Et as Qa, F as U, G as $a, H as eo, I as to, L as no, M as W, N as ro, O as io, P as ao, Q as oo, R as so, S as G, St as co, Tt as lo, U as uo, W as fo, Y as po, Z as mo, _ as ho, a as go, b as _o, bt as vo, c as yo, d as bo, dt as xo, f as So, g as Co, gt as wo, h as To, i as Eo, j as K, k as Do, l as Oo, m as ko, n as Ao, o as jo, p as Mo, r as No, s as Po, u as Fo, v as Io, vt as Lo, w as Ro, wt as zo, x as Bo, xt as Vo, y as Ho, yt as Uo } from "./use-restore-focus-D5D9xEjZ.js";
@@ -40,7 +40,7 @@ import { t as Ns } from "./useAsyncData-BD6AStMt.js";
 import { i as Ps, n as Fs, r as Is } from "./formats-BR5iGb4s.js";
 import { M as Ls, N as Rs } from "./vega-loader.browser-D95WfUcj.js";
 import { a as zs, n as Bs } from "./loader-D2W4oM-3.js";
-import { c as Vs, d as Hs, i as Us, l as Ws, o as Gs, s as Ks, t as qs, u as Js } from "./code-visibility-BdKqYmPi.js";
+import { c as Vs, d as Hs, i as Us, l as Ws, o as Gs, s as Ks, t as qs, u as Js } from "./code-visibility-qtEE1_Zi.js";
 import { t as Ys } from "./useDeepCompareMemoize-D_HNdyvI.js";
 import { t as Xs } from "./esm-BElI3qKH.js";
 //#region ../node_modules/.pnpm/iconify-icon@2.3.0/node_modules/iconify-icon/dist/iconify-icon.mjs
@@ -10458,7 +10458,7 @@ function RC(e, t) {
 }
 //#endregion
 //#region src/plugins/impl/DataEditorPlugin.tsx
-var zC = J.lazy(() => import("./glide-data-editor-Bp9hhneH.js").then((e) => e.t)), BC = xS("marimo-data-editor", { cssStyles: [WS] }).withData(W({
+var zC = J.lazy(() => import("./glide-data-editor-CV4eSJ7N.js").then((e) => e.t)), BC = xS("marimo-data-editor", { cssStyles: [WS] }).withData(W({
 	initialValue: W({ edits: G(W({
 		rowIdx: K(),
 		columnId: U(),
@@ -29922,7 +29922,7 @@ function bR(e) {
 }
 //#endregion
 //#region src/components/editor/renderers/slides-layout/slides-layout.tsx
-var xR = J.lazy(() => import("./reveal-component-CgMzL2w5.js")), SR = (e) => {
+var xR = J.lazy(() => import("./reveal-component-DLxDt6wQ.js")), SR = (e) => {
 	let t = (0, X.c)(33), { layout: n, setLayout: r, cells: i, mode: a } = e, o = rs(Ce), s = a === "read" || o, c = rs(xt) > 1, [l, u] = (0, J.useState)(null), d;
 	t[0] !== i || t[1] !== n ? (d = vP(i, n), t[0] = i, t[1] = n, t[2] = d) : d = t[2];
 	let { slideCells: f, skippedIds: p, noOutputIds: m, slideTypes: h, startCellIndex: g } = d, _;

package/dist/{number-overlay-editor-C743iqsh.js → number-overlay-editor-DXWRr4gK.js}

@@ -1,6 +1,6 @@
 import { a as e } from "./rolldown-runtime-Cb76FRpK.js";
 import { t } from "./react-ofJbxM4x.js";
-import { a as n } from "./glide-data-editor-Bp9hhneH.js";
+import { a as n } from "./glide-data-editor-CV4eSJ7N.js";
 //#region ../node_modules/.pnpm/@glideapps+glide-data-grid@6.0.4-alpha24_lodash@4.17.21_marked@15.0.12_react-dom@19.2.8_b9e6aec46d952f631ce71b0585d2a8e5/node_modules/@glideapps/glide-data-grid/dist/esm/internal/data-grid-overlay-editor/private/number-overlay-editor-style.js
 var r = /* @__PURE__ */ e(t()), i = /*#__PURE__*/ n("div")({
 	name: "NumberOverlayEditorStyle",

package/dist/{reveal-component-CgMzL2w5.js → reveal-component-DLxDt6wQ.js}

@@ -4,13 +4,13 @@ import { t as o } from "./react-ofJbxM4x.js";
 import { t as s } from "./compiler-runtime-Cj8ZWiNS.js";
 import { g as c, t as l } from "./tooltip-qB8NlSqV.js";
 import { G as u, w as d } from "./cells-BSgNCBZ8.js";
-import { $ as f, Q as p, Z as m, an as h, i as g, l as _, ln as v, n as y, on as b, r as x, t as S, u as C } from "./common-D9PY0k7A.js";
+import { $ as f, Q as p, Z as m, an as h, i as g, l as _, ln as v, n as y, on as b, r as x, t as S, u as C } from "./common-BmP252R5.js";
 import { M as w } from "./select-C6plhmZr.js";
 import { J as T } from "./dropdown-menu-CZgjYSAh.js";
 import { t as E } from "./jsx-runtime-DgDPJV9S.js";
 import { q as ee } from "./use-restore-focus-D5D9xEjZ.js";
 import { A as D, C as O, b as k } from "./useTheme-DzXmYZ5V.js";
-import { a as A, n as te, t as ne } from "./code-visibility-BdKqYmPi.js";
+import { a as A, n as te, t as ne } from "./code-visibility-qtEE1_Zi.js";
 /* empty css                */
 var j = c("sticky-note", [["path", {
 	d: "M21 9a2.4 2.4 0 0 0-.706-1.706l-3.588-3.588A2.4 2.4 0 0 0 15 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2z",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/islands",
-  "version": "0.24.3-dev50",
+  "version": "0.24.3-dev52",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/src/__tests__/fixtures/pair-preview.ts

@@ -0,0 +1,19 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { pairPreviewSchema } from "@/core/config/pair";
+
+// Read the Python-owned resource only in tests to check the shared contract.
+export const PAIR_PREVIEW = pairPreviewSchema.parse({
+  command: "uv run marimo",
+  templates: JSON.parse(
+    readFileSync(
+      path.resolve(
+        import.meta.dirname,
+        "../../../../marimo/_cli/pair/prompt.json",
+      ),
+      "utf8",
+    ),
+  ),
+});

package/src/__tests__/mount.test.ts

@@ -8,6 +8,8 @@ import { connectionAtom } from "@/core/network/connection";
 import { store } from "@/core/state/jotai";
 import { isStaticNotebook } from "@/core/static/static-state";
 import { WebSocketState } from "@/core/websocket/types";
+import { pairPreviewAtom } from "@/core/config/pair";
+import { PAIR_PREVIEW } from "./fixtures/pair-preview";
 import { mount, visibleForTesting } from "../mount";
 
 // Mock React DOM
@@ -82,6 +84,22 @@ describe("mount", () => {
       mockElement,
     );
 
+  it("hydrates the server's Pair preview configuration", () => {
+    const error = mountRead({ pairPreview: PAIR_PREVIEW });
+
+    expect(error).toBeUndefined();
+    expect(store.get(pairPreviewAtom)).toEqual(PAIR_PREVIEW);
+  });
+
+  it("uses legacy Pair behavior when the host omits preview configuration", () => {
+    store.set(pairPreviewAtom, PAIR_PREVIEW);
+
+    const error = mountRead();
+
+    expect(error).toBeUndefined();
+    expect(store.get(pairPreviewAtom)).toBeUndefined();
+  });
+
   describe("connection state initialization", () => {
     it("should set connection to CONNECTING when runtimeConfig has lazy=false", () => {
       mount(

package/src/components/editor/actions/__tests__/pair-with-agent-commands.test.ts

@@ -10,10 +10,12 @@ import {
   maskToken,
 } from "../pair-with-agent-commands";
 import { shellQuote } from "@/utils/shell";
+import { PAIR_PREVIEW } from "@/__tests__/fixtures/pair-preview";
 
 const CONNECTION: ConnectionInfo = {
   url: "http://localhost:8000",
   file: "notebooks/example.py",
+  session: "s_ab12cd",
 };
 
 const CONNECTION_WITHOUT_FILE: ConnectionInfo = {
@@ -104,6 +106,61 @@ describe("getMarimoCommand", () => {
 });
 
 describe("getTerminalCommand", () => {
+  it("uses the preview launcher in production and quotes session-only targets", () => {
+    vi.stubEnv("DEV", false);
+    try {
+      expect(
+        getTerminalCommand(
+          "claude",
+          { url: "http://host:8000?a=1&b=2", session: "s_' {file}" },
+          false,
+          { ...PAIR_PREVIEW, command: "uvx marimo@latest" },
+        ),
+      ).toBe(
+        String.raw`claude "$(MARIMO_PAIR_NEXT=1 uvx marimo@latest pair prompt \
+  --url 'http://host:8000?a=1&b=2' \
+  --session 's_'"'"' {file}')"`,
+      );
+      expect(
+        getTerminalCommand(
+          "codex",
+          CONNECTION_WITHOUT_FILE,
+          false,
+          PAIR_PREVIEW,
+        ),
+      ).toBe(
+        String.raw`codex "$(MARIMO_PAIR_NEXT=1 uv run marimo pair prompt \
+  --url http://localhost:8000)"`,
+      );
+    } finally {
+      vi.unstubAllEnvs();
+    }
+  });
+
+  it.each([
+    ["claude", "claude"],
+    ["codex", "codex"],
+    ["opencode", "opencode --prompt"],
+  ] as const)(
+    "enables the preview inside the %s prompt command",
+    (agent, cli) => {
+      expect(
+        getTerminalCommand(
+          agent,
+          { ...CONNECTION, session: "s_ab12cd" },
+          true,
+          PAIR_PREVIEW,
+        ),
+      ).toBe(
+        String.raw`${cli} "$(MARIMO_PAIR_NEXT=1 uv run marimo pair prompt \
+  --url http://localhost:8000 \
+  --file notebooks/example.py \
+  --session s_ab12cd \
+  --with-token)"`,
+      );
+    },
+  );
+
   it("includes the url and file for each agent", () => {
     expect(getTerminalCommand("claude", CONNECTION, false)).toBe(
       `claude "$(uv run marimo pair prompt --url http://localhost:8000 --file notebooks/example.py --claude)"`,
@@ -169,6 +226,64 @@ describe("getTerminalCommand", () => {
 });
 
 describe("getRawPrompt", () => {
+  it("uses supplied templates without reinterpreting inserted values", () => {
+    expect(
+      getRawPrompt(
+        {
+          url: "http://host/{file}",
+          file: "{session}/it's.py",
+          session: "{command}",
+        },
+        "tok'en {file} $&",
+        {
+          ...PAIR_PREVIEW,
+          command: "custom marimo",
+          templates: {
+            ...PAIR_PREVIEW.templates,
+            prompt: "{command}\n{url}\n{file}{session}{authentication}",
+          },
+        },
+      ),
+    ).toBe(
+      "custom marimo\nhttp://host/{file}\nFile: {session}/it's.py\nSession: {command}\n" +
+        `\n\nFor authenticated Pair commands, set \`export MARIMO_TOKEN='tok'"'"'en {file} $&'\` in the shell that runs marimo.`,
+    );
+  });
+
+  it.each([
+    [CONNECTION_WITHOUT_FILE, ""],
+    [
+      { ...CONNECTION_WITHOUT_FILE, session: "s_ab12cd" },
+      "Session: s_ab12cd\n",
+    ],
+    [
+      { ...CONNECTION_WITHOUT_FILE, file: "notebook.py" },
+      "File: notebook.py\n",
+    ],
+  ])("omits absent preview fields for %j", (connection, fields) => {
+    expect(getRawPrompt(connection, null, PAIR_PREVIEW)).toBe(
+      "Pair with me on this running marimo notebook.\n\n" +
+        `URL: http://localhost:8000\n${fields}\n` +
+        "Run `uv run marimo pair --help` first.\n" +
+        "Use `uv run marimo` for all marimo commands.\n\n" +
+        "Once connected, send a fun toast using `mo.status.toast(...)` (`import marimo as mo`).",
+    );
+  });
+
+  it("renders the shared preview template with optional session context", () => {
+    expect(
+      getRawPrompt({ ...CONNECTION, session: "s_ab12cd" }, null, PAIR_PREVIEW),
+    ).toBe(
+      "Pair with me on this running marimo notebook.\n\n" +
+        "URL: http://localhost:8000\n" +
+        "File: notebooks/example.py\n" +
+        "Session: s_ab12cd\n\n" +
+        "Run `uv run marimo pair --help` first.\n" +
+        "Use `uv run marimo` for all marimo commands.\n\n" +
+        "Once connected, send a fun toast using `mo.status.toast(...)` (`import marimo as mo`).",
+    );
+  });
+
   it("references the file-scoped execute-code command", () => {
     const prompt = getRawPrompt(CONNECTION, null);
     expect(prompt).toContain(

package/src/components/editor/actions/__tests__/pair-with-agent-modal.test.tsx

@@ -0,0 +1,218 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import {
+  act,
+  fireEvent,
+  render,
+  screen,
+  waitFor,
+  within,
+} from "@testing-library/react";
+import { Provider } from "jotai";
+import type React from "react";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { PAIR_PREVIEW } from "@/__tests__/fixtures/pair-preview";
+import { Dialog } from "@/components/ui/dialog";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { pairPreviewAtom } from "@/core/config/pair";
+import { getSessionId } from "@/core/kernel/session";
+import { filenameAtom } from "@/core/saving/file-state";
+import {
+  DEFAULT_RUNTIME_CONFIG,
+  runtimeConfigAtom,
+} from "@/core/runtime/config";
+import { store } from "@/core/state/jotai";
+import { PairWithAgentModal } from "../pair-with-agent-modal";
+import { copyToClipboard } from "@/utils/copy";
+
+vi.mock("@/utils/copy", () => ({
+  copyToClipboard: vi.fn().mockResolvedValue(undefined),
+}));
+
+function wrapper({ children }: { children: React.ReactNode }) {
+  return (
+    <Provider store={store}>
+      <TooltipProvider>
+        <Dialog open={true}>{children}</Dialog>
+      </TooltipProvider>
+    </Provider>
+  );
+}
+
+describe("PairWithAgentModal", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    store.set(pairPreviewAtom, PAIR_PREVIEW);
+    store.set(filenameAtom, "/project/my notebook.py");
+    store.set(runtimeConfigAtom, {
+      ...DEFAULT_RUNTIME_CONFIG,
+      url: "http://localhost:8000",
+    });
+    window.history.replaceState({}, "", "/?file=notebook.py");
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue(new Response(JSON.stringify({ token: null }))),
+    );
+  });
+
+  afterEach(() => {
+    store.set(pairPreviewAtom, undefined);
+    store.set(filenameAtom, null);
+    vi.unstubAllGlobals();
+  });
+
+  it.each(["Claude", "Codex", "OpenCode", "Prompt"])(
+    "omits skill installation and includes the current session in %s preview",
+    async (tab) => {
+      await act(async () => {
+        render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+      });
+      fireEvent.mouseDown(screen.getByRole("tab", { name: tab }), {
+        button: 0,
+        ctrlKey: false,
+      });
+
+      const panel = screen.getByRole("tabpanel");
+      expect(within(panel).queryAllByText(/skill/i)).toEqual([]);
+      expect(panel).toHaveTextContent(getSessionId());
+      expect(panel).toHaveTextContent(
+        tab === "Prompt" ? "File: notebook.py" : "--file notebook.py",
+      );
+      expect(panel).not.toHaveTextContent("/project/my notebook.py");
+      expect(panel).toHaveTextContent(
+        tab === "Prompt" ? "1. Copy this prompt" : "1. Run in your terminal",
+      );
+    },
+  );
+
+  it.each(["Claude", "Codex", "OpenCode", "Prompt"])(
+    "includes the known notebook file in %s preview when the URL has no file",
+    async (tab) => {
+      window.history.replaceState({}, "", "/");
+      await act(async () => {
+        render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+      });
+      fireEvent.mouseDown(screen.getByRole("tab", { name: tab }), {
+        button: 0,
+        ctrlKey: false,
+      });
+
+      const panel = screen.getByRole("tabpanel");
+      const fileHint =
+        tab === "Prompt"
+          ? "File: /project/my notebook.py"
+          : "--file '/project/my notebook.py'";
+      expect(panel).toHaveTextContent(fileHint);
+      fireEvent.click(
+        within(panel).getByRole("button", {
+          name: tab === "Prompt" ? "Copy prompt" : "Copy command",
+        }),
+      );
+      await waitFor(() => expect(copyToClipboard).toHaveBeenCalledOnce());
+      expect(vi.mocked(copyToClipboard).mock.calls[0][0]).toContain(fileHint);
+    },
+  );
+
+  it.each([null, ""])(
+    "omits the file when the URL and notebook filename are absent (%s)",
+    async (filename) => {
+      window.history.replaceState({}, "", "/");
+      store.set(filenameAtom, filename);
+      await act(async () => {
+        render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+      });
+      expect(screen.getByRole("tabpanel")).not.toHaveTextContent("--file");
+      fireEvent.mouseDown(screen.getByRole("tab", { name: "Prompt" }), {
+        button: 0,
+        ctrlKey: false,
+      });
+      expect(screen.getByRole("tabpanel")).not.toHaveTextContent("File:");
+    },
+  );
+
+  it.each(["Claude", "Codex", "OpenCode", "Prompt"])(
+    "preserves the %s skill flow without preview configuration",
+    async (tab) => {
+      store.set(pairPreviewAtom, undefined);
+      window.history.replaceState({}, "", "/");
+      await act(async () => {
+        render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+      });
+      fireEvent.mouseDown(screen.getByRole("tab", { name: tab }), {
+        button: 0,
+        ctrlKey: false,
+      });
+
+      const panel = screen.getByRole("tabpanel");
+      expect(
+        within(panel).getByText("npx skills add marimo-team/marimo-pair"),
+      ).toBeVisible();
+      expect(panel).not.toHaveTextContent(getSessionId());
+      expect(panel).not.toHaveTextContent("MARIMO_PAIR_NEXT");
+      expect(panel).not.toHaveTextContent("/project/my notebook.py");
+      expect(panel).toHaveTextContent(
+        tab === "Prompt" ? "2. Copy this prompt" : "2. Run in your terminal",
+      );
+    },
+  );
+
+  it.each([true, false])(
+    "masks the raw token but copies it intact (preview=%s)",
+    async (preview) => {
+      store.set(pairPreviewAtom, preview ? PAIR_PREVIEW : undefined);
+      vi.mocked(fetch).mockResolvedValue(
+        new Response(JSON.stringify({ token: "secret-token" })),
+      );
+      await act(async () => {
+        render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+      });
+      fireEvent.mouseDown(screen.getByRole("tab", { name: "Prompt" }), {
+        button: 0,
+        ctrlKey: false,
+      });
+
+      const panel = screen.getByRole("tabpanel");
+      expect(panel).toHaveTextContent("********oken");
+      expect(panel).not.toHaveTextContent("secret-token");
+      fireEvent.click(
+        within(panel).getByRole("button", { name: "Copy prompt" }),
+      );
+      await waitFor(() => expect(copyToClipboard).toHaveBeenCalledOnce());
+      expect(vi.mocked(copyToClipboard).mock.calls[0][0]).toContain(
+        preview ? "export MARIMO_TOKEN=secret-token" : "--token secret-token",
+      );
+      expect(vi.mocked(copyToClipboard).mock.calls[0][0]).not.toContain(
+        "********oken",
+      );
+    },
+  );
+
+  it("copies a preview terminal command without the token and lets the user copy the token separately", async () => {
+    vi.mocked(fetch).mockResolvedValue(
+      new Response(JSON.stringify({ token: "secret-token" })),
+    );
+    await act(async () => {
+      render(<PairWithAgentModal onClose={vi.fn()} />, { wrapper });
+    });
+
+    const panel = screen.getByRole("tabpanel");
+    expect(panel).toHaveTextContent("2. Paste when prompted for a token");
+    expect(panel).not.toHaveTextContent("secret-token");
+    fireEvent.click(
+      within(panel).getByRole("button", { name: "Copy command" }),
+    );
+    await waitFor(() =>
+      expect(copyToClipboard).toHaveBeenCalledWith(
+        String.raw`claude "$(MARIMO_PAIR_NEXT=1 uv run marimo pair prompt \
+  --url http://localhost:8000/ \
+  --file notebook.py \
+  --session ${getSessionId()} \
+  --with-token)"`,
+      ),
+    );
+    fireEvent.click(within(panel).getByRole("button", { name: "Copy token" }));
+    await waitFor(() =>
+      expect(copyToClipboard).toHaveBeenLastCalledWith("secret-token"),
+    );
+  });
+});

package/src/components/editor/actions/pair-with-agent-commands.ts

@@ -3,6 +3,7 @@
 import { assertNever } from "@/utils/assertNever";
 import { KnownQueryParams } from "@/core/constants";
 import { shellQuote } from "@/utils/shell";
+import type { PairPreviewConfig } from "@/core/config/pair";
 
 export type AgentTab = "claude" | "codex" | "opencode" | "prompt";
 
@@ -37,8 +38,9 @@ function getFileFlag(file: string | undefined): string {
 /** Identifies the specific running notebook to pair on. */
 export interface ConnectionInfo {
   url: string;
-  /** The server's file key, when the page URL identifies a notebook. */
+  /** The server's file key or notebook filename, when known. */
   file?: string;
+  session?: string;
 }
 
 /**
@@ -47,19 +49,29 @@ export interface ConnectionInfo {
  */
 export function getTerminalCommand(
   agent: Exclude<AgentTab, "prompt">,
-  { url, file }: ConnectionInfo,
+  { url, file, session }: ConnectionInfo,
   withToken: boolean,
+  preview?: PairPreviewConfig,
 ): string {
-  const fileFlag = getFileFlag(file);
-  const tokenFlag = withToken ? " --with-token" : "";
-  const base = `${getMarimoCommand()} pair prompt --url ${shellQuote(url)}${fileFlag}${tokenFlag}`;
+  const command = preview?.command ?? getMarimoCommand();
+  const prefix = preview ? "MARIMO_PAIR_NEXT=1 " : "";
+  const base = [
+    `${prefix}${command} pair prompt`,
+    `--url ${shellQuote(url)}`,
+    file ? `--file ${shellQuote(file)}` : "",
+    preview && session ? `--session ${shellQuote(session)}` : "",
+    withToken ? "--with-token" : "",
+    preview ? "" : `--${agent}`,
+  ]
+    .filter(Boolean)
+    .join(preview ? " \\\n  " : " ");
   switch (agent) {
     case "claude":
-      return `claude "$(${base} --claude)"`;
+      return `claude "$(${base})"`;
     case "codex":
-      return `codex "$(${base} --codex)"`;
+      return `codex "$(${base})"`;
     case "opencode":
-      return `opencode --prompt "$(${base} --opencode)"`;
+      return `opencode --prompt "$(${base})"`;
     default:
       assertNever(agent);
   }
@@ -71,9 +83,23 @@ export function getTerminalCommand(
  * an agent behaves the same as the terminal commands.
  */
 export function getRawPrompt(
-  { url, file }: ConnectionInfo,
+  { url, file, session }: ConnectionInfo,
   token: string | null,
+  preview?: PairPreviewConfig,
 ): string {
+  if (preview) {
+    const { command, templates } = preview;
+    return formatPrompt(templates.prompt, {
+      command,
+      url,
+      file: file ? formatPrompt(templates.file, { file }) : "",
+      session: session ? formatPrompt(templates.session, { session }) : "",
+      authentication: token
+        ? formatPrompt(templates.token, { token: shellQuote(token) })
+        : "",
+    });
+  }
+
   const fileFlag = getFileFlag(file);
   const fileHint = file ? ` (file ${file})` : "";
   const executeCmd = `execute-code.sh --url ${shellQuote(url)}${fileFlag}`;
@@ -91,6 +117,17 @@ export function getRawPrompt(
   ].join("\n");
 }
 
+function formatPrompt(
+  template: string,
+  values: Record<string, string>,
+): string {
+  // Replace once so inserted file names or tokens cannot become placeholders.
+  return template.replaceAll(
+    /\{(\w+)\}/g,
+    (placeholder, key: string) => values[key] ?? placeholder,
+  );
+}
+
 /** Mask all but the last 4 chars of a token for display. */
 export function maskToken(token: string): string {
   if (token.length <= 4) {

package/src/components/editor/actions/pair-with-agent-modal.tsx

@@ -2,6 +2,7 @@
 
 import { CheckIcon, CopyIcon } from "lucide-react";
 import React, { useEffect, useState } from "react";
+import { useAtomValue } from "jotai";
 import { Button } from "@/components/ui/button";
 import {
   DialogContent,
@@ -16,6 +17,9 @@ import { Events } from "@/utils/events";
 import { Tooltip } from "@/components/ui/tooltip";
 import { asRemoteURL, useRuntimeManager } from "@/core/runtime/config";
 import { API } from "@/core/network/api";
+import { pairPreviewAtom } from "@/core/config/pair";
+import { getSessionId } from "@/core/kernel/session";
+import { useFilename } from "@/core/saving/filename";
 import {
   AGENT_LABELS,
   AGENT_TABS,
@@ -49,11 +53,17 @@ export const PairWithAgentModal: React.FC<{
 }> = ({ onClose }) => {
   const [activeTab, setActiveTab] = useState<AgentTab>("claude");
   const runtimeManager = useRuntimeManager();
+  const preview = useAtomValue(pairPreviewAtom);
+  const filename = useFilename();
+  const commandStep = preview ? 1 : 2;
   const authToken = useAuthToken();
   const hasToken = Boolean(authToken);
   const connection: ConnectionInfo = {
     url: runtimeManager.httpURL.toString(),
-    file: getFileFromURL(window.location.href),
+    file:
+      getFileFromURL(window.location.href) ??
+      (preview ? filename || undefined : undefined),
+    session: preview ? getSessionId() : undefined,
   };
 
   return (
@@ -94,23 +104,34 @@ export const PairWithAgentModal: React.FC<{
               value={tab}
               className="mt-4 flex flex-col gap-4"
             >
-              <Step
-                index={1}
-                title="Install the skill"
-                hint="Run once per machine."
-              >
-                <CommandBlock command={SKILL_INSTALL} />
-              </Step>
-              <Step index={2} title="Run in your terminal">
+              {!preview && (
+                <Step
+                  index={1}
+                  title="Install the skill"
+                  hint="Run once per machine."
+                >
+                  <CommandBlock command={SKILL_INSTALL} />
+                </Step>
+              )}
+              <Step index={commandStep} title="Run in your terminal">
                 <CommandBlock
-                  command={getTerminalCommand(tab, connection, hasToken)}
+                  command={getTerminalCommand(
+                    tab,
+                    connection,
+                    hasToken,
+                    preview,
+                  )}
                 />
               </Step>
               {hasToken && authToken && (
-                <Step index={3} title="Paste when prompted for a token">
+                <Step
+                  index={commandStep + 1}
+                  title="Paste when prompted for a token"
+                >
                   <CommandBlock
                     command={authToken}
                     display={maskToken(authToken)}
+                    copyLabel="Copy token"
                   />
                 </Step>
               )}
@@ -118,15 +139,17 @@ export const PairWithAgentModal: React.FC<{
           ))}
 
           <TabsContent value="prompt" className="mt-4 flex flex-col gap-4">
+            {!preview && (
+              <Step
+                index={1}
+                title="Make sure the marimo-pair skill is available to your agent"
+                hint="Skip if your agent already has it."
+              >
+                <CommandBlock command={SKILL_INSTALL} />
+              </Step>
+            )}
             <Step
-              index={1}
-              title="Make sure the marimo-pair skill is available to your agent"
-              hint="Skip if your agent already has it."
-            >
-              <CommandBlock command={SKILL_INSTALL} />
-            </Step>
-            <Step
-              index={2}
+              index={commandStep}
               title="Copy this prompt into your agent"
               hint={
                 hasToken
@@ -135,10 +158,11 @@ export const PairWithAgentModal: React.FC<{
               }
             >
               <CommandBlock
-                command={getRawPrompt(connection, authToken)}
+                command={getRawPrompt(connection, authToken, preview)}
                 display={getRawPrompt(
                   connection,
                   authToken ? maskToken(authToken) : null,
+                  preview,
                 )}
                 multiline={true}
               />
@@ -177,7 +201,8 @@ const CommandBlock: React.FC<{
   command: string;
   display?: string;
   multiline?: boolean;
-}> = ({ command, display, multiline = false }) => {
+  copyLabel?: string;
+}> = ({ command, display, multiline = false, copyLabel = "Copy command" }) => {
   const [copied, setCopied] = useState(false);
 
   const copy = Events.stopPropagation(async (e) => {
@@ -195,6 +220,7 @@ const CommandBlock: React.FC<{
         </pre>
         <Tooltip content="Copied!" open={copied}>
           <Button
+            aria-label="Copy prompt"
             onClick={copy}
             size="xs"
             variant="ghost"
@@ -213,11 +239,11 @@ const CommandBlock: React.FC<{
 
   return (
     <div className="flex items-center gap-2 rounded-md bg-muted px-3 py-2 font-mono text-xs">
-      <code className="flex-1 select-all wrap-break-word">
+      <code className="flex-1 whitespace-pre-wrap select-all wrap-break-word">
         {display ?? command}
       </code>
       <Tooltip content="Copied!" open={copied}>
-        <Button onClick={copy} size="xs" variant="ghost">
+        <Button aria-label={copyLabel} onClick={copy} size="xs" variant="ghost">
           {copied ? (
             <CheckIcon size={14} strokeWidth={1.5} />
           ) : (

package/src/core/config/pair.ts

@@ -0,0 +1,19 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { atom } from "jotai";
+import { z } from "zod";
+
+export const pairPreviewSchema = z.object({
+  command: z.string(),
+  templates: z.object({
+    prompt: z.string(),
+    file: z.string(),
+    session: z.string(),
+    token_file: z.string(),
+    token: z.string(),
+  }),
+});
+
+export type PairPreviewConfig = z.infer<typeof pairPreviewSchema>;
+
+export const pairPreviewAtom = atom<PairPreviewConfig | undefined>(undefined);

package/src/mount.tsx

@@ -10,6 +10,7 @@ import {
   userConfigAtom,
 } from "@/core/config/config";
 import { KnownQueryParams } from "@/core/constants";
+import { pairPreviewAtom, pairPreviewSchema } from "@/core/config/pair";
 import { getFilenameFromDOM } from "@/core/dom/htmlUtils";
 import { getMarimoCode } from "@/core/meta/globals";
 import {
@@ -208,6 +209,7 @@ const mountOptionsSchema = z.object({
    * marimo config overrides
    */
   configOverrides: passthroughObject,
+  pairPreview: pairPreviewSchema.optional(),
   /**
    * marimo app config
    */
@@ -345,6 +347,7 @@ function initStore(options: unknown) {
   );
   store.set(userConfigAtom, parseUserConfig(parsedOptions.data.config));
   store.set(appConfigAtom, parseAppConfig(parsedOptions.data.appConfig));
+  store.set(pairPreviewAtom, parsedOptions.data.pairPreview);
 
   // Runtime config
   if (parsedOptions.data.runtimeConfig.length > 0) {