devsper 2.4.0__tar.gz → 2.5.0__tar.gz

{devsper-2.4.0 → devsper-2.5.0}/CHANGELOG.md

@@ -7,24 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.5.0] — 2026-04-06
+
+### Added
+
+- **LangChain / LangGraph integrations** — `devsper.integrations.langchain_adapter` and `langgraph_adapter` for wrapping LangChain runnables as Devsper tasks and running compiled LangGraph nodes with Devsper DAG scheduling; CLI-friendly examples under `examples/langchain_agent.py` and `examples/langgraph_swarm.py`; optional extra `pip install 'devsper[langgraph]'` to pin LangGraph.
+
+## [2.4.1] — 2026-03-31
+
+### Fixed
+
+- **HITL prompt loop + context handoff** — Clarification responses are now reused across subtasks, repeated clarification prompts are deduplicated/capped, and follow-up tasks inherit prior user decisions instead of re-asking equivalent questions.
+- **Run view prompt stability** — Local clarification prompts now pause/resume live rendering cleanly, reducing TUI corruption and preventing hidden/stuck prompts during interactive runs.
+- **Silent-failure propagation** — Agent failures now surface as explicit task failures (instead of empty-success paths), with clearer errors for missing model configuration.
+- **Executor compatibility regression** — Restored `budget_manager` compatibility on the runtime executor path to avoid end-of-run `AttributeError` crashes.
+
+### Changed
+
+- **Research tool routing defaults** — Tool selection now biases web-first for research/business discovery tasks when no local dataset path is provided.
+- **Export readability + content coverage** — Run export now backfills task outputs from tool traces when direct task result payloads are missing, and includes richer run details in markdown/html/latex/docx outputs.
+- **Duration formatting** — CLI run summary and export outputs now prefer `HH:MM:SS` format.
+- **Telemetry noise control** — Console span export is now opt-in (`DEVSPER_OTEL_CONSOLE=1`) to keep interactive TUI output clean by default.
+- **Auto-export workflow** — Added config-driven post-run export option (`[export] auto_export_on_run`) with selectable output format.
+
 ## [2.4.0] — 2026-03-31
 
 ### Added
 
-- **Distributed runtime extension layer** — Added `devsper.distributed` package with controller and worker-runtime wrappers for clean orchestration composition.
-- **Agent pool** — Added `runtime/agent_pool.py` with reusable, worker-aware concurrent agent leasing (`acquire_agent`, `release_agent`, `run_agent`, `run_parallel`).
-- **Model router (runtime layer)** — Added `runtime/model_router.py` for planning/reasoning/validation model routing with fallback chains.
-- **Speculative planner (runtime layer)** — Added `runtime/speculative_planner.py` to predict and stage speculative successor tasks.
-- **Runtime HITL manager** — Added `runtime/hitl.py` for pause/resume and explicit human-input request lifecycle handling.
-- **Execution graph upgrades** — Extended runtime execution graph with worker assignment metadata and distributed lineage tracking.
+- **Distributed runtime extensions** — Added modular runtime components for distributed orchestration: `AgentPool`, `ModelRouter`, `SpeculativePlanner`, `HITLManager`, `ExecutionGraph` worker assignment tracking, plus distributed wrappers (`distributed/controller.py`, `distributed/worker_runtime.py`).
+- **Runtime architecture documentation** — Expanded runtime docs with distributed architecture, worker/controller lifecycle, speculative execution flow, and HITL lifecycle details.
+- **Tool execution hardening** — Upgraded runtime tool runner with bounded parallelism, dependency-aware batching, per-call timeout isolation, and cancellation support.
 
 ### Changed
 
-- **Executor composition** — Runtime executor now integrates AgentPool, ModelRouter, speculative planning hooks, and distributed assignment tracking while preserving default behavior.
-- **Task runner routing** — Task execution now supports pool-backed agent execution, scoped model routing, and fallback chain handling.
-- **Tool execution control** — Runtime ToolRunner now supports bounded concurrency, dependency-aware batching, per-call timeout, cancellation, and structured results.
-- **Event backpressure handling** — Runtime event stream now uses bounded queues with controlled overflow behavior.
-- **Runtime docs** — Updated runtime architecture docs in `devsper/README.md` with distributed flow, worker/controller lifecycle, and HITL/speculative execution details.
+- **Executor orchestration** — Runtime executor now supports agent-pool-backed execution, model routing integration, speculative follow-up scheduling hooks, and improved cancellation/backpressure behavior.
+- **Prompt/token efficiency** — Tool schema injection in agent prompts was compressed to reduce runtime token overhead in tool-enabled turns.
+- **Homepage and release communication** — Updated README homepage with v2.4.0 release CTA and an architecture upgrade blog entry for this release.
 
 ## [2.3.0] — 2026-03-30
 

{devsper-2.4.0 → devsper-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devsper
-Version: 2.4.0
+Version: 2.5.0
 Summary: Orchestrate distributed swarms of AI agents that collaboratively solve complex tasks.
 Project-URL: Homepage, https://github.com/devsper-com/runtime
 Project-URL: Documentation, https://docs.devsper.com
@@ -62,6 +62,8 @@ Requires-Dist: sentence-transformers>=3.0.0; extra == 'embeddings'
 Provides-Extra: explainability
 Provides-Extra: hitl
 Requires-Dist: httpx>=0.27; extra == 'hitl'
+Provides-Extra: langgraph
+Requires-Dist: langgraph<2,>=1.0.0; extra == 'langgraph'
 Provides-Extra: mcp
 Requires-Dist: anyio>=4.0; extra == 'mcp'
 Requires-Dist: httpx>=0.27; extra == 'mcp'
@@ -72,6 +74,7 @@ Provides-Extra: server
 Requires-Dist: fastapi>=0.110; extra == 'server'
 Requires-Dist: sse-starlette>=2.0; extra == 'server'
 Requires-Dist: uvicorn>=0.29; extra == 'server'
+Requires-Dist: vektori>=0.1.1; extra == 'server'
 Provides-Extra: worker
 Description-Content-Type: text/markdown
 
@@ -206,6 +209,28 @@ Credentials are injected from the keyring (or env) when config is resolved—no
 
 ---
 
+## LangChain integration
+
+Devsper ships a **small adapter layer** (not a parallel orchestration stack) so you can keep building in **LangChain** and **LangGraph** while aligning execution with Devsper’s **task / DAG** mental model.
+
+| Module | Purpose |
+|--------|---------|
+| `devsper.integrations.langchain_adapter` | Wrap LangChain runnables and agents as tagged `Task`s; `run_langchain_runnable()` runs `ainvoke` / `invoke` and normalizes output for `Task.result`. |
+| `devsper.integrations.langgraph_adapter` | Derive a Devsper task graph from a compiled LangGraph graph (`compiled_graph_to_tasks`); `run_compiled_graph_as_devsper_tasks()` runs each node with bounded concurrency and pluggable state merge (default: concatenate list fields—good for `MessagesState`). |
+
+**Install:** `langchain` is a core dependency of the `devsper` package; **LangGraph** is pulled in transitively. To pin it explicitly: `pip install 'devsper[langgraph]'`.
+
+**Examples (from the runtime repo root):**
+
+```bash
+uv run python examples/langchain_agent.py --prompt "Say hi in one sentence."
+uv run python examples/langgraph_swarm.py --workers 4
+```
+
+Docs: [LangChain integration](https://docs.devsper.com/docs/langchain-integration) (source: `docs/docs/langchain-integration.md` in the docs tree).
+
+---
+
 ## Credentials
 
 API keys are **not** stored in config files. Use the **credential store** (OS keychain) or environment variables.
@@ -363,6 +388,8 @@ Rust workers: set `DEVSPER_WORKER_MODEL=github:gpt-4o` (or your model), `DEVSPER
 | Dataset analysis | `uv run python examples/data_science/dataset_analysis.py [path-to.csv]` |
 | Document intelligence | `uv run python examples/documents/analyze_documents.py [dir]` |
 | Parameter sweep | `uv run python examples/experiments/parameter_sweep.py --params '{"lr":[0.01,0.1]}'` |
+| LangChain agent (adapter) | `uv run python examples/langchain_agent.py [--live] [--prompt "..."]` |
+| LangGraph DAG (as Devsper tasks) | `uv run python examples/langgraph_swarm.py [--workers N]` |
 
 Outputs under `examples/output/`. Run from project root when using script paths.
 

{devsper-2.4.0 → devsper-2.5.0}/README.md

@@ -129,6 +129,28 @@ Credentials are injected from the keyring (or env) when config is resolved—no
 
 ---
 
+## LangChain integration
+
+Devsper ships a **small adapter layer** (not a parallel orchestration stack) so you can keep building in **LangChain** and **LangGraph** while aligning execution with Devsper’s **task / DAG** mental model.
+
+| Module | Purpose |
+|--------|---------|
+| `devsper.integrations.langchain_adapter` | Wrap LangChain runnables and agents as tagged `Task`s; `run_langchain_runnable()` runs `ainvoke` / `invoke` and normalizes output for `Task.result`. |
+| `devsper.integrations.langgraph_adapter` | Derive a Devsper task graph from a compiled LangGraph graph (`compiled_graph_to_tasks`); `run_compiled_graph_as_devsper_tasks()` runs each node with bounded concurrency and pluggable state merge (default: concatenate list fields—good for `MessagesState`). |
+
+**Install:** `langchain` is a core dependency of the `devsper` package; **LangGraph** is pulled in transitively. To pin it explicitly: `pip install 'devsper[langgraph]'`.
+
+**Examples (from the runtime repo root):**
+
+```bash
+uv run python examples/langchain_agent.py --prompt "Say hi in one sentence."
+uv run python examples/langgraph_swarm.py --workers 4
+```
+
+Docs: [LangChain integration](https://docs.devsper.com/docs/langchain-integration) (source: `docs/docs/langchain-integration.md` in the docs tree).
+
+---
+
 ## Credentials
 
 API keys are **not** stored in config files. Use the **credential store** (OS keychain) or environment variables.
@@ -286,6 +308,8 @@ Rust workers: set `DEVSPER_WORKER_MODEL=github:gpt-4o` (or your model), `DEVSPER
 | Dataset analysis | `uv run python examples/data_science/dataset_analysis.py [path-to.csv]` |
 | Document intelligence | `uv run python examples/documents/analyze_documents.py [dir]` |
 | Parameter sweep | `uv run python examples/experiments/parameter_sweep.py --params '{"lr":[0.01,0.1]}'` |
+| LangChain agent (adapter) | `uv run python examples/langchain_agent.py [--live] [--prompt "..."]` |
+| LangGraph DAG (as Devsper tasks) | `uv run python examples/langgraph_swarm.py [--workers N]` |
 
 Outputs under `examples/output/`. Run from project root when using script paths.
 

{devsper-2.4.0 → devsper-2.5.0}/devsper/agents/agent.py

@@ -594,6 +594,176 @@ class Agent:
         self.audit_logger = audit_logger
         self.audit_run_id = audit_run_id or ""
         self.clarification_requester = None  # set by executor for human-in-the-loop
+        self._hitl_response_cache: dict[str, dict] = {}
+        self._hitl_prompt_counts: dict[str, int] = {}
+        self._hitl_shared_answers: dict[str, str] = {}
+        self._hitl_shared_facts: list[str] = []
+        try:
+            self._hitl_max_prompts_per_task = int(
+                str(os.environ.get("DEVSPER_HITL_MAX_PROMPTS_PER_TASK", "1")).strip()
+                or "1"
+            )
+        except Exception:
+            self._hitl_max_prompts_per_task = 1
+        self._hitl_max_prompts_per_task = max(0, self._hitl_max_prompts_per_task)
+
+    def _default_answer_for_field(self, field: ClarificationField) -> object:
+        prior = self._find_prior_hitl_answer(field.question)
+        if prior:
+            return prior
+        if field.default is not None and str(field.default).strip() != "":
+            return field.default
+        ftype = str(field.type or "text")
+        options = field.options or []
+        if ftype == "confirm":
+            return True
+        if ftype == "multi_select":
+            return [options[0]] if options else []
+        if ftype == "rank":
+            return options
+        if ftype == "mcq":
+            return options[0] if options else "Proceed with best-effort defaults"
+        return "Proceed with best-effort defaults"
+
+    @staticmethod
+    def _normalize_question(text: str) -> str:
+        t = re.sub(r"[^a-z0-9\s]+", " ", (text or "").lower())
+        return re.sub(r"\s+", " ", t).strip()
+
+    def _find_prior_hitl_answer(self, question: str) -> str | None:
+        qn = self._normalize_question(question)
+        if not qn:
+            return None
+        if qn in self._hitl_shared_answers:
+            return self._hitl_shared_answers[qn]
+        q_tokens = {t for t in qn.split() if len(t) > 2}
+        if not q_tokens:
+            return None
+        best_overlap = 0
+        best_answer: str | None = None
+        for prev_qn, prev_answer in self._hitl_shared_answers.items():
+            p_tokens = {t for t in prev_qn.split() if len(t) > 2}
+            overlap = len(q_tokens.intersection(p_tokens))
+            if overlap >= 3 and overlap > best_overlap:
+                best_overlap = overlap
+                best_answer = prev_answer
+        return best_answer
+
+    def _record_hitl_answers(self, answers: dict[str, object]) -> None:
+        for question, answer in (answers or {}).items():
+            qn = self._normalize_question(str(question))
+            if not qn:
+                continue
+            answer_text = str(answer)
+            self._hitl_shared_answers[qn] = answer_text
+            fact = f"- {str(question).strip()}: {answer_text}"
+            if fact not in self._hitl_shared_facts:
+                self._hitl_shared_facts.append(fact)
+
+    def _should_auto_web_collection(
+        self,
+        request: AgentRequest,
+        tool_args: dict,
+        fields: list[ClarificationField],
+    ) -> bool:
+        prior_answers_text = " ".join(self._hitl_shared_answers.values()).lower()
+        prior_facts_text = " ".join(self._hitl_shared_facts).lower()
+        topic = " ".join(
+            [
+                str(self.user_task or ""),
+                str(getattr(request.task, "description", "") or ""),
+                str(tool_args.get("context") or ""),
+                " ".join(f.question for f in fields),
+                prior_answers_text,
+                prior_facts_text,
+            ]
+        ).lower()
+        # If this is clearly a research/data-collection workflow asking for local datasets,
+        # default to web/public-source collection to avoid blocking the run.
+        needs_dataset_input = any(
+            token in topic
+            for token in (
+                "dataset",
+                "csv",
+                "upload",
+                "file",
+                "local path",
+                "paste",
+                "provide the data",
+                "provide the dataset",
+            )
+        )
+        research_like = any(
+            token in topic
+            for token in (
+                "research",
+                "public source",
+                "web",
+                "openai business",
+                "data collection",
+                "comprehensive search",
+                "business aspect",
+            )
+        )
+        prior_prefers_web = any(
+            token in topic
+            for token in (
+                "public urls",
+                "public url",
+                "public-source",
+                "public source",
+                "web collection",
+                "curated list",
+                "crawl",
+                "fetch",
+                "url",
+            )
+        )
+        return needs_dataset_input and (research_like or prior_prefers_web)
+
+    def _auto_web_collection_answers(
+        self,
+        fields: list[ClarificationField],
+    ) -> dict[str, object]:
+        answers: dict[str, object] = {}
+        for f in fields:
+            q = (f.question or "").lower()
+            opts = [str(o) for o in (f.options or [])]
+            # Prefer choices indicating web/public/source fetching.
+            preferred = None
+            for opt in opts:
+                ol = opt.lower()
+                if any(
+                    t in ol
+                    for t in (
+                        "web",
+                        "public",
+                        "url",
+                        "crawl",
+                        "fetch",
+                        "curated list",
+                        "propose",
+                    )
+                ):
+                    preferred = opt
+                    break
+            if preferred is not None:
+                answers[f.question] = preferred
+                continue
+            # If there is no explicit web/public option, avoid blocking on local file uploads.
+            if any(t in q for t in ("dataset", "profile", "csv", "file", "path")):
+                template_opt = next(
+                    (o for o in opts if any(k in o.lower() for k in ("template", "generic", "sample", "synthetic"))),
+                    None,
+                )
+                if template_opt is not None:
+                    answers[f.question] = template_opt
+                    continue
+            if "how many" in q or "count" in q or "limit" in q:
+                answers[f.question] = "Up to 50 public URLs"
+                continue
+            answers[f.question] = self._default_answer_for_field(f)
+        return answers
 
     def run(self, request: AgentRequest) -> AgentResponse:
         """Stateless run: all context in AgentRequest, all output in AgentResponse."""
@@ -770,6 +940,12 @@ class Agent:
             message_bus_section = self.message_bus.get_context_sync(task.id) or ""
         if message_bus_section:
             memory_section = (memory_section + "\n\n" + message_bus_section).strip()
+        if self._hitl_shared_facts:
+            memory_section = (
+                memory_section
+                + "\n\nUSER CLARIFICATIONS (APPLY THESE PREFERENCES ACROSS SUBTASKS)\n"
+                + "\n".join(self._hitl_shared_facts[-20:])
+            ).strip()
         from devsper.agents.roles import get_role_config
 
         role_config = get_role_config(getattr(task, "role", None))
@@ -857,6 +1033,8 @@ class Agent:
                 success=True,
             )
         self.apply_response(task, response)
+        if not response.success:
+            raise RuntimeError(response.error or "Agent run failed")
         return response.result
 
     def _enrich_task(self, task: Task, answers: dict) -> Task:
@@ -1223,6 +1401,57 @@ class Agent:
         if not fields:
             return json.dumps({"error": "hitl.request has no valid fields"})
 
+        if self._should_auto_web_collection(request, tool_args, fields):
+            auto_answers = self._auto_web_collection_answers(fields)
+            self._record_hitl_answers(auto_answers)
+            payload = {
+                "request_id": f"auto-web-{request.task.id}",
+                "skipped": False,
+                "answers": auto_answers,
+                "auto_assumed": True,
+            }
+            return json.dumps(payload)
+
+        task_id = request.task.id
+        used_prompts = int(self._hitl_prompt_counts.get(task_id, 0))
+        if used_prompts >= max(0, self._hitl_max_prompts_per_task):
+            # Fast-path: avoid repeated user interruption after first clarification.
+            auto_answers: dict[str, object] = {}
+            for f in fields:
+                auto_answers[f.question] = self._default_answer_for_field(f)
+            self._record_hitl_answers(auto_answers)
+            payload = {
+                "request_id": f"auto-{task_id}-{used_prompts + 1}",
+                "skipped": False,
+                "answers": auto_answers,
+                "auto_assumed": True,
+            }
+            return json.dumps(payload)
+
+        # Prevent repeated identical prompts in the same task/tool loop.
+        signature_payload = {
+            "task_id": request.task.id,
+            "context": str(tool_args.get("context") or "Need user input"),
+            "fields": [
+                {
+                    "type": f.type,
+                    "question": f.question,
+                    "options": f.options or [],
+                    "default": f.default,
+                    "required": bool(f.required),
+                }
+                for f in fields
+            ],
+        }
+        cache_key = json.dumps(signature_payload, sort_keys=True)
+        cached = self._hitl_response_cache.get(cache_key)
+        if cached is not None:
+            try:
+                self._record_hitl_answers(cached.get("answers") or {})
+            except Exception:
+                pass
+            return json.dumps(cached)
+
         req = ClarificationRequest(
             request_id=str(uuid.uuid4()),
             task_id=request.task.id,
@@ -1233,13 +1462,15 @@ class Agent:
             timeout_seconds=int(tool_args.get("timeout_seconds", 120)),
         )
         resp = requester.request_clarification(req)
-        return json.dumps(
-            {
-                "request_id": req.request_id,
-                "skipped": bool(resp.skipped),
-                "answers": resp.answers or {},
-            }
-        )
+        self._hitl_prompt_counts[task_id] = used_prompts + 1
+        self._record_hitl_answers(resp.answers or {})
+        payload = {
+            "request_id": req.request_id,
+            "skipped": bool(resp.skipped),
+            "answers": resp.answers or {},
+        }
+        self._hitl_response_cache[cache_key] = payload
+        return json.dumps(payload)
 
     def _emit_tool_called_audit(
         self, task_id: str, tool_name: str, result: str

{devsper-2.4.0 → devsper-2.5.0}/devsper/cli/main.py

@@ -130,23 +130,6 @@ def _platform_api_builder():
     return PlatformAPIRequestBuilder(base_url=base_url, org_slug=org, token=token)
 
 
-def _is_platform_default_enabled(args: object) -> bool:
-    if getattr(args, "local_runtime", False):
-        return False
-    # Shadow mode explicitly compares both paths; do not default-route.
-    if getattr(args, "shadow", False):
-        return False
-    if os.environ.get("DEVSPER_PROFILE", "").strip().lower() == "local":
-        return False
-    if str(os.environ.get("DEVSPER_RUN_DEFAULT", "platform")).strip().lower() in {
-        "runtime",
-        "local",
-    }:
-        return False
-    api = _platform_api_builder()
-    return api.enabled()
-
-
 def _extract_platform_run_fields(payload: dict) -> tuple[str, str, int, int, int]:
     status = str(payload.get("status", ""))
     run_id = str(payload.get("run_id", ""))
@@ -181,8 +164,24 @@ def _run_platform_once(task: str, args: object) -> tuple[int, dict, float]:
             task=task, project_id=project_id or "", manifest=manifest
         )
         run_id = str(created.get("run_id", "") or "")
+        poll_interval = float(getattr(args, "platform_poll_interval", 2.0) or 2.0)
+        if poll_interval <= 0:
+            poll_interval = 2.0
+        last_print_status = {"status": ""}
+
+        def _on_update(payload: dict, elapsed: float, changed: bool) -> None:
+            if getattr(args, "quiet", False):
+                return
+            status = str(payload.get("status") or "").strip().lower() or "unknown"
+            if changed or status != last_print_status["status"]:
+                last_print_status["status"] = status
+                print(f"[platform] run_id={run_id} status={status} elapsed={elapsed:.1f}s")
+
         final = api.poll_run(
-            run_id, timeout_seconds=float(getattr(args, "platform_timeout", 180.0))
+            run_id,
+            interval_seconds=poll_interval,
+            timeout_seconds=float(getattr(args, "platform_timeout", 180.0)),
+            on_update=_on_update,
         )
         elapsed = time.time() - started
         return 0, final or {}, elapsed
@@ -251,7 +250,6 @@ def _run_shadow_mode(args: object) -> int:
         task,
         "--quiet",
         "--json",
-        "--local-runtime",
     ]
     local_started = time.time()
     local_proc = subprocess.run(local_cmd, capture_output=True, text=True)
@@ -383,7 +381,7 @@ def _run_platform_connect(args: object) -> int:
 
     print(f"Connected platform: api={api_url} org={org_slug}")
     print(
-        "`devsper run` will now default to platform. Use `--local-runtime` to bypass."
+        "Use `devsper cloud run` to route runs to platform."
     )
     _track_conversion_event("platform_connect_succeeded", {"org": org_slug})
     return 0
@@ -417,13 +415,7 @@ def _run_swarm(args: object) -> int:
     _track_conversion_event("runtime_user_detected", {"command": "run"})
     if getattr(args, "shadow", False):
         return _run_shadow_mode(args)
-    if _is_platform_default_enabled(args):
-        return _run_platform_only(args)
-    if not getattr(args, "local_runtime", False):
-        # Contextual nudge when users are still runtime-only.
-        print(
-            "Tip: run `devsper platform connect` to unlock retries, audit history, billing controls, and team workflows."
-        )
+    print("Running locally...")
     # Local profile fast-path: route through platform pool + local workers.
     if os.environ.get("DEVSPER_PROFILE", "").strip().lower() == "local":
         try:
@@ -436,10 +428,14 @@ def _run_swarm(args: object) -> int:
     from devsper.config import get_config
     from devsper.utils.event_logger import EventLog
     from devsper.swarm.swarm import Swarm
+    from devsper.runtime.executor import Executor
+    from devsper.runtime.agent_runner import AgentRunner
     from devsper.memory.memory_router import MemoryRouter
     from devsper.memory.memory_store import get_default_store
     from devsper.memory.memory_index import MemoryIndex
 
+    _ = (Executor, AgentRunner)
+
     task = getattr(args, "task", "Summarize swarm intelligence in one paragraph.")
     quiet = getattr(args, "quiet", False)
     summary_only = getattr(args, "summary", False)
@@ -625,6 +621,37 @@ def _run_swarm(args: object) -> int:
                 console.print((result or "")[:2000])
                 if (result or "") and len(result) > 2000:
                     console.print("...")
+    try:
+        if getattr(cfg, "export", None) and getattr(cfg.export, "auto_export_on_run", False):
+            from devsper.export.service import ExportOptions, export_all_runs
+
+            ts = int(time.time())
+            out_dir = f".devsper/exports/runs_{ts}"
+            fmt = str(getattr(cfg.export, "format", "docx") or "docx").lower()
+            if fmt == "pdf":
+                pdf_pipeline = "both"
+            else:
+                # docx/html/all still benefit from HTML PDF where available.
+                pdf_pipeline = "html"
+            manifest = export_all_runs(
+                ExportOptions(
+                    output_dir=out_dir,
+                    limit=int(getattr(cfg.export, "limit", 1) or 1),
+                    pdf_pipeline=pdf_pipeline,
+                )
+            )
+            files = manifest.get("files", {}) if isinstance(manifest, dict) else {}
+            print(f"Auto-export complete: {out_dir}")
+            if fmt in {"docx", "all"} and files.get("all_runs_docx"):
+                print(f"DOCX: {files.get('all_runs_docx')}")
+            if fmt in {"html", "all"} and files.get("all_runs_html"):
+                print(f"HTML: {files.get('all_runs_html')}")
+            if fmt in {"pdf", "all"}:
+                pdf_out = (manifest.get("pdf_outputs", {}) or {}).get("html_pdf")
+                if pdf_out:
+                    print(f"PDF: {pdf_out}")
+    except Exception as e:
+        print(f"Auto-export failed: {e}", file=sys.stderr)
     return 0
 
 
@@ -2891,11 +2918,6 @@ Examples:
         action="store_true",
         help="Only print run summary, not task results",
     )
-    run_parser.add_argument(
-        "--local-runtime",
-        action="store_true",
-        help="Force local runtime path even when platform is connected.",
-    )
     run_parser.add_argument(
         "--shadow",
         action="store_true",
@@ -2917,6 +2939,12 @@ Examples:
         default=180.0,
         help="Platform run polling timeout seconds.",
     )
+    run_parser.add_argument(
+        "--platform-poll-interval",
+        type=float,
+        default=2.0,
+        help="Platform polling interval seconds.",
+    )
     run_parser.add_argument(
         "--reporter",
         action="store_true",

{devsper-2.4.0 → devsper-2.5.0}/devsper/cli/ui/run_view.py

@@ -48,8 +48,11 @@ from devsper.cli.ui.components import devsperHeader, TaskRow, RoleTag, CostDispl
 
 
 def is_interactive() -> bool:
-    """True if we can show interactive prompts (TTY and not CI)."""
-    return sys.stdout.isatty() and not os.environ.get("CI")
+    """True if we can show interactive prompts (requires a real terminal)."""
+    try:
+        return bool(sys.stdin.isatty() and sys.stdout.isatty())
+    except Exception:
+        return False
 
 
 def _field_get(field: Any, key: str, default: Any = None) -> Any:
@@ -106,6 +109,9 @@ class ClarificationWidget:
         from devsper.events import ClarificationResponse
 
         if not is_interactive():
+            console.print(
+                "[hive.warning]HITL prompt auto-skipped: non-interactive terminal detected.[/]"
+            )
             answers = {}
             for field in self.req.fields:
                 q = _field_get(field, "question")
@@ -589,9 +595,21 @@ def run_live_view(
                     except queue.Empty:
                         pass
                     else:
-                        widget = ClarificationWidget(req, theme_style)
-                        response = widget.render()
-                        executor.receive_clarification(response)
+                        # Pause Live while prompting to avoid TUI corruption and hidden input.
+                        try:
+                            live.stop()
+                        except Exception:
+                            pass
+                        try:
+                            widget = ClarificationWidget(req, theme_style)
+                            response = widget.render()
+                            executor.receive_clarification(response)
+                        finally:
+                            try:
+                                live.start()
+                                live.update(get_renderable())
+                            except Exception:
+                                pass
             if cloud_hitl_submit is not None:
                 payload = _first_pending_cloud_clarification(log_path, handled_cloud_hitl)
                 if payload:
@@ -813,10 +831,14 @@ def print_run_summary(state: RunViewState, results: dict[str, str], summary_only
     if duration_s < 0:
         duration_s = 0.0
     cost_str = f"${state.total_cost_usd:.4f}" if (state.total_cost_usd is not None and state.total_cost_usd > 0) else "—"
+    hh = int(duration_s // 3600)
+    mm = int((duration_s % 3600) // 60)
+    ss = int(duration_s % 60)
+    duration_hms = f"{hh:02d}:{mm:02d}:{ss:02d}"
     cache_hits = sum(1 for t in state.tasks if t.status == "cached")
     lines = [
         f"{total} tasks  ·  {done} completed  ·  {failed_n} failed  ·  {skipped} skipped",
-        f"Duration: {duration_s:.1f}s  ·  Cost: {cost_str}  ·  Cache hits: {cache_hits}",
+        f"Duration: {duration_hms}  ·  Cost: {cost_str}  ·  Cache hits: {cache_hits}",
         f"run id: {state.run_id_short}",
     ]
     console.print(Panel("\n".join(lines), title="Run complete", border_style="hive.success"))