codebind 0.2.0__py3-none-any.whl → 0.4.0__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,6 +2,9 @@
 
 from __future__ import annotations
 
+import sys
+from collections.abc import Iterator
+from contextlib import contextmanager
 from dataclasses import asdict, dataclass
 from typing import Any
 
@@ -9,6 +12,7 @@ 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 +31,89 @@ 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]]) -> None:
+        self.shell = shell
+        self.outputs = outputs
+
+    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})
+
+
+@contextmanager
+def _captured_execution(
+    shell: InteractiveShell,
+    expression_outputs: list[dict[str, Any]],
+    *,
+    bridged: bool,
+) -> 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
+        sys.displayhook = _ExecutionDisplayHook(shell, expression_outputs)
+        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:
+        bridged = self.bridge is not None and self.bridge.ready
+        if not bridged:
+            display_cell(cell)
+        expression_outputs: list[dict[str, Any]] = []
+        with _captured_execution(
+            self.shell,
+            expression_outputs,
+            bridged=bridged,
+        ) as captured:
             result = self.shell.run_cell(cell, store_history=True)
-        captured.show()
+        if bridged:
+            self.bridge.insert_code_cell(
+                cell,
+                result.execution_count,
+                self._notebook_outputs(result, captured, expression_outputs),
+            )
+        else:
+            captured.show()
 
         return self._report(result, captured)
 
@@ -50,15 +122,29 @@ class IPythonExecutor:
         if not isinstance(cell, str) or not cell.strip():
             raise ValueError("cell must be a non-empty string")
 
-        display_cell(cell)
+        bridged = self.bridge is not None and self.bridge.ready
+        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,
+        ) as captured:
             result = await self.shell.run_cell_async(
                 cell,
                 store_history=True,
                 transformed_cell=transformed,
             )
-        captured.show()
+        if bridged:
+            self.bridge.insert_code_cell(
+                cell,
+                result.execution_count,
+                self._notebook_outputs(result, captured, expression_outputs),
+            )
+        else:
+            captured.show()
 
         return self._report(result, captured)
 
@@ -86,3 +172,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,68 @@
+"""Optional bridge from an IPython kernel to the Codebind JupyterLab extension."""
+
+from __future__ import annotations
+
+from typing import Any
+
+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
+
+            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 insert_code_cell(
+        self,
+        source: str,
+        execution_count: int | None,
+        outputs: list[dict[str, Any]],
+    ) -> bool:
+        """Insert one executed code cell through JupyterLab."""
+        if not self.ready:
+            return False
+        self._comm.send(
+            {
+                "type": "code_cell",
+                "source": source,
+                "execution_count": execution_count,
+                "outputs": outputs,
+            }
+        )
+        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

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 import json
 from collections.abc import Mapping, Sequence
 from typing import Any
@@ -14,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 = {
@@ -65,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
@@ -85,8 +89,15 @@ class Session:
         if self.instructions:
             self.messages.append(SystemMessage(self.instructions))
 
-    def ask(self, prompt: str, model: BaseChatModel) -> None:
-        """Run one user turn with the explicitly supplied model."""
+    def send(self, prompt: str, model: BaseChatModel) -> None:
+        """Send one user message synchronously."""
+        try:
+            asyncio.get_running_loop()
+        except RuntimeError:
+            pass
+        else:
+            raise RuntimeError("send() cannot run inside an active event loop; use await asend().")
+
         text = prompt.strip()
         if not text:
             raise ValueError("prompt cannot be empty")
@@ -104,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:
@@ -117,8 +128,8 @@ class Session:
                     )
                 )
 
-    async def aask(self, prompt: str, model: BaseChatModel) -> None:
-        """Run one user turn asynchronously for notebook and event-loop frontends."""
+    async def asend(self, prompt: str, model: BaseChatModel) -> None:
+        """Send one user message asynchronously."""
         text = prompt.strip()
         if not text:
             raise ValueError("prompt cannot be empty")
@@ -136,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:
@@ -156,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.0.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.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "codebind-jupyterlab",
+  "version": "0.4.0",
+  "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.a1fc3d70ac53ef43.js",
+      "extension": "./extension"
+    }
+  }
+}

codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.4acc74d60e21c02c.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;t.registerCommTarget("codebind",(l,c)=>{l.onMsg=l=>{var c;let u=l.content.data;if("object"==typeof u&&null!==u&&("markdown_cell"===u.type?"string"==typeof u.source:"code_cell"===u.type&&"string"==typeof u.source&&("number"==typeof u.execution_count||null===u.execution_count)&&Array.isArray(u.outputs))){let l,d,r=(o=>{if(n)return n;let l=e.content,c=l.widgets.findIndex(e=>"code"===e.model.type&&"running"===e.model.executionState);n={parentModel:c>=0?l.widgets[c].model:null,parentExecutionCount:"code_cell"===o.type&&null!==o.execution_count?o.execution_count-1:null,resumeModel:l.activeCell?.model??null,nextIndex:c>=0?c+1:l.activeCell?l.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})(u);c=r.nextIndex,(d=(l=e.content).model)&&("code_cell"===u.type?d.sharedModel.insertCell(c,{cell_type:"code",source:u.source,metadata:{trusted:!0},execution_count:u.execution_count,outputs:u.outputs}):d.sharedModel.insertCell(c,{cell_type:"markdown",source:u.source,metadata:{}}),l.activeCellIndex=c,l.deselectAll(),"markdown_cell"===u.type&&o.NotebookActions.run(l),l.scrollToItem(c)),r.nextIndex+=1}},l.send({type:"ready"})})}function c(e){e.sessionContext.ready.then(()=>l(e)),e.sessionContext.kernelChanged.connect(()=>l(e))}let u={id:"codebind-jupyterlab:plugin",description:"Insert Codebind executions as native notebook cells.",autoStart:!0,requires:[o.INotebookTracker],activate:(e,t)=>{t.forEach(c),t.widgetAdded.connect((e,t)=>c(t))}};n.d(t,{},{default:u})}}]);

codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.a1fc3d70ac53ef43.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+".4acc74d60e21c02c.js?v=4acc74d60e21c02c",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.0",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.0.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.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json

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

{codebind-0.2.0.dist-info → codebind-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebind
-Version: 0.2.0
+Version: 0.4.0
 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
@@ -51,7 +52,7 @@ It opens standard IPython with `chat` and `Models` in the user namespace. All no
 ```python
 models = Models({"openai": "OPENAI_API_KEY"})
 
-chat.ask(
+chat.send(
     "Inspect this project and tell me what to implement first.",
     models.chat("openai/gpt-5", reasoning_effort="medium"),
 )
@@ -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.aask("Inspect the current notebook state.", model)
+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
 
@@ -94,7 +105,7 @@ authorization = await models.sign_in("openai")
 webbrowser.open(authorization.url)
 await authorization.complete()
 
-chat.ask(
+chat.send(
     "Inspect this project.",
     models.chat("openai/gpt-5", authorization=authorization),
 )

codebind-0.4.0.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=V2pKWrlSpNYzXz5C9uL0_YBV3E8-cmPJzb4bo0T84eM,7864
+codebind/extension.py,sha256=elIDW_zl5o3uyil1tEnJ0A5jVkADalqPWI_qcDw4xhY,1460
+codebind/jupyter.py,sha256=LQ2ZEABqt1e2F7osfBFyATsRIYs1aUoAnM75gaCLaiI,2005
+codebind/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codebind/session.py,sha256=6KK2d55XsKaq5IVRQmUp5Pzdg-O76bAZvCYgxBU2BN0,7455
+codebind-0.4.0.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/install.json,sha256=78rEThkfrk1pXtekX5WrG9_Y0lJYi5XBEm8n9athpFE,164
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json,sha256=RA82cTG7Q6P7rzl8NFFa3NcMQnm-Jijet7SYyNhLSJs,1152
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.4acc74d60e21c02c.js,sha256=vDqupYcPg9MUgfSp87tlSmM78K_Br0R5xbbzBQFQ6tU,1994
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.a1fc3d70ac53ef43.js,sha256=oxw37rRPrYQtSfWoRqixxmxHPdBPh78JC7oz4f735Ms,11087
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/style.js,sha256=Opy15wyuR_ABqsrk-cOcOj2yZtvtq0r36aDkErnloD0,113
+codebind-0.4.0.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json,sha256=MNToQfru1YnHAie-2Virp23yWsc5co3qG0IzrO6SEfw,20
+codebind-0.4.0.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
+codebind-0.4.0.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
+codebind-0.4.0.dist-info/METADATA,sha256=lChyJGOhGdKLL3GIVYXpN8Pa1OzWBWJC3ILLOhDXqOA,4062
+codebind-0.4.0.dist-info/RECORD,,

codebind-0.2.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=NrxB9NLRpT_k0f56xaXgLGjEP6s2IdzF8QILCNBkLbA,6967
-codebind-0.2.0.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
-codebind-0.2.0.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
-codebind-0.2.0.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
-codebind-0.2.0.dist-info/METADATA,sha256=wdK2mZ5n9dR9Bt9Nn7vL-U4SNDo_-ocVhiWsdIjBhNM,3685
-codebind-0.2.0.dist-info/RECORD,,