@dotdrelle/wiki-manager 0.15.94 → 0.15.96

package/README.md

@@ -121,47 +121,60 @@ in isolated workspaces.
 
 ## How wikiLLM compares
 
-Several open projects now build a Markdown wiki with an LLM. They target
+Several open projects now build an LLM-maintained knowledge layer over your
+sources — some as a wiki, some as a retrieval and answer platform. They target
 **different problems** — the useful questions are *what goes in, what comes out,
-and who operates it*. Snapshot as of 2026; all of these move quickly.
+and who operates it*. Snapshot as of **September 2026**; all of these move quickly.
 
 ✅ first-class · 🟡 partial or indirect · ❌ not a goal
 
-Projects compared: [OpenWiki](https://github.com/langchain-ai/openwiki),
-[DeepWiki-Open](https://github.com/asyncfuncai/deepwiki-open),
+Projects compared: [OpenWiki](https://github.com/langchain-ai/openwiki) and
+[DeepWiki-Open](https://github.com/asyncfuncai/deepwiki-open) (code / knowledge
+wikis), [RAGFlow](https://github.com/infiniflow/ragflow) and
+[Onyx](https://github.com/onyx-dot-app/onyx) (RAG platforms), and
 [GraphRAG](https://github.com/microsoft/graphrag).
 
 <table>
 <thead>
-<tr><th><small>Need</small></th><th><small><strong>wikiLLM</strong></small></th><th><small><strong>OpenWiki</strong></small></th><th><small><strong>DeepWiki-Open</strong></small></th><th><small><strong>GraphRAG</strong></small></th></tr>
+<tr>
+<th><small>Need</small></th>
+<th><small><strong>wikiLLM</strong></small></th>
+<th><small><strong>Code / knowledge wikis</strong><br>OpenWiki · DeepWiki-Open</small></th>
+<th><small><strong>RAG platforms</strong><br>RAGFlow · Onyx</small></th>
+<th><small><strong>Graph pipeline</strong><br>GraphRAG</small></th>
+</tr>
 </thead>
 <tbody>
-<tr><td><small>Input</small></td><td><small>✅ Business docs — Confluence, PDF, Office, SaaS</small></td><td><small>✅ Codebase (code mode)</small></td><td><small>✅ Code repo → diagrams</small></td><td><small>🟡 Plain-text corpus only</small></td></tr>
-<tr><td><small>Output</small></td><td><small>✅ Maintained wiki <strong>+ deliverables</strong> from your templates</small></td><td><small>🟡 Wiki about the code, for agents</small></td><td><small>🟡 Interactive wiki + diagrams</small></td><td><small>❌ Entity graph + summaries — no wiki</small></td></tr>
-<tr><td><small>Keep current</small></td><td><small>✅ Re-ingest / scheduled</small></td><td><small>✅ <code>--update</code>, CI action</small></td><td><small>🟡 Regenerated per run</small></td><td><small>✅ <code>graphrag update</code> (delta)</small></td></tr>
-<tr><td><small>Evidence &amp; citations</small></td><td><small>🟡 Cites retrieved context</small></td><td><small>✅ Claims tied to versioned source</small></td><td><small>🟡 RAG-cited answers</small></td><td><small>✅ Citations to text units</small></td></tr>
-<tr><td><small>Corpus-wide Q&amp;A</small></td><td><small>🟡 BM25 + vector feeding generation</small></td><td><small>❌</small></td><td><small>🟡 Repo-scoped RAG chat</small></td><td><small>✅ Local/global community search</small></td></tr>
-<tr><td><small>Team UI</small></td><td><small>✅ Web console — wiki, graph, chat, runs (single-user today)</small></td><td><small>🟡 Local viewer + CLI chat</small></td><td><small>✅ Self-hosted web app + RAG</small></td><td><small>❌ Library / CLI</small></td></tr>
-<tr><td><small>Multi-project isolation</small></td><td><small>✅ Workspaces, own services, ports, secrets</small></td><td><small>❌ One wiki per run</small></td><td><small>❌ One wiki per repo</small></td><td><small>❌ One index per corpus</small></td></tr>
-<tr><td><small>Orchestration &amp; governance</small></td><td><small>✅ Approval-gated dispatcher, budgets, idempotent writes, crash recovery</small></td><td><small>❌ One agent loop</small></td><td><small>❌ One generation pipeline</small></td><td><small>❌ Indexing pipeline</small></td></tr>
-<tr><td><small>Connectors as services</small></td><td><small>✅ Independent MCP agents (Confluence, docs, e-mail…)</small></td><td><small>🟡 Built-in connector set</small></td><td><small>❌</small></td><td><small>❌</small></td></tr>
-<tr><td><small>Offline / local models</small></td><td><small>✅ Per-workspace OpenAI-compatible or gateway (Ollama, vLLM, MLX…)</small></td><td><small>✅ 13+ providers</small></td><td><small>✅ Ollama</small></td><td><small>✅ Any OpenAI-compatible</small></td></tr>
-<tr><td><small>License</small></td><td><small>❌ PolyForm <strong>Noncommercial</strong></small></td><td><small>✅ MIT</small></td><td><small>✅ MIT</small></td><td><small>✅ MIT</small></td></tr>
+<tr><td><small>Input</small></td><td><small>✅ Business docs — Confluence, PDF, Office, SaaS</small></td><td><small>✅ Code repo; OpenWiki also personal sources (Notion, Gmail, Slack…)</small></td><td><small>✅ PDF/Office/images, Confluence, S3, 50+ connectors</small></td><td><small>🟡 Plain text</small></td></tr>
+<tr><td><small>Output</small></td><td><small>✅ Maintained wiki <strong>+ deliverables</strong></small></td><td><small>✅ Linked Markdown wiki (+ graph / diagrams)</small></td><td><small>🟡 Grounded RAG answers, not a wiki</small></td><td><small>❌ Entity graph + summaries</small></td></tr>
+<tr><td><small>Agents &amp; actions</small></td><td><small>✅ Capability dispatcher, external agentic runtime, MCP tools</small></td><td><small>✅ Doc-generation agents, MCP connectors</small></td><td><small>✅ Agentic workflow, MCP actions, deep research</small></td><td><small>❌ Indexing pipeline</small></td></tr>
+<tr><td><small>Keep current</small></td><td><small>✅ Re-ingest / scheduled</small></td><td><small>✅ <code>--update</code> / regenerate, CI</small></td><td><small>✅ Scheduled connector sync</small></td><td><small>🟡 Maintenance mode</small></td></tr>
+<tr><td><small>Team UI</small></td><td><small>✅ Web console — wiki, graph, chat, runs</small></td><td><small>🟡 CLI + visualizer; DeepWiki-Open web app</small></td><td><small>✅ Self-hosted web app</small></td><td><small>❌ Library / CLI</small></td></tr>
+<tr><td><small>Multi-project isolation</small></td><td><small>✅ Workspaces, own services, ports, secrets</small></td><td><small>❌ One wiki per repo / directory</small></td><td><small>🟡 Datasets / teams, not isolated services</small></td><td><small>❌ One index per corpus</small></td></tr>
+<tr><td><small>Human approval &amp; governance</small></td><td><small>✅ Approval-gated dispatcher, budgets, crash recovery</small></td><td><small>❌ PR review only</small></td><td><small>🟡 RBAC / SSO (Onyx enterprise)</small></td><td><small>❌</small></td></tr>
+<tr><td><small>License</small></td><td><small>❌ PolyForm <strong>Noncommercial</strong></small></td><td><small>✅ MIT</small></td><td><small>✅ Apache-2.0 / MIT CE</small></td><td><small>✅ MIT</small></td></tr>
 </tbody>
 </table>
 
+<small>Per-project details: OpenWiki emits OKF v0.2 and maintains a versioned
+evidence graph of “grounded claims”; GraphRAG is a research project now in
+maintenance mode; Onyx’s SSO/RBAC live in its enterprise edition.</small>
+
 **The short version:**
 
-- **OpenWiki** and **DeepWiki-Open** document *source code*. Point wikiLLM at a
-  repository and there is nothing for it to ingest; point either of them at a
-  stack of Confluence pages and a Word document and that is not their job.
-- **GraphRAG** builds *retrieval structure*, not a wiki you read or deliverables
-  you ship — it is a strong back end for corpus-wide Q&A, and complementary
-  rather than competing.
-- **wikiLLM** is the only one of the four whose output is *both* a browsable wiki
-  *and* regenerated business documents, and the only one with the operational
-  layer — isolated projects, bounded approvals, automatic recovery, a web
-  console — that a shared internal tool needs.
+- **OpenWiki** and **DeepWiki-Open** build wikis from a **code repository**
+  (OpenWiki also ingests personal sources — Notion, Gmail, Slack…). Their input
+  is code or personal feeds, not a stack of business documents feeding your
+  deliverable templates.
+- **RAGFlow** and **Onyx** are RAG platforms: they index sources and answer
+  questions from them, with agents and connectors, but the output is an answer,
+  not a wiki you browse or a document you ship.
+- **GraphRAG** builds retrieval structure and is now in maintenance mode — a
+  complementary back end, not a wiki.
+- **wikiLLM** is the only one whose output is *both* a browsable wiki *and*
+  regenerated business documents, and the only one with the operational layer —
+  isolated projects, bounded approvals, automatic recovery, a web console —
+  that a shared internal tool needs.
 
 **What wikiLLM does *not* try to do (today):**
 
@@ -170,8 +183,6 @@ Projects compared: [OpenWiki](https://github.com/langchain-ai/openwiki),
 - Serve a true multi-user instance with per-user identity and an attributed
   audit trail. This is a single-user deployment baseline (see the scope note
   above).
-- Expose a graph-query API over the corpus the way GraphRAG does; retrieval is
-  BM25 plus a vector index feeding generation.
 - Ship or host the multi-provider AI gateway — routing to several providers is
   supported, the gateway itself is infrastructure you bring.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdrelle/wiki-manager",
-  "version": "0.15.94",
+  "version": "0.15.96",
   "description": "Agentic shell and orchestration cockpit for llm-wiki workspaces.",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   },
   "scripts": {
     "start": "bun ./bin/wiki-manager.js",
-    "test": "node --test src/core/skillInvocation.test.js src/core/skillCompiler.test.js src/runtime/skillRun.test.js src/runtime/controlDrain.test.js src/runtime/controlCancellation.test.js src/cli/runtimeStartup.test.js src/cli/wiki-manager.test.js src/agent/graph.test.js src/agent/skillRecursion.test.js src/contracts/schemas.test.js src/core/activity.test.js src/core/env.test.js src/core/agentsCompose.test.js src/core/profileServiceStatus.test.js src/core/workspaceProfile.test.js src/core/buildInfo.test.js src/core/agentEvents.test.js src/core/skillChainView.test.js src/core/runtimeLog.test.js src/core/runtimeEventAdapter.test.js src/activity/activityAggregator.test.js src/graph/runGraphProjector.test.js src/core/workflow.test.js src/core/planPatch.test.js src/core/agentLoop.test.js src/core/plan.test.js src/core/mcp.test.js src/core/toolLoop.test.js src/core/documentIntake.test.js src/core/dockerCompose.test.js src/core/otherWorkspacesRunning.test.js src/core/wikiSetup.test.js src/core/wikiWorkspace.test.js src/core/wikiWorkspaceStart.test.js src/core/wikirc.test.js src/core/workspaceInherit.test.js src/core/cacert.test.js src/core/composeOverrides.test.js src/core/setEnvValue.test.js src/core/commandFailure.test.js src/core/currentArtifact.test.js src/core/googleGrants.test.js src/core/modelFetch.test.js src/core/startupCheck.test.js src/core/queueStore.test.js src/orchestrator/agentRegistry.test.js src/orchestrator/capabilityRegistry.test.js src/orchestrator/capabilityResolver.test.js src/orchestrator/planValidator.test.js src/orchestrator/planIntegrator.test.js src/orchestrator/taskStatuses.test.js src/orchestrator/scheduler.test.js src/orchestrator/attemptManager.test.js src/orchestrator/resultAggregator.test.js src/orchestrator/approvalPolicy.test.js src/orchestrator/dispatcher.test.js src/orchestrator/objectiveResolver.test.js src/orchestrator/providers/fakeRuntimeProvider.test.js src/orchestrator/providers/runtimeProviders.test.js src/orchestrator/providers/dispatcherExternalRuntime.test.js src/orchestrator/providers/deepAgentsProvider.test.js src/commands/slash.test.js src/shell/repl.test.js src/shell/setupWizardModality.test.js src/shell/setupWizardPlaceholders.test.js src/shell/setupWizardSuggestions.test.js src/shell/setupWizardDiscovery.test.js src/shell/wrapText.test.js src/runtime/lifecycle.test.js src/runtime/store.test.js src/runtime/workspaceIsolation.test.js src/runtime/controlMessages.test.js src/runtime/recoveryManager.test.js src/runtime/server.test.js src/runtime/supervisor.test.js src/runtime/delegation.test.js src/runtime/runner.test.js src/runtime/runner.e2e.test.js src/runtime/skillChain.e2e.test.js src/runtime/donna-contract.test.js src/runtime/approvals.test.js src/runtime/auth.test.js src/runtime/totp.test.js src/runtime/loginSession.test.js src/runtime/loginRoutes.test.js",
+    "test": "node --test src/core/skillInvocation.test.js src/core/skillCompiler.test.js src/runtime/skillRun.test.js src/runtime/controlDrain.test.js src/runtime/controlCancellation.test.js src/cli/runtimeStartup.test.js src/cli/wiki-manager.test.js src/agent/graph.test.js src/agent/skillRecursion.test.js src/contracts/schemas.test.js src/core/activity.test.js src/core/env.test.js src/core/agentsCompose.test.js src/core/profileServiceStatus.test.js src/core/workspaceProfile.test.js src/core/buildInfo.test.js src/core/agentEvents.test.js src/core/skillChainView.test.js src/core/runtimeLog.test.js src/core/runtimeEventAdapter.test.js src/activity/activityAggregator.test.js src/graph/runGraphProjector.test.js src/core/workflow.test.js src/core/planPatch.test.js src/core/agentLoop.test.js src/core/plan.test.js src/core/mcp.test.js src/core/toolLoop.test.js src/core/documentIntake.test.js src/core/dockerCompose.test.js src/core/otherWorkspacesRunning.test.js src/core/wikiSetup.test.js src/core/wikiWorkspace.test.js src/core/wikiWorkspaceStart.test.js src/core/wikirc.test.js src/core/workspaceInherit.test.js src/core/cacert.test.js src/core/composeOverrides.test.js src/core/setEnvValue.test.js src/core/commandFailure.test.js src/core/currentArtifact.test.js src/core/googleGrants.test.js src/core/modelFetch.test.js src/core/startupCheck.test.js src/core/queueStore.test.js src/orchestrator/agentRegistry.test.js src/orchestrator/capabilityRegistry.test.js src/orchestrator/capabilityResolver.test.js src/orchestrator/planValidator.test.js src/orchestrator/planIntegrator.test.js src/orchestrator/taskStatuses.test.js src/orchestrator/scheduler.test.js src/orchestrator/attemptManager.test.js src/orchestrator/resultAggregator.test.js src/orchestrator/approvalPolicy.test.js src/orchestrator/dispatcher.test.js src/orchestrator/objectiveResolver.test.js src/orchestrator/providers/fakeRuntimeProvider.test.js src/orchestrator/providers/runtimeProviders.test.js src/orchestrator/providers/dispatcherExternalRuntime.test.js src/orchestrator/providers/deepAgentsProvider.test.js src/commands/slash.test.js src/shell/repl.test.js src/shell/setupWizardModality.test.js src/shell/setupWizardPlaceholders.test.js src/shell/setupWizardSuggestions.test.js src/shell/setupWizardDiscovery.test.js src/shell/wrapText.test.js src/runtime/lifecycle.test.js src/runtime/store.test.js src/runtime/workspaceIsolation.test.js src/runtime/controlMessages.test.js src/runtime/deltaCoalescer.test.js src/runtime/recoveryManager.test.js src/runtime/server.test.js src/runtime/supervisor.test.js src/runtime/delegation.test.js src/runtime/runner.test.js src/runtime/runner.e2e.test.js src/runtime/skillChain.e2e.test.js src/runtime/donna-contract.test.js src/runtime/approvals.test.js src/runtime/auth.test.js src/runtime/totp.test.js src/runtime/loginSession.test.js src/runtime/loginRoutes.test.js",
     "check-versions": "node scripts/check-versions.js",
     "prepack": "node scripts/check-versions.js",
     "prepublishOnly": "node scripts/check-versions.js",

package/src/agent/graph.js

@@ -31,6 +31,7 @@ import { artifactFromToolCall, currentArtifactFor, currentArtifactPromptLine, re
 import { capabilityRegistryForSession } from '../orchestrator/capabilityRegistry.js';
 import { objectiveForResolution } from '../orchestrator/objectiveResolver.js';
 import { fetchRuntimeState, postRuntimeCancel, postRuntimeControl, postRuntimeDelegate, postRuntimeKill, postRuntimeSkill } from '../runtime/client.js';
+import { formatPublicSkillInvocation, generateSkillAcknowledgment } from '../runtime/skillRun.js';
 
 const MAX_TOOL_ITERATIONS = 80;
 /**
@@ -1377,24 +1378,6 @@ export function buildAgentSystemPrompt(state) {
   return customPrompt ? `${customPrompt}\n\n${agentContext}` : agentContext;
 }
 
-export function buildLimitedAgentResponse(state, reason = 'no workspace loaded with .wikirc.yaml') {
-  const workspace = state.session.workspace ?? 'no workspace selected';
-  const wikirc = state.session.wikirc?.profile ?? 'no profile loaded';
-  return [
-    `Donna is active. Current workspace: ${workspace}.`,
-    `Current wikirc profile: ${wikirc}.`,
-    '',
-    'I am the shell agent mode: use `/agent` to route free text through this LangGraph graph, or `/chat` for direct chat.',
-    `LLM connection: limited mode (${reason}).`,
-    `Available primitives: ${commandList(state.session)}.`,
-    '',
-    'Connected MCP tools:',
-    formatMcpToolsForAgent(state.session.mcp),
-    '',
-    'Limited mode: workspace, Docker Compose tools, MCP calls, /wiki fallback, skill discovery, and headless mode are wired.',
-    'Use `/help` to see deterministic shell commands.',
-  ].join('\n');
-}
 
 export function formatLlmUnavailableMessage(reason) {
   const clean = String(reason ?? 'unknown reason').replace(/\s+/g, ' ').trim();
@@ -1903,6 +1886,7 @@ export function createAgentGraph(options = {}) {
     const toolCalls = state.pendingToolCalls ?? [];
     const toolResultMessages = [];
     let terminalFailure = null;
+    let skillLaunch = null;
 
     for (const call of toolCalls) {
       const resolved = resolveToolCallName(state.session.mcp, call.function.name, INTERNAL_TOOL_SERVERS);
@@ -2017,6 +2001,19 @@ export function createAgentGraph(options = {}) {
             if (skillResult?.terminal === true) {
               terminalFailure = skillResult.code ?? 'skill_failed';
               ok = false;
+            } else if (skillResult?.accepted === true) {
+              // The skill owns execution from here. Without this the turn kept
+              // going and the model could re-delegate or refuse the very
+              // objective it had just launched — the "launched, then no agent
+              // capable" contradiction. End the turn with the launch
+              // acknowledgement instead of another tool round.
+              skillLaunch = {
+                publicInput: formatPublicSkillInvocation(
+                  skillResult.skill ?? args.skillName ?? '',
+                  args.arguments && typeof args.arguments === 'object' ? args.arguments : {},
+                ),
+                objectives: Number(skillResult.objectiveCount ?? skillResult.objectives ?? 1) || 1,
+              };
             }
           }
           if (tool === 'delegate' && /^Runtime control error \(delegate\):/i.test(resultText)) {
@@ -2181,6 +2178,24 @@ export function createAgentGraph(options = {}) {
         invalidResponseRetries: 0,
       };
     }
+    if (skillLaunch) {
+      // Deterministic, localized acknowledgement, generated in the session
+      // language like the `/turn` skill path. No further model turn: the skill
+      // is launched and owns execution, so nothing can contradict it.
+      const response = await generateSkillAcknowledgment(state.session, skillLaunch).catch(
+        () => `Started ${skillLaunch.publicInput} — ${skillLaunch.objectives} step(s) in progress.`,
+      );
+      return {
+        messages: toolResultMessages,
+        pendingToolCalls: null,
+        response,
+        forceDelegation: false,
+        retryWithoutTool: false,
+        terminalToolFailure: false,
+        invalidToolCallRetries: 0,
+        invalidResponseRetries: 0,
+      };
+    }
     return {
       messages: toolResultMessages,
       pendingToolCalls: null,
@@ -2193,6 +2208,9 @@ export function createAgentGraph(options = {}) {
   }
 
   function routeToolExecutor(state) {
+    // A skill launch already produced its final acknowledgement: end the turn
+    // instead of routing back for another model call that could contradict it.
+    if (state.response != null) return END;
     return 'orchestrator';
   }
 

package/src/agent/graph.test.js

@@ -624,7 +624,10 @@ test('an explicitly selected skill runs through the intra-runtime path with name
     },
   });
   const result = await createAgentGraph().invoke({ input: 'lance le skill deliver avec le template Quarterly report', session });
-  assert.equal(result.response, 'Skill mis en file.');
+  // Launching a skill ends the turn: the acknowledgement is generated once and
+  // the model is not given a second chance to re-delegate or contradict it.
+  assert.equal(result.response, 'Started /deliver deliverable="Quarterly report" — 1 step(s) in progress.');
+  assert.equal(mainCalls, 1);
   // `skillStack` accompagne désormais la demande : le run imbriqué démarre après
   // le nettoyage de celui-ci, et c'est le seul canal par lequel il peut savoir
   // quelles compétences sont déjà ouvertes au-dessus de lui.

package/src/cli/wiki-manager.js

@@ -29,6 +29,8 @@ import { extractActivity, mergePolledActivity, parseJsonText, sessionActivities,
 import { syncActivitiesToPlan, formatPlanStatus } from '../core/plan.js';
 import { createAgentEvent, dispatchAgentEvent, reduceAgentEvents } from '../core/agentEvents.js';
 import { runAgentTurn, runAgenticLoop } from '../core/agentLoop.js';
+import { createDeltaCoalescer } from '../runtime/deltaCoalescer.js';
+import { TERMINAL_STATUS_SET } from '../orchestrator/taskStatuses.js';
 import { resolveCapabilityConcurrency } from '../orchestrator/scheduler.js';
 import { capabilityRegistryForSession } from '../orchestrator/capabilityRegistry.js';
 import { CapabilityUnavailableError, resolve as resolveCapability } from '../orchestrator/capabilityResolver.js';
@@ -827,7 +829,7 @@ async function runHeadless(argv, agent) {
 // export finished, before the ingest had even started. The control queue is the
 // only place where the whole chain is observable, so the wait is scoped to
 // chainId and ends when every item of that chain is terminal.
-const CHAIN_TERMINAL_STATUSES = new Set(['done', 'failed', 'cancelled', 'skipped']);
+const CHAIN_TERMINAL_STATUSES = TERMINAL_STATUS_SET;
 
 export async function waitForRuntimeChain(session, log, {
   chainId,
@@ -1739,7 +1741,21 @@ async function runRuntime(argv, agent) {
       workspace: context.workspace ?? ephemeral.workspace ?? null,
     }));
     const messages = conversationSeed({ agentProjection: persistedProjection }, input);
+    // Streaming fragments are coalesced before they are persisted and pushed —
+    // one synchronous SQLite insert (plus one SSE write) per token stalled the
+    // event loop, freezing both chats (serve and ShellUI) while a long answer
+    // was still being produced. Flushed before any non-delta event so ordering
+    // and the final tail are preserved.
+    const deltaCoalescer = createDeltaCoalescer((delta) => dispatchAgentEvent(ephemeral, createAgentEvent('assistant_delta', {
+      origin: 'runtime_turn',
+      turnId,
+      workspace: context.workspace ?? null,
+      payload: { delta },
+    })), { intervalMs: 80 });
     ephemeral._onAgentEvent = (event) => {
+      // Never let a final message (or any other event) overtake the buffered
+      // fragments that precede it: flush them first, in order.
+      if (event.type !== 'assistant_delta' && event.type !== 'assistant_delta_reset') deltaCoalescer.flush();
       const interactiveEvent = {
         ...event,
         origin: 'runtime_turn',
@@ -1785,28 +1801,30 @@ async function runRuntime(argv, agent) {
       response = await runHeadlessChatTurn(ephemeral, input, {
         history,
         onStep: ephemeral._onStep,
-        // Fragments de réponse publiés au fil de l'eau. Le réducteur les
-        // agrège dans la dernière entrée de conversation (`assistant_delta`),
-        // que `assistant_message` vient ensuite figer : les deux interfaces
-        // voient la réponse s'écrire, au lieu d'attendre le tour complet.
-        onTextDelta: (delta) => dispatchAgentEvent(ephemeral, createAgentEvent('assistant_delta', {
-          origin: 'runtime_turn',
-          turnId,
-          workspace: context.workspace ?? null,
-          payload: { delta },
-        })),
-        onTextReset: () => dispatchAgentEvent(ephemeral, createAgentEvent('assistant_delta_reset', {
-          origin: 'runtime_turn',
-          turnId,
-          workspace: context.workspace ?? null,
-          payload: {},
-        })),
+        // Fragments de réponse publiés au fil de l'eau, coalescés (voir
+        // deltaCoalescer ci-dessus). Le réducteur les agrège dans la dernière
+        // entrée de conversation (`assistant_delta`), que `assistant_message`
+        // vient ensuite figer : les deux interfaces voient la réponse s'écrire
+        // sans qu'un insert SQLite par token ne bloque le flux.
+        onTextDelta: (delta) => deltaCoalescer.push(delta),
+        onTextReset: () => {
+          deltaCoalescer.reset();
+          dispatchAgentEvent(ephemeral, createAgentEvent('assistant_delta_reset', {
+            origin: 'runtime_turn',
+            turnId,
+            workspace: context.workspace ?? null,
+            payload: {},
+          }));
+        },
         openWikiPages,
       });
     } else {
       ephemeral.openWikiPages = openWikiPages;
       response = await runAgentTurn(agent, ephemeral, input, { messages, signal });
     }
+    // Flush the tail before the turn is finalized, then stop the timer.
+    deltaCoalescer.flush();
+    deltaCoalescer.dispose();
     // Persist the artifact the turn may have opened/edited (template_write,
     // template_read, …) back onto the long-lived session, so the next /turn —
     // chat or agent — sees it. The ephemeral session is otherwise discarded.

package/src/core/agentEvents.js

@@ -1,4 +1,5 @@
 import { normalizeActivity } from './activity.js';
+import { cloneJson } from './json.js';
 import { attachActivityToExistingPlan, syncActivitiesToPlan } from './plan.js';
 import { applyPlanPatch, normalizePlanPatch, normalizePlanRevision, rebasePlanPatch } from './planPatch.js';
 import { formatRuntimeLogPayload, isDispatchPlumbingLine, normalizeRuntimeLog, shortTaskLabel } from './runtimeLog.js';
@@ -1240,6 +1241,3 @@ function sortedActivities(activities) {
     .sort((a, b) => String(a.updatedAt ?? '').localeCompare(String(b.updatedAt ?? '')));
 }
 
-function cloneJson(value) {
-  return value == null ? value : JSON.parse(JSON.stringify(value));
-}

package/src/core/buildInfo.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.15.94",
-  "commit": "00c41b1"
+  "version": "0.15.96",
+  "commit": "fbeddf2"
 }

package/src/core/googleGrants.js

@@ -33,6 +33,3 @@ export function defaultGoogleGrants() {
   return [...GOOGLE_GRANTS];
 }
 
-export function describeGoogleGrant(grant) {
-  return GOOGLE_GRANT_LABELS[grant] ?? null;
-}

package/src/core/json.js

@@ -0,0 +1,9 @@
+/*
+ * Deep clone via a JSON round-trip; `null`/`undefined` pass through.
+ *
+ * Three modules had grown their own byte-identical copy (agentEvents,
+ * agentRegistry, planValidator). One implementation, imported.
+ */
+export function cloneJson(value) {
+  return value == null ? value : JSON.parse(JSON.stringify(value));
+}

package/src/core/mcp.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { managerEnvFile, managerMcpEndpointsFile, readEnvFile } from './env.js';
 
-const WIKI_MANAGER_VERSION = '0.15.94';
+const WIKI_MANAGER_VERSION = '0.15.96';
 
 function envValue(key) {
   const filePath = managerEnvFile();

package/src/core/plan.js

@@ -48,10 +48,6 @@ export function extractHeadlessPlan(text) {
   return steps;
 }
 
-export function matchCompletedToPlan(plan, completed) {
-  if (!plan) return;
-  syncActivitiesToPlan(plan, completed.filter((activity) => activity.terminal));
-}
 
 export function syncActivitiesToPlan(plan, activities) {
   if (!plan) return;

package/src/core/progressNotes.js

@@ -48,7 +48,3 @@ export function toolResultNote(name, ok, detail) {
   return reason ? `${tool} done: ${reason}` : `${tool} done.`;
 }
 
-export function turnDoneNote(steps) {
-  if (!steps) return 'Done.';
-  return `Done — ${steps} step${steps > 1 ? 's' : ''}.`;
-}

package/src/core/skillChainView.js

@@ -7,6 +7,8 @@
  * which is why the shaping lives here and not in either renderer.
  */
 
+import { TERMINAL_STATUS_SET } from '../orchestrator/taskStatuses.js';
+
 const SYMBOLS = {
   done: '✓',
   running: '●',
@@ -29,7 +31,7 @@ export function selectionKindLabel(selectionKind) {
   return SELECTION_KIND_LABELS[selectionKind] ?? selectionKind ?? null;
 }
 
-export const TERMINAL = new Set(['done', 'failed', 'cancelled', 'skipped']);
+export const TERMINAL = TERMINAL_STATUS_SET;
 
 // Objectives are whole paragraphs; a chain view needs a line. Keep the first
 // sentence, drop the parameter block the compiler appends, and never cut a word

package/src/core/toolLoop.js

@@ -38,7 +38,15 @@ export async function runBoundedToolLoop({
   // livre le texte au fil de l'eau. Sans lui, la réponse finale n'apparaissait
   // qu'une fois complète — le tour paraissait figé pendant toute sa durée.
   const canStream = typeof onTextDelta === 'function' && typeof llm?.streamWithTools === 'function';
+  // The exact same tool + arguments called again is a loop, not progress: a
+  // model that keeps re-issuing `search("x")` will never finish, and burning
+  // the whole iteration cap on it only produced "could not finish". Track the
+  // signatures and stop as soon as a turn repeats one already executed.
+  const seen = new Set();
+  const signature = (call) => `${call?.function?.name ?? ''}\u0000${String(call?.function?.arguments ?? '')}`;
+  let iterations = 0;
   for (let i = 0; i < cap; i += 1) {
+    iterations = i + 1;
     onStep?.(i + 1, cap);
     let streamedText = false;
     const result = canStream
@@ -62,10 +70,12 @@ export async function runBoundedToolLoop({
     if (calls.length === 0) {
       return {
         content: result?.content ?? result?.message?.content ?? '',
-        iterations: i + 1,
+        iterations,
         capped: false,
       };
     }
+    if (calls.every((call) => seen.has(signature(call)))) break;
+    for (const call of calls) seen.add(signature(call));
     convo.push(result.message ?? { role: 'assistant', content: result.content ?? '', tool_calls: calls });
     // Tool calls within one turn are independent: dispatch concurrently, then
     // replay results in the model's call order so the transcript stays stable.
@@ -77,5 +87,49 @@ export async function runBoundedToolLoop({
       convo.push({ role: 'tool', tool_call_id: outcome.tool_call_id, content: outcome.content });
     }
   }
-  return { content: '', iterations: cap, capped: true };
+  // Cap reached or a loop detected: ask once more WITHOUT tools for the best
+  // answer the results gathered so far support. Returning '' here is what made
+  // a long search end in a dead-end instead of the partial answer it had
+  // already collected.
+  const content = await finalAnswerWithoutTools({ llm, system, convo, canStream, onTextDelta, onTextReset, signal });
+  return { content, iterations, capped: true };
+}
+
+async function finalAnswerWithoutTools({
+  llm,
+  system,
+  convo,
+  canStream,
+  onTextDelta,
+  onTextReset,
+  signal,
+}) {
+  try {
+    if (canStream) {
+      let text = '';
+      const result = await llm.streamWithTools({
+        system,
+        tools: [],
+        messages: convo,
+        toolChoice: 'auto',
+        onTextDelta: (delta) => { text += delta; onTextDelta(delta); },
+        signal,
+      });
+      // A tool call despite the empty toolset is not an answer: drop whatever
+      // it streamed and let the caller fall back to its own message.
+      if (result?.tool_calls?.length) { onTextReset?.(); return ''; }
+      return String(result?.content ?? text ?? '').trim();
+    }
+    const result = await llm.completeWithTools({
+      system,
+      tools: [],
+      messages: convo,
+      toolChoice: 'auto',
+      signal,
+    });
+    if (result?.tool_calls?.length) return '';
+    return String(result?.content ?? result?.message?.content ?? '').trim();
+  } catch {
+    return '';
+  }
 }

package/src/core/toolLoop.test.js

@@ -61,16 +61,47 @@ test('runs concurrent tool calls and replays results in call order', async () =>
   assert.deepEqual(order, ['a', 'b']); // preserved model call order
 });
 
-test('reports capped when the model keeps calling tools past the cap', async () => {
+test('stops on a repeated identical tool call instead of burning the cap', async () => {
   const llm = {
-    async completeWithTools() {
+    async completeWithTools({ tools }) {
+      if (tools.length === 0) return { content: 'Synthèse des résultats.', tool_calls: [] };
       const calls = [toolCall('x', 's__status')];
       return { message: { role: 'assistant', content: '', tool_calls: calls }, tool_calls: calls };
     },
   };
-  const out = await runBoundedToolLoop({ llm, tools: [], executeCall: async () => 'r', maxIterations: 3 });
+  const out = await runBoundedToolLoop({
+    llm,
+    tools: [{ function: { name: 's__status' } }],
+    executeCall: async () => 'r',
+    maxIterations: 8,
+  });
+  assert.equal(out.capped, true);
+  // The same call twice is a loop: it stopped well before the cap.
+  assert.ok(out.iterations < 8, `expected an early stop, got ${out.iterations}`);
+  // And the turn still answers from what it gathered instead of a dead-end.
+  assert.equal(out.content, 'Synthèse des résultats.');
+});
+
+test('answers from the gathered results when the cap is reached', async () => {
+  let round = 0;
+  const llm = {
+    async completeWithTools({ tools }) {
+      round += 1;
+      if (round <= 2 && tools.length > 0) {
+        const calls = [toolCall('x', 's__search', `{"q":"${round}"}`)];
+        return { message: { role: 'assistant', content: '', tool_calls: calls }, tool_calls: calls };
+      }
+      return { content: "Voici ce que j'ai trouvé.", tool_calls: [] };
+    },
+  };
+  const out = await runBoundedToolLoop({
+    llm,
+    tools: [{ function: { name: 's__search' } }],
+    executeCall: async () => 'r',
+    maxIterations: 2,
+  });
   assert.equal(out.capped, true);
-  assert.equal(out.iterations, 3);
+  assert.equal(out.content, "Voici ce que j'ai trouvé.");
 });
 
 test('propagates an abort thrown by executeCall', async () => {

package/src/orchestrator/agentRegistry.js

@@ -1,5 +1,6 @@
 import { createAgentEvent, dispatchAgentEvent, dispatchRuntimeLog } from '../core/agentEvents.js';
 import { callMcpTool, formatMcpToolResult } from '../core/mcp.js';
+import { cloneJson } from '../core/json.js';
 import { assertContract } from '../contracts/schemas.js';
 
 const AVAILABLE = 'available';
@@ -320,6 +321,3 @@ function cloneAgent(agent) {
   };
 }
 
-function cloneJson(value) {
-  return value == null ? value : JSON.parse(JSON.stringify(value));
-}

package/src/orchestrator/dependencyResolver.js

@@ -174,6 +174,3 @@ function taskId(task) {
   return String(task?.id ?? task?.step);
 }
 
-export function isTerminalTask(task) {
-  return isTerminal(statusOf(task));
-}

package/src/orchestrator/planValidator.js

@@ -1,4 +1,5 @@
 import { validateContract } from '../contracts/schemas.js';
+import { cloneJson } from '../core/json.js';
 
 const SUPPORTED_CONTRACT_VERSIONS = new Set(['1']);
 const MUTATING_OPERATIONS = new Set([
@@ -529,6 +530,3 @@ function issue(code, message, details = {}) {
   return { code, message, details };
 }
 
-function cloneJson(value) {
-  return value == null ? value : JSON.parse(JSON.stringify(value));
-}

package/src/orchestrator/providers/runtimeProvider.js

@@ -43,20 +43,6 @@ import { assertContract } from '../../contracts/schemas.js';
 
 export const RUNTIME_PROTOCOL_VERSION = '1';
 
-export const RUNTIME_EVENT_TYPES = [
-  'run_created',
-  'run_started',
-  'agent_thinking',
-  'tool_started',
-  'tool_finished',
-  'subagent_started',
-  'subagent_finished',
-  'message',
-  'approval_required',
-  'run_completed',
-  'run_failed',
-  'run_cancelled',
-];
 
 export class RuntimeProviderUnavailableError extends Error {
   constructor(runtime, reason) {