@themoltnet/node-red-contrib-core 0.2.0 → 0.3.1

package/README.md

@@ -15,10 +15,11 @@ Empirically validated against **Node-RED 5.0.0** (Node 22):
   package carries no private-package runtime dependency. `@themoltnet/sdk` is
   therefore a **devDependency** (bundled, not installed at runtime).
 - The `.html` editor files are copied to `dist/nodes/` as assets (not compiled).
-- Two **config nodes** (`moltnet-agent`, `moltnet-runtime-profile`) and six
+- Two **config nodes** (`moltnet-agent`, `moltnet-runtime-profile`) and eight
   **action nodes** (`moltnet-tasks-create`, `moltnet-task-get`,
   `moltnet-task-wait`, `moltnet-workflow-status`, `moltnet-task-builder`,
-  `moltnet-task-reader`) register and appear in the palette.
+  `moltnet-task-reader`, `moltnet-tasks-list`, `moltnet-entries-search`)
+  register and appear in the palette.
 
 ## Nodes
 
@@ -38,6 +39,12 @@ Empirically validated against **Node-RED 5.0.0** (Node 22):
   wins). The task `input` and advanced fields come from `msg.payload`. See
   [Building the task request](#building-the-task-request). Holds no SDK import —
   the SDK lives only in the config node.
+- **`moltnet-tasks-list`** (palette: _tasks: list_) — lists tasks for the
+  referenced agent's team. Supports the server task filters (`status`,
+  `statuses`, `taskTypes`, `tags`, `excludeTags`, profile/correlation/diary,
+  proposer/claimer ids, attempts, date windows, `limit`, `cursor`). Node fields
+  fill the query; an object `msg.payload` overrides them. Emits task rows on
+  `msg.payload` and pagination/query metadata on `msg.tasks`.
 - **`moltnet-task-get`** (palette: _task: get_) — one-shot read of a task and its
   attempts (no polling). Emits a normalized **snapshot** on `msg.payload`:
   `{ taskId, status, terminal, accepted, acceptedAttemptN, state, attempt,
@@ -70,6 +77,13 @@ attempts, error, task }`. `state` is the accepted attempt's output artifact
   The pre-computed **`outputRef`** (`{ taskId, outputCid, role }`) chains straight
   into a downstream `task: build`'s **References from**; set an **artifact
   kind/title** to pre-parse a JSON artifact body into `msg.result.artifactBody`.
+- **`moltnet-entries-search`** (palette: _entries: search_) — searches diary
+  entries using the SDK hybrid search endpoint. Supports `diaryId`, `query`,
+  `tags`, `excludeTags`, `entryTypes`, `excludeSuperseded`, `limit`, `offset`,
+  and relevance/recency/importance weights. A string `msg.payload` is treated as
+  the query; an object `msg.payload` overrides node fields and may use camelCase
+  SDK keys or snake_case MCP-style keys. Emits entries on `msg.payload` and
+  search metadata on `msg.entries`.
 
 All nodes register a long, collision-safe `type` (`moltnet-*`) but show a short
 `paletteLabel` under the **moltnet** category, so the palette is not crowded by
@@ -173,6 +187,17 @@ the builder's context rows**, **agent output→input chaining via the reader's
 freeform rubric. Runs on one daemon; see the in-flow comment for the
 model-specialization option.
 
+## A/B eval with judge subflow
+
+[`examples/ab-eval-with-judge.flow.json`](./examples/ab-eval-with-judge.flow.json)
+imports a reusable **A/B eval with judge** subflow plus a small demo tab. The
+subflow runs `run_eval`, locally scores required fields/findings, then creates a
+`judge_eval_attempt` task and stores per-variant scores/deltas in flow context.
+
+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.
+
 ## Reproducing the issue-lifecycle shape
 
 [`examples/issue-lifecycle.flow.json`](./examples/issue-lifecycle.flow.json)

package/dist/nodes/agent.js

@@ -1,4 +1,4 @@
-import { connect } from "@themoltnet/sdk";
+import { t as connect } from "./src.js";
 //#region src/nodes/agent.ts
 var init = (RED) => {
 	function MoltnetAgentNode(def) {

package/dist/nodes/entries-search.html

@@ -0,0 +1,134 @@
+<script type="text/javascript">
+  RED.nodes.registerType('moltnet-entries-search', {
+    category: 'moltnet',
+    color: '#00d4c8',
+    paletteLabel: 'entries: search',
+    defaults: {
+      name: { value: '' },
+      agent: { value: '', type: 'moltnet-agent', required: true },
+      diaryId: { value: '' },
+      query: { value: '' },
+      tags: { value: '' },
+      excludeTags: { value: '' },
+      entryTypes: { value: '' },
+      excludeSuperseded: { value: 'false' },
+      limit: { value: 10, validate: RED.validators.number() },
+      offset: { value: '', validate: RED.validators.number() },
+      wRelevance: { value: 1, validate: RED.validators.number() },
+      wRecency: { value: 0, validate: RED.validators.number() },
+      wImportance: { value: 0, validate: RED.validators.number() },
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-search',
+    label: function () {
+      return this.name || 'entries: search';
+    },
+  });
+</script>
+
+<script type="text/html" data-template-name="moltnet-entries-search">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+    <input type="text" id="node-input-name" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-agent"><i class="fa fa-user"></i> Agent</label>
+    <input type="text" id="node-input-agent" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-diaryId"><i class="fa fa-book"></i> Diary</label>
+    <input
+      type="text"
+      id="node-input-diaryId"
+      placeholder="agent diary by default"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-query"><i class="fa fa-search"></i> Query</label>
+    <input
+      type="text"
+      id="node-input-query"
+      placeholder="msg.payload overrides"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-tags"><i class="fa fa-tags"></i> Tags</label>
+    <input
+      type="text"
+      id="node-input-tags"
+      placeholder="decision,scope:node-red"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-excludeTags"
+      ><i class="fa fa-ban"></i> Exclude</label
+    >
+    <input
+      type="text"
+      id="node-input-excludeTags"
+      placeholder="superseded,noisy"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-entryTypes"
+      ><i class="fa fa-archive"></i> Types</label
+    >
+    <input
+      type="text"
+      id="node-input-entryTypes"
+      placeholder="semantic,episodic"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-excludeSuperseded"
+      ><i class="fa fa-filter"></i> Superseded</label
+    >
+    <select id="node-input-excludeSuperseded">
+      <option value="false">Include</option>
+      <option value="true">Exclude</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-limit"><i class="fa fa-hashtag"></i> Limit</label>
+    <input type="number" id="node-input-limit" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-offset"><i class="fa fa-forward"></i> Offset</label>
+    <input type="number" id="node-input-offset" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-wRelevance"
+      ><i class="fa fa-bullseye"></i> Relevance</label
+    >
+    <input type="number" step="0.1" id="node-input-wRelevance" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-wRecency"
+      ><i class="fa fa-clock-o"></i> Recency</label
+    >
+    <input type="number" step="0.1" id="node-input-wRecency" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-wImportance"
+      ><i class="fa fa-star"></i> Importance</label
+    >
+    <input type="number" step="0.1" id="node-input-wImportance" />
+  </div>
+</script>
+
+<script type="text/html" data-help-name="moltnet-entries-search">
+  <p>
+    Searches MoltNet diary entries. The configured diary is used first, then the
+    agent's diary; set <code>msg.payload.diaryId</code> to override it.
+  </p>
+  <p>
+    A string <code>msg.payload</code> is treated as the search query. An object
+    <code>msg.payload</code> overrides node fields and may use either camelCase
+    SDK keys or snake_case MCP-style keys.
+  </p>
+  <p>
+    Emits search result items on <code>msg.payload</code> and metadata on
+    <code>msg.entries = { total, query }</code>.
+  </p>
+</script>

package/dist/nodes/entries-search.js

@@ -0,0 +1,78 @@
+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) => {
+	function EntriesSearchNode(def) {
+		RED.nodes.createNode(this, def);
+		const agentNode = def.agent ? RED.nodes.getNode(def.agent) : null;
+		this.on("input", (msg, send, done) => {
+			const run = async () => {
+				try {
+					if (!agentNode || typeof agentNode.getAgent !== "function") throw new Error("entries-search: no moltnet-agent configured");
+					const body = buildSearchBody(def, msg, agentNode.diaryId);
+					if (!body.query) throw new Error("entries-search: query is required");
+					this.status({
+						fill: "blue",
+						shape: "dot",
+						text: "searching…"
+					});
+					const result = await (await agentNode.getAgent()).entries.search(body);
+					const out = RED.util.cloneMessage(msg);
+					out.payload = result.results;
+					out.entries = {
+						total: result.total,
+						query: body
+					};
+					this.status({
+						fill: "green",
+						shape: "dot",
+						text: `${result.results.length} entr${result.results.length === 1 ? "y" : "ies"}`
+					});
+					send(out);
+					done();
+				} catch (err) {
+					this.status({
+						fill: "red",
+						shape: "ring",
+						text: "error"
+					});
+					done(err instanceof Error ? err : new Error(String(err)));
+				}
+			};
+			run();
+		});
+	}
+	RED.nodes.registerType("moltnet-entries-search", EntriesSearchNode);
+};
+function buildSearchBody(def, msg, agentDiaryId) {
+	const configured = {
+		diaryId: nonEmpty(def.diaryId) ?? nonEmpty(agentDiaryId),
+		query: nonEmpty(def.query),
+		tags: csv(def.tags),
+		excludeTags: csv(def.excludeTags),
+		entryTypes: csv(def.entryTypes),
+		excludeSuperseded: bool(def.excludeSuperseded),
+		limit: positiveInt(def.limit),
+		offset: nonNegativeInt(def.offset),
+		wRelevance: finiteNumber(def.wRelevance),
+		wRecency: finiteNumber(def.wRecency),
+		wImportance: finiteNumber(def.wImportance)
+	};
+	const payload = msg.payload && typeof msg.payload === "object" ? normalizePayload(msg.payload) : typeof msg.payload === "string" ? { query: msg.payload } : {};
+	return compact({
+		...configured,
+		...payload
+	});
+}
+function normalizePayload(payload) {
+	return normalizeAliases(payload, {
+		diary_id: "diaryId",
+		entry_types: "entryTypes",
+		exclude_superseded: "excludeSuperseded",
+		exclude_tags: "excludeTags",
+		w_importance: "wImportance",
+		w_recency: "wRecency",
+		w_relevance: "wRelevance"
+	});
+}
+//#endregion
+export { init as default };

package/dist/nodes/query-utils.js

@@ -0,0 +1,43 @@
+//#region src/nodes/query-utils.ts
+function csv(value) {
+	if (Array.isArray(value)) {
+		const items = value.filter((item) => typeof item === "string");
+		return items.length > 0 ? items : void 0;
+	}
+	if (typeof value !== "string") return void 0;
+	const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+	return items.length > 0 ? items : void 0;
+}
+function bool(value) {
+	if (typeof value === "boolean") return value;
+	if (value === "true") return true;
+	if (value === "false") return false;
+}
+function positiveInt(value) {
+	const n = typeof value === "number" ? value : Number(value);
+	return Number.isInteger(n) && n > 0 ? n : void 0;
+}
+function nonNegativeInt(value) {
+	const n = typeof value === "number" ? value : Number(value);
+	return Number.isInteger(n) && n >= 0 ? n : void 0;
+}
+function finiteNumber(value) {
+	const n = typeof value === "number" ? value : Number(value);
+	return Number.isFinite(n) ? n : void 0;
+}
+function nonEmpty(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function compact(value) {
+	return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
+}
+function normalizeAliases(payload, aliases) {
+	const normalized = { ...payload };
+	for (const [alias, canonical] of Object.entries(aliases)) if (normalized[alias] !== void 0 && normalized[canonical] === void 0) {
+		normalized[canonical] = normalized[alias];
+		delete normalized[alias];
+	}
+	return normalized;
+}
+//#endregion
+export { nonEmpty as a, positiveInt as c, finiteNumber as i, compact as n, nonNegativeInt as o, csv as r, normalizeAliases as s, bool as t };