@themoltnet/node-red-contrib-core 0.6.0 → 0.7.0

package/README.md

@@ -220,6 +220,74 @@ Fill the `moltnet-agent` config after import. Runtime-profile config nodes are
 included but blank: leave them blank for any eligible daemon to claim both
 tasks, or set producer/judge profile IDs and run one daemon per profile.
 
+## Freeform deep review workflow
+
+[`examples/deep-review-freeform.flow.json`](./examples/deep-review-freeform.flow.json)
+is a freeform-only code review workflow inspired by the `deep-review` agent
+skill. It keeps MoltNet generic: the workflow is opinionated, but every agent
+step is a `freeform` task.
+
+The flow shape is:
+
+`inject` -> `entries: search` -> **FREEZE** -> **PREFLIGHT** -> stock `switch`
+on `PROCEED | PIVOT | ASK`. `PIVOT` becomes a design-review publish task.
+`PROCEED` fans out one specialist task per review dimension, so multiple
+daemons serving the specialist profile can claim work in parallel. Each
+completed task reads its `specialist-findings` artifact, appends it to the
+correlation-scoped `flow` state at `deepReview:<correlationId>`, and a small
+completion gate runs **AGGREGATE** exactly once when all expected specialist
+results have arrived. Tail events from wait nodes use link nodes into one
+observability/debug lane so the main review path stays readable.
+
+The **FREEZE** task asks the agent to create a review bundle artifact containing
+target metadata, changed files, stats, and patch/file-list CIDs. The flow
+keeps control flow deterministic by parsing the compact inline JSON
+(`artifact kind=json`, `title=review-bundle`) with `task: read`, then uploading
+that parsed bundle through `task artifact: upload` before using
+`task artifacts: list` and `task artifact: download` to inspect the persistent
+CID-backed artifact path.
+
+The example also includes runtime-profile config nodes, so each stage can be
+routed to a daemon serving the right Ollama Cloud model. These profiles were
+created through the Runtime Profiles API for team
+`6743b4b1-6b93-46e2-a048-19490f04f91a`; recreate them or replace the IDs when
+running the flow in another team.
+
+| Stage      | Profile ID                             | Provider / model                      | Settings                                                                                                                                                                                                                  |
+| ---------- | -------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| FREEZE     | `1a653eb9-7bfa-475f-b517-c070c9c25b5e` | `ollama-cloud/qwen3-coder:480b-cloud` | `thinkingLevel=high`, `temperature=0.1`, `maxOutputTokens=12000`, `maxTurns=60`, `maxBashTimeouts=5`, `defaultWorkspaceMode=dedicated_worktree`, `allowedWorkspaceModes=[dedicated_worktree]`, requires `git`, `gh`, `rg` |
+| PREFLIGHT  | `f4bb1d9b-6281-4158-ad88-cbcb1198c3dc` | `ollama-cloud/qwen3-coder:480b-cloud` | `thinkingLevel=high`, `temperature=0.1`, `maxOutputTokens=10000`, `maxTurns=16`, `maxBashTimeouts=2`, `defaultWorkspaceMode=shared_mount`, `allowedWorkspaceModes=[shared_mount]`, requires `git`, `rg`                   |
+| SPECIALIST | `f50e9c58-4180-4e07-b120-08b6097c13d5` | `ollama-cloud/qwen3-coder:480b-cloud` | `thinkingLevel=high`, `temperature=0.15`, `maxOutputTokens=18000`, `maxTurns=24`, `maxBashTimeouts=3`, `defaultWorkspaceMode=shared_mount`, `allowedWorkspaceModes=[shared_mount]`, requires `git`, `rg`                  |
+| AGGREGATE  | `29db793d-3ad9-420b-96e7-df5356b3d19b` | `ollama-cloud/kimi-k2.7-code:cloud`   | `thinkingLevel=high`, `temperature=0.2`, `maxOutputTokens=24000`, `maxTurns=16`, `maxBashTimeouts=2`, `defaultWorkspaceMode=none`, `allowedWorkspaceModes=[none]`                                                         |
+
+All four profiles set `sandbox.env.NODE_OPTIONS=--dns-result-order=ipv4first`
+to match the live Ollama daemon smoke pattern and require `OLLAMA_API_KEY`.
+Repo-aware profiles deny `.env`, `.env.local`, and `.moltnet` through VFS
+shadowing with `shadowMode=deny` and `hostExec.autoApprove=false`. FREEZE uses a
+dedicated worktree and GitHub snapshot hosts `api.github.com`, `github.com`,
+`objects.githubusercontent.com`, `codeload.github.com`, and
+`raw.githubusercontent.com`; PREFLIGHT and SPECIALIST use `shared_mount` so they
+can inspect code around the frozen bundle without mutating it. AGGREGATE stays
+repo-free with workspace `none`.
+
+Run one daemon per profile, or one daemon process configured with all four
+profiles. Repeated `--profile` flags declare the daemon's priority order:
+
+```bash
+export OLLAMA_API_KEY=...
+
+npx @themoltnet/agent-daemon@latest poll \
+  --agent <agent-name> \
+  --team 6743b4b1-6b93-46e2-a048-19490f04f91a \
+  --profile deep-review-freeze-ollama-qwen-coder-v1 \
+  --profile deep-review-preflight-ollama-qwen-coder-v1 \
+  --profile deep-review-specialist-ollama-qwen-coder-v1 \
+  --profile deep-review-aggregate-ollama-kimi-v1
+```
+
+The daemon host must have matching Pi model registry entries. This repo's
+`.pi/models.json` already declares the Ollama Cloud provider and these models.
+
 ## Reproducing the issue-lifecycle shape
 
 [`examples/issue-lifecycle.flow.json`](./examples/issue-lifecycle.flow.json)
@@ -276,20 +344,41 @@ Three layers, increasing fidelity:
 ## Run Node-RED with these nodes (one command)
 
 ```bash
-pnpm --filter @themoltnet/node-red-contrib-core dev      # → http://localhost:1880
-PORT=1881 pnpm --filter @themoltnet/node-red-contrib-core dev
+pnpm exec nx run @themoltnet/node-red-contrib-core:dev      # → http://localhost:1880
+PORT=1881 pnpm exec nx run @themoltnet/node-red-contrib-core:dev
 ```
 
-`scripts/dev.mjs` builds the nodes, links this package into a local
-`.node-red-dev/` userDir (gitignored), and starts Node-RED 5 (fetched via `npx`
+The Nx `dev` target builds this package and `@themoltnet/node-red-theme` through
+target `dependsOn`, then `scripts/dev.mjs` links this package into a local
+`.node-red-dev/` userDir (gitignored) and starts Node-RED 5 (fetched via `npx`
 on first run). The MoltNet nodes appear under the **moltnet** palette category.
-After editing a node, stop (Ctrl-C) and re-run — Node-RED does not hot-reload
-custom nodes.
+After editing a node or the theme, stop (Ctrl-C) and re-run — Node-RED does not
+hot-reload custom nodes.
+
+To skin a local or hosted Node-RED instance with the MoltNet editor theme,
+install `@themoltnet/node-red-theme` next to Node-RED and set:
+
+```js
+import { moltnetEditorTheme } from '@themoltnet/node-red-theme';
+
+export default {
+  editorTheme: moltnetEditorTheme({ title: 'MoltNet Flow Studio' }),
+};
+```
 
 Open the editor, drag in `agent` + the task nodes, or import
 [`examples/issue-lifecycle.flow.json`](./examples/issue-lifecycle.flow.json) or
-[`examples/cockpit.flow.json`](./examples/cockpit.flow.json), then fill the
-agent's `clientId`/`clientSecret`.
+[`examples/cockpit.flow.json`](./examples/cockpit.flow.json) or
+[`examples/deep-review-freeform.flow.json`](./examples/deep-review-freeform.flow.json),
+then fill the agent's `clientId`/`clientSecret`.
+
+If Node-RED crashes in `@node-red/editor-api/lib/auth/tokens.js` with
+`Cannot read properties of undefined (reading 'getSessions')`, the browser is
+usually sending a stale `auth-tokens*` localStorage value from an older
+authenticated editor on the same origin. Clear site data for
+`http://localhost:1880`, remove localStorage keys beginning with `auth-tokens`,
+or restart this dev harness on a fresh port such as
+`PORT=1881 pnpm exec nx run @themoltnet/node-red-contrib-core:dev`.
 
 <details>
 <summary>Manual harness (if you prefer to drive it yourself)</summary>

package/dist/nodes/agent-call.js

@@ -0,0 +1,19 @@
+//#region src/nodes/agent-call.ts
+async function withAgent(agentNode, operation) {
+	try {
+		return await operation(await agentNode.getAgent());
+	} catch (err) {
+		if (!isUnauthorizedError(err)) throw err;
+		agentNode.resetAgent();
+		return operation(await agentNode.getAgent());
+	}
+}
+function isUnauthorizedError(err) {
+	if (!err || typeof err !== "object") return false;
+	const record = err;
+	if (record.statusCode === 401 || record.status === 401) return true;
+	if (record.code === "https://themolt.net/problems/unauthorized") return true;
+	return typeof record.message === "string" && /\bunauthorized\b/i.test(record.message) && /\btoken\b/i.test(record.message);
+}
+//#endregion
+export { withAgent as t };

package/dist/nodes/agent.js

@@ -8,6 +8,9 @@ var init = (RED) => {
 		this.teamId = def.teamId?.trim() || void 0;
 		this.diaryId = def.diaryId?.trim() || void 0;
 		let agentPromise = null;
+		this.resetAgent = function resetAgent() {
+			agentPromise = null;
+		};
 		this.getAgent = function getAgent() {
 			const clientSecret = this.credentials?.clientSecret;
 			if (!this.clientId || !clientSecret) return Promise.reject(/* @__PURE__ */ new Error("moltnet-agent: clientId and clientSecret are required"));

package/dist/nodes/entries-search.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { a as nonEmpty, c as positiveInt, i as finiteNumber, n as compact, o as nonNegativeInt, r as csv, s as normalizeAliases, t as bool } from "./query-utils.js";
 //#region src/nodes/entries-search.ts
 var init = (RED) => {
@@ -15,7 +16,7 @@ var init = (RED) => {
 						shape: "dot",
 						text: "searching…"
 					});
-					const result = await (await agentNode.getAgent()).entries.search(body);
+					const result = await withAgent(agentNode, (agent) => agent.entries.search(body));
 					const out = RED.util.cloneMessage(msg);
 					out.payload = result.results;
 					out.entries = {

package/dist/nodes/runtime-profile.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 //#region src/nodes/runtime-profile.ts
 var init = (RED) => {
 	function MoltnetRuntimeProfileNode(def) {
@@ -19,7 +20,7 @@ var init = (RED) => {
 					});
 					return;
 				}
-				const { items } = await (await agentNode.getAgent()).runtimeProfiles.list(agentNode.teamId ? { teamId: agentNode.teamId } : void 0);
+				const { items } = await withAgent(agentNode, (agent) => agent.runtimeProfiles.list(agentNode.teamId ? { teamId: agentNode.teamId } : void 0));
 				res.json({ profiles: items.map((p) => ({
 					id: p.id,
 					name: p.name,

package/dist/nodes/src.js

@@ -2836,6 +2836,15 @@ function unwrapResult(result) {
 			networkError.stack = error.stack;
 			throw networkError;
 		}
+		const responseSummary = summarizeResponse(result.response);
+		if (responseSummary) {
+			const detail = stringifyUnknown(error);
+			throw new MoltNetError(`MoltNet API request failed with HTTP ${responseSummary.status} ${responseSummary.statusText}: ${detail}`, {
+				code: `HTTP_${responseSummary.status}`,
+				detail,
+				statusCode: responseSummary.status
+			});
+		}
 		throw new MoltNetError(`Unexpected error from MoltNet API: ${stringifyUnknown(error)}`, { code: "UNKNOWN" });
 	}
 	if (result.data === void 0) throw new MoltNetError("Unexpected empty response from MoltNet API", { code: "EMPTY_RESPONSE" });
@@ -2853,6 +2862,15 @@ function stringifyUnknown(value) {
 		return String(value);
 	}
 }
+function summarizeResponse(response) {
+	if (!response || typeof response !== "object") return null;
+	const candidate = response;
+	if (typeof candidate.status !== "number") return null;
+	return {
+		status: candidate.status,
+		statusText: typeof candidate.statusText === "string" && candidate.statusText ? candidate.statusText : "Error"
+	};
+}
 function unwrapRequired(result, message, code) {
 	if (result.error || !result.data) throw new MoltNetError(message, { code });
 	return result.data;

package/dist/nodes/task-artifact-download.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { a as nonEmpty, t as bool } from "./query-utils.js";
 import { a as requireAttemptContext, n as payloadRecord, r as recordField, s as resolveMaxBytes, t as collectArtifactBody } from "./task-artifact-utils.js";
 //#region src/nodes/task-artifact-download.ts
@@ -17,11 +18,11 @@ var init = (RED) => {
 						shape: "dot",
 						text: "downloading…"
 					});
-					const result = await (await agentNode.getAgent()).tasks.artifacts.download({
+					const result = await withAgent(agentNode, (agent) => agent.tasks.artifacts.download({
 						taskId,
 						attemptN,
 						cid
-					}, { teamId });
+					}, { teamId }));
 					const body = await collectArtifactBody(result, resolveMaxBytes(def.maxBytes));
 					const out = RED.util.cloneMessage({
 						...msg,

package/dist/nodes/task-artifact-upload.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { t as bool } from "./query-utils.js";
 import { a as requireAttemptContext, c as resolveUploadBody, o as resolveField, s as resolveMaxBytes } from "./task-artifact-utils.js";
 //#region src/nodes/task-artifact-upload.ts
@@ -17,10 +18,10 @@ var init = (RED) => {
 						shape: "dot",
 						text: "uploading…"
 					});
-					const artifact = await (await agentNode.getAgent()).tasks.artifacts.upload({
+					const artifact = await withAgent(agentNode, (agent) => agent.tasks.artifacts.upload({
 						taskId,
 						attemptN
-					}, body, query, { teamId });
+					}, body, query, { teamId }));
 					const out = RED.util.cloneMessage({
 						...msg,
 						payload: void 0

package/dist/nodes/task-artifacts-list.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { a as nonEmpty, c as positiveInt, n as compact, t as bool } from "./query-utils.js";
 import { i as requireArtifactContext, n as payloadRecord } from "./task-artifact-utils.js";
 //#region src/nodes/task-artifacts-list.ts
@@ -15,9 +16,8 @@ var init = (RED) => {
 						shape: "dot",
 						text: "loading…"
 					});
-					const agent = await agentNode.getAgent();
 					const query = buildQuery(def, msg);
-					const page = await agent.tasks.artifacts.listPage(taskId, query, { teamId });
+					const page = await withAgent(agentNode, (agent) => agent.tasks.artifacts.listPage(taskId, query, { teamId }));
 					const out = RED.util.cloneMessage(msg);
 					out.payload = page.artifacts;
 					out.taskId = taskId;

package/dist/nodes/task-get.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { t as buildTaskSnapshot } from "./task-snapshot.js";
 //#region src/nodes/task-get.ts
 var init = (RED) => {
@@ -15,8 +16,7 @@ var init = (RED) => {
 						shape: "dot",
 						text: "loading…"
 					});
-					const agent = await agentNode.getAgent();
-					const [task, attempts] = await Promise.all([agent.tasks.get(taskId), agent.tasks.listAttempts(taskId)]);
+					const [task, attempts] = await withAgent(agentNode, (agent) => Promise.all([agent.tasks.get(taskId), agent.tasks.listAttempts(taskId)]));
 					const snapshot = buildTaskSnapshot(task, attempts);
 					const out = RED.util.cloneMessage(msg);
 					out.payload = snapshot;

package/dist/nodes/task-wait.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { n as isTerminalTaskStatus, t as buildTaskSnapshot } from "./task-snapshot.js";
 //#region src/nodes/task-wait.ts
 var DEFAULT_POLL_SEC = 5;
@@ -9,48 +10,63 @@ var init = (RED) => {
 		const pollMs = Math.max(1, def.pollIntervalSec || DEFAULT_POLL_SEC) * 1e3;
 		const timeoutMs = (def.timeoutSec ?? DEFAULT_TIMEOUT_SEC) > 0 ? (def.timeoutSec ?? DEFAULT_TIMEOUT_SEC) * 1e3 : 0;
 		const kindAllow = parseKinds(def.kinds);
+		const active = /* @__PURE__ */ new Map();
 		const pending = /* @__PURE__ */ new Set();
 		this.on("close", () => {
 			for (const t of pending) clearTimeout(t);
 			pending.clear();
 		});
 		this.on("input", (msg, send, done) => {
+			let taskIdForStatus;
+			let label = describeMessage(msg);
 			const run = async () => {
 				try {
 					if (!agentNode || typeof agentNode.getAgent !== "function") throw new Error("task-wait: no moltnet-agent configured");
 					const taskId = resolveTaskId(msg, def.taskId);
 					if (!taskId) throw new Error("task-wait: taskId is required");
-					const agent = await agentNode.getAgent();
+					taskIdForStatus = taskId;
+					label = describeWait(taskId, msg, label);
+					active.set(taskId, label);
+					const correlationId = resolveCorrelationId(msg);
 					const startedAt = Date.now();
 					let afterSeq;
 					let polls = 0;
 					this.status({
 						fill: "blue",
 						shape: "dot",
-						text: "waiting…"
+						text: statusText("waiting", label, active.size)
 					});
 					for (;;) {
-						if (def.tail) afterSeq = await drainMessages({
+						if (def.tail) afterSeq = await withAgent(agentNode, (agent) => drainMessages({
 							agent,
 							taskId,
 							afterSeq,
 							kindAllow,
 							emit: (m) => {
 								const tailMsg = RED.util.cloneMessage(msg);
-								tailMsg.payload = m;
+								tailMsg.payload = correlationId ? {
+									...m,
+									correlationId
+								} : m;
 								tailMsg.taskId = taskId;
+								if (correlationId) tailMsg.correlationId = correlationId;
 								send([tailMsg, null]);
 							}
-						});
-						const task = await agent.tasks.get(taskId);
+						}));
+						const task = await withAgent(agentNode, (agent) => agent.tasks.get(taskId));
 						if (isTerminalTaskStatus(task.status)) {
-							const snapshot = buildTaskSnapshot(task, await agent.tasks.listAttempts(taskId));
+							const snapshot = buildTaskSnapshot(task, await withAgent(agentNode, (agent) => agent.tasks.listAttempts(taskId)));
 							const resultMsg = RED.util.cloneMessage(msg);
-							resultMsg.payload = snapshot;
+							resultMsg.payload = correlationId ? {
+								...snapshot,
+								correlationId
+							} : snapshot;
+							if (correlationId) resultMsg.correlationId = correlationId;
+							active.delete(taskId);
 							this.status({
 								fill: snapshot.accepted ? "green" : "red",
 								shape: "dot",
-								text: `${snapshot.status}${snapshot.accepted ? " ✓" : ""}`
+								text: statusText(`${snapshot.status}${snapshot.accepted ? " ok" : ""}`, label, active.size)
 							});
 							send([null, resultMsg]);
 							done();
@@ -61,15 +77,16 @@ var init = (RED) => {
 						this.status({
 							fill: "blue",
 							shape: "ring",
-							text: `${task.status} · ${polls}×`
+							text: statusText(`${task.status} ${polls}x`, label, active.size)
 						});
 						await sleep(pollMs, pending);
 					}
 				} catch (err) {
+					if (taskIdForStatus) active.delete(taskIdForStatus);
 					this.status({
 						fill: "red",
 						shape: "ring",
-						text: "error"
+						text: statusText("error", label, active.size)
 					});
 					done(err instanceof Error ? err : new Error(String(err)));
 				}
@@ -120,6 +137,43 @@ function resolveTaskId(msg, configured) {
 	}
 	return configured && configured.length > 0 ? configured : void 0;
 }
+function resolveCorrelationId(msg) {
+	if (typeof msg.correlationId === "string" && msg.correlationId) return msg.correlationId;
+	const payload = msg.payload;
+	if (payload && typeof payload === "object") {
+		const p = payload;
+		if (typeof p.correlationId === "string" && p.correlationId) return p.correlationId;
+	}
+}
+function describeMessage(msg) {
+	if (typeof msg.reviewDimension === "string" && msg.reviewDimension) return msg.reviewDimension;
+	const payload = msg.payload;
+	if (payload && typeof payload === "object") {
+		const p = payload;
+		if (typeof p.dimension === "string" && p.dimension) return p.dimension;
+		if (typeof p.title === "string" && p.title) return p.title;
+	}
+	return "task";
+}
+function describeWait(taskId, msg, fallback) {
+	if (fallback !== "task") return fallback;
+	const payload = msg.payload;
+	if (payload && typeof payload === "object") {
+		const p = payload;
+		if (typeof p.title === "string" && p.title) return p.title;
+	}
+	return shortId(taskId);
+}
+function statusText(action, label, activeCount) {
+	const suffix = activeCount > 0 ? ` · ${activeCount} active` : "";
+	return `${action} · ${truncate(label, 34)}${suffix}`;
+}
+function shortId(id) {
+	return id.slice(0, 8);
+}
+function truncate(value, max) {
+	return value.length <= max ? value : `${value.slice(0, max - 1)}…`;
+}
 function sleep(ms, pending) {
 	return new Promise((resolve) => {
 		const t = setTimeout(() => {

package/dist/nodes/tasks-create.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { randomUUID } from "node:crypto";
 //#region src/nodes/tasks-create.ts
 var init = (RED) => {
@@ -5,18 +6,24 @@ var init = (RED) => {
 		RED.nodes.createNode(this, def);
 		const agentNode = def.agent ? RED.nodes.getNode(def.agent) : null;
 		const profileNode = def.runtimeProfile ? RED.nodes.getNode(def.runtimeProfile) : null;
+		const active = /* @__PURE__ */ new Map();
+		let nextInvocationId = 0;
 		this.on("input", (msg, send, done) => {
+			const invocationId = ++nextInvocationId;
+			let label = describeMessage(msg);
 			const run = async () => {
 				try {
 					if (!agentNode || typeof agentNode.getAgent !== "function") throw new Error("tasks-create: no moltnet-agent configured");
+					active.set(invocationId, label);
 					this.status({
 						fill: "blue",
 						shape: "dot",
-						text: "creating…"
+						text: statusText("creating", label, active.size)
 					});
-					const agent = await agentNode.getAgent();
 					const base = msg.payload && typeof msg.payload === "object" ? { ...msg.payload } : {};
 					if (!base.taskType) base.taskType = "freeform";
+					label = describeTaskBody(base, label);
+					active.set(invocationId, label);
 					if (!base.allowedProfiles && profileNode?.profileId) base.allowedProfiles = [{ profileId: profileNode.profileId }];
 					if (base.maxAttempts === void 0 && typeof def.maxAttempts === "number") base.maxAttempts = def.maxAttempts;
 					if (!base.teamId && agentNode.teamId) base.teamId = agentNode.teamId;
@@ -24,22 +31,24 @@ var init = (RED) => {
 					const correlationId = resolveCorrelationId(msg, base.correlationId, def.generateCorrelationId === true);
 					if (correlationId) base.correlationId = correlationId;
 					const { teamId, ...createBody } = base;
-					const task = await agent.tasks.create(createBody, { teamId });
+					const task = await withAgent(agentNode, (agent) => agent.tasks.create(createBody, { teamId }));
 					const out = RED.util.cloneMessage(msg);
 					if (correlationId) out.correlationId = correlationId;
 					out.payload = task;
+					active.delete(invocationId);
 					this.status({
 						fill: "green",
 						shape: "dot",
-						text: `task ${task.id ?? "created"}`
+						text: statusText(`created ${shortId(task.id)}`, label, active.size)
 					});
 					send(out);
 					done();
 				} catch (err) {
+					active.delete(invocationId);
 					this.status({
 						fill: "red",
 						shape: "ring",
-						text: "error"
+						text: statusText("error", label, active.size)
 					});
 					done(err instanceof Error ? err : new Error(String(err)));
 				}
@@ -60,5 +69,37 @@ function resolveCorrelationId(msg, fromPayload, generate) {
 	if (typeof msg.correlationId === "string" && msg.correlationId) return msg.correlationId;
 	return generate ? randomUUID() : void 0;
 }
+function describeMessage(msg) {
+	if (typeof msg.reviewDimension === "string" && msg.reviewDimension) return msg.reviewDimension;
+	const payload = msg.payload;
+	if (payload && typeof payload === "object") {
+		const p = payload;
+		if (typeof p.dimension === "string" && p.dimension) return p.dimension;
+		if (typeof p.title === "string" && p.title) return p.title;
+	}
+	return "task";
+}
+function describeTaskBody(body, fallback) {
+	if (fallback !== "task") return fallback;
+	const input = body.input;
+	if (input && typeof input === "object") {
+		const execution = input.execution;
+		if (execution && typeof execution === "object") {
+			const dimension = execution.dimension;
+			if (typeof dimension === "string" && dimension) return dimension;
+		}
+	}
+	return typeof body.title === "string" && body.title ? body.title : fallback;
+}
+function statusText(action, label, activeCount) {
+	const suffix = activeCount > 0 ? ` · ${activeCount} active` : "";
+	return `${action} · ${truncate(label, 34)}${suffix}`;
+}
+function shortId(id) {
+	return typeof id === "string" && id ? id.slice(0, 8) : "task";
+}
+function truncate(value, max) {
+	return value.length <= max ? value : `${value.slice(0, max - 1)}…`;
+}
 //#endregion
 export { init as default };

package/dist/nodes/tasks-list.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 import { a as nonEmpty, c as positiveInt, n as compact, r as csv, t as bool } from "./query-utils.js";
 //#region src/nodes/tasks-list.ts
 var init = (RED) => {
@@ -15,9 +16,8 @@ var init = (RED) => {
 						shape: "dot",
 						text: "loading…"
 					});
-					const agent = await agentNode.getAgent();
 					const query = buildTasksQuery(def, msg);
-					const result = await agent.tasks.list(query, { teamId });
+					const result = await withAgent(agentNode, (agent) => agent.tasks.list(query, { teamId }));
 					const out = RED.util.cloneMessage(msg);
 					out.payload = result.items;
 					out.tasks = {

package/dist/nodes/workflow-status.js

@@ -1,3 +1,4 @@
+import { t as withAgent } from "./agent-call.js";
 //#region src/nodes/workflow-status.ts
 var init = (RED) => {
 	function WorkflowStatusNode(def) {
@@ -17,12 +18,11 @@ var init = (RED) => {
 					});
 					const teamId = agentNode.teamId;
 					if (!teamId) throw new Error("workflow-status: agent teamId is required");
-					const agent = await agentNode.getAgent();
 					const query = {
 						correlationId,
 						limit: def.limit && def.limit > 0 ? def.limit : 50
 					};
-					const res = await agent.tasks.list(query, { teamId });
+					const res = await withAgent(agentNode, (agent) => agent.tasks.list(query, { teamId }));
 					const rows = res.items.map((t) => ({
 						taskId: t.id,
 						type: t.taskType,