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

package/README.md

@@ -15,12 +15,19 @@ 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 eight
+- Two **config nodes** (`moltnet-agent`, `moltnet-runtime-profile`) and eleven
   **action nodes** (`moltnet-tasks-create`, `moltnet-task-get`,
-  `moltnet-task-wait`, `moltnet-workflow-status`, `moltnet-task-builder`,
-  `moltnet-task-reader`, `moltnet-tasks-list`, `moltnet-entries-search`)
+  `moltnet-task-wait`, `moltnet-task-artifacts-list`,
+  `moltnet-task-artifact-upload`, `moltnet-task-artifact-download`,
+  `moltnet-workflow-status`, `moltnet-task-builder`, `moltnet-task-reader`,
+  `moltnet-tasks-list`, `moltnet-entries-search`)
   register and appear in the palette.
 
+For editor styling, install the separate companion package
+`@themoltnet/node-red-theme`. The theme is intentionally not bundled with these
+runtime nodes so it can be used independently by Node-RED instances that only
+want the MoltNet editor skin.
+
 ## Nodes
 
 - **`moltnet-agent`** (config) — holds one MoltNet agent identity (OAuth2 client
@@ -57,6 +64,21 @@ attempts, error, task }`. `state` is the accepted attempt's output artifact
   snapshot once. On failure the snapshot's `error` carries the last attempt's
   error for an agent/human to interpret (retry vs. escalate) — the same hook the
   `issue-lifecycle` supervisor uses.
+- **`moltnet-task-artifacts-list`** (palette: _task artifacts: list_) — lists a
+  task's artifacts for the configured team. Reads task id from
+  `msg.taskId`/`msg.payload.taskId`/`msg.payload.id` or the node field, supports
+  `limit`/`cursor`, emits artifact rows on `msg.payload`, and places
+  pagination/query metadata on `msg.artifacts`.
+- **`moltnet-task-artifact-upload`** (palette: _task artifact: upload_) —
+  uploads bytes for a task attempt. Reads bytes from `msg.payload` when it is a
+  string/Buffer/Uint8Array/ArrayBuffer, or from object payload fields
+  `content`, `body`, or base64 `contentBase64`. Team context is the configured
+  node/agent by default; message team overrides require an explicit checkbox.
+  Emits artifact metadata on `msg.payload` and `msg.artifact`.
+- **`moltnet-task-artifact-download`** (palette: _task artifact: download_) —
+  downloads an artifact by task id, attempt number, and CID. Emits the artifact
+  bytes as a Buffer on `msg.payload` and metadata on `msg.artifact`. Upload and
+  download nodes enforce a local 25 MiB byte limit by default.
 - **`moltnet-workflow-status`** (palette: _workflow: status_) — reads the tasks of
   one workflow run (by `correlationId`) and emits a table-shaped `msg.payload`
   (array of `{ taskId, type, title, status, queuedAt, completedAt }`) plus

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

@@ -0,0 +1,86 @@
+<script type="text/javascript">
+  RED.nodes.registerType('moltnet-task-artifact-download', {
+    category: 'moltnet',
+    color: '#00d4c8',
+    paletteLabel: 'task artifact: download',
+    defaults: {
+      name: { value: '' },
+      agent: { value: '', type: 'moltnet-agent', required: true },
+      taskId: { value: '' },
+      teamId: { value: '' },
+      allowMsgTeamOverride: { value: false },
+      attemptN: { value: '', validate: RED.validators.number() },
+      maxBytes: { value: 26214400, validate: RED.validators.number() },
+      cid: { value: '' },
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-download',
+    label: function () {
+      return this.name || 'task artifact: download';
+    },
+  });
+</script>
+
+<script type="text/html" data-template-name="moltnet-task-artifact-download">
+  <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-taskId"><i class="fa fa-hashtag"></i> Task ID</label>
+    <input
+      type="text"
+      id="node-input-taskId"
+      placeholder="msg.payload.taskId"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-teamId"><i class="fa fa-users"></i> Team ID</label>
+    <input type="text" id="node-input-teamId" placeholder="agent teamId" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-allowMsgTeamOverride"
+      ><i class="fa fa-random"></i> Team override</label
+    >
+    <input
+      type="checkbox"
+      id="node-input-allowMsgTeamOverride"
+      style="display: inline-block; width: auto; vertical-align: top"
+    />
+    <span>Allow <code>msg.teamId</code></span>
+  </div>
+  <div class="form-row">
+    <label for="node-input-attemptN"
+      ><i class="fa fa-history"></i> Attempt</label
+    >
+    <input type="number" id="node-input-attemptN" placeholder="msg.attemptN" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-cid"><i class="fa fa-fingerprint"></i> CID</label>
+    <input type="text" id="node-input-cid" placeholder="msg.payload.cid" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-maxBytes"><i class="fa fa-database"></i> Max</label>
+    <input type="number" id="node-input-maxBytes" />
+  </div>
+</script>
+
+<script type="text/html" data-help-name="moltnet-task-artifact-download">
+  <p>
+    Downloads a task artifact by task id, attempt number, and CID. CID is taken
+    from <code>msg.cid</code>, <code>msg.payload.cid</code>,
+    <code>msg.payload.artifact.cid</code>, or the configured CID. Team ID is
+    taken from this node or the configured agent unless Team override is
+    enabled.
+  </p>
+  <p>
+    Emits the artifact bytes as a Buffer on <code>msg.payload</code>. Download
+    metadata is placed on <code>msg.artifact</code>. The local byte limit
+    defaults to 25 MiB.
+  </p>
+</script>

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

@@ -0,0 +1,75 @@
+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
+var init = (RED) => {
+	function TaskArtifactDownloadNode(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("task-artifact-download: no moltnet-agent configured");
+					const { taskId, teamId, attemptN } = requireAttemptContext("task-artifact-download", msg, def.taskId, def.teamId, def.attemptN, agentNode, bool(def.allowMsgTeamOverride) ?? false);
+					const cid = resolveCid(msg, def.cid);
+					if (!cid) throw new Error("task-artifact-download: cid is required");
+					this.status({
+						fill: "blue",
+						shape: "dot",
+						text: "downloading…"
+					});
+					const result = await (await agentNode.getAgent()).tasks.artifacts.download({
+						taskId,
+						attemptN,
+						cid
+					}, { teamId });
+					const body = await collectArtifactBody(result, resolveMaxBytes(def.maxBytes));
+					const out = RED.util.cloneMessage({
+						...msg,
+						payload: void 0
+					});
+					out.payload = body;
+					out.taskId = taskId;
+					out.artifact = {
+						taskId,
+						teamId,
+						attemptN,
+						cid,
+						...metadataFromResult(result)
+					};
+					this.status({
+						fill: "green",
+						shape: "dot",
+						text: `${body.byteLength} byte(s)`
+					});
+					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-task-artifact-download", TaskArtifactDownloadNode);
+};
+function resolveCid(msg, configured) {
+	if (typeof msg.cid === "string" && msg.cid) return msg.cid;
+	const payload = payloadRecord(msg);
+	return nonEmpty(payload.cid) ?? nonEmpty(recordField(payload.artifact, "cid")) ?? nonEmpty(configured);
+}
+function metadataFromResult(result) {
+	if (!result || typeof result !== "object") return {};
+	const record = result;
+	return {
+		artifactId: record.artifactId,
+		contentType: record.contentType,
+		contentEncoding: record.contentEncoding
+	};
+}
+//#endregion
+export { init as default };

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

@@ -0,0 +1,118 @@
+<script type="text/javascript">
+  RED.nodes.registerType('moltnet-task-artifact-upload', {
+    category: 'moltnet',
+    color: '#00d4c8',
+    paletteLabel: 'task artifact: upload',
+    defaults: {
+      name: { value: '' },
+      agent: { value: '', type: 'moltnet-agent', required: true },
+      taskId: { value: '' },
+      teamId: { value: '' },
+      allowMsgTeamOverride: { value: false },
+      attemptN: { value: '', validate: RED.validators.number() },
+      maxBytes: { value: 26214400, validate: RED.validators.number() },
+      kind: { value: 'output' },
+      title: { value: '' },
+      contentType: { value: 'application/octet-stream' },
+      contentEncoding: { value: '' },
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-upload',
+    label: function () {
+      return this.name || 'task artifact: upload';
+    },
+  });
+</script>
+
+<script type="text/html" data-template-name="moltnet-task-artifact-upload">
+  <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-taskId"><i class="fa fa-hashtag"></i> Task ID</label>
+    <input
+      type="text"
+      id="node-input-taskId"
+      placeholder="msg.payload.taskId"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-teamId"><i class="fa fa-users"></i> Team ID</label>
+    <input type="text" id="node-input-teamId" placeholder="agent teamId" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-allowMsgTeamOverride"
+      ><i class="fa fa-random"></i> Team override</label
+    >
+    <input
+      type="checkbox"
+      id="node-input-allowMsgTeamOverride"
+      style="display: inline-block; width: auto; vertical-align: top"
+    />
+    <span>Allow <code>msg.teamId</code></span>
+  </div>
+  <div class="form-row">
+    <label for="node-input-attemptN"
+      ><i class="fa fa-history"></i> Attempt</label
+    >
+    <input type="number" id="node-input-attemptN" placeholder="msg.attemptN" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-kind"><i class="fa fa-archive"></i> Kind</label>
+    <select id="node-input-kind">
+      <option value="output">Output</option>
+      <option value="input">Input</option>
+      <option value="log">Log</option>
+      <option value="other">Other</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-title"><i class="fa fa-font"></i> Title</label>
+    <input type="text" id="node-input-title" placeholder="summary.md" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-maxBytes"><i class="fa fa-database"></i> Max</label>
+    <input type="number" id="node-input-maxBytes" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-contentType"
+      ><i class="fa fa-file-o"></i> Type</label
+    >
+    <input
+      type="text"
+      id="node-input-contentType"
+      placeholder="text/markdown"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-contentEncoding"
+      ><i class="fa fa-compress"></i> Encoding</label
+    >
+    <input type="text" id="node-input-contentEncoding" placeholder="gzip" />
+  </div>
+</script>
+
+<script type="text/html" data-help-name="moltnet-task-artifact-upload">
+  <p>
+    Uploads bytes as an artifact for a task attempt. Task id, attempt, kind,
+    title, content type, and content encoding can be supplied by the node fields
+    or matching fields on <code>msg.payload</code>. Team ID is taken from this
+    node or the configured agent unless Team override is enabled.
+  </p>
+  <p>
+    The body is read from <code>msg.payload</code> when it is a string, Buffer,
+    Uint8Array, or ArrayBuffer. Object payloads may provide
+    <code>content</code>, <code>body</code>, or base64
+    <code>contentBase64</code>. The local byte limit defaults to 25 MiB.
+  </p>
+  <p>
+    Emits the artifact metadata on <code>msg.payload</code> and
+    <code>msg.artifact</code>.
+  </p>
+</script>

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

@@ -0,0 +1,61 @@
+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
+var init = (RED) => {
+	function TaskArtifactUploadNode(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("task-artifact-upload: no moltnet-agent configured");
+					const { taskId, teamId, attemptN } = requireAttemptContext("task-artifact-upload", msg, def.taskId, def.teamId, def.attemptN, agentNode, bool(def.allowMsgTeamOverride) ?? false);
+					const body = resolveUploadBody(msg, resolveMaxBytes(def.maxBytes));
+					const query = buildUploadQuery(def, msg);
+					this.status({
+						fill: "blue",
+						shape: "dot",
+						text: "uploading…"
+					});
+					const artifact = await (await agentNode.getAgent()).tasks.artifacts.upload({
+						taskId,
+						attemptN
+					}, body, query, { teamId });
+					const out = RED.util.cloneMessage({
+						...msg,
+						payload: void 0
+					});
+					out.payload = artifact;
+					out.taskId = taskId;
+					out.artifact = artifact;
+					this.status({
+						fill: "green",
+						shape: "dot",
+						text: artifact.cid
+					});
+					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-task-artifact-upload", TaskArtifactUploadNode);
+};
+function buildUploadQuery(def, msg) {
+	return {
+		kind: resolveField(msg, "kind", def.kind) ?? "output",
+		title: resolveField(msg, "title", def.title) ?? "artifact",
+		contentType: resolveField(msg, "contentType", def.contentType) ?? "application/octet-stream",
+		contentEncoding: resolveField(msg, "contentEncoding", def.contentEncoding)
+	};
+}
+//#endregion
+export { init as default };

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

@@ -0,0 +1,149 @@
+import { a as nonEmpty, c as positiveInt } from "./query-utils.js";
+import { Readable } from "node:stream";
+import { Buffer } from "node:buffer";
+function payloadRecord(msg) {
+	if (!msg.payload || typeof msg.payload !== "object") return {};
+	if (Buffer.isBuffer(msg.payload)) return {};
+	return msg.payload;
+}
+function resolveTaskId(msg, configured) {
+	if (typeof msg.taskId === "string" && msg.taskId) return msg.taskId;
+	const payload = payloadRecord(msg);
+	return nonEmpty(payload.taskId) ?? nonEmpty(payload.id) ?? nonEmpty(recordField(payload.task, "id")) ?? nonEmpty(configured);
+}
+function resolveTeamId(msg, configured, agentNode, allowMsgTeamOverride) {
+	if (!allowMsgTeamOverride) return nonEmpty(configured) ?? agentNode.teamId;
+	if (typeof msg.teamId === "string" && msg.teamId) return msg.teamId;
+	return nonEmpty(payloadRecord(msg).teamId) ?? nonEmpty(configured) ?? agentNode.teamId;
+}
+function resolveAttemptN(msg, configured) {
+	const payload = payloadRecord(msg);
+	return positiveInt(msg.attemptN) ?? positiveInt(payload.attemptN) ?? positiveInt(recordField(payload.attempt, "attemptN")) ?? positiveInt(recordField(payload.artifact, "attemptN")) ?? positiveInt(configured);
+}
+function requireArtifactContext(nodeName, msg, configuredTaskId, configuredTeamId, agentNode, allowMsgTeamOverride) {
+	const taskId = resolveTaskId(msg, configuredTaskId);
+	if (!taskId) throw new Error(`${nodeName}: taskId is required`);
+	const teamId = resolveTeamId(msg, configuredTeamId, agentNode, allowMsgTeamOverride);
+	if (!teamId) throw new Error(`${nodeName}: teamId is required`);
+	return {
+		taskId,
+		teamId
+	};
+}
+function requireAttemptContext(nodeName, msg, configuredTaskId, configuredTeamId, configuredAttemptN, agentNode, allowMsgTeamOverride) {
+	const context = requireArtifactContext(nodeName, msg, configuredTaskId, configuredTeamId, agentNode, allowMsgTeamOverride);
+	const attemptN = resolveAttemptN(msg, configuredAttemptN);
+	if (!attemptN) throw new Error(`${nodeName}: attemptN is required`);
+	return {
+		...context,
+		attemptN
+	};
+}
+function resolveField(msg, name, configured) {
+	return nonEmpty(payloadRecord(msg)[name]) ?? nonEmpty(configured);
+}
+function resolveMaxBytes(configured) {
+	return positiveInt(configured) ?? 26214400;
+}
+function resolveUploadBody(msg, maxBytes) {
+	const payload = msg.payload;
+	if (Buffer.isBuffer(payload)) return enforceMaxBytes(payload, maxBytes);
+	if (payload instanceof Uint8Array) return enforceMaxBytes(payload, maxBytes);
+	if (payload instanceof ArrayBuffer) {
+		if (payload.byteLength > maxBytes) throw tooLarge("upload", maxBytes);
+		return new Uint8Array(payload);
+	}
+	if (typeof payload === "string") {
+		if (Buffer.byteLength(payload) > maxBytes) throw tooLarge("upload", maxBytes);
+		return new TextEncoder().encode(payload);
+	}
+	const record = payloadRecord(msg);
+	if (typeof record.contentBase64 === "string") {
+		const normalized = record.contentBase64.replace(/\s/g, "");
+		if (decodedBase64Length(normalized) > maxBytes) throw tooLarge("upload", maxBytes);
+		return Buffer.from(normalized, "base64");
+	}
+	const content = record.content ?? record.body;
+	if (Buffer.isBuffer(content)) return enforceMaxBytes(content, maxBytes);
+	if (content instanceof Uint8Array) return enforceMaxBytes(content, maxBytes);
+	if (content instanceof ArrayBuffer) {
+		if (content.byteLength > maxBytes) throw tooLarge("upload", maxBytes);
+		return new Uint8Array(content);
+	}
+	if (typeof content === "string") {
+		if (Buffer.byteLength(content) > maxBytes) throw tooLarge("upload", maxBytes);
+		return new TextEncoder().encode(content);
+	}
+	throw new Error("task-artifact-upload: payload content is required");
+}
+async function collectArtifactBody(value, maxBytes) {
+	const source = value && typeof value === "object" && "stream" in value ? value.stream : value;
+	if (Buffer.isBuffer(source)) {
+		if (source.byteLength > maxBytes) throw tooLarge("download", maxBytes);
+		return source;
+	}
+	if (source instanceof Uint8Array) {
+		if (source.byteLength > maxBytes) throw tooLarge("download", maxBytes);
+		return Buffer.from(source);
+	}
+	if (source instanceof ArrayBuffer) {
+		if (source.byteLength > maxBytes) throw tooLarge("download", maxBytes);
+		return Buffer.from(source);
+	}
+	if (typeof source === "string") {
+		if (Buffer.byteLength(source) > maxBytes) throw tooLarge("download", maxBytes);
+		return Buffer.from(source);
+	}
+	if (source instanceof Readable) {
+		const chunks = [];
+		let bytes = 0;
+		for await (const chunk of source) bytes = pushChunk(chunks, chunk, bytes, maxBytes);
+		return Buffer.concat(chunks);
+	}
+	if (source && typeof source === "object" && Symbol.asyncIterator in source) {
+		const chunks = [];
+		let bytes = 0;
+		for await (const chunk of source) bytes = pushChunk(chunks, chunk, bytes, maxBytes);
+		return Buffer.concat(chunks);
+	}
+	if (source && typeof source === "object" && "arrayBuffer" in source) {
+		const size = source.size;
+		if (typeof size === "number" && size > maxBytes) throw tooLarge("download", maxBytes);
+		const arrayBuffer = await source.arrayBuffer();
+		if (arrayBuffer.byteLength > maxBytes) throw tooLarge("download", maxBytes);
+		return Buffer.from(arrayBuffer);
+	}
+	throw new Error("task-artifact-download: unsupported artifact body");
+}
+function toBuffer(value) {
+	if (Buffer.isBuffer(value)) return value;
+	if (value instanceof Uint8Array) return Buffer.from(value);
+	if (value instanceof ArrayBuffer) return Buffer.from(value);
+	if (typeof value === "string") return Buffer.from(value);
+	return Buffer.from(String(value));
+}
+function recordField(value, key) {
+	if (!value || typeof value !== "object") return void 0;
+	return value[key];
+}
+function enforceMaxBytes(value, maxBytes) {
+	if (value.byteLength > maxBytes) throw tooLarge("upload", maxBytes);
+	return value;
+}
+function pushChunk(chunks, chunk, bytes, maxBytes) {
+	const next = toBuffer(chunk);
+	const total = bytes + next.byteLength;
+	if (total > maxBytes) throw tooLarge("download", maxBytes);
+	chunks.push(next);
+	return total;
+}
+function decodedBase64Length(value) {
+	if (!value) return 0;
+	const padding = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0;
+	return Math.floor(value.length * 3 / 4) - padding;
+}
+function tooLarge(operation, maxBytes) {
+	return /* @__PURE__ */ new Error(`task-artifact-${operation}: artifact body exceeds ${maxBytes} bytes`);
+}
+//#endregion
+export { requireAttemptContext as a, resolveUploadBody as c, requireArtifactContext as i, payloadRecord as n, resolveField as o, recordField as r, resolveMaxBytes as s, collectArtifactBody as t };

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

@@ -0,0 +1,78 @@
+<script type="text/javascript">
+  RED.nodes.registerType('moltnet-task-artifacts-list', {
+    category: 'moltnet',
+    color: '#00d4c8',
+    paletteLabel: 'task artifacts: list',
+    defaults: {
+      name: { value: '' },
+      agent: { value: '', type: 'moltnet-agent', required: true },
+      taskId: { value: '' },
+      teamId: { value: '' },
+      allowMsgTeamOverride: { value: false },
+      limit: { value: 20, validate: RED.validators.number() },
+      cursor: { value: '' },
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-list',
+    label: function () {
+      return this.name || 'task artifacts: list';
+    },
+  });
+</script>
+
+<script type="text/html" data-template-name="moltnet-task-artifacts-list">
+  <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-taskId"><i class="fa fa-hashtag"></i> Task ID</label>
+    <input
+      type="text"
+      id="node-input-taskId"
+      placeholder="msg.payload.taskId"
+    />
+  </div>
+  <div class="form-row">
+    <label for="node-input-teamId"><i class="fa fa-users"></i> Team ID</label>
+    <input type="text" id="node-input-teamId" placeholder="agent teamId" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-allowMsgTeamOverride"
+      ><i class="fa fa-random"></i> Team override</label
+    >
+    <input
+      type="checkbox"
+      id="node-input-allowMsgTeamOverride"
+      style="display: inline-block; width: auto; vertical-align: top"
+    />
+    <span>Allow <code>msg.teamId</code></span>
+  </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-cursor"><i class="fa fa-forward"></i> Cursor</label>
+    <input type="text" id="node-input-cursor" />
+  </div>
+</script>
+
+<script type="text/html" data-help-name="moltnet-task-artifacts-list">
+  <p>
+    Lists artifacts for a MoltNet task. The task id is taken from
+    <code>msg.taskId</code>, <code>msg.payload.taskId</code>,
+    <code>msg.payload.id</code>, or the configured Task ID. Team ID is taken
+    from this node or the configured agent. Enable Team override to allow
+    <code>msg.teamId</code> or <code>msg.payload.teamId</code>.
+  </p>
+  <p>
+    Emits artifact rows on <code>msg.payload</code>. Pagination metadata, the
+    final query, and the full page are on <code>msg.artifacts</code>.
+  </p>
+</script>

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

@@ -0,0 +1,61 @@
+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
+var init = (RED) => {
+	function TaskArtifactsListNode(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("task-artifacts-list: no moltnet-agent configured");
+					const { taskId, teamId } = requireArtifactContext("task-artifacts-list", msg, def.taskId, def.teamId, agentNode, bool(def.allowMsgTeamOverride) ?? false);
+					this.status({
+						fill: "blue",
+						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 out = RED.util.cloneMessage(msg);
+					out.payload = page.artifacts;
+					out.taskId = taskId;
+					out.artifacts = {
+						taskId,
+						teamId,
+						query,
+						count: page.artifacts.length,
+						nextCursor: page.nextCursor,
+						page
+					};
+					this.status({
+						fill: "green",
+						shape: "dot",
+						text: `${page.artifacts.length} artifact(s)`
+					});
+					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-task-artifacts-list", TaskArtifactsListNode);
+};
+function buildQuery(def, msg) {
+	const payload = payloadRecord(msg);
+	return compact({
+		limit: positiveInt(payload.limit) ?? positiveInt(def.limit),
+		cursor: nonEmpty(payload.cursor) ?? nonEmpty(def.cursor)
+	});
+}
+//#endregion
+export { init as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@themoltnet/node-red-contrib-core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Node-RED nodes for the MoltNet API",
   "keywords": [
@@ -27,6 +27,9 @@
       "moltnet-tasks-list": "dist/nodes/tasks-list.js",
       "moltnet-task-get": "dist/nodes/task-get.js",
       "moltnet-task-wait": "dist/nodes/task-wait.js",
+      "moltnet-task-artifacts-list": "dist/nodes/task-artifacts-list.js",
+      "moltnet-task-artifact-upload": "dist/nodes/task-artifact-upload.js",
+      "moltnet-task-artifact-download": "dist/nodes/task-artifact-download.js",
       "moltnet-workflow-status": "dist/nodes/workflow-status.js",
       "moltnet-task-builder": "dist/nodes/task-builder.js",
       "moltnet-task-reader": "dist/nodes/task-reader.js",