@lazyingart/agintiflow 0.20.25 → 0.20.39

package/src/cli.js

@@ -15,20 +15,25 @@ import { startInteractiveCli } from "./interactive-cli.js";
 import { SessionStore } from "./session-store.js";
 import {
   doctorReport,
+  ensureProjectSessionStorage,
   initProject,
   listProjectSessions,
+  renameProjectSession,
   providerKeyStatus,
   setProviderKey,
   showProjectSession,
+  sessionStoreOptions,
 } from "./project.js";
 import { listTaskProfiles } from "./task-profiles.js";
 import { recommendedMaxStepsForTask } from "./engineering-guidance.js";
 import { normalizeAuthProvider, promptHidden, runAuthWizard, shouldPromptForDeepSeek } from "./auth-onboarding.js";
 import { listSkills, selectSkillsForGoal } from "./skill-library.js";
 import { languageLabel, resolveLanguage } from "./i18n.js";
+import { maybeAutoUpdate } from "./auto-update.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import readline from "node:readline/promises";
 
 const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(await fs.readFile(path.join(packageDir, "package.json"), "utf8"));
@@ -94,6 +99,7 @@ export function parseArgs(argv) {
     latex: false,
     image: false,
     language: "",
+    autoUpdate: undefined,
   };
 
   const parts = [];
@@ -129,6 +135,14 @@ export function parseArgs(argv) {
       }
       continue;
     }
+    if (arg === "--no-auto-update") {
+      result.autoUpdate = false;
+      continue;
+    }
+    if (arg === "--auto-update") {
+      result.autoUpdate = true;
+      continue;
+    }
     if (arg === "--start-url") {
       result.startUrl = readOption(argv, i);
       i += 1;
@@ -364,7 +378,7 @@ export function parseArgs(argv) {
 
 function printUsage() {
   console.log(
-    'Usage: aginti [chat] OR aginti web [--port 3210] OR aginti models OR aginti skills [query] OR aginti auth [deepseek|openai|qwen|venice|grsai] OR aginti resume [latest|<session-id>] ["prompt"] OR aginti queue <session-id> "message" OR aginti [--language en|ja|zh-Hans|zh-Hant|ko|fr|es|ar|vi|de|ru] [--image] [--latex] [--routing smart|fast|complex|manual] [--provider deepseek|openai|qwen|venice|mock] [--model MODEL] [--route-model MODEL] [--main-model MODEL] [--spare-model MODEL --spare-reasoning medium] [--aux-provider grsai|venice --aux-model MODEL] [--sandbox-mode host|docker-readonly|docker-workspace] [--package-install-policy block|prompt|allow] [--approve-package-installs] [--allow-shell|--no-shell] [--allow-file-tools|--no-file-tools] [--web-search|--no-web-search] [--parallel-scouts|--no-parallel-scouts --scout-count 1..10] [--allow-auxiliary-tools|--no-auxiliary-tools] [--allow-wrappers --wrapper codex --wrapper-model gpt-5.5] [--list-models|--list-routes] "your task"'
+    'Usage: aginti [chat] OR aginti web [--port 3210] OR aginti update OR aginti models OR aginti skills [query] OR aginti auth [deepseek|openai|qwen|venice|grsai] OR aginti resume [latest|<session-id>] ["prompt"] OR aginti queue <session-id> "message" OR aginti [--no-auto-update] [--language en|ja|zh-Hans|zh-Hant|ko|fr|es|ar|vi|de|ru] [--image] [--latex] [--routing smart|fast|complex|manual] [--provider deepseek|openai|qwen|venice|mock] [--model MODEL] [--route-model MODEL] [--main-model MODEL] [--spare-model MODEL --spare-reasoning medium] [--aux-provider grsai|venice --aux-model MODEL] [--sandbox-mode host|docker-readonly|docker-workspace] [--package-install-policy block|prompt|allow] [--approve-package-installs] [--allow-shell|--no-shell] [--allow-file-tools|--no-file-tools] [--web-search|--no-web-search] [--parallel-scouts|--no-parallel-scouts --scout-count 1..10] [--allow-auxiliary-tools|--no-auxiliary-tools] [--allow-wrappers --wrapper codex --wrapper-model gpt-5.5] [--list-models|--list-routes] "your task"'
   );
   console.log(`Languages: ${["en", "ja", "zh-Hans", "zh-Hant", "ko", "fr", "es", "ar", "vi", "de", "ru"].map((code) => `${code}=${languageLabel(code)}`).join(", ")}`);
 }
@@ -379,29 +393,46 @@ function providerLabel(provider) {
 }
 
 function agentDefaults(args) {
+  const envSandboxMode = process.env.SANDBOX_MODE || "";
+  const envPackageInstallPolicy = process.env.PACKAGE_INSTALL_POLICY || "";
+  const envUseDockerSandbox = process.env.USE_DOCKER_SANDBOX;
+  const envScoutCount = Number(process.env.AGINTI_SCOUT_COUNT);
+  const taskProfile = args.taskProfile || process.env.AGINTI_TASK_PROFILE || (args.latex ? "latex" : "auto");
   const defaults = {
     ...args,
+    provider: args.provider || process.env.AGENT_PROVIDER || "",
+    routingMode: args.routingMode || process.env.AGENT_ROUTING_MODE || "smart",
+    routeProvider: args.routeProvider || process.env.AGINTI_ROUTE_PROVIDER || "",
+    routeModel: args.routeModel || process.env.AGINTI_ROUTE_MODEL || "",
+    mainProvider: args.mainProvider || process.env.AGINTI_MAIN_PROVIDER || "",
+    mainModel: args.mainModel || process.env.AGINTI_MAIN_MODEL || "",
+    spareProvider: args.spareProvider || process.env.AGINTI_SPARE_PROVIDER || "",
+    spareModel: args.spareModel || process.env.AGINTI_SPARE_MODEL || "",
+    spareReasoning: args.spareReasoning || process.env.AGINTI_SPARE_REASONING || "",
+    taskProfile,
     language: resolveLanguage(args.language || process.env.AGINTI_LANGUAGE || ""),
     allowShellTool: args.allowShellTool ?? true,
     allowFileTools: args.allowFileTools ?? true,
     allowAuxiliaryTools: args.allowAuxiliaryTools ?? true,
     allowWebSearch: args.allowWebSearch ?? true,
     allowParallelScouts: args.allowParallelScouts ?? true,
-    parallelScoutCount: args.parallelScoutCount || 3,
-    sandboxMode: args.sandboxMode || "docker-workspace",
-    packageInstallPolicy: args.packageInstallPolicy || "allow",
-    useDockerSandbox: args.useDockerSandbox ?? true,
+    parallelScoutCount: args.parallelScoutCount || (Number.isFinite(envScoutCount) && envScoutCount > 0 ? envScoutCount : 3),
+    sandboxMode: args.sandboxMode || envSandboxMode || "docker-workspace",
+    packageInstallPolicy: args.packageInstallPolicy || envPackageInstallPolicy || "allow",
+    useDockerSandbox:
+      args.useDockerSandbox ??
+      (envUseDockerSandbox === undefined ? true : String(envUseDockerSandbox).toLowerCase() !== "false"),
     maxSteps:
       args.maxSteps ||
       recommendedMaxStepsForTask({
         goal: args.goal || "",
-        taskProfile: args.taskProfile || (args.latex ? "latex" : "auto"),
+        taskProfile,
       }),
   };
 
   if (defaults.sandboxMode === "host") {
     defaults.useDockerSandbox = false;
-    defaults.packageInstallPolicy = args.packageInstallPolicy || "prompt";
+    defaults.packageInstallPolicy = args.packageInstallPolicy || envPackageInstallPolicy || "prompt";
   }
 
   return defaults;
@@ -469,7 +500,7 @@ function printInitResult(result) {
   console.log(`AgInTiFlow project initialized: ${result.projectRoot}`);
   console.log(`instructions=${result.instructionsPath}`);
   console.log(`control=${result.controlDir}`);
-  console.log(`sessions=${result.sessionsDir}`);
+  console.log(`projectSessions=${result.sessionsDir}`);
   console.log(`created=${result.created.length} updated=${result.updated.length} skipped=${result.skipped.length}`);
 }
 
@@ -479,7 +510,8 @@ function printDoctorReport(report) {
   console.log(`platform=${report.platform.label} family=${report.platform.linuxFamily || report.platform.platform}`);
   console.log(`project=${report.project.root}`);
   console.log(`instructions=${report.project.instructionsPath} present=${report.project.instructionsPresent}`);
-  console.log(`sessions=${report.project.sessionsDir}`);
+  console.log(`projectSessions=${report.project.sessionsDir}`);
+  console.log(`globalSessions=${report.project.globalSessionsDir}`);
   console.log(`sessionDb=${report.project.sessionDbPath}`);
   console.log(
     `keys: deepseek=${report.keys.deepseek ? "available" : "missing"} openai=${
@@ -569,7 +601,7 @@ function printAuthWizardResult(result) {
 }
 
 async function handleSessionsCommand(argv) {
-  const [verb = "list", sessionId = ""] = argv;
+  const [verb = "list", sessionId = "", ...rest] = argv;
   if (verb === "list") {
     const sessions = await listProjectSessions(process.cwd(), 80);
     if (sessions.length === 0) {
@@ -593,14 +625,49 @@ async function handleSessionsCommand(argv) {
     return;
   }
 
-  console.error("Usage: aginti sessions list OR aginti sessions show <session-id>");
+  if (verb === "rename") {
+    const title = rest.join(" ").trim();
+    if (!sessionId || !title) {
+      console.error('Usage: aginti sessions rename <session-id> "new title"');
+      process.exit(1);
+    }
+    const result = await renameProjectSession(process.cwd(), sessionId, title);
+    console.log(`renamed ${result.sessionId}: ${result.title}`);
+    return;
+  }
+
+  console.error('Usage: aginti sessions list OR aginti sessions show <session-id> OR aginti sessions rename <session-id> "title"');
   process.exit(1);
 }
 
+async function promptSelectSession(sessions) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return sessions[0]?.sessionId || "";
+  console.log("Select a session to resume:");
+  sessions.slice(0, 20).forEach((session, index) => {
+    const title = session.title || session.goal || "(untitled)";
+    console.log(
+      `${index + 1}. ${session.sessionId} ${session.provider || "unknown"}/${session.model || "unknown"} ${session.updatedAt || ""} ${title.slice(0, 90)}`
+    );
+  });
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question("Session number: ");
+    const index = Number(answer.trim()) - 1;
+    return sessions[index]?.sessionId || "";
+  } finally {
+    rl.close();
+  }
+}
+
 async function resolveResumeSessionId(sessionId) {
   if (sessionId && sessionId !== "latest") return sessionId;
-  const sessions = await listProjectSessions(process.cwd(), 1);
-  if (sessions[0]?.sessionId) return sessions[0].sessionId;
+  const sessions = await listProjectSessions(process.cwd(), 50);
+  if (sessionId === "latest" || sessions.length <= 1 || !process.stdin.isTTY || !process.stdout.isTTY) {
+    if (sessions[0]?.sessionId) return sessions[0].sessionId;
+  } else {
+    const selected = await promptSelectSession(sessions);
+    if (selected) return selected;
+  }
   throw new Error("No project-local sessions found. Run `aginti sessions list` to check this folder.");
 }
 
@@ -612,12 +679,31 @@ async function handleQueueCommand(argv) {
     process.exit(1);
   }
 
-  const store = new SessionStore(path.resolve(process.cwd(), ".sessions"), sessionId);
+  const paths = await ensureProjectSessionStorage(process.cwd());
+  const store = new SessionStore(paths.globalSessionsDir, sessionId, sessionStoreOptions(process.cwd(), sessionId));
   await store.appendInbox(content, { source: "cli" });
   await store.appendEvent("conversation.queued_input", { prompt: content, source: "cli" }).catch(() => {});
   console.log(`queued message for ${sessionId}`);
 }
 
+async function handleStorageCommand(argv) {
+  const [verb = "status", ...rest] = argv;
+  if (verb !== "migrate" && verb !== "status") {
+    console.error("Usage: aginti storage migrate [project-root ...] OR aginti storage status");
+    process.exit(1);
+  }
+
+  const roots = verb === "migrate" && rest.length > 0 ? rest : [process.cwd()];
+  for (const root of roots) {
+    const projectRoot = path.resolve(root);
+    const paths = await ensureProjectSessionStorage(projectRoot);
+    const sessions = await listProjectSessions(projectRoot, 1000);
+    console.log(
+      `${verb === "migrate" ? "migrated" : "storage"} project=${paths.root} projectSessions=${paths.sessionsDir} globalSessions=${paths.globalSessionsDir} sessions=${sessions.length}`
+    );
+  }
+}
+
 export async function main(argv = process.argv.slice(2)) {
   if (argv[0] === "help" || argv.includes("--help") || argv.includes("-h")) {
     printUsage();
@@ -629,6 +715,30 @@ export async function main(argv = process.argv.slice(2)) {
     return;
   }
 
+  if (argv[0] === "update" || argv[0] === "upgrade") {
+    const updateResult = await maybeAutoUpdate({
+      argv,
+      force: true,
+      manual: true,
+      packageDir,
+      packageName: packageJson.name,
+      packageVersion: packageJson.version,
+      restart: false,
+    });
+    if (updateResult.error) process.exit(1);
+    return;
+  }
+
+  const autoUpdateResult = await maybeAutoUpdate({
+    argv,
+    force: argv.includes("--auto-update"),
+    packageDir,
+    packageName: packageJson.name,
+    packageVersion: packageJson.version,
+    restart: true,
+  });
+  if (autoUpdateResult.restarted) process.exit(autoUpdateResult.exitCode ?? 0);
+
   if (argv[0] === "init") {
     printInitResult(await initProject(process.cwd()));
     return;
@@ -706,6 +816,11 @@ export async function main(argv = process.argv.slice(2)) {
     return;
   }
 
+  if (argv[0] === "storage") {
+    await handleStorageCommand(argv.slice(1));
+    return;
+  }
+
   if (argv[0] === "models" || argv[0] === "model") {
     printModels();
     return;

package/src/config.js

@@ -3,7 +3,7 @@ import crypto from "node:crypto";
 import { getModelRoleDefaults, getProviderDefaults, normalizeRoutingMode, selectModelRoute } from "./model-routing.js";
 import { normalizePackageInstallPolicy, normalizeSandboxMode } from "./command-policy.js";
 import { normalizeWrapperName } from "./tool-wrappers.js";
-import { loadProjectEnv, resolveProjectRoot } from "./project.js";
+import { loadProjectEnv, projectPaths, resolveProjectRoot } from "./project.js";
 import { normalizeTaskProfile } from "./task-profiles.js";
 import { recommendedMaxStepsForTask } from "./engineering-guidance.js";
 import { resolveLanguage } from "./i18n.js";
@@ -32,6 +32,7 @@ function parseList(value) {
 
 export function resolveRuntimeConfig(args, overrides = {}) {
   const baseDir = resolveProjectRoot(overrides.baseDir || process.cwd());
+  const paths = projectPaths(baseDir);
   loadProjectEnv(baseDir);
   const requestedProvider =
     overrides.provider ||
@@ -155,7 +156,10 @@ export function resolveRuntimeConfig(args, overrides = {}) {
     useDockerSandbox: sandboxMode !== "host",
     dockerSandboxImage: overrides.dockerSandboxImage || process.env.DOCKER_SANDBOX_IMAGE || "agintiflow-sandbox:latest",
     commandCwd: path.resolve(overrides.commandCwd || args.commandCwd || process.env.COMMAND_CWD || baseDir),
-    sessionsDir: path.resolve(baseDir, ".sessions"),
+    sessionsDir: paths.globalSessionsDir,
+    projectSessionsDir: paths.sessionsDir,
+    sessionDbPath: paths.sessionDbPath,
+    globalSessionIndexPath: paths.globalSessionIndexPath,
     onLog: overrides.onLog,
     onEvent: overrides.onEvent,
   };

package/src/engineering-guidance.js

@@ -11,7 +11,7 @@ const LANGUAGE_HINTS = [
     id: "python",
     pattern: /\b(python|pytest|pip|uv|poetry|conda|venv|jupyter|fastapi|django|flask|pandas|numpy)\b/i,
     text:
-      "Python: inspect pyproject/requirements, prefer project-local venv/uv/conda or Docker, run python -m pytest or focused module checks, avoid global package installs on host.",
+      "Python: inspect pyproject/requirements, prefer project-local venv/uv/conda or Docker, run python -m pytest or focused module checks, avoid global package installs on host, and check Python caches recursively with find . -type d -name __pycache__ -o -name '*.pyc' before claiming none exist.",
   },
   {
     id: "rust",
@@ -29,7 +29,7 @@ const LANGUAGE_HINTS = [
     id: "android",
     pattern: /\b(android|apk|adb|avd|emulator|gradle wrapper|gradlew|android sdk|kotlin android|jetpack|compose)\b/i,
     text:
-      "Android: inspect git status, Gradle/settings/manifests, ANDROID_HOME/SDK paths, Java/Kotlin versions, adb devices, and emulator/AVD list first. Never start host sudo or host OS package installs; use the existing SDK, a project-local Gradle wrapper, user-writable caches, or return a precise setup report. Build, install with adb, launch with am, verify with logcat/screencap when possible, then commit.",
+      "Android: inspect git status, Gradle/settings/manifests, ANDROID_HOME/SDK paths, Java/Kotlin versions, adb devices, and emulator/AVD list first. Never start host sudo or host OS package installs; use the existing SDK, a project-local Gradle wrapper, user-writable caches, or return a precise setup report. Build, install with adb, launch with am, verify with logcat/screencap when possible, save screenshots under a durable workspace path, then commit.",
   },
   {
     id: "java-jvm",
@@ -55,6 +55,12 @@ const LANGUAGE_HINTS = [
     text:
       "Git: always run git status --short and git diff --stat before commit/push. Commit only requested changes, use a clear message, run git fetch before push when remote state matters, prefer git pull --ff-only, and stop to ask if there are conflicts, unrelated dirty files, divergent branches, or ambiguous merge choices.",
   },
+  {
+    id: "supervision",
+    pattern: /\b(supervise|supervisor|student agent|homework|curriculum|self[- ]?supervision|train the agent|agent training|monitor tmux)\b/i,
+    text:
+      "Supervision: do not simply believe the student agent. Define acceptance criteria, give normal user-level prompts, monitor tmux/session logs, verify artifacts and git state externally, record evidence, and turn repeated failures into durable profile, skill, tool, policy, or test improvements.",
+  },
   {
     id: "r-stats",
     pattern: /\b(rstats|r language|cmdstanr|stan|renv|tidyverse|shiny)\b/i,
@@ -92,7 +98,11 @@ export function engineeringGuidanceForTask(goal = "", taskProfile = "auto") {
     "Build a compact context pack before major edits: project instructions, manifests/scripts, git status/diff, relevant symbols/search hits, target files, and the narrowest checks. Do not paste whole trees or huge files into model context.",
     "For system repair, act like a doctor: gather evidence first, avoid silent destructive host changes, prefer Docker or project-local scripts for installs, and make every stronger action explicit in logs.",
     "Never send sudo passwords or wait at interactive password prompts. If host-level permission is truly required, stop that path, explain the blocker, and provide a manual command instead of hanging.",
+    "Shell commands already start in the configured workspace. Prefer workspace-relative commands such as python3 scripts/check.py or cd subdir && make; do not prefix commands with absolute host cd paths unless the tool explicitly requires it.",
+    "When you create or fix scripts, reports, tables, generated files, or analysis outputs, inspect the actual output. If it contains obvious duplicates, noisy rows, stale names, broken markdown, or contradictions, patch the source/output and rerun the check rather than merely explaining the defect in the report.",
     "Before claiming a coding task is finished, run git status --short when git is available. Leave the worktree clean, or explicitly report and justify each remaining untracked/unstaged artifact.",
+    "Do not claim there are no transient artifacts unless you checked recursively for the relevant stack, such as find . -type d -name __pycache__ -o -name '*.pyc' for Python. A clean git status means tracked work is clean; ignored caches such as __pycache__ may still exist and should be removed or described accurately if relevant.",
+    "For generated screenshots, images, PDFs, reports, archives, and app packages, choose a descriptive non-conflicting workspace path when the user did not specify one. Verify the file still exists after cleanup before claiming it was saved.",
   ];
 
   if (matched.length > 0) {

package/src/interactive-cli.js

@@ -3,7 +3,15 @@ import { emitKeypressEvents } from "node:readline";
 import { stdin as input, stdout as output } from "node:process";
 import { runAgent } from "./agent-runner.js";
 import { loadConfig } from "./config.js";
-import { initProject, listProjectSessions, projectPaths, providerKeyStatus, readProjectInstructions } from "./project.js";
+import {
+  initProject,
+  listProjectSessions,
+  projectPaths,
+  providerKeyStatus,
+  readProjectInstructions,
+  renameProjectSession,
+  sessionStoreOptions,
+} from "./project.js";
 import { normalizePackageInstallPolicy, normalizeSandboxMode } from "./command-policy.js";
 import { defaultMaxStepsForProfile, normalizeTaskProfile } from "./task-profiles.js";
 import { recommendedMaxStepsForTask } from "./engineering-guidance.js";
@@ -61,6 +69,7 @@ const SLASH_COMMANDS = [
   "/new",
   "/resume",
   "/sessions",
+  "/rename",
   "/skills",
   "/skill",
   "/profile",
@@ -624,6 +633,7 @@ function printHelp() {
       `  ${command("/auxiliary [status|grsai|venice|model [provider/model]|on|off|image]", "Manage optional auxiliary skills, including image generation.", "helpAuxiliary")}`,
       `  ${command("/new", "Start a fresh session on the next message.", "helpNew")}`,
       `  ${command("/resume <session-id>", "Continue a saved session.", "helpResume")}`,
+      `  ${command("/rename [title|auto]", "Rename the current session.", "helpRename")}`,
       `  ${command("/sessions", "List recent sessions in this project.", "helpSessions")}`,
       `  ${command("/skills [query]", "List Markdown skills selected for a topic.", "helpSkills")}`,
       `  ${command("/profile <name>", "Set task profile, e.g. code, website, latex, maintenance.", "helpProfile")}`,
@@ -1564,8 +1574,17 @@ function isAbortError(error) {
 }
 
 function formatSessionLine(session) {
-  const goal = session.goal ? ` ${session.goal.slice(0, 72)}` : "";
-  return `${session.sessionId} ${session.provider || "unknown"}/${session.model || "unknown"} ${session.updatedAt || ""}${goal}`.trim();
+  const title = session.title || session.goal || "";
+  const preview = title ? ` ${title.slice(0, 72)}` : "";
+  return `${session.sessionId} ${session.provider || "unknown"}/${session.model || "unknown"} ${session.updatedAt || ""}${preview}`.trim();
+}
+
+function autoSessionTitle(state) {
+  const route = `${state.routeProvider || state.provider || "auto"}/${state.routeModel || state.model || "auto"}`;
+  const main = `${state.mainProvider || state.provider || "auto"}/${state.mainModel || state.model || "auto"}`;
+  const goal = String(state.activeGoal || "").replace(/\s+/g, " ").trim();
+  const prefix = state.taskProfile && state.taskProfile !== "auto" ? state.taskProfile : "auto";
+  return [prefix, `route ${route}`, `main ${main}`, goal.slice(0, 36)].filter(Boolean).join(" · ").slice(0, 90);
 }
 
 async function latestSession() {
@@ -1582,7 +1601,8 @@ function printHistoryEntry(entry) {
 
 async function printResumeHistory(state, { limit = 0 } = {}) {
   if (!state.sessionId) return;
-  const store = new SessionStore(projectPaths(process.cwd()).sessionsDir, state.sessionId);
+  const paths = projectPaths(process.cwd());
+  const store = new SessionStore(paths.globalSessionsDir, state.sessionId, sessionStoreOptions(process.cwd(), state.sessionId));
   const saved = await store.loadState().catch(() => null);
   const events = await store.loadEvents().catch(() => []);
   const chat = Array.isArray(saved?.chat) ? saved.chat.filter((entry) => entry?.content) : [];
@@ -2583,6 +2603,20 @@ async function handleCommand(line, state, packageDir) {
     }
     return true;
   }
+  if (command === "rename") {
+    if (!state.sessionId) {
+      printAgentMessage("No active session to rename. Start or resume a session first.");
+      return true;
+    }
+    const title = value === "auto" || !value ? autoSessionTitle(state) : value;
+    try {
+      const result = await renameProjectSession(process.cwd(), state.sessionId, title);
+      printSystemLine(`session=${result.sessionId} title=${result.title}`);
+    } catch (error) {
+      printAgentMessage(error instanceof Error ? error.message : String(error));
+    }
+    return true;
+  }
   if (command === "skills" || command === "skill") {
     const skills = value
       ? selectSkillsForGoal(value, { taskProfile: state.taskProfile, limit: 12, includeBody: false })
@@ -2914,7 +2948,10 @@ async function runPrompt(prompt, state, packageDir) {
   state.activeGoal = compactLine(prompt, 84);
   state.lastEvent = "";
 
-  const store = new SessionStore(config.sessionsDir, state.sessionId);
+  const store = new SessionStore(config.sessionsDir, state.sessionId, {
+    projectRoot: config.baseDir,
+    projectSessionsDir: config.projectSessionsDir,
+  });
   const liveInput = new LiveRunInput({ state, store, controller });
   const liveStarted = liveInput.start();
   const detachInterrupts = liveStarted ? () => {} : attachRunInterrupts(controller);

package/src/model-client.js

@@ -1020,7 +1020,7 @@ export async function requestNextStep(client, config, messages) {
     function: {
       name: "send_to_canvas",
       description:
-        "Send an optional artifact notification to the frontend canvas/artifacts tunnel. Use for important markdown/text, generated images, screenshots, figures, diffs, or workspace file paths the user should preview. Proactively use this for draw/plot/graph/chart/diagram/figure requests even when the user did not mention canvas. This does not replace finish.",
+        "Send an optional artifact notification to the frontend canvas/artifacts tunnel. Use for important markdown/text, generated images, screenshots, figures, diffs, or workspace file paths the user should preview. Workspace files sent here are copied into session artifacts for durable preview, but if the user asked to save/capture/generate a file, keep a descriptive non-conflicting copy in the working directory too. Proactively use this for draw/plot/graph/chart/diagram/figure requests even when the user did not mention canvas. This does not replace finish.",
       parameters: {
         type: "object",
         properties: {
@@ -1031,7 +1031,7 @@ export async function requestNextStep(client, config, messages) {
             description: "Renderer hint. Use image/file with path, markdown/text/json/diff with content.",
           },
           content: { type: "string", description: "Inline text or markdown content to render." },
-          path: { type: "string", description: "Optional workspace-relative file path to preview." },
+          path: { type: "string", description: "Optional existing workspace-relative file path to preview and persist into the session artifact store." },
           note: { type: "string", description: "Short notification message for the artifact explorer." },
           selected: { type: "boolean", description: "Whether the frontend should select this item immediately." },
         },

package/src/model-routing.js

@@ -776,7 +776,9 @@ export function modelsForProviderGroup(groupId) {
 export function scoreTaskComplexity(goal = "", taskProfile = "auto") {
   const text = String(goal).toLowerCase();
   let score = text.length > 600 ? 2 : text.length > 240 ? 1 : 0;
-  if (["large-codebase", "engineering", "codebase"].includes(String(taskProfile || "").toLowerCase())) score += 3;
+  const profile = String(taskProfile || "").toLowerCase();
+  if (["large-codebase", "engineering", "codebase", "code", "qa", "database", "devops", "security"].includes(profile)) score += 3;
+  if (["app", "data", "paper", "research", "latex", "github", "maintenance", "supervision"].includes(profile)) score += 2;
   for (const keyword of COMPLEXITY_KEYWORDS) {
     if (text.includes(keyword)) score += 1;
   }

package/src/parallel-scouts.js

@@ -69,7 +69,23 @@ function shouldUseComplexScouts(config, state) {
   const goal = String(config.goal || state.goal || "");
   return (
     Number(config.routeComplexityScore || 0) >= 3 ||
-    ["large-codebase", "maintenance", "code"].includes(profile) ||
+    [
+      "large-codebase",
+      "maintenance",
+      "code",
+      "qa",
+      "database",
+      "devops",
+      "security",
+      "github",
+      "java",
+      "ios",
+      "go",
+      "rust",
+      "dotnet",
+      "php",
+      "ruby",
+    ].includes(profile) ||
     /\b(large|complex|complicated|debug|bug|failing|system|install|setup|codebase|repo|multi[- ]file|architecture|refactor|migration)\b/i.test(
       goal
     )