kolega-code 0.26.1__tar.gz → 0.26.2__tar.gz

{kolega_code-0.26.1 → kolega_code-0.26.2}/CHANGELOG.md

@@ -6,6 +6,23 @@ This project uses GitHub Releases for detailed generated release notes. This fil
 
 ## Unreleased
 
+## 0.26.2 - 2026-07-31
+
+### Added
+
+- `kolega-code ask --gigacode` enables gigacode workflow orchestration in
+  headless runs, matching the TUI's `/gigacode` toggle: the `run_workflow` and
+  `list_workflow_runs` tools are exposed and the authoring guide is injected.
+  The setting persists with the session, so `ask --session <id>` resumes with
+  gigacode still on.
+
+### Changed
+
+- Gigacode's concurrent-worker cap is now a flat 8 instead of being derived from
+  the host's core count. Workers wait on provider responses rather than CPU, so
+  the old formula only made fan-out width vary with the machine — and collapse to
+  a single serial worker on a one-CPU host or container.
+
 ## 0.26.1 - 2026-07-31
 
 ### Fixed

{kolega_code-0.26.1 → kolega_code-0.26.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kolega-code
-Version: 0.26.1
+Version: 0.26.2
 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/

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/__init__.py

@@ -151,4 +151,4 @@ __all__ = [
     "parse_git_status_output",
 ]
 
-__version__ = "0.26.1"
+__version__ = "0.26.2"

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/agent/__init__.py

@@ -51,4 +51,4 @@ __all__ = [
     "ToolExtension",
 ]
 
-__version__ = "0.26.1"
+__version__ = "0.26.2"

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/agent/orchestration/__init__.py

@@ -20,7 +20,7 @@ from .errors import (
 )
 from .executor import DEFAULT_MAX_AGENT_DEPTH, MAX_AGENT_DEPTH, extract_meta, run_script, safe_builtins
 from .journal import ResumeCache, RunJournal, saved_workflows_dir, workflows_root
-from .runtime import DEFAULT_AGENT_CAP, MAX_FANOUT, WorkflowRuntime, default_concurrency
+from .runtime import DEFAULT_AGENT_CAP, DEFAULT_WORKFLOW_CONCURRENCY, MAX_FANOUT, WorkflowRuntime
 from .types import AgentRunResult, AgentRunSpec, DispatchFn, EmitFn
 
 __all__ = [
@@ -39,7 +39,7 @@ __all__ = [
     "workflows_root",
     "saved_workflows_dir",
     "WorkflowRuntime",
-    "default_concurrency",
+    "DEFAULT_WORKFLOW_CONCURRENCY",
     "MAX_FANOUT",
     "DEFAULT_AGENT_CAP",
     "AgentRunSpec",

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/agent/orchestration/guide.py

@@ -5,6 +5,8 @@ it in sync with the primitives in :mod:`runtime` and the tool in
 ``tool_backend/workflow_tool.py``.
 """
 
+from ..prompt_provider import PromptExtension
+
 GIGACODE_AUTHORING_GUIDE = """\
 ## gigacode — dynamic workflow orchestration
 
@@ -299,3 +301,21 @@ id as `resume_from_run_id` — every agent call it completed replays from the jo
 no cost. `list_workflow_runs` shows only this session's runs; a run still listed as
 "running" when no workflow is in flight died mid-run and is resumable the same way.
 """
+
+
+def gigacode_prompt_extension() -> PromptExtension:
+    """The authoring guide as a prompt extension, for every frontend that enables gigacode.
+
+    The TUI's ``/gigacode`` toggle and ``kolega-code ask --gigacode`` share this
+    so a headless run sees exactly the guidance an interactive session does.
+    """
+    return PromptExtension(
+        id="gigacode",
+        title="gigacode — workflow orchestration",
+        markdown=GIGACODE_AUTHORING_GUIDE,
+        agent_types=None,
+        modes=None,
+        # Sub-agents can't run workflows (run_workflow is gated off for them),
+        # so the authoring guide is just prompt bloat for a sub-agent.
+        propagate_to_sub_agents=False,
+    )

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/agent/orchestration/runtime.py

@@ -13,7 +13,6 @@ from __future__ import annotations
 
 import asyncio
 import inspect
-import os
 import random
 from typing import Any, Awaitable, Callable, Dict, Iterable, List, Optional
 
@@ -43,14 +42,12 @@ DROPPED_ITEM_LOG_LIMIT = 10
 START_STAGGER_SECONDS = 0.75
 
 
-def default_concurrency() -> int:
-    """Concurrent-agent cap: a few below the core count, clamped to [1, 8].
-
-    Kept modest so a fan-out doesn't burst enough simultaneous LLM requests to trip
-    account-level rate limits; the jittered start-stagger further de-correlates them.
-    """
-    cpus = os.cpu_count() or 4
-    return max(1, min(8, cpus - 2))
+# Concurrent-agent cap for one workflow. A worker spends nearly all its wall-clock
+# waiting on a provider response, so the binding constraint is the account's rate
+# limit, not the host's core count — deriving this from cores only made the fan-out
+# width vary arbitrarily with the machine (and collapse to 1 in a single-CPU
+# container). The jittered start-stagger de-correlates the burst on top of this cap.
+DEFAULT_WORKFLOW_CONCURRENCY = 8
 
 
 def _call_with_arity(fn: Callable[..., Any], *args: Any) -> Any:
@@ -97,7 +94,7 @@ class WorkflowRuntime:
         if self._accounting.budget is not budget:
             raise ValueError("workflow accounting must own the runtime budget")
         self.budget = self._accounting.budget
-        self._sem = asyncio.Semaphore(concurrency or default_concurrency())
+        self._sem = asyncio.Semaphore(concurrency or DEFAULT_WORKFLOW_CONCURRENCY)
         self._max_agent_depth = max_agent_depth
         self._resolver = workflow_resolver
         self._routing_fingerprint = routing_fingerprint

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/cli/main.py

@@ -16,6 +16,7 @@ from typing import Any, Iterable, Optional
 from kolega_code.agent import CoderAgent
 from kolega_code.config import EditProtocol
 from kolega_code.agent.custom_agents import discover_custom_agents, validate_custom_agent_models
+from kolega_code.agent.orchestration.guide import gigacode_prompt_extension
 from kolega_code.agent.prompt_provider import PromptExtension
 from kolega_code.agent.prompt_dump import (
     dump_prompt_overrides,
@@ -392,6 +393,11 @@ def _build_subcommand_parser() -> argparse.ArgumentParser:
     ask.add_argument(
         "--mode", choices=[mode.value for mode in AgentMode], default=CLI_AGENT_MODE, help=argparse.SUPPRESS
     )
+    ask.add_argument(
+        "--gigacode",
+        action="store_true",
+        help="Enable gigacode workflow orchestration (the TUI's /gigacode, for headless runs).",
+    )
     ask.add_argument("--save", action="store_true", help="Persist the session after the prompt completes.")
     ask.add_argument("--json", action="store_true", help="Emit response chunks and events as JSON.")
     ask.add_argument("--browser-visible", action="store_true", help="Launch visible Playwright browser windows.")
@@ -1339,6 +1345,12 @@ async def _run_ask(args: argparse.Namespace) -> int:
         memory_project_path=launch_project_path,
     )
     agent_ref["agent"] = agent
+    # --gigacode turns orchestration on for this run; a resumed session that had
+    # it on keeps it on, exactly as the TUI's /gigacode toggle persists.
+    gigacode_enabled = bool(getattr(args, "gigacode", False)) or bool(session.gigacode_enabled)
+    if gigacode_enabled:
+        agent.apply_gigacode(True, gigacode_prompt_extension())
+    session.gigacode_enabled = gigacode_enabled
     lsp_messages = await agent.tool_collection.initialize()
     if not args.json:
         for msg in lsp_messages:

{kolega_code-0.26.1 → kolega_code-0.26.2}/kolega_code/cli/tui/command_handlers.py

@@ -257,18 +257,9 @@ class CommandHandlersMixin(tui_app_base.KolegaAppBase):
         self._update_mode_chrome()
 
     def _gigacode_prompt_extension(self) -> PromptExtension:
-        from kolega_code.agent.orchestration.guide import GIGACODE_AUTHORING_GUIDE
-
-        return PromptExtension(
-            id="gigacode",
-            title="gigacode — workflow orchestration",
-            markdown=GIGACODE_AUTHORING_GUIDE,
-            agent_types=None,
-            modes=None,
-            # Sub-agents can't run workflows (run_workflow is gated off for them),
-            # so the authoring guide is just prompt bloat for a sub-agent.
-            propagate_to_sub_agents=False,
-        )
+        from kolega_code.agent.orchestration.guide import gigacode_prompt_extension
+
+        return gigacode_prompt_extension()
 
     async def _command_goal(self, args: str) -> None:
         clean = args.strip()

{kolega_code-0.26.1 → kolega_code-0.26.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kolega-code"
-version = "0.26.1"
+version = "0.26.2"
 description = "Multi-agent coding in the terminal"
 readme = "README.md"
 license = {file = "LICENSE"}