agent-golf 0.1.0 → 0.1.1

package/README.md

@@ -2,17 +2,17 @@
 
 Pi commands for the Agent Golf coding-agent leaderboard. Login, browsing and submission never call a model or compute scores locally.
 
-**Initial release: preview (0.1.0).** Installation, UI, transport and privacy are verified. At initial publication, production API availability and real counter integration were not verified; local website tests used stand-in scores. This is for integration testing, not competition scoring until your organizer confirms a deployed, verified real counter.
+**0.1.1:** uses https://agent-golf.csbasics.in and includes read-only interactive problem views. Local integration with the real counter is verified and the production catalogue is reachable. A fresh solved production submission has not been verified; follow your organizer's readiness announcement before competition use.
 
 ## Install and update
 
 Requires Node.js 22.19+ and the Pi coding agent (tested with Pi 1.1.0).
 
 ```bash
-pi install npm:agent-golf@preview
+pi install npm:agent-golf
 ```
 
-Use an organizer-provided trusted test server via the override below until production is ready. Once the team announces a stable release, install `npm:agent-golf` to follow `latest` instead.
+Unversioned installations follow `latest`. The `preview` channel also receives this URL update; existing preview users can keep that installation source.
 
 Start a new Pi process, or run `/reload` in an existing one. To update an unpinned installation:
 
@@ -20,7 +20,9 @@ Start a new Pi process, or run `/reload` in an existing one. To update an unpinn
 pi update --extensions
 ```
 
-Restart Pi or `/reload` afterward. An exact version such as `npm:agent-golf@0.1.0` is pinned; updating does not advance it to a different version. The `npm:agent-golf@preview` installation follows the preview channel; it does not automatically switch to `latest`.
+Restart Pi or `/reload` afterward. An exact version such as `npm:agent-golf@0.1.0` is pinned; updating does not advance it to a different version. Remove the old pinned source (`pi remove npm:agent-golf@0.1.0`), then install `npm:agent-golf@0.1.1` explicitly to replace that pin. The `npm:agent-golf@preview` installation follows the preview channel; it does not automatically switch to `latest`.
+
+**Updating from 0.1.0:** the default server origin changed. Unset any old `AGENT_GOLF_API_BASE_URL` override, update/restart Pi, and run `/golf-login` with your student key valid on the new website. Old-origin credentials are preserved but never migrated or sent to the new origin.
 
 ## Commands
 
@@ -28,7 +30,7 @@ Restart Pi or `/reload` afterward. An exact version such as `npm:agent-golf@0.1.
 
 Browse public contest rules, challenge URLs, instructions and each problem's model/thinking setup. Rules open first, followed by a problem selector. Close a detail view to return to the list; cancel the list to exit. An empty list still shows the rules.
 
-Views use Pi's temporary plain-text multi-line editor in interactive or supported RPC clients. All edits are discarded; nothing is inserted into your prompt or session. `any` setup is displayed as "any model, one per session" or "any thinking level".
+Interactive Pi uses read-only, scrollable text views: Enter on rules opens the problem list, Esc closes browsing, and Enter/Esc on details returns to the list. Arrow keys, Page Up/Down and Home/End scroll; navigation hints use your configured confirm/cancel keys. RPC clients retain temporary text-editor dialogs with explicit navigation titles; all edits are discarded. Nothing is inserted into your prompt or session. `any` setup is displayed as "any model, one per session" or "any thinking level".
 
 Browsing sends no key, cookie or session log, makes no model calls, and never starts/binds an attempt or changes your setup. The catalogue is advisory; server submission checks are authoritative. Replies are bounded to 64 KB and strings to 1,000 Unicode characters, with terminal-safety and exact Hackattic URL checks.
 
@@ -56,7 +58,7 @@ The server owns scores and status. A null total with `missing_usage` is displaye
 
 ## Server configuration
 
-Default API origin: **https://agent-golf.justuju.in**.
+Default API origin: **https://agent-golf.csbasics.in**.
 
 For a trusted local server:
 
@@ -75,7 +77,7 @@ Both authentication and browsing/submission use this origin. Only HTTPS and loop
 - **No persisted session file:** submit from the saved attempt, not a fresh custom-only session that has not flushed to disk.
 - **Upload/network error:** the upload may already have reached the server. Check the website before retrying. The plugin never retries automatically.
 
-Removing the preview with `pi remove npm:agent-golf@preview` (use the source you installed) does not remove your credential file. Delete that file separately only if you intend to discard saved logins.
+Removing the package with `pi remove npm:agent-golf` (use the source you installed, e.g. `npm:agent-golf@preview`) does not remove your credential file. Delete that file separately only if you intend to discard saved logins.
 
 ## License
 

package/config.ts

@@ -1,4 +1,4 @@
-export const DEFAULT_API_ORIGIN = "https://agent-golf.justuju.in";
+export const DEFAULT_API_ORIGIN = "https://agent-golf.csbasics.in";
 
 export function getApiOrigin(baseUrl: string | undefined): string {
   if (!baseUrl?.trim()) throw new Error("missing-origin");

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "agent-golf",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Zero-model-call Pi commands for Agent Golf login, raw session submission and problem browsing",
   "license": "MIT",
-  "homepage": "https://agent-golf.justuju.in",
+  "homepage": "https://agent-golf.csbasics.in",
   "keywords": ["pi-package", "agent-golf"],
   "engines": { "node": ">=22.19.0" },
-  "files": ["index.ts", "config.ts", "login.ts", "submit.ts", "user-bash.ts", "problems.ts", "README.md", "LICENSE"],
+  "files": ["index.ts", "config.ts", "login.ts", "submit.ts", "user-bash.ts", "problems.ts", "problem-view.ts", "README.md", "LICENSE"],
   "pi": { "extensions": ["./index.ts"], "skills": [], "prompts": [], "themes": [] },
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
   "type": "module",
@@ -14,7 +14,8 @@
     "test": "node --test test/*.test.mjs"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*"
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
   },
   "devDependencies": {}
 }

package/problem-view.ts

@@ -0,0 +1,74 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+type TuiModule = typeof import("@earendil-works/pi-tui");
+type Factory = Parameters<ExtensionContext["ui"]["custom"]>[0];
+type Tui = Parameters<Factory>[0];
+type Theme = Parameters<Factory>[1];
+type Bindings = Parameters<Factory>[2];
+
+// Dependency injection keeps rendering tests independent of Pi's module loader.
+export function createProblemView(
+  lib: TuiModule, tui: Tui, theme: Theme, bindings: Bindings,
+  done: (continued: boolean) => void, title: string, body: string, action: string, cancel: string,
+) {
+  const text = new lib.Text(body, 0, 0);
+  const scroll = new lib.ScrollView(text, { scrollbar: "hidden", overscroll: "contain" });
+  let height = 1;
+  let closed = false;
+  const finish = (value: boolean) => { if (!closed) { closed = true; done(value); } };
+  const keys = (name: "tui.select.confirm" | "tui.select.cancel") => bindings.getKeys(name).join("/");
+  return {
+    render(width: number) {
+      const w = Math.max(1, Math.floor(width));
+      const confirmKey = keys("tui.select.confirm"), cancelKey = keys("tui.select.cancel");
+      const navigation = action === cancel ? `${confirmKey}/${cancelKey}: ${action}` :
+        `${confirmKey}: ${action} · ${cancelKey}: ${cancel}`;
+      const navigationLines = new lib.Text(navigation, 0, 0).render(w);
+      const available = Math.max(1, tui.terminal.rows - 5);
+      // Physically tiny terminals cannot fit body plus controls; ask for resize
+      // rather than presenting a clipped action as if it were the full help.
+      if (w < 12 || navigationLines.length + 2 > available) {
+        return [lib.truncateToWidth("Resize terminal", w),
+          ...new lib.Text(`${confirmKey}/${cancelKey}`, 0, 0).render(w)].slice(0, available);
+      }
+      const showScrollHint = available >= navigationLines.length + 3;
+      height = Math.max(1, Math.min(16, available - 1 - navigationLines.length - Number(showScrollHint)));
+      const lines = text.render(w);
+      scroll.updateLayout(lines.length, height, () => tui.requestRender());
+      const visible = lines.slice(scroll.scrollTop, scroll.scrollTop + height);
+      const scrollHint = `${w < 45 ? "↑/↓ scroll" : "↑/↓ PgUp/PgDn Home/End: scroll"} · ${scroll.scrollTop + 1}-${Math.min(lines.length, scroll.scrollTop + height)}/${lines.length}`;
+      return [
+        lib.truncateToWidth(theme.fg("accent", title), w),
+        ...visible,
+        ...navigationLines.map((line) => theme.fg("muted", line)),
+        ...(showScrollHint ? [lib.truncateToWidth(theme.fg("muted", scrollHint), w)] : []),
+      ];
+    },
+    handleInput(data: string) {
+      if (closed) return;
+      if (bindings.matches(data, "tui.select.cancel") || lib.matchesKey(data, lib.Key.ctrl("c"))) { finish(false); return; }
+      if (bindings.matches(data, "tui.select.confirm")) { finish(true); return; }
+      if (lib.matchesKey(data, lib.Key.up)) scroll.scrollBy(-1);
+      else if (lib.matchesKey(data, lib.Key.down)) scroll.scrollBy(1);
+      else if (lib.matchesKey(data, lib.Key.pageUp)) scroll.scrollBy(-height);
+      else if (lib.matchesKey(data, lib.Key.pageDown)) scroll.scrollBy(height);
+      else if (lib.matchesKey(data, lib.Key.home)) scroll.scrollToStart();
+      else if (lib.matchesKey(data, lib.Key.end)) scroll.scrollToEnd();
+      // No input/editor exists: typing and paste cannot alter the displayed text.
+    },
+    invalidate() { text.invalidate(); scroll.invalidate(); },
+  };
+}
+
+export async function showProblemView(
+  ctx: Pick<ExtensionContext, "ui" | "mode">,
+  title: string, body: string, action: string, cancel: string,
+): Promise<boolean> {
+  if (ctx.mode !== "tui") {
+    return await ctx.ui.editor(`${title} — Enter: ${action}; Esc: ${cancel} (not an upload)`,
+      `${body}\n\nViewer only. Enter navigates; it does not upload. Edits are discarded.`) !== undefined;
+  }
+  const lib = await import("@earendil-works/pi-tui");
+  return ctx.ui.custom<boolean>((tui, theme, bindings, done) =>
+    createProblemView(lib, tui, theme, bindings, done, title, body, action, cancel));
+}

package/problems.ts

@@ -1,10 +1,11 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { resolveApiOrigin } from "./config.ts";
+import { showProblemView } from "./problem-view.ts";
 
 export const MAX_PROBLEM_BODY_BYTES = 64 * 1024;
 const MAX_STRING_CHARACTERS = 1000;
 const UNAVAILABLE = "Problem list unavailable. Check the configured server and connection, then try /golf-problems again.";
-const ADVISORY = "Informational only: browsing does not start or bind an attempt. Upload checks remain authoritative. Any edits in this view are discarded.";
+const ADVISORY = "Informational only: browsing does not start or bind an attempt. Upload checks remain authoritative. Nothing is uploaded by browsing.";
 
 interface Problem {
   slug: string;
@@ -72,7 +73,7 @@ async function readCatalogue(response: Response): Promise<Catalogue | undefined>
 let browsing = false;
 export async function browseProblems(
   args: string,
-  ctx: Pick<ExtensionContext, "ui" | "hasUI">,
+  ctx: Pick<ExtensionContext, "ui" | "hasUI" | "mode">,
   options: ProblemOptions = {},
 ): Promise<Result> {
   if (args.trim()) return { message: "Usage: /golf-problems", type: "info" };
@@ -94,22 +95,21 @@ export async function browseProblems(
     if (!data) return { message: UNAVAILABLE, type: "error" };
     const rules = [`Rules version: ${data.rules_version}`, "", ...data.rules, "", ADVISORY];
     if (!data.problems.length) rules.push("", "No problems are currently listed.");
-    // A temporary plain-text editor is supported in TUI and RPC and can scroll
-    // long guidance. Never paste its result into the main editor or session.
-    await ctx.ui.editor("Agent Golf rules — edits discarded", rules.join("\n"));
-    if (data.problems.length) {
+    const continued = await showProblemView(ctx, "Agent Golf rules", rules.join("\n"),
+      data.problems.length ? "view problems" : "close", "close");
+    if (continued && data.problems.length) {
       const labels = data.problems.map((p) => `${p.title.replace(/[\n\t]/g, " ")} (${p.slug})`);
       while (true) {
-        const selected = await ctx.ui.select("Agent Golf problems — advisory; Esc to close", labels);
+        const selected = await ctx.ui.select("Agent Golf problems — choose to view details", labels);
         const index = selected === undefined ? -1 : labels.indexOf(selected);
         if (index < 0) break;
         const problem = data.problems[index];
-        await ctx.ui.editor("Problem details — edits discarded", [
+        await showProblemView(ctx, "Problem details", [
           problem.title, `Problem: ${problem.slug}`, problem.challenge_url,
           `Model: ${problem.model === "any" ? "any model, one per session" : problem.model}`,
           `Thinking level: ${problem.thinking_level === "any" ? "any thinking level" : problem.thinking_level}`,
           "", ...problem.instructions, "", ADVISORY,
-        ].join("\n"));
+        ].join("\n"), "back to problems", "back to problems");
       }
     }
     return { message: "Problem browsing closed. No attempt or setup was changed.", type: "info" };