Execute Python code with a PERSISTENT namespace.

Variables you assign are STORED and available in subsequent calls. Access them DIRECTLY by name (e.g. my_data, df).

The result variable is ONLY for returning output to the caller. It does NOT persist between calls — use named variables instead.

Correct workflow::

Call 1: data = load_csv("input.csv"); result = f"loaded {len(data)} rows"
Call 2: filtered = [r for r in data if r["active"]]; result = len(filtered)

Returns: JSON with execution result, new/modified variables, and namespace summary.

Execute a Python file inside the persistent session.

Variables defined in the file become available for later use.

Args: params: File path, optional session ID, and optional CLI args.

Returns: JSON with execution result, file metadata, and namespace summary.

Install a Python package using pip (or uv if available).

The package becomes importable in all sessions immediately.

Args: params: Package specifier (e.g. pandas, requests>=2.31).

Returns: JSON with installation status and output.

List all variables stored in a session's namespace.

Returns: JSON with variable names, types, and preview values.

Retrieve the full value of a variable from a session.

Returns: JSON with the variable name, type, and serialized value.

Set a variable in a session from a JSON string.

Useful for injecting data from external sources.

Returns: Confirmation with variable type and preview.

Delete a specific variable from a session's namespace.

Returns: Confirmation with remaining variables.

Clear ALL variables from a session. Cannot be undone.

Returns: Confirmation with list of cleared variables.

List all active REPL sessions.

Returns: JSON array of sessions with IDs, timestamps, and variable counts.

Delete a session and all its data.

Returns: Confirmation message.

Get the last N execution records for a session.

Useful for debugging what happened in previous calls.

Returns: JSON array of execution records.

Get current server status and configuration.

Returns: JSON with Python version, session count, configuration, and limits.