langflower 0.0.3 → 0.0.5

package/vendor/server/skeleton/schemas/langflower-config.schema.json

@@ -0,0 +1,164 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "langflower-config.schema.json",
+	"title": "Langflower project config",
+	"description": "Shape of `.langflower/langflower.jsonc`. Unknown top-level keys are preserved on disk.",
+	"type": "object",
+	"additionalProperties": true,
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON Schema reference for IDE autocomplete."
+		},
+		"currentWorkflowId": {
+			"type": "string",
+			"description": "Stem of the last opened workflow under `.langflower/workflows/{id}.json`."
+		},
+		"model": {
+			"type": "string",
+			"description": "Optional default model id (provider/model or bare id)."
+		},
+		"serverLogs": {
+			"type": "boolean",
+			"description": "Bridge diagnostic JSONL logging under `.langflower/logs/`. Omit to inherit; true enables; false disables."
+		},
+		"provider": {
+			"type": "object",
+			"additionalProperties": {
+				"type": "object",
+				"required": ["name"],
+				"additionalProperties": true,
+				"properties": {
+					"name": { "type": "string" },
+					"models": {
+						"oneOf": [
+							{
+								"type": "array",
+								"items": { "type": "string" }
+							},
+							{
+								"type": "object",
+								"additionalProperties": {
+									"oneOf": [
+										{ "type": "string" },
+										{
+											"type": "object",
+											"additionalProperties": true,
+											"properties": {
+												"name": { "type": "string" }
+											}
+										}
+									]
+								}
+							}
+						]
+					},
+					"options": {
+						"type": "object",
+						"additionalProperties": true
+					}
+				}
+			}
+		},
+		"tools": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["id", "name"],
+				"additionalProperties": true,
+				"properties": {
+					"id": { "type": "string" },
+					"name": { "type": "string" }
+				}
+			}
+		},
+		"dividerPositions": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"leftWidth": { "type": "number" },
+				"rightWidth": { "type": "number" },
+				"composerHeight": { "type": "number" }
+			}
+		},
+		"permission": {
+			"type": "object",
+			"description": "Runtime allow/ask/deny for harness tools (≠ Inspector enabledToolIds).",
+			"additionalProperties": {
+				"$ref": "#/$defs/permissionToolConfig"
+			}
+		},
+		"harness": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"denyPaths": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"allowedRoots": {
+					"type": "array",
+					"items": { "type": "string" }
+				},
+				"allowedHosts": {
+					"type": "array",
+					"items": { "type": "string" }
+				}
+			}
+		},
+		"mcp": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"servers": {
+					"type": "object",
+					"additionalProperties": {
+						"oneOf": [
+							{ "$ref": "#/$defs/mcpStdio" },
+							{ "$ref": "#/$defs/mcpHttp" }
+						]
+					}
+				}
+			}
+		}
+	},
+	"$defs": {
+		"permissionDecision": {
+			"type": "string",
+			"enum": ["allow", "ask", "deny"]
+		},
+		"permissionToolConfig": {
+			"oneOf": [
+				{ "$ref": "#/$defs/permissionDecision" },
+				{
+					"type": "object",
+					"additionalProperties": {
+						"$ref": "#/$defs/permissionDecision"
+					},
+					"description": "Pattern → decision map (`*`, `docs/**`, `git diff*`, …)."
+				}
+			]
+		},
+		"mcpStdio": {
+			"type": "object",
+			"required": ["kind", "command"],
+			"additionalProperties": false,
+			"properties": {
+				"kind": { "const": "stdio" },
+				"command": { "type": "string" },
+				"toolNames": { "type": "string" }
+			}
+		},
+		"mcpHttp": {
+			"type": "object",
+			"required": ["kind", "url"],
+			"additionalProperties": false,
+			"properties": {
+				"kind": { "const": "http" },
+				"url": { "type": "string" },
+				"command": { "type": "string" },
+				"toolNames": { "type": "string" }
+			}
+		}
+	}
+}

package/vendor/server/skeleton/schemas/workflow.schema.json

@@ -0,0 +1,119 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "workflow.schema.json",
+	"title": "Langflower workflow document",
+	"description": "On-disk shape of `.langflower/workflows/{id}.json`. Identity is the filename stem, not a field inside the file.",
+	"type": "object",
+	"required": ["metadata", "graph"],
+	"additionalProperties": true,
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON Schema reference for IDE autocomplete."
+		},
+		"metadata": {
+			"type": "object",
+			"required": ["name", "createdAt", "updatedAt"],
+			"additionalProperties": true,
+			"properties": {
+				"name": { "type": "string" },
+				"description": { "type": "string" },
+				"createdAt": { "type": "string" },
+				"updatedAt": { "type": "string" }
+			}
+		},
+		"graph": {
+			"type": "object",
+			"required": ["viewport", "nodes", "edges"],
+			"additionalProperties": false,
+			"properties": {
+				"viewport": {
+					"type": "object",
+					"required": ["x", "y", "scale"],
+					"additionalProperties": true,
+					"properties": {
+						"x": { "type": "number" },
+						"y": { "type": "number" },
+						"scale": { "type": "number" },
+						"width": { "type": "number" },
+						"height": { "type": "number" }
+					}
+				},
+				"nodes": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/node" }
+				},
+				"edges": {
+					"type": "array",
+					"items": { "$ref": "#/$defs/edge" }
+				}
+			}
+		}
+	},
+	"$defs": {
+		"node": {
+			"type": "object",
+			"required": ["id", "type", "params", "inputs", "ui"],
+			"additionalProperties": false,
+			"properties": {
+				"id": { "type": "string" },
+				"type": { "type": "string" },
+				"params": {
+					"type": "object",
+					"additionalProperties": true
+				},
+				"inputs": {
+					"type": "object",
+					"additionalProperties": true
+				},
+				"ui": {
+					"type": "object",
+					"required": ["position"],
+					"additionalProperties": true,
+					"properties": {
+						"position": {
+							"type": "object",
+							"required": ["x", "y"],
+							"additionalProperties": false,
+							"properties": {
+								"x": { "type": "number" },
+								"y": { "type": "number" },
+								"width": { "type": "number" },
+								"height": { "type": "number" }
+							}
+						},
+						"label": { "type": "string" }
+					}
+				}
+			}
+		},
+		"edge": {
+			"type": "object",
+			"required": [
+				"edgeId",
+				"fromNodeId",
+				"fromPort",
+				"toNodeId",
+				"toPort"
+			],
+			"additionalProperties": false,
+			"properties": {
+				"edgeId": { "type": "string" },
+				"fromNodeId": { "type": "string" },
+				"fromPort": {
+					"type": "array",
+					"minItems": 2,
+					"maxItems": 2,
+					"prefixItems": [{ "type": "string" }, { "type": "number" }]
+				},
+				"toNodeId": { "type": "string" },
+				"toPort": {
+					"type": "array",
+					"minItems": 2,
+					"maxItems": 2,
+					"prefixItems": [{ "type": "string" }, { "type": "number" }]
+				}
+			}
+		}
+	}
+}

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

@@ -64,24 +64,27 @@ do not say coding pipelines “don’t exist” or are unavailable.
 
 - **Can:** `langflower start [project-dir]` (default port **4010**) creates
   `.langflower/`, config, `instructions.md`, pack `nodes/my-nodes/`, skills
-  `langflower-helper` + `langflower-node-writer`, and opens workflow
-  **`starter`** first.
+  `langflower-helper`, `langflower-node-writer`, and
+  `langflower-workflow-writer`, and opens workflow **`starter`** first.
 - **Can:** Skeleton already ships coding and KB sample workflows
   (`simple-coder`, `advanced-coder`, `kb-create`, `kb-navigate`, …). With a
   provider configured, they are seeded on first-run → load → composer **Start**.
 - **Can:** Second `langflower start` on an existing `.langflower/` **reuses**
   it as-is (no wipe).
-- **Can:** Configure providers via `.langflower/langflower.jsonc` (prefer
-  `{env:VAR}`). Bootstrap never invents API keys.
+- **Can:** Configure providers via **Settings** (Global opens on first connect
+  when none are configured) or `.langflower/langflower.jsonc` (prefer
+  `{env:VAR}`). Bootstrap never invents API keys. Simple nodes / Fake LLM work
+  without a provider; a real OpenAI-compatible provider is required for live
+  model runs and seeded coding samples.
 - **Cannot:** Claim bootstrap invents secrets, or that a polished
-  **named-path** empty-provider fail-closed error is already shipped — tell
-  users to edit `langflower.jsonc`; prefer fail over hang, without inventing
-  a finished error UX.
+  **named-path** empty-provider fail-closed error on run is already shipped —
+  tell users to add a provider in Settings or `langflower.jsonc`; prefer fail
+  over hang, without inventing a finished run-error UX.
 
 ### 3. Skeleton and samples
 
 - **Can:** First-run seed = config + **all** skeleton workflows (including
-  `starter`, coding samples, `kb-create`, `kb-navigate`) + two skills +
+  `starter`, coding samples, `kb-create`, `kb-navigate`) + three skills +
   `my-nodes` + instructions.
 - **Can:** Skeleton inventory includes `node-writer`, `agents-dialog`,
   `simple-coder`, `advanced-coder`, `kb-create`, `kb-navigate` (and other
@@ -95,9 +98,12 @@ do not say coding pipelines “don’t exist” or are unavailable.
 ### 4. Providers and Settings
 
 - **Can:** Gear opens **Settings** in the **right aside**, swapping feed /
-  inspector; canvas stays. Project and Global scopes; merge **project >
-  global**; Save applies without a full app reload. Keys are write-only;
-  prefer `{env:VAR}`.
+  inspector; canvas stays. Open/close/scope are server-driven. Project and
+  Global scopes; merge **project > global**; Save applies without a full app
+  reload. Keys are write-only; prefer `{env:VAR}`.
+- **Can:** With no providers configured, connect opens **Global Settings** with
+  onboarding copy (add OpenAI-compatible provider; Fake LLM / simple nodes
+  still work).
 - **Cannot:** Treat Settings as the selected-node inspector (ports/params).
 - **Cannot:** Reveal a saved API key in the UI.
 
@@ -112,12 +118,21 @@ do not say coding pipelines “don’t exist” or are unavailable.
 - **Cannot:** Claim `basic-coder` proves chat-dense mood for the full
   `coding-agent` pipeline.
 
+### 5b. Workflow load repair
+
+- **Can:** If a workflow JSON has unknown node types or edges to missing /
+  unknown ports, load **strips** those nodes/edges and opens the rest as
+  **dirty**. A short topbar notice explains the repair; **Save** writes the
+  cleaned graph. Catalog list still shows the file (metadata-only).
+- **Cannot:** Silently rewrite disk on load. Invent port renames — only drop.
+
 ### 6. Coding workflows
 
 | Name           | Fact                                                                                                                                                                                                                                                                                               |
 | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `starter`      | Onboarding chat + this skill — default open after seed                                                                                                                                                                                                                                             |
+| `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`                                                                                                                                                                                             |
@@ -143,9 +158,15 @@ These four are **not** the same thing.
   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.
+- **Can:** First-run `langflower.jsonc` seeds `permission` allow-all (project
+  **floor**). Inspector **Tool permissions** table (`tool` / `deny` / `ask` /
+  `allow`) sets per-agent `toolPermissions` (cannot loosen past floor). Presets
+  materialize that table — no hidden role overlay. Schemas under
+  `.langflower/schemas/`.
 - **Cannot:** Prior-run Allows carry into a new run. Mid-run “permission tier
   unlock” as the product model (use graph stages / tool profiles). All
   `mcp.servers` always start. Agent sees raw MCP config instead of handles.
+  Equating a checkbox allowlist with runtime allow — use the permission table.
 
 ### 9. Sub-Agent and swarm
 
@@ -199,9 +220,14 @@ When the user asks to “create a project wiki”, “build a knowledge base”,
   `tsc` / IDE types act as compile-time validators before Custom → **Update**.
   Packs under `.langflower/nodes/<pack>/`; user runs `npm install` in the pack.
   See `instructions.md` and `nodes/my-nodes/README.md`.
+  Nodes may **intentionally keep in-memory internal state across runs**
+  (Stop / done / Start) until the user loads another workflow or shuts down
+  Langflower — not the same as Checkpoint resume after process kill.
 - **Cannot:** Plain JS as the authoring path, Go, Python, or other languages.
   Server auto-install. Sandboxed arbitrary user-node execution as shipped.
   Custom-pack compiler as product-Implementable.
+  Claim that every node always resets on Stop, or that in-memory node state
+  survives process restart without Checkpoints.
 
 ### 12. Status vocabulary
 

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

@@ -49,6 +49,11 @@ Project product data for Langflower lives under **`.langflower/`**.
 - Nodes and edges run on a **reactive runtime**: ports are live streams. A node
   may receive and emit **at any time** while the run is alive — not a single
   batch “call node → return once”.
+- Canvas node instances stay alive across **Stop / done / Start** while the
+  same workflow is loaded. Authors may **intentionally** keep in-memory
+  internal state across runs until the user **loads another workflow** or
+  **shuts down Langflower**. That is not durable Checkpoint resume after
+  process restart.
 - **HITL loops** (Review Gate, feedback ports, composer Start/Send) are normal
   **internal waiting state of nodes**, not a separate product “interrupt the
   engine” mechanism.

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

@@ -10,38 +10,40 @@ Facts for UI chrome and on-disk paths. Prefer this file over guessing.
   custom packs after disk changes.
 - **Center** — canvas (nodes, edges, selection).
 - **Right aside** — mutually exclusive modes: **feed** | **inspector** |
-  **Settings**. Opening Settings (gear) swaps out feed/inspector; canvas stays.
+  **Settings**. Opening Settings (gear or empty-provider onboarding) swaps out
+  feed/inspector; canvas stays. Settings open/close is server-driven.
 - **Composer (bottom)** — **Start** / Hard **Stop** / soft **Pause**; HITL
   input and actions; `permission.ask` Allow/Deny while a run needs them.
 
 ## Where can I…?
 
-| Goal                                   | Where                                                                                                                     |
-| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| Change provider / API key              | Gear → **Settings** (right aside), or edit `.langflower/langflower.jsonc` (prefer `{env:VAR}`)                            |
-| Start a Chat Input graph               | Composer **Start** — not plain **Run** (Run stays disabled for those graphs)                                              |
-| See run output / stream                | Right aside **feed**                                                                                                      |
-| Answer HITL / send into a waiting node | Composer + feed context                                                                                                   |
-| 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)                                                                    |
-| Add or reload custom nodes             | Put pack under `.langflower/nodes/<pack>/`, then Custom → **Update**                                                      |
-| Switch workflow                        | Topbar workflow list                                                                                                      |
-| 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`                                                                                             |
+| Goal                                   | Where                                                                                                                                  |
+| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| Change provider / API key              | Gear → **Settings** (right aside; Global auto-opens when none configured), or edit `.langflower/langflower.jsonc` (prefer `{env:VAR}`) |
+| Start a Chat Input graph               | Composer **Start** — not plain **Run** (Run stays disabled for those graphs)                                                           |
+| See run output / stream                | Right aside **feed**                                                                                                                   |
+| Answer HITL / send into a waiting node | Composer + feed context                                                                                                                |
+| 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)                                                                                 |
+| Add or reload custom nodes             | Put pack under `.langflower/nodes/<pack>/`, then Custom → **Update**                                                                   |
+| Switch workflow                        | Topbar workflow list                                                                                                                   |
+| 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`                                                                                                          |
 
 ## On-disk `.langflower/` map
 
-| Path               | Role                                     |
-| ------------------ | ---------------------------------------- |
-| `langflower.jsonc` | Providers, secrets refs, project config  |
-| `workflows/`       | Saved workflow graphs                    |
-| `skills/`          | Agent skills (e.g. `langflower-helper/`) |
-| `nodes/`           | Custom node packs (e.g. `my-nodes/`)     |
-| `instructions.md`  | Project-level agent instructions         |
-| `runs/`            | Run artifacts / checkpoints when created |
+| Path               | Role                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| `langflower.jsonc` | Providers, secrets refs, project config                                                       |
+| `workflows/`       | Saved workflow graphs                                                                         |
+| `skills/`          | Agent skills (`langflower-helper/`, `langflower-node-writer/`, `langflower-workflow-writer/`) |
+| `nodes/`           | Custom node packs (e.g. `my-nodes/`)                                                          |
+| `instructions.md`  | Project-level agent instructions                                                              |
+| `runs/`            | Run artifacts / checkpoints when created                                                      |
+| `logs/`            | Server bridge diagnostic JSONL logs when the server runs                                      |
 
 ## Out of chrome
 

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

@@ -0,0 +1,95 @@
+---
+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).
+---
+
+# Langflower workflow writer
+
+You help the user **author valid Langflower workflow JSON** under
+`.langflower/workflows/`.
+
+## Honesty (do not invent)
+
+- Use only **catalog** node `type` strings that exist in the project palette /
+  common-nodes. Do **not** invent types (e.g. there is no `common-hitl` —
+  use `common-hitl-review-gate`).
+- Use only **real port ids** from each node’s definition / `NODE.md`. Wrong
+  ports are stripped on load (graceful repair) — inventing ports breaks the
+  graph.
+- Identity is the **filename stem** (`my-flow.json` → `workflowId: my-flow`).
+  Do not put `id` inside `metadata`.
+- Tool allowlists use plain builtin ids: `read`, `glob`, `grep`, `edit`,
+  `write`, `create`, `delete`, `bash` — never `Bash(ls)`-style strings.
+- LLM `rolePreset` values are only: `custom` | `plan` | `coder` | `explorer`.
+  Unknown values silently become `custom`.
+
+## On-disk shape
+
+```json
+{
+	"$schema": "../schemas/workflow.schema.json",
+	"metadata": {
+		"name": "Display name",
+		"description": "optional",
+		"createdAt": "ISO-8601",
+		"updatedAt": "ISO-8601"
+	},
+	"graph": {
+		"viewport": { "x": 0, "y": 0, "scale": 1 },
+		"nodes": [],
+		"edges": []
+	}
+}
+```
+
+Schema: `.langflower/schemas/workflow.schema.json`. Samples:
+`.langflower/workflows/*.json`.
+
+## Ports you must get right
+
+| 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-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-finish`                         | in `value`                                                                                                           |
+| `common-string`                         | in/out `value`                                                                                                       |
+
+## Soft↔Hard loops
+
+Typical HITL revise loop:
+
+1. LLM `response` → Review Gate `result`
+2. Gate `feedback` → (optional Merge `value`) → LLM `feedback`
+3. Gate `response` → next stage (coder, finish, …)
+
+Do **not** feed Merge output into both gates and LLM feedback on every tick
+without a clear phase split.
+
+## Sub-Agent L0 (registration + spawn)
+
+Mirror `.langflower/workflows/kb-navigate.json`:
+
+- Sub-Agent `registration` → parent `subagentRegistration`
+- Parent `subagent` → Sub-Agent `task`
+- Sub-Agent `result` → parent `subagentResult`
+
+## Load repair (product fact)
+
+If a workflow lists in the catalog but contains unknown node types or bad
+ports, Langflower **loads what it can**: drops invalid nodes/edges, opens the
+rest as **dirty**. Save persists the cleaned graph. Prefer writing a valid
+graph the first time.
+
+## When drafting
+
+1. Pick a stable filename stem and metadata name.
+2. Place nodes with real `type` / `params` / `inputs` / `ui.position`.
+3. Wire edges with `[portId, slotIndex]` tuples.
+4. Prefer copying structure from an existing sample, then editing.
+5. Remind the user to reload the workflow in the topbar and Save if repair ran.

package/vendor/server/skeleton/workflows/advanced-coder.json

@@ -1,4 +1,5 @@
 {
+	"$schema": "../schemas/workflow.schema.json",
 	"metadata": {
 		"name": "Advanced coder",
 		"description": "Plan → refine → coder → review → QA with internal loops and HITL after QA (successor intent to coding-agent). Partial sample graph; configure a provider before running.",

package/vendor/server/skeleton/workflows/agents-dialog.json

@@ -1,4 +1,5 @@
 {
+	"$schema": "../schemas/workflow.schema.json",
 	"metadata": {
 		"name": "Agents dialog",
 		"description": "Chat loop with two agents — proposer and critique — then HITL review before finish.",
@@ -20,7 +21,10 @@
 				"params": {},
 				"inputs": {},
 				"ui": {
-					"position": { "x": 40, "y": 240 },
+					"position": {
+						"x": 40,
+						"y": 240
+					},
 					"label": "Topic"
 				}
 			},
@@ -38,7 +42,10 @@
 					"systemPrompt": "You are the Proposer. Draft a clear short claim or answer for the user's topic. When feedback arrives from Critique or Review, revise — do not ignore it."
 				},
 				"ui": {
-					"position": { "x": 300, "y": 160 },
+					"position": {
+						"x": 300,
+						"y": 160
+					},
 					"label": "Proposer"
 				}
 			},
@@ -54,7 +61,10 @@
 					"systemPrompt": "Call tool `feedback` or `accept` — never reply in plain text.\nYou are an independent Critique. Attack contradictions, overclaim, and missing evidence. Call accept only when the packet is defensible."
 				},
 				"ui": {
-					"position": { "x": 560, "y": 360 },
+					"position": {
+						"x": 560,
+						"y": 360
+					},
 					"label": "Critique"
 				}
 			},
@@ -64,7 +74,10 @@
 				"params": {},
 				"inputs": {},
 				"ui": {
-					"position": { "x": 820, "y": 200 },
+					"position": {
+						"x": 820,
+						"y": 200
+					},
 					"label": "Human review"
 				}
 			},
@@ -74,7 +87,10 @@
 				"params": {},
 				"inputs": {},
 				"ui": {
-					"position": { "x": 1080, "y": 200 },
+					"position": {
+						"x": 1080,
+						"y": 200
+					},
 					"label": "Done"
 				}
 			}