pi-mox 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ version may add commands and options and a patch version fixes.
 
 ## Unreleased
 
+## 0.2.0
+
+### Added
+
+- `/mox show <id>` shows one cue with its whole message.
+
+### Changed
+
+- `/mox list` and the id completions show each message on one line: whitespace and line breaks collapse to
+  one space, and a message over 60 characters is cut with `…`. `/mox show <id>` gives the whole message.
+
+## 0.1.1
+
+### Added
+
+- A gallery preview image (`pi.image`) in the Roman inscription look, also at the top of the README;
+  its source is `assets/preview.html`.
+
 ## 0.1.0
 
 ### Added

package/README.md

@@ -1,4 +1,6 @@
-# pi-mox
+# ·MOX· pi-mox
+
+![pi-mox: schedule a message for the agent in Pi](assets/preview.png)
 
 Schedule a message for the agent in [Pi](https://github.com/earendil-works/pi). Say when, say what, and at
 that time the message reaches the agent and starts a turn. *Mox* is Latin for "soon".
@@ -21,10 +23,11 @@ pi install npm:pi-mox
 | Command | What it does |
 | --- | --- |
 | `/mox <time> <message>` | Deliver `<message>` to the agent at `<time>` |
-| `/mox list` (or `/mox`) | Show the pending cues |
+| `/mox list` (or `/mox`) | Show the pending cues, each message on one line cut at 60 characters with `…` |
+| `/mox show <id>` | Show one cue with its whole message |
 | `/mox cancel <id>` | Cancel a cue; the id is Roman (`II`, `ii`) or Arabic (`2`) |
 
-`list` and `cancel` are reserved first words.
+`list`, `show` and `cancel` are reserved first words.
 
 ### Time
 
@@ -48,6 +51,10 @@ Scheduled II for 14:00 (in 5h36m): corre la suite
 I   10:30  2h06m  continúa con T3
 II  14:00  5h36m  corre la suite
 
+/mox show I
+I  10:30  2h06m
+continúa con T3
+
 /mox cancel II
 Cancelled II (14:00): corre la suite
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mox",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Schedule a message for the agent in Pi: /mox 10:30 <message> delivers it at that time and starts a turn.",
   "license": "MIT",
   "author": "jals1212",
@@ -22,7 +22,8 @@
   "pi": {
     "extensions": [
       "./extensions/mox.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/jals1212/pi-mox/main/assets/preview.png"
   },
   "files": [
     "src",

package/src/mox.ts

@@ -1,7 +1,7 @@
 // pi-mox core: time parsing, Roman numerals, the cue list and its wall-clock scheduler, and the /mox command.
 // No Pi runtime imports here (see src/wire.ts for the wiring), so everything runs under plain `node --test`.
 
-export const USAGE = "Usage: /mox <time> <message>, /mox list, /mox cancel <id> (time: 10:30 or +2h15m)";
+export const USAGE = "Usage: /mox <time> <message>, /mox list, /mox show <id>, /mox cancel <id> (time: 10:30 or +2h15m)";
 
 /** A pending cue: a message to deliver at `at` (epoch milliseconds). `id` is shown as a Roman numeral. */
 export interface Cue {
@@ -236,6 +236,16 @@ export function createMox(options: MoxOptions): Mox {
 
 // --- Command ---
 
+const PREVIEW_CHARS = 60;
+
+/** One-line preview for lists: whitespace runs collapse to one space; over 60 characters it ends in `…`. */
+export function previewMessage(message: string): string {
+	const line = message.replace(/\s+/g, " ").trim();
+	return line.length > PREVIEW_CHARS ? `${line.slice(0, PREVIEW_CHARS - 1).trimEnd()}…` : line;
+}
+
+const parseId = (text: string) => (/^\d+$/.test(text) ? Number(text) : fromRoman(text));
+
 const dayStart = (ms: number) => new Date(new Date(ms).setHours(0, 0, 0, 0)).getTime();
 
 function dayLabel(at: number, now: number): string {
@@ -265,16 +275,26 @@ export function runMoxCommand(args: string, deps: CommandDeps): void {
 		return info(
 			cues
 				.map((cue) => {
-					const line = `${formatClock(cue.at)}  ${formatRemaining(cue.at - now)}  ${cue.message}`;
+					const line = `${formatClock(cue.at)}  ${formatRemaining(cue.at - now)}  ${previewMessage(cue.message)}`;
 					return `${paint(BRONZE, toRoman(cue.id).padEnd(width), ctx.hasUI)}  ${paint(MARBLE, line, ctx.hasUI)}`;
 				})
 				.join("\n"),
 		);
 	}
 
+	if (word === "show") {
+		if (rest === "") return fail("Missing cue id.");
+		const id = parseId(rest);
+		if (id === undefined || id < 1) return fail(`Invalid cue id "${rest}".`);
+		const cue = mox.list().find((candidate) => candidate.id === id);
+		if (!cue) return fail(`No pending cue ${toRoman(id)}.`);
+		const head = `${toRoman(cue.id)}  ${formatClock(cue.at)}  ${formatRemaining(cue.at - deps.now())}`;
+		return info(`${paint(BRONZE, head, ctx.hasUI)}\n${paint(MARBLE, cue.message, ctx.hasUI)}`);
+	}
+
 	if (word === "cancel") {
 		if (rest === "") return fail("Missing cue id.");
-		const id = /^\d+$/.test(rest) ? Number(rest) : fromRoman(rest);
+		const id = parseId(rest);
 		if (id === undefined || id < 1) return fail(`Invalid cue id "${rest}".`);
 		const cue = mox.cancel(id);
 		if (!cue) return fail(`No pending cue ${toRoman(id)}.`);
@@ -289,20 +309,24 @@ export function runMoxCommand(args: string, deps: CommandDeps): void {
 	info(`Scheduled ${toRoman(cue.id)} for ${formatClock(at)}${dayLabel(at, now)} (in ${formatRemaining(at - now)}): ${rest}`);
 }
 
-/** Autocompletion: `list`, `cancel`, and pending ids after `cancel`. */
+/** Autocompletion: `list`, `show`, `cancel`, and pending ids after `show` or `cancel`. */
 export function completeMoxArgs(prefix: string, mox: Mox): { value: string; label: string }[] | null {
 	const words = prefix.split(" ");
 	if (words.length === 1) {
-		const items = ["list", "cancel"].filter((sub) => sub.startsWith(words[0])).map((sub) => ({ value: sub, label: sub }));
+		const items = ["list", "show", "cancel"].filter((sub) => sub.startsWith(words[0])).map((sub) => ({ value: sub, label: sub }));
 		return items.length > 0 ? items : null;
 	}
-	if (words.length !== 2 || words[0] !== "cancel") return null;
+	const sub = words[0];
+	if (words.length !== 2 || (sub !== "cancel" && sub !== "show")) return null;
 	const typed = words[1].toUpperCase();
 	const items = mox
 		.list()
 		.sort((a, b) => a.id - b.id)
 		.filter((cue) => toRoman(cue.id).startsWith(typed) || String(cue.id).startsWith(typed))
-		.map((cue) => ({ value: `cancel ${toRoman(cue.id)}`, label: `${toRoman(cue.id)}  ${formatClock(cue.at)}  ${cue.message}` }));
+		.map((cue) => ({
+			value: `${sub} ${toRoman(cue.id)}`,
+			label: `${toRoman(cue.id)}  ${formatClock(cue.at)}  ${previewMessage(cue.message)}`,
+		}));
 	return items.length > 0 ? items : null;
 }
 

package/src/wire.ts

@@ -50,7 +50,7 @@ export function registerMox(pi: ExtensionAPI, options: WireOptions): void {
 	});
 
 	pi.registerCommand("mox", {
-		description: "Schedule a message for the agent: /mox <10:30|+2h15m> <message>, /mox list, /mox cancel <id>",
+		description: "Schedule a message for the agent: /mox <10:30|+2h15m> <message>, /mox list, /mox show <id>, /mox cancel <id>",
 		getArgumentCompletions: (prefix) => completeMoxArgs(prefix, mox),
 		handler: async (args, ctx) => {
 			use(ctx);