chore: deploy AGILAB release Space (2026-10-11T07:35:14Z) (part 4)

src/agilab/lib/agi-app-data-quality-gate/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-data-quality-gate"
 description = "AGILAB deterministic data contract, drift, leakage, and promotion gate"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-flight-telemetry/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-flight-telemetry"
 description = "AGILAB flight-telemetry ingestion demo with reusable dataframe and map-analysis outputs"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-learning-assessment/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.07"
+version = "2026.10.10.1"
 name = "agi-app-learning-assessment"
 description = "AGILAB learning and assessment workflow with evidence scoring and regression-plan artifacts"
 requires-python = ">=3.13"

src/agilab/lib/agi-app-minimal/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-minimal"
 description = "Built-in AGILAB minimal Polars manager and worker example"
 requires-python = ">=3.12"
@@ -29,7 +29,7 @@ keywords = [
     "workflow-orchestration",
 ]
 
-dependencies = ["agi-env>=2026.10.04,<2027.0", "agi-node>=2026.10.04,<2027.0", "agi-web>=2026.10.04,<2027.0"]
+dependencies = ["agi-env>=2026.10.04,<2027.0", "agi-node>=2026.10.04,<2027.0", "agi-web>=2026.10.10.1,<2027.0"]
 
 [project.urls]
 Documentation = "https://thalesgroup.github.io/agilab"

src/agilab/lib/agi-app-mission-decision/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-mission-decision"
 description = "Deterministic AGILAB mission-decision workflow with scenario scoring and evidence artifacts"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-multi-dag/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-multi-dag"
 description = "AGILAB cross-app DAG preview showing artifact handoffs between demo projects"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-pandas-execution/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-pandas-execution"
 description = "AGILAB Pandas execution benchmark for deterministic worker and reducer validation"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-polars-execution/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-polars-execution"
 description = "AGILAB Polars execution benchmark for deterministic worker and reducer validation"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-pytorch-playground/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-pytorch-playground"
 description = "AGILAB PyTorch playground app for reproducible neural-network experiments"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-r-runtime-bridge/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-r-runtime-bridge"
 description = "Built-in AGILAB Rscript JSON and artifact stage bridge"
 requires-python = ">=3.12"
@@ -29,7 +29,7 @@ keywords = [
     "workflow-orchestration",
 ]
 
-dependencies = ["agi-env>=2026.10.04,<2027.0", "agi-node>=2026.10.04,<2027.0", "agi-web>=2026.10.04,<2027.0"]
+dependencies = ["agi-env>=2026.10.04,<2027.0", "agi-node>=2026.10.04,<2027.0", "agi-web>=2026.10.10.1,<2027.0"]
 
 [project.urls]
 Documentation = "https://thalesgroup.github.io/agilab"

src/agilab/lib/agi-app-sklearn-pipeline/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-sklearn-pipeline"
 description = "AGILAB scikit-learn pipeline app with model, metrics, predictions, and evidence manifest"
 requires-python = ">=3.12"

src/agilab/lib/agi-app-uav-queue/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-uav-queue"
 description = "AGILAB UAV queue simulation demo with scenario evidence and network-map artifacts"
 requires-python = ">=3.13"

src/agilab/lib/agi-app-uav-relay-queue/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-uav-relay-queue"
 description = "AGILAB UAV relay queue simulation demo with routing, delay, and resilience artifacts"
 requires-python = ">=3.13"

src/agilab/lib/agi-app-weather-forecast/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.04"
+version = "2026.10.10.1"
 name = "agi-app-weather-forecast"
 description = "AGILAB weather-forecast notebook-migration demo with forecast analysis artifacts"
 requires-python = ">=3.12"

src/agilab/lib/agi-apps/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.07"
+version = "2026.10.10.1"
 name = "agi-apps"
 description = "AGILAB public app package umbrella and example assets"
 requires-python = ">=3.12"
@@ -31,7 +31,7 @@ keywords = [
     "workflow-orchestration",
 ]
 
-dependencies = ["agi-core==2026.10.05", "agi-app-mission-decision==2026.10.04", "agi-app-pandas-execution==2026.10.04", "agi-app-polars-execution==2026.10.04", "agi-app-flight-telemetry==2026.10.04", "agi-app-multi-dag==2026.10.04", "agi-app-weather-forecast==2026.10.04", "agi-app-sklearn-pipeline==2026.10.04", "agi-app-data-quality-gate==2026.10.04", "agi-app-pytorch-playground==2026.10.04; python_version >= '3.12'", "agi-app-learning-assessment==2026.10.07; python_version >= '3.13'", "agi-app-uav-relay-queue==2026.10.04; python_version >= '3.13'"]
+dependencies = ["agi-core==2026.10.10.1", "agi-app-mission-decision==2026.10.10.1", "agi-app-pandas-execution==2026.10.10.1", "agi-app-polars-execution==2026.10.10.1", "agi-app-flight-telemetry==2026.10.10.1", "agi-app-multi-dag==2026.10.10.1", "agi-app-weather-forecast==2026.10.10.1", "agi-app-sklearn-pipeline==2026.10.10.1", "agi-app-data-quality-gate==2026.10.10.1", "agi-app-pytorch-playground==2026.10.10.1; python_version >= '3.12'", "agi-app-learning-assessment==2026.10.10.1; python_version >= '3.13'", "agi-app-uav-relay-queue==2026.10.10.1; python_version >= '3.13'"]
 
 [project.urls]
 Documentation = "https://thalesgroup.github.io/agilab"

src/agilab/lib/agi-gui/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.08"
+version = "2026.10.10.1"
 name = "agi-gui"
 description = "AGILAB native React UI dependency bundle and Python view helpers"
 requires-python = ">=3.12"
@@ -31,7 +31,7 @@ keywords = [
     "python",
 ]
 
-dependencies = ["agi-env==2026.10.04", "agi-web==2026.10.08", "starlette>=1.0.1,<2", "watchdog>=6,<7"]
+dependencies = ["agi-env==2026.10.04", "agi-web==2026.10.10.1", "starlette>=1.0.1,<2", "watchdog>=6,<7"]
 
 [project.urls]
 Documentation = "https://thalesgroup.github.io/agilab"

src/agilab/lib/agi-gui/src/agi_gui/widgets/file_picker.py

@@ -229,7 +229,7 @@ def agi_file_picker(
     help: str | None = None,
     container: Any | None = None,
 ) -> str | list[str] | None:
-    """Render a Streamlit popover file picker and return selected absolute paths."""
+    """Render a native popover file picker and return selected absolute paths."""
 
     if selection_mode not in {"single", "multi"}:
         raise ValueError("selection_mode must be 'single' or 'multi'")
@@ -339,6 +339,7 @@ def agi_file_picker(
                 st.error(str(exc))
             else:
                 st.session_state[state_key] = [str(selected_manual)]
+                st.session_state.pop(table_key, None)
                 st.rerun()
 
         if allow_upload:
@@ -352,6 +353,8 @@ def agi_file_picker(
                 saved_paths = _save_uploaded_files(uploaded_files, upload_dir, root_items)
                 if saved_paths:
                     st.session_state[state_key] = saved_paths[:1] if selection_mode == "single" else saved_paths
+                    st.session_state.pop(table_key, None)
+                    st.session_state[upload_key] = []
                     st.rerun()
 
     final_selection = _validated_selection(st.session_state.get(state_key), root_items, selection_mode)

src/agilab/lib/agi-gui/test/test_file_picker.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-import agi_web.python_ui
+from importlib import import_module
 from pathlib import Path
 from types import SimpleNamespace
 
@@ -263,7 +263,7 @@ def test_agi_file_picker_selects_dataframe_row(tmp_path: Path, monkeypatch) -> N
     selected_file.write_text("a\n", encoding="utf-8")
     (tmp_path / "beta.txt").write_text("b\n", encoding="utf-8")
     fake_st = _FakeStreamlit(dataframe_state={"selection": {"rows": [0]}})
-    monkeypatch.setattr(agi_web, "python_ui", fake_st)
+    monkeypatch.setattr(import_module("agi_web"), "python_ui", fake_st, raising=False)
 
     result = agi_file_picker(
         "Browse",
@@ -294,7 +294,7 @@ def test_agi_file_picker_handles_multi_root_empty_search_and_manual_error(tmp_pa
         button_values={"picker:use_manual_path": True},
         pills_value="unknown",
     )
-    monkeypatch.setattr(agi_web, "python_ui", fake_st)
+    monkeypatch.setattr(import_module("agi_web"), "python_ui", fake_st, raising=False)
 
     result = agi_file_picker(
         "Browse",
@@ -315,7 +315,7 @@ def test_agi_file_picker_manual_path_updates_selection(tmp_path: Path, monkeypat
         text_values={"picker:manual_path": str(selected_file)},
         button_values={"picker:use_manual_path": True},
     )
-    monkeypatch.setattr(agi_web, "python_ui", fake_st)
+    monkeypatch.setattr(import_module("agi_web"), "python_ui", fake_st, raising=False)
 
     result = agi_file_picker("Browse", roots={"Project": tmp_path}, key="picker")
 
@@ -330,7 +330,7 @@ def test_agi_file_picker_upload_saves_files(tmp_path: Path, monkeypatch) -> None
     fake_st = _FakeStreamlit(
         uploads=[_UploadedFile("nested/new.csv", b"payload")],
     )
-    monkeypatch.setattr(agi_web, "python_ui", fake_st)
+    monkeypatch.setattr(import_module("agi_web"), "python_ui", fake_st, raising=False)
 
     result = agi_file_picker(
         "Upload",

src/agilab/lib/agi-pages/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.08"
+version = "2026.10.10.1"
 name = "agi-pages"
 description = "AGILAB public analysis page umbrella and provider package"
 requires-python = ">=3.12"
@@ -34,7 +34,7 @@ keywords = [
     "page-bundles",
 ]
 
-dependencies = ["agi-gui==2026.10.08"]
+dependencies = ["agi-gui==2026.10.10.1"]
 
 [project.entry-points."agi_env.paths"]
 pages = "agi_pages:bundles_root"

src/agilab/lib/agi-web/frontend/agilab_react_native_controls_and_progress.test.mjs

@@ -329,3 +329,163 @@ test("image descriptions and stretch widths reach the rendered plot", async () =
   assert.equal(images[2].getAttribute("alt"), "", "Only an explicit decorative alt may be empty.");
   assert.equal(images[3].hasAttribute("alt"), false, "An empty caption must not mark an undescribed plot decorative.");
 });
+
+
+test("file popovers retain controls during rerenders and close with Escape or outside interaction", async () => {
+  const disclosure = revision => {
+    const item = node("dataset-picker", "popover", {
+      label: revision === 1 ? "Choose dataset" : "Dataset selected",
+      help: "Choose a CSV under the project", width: "stretch",
+    });
+    item.children = [
+      node("dataset-filter", "text_input", { label: "Filter files", value: "input", key: "filter" }),
+      node("dataset-select", "button", { label: "Select dataset", key: "choose" }),
+    ];
+    return item;
+  };
+  const actions = [];
+  const element = await mount(payload(1, [disclosure(1)]), {
+    action: async action => { actions.push(action); return payload(2, [disclosure(2)]); },
+  });
+  const trigger = element.querySelector(".py-popover-trigger");
+  const panel = element.querySelector(".py-popover-panel");
+  const input = element.querySelector("#dataset-filter");
+  assert.equal(trigger.tagName, "BUTTON", "Use native keyboard activation.");
+  assert.equal(trigger.getAttribute("aria-expanded"), "false");
+  assert.equal(trigger.getAttribute("aria-controls"), panel.id);
+  assert.equal(panel.getAttribute("role"), "dialog");
+  assert.equal(panel.hidden, true);
+  assert.equal(element.querySelector(".py-popover").style.width, "100%");
+  await act(() => trigger.click());
+  assert.equal(panel.hidden, false);
+  assert.equal(trigger.getAttribute("aria-expanded"), "true");
+  assert.equal(actions.length, 0, "Opening a disclosure needs no server roundtrip.");
+  input.focus();
+  await act(() => input.dispatchEvent(new Event("pointerdown", { bubbles: true })));
+  assert.equal(panel.hidden, false);
+  await act(() => input.dispatchEvent(new dom.window.KeyboardEvent("keydown", { key: "Escape", bubbles: true })));
+  assert.equal(panel.hidden, true);
+  assert.equal(document.activeElement, trigger);
+  await act(() => trigger.click());
+  await act(async () => element.querySelector("#dataset-select").click());
+  assert.equal(actions.length, 1);
+  assert.equal(actions[0].id, "dataset-select");
+  assert.equal(element.querySelector(".py-popover-trigger"), trigger);
+  assert.equal(trigger.textContent, "Dataset selected");
+  assert.equal(panel.hidden, false);
+  assert.equal(element.querySelector("#dataset-filter"), input);
+  assert.equal(input.value, "input");
+  const outside = document.createElement("button");
+  document.body.append(outside);
+  await act(() => outside.focus());
+  assert.equal(panel.hidden, true, "Leaving the popover by keyboard closes it.");
+  await act(() => trigger.click());
+  assert.equal(panel.hidden, false);
+  await act(() => outside.dispatchEvent(new Event("pointerdown", { bubbles: true })));
+  assert.equal(panel.hidden, true);
+  assert.equal(document.activeElement, outside, "Closing outside must not steal focus.");
+});
+
+test("disabled popovers keep their child controls hidden", async () => {
+  const item = node("disabled-picker", "popover", { label: "Unavailable", disabled: true });
+  item.children = [node("disabled-child", "text_input", { label: "Hidden child", value: "" })];
+  const element = await mount(payload(1, [item]), { action: async () => assert.fail("Unexpected server action") });
+  const trigger = element.querySelector(".py-popover-trigger");
+  assert.equal(trigger.disabled, true);
+  await act(() => trigger.click());
+  assert.equal(trigger.getAttribute("aria-expanded"), "false");
+  assert.equal(element.querySelector(".py-popover-panel").hidden, true);
+});
+
+
+test("the packaged production bundle renders an interactive file popover", async () => {
+  const packaged = new URL("../src/agi_web/react_python_host_assets/agilab_react_python_host.js", import.meta.url);
+  const module = path.join(scratch, "agilab_native_packaged_popover_host_exact_bytes.mjs");
+  await copyFile(packaged, module);
+  assert.deepEqual(await readFile(module), await readFile(packaged));
+  const { mountPythonView: mountPackaged } = await import(pathToFileURL(module).href);
+  const item = node("packaged-picker", "popover", { label: "Choose CSV", width: "stretch" });
+  item.children = [node("packaged-filter", "text_input", { label: "Filter files", value: "" })];
+  const element = document.createElement("div"); document.body.append(element);
+  cleanup = mountPackaged(element, { initialPayload: payload(1, [item]), transport: {
+    action: async () => assert.fail("Popover interactions must stay local"),
+  } });
+  const waitFor = async predicate => {
+    for (let attempt = 0; attempt < 100; attempt++) {
+      if (predicate()) return;
+      await new Promise(resolve => setTimeout(resolve, 1));
+    }
+    assert.fail("The packaged popover did not reach its expected state.");
+  };
+  await waitFor(() => element.querySelector(".py-popover-trigger"));
+  const trigger = element.querySelector(".py-popover-trigger");
+  const panel = element.querySelector(".py-popover-panel");
+  assert.equal(panel.hidden, true);
+  trigger.click();
+  await waitFor(() => !panel.hidden);
+  const input = element.querySelector("#packaged-filter");
+  input.focus();
+  input.dispatchEvent(new dom.window.KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
+  await waitFor(() => panel.hidden);
+  assert.equal(document.activeElement, trigger);
+});
+
+
+test("packaged nested popovers retain state on rerender and Escape closes only the deepest panel", async () => {
+  const packaged = new URL("../src/agi_web/react_python_host_assets/agilab_react_python_host.js", import.meta.url);
+  const module = path.join(scratch, "agilab_native_packaged_nested_popover_host_exact_bytes.mjs");
+  await copyFile(packaged, module);
+  assert.deepEqual(await readFile(module), await readFile(packaged));
+  const { mountPythonView: mountPackaged } = await import(pathToFileURL(module).href);
+  const nested = revision => {
+    const parent = node("outer-picker", "popover", { label: revision === 1 ? "Choose dataset" : "Dataset selected" });
+    const child = node("inner-picker", "popover", { label: "Advanced" });
+    child.children = [
+      node("inner-filter", "text_input", { label: "Filter files", value: "input" }),
+      node("inner-apply", "button", { label: "Apply filter" }),
+    ];
+    parent.children = [child];
+    return payload(revision, [parent]);
+  };
+  const element = document.createElement("div"); document.body.append(element);
+  const actions = [];
+  cleanup = mountPackaged(element, { initialPayload: nested(1), transport: {
+    action: async action => { actions.push(action); return nested(2); },
+  } });
+  const waitFor = async predicate => {
+    for (let attempt = 0; attempt < 100; attempt++) {
+      if (predicate()) return;
+      await new Promise(resolve => setTimeout(resolve, 1));
+    }
+    assert.fail("The packaged nested popovers did not reach their expected state.");
+  };
+  await waitFor(() => element.querySelector("#outer-picker-popover"));
+  const parentPanel = element.querySelector("#outer-picker-popover");
+  const childPanel = element.querySelector("#inner-picker-popover");
+  const parentTrigger = element.querySelector('[aria-controls="outer-picker-popover"]');
+  const childTrigger = element.querySelector('[aria-controls="inner-picker-popover"]');
+  parentTrigger.focus();
+  parentTrigger.click();
+  await waitFor(() => !parentPanel.hidden);
+  childTrigger.focus();
+  childTrigger.click();
+  await waitFor(() => !childPanel.hidden);
+  const input = element.querySelector("#inner-filter");
+  input.focus();
+  element.querySelector("#inner-apply").click();
+  await waitFor(() => parentTrigger.textContent === "Dataset selected");
+  assert.equal(actions.length, 1);
+  assert.equal(element.querySelector("#inner-filter"), input);
+  assert.equal(document.activeElement, input);
+  assert.equal(childPanel.hidden, false, "The nested panel stays open across the Python rerender.");
+  input.dispatchEvent(new dom.window.KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
+  await waitFor(() => childPanel.hidden);
+  assert.equal(parentPanel.hidden, false, "Escape first closes only the deepest panel.");
+  assert.equal(document.activeElement, childTrigger);
+  assert.equal(parentTrigger.getAttribute("aria-expanded"), "true");
+  assert.equal(childTrigger.getAttribute("aria-expanded"), "false");
+  childTrigger.dispatchEvent(new dom.window.KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
+  await waitFor(() => parentPanel.hidden);
+  assert.equal(document.activeElement, parentTrigger);
+  assert.equal(parentTrigger.getAttribute("aria-expanded"), "false");
+});

src/agilab/lib/agi-web/frontend/agilab_react_python_host.css

@@ -19,3 +19,5 @@
 .py-options input {flex-shrink:0}
 .py-app figure img {display:block}
 .py-table-pagination{display:flex;align-items:center;gap:.75rem;flex-wrap:wrap;padding:.5rem 0}.py-table-pagination [role=status]{font-variant-numeric:tabular-nums}
+
+.py-popover{position:relative;width:fit-content}.py-popover-trigger{width:100%;text-align:left;overflow-wrap:anywhere}.py-popover-trigger[aria-expanded=true]{border-color:var(--py-accent)}.py-popover-trigger:focus-visible{outline:2px solid var(--py-accent);outline-offset:2px}.py-popover-panel{position:absolute;inset-block-start:calc(100% + .4rem);inset-inline-start:0;z-index:50;width:100%;max-width:34rem;box-sizing:border-box;max-height:70vh;overflow:auto;padding:1rem;border:1px solid var(--py-border);border-radius:.65rem;background:var(--py-surface);box-shadow:0 .5rem 1.5rem #18334826}.py-popover-panel[hidden]{display:none}

src/agilab/lib/agi-web/frontend/agilab_react_python_host.jsx

@@ -246,6 +246,45 @@ function LinkAction({node}) {
   return <PythonLinkAction node={node} view={useContext(View)}/>;
 }
 
+function Popover({node}) {
+  const p = node.props, [open, setOpen] = useState(false), element = useRef(null), trigger = useRef(null), panel = useRef(null);
+  const visible = open && !p.disabled, panelId = `${node.id}-popover`, helpId = `${node.id}-help`;
+  useEffect(() => {
+    if (!visible) return;
+    const outside = event => { if (!element.current?.contains(event.target)) setOpen(false); };
+    const escape = event => {
+      // A nested panel handles Escape first, even when its document listener
+      // was registered after ours. Hidden panels may still await effect cleanup.
+      if (event.key === "Escape" && panel.current && !panel.current.closest("[hidden]")
+        && !Array.from(panel.current.querySelectorAll(".py-popover-panel:not([hidden])"))
+          .some(child => !child.closest("[hidden]"))) {
+        event.preventDefault();
+        event.stopPropagation();
+        setOpen(false);
+        trigger.current?.focus();
+      }
+    };
+    document.addEventListener("pointerdown", outside);
+    document.addEventListener("focusin", outside);
+    document.addEventListener("keydown", escape);
+    return () => {
+      document.removeEventListener("pointerdown", outside);
+      document.removeEventListener("focusin", outside);
+      document.removeEventListener("keydown", escape);
+    };
+  }, [visible]);
+  return <div ref={element} className="py-popover" data-widget-kind="popover" data-widget-key={p.key}
+    style={{width: p.width === "stretch" ? "100%" : typeof p.width === "number" ? p.width : undefined}}>
+    <button ref={trigger} type="button" className="py-popover-trigger" disabled={p.disabled} title={p.help || undefined}
+      aria-expanded={visible} aria-controls={panelId} aria-haspopup="dialog" aria-describedby={p.help ? helpId : undefined}
+      onClick={() => setOpen(value => !value)}>{p.label}</button>
+    {p.help ? <span id={helpId} hidden>{p.help}</span> : null}
+    <div ref={panel} id={panelId} className="py-popover-panel" role="dialog" aria-label={p.label} hidden={!visible}>
+      <Nodes nodes={node.children}/>
+    </div>
+  </div>;
+}
+
 // Pure traversal stays outside View so local controls do not repaint heavy siblings.
 const Node = memo(function Node({node}) {
   const p = node.props, content = <Nodes nodes={node.children}/>;
@@ -253,6 +292,7 @@ const Node = memo(function Node({node}) {
   if (node.kind === "component") return <Island node={node}/>;
   if (node.kind === "columns") return <div className="py-columns" style={{gridTemplateColumns: p.weights.map(weight => `${weight}fr`).join(" ")}}>{content}</div>;
   if (node.kind === "tabs") return <Tabs node={node}/>;
+  if (node.kind === "popover") return <Popover node={node}/>;
   if (node.kind === "expander" || node.kind === "status") return <details className="py-expander" data-widget-kind={node.kind} data-widget-key={p.key} data-state={p.state} open={p.expanded}><summary>{p.label}</summary>{content}</details>;
   if (node.kind === "form") return <Form node={node}/>;
   if (node.kind === "dialog") return <div className="py-dialog-backdrop"><section role="dialog" aria-modal="true" aria-label={p.title}><h2>{p.title}</h2>{content}</section></div>;

src/agilab/lib/agi-web/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-version = "2026.10.08"
+version = "2026.10.10.1"
 name = "agi-web"
 description = "AGILAB portable web components with native React Python views and shared analysis components for Jupyter"
 requires-python = ">=3.12"

src/agilab/lib/agi-web/src/agi_web/python_ui.py

@@ -151,6 +151,13 @@ def expander(label, expanded=False, **kwargs):
     return Container(_node("expander", label=str(label), expanded=expanded, **kwargs))
 
 
+def popover(label, *, help=None, disabled=False, width="content", key=None, **kwargs):
+    return Container(current_session().add_node(
+        "popover", {"label": str(label), "help": help, "disabled": bool(disabled),
+                    "width": width, "key": key, **kwargs}, key=key,
+    ))
+
+
 def form(key, *, clear_on_submit=False, **kwargs):
     if current_session().form_stack:
         raise UIError("Forms cannot be nested.")
@@ -271,7 +278,8 @@ def select_slider(label, options, value=None, **kwargs):
 def number_input(label, min_value=None, max_value=None, value="min", step=None, **kwargs):
     if value == "min":
         value = min_value if min_value is not None else (0.0 if isinstance(step, float) else 0)
-    integer = isinstance(value, int) and not isinstance(value, bool)
+    numeric_types = [item for item in ((min_value, max_value, step) if value is None else (value,)) if item is not None]
+    integer = bool(numeric_types) and all(isinstance(item, int) and not isinstance(item, bool) for item in numeric_types)
     return _widget("number_input", label, value, min_value=min_value, max_value=max_value,
                    step=step or (1 if integer else 0.01), integer=integer,
                    decoder=int if integer else float, **kwargs)

src/agilab/lib/agi-web/test/test_python_ui_rendering_and_input_contracts.py

@@ -10,6 +10,7 @@ import pytest
 
 from agi_web import python_ui as ui
 from agi_web.python_view_session import RerunView, UIError, ViewSession, use_session
+from agi_web.testing import AppTest
 
 
 @pytest.fixture
@@ -83,6 +84,44 @@ def test_text_and_status_helpers_preserve_visible_content(session):
     assert ui.status("Done", state="complete").node["props"]["state"] == "complete"
 
 
+@pytest.mark.parametrize(
+    "bounds, entered, expected_type, expected_step",
+    [
+        ({"min_value": 0, "max_value": 4}, 4, int, 1),
+        ({"max_value": 4}, 2, int, 1),
+        ({"step": 2}, 4, int, 2),
+        ({"min_value": 0.0, "max_value": 4.0}, 1.5, float, 0.01),
+        ({"min_value": 0, "max_value": 4.0}, 1.5, float, 0.01),
+        ({"min_value": 0, "max_value": 4, "step": 0.5}, 1.5, float, 0.5),
+        ({}, 1.5, float, 0.01),
+    ],
+)
+def test_empty_numeric_control_infers_type_and_round_trips_native_input(
+    bounds, entered, expected_type, expected_step
+):
+    app = AppTest.from_function(
+        lambda: ui.number_input("Score", value=None, key="score", **bounds)
+    ).run()
+    assert not app.exception
+    assert app.number_input("score").value is None
+    assert app.number_input("score").proto.integer is (expected_type is int)
+    assert app.number_input("score").step == expected_step
+    app.number_input("score").set_value(entered).run()
+    assert not app.exception
+    assert type(app.session_state["score"]) is expected_type
+    assert app.session_state["score"] == entered
+
+
+@pytest.mark.parametrize("invalid", [1.5, True, False])
+def test_empty_integer_control_rejects_fractional_and_boolean_native_input(invalid):
+    app = AppTest.from_function(
+        lambda: ui.number_input("Score", 0, 4, value=None, key="score")
+    ).run()
+    with pytest.raises(UIError, match="Expected (an integer|a number)"):
+        app.number_input("score").set_value(invalid).run()
+    assert app.session_state["score"] is None
+
+
 def test_duplicate_control_keys_and_numeric_defaults(session):
     assert ui.toggle("Toggle", key="toggle") is False
     assert ui.text_area("Notes", value="kept", key="notes") == "kept"
@@ -407,3 +446,90 @@ def test_component_duplicate_keys_config_and_private_secret_files(session, monke
     assert ui.secrets.fixture == ui.secrets["fixture"] == "synthetic fixture value"
     with pytest.raises(AttributeError):
         _ = ui.secrets.missing
+
+
+def test_popover_context_and_container_passthrough_keep_children_scoped(session):
+    outer = ui.container(key="file-picker")
+    with outer.popover("Choose dataset", help="Choose a CSV", width="stretch", key="datasets"):
+        ui.text_input("Filter files", key="dataset-filter")
+        with ui.popover("Advanced", disabled=True):
+            ui.caption("Nested details")
+    ui.text("Outside")
+    disclosure = outer.node["children"][0]
+    assert disclosure["kind"] == "popover"
+    assert disclosure["props"]["label"] == "Choose dataset"
+    assert disclosure["props"]["help"] == "Choose a CSV"
+    assert disclosure["props"]["width"] == "stretch"
+    assert disclosure["children"][0]["kind"] == "text_input"
+    assert disclosure["children"][1]["kind"] == "popover"
+    assert disclosure["children"][1]["props"]["disabled"] is True
+    assert disclosure["children"][1]["children"][0]["kind"] == "caption"
+    assert session.roots["main"][-1]["props"]["body"] == "Outside"
+    assert len(session.stack) == 1
+
+
+def test_real_file_picker_csv_controls_select_filter_roots_manual_path_and_upload(tmp_path):
+    from agi_gui.file_picker import agi_file_picker
+
+    first = tmp_path / "datasets"
+    second = tmp_path / "exports"
+    first.mkdir()
+    second.mkdir()
+    dataset = first / "input_1000_rows.csv"
+    dataset.write_text("x,y\n" + "".join(f"{row},{row * 2}\n" for row in range(1_000)))
+    exported = second / "export.csv"
+    exported.write_text("x,y\n1,2\n")
+
+    def page():
+        ui.session_state["selected_csv"] = agi_file_picker(
+            "Dataset", key="dataset-picker", roots={"Datasets": first, "Exports": second},
+            patterns="*.csv", allow_dirs=False, container=ui.container(),
+            allow_upload=True, upload_dir=first, upload_types=["csv"],
+        )
+
+    app = AppTest.from_function(page).run()
+    assert not app.exception
+    assert len(app.get("popover")) == 1
+    assert app.get("pills")[0].value == "Datasets"
+    table = app.get("dataframe")[0]
+    assert len(table.node["props"]["rows"]) == 1
+    table.set_value(ui.SessionState(selection=ui.SessionState(rows=[0], columns=[]))).run()
+    assert not app.exception
+    assert app.session_state["selected_csv"] == str(dataset)
+    app.get("text_input")[0].input("no matching CSV").run()
+    assert not app.exception
+    assert not app.get("dataframe")
+    assert any("No matching files" in item.value for item in app.get("caption"))
+    app.get("text_input")[0].input("").run()
+    app.get("pills")[0].select("Exports").run()
+    assert not app.exception
+    assert app.get("dataframe")[0].node["props"]["rows"][0][0] == "export.csv"
+    app.get("text_input")[1].input(str(exported)).run()
+    next(item for item in app.get("button") if item.label == "Use path").click().run()
+    assert not app.exception
+    assert app.session_state["selected_csv"] == str(exported)
+    app.get("pills")[0].select("Datasets").run()
+    app.get("file_uploader")[0].upload("uploaded.csv", b"x,y\n3,6\n", "text/csv").run()
+    assert not app.exception
+    uploaded = first / "uploaded.csv"
+    assert uploaded.read_bytes() == b"x,y\n3,6\n"
+    assert app.session_state["selected_csv"] == str(uploaded)
+    assert app.session_state["dataset-picker:upload"] == []
+    app.run()
+    assert not app.exception
+    assert app.session_state["selected_csv"] == str(uploaded)
+    app.get("file_uploader")[0].upload("next_upload.csv", b"x,y\n4,8\n", "text/csv").run()
+    assert not app.exception
+    next_upload = first / "next_upload.csv"
+    assert next_upload.read_bytes() == b"x,y\n4,8\n"
+    assert app.session_state["selected_csv"] == str(next_upload)
+    assert uploaded.read_bytes() == b"x,y\n3,6\n"
+    app.get("dataframe")[0].set_value(ui.SessionState(selection=ui.SessionState(rows=[0], columns=[]))).run()
+    assert app.session_state["selected_csv"] == str(dataset)
+    app.get("text_input")[1].input(str(next_upload)).run()
+    next(item for item in app.get("button") if item.label == "Use path").click().run()
+    assert not app.exception
+    assert app.session_state["selected_csv"] == str(next_upload)
+    app.run()
+    assert not app.exception
+    assert app.session_state["selected_csv"] == str(next_upload)

src/agilab/notebooks/notebook_export_support.py

@@ -18,7 +18,7 @@ import tomllib
 from agi_env.app_provider_registry import app_name_aliases
 from agi_env.app_settings_support import read_app_settings
 
-from agilab.notebooks.notebook_helper_cell import _helper_cell
+from agilab.notebooks.notebook_helper_cell import SDK_WORKER_DEPLOYMENT_HANDOFF, _helper_cell
 
 from agilab.ui.page_bundle_registry import discover_page_bundle
 
@@ -1732,6 +1732,10 @@ def build_notebook_export_handoff_markdown(manifest: Mapping[str, Any]) -> str:
         "3. Run `run_agilab_stage(i)` for one stage, or `run_agilab_pipeline()` for the full workflow.",
         "4. Edit `STAGE_###_CODE` cells when you want the notebook to become the new source of truth.",
         "",
+        "## SDK deployment prerequisites",
+        "",
+        SDK_WORKER_DEPLOYMENT_HANDOFF,
+        "",
         "## Commands",
         "",
         "```bash",
@@ -2272,6 +2276,7 @@ def build_notebook_document(
                     f"- Export mode: `{export_context.export_mode}`",
                     "- First run `validate_agilab_export()` to check local paths before executing workflow code.",
                     "- Use `run_agilab_stage(i)` or `run_agilab_pipeline()` to execute workflow stages in their recorded runtime.",
+                    "- " + SDK_WORKER_DEPLOYMENT_HANDOFF,
                     "- Disabled/skipped stages and output-skip rules remain enforced by the exported runner helpers.",
                     "- The selected automation profile is applied; module max_workers is preserved for re-import, while notebook pipeline execution stays sequential.",
                     "- ID-less stages can be re-imported only while the stage at the recorded module/index still matches its export fingerprint. Notebook source edits are accepted; if the AGILAB target changed, refresh the export or add an explicit stage ID.",

src/agilab/notebooks/notebook_helper_cell.py

@@ -8,9 +8,8 @@
 `_helper_cell` is a single ~1250-line f-string holding the Python that exported
 notebooks run to locate their app, rebuild stage context, and render analysis
 pages. It carried a third of notebook_export_support.py while sharing nothing
-with it -- the only value interpolated from the caller is `payload_literal`, and
-every other brace in the template is `{{`-escaped and belongs to the generated
-code.
+with it -- the caller payload and the shared deployment instructions are embedded
+as literals. Braces belonging to the generated Python are `{{`-escaped.
 
 Keeping it here leaves the export logic readable and lets this file be reviewed
 as what it is: emitted source, not control flow.
@@ -23,6 +22,14 @@ import textwrap
 from typing import Any
 
 
+SDK_WORKER_DEPLOYMENT_HANDOFF = (
+    "SDK run stages using `AGI.run` (including app shorthand) need deployed manager and worker environments, "
+    "including mode `0` (local Python). Before running them, use **ORCHESTRATE → Resources → Deploy scheduler & workers**, "
+    "or include an explicit `AGI.install` stage in your plan. Export preserves your plan and does not add an installation stage. "
+    "Python stages that do not call `AGI.run` remain independently editable and executable with their own dependencies."
+)
+
+
 def _helper_cell(payload: dict[str, Any]) -> str:
     payload_literal = repr(json.dumps(payload, ensure_ascii=False))
     return textwrap.dedent(
@@ -357,6 +364,10 @@ def _helper_cell(payload: dict[str, Any]) -> str:
                 "3. Render related analysis pages if configured.",
                 "4. If you edit stage code, re-import the notebook into AGILAB when you want lab_stages.toml to become the source of truth again.",
                 "",
+                "## SDK deployment prerequisites",
+                "",
+                {SDK_WORKER_DEPLOYMENT_HANDOFF!r},
+                "",
                 "## Paths",
                 "",
                 "- Artifact directory: `" + str(AGILAB_NOTEBOOK_EXPORT.get("artifact_dir") or "(not set)") + "`",
@@ -988,6 +999,10 @@ def _helper_cell(payload: dict[str, Any]) -> str:
                     inherited_mode = run_args.pop("mode", None)
                     if inherited_mode not in (None, ""):
                         run_mode = inherited_mode
+                # Older Workflow templates used this label for SDK local Python.
+                # Other values keep the SDK's own validation and mode semantics.
+                if run_mode == "local":
+                    run_mode = 0
             run_params = dict(run_args)
             run_stages_payload = run_params.pop("stages", []) or []
             if "args" in run_params: