Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

fix: specific handling for lazy requests (#7698)

Myles Scolnick850f266868df
diff --git a/frontend/src/components/editor/alerts/connecting-alert.tsx b/frontend/src/components/editor/alerts/connecting-alert.tsx
index 4934a9da39..db7f0e2201 100644
--- a/frontend/src/components/editor/alerts/connecting-alert.tsx
+++ b/frontend/src/components/editor/alerts/connecting-alert.tsx
@@ -2,7 +2,6 @@
import { useAtomValue } from "jotai";
import { LoadingEllipsis } from "@/components/icons/loading-ellipsis";
-import { Spinner } from "@/components/icons/spinner";
import { Button } from "@/components/ui/button";
import { DelayMount } from "@/components/utils/delay-mount";
import {
@@ -15,7 +14,6 @@ import { Tooltip } from "../../ui/tooltip";
import { FloatingAlert } from "./floating-alert";
const SHORT_DELAY_MS = 1000; // 1 second
-const LONG_DELAY_MS = 5000; // 5 seconds
export const ConnectingAlert: React.FC = () => {
const isConnecting = useAtomValue(isConnectingAtom);
@@ -23,23 +21,15 @@ export const ConnectingAlert: React.FC = () => {
if (isConnecting) {
return (
- <>
- <DelayMount milliseconds={SHORT_DELAY_MS}>
- <div className="absolute top-4 m-0 flex items-center min-h-[28px] left-1/2 transform -translate-x-1/2 z-200 ">
- <Tooltip content="Connecting to a marimo runtime">
- <div className="flex items-center">
- <LoadingEllipsis size={5} className="text-yellow-500" />
- </div>
- </Tooltip>
- </div>
- </DelayMount>
- <FloatingAlert show={isConnecting} delayMs={LONG_DELAY_MS}>
- <div className="flex items-center gap-2">
- <Spinner className="h-4 w-4" />
- <p>Connecting to a marimo runtime ...</p>
- </div>
- </FloatingAlert>
- </>
+ <DelayMount milliseconds={SHORT_DELAY_MS}>
+ <div className="absolute top-4 m-0 flex items-center min-h-[28px] left-1/2 transform -translate-x-1/2 z-200 ">
+ <Tooltip content="Connecting to a marimo runtime">
+ <div className="flex items-center">
+ <LoadingEllipsis size={5} className="text-yellow-500" />
+ </div>
+ </Tooltip>
+ </div>
+ </DelayMount>
);
}
diff --git a/frontend/src/components/editor/chrome/wrapper/app-chrome.tsx b/frontend/src/components/editor/chrome/wrapper/app-chrome.tsx
index 92b6ba0d77..0c4a07217c 100644
--- a/frontend/src/components/editor/chrome/wrapper/app-chrome.tsx
+++ b/frontend/src/components/editor/chrome/wrapper/app-chrome.tsx
@@ -17,7 +17,6 @@ import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
import { LazyMount } from "@/components/utils/lazy-mount";
import { cellErrorCount } from "@/core/cells/cells";
import { getFeatureFlag } from "@/core/config/feature-flag";
-import { IfCapability } from "@/core/config/if-capability";
import { cn } from "@/utils/cn";
import { ErrorBoundary } from "../../boundary/ErrorBoundary";
import { ContextAwarePanel } from "../panels/context-aware-panel/context-aware-panel";
@@ -70,7 +69,7 @@ export const AppChrome: React.FC<PropsWithChildren> = ({ children }) => {
setSelectedDeveloperPanelTab,
} = useChromeActions();
const sidebarRef = React.useRef<ImperativePanelHandle>(null);
- const terminalRef = React.useRef<ImperativePanelHandle>(null);
+ const developerPanelRef = React.useRef<ImperativePanelHandle>(null);
const { aiPanelTab, setAiPanelTab } = useAiPanelTab();
const errorCount = useAtomValue(cellErrorCount);
@@ -100,16 +99,16 @@ export const AppChrome: React.FC<PropsWithChildren> = ({ children }) => {
// sync panel
useEffect(() => {
- if (!terminalRef.current) {
+ if (!developerPanelRef.current) {
return;
}
- const isCurrentlyCollapsed = terminalRef.current.isCollapsed();
+ const isCurrentlyCollapsed = developerPanelRef.current.isCollapsed();
if (isDeveloperPanelOpen && isCurrentlyCollapsed) {
- terminalRef.current.expand();
+ developerPanelRef.current.expand();
}
if (!isDeveloperPanelOpen && !isCurrentlyCollapsed) {
- terminalRef.current.collapse();
+ developerPanelRef.current.collapse();
}
// Dispatch a resize event so widgets know to resize
@@ -253,7 +252,7 @@ export const AppChrome: React.FC<PropsWithChildren> = ({ children }) => {
const bottomPanel = (
<Panel
- ref={terminalRef}
+ ref={developerPanelRef}
// This cannot by dynamic and must be constant
// so that the size is preserved between page loads
id="app-chrome-panel"
@@ -272,7 +271,7 @@ export const AppChrome: React.FC<PropsWithChildren> = ({ children }) => {
onResize={(size, prevSize) => {
// This means it started closed and is opening for the first time
if (prevSize === 0 && size === 10) {
- terminalRef.current?.resize(30);
+ developerPanelRef.current?.resize(30);
}
}}
onCollapse={() => setIsDeveloperPanelOpen(false)}
@@ -395,7 +394,7 @@ export const AppChrome: React.FC<PropsWithChildren> = ({ children }) => {
>
<PanelGroup autoSaveId="marimo:chrome:v1:l1" direction="vertical">
{appBodyPanel}
- <IfCapability capability="terminal">{bottomPanel}</IfCapability>
+ {bottomPanel}
</PanelGroup>
</Panel>
<ContextAwarePanel />
diff --git a/frontend/src/components/editor/chrome/wrapper/footer-items/runtime-settings.tsx b/frontend/src/components/editor/chrome/wrapper/footer-items/runtime-settings.tsx
index fa39d7f969..4120288762 100644
--- a/frontend/src/components/editor/chrome/wrapper/footer-items/runtime-settings.tsx
+++ b/frontend/src/components/editor/chrome/wrapper/footer-items/runtime-settings.tsx
@@ -81,149 +81,136 @@ export const RuntimeSettings: React.FC<RuntimeSettingsProps> = ({
(isWasm() || config.runtime.auto_reload !== "autorun");
return (
- <div className={cn("flex items-center", className)}>
- <div className="flex">
- <DropdownMenu>
- <DropdownMenuTrigger asChild={true}>
- <FooterItem
- tooltip="Runtime reactivity"
- selected={false}
- data-testid="footer-runtime-settings"
- >
- <div className="flex items-center gap-1">
- {allReactivityDisabled ? (
- <ZapOffIcon size={16} className="text-muted-foreground" />
- ) : (
- <ZapIcon size={16} className="text-amber-500" />
- )}
- <ChevronDownIcon size={14} />
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild={true}>
+ <FooterItem
+ tooltip="Runtime reactivity"
+ selected={false}
+ data-testid="footer-runtime-settings"
+ >
+ <div className="flex items-center gap-1">
+ {allReactivityDisabled ? (
+ <ZapOffIcon size={16} className="text-muted-foreground" />
+ ) : (
+ <ZapIcon size={16} className="text-amber-500" />
+ )}
+ <ChevronDownIcon size={14} />
+ </div>
+ </FooterItem>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="start" className="w-64">
+ <DropdownMenuLabel>Runtime reactivity</DropdownMenuLabel>
+ <DropdownMenuSeparator />
+
+ {/* On startup toggle */}
+ <DisableIfOverridden name="runtime.auto_instantiate">
+ <div className="flex items-center justify-between px-2 py-2">
+ <div className="flex items-center space-x-2">
+ {config.runtime.auto_instantiate ? (
+ <ZapIcon size={14} className="text-amber-500" />
+ ) : (
+ <ZapOffIcon size={14} className="text-muted-foreground" />
+ )}
+ <div>
+ <div className="text-sm font-medium">On startup</div>
+ <div className="text-xs text-muted-foreground">
+ {config.runtime.auto_instantiate ? "autorun" : "lazy"}
+ </div>
</div>
- </FooterItem>
- </DropdownMenuTrigger>
- <DropdownMenuContent align="start" className="w-64">
- <DropdownMenuLabel>Runtime reactivity</DropdownMenuLabel>
- <DropdownMenuSeparator />
+ </div>
+ <Switch
+ checked={config.runtime.auto_instantiate}
+ onCheckedChange={handleStartupToggle}
+ size="sm"
+ />
+ </div>
+ </DisableIfOverridden>
- {/* On startup toggle */}
- <DisableIfOverridden name="runtime.auto_instantiate">
- <div className="flex items-center justify-between px-2 py-2">
- <div className="flex items-center space-x-2">
- {config.runtime.auto_instantiate ? (
- <ZapIcon size={14} className="text-amber-500" />
- ) : (
- <ZapOffIcon size={14} className="text-muted-foreground" />
- )}
- <div>
- <div className="text-sm font-medium">On startup</div>
- <div className="text-xs text-muted-foreground">
- {config.runtime.auto_instantiate ? "autorun" : "lazy"}
- </div>
- </div>
+ <DropdownMenuSeparator />
+
+ {/* On cell change toggle */}
+ <DisableIfOverridden name="runtime.on_cell_change">
+ <div className="flex items-center justify-between px-2 py-2">
+ <div className="flex items-center space-x-2">
+ {config.runtime.on_cell_change === "autorun" ? (
+ <ZapIcon size={14} className="text-amber-500" />
+ ) : (
+ <ZapOffIcon size={14} className="text-muted-foreground" />
+ )}
+ <div>
+ <div className="text-sm font-medium">On cell change</div>
+ <div className="text-xs text-muted-foreground">
+ {config.runtime.on_cell_change}
</div>
- <Switch
- checked={config.runtime.auto_instantiate}
- onCheckedChange={handleStartupToggle}
- size="sm"
- />
</div>
- </DisableIfOverridden>
+ </div>
+ <Switch
+ checked={config.runtime.on_cell_change === "autorun"}
+ onCheckedChange={handleCellChangeToggle}
+ size="sm"
+ />
+ </div>
+ </DisableIfOverridden>
+ {!isWasm() && (
+ <>
<DropdownMenuSeparator />
- {/* On cell change toggle */}
- <DisableIfOverridden name="runtime.on_cell_change">
- <div className="flex items-center justify-between px-2 py-2">
- <div className="flex items-center space-x-2">
- {config.runtime.on_cell_change === "autorun" ? (
- <ZapIcon size={14} className="text-amber-500" />
- ) : (
+ {/* On module change dropdown */}
+ <DisableIfOverridden name="runtime.auto_reload">
+ <div className="px-2 py-1">
+ <div className="flex items-center space-x-2 mb-2">
+ {config.runtime.auto_reload === "off" && (
+ <PowerOffIcon size={14} className="text-muted-foreground" />
+ )}
+ {config.runtime.auto_reload === "lazy" && (
<ZapOffIcon size={14} className="text-muted-foreground" />
)}
+ {config.runtime.auto_reload === "autorun" && (
+ <ZapIcon size={14} className="text-amber-500" />
+ )}
<div>
- <div className="text-sm font-medium">On cell change</div>
+ <div className="text-sm font-medium">On module change</div>
<div className="text-xs text-muted-foreground">
- {config.runtime.on_cell_change}
+ {config.runtime.auto_reload}
</div>
</div>
</div>
- <Switch
- checked={config.runtime.on_cell_change === "autorun"}
- onCheckedChange={handleCellChangeToggle}
- size="sm"
- />
- </div>
- </DisableIfOverridden>
-
- {!isWasm() && (
- <>
- <DropdownMenuSeparator />
-
- {/* On module change dropdown */}
- <DisableIfOverridden name="runtime.auto_reload">
- <div className="px-2 py-1">
- <div className="flex items-center space-x-2 mb-2">
- {config.runtime.auto_reload === "off" && (
- <PowerOffIcon
- size={14}
- className="text-muted-foreground"
- />
+ <div className="space-y-1">
+ {["off", "lazy", "autorun"].map((option) => (
+ <button
+ key={option}
+ onClick={() =>
+ handleModuleReloadChange(
+ option as "off" | "lazy" | "autorun",
+ )
+ }
+ className={cn(
+ "w-full flex items-center px-2 py-1 text-sm rounded hover:bg-accent",
+ option === config.runtime.auto_reload && "bg-accent",
)}
- {config.runtime.auto_reload === "lazy" && (
- <ZapOffIcon
- size={14}
- className="text-muted-foreground"
- />
+ >
+ {option === "off" && (
+ <PowerOffIcon size={12} className="mr-2" />
)}
- {config.runtime.auto_reload === "autorun" && (
- <ZapIcon size={14} className="text-amber-500" />
+ {option === "lazy" && (
+ <ZapOffIcon size={12} className="mr-2" />
)}
- <div>
- <div className="text-sm font-medium">
- On module change
- </div>
- <div className="text-xs text-muted-foreground">
- {config.runtime.auto_reload}
- </div>
- </div>
- </div>
- <div className="space-y-1">
- {["off", "lazy", "autorun"].map((option) => (
- <button
- key={option}
- onClick={() =>
- handleModuleReloadChange(
- option as "off" | "lazy" | "autorun",
- )
- }
- className={cn(
- "w-full flex items-center px-2 py-1 text-sm rounded hover:bg-accent",
- option === config.runtime.auto_reload &&
- "bg-accent",
- )}
- >
- {option === "off" && (
- <PowerOffIcon size={12} className="mr-2" />
- )}
- {option === "lazy" && (
- <ZapOffIcon size={12} className="mr-2" />
- )}
- {option === "autorun" && (
- <ZapIcon size={12} className="mr-2" />
- )}
- <span className="capitalize">{option}</span>
- {option === config.runtime.auto_reload && (
- <span className="ml-auto">✓</span>
- )}
- </button>
- ))}
- </div>
- </div>
- </DisableIfOverridden>
- </>
- )}
- </DropdownMenuContent>
- </DropdownMenu>
- </div>
- </div>
+ {option === "autorun" && (
+ <ZapIcon size={12} className="mr-2" />
+ )}
+ <span className="capitalize">{option}</span>
+ {option === config.runtime.auto_reload && (
+ <span className="ml-auto">✓</span>
+ )}
+ </button>
+ ))}
+ </div>
+ </div>
+ </DisableIfOverridden>
+ </>
+ )}
+ </DropdownMenuContent>
+ </DropdownMenu>
);
};
diff --git a/frontend/src/components/editor/chrome/wrapper/footer.tsx b/frontend/src/components/editor/chrome/wrapper/footer.tsx
index 565bb4c541..82186c31d6 100644
--- a/frontend/src/components/editor/chrome/wrapper/footer.tsx
+++ b/frontend/src/components/editor/chrome/wrapper/footer.tsx
@@ -6,13 +6,16 @@ import type React from "react";
import { renderShortcut } from "@/components/shortcuts/renderShortcut";
import { Tooltip } from "@/components/ui/tooltip";
import { cellErrorCount } from "@/core/cells/cells";
-import { IfCapability } from "@/core/config/if-capability";
+import { isConnectingAtom } from "@/core/network/connection";
import { useHotkey } from "@/hooks/useHotkey";
import { ShowInKioskMode } from "../../kiosk-mode";
import { useChromeActions, useChromeState } from "../state";
import { FooterItem } from "./footer-item";
import { AIStatusIcon } from "./footer-items/ai-status";
-import { connectionStatusAtom } from "./footer-items/backend-status";
+import {
+ BackendConnectionStatus,
+ connectionStatusAtom,
+} from "./footer-items/backend-status";
import { CopilotStatusIcon } from "./footer-items/copilot-status";
import { MachineStats } from "./footer-items/machine-stats";
import { MinimapStatusIcon } from "./footer-items/minimap-status";
@@ -44,40 +47,36 @@ export const Footer: React.FC = () => {
});
return (
- <footer className="h-10 py-2 bg-background flex items-center text-muted-foreground text-md pl-2 pr-1 border-t border-border select-none no-print text-sm z-50 print:hidden hide-on-fullscreen overflow-x-auto overflow-y-hidden scrollbar-thin">
- <IfCapability capability="terminal">
- <div className="flex items-center">
- <div className="flex">
- <FooterItem
- tooltip={
- <span className="flex items-center gap-2">
- Toggle developer panel{" "}
- {renderShortcut("global.togglePanel", false)}
- </span>
- }
- selected={isDeveloperPanelOpen}
- onClick={() => toggleDeveloperPanel()}
- data-testid="footer-panel"
- >
- <div className="flex items-center gap-1">
- <XCircleIcon
- className={`w-4 h-4 ${issueCount > 0 ? "text-destructive" : ""}`}
- />
- <span>{issueCount}</span>
- <AlertTriangleIcon
- className={`w-4 h-4 ml-1 ${warningCount > 0 ? "text-yellow-500" : ""}`}
- />
- <span>{warningCount}</span>
- </div>
- </FooterItem>
- </div>
+ <footer className="h-10 py-1 gap-1 bg-background flex items-center text-muted-foreground text-md pl-2 pr-1 border-t border-border select-none no-print text-sm z-50 print:hidden hide-on-fullscreen overflow-x-auto overflow-y-hidden scrollbar-thin">
+ <FooterItem
+ className="h-full"
+ tooltip={
+ <span className="flex items-center gap-2">
+ Toggle developer panel {renderShortcut("global.togglePanel", false)}
+ </span>
+ }
+ selected={isDeveloperPanelOpen}
+ onClick={() => toggleDeveloperPanel()}
+ data-testid="footer-panel"
+ >
+ <div className="flex items-center gap-1 h-full">
+ <XCircleIcon
+ className={`w-4 h-4 ${issueCount > 0 ? "text-destructive" : ""}`}
+ />
+ <span>{issueCount}</span>
+ <AlertTriangleIcon
+ className={`w-4 h-4 ml-1 ${warningCount > 0 ? "text-yellow-500" : ""}`}
+ />
+ <span>{warningCount}</span>
</div>
- </IfCapability>
+ </FooterItem>
<RuntimeSettings />
<div className="mx-auto" />
+ <ConnectingKernelIndicatorItem />
+
<ShowInKioskMode>
<Tooltip
content={
@@ -101,3 +100,14 @@ export const Footer: React.FC = () => {
</footer>
);
};
+
+/**
+ * Only show the backend connection status if we are connecting to a kernel
+ */
+const ConnectingKernelIndicatorItem: React.FC = () => {
+ const isConnecting = useAtomValue(isConnectingAtom);
+ if (!isConnecting) {
+ return null;
+ }
+ return <BackendConnectionStatus />;
+};
diff --git a/frontend/src/core/network/__tests__/requests-lazy.test.ts b/frontend/src/core/network/__tests__/requests-lazy.test.ts
index 7b244333bd..3ce5e46c25 100644
--- a/frontend/src/core/network/__tests__/requests-lazy.test.ts
+++ b/frontend/src/core/network/__tests__/requests-lazy.test.ts
@@ -6,9 +6,13 @@ import { createLazyRequests } from "../requests-lazy";
import type { EditRequests, RunRequests } from "../types";
// Mock the connection module
-vi.mock("../connection", () => ({
- waitForConnectionOpen: vi.fn().mockResolvedValue(undefined),
-}));
+vi.mock("../connection", async () => {
+ const { atom } = await import("jotai");
+ return {
+ connectionAtom: atom({ state: "NOT_STARTED" }),
+ waitForConnectionOpen: vi.fn().mockResolvedValue(undefined),
+ };
+});
// Mock the kernel state module
vi.mock("../../kernel/state", () => ({
@@ -30,6 +34,7 @@ describe("createLazyRequests", () => {
// Mock runtime manager
mockRuntimeManager = {
init: mockInit,
+ isLazy: true,
} as unknown as RuntimeManager;
// Mock getter function
@@ -156,121 +161,6 @@ describe("createLazyRequests", () => {
).rejects.toThrow("Request failed");
});
- describe("SKIP_REQUESTS", () => {
- it("should not wait for init or connection for sendRestart", async () => {
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendRestart();
-
- // Should not call init or wait for connection
- expect(mockInit).not.toHaveBeenCalled();
- expect(mockGetRuntimeManager).not.toHaveBeenCalled();
- // Should call the delegate method directly
- expect(mockDelegate.sendRestart).toHaveBeenCalled();
- });
-
- it("should call sendRestart immediately without waiting", async () => {
- const { waitForConnectionOpen } = await import("../connection");
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendRestart();
-
- expect(waitForConnectionOpen).not.toHaveBeenCalled();
- });
- });
-
- describe("WAIT_FOR_INSTANTIATE_REQUESTS", () => {
- it("should wait for kernel instantiation for sendRun", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendRun({ cellIds: ["cell1"], codes: ["code"] });
-
- expect(waitForKernelToBeInstantiated).toHaveBeenCalled();
- });
-
- it("should wait for kernel instantiation for sendDeleteCell", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendDeleteCell({ cellId: "cell1" });
-
- expect(waitForKernelToBeInstantiated).toHaveBeenCalled();
- });
-
- it("should wait for kernel instantiation for sendInterrupt", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendInterrupt();
-
- expect(waitForKernelToBeInstantiated).toHaveBeenCalled();
- });
-
- it("should wait for kernel instantiation for sendPdb", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendPdb({ cellId: "cell1" });
-
- expect(waitForKernelToBeInstantiated).toHaveBeenCalled();
- });
-
- it("should wait for kernel instantiation for sendRunScratchpad", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendRunScratchpad({ code: "print('test')" });
-
- expect(waitForKernelToBeInstantiated).toHaveBeenCalled();
- });
-
- it("should not wait for kernel instantiation for other requests", async () => {
- const { waitForKernelToBeInstantiated } = await import(
- "../../kernel/state"
- );
- const lazyRequests = createLazyRequests(
- mockDelegate,
- mockGetRuntimeManager,
- );
-
- await lazyRequests.sendInstantiate({ objectIds: ["obj1"], values: [] });
-
- expect(waitForKernelToBeInstantiated).not.toHaveBeenCalled();
- });
- });
-
describe("Memoization", () => {
it("should re-initialize if runtime manager changes", async () => {
const lazyRequests = createLazyRequests(
@@ -286,6 +176,7 @@ describe("createLazyRequests", () => {
const mockInit2 = vi.fn().mockResolvedValue(undefined);
const mockRuntimeManager2 = {
init: mockInit2,
+ isLazy: true,
} as unknown as RuntimeManager;
mockGetRuntimeManager = vi.fn(() => mockRuntimeManager2);
diff --git a/frontend/src/core/network/__tests__/requests-network.test.ts b/frontend/src/core/network/__tests__/requests-network.test.ts
new file mode 100644
index 0000000000..9e06398b99
--- /dev/null
+++ b/frontend/src/core/network/__tests__/requests-network.test.ts
@@ -0,0 +1,114 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import * as apiModule from "../api";
+import { visibleForTesting } from "../requests-lazy";
+import { createNetworkRequests } from "../requests-network";
+
+const { ACTIONS } = visibleForTesting;
+
+// Mock dependencies
+vi.mock("../../runtime/config", () => ({
+ getRuntimeManager: vi.fn(() => ({
+ sessionHeaders: vi.fn(() => ({ "X-Test-Header": "test" })),
+ isLazy: true,
+ })),
+}));
+
+vi.mock("../api", async () => {
+ const actual = await vi.importActual<typeof apiModule>("../api");
+ return {
+ ...actual,
+ API: {
+ handleResponse: vi.fn((response) => response.data),
+ handleResponseReturnNull: vi.fn(() => null),
+ },
+ createClientWithRuntimeManager: vi.fn(),
+ };
+});
+
+vi.mock("../connection", () => ({
+ isConnectedAtom: { read: vi.fn(() => true) },
+ waitForConnectionOpen: vi.fn().mockResolvedValue(undefined),
+}));
+
+vi.mock("../../state/jotai", () => ({
+ store: {
+ get: vi.fn(() => true),
+ },
+}));
+
+describe("createNetworkRequests", () => {
+ let mockClient: any;
+ let capturedCalls: Map<string, { hasParams: boolean; endpoint: string }>;
+
+ beforeEach(() => {
+ vi.clearAllMocks();
+ capturedCalls = new Map();
+
+ // Create mock client that captures all calls
+ const createMockMethod = (endpoint: string) => {
+ return vi.fn((_route: string, options?: any) => {
+ const hasParams = options?.params !== undefined;
+ capturedCalls.set(endpoint, { hasParams, endpoint });
+ return Promise.resolve({ data: null, error: undefined });
+ });
+ };
+
+ mockClient = {
+ POST: createMockMethod("POST"),
+ GET: createMockMethod("GET"),
+ };
+
+ // Mock createClientWithRuntimeManager to return our mock client
+ vi.mocked(apiModule.createClientWithRuntimeManager).mockReturnValue(
+ mockClient,
+ );
+ });
+
+ it("all request methods have an action defined", () => {
+ const requests = createNetworkRequests();
+ const methodNames = Object.keys(requests);
+
+ for (const methodName of methodNames) {
+ if (!ACTIONS[methodName as keyof typeof ACTIONS]) {
+ expect.fail(`Method ${methodName} has no action defined`);
+ }
+ }
+ });
+
+ describe("special behavior", () => {
+ it("sendRun should drop requests if not connected", async () => {
+ const { store } = await import("../../state/jotai");
+
+ vi.mocked(store.get).mockReturnValue(false);
+
+ const requests = createNetworkRequests();
+ const result = await requests.sendRun({} as any);
+
+ expect(result).toBe(null);
+ expect(mockClient.POST).not.toHaveBeenCalled();
+ });
+
+ it("exportAsHTML should set assetUrl in dev/test mode", async () => {
+ const originalEnv = process.env.NODE_ENV;
+ process.env.NODE_ENV = "development";
+
+ const requests = createNetworkRequests();
+ await requests.exportAsHTML({} as any);
+
+ expect(mockClient.POST).toHaveBeenCalledWith(
+ "/api/export/html",
+ expect.objectContaining({
+ body: expect.objectContaining({
+ assetUrl: window.location.origin,
+ }),
+ }),
+ );
+
+ process.env.NODE_ENV = originalEnv;
+ });
+ });
+});
diff --git a/frontend/src/core/network/requests-lazy.ts b/frontend/src/core/network/requests-lazy.ts
index e17ee19813..bfcd689759 100644
--- a/frontend/src/core/network/requests-lazy.ts
+++ b/frontend/src/core/network/requests-lazy.ts
@@ -1,79 +1,175 @@
/* Copyright 2024 Marimo. All rights reserved. */
+import { NoKernelConnectedError } from "@/utils/errors";
import { Objects } from "@/utils/objects";
import { memoizeLastValue } from "@/utils/once";
import { waitForKernelToBeInstantiated } from "../kernel/state";
import type { RuntimeManager } from "../runtime/runtime";
-import { waitForConnectionOpen } from "./connection";
+import { store } from "../state/jotai";
+import { WebSocketState } from "../websocket/types";
+import { connectionAtom, waitForConnectionOpen } from "./connection";
import type { EditRequests, RunRequests } from "./types";
type AllRequests = EditRequests & RunRequests;
-const SKIP_REQUESTS = new Set<keyof AllRequests>([
- // These are requests that don't require an active session.
- "sendRestart",
- "getDependencyTree",
- "getPackageList",
- // Homepage requests - called before session exists
- "getRecentFiles",
- "getWorkspaceFiles",
- "getRunningNotebooks",
- "shutdownSession",
- "openTutorial",
- // Local operations that don't need runtime
- "sendFormat",
- // Config operations that work without current session
- "saveUserConfig",
- // This does need an active session, but we don't want to wait for it.
- "sendCodeCompletionRequest",
-]);
-
-const WAIT_FOR_INSTANTIATE_REQUESTS = new Set<keyof AllRequests>([
- "sendDeleteCell",
- "sendInterrupt",
- "sendPdb",
- "sendRun",
- "sendRunScratchpad",
-]);
+// We have various requests that act different when called and not connected to a Kernel. They are:
+// - throw an Error
+// - drop the request
+// - start the connection
+// - wait for the connection to be open
+
+type Action =
+ | "throwError"
+ | "dropRequest"
+ | "startConnection"
+ | "waitForConnectionOpen";
+
+const ACTIONS: Record<keyof AllRequests, Action> = {
+ // These will start a connection if not already connected and then wait until the connection is open
+ sendComponentValues: "startConnection",
+ sendModelValue: "startConnection",
+ sendInstantiate: "startConnection",
+ sendRun: "startConnection",
+ sendDeleteCell: "startConnection",
+ sendRunScratchpad: "startConnection",
+ saveAppConfig: "startConnection",
+ saveCellConfig: "startConnection",
+
+ // Export operations start a connection
+ exportAsHTML: "startConnection",
+ exportAsMarkdown: "startConnection",
+ readCode: "startConnection",
+ sendCopy: "throwError",
+
+ // Throw errors for operations that are not supported offline
+ sendFormat: "throwError",
+ sendRestart: "throwError",
+
+ // These wait until the connection is open, but don't start a connection
+ sendSave: "waitForConnectionOpen",
+ invokeAiTool: "waitForConnectionOpen",
+ sendFunctionRequest: "waitForConnectionOpen",
+
+ // Session-based operations that wait for connection
+ sendRename: "waitForConnectionOpen",
+ autoExportAsHTML: "waitForConnectionOpen",
+ autoExportAsMarkdown: "waitForConnectionOpen",
+ autoExportAsIPYNB: "waitForConnectionOpen",
+
+ // Sidebar operations that wait for connection
+ listSecretKeys: "throwError",
+ writeSecret: "throwError",
+ clearCache: "throwError",
+ getCacheInfo: "throwError",
+
+ // Operations that throw errors (sessionless but not supported offline)
+ saveUserConfig: "throwError",
+ sendShutdown: "throwError",
+ getPackageList: "throwError",
+ getDependencyTree: "throwError",
+ addPackage: "throwError",
+ removePackage: "throwError",
+
+ // Folder and file operations throw errors
+ sendListFiles: "startConnection",
+ sendSearchFiles: "startConnection",
+ sendCreateFileOrFolder: "throwError",
+ sendDeleteFileOrFolder: "throwError",
+ sendRenameFileOrFolder: "throwError",
+ sendUpdateFile: "throwError",
+ sendFileDetails: "throwError",
+ openFile: "throwError",
+
+ // Home operations throw errors
+ getRecentFiles: "startConnection",
+ getWorkspaceFiles: "startConnection",
+ getRunningNotebooks: "startConnection",
+ shutdownSession: "startConnection",
+ openTutorial: "startConnection",
+ getUsageStats: "waitForConnectionOpen",
+
+ // These wait for connection
+ sendStdin: "waitForConnectionOpen",
+ sendInterrupt: "waitForConnectionOpen",
+ sendPdb: "waitForConnectionOpen",
+ sendInstallMissingPackages: "waitForConnectionOpen",
+ readSnippets: "waitForConnectionOpen",
+ previewDatasetColumn: "waitForConnectionOpen",
+ previewSQLTable: "waitForConnectionOpen",
+ previewSQLTableList: "waitForConnectionOpen",
+ previewDataSourceConnection: "waitForConnectionOpen",
+ validateSQL: "waitForConnectionOpen",
+
+ // Sync operations that wait for connection
+ syncCellIds: "waitForConnectionOpen",
+ sendCodeCompletionRequest: "waitForConnectionOpen",
+};
/**
* Create a lazy requests client.
* On any request, we will initialize the runtime manager (if not already initialized)
- * and wait for the connection to be open.
+ * and handle it based on the action type defined in ACTIONS.
*/
export function createLazyRequests(
delegate: AllRequests,
getRuntimeManager: () => RuntimeManager,
): AllRequests {
// Memoize the init call, just once per runtime manager
- const initOnce = memoizeLastValue((runtimeManager: RuntimeManager) => {
- return runtimeManager.init();
+ const initOnce = memoizeLastValue(async (runtimeManager: RuntimeManager) => {
+ store.set(connectionAtom, { state: WebSocketState.CONNECTING });
+ await runtimeManager.init();
});
// eslint-disable-next-line @typescript-eslint/no-explicit-any
- function connectAndThen<T extends (...args: any[]) => Promise<any>>(
+ function wrapRequest<T extends (...args: any[]) => Promise<any>>(
request: T,
key: keyof AllRequests,
): T {
+ const action = ACTIONS[key];
+
const wrapped = (async (...args) => {
- // Call init, just once per runtime manager
- // This needs to be a getter because the runtime manager is created lazily.
- await initOnce(getRuntimeManager());
- // Wait for connection to be open
- await waitForConnectionOpen();
- if (WAIT_FOR_INSTANTIATE_REQUESTS.has(key)) {
- await waitForKernelToBeInstantiated();
+ const runtimeManager = getRuntimeManager();
+
+ if (!runtimeManager.isLazy) {
+ return request(...args);
+ }
+
+ switch (action) {
+ case "dropRequest":
+ // Silently drop the request
+ return Promise.resolve();
+
+ case "throwError":
+ throw new NoKernelConnectedError();
+
+ case "waitForConnectionOpen":
+ // Wait for connection but don't start it
+ await waitForConnectionOpen();
+ await waitForKernelToBeInstantiated();
+ return request(...args);
+
+ case "startConnection":
+ // Start connection and wait for it to be open
+ await initOnce(runtimeManager);
+ await waitForConnectionOpen();
+ if (key !== "sendInstantiate") {
+ await waitForKernelToBeInstantiated();
+ }
+ return request(...args);
+
+ default:
+ // This should never happen if ACTIONS is complete
+ throw new Error(`Unknown action for "${key}"`);
}
- // Call the request
- return request(...args);
}) as T;
return wrapped;
}
return Objects.mapValues(delegate, (value, key) => {
- if (SKIP_REQUESTS.has(key)) {
- return value;
- }
- return connectAndThen(value, key);
+ return wrapRequest(value, key);
}) as AllRequests;
}
+
+export const visibleForTesting = {
+ ACTIONS,
+};
diff --git a/frontend/src/core/network/requests-network.ts b/frontend/src/core/network/requests-network.ts
index 4dce6942dd..9fdfb27cde 100644
--- a/frontend/src/core/network/requests-network.ts
+++ b/frontend/src/core/network/requests-network.ts
@@ -15,11 +15,23 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return createClientWithRuntimeManager(runtimeManager);
});
+ const getHeaders = () => {
+ const runtimeManager = getRuntimeManager();
+ return runtimeManager.sessionHeaders();
+ };
+
+ const getParams = () => {
+ return {
+ header: getHeaders(),
+ };
+ };
+
return {
sendComponentValues: (request) => {
return getClient()
.POST("/api/kernel/set_ui_element_value", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -27,12 +39,15 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/set_model_value", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
sendRestart: () => {
return getClient()
- .POST("/api/kernel/restart_session")
+ .POST("/api/kernel/restart_session", {
+ params: getParams(),
+ })
.then(handleResponseReturnNull);
},
syncCellIds: async (request) => {
@@ -40,6 +55,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/sync/cell_ids", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -47,6 +63,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/rename", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -55,6 +72,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
.POST("/api/kernel/save", {
body: request,
parseAs: "text",
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -63,6 +81,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
.POST("/api/kernel/copy", {
body: request,
parseAs: "text",
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -75,7 +94,9 @@ export function createNetworkRequests(): EditRequests & RunRequests {
},
sendInterrupt: () => {
return getClient()
- .POST("/api/kernel/interrupt")
+ .POST("/api/kernel/interrupt", {
+ params: getParams(),
+ })
.then(handleResponseReturnNull);
},
sendShutdown: () => {
@@ -92,6 +113,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/run", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -100,6 +122,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/scratchpad/run", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -108,6 +131,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/instantiate", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -115,6 +139,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/delete", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -123,6 +148,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/code_autocomplete", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -138,6 +164,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
.POST("/api/kernel/save_app_config", {
body: request,
parseAs: "text",
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -145,6 +172,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/set_cell_config", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -152,6 +180,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/function_call", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -159,6 +188,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/stdin", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -166,23 +196,31 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/install_missing_packages", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
readCode: async () => {
await waitForConnectionOpen();
- return getClient().POST("/api/kernel/read_code").then(handleResponse);
+ return getClient()
+ .POST("/api/kernel/read_code", {
+ params: getParams(),
+ })
+ .then(handleResponse);
},
readSnippets: async () => {
await waitForConnectionOpen();
return getClient()
- .GET("/api/documentation/snippets")
+ .GET("/api/documentation/snippets", {
+ params: getParams(),
+ })
.then(handleResponse);
},
previewDatasetColumn: (request) => {
return getClient()
.POST("/api/datasources/preview_column", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -190,6 +228,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/datasources/preview_sql_table", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -197,6 +236,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/datasources/preview_sql_table_list", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -204,6 +244,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/datasources/preview_datasource_connection", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -211,6 +252,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/sql/validate", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -231,6 +273,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/kernel/pdb/pm", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -330,6 +373,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
.POST("/api/export/html", {
body: request,
parseAs: "text",
+ params: getParams(),
})
.then(handleResponse);
},
@@ -338,6 +382,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
.POST("/api/export/markdown", {
body: request,
parseAs: "text",
+ params: getParams(),
})
.then(handleResponse);
},
@@ -345,6 +390,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/export/auto_export/html", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -352,6 +398,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/export/auto_export/markdown", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -359,6 +406,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/export/auto_export/ipynb", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -392,6 +440,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/secrets/keys", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -399,6 +448,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/secrets/create", {
body: request,
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -406,6 +456,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/ai/invoke_tool", {
body: request,
+ params: getParams(),
})
.then(handleResponse);
},
@@ -413,6 +464,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/cache/clear", {
body: {},
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
@@ -420,6 +472,7 @@ export function createNetworkRequests(): EditRequests & RunRequests {
return getClient()
.POST("/api/cache/info", {
body: {},
+ params: getParams(),
})
.then(handleResponseReturnNull);
},
diff --git a/frontend/src/core/network/requests-toasting.ts b/frontend/src/core/network/requests-toasting.tsx
similarity index 70%
rename from frontend/src/core/network/requests-toasting.ts
rename to frontend/src/core/network/requests-toasting.tsx
index f55bab875b..748126fbd9 100644
--- a/frontend/src/core/network/requests-toasting.ts
+++ b/frontend/src/core/network/requests-toasting.tsx
@@ -1,8 +1,15 @@
/* Copyright 2026 Marimo. All rights reserved. */
/* eslint-disable @typescript-eslint/no-explicit-any */
+
+import { useAtomValue } from "jotai";
+import { Spinner } from "@/components/icons/spinner";
+import { Button } from "@/components/ui/button";
import { toast } from "@/components/ui/use-toast";
-import { prettyError } from "@/utils/errors";
+import { NoKernelConnectedError, prettyError } from "@/utils/errors";
import { Logger } from "@/utils/Logger";
+import { useConnectToRuntime } from "../runtime/config";
+import { store } from "../state/jotai";
+import { isConnectingAtom } from "./connection";
import type { EditRequests, RequestKey, RunRequests } from "./types";
export function createErrorToastingRequests(
@@ -75,6 +82,26 @@ export function createErrorToastingRequests(
try {
return await handler(...args);
} catch (error) {
+ // Special handling for NoKernelConnectedError error
+ if (error instanceof NoKernelConnectedError) {
+ // If we are connecting to a kernel, don't show the toast
+ const isConnecting = store.get(isConnectingAtom);
+ if (isConnecting) {
+ return;
+ }
+
+ const toastId = toast({
+ title: "Kernel Not Connected",
+ description:
+ "You need to connect to a kernel to perform this action.",
+ variant: "default",
+ action: <ConnectButton onConnect={() => toastId.dismiss()} />,
+ });
+ Logger.error(`Failed to handle request: ${key}`, error);
+ // Rethrow the error so that the caller can handle it
+ throw error;
+ }
+
const title = MESSAGES[keyString];
const message = prettyError(error);
if (title) {
@@ -93,3 +120,25 @@ export function createErrorToastingRequests(
return handlers;
}
+
+export const ConnectButton: React.FC<{ onConnect: () => void }> = ({
+ onConnect,
+}) => {
+ const connectToRuntime = useConnectToRuntime();
+ const isConnecting = useAtomValue(isConnectingAtom);
+ return (
+ <Button
+ size="xs"
+ onClick={() => {
+ connectToRuntime();
+ setTimeout(() => {
+ onConnect();
+ }, 800);
+ }}
+ disabled={isConnecting}
+ >
+ {isConnecting && <Spinner size="small" className="mr-1" />}
+ Connect
+ </Button>
+ );
+};
diff --git a/frontend/src/core/runtime/runtime.ts b/frontend/src/core/runtime/runtime.ts
index d045b8cd67..0c37b6881c 100644
--- a/frontend/src/core/runtime/runtime.ts
+++ b/frontend/src/core/runtime/runtime.ts
@@ -30,6 +30,10 @@ export class RuntimeManager {
}
}
+ get isLazy(): boolean {
+ return this.lazy;
+ }
+
get httpURL(): URL {
return new URL(this.config.url);
}
@@ -250,8 +254,8 @@ export class RuntimeManager {
return this.initialHealthyCheck.promise;
}
- headers(): Record<string, string> {
- const headers: Record<string, string> = {
+ headers(): KnownHeaders {
+ const headers: KnownHeaders = {
"Marimo-Session-Id": getSessionId(),
"Marimo-Server-Token": this.config.serverToken ?? "",
// Needed for widgets that need absolute URLs when embedding in an iframe
@@ -266,6 +270,19 @@ export class RuntimeManager {
return headers;
}
+
+ sessionHeaders(): Pick<KnownHeaders, "Marimo-Session-Id"> {
+ return {
+ "Marimo-Session-Id": getSessionId(),
+ };
+ }
+}
+
+interface KnownHeaders {
+ "Marimo-Session-Id": SessionId;
+ "Marimo-Server-Token": string;
+ "x-runtime-url": string;
+ [key: string]: string;
}
function asWsUrl(url: string): URL {
diff --git a/frontend/src/core/runtime/types.ts b/frontend/src/core/runtime/types.ts
index 30ea9d4ff0..8d8e6ddf44 100644
--- a/frontend/src/core/runtime/types.ts
+++ b/frontend/src/core/runtime/types.ts
@@ -9,13 +9,13 @@ export interface RuntimeConfig {
* If true, the runtime will not be loaded until the user interacts with the notebook.
* If false, the runtime will be loaded immediately.
*/
- lazy: boolean;
+ readonly lazy: boolean;
/**
* The server token for the runtime (Skew protection token)
*/
- serverToken?: string;
+ readonly serverToken?: string;
/**
* The API key or JWT token for the remote backend (used for authentication)
*/
- authToken?: string | null;
+ readonly authToken?: string | null;
}
diff --git a/frontend/src/utils/errors.ts b/frontend/src/utils/errors.ts
index 1268c4a3ef..8ef7b4512e 100644
--- a/frontend/src/utils/errors.ts
+++ b/frontend/src/utils/errors.ts
@@ -70,3 +70,10 @@ export class CellNotInitializedError extends Error {
this.name = "CellNotInitializedError";
}
}
+
+export class NoKernelConnectedError extends Error {
+ constructor(message = "Not yet connected to a kernel.") {
+ super(message);
+ this.name = "NoKernelConnectedError";
+ }
+}
diff --git a/marimo/_server/api/endpoints/ai.py b/marimo/_server/api/endpoints/ai.py
index 9d4409fbca..a60a92d706 100644
--- a/marimo/_server/api/endpoints/ai.py
+++ b/marimo/_server/api/endpoints/ai.py
@@ -117,6 +117,12 @@ async def ai_completion(
request: Request,
) -> StreamingResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
description: The request body for AI completion
required: true
@@ -234,6 +240,12 @@ async def ai_chat(
request: Request,
) -> StreamingResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
description: The request body for AI chat
required: true
@@ -311,6 +323,12 @@ async def ai_inline_completion(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
description: The request body for AI inline completion
required: true
@@ -389,6 +407,12 @@ async def invoke_tool(
request: Request,
) -> Response:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
description: The request body for tool invocation
required: true
@@ -535,6 +559,12 @@ async def mcp_refresh(
request: Request,
) -> Response:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Refresh MCP server configuration
diff --git a/marimo/_server/api/endpoints/cache.py b/marimo/_server/api/endpoints/cache.py
index 9639670dbf..8bb9ede850 100644
--- a/marimo/_server/api/endpoints/cache.py
+++ b/marimo/_server/api/endpoints/cache.py
@@ -21,6 +21,12 @@ router = APIRouter()
@requires("edit")
async def clear_cache(request: Request) -> SuccessResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -41,6 +47,12 @@ async def clear_cache(request: Request) -> SuccessResponse:
@requires("edit")
async def get_cache_info(request: Request) -> SuccessResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/config.py b/marimo/_server/api/endpoints/config.py
index fbfadb6fbc..ec846d1d25 100644
--- a/marimo/_server/api/endpoints/config.py
+++ b/marimo/_server/api/endpoints/config.py
@@ -41,6 +41,12 @@ async def save_user_config(
request: Request,
) -> JSONResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: false
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/datasources.py b/marimo/_server/api/endpoints/datasources.py
index 66f0c3faff..b781896d97 100644
--- a/marimo/_server/api/endpoints/datasources.py
+++ b/marimo/_server/api/endpoints/datasources.py
@@ -31,6 +31,12 @@ async def preview_column(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -51,6 +57,12 @@ async def preview_column(
@requires("edit")
async def preview_sql_table(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -71,6 +83,12 @@ async def preview_sql_table(request: Request) -> BaseResponse:
@requires("edit")
async def preview_sql_table_list(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -91,6 +109,12 @@ async def preview_sql_table_list(request: Request) -> BaseResponse:
@requires("edit")
async def preview_datasource_connection(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/documentation.py b/marimo/_server/api/endpoints/documentation.py
index c18da9630f..43062e92d6 100644
--- a/marimo/_server/api/endpoints/documentation.py
+++ b/marimo/_server/api/endpoints/documentation.py
@@ -29,6 +29,12 @@ async def load_snippets(
request: Request,
) -> Snippets:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Load the snippets for the documentation page
diff --git a/marimo/_server/api/endpoints/editing.py b/marimo/_server/api/endpoints/editing.py
index 787e144c4f..89cd139b77 100644
--- a/marimo/_server/api/endpoints/editing.py
+++ b/marimo/_server/api/endpoints/editing.py
@@ -35,6 +35,12 @@ router = APIRouter()
@requires("edit")
async def code_complete(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -55,6 +61,12 @@ async def code_complete(request: Request) -> BaseResponse:
@requires("edit")
async def delete_cell(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -75,6 +87,12 @@ async def delete_cell(request: Request) -> BaseResponse:
@requires("edit")
async def sync_cell_ids(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -125,6 +143,12 @@ async def format_cell(request: Request) -> FormatResponse:
@requires("edit")
async def set_cell_config(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -145,6 +169,12 @@ async def set_cell_config(request: Request) -> BaseResponse:
@requires("edit")
async def stdin(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -169,6 +199,12 @@ async def stdin(request: Request) -> BaseResponse:
@requires("edit")
async def install_missing_packages(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/execution.py b/marimo/_server/api/endpoints/execution.py
index 41d53bf746..ff6248b7a5 100644
--- a/marimo/_server/api/endpoints/execution.py
+++ b/marimo/_server/api/endpoints/execution.py
@@ -48,6 +48,12 @@ async def set_ui_element_values(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -82,6 +88,12 @@ async def set_model_values(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -105,6 +117,12 @@ async def instantiate(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -135,6 +153,12 @@ async def function_call(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -158,6 +182,12 @@ async def interrupt(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Interrupt the kernel's execution
@@ -179,6 +209,12 @@ async def run_cell(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -210,6 +246,12 @@ async def run_scratchpad(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -233,6 +275,12 @@ async def run_post_mortem(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -256,6 +304,12 @@ async def restart_session(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Restart the current session without affecting other sessions.
@@ -294,6 +348,12 @@ async def shutdown(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: false
responses:
200:
description: Shutdown the kernel
@@ -339,6 +399,12 @@ async def takeover_endpoint(
request: Request,
) -> JSONResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Successfully closed existing sessions
diff --git a/marimo/_server/api/endpoints/export.py b/marimo/_server/api/endpoints/export.py
index edf549e6f1..4daa402a93 100644
--- a/marimo/_server/api/endpoints/export.py
+++ b/marimo/_server/api/endpoints/export.py
@@ -44,6 +44,12 @@ async def export_as_html(
request: Request,
) -> HTMLResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -101,6 +107,12 @@ async def auto_export_as_html(
request: Request,
) -> JSONResponse | PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -169,6 +181,12 @@ async def export_as_script(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -212,6 +230,12 @@ async def export_as_markdown(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -265,6 +289,12 @@ async def auto_export_as_markdown(
request: Request,
) -> JSONResponse | PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -323,6 +353,12 @@ async def auto_export_as_ipynb(
request: Request,
) -> JSONResponse | PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/files.py b/marimo/_server/api/endpoints/files.py
index 335c5f7275..c9044a026c 100644
--- a/marimo/_server/api/endpoints/files.py
+++ b/marimo/_server/api/endpoints/files.py
@@ -41,6 +41,12 @@ async def read_code(
request: Request,
) -> ReadCodeResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
responses:
200:
description: Read the code from the server
@@ -82,6 +88,12 @@ async def rename_file(
request: Request,
) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -119,6 +131,12 @@ async def save(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -147,6 +165,12 @@ async def copy(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
@@ -175,6 +199,12 @@ async def save_app_config(
request: Request,
) -> PlainTextResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/marimo/_server/api/endpoints/secrets.py b/marimo/_server/api/endpoints/secrets.py
index 2f2fced33d..53109bf20a 100644
--- a/marimo/_server/api/endpoints/secrets.py
+++ b/marimo/_server/api/endpoints/secrets.py
@@ -33,6 +33,12 @@ router = APIRouter()
@requires("edit")
async def list_keys(request: Request) -> SuccessResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
required: true
content:
@@ -54,6 +60,12 @@ async def list_keys(request: Request) -> SuccessResponse:
@requires("edit")
async def create_secret(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
required: true
content:
diff --git a/marimo/_server/api/endpoints/sql.py b/marimo/_server/api/endpoints/sql.py
index 3c40b1410b..a28aa9cf19 100644
--- a/marimo/_server/api/endpoints/sql.py
+++ b/marimo/_server/api/endpoints/sql.py
@@ -20,6 +20,12 @@ router = APIRouter()
@requires("edit")
async def validate_sql(request: Request) -> BaseResponse:
"""
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ schema:
+ type: string
+ required: true
requestBody:
content:
application/json:
diff --git a/packages/openapi/api.yaml b/packages/openapi/api.yaml
index 3754bde4fe..e1496344ff 100644
--- a/packages/openapi/api.yaml
+++ b/packages/openapi/api.yaml
@@ -4417,6 +4417,12 @@ paths:
description: Invalid byte length in virtual file request
/api/ai/chat:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4426,6 +4432,12 @@ paths:
required: true
/api/ai/completion:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4443,6 +4455,12 @@ paths:
description: Get AI completion for a prompt
/api/ai/inline_completion:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4459,6 +4477,12 @@ paths:
description: Get AI inline completion for code
/api/ai/invoke_tool:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4475,6 +4499,12 @@ paths:
description: Tool invocation result
/api/ai/mcp/refresh:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -4493,6 +4523,12 @@ paths:
description: Get MCP server status
/api/cache/clear:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4507,6 +4543,12 @@ paths:
description: Clear all caches
/api/cache/info:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4521,6 +4563,12 @@ paths:
description: Get cache statistics
/api/datasources/preview_column:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4535,6 +4583,12 @@ paths:
description: Preview a column in a dataset
/api/datasources/preview_datasource_connection:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4549,6 +4603,12 @@ paths:
description: Broadcasts a datasource connection
/api/datasources/preview_sql_table:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4563,6 +4623,12 @@ paths:
description: Preview a SQL table
/api/datasources/preview_sql_table_list:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4577,6 +4643,12 @@ paths:
description: Preview a list of tables in an SQL schema
/api/documentation/snippets:
get:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -4586,6 +4658,12 @@ paths:
description: Load the snippets for the documentation page
/api/export/auto_export/html:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4602,6 +4680,12 @@ paths:
description: File must be saved before downloading
/api/export/auto_export/ipynb:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4618,6 +4702,12 @@ paths:
description: File must be saved before downloading
/api/export/auto_export/markdown:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4634,6 +4724,12 @@ paths:
description: File must be saved before downloading
/api/export/html:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4650,6 +4746,12 @@ paths:
description: File must be saved before downloading
/api/export/markdown:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4666,6 +4768,12 @@ paths:
description: File must be saved before downloading
/api/export/script:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4854,6 +4962,12 @@ paths:
description: Get the files in the workspace
/api/kernel/code_autocomplete:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4868,6 +4982,12 @@ paths:
description: Complete a code fragment
/api/kernel/copy:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4882,6 +5002,12 @@ paths:
description: Copy notebook
/api/kernel/delete:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4910,6 +5036,12 @@ paths:
description: Format code
/api/kernel/function_call:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4924,6 +5056,12 @@ paths:
description: Invoke an RPC
/api/kernel/install_missing_packages:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4938,6 +5076,12 @@ paths:
description: Install missing packages
/api/kernel/instantiate:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4953,6 +5097,12 @@ paths:
mode, instantiation happens server-side automatically.
/api/kernel/interrupt:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -4962,6 +5112,12 @@ paths:
description: Interrupt the kernel's execution
/api/kernel/pdb/pm:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -4976,6 +5132,12 @@ paths:
description: Run a post mortem on the most recent failed cell.
/api/kernel/read_code:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -4989,6 +5151,12 @@ paths:
description: Code is not available in run mode
/api/kernel/rename:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5003,6 +5171,12 @@ paths:
description: Rename the current app
/api/kernel/restart_session:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -5012,6 +5186,12 @@ paths:
description: Restart the current session without affecting other sessions.
/api/kernel/run:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5027,6 +5207,12 @@ paths:
new cells for unseen cell IDs. Only allowed in edit mode.
/api/kernel/save:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5041,6 +5227,12 @@ paths:
description: Save the current app
/api/kernel/save_app_config:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5055,6 +5247,12 @@ paths:
description: Save the app configuration
/api/kernel/save_user_config:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: false
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5070,6 +5268,12 @@ paths:
in edit mode.
/api/kernel/scratchpad/run:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5084,6 +5288,12 @@ paths:
description: Run the scratchpad
/api/kernel/set_cell_config:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5098,6 +5308,12 @@ paths:
description: Set the configuration of a cell
/api/kernel/set_model_value:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5112,6 +5328,12 @@ paths:
description: Set model value
/api/kernel/set_ui_element_value:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5126,6 +5348,12 @@ paths:
description: Set UI element values
/api/kernel/shutdown:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: false
+ schema:
+ type: string
responses:
200:
content:
@@ -5135,6 +5363,12 @@ paths:
description: Shutdown the kernel
/api/kernel/stdin:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5149,6 +5383,12 @@ paths:
description: Send input to the stdin stream
/api/kernel/sync/cell_ids:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5163,6 +5403,12 @@ paths:
description: Sync cell ids
/api/kernel/takeover:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
responses:
200:
content:
@@ -5221,6 +5467,12 @@ paths:
description: List dependency tree
/api/secrets/create:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5245,6 +5497,12 @@ paths:
description: Delete a secret
/api/secrets/keys:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
@@ -5260,6 +5518,12 @@ paths:
description: List all secret keys
/api/sql/validate:
post:
+ parameters:
+ - in: header
+ name: Marimo-Session-Id
+ required: true
+ schema:
+ type: string
requestBody:
content:
application/json:
diff --git a/packages/openapi/src/api.ts b/packages/openapi/src/api.ts
index e7b91a78d9..826ab6bc6b 100644
--- a/packages/openapi/src/api.ts
+++ b/packages/openapi/src/api.ts
@@ -61,7 +61,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -91,7 +93,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -133,7 +137,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -173,7 +179,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -213,7 +221,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -283,7 +293,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -322,7 +334,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -361,7 +375,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -400,7 +416,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -439,7 +457,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -478,7 +498,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -515,7 +537,9 @@ export interface paths {
get: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -552,7 +576,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -598,7 +624,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -644,7 +672,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -690,7 +720,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -736,7 +768,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -782,7 +816,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1327,7 +1363,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1366,7 +1404,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1405,7 +1445,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1483,7 +1525,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1522,7 +1566,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1561,7 +1607,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1600,7 +1648,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1635,7 +1685,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1674,7 +1726,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1723,7 +1777,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1762,7 +1818,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1797,7 +1855,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1836,7 +1896,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1875,7 +1937,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1914,7 +1978,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header?: {
+ "Marimo-Session-Id"?: string;
+ };
path?: never;
cookie?: never;
};
@@ -1953,7 +2019,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -1992,7 +2060,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2031,7 +2101,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2070,7 +2142,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2109,7 +2183,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header?: {
+ "Marimo-Session-Id"?: string;
+ };
path?: never;
cookie?: never;
};
@@ -2144,7 +2220,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2183,7 +2261,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2222,7 +2302,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2407,7 +2489,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2481,7 +2565,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};
@@ -2520,7 +2606,9 @@ export interface paths {
post: {
parameters: {
query?: never;
- header?: never;
+ header: {
+ "Marimo-Session-Id": string;
+ };
path?: never;
cookie?: never;
};