@lazyingart/agintiflow 0.20.123 → 0.20.125

package/README.md

@@ -103,7 +103,9 @@ Provider signup and key pages:
 | Qwen / DashScope | [https://bailian.console.aliyun.com/](https://bailian.console.aliyun.com/) | `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` |
 | GRS AI image tools | [https://grsai.ai/dashboard/api-keys](https://grsai.ai/dashboard/api-keys) | Configure with `/auxiliary grsai` or `aginti login grsai` |
 
-The CLI auto-starts or reuses the local web UI from the same project. It tries `http://127.0.0.1:3210` first, then `3211`, `3212`, and so on if the port is already occupied. The active URL is shown in the CLI launch header.
+The CLI quietly auto-starts or reuses the local web UI from the same project. It tries `http://127.0.0.1:3210` first, then `3211`, `3212`, and so on if the port is already occupied. The active URL is shown in the CLI launch header. If startup is blocked or unavailable, the same header row shows the recovery hint; run `/webapp [port]` inside the CLI to retry.
+
+Package installation also makes a best-effort, non-blocking webapp initialization. Install never fails because the optional local webapp could not start.
 
 Launch the web UI explicitly when you want a foreground web server:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.20.123",
+  "version": "0.20.125",
   "type": "module",
   "description": "AgInTiFlow is a project-aware agent workspace for hybrid wet-dry R&D, hardware-aware intelligence, software automation, and industrial workflows.",
   "license": "Apache-2.0",
@@ -50,6 +50,7 @@
     "scripts/install-docker-ubuntu.sh",
     "scripts/setup-agent-toolchain-docker.sh",
     "scripts/real-deepseek-capabilities.js",
+    "scripts/postinstall-webapp.js",
     "scripts/smoke-auxiliary-tools.js",
     "scripts/smoke-auth.js",
     "scripts/smoke-aaps-adapter.js",
@@ -70,6 +71,7 @@
     "scripts/smoke-toolchain-docker.js",
     "scripts/smoke-web-autostart.js",
     "scripts/smoke-web-api.js",
+    "scripts/smoke-webapp-command.js",
     "scripts/smoke-web-port-fallback.js",
     "src/",
     "run.js",
@@ -103,12 +105,14 @@
     "smoke:tmux-tools": "node scripts/smoke-tmux-tools.js",
     "smoke:web-api": "node scripts/smoke-web-api.js",
     "smoke:web-autostart": "node scripts/smoke-web-autostart.js",
+    "smoke:webapp-command": "node scripts/smoke-webapp-command.js",
     "smoke:web-port-fallback": "node scripts/smoke-web-port-fallback.js",
     "smoke:autoupdate": "node scripts/smoke-auto-update.js",
     "real:deepseek": "node scripts/real-deepseek-capabilities.js",
+    "postinstall": "node scripts/postinstall-webapp.js",
     "supervision:seed": "node scripts/seed-supervised-homework.js",
     "storage:migrate": "node bin/aginti-cli.js storage migrate",
-    "test": "npm run check && npm run smoke:autoupdate && npm run smoke:web-api && npm run smoke:web-autostart && npm run smoke:web-port-fallback && npm run smoke:coding-tools && npm run smoke:dynamic-step-budget && npm run smoke:aaps-adapter && npm run smoke:auxiliary-tools && npm run smoke:perception-research && npm run smoke:auth && npm run smoke:canvas-artifacts && npm run smoke:capabilities && npm run smoke:model-roles && npm run smoke:platform && npm run smoke:permission-modes && npm run smoke:skills && npm run smoke:skillmesh && npm run smoke:tmux-tools && npm run smoke:cli-chat && npm run smoke:inbox",
+    "test": "npm run check && npm run smoke:autoupdate && npm run smoke:web-api && npm run smoke:web-autostart && npm run smoke:webapp-command && npm run smoke:web-port-fallback && npm run smoke:coding-tools && npm run smoke:dynamic-step-budget && npm run smoke:aaps-adapter && npm run smoke:auxiliary-tools && npm run smoke:perception-research && npm run smoke:auth && npm run smoke:canvas-artifacts && npm run smoke:capabilities && npm run smoke:model-roles && npm run smoke:platform && npm run smoke:permission-modes && npm run smoke:skills && npm run smoke:skillmesh && npm run smoke:tmux-tools && npm run smoke:cli-chat && npm run smoke:inbox",
     "pack:dry-run": "npm pack --dry-run",
     "smoke:capabilities": "node scripts/smoke-capabilities.js"
   },

package/scripts/postinstall-webapp.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ensureAgintiWebApp } from "../src/web-autostart.js";
+
+const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const cwd = process.env.INIT_CWD || process.cwd();
+
+if (process.env.CI === "true" || process.env.AGINTIFLOW_SKIP_POSTINSTALL_WEBAPP === "1") {
+  process.exit(0);
+}
+
+try {
+  await ensureAgintiWebApp({
+    packageDir,
+    cwd,
+    host: process.env.AGINTI_WEB_HOST || "127.0.0.1",
+    preferredPort: process.env.AGINTI_WEB_PORT || 3210,
+    language: process.env.AGINTI_LANGUAGE || "",
+  });
+} catch {
+  // Installation must not fail because the optional local webapp could not be started.
+}

package/scripts/smoke-cli-chat.js

@@ -326,6 +326,15 @@ try {
   if (!launchHeaderWithWeb.includes("webapp: http://127.0.0.1:3210")) {
     throw new Error("launch header did not render the active webapp URL in the tagline row");
   }
+  const launchHeaderWithWebError = buildLaunchHeaderLines({
+    width: 120,
+    packageVersion: "0.0.0",
+    animated: false,
+    webAppNotice: "webapp unavailable - use /webapp to retry; error: smoke failure",
+  }).join("\n");
+  if (!launchHeaderWithWebError.includes("webapp unavailable - use /webapp to retry")) {
+    throw new Error("launch header did not render webapp recovery advice in the tagline row");
+  }
   if (
     formatElapsedDuration(0) !== "00:00" ||
     formatElapsedDuration(65_000) !== "01:05" ||
@@ -650,6 +659,7 @@ try {
     !helpResult.stdout.includes("/auxiliary") ||
     !helpResult.stdout.includes("/review") ||
     !helpResult.stdout.includes("/scs") ||
+    !helpResult.stdout.includes("/webapp") ||
     !helpResult.stdout.includes("/safe") ||
     helpResult.stdout.includes("helpReview") ||
     helpResult.stdout.includes("helpRename") ||

package/scripts/smoke-webapp-command.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { execFile as execFileCallback, spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const runtimeDir = await fs.mkdtemp(path.join(os.tmpdir(), "agintiflow-webapp-command-"));
+const execFile = promisify(execFileCallback);
+
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function waitFor(predicate, child, label, output) {
+  const deadline = Date.now() + 12000;
+  while (Date.now() < deadline) {
+    if (predicate()) return true;
+    if (child.exitCode !== null) break;
+    await delay(150);
+  }
+  const { stdout, stderr } = output;
+  throw new Error(`${label} timed out. stdout=${stdout.slice(-1000)} stderr=${stderr.slice(-1000)}`);
+}
+
+async function killPort(port) {
+  try {
+    const { stdout: pids } = await execFile("lsof", [`-tiTCP:${port}`, "-sTCP:LISTEN"]);
+    for (const pid of pids.split(/\s+/).filter(Boolean)) {
+      try {
+        process.kill(Number(pid), "SIGTERM");
+      } catch {
+        // Ignore already-exited listeners.
+      }
+    }
+  } catch {
+    // lsof may be unavailable; the temporary port listener will otherwise be reusable by later tests.
+  }
+}
+
+async function runCase({ port, env = {}, expectHeader, label }) {
+  const output = { stdout: "", stderr: "" };
+  const child = spawn(process.execPath, [path.join(repoRoot, "bin/aginti-cli.js"), "chat", "--provider", "mock", "--routing", "manual", "--port", String(port)], {
+    cwd: runtimeDir,
+    env: {
+      ...process.env,
+      AGINTIFLOW_NO_ANIMATION: "1",
+      AGINTIFLOW_HOME: path.join(runtimeDir, `.agintiflow-home-${label}`),
+      ...env,
+    },
+    stdio: ["pipe", "pipe", "pipe"],
+  });
+
+  child.stdout.on("data", (chunk) => {
+    output.stdout += chunk.toString();
+  });
+  child.stderr.on("data", (chunk) => {
+    output.stderr += chunk.toString();
+  });
+
+  try {
+    await waitFor(() => output.stdout.includes(expectHeader), child, `${label} launch header`, output);
+    child.stdin.write(`/webapp ${port}\n`);
+    await waitFor(() => output.stdout.includes(`webapp=http://127.0.0.1:${port}`), child, `${label} /webapp command`, output);
+    const health = await fetch(`http://127.0.0.1:${port}/health`).then((response) => response.json());
+    if (!health.ok || health.app !== "agintiflow" || Number(health.port) !== port) {
+      throw new Error(`invalid /webapp health response for ${label}: ${JSON.stringify(health)}`);
+    }
+  } finally {
+    child.kill("SIGTERM");
+    await killPort(port);
+  }
+}
+
+const autoPort = 45600 + Math.floor(Math.random() * 300);
+const manualPort = autoPort + 301;
+
+try {
+  await runCase({
+    port: autoPort,
+    expectHeader: `webapp: http://127.0.0.1:${autoPort}`,
+    label: "auto-start",
+  });
+  await runCase({
+    port: manualPort,
+    env: { AGINTIFLOW_NO_WEB_AUTO_START: "1" },
+    expectHeader: "webapp auto-start disabled - use /webapp to start manually",
+    label: "manual-disabled",
+  });
+  console.log(`webapp slash command smoke passed: http://127.0.0.1:${autoPort}, http://127.0.0.1:${manualPort}`);
+} finally {
+  await killPort(autoPort);
+  await killPort(manualPort);
+  await fs.rm(runtimeDir, { recursive: true, force: true });
+}

package/src/cli.js

@@ -107,6 +107,14 @@ async function maybeEnsureDefaultWebApp(args = {}, { commandCwd = process.cwd()
   }
 }
 
+function webAppNotice(result) {
+  if (!result || result.ok) return "";
+  if (result.disabled) return "webapp auto-start disabled - use /webapp to start manually";
+  const error = String(result.error || "unknown").replace(/\s+/g, " ").trim();
+  const compact = error.length > 84 ? `${error.slice(0, 83)}…` : error;
+  return `webapp unavailable - use /webapp to retry; error: ${compact}`;
+}
+
 const CLI_VALUE_OPTIONS = new Set([
   "--port",
   "--host",
@@ -1755,6 +1763,7 @@ export async function main(argv = process.argv.slice(2)) {
         packageDir,
         packageVersion: packageJson.version,
         webAppUrl: webLaunch.ok ? webLaunch.url : "",
+        webAppNotice: webAppNotice(webLaunch),
       });
       return;
     }
@@ -1783,7 +1792,12 @@ export async function main(argv = process.argv.slice(2)) {
 
   if (args.interactive || (!args.goal && !args.resume && process.stdin.isTTY)) {
     const webLaunch = await maybeEnsureDefaultWebApp(args, { commandCwd });
-    await startInteractiveCli(agentDefaults(args), { packageDir, packageVersion: packageJson.version, webAppUrl: webLaunch.ok ? webLaunch.url : "" });
+    await startInteractiveCli(agentDefaults(args), {
+      packageDir,
+      packageVersion: packageJson.version,
+      webAppUrl: webLaunch.ok ? webLaunch.url : "",
+      webAppNotice: webAppNotice(webLaunch),
+    });
     return;
   }
 

package/src/i18n.js

@@ -139,6 +139,7 @@ const TRANSLATIONS = {
     helpSkills: "List Markdown skills selected for a topic.",
     helpSkillMesh: "Manage strict reviewed skill sharing.",
     helpProfile: "Set task profile, e.g. code, website, latex, maintenance.",
+    helpWebapp: "Start or reuse the local webapp and print its URL.",
     helpWebSearch: "Enable or disable the web_search tool.",
     helpEnableScs: "Toggle Student-Committee-Supervisor gated execution.",
     helpScouts: "Enable parallel DeepSeek scouts and set scout count.",

package/src/interactive-cli.js

@@ -43,6 +43,7 @@ import {
   permissionModeForApprovalCategory,
   permissionModeLabel,
 } from "./permission-modes.js";
+import { ensureAgintiWebApp } from "./web-autostart.js";
 
 const useColor = Boolean(input.isTTY && output.isTTY && process.env.AGINTIFLOW_NO_COLOR !== "1");
 const ansi = {
@@ -95,6 +96,8 @@ const SLASH_COMMANDS = [
   "/skillsync",
   "/profile",
   "/web-search",
+  "/webapp",
+  "/web",
   "/web-research",
   "/image-read",
   "/research-wrapper",
@@ -291,7 +294,23 @@ function promptViewportRows(height = terminalHeight()) {
 }
 
 function stripAnsi(value) {
-  return String(value || "").replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "");
+  return String(value || "")
+    .replace(/\x1b\][\s\S]*?(?:\x07|\x1b\\)/g, "")
+    .replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "");
+}
+
+function terminalHyperlink(url = "", text = url) {
+  if (!useColor || process.env.AGINTIFLOW_NO_HYPERLINK === "1") return String(text || "");
+  const safeUrl = String(url || "").replace(/[\x00-\x1f\x7f]/g, "");
+  if (!safeUrl) return String(text || "");
+  return `\x1b]8;;${safeUrl}\x07${text}\x1b]8;;\x07`;
+}
+
+function linkifyTerminalUrl(line = "", url = "") {
+  const visibleLine = String(line || "");
+  const visibleUrl = String(url || "");
+  if (!visibleLine || !visibleUrl || !visibleLine.includes(visibleUrl)) return visibleLine;
+  return visibleLine.replace(visibleUrl, terminalHyperlink(visibleUrl, visibleUrl));
 }
 
 function charCellWidth(char = "") {
@@ -772,10 +791,19 @@ function launchTitleLines(contentWidth) {
   return largeWidth <= contentWidth ? LARGE_LAUNCH_TITLE : COMPACT_LAUNCH_TITLE;
 }
 
-export function buildLaunchHeaderLines({ packageVersion = "", frame = 2, width = terminalWidth(), animated = true, language = cliLanguage, webAppUrl = "" } = {}) {
+export function buildLaunchHeaderLines({
+  packageVersion = "",
+  frame = 2,
+  width = terminalWidth(),
+  animated = true,
+  language = cliLanguage,
+  webAppUrl = "",
+  webAppNotice = "",
+} = {}) {
   const subtitle = t("launchSubtitle", language);
   const credit = t("launchCredit", language);
-  const tagline = webAppUrl ? `webapp: ${webAppUrl}` : t("launchTagline", language);
+  const webappLine = webAppUrl ? `webapp: ${webAppUrl}` : webAppNotice;
+  const tagline = webappLine || t("launchTagline", language);
   const version = packageVersion ? `v${packageVersion}` : "";
   const terminalColumns = Math.max(Number(width) || 80, 50);
   const contentWidth = Math.min(Math.max(terminalColumns - 8, 58), 112);
@@ -794,16 +822,18 @@ export function buildLaunchHeaderLines({ packageVersion = "", frame = 2, width =
     row(centerLine(subtitle, contentWidth), ansi.dim),
     row(centerLine(credit, contentWidth), ansi.dim),
     tagline ? mid : "",
-    tagline ? row(centerLine(tagline, contentWidth), ansi.cyan) : "",
+    tagline
+      ? row(centerLine(linkifyTerminalUrl(compactLine(tagline, contentWidth), webAppUrl), contentWidth), webAppUrl ? ansi.cyan : ansi.yellow)
+      : "",
     bottom,
   ].filter(Boolean);
   const indent = " ".repeat(Math.max(Math.floor((terminalColumns - Math.max(...boxLines.map((line) => visualLength(line)))) / 2), 0));
   return boxLines.map((line) => `${indent}${line}`);
 }
 
-async function renderLaunchHeader(packageVersion = "", language = cliLanguage, webAppUrl = "") {
+async function renderLaunchHeader(packageVersion = "", language = cliLanguage, webAppUrl = "", webAppNotice = "") {
   if (!useColor || process.env.AGINTIFLOW_NO_ANIMATION === "1") {
-    console.log(buildLaunchHeaderLines({ packageVersion, animated: false, language, webAppUrl }).join("\n"));
+    console.log(buildLaunchHeaderLines({ packageVersion, animated: false, language, webAppUrl, webAppNotice }).join("\n"));
     return;
   }
 
@@ -812,7 +842,7 @@ async function renderLaunchHeader(packageVersion = "", language = cliLanguage, w
   let previousLineCount = 0;
   output.write(ansi.cursorHide);
   for (let frame = 0; frame < 18; frame += 1) {
-    const lines = [...paddingLines, ...buildLaunchHeaderLines({ packageVersion, frame, animated: true, language, webAppUrl })];
+    const lines = [...paddingLines, ...buildLaunchHeaderLines({ packageVersion, frame, animated: true, language, webAppUrl, webAppNotice })];
     if (previousLineCount > 0) output.write(`\x1b[${previousLineCount}A`);
     output.write(lines.map((line) => `\r${ansi.clearLine}${line}`).join("\n"));
     output.write("\n");
@@ -849,6 +879,7 @@ function printHelp() {
       `  ${command("/skills [query]", "List Markdown skills selected for a topic.", "helpSkills")}`,
       `  ${command("/skillmesh [status|off|record|share|sync]", "Manage strict reviewed skill sharing.", "helpSkillMesh")}`,
       `  ${command("/profile <name>", "Set task profile, e.g. code, website, latex, maintenance.", "helpProfile")}`,
+      `  ${command("/webapp [port]", "Start or reuse the local webapp and print its URL.", "helpWebapp")}`,
       `  ${command("/web-search on|off", "Enable or disable the web_search tool.", "helpWebSearch")}`,
       `  ${command("/web-research <query>", "Run a sourced web_research turn with persisted evidence.", "helpWebSearch")}`,
       `  ${command("/image-read <path> [question]", "Run read_image on a workspace screenshot/image.", "helpWebSearch")}`,
@@ -2170,6 +2201,8 @@ function createState(args = {}) {
     dynamicStepHardCap: args.dynamicStepHardCap,
     dynamicStepExtensionSize: args.dynamicStepExtensionSize,
     sessionId: args.resume || "",
+    webAppUrl: args.webAppUrl || "",
+    webAppNotice: args.webAppNotice || "",
   };
 }
 
@@ -2975,6 +3008,28 @@ async function handleCommand(line, state, packageDir) {
     );
     return true;
   }
+  if (command === "webapp" || command === "web") {
+    const port = Number(value) || Number(process.env.AGINTI_WEB_PORT || process.env.PORT || 3210);
+    printSystemLine("webapp=starting");
+    const result = await ensureAgintiWebApp({
+      packageDir,
+      cwd: state.commandCwd || process.cwd(),
+      host: process.env.AGINTI_WEB_HOST || process.env.HOST || "127.0.0.1",
+      preferredPort: port,
+      language: state.language,
+      respectAutoStartDisable: false,
+    }).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error), url: "" }));
+    if (result.ok) {
+      state.webAppUrl = result.url;
+      state.webAppNotice = "";
+      printSystemLine(`webapp=${result.url} ${result.reused ? "reused" : "started"}`);
+    } else {
+      state.webAppUrl = "";
+      state.webAppNotice = `webapp unavailable - use /webapp to retry; error: ${compactLine(result.error || "unknown", 72)}`;
+      printSystemLine(state.webAppNotice);
+    }
+    return true;
+  }
   if (command === "language" || command === "lang") {
     if (!value) {
       printSystemLine(tr("languageSet", { language: state.language || cliLanguage, label: languageLabel(state.language || cliLanguage) }));
@@ -3599,12 +3654,6 @@ async function handleCommand(line, state, packageDir) {
     printAgentMessage(`initialized project=${result.projectRoot}\nAGINTI.md=${result.instructionsPath}\ntemplate=${result.template}`);
     return true;
   }
-  if (command === "web") {
-    const port = value || "3220";
-    printAgentMessage(`Run in another terminal: aginti web --port ${port}`);
-    return true;
-  }
-
   const typed = `/${command}`;
   const suggestions = SLASH_COMMANDS.filter((candidate) => candidate.startsWith(typed));
   printAgentMessage(
@@ -3808,8 +3857,8 @@ async function runPrompt(prompt, state, packageDir, { approvalDepth = 0 } = {})
   return queuedAfterFinish;
 }
 
-export async function startInteractiveCli(args = {}, { packageDir, packageVersion, webAppUrl = "" } = {}) {
-  const state = createState(args);
+export async function startInteractiveCli(args = {}, { packageDir, packageVersion, webAppUrl = "", webAppNotice = "" } = {}) {
+  const state = createState({ ...args, webAppUrl, webAppNotice });
   const detachProcessInterrupts = installProcessInterruptHandlers();
   setCliLanguage(state.language);
   const rl =
@@ -3822,7 +3871,7 @@ export async function startInteractiveCli(args = {}, { packageDir, packageVersio
           completer: commandCompleter,
         });
 
-  await renderLaunchHeader(packageVersion, state.language, webAppUrl);
+  await renderLaunchHeader(packageVersion, state.language, state.webAppUrl, state.webAppNotice);
   printSystemLine(`${tr("project")}: ${process.cwd()}`);
   await maybeOnboardDeepSeekKey(state);
   printAgentMessage(tr("interactiveIntro"));

package/src/web-autostart.js

@@ -86,8 +86,9 @@ export async function ensureAgintiWebApp({
   host = DEFAULT_HOST,
   preferredPort = DEFAULT_PORT,
   language = "",
+  respectAutoStartDisable = true,
 } = {}) {
-  if (process.env.AGINTI_NO_WEB_AUTO_START === "1" || process.env.AGINTIFLOW_NO_WEB_AUTO_START === "1") {
+  if (respectAutoStartDisable && (process.env.AGINTI_NO_WEB_AUTO_START === "1" || process.env.AGINTIFLOW_NO_WEB_AUTO_START === "1")) {
     return { ok: false, disabled: true, url: "" };
   }