@duckmind/dm-windows-x64 0.61.4 → 0.61.9

package/extensions/dm-subagents/src/runs/background/fleet-view.js

@@ -1,14 +1,16 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { safeTerminalText } from "../../shared/display-text.js";
 import { formatDuration, formatModelThinking, formatTokens, shortenPath } from "../../shared/formatters.js";
 import { formatActivityLabel } from "../../shared/status-format.js";
 import {
-  ASYNC_DIR,
-  RESULTS_DIR
+  DIRS
 } from "../../shared/types.js";
 import { readStatus } from "../../shared/utils.js";
 import { formatNestedRunStatusLines } from "../shared/nested-render.js";
+import { contextModeLabel, summarizeContextModes } from "../shared/context-mode.js";
 import { formatAsyncRunOutputPath, formatAsyncRunProgressLabel, listAsyncRuns } from "./async-status.js";
+import { isTrustedRecordedSessionFile } from "../../shared/session-file-trust.js";
 const DEFAULT_TRANSCRIPT_LINES = 80;
 const MAX_TRANSCRIPT_LINES = 500;
 const TRANSCRIPT_TAIL_BYTES = 256 * 1024;
@@ -30,6 +32,12 @@ function uniqueStrings(values) {
   }
   return result;
 }
+function fleetChildDisplayName(child, fallback = "subagent") {
+  return child.sessionName?.trim() || child.agent || fallback;
+}
+function fleetStepDisplayName(step) {
+  return step.sessionName?.trim() || (step.label ? `${step.label} (${step.agent})` : step.agent);
+}
 function resolveMaybeRelative(asyncDir, filePath) {
   if (!filePath)
     return;
@@ -78,11 +86,12 @@ function readTextTail(filePath, maxLines) {
       fs.closeSync(fd);
   }
 }
-function readContainedTextTail(filePath, maxLines, trustedRoots, label) {
-  if (trustedRoots.length === 0)
+function readContainedTextTail(filePath, maxLines, trustedRoots, label, trustedFiles = [], trustedFileRoot) {
+  if (trustedRoots.length === 0 && (!trustedFileRoot || trustedFiles.length === 0))
     return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path without a trusted root: ${filePath}` };
   const resolvedPath = path.resolve(filePath);
-  if (!trustedRoots.some((root) => pathWithin(root, resolvedPath))) {
+  const recordedCandidate = trustedFileRoot && pathWithin(trustedFileRoot, resolvedPath) && trustedFiles.some((file) => path.resolve(file) === resolvedPath);
+  if (!trustedRoots.some((root) => pathWithin(root, resolvedPath)) && !recordedCandidate) {
     return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };
   }
   let lstat;
@@ -105,7 +114,7 @@ function readContainedTextTail(filePath, maxLines, trustedRoots, label) {
   } catch (error) {
     return { path: filePath, lines: [], truncated: false, error: getErrorMessage(error) };
   }
-  if (!realRoots.some((root) => pathWithin(root, realPath))) {
+  if (!realRoots.some((root) => pathWithin(root, realPath)) && !isTrustedRecordedSessionFile(realPath, trustedFiles, trustedFileRoot)) {
     return { path: filePath, lines: [], truncated: false, error: `Refusing to read ${label} transcript path outside trusted roots: ${filePath}` };
   }
   return readTextTail(resolvedPath, maxLines);
@@ -118,45 +127,84 @@ function stringifyJsonPreview(value, maxLength = 240) {
     raw = JSON.stringify(value);
   return raw.length > maxLength ? `${raw.slice(0, maxLength)}…` : raw;
 }
-function contentText(content) {
+function sessionMessageParts(record) {
+  if (!record || typeof record !== "object")
+    return [];
+  const outer = record;
+  const message = outer.message && typeof outer.message === "object" ? outer.message : outer;
+  const role = typeof message.role === "string" ? message.role : undefined;
+  if (!role)
+    return [];
+  const content = message.content;
   if (typeof content === "string")
-    return content;
+    return content.trim() ? [{ role, kind: "text", text: content }] : [];
   if (!Array.isArray(content))
-    return "";
-  return content.map((part) => {
+    return [];
+  const parts = [];
+  for (const part of content) {
     if (!part || typeof part !== "object")
-      return "";
+      continue;
     const entry = part;
-    if (typeof entry.text === "string")
-      return entry.text;
+    if (typeof entry.text === "string") {
+      if (entry.text.trim())
+        parts.push({ role, kind: "text", text: entry.text });
+      continue;
+    }
     if (entry.type === "toolCall" || entry.type === "tool_call") {
       const name = typeof entry.name === "string" ? entry.name : typeof entry.toolName === "string" ? entry.toolName : "tool";
-      return `[tool: ${name}${entry.args === undefined ? "" : ` ${stringifyJsonPreview(entry.args)}`}]`;
+      parts.push({ role, kind: "toolCall", name, text: `[tool: ${name}${entry.args === undefined ? "" : ` ${stringifyJsonPreview(entry.args)}`}]` });
+      continue;
     }
     if (entry.type === "toolResult" || entry.type === "tool_result") {
-      return `[tool result${entry.result === undefined ? "" : `: ${stringifyJsonPreview(entry.result)}`}]`;
+      const name = typeof entry.name === "string" ? entry.name : typeof entry.toolName === "string" ? entry.toolName : undefined;
+      parts.push({ role, kind: "toolResult", ...name ? { name } : {}, ...entry.isError === true ? { isError: true } : {}, text: `[tool result${entry.result === undefined ? "" : `: ${stringifyJsonPreview(entry.result)}`}]` });
+      continue;
     }
-    if (entry.content !== undefined)
-      return stringifyJsonPreview(entry.content);
-    return "";
-  }).filter(Boolean).join(`
-`);
+    if (entry.content !== undefined) {
+      const preview = stringifyJsonPreview(entry.content);
+      if (preview.trim())
+        parts.push({ role, kind: "text", text: preview });
+    }
+  }
+  return parts;
 }
 function sessionMessageLine(record) {
-  if (!record || typeof record !== "object")
+  const parts = sessionMessageParts(record);
+  if (parts.length === 0)
     return;
-  const outer = record;
-  const message = outer.message && typeof outer.message === "object" ? outer.message : outer;
-  const role = typeof message.role === "string" ? message.role : undefined;
-  if (!role)
-    return;
-  const text = contentText(message.content).trim();
+  const text = parts.map((part) => part.text).join(`
+`).trim();
   if (!text)
     return;
-  return `${role}: ${text}`;
+  return `${parts[0].role}: ${text}`;
 }
-function readSessionTranscriptTail(sessionFile, maxLines, trustedRoots) {
-  const tail = readContainedTextTail(sessionFile, Math.max(maxLines * 4, maxLines), trustedRoots, "session");
+export function readSessionMessagesTail(sessionFile, maxMessages, trustedRoots, trustedFiles = [], trustedFileRoot) {
+  const tail = readContainedTextTail(sessionFile, Math.max(maxMessages * 4, maxMessages), trustedRoots, "session", trustedFiles, trustedFileRoot);
+  const warnings = [];
+  if (tail.error)
+    warnings.push(`Session read failed for ${sessionFile}: ${tail.error}`);
+  const parsedMessages = [];
+  let malformed = 0;
+  let recordIndex = 0;
+  for (const line of tail.lines) {
+    if (!line.trim())
+      continue;
+    try {
+      const parsed = JSON.parse(line);
+      for (const part of sessionMessageParts(parsed))
+        parsedMessages.push({ ...part, recordIndex });
+    } catch {
+      malformed++;
+    }
+    recordIndex++;
+  }
+  if (malformed > 0)
+    warnings.push(`Skipped ${malformed} malformed session tail line${malformed === 1 ? "" : "s"}.`);
+  const messages = parsedMessages.slice(-maxMessages);
+  return { messages, warnings, truncated: tail.truncated || parsedMessages.length > messages.length };
+}
+function readSessionTranscriptTail(sessionFile, maxLines, trustedRoots, trustedFiles = [], trustedFileRoot) {
+  const tail = readContainedTextTail(sessionFile, Math.max(maxLines * 4, maxLines), trustedRoots, "session", trustedFiles, trustedFileRoot);
   const warnings = [];
   if (tail.error)
     warnings.push(`Session read failed for ${sessionFile}: ${tail.error}`);
@@ -169,7 +217,7 @@ function readSessionTranscriptTail(sessionFile, maxLines, trustedRoots) {
       const parsed = JSON.parse(line);
       const messageLine = sessionMessageLine(parsed);
       if (messageLine)
-        lines.push(messageLine);
+        lines.push(...messageLine.split(/\r?\n/));
     } catch {
       malformed++;
     }
@@ -196,8 +244,9 @@ function formatActivityFacts(input) {
   return activity || facts.length ? [activity, ...facts].filter(Boolean).join(" | ") : undefined;
 }
 function foregroundModeName(control) {
-  if (control.mode === "single" && control.currentAgent)
-    return control.currentAgent;
+  const currentDisplayName = control.sessionName?.trim() || control.currentAgent;
+  if (control.mode === "single" && currentDisplayName)
+    return currentDisplayName;
   return control.mode;
 }
 function formatForegroundFleetLines(controls) {
@@ -216,7 +265,8 @@ function formatForegroundFleetLines(controls) {
       toolCount: control.toolCount,
       ...control.tokens !== undefined ? { tokens: { total: control.tokens } } : {}
     });
-    const current = control.currentAgent ? ` | ${control.currentAgent}${control.currentIndex !== undefined ? ` #${control.currentIndex}` : ""}` : "";
+    const currentDisplayName = control.sessionName?.trim() || control.currentAgent;
+    const current = currentDisplayName ? ` | ${currentDisplayName}${control.currentIndex !== undefined ? ` #${control.currentIndex}` : ""}` : "";
     lines.push(`- ${control.runId} | running | ${foregroundModeName(control)}${current}${activity ? ` | ${activity}` : ""}`);
     lines.push(`  status: subagent({ action: "status", id: "${control.runId}" })`);
     lines.push("  transcript: live in the expanded foreground result; persisted session transcript appears after completion when sessions are enabled.");
@@ -224,6 +274,20 @@ function formatForegroundFleetLines(controls) {
   }
   return lines;
 }
+function formatDetachedForegroundFleetLines(runs) {
+  if (runs.length === 0)
+    return [];
+  const lines = ["Detached foreground runs:"];
+  const ordered = [...runs].sort((left, right) => right.updatedAt - left.updatedAt);
+  for (const run of ordered) {
+    const detachedChildren = run.children.filter((child) => child.status === "detached");
+    const childSummary = detachedChildren.map((child) => `${fleetChildDisplayName(child)} #${child.index}`).join(", ");
+    lines.push(`- ${run.runId} | detached | ${run.mode}${childSummary ? ` | ${childSummary}` : ""}`);
+    lines.push(`  status: subagent({ action: "status", id: "${run.runId}" })`);
+    lines.push(`  recovery: reply to the supervisor request first, then wait with bg_wait({ id: "${run.runId}" }); do not resume or launch a replacement while any child remains detached.`);
+  }
+  return lines;
+}
 function formatAsyncFleetLines(runs) {
   if (runs.length === 0)
     return [];
@@ -233,15 +297,17 @@ function formatAsyncFleetLines(runs) {
     const activity = formatActivityFacts(run);
     const cwd = run.cwd ? shortenPath(run.cwd) : shortenPath(run.asyncDir);
     const pending = run.pendingAppends ? ` | ${run.pendingAppends} pending append${run.pendingAppends === 1 ? "" : "s"}` : "";
-    lines.push(`- ${run.id} | ${run.state}${activity ? ` | ${activity}` : ""} | ${run.mode} | ${progress}${pending} | ${cwd}`);
+    const runContext = contextModeLabel(run.context);
+    lines.push(`- ${run.id} | ${run.state}${activity ? ` | ${activity}` : ""} | ${run.mode}${runContext ? ` ${runContext}` : ""} | ${progress}${pending} | ${cwd}`);
     lines.push(`  status: subagent({ action: "status", id: "${run.id}" })`);
     lines.push(`  transcript: subagent({ action: "status", id: "${run.id}", view: "transcript" })`);
     for (const step of run.steps) {
-      const display = step.label ? `${step.label} (${step.agent})` : step.agent;
+      const display = fleetStepDisplayName(step);
+      const stepContext = contextModeLabel(step.context);
       const phase = step.phase ? `[${step.phase}] ` : "";
       const stepActivity = formatActivityFacts(step);
       const modelThinking = formatModelThinking(step.model, step.thinking);
-      const parts = [`${step.index}. ${phase}${display}`, step.status, stepActivity, modelThinking].filter(Boolean);
+      const parts = [`${step.index}. ${phase}${display}${stepContext ? ` ${stepContext}` : ""}`, step.status, stepActivity, modelThinking].filter(Boolean);
       lines.push(`  ${parts.join(" | ")}`);
       const output = path.join(run.asyncDir, `output-${step.index}.log`);
       if (fs.existsSync(output))
@@ -278,10 +344,10 @@ export function inspectSubagentFleet(_params, deps = {}) {
   }
   let asyncRuns;
   try {
-    asyncRuns = listAsyncRuns(deps.asyncDirRoot ?? ASYNC_DIR, {
+    asyncRuns = listAsyncRuns(deps.asyncDirRoot ?? DIRS.async, {
       states: ["queued", "running"],
       sessionId: deps.state?.currentSessionId ?? undefined,
-      resultsDir: deps.resultsDir ?? RESULTS_DIR,
+      resultsDir: deps.resultsDir ?? DIRS.results,
       kill: deps.kill,
       now: deps.now
     });
@@ -290,17 +356,22 @@ export function inspectSubagentFleet(_params, deps = {}) {
     return { content: [{ type: "text", text: message }], isError: true, details: { mode: "management", results: [] } };
   }
   const foregroundControls = deps.state ? [...deps.state.foregroundControls.values()] : [];
-  const total = foregroundControls.length + asyncRuns.length;
+  const activeForegroundIds = new Set(foregroundControls.map((control) => control.runId));
+  const detachedForegroundRuns = deps.state?.foregroundRuns ? [...deps.state.foregroundRuns.values()].filter((run) => run.sessionId === deps.state?.currentSessionId && !activeForegroundIds.has(run.runId) && run.children.some((child) => child.status === "detached")) : [];
+  const total = foregroundControls.length + detachedForegroundRuns.length + asyncRuns.length;
   if (total === 0) {
     return {
       content: [{ type: "text", text: 'No active subagent fleet. Background runs that already finished are available through completion notifications or subagent({ action: "status", id: "..." }).' }],
       details: { mode: "management", results: [] }
     };
   }
-  const lines = [`Subagent fleet: ${total} active`, ""];
+  const lines = [`Subagent fleet: ${total} tracked`, ""];
   const foregroundLines = formatForegroundFleetLines(foregroundControls);
   if (foregroundLines.length)
     lines.push(...foregroundLines, "");
+  const detachedForegroundLines = formatDetachedForegroundFleetLines(detachedForegroundRuns);
+  if (detachedForegroundLines.length)
+    lines.push(...detachedForegroundLines, "");
   const asyncLines = formatAsyncFleetLines(asyncRuns);
   if (asyncLines.length)
     lines.push(...asyncLines, "");
@@ -331,15 +402,16 @@ function selectTranscriptStep(status, options) {
     }
   }
   const step = selectedIndex !== undefined ? steps[selectedIndex] : undefined;
-  const hint = options.index === undefined && steps.length > 1 ? `Tip: pass index to inspect a specific child transcript (${steps.map((candidate, index) => `${index}=${candidate.agent}`).join(", ")}).` : undefined;
+  const hint = options.index === undefined && steps.length > 1 ? `Tip: pass index to inspect a specific child transcript (${steps.map((candidate, index) => `${index}=${fleetChildDisplayName(candidate)}`).join(", ")}).` : undefined;
   return { index: selectedIndex, step, hint };
 }
 function stepStateLine(mode, index, step) {
   if (index === undefined || !step)
     return;
   const modelThinking = formatModelThinking(step.model, step.thinking);
+  const context = contextModeLabel(step.context);
   const parts = [
-    `${mode === "parallel" ? "Agent" : "Step"}: ${index} (${step.agent})`,
+    `${mode === "parallel" ? "Agent" : "Step"}: ${index} (${fleetChildDisplayName(step)})${context ? ` ${context}` : ""}`,
     step.status,
     formatActivityFacts(step),
     modelThinking,
@@ -365,6 +437,10 @@ function appendKnownArtifacts(lines, input) {
   for (const artifact of artifacts)
     lines.push(`  ${artifact}`);
 }
+function safeTranscriptLines(lines) {
+  return lines.map((line) => safeTerminalText(line)).join(`
+`);
+}
 function appendTranscriptBody(lines, sourceLabel, sourceLines, truncated) {
   lines.push(`${sourceLabel}${truncated ? " (tail truncated)" : ""}:`);
   if (sourceLines.length === 0) {
@@ -383,14 +459,15 @@ export function formatAsyncRunTranscript(status, asyncDir, options = {}) {
   const outputPaths = selected.index !== undefined ? uniqueStrings([stepOutputPath, runOutputPath && stepOutputPath && path.resolve(runOutputPath) === path.resolve(stepOutputPath) ? runOutputPath : undefined]) : uniqueStrings([runOutputPath]);
   const sessionFile = selected.index !== undefined ? selected.step?.sessionFile : status.sessionFile;
   const eventsPath = path.join(asyncDir, "events.jsonl");
+  const context = contextModeLabel(status.context ?? summarizeContextModes((status.steps ?? []).map((step) => step.context)));
   const lines = [
     `Run: ${status.runId}`,
     `State: ${status.state}`,
-    `Mode: ${status.mode}`,
+    `Mode: ${status.mode}${context ? ` ${context}` : ""}`,
     stepStateLine(status.mode, selected.index, selected.step),
     selected.hint
   ].filter((line) => Boolean(line));
-  appendKnownArtifacts(lines, { outputPaths, sessionFile, eventsPath: fs.existsSync(eventsPath) ? eventsPath : undefined, logPath: fs.existsSync(logPath) ? logPath : undefined });
+  appendKnownArtifacts(lines, { outputPaths: outputPaths.filter((outputPath) => fs.existsSync(outputPath)), sessionFile, eventsPath: fs.existsSync(eventsPath) ? eventsPath : undefined, logPath: fs.existsSync(logPath) ? logPath : undefined });
   const warnings = [];
   let transcriptLines = [];
   let transcriptSource = "Transcript tail";
@@ -411,7 +488,7 @@ export function formatAsyncRunTranscript(status, asyncDir, options = {}) {
     transcriptSource = "Recent output from status.json";
   }
   if (transcriptLines.length === 0 && sessionFile) {
-    const sessionTail = readSessionTranscriptTail(sessionFile, lineLimit, options.sessionRoots ?? []);
+    const sessionTail = readSessionTranscriptTail(sessionFile, lineLimit, options.sessionRoots ?? [], options.trustedSessionFiles, options.trustedSessionFileRoot);
     transcriptLines = sessionTail.lines;
     warnings.push(...sessionTail.warnings);
     if (transcriptLines.length > 0)
@@ -423,8 +500,7 @@ export function formatAsyncRunTranscript(status, asyncDir, options = {}) {
       lines.push(`  ${warning}`);
   }
   appendTranscriptBody(lines, transcriptSource, transcriptLines, truncated);
-  return lines.join(`
-`);
+  return safeTranscriptLines(lines);
 }
 export function formatNestedRunTranscript(run, options = {}) {
   if (run.asyncDir) {
@@ -437,28 +513,26 @@ export function formatNestedRunTranscript(run, options = {}) {
     `Nested run: ${run.id}`,
     `State: ${run.state}`,
     run.mode ? `Mode: ${run.mode}` : undefined,
-    run.agent ? `Agent: ${run.agent}` : run.agents?.length ? `Agents: ${run.agents.join(", ")}` : undefined
+    run.sessionName?.trim() ? `Agent: ${run.sessionName.trim()}` : run.agent ? `Agent: ${run.agent}` : run.agents?.length ? `Agents: ${run.agents.join(", ")}` : undefined
   ].filter((line) => Boolean(line));
   appendKnownArtifacts(lines, { outputPaths: [], sessionFile: run.sessionFile });
   if (!run.sessionFile) {
     appendTranscriptBody(lines, "Transcript tail", [], false);
-    return lines.join(`
-`);
+    return safeTranscriptLines(lines);
   }
-  const sessionTail = readSessionTranscriptTail(run.sessionFile, lineLimit, options.sessionRoots ?? []);
+  const sessionTail = readSessionTranscriptTail(run.sessionFile, lineLimit, options.sessionRoots ?? [], options.trustedSessionFiles, options.trustedSessionFileRoot);
   if (sessionTail.warnings.length) {
     lines.push("Warnings:");
     for (const warning of sessionTail.warnings)
       lines.push(`  ${warning}`);
   }
   appendTranscriptBody(lines, `Session transcript tail from ${run.sessionFile}`, sessionTail.lines, false);
-  return lines.join(`
-`);
+  return safeTranscriptLines(lines);
 }
 export function formatAsyncResultTranscript(data, resultPath, options = {}) {
   const lineLimit = transcriptLineLimit(options.lines);
   const runId = data.runId ?? data.id ?? path.basename(resultPath, ".json");
-  const children = Array.isArray(data.results) ? data.results : data.agent ? [{ agent: data.agent, output: data.output, summary: data.summary, sessionFile: data.sessionFile, state: data.state, success: data.success, exitCode: data.exitCode }] : [];
+  const children = Array.isArray(data.results) ? data.results : data.agent ? [{ agent: data.agent, sessionName: undefined, output: data.output, summary: data.summary, sessionFile: data.sessionFile, state: data.state, success: data.success, exitCode: data.exitCode }] : [];
   let index = options.index;
   if (index !== undefined && !Number.isInteger(index))
     throw new Error("Transcript index must be an integer.");
@@ -473,11 +547,10 @@ export function formatAsyncResultTranscript(data, resultPath, options = {}) {
   const lines = [
     `Run: ${runId}`,
     `State: ${data.state ?? (data.success ? "complete" : "failed")}`,
-    index !== undefined && child ? `Child: ${index} (${child.agent ?? "subagent"})` : undefined,
-    index === undefined && children.length > 1 ? `Tip: pass index to inspect a specific child transcript (${children.map((candidate, childIndex) => `${childIndex}=${candidate.agent ?? "subagent"}`).join(", ")}).` : undefined
+    index !== undefined && child ? `Child: ${index} (${fleetChildDisplayName(child)})` : undefined,
+    index === undefined && children.length > 1 ? `Tip: pass index to inspect a specific child transcript (${children.map((candidate, childIndex) => `${childIndex}=${fleetChildDisplayName(candidate)}`).join(", ")}).` : undefined
   ].filter((line) => Boolean(line));
   appendKnownArtifacts(lines, { outputPaths: [], sessionFile, resultPath });
   appendTranscriptBody(lines, "Result transcript tail", transcriptLines.filter((line) => line.trim()), output.split(/\r?\n/).length > lineLimit);
-  return lines.join(`
-`);
+  return safeTranscriptLines(lines);
 }

package/extensions/dm-subagents/src/runs/background/index-segment.js

@@ -0,0 +1,38 @@
+import { createHash } from "node:crypto";
+export const MAX_INDEX_SEGMENT_BYTES = 255;
+const HASHED_INDEX_SEGMENT_PREFIX = "~sha256-";
+const WINDOWS_RESERVED_NAME = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i;
+function hashedSegment(value) {
+  return `${HASHED_INDEX_SEGMENT_PREFIX}${createHash("sha256").update(value).digest("hex")}`;
+}
+function isPortableSegment(value) {
+  return value.length > 0 && value !== "." && value !== ".." && !value.endsWith(".") && !WINDOWS_RESERVED_NAME.test(value) && !/%5C/i.test(value) && !/\.[A-Za-z][A-Za-z0-9]{0,7}$/.test(value);
+}
+export function encodeIndexSegment(value, maxBytes = MAX_INDEX_SEGMENT_BYTES) {
+  let encoded;
+  try {
+    encoded = encodeURIComponent(value);
+  } catch {
+    return hashedSegment(value);
+  }
+  if (Buffer.byteLength(encoded, "utf-8") <= maxBytes && isPortableSegment(encoded))
+    return encoded;
+  return hashedSegment(value);
+}
+function historicallyReadableSegment(value, maxBytes) {
+  try {
+    const encoded = encodeURIComponent(value);
+    if (encoded.length === 0 || encoded === "." || encoded === ".." || encoded.endsWith(".") || WINDOWS_RESERVED_NAME.test(encoded))
+      return;
+    if (Buffer.byteLength(encoded, "utf-8") > maxBytes)
+      return;
+    return encoded;
+  } catch {
+    return;
+  }
+}
+export function indexSegmentAliases(value, maxBytes = MAX_INDEX_SEGMENT_BYTES) {
+  const current = encodeIndexSegment(value, maxBytes);
+  const historical = historicallyReadableSegment(value, maxBytes);
+  return historical && historical !== current ? [current, historical] : [current];
+}