capdag 0.138.305 → 0.140.310

package/cap-graph-renderer.js

@@ -108,24 +108,24 @@ function canonicalMediaUrn(mediaUrnString) {
   return MediaUrn.fromString(mediaUrnString).toString();
 }
 
-// Produce a multi-line node label from a canonical media URN, one line
-// per tag. Marker tags render as bare keys; value tags render as
-// `key: value`. TaggedUrn.getTags() is iterated in sorted order matching
-// the canonical serialization.
-function mediaNodeLabel(canonicalUrn) {
-  const TaggedUrn = requireHostDependency('TaggedUrn');
-  const parsed = TaggedUrn.fromString(canonicalUrn);
-  const tags = parsed.tags;
-  const lines = [];
-  for (const key of Object.keys(tags).sort()) {
-    const value = tags[key];
-    if (value === '*') {
-      lines.push(key);
-    } else {
-      lines.push(`${key}: ${value}`);
-    }
+// Graph labels must be provided explicitly by the host. The renderer is not
+// allowed to synthesize user-facing labels from URNs.
+function mediaNodeLabel() {
+  throw new Error(
+    'CapGraphRenderer: mediaNodeLabel() is no longer supported. ' +
+    'Pass explicit media titles/display names to the renderer.'
+  );
+}
+
+function requireExplicitDisplayName(canonicalUrn, displayEntries, context) {
+  const MediaUrn = requireHostDependency('MediaUrn');
+  const candidate = MediaUrn.fromString(canonicalUrn);
+  for (const entry of displayEntries) {
+    if (candidate.isEquivalent(entry.media)) return entry.display;
   }
-  return lines.join('\n');
+  throw new Error(
+    `CapGraphRenderer: missing explicit display name for ${context} '${canonicalUrn}'`
+  );
 }
 
 // =============================================================================
@@ -461,6 +461,9 @@ function validateBrowseData(data) {
     assertString(cap.urn, `browse mode data[${idx}].urn`);
     assertString(cap.in_spec, `browse mode data[${idx}].in_spec (cap urn: ${cap.urn})`);
     assertString(cap.out_spec, `browse mode data[${idx}].out_spec (cap urn: ${cap.urn})`);
+    assertString(cap.title, `browse mode data[${idx}].title (cap urn: ${cap.urn})`);
+    assertString(cap.in_media_title, `browse mode data[${idx}].in_media_title (cap urn: ${cap.urn})`);
+    assertString(cap.out_media_title, `browse mode data[${idx}].out_media_title (cap urn: ${cap.urn})`);
   });
 }
 
@@ -631,6 +634,7 @@ function validateResolvedMachinePayload(data) {
       }
       assertString(n.id, `machine mode data.strands[${sIdx}].nodes[${nIdx}].id`);
       assertString(n.urn, `machine mode data.strands[${sIdx}].nodes[${nIdx}].urn`);
+      assertString(n.title, `machine mode data.strands[${sIdx}].nodes[${nIdx}].title`);
     });
     assertArray(strand.edges, `machine mode data.strands[${sIdx}].edges`);
     strand.edges.forEach((e, eIdx) => {
@@ -639,6 +643,7 @@ function validateResolvedMachinePayload(data) {
       }
       assertString(e.alias, `machine mode data.strands[${sIdx}].edges[${eIdx}].alias`);
       assertString(e.cap_urn, `machine mode data.strands[${sIdx}].edges[${eIdx}].cap_urn`);
+      assertString(e.title, `machine mode data.strands[${sIdx}].edges[${eIdx}].title`);
       if (typeof e.is_loop !== 'boolean') {
         throw new Error(`CapGraphRenderer machine mode: data.strands[${sIdx}].edges[${eIdx}].is_loop must be boolean`);
       }
@@ -744,6 +749,13 @@ function buildBrowseGraphData(capabilities) {
   });
 
   const nodes = Array.from(nodesMap.values());
+  for (const node of nodes) {
+    if (!mediaTitles.has(node.id)) {
+      throw new Error(
+        `CapGraphRenderer browse mode: missing explicit media title for '${node.id}'`
+      );
+    }
+  }
 
   const adjacency = new Map();
   const reverseAdj = new Map();
@@ -762,8 +774,8 @@ function browseCytoscapeElements(built) {
     group: 'nodes',
     data: {
       id: node.id,
-      label: mediaNodeLabel(node.id),
-      mediaTitle: built.mediaTitles.get(node.id) || '',
+      label: built.mediaTitles.get(node.id),
+      mediaTitle: built.mediaTitles.get(node.id),
       fullUrn: node.id,
     },
   }));
@@ -863,11 +875,7 @@ function buildStrandGraphData(data) {
     }
   }
   function displayNameFor(canonicalUrn) {
-    const candidate = MediaUrn.fromString(canonicalUrn);
-    for (const entry of displayEntries) {
-      if (candidate.isEquivalent(entry.media)) return entry.display;
-    }
-    return mediaNodeLabel(canonicalUrn);
+    return requireExplicitDisplayName(canonicalUrn, displayEntries, 'strand node');
   }
 
   const nodes = [];
@@ -1497,11 +1505,7 @@ function buildRunGraphData(data) {
     } catch (_) { /* ignore malformed keys */ }
   }
   function displayNameFor(canonicalUrn) {
-    const candidate = MediaUrn.fromString(canonicalUrn);
-    for (const entry of displayEntries) {
-      if (candidate.isEquivalent(entry.media)) return entry.display;
-    }
-    return mediaNodeLabel(canonicalUrn);
+    return requireExplicitDisplayName(canonicalUrn, displayEntries, 'run node');
   }
 
   // The per-body "entry" node represents one item of the
@@ -1946,7 +1950,7 @@ function buildResolvedMachineGraphData(data) {
         group: 'nodes',
         data: {
           id: node.id,
-          label: mediaNodeLabel(canonicalMediaUrn(node.urn)),
+          label: node.title,
           fullUrn: node.urn,
           strandIndex: strandIdx,
         },
@@ -1957,11 +1961,7 @@ function buildResolvedMachineGraphData(data) {
     for (const edge of strand.edges) {
       const cardinality = edge.is_loop ? 'n\u21921' : '1\u21921';
       const capUrn = edge.cap_urn;
-      // Title falls back to the canonical cap URN. The host can
-      // pre-resolve a friendlier title via `step_titles` on the
-      // proto message and use it elsewhere in the UI; the graph
-      // renderer is intentionally registry-free.
-      const capTitle = capUrn;
+      const capTitle = edge.title;
       const label = cardinality === '1\u21921'
         ? edge.alias
         : `${edge.alias} (${cardinality})`;

package/capdag.js

@@ -890,11 +890,10 @@ const MEDIA_YAML_LIST_RECORD = 'media:list;record;textable;yaml';
 const MEDIA_CSV = 'media:csv;list;record;textable';
 const MEDIA_CSV_LIST = 'media:csv;list;textable';
 
-// File path types - for arguments that represent filesystem paths
-// Media URN for a single file path - textable, scalar by default (no list marker)
+// File path type — for arguments that represent filesystem paths.
+// There is a single media URN; cardinality (single file vs many files)
+// is carried on the wire via is_sequence, not via URN tags.
 const MEDIA_FILE_PATH = 'media:file-path;textable';
-// Media URN for an array of file paths - textable with list marker
-const MEDIA_FILE_PATH_ARRAY = 'media:file-path;list;textable';
 
 // Semantic text input types - distinguished by their purpose/context
 // Media URN for model spec (provider:model format, HuggingFace name, etc.) - scalar by default
@@ -1095,25 +1094,12 @@ class MediaUrn {
   }
 
   /**
-   * Check if this represents a single file path type (not array).
-   * Returns true if the "file-path" marker tag is present AND no list marker.
+   * True if this URN specializes `media:file-path`. There is a single
+   * file-path media URN; cardinality (single file vs many) is carried on
+   * the wire via `is_sequence`, not via URN tags.
    * @returns {boolean}
    */
-  isFilePath() { return this._hasMarkerTag('file-path') && !this.isList(); }
-
-  /**
-   * Check if this represents a file path array type.
-   * Returns true if the "file-path" marker tag is present AND has list marker.
-   * @returns {boolean}
-   */
-  isFilePathArray() { return this._hasMarkerTag('file-path') && this.isList(); }
-
-  /**
-   * Check if this represents any file path type (single or array).
-   * Returns true if "file-path" marker tag is present.
-   * @returns {boolean}
-   */
-  isAnyFilePath() { return this._hasMarkerTag('file-path'); }
+  isFilePath() { return this._hasMarkerTag('file-path'); }
 
   /**
    * Check if this represents a collection type.
@@ -5675,9 +5661,8 @@ module.exports = {
   MEDIA_LLM_INFERENCE_OUTPUT,
   MEDIA_IMAGE_DESCRIPTION,
   MEDIA_TRANSCRIPTION_OUTPUT,
-  // File path types
+  // File path type — single URN; cardinality lives on is_sequence.
   MEDIA_FILE_PATH,
-  MEDIA_FILE_PATH_ARRAY,
   MEDIA_MLX_MODEL_PATH,
   // Collection types
   MEDIA_COLLECTION,

package/capdag.test.js

@@ -24,7 +24,7 @@ const {
   MEDIA_HTML, MEDIA_XML, MEDIA_JSON, MEDIA_YAML, MEDIA_JSON_SCHEMA,
   MEDIA_MODEL_SPEC, MEDIA_AVAILABILITY_OUTPUT, MEDIA_PATH_OUTPUT,
   MEDIA_LLM_INFERENCE_OUTPUT,
-  MEDIA_FILE_PATH, MEDIA_FILE_PATH_ARRAY,
+  MEDIA_FILE_PATH,
   MEDIA_COLLECTION, MEDIA_COLLECTION_LIST,
   MEDIA_DECISION,
   MEDIA_AUDIO_SPEECH
@@ -2453,34 +2453,15 @@ function test1298_isBool() {
   assert(!MediaUrn.fromString(MEDIA_IDENTITY).isBool(), 'MEDIA_IDENTITY should not be bool');
 }
 
-// TEST1299: is_file_path returns true for scalar file-path, false for array
+// TEST1299: isFilePath returns true for the single file-path media URN,
+// false for everything else. There is no "array" variant — cardinality is
+// carried by is_sequence on the wire, not by URN tags.
 function test1299_isFilePath() {
   assert(MediaUrn.fromString(MEDIA_FILE_PATH).isFilePath(), 'MEDIA_FILE_PATH should be file-path');
-  // Array file-path is NOT isFilePath (it's isFilePathArray)
-  assert(!MediaUrn.fromString(MEDIA_FILE_PATH_ARRAY).isFilePath(), 'MEDIA_FILE_PATH_ARRAY should not be isFilePath');
-  // Non-file-path types
   assert(!MediaUrn.fromString(MEDIA_STRING).isFilePath(), 'MEDIA_STRING should not be file-path');
   assert(!MediaUrn.fromString(MEDIA_IDENTITY).isFilePath(), 'MEDIA_IDENTITY should not be file-path');
 }
 
-// TEST1300: is_file_path_array returns true for list file-path, false for scalar
-function test1300_isFilePathArray() {
-  assert(MediaUrn.fromString(MEDIA_FILE_PATH_ARRAY).isFilePathArray(), 'MEDIA_FILE_PATH_ARRAY should be file-path-array');
-  // Scalar file-path is NOT isFilePathArray
-  assert(!MediaUrn.fromString(MEDIA_FILE_PATH).isFilePathArray(), 'MEDIA_FILE_PATH should not be isFilePathArray');
-  // Non-file-path types
-  assert(!MediaUrn.fromString(MEDIA_STRING_LIST).isFilePathArray(), 'MEDIA_STRING_LIST should not be file-path-array');
-}
-
-// TEST1301: is_any_file_path returns true for both scalar and array file-path
-function test1301_isAnyFilePath() {
-  assert(MediaUrn.fromString(MEDIA_FILE_PATH).isAnyFilePath(), 'MEDIA_FILE_PATH should be any-file-path');
-  assert(MediaUrn.fromString(MEDIA_FILE_PATH_ARRAY).isAnyFilePath(), 'MEDIA_FILE_PATH_ARRAY should be any-file-path');
-  // Non-file-path types
-  assert(!MediaUrn.fromString(MEDIA_STRING).isAnyFilePath(), 'MEDIA_STRING should not be any-file-path');
-  assert(!MediaUrn.fromString(MEDIA_STRING_LIST).isAnyFilePath(), 'MEDIA_STRING_LIST should not be any-file-path');
-}
-
 // Mirror-specific coverage: isCollection returns true when collection marker tag is present
 // Mirror-specific coverage: N/A for JS (MEDIA_COLLECTION constants removed - no longer exists)
 function testisCollection() {
@@ -3872,6 +3853,7 @@ const {
   cardinalityFromCap: rendererCardinalityFromCap,
   canonicalMediaUrn: rendererCanonicalMediaUrn,
   mediaNodeLabel: rendererMediaNodeLabel,
+  buildBrowseGraphData: rendererBuildBrowseGraphData,
   buildStrandGraphData: rendererBuildStrandGraphData,
   collapseStrandShapeTransitions: rendererCollapseStrandShapeTransitions,
   buildRunGraphData: rendererBuildRunGraphData,
@@ -4018,24 +4000,41 @@ function testRenderer_canonicalMediaUrn_rejectsCapUrn() {
   assert(threw, 'canonicalMediaUrn must reject non-media URNs');
 }
 
-function testRenderer_mediaNodeLabel_oneLinePerTag_valueAndMarker() {
-  // A media URN with one value tag and one marker tag renders two lines:
-  // value tag as "key: value", marker tag as bare key. Order is canonical
-  // (alphabetical, matching TaggedUrn's sorted key iteration).
-  const label = rendererMediaNodeLabel('media:video;quant=q4');
-  const lines = label.split('\n');
-  assertEqual(lines.length, 2, 'two tags must produce two lines');
-  assert(lines.includes('quant: q4'), 'value tag rendered as key: value');
-  assert(lines.includes('video'),     'marker tag rendered as bare key');
+function testRenderer_mediaNodeLabel_rejectsUrnDerivedLabels() {
+  let threw = false;
+  let message = '';
+  try {
+    rendererMediaNodeLabel('media:video;quant=q4');
+  } catch (e) {
+    threw = true;
+    message = e.message || '';
+  }
+  assert(threw, 'mediaNodeLabel must reject URN-derived labels');
+  assert(message.includes('no longer supported'),
+    'error must explain that explicit titles are required');
 }
 
-function testRenderer_mediaNodeLabel_stableAcrossTagOrder() {
-  // Labels must be tag-order-independent so that the same media URN
-  // produces the same multi-line label regardless of how the source
-  // happened to spell it.
-  const a = rendererMediaNodeLabel(rendererCanonicalMediaUrn('media:list;textable'));
-  const b = rendererMediaNodeLabel(rendererCanonicalMediaUrn('media:textable;list'));
-  assertEqual(a, b, 'label must be stable across tag orderings');
+function testRenderer_buildBrowseGraphData_rejectsMissingMediaTitles() {
+  let threw = false;
+  let message = '';
+  try {
+    rendererBuildBrowseGraphData([
+      {
+        urn: 'cap:in="media:pdf";op=extract;out="media:txt;textable"',
+        title: 'Extract Text',
+        in_spec: 'media:pdf',
+        out_spec: 'media:txt;textable',
+        in_media_title: 'PDF',
+        out_media_title: '',
+      },
+    ]);
+  } catch (e) {
+    threw = true;
+    message = e.message || '';
+  }
+  assert(threw, 'browse builder must reject missing explicit media titles');
+  assert(message.includes('out_media_title'),
+    'error must identify the missing explicit media title field');
 }
 
 // ---------------- strand builder ----------------
@@ -4156,18 +4155,27 @@ function findEdge(edges, source, target) {
   return edges.find(e => e.source === source && e.target === target);
 }
 
+function withMediaDisplayNames(payload, mediaDisplayNames) {
+  return Object.assign({}, payload, {
+    media_display_names: Object.assign({}, mediaDisplayNames),
+  });
+}
+
 function testRenderer_buildStrandGraphData_singleCapPlain() {
   // Minimal strand with one plain 1→1 cap. Plan builder produces:
   //   input_slot → step_0 (cap) → output
   // (two edges, three nodes). No cardinality marker in the cap label
   // because input_is_sequence == output_is_sequence == false.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:b',
     steps: [
       makeCapStep('cap:in="media:a";op=x;out="media:b"', 'x', 'media:a', 'media:b', false, false),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Target B',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const nodeIds = built.nodes.map(n => n.id).sort();
   assertEqual(JSON.stringify(nodeIds), JSON.stringify(['input_slot', 'output', 'step_0']),
@@ -4183,13 +4191,16 @@ function testRenderer_buildStrandGraphData_singleCapPlain() {
 function testRenderer_buildStrandGraphData_sequenceShowsCardinality() {
   // A cap with input_is_sequence=true MUST emit "(n→1)" on its edge
   // label.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a;list',
     target_spec: 'media:b',
     steps: [
       makeCapStep('cap:in="media:a;list";op=x;out="media:b"', 'x', 'media:a;list', 'media:b', true, false),
     ],
-  };
+  }, {
+    'media:a;list': 'Source A List',
+    'media:b': 'Target B',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const capEdge = findEdge(built.edges, 'input_slot', 'step_0');
   assert(capEdge !== undefined, 'cap edge exists');
@@ -4210,7 +4221,7 @@ function testRenderer_buildStrandGraphData_foreachCollectSpan() {
   // edges.) ForEach and Collect are REAL nodes in the graph, not
   // labels on cap edges — they're distinct processing units in the
   // plan. This mirrors capdag's plan_builder.rs exactly.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:pdf;list',
     target_spec: 'media:txt;list',
     steps: [
@@ -4218,7 +4229,11 @@ function testRenderer_buildStrandGraphData_foreachCollectSpan() {
       makeCapStep('cap:in="media:pdf";op=extract;out="media:txt"', 'extract', 'media:pdf', 'media:txt', false, false),
       makeCollectStep('media:txt'),
     ],
-  };
+  }, {
+    'media:pdf;list': 'PDF List',
+    'media:txt': 'Plain Text',
+    'media:txt;list': 'Text List',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const nodeIds = built.nodes.map(n => n.id).sort();
   assertEqual(JSON.stringify(nodeIds),
@@ -4248,14 +4263,18 @@ function testRenderer_buildStrandGraphData_standaloneCollect() {
   // Strand with a standalone Collect (no enclosing ForEach). Plan
   // builder creates a Collect node consuming prev directly — plain
   // direct edge, no iteration/collection semantics.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:b;list',
     steps: [
       makeCapStep('cap:in="media:a";op=x;out="media:b"', 'x', 'media:a', 'media:b', false, false),
       makeCollectStep('media:b'),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Target B',
+    'media:b;list': 'Target B List',
+  });
   const built = rendererBuildStrandGraphData(payload);
   assert(findEdge(built.edges, 'input_slot', 'step_0') !== undefined,
     'cap edge input_slot → step_0');
@@ -4272,7 +4291,7 @@ function testRenderer_buildStrandGraphData_unclosedForEachBody() {
   // builder's "unclosed ForEach" branch creates a ForEach node
   // connecting Cap_a to Cap_b via iteration, with prev becoming the
   // body exit (Cap_b).
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:c',
     steps: [
@@ -4280,7 +4299,11 @@ function testRenderer_buildStrandGraphData_unclosedForEachBody() {
       makeForEachStep('media:b'),
       makeCapStep('cap:in="media:b";op=b;out="media:c"', 'b', 'media:b', 'media:c', false, false),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Intermediate B',
+    'media:c': 'Target C',
+  });
   const built = rendererBuildStrandGraphData(payload);
   // Cap_a connects from input_slot.
   assert(findEdge(built.edges, 'input_slot', 'step_0') !== undefined,
@@ -4305,7 +4328,7 @@ function testRenderer_buildStrandGraphData_nestedForEachThrows() {
   // ForEach is an illegal nesting per plan_builder. The renderer
   // must throw the same error to surface the issue rather than
   // render a malformed graph.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a;list',
     target_spec: 'media:a',
     steps: [
@@ -4313,7 +4336,10 @@ function testRenderer_buildStrandGraphData_nestedForEachThrows() {
       makeForEachStep('media:a'),
       makeCapStep('cap:in="media:a";op=x;out="media:a"', 'x', 'media:a', 'media:a', false, false),
     ],
-  };
+  }, {
+    'media:a;list': 'Source A List',
+    'media:a': 'Source A',
+  });
   let threw = false;
   try {
     rendererBuildStrandGraphData(payload);
@@ -4339,7 +4365,7 @@ function testRenderer_collapseStrand_singleCapBodyKeepsCapOwnLabel() {
   // Expected render shape: 3 nodes (input_slot, step_1, output),
   // with the entry edge labeled "extract" and an unlabeled
   // connector bridge to the output.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:pdf;list',
     target_spec: 'media:txt;list',
     steps: [
@@ -4347,7 +4373,11 @@ function testRenderer_collapseStrand_singleCapBodyKeepsCapOwnLabel() {
       makeCapStep('cap:in="media:pdf";op=extract;out="media:txt"', 'extract', 'media:pdf', 'media:txt', false, false),
       makeCollectStep('media:txt'),
     ],
-  };
+  }, {
+    'media:pdf;list': 'PDF List',
+    'media:txt': 'Plain Text',
+    'media:txt;list': 'Text List',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4384,7 +4414,7 @@ function testRenderer_collapseStrand_unclosedForEachBodyCollapses() {
   // no relabeling.
   //
   // Final: 3 nodes (input_slot, step_0, step_2), 2 edges.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:c',
     steps: [
@@ -4392,7 +4422,11 @@ function testRenderer_collapseStrand_unclosedForEachBodyCollapses() {
       makeForEachStep('media:b'),
       makeCapStep('cap:in="media:b";op=b;out="media:c"', 'b', 'media:b', 'media:c', false, false),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Intermediate B',
+    'media:c': 'Target C',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4437,14 +4471,18 @@ function testRenderer_collapseStrand_standaloneCollectCollapses() {
   //     cap is not inside any foreach body.
   //
   // Final: 3 nodes (input_slot, step_0, output), 2 edges.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:b;list',
     steps: [
       makeCapStep('cap:in="media:a";op=x;out="media:b"', 'x', 'media:a', 'media:b', false, false),
       makeCollectStep('media:b'),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Target B',
+    'media:b;list': 'Target B List',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4481,7 +4519,7 @@ function testRenderer_collapseStrand_sequenceProducingCapBeforeForeach() {
   //       (Disbind), NOT the cap that consumes one item from it.
   //   No separate output node because step_2's to_spec equals the
   //       strand target.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:pdf',
     target_spec: 'media:decision',
     steps: [
@@ -4489,7 +4527,11 @@ function testRenderer_collapseStrand_sequenceProducingCapBeforeForeach() {
       makeForEachStep('media:page'),
       makeCapStep('cap:in="media:page";op=decide;out="media:decision"', 'Make a Decision', 'media:page', 'media:decision', false, false),
     ],
-  };
+  }, {
+    'media:pdf': 'PDF',
+    'media:page': 'Page',
+    'media:decision': 'Decision',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4532,13 +4574,16 @@ function testRenderer_collapseStrand_plainCapMergesTrailingOutput() {
   // step_0 and output represent the same URN (media:b).
   //
   // Final: 2 nodes (input_slot, step_0), 1 edge.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:b',
     steps: [
       makeCapStep('cap:in="media:a";op=x;out="media:b"', 'x', 'media:a', 'media:b', false, false),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Target B',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4561,13 +4606,17 @@ function testRenderer_collapseStrand_plainCapDistinctTargetNoMerge() {
   // A strand with a single plain cap whose to_spec is NOT
   // equivalent to target_spec. The output node must be retained
   // and the trailing connector edge preserved.
-  const payload = {
+  const payload = withMediaDisplayNames({
     source_spec: 'media:a',
     target_spec: 'media:b;list',
     steps: [
       makeCapStep('cap:in="media:a";op=x;out="media:b"', 'x', 'media:a', 'media:b', false, false),
     ],
-  };
+  }, {
+    'media:a': 'Source A',
+    'media:b': 'Target B',
+    'media:b;list': 'Target B List',
+  });
   const built = rendererBuildStrandGraphData(payload);
   const collapsed = rendererCollapseStrandShapeTransitions(built);
 
@@ -4641,6 +4690,12 @@ function testRenderer_buildRunGraphData_pagesSuccessesAndFailures() {
   }
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf;list': 'PDF List',
+      'media:pdf': 'PDF',
+      'media:png': 'PNG',
+      'media:txt': 'Text',
+    },
     body_outcomes: outcomes,
     visible_success_count: 3,
     visible_failure_count: 2,
@@ -4684,6 +4739,11 @@ function testRenderer_buildRunGraphData_failureWithoutFailedCapRendersFullTrace(
   };
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf;list': 'PDF List',
+      'media:pdf': 'PDF',
+      'media:txt': 'Text',
+    },
     body_outcomes: [
       { body_index: 0, success: false, cap_urns: [], saved_paths: [], total_bytes: 0, duration_ms: 0, error: 'unknown' },
     ],
@@ -4726,6 +4786,12 @@ function testRenderer_buildRunGraphData_usesCapUrnIsEquivalentForFailedCap() {
   // will match. Feed a fully-specified form that is equivalent.
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:a': 'Source A',
+      'media:a;list': 'Source A List',
+      'media:b': 'Intermediate B',
+      'media:c': 'Target C',
+    },
     body_outcomes: [
       {
         body_index: 0,
@@ -4775,6 +4841,11 @@ function testRenderer_buildRunGraphData_backboneHasNoForeachNode() {
   };
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf': 'PDF',
+      'media:page': 'Page',
+      'media:decision': 'Decision',
+    },
     body_outcomes: [],
     visible_success_count: 0,
     visible_failure_count: 0,
@@ -4819,6 +4890,11 @@ function testRenderer_buildRunGraphData_allFailedDropsTargetPlaceholder() {
   const failedCapUrn = 'cap:in="media:page";op=decide;out="media:decision"';
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf': 'PDF',
+      'media:page': 'Page',
+      'media:decision': 'Decision',
+    },
     body_outcomes: [
       { body_index: 0, success: false, cap_urns: [], saved_paths: [], total_bytes: 0, duration_ms: 0, failed_cap: failedCapUrn, error: 'boom' },
       { body_index: 1, success: false, cap_urns: [], saved_paths: [], total_bytes: 0, duration_ms: 0, failed_cap: failedCapUrn, error: 'boom' },
@@ -4883,6 +4959,11 @@ function testRenderer_buildRunGraphData_unclosedForeachSuccessNoMerge() {
   };
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf': 'PDF',
+      'media:page': 'Page',
+      'media:decision': 'Decision',
+    },
     body_outcomes: [
       { body_index: 0, success: true, cap_urns: [], saved_paths: [], total_bytes: 0, duration_ms: 0 },
     ],
@@ -4937,6 +5018,12 @@ function testRenderer_buildRunGraphData_closedForeachSuccessMergesAtCollectTarge
   };
   const payload = {
     resolved_strand: strand,
+    media_display_names: {
+      'media:pdf;list': 'PDF List',
+      'media:pdf': 'PDF',
+      'media:txt': 'Text',
+      'media:txt;list': 'Text List',
+    },
     body_outcomes: [
       { body_index: 0, success: true, cap_urns: [], saved_paths: [], total_bytes: 0, duration_ms: 0 },
     ],
@@ -5098,14 +5185,15 @@ function testRenderer_buildResolvedMachineGraphData_singleStrandLinearChain() {
     strands: [
       {
         nodes: [
-          { id: 'n0', urn: 'media:pdf' },
-          { id: 'n1', urn: 'media:txt;textable' },
-          { id: 'n2', urn: 'media:embedding;record' },
+          { id: 'n0', urn: 'media:pdf', title: 'PDF' },
+          { id: 'n1', urn: 'media:txt;textable', title: 'Plain Text' },
+          { id: 'n2', urn: 'media:embedding;record', title: 'Embedding Record' },
         ],
         edges: [
           {
             alias: 'edge_0',
             cap_urn: 'cap:in=media:pdf;op=extract;out=media:txt;textable',
+            title: 'Extract Text',
             is_loop: false,
             assignment: [
               { cap_arg_media_urn: 'media:pdf', source_node: 'n0' },
@@ -5115,6 +5203,7 @@ function testRenderer_buildResolvedMachineGraphData_singleStrandLinearChain() {
           {
             alias: 'edge_1',
             cap_urn: 'cap:in=media:textable;op=embed;out=media:embedding;record',
+            title: 'Generate Embedding',
             is_loop: false,
             assignment: [
               { cap_arg_media_urn: 'media:textable', source_node: 'n1' },
@@ -5137,6 +5226,7 @@ function testRenderer_buildResolvedMachineGraphData_singleStrandLinearChain() {
   // Anchor nodes carry the strand-source / strand-target classes.
   const n0 = built.nodes.find(n => n.data.id === 'n0');
   const n2 = built.nodes.find(n => n.data.id === 'n2');
+  assertEqual(n0.data.label, 'PDF', 'node label must come from explicit title');
   assert(n0.classes.indexOf('strand-source') >= 0,
     'input anchor node carries strand-source class');
   assert(n2.classes.indexOf('strand-target') >= 0,
@@ -5151,13 +5241,14 @@ function testRenderer_buildResolvedMachineGraphData_loopEdgeGetsLoopClass() {
     strands: [
       {
         nodes: [
-          { id: 'n0', urn: 'media:page;textable' },
-          { id: 'n1', urn: 'media:decision;json;record;textable' },
+          { id: 'n0', urn: 'media:page;textable', title: 'Page' },
+          { id: 'n1', urn: 'media:decision;json;record;textable', title: 'Decision Record' },
         ],
         edges: [
           {
             alias: 'edge_0',
             cap_urn: 'cap:in=media:textable;op=make_decision;out=media:decision;json;record;textable',
+            title: 'Make Decision',
             is_loop: true,
             assignment: [
               { cap_arg_media_urn: 'media:textable', source_node: 'n0' },
@@ -5185,14 +5276,15 @@ function testRenderer_buildResolvedMachineGraphData_fanInProducesEdgePerAssignme
     strands: [
       {
         nodes: [
-          { id: 'n0', urn: 'media:image;png' },
-          { id: 'n1', urn: 'media:model-spec;textable' },
-          { id: 'n2', urn: 'media:image-description;textable' },
+          { id: 'n0', urn: 'media:image;png', title: 'PNG Image' },
+          { id: 'n1', urn: 'media:model-spec;textable', title: 'Model Spec' },
+          { id: 'n2', urn: 'media:image-description;textable', title: 'Image Description' },
         ],
         edges: [
           {
             alias: 'edge_0',
             cap_urn: 'cap:in=media:image;png;op=describe_image;out=media:image-description;textable',
+            title: 'Describe Image',
             is_loop: false,
             assignment: [
               { cap_arg_media_urn: 'media:image;png', source_node: 'n0' },
@@ -5225,13 +5317,14 @@ function testRenderer_buildResolvedMachineGraphData_multiStrandKeepsStrandsDisjo
     strands: [
       {
         nodes: [
-          { id: 'n0', urn: 'media:pdf' },
-          { id: 'n1', urn: 'media:txt;textable' },
+          { id: 'n0', urn: 'media:pdf', title: 'PDF' },
+          { id: 'n1', urn: 'media:txt;textable', title: 'Plain Text' },
         ],
         edges: [
           {
             alias: 'edge_0',
             cap_urn: 'cap:in=media:pdf;op=extract;out=media:txt;textable',
+            title: 'Extract Text',
             is_loop: false,
             assignment: [
               { cap_arg_media_urn: 'media:pdf', source_node: 'n0' },
@@ -5244,13 +5337,14 @@ function testRenderer_buildResolvedMachineGraphData_multiStrandKeepsStrandsDisjo
       },
       {
         nodes: [
-          { id: 'n2', urn: 'media:json;record;textable' },
-          { id: 'n3', urn: 'media:csv;list;record;textable' },
+          { id: 'n2', urn: 'media:json;record;textable', title: 'JSON Record' },
+          { id: 'n3', urn: 'media:csv;list;record;textable', title: 'CSV Rows' },
         ],
         edges: [
           {
             alias: 'edge_1',
             cap_urn: 'cap:in=media:json;record;textable;op=convert_format;out=media:csv;list;record;textable',
+            title: 'Convert Format',
             is_loop: false,
             assignment: [
               { cap_arg_media_urn: 'media:json;record;textable', source_node: 'n2' },
@@ -5284,13 +5378,13 @@ function testRenderer_buildResolvedMachineGraphData_duplicateNodeIdAcrossStrands
   const payload = {
     strands: [
       {
-        nodes: [{ id: 'n0', urn: 'media:pdf' }],
+        nodes: [{ id: 'n0', urn: 'media:pdf', title: 'PDF' }],
         edges: [],
         input_anchor_nodes: ['n0'],
         output_anchor_nodes: ['n0'],
       },
       {
-        nodes: [{ id: 'n0', urn: 'media:html' }],
+        nodes: [{ id: 'n0', urn: 'media:html', title: 'HTML' }],
         edges: [],
         input_anchor_nodes: ['n0'],
         output_anchor_nodes: ['n0'],
@@ -5318,13 +5412,14 @@ function testRenderer_validateResolvedMachinePayload_rejectsMissingFields() {
   const cases = [
     { strands: 'not-an-array' },
     { strands: [{ nodes: [], edges: [], input_anchor_nodes: [] /* missing output_anchor_nodes */ }] },
-    { strands: [{ nodes: [{ id: 'n0' /* missing urn */ }], edges: [], input_anchor_nodes: [], output_anchor_nodes: [] }] },
+    { strands: [{ nodes: [{ id: 'n0' /* missing urn/title */ }], edges: [], input_anchor_nodes: [], output_anchor_nodes: [] }] },
     {
       strands: [{
-        nodes: [{ id: 'n0', urn: 'media:x' }],
+        nodes: [{ id: 'n0', urn: 'media:x', title: 'X' }],
         edges: [{
           alias: 'edge_0',
           cap_urn: 'cap:in=...;out=...',
+          title: 'Edge 0',
           is_loop: false,
           assignment: [{ cap_arg_media_urn: 'media:x' /* missing source_node */ }],
           target_node: 'n0',
@@ -5546,8 +5641,6 @@ async function runTests() {
   runTest('TEST1315: is_numeric', test1315_isNumeric);
   runTest('TEST1298: is_bool', test1298_isBool);
   runTest('TEST1299: is_file_path', test1299_isFilePath);
-  runTest('TEST1300: is_file_path_array', test1300_isFilePathArray);
-  runTest('TEST1301: is_any_file_path', test1301_isAnyFilePath);
   runTest('TEST1302: predicate_constant_consistency', test1302_predicateConstantConsistency);
 
   // cap_urn.rs: TEST1303-TEST1307 (CapUrn tier tests)
@@ -5703,8 +5796,8 @@ async function runTests() {
   runTest('RENDERER: canonicalMediaUrn_normalizesTagOrder',   testRenderer_canonicalMediaUrn_normalizesTagOrder);
   runTest('RENDERER: canonicalMediaUrn_preservesValueTags',   testRenderer_canonicalMediaUrn_preservesValueTags);
   runTest('RENDERER: canonicalMediaUrn_rejectsCapUrn',        testRenderer_canonicalMediaUrn_rejectsCapUrn);
-  runTest('RENDERER: mediaNodeLabel_valueAndMarker',          testRenderer_mediaNodeLabel_oneLinePerTag_valueAndMarker);
-  runTest('RENDERER: mediaNodeLabel_stableAcrossTagOrder',    testRenderer_mediaNodeLabel_stableAcrossTagOrder);
+  runTest('RENDERER: mediaNodeLabel_rejectsUrnDerived',       testRenderer_mediaNodeLabel_rejectsUrnDerivedLabels);
+  runTest('RENDERER: buildBrowse_rejectsMissingMediaTitles',  testRenderer_buildBrowseGraphData_rejectsMissingMediaTitles);
 
   console.log('\n--- cap-graph-renderer strand builder ---');
   runTest('RENDERER: validateStrandStep_unknownVariant',      testRenderer_validateStrandStep_rejectsUnknownVariant);

package/package.json

@@ -40,5 +40,5 @@
     "pretest": "npm run build:parser",
     "test": "node capdag.test.js"
   },
-  "version": "0.138.305"
+  "version": "0.140.310"
 }