lcode-cli 0.32.0__tar.gz → 0.33.1__tar.gz

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/CHANGELOG.md

@@ -6,6 +6,37 @@ All notable changes to lcode are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.33.1] - 2026-10-14
+
+### Changed
+
+- A new logo, on GitHub, PyPI and the docs site (header, favicon, home page and link previews),
+  with a light version for dark backgrounds. `scripts/make_logos.py` makes every size from the
+  original.
+
+### Fixed
+
+- The README's images and links work on PyPI: the logo, the demo and the links to the license
+  and contributing guide were relative, so PyPI showed them broken.
+- The source package is half the size (0.6 MB): it no longer carries the docs' images.
+
+## [0.33.0] - 2026-10-14
+
+### Added
+
+- Steer while it works. Type while a request runs and press Enter: the line goes to the model at
+  its next step, as a note from you, without interrupting anything. The spinner shows what you're
+  typing and the notes waiting. Esc pauses after the current step, so you can look, then go on with
+  or without a note. Notes count as your requests for summaries and the review, and anything that
+  never reached the model goes back into the prompt. A command that runs for a while now shows a
+  spinner with its elapsed time. See
+  [Steer while it works](https://nasser1941.github.io/lcode/usage/#steer-while-it-works).
+
+### Fixed
+
+- "Where you left off" (`lcode -c`) and session titles showed lcode's own messages to the model,
+  such as a failed check, as if you had written them. They show your last request now.
+
 ## [0.32.0] - 2026-10-14
 
 ### Added
@@ -691,7 +722,9 @@ First public release.
 - `AGENTS.md` project instructions and `/init` to generate them.
 - One-line installer for Linux and macOS.
 
-[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.32.0...HEAD
+[Unreleased]: https://github.com/nasser1941/lcode/compare/v0.33.1...HEAD
+[0.33.1]: https://github.com/nasser1941/lcode/compare/v0.33.0...v0.33.1
+[0.33.0]: https://github.com/nasser1941/lcode/compare/v0.32.0...v0.33.0
 [0.32.0]: https://github.com/nasser1941/lcode/compare/v0.31.0...v0.32.0
 [0.31.0]: https://github.com/nasser1941/lcode/compare/v0.30.0...v0.31.0
 [0.30.0]: https://github.com/nasser1941/lcode/compare/v0.29.0...v0.30.0

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: lcode-cli
-Version: 0.32.0
+Version: 0.33.1
 Summary: A local-first terminal coding agent powered by open-weight models on your own GPU or Mac, via Ollama.
 Project-URL: Homepage, https://nasser1941.github.io/lcode/
 Project-URL: Documentation, https://nasser1941.github.io/lcode/
@@ -35,11 +35,12 @@ Requires-Dist: encord>=0.1.200; extra == 'encord'
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="docs/assets/logo.svg" width="96" alt="lcode logo">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo-dark.png">
+    <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo.png" width="360" alt="lcode">
+  </picture>
 </p>
 
-<h1 align="center">lcode</h1>
-
 <p align="center">
   <b>A coding agent that runs entirely on your own machine.</b><br>
   Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local
@@ -49,7 +50,7 @@ Description-Content-Type: text/markdown
   <a href="https://github.com/nasser1941/lcode/actions/workflows/ci.yml"><img src="https://github.com/nasser1941/lcode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://nasser1941.github.io/lcode/"><img src="https://github.com/nasser1941/lcode/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
   <a href="https://pypi.org/project/lcode-cli/"><img src="https://img.shields.io/pypi/v/lcode-cli.svg" alt="PyPI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20(Apple%20Silicon)-lightgrey.svg" alt="Linux and macOS">
 </p>
@@ -58,11 +59,11 @@ Description-Content-Type: text/markdown
   <a href="https://nasser1941.github.io/lcode/"><b>Documentation</b></a> ·
   <a href="https://nasser1941.github.io/lcode/installation/">Install</a> ·
   <a href="https://nasser1941.github.io/lcode/models/">Models</a> ·
-  <a href="CONTRIBUTING.md">Contributing</a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
+  <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
 </p>
 
 Point lcode at a repository and talk to it in your terminal. It explores the code, answers
@@ -222,8 +223,8 @@ See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). N
 ## Contributing
 
 Contributions are welcome: bug reports, model test results, docs and code. See
-[CONTRIBUTING.md](CONTRIBUTING.md). Please follow the [code of conduct](CODE_OF_CONDUCT.md), and
-report security issues privately as described in [SECURITY.md](SECURITY.md).
+[CONTRIBUTING.md](https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md). Please follow the [code of conduct](https://github.com/nasser1941/lcode/blob/main/CODE_OF_CONDUCT.md), and
+report security issues privately as described in [SECURITY.md](https://github.com/nasser1941/lcode/blob/main/SECURITY.md).
 
 ## Acknowledgements
 
@@ -234,4 +235,4 @@ the open-weight models from Qwen, Poolside, NVIDIA and OpenAI,
 
 ## License
 
-[MIT](LICENSE) © 2026 Naser Derakhshan
+[MIT](https://github.com/nasser1941/lcode/blob/main/LICENSE) © 2026 Naser Derakhshan

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/README.md

@@ -1,9 +1,10 @@
 <p align="center">
-  <img src="docs/assets/logo.svg" width="96" alt="lcode logo">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo-dark.png">
+    <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/logo.png" width="360" alt="lcode">
+  </picture>
 </p>
 
-<h1 align="center">lcode</h1>
-
 <p align="center">
   <b>A coding agent that runs entirely on your own machine.</b><br>
   Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local
@@ -13,7 +14,7 @@
   <a href="https://github.com/nasser1941/lcode/actions/workflows/ci.yml"><img src="https://github.com/nasser1941/lcode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://nasser1941.github.io/lcode/"><img src="https://github.com/nasser1941/lcode/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
   <a href="https://pypi.org/project/lcode-cli/"><img src="https://img.shields.io/pypi/v/lcode-cli.svg" alt="PyPI"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20(Apple%20Silicon)-lightgrey.svg" alt="Linux and macOS">
 </p>
@@ -22,11 +23,11 @@
   <a href="https://nasser1941.github.io/lcode/"><b>Documentation</b></a> ·
   <a href="https://nasser1941.github.io/lcode/installation/">Install</a> ·
   <a href="https://nasser1941.github.io/lcode/models/">Models</a> ·
-  <a href="CONTRIBUTING.md">Contributing</a>
+  <a href="https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 <p align="center">
-  <img src="docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
+  <img src="https://raw.githubusercontent.com/nasser1941/lcode/main/docs/assets/demo.svg" alt="lcode finding and fixing a bug, then running the tests" width="820">
 </p>
 
 Point lcode at a repository and talk to it in your terminal. It explores the code, answers
@@ -186,8 +187,8 @@ See the pinned [Roadmap issue](https://github.com/nasser1941/lcode/issues/10). N
 ## Contributing
 
 Contributions are welcome: bug reports, model test results, docs and code. See
-[CONTRIBUTING.md](CONTRIBUTING.md). Please follow the [code of conduct](CODE_OF_CONDUCT.md), and
-report security issues privately as described in [SECURITY.md](SECURITY.md).
+[CONTRIBUTING.md](https://github.com/nasser1941/lcode/blob/main/CONTRIBUTING.md). Please follow the [code of conduct](https://github.com/nasser1941/lcode/blob/main/CODE_OF_CONDUCT.md), and
+report security issues privately as described in [SECURITY.md](https://github.com/nasser1941/lcode/blob/main/SECURITY.md).
 
 ## Acknowledgements
 
@@ -198,4 +199,4 @@ the open-weight models from Qwen, Poolside, NVIDIA and OpenAI,
 
 ## License
 
-[MIT](LICENSE) © 2026 Naser Derakhshan
+[MIT](https://github.com/nasser1941/lcode/blob/main/LICENSE) © 2026 Naser Derakhshan

lcode_cli-0.33.1/docs/assets/extra.css

@@ -0,0 +1,60 @@
+.hero {
+  text-align: center;
+  padding: 1.5rem 0 0.5rem;
+}
+
+.hero h1 {
+  font-size: 3rem;
+  font-weight: 800;
+  margin: 0.5rem 0 0.25rem;
+  letter-spacing: -0.02em;
+}
+
+.hero-logo {
+  width: 360px;
+  max-width: 80%;
+  height: auto;
+  margin: 0.5rem 0 0.75rem;
+}
+
+.hero p {
+  font-size: 1.1rem;
+  max-width: 44rem;
+  margin: 0.5rem auto 1.25rem;
+}
+
+.demo {
+  display: block;
+  margin: 1.5rem auto;
+  border-radius: 10px;
+  box-shadow: 0 12px 40px rgba(0, 0, 0, 0.25);
+}
+
+/* In the page for screen readers and search, but the logo shows the name. */
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+}
+
+/* The buttons in the logo's colours. */
+.hero .md-button {
+  border-color: #00b8cc;
+  color: inherit;
+}
+
+.hero .md-button--primary {
+  background-color: #00e3fc;
+  border-color: #00e3fc;
+  color: #0a0e10;
+}
+
+.hero .md-button:hover,
+.hero .md-button:focus {
+  background-color: #00b8cc;
+  border-color: #00b8cc;
+  color: #0a0e10;
+}

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/docs/index.md

@@ -7,9 +7,10 @@ hide:
 
 <div class="hero" markdown>
 
-![lcode logo](assets/logo.svg){ .hero-logo }
+![lcode](assets/logo.png#only-light){ .hero-logo }
+![lcode](assets/logo-dark.png#only-dark){ .hero-logo }
 
-# lcode
+# lcode { .sr-only }
 
 **A coding agent that runs entirely on your own machine.**
 Open-weight models · up to 256K tokens of context · your NVIDIA GPU or Apple Silicon Mac · your code stays local.

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/docs/quickstart.md

@@ -12,7 +12,7 @@ lcode
 
 ```text
 ╭──────────────────────────────────────────────╮
-│ lcode v0.32.0 — local coding agent           │
+│ lcode v0.33.1 — local coding agent           │
 │                                              │
 │ model    lcode-qwen3.6-35b                   │
 │ context  256K tokens                         │

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/docs/usage.md

@@ -44,6 +44,8 @@ lcode update [--check]       # update lcode, and Ollama when it runs in Docker (
 | ++enter++ | Send |
 | ++esc++ ++enter++ or a trailing `\` | New line |
 | ++ctrl+c++ | Interrupt the model or a running command |
+| Typing while it works | A note for the model, read at its next step ([Steer while it works](#steer-while-it-works)) |
+| ++esc++ while it works | Pause after the current step |
 | ++ctrl+d++ | Quit |
 | ++shift+tab++ | Cycle permission mode: ask → plan → auto-edit → yolo |
 | ++tab++ | Complete slash commands and `@` paths |
@@ -231,9 +233,10 @@ Much of the waiting with a local model isn't the model thinking: it's loading th
 a long conversation before the first word. lcode says which, in the status line under a request:
 
 ```text
-⠋ Loading qwen3.6-35b into memory… (0 tokens, 9s · Ctrl+C to stop)
-⠋ Reading the conversation (18K tokens)… (0 tokens, 21s · Ctrl+C to stop)
-⠋ Thinking… (312 tokens, 27s · Ctrl+C to stop)
+⠋ Loading qwen3.6-35b into memory… (0 tokens, 9s · type a note · Esc pauses · Ctrl+C stops)
+⠋ Reading the conversation (18K tokens)… (0 tokens, 21s · type a note · Esc pauses · Ctrl+C stops)
+⠋ Thinking… (312 tokens, 27s · type a note · Esc pauses · Ctrl+C stops)
+⠋ Running the command… (48s · type a note · Esc pauses · Ctrl+C stops)
 ```
 
 It prints a line only when something worth knowing happens, and nothing while the model simply
@@ -252,6 +255,42 @@ While the model loads in the background at startup, the status bar says
 part of them in system RAM. Dense ones slow down a lot, to a few tokens a second, which is why they
 get the warning.
 
+## Steer while it works
+
+A request can take minutes with a local model. You don't have to stop it to change course: type
+while it works, and press ++enter++. The line goes to the model at its next step, after the step it's
+on finishes, as a note from you. Nothing is interrupted or thrown away.
+
+```text
+● edit_file(tally.py)
+  ✓ Edited tally.py
+✎ Note for the model: also add a --min-count N option that skips rare words
+```
+
+What you type shows under the spinner, since the terminal doesn't echo it while lcode works:
+
+```text
+⠋ Thinking… (212 tokens, 14s · type a note · Esc pauses · Ctrl+C stops)
+  ✎ also add a --min-count N opt▏  Enter adds it as a note
+```
+
+- A note typed while the model writes its final answer still counts: the model reads it before the
+  request ends.
+- Press ++esc++ to pause after the current step, to look at what it did. Then press ++enter++ to go
+  on, type a note to go on with it, or press ++ctrl+c++ to stop the request. Press ++esc++ again
+  before the step ends if you change your mind.
+- Notes count as your requests: they're kept when old messages are
+  [summarized](how-it-works.md#context-management), and the [review](#a-review-before-the-answer)
+  checks the change against them too.
+- When lcode asks you something, such as a permission, the keyboard is yours again for the answer.
+  Keys you typed just before the question appeared are dropped, so a note you were finishing can't
+  answer it by accident.
+- What never reached the model, such as a note typed as the request ended or after ++ctrl+c++, is
+  put back in the prompt.
+
+Steering works in the interactive session on macOS and Linux. `lcode -p` and the editor
+integration don't read the keyboard during a request.
+
 ## Notifications
 
 Local models take a while, so you'll often switch to something else during a request. lcode shows

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/mkdocs.yml

@@ -9,8 +9,8 @@ copyright: Copyright &copy; 2026 Naser Derakhshan · <a href="https://github.com
 theme:
   name: material
   custom_dir: overrides
-  logo: assets/logo.svg
-  favicon: assets/logo.svg
+  logo: assets/icon.png
+  favicon: assets/favicon.png
   icon:
     repo: fontawesome/brands/github
   font:

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/pyproject.toml

@@ -61,6 +61,9 @@ path = "src/lcode/__init__.py"
 [tool.hatch.build.targets.wheel]
 packages = ["src/lcode"]
 
+[tool.hatch.build.targets.sdist]
+exclude = ["docs/assets/*.png"]  # images for the README and the docs site: not needed to build or install
+
 [tool.ruff]
 line-length = 120
 target-version = "py310"

lcode_cli-0.33.1/scripts/make_logos.py

@@ -0,0 +1,62 @@
+"""Make the logo files the README, the docs and PyPI use, from docs/assets/logo-original.png.
+
+    uv run --with pillow python scripts/make_logos.py
+
+- logo.png: the mark and the name, for light backgrounds
+- logo-dark.png: the same with a light name, for dark backgrounds (GitHub's dark mode, the docs' dark scheme)
+- icon.png: the mark alone, square (the docs' header)
+- favicon.png: the mark, small (browser tabs)
+"""
+
+from pathlib import Path
+
+from PIL import Image
+
+ASSETS = Path(__file__).resolve().parent.parent / "docs" / "assets"
+WIDTH = 1200  # sharp at the README's 360 pixels on a 3x screen
+LIGHT_TEXT = (230, 237, 243)  # GitHub's dark-mode text colour
+PAD = 0.03  # around the logo, as a share of its width
+
+
+def is_mark(r: int, g: int, b: int) -> bool:
+    return b > 120 and g > 100 and r < 120  # the cyan of the mark (anti-aliased edges included)
+
+
+def main() -> None:
+    original = Image.open(ASSETS / "logo-original.png").convert("RGBA")
+    box = original.getchannel("A").point(lambda a: 255 if a > 8 else 0).getbbox()
+    logo = original.crop(box)
+    pad = int(logo.width * PAD)
+    framed = Image.new("RGBA", (logo.width + 2 * pad, logo.height + 2 * pad))
+    framed.paste(logo, (pad, pad))
+    height = round(framed.height * WIDTH / framed.width)
+    light = framed.resize((WIDTH, height), Image.LANCZOS)
+    light.save(ASSETS / "logo.png", optimize=True)
+
+    dark = light.copy()
+    pixels = dark.load()
+    for y in range(dark.height):
+        for x in range(dark.width):
+            r, g, b, a = pixels[x, y]
+            if a and not is_mark(r, g, b):
+                pixels[x, y] = (*LIGHT_TEXT, a)
+    dark.save(ASSETS / "logo-dark.png", optimize=True)
+
+    # The mark: the cyan part on the left.
+    cyan = Image.new("L", logo.size)
+    lp, cp = logo.load(), cyan.load()
+    for y in range(logo.height):
+        for x in range(logo.width):
+            r, g, b, a = lp[x, y]
+            if a > 8 and is_mark(r, g, b):
+                cp[x, y] = 255
+    mark = logo.crop(cyan.getbbox())
+    side = round(max(mark.size) * 1.12)
+    square = Image.new("RGBA", (side, side))
+    square.paste(mark, ((side - mark.width) // 2, (side - mark.height) // 2))
+    square.resize((512, 512), Image.LANCZOS).save(ASSETS / "icon.png", optimize=True)
+    square.resize((96, 96), Image.LANCZOS).save(ASSETS / "favicon.png", optimize=True)
+
+
+if __name__ == "__main__":
+    main()

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/scripts/social-preview.html

@@ -8,14 +8,14 @@
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;800&family=JetBrains+Mono:wght@400;700&display=block" rel="stylesheet">
 <style>
-  :root { --cyan: #22d3ee; --violet: #a78bfa; --text: #e2e8f0; --muted: #94a3b8; }
+  :root { --cyan: #00e3fc; --cyan-light: #8ef4ff; --text: #e6edf3; --muted: #94a3b8; }
   * { box-sizing: border-box; margin: 0; padding: 0; }
   html, body { width: 1280px; height: 640px; overflow: hidden; }
   body {
     font-family: Inter, system-ui, sans-serif; color: var(--text);
     background:
-      radial-gradient(900px 500px at 85% 20%, rgba(167, 139, 250, 0.22), transparent 60%),
-      radial-gradient(700px 500px at 10% 90%, rgba(34, 211, 238, 0.18), transparent 60%),
+      radial-gradient(900px 500px at 85% 20%, rgba(0, 227, 252, 0.14), transparent 60%),
+      radial-gradient(700px 500px at 10% 90%, rgba(0, 227, 252, 0.16), transparent 60%),
       linear-gradient(135deg, #0b1120 0%, #0f172a 55%, #111827 100%);
     display: flex; align-items: center; padding: 64px 72px; gap: 56px;
   }
@@ -25,12 +25,11 @@
     background-size: 40px 40px;
   }
   .left { flex: 1 1 0; position: relative; }
-  .brand { display: flex; align-items: center; gap: 22px; margin-bottom: 26px; }
-  .brand svg { width: 92px; height: 92px; filter: drop-shadow(0 10px 30px rgba(34, 211, 238, 0.25)); }
-  h1 { font-size: 104px; font-weight: 800; letter-spacing: -0.04em; line-height: 1; }
+  .brand { margin: 0 0 30px -10px; }
+  .brand img { height: 118px; display: block; filter: drop-shadow(0 10px 30px rgba(0, 227, 252, 0.22)); }
   .tagline { font-size: 34px; font-weight: 600; line-height: 1.25; margin-bottom: 30px; max-width: 560px; }
   .tagline span {
-    background: linear-gradient(90deg, var(--cyan), var(--violet)); -webkit-background-clip: text; color: transparent;
+    background: linear-gradient(90deg, var(--cyan), var(--cyan-light)); -webkit-background-clip: text; color: transparent;
   }
   .chips { display: flex; flex-wrap: wrap; gap: 12px; margin-bottom: 34px; max-width: 580px; }
   .chip {
@@ -56,18 +55,7 @@
 </head>
 <body>
   <div class="left">
-    <div class="brand">
-      <svg viewBox="0 0 128 128" aria-hidden="true">
-        <defs>
-          <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#1e293b"/><stop offset="1" stop-color="#0f172a"/></linearGradient>
-          <linearGradient id="fg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#22d3ee"/><stop offset="1" stop-color="#a78bfa"/></linearGradient>
-        </defs>
-        <rect width="128" height="128" rx="28" fill="url(#bg)" stroke="rgba(148,163,184,.35)" stroke-width="2"/>
-        <path d="M34 40 L62 64 L34 88" fill="none" stroke="url(#fg)" stroke-width="12" stroke-linecap="round" stroke-linejoin="round"/>
-        <rect x="70" y="80" width="30" height="10" rx="5" fill="url(#fg)"/>
-      </svg>
-      <h1>lcode</h1>
-    </div>
+    <div class="brand"><img src="../docs/assets/logo-dark.png" alt="lcode"></div>
     <p class="tagline">A coding agent that runs <span>entirely on your own machine.</span></p>
     <div class="chips">
       <div class="chip">Open-weight models</div>

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/src/lcode/__init__.py

@@ -3,7 +3,7 @@
 From a program: `from lcode import Session` (see lcode.api).
 """
 
-__version__ = "0.32.0"
+__version__ = "0.33.1"
 
 API = ("Session", "Result", "Options", "SetupError")
 

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/src/lcode/agent.py

@@ -52,6 +52,7 @@ from lcode.permissions import Permissions
 from lcode.render import MarkdownStreamer
 from lcode.repeats import Repeats
 from lcode.sandbox import Sandbox, SandboxError, project_root
+from lcode.steer import NOTE_INTRO, Steering
 from lcode.tools import (
     LSP_SCHEMA,
     MEMORY_SCHEMA,
@@ -224,10 +225,12 @@ class Progress:
     arrives, for example while the model writes a long file into a tool call.
     """
 
-    def __init__(self, phase: str = "Thinking") -> None:
+    def __init__(self, phase: str = "Thinking", steering: Steering | None = None, tokens: bool = True) -> None:
         self.started = self.last_chunk = time.time()
         self.phase = phase
         self.chars = 0
+        self.steering = steering  # the note being typed and the notes waiting, shown on a second line
+        self.tokens = tokens  # False for a command running: no tokens to count
 
     def update(self, phase: str, text: str) -> None:
         self.phase, self.chars, self.last_chunk = phase, self.chars + len(text), time.time()
@@ -240,9 +243,11 @@ class Progress:
         now = time.time()
         streaming = self.phase in ("Thinking", "Writing")  # loading and reading say what they are throughout
         phase = self.phase if now - self.last_chunk < 3 or not streaming else "Working"
-        return Text.from_markup(
-            f"[cyan]{phase}…[/] [dim]({self.chars // 4} tokens, {now - self.started:.0f}s · Ctrl+C to stop)[/]"
-        )
+        tokens = f"{self.chars // 4} tokens, " if self.tokens else ""
+        keys = "Ctrl+C to stop" if self.steering is None else "type a note · Esc pauses · Ctrl+C stops"
+        line = Text.from_markup(f"[cyan]{phase}…[/] [dim]({tokens}{now - self.started:.0f}s · {keys})[/]")
+        below = self.steering.status() if self.steering is not None else None
+        return line if below is None else Text("\n").join([line, below])
 
 
 @dataclass
@@ -321,6 +326,9 @@ class Agent:
         self.read_only = False  # only read-only shell commands
         self.no_changes = ""  # set during a review: why nothing may change (read-only tools only)
         self.cancel: threading.Event | None = None  # set from another thread to stop
+        self.steering: Steering | None = None  # notes typed and pauses asked for during a request (lcode.repl)
+        self.turn_requests: list[str] = []  # the request, then the notes added to it while it ran
+        self.unsent = ""  # typed during the last request but never sent to the model: back in the prompt (lcode.repl)
         self.on_tool = None  # called with (name, arguments) before each tool runs
         self.jobs = Jobs()  # background commands (shared with subagents)
         self.turn_started = 0.0  # when the running request started (time.monotonic)
@@ -749,7 +757,7 @@ class Agent:
         """Stream one model response, rendering thinking/content live. Returns the assistant message."""
         content, thinking, tool_calls, final = "", "", [], {}
         md = MarkdownStreamer(self.console)
-        progress = Progress()
+        progress = Progress(steering=self.steering)
         watch = self.before_request(progress)
         status = None
         printed_thinking = False
@@ -845,15 +853,10 @@ class Agent:
         diff, changed = review.diff_of(self.tools.before, self.current_text, budget)
         if changed < review.MIN_CHANGED_LINES:
             return []
-        request = next(
-            (
-                context_tools.request_text(str(m.get("content", "")))
-                for m in reversed(self.messages)
-                if m.get("role") == "user"
-                and not str(m.get("content", "")).startswith(("[lcode]", sessions.SUMMARY_PREFIX))
-            ),
-            "",
-        )
+        request = self.turn_requests[0] if self.turn_requests else ""
+        if len(self.turn_requests) > 1:
+            added = "\n".join(f"- {note}" for note in self.turn_requests[1:])
+            request += f"\n\nWhat the user added while you worked:\n{added}"
         try:
             with self.console.status("Reviewing the change against your request…", spinner="dots"):
                 problems = review.run(self, request, answer, diff)
@@ -1069,6 +1072,7 @@ class Agent:
         self.turn_status = "running"
         note = planning.NOTE if self.planning() and self.allowed_tools is None else ""
         self.messages.append({"role": "user", "content": self.expand_mentions(user_text) + note})
+        self.turn_requests = [user_text.strip()]
         self.repeats.reset()
         self.check_results = []
         self.review_results = None
@@ -1081,6 +1085,8 @@ class Agent:
         for step in range(self.max_steps):
             if self.cancel is not None and self.cancel.is_set():
                 raise KeyboardInterrupt
+            if step and self.steering is not None:
+                self.steer()
             if step and self.autosave:
                 self.save()  # a crash or a closed terminal loses at most this step
             self.maybe_compact()
@@ -1126,6 +1132,8 @@ class Agent:
                 )
                 continue
             if not calls:
+                if self.steering is not None and self.steering.waiting():
+                    continue  # the user added a note while the model wrote its answer: it reads the note first
                 check = self.project_check() if changed and not verified else None
                 if check is not None and check_rounds < checks.MAX_ROUNDS:
                     check_rounds += 1
@@ -1241,6 +1249,34 @@ class Agent:
         self.turn_status = "success"
         self.print_stats()
 
+    def steer(self) -> None:
+        """Between two steps: pause if the user pressed Esc, then hand the model the notes typed meanwhile."""
+        steering = self.steering
+        if steering is None:
+            return
+        if steering.take_pause():
+            self.console.print(
+                Text(
+                    "⏸ Paused. Press Enter to go on, type a note to go on with it, or press Ctrl+C to stop the request.",
+                    style="yellow",
+                )
+            )
+            note = steering.ask("  ⏸ ").strip()
+            if note:
+                steering.add(note)
+        notes = steering.take()
+        if not notes:
+            return
+        self.turn_requests += notes
+        self.messages.append({"role": "user", "content": "\n\n".join(notes) + "\n\n" + NOTE_INTRO})
+        for note in notes:
+            shown = note if len(note) <= 200 else note[:200] + "…"
+            self.console.print(Text(f"✎ Note for the model: {shown}", style="cyan"))
+
+    def activity(self, phase: str):
+        """A spinner with the elapsed time while something runs (a command), with the note being typed under it."""
+        return self.console.status(Progress(phase, self.steering, tokens=False), spinner="dots")
+
     def print_stats(self) -> None:
         pct = 100 * self.ctx_used / self.settings.context
         self.console.print(

{lcode_cli-0.32.0 → lcode_cli-0.33.1}/src/lcode/permissions.py

@@ -198,6 +198,7 @@ class Permissions:
         self.always: set[str] = set()
         self.rules = Rules()  # allow and deny lists from the settings (lcode.hooks)
         self.on_prompt = None  # called with the title before lcode asks the user (notification hooks)
+        self.read_line: Callable[[str], str] | None = None  # asks instead of input() (lcode.steer, during a request)
         # Decides instead of asking (lcode.api, lcode acp): True, False, or a message saying why not.
         self.approve: Callable[[dict], bool | str] | None = None
 
@@ -243,7 +244,8 @@ class Permissions:
         if kind == "mcp":
             scope = scope.replace(":", " › ", 1)
         try:
-            answer = input(f"  Allow? [y]es / [a]lways for '{scope}' this session / [n]o (+ optional reason): ")
+            question = f"  Allow? [y]es / [a]lways for '{scope}' this session / [n]o (+ optional reason): "
+            answer = (self.read_line or input)(question)
         except EOFError:
             return False, "The user denied this action (no input available)."
         answer = answer.strip()