@paradow/ledge 0.16.0 → 0.17.0

package/README.md

@@ -42,6 +42,7 @@ ledge claude            # start Claude Code in a tracked tmux session (tab renam
 ledge claude --name max # pick the session's Ledge name
 ledge status            # list bots and what they wait for
 ledge attach <id>       # put this terminal on a running session (what the overlay opens a tab with)
+ledge tui               # follow and answer every session from this terminal (--notify bell|osc9|off)
 ledge daemon            # run the daemon in the foreground (normally run by the systemd service)
 ledge uninstall         # undo ledge setup: hooks, service and ~/.local/bin/ledge (--purge: ~/.ledge too)
 ```
@@ -65,6 +66,7 @@ systemctl --user disable --now ledge-daemon.service   # back to on-demand start
 ~/.ledge/daemon.log     dropped hooks, failed injections, poll errors
 ~/.ledge/chat.json      the day's chat conversation (date, session id)
 ~/.ledge/chat/context/  files the chat reads (sessions.md, pane-*, reply-*, git-*)
+~/.ledge/tui.json       ledge tui's settings (its language)
 ~/.ledge/daemon.pid     PID of the running daemon, removed when it stops cleanly
 ~/.config/systemd/user/ledge-daemon.service   user unit written by `ledge setup`
 ~/.ledge/exit-<id>      transient: the agent's exit code, written by the launcher's wrapper when the agent ends and read and deleted by `ledge claude`

package/dist/cli/{attach-5H727FCW.js → attach-EYIX7FZN.js}

@@ -1,19 +1,19 @@
 import {
   attachEnv
-} from "./chunk-MQICEVKR.js";
+} from "./chunk-36KJUV62.js";
 import {
   connect
-} from "./chunk-DEXDXDO4.js";
-import "./chunk-H36JD4E3.js";
+} from "./chunk-VVK4I6B5.js";
+import "./chunk-VE4LGNXX.js";
 import {
   PROTOCOL_PORT,
   backendOf
-} from "./chunk-Q5WWH7FG.js";
+} from "./chunk-QD27W6W5.js";
 import {
   realTmux
-} from "./chunk-2H5FJH4Q.js";
-import "./chunk-BNKPXSUY.js";
-import "./chunk-R5462SQM.js";
+} from "./chunk-LAUNHDTX.js";
+import "./chunk-JQZHXVIZ.js";
+import "./chunk-ELLXOV4Q.js";
 
 // src/cli/attach.ts
 import { spawn } from "child_process";

package/dist/cli/{bridge-LXMOQN6Q.js → bridge-6UHCD76N.js}

@@ -7,8 +7,8 @@ import {
   parseClientMessage,
   parseServerMessage,
   readDaemonToken
-} from "./chunk-Q5WWH7FG.js";
-import "./chunk-R5462SQM.js";
+} from "./chunk-QD27W6W5.js";
+import "./chunk-ELLXOV4Q.js";
 
 // src/cli/bridge.ts
 import WebSocket from "ws";

package/dist/cli/{chunk-MQICEVKR.js → chunk-36KJUV62.js}

@@ -1,23 +1,23 @@
 import {
   DaemonRefusedError,
   connect
-} from "./chunk-DEXDXDO4.js";
+} from "./chunk-VVK4I6B5.js";
 import {
   exitFile,
   spawnSession
-} from "./chunk-H36JD4E3.js";
+} from "./chunk-VE4LGNXX.js";
 import {
   PROTOCOL_PORT
-} from "./chunk-Q5WWH7FG.js";
+} from "./chunk-QD27W6W5.js";
 import {
   realTmux
-} from "./chunk-2H5FJH4Q.js";
+} from "./chunk-LAUNHDTX.js";
 import {
   log
-} from "./chunk-BNKPXSUY.js";
+} from "./chunk-JQZHXVIZ.js";
 import {
   ensureLedgeDir
-} from "./chunk-R5462SQM.js";
+} from "./chunk-ELLXOV4Q.js";
 
 // src/cli/launch.ts
 import { spawn } from "child_process";

package/dist/cli/chunk-5ZCHFGCV.js

@@ -0,0 +1,115 @@
+import {
+  connect
+} from "./chunk-VVK4I6B5.js";
+import {
+  CODEX_HOOK_VAR
+} from "./chunk-VE4LGNXX.js";
+import {
+  TASK_TEXT_MAX,
+  TASK_TITLE_MAX
+} from "./chunk-QD27W6W5.js";
+
+// src/cli/task.ts
+import { randomUUID } from "crypto";
+var TASK_USAGE = `ledge task give <nom> "<titre>" ["<d\xE9tail>"]   confier un travail \xE0 une session
+ledge task list [--all]                         tes t\xE2ches (tenues ou confi\xE9es), ouvertes ; --all : closes aussi
+ledge task show <id>                            une t\xE2che, son d\xE9tail et son historique
+ledge task take <id>                            la prendre
+ledge task done <id> ["<r\xE9sultat>"]             la terminer (la session qui l'a confi\xE9e est pr\xE9venue)
+ledge task refuse <id> "<raison>"               la refuser, ou l'annuler si tu l'as confi\xE9e
+ledge task pass <id> <nom> ["<note>"]           la passer \xE0 une autre session`;
+var TASK_MS = 4e3;
+var ID = /^t[0-9a-f]{6}$/;
+function taskArgs(args) {
+  const [op, ...rest] = args;
+  const id = rest[0] && ID.test(rest[0]) ? rest[0] : void 0;
+  const fits = (min, max) => rest.length >= min && rest.length <= max && rest.slice(0, min).every((a) => a.trim() !== "");
+  switch (op) {
+    case "give":
+      return fits(2, 3) && rest[1].length <= TASK_TITLE_MAX && (rest[2]?.length ?? 0) <= TASK_TEXT_MAX ? { op, to: rest[0], title: rest[1], ...rest[2] ? { text: rest[2] } : {} } : void 0;
+    case "list":
+      return rest.length === 0 ? { op } : rest.length === 1 && rest[0] === "--all" ? { op, all: true } : void 0;
+    case "show":
+    case "take":
+      return fits(1, 1) && id ? { op, task: id } : void 0;
+    case "done":
+      return fits(1, 2) && id && (rest[1]?.length ?? 0) <= TASK_TEXT_MAX ? { op, task: id, ...rest[1] ? { text: rest[1] } : {} } : void 0;
+    case "refuse":
+      return fits(2, 2) && id && rest[1].length <= TASK_TEXT_MAX ? { op, task: id, text: rest[1] } : void 0;
+    case "pass":
+      return fits(2, 3) && id && (rest[2]?.length ?? 0) <= TASK_TEXT_MAX ? { op, task: id, to: rest[1], ...rest[2] ? { text: rest[2] } : {} } : void 0;
+    default:
+      return void 0;
+  }
+}
+var STATE = { open: "\xE0 prendre", taken: "prise", done: "termin\xE9e", refused: "refus\xE9e", dropped: "abandonn\xE9e" };
+var time = (iso) => iso.slice(0, 16).replace("T", " ");
+function formatTask(t) {
+  return [
+    `${t.id} \xB7 ${STATE[t.state]} \xB7 de ${t.giverName} \xE0 ${t.ownerName} \xB7 ${time(t.at)}`,
+    t.title,
+    ...t.text ? ["", t.text] : [],
+    ...t.result ? ["", `${t.state === "done" ? "R\xE9sultat" : "Raison"} : ${t.result}`] : [],
+    "",
+    "Historique :",
+    ...t.log.map((l) => `  ${time(l.at)} ${l.by} : ${l.what}`)
+  ].join("\n");
+}
+async function taskOnClient(client, args, by, ms) {
+  const op = taskArgs(args);
+  if (!op) return { line: TASK_USAGE, code: 1 };
+  try {
+    client.send({ type: "task.cmd", rid: randomUUID(), by, ...op });
+    const r = await client.next("task.result", ms);
+    if (r.reason !== void 0) return { line: `refus\xE9 : ${r.reason}`, code: 1 };
+    if (op.op === "list") {
+      const list = r.tasks ?? [];
+      if (!list.length) return { line: op.all ? "aucune t\xE2che" : "aucune t\xE2che ouverte", code: 0 };
+      return { line: list.map((t2) => `${t2.id}  ${STATE[t2.state].padEnd(10)} ${t2.giverName} \u2192 ${t2.ownerName}  ${t2.title}`).join("\n"), code: 0 };
+    }
+    const t = r.task;
+    switch (op.op) {
+      case "give":
+        return { line: `t\xE2che ${t.id} confi\xE9e \xE0 ${t.ownerName} : elle lui arrive \xE0 son prochain moment libre`, code: 0 };
+      case "take":
+        return { line: `t\xE2che ${t.id} prise`, code: 0 };
+      case "done":
+        return { line: `t\xE2che ${t.id} termin\xE9e ; Ledge pr\xE9vient ${t.giverName}`, code: 0 };
+      case "refuse":
+        return { line: t.giver === by ? `t\xE2che ${t.id} annul\xE9e ; Ledge pr\xE9vient ${t.ownerName}` : `t\xE2che ${t.id} refus\xE9e ; Ledge pr\xE9vient ${t.giverName}`, code: 0 };
+      case "pass":
+        return { line: `t\xE2che ${t.id} pass\xE9e \xE0 ${t.ownerName}`, code: 0 };
+      default:
+        return { line: formatTask(t), code: 0 };
+    }
+  } catch (e) {
+    return { line: `pas de r\xE9ponse de Ledge : ${e.message}`, code: 1 };
+  }
+}
+async function runTask(args, opts = {}) {
+  if (!taskArgs(args)) return { line: TASK_USAGE, code: args.length ? 1 : 0 };
+  const env = opts.env ?? process.env;
+  const by = env[CODEX_HOOK_VAR] || env.LEDGE_SESSION;
+  if (!by) return { line: "ledge task ne marche que dans une session lanc\xE9e par Ledge", code: 1 };
+  const deadline = Date.now() + (opts.timeoutMs ?? TASK_MS);
+  const left = () => Math.max(0, deadline - Date.now());
+  let client;
+  try {
+    client = await connect({ port: opts.port, timeoutMs: left() });
+  } catch {
+    return { line: "daemon not running (start a session with `ledge claude`, or run `ledge daemon`)", code: 1 };
+  }
+  try {
+    return await taskOnClient(client, args, by, left());
+  } finally {
+    await client.close();
+  }
+}
+
+export {
+  TASK_USAGE,
+  taskArgs,
+  formatTask,
+  taskOnClient,
+  runTask
+};

package/dist/cli/{chunk-QJVODYJ5.js → chunk-AQ25HFBP.js}

@@ -1,10 +1,10 @@
 import {
   connect,
   sendMessageAndAwaitAck
-} from "./chunk-DEXDXDO4.js";
+} from "./chunk-VVK4I6B5.js";
 import {
   CODEX_HOOK_VAR
-} from "./chunk-H36JD4E3.js";
+} from "./chunk-VE4LGNXX.js";
 
 // src/cli/send.ts
 import { randomUUID } from "crypto";
@@ -58,6 +58,40 @@ async function sendMessage(args, opts = {}) {
     await client.close();
   }
 }
+var READ_USAGE = "ledge read <id>   print a long message whole (its id is in the pointer you received)";
+var MAIL_ID = /^m[0-9a-f]{6,40}$/;
+async function readOnClient(client, args, by, ms) {
+  const [id] = args;
+  if (args.length !== 1 || !id || !MAIL_ID.test(id)) return { line: READ_USAGE, code: 1 };
+  try {
+    client.send({ type: "message.read", id, by });
+    const body = await client.next("message.body", ms);
+    if (body.text === void 0) return { line: `introuvable : ${body.reason ?? "raison inconnue"}`, code: 1 };
+    return { line: `De ${body.from} \xE0 ${body.to}, ${body.at} :
+${body.text}`, code: 0 };
+  } catch (e) {
+    return { line: `pas de r\xE9ponse de Ledge : ${e.message}`, code: 1 };
+  }
+}
+async function readMessage(args, opts = {}) {
+  if (args.length !== 1 || !MAIL_ID.test(args[0])) return { line: READ_USAGE, code: 1 };
+  const env = opts.env ?? process.env;
+  const by = env[CODEX_HOOK_VAR] || env.LEDGE_SESSION;
+  if (!by) return { line: "ledge read ne marche que dans une session lanc\xE9e par Ledge", code: 1 };
+  const deadline = Date.now() + (opts.timeoutMs ?? SEND_MS);
+  const left = () => Math.max(0, deadline - Date.now());
+  let client;
+  try {
+    client = await connect({ port: opts.port, timeoutMs: left() });
+  } catch {
+    return { line: "daemon not running (start a session with `ledge claude`, or run `ledge daemon`)", code: 1 };
+  }
+  try {
+    return await readOnClient(client, args, by, left());
+  } finally {
+    await client.close();
+  }
+}
 function parseLedgeCommand(command) {
   command = command.replace(/[\r\n\s]+$/, "");
   const words = [];
@@ -95,11 +129,15 @@ function parseLedgeCommand(command) {
   if (words[0] !== "ledge") return void 0;
   if (words[1] === "who" && words.length === 2) return { cmd: "who" };
   if (words[1] === "send") return { cmd: "send", args: words.slice(2) };
+  if (words[1] === "read") return { cmd: "read", args: words.slice(2) };
+  if (words[1] === "task") return { cmd: "task", args: words.slice(2) };
   return void 0;
 }
 
 export {
   sendOnClient,
   sendMessage,
+  readOnClient,
+  readMessage,
   parseLedgeCommand
 };

package/dist/cli/{chunk-R5462SQM.js → chunk-ELLXOV4Q.js}

@@ -17,7 +17,7 @@ function ledgeDir() {
 }
 function paths() {
   const dir = ledgeDir();
-  return { dir, tmuxConf: join(dir, "tmux.conf"), journal: join(dir, "sessions.json"), log: join(dir, "daemon.log"), pid: join(dir, "daemon.pid"), history: join(dir, "history"), machines: join(dir, "machines.json"), projects: join(dir, "projects.json"), island: join(dir, "island.json"), token: join(dir, "token"), mobile: join(dir, "mobile.json"), mobileSession: join(dir, "mobile-session.json"), mobileKey: join(dir, "mobile-key"), devices: join(dir, "devices.json"), revocations: join(dir, "revocations.json") };
+  return { dir, tmuxConf: join(dir, "tmux.conf"), journal: join(dir, "sessions.json"), log: join(dir, "daemon.log"), pid: join(dir, "daemon.pid"), history: join(dir, "history"), mail: join(dir, "mail.json"), tasks: join(dir, "tasks.json"), machines: join(dir, "machines.json"), projects: join(dir, "projects.json"), island: join(dir, "island.json"), token: join(dir, "token"), mobile: join(dir, "mobile.json"), mobileSession: join(dir, "mobile-session.json"), mobileKey: join(dir, "mobile-key"), devices: join(dir, "devices.json"), revocations: join(dir, "revocations.json") };
 }
 async function ensureLedgeDir() {
   const p = paths();
@@ -33,6 +33,7 @@ ${TITLE_LINES}`);
 }
 
 export {
+  ledgeDir,
   paths,
   ensureLedgeDir
 };

package/dist/cli/{chunk-BNKPXSUY.js → chunk-JQZHXVIZ.js}

@@ -1,6 +1,6 @@
 import {
   paths
-} from "./chunk-R5462SQM.js";
+} from "./chunk-ELLXOV4Q.js";
 
 // src/log.ts
 import { appendFileSync } from "fs";

package/dist/cli/{chunk-2H5FJH4Q.js → chunk-LAUNHDTX.js}

@@ -1,9 +1,9 @@
 import {
   log
-} from "./chunk-BNKPXSUY.js";
+} from "./chunk-JQZHXVIZ.js";
 import {
   paths
-} from "./chunk-R5462SQM.js";
+} from "./chunk-ELLXOV4Q.js";
 
 // src/tmux.ts
 import { execFile } from "child_process";

package/dist/cli/{chunk-DBSCO3HI.js → chunk-NC5YAEJB.js}

@@ -1,12 +1,13 @@
 import {
   ledgeTitleRest
-} from "./chunk-H36JD4E3.js";
+} from "./chunk-VE4LGNXX.js";
 import {
   cleanTopic,
   sessionTitle
-} from "./chunk-Q5WWH7FG.js";
+} from "./chunk-QD27W6W5.js";
 
 // src/daemon/crossSession.ts
+import { createHash } from "crypto";
 var FIRST_LINE = /^Another Claude session sent a message:\s*\n/;
 var BLOCK = /<cross-session-message\b([^>]*)>([\s\S]*?)(?:<\/cross-session-message>|(?=\n[ \t]*<cross-session-message\b)|$)/g;
 var ATTR = /([\w-]+)="([^"]*)"/g;
@@ -24,7 +25,7 @@ function crossSession(text) {
 }
 var LEDGE_CLOSE = "</ledge-message>";
 var LEDGE_BLOCK = /^<ledge-message\b([^>]*)>([\s\S]*?)(?:<\/ledge-message>|$)/;
-var messageNote = (from, to) => `(message de la session ${from}, pas de l'utilisateur ; pour r\xE9pondre : ${to === "codex" ? `ledge send ${from} "\u2026"` : `SendMessage vers ${from}`})`;
+var messageNote = (from, to) => `(message de la session ${from}, pas de l'utilisateur ; pour r\xE9pondre : ${to === "claude" ? `SendMessage vers ${from}` : `ledge send ${from} "\u2026"`})`;
 var NOTE_SENDER = /^\(message de la session (.+?), pas de l'utilisateur ; /;
 function stripNote(text) {
   const body = text.trimStart();
@@ -36,9 +37,20 @@ var ESCAPES = /\x1b(?:\[[0-?]*[ -/]*[@-~]|[\]PX^_][^\x07\x1b]*(?:\x07|\x1b\\)|[
 var CONTROLS = /[\x00-\x1f\x7f-\x9f]/g;
 var typable = (text, newline) => text.replace(ESCAPES, "").replace(/\r\n|\r|\n/g, newline).replace(CONTROLS, " ");
 var ledgeBody = (text) => typable(text.replaceAll("<", "\u2039"), " \u23CE ");
+var INLINE_MAX = 800;
+var INLINE_LINES = 8;
+var POINTER_HEAD = 200;
+var lineCount = (text) => text.split(/\r\n|\r|\n/).length;
+var mailId = (rid, length = 6) => `m${createHash("sha1").update(rid).digest("hex").slice(0, length)}`;
+var inline = (text) => text.length <= INLINE_MAX && lineCount(text) <= INLINE_LINES;
+var attr = (s) => typable(s, " ").replace(/["<>]/g, "").trim();
 function formatLedgeMessage(m) {
-  const from = typable(m.from, " ").replace(/["<>]/g, "").trim();
-  return `<ledge-message from="${from}" tool="${m.tool}">${messageNote(from, m.to)} ${ledgeBody(m.text)}${LEDGE_CLOSE}`;
+  const from = attr(m.from);
+  const open = `<ledge-message from="${from}" tool="${m.tool}"${m.id ? ` id="${attr(m.id)}"` : ""}>${messageNote(from, m.to)} `;
+  if (!m.id || inline(m.text)) return `${open}${ledgeBody(m.text)}${LEDGE_CLOSE}`;
+  const first = m.summary?.trim() || m.text.trim().split(/\r\n|\r|\n/)[0].trim();
+  const head = ledgeBody(first.length > POINTER_HEAD ? `${first.slice(0, POINTER_HEAD)}\u2026` : first);
+  return `${open}${head} \u2026 [message de ${m.text.length} caract\xE8res, ${lineCount(m.text)} lignes : lis-le en entier avec ledge read ${attr(m.id)}]${LEDGE_CLOSE}`;
 }
 function ledgeMessages(text) {
   const m = LEDGE_BLOCK.exec(text.trimStart());
@@ -46,8 +58,39 @@ function ledgeMessages(text) {
   const attrs = new Map([...m[1].matchAll(ATTR)].map((a) => [a[1], a[2]]));
   const from = attrs.get("from");
   const tool = attrs.get("tool");
+  const id = attrs.get("id");
   if (!from) return void 0;
-  return [{ from, ...tool ? { tool } : {}, text: stripNote(m[2]).text.trim() }];
+  return [{ from, ...tool ? { tool } : {}, ...id ? { id } : {}, text: stripNote(m[2]).text.trim() }];
+}
+var NOTICE_BLOCK = /^<ledge-notice\b([^>]*)>([\s\S]*?)(?:<\/ledge-notice>|$)/;
+var NOTICE_QUOTE = 80;
+var NOTICE_REASON = " \xBB) : ";
+function formatLedgeNotice(n) {
+  const to = attr(n.to);
+  const flat = typable(n.text, " ").trim();
+  const quote = ledgeBody(flat.length > NOTICE_QUOTE ? `${flat.slice(0, NOTICE_QUOTE)}\u2026` : flat);
+  return `<ledge-notice to="${to}">Ledge n'a pas pu remettre ton message \xE0 ${to} (\xAB ${quote}${NOTICE_REASON}${ledgeBody(n.reason)}</ledge-notice>`;
+}
+var TASK_BLOCK = /^<ledge-task\b([^>]*)>([\s\S]*?)(?:<\/ledge-task>|$)/;
+function formatLedgeTask(t) {
+  return `<ledge-task id="${attr(t.id)}" from="${attr(t.from)}">${ledgeBody(t.text)}</ledge-task>`;
+}
+function ledgeTask(text) {
+  const m = TASK_BLOCK.exec(text.trimStart());
+  if (!m) return void 0;
+  const attrs = new Map([...m[1].matchAll(ATTR)].map((a) => [a[1], a[2]]));
+  const id = attrs.get("id");
+  const from = attrs.get("from");
+  return id ? { id, ...from ? { from } : {}, text: m[2].trim() } : void 0;
+}
+function ledgeNotice(text) {
+  const m = NOTICE_BLOCK.exec(text.trimStart());
+  if (!m) return void 0;
+  const to = new Map([...m[1].matchAll(ATTR)].map((a) => [a[1], a[2]])).get("to");
+  if (!to) return void 0;
+  const body = m[2].trim();
+  const at = body.lastIndexOf(NOTICE_REASON);
+  return { to, ...at >= 0 ? { reason: body.slice(at + NOTICE_REASON.length) } : {}, text: body };
 }
 var NOTICE_HEAD = /^\[Cross-session ([\w -]+?) notice\]/;
 var NOTICE_SPLIT = /\n\s*(?=\[Cross-session [\w -]+? notice\])/;
@@ -393,7 +436,7 @@ function reduceEvent(s, ev) {
     case "PreToolUse":
     case "PermissionRequest":
     case "Notification": {
-      const notice2 = ev.name === "UserPromptSubmit" && !!ev.text && !!crossSessionNotices(ev.text);
+      const notice2 = ev.name === "UserPromptSubmit" && !!ev.text && (!!crossSessionNotices(ev.text) || !!ledgeNotice(ev.text) || !!ledgeTask(ev.text));
       if (ev.name === "UserPromptSubmit" && ev.text && !s.topic && !notice2 && !crossSession(ev.text)) s = withTopic(s, ev.text, "prompt");
       if (s.pending?.source === "rpc" && ev.name === "PreToolUse") return { ...s, lastHookAt: at, lastActivityAt: at };
       const incoming = pendingFor(ev);
@@ -524,8 +567,14 @@ export {
   messageNote,
   stripNote,
   ledgeBody,
+  mailId,
+  inline,
   formatLedgeMessage,
   ledgeMessages,
+  formatLedgeNotice,
+  formatLedgeTask,
+  ledgeTask,
+  ledgeNotice,
   crossSessionNotices,
   Refusal,
   NO_ALWAYS,

package/dist/cli/{chunk-S4ANPQGA.js → chunk-OVJL2QTN.js}

@@ -1,10 +1,10 @@
 import {
   run
-} from "./chunk-2H5FJH4Q.js";
+} from "./chunk-LAUNHDTX.js";
 import {
   ensureLedgeDir,
   paths
-} from "./chunk-R5462SQM.js";
+} from "./chunk-ELLXOV4Q.js";
 
 // src/cli/setup.ts
 import { readFile as readFile2, writeFile, mkdir, rename, realpath, rm, stat, lstat, readlink } from "fs/promises";

package/dist/cli/{chunk-TB47EHML.js → chunk-Q7YNLP66.js}

@@ -1,9 +1,9 @@
 import {
   connect
-} from "./chunk-DEXDXDO4.js";
+} from "./chunk-VVK4I6B5.js";
 import {
   isArchived
-} from "./chunk-Q5WWH7FG.js";
+} from "./chunk-QD27W6W5.js";
 
 // src/cli/who.ts
 import { basename } from "path";