pi-lxmf 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-09-28
+
+### Added
+
+- Outbound LXMF messages now signal their content format: every content
+  chunk carries the `FIELD_RENDERER` field set to `RENDERER_MARKDOWN`, so
+  clients (Sideband, NomadNet) render pi's Markdown replies correctly
+  instead of showing raw markup as plain text.
+
 ## [0.2.0] - 2026-09-27
 
 ### Added

package/SPEC.md

@@ -181,6 +181,10 @@ example:
   paragraph boundaries where possible, each chunk suffixed
   `[… n/N]` except the last. Chunking keeps single LXMF messages
   reasonable for phone UIs and for mesh airtime.
+- **Content format:** every chunk carries the LXMF `FIELD_RENDERER` field
+  set to `RENDERER_MARKDOWN` (§5.9.4), since pi's replies are Markdown —
+  clients (Sideband, NomadNet) use it to render them instead of showing
+  raw markup as plain text.
 - **Errors:** failures to deliver a reply are logged and retried once;
   persistent failure is reported in the next successful message (LXMF has
   no channel over which to report its own failure).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-lxmf",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Drive the Pi coding agent over LXMF messaging (Reticulum mesh) from a headless server.",
   "license": "EUPL-1.2",
   "author": "Henri Bergius <henri.bergius@iki.fi>",

package/src/lxmf.js

@@ -53,6 +53,20 @@ export function isUnknownIdentityError(e) {
   return e instanceof Error && UNKNOWN_IDENTITY_MESSAGE.test(e.message);
 }
 
+/**
+ * Builds the fields map signaling the outbound message content format
+ * (FIELD_RENDERER, SPEC §5.9.4): pi's replies are Markdown, and clients
+ * such as Sideband only render them as such when the field says so —
+ * without it they show raw `**bold**`/backtick fences as plain text.
+ *
+ * @returns {Map<number, number>} `{FIELD_RENDERER: RENDERER_MARKDOWN}`
+ */
+export function contentFields() {
+  const fields = new Map();
+  fields.set(LXMFConstants.FIELD_RENDERER, LXMFConstants.RENDERER_MARKDOWN);
+  return fields;
+}
+
 /**
  * Waits until `transport` can recall the identity for `destinationHash`,
  * soliciting it first: a path request makes the destination itself (or any
@@ -526,6 +540,7 @@ export async function startLxmf(config, options = {}) {
         sourceHash: /** @type {Uint8Array} */ (deliveryDest.destinationHash),
         destinationHash: fromHex(destinationHex),
         content,
+        fields: contentFields(),
         ...(i === 0 && sendOptions.title ? { title: sendOptions.title } : {}),
       });
       await sendWithRetry(message, sendOptions.link);