rakerun 0.1.0 → 0.1.1

package/README.md

@@ -13,7 +13,7 @@ npm install -g @cloudraker/run-cli
 rakerun --help
 ```
 
-Node 22 or newer. No runtime dependency: `run-core` (the push lint) is bundled in.
+Node 22 or newer. Two runtime dependencies, Ink and React, for the template picker. The push lint of `run-core` is bundled in.
 
 ## First contact
 
@@ -22,8 +22,9 @@ rakerun start
 ```
 
 `rakerun start` opens the console sign-up, creates the organization and a CLI token (the browser
-hands it to the terminal), then asks for a project name and the templates to import, creates
-the repo, and deploys. Three steps, one terminal.
+hands it to the terminal), then asks for a project name, opens the template picker (grouped by
+category; arrow keys, space to select, type to filter, enter), creates the repo, and deploys.
+Three steps, one terminal.
 
 ## Log in
 

package/dist/rakerun.js

@@ -9,6 +9,9 @@ import { createInterface } from "node:readline/promises";
 import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
+import { Box, Text, render, useApp, useInput } from "ink";
+import { useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
@@ -15550,7 +15553,7 @@ function normalizeBaseUrl(input) {
 }
 //#endregion
 //#region src/help.ts
-const VERSION = "0.1.0";
+const VERSION = "0.1.1";
 const HELP = `rakerun ${VERSION}: the command line of cloudraker.run
 
 Usage: rakerun <command> [subcommand] [options]
@@ -16605,7 +16608,7 @@ async function deploy(ctx) {
 }
 const PLATFORM = `https://${DEFAULT_DOMAIN}`;
 /** Picks template ids from a numbered list: `1,3` or ids. Empty: none. */
-function pickTemplates(answer, templates) {
+function pickTemplates$1(answer, templates) {
 	const picks = answer.split(/[\s,]+/).filter(Boolean);
 	const chosen = [];
 	for (const pick of picks) {
@@ -16645,15 +16648,19 @@ async function start(initial) {
 		io.err(REPO_NAME.test(name) ? `${name} exists here and is not empty.` : "Letters, digits, dots, dashes and underscores only.");
 	}
 	const dir = resolve(io.cwd, name);
-	const catalog = await call(ctx, "/_console/templates").catch(() => ({ templates: [] }));
+	const catalog = await call(ctx, "/_console/templates").catch(() => ({
+		templates: [],
+		categories: []
+	}));
 	let chosen = [];
-	if (catalog.templates.length) {
+	if (catalog.templates.length && io.pickTemplates) chosen = await io.pickTemplates(catalog.templates, catalog.categories);
+	else if (catalog.templates.length) {
 		io.err("\nTemplates:");
 		catalog.templates.forEach((t, i) => io.err(`  ${String(i + 1).padStart(2)}. ${t.id.padEnd(28)} ${t.description}`));
 		for (;;) {
 			const answer = await io.ask("Pick templates (numbers, comma separated; empty for a starter agent)", "");
 			try {
-				chosen = pickTemplates(answer, catalog.templates);
+				chosen = pickTemplates$1(answer, catalog.templates);
 				break;
 			} catch (error) {
 				io.err(error.message);
@@ -16799,6 +16806,140 @@ async function main(io) {
 	}
 }
 //#endregion
+//#region src/ui/template-picker.tsx
+/** Rows shown at once. The list scrolls around the cursor. */
+const WINDOW = 14;
+function rowsOf(templates, categories, filter) {
+	const q = filter.trim().toLowerCase();
+	const shown = q ? templates.filter((t) => `${t.id} ${t.name} ${t.description}`.toLowerCase().includes(q)) : templates;
+	const names = new Map(categories.map((c) => [c.id, c.name]));
+	const rows = [];
+	for (const category of new Set(shown.map((t) => t.category))) {
+		rows.push({
+			kind: "header",
+			name: names.get(category) ?? category
+		});
+		for (const template of shown.filter((t) => t.category === category)) rows.push({
+			kind: "item",
+			template
+		});
+	}
+	return rows;
+}
+function Picker({ templates, categories, onDone }) {
+	const { exit } = useApp();
+	const [filter, setFilter] = useState("");
+	const [cursor, setCursor] = useState(0);
+	const [chosen, setChosen] = useState(/* @__PURE__ */ new Set());
+	const rows = useMemo(() => rowsOf(templates, categories, filter), [
+		templates,
+		categories,
+		filter
+	]);
+	const items = rows.map((r, i) => r.kind === "item" ? i : -1).filter((i) => i >= 0);
+	const at = items[Math.min(cursor, Math.max(items.length - 1, 0))];
+	const current = at === void 0 ? null : rows[at].template;
+	useInput((input, key) => {
+		if (key.return) {
+			onDone(templates.filter((t) => chosen.has(t.id)));
+			exit();
+		} else if (key.escape) {
+			onDone([]);
+			exit();
+		} else if (key.upArrow) setCursor((c) => Math.max(0, c - 1));
+		else if (key.downArrow) setCursor((c) => Math.min(items.length - 1, c + 1));
+		else if (input === " " && current) setChosen((s) => {
+			const next = new Set(s);
+			if (next.has(current.id)) next.delete(current.id);
+			else next.add(current.id);
+			return next;
+		});
+		else if (key.backspace || key.delete) {
+			setFilter((f) => f.slice(0, -1));
+			setCursor(0);
+		} else if (input && !key.ctrl && !key.meta) {
+			setFilter((f) => f + input);
+			setCursor(0);
+		}
+	});
+	const start = Math.max(0, Math.min((at ?? 0) - Math.floor(WINDOW / 2), rows.length - WINDOW));
+	const visible = rows.slice(start, start + WINDOW);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: "Templates"
+			}), /* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: ["  ", "↑↓ move · space select · type to filter · enter confirm · esc for a starter agent"]
+			})] }),
+			/* @__PURE__ */ jsxs(Text, { children: [
+				/* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: "Filter: "
+				}),
+				/* @__PURE__ */ jsx(Text, { children: filter || " " }),
+				/* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: [
+						"  ",
+						chosen.size,
+						" selected"
+					]
+				})
+			] }),
+			visible.map((row, i) => row.kind === "header" ? /* @__PURE__ */ jsxs(Text, {
+				bold: true,
+				color: "cyan",
+				children: [start + i > 0 ? "\n" : "", row.name]
+			}, `h-${row.name}`) : /* @__PURE__ */ jsxs(Text, {
+				inverse: row.template === current,
+				children: [
+					chosen.has(row.template.id) ? " ◉ " : " ○ ",
+					row.template.id.padEnd(28),
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: row.template.name
+					})
+				]
+			}, row.template.id)),
+			rows.length > WINDOW ? /* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: [
+					start + 1,
+					"-",
+					Math.min(start + WINDOW, rows.length),
+					" of ",
+					rows.length
+				]
+			}) : null,
+			current ? /* @__PURE__ */ jsxs(Box, {
+				marginTop: 1,
+				flexDirection: "column",
+				children: [/* @__PURE__ */ jsx(Text, { children: current.description }), /* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: [current.mode, current.connectors.length ? ` · connectors: ${current.connectors.map((c) => c.required ? `${c.id}*` : c.id).join(", ")}` : ""]
+				})]
+			}) : /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "No template matches."
+			})
+		]
+	});
+}
+/** Renders the picker on the terminal and resolves with the chosen templates. */
+function pickTemplates(templates, categories) {
+	return new Promise((resolve) => {
+		let chosen = [];
+		render(/* @__PURE__ */ jsx(Picker, {
+			templates,
+			categories,
+			onDone: (c) => chosen = c
+		}), { exitOnCtrlC: true }).waitUntilExit().then(() => resolve(chosen));
+	});
+}
+//#endregion
 //#region src/index.ts
 /** All of stdin. A pipe ends it; a terminal ends it on Ctrl-D. */
 async function stdin() {
@@ -16971,6 +17112,7 @@ process.exitCode = await main({
 	stdinIsTty: process.stdin.isTTY === true,
 	readSecret,
 	ask,
+	pickTemplates: process.stdin.isTTY && process.stdout.isTTY ? pickTemplates : null,
 	callback,
 	open,
 	exec,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rakerun",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "rakerun: the command line of cloudraker.run. Sign up, create projects from templates, deploy agents, run them, and manage secrets, connectors, tokens and Structured Knowledge from the terminal.",
   "keywords": [
     "agents",
@@ -39,8 +39,13 @@
     "format:check": "oxfmt --check .",
     "prepublishOnly": "pnpm build"
   },
+  "dependencies": {
+    "ink": "8.0.0",
+    "react": "19.3.1"
+  },
   "devDependencies": {
     "@types/node": "26.6.1",
+    "@types/react": "^19.3.0",
     "oxfmt": "catalog:",
     "oxlint": "catalog:",
     "run-core": "workspace:*",