@stemtrooper/learningcode 0.4.7 → 0.4.9

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;
 
@@ -105,15 +131,31 @@ export default function sparkFooter(pi: ExtensionAPI) {
       tui = footerTui;
       return {
         render(width: number): string[] {
+          // Every path ends with the exit hint. Students asked how to quit,
+          // 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.)
+          //
+          // 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".
           if (!TOKEN) {
-            return [theme.fg("dim", "  not on Spark — /login, or use --model opencode-go/…")];
+            return [theme.fg("dim", "  not on Spark — /login, or use --model opencode-go/…"), hints];
           }
-          if (!quota) return [theme.fg("dim", "  Spark quota unavailable")];
+          if (!quota) return [theme.fg("dim", "  Spark quota unavailable"), hints];
 
           if (quota.aiEnabled === false) {
-            return [theme.fg("error", "  AI disabled for your account — ask your teacher")];
+            return [theme.fg("error", "  AI disabled for your account — ask your teacher"), hints];
           }
 
           // No ceiling: no meter and no percentage, because a full bar implies a
@@ -122,6 +164,7 @@ export default function sparkFooter(pi: ExtensionAPI) {
             return [
               theme.fg("dim", `  ${Math.round(quota.tokensUsed / 1000)}k used today`) +
                 theme.fg("muted", "  ·  unlimited"),
+              hints,
             ];
           }
 
@@ -131,6 +174,7 @@ export default function sparkFooter(pi: ExtensionAPI) {
             return [
               theme.fg("dim", `  ${Math.round(quota.tokensUsed / 1000)}k used today`) +
                 theme.fg("muted", "  ·  no daily token cap"),
+              hints,
             ];
           }
 
@@ -141,13 +185,13 @@ export default function sparkFooter(pi: ExtensionAPI) {
 
           // Narrow terminals keep the bar and the percentage only; the absolute
           // token counts are the part that can be dropped.
-          if (width < 52) return [`  ${bar} ${percent}`];
+          if (width < 52) return [`  ${bar} ${percent}`, hints];
 
           const numbers = theme.fg(
             "dim",
             `${Math.round(tokensUsed / 1000)}k / ${Math.round(limit / 1000)}k today`,
           );
-          return [`  ${bar} ${percent}  ${numbers}`];
+          return [`  ${bar} ${percent}  ${numbers}`, hints];
         },
       };
     });
@@ -158,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.7",
+	"version": "0.4.9",
 	"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",