langflower 0.0.9 → 0.0.10

package/vendor/server/dist/bridge/wire-workflow-handlers.js

@@ -1,6 +1,7 @@
 import { Subscription } from 'rxjs';
 import { listResumableCheckpoints } from '../checkpoint/list-resumable-checkpoints.js';
 import { WorkflowCheckpointStore } from '../checkpoint/workflow-checkpoint-store.js';
+import { resetSessionExecutionFeed } from '../session/reset-session-execution-feed.js';
 import { buildSaveCurrentPayload } from '../workflow/build-save-current-payload.js';
 import { copyWorkflowToSession } from '../workflow/copy-workflow-to-session.js';
 import { createEmptyWorkflowInSession } from '../workflow/create-empty-workflow-in-session.js';
@@ -10,11 +11,17 @@ import { bridgeEmit, clientEmit } from './bridge-outbound.js';
 import { findClientById } from './client-index.js';
 import { isInboundEvent } from './inbound-guards.js';
 /**
- * Composer: clear selection → current snapshot → optional catalog sync.
- * Sibling steps — handlers do not call these in nested order themselves.
+ * Composer: optional feed reset → clear selection → current snapshot →
+ * optional catalog sync. Sibling steps — handlers do not nest these.
  */
 const syncAfterWorkflowMutation = async (bridge, context, session, client, options) => {
-    // 1. Clear selection (and notify tabs if it was set)
+    // 1. Document switch: empty feed before the new catalog so the UI never
+    // paints the previous run under the next workflow's nodes.
+    if (options.resetFeed === true) {
+        resetSessionExecutionFeed(session);
+        bridgeEmit(bridge, 'executionFeed.snapshot', session.buildExecutionFeed());
+    }
+    // 2. Clear selection (and notify tabs if it was set)
     if (options.clearSelection) {
         const hadSelection = session.selectedNodeId !== null;
         session.selectedNodeId = null;
@@ -22,19 +29,19 @@ const syncAfterWorkflowMutation = async (bridge, context, session, client, optio
             bridgeEmit(bridge, 'editor.nodeSelected', { node: null });
         }
     }
-    // 2. Authoritative current-workflow slice (session-shared — fan out)
+    // 3. Authoritative current-workflow slice (session-shared — fan out)
     bridgeEmit(bridge, 'workflow.current.snapshot', {
         activeWorkflow: session.activeWorkflow,
         currentStatus: { status: session.currentStatus },
     });
-    // 3. Resumable checkpoints for the active workflow (explicit boundaries)
+    // 4. Resumable checkpoints for the active workflow (explicit boundaries)
     const workflowId = session.activeWorkflowId ?? null;
     const checkpoints = await listResumableCheckpoints(new WorkflowCheckpointStore(context.projectDir), workflowId, session.activeWorkflow);
     bridgeEmit(bridge, 'runner.checkpoints.snapshot', {
         workflowId,
         checkpoints,
     });
-    // 4. Catalog sync
+    // 5. Catalog sync
     if (options.catalog.kind === 'broadcast') {
         const workflows = await context.workflowService.list();
         bridgeEmit(bridge, 'workflow.list.snapshot', { workflows });
@@ -67,11 +74,13 @@ export const wireWorkflowHandlers = (bridge, context, session) => {
             return;
         }
         let clearSelection = false;
+        let resetFeed = false;
         if (!session.isGraphLocked()) {
             // 1. Load document into session
             const loaded = await loadWorkflowIntoSession(session, context.workflowService, context.projectDir, raw.payload.workflowId, context.resolveDefinition);
             // 2. Persist current-workflow id when load succeeded
             if (loaded.ok) {
+                resetFeed = true;
                 await context.langflowerConfigService.setCurrentWorkflowId(raw.payload.workflowId);
                 if (loaded.repaired) {
                     const nodeCount = loaded.droppedNodeIds.length;
@@ -101,7 +110,7 @@ export const wireWorkflowHandlers = (bridge, context, session) => {
             });
         }
         // 3. Sync outbound
-        await syncAfterWorkflowMutation(bridge, context, session, connected, { clearSelection, catalog: { kind: 'none' } });
+        await syncAfterWorkflowMutation(bridge, context, session, connected, { clearSelection, catalog: { kind: 'none' }, resetFeed });
     }));
     subscription.add(bridge['workflow.saveCurrent.requested'].subscribe(async (raw) => {
         if (!isInboundEvent(raw)) {
@@ -163,11 +172,13 @@ export const wireWorkflowHandlers = (bridge, context, session) => {
             return;
         }
         let clearSelection = false;
+        let resetFeed = false;
         if (!session.isGraphLocked()) {
-            await createEmptyWorkflowInSession(session, context.workflowService, context.projectDir, context.resolveDefinition);
+            const created = await createEmptyWorkflowInSession(session, context.workflowService, context.projectDir, context.resolveDefinition);
             clearSelection = true;
+            resetFeed = created;
         }
-        await syncAfterWorkflowMutation(bridge, context, session, connected, { clearSelection, catalog: { kind: 'none' } });
+        await syncAfterWorkflowMutation(bridge, context, session, connected, { clearSelection, catalog: { kind: 'none' }, resetFeed });
     }));
     subscription.add(bridge['workflow.copy.requested'].subscribe(async (raw) => {
         if (!isInboundEvent(raw)) {
@@ -179,16 +190,19 @@ export const wireWorkflowHandlers = (bridge, context, session) => {
         }
         let catalogChanged = false;
         let clearSelection = false;
+        let resetFeed = false;
         if (!session.isGraphLocked()) {
             const copied = await copyWorkflowToSession(session, context.workflowService, context.projectDir, raw.payload.workflowId, context.resolveDefinition);
             if (copied && session.activeWorkflowId !== undefined) {
                 catalogChanged = true;
+                resetFeed = true;
                 await context.langflowerConfigService.setCurrentWorkflowId(session.activeWorkflowId);
             }
             clearSelection = true;
         }
         await syncAfterWorkflowMutation(bridge, context, session, connected, {
             clearSelection,
+            resetFeed,
             catalog: catalogChanged
                 ? { kind: 'broadcast' }
                 : { kind: 'none' },

package/vendor/server/dist/checkpoint/run-checkpoint-session.js

@@ -62,11 +62,11 @@ export class RunCheckpointSession {
             event[0] !== 'out') {
             return false;
         }
-        const [, nodeIdRaw, portId, state, value] = event;
-        if (state !== 'value' || typeof portId !== 'string') {
+        const [, nodeIdRaw, portId, response] = event;
+        if (!('value' in response) || typeof portId !== 'string') {
             return false;
         }
-        const jsonValue = toCheckpointJsonValue(value);
+        const jsonValue = toCheckpointJsonValue(response.value);
         if (jsonValue === undefined) {
             this.unsupportedValue = `${String(nodeIdRaw)}.${portId}`;
             return false;

package/vendor/server/dist/session/reset-session-execution-feed.d.ts

@@ -0,0 +1,6 @@
+import type { LangflowerSession } from './langflower-session.js';
+/**
+ * Drop the session run log so `buildExecutionFeed()` returns null.
+ * Call only when the runner is idle (document switch or user Clear).
+ */
+export declare const resetSessionExecutionFeed: (session: LangflowerSession) => void;

package/vendor/server/dist/session/reset-session-execution-feed.js

@@ -0,0 +1,8 @@
+/**
+ * Drop the session run log so `buildExecutionFeed()` returns null.
+ * Call only when the runner is idle (document switch or user Clear).
+ */
+export const resetSessionExecutionFeed = (session) => {
+    session.runtime.runner.clearEventLog();
+    session.runId = undefined;
+};

package/vendor/server/skeleton/nodes/my-nodes/package.json

@@ -5,7 +5,7 @@
 	"type": "module",
 	"peerDependencies": {
 		"@langflower/node-sdk": "0.1.0",
-		"@rx-evo/stateful-observable": "^0.5.2",
+		"@rx-evo/stateful-observable": "^0.6.0",
 		"rxjs": "^7.8.1"
 	}
 }

package/vendor/server/skeleton/skills/langflower-helper/SKILL.md

@@ -116,7 +116,11 @@ do not say coding pipelines “don’t exist” or are unavailable.
 - **Can:** Chat Input graphs start from the composer **Start** control. Plain
   **Run** stays disabled for those graphs.
 - **Can:** While running — Hard **Stop**, soft **Pause**, HITL and
-  `permission.ask` in the composer.
+  `permission.ask` in the composer. Work log **clears** on successful
+  workflow load / create / copy (not rename).
+- **Cannot:** Switch, rename, delete, copy, or create a workflow while a run
+  is active — Stop first. Same lock: inspector / canvas inline / palette
+  drag (`cursor-not-allowed`).
 - **Cannot:** Tell users to press plain **Run** to start a Chat Input graph.
 - **Cannot:** Claim the feed after reload must be **richer** than live.
 - **Cannot:** Claim `basic-coder` proves chat-dense mood for the full
@@ -132,16 +136,16 @@ do not say coding pipelines “don’t exist” or are unavailable.
 
 ### 6. Coding workflows
 
-| Name           | Fact                                                                                                                                                                                                                                                                                               |
-| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `starter`      | Onboarding chat + this skill + Writer Sub-Agent (`langflower-workflow-writer` + `langflower-node-writer`) — default open after seed                                                                                                                                                                |
-| Skeleton stubs | `simple-coder`, `advanced-coder`, `kb-create`, `kb-navigate`, … seeded on first-run; with provider → Start                                                                                                                                                                                         |
-| `simple-coder` | Plan⇄HITL→Coder⇄HITL→Finish smoke spine + `common-memory-tools` on Plan/Coder/Researcher/Worker; Researcher Sub-Agent under Plan, Worker under Coder — **not** full multi-loop `coding-agent`                                                                                                      |
-| `kb-create`    | Memory / project wiki create: Orchestrator **indexes** the repo with `glob`/`read`, persists `history/work-queue.md`, then **serially** spawns Explorer → Composer **one unit at a time**; `common-memory-tools` writes `core/*` + `modules/*`; Review rejects non-empty Pending or thin overviews |
-| `kb-navigate`  | Memory navigate: Navigator + Searcher + memory tree/grep/section tools; HITL Review Gate for follow-ups                                                                                                                                                                                            |
-| `basic-coder`  | Basic coding harness (Plan⇄HITL→Coder⇄HITL→Finish) — not a toy, **not** full multi-loop `coding-agent`                                                                                                                                                                                             |
-| `coding-agent` | Clarify HITL → red team → plan gate → coder → QA → `common-review` → result HITL; **graph** orders stages                                                                                                                                                                                          |
-| Status         | Use-case **Partial**; real-LLM Implementable bar open; Fake CI ≠ end-user proof — **not** “no templates”                                                                                                                                                                                           |
+| Name           | Fact                                                                                                                                                                                                                                                                                              |
+| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `starter`      | Onboarding chat + this skill + Writer Sub-Agent (`langflower-workflow-writer` + `langflower-node-writer`) — default open after seed                                                                                                                                                               |
+| Skeleton stubs | `simple-coder`, `advanced-coder`, `kb-create`, `kb-navigate`, … seeded on first-run; with provider → Start                                                                                                                                                                                        |
+| `simple-coder` | Plan⇄HITL→Coder⇄HITL→Finish smoke spine + `common-memory-tools` on Plan/Coder/Researcher/Worker; Researcher Sub-Agent under Plan, Worker under Coder — **not** full multi-loop `coding-agent`                                                                                                     |
+| `kb-create`    | Memory / project wiki create: Orchestrator **indexes** the repo with `glob`/`read`, persists `history/work-queue.md`, then **serially** calls Explorer → Composer **one unit at a time**; `common-memory-tools` writes `core/*` + `modules/*`; Review rejects non-empty Pending or thin overviews |
+| `kb-navigate`  | Memory navigate: Navigator + Searcher + memory tree/grep/section tools; HITL Review Gate for follow-ups                                                                                                                                                                                           |
+| `basic-coder`  | Basic coding harness (Plan⇄HITL→Coder⇄HITL→Finish) — not a toy, **not** full multi-loop `coding-agent`                                                                                                                                                                                            |
+| `coding-agent` | Clarify HITL → red team → plan gate → coder → QA → `common-review` → result HITL; **graph** orders stages                                                                                                                                                                                         |
+| Status         | Use-case **Partial**; real-LLM Implementable bar open; Fake CI ≠ end-user proof — **not** “no templates”                                                                                                                                                                                          |
 
 ### 7. Run lifecycle
 
@@ -161,8 +165,12 @@ These four are **not** the same thing.
 - **Can:** Harness builtins + `permission.ask` Allow/Deny for those builtins.
   Wired pack / MCP tools (including memory writes and **Langflower Tools**)
   do **not** ask — authoring the edge is consent. Write Allow does **not**
-  grant bash. Agents receive **McpHandle**s; system MCP starts only for ids
-  enabled on nodes in the active workflow.
+  grant bash. MCP **nodes** wire `tools` → agent `tools` (`ToolHandle[]`).
+  Optional **Tool collection** (`common-tool-collection`) can merge several
+  `tools` wires into one before the agent. Direct multi-wire into the agent
+  still works. System MCP from `langflower.jsonc` starts only for ids enabled
+  on nodes in the active workflow; those tools land on `EC.toolHandles`,
+  never as raw config.
 - **Can:** `compile_custom_nodes` exists only when **Langflower Tools**
   (`common-langflower-tools`) is wired into that agent’s `tools` port
   (starter Helper / Writer). Same intent as Custom → **Update**. Recompile
@@ -180,16 +188,21 @@ These four are **not** the same thing.
 ### 9. Sub-Agent and swarm
 
 Sub-Agent is an **explicit canvas node** for **control and observability**
-(own toolLog/response, visible spawn, `nodeId` filter) — not magic inside one
-LLM turn.
-
-- **Can:** First-class Sub-Agent node + spawn registration / `subagentResult`.
-  Default swarm spawns are **serial**. Wiki/memory create (`kb-create`) uses
-  **serial** scoped spawns driven by a persisted work queue — not parallel
+(own toolLog/response, visible specialist) — not magic inside one LLM turn.
+
+- **Can:** First-class Sub-Agent node. Wire Sub-Agent
+  `subagent-registration` → parent `tools` (one edge). The parent calls the
+  specialist tool (`Writer(subagent)` / `toolId` `Writer_subagent`) with a
+  `task`
+  (optional `skillId` from the Inspector Skills enum). That call closes the
+  parent work-log visit; the specialist streams as its own card. Default swarm
+  invokes are **serial**. Wiki/memory create (`kb-create`) uses **serial**
+  scoped specialist calls driven by a persisted work queue — not parallel
   whole-repo fan-out.
 - **Cannot / not yet:** Hide Sub-Agent work only inside a single LLM turn with
   no graph node (anti-pattern). Parallel fan-out as the **default**. Nested
-  **workflow files** (far future).
+  **workflow files** (far future). Do not look for `spawn_subagent` or
+  registration / spawn / result ports — those wires are gone.
 
 ### 10. Other demos
 
@@ -218,7 +231,8 @@ When the user asks to “create a project wiki”, “build a knowledge base”,
   → Orchestrator (`common-openai-llm` + builtins `glob`/`read`/`grep` + wired
   `common-memory-tools`) → Sub-Agents Explorer (read) + Composer (write) →
   `common-review` with readiness criteria → Finish. Persist a work queue in
-  memory **before** deep survey; `spawn_subagent` **one unit at a time**.
+  memory **before** deep survey; call the Explorer / Composer specialist
+  tools **one unit at a time**.
 - **Cannot:** Recommend one LLM that “reads the whole repo once and dumps a
   wiki”. Claim vector/embedding KB as base. Claim Obsidian vault helpers as
   shipped.
@@ -248,7 +262,7 @@ When the user asks to “create a project wiki”, “build a knowledge base”,
 
 When the user asks to add or change a custom node from this starter chat:
 
-1. Spawn Writer (or edit `.langflower/nodes/<pack>/*.ts` yourself).
+1. Call Writer (or edit `.langflower/nodes/<pack>/*.ts` yourself).
 2. Call **`compile_custom_nodes`** (no args). Report `status` / `nodeTypes` /
    `errors` from the tool text. Pack failures also write
    `COMPILATION_ERRORS.md`.

package/vendor/server/skeleton/skills/langflower-helper/architecture.md

@@ -76,7 +76,13 @@ Project product data for Langflower lives under **`.langflower/`**.
 
 - LLM / agent nodes use **skills** and harness tools as wired in the graph.
 - **Sub-Agent** is an **explicit canvas node** for control and observability
-  (own toolLog/response, visible spawn) — not hidden work inside one LLM turn.
+  (own toolLog/response). Wire `subagent-registration` into the parent
+  `tools` — not hidden work inside one LLM turn. The announced tool is
+  `{name}(subagent)` (`toolId` slug `Name_subagent`). Calling that tool closes
+  the parent work-log visit; the specialist streams as its own card, and
+  the parent continues in a new visit below. Optional **Tool collection**
+  (`common-tool-collection`) can merge several `tools` wires; direct
+  multi-wire into the agent still works.
 - **Graph order** stages the pipeline; the model does not invent the stage
   sequence outside the graph.
 - Project memory / wiki create is **queue-driven**: index with harness `glob`,

package/vendor/server/skeleton/skills/langflower-helper/layout.md

@@ -26,9 +26,10 @@ Facts for UI chrome and on-disk paths. Prefer this file over guessing.
 | Allow or Deny `permission.ask`         | Composer permission controls                                                                                                                                                                                                                                                                                         |
 | Soft-pause last feed agent / continue  | Composer **Pause** (per-node) / Send or Resume (soft pause ≠ Hard Stop)                                                                                                                                                                                                                                              |
 | Hard-stop a run                        | Composer **Stop**                                                                                                                                                                                                                                                                                                    |
-| Edit selected node params / ports      | Select node → right aside **inspector** (not Settings)                                                                                                                                                                                                                                                               |
+| Edit selected node params / ports      | Select node → right aside **inspector** (not Settings). Read-only while a run is active — Stop first.                                                                                                                                                                                                                |
+| Add a node from the palette            | Drag from the left palette onto the canvas. Disabled while a run is active (`cursor-not-allowed`) — Stop first.                                                                                                                                                                                                      |
 | Add or reload custom nodes             | Pack under `.langflower/nodes/<pack>/`. On starter, Helper / Writer call `compile_custom_nodes` (Langflower Tools is wired). Else Custom → **Update**. Hot-swap already-placed types; already-wired custom tools work later in the same run. New types: user places from Custom (no auto-place / auto-wire mid-run). |
-| Switch workflow                        | Topbar workflow list                                                                                                                                                                                                                                                                                                 |
+| Switch workflow                        | Topbar workflow list. Load / New / Copy / rename / Delete are locked while a run is active — Stop first.                                                                                                                                                                                                             |
 | Open Settings without leaving canvas   | Gear — Settings in right aside                                                                                                                                                                                                                                                                                       |
 | Find sample coding graphs              | Skeleton / demo-project workflow files — **manual copy** into project, then load → Start. No Sample workflows catalog UI.                                                                                                                                                                                            |
 | Project instructions for agents        | `.langflower/instructions.md`                                                                                                                                                                                                                                                                                        |

package/vendor/server/skeleton/skills/langflower-workflow-writer/SKILL.md

@@ -2,7 +2,8 @@
 name: Langflower workflow writer
 description: >-
     Guides authors writing and editing `.langflower/workflows/*.json` graphs
-    (catalog node types, real ports, Soft↔Hard loops, Sub-Agent L0 wiring).
+    (catalog node types, real ports, Soft↔Hard loops, Sub-Agent
+    `subagent-registration` wiring).
 ---
 
 # Langflower workflow writer
@@ -55,11 +56,13 @@ Schema: `.langflower/schemas/workflow.schema.json`. Samples:
 | Node type                               | Key ports                                                                                                                                                                                                              |
 | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `common-chat-input`                     | out `message` (no wireable in)                                                                                                                                                                                         |
-| `common-openai-llm` / `common-fake-llm` | in `userPrompt`, `systemPrompt`, `feedback`, `subagentRegistration`, `subagentResult`; out `response`, `subagent`, …                                                                                                   |
+| `common-openai-llm` / `common-fake-llm` | in `userPrompt`, `systemPrompt`, `feedback`, `tools`; out `response`, `toolLog`, …                                                                                                                                     |
+| `common-mcp-stdio` / `common-mcp-http`  | out **`tools`** — wire into an agent `tools` port (not a separate `mcp` port)                                                                                                                                          |
+| `common-tool-collection`                | in **`tools`** (multi combine) → out **`tools`** — optional hub; duplicate `toolId` last-wins. Direct pack → agent still OK                                                                                            |
 | `common-hitl-review-gate`               | in `result`; out `response`, `feedback`                                                                                                                                                                                |
 | `common-merge`                          | in/out **`value`** only (not `step` / `output`)                                                                                                                                                                        |
-| `common-review`                         | in `task`, `result`, `systemPrompt`; out `response`, `feedback`                                                                                                                                                        |
-| `common-sub-agent`                      | out `registration`, `result`; in `task`, `systemPrompt`                                                                                                                                                                |
+| `common-review`                         | in `task`, `result`, `systemPrompt`, `tools`; out `response`, `feedback`                                                                                                                                               |
+| `common-sub-agent`                      | out **`subagent-registration`** (one specialist handle) → parent `tools`; in `systemPrompt`, `tools`                                                                                                                   |
 | `common-finish`                         | in `value`                                                                                                                                                                                                             |
 | `common-string`                         | in/out `value`                                                                                                                                                                                                         |
 | `common-langflower-tools`               | out **`tools`** only — wire into an agent `tools` port to opt in to **`compile_custom_nodes`** (unsafe; starter Helper / Writer already wired). Not ambient. Canvas add/remove node or edge tools are **not** shipped. |
@@ -75,13 +78,14 @@ Typical HITL revise loop:
 Do **not** feed Merge output into both gates and LLM feedback on every tick
 without a clear phase split.
 
-## Sub-Agent L0 (registration + spawn)
+## Sub-Agent (one registration wire)
 
 Mirror `.langflower/workflows/kb-navigate.json`:
 
-- Sub-Agent `registration` → parent `subagentRegistration`
-- Parent `subagent` → Sub-Agent `task`
-- Sub-Agent `result` → parent `subagentResult`
+- Sub-Agent `subagent-registration` → parent `tools`
+- Parent calls the specialist tool (`task`, optional `skillId` enum)
+- Do **not** draw `registration` / `subagent` / `task` / `result` /
+  `subagentResult` — those ports are gone
 
 ## Load repair (product fact)
 

package/vendor/server/skeleton/workflows/kb-create.json

@@ -60,7 +60,7 @@
 					"maxFeedbackTurns": 8
 				},
 				"inputs": {
-					"systemPrompt": "You are the Orchestrator for building a DETAILED project memory map (project wiki) under `.langflower/memory/`.\n\nGoal: grounding a coding agent can use to implement features without rediscovering the repo. A thin whole-repo skim is NOT enough.\n\n## Required memory layout (all under `.langflower/memory/`)\n\n1) `core/overview.md` — purpose, primary user, ships vs not, how to run\n2) `core/layout.md` — directory / package map with ownership\n3) `core/architecture.md` — runtime flow, boundaries, key ADRs / invariants\n4) `core/build-test.md` — install, build, typecheck, unit vs integration, verify\n5) `core/entrypoints.md` — CLI / server / UI / MCP paths and ports\n6) `core/conventions.md` — coding rules agents must follow\n7) `modules/<area>.md` — one file per major package/area (responsibility, layout, contracts, neighbors, pitfalls)\n8) `history/work-queue.md` — indexed work units (Pending / In progress / Done)\n9) `history/build-log.md` — chronological survey/write notes (append_memory_log)\n\nOptional when material exists: `core/config.md`, `core/workflows-skills.md`.\n\n## Process (STRICT order — serial spawn_subagent)\n\n### Phase A — Index first (before any deep Explorer/Composer spawn)\n\n1) Use `glob` + `read` on package.json workspaces, top-level dirs, README*, AGENTS.md, docs/** (or equivalents). List every workspace package / major area and each mandatory `core/*` topic.\n2) Persist `.langflower/memory/history/work-queue.md` via create_memory_file / update_memory_section with ## Pending, ## In progress, ## Done. Each Pending item: id, path(s) to survey, target memory file (`modules/<area>.md` or `core/<name>.md`), status.\n3) Do NOT spawn Explorer/Composer for a vague “survey the whole repo” after the queue exists.\n\n### Phase B — One-unit loop\n\n1) Pick ONE Pending unit → move to In progress in work-queue.md.\n2) spawn_subagent Explorer with a task that names ONLY that unit (paths, expected depth, target memory file).\n3) spawn_subagent Composer for ONLY that unit’s target file/sections (pass Explorer findings).\n4) Mark the unit Done; append_memory_log on history/build-log.md.\n5) Repeat until Pending is empty (or explicit justified skips with evidence in the queue).\n\n### Phase C — Exit / Review feedback\n\n- Emit readiness only when Pending is empty AND mandatory files have real ## sections with concrete paths/commands/types.\n- Module pages MUST cover every indexed package/area from the queue.\n- On Review feedback: re-open specific queue items — do not restart a vague whole-repo pass.\n- Cite evidence (paths + section headings) in the readiness report."
+					"systemPrompt": "You are the Orchestrator for building a DETAILED project memory map (project wiki) under `.langflower/memory/`.\n\nGoal: grounding a coding agent can use to implement features without rediscovering the repo. A thin whole-repo skim is NOT enough.\n\n## Required memory layout (all under `.langflower/memory/`)\n\n1) `core/overview.md` — purpose, primary user, ships vs not, how to run\n2) `core/layout.md` — directory / package map with ownership\n3) `core/architecture.md` — runtime flow, boundaries, key ADRs / invariants\n4) `core/build-test.md` — install, build, typecheck, unit vs integration, verify\n5) `core/entrypoints.md` — CLI / server / UI / MCP paths and ports\n6) `core/conventions.md` — coding rules agents must follow\n7) `modules/<area>.md` — one file per major package/area (responsibility, layout, contracts, neighbors, pitfalls)\n8) `history/work-queue.md` — indexed work units (Pending / In progress / Done)\n9) `history/build-log.md` — chronological survey/write notes (append_memory_log)\n\nOptional when material exists: `core/config.md`, `core/workflows-skills.md`.\n\n## Process (STRICT order — serial specialist tool calls)\n\n### Phase A — Index first (before any deep Explorer/Composer spawn)\n\n1) Use `glob` + `read` on package.json workspaces, top-level dirs, README*, AGENTS.md, docs/** (or equivalents). List every workspace package / major area and each mandatory `core/*` topic.\n2) Persist `.langflower/memory/history/work-queue.md` via create_memory_file / update_memory_section with ## Pending, ## In progress, ## Done. Each Pending item: id, path(s) to survey, target memory file (`modules/<area>.md` or `core/<name>.md`), status.\n3) Do NOT call Explorer/Composer for a vague “survey the whole repo” after the queue exists.\n\n### Phase B — One-unit loop\n\n1) Pick ONE Pending unit → move to In progress in work-queue.md.\n2) Call the Explorer specialist tool with a task that names ONLY that unit (paths, expected depth, target memory file).\n3) Call the Composer specialist tool for ONLY that unit’s target file/sections (pass Explorer findings).\n4) Mark the unit Done; append_memory_log on history/build-log.md.\n5) Repeat until Pending is empty (or explicit justified skips with evidence in the queue).\n\n### Phase C — Exit / Review feedback\n\n- Emit readiness only when Pending is empty AND mandatory files have real ## sections with concrete paths/commands/types.\n- Module pages MUST cover every indexed package/area from the queue.\n- On Review feedback: re-open specific queue items — do not restart a vague whole-repo pass.\n- Cite evidence (paths + section headings) in the readiness report."
 				},
 				"ui": {
 					"position": {
@@ -212,48 +212,6 @@
 				"toNodeId": "review",
 				"toPort": ["tools", 0]
 			},
-			{
-				"edgeId": "e-reg-explorer",
-				"fromNodeId": "explorer",
-				"fromPort": ["registration", 0],
-				"toNodeId": "orchestrator",
-				"toPort": ["subagentRegistration", 0]
-			},
-			{
-				"edgeId": "e-reg-composer",
-				"fromNodeId": "composer",
-				"fromPort": ["registration", 0],
-				"toNodeId": "orchestrator",
-				"toPort": ["subagentRegistration", 1]
-			},
-			{
-				"edgeId": "e-spawn-explorer",
-				"fromNodeId": "orchestrator",
-				"fromPort": ["subagent", 0],
-				"toNodeId": "explorer",
-				"toPort": ["task", 0]
-			},
-			{
-				"edgeId": "e-spawn-composer",
-				"fromNodeId": "orchestrator",
-				"fromPort": ["subagent", 0],
-				"toNodeId": "composer",
-				"toPort": ["task", 0]
-			},
-			{
-				"edgeId": "e-result-explorer",
-				"fromNodeId": "explorer",
-				"fromPort": ["result", 0],
-				"toNodeId": "orchestrator",
-				"toPort": ["subagentResult", 0]
-			},
-			{
-				"edgeId": "e-result-composer",
-				"fromNodeId": "composer",
-				"fromPort": ["result", 0],
-				"toNodeId": "orchestrator",
-				"toPort": ["subagentResult", 1]
-			},
 			{
 				"edgeId": "e-orch-review-result",
 				"fromNodeId": "orchestrator",
@@ -281,6 +239,20 @@
 				"fromPort": ["response", 0],
 				"toNodeId": "done",
 				"toPort": ["value", 0]
+			},
+			{
+				"edgeId": "e-tools-explorer",
+				"fromNodeId": "explorer",
+				"fromPort": ["subagent-registration", 0],
+				"toNodeId": "orchestrator",
+				"toPort": ["tools", 1]
+			},
+			{
+				"edgeId": "e-tools-composer",
+				"fromNodeId": "composer",
+				"fromPort": ["subagent-registration", 0],
+				"toNodeId": "orchestrator",
+				"toPort": ["tools", 2]
 			}
 		]
 	}

package/vendor/server/skeleton/workflows/kb-navigate.json

@@ -53,7 +53,7 @@
 					"maxFeedbackTurns": 6
 				},
 				"inputs": {
-					"systemPrompt": "You answer questions about this project grounded in project memory.\n\nConvention: markdown under `.langflower/memory/` (built by the kb-create / Memory create workflow). Memory is also readable with harness file tools on `.langflower/memory/…`.\n\nBefore answering, use get_memory_tree / search_memory_grep / read_memory_section (yourself or via spawn_subagent Searcher). Prefer memory hits over guessing. If memory is empty or hits are weak, say so and offer to run Memory create (kb-create) — do not invent.\n\nWhen HITL feedback arrives, revise the answer — do not ignore it. Keep answers short and cite memory file paths / headings when available."
+					"systemPrompt": "You answer questions about this project grounded in project memory.\n\nConvention: markdown under `.langflower/memory/` (built by the kb-create / Memory create workflow). Memory is also readable with harness file tools on `.langflower/memory/…`.\n\nBefore answering, use get_memory_tree / search_memory_grep / read_memory_section (yourself or via the Searcher specialist tool). Prefer memory hits over guessing. If memory is empty or hits are weak, say so and offer to run Memory create (kb-create) — do not invent.\n\nWhen HITL feedback arrives, revise the answer — do not ignore it. Keep answers short and cite memory file paths / headings when available."
 				},
 				"ui": {
 					"position": {
@@ -125,27 +125,6 @@
 				"toNodeId": "searcher",
 				"toPort": ["tools", 0]
 			},
-			{
-				"edgeId": "e-reg-searcher",
-				"fromNodeId": "searcher",
-				"fromPort": ["registration", 0],
-				"toNodeId": "navigator",
-				"toPort": ["subagentRegistration", 0]
-			},
-			{
-				"edgeId": "e-spawn-searcher",
-				"fromNodeId": "navigator",
-				"fromPort": ["subagent", 0],
-				"toNodeId": "searcher",
-				"toPort": ["task", 0]
-			},
-			{
-				"edgeId": "e-result-searcher",
-				"fromNodeId": "searcher",
-				"fromPort": ["result", 0],
-				"toNodeId": "navigator",
-				"toPort": ["subagentResult", 0]
-			},
 			{
 				"edgeId": "e-nav-review",
 				"fromNodeId": "navigator",
@@ -159,6 +138,13 @@
 				"fromPort": ["feedback", 0],
 				"toNodeId": "navigator",
 				"toPort": ["feedback", 0]
+			},
+			{
+				"edgeId": "e-tools-searcher",
+				"fromNodeId": "searcher",
+				"fromPort": ["subagent-registration", 0],
+				"toNodeId": "navigator",
+				"toPort": ["tools", 1]
 			}
 		]
 	}