akernel-runtime 0.1.6__tar.gz → 0.1.8__tar.gz

akernel_runtime-0.1.8/.github/release-notes/v0.1.7.md

@@ -0,0 +1,32 @@
+# Context Kernel v0.1.7
+
+This release adds real-time interactive completions to `akernel`.
+
+## Install
+
+Python:
+
+```powershell
+python -m pip install --user --upgrade akernel-runtime
+akernel setup
+akernel
+```
+
+npm launcher:
+
+```powershell
+npm install -g @context-akernel/akernel
+akernel setup
+akernel
+```
+
+## Highlights
+
+- Typing `/` now opens command completions such as `/help`, `/status`, `/model`, and `/cost`.
+- Typing `@` now opens workspace file completions for attaching files.
+- Non-interactive shells and scripts still fall back to standard `input()` behavior.
+
+## Verification
+
+- Added completion unit coverage for slash commands and `@` file candidates.
+- Ran the full Python test suite.

akernel_runtime-0.1.8/.github/release-notes/v0.1.8.md

@@ -0,0 +1,14 @@
+# Context Kernel v0.1.8
+
+This patch fixes the default TUI rendering rhythm so chat turns no longer flood the terminal with repeated full-screen layouts.
+
+## Highlights
+
+- The startup workspace view still appears once.
+- Each normal user message now appends only the user turn, compact status, and assistant result.
+- Full redraw remains available through `/clear` or `AKERNEL_ALT_SCREEN=1`.
+
+## Verification
+
+- Added regression coverage to ensure normal TUI turns do not repeatedly print the full header.
+- Ran the full Python test suite.

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/CHANGELOG.md

@@ -8,6 +8,26 @@ The project follows a pragmatic pre-1.0 changelog: breaking changes may occur, b
 
 No changes yet.
 
+## 0.1.8 - 2026-05-14
+
+### Changed
+
+- Changed the default TUI loop to render the full workspace view once, then append only incremental user/status/assistant updates for each turn.
+
+### Fixed
+
+- Prevented normal chat turns from repeatedly printing the full fixed UI layout and filling the terminal scrollback.
+
+## 0.1.7 - 2026-05-14
+
+### Added
+
+- Added real-time chat input completions for slash commands and `@` workspace file search.
+
+### Changed
+
+- Added `prompt_toolkit` as the interactive input dependency, with automatic fallback to native `input()` in non-interactive terminals.
+
 ## 0.1.6 - 2026-05-14
 
 ### Added

{akernel_runtime-0.1.6/src/akernel_runtime.egg-info → akernel_runtime-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akernel-runtime
-Version: 0.1.6
+Version: 0.1.8
 Summary: Agent Kernel: a CLI-first context-native agent runtime prototype.
 Author: Context Kernel contributors
 License-Expression: Apache-2.0
@@ -20,6 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
+Requires-Dist: prompt_toolkit>=3.0.43
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/packages/npm/akernel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-akernel/akernel",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "npm launcher wrapper for the Context Kernel akernel CLI.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/huanxin0825-ctrl/context-akernel#readme",

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "akernel-runtime"
-version = "0.1.6"
+version = "0.1.8"
 description = "Agent Kernel: a CLI-first context-native agent runtime prototype."
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE"]
 requires-python = ">=3.10"
-dependencies = []
+dependencies = ["prompt_toolkit>=3.0.43"]
 keywords = ["agent", "cli", "context", "llm", "token-budget"]
 authors = [
   { name = "Context Kernel contributors" },

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8/src/akernel_runtime.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akernel-runtime
-Version: 0.1.6
+Version: 0.1.8
 Summary: Agent Kernel: a CLI-first context-native agent runtime prototype.
 Author: Context Kernel contributors
 License-Expression: Apache-2.0
@@ -20,6 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
+Requires-Dist: prompt_toolkit>=3.0.43
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/src/akernel_runtime.egg-info/SOURCES.txt

@@ -22,6 +22,8 @@ wake.ps1
 .github/release-notes/v0.1.4.md
 .github/release-notes/v0.1.5.md
 .github/release-notes/v0.1.6.md
+.github/release-notes/v0.1.7.md
+.github/release-notes/v0.1.8.md
 .github/workflows/ci.yml
 .github/workflows/release.yml
 docs/00-vision.md

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/src/akernel_runtime.egg-info/requires.txt

@@ -1,3 +1,4 @@
+prompt_toolkit>=3.0.43
 
 [dev]
 build>=1.2

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/src/context_kernel/__init__.py

@@ -1,3 +1,3 @@
 """Context Kernel CLI-first agent runtime prototype."""
 
-__version__ = "0.1.6"
+__version__ = "0.1.8"

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/src/context_kernel/cli.py

@@ -43,6 +43,22 @@ from .verifier import verify_trace
 
 DEFAULT_PRIMARY_MODEL = "gpt-5.5"
 DEFAULT_AUXILIARY_MODEL = "gpt-5.3-codex"
+CHAT_COMMANDS: list[tuple[str, str]] = [
+    ("/help", "show command palette"),
+    ("/status", "show workspace and runtime status"),
+    ("/model", "show primary and auxiliary model roles"),
+    ("/config", "show setup and environment guidance"),
+    ("/compact", "show compact task brief"),
+    ("/paste", "enter a multi-line task"),
+    ("/task", "print current task session JSON"),
+    ("/runs", "list recent agent runs"),
+    ("/cost", "print last run cost report"),
+    ("/up", "show older transcript lines"),
+    ("/down", "move back toward latest messages"),
+    ("/latest", "jump to latest messages"),
+    ("/clear", "clear transcript"),
+    ("/exit", "leave interactive session"),
+]
 OPENAI_ENV_KEYS = {
     "api_key": "AKERNEL_OPENAI_API_KEY",
     "base_url": "AKERNEL_OPENAI_BASE_URL",
@@ -1075,7 +1091,7 @@ def cmd_chat(args: argparse.Namespace) -> None:
     print_chat_header(workspace, task_id, args)
     while True:
         try:
-            request = input(chat_prompt(args)).strip()
+            request = read_chat_input(chat_prompt(args), workspace).strip()
         except EOFError:
             print("")
             break
@@ -1236,15 +1252,15 @@ def run_chat_loop_tui(
         render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
         while True:
             try:
-                request = input(tui_prompt(args)).strip()
+                request = read_chat_input(tui_prompt(args), workspace).strip()
             except EOFError:
                 break
             except KeyboardInterrupt:
                 transcript.append({"role": "system", "title": "Interrupted", "text": "Keyboard interrupt received."})
-                render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="interrupted", state=state, clear=use_alt_screen)
+                render_chat_tui_update(workspace, task_id, args, transcript, last_report, pending_context, status="interrupted", state=state, clear=use_alt_screen)
                 break
             if not request:
-                render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
+                render_chat_tui_update(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
                 continue
             lowered = request.lower()
             if lowered in {"/exit", "/quit", "exit", "quit"}:
@@ -1267,14 +1283,15 @@ def run_chat_loop_tui(
                 state=state,
             ):
                 last_report = state.get("last_report")
-                render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
+                render_chat_tui_update(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
                 continue
 
             request_for_agent = merge_pending_context(request, pending_context)
             pending_context.clear()
             state["scroll_offset"] = 0
             transcript.append({"role": "user", "title": "You", "text": request_for_agent})
-            render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="running", state=state, clear=use_alt_screen)
+            render_chat_tui_message({"role": "user", "title": "You", "text": request_for_agent})
+            render_chat_tui_status("running", args, pending_context)
             last_report = AgentLoop(workspace).run(
                 request_for_agent,
                 provider_name=args.provider,
@@ -1292,7 +1309,8 @@ def run_chat_loop_tui(
                 expect_json=args.expect_json,
             )
             transcript.append({"role": "assistant", "title": "Assistant", "text": format_tui_report(last_report)})
-            render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status="ready", state=state, clear=use_alt_screen)
+            render_chat_tui_message({"role": "assistant", "title": "Assistant", "text": format_tui_report(last_report)})
+            render_chat_tui_status("ready", args, pending_context, last_report=last_report)
     finally:
         if use_alt_screen:
             print("\033[?1049l", end="")
@@ -1392,27 +1410,62 @@ def capture_chat_output(func: Any) -> str:
 
 def format_chat_help_text() -> str:
     rows = [
-        ("/help", "show this command palette"),
-        ("/status", "show workspace and runtime status"),
-        ("/model", "show primary and auxiliary model roles"),
-        ("/config", "show setup and environment guidance"),
-        ("/compact", "show the compact task brief used for resume context"),
-        ("/paste", "enter a multi-line task; finish with /end"),
-        ("@path", "attach a workspace file to the next task"),
-        ("!command", "run a policy-checked command and attach its summary"),
-        ("/task", "print the current task session JSON"),
-        ("/runs", "list recent agent runs"),
-        ("/cost", "print the last agent run cost report"),
-        ("/up", "show older transcript lines in the viewport"),
-        ("/down", "move the viewport back toward latest messages"),
-        ("/latest", "jump to the newest transcript lines"),
-        ("/clear", "clear the transcript"),
-        ("/exit", "leave the interactive session"),
+        *CHAT_COMMANDS,
         ("@query", "search current workspace files; use @1, @2... to attach a listed match"),
+        ("!command", "run a policy-checked command and attach its summary"),
     ]
     return "\n".join(f"{name:<10} {description}" for name, description in rows)
 
 
+def read_chat_input(prompt: str, workspace: Workspace) -> str:
+    if not should_use_prompt_toolkit():
+        return input(prompt)
+    try:
+        from prompt_toolkit import PromptSession
+        from prompt_toolkit.completion import Completer, Completion
+        from prompt_toolkit.formatted_text import ANSI
+        from prompt_toolkit.shortcuts import CompleteStyle
+    except ImportError:
+        return input(prompt)
+
+    class ChatCompleter(Completer):
+        def get_completions(self, document: Any, complete_event: Any) -> Any:
+            text = document.text_before_cursor
+            for value, description in chat_completion_items(workspace.root, text):
+                yield Completion(value, start_position=-len(text), display=value, display_meta=description)
+
+    session = PromptSession(
+        completer=ChatCompleter(),
+        complete_while_typing=True,
+        complete_in_thread=True,
+        complete_style=CompleteStyle.MULTI_COLUMN,
+        reserve_space_for_menu=6,
+    )
+    return session.prompt(ANSI(prompt))
+
+
+def should_use_prompt_toolkit() -> bool:
+    if os.environ.get("AKERNEL_NO_COMPLETION"):
+        return False
+    return bool(sys.stdin.isatty() and sys.stdout.isatty())
+
+
+def chat_completion_items(root: Path, text: str, *, limit: int = 12) -> list[tuple[str, str]]:
+    value = text.strip()
+    if value.startswith("/"):
+        query = value.casefold()
+        return [
+            (command, description)
+            for command, description in CHAT_COMMANDS
+            if command.casefold().startswith(query)
+        ][:limit]
+    if value.startswith("@"):
+        query = value[1:].strip()
+        matches = find_workspace_files(root, query, limit=limit)
+        return [(f"@{path}", "attach file") for path in matches]
+    return []
+
+
 def tui_prompt(args: argparse.Namespace) -> str:
     return chat_color("\nakernel", "cyan", bold=True) + chat_color(f" [{primary_model(args)}]", "dim") + "> "
 
@@ -1434,6 +1487,50 @@ def render_chat_tui_screen(
     print(prefix + screen + ("\n" if not clear else ""), end="")
 
 
+def render_chat_tui_update(
+    workspace: Workspace,
+    task_id: str,
+    args: argparse.Namespace,
+    transcript: list[dict[str, str]],
+    last_report: dict[str, Any] | None,
+    pending_context: list[str],
+    *,
+    status: str,
+    state: dict[str, Any] | None = None,
+    clear: bool = True,
+) -> None:
+    if clear:
+        render_chat_tui_screen(workspace, task_id, args, transcript, last_report, pending_context, status=status, state=state, clear=True)
+        return
+    if transcript:
+        render_chat_tui_message(transcript[-1])
+    render_chat_tui_status(status, args, pending_context, last_report=last_report)
+
+
+def render_chat_tui_message(item: dict[str, str]) -> None:
+    width = chat_width()
+    role = item.get("role", "system")
+    title = item.get("title", role)
+    label = tui_role_label(role, title)
+    prefix = "  " if role != "user" else "> "
+    print("")
+    print(chat_color(truncate_line(label, width), "cyan" if role == "system" else "green" if role == "assistant" else "yellow", bold=True))
+    for line in wrap_plain(item.get("text", ""), width=max(20, width - len(prefix))).splitlines():
+        print(truncate_line(prefix + line, width))
+
+
+def render_chat_tui_status(
+    status: str,
+    args: argparse.Namespace,
+    pending_context: list[str],
+    *,
+    last_report: dict[str, Any] | None = None,
+) -> None:
+    tokens = 0 if not last_report else last_report.get("totals", {}).get("total_tokens", 0)
+    summary = f"{status} | provider {args.provider} | primary {primary_model(args)} | attached {len(pending_context)} | tokens {tokens}"
+    print(chat_color(truncate_line(summary, chat_width()), "dim"))
+
+
 def build_chat_tui_screen(
     workspace: Workspace,
     task_id: str,

{akernel_runtime-0.1.6 → akernel_runtime-0.1.8}/tests/test_runtime.py

@@ -10,7 +10,7 @@ from unittest.mock import patch
 from context_kernel.agent_reports import build_agent_cost_report, render_agent_cost_report
 from context_kernel.benchmarks import BenchmarkRunner, render_benchmark_evidence_markdown, render_benchmark_markdown
 from context_kernel.budget import allocate_budget
-from context_kernel.cli import build_chat_tui_screen, load_batch_patch_specs, main, print_agent_report
+from context_kernel.cli import build_chat_tui_screen, chat_completion_items, load_batch_patch_specs, main, print_agent_report
 from context_kernel.context import ContextBuilder
 from context_kernel.evals import EvalRunner
 from context_kernel.global_memory import pull_global_memories, push_global_memories
@@ -1357,6 +1357,7 @@ class RuntimeTests(unittest.TestCase):
             self.assertIn("Assistant", output)
             self.assertIn("Mock agent response", output)
             self.assertIn("bye", output)
+            self.assertEqual(output.count("AKERNEL // READY"), 1)
 
     def test_tui_screen_can_render_older_history_window(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
@@ -1417,6 +1418,19 @@ class RuntimeTests(unittest.TestCase):
             self.assertIn("Attached File", output)
             self.assertIn("Mock agent response", output)
 
+    def test_chat_completion_items_include_commands_and_files(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            (root / "README.md").write_text("demo", encoding="utf-8")
+            (root / "src").mkdir()
+            (root / "src" / "runtime.py").write_text("print('ok')", encoding="utf-8")
+
+            command_items = chat_completion_items(root, "/mo")
+            file_items = chat_completion_items(root, "@run")
+
+            self.assertIn(("/model", "show primary and auxiliary model roles"), command_items)
+            self.assertIn(("@src/runtime.py", "attach file"), file_items)
+
     def test_tui_screen_surfaces_task_plan_and_command_strip(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             workspace = Workspace(Path(tmp))