@stemtrooper/learningcode 0.4.8 → 0.4.10

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/footer.ts

@@ -24,6 +24,10 @@ const TOKEN = process.env.SPARK_API_KEY || "";
 /** Two minutes. Enough to stay current, rarely enough to be invisible. */
 const POLL_MS = 120_000;
 
+/** One braille frame per tick while the agent works. */
+const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const SPIN_MS = 120;
+
 type Quota = {
   tokensUsed: number;
   /** null means no daily cap, which is not the same as a cap of zero. */
@@ -88,8 +92,30 @@ async function fetchQuota(): Promise<Quota | null> {
 export default function sparkFooter(pi: ExtensionAPI) {
   let quota: Quota | null = null;
   let timer: ReturnType<typeof setInterval> | undefined;
+  let spinTimer: ReturnType<typeof setInterval> | undefined;
+  let working = false;
+  let frame = 0;
   let tui: TuiLike | undefined;
 
+  const repaint = () => tui?.requestRender?.();
+
+  const setWorking = (on: boolean) => {
+    working = on;
+    if (on) {
+      if (!spinTimer) {
+        spinTimer = setInterval(() => {
+          frame = (frame + 1) % SPINNER.length;
+          repaint();
+        }, SPIN_MS);
+        spinTimer.unref?.();
+      }
+    } else if (spinTimer) {
+      clearInterval(spinTimer);
+      spinTimer = undefined;
+    }
+    repaint();
+  };
+
   pi.on("session_start", async (_event, ctx) => {
     if (!ctx.hasUI || ctx.mode !== "tui") return;
 
@@ -109,7 +135,17 @@ export default function sparkFooter(pi: ExtensionAPI) {
           // and the footer is the one line that is always on screen.
           // (ctrl+c clears the editor; pressed twice, or on an empty editor
           // via ctrl+d, it exits. These are Pi's default bindings.)
-          const hints = theme.fg("dim", "  ctrl+c exit  ·  esc interrupt");
+          //
+          // While the agent works the hint line becomes the working
+          // indicator instead: an animated frame plus the interrupt key.
+          // Pi has its own status spinner, but the footer is the TLC-owned
+          // surface, so the motion lives here where it cannot be restyled
+          // away from the brand.
+          const idleHints = theme.fg("dim", "  ctrl+c exit  ·  esc interrupt");
+          const hints = working
+            ? theme.fg("accent", `  ${SPINNER[frame]} working…`) +
+              theme.fg("muted", "  ·  esc to interrupt")
+            : idleHints;
 
           // Nothing to say off Spark, or no token: say so rather than draw a bar
           // full of empties that reads as "you have spent nothing".
@@ -166,10 +202,19 @@ export default function sparkFooter(pi: ExtensionAPI) {
   });
 
   pi.on("session_shutdown", async () => {
+    setWorking(false);
     if (timer) clearInterval(timer);
     timer = undefined;
     tui = undefined;
   });
+
+  pi.on("agent_start", async () => {
+    setWorking(true);
+  });
+
+  pi.on("agent_end", async () => {
+    setWorking(false);
+  });
 }
 
 // Exported for tests.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@stemtrooper/learningcode",
-	"version": "0.4.8",
+	"version": "0.4.10",
 	"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",