codebind 0.3.0__py3-none-any.whl → 0.4.1__py3-none-any.whl

codebind/__init__.py

@@ -4,6 +4,7 @@ from importlib.metadata import version
 
 from .execution import ExecutionReport, IPythonExecutor
 from .extension import load_ipython_extension, unload_ipython_extension
+from .jupyter import JupyterLabBridge
 from .session import Session
 
 
@@ -12,6 +13,7 @@ __version__ = version("codebind")
 __all__ = [
     "ExecutionReport",
     "IPythonExecutor",
+    "JupyterLabBridge",
     "Session",
     "__version__",
     "load_ipython_extension",

codebind/execution.py

@@ -2,13 +2,18 @@
 
 from __future__ import annotations
 
+import sys
+from collections.abc import Callable, Iterator
+from contextlib import contextmanager
 from dataclasses import asdict, dataclass
-from typing import Any
+from typing import Any, cast
 
+from IPython.core.displaypub import DisplayPublisher
 from IPython.core.interactiveshell import InteractiveShell
 from IPython.utils.capture import capture_output
 
 from .display import display_cell
+from .jupyter import JupyterLabBridge
 
 
 @dataclass(frozen=True, slots=True)
@@ -27,21 +32,194 @@ class ExecutionReport:
         return asdict(self)
 
 
+class _ExecutionDisplayHook:
+    """Capture an expression result while preserving IPython output history."""
+
+    def __init__(
+        self,
+        shell: InteractiveShell,
+        outputs: list[dict[str, Any]],
+        on_output: Callable[[dict[str, Any]], None] | None = None,
+    ) -> None:
+        self.shell = shell
+        self.outputs = outputs
+        self.on_output = on_output
+
+    def __call__(self, value: Any = None) -> None:
+        if value is None:
+            return
+        displayhook = self.shell.displayhook
+        displayhook.check_for_underscore()
+        if displayhook.quiet():
+            return
+        data, metadata = displayhook.compute_format_data(value)
+        displayhook.update_user_ns(value)
+        displayhook.fill_exec_result(value)
+        if data:
+            displayhook.log_output(data)
+            self.outputs.append({"data": data, "metadata": metadata})
+            if self.on_output is not None:
+                self.on_output(
+                    {
+                        "output_type": "execute_result",
+                        "execution_count": displayhook.prompt_count,
+                        "data": data,
+                        "metadata": metadata,
+                    }
+                )
+
+
+class _StreamingTextIO:
+    """Write to IPython's capture buffer while forwarding live stream output."""
+
+    def __init__(
+        self,
+        stream: Any,
+        name: str,
+        on_output: Callable[[dict[str, Any]], None],
+    ) -> None:
+        self.stream = stream
+        self.name = name
+        self.on_output = on_output
+
+    def write(self, text: str) -> int:
+        written = self.stream.write(text)
+        if text:
+            self.on_output({"output_type": "stream", "name": self.name, "text": text})
+        return written
+
+    def flush(self) -> None:
+        self.stream.flush()
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.stream, name)
+
+
+class _StreamingDisplayPublisher:
+    """Capture rich displays while forwarding them to the notebook cell."""
+
+    def __init__(
+        self,
+        publisher: Any,
+        on_output: Callable[[dict[str, Any]], None],
+        on_clear: Callable[[bool], None],
+    ) -> None:
+        self.publisher = publisher
+        self.on_output = on_output
+        self.on_clear = on_clear
+
+    def publish(
+        self,
+        data: dict[str, Any],
+        metadata: dict[str, Any] | None = None,
+        source: str | None = None,
+        *,
+        transient: dict[str, Any] | None = None,
+        update: bool = False,
+    ) -> None:
+        self.publisher.publish(
+            data,
+            metadata=metadata,
+            source=source,
+            transient=transient,
+            update=update,
+        )
+        self.on_output(
+            {
+                "output_type": "display_data",
+                "data": data,
+                "metadata": metadata or {},
+            }
+        )
+
+    def clear_output(self, wait: bool = False) -> None:
+        self.publisher.clear_output(wait)
+        self.on_clear(wait)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.publisher, name)
+
+
+@contextmanager
+def _captured_execution(
+    shell: InteractiveShell,
+    expression_outputs: list[dict[str, Any]],
+    *,
+    bridged: bool,
+    on_output: Callable[[dict[str, Any]], None] | None = None,
+    on_clear: Callable[[bool], None] | None = None,
+) -> Iterator[Any]:
+    """Capture one nested execution without leaking its output to the parent cell."""
+    with capture_output() as captured:
+        if not bridged:
+            yield captured
+            return
+
+        previous_displayhook = sys.displayhook
+        previous_showtraceback = shell.showtraceback
+        previous_showsyntaxerror = shell.showsyntaxerror
+        if on_output is not None:
+            sys.stdout = _StreamingTextIO(sys.stdout, "stdout", on_output)
+            sys.stderr = _StreamingTextIO(sys.stderr, "stderr", on_output)
+            shell.display_pub = cast(
+                DisplayPublisher,
+                _StreamingDisplayPublisher(
+                    shell.display_pub,
+                    on_output,
+                    on_clear or (lambda wait: None),
+                ),
+            )
+        sys.displayhook = _ExecutionDisplayHook(shell, expression_outputs, on_output)
+        shell.showtraceback = lambda *args, **kwargs: None
+        shell.showsyntaxerror = lambda *args, **kwargs: None
+        try:
+            yield captured
+        finally:
+            sys.displayhook = previous_displayhook
+            shell.showtraceback = previous_showtraceback
+            shell.showsyntaxerror = previous_showsyntaxerror
+
+
 class IPythonExecutor:
     """Run cells through one existing IPython shell."""
 
-    def __init__(self, shell: InteractiveShell) -> None:
+    def __init__(
+        self,
+        shell: InteractiveShell,
+        bridge: JupyterLabBridge | None = None,
+    ) -> None:
         self.shell = shell
+        self.bridge = bridge
 
     def execute(self, cell: str) -> ExecutionReport:
         """Execute a cell through IPython and replay its native rich output."""
         if not isinstance(cell, str) or not cell.strip():
             raise ValueError("cell must be a non-empty string")
 
-        display_cell(cell)
-        with capture_output() as captured:
+        bridge = self.bridge
+        cell_id = bridge.start_code_cell(cell) if bridge is not None else None
+        bridged = cell_id is not None
+        on_output, on_clear = self._stream_callbacks(cell_id)
+        if not bridged:
+            display_cell(cell)
+        expression_outputs: list[dict[str, Any]] = []
+        with _captured_execution(
+            self.shell,
+            expression_outputs,
+            bridged=bridged,
+            on_output=on_output,
+            on_clear=on_clear,
+        ) as captured:
             result = self.shell.run_cell(cell, store_history=True)
-        captured.show()
+        if bridged:
+            assert bridge is not None and cell_id is not None
+            bridge.finish_code_cell(
+                cell_id,
+                result.execution_count,
+                self._notebook_outputs(result, captured, expression_outputs),
+            )
+        else:
+            captured.show()
 
         return self._report(result, captured)
 
@@ -50,18 +228,57 @@ class IPythonExecutor:
         if not isinstance(cell, str) or not cell.strip():
             raise ValueError("cell must be a non-empty string")
 
-        display_cell(cell)
+        bridge = self.bridge
+        cell_id = bridge.start_code_cell(cell) if bridge is not None else None
+        bridged = cell_id is not None
+        on_output, on_clear = self._stream_callbacks(cell_id)
+        if not bridged:
+            display_cell(cell)
         transformed = self.shell.transform_cell(cell)
-        with capture_output() as captured:
+        expression_outputs: list[dict[str, Any]] = []
+        with _captured_execution(
+            self.shell,
+            expression_outputs,
+            bridged=bridged,
+            on_output=on_output,
+            on_clear=on_clear,
+        ) as captured:
             result = await self.shell.run_cell_async(
                 cell,
                 store_history=True,
                 transformed_cell=transformed,
             )
-        captured.show()
+        if bridged:
+            assert bridge is not None and cell_id is not None
+            bridge.finish_code_cell(
+                cell_id,
+                result.execution_count,
+                self._notebook_outputs(result, captured, expression_outputs),
+            )
+        else:
+            captured.show()
 
         return self._report(result, captured)
 
+    def _stream_callbacks(
+        self,
+        cell_id: str | None,
+    ) -> tuple[
+        Callable[[dict[str, Any]], None] | None,
+        Callable[[bool], None] | None,
+    ]:
+        bridge = self.bridge
+        if bridge is None or cell_id is None:
+            return None, None
+
+        def on_output(output: dict[str, Any]) -> None:
+            bridge.append_code_output(cell_id, output)
+
+        def on_clear(wait: bool) -> None:
+            bridge.clear_code_output(cell_id, wait=wait)
+
+        return on_output, on_clear
+
     @staticmethod
     def _report(result: Any, captured: Any) -> ExecutionReport:
         """Build the model-facing text projection of an IPython execution."""
@@ -86,3 +303,61 @@ class IPythonExecutor:
             displays=tuple(displays),
             error=error,
         )
+
+    def _notebook_outputs(
+        self,
+        result: Any,
+        captured: Any,
+        expression_outputs: list[dict[str, Any]],
+    ) -> list[dict[str, Any]]:
+        """Build standard nbformat outputs for a JupyterLab code cell."""
+        outputs: list[dict[str, Any]] = []
+        if captured.stdout:
+            outputs.append({"output_type": "stream", "name": "stdout", "text": captured.stdout})
+        if captured.stderr:
+            outputs.append({"output_type": "stream", "name": "stderr", "text": captured.stderr})
+
+        for output in captured.outputs:
+            data = getattr(output, "data", None)
+            if not isinstance(data, dict):
+                continue
+            outputs.append(
+                {
+                    "output_type": "display_data",
+                    "data": data,
+                    "metadata": getattr(output, "metadata", {}) or {},
+                }
+            )
+
+        for expression in expression_outputs:
+            outputs.append(
+                {
+                    "output_type": "execute_result",
+                    "execution_count": result.execution_count,
+                    "data": expression["data"],
+                    "metadata": expression["metadata"],
+                }
+            )
+
+        exception = result.error_before_exec or result.error_in_exec
+        if exception is not None:
+            if isinstance(exception, SyntaxError):
+                traceback = self.shell.SyntaxTB.structured_traceback(
+                    type(exception),
+                    exception,
+                )
+            else:
+                traceback = self.shell.InteractiveTB.structured_traceback(
+                    type(exception),
+                    exception,
+                    exception.__traceback__,
+                )
+            outputs.append(
+                {
+                    "output_type": "error",
+                    "ename": type(exception).__name__,
+                    "evalue": str(exception),
+                    "traceback": traceback,
+                }
+            )
+        return outputs

codebind/extension.py

@@ -7,6 +7,7 @@ from typing import Any
 from IPython.core.interactiveshell import InteractiveShell
 from models_provider import Models
 
+from .jupyter import JupyterLabBridge
 from .session import Session
 
 
@@ -17,9 +18,13 @@ def load_ipython_extension(ipython: InteractiveShell) -> None:
     """Load Codebind into the active IPython user namespace."""
     previous = getattr(ipython, _NAMESPACE_ATTRIBUTE, None)
     if isinstance(previous, dict):
+        previous_chat = previous.get("chat")
+        if isinstance(previous_chat, Session) and previous_chat.bridge is not None:
+            previous_chat.bridge.close()
         ipython.drop_by_id(previous)
+    bridge = JupyterLabBridge.connect(ipython)
     namespace: dict[str, Any] = {
-        "chat": Session(shell=ipython),
+        "chat": Session(shell=ipython, bridge=bridge),
         "Models": Models,
     }
     ipython.push(namespace)
@@ -30,5 +35,8 @@ def unload_ipython_extension(ipython: InteractiveShell) -> None:
     """Remove names added by Codebind without touching user replacements."""
     namespace = getattr(ipython, _NAMESPACE_ATTRIBUTE, None)
     if isinstance(namespace, dict):
+        chat = namespace.get("chat")
+        if isinstance(chat, Session) and chat.bridge is not None:
+            chat.bridge.close()
         ipython.drop_by_id(namespace)
         delattr(ipython, _NAMESPACE_ATTRIBUTE)

codebind/jupyter.py

@@ -0,0 +1,109 @@
+"""Optional bridge from an IPython kernel to the Codebind JupyterLab extension."""
+
+from __future__ import annotations
+
+from typing import Any
+from uuid import uuid4
+
+from IPython.core.interactiveshell import InteractiveShell
+
+
+_TARGET_NAME = "codebind"
+
+
+class JupyterLabBridge:
+    """Send native notebook cells to a connected JupyterLab frontend."""
+
+    def __init__(self, comm: Any) -> None:
+        self._comm = comm
+        self.ready = False
+        comm.on_msg(self._on_message)
+
+    @classmethod
+    def connect(cls, shell: InteractiveShell) -> JupyterLabBridge | None:
+        """Open a frontend comm when running inside an IPython kernel."""
+        if not hasattr(shell, "kernel"):
+            return None
+
+        try:
+            from comm import create_comm  # pyright: ignore[reportMissingImports]
+
+            return cls(create_comm(target_name=_TARGET_NAME))
+        except (ImportError, RuntimeError):
+            return None
+
+    def close(self) -> None:
+        """Close the frontend connection."""
+        self._comm.close()
+        self.ready = False
+
+    def start_code_cell(self, source: str) -> str | None:
+        """Insert a running code cell before its execution begins."""
+        if not self.ready:
+            return None
+        cell_id = str(uuid4())
+        self._comm.send(
+            {
+                "type": "code_cell_started",
+                "cell_id": cell_id,
+                "source": source,
+            }
+        )
+        return cell_id
+
+    def finish_code_cell(
+        self,
+        cell_id: str,
+        execution_count: int | None,
+        outputs: list[dict[str, Any]],
+    ) -> bool:
+        """Finish a previously inserted code cell with its native outputs."""
+        if not self.ready:
+            return False
+        self._comm.send(
+            {
+                "type": "code_cell_finished",
+                "cell_id": cell_id,
+                "execution_count": execution_count,
+                "outputs": outputs,
+            }
+        )
+        return True
+
+    def append_code_output(self, cell_id: str, output: dict[str, Any]) -> bool:
+        """Append one live output to a running code cell."""
+        if not self.ready:
+            return False
+        self._comm.send(
+            {
+                "type": "code_cell_output",
+                "cell_id": cell_id,
+                "output": output,
+            }
+        )
+        return True
+
+    def clear_code_output(self, cell_id: str, *, wait: bool = False) -> bool:
+        """Clear a running code cell's outputs."""
+        if not self.ready:
+            return False
+        self._comm.send(
+            {
+                "type": "code_cell_clear",
+                "cell_id": cell_id,
+                "wait": wait,
+            }
+        )
+        return True
+
+    def insert_markdown_cell(self, source: str) -> bool:
+        """Insert one rendered Markdown cell through JupyterLab."""
+        if not self.ready:
+            return False
+        self._comm.send({"type": "markdown_cell", "source": source})
+        return True
+
+    def _on_message(self, message: dict[str, Any]) -> None:
+        data = message.get("content", {}).get("data", {})
+        if isinstance(data, dict) and data.get("type") == "ready":
+            self.ready = True

codebind/session.py

@@ -15,6 +15,7 @@ from langchain_core.runnables import Runnable
 
 from .display import display_assistant
 from .execution import ExecutionReport, IPythonExecutor
+from .jupyter import JupyterLabBridge
 
 
 IPYTHON_TOOL = {
@@ -66,13 +67,15 @@ class Session:
         *,
         shell: InteractiveShell | None = None,
         instructions: str | None = None,
+        bridge: JupyterLabBridge | None = None,
     ) -> None:
         resolved_shell = shell or get_ipython()
         if resolved_shell is None:
             raise RuntimeError("Session must be created inside IPython or given an IPython shell.")
 
         self.shell = resolved_shell
-        self.executor = IPythonExecutor(resolved_shell)
+        self.bridge = bridge
+        self.executor = IPythonExecutor(resolved_shell, bridge)
         self.instructions = instructions.strip() if instructions else None
         self.messages: list[BaseMessage] = []
         self.last_response: AIMessage | None = None
@@ -112,7 +115,7 @@ class Session:
             if not response.tool_calls:
                 answer = _message_text(response)
                 if answer:
-                    display_assistant(answer)
+                    self._display_assistant(answer)
                 return
 
             for call in response.tool_calls:
@@ -144,7 +147,7 @@ class Session:
             if not response.tool_calls:
                 answer = _message_text(response)
                 if answer:
-                    display_assistant(answer)
+                    self._display_assistant(answer)
                 return
 
             for call in response.tool_calls:
@@ -164,6 +167,10 @@ class Session:
         except NotImplementedError:
             return model.bind(tools=[IPYTHON_TOOL], parallel_tool_calls=False)
 
+    def _display_assistant(self, answer: str) -> None:
+        if self.bridge is None or not self.bridge.insert_markdown_cell(answer):
+            display_assistant(answer)
+
     def _execute_call(self, call: Mapping[str, Any]) -> ExecutionReport:
         if call.get("name") != "ipython":
             return _tool_error("UnknownTool", f"unknown tool: {call.get('name')!r}")

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/install.json

@@ -0,0 +1,5 @@
+{
+  "packageManager": "python",
+  "packageName": "codebind",
+  "uninstallInstructions": "Use the Python package manager that installed Codebind to uninstall it."
+}

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "codebind-jupyterlab",
+  "version": "0.4.1",
+  "description": "Native JupyterLab cells for Codebind model executions.",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/**/*"
+  ],
+  "scripts": {
+    "build": "jlpm run clean && jlpm run build:lib && jupyter-builder build && jlpm run build:install",
+    "build:install": "node -e \"require('node:fs').copyFileSync('install.json', '../data/share/jupyter/labextensions/codebind-jupyterlab/install.json')\"",
+    "build:lib": "tsc",
+    "clean": "rimraf lib tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@jupyterlab/application": "^4.0.0",
+    "@jupyterlab/cells": "^4.0.0",
+    "@jupyterlab/nbformat": "^4.0.0",
+    "@jupyterlab/notebook": "^4.0.0",
+    "@jupyterlab/services": "^7.0.0"
+  },
+  "devDependencies": {
+    "@jupyter/builder": "^1.2.0",
+    "rimraf": "^6.0.0",
+    "typescript": "~5.7.0"
+  },
+  "jupyterlab": {
+    "extension": true,
+    "outputDir": "../data/share/jupyter/labextensions/codebind-jupyterlab",
+    "_build": {
+      "load": "static/remoteEntry.6f017385dfc989f1.js",
+      "extension": "./extension"
+    }
+  }
+}

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.6544266cd73a003b.js

@@ -0,0 +1 @@
+"use strict";(self.rspackChunkcodebind_jupyterlab=self.rspackChunkcodebind_jupyterlab||[]).push([[590],{509(e,t,n){n.r(t);var o=n(171);function l(e){let t=e.sessionContext.session?.kernel;if(!t)return;let n=null,l=new Map;t.registerCommTarget("codebind",(u,c)=>{u.onMsg=u=>{var c;let d,i,r=u.content.data;if(!("object"==typeof r&&null!==r&&("markdown_cell"===r.type?"string"==typeof r.source:"code_cell_started"===r.type?"string"==typeof r.cell_id&&"string"==typeof r.source:"code_cell_output"===r.type?"string"==typeof r.cell_id&&"object"==typeof r.output&&null!==r.output:"code_cell_clear"===r.type?"string"==typeof r.cell_id&&"boolean"==typeof r.wait:"code_cell_finished"===r.type&&"string"==typeof r.cell_id&&("number"==typeof r.execution_count||null===r.execution_count)&&Array.isArray(r.outputs))))return;if("code_cell_output"===r.type)return void l.get(r.cell_id)?.outputs.add(r.output);if("code_cell_clear"===r.type)return void l.get(r.cell_id)?.outputs.clear(r.wait);if("code_cell_finished"===r.type){let e=l.get(r.cell_id);if(!e)return;e.outputs.fromJSON(r.outputs),e.executionCount=r.execution_count,e.executionState="idle",n&&null===n.parentExecutionCount&&null!==r.execution_count&&(n.parentExecutionCount=r.execution_count-1);return}let s=(()=>{if(n)return n;let o=e.content,l=o.widgets.findIndex(e=>"code"===e.model.type&&"running"===e.model.executionState);n={parentModel:l>=0?o.widgets[l].model:null,parentExecutionCount:null,resumeModel:o.activeCell?.model??null,nextIndex:l>=0?l+1:o.activeCell?o.activeCellIndex+1:0};let u=(o,l)=>{"idle"===l&&(t.statusChanged.disconnect(u),(()=>{if(!n)return;let t=e.content,o=n;if(n=null,o.parentModel&&null!==o.parentExecutionCount&&(o.parentModel.executionCount=o.parentExecutionCount),o.resumeModel){let e=t.widgets.findIndex(e=>e.model===o.resumeModel);e>=0&&(t.activeCellIndex=e)}})())};return t.statusChanged.connect(u),n})(),a=(c=s.nextIndex,(i=(d=e.content).model)?("code_cell_started"===r.type?i.sharedModel.insertCell(c,{cell_type:"code",source:r.source,metadata:{trusted:!0},execution_count:null,outputs:[]}):i.sharedModel.insertCell(c,{cell_type:"markdown",source:r.source,metadata:{}}),d.activeCellIndex=c,d.deselectAll(),"markdown_cell"===r.type&&o.NotebookActions.run(d),d.scrollToItem(c),d.widgets[c]?.model??null):null);"code_cell_started"===r.type&&a?.type==="code"&&(a.executionState="running",l.set(r.cell_id,a)),s.nextIndex+=1},u.send({type:"ready"})})}function u(e){e.sessionContext.ready.then(()=>l(e)),e.sessionContext.kernelChanged.connect(()=>l(e))}let c={id:"codebind-jupyterlab:plugin",description:"Insert Codebind executions as native notebook cells.",autoStart:!0,requires:[o.INotebookTracker],activate:(e,t)=>{t.forEach(u),t.widgetAdded.connect((e,t)=>u(t))}};n.d(t,{},{default:c})}}]);

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.6f017385dfc989f1.js

@@ -0,0 +1 @@
+var _JUPYTERLAB;(()=>{"use strict";var e,n,r,t,o,i,u,a,c,l,f,s,p,d,h,v,g,m,y,b,S,j,k,w,E,x,T,P,M,A,C,O,D,_,L,N,$,q={457(e,n,r){var t={"./index":()=>r.e(590).then(()=>()=>r(509)),"./extension":()=>r.e(590).then(()=>()=>r(509))},o=function(e,n){return r.R=n,n=r.o(t,e)?t[e]():Promise.resolve().then(()=>{throw Error('Module "'+e+'" does not exist in container.')}),r.R=void 0,n},i=function(e,n){if(r.S){var t="default",o=r.S[t];if(o&&o!==e)throw Error("Container initialization failed as it has already been initialized with a different share scope");return r.S[t]=e,r.I(t,n)}};r.d(n,{get:()=>o,init:()=>i})}},z={};function I(e){var n=z[e];if(void 0!==n)return n.exports;var r=z[e]={exports:{}};return q[e](r,r.exports,I),r.exports}I.m=q,I.c=z,I.n=e=>{var n=e&&e.__esModule?()=>e.default:()=>e;return I.d(n,{a:n}),n},I.d=(e,n,r)=>{var t=(n,r)=>{for(var t in n)I.o(n,t)&&!I.o(e,t)&&Object.defineProperty(e,t,{enumerable:!0,[r]:n[t]})};t(n,"get"),t(r,"value")},I.f={},I.e=e=>Promise.all(Object.keys(I.f).reduce((n,r)=>(I.f[r](e,n),n),[])),I.u=e=>""+e+".6544266cd73a003b.js?v=6544266cd73a003b",I.g=(()=>{if("object"==typeof globalThis)return globalThis;try{return this||Function("return this")()}catch(e){if("object"==typeof window)return window}})(),I.o=(e,n)=>Object.prototype.hasOwnProperty.call(e,n),R={},I.l=function(e,n,r,t){if(R[e])return void R[e].push(n);if(void 0!==r)for(var o,i,u=document.getElementsByTagName("script"),a=0;a<u.length;a++){var c=u[a];if(c.getAttribute("src")==e||c.getAttribute("data-rspack")=="codebind-jupyterlab:"+r){o=c;break}}o||(i=!0,(o=document.createElement("script")).timeout=120,I.nc&&o.setAttribute("nonce",I.nc),o.setAttribute("data-rspack","codebind-jupyterlab:"+r),o.src=e),R[e]=[n];var l=function(n,r){o.onerror=o.onload=null,clearTimeout(f);var t=R[e];if(delete R[e],o.parentNode&&o.parentNode.removeChild(o),t&&t.forEach(function(e){return e(r)}),n)return n(r)},f=setTimeout(l.bind(null,void 0,{type:"timeout",target:o}),12e4);o.onerror=l.bind(null,o.onerror),o.onload=l.bind(null,o.onload),i&&document.head.appendChild(o)},I.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},I.S={},I.initializeSharingData={scopeToSharingDataMapping:{default:[{name:"codebind-jupyterlab",version:"0.4.1",factory:()=>I.e(590).then(()=>()=>I(509)),eager:0,treeShakingMode:null}]},uniqueName:"codebind-jupyterlab"},U={},B={},I.I=function(e,n){n||(n=[]);var r=B[e];if(r||(r=B[e]={}),!(n.indexOf(r)>=0)){if(n.push(r),U[e])return U[e];I.o(I.S,e)||(I.S[e]={});var t=I.S[e],o=function(e){"u">typeof console&&console.warn&&console.warn(e)},i=I.initializeSharingData.uniqueName,u=function(e,n,r,o){var u=t[e]=t[e]||{},a=u[n];(!a||!a.loaded&&(!o!=!a.eager?o:i>a.from))&&(u[n]={get:r,from:i,eager:!!o})},a=function(r){var t=function(e){o("Initialization of sharing external failed: "+e)};try{var i=I(r);if(!i)return;var u=function(r){return r&&r.init&&r.init(I.S[e],n)};if(i.then)return c.push(i.then(u,t));var a=u(i);if(a&&a.then)return c.push(a.catch(t))}catch(e){t(e)}},c=[],l=I.initializeSharingData.scopeToSharingDataMapping;return(l[e]&&l[e].forEach(function(e){"object"==typeof e?u(e.name,e.version,e.factory,e.eager):a(e)}),c.length)?U[e]=Promise.all(c).then(function(){return U[e]=1}):U[e]=1}},I.g.importScripts&&(V=I.g.location+"");var R,U,B,V,J=I.g.document;if(!V&&J&&(J.currentScript&&"SCRIPT"===J.currentScript.tagName.toUpperCase()&&(V=J.currentScript.src),!V)){var Y=J.getElementsByTagName("script");if(Y.length)for(var K=Y.length-1;K>-1&&(!V||!/^http(s?):/.test(V));)V=Y[K--].src}if(!V)throw Error("Automatic publicPath is not supported in this browser");I.p=V=V.replace(/^blob:/,"").replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),I.consumesLoadingData={chunkMapping:{590:["171"]},moduleIdToConsumeDataMapping:{171:{shareScope:"default",shareKey:"@jupyterlab/notebook",import:null,requiredVersion:"^4.6.3",strictVersion:!1,singleton:!0,eager:!1,fallback:void 0,treeShakingMode:null}},initialConsumes:[]},e=function(e){return e.split(".").map(function(e){return+e==e?+e:e})},n=function(n){var r=function(n){var r=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(n),t=r[1]?[0].concat(e(r[1])):[0];r[2]&&(t.length++,t.push.apply(t,e(r[2])));let o=t[t.length-1];for(;t.length&&(void 0===o||/^[*xX]$/.test(o));)t.pop(),o=t[t.length-1];return t},t=function(e){return 1===e.length?[0]:2===e.length?[1].concat(e.slice(1)):3===e.length?[2].concat(e.slice(1)):[e.length].concat(e.slice(1))},o=function(e){return[-e[0]-1].concat(e.slice(1))},i=function(e){let n=/^(\^|~|<=|<|>=|>|=|v|!)/.exec(e),i=n?n[0]:"",u=r(i.length?e.slice(i.length).trim():e.trim());switch(i){case"^":if(u.length>1&&0===u[1]){if(u.length>2&&0===u[2])return[3].concat(u.slice(1));return[2].concat(u.slice(1))}return[1].concat(u.slice(1));case"~":return[2].concat(u.slice(1));case">=":return u;case"=":case"v":case"":return t(u);case"<":return o(u);case">":return[,t(u),0,u,2];case"<=":return[,t(u),o(u),1];case"!":return[,t(u),0];default:throw Error("Unexpected start value")}},u=function(e,n){if(1===e.length)return e[0];let r=[];for(let n of e.slice().reverse())0 in n?r.push(n):r.push.apply(r,n.slice(1));return[,].concat(r,e.slice(1).map(()=>n))};return u(n.split(/\s*\|\|\s*/).map(function(e){let n=e.split(/\s+-\s+/);if(1===n.length){e=e.trim();let n=[],r=/[-0-9A-Za-z]\s+/g;for(var a,c=0;a=r.exec(e);){let r=a.index+1;n.push(i(e.slice(c,r).trim())),c=r}return n.push(i(e.slice(c).trim())),u(n,2)}let l=r(n[0]),f=r(n[1]);return[,t(f),o(f),1,l,2]}),1)},r=function(n){var r=/^([^-+]+)?(?:-([^+]+))?(?:\+(.+))?$/.exec(n),t=r[1]?e(r[1]):[];return r[2]&&(t.length++,t.push.apply(t,e(r[2]))),r[3]&&(t.push([]),t.push.apply(t,e(r[3]))),t},t=function(e,n){e=r(e),n=r(n);for(var t=0;;){if(t>=e.length)return t<n.length&&"u"!=(typeof n[t])[0];var o=e[t],i=(typeof o)[0];if(t>=n.length)return"u"==i;var u=n[t],a=(typeof u)[0];if(i==a){if("o"!=i&&"u"!=i&&o!=u)return o<u;t++}else{if("o"==i&&"n"==a)return!0;return"s"==a||"u"==i}}},o=function(e){var n=e[0],r="";if(1===e.length)return"*";if(n+.5){r+=0==n?">=":-1==n?"<":1==n?"^":2==n?"~":n>0?"=":"!=";for(var t=1,i=1;i<e.length;i++){var u=e[i],a=(typeof u)[0];t--,r+="u"==a?"-":(t>0?".":"")+(t=2,u)}return r}for(var c=[],i=1;i<e.length;i++){var u=e[i];c.push(0===u?"not("+l()+")":1===u?"("+l()+" || "+l()+")":2===u?c.pop()+" "+c.pop():o(u))}return l();function l(){return c.pop().replace(/^\((.+)\)$/,"$1")}},i=function(e,n){if(0 in e){n=r(n);var t=e[0],o=t<0;o&&(t=-t-1);for(var u=0,a=1,c=!0;;a++,u++){var l,f,s=a<e.length?(typeof e[a])[0]:"";if(u>=n.length||"o"==(f=(typeof(l=n[u]))[0])){if(!c)return!0;if("u"==s)return a>t&&!o;return""==s!=o}if("u"==f){if(!c||"u"!=s)return!1}else if(c)if(s==f)if(a<=t){if(l!=e[a])return!1}else{if(o?l>e[a]:l<e[a])return!1;l!=e[a]&&(c=!1)}else if("s"!=s&&"n"!=s){if(o||a<=t)return!1;c=!1,a--}else{if(a<=t||f<s!=o)return!1;c=!1}else"s"!=s&&"n"!=s&&(c=!1,a--)}}for(var p=[],d=p.pop.bind(p),u=1;u<e.length;u++){var h=e[u];p.push(1==h?d()|d():2==h?d()&d():h?i(h,n):!d())}return!!d()},u=function(e,n){var r=I.S[e];if(!r||!I.o(r,n))throw Error("Shared module "+n+" doesn't exist in shared scope "+e);return r},a=function(e,n){var r=e[n],n=Object.keys(r).reduce(function(e,n){return!e||t(e,n)?n:e},0);return n&&r[n]},c=function(e,n){var r=e[n];return Object.keys(r).reduce(function(e,n){return!e||!r[e].loaded&&t(e,n)?n:e},0)},l=function(e,n,r,t){return"Unsatisfied version "+r+" from "+(r&&e[n][r].from)+" of shared singleton module "+n+" (required "+o(t)+")"},f=function(e,n,r,t){var o=c(e,r);return y(e[r][o])},s=function(e,n,r,t){var o=c(e,r);return i(t,o)||g(l(e,r,o,t)),y(e[r][o])},p=function(e,n,r,t){var o=c(e,r);if(!i(t,o))throw Error(l(e,r,o,t));return y(e[r][o])},d=function(e,n,r){var o=e[n],n=Object.keys(o).reduce(function(e,n){return i(r,n)&&(!e||t(e,n))?n:e},0);return n&&o[n]},h=function(e,n,r,t){var i=e[r];return"No satisfying version ("+o(t)+") of shared module "+r+" found in shared scope "+n+".\nAvailable versions: "+Object.keys(i).map(function(e){return e+" from "+i[e].from}).join(", ")},v=function(e,n,r,t){var o=d(e,r,t);if(o)return y(o);throw Error(h(e,n,r,t))},g=function(e){"u">typeof console&&console.warn&&console.warn(e)},m=function(e,n,r,t){g(h(e,n,r,t))},y=function(e){return e.loaded=1,e.get()},S=(b=function(e){return function(n,r,t,o){var i=I.I(n);return i&&i.then?i.then(e.bind(e,n,I.S[n],r,t,o)):e(n,I.S[n],r,t,o)}})(function(e,n,r){return u(e,r),y(a(n,r))}),j=b(function(e,n,r,t){return n&&I.o(n,r)?y(a(n,r)):t()}),k=b(function(e,n,r,t){return u(e,r),y(d(n,r,t)||m(n,e,r,t)||a(n,r))}),w=b(function(e,n,r){return u(e,r),f(n,e,r)}),E=b(function(e,n,r,t){return u(e,r),s(n,e,r,t)}),x=b(function(e,n,r,t){return u(e,r),v(n,e,r,t)}),T=b(function(e,n,r,t){return u(e,r),p(n,e,r,t)}),P=b(function(e,n,r,t,o){return n&&I.o(n,r)?y(d(n,r,t)||m(n,e,r,t)||a(n,r)):o()}),M=b(function(e,n,r,t){return n&&I.o(n,r)?f(n,e,r):t()}),A=b(function(e,n,r,t,o){return n&&I.o(n,r)?s(n,e,r,t):o()}),C=b(function(e,n,r,t,o){var i=n&&I.o(n,r)&&d(n,r,t);return i?y(i):o()}),O=b(function(e,n,r,t,o){return n&&I.o(n,r)?p(n,e,r,t):o()}),D=function(e){var r=!1,t=!1,o=!1,i=!1,u=[e.shareScope,e.shareKey];return(e.requiredVersion?(e.strictVersion&&(r=!0),e.singleton&&(t=!0),u.push(n(e.requiredVersion)),o=!0):e.singleton&&(t=!0),e.fallback&&(i=!0,u.push(e.fallback)),r&&t&&o&&i)?function(){return O.apply(null,u)}:r&&o&&i?function(){return C.apply(null,u)}:t&&o&&i?function(){return A.apply(null,u)}:r&&t&&o?function(){return T.apply(null,u)}:t&&i?function(){return M.apply(null,u)}:o&&i?function(){return P.apply(null,u)}:r&&o?function(){return x.apply(null,u)}:t&&o?function(){return E.apply(null,u)}:t?function(){return w.apply(null,u)}:o?function(){return k.apply(null,u)}:i?function(){return j.apply(null,u)}:function(){return S.apply(null,u)}},_={},I.f.consumes=function(e,n){var r=I.consumesLoadingData.moduleIdToConsumeDataMapping,t=I.consumesLoadingData.chunkMapping;I.o(t,e)&&t[e].forEach(function(e){if(I.o(_,e))return n.push(_[e]);var t=function(n){_[e]=0,I.m[e]=function(r){delete I.c[e],r.exports=n()}},o=function(n){delete _[e],I.m[e]=function(r){throw delete I.c[e],n}};try{var i=D(r[e])();i.then?n.push(_[e]=i.then(t).catch(o)):t(i)}catch(e){o(e)}})},L={871:0},I.f.j=function(e,n){var r=I.o(L,e)?L[e]:void 0;if(0!==r)if(r)n.push(r[2]);else{var t=new Promise((n,t)=>r=L[e]=[n,t]);n.push(r[2]=t);var o=I.p+I.u(e),i=Error();I.l(o,function(n){if(I.o(L,e)&&(0!==(r=L[e])&&(L[e]=void 0),r)){var t=n&&("load"===n.type?"missing":n.type),o=n&&n.target&&n.target.src;i.message="Loading chunk "+e+" failed.\n("+t+": "+o+")",i.name="ChunkLoadError",i.type=t,i.request=o,r[1](i)}},"chunk-"+e,e)}},N=(e,n)=>{var r,t,[o,i,u]=n,a=0;if(o.some(e=>0!==L[e])){for(r in i)I.o(i,r)&&(I.m[r]=i[r]);u&&u(I)}for(e&&e(n);a<o.length;a++)t=o[a],I.o(L,t)&&L[t]&&L[t][0](),L[t]=0},($=self.rspackChunkcodebind_jupyterlab=self.rspackChunkcodebind_jupyterlab||[]).forEach(N.bind(null,0)),$.push=N.bind(null,$.push.bind($));var F=I(457);(_JUPYTERLAB=void 0===_JUPYTERLAB?{}:_JUPYTERLAB)["codebind-jupyterlab"]=F})();

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/style.js

@@ -0,0 +1,2 @@
+/* This is a generated file of CSS imports */
+/* It was generated by @jupyter/builder in Build.ensureAssets() */

codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json

@@ -0,0 +1,3 @@
+{
+  "packages": []
+}

{codebind-0.3.0.dist-info → codebind-0.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebind
-Version: 0.3.0
+Version: 0.4.1
 Summary: A frontend-neutral model loop for persistent IPython sessions.
 Keywords: ai,ipython,llm,repl,agents
 Author: Giovanni Gravili
@@ -8,6 +8,7 @@ Author-email: Giovanni Gravili <ghovax@users.noreply.github.com>
 License-Expression: MIT
 License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -61,7 +62,13 @@ Codebind does not load files or construct a project prompt automatically. The us
 
 ## Jupyter
 
-Install Codebind in the environment used by a Jupyter kernel, then start the Jupyter frontend normally:
+Start JupyterLab with Codebind from any directory without a permanent installation:
+
+```console
+uvx --from jupyterlab --with codebind jupyter lab
+```
+
+Or install both packages into the same environment, then start JupyterLab normally:
 
 ```console
 pip install codebind jupyterlab
@@ -72,15 +79,19 @@ Load Codebind in a notebook:
 
 ```python
 %load_ext codebind
+```
+
+Run that cell once so JupyterLab can connect to the extension, then use Codebind in later cells:
 
+```python
 models = Models({"openai": "OPENAI_API_KEY"})
 model = models.chat("openai/gpt-5")
 await chat.asend("Inspect the current notebook state.", model)
 ```
 
-Codebind publishes cells, assistant Markdown, stdout, tracebacks, and rich results through IPython's MIME display system. The active frontend decides how to render HTML, Markdown, images, SVG, audio, tables, and plain text.
+The Codebind package includes a prebuilt JupyterLab extension. In JupyterLab, each model-authored IPython execution becomes a genuine code cell with its native execution count and outputs, and the assistant response becomes a rendered Markdown cell. The cells are ordinary notebook content and are saved with the notebook.
 
-Model-authored cells are recorded in native IPython history and displayed through the active frontend. A kernel cannot insert a genuine input cell into every possible frontend without a frontend-specific extension, so Codebind does not attempt to control notebook or editor UI.
+Other IPython frontends use the standard MIME display protocol instead. They still receive syntax-highlighted code, assistant Markdown, stdout, tracebacks, rich results, and native IPython history without Codebind depending on their UI.
 
 ## ChatGPT account login
 

codebind-0.4.1.dist-info/RECORD

@@ -0,0 +1,19 @@
+codebind/__init__.py,sha256=GNO_K5EPAdgiK2CWsPVVY-3bAmH2TnFJ9ReAWgSbnqM,514
+codebind/cli.py,sha256=9LOR1L3P8sPsOOgsnpbOsA1PNUZdAj1Z9ROFKeo3EV8,423
+codebind/display.py,sha256=IpxcElyNcr5olRIatEduN_d-sRwpsMlaq1UtrOXocQA,494
+codebind/execution.py,sha256=b1U0iT0e9fDpvGZclGGihod_iLFjJ7wLUkXhmawgeRs,11968
+codebind/extension.py,sha256=elIDW_zl5o3uyil1tEnJ0A5jVkADalqPWI_qcDw4xhY,1460
+codebind/jupyter.py,sha256=xuoiV2-pqtcb_dWXvaaVrlSvqcYfqRYtbX4B-Zh_pBA,3272
+codebind/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebind/session.py,sha256=6KK2d55XsKaq5IVRQmUp5Pzdg-O76bAZvCYgxBU2BN0,7455
+codebind-0.4.1.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/install.json,sha256=78rEThkfrk1pXtekX5WrG9_Y0lJYi5XBEm8n9athpFE,164
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json,sha256=HYr80rRV4byoPUvhf5r9swwnssr7eGxIay227Cusyqo,1152
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.6544266cd73a003b.js,sha256=zrQdGY0320_MGN8KRf8dzMXCjXI_6jtZoAnW4UhDquo,2771
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.6f017385dfc989f1.js,sha256=Cwm6yVfy68shv0OTb6yIbHwV5FxozSz-jO9gf9WE0vc,11087
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/style.js,sha256=Opy15wyuR_ABqsrk-cOcOj2yZtvtq0r36aDkErnloD0,113
+codebind-0.4.1.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json,sha256=MNToQfru1YnHAie-2Virp23yWsc5co3qG0IzrO6SEfw,20
+codebind-0.4.1.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
+codebind-0.4.1.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
+codebind-0.4.1.dist-info/METADATA,sha256=AwmxcH7e9fosl2xI6gJhdbyzKhGbLE5yv1JBva4iX_k,4062
+codebind-0.4.1.dist-info/RECORD,,

codebind-0.3.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-codebind/__init__.py,sha256=ZA475Vomau6BqvxTwcXUeFKXiOlrjTWK6XjD8_Ez6os,452
-codebind/cli.py,sha256=9LOR1L3P8sPsOOgsnpbOsA1PNUZdAj1Z9ROFKeo3EV8,423
-codebind/display.py,sha256=IpxcElyNcr5olRIatEduN_d-sRwpsMlaq1UtrOXocQA,494
-codebind/execution.py,sha256=Md2bv_oIp4rwjMhf8W4b4azA6a0aj-4b6J64cErPP1A,2876
-codebind/extension.py,sha256=zt30o59tynJhat5OMi_u2rci1VDhq8ZOm202hZRwFp8,1055
-codebind/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-codebind/session.py,sha256=Q7HabKcjHUmawLKhoNc2Rdx2-pkTPM0sh1A-tApXQsU,7146
-codebind-0.3.0.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
-codebind-0.3.0.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
-codebind-0.3.0.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
-codebind-0.3.0.dist-info/METADATA,sha256=wPZj3RGdkOU_mJLuUGsq3Du_C76P_t0jGMdtLwugeMw,3688
-codebind-0.3.0.dist-info/RECORD,,