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

akernel_runtime-0.1.7/.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.6 → akernel_runtime-0.1.7}/CHANGELOG.md

@@ -8,6 +8,16 @@ The project follows a pragmatic pre-1.0 changelog: breaking changes may occur, b
 
 No changes yet.
 
+## 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.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akernel-runtime
-Version: 0.1.6
+Version: 0.1.7
 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.7}/packages/npm/akernel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-akernel/akernel",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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.7}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "akernel-runtime"
-version = "0.1.6"
+version = "0.1.7"
 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.7/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.7
 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.7}/src/akernel_runtime.egg-info/SOURCES.txt

@@ -22,6 +22,7 @@ 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/workflows/ci.yml
 .github/workflows/release.yml
 docs/00-vision.md

{akernel_runtime-0.1.6 → akernel_runtime-0.1.7}/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.7}/src/context_kernel/__init__.py

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

{akernel_runtime-0.1.6 → akernel_runtime-0.1.7}/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,7 +1252,7 @@ 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:
@@ -1392,27 +1408,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") + "> "
 

{akernel_runtime-0.1.6 → akernel_runtime-0.1.7}/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
@@ -1417,6 +1417,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))