@computesdk/loops 0.0.0-stage → 0.1.1

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@computesdk/loops",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Loops for people who do not live in a terminal: one command starts a localhost UI that runs, watches and steers hill-climbing agents in your repos.",
+  "keywords": [
+    "pi",
+    "pi-extension",
+    "loops",
+    "hill-climbing",
+    "agents",
+    "ui"
+  ],
+  "license": "MIT",
+  "bin": {
+    "loops": "./bin/loops.mjs",
+    "pi-loops-ui": "./bin/pi-loops-ui.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "client.ts",
+    "src/shared",
+    "README.md",
+    "API.md"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "scripts": {
+    "dev": "node --experimental-strip-types server/dev.ts",
+    "build": "npm run build:spa && npm run build:server",
+    "build:spa": "vite build",
+    "build:server": "esbuild server/index.ts --bundle --platform=node --format=esm --target=node22 --define:__LOOPS_BUNDLED__=true --outfile=dist/server.mjs --log-level=warning",
+    "prepack": "npm run build",
+    "start": "node --experimental-strip-types server/index.ts",
+    "check": "tsc --noEmit && tsc --noEmit -p tsconfig.client.json",
+    "shots": "node shots.mjs",
+    "test": "esbuild test/compare.ts --bundle --platform=node --format=cjs --outfile=node_modules/.tmp/compare.cjs --loader:.tsx=tsx --jsx=automatic --log-level=error && node node_modules/.tmp/compare.cjs && node --experimental-strip-types test/runs.ts && node --experimental-strip-types test/api.ts && node --experimental-strip-types test/cli.ts"
+  },
+  "dependencies": {
+    "@computesdk/pi-loops": "^1.0.7",
+    "@hono/node-server": "^1.19.5",
+    "hono": "^4.9.10"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "catalog:",
+    "@streamdown/cjk": "^1.0.4",
+    "@streamdown/code": "^2.0.0",
+    "@streamdown/math": "^1.0.3",
+    "@streamdown/mermaid": "^1.0.3",
+    "@tailwindcss/vite": "^4.1.14",
+    "@types/node": "catalog:",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@types/ws": "^8.18.2",
+    "@vitejs/plugin-react": "^5.1.0",
+    "clsx": "^2.1.1",
+    "esbuild": "^0.28.2",
+    "lucide-react": "^1.62.0",
+    "motion": "^14.7.1",
+    "puppeteer-core": "^25.16.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "streamdown": "^2.7.1",
+    "tailwind-merge": "^3.4.0",
+    "tailwindcss": "^4.1.14",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "catalog:",
+    "use-stick-to-bottom": "^1.1.6",
+    "vite": "^7.1.9",
+    "ws": "^8.22.0"
+  },
+  "exports": {
+    ".": "./client.ts",
+    "./client": "./client.ts"
+  }
+}

package/src/shared/types.ts

@@ -0,0 +1,180 @@
+// The shapes the UI renders. They are the *view* of a run: everything here is derived on the server from
+// Pi's session entries (`loops-run`, `loops-round`, `loops-question`, tool results), the run's state file and
+// the worktrees it owns. Nothing polls: a live round arrives as `tool_execution_update` from the RPC child.
+
+export type RunAttempt = {
+  /** `run:rN-L` */
+  id: string;
+  /** `rN-L`, what `loop_talk` and `loop_pick` take */
+  name: string;
+  label: string;
+  model: string;
+  style: string;
+  /** running | done | error | unchanged | aborted | timeout | budget */
+  status: string;
+  score?: number;
+  kept?: boolean;
+  humanPick?: boolean;
+  summary?: string;
+  reason?: string;
+  /** URL of the attempt's screenshot, when the run writes one */
+  shot?: string;
+  shotMobile?: string;
+  live?: string;
+  ms?: number;
+  tokens?: number;
+  cost?: number;
+  hasSession: boolean;
+  bench?: { passed: boolean; tests?: string; value?: number; samples?: number[]; error?: string };
+  review?: { ok: boolean; note: string };
+  vetoed?: boolean;
+  h2h?: { wins: number; losses: number; ties: number; votes: number };
+  spread?: number;
+  /** the worktree, relative to the repo — where the attempt's files live (gone once the run is cleaned) */
+  dir?: string;
+  commit?: string;
+  /** set when the worktree has been removed and only the commit remains */
+  cleaned?: boolean;
+  /** the judge could not see this attempt's screenshot, so it has no score — not a zero */
+  unscored?: boolean;
+};
+
+export type RunRound = {
+  n: number;
+  from: { round: number; label: string; byHuman?: boolean };
+  attempts: RunAttempt[];
+  current?: { score?: number; reason?: string; shot?: string; live?: string; kept?: boolean };
+  pick?: string;
+  why?: string;
+  judging?: boolean;
+  inProgress: boolean;
+  /** the round's contact sheet: one image with every candidate */
+  sheet?: string;
+  judgeTokens?: number;
+  judgeCost?: number;
+  startedAt?: number;
+  endedAt?: number;
+  /** screenshots kept in the run's own folder, by attempt label */
+  shots?: Record<string, string[]>;
+  /** the judge never saw the images: nothing in this round was compared */
+  inconclusive?: boolean;
+  /** an attempt committed into your checkout; `restored` says whether it was put back */
+  escaped?: { from: string; to: string; restored?: boolean } | null;
+  /** candidates whose stamped code the judge could not read back */
+  unseen?: string[];
+};
+
+export type RunEvent = { t: number; kind: string; text: string; round?: number; pick?: string; why?: string; scores?: Record<string, number>; source?: string; label?: string; note?: string };
+
+export type RunMetric = { key: string; unit: string; better: "lower" | "higher"; label?: string };
+
+export type Question = {
+  id: string;
+  t: number;
+  round?: number;
+  /** close | veto | stall | apply | ask */
+  kind: string;
+  source: "loop" | "parent";
+  text: string;
+  detail?: string;
+  /** the attempt the question is about */
+  label?: string;
+  options: { label: string; steer?: Record<string, unknown> }[];
+  answered?: { i?: number; auto?: string; t: number };
+};
+
+export type Run = {
+  id: string;
+  /** the chat (Pi session) that owns this loop */
+  chat: string;
+  kind: "visual" | "bench";
+  metric?: RunMetric;
+  baseline?: number;
+  name: string;
+  goal: string;
+  status: "running" | "paused" | "done" | "error" | "stalled";
+  alive: boolean;
+  stopReason?: string;
+  rules: { text: string; source: string }[];
+  rounds: RunRound[];
+  best: { round: number; label: string; score?: number; shot?: string; live?: string; byHuman?: boolean };
+  scores: number[];
+  maxRounds: number;
+  tokens: number;
+  log: RunEvent[];
+  pendingSteer: number;
+  pending: RunEvent[];
+  questions: Question[];
+  /** what a frontend needs to fetch artifacts: the repo the run lives in */
+  cwd?: string;
+  baseCommit?: string;
+  editedBaseline?: boolean;
+  winnerFiles?: { changed: string[]; added: string[]; removed: string[] } | null;
+};
+
+export type TItem =
+  | { t: "user"; text: string; inherited: boolean }
+  | { t: "agent"; text: string; inherited: boolean }
+  | { t: "tool"; name: string; args: string; out?: string; inherited: boolean };
+
+export type ParentItem =
+  | { t: "user"; ts: number; text: string }
+  | { t: "text"; ts: number; text: string }
+  | { t: "tool"; ts: number; cmd: string; out?: string };
+
+export type ParentLive = { busy: boolean; chat?: string; startedAt: number; user: string; text: string; tools: { id: string; cmd: string; done: boolean }[]; error?: string };
+
+/** Enough about a chat to draw its sidebar row without opening it: derived from its own session file. */
+export type ChatSummary = {
+  loops: number;
+  running: number;
+  open: number;
+  /** the newest open question, if any */
+  question?: { kind: string; round?: number; title: string };
+  lastT: number;
+  latest?: { name: string; status: string; kind: "visual" | "bench"; score?: number; unit?: string; rounds: number };
+  /** a run whose process went away: it says running, nothing is working */
+};
+
+export type ChatInfo = { id: string; title: string; ts: number; last: number; summary?: ChatSummary; ws?: string };
+
+/** A repo this app may loop in. The browser names an id; the server resolves the path. */
+export type Workspace = { id: string; path: string; sessionDir: string; title: string };
+
+/** `/loop doctor`, read from the session: settings with their source, and what the repo can and cannot do. */
+export type DoctorReport = {
+  cwd: string;
+  at: number;
+  settings: Record<string, { value: any; source: string }>;
+  models: { safe?: string | null; bold?: string | null; wild?: string | null; judge?: string | null; council: (string | null)[]; spread?: boolean; pool?: string[] };
+  vision: Record<string, boolean | null>;
+  chrome: boolean;
+  repo: { repo: boolean; head?: string; dirty?: boolean };
+  panel: boolean;
+  deps: boolean;
+  ready: { bench: boolean; check: boolean; visual: boolean };
+  workspace?: Workspace;
+};
+
+export type ModelOption = { id: string; provider: string; model: string; images: boolean | null };
+
+/** What the server returns for one chat: its transcript, its loops and its live turn. */
+/** A change to `.pi/loops.json` an agent made while the UI was open: held, because it decides how loops are judged. */
+export type ConfigProposal = { id: string; at: number; file: string; changes: { key: string; from: string; to: string }[] };
+
+export type ChatState = {
+  chat: string;
+  title?: string;
+  chats: ChatInfo[];
+  workspaces?: Workspace[];
+  ws?: string;
+  items: ParentItem[];
+  live: ParentLive | null;
+  error?: string;
+  runs: Run[];
+  model?: string | null;
+  /** open questions for chats that are not loaded, so the sidebar can count them */
+  busyElsewhere?: boolean;
+  /** config writes waiting for a yes/no; the file is unchanged until one */
+  proposals?: ConfigProposal[];
+};