clikernel 0.2.0__tar.gz → 0.2.2__tar.gz

{clikernel-0.2.0 → clikernel-0.2.2}/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 <!-- do not remove -->
 
+## 0.2.2
+
+### New Features
+
+- skip AST inspectors on nested `run_cell` so tool-replayed cells (e.g. %nbrun) are not treated as user-typed input ([#32](https://github.com/AnswerDotAI/clikernel/issues/32))
+
+
+## 0.2.1
+
+### New Features
+
+- Delegate traceback truncation and ANSI stripping to fastcore `render_text`(`tb_maxlen`=120); drop `render_outs` ([#31](https://github.com/AnswerDotAI/clikernel/issues/31))
+
+
 ## 0.2.0
 
 ### New Features

{clikernel-0.2.0/clikernel.egg-info → clikernel-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clikernel
-Version: 0.2.0
+Version: 0.2.2
 Summary: Serve persistent Jupyter kernels to LLMs as concise text, over MCP or a plain stream protocol
 Author: clikernel contributors
 License: Apache-2.0
@@ -11,7 +11,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.1.17
+Requires-Dist: fastcore>=2.2.2
 Requires-Dist: jupyasyncclient>=0.2.1
 Requires-Dist: mcpmini>=0.0.1
 Requires-Dist: aidialog>=0.0.7

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel/__init__.py

@@ -2,7 +2,10 @@
 
 Modules:
 
+- `clikernel.cli`: The stream-protocol frontend: the service on stdin/stdout for token-reading clients
+- `clikernel.core`: Connect to jupygate-hosted kernels and turn execution into concise text
+- `clikernel.mcp`: The MCP frontend: `Client` as tools on stdio
 - `clikernel.skill`: Use the persistent `clikernel` MCP session as the default workspace for any task advanced through live Python execution -- stateful inspection, file-editing workflows, debugging, experiments, API probes, data transforms, or notebook-style work. Read this before writing, running, or debugging Python code in a session with `clikernel` connected.
 - `clikernel.stream`: Streaming JSON-lines worker protocol: nbformat-shaped output events, and a supervisor for select-based UIs."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel/_modidx.py

@@ -1,6 +1,10 @@
 # Autogenerated by nbdev
 
-d = { 'settings': {'branch': 'main', 'doc_baseurl': '/', 'doc_host': '', 'git_url': '', 'lib_path': 'clikernel'},
+d = { 'settings': { 'branch': 'main',
+                'doc_baseurl': '/clikernel',
+                'doc_host': 'https://AnswerDotAI.github.io',
+                'git_url': 'https://github.com/AnswerDotAI/clikernel',
+                'lib_path': 'clikernel'},
   'syms': { 'clikernel.cli': { 'clikernel.cli._new_delim': ('cli.html#_new_delim', 'clikernel/cli.py'),
                                'clikernel.cli._next_line': ('cli.html#_next_line', 'clikernel/cli.py'),
                                'clikernel.cli._read_block': ('cli.html#_read_block', 'clikernel/cli.py'),
@@ -23,11 +27,8 @@ d = { 'settings': {'branch': 'main', 'doc_baseurl': '/', 'doc_host': '', 'git_ur
                                 'clikernel.core.Client.stop': ('core.html#client.stop', 'clikernel/core.py'),
                                 'clikernel.core._inspector_setup': ('core.html#_inspector_setup', 'clikernel/core.py'),
                                 'clikernel.core._startup_src': ('core.html#_startup_src', 'clikernel/core.py'),
-                                'clikernel.core._tb_line': ('core.html#_tb_line', 'clikernel/core.py'),
-                                'clikernel.core._trunc_tb': ('core.html#_trunc_tb', 'clikernel/core.py'),
                                 'clikernel.core.cfg_dir': ('core.html#cfg_dir', 'clikernel/core.py'),
                                 'clikernel.core.gateways': ('core.html#gateways', 'clikernel/core.py'),
-                                'clikernel.core.render_outs': ('core.html#render_outs', 'clikernel/core.py'),
                                 'clikernel.core.resolve': ('core.html#resolve', 'clikernel/core.py')},
             'clikernel.mcp': { 'clikernel.mcp.main': ('mcp.html#main', 'clikernel/mcp.py'),
                                'clikernel.mcp.mk_server': ('mcp.html#mk_server', 'clikernel/mcp.py'),

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel/cli.py

@@ -1,6 +1,8 @@
 """The stream-protocol frontend: the service on stdin/stdout for token-reading clients
 
-The `clikernel` command: the delimiter-framed stdin/stdout protocol v1 established (documented in the README, rationale unchanged — a client that reads stdout as tokens wants no echo, a cheap ack byte, and a per-process random delimiter to read until). The protocol machinery ports from v1 verbatim; underneath, the process is now a thin client of a jupygate kernel. Run bare it creates a kernel and stops it again on exit — whoever ran the command made that decision by running it — while `--kernel` attaches to an existing kernel and leaves it exactly as found. Ctrl-C during a long cell translates into a kernel interrupt, jupyter-console style, instead of killing the process."""
+The `clikernel` command: the delimiter-framed stdin/stdout protocol v1 established (documented in the README, rationale unchanged — a client that reads stdout as tokens wants no echo, a cheap ack byte, and a per-process random delimiter to read until). The protocol machinery ports from v1 verbatim; underneath, the process is now a thin client of a jupygate kernel. Run bare it creates a kernel and stops it again on exit — whoever ran the command made that decision by running it — while `--kernel` attaches to an existing kernel and leaves it exactly as found. Ctrl-C during a long cell translates into a kernel interrupt, jupyter-console style, instead of killing the process.
+
+Docs: https://AnswerDotAI.github.io/clikernel/cli.html.md"""
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/02_cli.ipynb.
 

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel/core.py

@@ -1,16 +1,17 @@
 """Connect to jupygate-hosted kernels and turn execution into concise text
 
-clikernel is the LLM side of a two-process design: jupygate runs all the time and hosts the kernels; clikernel starts and stops with each conversation and holds nothing but a pointer. This module is the whole client: gateway resolution from `gateways.toml`, the concise-text rendering contract (ANSI-stripped, capped tracebacks), delivery of `startup.py` and `inspectors.py` into freshly created kernels, and `Client` — connect (create or attach), execute, interrupt, restart, stop, list. The MCP and CLI frontends are thin faces over `Client`; nothing here creates or kills a kernel except when asked."""
+clikernel is the LLM side of a two-process design: jupygate runs all the time and hosts the kernels; clikernel starts and stops with each conversation and holds nothing but a pointer. This module is the whole client: gateway resolution from `gateways.toml`, the concise-text rendering contract (ANSI-stripped, capped tracebacks), delivery of `startup.py` and `inspectors.py` into freshly created kernels, and `Client` — connect (create or attach), execute, interrupt, restart, stop, list. The MCP and CLI frontends are thin faces over `Client`; nothing here creates or kills a kernel except when asked.
+
+Docs: https://AnswerDotAI.github.io/clikernel/core.html.md"""
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/00_core.ipynb.
 
 # %% auto #0
-__all__ = ['DEFAULT_URL', 'STATE_LOST', 'cfg_dir', 'gateways', 'resolve', 'render_outs', 'Client']
+__all__ = ['DEFAULT_URL', 'STATE_LOST', 'cfg_dir', 'gateways', 'resolve', 'Client']
 
 # %% ../nbs/00_core.ipynb #2b3b7f4a
 import os, tomllib
 from fastcore.utils import *
-from fastcore.ansi import strip_ansi
 from fastcore.nbio import render_text
 from fastcore.xdg import xdg_config_home
 from jupyasyncclient import JupyAsyncMultiKernelManager, DeadKernelError
@@ -36,33 +37,6 @@ def resolve(host='', cfgdir=None):
     return g['url'], g.get('token') or os.environ.get(g.get('token_env','')) or None
 
 
-# %% ../nbs/00_core.ipynb #b739b087
-def _tb_line(l, maxlen):
-    "One traceback line, capped at `maxlen`; `None` drops it (an over-long anchor line means nothing once cut). `File `/`Cell ` locations are exempt."
-    if len(l) <= maxlen: return l
-    if l.strip() and not (set(l) - set('~^ ')): return None
-    if l.lstrip().startswith(('File ', 'Cell ')): return l
-    return l[:maxlen] + '…'
-
-
-def _trunc_tb(outputs, maxlen=120):
-    "Cap over-long lines in error tracebacks: a cell magic's transformed source echoes its whole payload on one line. Locations survive whole, and so does the last chunk, which is the exception message in both IPython's format and the stdlib's."
-    for o in outputs:
-        if o.get("output_type") != "error": continue
-        # Each chunk keeps its own identity: the renderer joins the list with newlines, so
-        # flattening chunks into lines would silently drop the blank line between frames.
-        # Strip ANSI before capping: the cap can sever an escape sequence, leaving an unstrippable fragment.
-        tb = [strip_ansi(c) for c in o.get("traceback", [])]
-        o["traceback"] = ["\n".join(l for l in (_tb_line(x, maxlen) for x in chunk.split("\n")) if l is not None)
-            for chunk in tb[:-1]] + tb[-1:]
-    return outputs
-
-# %% ../nbs/00_core.ipynb #f70c7acd
-def render_outs(outs):
-    "Concise text for nbformat-style `outs`: cap tracebacks, render, strip ANSI"
-    return strip_ansi(render_text(_trunc_tb(outs)))
-
-
 # %% ../nbs/00_core.ipynb #0d846754
 def _startup_src(src, path):
     "The startup file's source wrapped so `__file__` is bound to its path during the run, and absent after"
@@ -73,6 +47,7 @@ finally: del __file__'''
 # %% ../nbs/00_core.ipynb #3dbf4cb6
 _INSP_RUNNER = r'''
 import inspect as _clik_inspect
+import sys as _clik_sys
 from IPython.core.error import InputRejected
 class RuleBlock(InputRejected):
     "Raise from an inspector to deliberately block a cell; any other inspector exception is a bug, and fails open"
@@ -81,6 +56,11 @@ class _ClikInspect:
     "Calls each inspector once per cell: 1-arg get the AST, 2-arg also the raw source"
     def __init__(self, fs): self.fs = fs
     def visit(self, tree):
+        fr, n = _clik_sys._getframe(), 0
+        while fr:
+            n += fr.f_code.co_name == 'run_cell_async'
+            fr = fr.f_back
+        if n > 1: return tree  # nested run_cell: cell replayed by a tool (%nbrun etc.), not typed
         for f in self.fs:
             try:
                 note = f(tree, _clik_src) if len(_clik_inspect.signature(f).parameters) > 1 else f(tree)
@@ -161,7 +141,7 @@ async def execute_outs(self:Client, code):
 async def execute(self:Client, code):
     "Run `code` in the current kernel; concise rendered text of its outputs"
     r = await self.execute_outs(code)
-    return r if isinstance(r, str) else render_outs(r)
+    return r if isinstance(r, str) else render_text(r, tb_maxlen=120)
 
 # %% ../nbs/00_core.ipynb #1ef42fff
 @patch

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel/mcp.py

@@ -1,6 +1,8 @@
 """The MCP frontend: `Client` as tools on stdio
 
-The frontend Claude Code launches per conversation: `mk_server` closes the tools over a `Client`, and `main` (the `clikernel-mcp` console script) serves it on stdio via mcpmini. There is no instructions machinery and nothing eager — usage is taught by skill text, the server answers `initialize` instantly, and nothing happens until the model calls `connect`. Tool descriptions carry v1's hard-won wording."""
+The frontend Claude Code launches per conversation: `mk_server` closes the tools over a `Client`, and `main` (the `clikernel-mcp` console script) serves it on stdio via mcpmini. There is no instructions machinery and nothing eager — usage is taught by skill text, the server answers `initialize` instantly, and nothing happens until the model calls `connect`. Tool descriptions carry v1's hard-won wording.
+
+Docs: https://AnswerDotAI.github.io/clikernel/mcp.html.md"""
 
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/01_mcp.ipynb.
 
@@ -14,7 +16,8 @@ from mcpmini.core import MCPServer, serve_stdio
 from aidialog.dialog import Message
 from aidialog.hist import output_parts, merge_media
 from aidialog.msg_parts import PartType, data_url
-from .core import Client, render_outs
+from fastcore.nbio import render_text
+from .core import Client
 from . import __version__
 
 
@@ -41,7 +44,7 @@ def mk_server(c:Client):
         "Run `code` in the current kernel, keeping state across calls (imports, variables, monkeypatches, cached objects). Requires a `connect` first. If the reply says the kernel died, `connect` again. Image outputs (plots etc.) come back as image blocks, resized to a token-friendly size, each preceded by its `<media id=...>` tag."
         r = await c.execute_outs(code)
         if isinstance(r, str): return r
-        res = merge_media(render_outs(r), output_parts(Message(msg_type='code', output=r)))
+        res = merge_media(render_text(r, tb_maxlen=120), output_parts(Message(msg_type='code', output=r)))
         return res if isinstance(res, str) else dict(content=[part2block(p) for p in res], isError=False)
 
     async def list_kernels(

{clikernel-0.2.0 → clikernel-0.2.2/clikernel.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clikernel
-Version: 0.2.0
+Version: 0.2.2
 Summary: Serve persistent Jupyter kernels to LLMs as concise text, over MCP or a plain stream protocol
 Author: clikernel contributors
 License: Apache-2.0
@@ -11,7 +11,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.1.17
+Requires-Dist: fastcore>=2.2.2
 Requires-Dist: jupyasyncclient>=0.2.1
 Requires-Dist: mcpmini>=0.0.1
 Requires-Dist: aidialog>=0.0.7

{clikernel-0.2.0 → clikernel-0.2.2}/clikernel.egg-info/requires.txt

@@ -1,4 +1,4 @@
-fastcore>=2.1.17
+fastcore>=2.2.2
 jupyasyncclient>=0.2.1
 mcpmini>=0.0.1
 aidialog>=0.0.7

{clikernel-0.2.0 → clikernel-0.2.2}/pyproject.toml

@@ -16,7 +16,7 @@ classifiers = [
 ]
 
 dependencies = [
-  "fastcore>=2.1.17",
+  "fastcore>=2.2.2",
   "jupyasyncclient>=0.2.1",
   "mcpmini>=0.0.1",
   "aidialog>=0.0.7",