@stemtrooper/learningcode 0.4.9 → 0.4.11

package/bin/learningcode.mjs

@@ -265,6 +265,7 @@ async function main() {
 	forced.push("--extension", join(here, "..", "extensions", "spark-quota.ts"));
 	forced.push("--extension", join(here, "..", "extensions", "footer.ts"));
 	forced.push("--extension", join(here, "..", "extensions", "banner.ts"));
+	forced.push("--extension", join(here, "..", "extensions", "orange-cat.ts"));
 	if (process.env.LEARNINGCODE_PI_FLAGS) {
 		forced.push(...process.env.LEARNINGCODE_PI_FLAGS.split(/\s+/).filter(Boolean));
 	}

package/extensions/banner.ts

@@ -152,9 +152,57 @@ export function createBanner(theme: ThemeLike): HeaderComponent {
  * right moment: extensions are loaded in print and JSON modes too, where there is
  * no header to replace, and starting work in the factory would run for those.
  */
+
+/** Terminal tab title. Just enough of the event context to set it. */
+const TITLE = "learningcode by the learning curve";
+type TitleContext = {
+  hasUI: boolean;
+  mode: string;
+  ui: { setTitle(title: string): void };
+};
+
+/**
+ * Pi rewrites its own π title after extensions bind and again after its async
+ * startup package check on Windows, so one write is never enough. The title is
+ * set on every event where Pi rewrites its own (startup, renames, new turns),
+ * plus once deferred past the startup check. Each write is last-writer-wins in
+ * our favour on at least one of those paths.
+ */
+const TITLE_REASSERT_MS = 2500;
+
 export default function learningcodeBanner(pi: ExtensionAPI) {
-	pi.on("session_start", async (_event, ctx) => {
-		if (!ctx.hasUI || ctx.mode !== "tui") return;
-		ctx.ui.setHeader((_tui, theme) => createBanner(theme as ThemeLike));
-	});
+  let titleTimer: ReturnType<typeof setTimeout> | undefined;
+
+  const applyTitle = (ctx: TitleContext) => {
+    try {
+      ctx.ui.setTitle(TITLE);
+    } catch {
+      // Cosmetic only: a title failure must never break startup.
+    }
+  };
+
+  const titleHook =
+    (defer: boolean) => async (_event: unknown, ctx: TitleContext) => {
+      if (!ctx.hasUI || ctx.mode !== "tui") return;
+      applyTitle(ctx);
+      if (!defer) return;
+      if (titleTimer) clearTimeout(titleTimer);
+      titleTimer = setTimeout(() => {
+        titleTimer = undefined;
+        applyTitle(ctx);
+      }, TITLE_REASSERT_MS);
+      titleTimer.unref?.();
+    };
+
+  pi.on("session_start", async (_event, ctx) => {
+    if (!ctx.hasUI || ctx.mode !== "tui") return;
+    ctx.ui.setHeader((_tui, theme) => createBanner(theme as ThemeLike));
+    await titleHook(true)(_event, ctx);
+  });
+  pi.on("session_info_changed", titleHook(false));
+  pi.on("agent_start", titleHook(false));
+  pi.on("session_shutdown", async () => {
+    if (titleTimer) clearTimeout(titleTimer);
+    titleTimer = undefined;
+  });
 }

package/extensions/orange-cat.ts

@@ -0,0 +1,131 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Image, allocateImageId, getCapabilities } from "@earendil-works/pi-tui";
+import type { Component, TUI, Theme } from "@earendil-works/pi-tui";
+
+/**
+ * Micro orange cat (opencode-style footprint: 5 cells, 1 row).
+ * Sitting front-facing cat: orange ears, blinking eyes, flicking tail.
+ * True-pixel PNG (30x12px) where image protocols exist, half-blocks elsewhere.
+ * The loader-row spinner is also swapped to a small orange rotating square.
+ */
+
+const FRAMES = [
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAARElEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oRl4SIiAjWVPo6rwmretFJdVjF37x5M5qqwWA0OzHQCwAACZMNF3vfv8oAAAAASUVORK5CYII=",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAARElEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oRl4SIiAjWVPo6rwmretFJdVjF37x5M5qqwWA0OzHQCwAACZMNF3vfv8oAAAAASUVORK5CYII=",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAAQ0lEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oFl8TJk9jF/zdNw5p6T57MIsliJoYBAkyjFtMLDFhQAwCZmQy+VnpibQAAAABJRU5ErkJggg==",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAARElEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oRl4SIiAjWVPo6rwmretFJdVjF37x5M5qqwWA0OzHQCwAACZMNF3vfv8oAAAAASUVORK5CYII=",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAAT0lEQVR4nGM8kcfwnwELsJjEwIhN/P9S7OoZo0lTz8QwQIBp1OJhH9SMuCRERESwpsbXeU1Y1YtOqsMq/ubNG6x2MDEMEGAatZheYMCCGgCBNA+6BCtJTQAAAABJRU5ErkJggg==",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAARElEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oRl4SIiAjWVPo6rwmretFJdVjF37x5M5qqwWA0OzHQCwAACZMNF3vfv8oAAAAASUVORK5CYII=",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAATUlEQVR4nGNkwAH+L2X4j02cMZqBkRT1J09iN5+JYYAA06jFwz6oGXFJiIiIYE2lr/OasKoXnVSHVfzNmzdY7WBiGCDANGoxvcCABTUAbQkOTKbjrEAAAAAASUVORK5CYII=",
+  "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAMCAYAAAB1Lg0yAAAARElEQVR4nGNkwAH+L2X4j02cMZqBkRrqmRgGCDCNWjzsg5oRl4SIiAjWVPo6rwmretFJdVjF37x5M5qqwWA0OzHQCwAACZMNF3vfv8oAAAAASUVORK5CYII=",
+];
+
+const SPIN = ["◰", "◳", "◲", "◱"].map((g) => "\x1b[38;2;255;165;0m" + g + "\x1b[39m");
+
+// Braille fallback: 12x4 cells = 24x16 dots (4x half-block density).
+// Orange silhouette of assets/cat.webp; eyes carved (blink), tail shifts.
+const BRAILLE_SEQ: string[][] = [
+  ["⠓⣄⣠⠚"],
+  ["⠓⣄⣠⠚"],
+  ["⠓⣤⣤⠚"],
+  ["⠓⣄⣠⠚"],
+  ["⠒⣄⣠⠒"],
+  ["⠓⣄⣠⠚"]
+];
+const FB_TRAVEL = 4;
+
+function mirrorBraille(line: string): string {
+  // strip ANSI, mirror dot bits left-right, re-wrap
+  const core = line.replace(/\[[0-9;]*m/g, "");
+  let out = "";
+  for (let i = core.length - 1; i >= 0; i--) {
+    const b = core.charCodeAt(i)! - 0x2800;
+    const m =
+      ((b & 0x01) << 3) | ((b & 0x08) >> 3) |
+      ((b & 0x02) << 3) | ((b & 0x10) >> 3) |
+      ((b & 0x04) << 3) | ((b & 0x20) >> 3) |
+      ((b & 0x40) << 1) | ((b & 0x80) >> 1);
+    out += String.fromCharCode(0x2800 + m);
+  }
+  return "" + out + "";
+}
+
+function fallbackFrames(): string[][] {
+  const frames: string[][] = [];
+  for (let i = 0; i <= FB_TRAVEL; i++) {
+    const s = BRAILLE_SEQ[i % BRAILLE_SEQ.length]!;
+    frames.push(s.map((l) => " ".repeat(i) + l));
+  }
+  for (let i = FB_TRAVEL; i >= 0; i--) {
+    const s = BRAILLE_SEQ[i % BRAILLE_SEQ.length]!;
+    frames.push(s.map((l) => " ".repeat(i) + mirrorBraille(l)));
+  }
+  return frames;
+}
+
+class CatWidget implements Component {
+  private idx = 0;
+  private imageId = allocateImageId();
+  private fallback = fallbackFrames();
+  private images: Image[] = [];
+  private tui!: TUI;
+  constructor(tui: TUI, theme: Theme) {
+    this.tui = tui;
+    const fallbackColor = (s: string) => s;
+    for (const f of FRAMES) {
+      this.images.push(new Image(f, "image/png", { fallbackColor }, { imageId: this.imageId }));
+    }
+    void theme;
+  }
+  advance() {
+    this.idx = (this.idx + 1) % FRAMES.length;
+    this.invalidate();
+    this.tui.requestRender?.();
+  }
+  invalidate() {
+    for (const im of this.images) im.invalidate();
+  }
+  render(width: number): string[] {
+    if (!getCapabilities().images) return this.fallback[this.idx % this.fallback.length]!;
+    return this.images[this.idx % this.images.length]!.render(width);
+  }
+}
+
+export default function (pi: ExtensionAPI) {
+  pi.registerCommand("cat", {
+    description: "Show which cat renderer is active (pixel PNG or block fallback).",
+    handler: async (_args, ctx) => {
+      const caps = getCapabilities();
+      ctx.ui.notify(
+        "cat renderer: " + (caps.images ? "true-pixel PNG (" + caps.images + ")" : "block fallback (no image protocol)"),
+        "info",
+      );
+    },
+  });
+  let widget: CatWidget | null = null;
+  let timer: ReturnType<typeof setInterval> | null = null;
+
+  pi.on("session_start", async (_e, ctx: ExtensionContext) => {
+    ctx.ui.setWorkingIndicator({ frames: SPIN, intervalMs: 100 });
+  });
+
+  pi.on("agent_start", async (_e, ctx: ExtensionContext) => {
+    if (!ctx.hasUI || ctx.mode !== "tui") return;
+    if (timer) clearInterval(timer);
+    widget = null;
+    ctx.ui.setWidget("tiny-cat", (tui, theme) => {
+      widget = new CatWidget(tui, theme as unknown as Theme);
+      return widget;
+    });
+    timer = setInterval(() => widget?.advance(), 220);
+  });
+
+  const stop = async (_e: unknown, ctx: ExtensionContext) => {
+    if (timer) clearInterval(timer);
+    timer = null;
+    widget = null;
+    ctx.ui.setWidget("tiny-cat", undefined);
+  };
+  pi.on("agent_settled", stop as never);
+  pi.on("session_shutdown", stop as never);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stemtrooper/learningcode",
-	"version": "0.4.9",
+	"version": "0.4.11",
 	"description": "TLC Spark coding agent for students: Pi wired to the Spark OpenAI-compatible endpoint with per-student tokens, quota and seat-queue awareness.",
 	"type": "module",
 	"license": "MIT",