pi-feats 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-feats",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A modular Pi package for profiles, sandboxing, remote access, applications, guardrails, skills, session management, observability, and web-based operations.",
   "keywords": [
     "pi-package",
@@ -29,6 +29,7 @@
     "scripts",
     "schemas",
     "skills",
+    "themes",
     "README.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
@@ -40,18 +41,18 @@
     "node": ">=22"
   },
   "scripts": {
-    "build:web": "cd extensions/pi-console-webui && npx --no-install next build",
+    "build:web": "node scripts/build-console-webui.mjs",
+    "build:web:next": "cd extensions/pi-console-webui && npx --no-install next build",
     "ensure:nono": "sh scripts/install-nono.sh",
-    "postinstall": "npm run ensure:nono && npm run build:web",
-    "test": "npm run test:composio && npm run build:web",
-    "test:composio": "node --experimental-strip-types --test tests/*.test.ts"
+    "postinstall": "npm run ensure:nono && node scripts/ensure-console-build.mjs",
+    "test": "npm run test:extensions && npm run build:web",
+    "test:extensions": "node --experimental-strip-types --test tests/*.test.ts"
   },
   "dependencies": {
     "@codemirror/lang-javascript": "^6.2.5",
     "@codemirror/lang-json": "^6.0.2",
     "@codemirror/lang-markdown": "^6.5.2",
     "@composio/core": "^0.18.1",
-    "@earendil-works/pi-ai": "^0.85.1",
     "@fastify/websocket": "^11.3.0",
     "@homebridge/node-pty-prebuilt-multiarch": "^0.14.1",
     "@radix-ui/react-slot": "^1.2.4",
@@ -79,14 +80,17 @@
     "remark-gfm": "^4.0.1",
     "tailwind-merge": "^3.0.2",
     "tailwindcss": "^3.4.17",
-    "typebox": "^1.3.30",
     "typescript": "^5.7.2"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*"
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   },
   "pi": {
     "extensions": [
+      "./extensions/cli-tui-mode.ts",
       "./extensions/api-server",
       "./extensions/browser-harness",
       "./extensions/cli-resources.ts",
@@ -104,9 +108,15 @@
     "skills": [
       "./skills"
     ],
+    "themes": [
+      "./themes/*.json"
+    ],
     "image": "https://raw.githubusercontent.com/rjaskonis/pi-feats/v0.1.4/assets/pi-feats-preview.png"
   },
   "devDependencies": {
-    "@types/ws": "^8.18.1"
+    "@earendil-works/pi-ai": "^0.85.1",
+    "@earendil-works/pi-tui": "^0.85.1",
+    "@types/ws": "^8.18.1",
+    "typebox": "^1.3.30"
   }
 }

package/scripts/build-console-webui.mjs

@@ -0,0 +1,7 @@
+import { spawnSync } from "node:child_process";
+import { packageRoot, saveBuildCache } from "./console-webui-cache.mjs";
+
+const result = spawnSync(process.platform === "win32" ? "npm.cmd" : "npm", ["run", "build:web:next"], { cwd: packageRoot, stdio: "inherit" });
+if (result.status !== 0) process.exit(result.status ?? 1);
+await saveBuildCache();
+console.log("Cached Pi Console WebUI build for future updates.");

package/scripts/console-webui-cache.mjs

@@ -0,0 +1,79 @@
+import { createHash } from "node:crypto";
+import { cp, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { execFileSync } from "node:child_process";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+export const webuiRoot = join(packageRoot, "extensions", "pi-console-webui");
+const agentRoot = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+export const cacheRoot = process.env.PI_FEATS_WEB_BUILD_CACHE_DIR ?? join(agentRoot, "cache", "pi-feats", "console-webui");
+const cacheBuild = join(cacheRoot, "next-build");
+const metadataPath = join(cacheRoot, "metadata.json");
+const targetBuild = join(webuiRoot, ".next");
+
+async function sourceHash(path) {
+  const hash = createHash("sha256");
+  const visit = async (directory) => {
+    for (const entry of (await readdir(directory, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name))) {
+      if ([".next", "node_modules"].includes(entry.name)) continue;
+      const fullPath = join(directory, entry.name);
+      if (entry.isDirectory()) await visit(fullPath);
+      else if (entry.isFile()) {
+        hash.update(relative(webuiRoot, fullPath));
+        hash.update(await readFile(fullPath));
+      }
+    }
+  };
+  await visit(path);
+  return hash.digest("hex");
+}
+
+const gitCommit = () => {
+  try { return execFileSync("git", ["rev-parse", "HEAD"], { cwd: packageRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim(); }
+  catch { return undefined; }
+};
+
+export async function buildMetadata() {
+  const next = JSON.parse(await readFile(join(packageRoot, "node_modules", "next", "package.json"), "utf8"));
+  return { sourceHash: await sourceHash(webuiRoot), nodeVersion: process.version, nextVersion: next.version, commit: gitCommit(), builtAt: new Date().toISOString() };
+}
+
+export async function loadCache() {
+  try { return JSON.parse(await readFile(metadataPath, "utf8")); }
+  catch { return undefined; }
+}
+
+export async function cacheStatus() {
+  const metadata = await buildMetadata();
+  const cached = await loadCache();
+  if (!cached || !existsSync(join(cacheBuild, "BUILD_ID"))) return { state: "missing", metadata };
+  if (cached.nodeVersion !== metadata.nodeVersion || cached.nextVersion !== metadata.nextVersion) return { state: "incompatible", metadata, cached };
+  if (cached.sourceHash !== metadata.sourceHash) return { state: "changed", metadata, cached };
+  return { state: "compatible", metadata, cached };
+}
+
+export async function restoreCachedBuild() {
+  if (!existsSync(join(cacheBuild, "BUILD_ID"))) return false;
+  await rm(targetBuild, { recursive: true, force: true });
+  await cp(cacheBuild, targetBuild, { recursive: true });
+  return true;
+}
+
+export async function saveBuildCache(metadata) {
+  if (!metadata) metadata = await buildMetadata();
+  if (!existsSync(join(targetBuild, "BUILD_ID"))) throw new Error("Next.js completed without producing .next/BUILD_ID.");
+  const staging = join(cacheRoot, `next-build-${process.pid}-${Date.now()}`);
+  await mkdir(cacheRoot, { recursive: true });
+  await rm(staging, { recursive: true, force: true });
+  await cp(targetBuild, staging, { recursive: true });
+  await rm(cacheBuild, { recursive: true, force: true });
+  await rename(staging, cacheBuild);
+  await writeFile(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, "utf8");
+}
+
+export async function clearBuildCache() {
+  await rm(cacheRoot, { recursive: true, force: true });
+}

package/scripts/ensure-console-build.mjs

@@ -0,0 +1,43 @@
+import { createInterface } from "node:readline/promises";
+import { spawnSync } from "node:child_process";
+import { clearBuildCache, cacheStatus, packageRoot, restoreCachedBuild } from "./console-webui-cache.mjs";
+
+const mode = process.env.PI_FEATS_BUILD_WEB;
+if (process.env.PI_FEATS_CLEAR_WEB_CACHE === "1") {
+  await clearBuildCache();
+  console.log("Cleared the cached Pi Console WebUI build.");
+}
+
+const build = () => {
+  const result = spawnSync(process.platform === "win32" ? "npm.cmd" : "npm", ["run", "build:web"], { cwd: packageRoot, stdio: "inherit" });
+  if (result.status !== 0) process.exit(result.status ?? 1);
+};
+
+const prompt = async (message) => {
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  const answer = (await readline.question(message)).trim().toLowerCase();
+  readline.close();
+  return answer === "" || answer === "y" || answer === "yes";
+};
+
+if (mode === "1") {
+  console.log("Rebuilding Pi Console WebUI (PI_FEATS_BUILD_WEB=1).");
+  build();
+} else if (mode === "0") {
+  console.log("Skipping Pi Console WebUI rebuild (PI_FEATS_BUILD_WEB=0).");
+} else {
+  const status = await cacheStatus();
+  if (status.state === "compatible" && await restoreCachedBuild()) {
+    console.log("Restored cached Pi Console WebUI build; no frontend changes were detected.");
+  } else {
+    const message = status.state === "changed"
+      ? "Pi Console WebUI changed in this update.\n\nRebuild now? [Y/n]\n  y  Rebuild now (recommended)\n  n  Keep the previous Console build\n> "
+      : "No compatible Pi Console WebUI build is available.\n\nBuild now? [Y/n]\n> ";
+    if (!process.stdin.isTTY || !process.stdout.isTTY || await prompt(message)) {
+      if (!process.stdin.isTTY || !process.stdout.isTTY) console.log("Rebuilding Pi Console WebUI in a non-interactive install.");
+      build();
+    } else {
+      console.log("Skipped Pi Console WebUI rebuild. The Console may not match this package version until you run `npm run build:web`.");
+    }
+  }
+}

package/skills/sequential-workflow/SKILL.md

@@ -62,9 +62,10 @@ Do not inspect, resume, or otherwise select a persisted workflow merely because
 
 - For an `action`, perform the action and call `sequential_workflow_record_result` with `phase: "action"` and a verifiable result summary.
 - For a `collect`, request the required information from the user. After receiving it, call `sequential_workflow_record_result` with `phase: "collect"` and the received response.
-- For a `workflow` task, create the child with `parentTaskId` set to that task ID. The parent task waits automatically; do not record a result for it.
-- If a task has `criteria`, call `sequential_workflow_evaluate` to record whether the criterion was accepted. Do not advance before acceptance.
+- For a `workflow` task, call `sequential_workflow_create_subworkflow` with both `parentWorkflowId` and `parentTaskId` for that current task. The parent task waits automatically; do not record a result for it.
+- If a task has `criteria`, call `sequential_workflow_evaluate` with `outcome: "accept"`, `"retry"`, or `"fail"`. Do not advance before acceptance.
+- Use `retry` only when another execution could change the outcome. After recording evidence, use `fail` when the task cannot safely progress; this ends the workflow without advancing or consuming retry attempts.
 - For an `evaluate`, assess the available information according to the instruction and call `sequential_workflow_evaluate`.
 - If an evaluation rejects an `action`, correct or repeat the current action. If it rejects a `collect`, explain what is missing and request the information again. A rejected `workflow` task becomes runnable again and may create a replacement child.
 
-`parentWorkflowId` creates a hierarchical relationship only. `parentTaskId` additionally creates an operational dependency: the parent task waits for that child. Use `sequential_workflow_status` without an ID to list this session's active workflows or with `workflowId` to inspect an owned execution. Status never changes focus. When the user requests cancellation, call `sequential_workflow_cancel` with the workflow ID. Cancellation is available across sessions in the same profile and does not require adoption. It cancels only that workflow; a cancelled child is surfaced to its parent for evaluation and descendants are not cancelled automatically. `/workflow-cancel <workflowId>` remains available as an explicit user control.
+`sequential_workflow_create` creates only root workflows and hydrates a focused `pending_definition`; it has no parent parameters and never creates a child. `sequential_workflow_create_subworkflow` creates the hierarchical relationship and operational dependency for a current `workflow` task. Use `sequential_workflow_status` without an ID to list this session's active workflows or with `workflowId` to inspect an owned execution. Status never changes focus. When the user requests cancellation, call `sequential_workflow_cancel` with the workflow ID. Cancellation is available across sessions in the same profile and does not require adoption. It cancels only that workflow; a cancelled child is surfaced to its parent for evaluation and descendants are not cancelled automatically. `/workflow-cancel <workflowId>` remains available as an explicit user control.

package/themes/legacy-dark.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "legacy-dark",
+  "vars": {
+    "cyan": "#00d7ff",
+    "blue": "#5f87ff",
+    "green": "#b5bd68",
+    "red": "#cc6666",
+    "yellow": "#ffff00",
+    "text": "#d4d4d4",
+    "gray": "#808080",
+    "dimGray": "#666666",
+    "darkGray": "#505050",
+    "accent": "#8abeb7",
+    "selectedBg": "#3a3a4a",
+    "userMsgBg": "#343541",
+    "toolPendingBg": "#282832",
+    "toolSuccessBg": "#283228",
+    "toolErrorBg": "#3c2828",
+    "customMsgBg": "#2d2838"
+  },
+  "colors": {
+    "accent": "accent",
+    "border": "blue",
+    "borderAccent": "cyan",
+    "borderMuted": "darkGray",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "gray",
+    "dim": "dimGray",
+    "text": "text",
+    "thinkingText": "gray",
+    "selectedBg": "selectedBg",
+    "scrollbarTrack": "darkGray",
+    "scrollbarThumb": "text",
+    "searchMatchBg": "selectedBg",
+    "searchMatchText": "text",
+    "userMessageBg": "userMsgBg",
+    "userMessageText": "text",
+    "customMessageBg": "customMsgBg",
+    "customMessageText": "text",
+    "customMessageLabel": "#9575cd",
+    "toolPendingBg": "toolPendingBg",
+    "toolSuccessBg": "toolSuccessBg",
+    "toolErrorBg": "toolErrorBg",
+    "toolTitle": "text",
+    "toolOutput": "gray",
+    "mdHeading": "#f0c674",
+    "mdLink": "#81a2be",
+    "mdLinkUrl": "dimGray",
+    "mdCode": "accent",
+    "mdCodeBlock": "green",
+    "mdCodeBlockBorder": "gray",
+    "mdQuote": "gray",
+    "mdQuoteBorder": "gray",
+    "mdHr": "gray",
+    "mdListBullet": "accent",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "gray",
+    "syntaxComment": "#6A9955",
+    "syntaxKeyword": "#569CD6",
+    "syntaxFunction": "#DCDCAA",
+    "syntaxVariable": "#9CDCFE",
+    "syntaxString": "#CE9178",
+    "syntaxNumber": "#B5CEA8",
+    "syntaxType": "#4EC9B0",
+    "syntaxOperator": "#D4D4D4",
+    "syntaxPunctuation": "#D4D4D4",
+    "thinkingOff": "darkGray",
+    "thinkingMinimal": "#6e6e6e",
+    "thinkingLow": "#5f87af",
+    "thinkingMedium": "#81a2be",
+    "thinkingHigh": "#b294bb",
+    "thinkingXhigh": "#d183e8",
+    "thinkingMax": "#ff5fff",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "#18181e",
+    "cardBg": "#1e1e24",
+    "infoBg": "#3c3728"
+  }
+}