pi-feats 0.1.4 → 0.1.7

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/profile-ssh/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: profile-ssh
+description: Use when connecting to hosts over SSH or when the user asks to register an SSH host for a Pi profile. Covers ordinary SSH plus the optional profile-scoped SSH configuration created by `pi ssh add`.
+---
+
+# Profile SSH
+
+Use SSH normally unless a profile-scoped host is relevant. Profile SSH is an additional access mechanism; it does not replace the user's existing `~/.ssh/config`, SSH agent, global keys, or direct `ssh user@host` access.
+
+## Choose the access method
+
+1. **Ordinary SSH first** when the user gives a host, username, global alias, or has existing SSH credentials:
+
+   ```bash
+   ssh user@host
+   ssh existing-global-alias
+   ```
+
+   Respect the user's normal SSH configuration and agent. Do not assume a profile SSH host exists.
+
+2. **Profile-scoped SSH** when the user refers to a host registered with `pi ssh add`, `pi profile <profile> ssh add`, or asks to use the current profile's SSH registration.
+
+   The profile config is not `~/.ssh/config`; use it explicitly:
+
+   ```bash
+   ssh -F "$PI_CODING_AGENT_DIR/.ssh/config" <alias>
+   ```
+
+   `$PI_CODING_AGENT_DIR` identifies the active Pi profile. This keeps profile keys, known-host entries, and aliases isolated from global SSH configuration.
+
+## Register a profile host
+
+Only register a host when the user asks to do so or approves the setup. Run one of:
+
+```bash
+pi ssh add <alias>
+pi profile <profile> ssh add <alias>
+# Supported shorthand:
+pi profile <profile> add <alias>
+```
+
+The setup uses the alias as the default hostname, then asks for the IP address, port, and remote user. It shows the server fingerprint for confirmation and selects an Ed25519 key for modern servers or an RSA-4096 key for legacy OpenSSH servers. It first tests that key without password fallback. If authorization is needed, `ssh-copy-id` prompts for the remote password once; the setup only saves the host after the same key-only validation succeeds.
+
+List or remove profile-managed hosts with:
+
+```bash
+pi ssh list
+pi profile <profile> ssh list
+pi ssh delete <alias>
+pi profile <profile> ssh delete <alias>
+```
+
+## Safe connection checks
+
+For a non-interactive verification, prefer:
+
+```bash
+ssh -F "$PI_CODING_AGENT_DIR/.ssh/config" \
+  -o BatchMode=yes -o ConnectTimeout=15 \
+  <alias> true
+```
+
+Keep host-key verification enabled. Do **not** suggest or add `StrictHostKeyChecking=no`, and do not put passwords in shell commands, scripts, settings, prompts, or logs.
+
+If authentication fails, report the failure succinctly. Ask the user whether they want to use their normal SSH credentials or register/profile-authorize a key with `pi ssh add`; do not attempt to discover, copy, or expose private credentials.

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"
+  }
+}