kolega-code 0.25.2__tar.gz → 0.26.0__tar.gz

{kolega_code-0.25.2 → kolega_code-0.26.0}/CHANGELOG.md

@@ -6,6 +6,151 @@ This project uses GitHub Releases for detailed generated release notes. This fil
 
 ## Unreleased
 
+## 0.26.0 - 2026-07-31
+
+### Added
+
+- **New bundled research and writing skills.** `deep-research` orchestrates
+  evidence-backed research and materializes cited reports, while `humanizer`
+  helps revise generated prose into more natural writing.
+- **OpenRouter provider.** `openrouter` (`OPENROUTER_API_KEY`) reaches the
+  OpenRouter gateway, shipping a generated catalog of every tool-capable
+  OpenRouter model with per-model context, output, vision, reasoning-effort and
+  edit-protocol metadata. Because the catalog runs to hundreds of models, the
+  Settings picker, `/model` and the sub-agent model catalog list OpenRouter's 20
+  most-used models — in the order of OpenRouter's own LLM Leaderboard — while
+  every other catalogued model stays selectable by exact ID via `--model`,
+  `/model`, `KOLEGA_CODE_MODEL` or `settings.json`. Reasoning effort maps to
+  OpenRouter's nested `reasoning` control, prompt caching is enabled
+  automatically, and `max_tokens` is deliberately not sent so an output cap
+  cannot bias upstream routing (override with
+  `KOLEGA_CODE_OPENROUTER_MAX_TOKENS`). Models default to the Claude Code-style
+  edit tool, except OpenAI models which use Codex `apply_patch`.
+- **`kolega-code models` command.** `models list` inspects the model catalog
+  (`--provider`, `--featured`, `--sort`, `--json`), and `models refresh` caches
+  OpenRouter's current model list locally so models published after a release
+  can be used without upgrading. Startup merges the cache without any network
+  access; `KOLEGA_CODE_OPENROUTER_CATALOG` and
+  `KOLEGA_CODE_DISABLE_OPENROUTER_CATALOG` control it.
+- **Settings "Other…" model picker.** The main Model dropdown and every Agent
+  Models role row lead with OpenRouter's most-used models and then offer an
+  "Other…" entry backed by a free-text field, so any catalogued model id
+  (bundled or added by `models refresh`) can be selected from Settings instead
+  of only by exact ID on the command line. Typed ids are validated against the
+  catalog before saving, and the Browser role keeps its vision-capability gate.
+- **Worktree-aware startup and workspace switching.** Interactive and headless
+  launches can select a registered checkout with `--worktree`, or create one
+  safely with `--create-worktree` plus optional `--from` and
+  `--worktree-path`. In the TUI, the top-level build-mode agent can switch its
+  complete active workspace between registered sibling worktrees, but only when
+  the user has explicitly asked it to: the agent never creates a worktree or
+  moves the session on its own initiative, plan mode has no workspace-switching
+  tool at all, and every agent-initiated switch is confirmed by the user first,
+  with a declined or unanswered prompt leaving the workspace unchanged. Once
+  approved, the switch commits immediately and applies at the end of the agent's
+  turn by rebuilding the workspace — terminal, filesystem, LSP, snapshots,
+  skills, autocomplete, and Changes/Rewind scope move together — after which the
+  agent is prompted to continue in the new checkout. Session identity and
+  sibling-checkout isolation remain unchanged, and active workspace selection
+  persists across resume.
+- The public `ToolExtension` API now accepts additive `exclusive_tools`
+  metadata for tools that must run alone in a model tool-call batch.
+- `browser_scroll` on both browser backends, taking exactly one of a target, a
+  count of viewports, or an absolute offset. On a page too large to snapshot in
+  one call, scrolling is how the rest is reached, and until now nothing could
+  move the viewport on the Chrome backend at all.
+
+### Changed
+
+- The TUI `set_goal` tool is now build-mode only. Plan mode's tool inventory is
+  meant to be read-only plus investigation, and a planning turn should not be
+  able to start an autonomous loop on its own; `/goal <condition>` still works in
+  either mode, and a goal set in build mode keeps driving turns after switching
+  to plan mode.
+- Project memory, repository guidance (`AGENTS.md`/`KOLEGA.md`), and the current
+  date are no longer rendered into the system prompt. They now reach the agent as
+  `<system-reminder>` context updates, sent once each time they change. Because
+  providers cache on a prefix match and the system prompt is processed ahead of
+  every message, a single `edit_memory` call previously invalidated the cached
+  prefix for the whole conversation and re-billed it on the next turn — on the
+  order of a dollar per write in a long session, and worse on providers whose
+  prefix caching is automatic and offers no way to compensate. The system prompt
+  is now byte-stable for the life of a session.
+- Prompt-cache breakpoints are placed more deliberately: the tool list and the
+  system prompt each get one with a 1-hour TTL, and the conversation carries two
+  rolling breakpoints a turn apart rather than one. A single trailing breakpoint
+  could fail to match after a turn with many parallel tool calls, which discarded
+  the whole conversation's cache; the second one bounds that loss to one turn.
+
+- The Chrome browser backend now works on large real-world pages. Selector
+  resolution, snapshots, text search and focus handling previously failed
+  outright on any page over about a thousand DOM nodes, so an ordinary
+  application page returned an empty snapshot and refused every selector. Work
+  is now bounded by a wall-clock budget with the browser's own APIs doing the
+  filtering, and a bound that is reached degrades with a report instead of
+  failing.
+- Snapshots emit the nodes nearest the viewport first and attach a `Coverage:`
+  line naming what was omitted, why, and where the viewport sits in the page, so
+  a partial snapshot reads as "narrow the scope" rather than "the page is
+  unreadable".
+- `browser_find` distinguishes three outcomes: absent from the page, present but
+  outside the region the snapshot covered, and undetermined because the search
+  was truncated. Only the first is a reliable absence.
+- Text waits that could not read the whole page now fail immediately with a
+  `search_truncated` explanation instead of polling to a timeout and implying the
+  text was not there.
+- `browser_press_key` scrolls for `PageDown`, `PageUp`, `Home`, `End`, arrow keys
+  and `Space`, matching the Playwright backend, unless the page handles the key
+  itself or focus is in a text field or select.
+- Chrome snapshot `depth` now counts emitted nodes rather than raw DOM nesting,
+  so it means roughly what it means on the Playwright backend.
+- Tall full-page screenshots on Chrome are clipped from the current scroll
+  position and report the omission, instead of being downscaled until unreadable.
+  Native Messaging envelopes are now bounded per direction, following Chrome's
+  own asymmetric limits.
+- Errors from the Chrome extension keep their error code, and codes that mean
+  "too large to cover in one call" carry the concrete next step.
+- The responsiveness watchdog now captures stacks for event-loop stalls from ~1
+  second (was 5) and counts shorter gaps into a periodic `loop_gap_histogram`
+  diagnostics entry, so choppy-but-not-frozen UI leaves evidence instead of
+  nothing. Stack dumps are capped per session so a pathological session cannot
+  fill the timeline.
+- `read_image` now refuses files above 20 MB (the limit image encoding already
+  applied elsewhere) instead of reading them and having the provider reject the
+  request.
+
+### Fixed
+
+- Standalone generated `<system-reminder>` context no longer appears in the TUI
+  transcript after resuming a session or rebuilding the agent for model and
+  settings changes; the context remains unchanged in model and session history.
+- Continuing after cancelling an in-flight tool call no longer duplicates the
+  next prompt or makes Anthropic reject the request for exceeding its maximum
+  of four `cache_control` blocks.
+- Plan mode now carries requested Build-mode session handoffs into approved
+  plans: worktree plans switch the complete session before setup or edits in
+  the linked checkout, and authorized autonomous-goal plans place `set_goal` at
+  the intended transition after any required prerequisites.
+- Stopped image-heavy sessions from freezing the TUI. Building request history
+  re-encoded every screenshot in history on every LLM request, on the event
+  loop — dozens of multi-second stalls per session, multiplied by each running
+  sub-agent. Resized copies are now memoized per image and dimension cap
+  (surviving the small byte-budget shifts a newly captured screenshot causes),
+  and the repair/adapt pass runs in a worker thread.
+- Moved LLM request preparation off the event loop. Building a request body is
+  proportional to conversation size, and on the Anthropic streaming path it
+  blocked the UI for 0.4 s per request with an image-heavy history — multiplied
+  by every concurrently running sub-agent. The worst event-loop gap per request
+  drops from 111 ms to 19 ms with 6 MiB of images in history, and from 425 ms to
+  69 ms at 24 MiB.
+- Stopped `web_fetch` from freezing the UI on large pages. Scoring an extraction
+  re-parsed the entire raw document on the event loop, once per extractor
+  attempt plus once more for single-page-app detection; the document is now
+  measured once per fetch in a worker thread. On an 11.6 MB page the worst
+  event-loop gap drops from 774 ms to 219 ms, and on a pathological 13.8 MB page
+  from 48 s to 0.5 s.
+- Moved `read_image`'s file read and base64 encode off the event loop.
+
 ## 0.25.2 - 2026-07-28
 
 ### Fixed

{kolega_code-0.25.2 → kolega_code-0.26.0}/CONTRIBUTING.md

@@ -99,6 +99,15 @@ Run the fast test suite before opening a pull request:
 ./run_tests.sh
 ```
 
+The wrapper runs tests in parallel using the available CPU cores. Set
+`PYTEST_WORKERS` to cap concurrency, or set it to `0` for a serial debugging
+run:
+
+```bash
+PYTEST_WORKERS=4 ./run_tests.sh
+PYTEST_WORKERS=0 ./run_tests.sh tests/test_git_env.py
+```
+
 Run slow and integration tests only when you have the required credentials:
 
 ```bash
@@ -108,7 +117,7 @@ Run slow and integration tests only when you have the required credentials:
 You can pass additional pytest arguments through the wrapper:
 
 ```bash
-./run_tests.sh tests/agent/llm/test_client.py -ra
+./run_tests.sh tests/test_git_env.py -ra
 ```
 
 ## Updating bundled skills

{kolega_code-0.25.2 → kolega_code-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kolega-code
-Version: 0.25.2
+Version: 0.26.0
 Summary: Multi-agent coding in the terminal
 Project-URL: Homepage, https://kolega-ai.github.io/kolega-code/
 Project-URL: Documentation, https://kolega-ai.github.io/kolega-code/
@@ -236,6 +236,7 @@ Requires-Dist: filelock==3.20.3
 Requires-Dist: firecrawl-py==4.28.2
 Requires-Dist: google-genai==2.12.1
 Requires-Dist: httpx==0.28.1
+Requires-Dist: idna==3.18
 Requires-Dist: jinja2==3.1.6
 Requires-Dist: langfuse==3.14.5
 Requires-Dist: lxml-html-clean==0.4.5
@@ -269,6 +270,7 @@ Requires-Dist: pre-commit==4.6.0; extra == 'dev'
 Requires-Dist: pyright==1.1.411; extra == 'dev'
 Requires-Dist: pytest-asyncio==1.3.0; extra == 'dev'
 Requires-Dist: pytest-cov==7.0.0; extra == 'dev'
+Requires-Dist: pytest-xdist==3.8.0; extra == 'dev'
 Requires-Dist: pytest==9.0.3; extra == 'dev'
 Requires-Dist: ruff==0.15.12; extra == 'dev'
 Requires-Dist: twine==6.2.0; extra == 'dev'
@@ -418,6 +420,7 @@ Supported model providers:
 - Fireworks.ai
 - xAI / Grok
 - DashScope / Qwen
+- OpenRouter (gateway to 250+ tool-capable models)
 - Moonshot / Kimi
 - DeepSeek
 - Z.AI / GLM Coding Plan

{kolega_code-0.25.2 → kolega_code-0.26.0}/README.md

@@ -142,6 +142,7 @@ Supported model providers:
 - Fireworks.ai
 - xAI / Grok
 - DashScope / Qwen
+- OpenRouter (gateway to 250+ tool-capable models)
 - Moonshot / Kimi
 - DeepSeek
 - Z.AI / GLM Coding Plan

{kolega_code-0.25.2 → kolega_code-0.26.0}/kolega_code/__init__.py

@@ -151,4 +151,4 @@ __all__ = [
     "parse_git_status_output",
 ]
 
-__version__ = "0.25.2"
+__version__ = "0.26.0"

{kolega_code-0.25.2 → kolega_code-0.26.0}/kolega_code/_bundled_skills/manifest.json

@@ -4,6 +4,26 @@
       "path": "LICENSE",
       "sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4"
     },
+    {
+      "path": "skills/deep-research/SKILL.md",
+      "sha256": "1fbbef0e49a27ff23917a28c8c4baf7aa9005458ce10e55f895f2649103f12af"
+    },
+    {
+      "path": "skills/deep-research/references/evidence-and-reporting.md",
+      "sha256": "933965dde6b5f95c00d68185251469553fde727779d2bb4113e7749527955418"
+    },
+    {
+      "path": "skills/deep-research/references/gigacode-workflow.md",
+      "sha256": "097807156d55a29d12b16a3a5d496a41fb07f152476e95e390699dec1842bc6a"
+    },
+    {
+      "path": "skills/deep-research/scripts/deep-research.workflow",
+      "sha256": "5207a175f1f1b4144d1c1e53c66e351c20006444e9d31abc7ce3f9be9204df3c"
+    },
+    {
+      "path": "skills/deep-research/scripts/materialize_report.py",
+      "sha256": "2e9d652b05b62c9f08ebbbf47b72b0156e1cf8bd39ddf33ee1416315932c600f"
+    },
     {
       "path": "skills/docx/LICENSE",
       "sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4"
@@ -40,6 +60,14 @@
       "path": "skills/docx/scripts/smoke_test.py",
       "sha256": "1cb265f9b129032a09586132a4bfb4924bbd0aefa6dfa6c641576e1e159b3ece"
     },
+    {
+      "path": "skills/humanizer/LICENSE",
+      "sha256": "4ac4810254ab36d45419141aeb8e69bf50652cfafe5b2dab947d06d44e5cbf96"
+    },
+    {
+      "path": "skills/humanizer/SKILL.md",
+      "sha256": "2fc8fa3cefe67013f2fecfa9ec63564a4a821ddcc03da483d7b1ade00762ca3c"
+    },
     {
       "path": "skills/pdf/LICENSE",
       "sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4"
@@ -179,7 +207,9 @@
   ],
   "schema_version": 1,
   "skills": [
+    "deep-research",
     "docx",
+    "humanizer",
     "pdf",
     "pptx",
     "review",
@@ -187,8 +217,8 @@
     "xlsx"
   ],
   "source": {
-    "commit": "22eeee98363a92c199d234a10a798cbdaf3998e2",
+    "commit": "c0ba68e7aee0994318913aa9fcaad4f57cbc11d7",
     "repository": "https://github.com/kolega-ai/kolega-skills",
-    "tag": "v0.2.1"
+    "tag": "v0.3.0"
   }
 }