@monster-orange/den 0.4.11 → 0.4.12

package/src/ui/server/public/agents-section.js

@@ -138,7 +138,7 @@ function rowHtml(r) {
     ? ` <span class="tbl-muted">· ${esc(r.model)}</span>`
     : "";
   return `<tr class="agent" data-agent="${esc(r.agent)}" data-state="${esc(r.state)}">
-              <th scope="row"><span class="repo-name">${esc(r.agent)}</span>${persona}</th>
+              <th scope="row">${r.displayName ? `<span class="repo-name">${esc(r.displayName)}</span> <span class="tbl-muted">${esc(r.agent)}</span>` : `<span class="repo-name">${esc(r.agent)}</span>`}${persona}</th>
               <td class="tbl-mono">${esc(r.runtime ?? "—")}${model}</td>
               <td>${stateCell(r.state)}</td>
               <td class="tbl-mono tbl-muted agent-cwd" title="${esc(r.cwd ?? "")}">${esc(r.cwd ?? "—")}</td>

package/src/ui/server/public/agents.html

@@ -50,13 +50,26 @@
         flex-direction: column;
         overflow: hidden;
       }
+      /* AG-4b: the main area is a column that fills the window between
+         the top bar and the runs dock (the body is the viewport's height,
+         the shell's column puts the dock at its foot); the list and the
+         panes take what is left, 14px above the dock. No 100vh guess. */
+      html body.den-has-shell {
+        height: 100%;
+        min-height: 0;
+      }
       html body.den-has-shell > #den-content {
         overflow: auto;
         min-width: 0;
-        padding: 20px 24px 32px 24px;
+        min-height: 0;
+        padding: 20px 24px 14px 24px;
         font: 14px/1.45 var(--sans);
         color: var(--text);
-        display: block;
+        display: flex;
+        flex-direction: column;
+      }
+      #den-content > .ph {
+        flex: none;
       }
       #den-content :focus-visible {
         outline: 2px solid var(--accent);
@@ -94,9 +107,38 @@
       .agx {
         display: grid;
         grid-template-columns: 300px minmax(0, 1fr);
+        grid-template-rows: minmax(0, 1fr);
         gap: 14px;
-        min-height: 420px;
-        height: calc(100vh - 300px);
+        flex: 1;
+        min-height: 0;
+      }
+      /* The layout switch (AG-4b), the prototype's .seg. */
+      .seg {
+        display: inline-flex;
+        border: 1px solid var(--border);
+        border-radius: var(--radius-button);
+        overflow: hidden;
+        flex-wrap: wrap;
+      }
+      .seg button {
+        background: none;
+        border: 0;
+        padding: 6px 12px;
+        cursor: pointer;
+        color: var(--muted);
+        font: inherit;
+      }
+      .seg button[aria-pressed="true"] {
+        background: color-mix(in srgb, var(--accent) 16%, transparent);
+        color: var(--text);
+        font-weight: 500;
+      }
+      .agl .aghint {
+        padding: 10px 12px;
+        font-size: 12px;
+        color: var(--faint);
+        border-top: 1px solid var(--border);
+        margin-top: 6px;
       }
       .agl {
         border: 1px solid var(--border);
@@ -245,6 +287,98 @@
         grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
         grid-auto-rows: minmax(0, 1fr);
       }
+      .agp.tabs {
+        grid-template-columns: minmax(0, 1fr);
+        grid-template-rows: auto minmax(0, 1fr);
+        gap: 0;
+      }
+      .agp > .pane[hidden] {
+        display: none;
+      }
+      .agp.tabs > .pane {
+        border-top-left-radius: 0;
+      }
+      /* The tab strip (the prototype's .agtabs): name, persona · workspace. */
+      .agtabs {
+        display: flex;
+        gap: 2px;
+        border-bottom: 1px solid var(--border);
+        overflow-x: auto;
+        min-width: 0;
+      }
+      .agtab-w {
+        position: relative;
+        display: inline-flex;
+        flex: none;
+        max-width: 280px;
+      }
+      .agtab {
+        display: inline-flex;
+        align-items: center;
+        gap: 6px;
+        min-width: 0;
+        border: 1px solid transparent;
+        border-bottom: 0;
+        background: none;
+        padding: 6px 28px 6px 10px;
+        border-radius: var(--radius-button) var(--radius-button) 0 0;
+        cursor: pointer;
+        color: var(--muted);
+        white-space: nowrap;
+        font: 13px var(--sans);
+      }
+      .agtab[hidden] {
+        display: none;
+      }
+      .agtab[aria-selected="true"] {
+        background: var(--surface);
+        border-color: var(--border);
+        color: var(--text);
+        margin-bottom: -1px;
+      }
+      .agtab .den-dot {
+        margin: 0;
+      }
+      .agtab .tn {
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+      .agtab .tm {
+        color: var(--faint);
+        font-size: 11px;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+      .agtab-x {
+        position: absolute;
+        top: 0;
+        bottom: 0;
+        right: 4px;
+        display: flex;
+        align-items: center;
+        padding: 0 4px;
+        border: 0;
+        background: none;
+        cursor: pointer;
+        font: 13px var(--sans);
+        color: var(--faint);
+      }
+      .agtab-x:hover {
+        color: var(--bad);
+      }
+      .agtab-in {
+        font: 13px var(--sans);
+        width: 200px;
+        margin: 3px 28px 3px 6px;
+        padding: 2px 6px;
+        border: 1px solid var(--accent);
+        border-radius: var(--radius-button);
+        background: var(--bg);
+        color: var(--text);
+      }
+      .den-sr[hidden] {
+        display: none;
+      }
       .pane {
         display: grid;
         grid-template-rows: auto minmax(0, 1fr);
@@ -292,6 +426,9 @@
         gap: 6px;
         flex: none;
       }
+      .pane .bar2 .x [hidden] {
+        display: none;
+      }
       /* The body: mono 12px/1.5 (xterm draws inside it). */
       .pane .term {
         min-height: 0;
@@ -301,6 +438,15 @@
         color: var(--text);
         overflow: hidden;
       }
+      .pane .term {
+        display: grid;
+        grid-template: minmax(0, 1fr) / minmax(0, 1fr);
+      }
+      .pane .term .tbox {
+        min-height: 0;
+        min-width: 0;
+        overflow: hidden;
+      }
       .pane .term .xterm {
         height: 100%;
       }
@@ -430,7 +576,8 @@
       @media (max-width: 860px) {
         .agx {
           grid-template-columns: minmax(0, 1fr);
-          height: auto;
+          grid-template-rows: none;
+          flex: none;
         }
         .ph .act {
           flex-wrap: wrap;
@@ -465,6 +612,32 @@
           </div>
         </div>
         <div class="act">
+          <div class="seg" role="group" aria-label="Layout" data-layouts>
+            <button
+              type="button"
+              data-layout="focus"
+              aria-pressed="true"
+              aria-keyshortcuts="Control+Shift+1"
+            >
+              Focus
+            </button>
+            <button
+              type="button"
+              data-layout="tabs"
+              aria-pressed="false"
+              aria-keyshortcuts="Control+Shift+2"
+            >
+              Tabs
+            </button>
+            <button
+              type="button"
+              data-layout="tile"
+              aria-pressed="false"
+              aria-keyshortcuts="Control+Shift+3"
+            >
+              Tile
+            </button>
+          </div>
           <button type="button" class="den-btn" id="ag-clear" hidden>
             Clear stopped
           </button>

package/src/ui/server/public/header.js

@@ -877,6 +877,8 @@ function followScopeInUrl(value) {
 async function _switchScope(value, focus, inView) {
   if (value !== "all" && value !== focus && !(await _setFocus(value))) return;
   if (inView) {
+    // A ?ws= page shows the pick after the reload, not its old ?ws=.
+    followScopeInUrl(value);
     location.reload();
     return;
   }

package/src/ui/server/public/i18n/es.js

@@ -327,6 +327,7 @@
     "set.language": "Idioma",
     "set.appearance.org-theme": "Tema predeterminado de la org",
     "set.editor": "IDE predeterminado",
+    "set.editor.open": "Abrir enlaces de archivo en",
     "set.editor_overrides": "IDE por lenguaje",
     "set.terminal": "Terminal predeterminada",
     "set.shell.pages": "Páginas",
@@ -341,6 +342,7 @@
     "set.graph.panelWidth": "Panel de detalles",
     "set.workspace.editor": "IDE de este espacio de trabajo",
     "set.agents.runtimes": "Runtimes",
+    "set.agents.layout": "Disposición de la pestaña Agentes",
     "set.cli.local_dev": "Entorno local",
     "set.cli.cli_tabs": "Pestañas de terminal",
     "set.cli.log_window_lines": "Líneas del panel de registros",
@@ -475,6 +477,23 @@
     "ag.palStart": "Iniciar agente…",
     "ag.cap":
       "Hasta 4 paneles: se cerró el de {id} para hacer sitio (sigue en marcha)",
+    "ag.layout": "Disposición",
+    "ag.l.focus": "Enfoque",
+    "ag.l.tabs": "Pestañas",
+    "ag.l.tile": "Mosaico",
+    "ag.l.tip": "{name} ({key})",
+    "ag.hint.keys":
+      "⌃⇧1 / ⌃⇧2 / ⌃⇧3 cambian la disposición. ⌘ y clic (Ctrl y clic) abre un enlace o una ruta.",
+    "ag.pal.layout": "Disposición: {name}",
+    "ag.copied": "Copiado",
+    "ag.tabs": "Sesiones abiertas",
+    "ag.hint.focus":
+      "Un clic muestra una sesión. Mayús o ⌘ y clic la añade al lado.",
+    "ag.hint.tabs":
+      "Un clic abre una sesión en una pestaña. Doble clic en una pestaña para cambiarle el nombre.",
+    "ag.hint.tile": "Un clic añade una sesión al mosaico, hasta 4.",
+    "ag.renameTip": "Doble clic para cambiar el nombre",
+    "ag.renameName": "Cambiar el nombre de {id}",
     "ag.rt.ready": "Inicia {name} {version} desde",
     "ag.rt.readyNoVer": "Inicia {name} desde",
     "ag.rt.notFound": "No se encontró {name}.",

package/src/ui/server/public/i18n/ja.js

@@ -316,6 +316,7 @@
     "set.language": "言語",
     "set.appearance.org-theme": "組織の既定テーマ",
     "set.editor": "既定の IDE",
+    "set.editor.open": "ファイルリンクを開くエディター",
     "set.editor_overrides": "言語ごとの IDE",
     "set.terminal": "既定のターミナル",
     "set.shell.pages": "ページ",
@@ -330,6 +331,7 @@
     "set.graph.panelWidth": "詳細パネル",
     "set.workspace.editor": "このワークスペースの IDE",
     "set.agents.runtimes": "ランタイム",
+    "set.agents.layout": "エージェントタブのレイアウト",
     "set.cli.local_dev": "ローカル環境",
     "set.cli.cli_tabs": "ターミナルのタブ",
     "set.cli.log_window_lines": "ログ欄の行数",
@@ -455,6 +457,23 @@
     "ag.palStart": "エージェントを開始…",
     "ag.cap":
       "ペインは最大 4 つです。{id} のペインを閉じました（実行は続きます）",
+    "ag.layout": "レイアウト",
+    "ag.l.focus": "フォーカス",
+    "ag.l.tabs": "タブ",
+    "ag.l.tile": "タイル",
+    "ag.l.tip": "{name}（{key}）",
+    "ag.hint.keys":
+      "⌃⇧1 / ⌃⇧2 / ⌃⇧3 でレイアウトを切り替えます。⌘ クリック（Ctrl クリック）でリンクやパスを開きます。",
+    "ag.pal.layout": "レイアウト: {name}",
+    "ag.copied": "コピーしました",
+    "ag.tabs": "開いているセッション",
+    "ag.hint.focus":
+      "クリックで 1 つのセッションを表示します。Shift か ⌘ を押しながらクリックすると横に追加します。",
+    "ag.hint.tabs":
+      "クリックでセッションをタブで開きます。タブをダブルクリックすると名前を変えられます。",
+    "ag.hint.tile": "クリックでセッションをタイルに追加します（最大 4）。",
+    "ag.renameTip": "ダブルクリックで名前を変更",
+    "ag.renameName": "{id} の名前を変更",
     "ag.rt.ready": "{name} {version} を起動:",
     "ag.rt.readyNoVer": "{name} を起動:",
     "ag.rt.notFound": "{name} が見つかりません。",

package/src/ui/server/public/settings-registry.js

@@ -628,6 +628,33 @@ export const DEN_SETTINGS = [
     read: (ctx) => effective(ctx.data.editors, ctx.data.editor),
     write: (v, ctx) => ctx.post({ editor: v || null }),
   },
+  {
+    id: "editor.open",
+    category: "editor",
+    label: "Open file links in",
+    description:
+      "⌘-click (Ctrl-click on Windows and Linux) on a file path in an agent's pane opens it here, at the line. None copies the path instead.",
+    keywords: [
+      "editor",
+      "link",
+      "path",
+      "file",
+      "agents",
+      "vscode",
+      "cursor",
+      "zed",
+    ],
+    scope: "user",
+    control: seg([
+      { value: "vscode", label: "VS Code" },
+      { value: "cursor", label: "Cursor" },
+      { value: "zed", label: "Zed" },
+      { value: "none", label: "None (copy)" },
+    ]),
+    keys: ["editor_open"],
+    read: (ctx) => ctx.data.editor_open ?? "none",
+    write: (v, ctx) => ctx.post({ editor_open: v }),
+  },
   {
     id: "editor_overrides",
     category: "editor",
@@ -813,6 +840,23 @@ export const DEN_SETTINGS = [
   },
 
   // ── Agents ─────────────────────────────────────────────────────────────
+  {
+    id: "agents.layout",
+    category: "agents",
+    label: "Agents tab layout",
+    description:
+      "Focus shows one agent, Tabs shows one with a tab for each, Tile shows up to four in a grid. The Agents tab's switch, ⌃⇧1, ⌃⇧2, ⌃⇧3 and ⌘K set it too.",
+    keywords: ["agents", "layout", "focus", "tabs", "tile", "grid", "panes"],
+    scope: "user",
+    control: seg([
+      { value: "focus", label: "Focus" },
+      { value: "tabs", label: "Tabs" },
+      { value: "tile", label: "Tile" },
+    ]),
+    keys: ["agents_layout"],
+    read: (ctx) => ctx.data.agents_layout ?? "focus",
+    write: (v, ctx) => ctx.post({ agents_layout: v }),
+  },
   {
     id: "agents.runtimes",
     category: "agents",

package/src/ui/server/public/shell.js

@@ -438,6 +438,7 @@
     "set.language": "Language",
     "set.appearance.org-theme": "Org default theme",
     "set.editor": "Default IDE",
+    "set.editor.open": "Open file links in",
     "set.editor_overrides": "Per-language IDE",
     "set.terminal": "Default terminal",
     "set.shell.pages": "Pages",
@@ -452,6 +453,7 @@
     "set.graph.panelWidth": "Details panel",
     "set.workspace.editor": "IDE for this workspace",
     "set.agents.runtimes": "Runtimes",
+    "set.agents.layout": "Agents tab layout",
     "set.cli.local_dev": "Local environment",
     "set.cli.cli_tabs": "Terminal tabs",
     "set.cli.log_window_lines": "Log pane lines",
@@ -585,6 +587,24 @@
     "ag.pal": "Agents › {ws} / {name}",
     "ag.palStart": "Start agent…",
     "ag.cap": "Up to 4 panes: {id}'s closed to make room (it keeps running)",
+    // AG-4b: the Agents tab's layouts and named tabs.
+    "ag.layout": "Layout",
+    "ag.l.focus": "Focus",
+    "ag.l.tabs": "Tabs",
+    "ag.l.tile": "Tile",
+    "ag.l.tip": "{name} ({key})",
+    "ag.hint.keys":
+      "⌃⇧1 / ⌃⇧2 / ⌃⇧3 switch layout. ⌘-click (Ctrl-click) opens a link or path.",
+    "ag.pal.layout": "Layout: {name}",
+    "ag.copied": "Copied",
+    "ag.tabs": "Open sessions",
+    "ag.hint.focus":
+      "Click shows one session. Shift- or ⌘-click adds it alongside.",
+    "ag.hint.tabs":
+      "Click opens a session as a tab. Double-click a tab to rename it.",
+    "ag.hint.tile": "Click adds a session as a tile, up to 4.",
+    "ag.renameTip": "Double-click to rename",
+    "ag.renameName": "Rename {id}",
     "ag.rt.ready": "Starts {name} {version} from",
     "ag.rt.readyNoVer": "Starts {name} from",
     "ag.rt.notFound": "{name} not found.",

package/src/ui/server/public/term-input.js

@@ -0,0 +1,129 @@
+/**
+ * The Agents tab's terminal input and links (AG-4b), pure helpers for
+ * agents-page.js (and its tests):
+ *
+ *   isWebUrl(uri)          only http: and https: open (an OSC 8 link's
+ *                          javascript:, data:, file: and the rest never)
+ *   linkModifier(e, mac)   the click that opens a link: ⌘ on a Mac, Ctrl
+ *                          elsewhere; a plain click still selects
+ *   findPaths(line)        file paths in a line of output: `src/foo.ts:42`,
+ *                          `./a/b.js:3:7`, `/abs/path`; never a URL
+ *   editorUrl(ed, abs, l)  an editor's URL for a path and line (vscode,
+ *                          cursor, zed); none: null (the path is copied)
+ *   softNewlineKey(e)      Shift+Enter, and no other modifier
+ *   layoutKeyIndex(e)      ⌃⇧1 / ⌃⇧2 / ⌃⇧3 (by the key's code: Shift+1 is
+ *                          "!" on a US keyboard): 0-2, else -1. ⌘1-9 and
+ *                          Ctrl+1-9 are the browser's (its tabs), never ours
+ */
+
+/** The editors a path link opens in, by URL scheme (Settings › editor.open). */
+export const EDITORS = ["vscode", "cursor", "zed", "none"];
+
+/** Whether `uri` is an http or https URL: the only links that open. */
+export function isWebUrl(uri) {
+  if (typeof uri !== "string" || !uri) return false;
+  let u;
+  try {
+    u = new URL(uri);
+  } catch {
+    return false;
+  }
+  return (u.protocol === "http:" || u.protocol === "https:") && !!u.host;
+}
+
+/** This browser is on a Mac (⌘ opens links there, Ctrl elsewhere). */
+export function isMac(nav = globalThis.navigator) {
+  const p = nav?.userAgentData?.platform || nav?.platform || "";
+  return /mac|iphone|ipad/i.test(p);
+}
+
+/** The click opens a link: ⌘-click on a Mac, Ctrl-click elsewhere. */
+export function linkModifier(e, mac = isMac()) {
+  if (!e) return false;
+  return mac ? !!e.metaKey : !!e.ctrlKey;
+}
+
+/**
+ * A path, then an optional :line and :column. It never starts right after
+ * a word character, a dot, a slash or a colon, so no part of a URL
+ * (https://host/a/b) and no part of a longer word is one.
+ */
+const PATH_RE =
+  /(?<![\w./~:@%+-])((?:\.{1,2}\/|\/)?[\w@+-][\w.@+-]*(?:\/[\w.@+-]+)*)(?::(\d+)(?::(\d+))?)?/g;
+const EXT_RE = /[^/.]\.[A-Za-z0-9]{1,12}$/;
+
+/**
+ * The file paths in `line`: { text, start, end, path, line?, col? }, start
+ * and end its columns in the line (end exclusive). A path has a "/" and
+ * either starts with /, ./ or ../, has an extension or a line; or it is a
+ * file name with an extension and a line (`foo.ts:12`). The server says
+ * which of them exist in the agent's workspace (only those are links).
+ */
+export function findPaths(line) {
+  const out = [];
+  if (typeof line !== "string" || !line) return out;
+  PATH_RE.lastIndex = 0;
+  for (let m; (m = PATH_RE.exec(line)); ) {
+    let p = m[1];
+    const ln = m[2] === undefined ? undefined : Number(m[2]);
+    const col = m[3] === undefined ? undefined : Number(m[3]);
+    let text = m[0];
+    if (ln === undefined) {
+      // A sentence's full stop is not the path's.
+      const trimmed = p.replace(/\.+$/, "");
+      text = trimmed;
+      p = trimmed;
+    }
+    if (!p) continue;
+    const slash = p.includes("/");
+    const rooted = /^(?:\/|\.{1,2}\/)/.test(p);
+    const ext = EXT_RE.test(p);
+    const ok = slash
+      ? rooted || ext || ln !== undefined
+        ? !/^\d+\/\d+$/.test(p)
+        : false
+      : ext && ln !== undefined;
+    if (!ok) continue;
+    out.push({
+      text,
+      start: m.index,
+      end: m.index + text.length,
+      path: p,
+      ...(ln !== undefined ? { line: ln } : {}),
+      ...(col !== undefined ? { col } : {}),
+    });
+  }
+  return out;
+}
+
+/**
+ * The URL that opens `abs` at `line` (and `col`) in `editor`, or null:
+ * none, an editor Den doesn't know, or a path that isn't absolute.
+ */
+export function editorUrl(editor, abs, line, col) {
+  if (!["vscode", "cursor", "zed"].includes(editor)) return null;
+  if (typeof abs !== "string" || !abs.startsWith("/")) return null;
+  const p = abs.split("/").map(encodeURIComponent).join("/");
+  const at = line ? `:${line}${col ? `:${col}` : ""}` : "";
+  return `${editor}://file${p}${at}`;
+}
+
+/** Shift+Enter, no other modifier: the soft newline. */
+export function softNewlineKey(e) {
+  return (
+    e?.type === "keydown" &&
+    e.key === "Enter" &&
+    e.shiftKey &&
+    !e.ctrlKey &&
+    !e.altKey &&
+    !e.metaKey &&
+    !e.isComposing
+  );
+}
+
+/** ⌃⇧1, ⌃⇧2, ⌃⇧3: the layouts' index; else -1. */
+export function layoutKeyIndex(e) {
+  if (e?.type !== "keydown") return -1;
+  if (!e.ctrlKey || !e.shiftKey || e.metaKey || e.altKey) return -1;
+  return ["Digit1", "Digit2", "Digit3"].indexOf(e.code);
+}

package/src/ui/server/public/topbar.js

@@ -877,14 +877,32 @@ function paletteItems() {
     });
   }
   for (const x of palSessions) {
-    const name = x.kind === "agent" ? (x.persona ?? x.label) : x.label;
+    // AG-4b: the name a person gave the agent, else its persona.
+    const base =
+      x.kind === "agent" ? x.displayName || (x.persona ?? x.label) : x.label;
+    // AG-4b: the session's name (a /rename, or Den's), when it says more.
+    const sn = x.kind === "agent" ? (x.sessionName ?? "").trim() : "";
+    const extra =
+      sn && sn !== base && sn !== x.persona && sn !== x.label ? sn : "";
+    const name = extra ? `${base} · ${extra}` : base;
     items.push({
       key: `agent:${x.id}`,
       kind: "agent",
       label: t("ag.pal", { ws: x.workspace, name }),
-      sub: x.kind === "agent" && x.persona !== x.label ? x.label : undefined,
-      dot: x.state === "running" ? "" : "off",
-      keywords: [x.workspace, x.label, x.persona ?? "", "agents", "terminal"],
+      sub:
+        x.kind === "agent" && (x.displayName || x.persona !== x.label)
+          ? x.label
+          : undefined,
+      dot: x.waiting ? "warn" : x.state === "running" ? "" : "off",
+      keywords: [
+        x.workspace,
+        x.label,
+        x.persona ?? "",
+        x.displayName ?? "",
+        x.sessionName ?? "",
+        "agents",
+        "terminal",
+      ],
       run: () => go(`/agents?open=${encodeURIComponent(x.id)}`),
     });
   }

package/src/ui/server/route-classes.ts

@@ -148,6 +148,10 @@ export const ROUTES: readonly RouteEntry[] = [
     "/api/agents/runtimes",
     "/api/workspaces/:ws/agents",
   ].map((p) => R(p)),
+  R(
+    "/api/workspaces/:ws/agents/:id/paths",
+    "which paths an agent printed exist in its workspace (stat only, AG-4b)",
+  ),
   R(
     "/api/sessions",
     "lists the sessions and agents (names and states, never their output)",
@@ -302,6 +306,11 @@ export const ROUTES: readonly RouteEntry[] = [
   M(["POST", "DELETE"], "/api/workspaces/services"),
   M(["POST"], "/api/workspaces/settings"),
   M(["POST"], "/api/workspaces/:ws/agents/:id/stop", "TERM to its session"),
+  M(
+    ["POST"],
+    "/api/workspaces/:ws/agents/:id/name",
+    "the name a person gave an agent (AG-4b); its id never changes",
+  ),
   M(
     ["POST"],
     "/api/workspaces/:ws/agents/:id/remove",
@@ -407,6 +416,8 @@ export const REGEX_ROUTES: Readonly<Record<string, readonly string[]>> = {
     "/api/workspaces/:ws/agents/:id/fresh",
     "/api/workspaces/:ws/agents/:id/relaunch",
     "/api/workspaces/:ws/agents/:id/remove",
+    "/api/workspaces/:ws/agents/:id/name",
+    "/api/workspaces/:ws/agents/:id/paths",
   ],
   "agent-routes.ts:RUNTIME_PATH": ["/api/agents/runtimes/:id/path"],
   "session-routes.ts:IO_PATH": ["/api/sessions/:id/io"],

package/src/ui/server/session-routes.ts

@@ -43,6 +43,8 @@ import { getStateDir } from "../../shared/paths.js";
 import { product } from "../../shared/product.js";
 import { revokedAgentIds } from "../../shared/actor-token.js";
 import { listRecords } from "../../shared/agents/records.js";
+import { softNewlineSeq } from "../../shared/agents/catalog.js";
+import { getRuntime } from "../../shared/agents/runtimes.js";
 import type { RotationInfo } from "../../shared/agents/rotation.js";
 import {
   connectHost,
@@ -132,6 +134,18 @@ export interface ListedSession {
   /** The `<name>` part: an agent's id, a plain session's name. */
   label: string;
   agent?: string;
+  /** The name a person gave the agent (AG-4b), when one did. */
+  displayName?: string;
+  /**
+   * Its session's name (AG-4b): the latest of Den's rename and the
+   * runtime's (Claude Code's /rename), when there is one.
+   */
+  sessionName?: string;
+  /**
+   * What Shift+Enter sends to it (AG-4b, its catalog entry's softNewline):
+   * ESC CR unless the runtime says otherwise. A plain session: none (Enter).
+   */
+  softNewline?: string;
   persona?: string;
   runtime?: string;
   model?: string;
@@ -193,6 +207,9 @@ export function listedSessions(
       kind: "agent",
       label: rec.id,
       agent: rec.id,
+      ...(rec.displayName ? { displayName: rec.displayName } : {}),
+      ...(r.sessionName ? { sessionName: r.sessionName } : {}),
+      softNewline: softNewlineSeq(getRuntime(rec.runtime)?.catalog),
       persona: rec.persona,
       runtime: rec.runtime,
       ...(rec.model ? { model: rec.model } : {}),