jinzd-ai-cli 0.4.277 → 0.4.279

package/dist/electron-server.js

@@ -40,14 +40,14 @@ import {
   touchMemoryReferences,
   updateMemoryApproval,
   updateMemoryEntry
-} from "./chunk-7YYUITED.js";
+} from "./chunk-CMNXAJLH.js";
 import {
   redactJson,
   scanString
 } from "./chunk-FSC6KEWU.js";
 import {
   runTestsTool
-} from "./chunk-BYNNKJUC.js";
+} from "./chunk-SIVM2YQQ.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   APP_NAME,
@@ -80,7 +80,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   buildUserIdentityPrompt
-} from "./chunk-Z752LDYF.js";
+} from "./chunk-5XHEXRMN.js";
 import {
   hasSemanticIndex,
   semanticSearch
@@ -15543,48 +15543,259 @@ function applyThinkCommand(sub, state2) {
   return stay(`Unknown /think option "${sub}" \u2014 expected on | off | low | high | max | status`);
 }
 
+// src/core/provider-command.ts
+function preservedSuffix(messageCount) {
+  return messageCount > 0 ? ` (conversation preserved: ${messageCount} messages)` : "";
+}
+function resolveProviderSwitch(input) {
+  const id = input.targetId;
+  if (!input.configured) {
+    return {
+      status: "not-configured",
+      message: `Provider '${id}' is not configured. Run: aicli config`
+    };
+  }
+  if (input.availableModels.length === 0) {
+    return {
+      status: "no-models",
+      message: `Provider '${id}' has no available models. ` + (id === "ollama" ? "Make sure Ollama is running (`ollama serve`) and has models (`ollama pull <model>`)." : "Check provider configuration.")
+    };
+  }
+  if (id === input.currentProvider) {
+    return { status: "unchanged", message: `Already using provider: ${id}` };
+  }
+  const model = input.configuredDefaultModel || input.providerDefaultModel;
+  return {
+    status: "switched",
+    providerId: id,
+    model,
+    message: `Switched to provider: ${id} (${model})` + preservedSuffix(input.messageCount)
+  };
+}
+function parseModelCommand(args, currentProvider) {
+  const raw = args[0];
+  if (!raw) return { kind: "select" };
+  const sub = raw.toLowerCase();
+  if (sub === "refresh") return { kind: "refresh", providerId: args[1] ?? currentProvider };
+  if (sub === "cache") {
+    if ((args[1] ?? "").toLowerCase() === "clear") return { kind: "cache-clear", providerId: args[2] };
+    return { kind: "cache-show" };
+  }
+  return { kind: "set", modelId: raw };
+}
+function resolveModelSwitch(input) {
+  if (input.targetModel === input.currentModel) {
+    return { status: "unchanged", message: `Already using model: ${input.targetModel}` };
+  }
+  const known = input.knownModels.includes(input.targetModel);
+  return {
+    status: "switched",
+    model: input.targetModel,
+    message: `Switched to model: ${input.targetModel}` + preservedSuffix(input.messageCount),
+    warning: known ? void 0 : `'${input.targetModel}' is not in the known model list for ${input.provider}. If the provider rejects it, check the spelling or run /model refresh ${input.provider}.`
+  };
+}
+var PLAN_MODE_TOOL_HINT = [
+  "read_file \xB7 list_dir \xB7 grep_files \xB7 glob_files",
+  "web_fetch \xB7 google_search \xB7 ask_user \xB7 write_todos"
+];
+function applyPlanCommand(sub, active) {
+  const key = (sub ?? "enter").toLowerCase() === "toggle" ? active ? "exit" : "enter" : (sub ?? "enter").toLowerCase();
+  if (key === "enter") {
+    if (active) {
+      return {
+        planMode: true,
+        changed: false,
+        status: "already-active",
+        summary: "Already in Plan Mode. Use /plan execute to start executing, or /plan exit to leave.",
+        details: []
+      };
+    }
+    return {
+      planMode: true,
+      changed: true,
+      status: "entered",
+      summary: "\u{1F4CB} Plan Mode activated",
+      details: [
+        "AI can now ONLY use read-only tools:",
+        ...PLAN_MODE_TOOL_HINT,
+        "Describe your task and the AI will analyze the codebase and create a detailed implementation plan.",
+        "When ready: /plan execute  |  To cancel: /plan exit"
+      ]
+    };
+  }
+  if (key === "execute") {
+    if (!active) {
+      return { planMode: false, changed: false, status: "not-active", summary: "Not in Plan Mode. Enter first with /plan", details: [] };
+    }
+    return {
+      planMode: false,
+      changed: true,
+      status: "executing",
+      summary: "Plan Mode ended \u2014 switching to execute mode. AI now has full tool access.",
+      details: []
+    };
+  }
+  if (key === "exit" || key === "cancel") {
+    if (!active) {
+      return { planMode: false, changed: false, status: "not-active", summary: "Not in Plan Mode.", details: [] };
+    }
+    return { planMode: false, changed: true, status: "cancelled", summary: "Plan Mode cancelled. Returning to normal mode.", details: [] };
+  }
+  if (key === "status" || key === "show") {
+    return {
+      planMode: active,
+      changed: false,
+      status: "status",
+      summary: `Plan Mode: ${active ? "ACTIVE \u{1F4CB}" : "inactive"}`,
+      details: active ? ["Tools restricted to read-only set.", "Use /plan execute to start executing, or /plan exit to cancel."] : []
+    };
+  }
+  return {
+    planMode: active,
+    changed: false,
+    status: "unknown",
+    summary: `Unknown /plan option "${sub}" \u2014 expected execute | exit | status`,
+    details: []
+  };
+}
+function parseRouteCommand(args) {
+  const sub = (args[0] ?? "show").toLowerCase();
+  if (sub === "on" || sub === "enable") return { kind: "enable" };
+  if (sub === "off" || sub === "disable") return { kind: "disable" };
+  if (sub === "test") {
+    const message = args.slice(1).join(" ").trim();
+    return message ? { kind: "test", message } : { kind: "usage", message: "Usage: /route test <message>" };
+  }
+  if (sub === "show" || sub === "status") return { kind: "show" };
+  return { kind: "unknown", message: `Unknown subcommand: ${sub}. Usage: /route [on|off|show|test <message>]` };
+}
+function routingEmptyRulesNote(routing) {
+  if (routing && routing.rules.length > 0) return null;
+  return 'No rules configured yet. Add rules under `routing.rules` in ~/.aicli/config.json.\nExample: { match: { tag: "fast" }, model: "claude-haiku-4-5" }';
+}
+function describeRoutingRule(rule, index) {
+  const parts = [];
+  if (rule.match.tag) parts.push(`tag=#${rule.match.tag}`);
+  if (rule.match.contains && rule.match.contains.length > 0) {
+    const shown = rule.match.contains.slice(0, 3).join(", ");
+    parts.push(`contains=[${shown}${rule.match.contains.length > 3 ? ", \u2026" : ""}]`);
+  }
+  if (typeof rule.match.maxLength === "number") parts.push(`maxLen=${rule.match.maxLength}`);
+  if (typeof rule.match.minLength === "number") parts.push(`minLen=${rule.match.minLength}`);
+  const empty = parts.length === 0;
+  return {
+    index,
+    name: rule.name,
+    condition: empty ? "(empty \u2014 never matches)" : parts.join(" & "),
+    model: rule.model,
+    empty
+  };
+}
+function describeRouting(input) {
+  const rules = input.routing?.rules ?? [];
+  return {
+    enabled: input.routing?.enabled === true,
+    provider: input.provider,
+    currentModel: input.currentModel,
+    fallback: input.routing?.fallback,
+    rules: rules.map((r, i) => describeRoutingRule(r, i)),
+    noRulesNote: rules.length === 0 ? "(no rules configured \u2014 edit ~/.aicli/config.json `routing.rules`)" : null,
+    hint: "Commands: /route on | off | test <msg> | show"
+  };
+}
+function routeDecisionRows(message, currentModel, decision) {
+  const rows = [
+    { label: "Input", value: message },
+    { label: "Current", value: currentModel },
+    { label: "Decision", value: `${decision.model}  ${decision.overridden ? "\u2192 ROUTED" : "(unchanged)"}` },
+    { label: "Reason", value: decision.reason }
+  ];
+  if (typeof decision.ruleIdx === "number") rows.push({ label: "Rule", value: `#${decision.ruleIdx}` });
+  return rows;
+}
+
 // src/web/commands/provider-commands.ts
+function syncSessionProvider(ctx) {
+  const session = ctx.sessions.current;
+  if (!session) return;
+  session.updateProvider(ctx.currentProvider, ctx.currentModel);
+  ctx.saveIfNeeded();
+}
 async function handleProvider(args, ctx) {
   const id = args[0];
   if (!id) {
     ctx.send({ type: "error", message: "Usage: /provider <id>" });
     return;
   }
-  const p = ctx.providers.get(id);
-  if (!p) {
-    ctx.send({ type: "error", message: `Provider "${id}" not available` });
+  const configured = ctx.providers.has(id);
+  let availableModels = [];
+  let providerDefaultModel = "";
+  if (configured) {
+    const target = ctx.providers.get(id);
+    providerDefaultModel = target.info.defaultModel;
+    availableModels = target.info.models.map((m) => m.id);
+    if (availableModels.length === 0) {
+      try {
+        availableModels = (await target.listModels()).map((m) => m.id);
+      } catch {
+        availableModels = [];
+      }
+    }
+  }
+  const outcome = resolveProviderSwitch({
+    targetId: id,
+    currentProvider: ctx.currentProvider,
+    configured,
+    availableModels,
+    configuredDefaultModel: ctx.config.get("defaultModels")[id],
+    providerDefaultModel,
+    messageCount: ctx.sessions.current?.messages.length ?? 0
+  });
+  if (outcome.status === "not-configured" || outcome.status === "no-models") {
+    ctx.send({ type: "error", message: outcome.message });
     return;
   }
-  ctx.currentProvider = id;
-  ctx.currentModel = p.info.defaultModel;
+  if (outcome.status === "unchanged") {
+    ctx.send({ type: "info", message: outcome.message });
+    return;
+  }
+  ctx.currentProvider = outcome.providerId;
+  ctx.currentModel = outcome.model;
   ctx.updateContextWindow();
-  ctx.send({ type: "info", message: `Switched to provider: ${id} (${ctx.currentModel})` });
+  syncSessionProvider(ctx);
+  ctx.send({ type: "info", message: outcome.message });
   ctx.sendStatus();
 }
 async function handleModel(args, ctx) {
-  const sub = args[0];
-  if (!sub) {
+  const intent = parseModelCommand(args, ctx.currentProvider);
+  if (intent.kind === "select") {
     ctx.send({ type: "error", message: "Usage: /model <id>|refresh [provider]|cache [clear [provider]]" });
     return;
   }
-  if (sub === "refresh") {
-    const providerId = args[1] ?? ctx.currentProvider;
+  if (intent.kind === "refresh") {
+    if (!ctx.providers.has(intent.providerId)) {
+      ctx.send({ type: "error", message: `Provider is not configured: ${intent.providerId}` });
+      return;
+    }
     try {
-      const models2 = await ctx.providers.refreshModels(providerId);
-      ctx.send({ type: "info", message: `Refreshed ${models2.length} model(s) for ${providerId}.` });
+      const models2 = await ctx.providers.refreshModels(intent.providerId);
+      ctx.send({ type: "info", message: `Refreshed ${models2.length} model(s) for ${intent.providerId}.` });
       ctx.sendStatus();
     } catch (err) {
       ctx.send({ type: "error", message: `Model refresh failed: ${err instanceof Error ? err.message : String(err)}` });
     }
     return;
   }
-  if (sub === "cache") {
-    if ((args[1] ?? "").toLowerCase() === "clear") {
-      const providerId = args[2];
-      ctx.providers.clearModelCache(providerId);
-      ctx.send({ type: "info", message: providerId ? `Cleared model cache for ${providerId}.` : "Cleared model cache." });
-      return;
-    }
+  if (intent.kind === "cache-clear") {
+    ctx.providers.clearModelCache(intent.providerId);
+    ctx.send({
+      type: "info",
+      message: intent.providerId ? `Cleared model cache for ${intent.providerId}.` : "Cleared model cache."
+    });
+    return;
+  }
+  if (intent.kind === "cache-show") {
     const rows = ctx.providers.getModelCacheStatus();
     ctx.send({
       type: "info",
@@ -15592,16 +15803,25 @@ async function handleModel(args, ctx) {
     });
     return;
   }
-  const modelId = sub;
   const models = await ctx.providers.listModels(ctx.currentProvider);
-  const found = models.find((m) => m.id === modelId);
-  if (!found) {
-    ctx.send({ type: "error", message: `Model "${modelId}" not found` });
+  const outcome = resolveModelSwitch({
+    targetModel: intent.modelId,
+    currentModel: ctx.currentModel,
+    provider: ctx.currentProvider,
+    knownModels: models.map((m) => m.id),
+    messageCount: ctx.sessions.current?.messages.length ?? 0
+  });
+  if (outcome.status === "unchanged") {
+    ctx.send({ type: "info", message: outcome.message });
     return;
   }
-  ctx.currentModel = modelId;
+  ctx.currentModel = outcome.model;
   ctx.updateContextWindow();
-  ctx.send({ type: "info", message: `Switched to model: ${modelId}` });
+  syncSessionProvider(ctx);
+  ctx.send({
+    type: "info",
+    message: outcome.warning ? `${outcome.message} \u2014 ${outcome.warning}` : outcome.message
+  });
   ctx.sendStatus();
 }
 async function handleThink(args, ctx) {
@@ -15611,7 +15831,7 @@ async function handleThink(args, ctx) {
     runtimeEffort: ctx.runtimeThinkingEffort,
     configuredThinking: modelParams?.thinking,
     configuredEffort: modelParams?.thinkingEffort,
-    supportsEffort: ctx.providers.get(ctx.currentProvider)?.supportsReasoningEffort ?? false,
+    supportsEffort: ctx.providers.has(ctx.currentProvider) ? ctx.providers.get(ctx.currentProvider).supportsReasoningEffort : false,
     provider: ctx.currentProvider
   });
   if (outcome.changed) {
@@ -15625,24 +15845,59 @@ async function handleThink(args, ctx) {
   if (outcome.changed) ctx.sendStatus();
 }
 async function handlePlan(args, ctx) {
-  const sub = args[0];
-  if (sub === "exit" || sub === "cancel") {
-    ctx.planMode = false;
-    ctx.send({ type: "info", message: "Plan mode OFF." });
-  } else if (sub === "execute") {
-    ctx.planMode = false;
-    ctx.send({ type: "info", message: "Plan mode OFF. Executing with all tools enabled." });
-  } else if (sub === "status" || sub === "show") {
-    ctx.send({ type: "info", message: `Plan mode: ${ctx.planMode ? "ON (read-only tools only)" : "OFF"}` });
+  const outcome = applyPlanCommand(args[0], ctx.planMode);
+  if (outcome.changed) ctx.planMode = outcome.planMode;
+  ctx.send({
+    type: outcome.status === "unknown" ? "error" : "info",
+    message: [outcome.summary, ...outcome.details].join(" \u2014 ")
+  });
+  if (outcome.changed) ctx.sendStatus();
+}
+async function handleRoute(args, ctx) {
+  const intent = parseRouteCommand(args);
+  const routing = ctx.config.get("routing");
+  if (intent.kind === "enable" || intent.kind === "disable") {
+    const on = intent.kind === "enable";
+    ctx.config.setByPath("routing.enabled", on ? "true" : "false");
+    const note = on ? routingEmptyRulesNote(routing) : null;
+    ctx.send({
+      type: "info",
+      message: `Smart model routing ${on ? "enabled" : "disabled"}.` + (note ? `
+${note}` : "")
+    });
+    ctx.sendStatus();
     return;
-  } else if (sub !== void 0) {
-    ctx.send({ type: "error", message: `Unknown /plan option "${sub}" \u2014 expected execute | exit | status` });
+  }
+  if (intent.kind === "usage" || intent.kind === "unknown") {
+    ctx.send({ type: "error", message: intent.message });
     return;
+  }
+  if (intent.kind === "test") {
+    const decision = ctx.computeRoutingDecision(intent.message);
+    ctx.send({
+      type: "info",
+      message: routeDecisionRows(intent.message, ctx.currentModel, decision).map((row) => `${row.label}: ${row.value}`).join("\n")
+    });
+    return;
+  }
+  const view = describeRouting({ routing, provider: ctx.currentProvider, currentModel: ctx.currentModel });
+  const lines = [
+    "Smart Model Routing",
+    `Status:   ${view.enabled ? "enabled" : "disabled"}`,
+    `Provider: ${view.provider}`,
+    `Current:  ${view.currentModel}`
+  ];
+  if (view.fallback) lines.push(`Fallback: ${view.fallback}`);
+  if (view.noRulesNote) {
+    lines.push(view.noRulesNote);
   } else {
-    ctx.planMode = !ctx.planMode;
-    ctx.send({ type: "info", message: `Plan mode: ${ctx.planMode ? "ON (read-only tools only)" : "OFF"}` });
+    lines.push("Rules (evaluated top-to-bottom):");
+    for (const rule of view.rules) {
+      lines.push(`  #${rule.index} ${rule.name ? `${rule.name} ` : ""}${rule.condition} \u2192 ${rule.model}`);
+    }
   }
-  ctx.sendStatus();
+  lines.push(view.hint);
+  ctx.send({ type: "info", message: lines.join("\n") });
 }
 
 // src/core/session-cost.ts
@@ -16152,6 +16407,232 @@ function lastAssistantText(messages) {
   return void 0;
 }
 
+// src/core/session-command.ts
+var DEFAULT_SESSION_LIST_LIMIT = 50;
+function parseSessionListArgs(args) {
+  let limit = DEFAULT_SESSION_LIST_LIMIT;
+  let all = false;
+  const filter = {};
+  const warnings = [];
+  let search = null;
+  let days = null;
+  let since = null;
+  let sort = { field: "updated", order: "desc" };
+  let json = false;
+  let stale = null;
+  let verbose = false;
+  for (let i = 1; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--all" || a === "-a") {
+      all = true;
+    } else if ((a === "--limit" || a === "-n") && i + 1 < args.length) {
+      const n = Number(args[i + 1]);
+      if (Number.isFinite(n) && n > 0) {
+        limit = n;
+        i++;
+      }
+    } else if (a === "--filter" && i + 1 < args.length) {
+      const val = args[++i];
+      const eq = val.indexOf("=");
+      if (eq > 0) {
+        const key = val.slice(0, eq);
+        const vals = val.slice(eq + 1).split(",").map((s) => s.trim().toLowerCase());
+        if (key === "provider") filter.provider = vals;
+        else if (key === "model") filter.model = vals;
+        else if (key === "messages") {
+          const n = Number(vals[0]);
+          if (Number.isFinite(n) && n >= 0) filter.messages = n;
+          else warnings.push(`Invalid filter value for "messages": expected a non-negative integer, got "${vals[0]}"`);
+        } else {
+          warnings.push(`Unknown filter key: "${key}". Supported keys: provider, model, messages`);
+        }
+      } else {
+        warnings.push(`Invalid --filter syntax: "${val}". Expected key=value`);
+      }
+    } else if ((a === "--search" || a === "-s") && i + 1 < args.length) {
+      search = args[++i];
+    } else if (a === "--days" && i + 1 < args.length) {
+      const n = Number(args[++i]);
+      if (Number.isFinite(n) && n > 0) days = n;
+    } else if (a === "--since" && i + 1 < args.length) {
+      since = args[++i];
+    } else if (a === "--sort" && i + 1 < args.length) {
+      const sv = args[++i];
+      const colon = sv.indexOf(":");
+      const field = colon > 0 ? sv.slice(0, colon) : sv;
+      const order = colon > 0 ? sv.slice(colon + 1) : "desc";
+      if (field === "updated" || field === "created" || field === "messages" || field === "size") {
+        sort = { field, order: order === "asc" ? "asc" : "desc" };
+      }
+    } else if (a === "--json") {
+      json = true;
+    } else if (a === "--verbose" || a === "-v") {
+      verbose = true;
+    } else if (a === "--stale" && i + 1 < args.length) {
+      const n = Number(args[++i]);
+      if (Number.isFinite(n) && n > 0) stale = n;
+    }
+  }
+  if (all) limit = -1;
+  return { limit, all, filter, search, days, since, sort, json, stale, verbose, warnings };
+}
+function sessionListNeedsFileSize(opts) {
+  return opts.verbose || opts.sort.field === "size";
+}
+function selectSessions(sessions, opts, now = Date.now()) {
+  let matched = sessions;
+  const hasFilters = !!opts.filter.provider || !!opts.filter.model || opts.filter.messages !== void 0;
+  const hasSearch = !!opts.search;
+  const hasTimeFilter = opts.days !== null || opts.since !== null;
+  const hasStale = opts.stale !== null;
+  if (hasFilters) {
+    const p = opts.filter.provider;
+    const m = opts.filter.model;
+    const msg = opts.filter.messages;
+    matched = matched.filter((s) => {
+      if (p && !p.includes(s.provider.toLowerCase())) return false;
+      if (m && !m.some((kw) => s.model.toLowerCase().includes(kw))) return false;
+      if (msg !== void 0 && s.messageCount !== msg) return false;
+      return true;
+    });
+  }
+  if (hasSearch) {
+    const q = opts.search.toLowerCase();
+    matched = matched.filter(
+      (s) => (s.title ?? "").toLowerCase().includes(q) || s.id.toLowerCase().includes(q)
+    );
+  }
+  if (hasTimeFilter) {
+    let cutoff = 0;
+    if (opts.since) cutoff = new Date(opts.since).getTime();
+    else if (opts.days !== null) cutoff = now - opts.days * 24 * 60 * 60 * 1e3;
+    if (!Number.isNaN(cutoff)) {
+      matched = matched.filter((s) => s.updated.getTime() >= cutoff);
+    }
+  }
+  const staleCutoff = hasStale ? now - opts.stale * 24 * 60 * 60 * 1e3 : null;
+  if (staleCutoff !== null) {
+    matched = matched.filter((s) => s.updated.getTime() < staleCutoff);
+  }
+  const defaultSort = opts.sort.field === "updated" && opts.sort.order === "desc";
+  if (!defaultSort) {
+    const mul = opts.sort.order === "asc" ? 1 : -1;
+    matched = [...matched].sort((a, b) => {
+      switch (opts.sort.field) {
+        case "created":
+          return (a.created.getTime() - b.created.getTime()) * mul;
+        case "messages":
+          return (a.messageCount - b.messageCount) * mul;
+        case "size":
+          return ((a.fileSize ?? 0) - (b.fileSize ?? 0)) * mul;
+        default:
+          return (a.updated.getTime() - b.updated.getTime()) * mul;
+      }
+    });
+  }
+  const filterTags = [];
+  if (hasFilters) filterTags.push("filtered");
+  if (hasSearch) filterTags.push("searched");
+  if (hasTimeFilter) filterTags.push("time-limited");
+  if (hasStale) filterTags.push(`stale >${opts.stale}d`);
+  return {
+    matched,
+    shown: opts.limit > 0 ? matched.slice(0, opts.limit) : matched,
+    totalCount: matched.length,
+    totalMessages: matched.reduce((sum, s) => sum + s.messageCount, 0),
+    staleCutoff,
+    filterTags,
+    needsFileSize: sessionListNeedsFileSize(opts)
+  };
+}
+function sessionListSummary(view) {
+  const tag = view.filterTags.length > 0 ? ` (${view.filterTags.join(", ")})` : "";
+  return `${view.shown.length} of ${view.totalCount} sessions${tag} \xB7 ${view.totalMessages} messages total`;
+}
+function sessionListJsonRow(s, includeFileSize) {
+  return {
+    id: s.id,
+    title: s.title ?? null,
+    provider: s.provider,
+    model: s.model,
+    messageCount: s.messageCount,
+    created: s.created.toISOString(),
+    updated: s.updated.toISOString(),
+    ...includeFileSize ? { fileSize: s.fileSize } : {},
+    ...s.branchCount !== void 0 ? { branchCount: s.branchCount, activeBranch: s.activeBranch } : {}
+  };
+}
+function resolveSessionRef(sessions, prefix, policy) {
+  const matches2 = sessions.filter((s) => s.id.startsWith(prefix));
+  if (matches2.length === 0) {
+    return { status: "not-found", message: `Session '${prefix}' not found.` };
+  }
+  if (matches2.length > 1 && policy === "strict") {
+    return {
+      status: "ambiguous",
+      matches: matches2,
+      message: `Ambiguous prefix '${prefix}' matches ${matches2.length} sessions \u2014 be more specific:`
+    };
+  }
+  return {
+    status: "ok",
+    match: matches2[0],
+    ambiguousWith: matches2.length > 1 ? matches2 : [],
+    message: matches2.length > 1 ? `\u26A0 Ambiguous prefix '${prefix}' matches ${matches2.length} sessions \u2014 loading most recent:` : void 0
+  };
+}
+function formatSessionSummaryLine(s, titleWidth = 60) {
+  const title = s.title ?? "(untitled)";
+  const shown = title.length > titleWidth ? `${title.slice(0, titleWidth - 1)}\u2026` : title;
+  return `${s.id.slice(0, 12)}  ${s.provider}/${s.model}  ${String(s.messageCount).padStart(4)} msgs  ${s.updated.toISOString().slice(0, 10)}  ${shown}`;
+}
+function parseBatchDeleteArgs(args) {
+  let messages;
+  let dryRun = false;
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === "--filter" && i + 1 < args.length) {
+      const val = args[++i];
+      const eq = val.indexOf("=");
+      if (eq <= 0) {
+        return { dryRun, error: `Invalid --filter syntax: "${val}". Expected key=value (e.g., messages=0)` };
+      }
+      const key = val.slice(0, eq);
+      const vals = val.slice(eq + 1).split(",").map((s) => s.trim().toLowerCase());
+      if (key !== "messages") {
+        return { dryRun, error: `Unsupported filter key for delete: "${key}". Only "messages" is supported.` };
+      }
+      const n = Number(vals[0]);
+      if (!Number.isFinite(n) || n < 0) {
+        return { dryRun, error: `Invalid filter value for "messages": expected a non-negative integer, got "${vals[0]}"` };
+      }
+      messages = n;
+    } else if (args[i] === "--dry-run") {
+      dryRun = true;
+    }
+  }
+  if (messages === void 0) {
+    return { dryRun, error: "Usage: /session delete --filter messages=N [--dry-run]" };
+  }
+  return { messages, dryRun };
+}
+function parseCleanArgs(args) {
+  let staleDays = 90;
+  let dryRun = false;
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === "--stale" && i + 1 < args.length) {
+      const n = Number(args[++i]);
+      if (Number.isFinite(n) && n > 0) staleDays = n;
+    } else if (args[i] === "--dry-run") {
+      dryRun = true;
+    }
+  }
+  return { staleDays, dryRun };
+}
+function selectStaleSessions(sessions, staleDays, now = Date.now()) {
+  const cutoff = now - staleDays * 24 * 60 * 60 * 1e3;
+  return sessions.filter((s) => s.updated.getTime() < cutoff);
+}
+
 // src/web/commands/session-commands.ts
 async function handleClear(_args, ctx) {
   ctx.saveIfNeeded();
@@ -16175,7 +16656,7 @@ Cache:  write=${cacheCreate} read=${cacheRead}` : "";
 Cost:   ${formatCost(cost)}` : "";
   let memoryLine = "";
   try {
-    const { countPendingMemories: countPendingMemories2 } = await import("./persistent-memory-ZFR5GI7D.js");
+    const { countPendingMemories: countPendingMemories2 } = await import("./persistent-memory-QZN4Q3W4.js");
     const pending = countPendingMemories2(ctx.config.getConfigDir());
     if (pending > 0) memoryLine = `
 Memory: \u26A0 ${pending} pending approval \u2014 see the Memory panel or /memory`;
@@ -16218,11 +16699,17 @@ async function handleSession(args, ctx) {
       ctx.sendSessionList();
       return;
     }
-    const list = ctx.sessions.listSessions();
-    const found = list.find((s) => s.id.startsWith(targetId));
-    if (found) {
+    const ref = resolveSessionRef(ctx.sessions.listSessions(), targetId, "most-recent");
+    if (ref.status === "ok") {
+      const found = ref.match;
       ctx.sessions.loadSession(found.id);
       ctx.resetWebSessionUsage();
+      if (ref.message) {
+        ctx.send({
+          type: "info",
+          message: [ref.message, ...ref.ambiguousWith.slice(0, 5).map((m) => `  ${formatSessionSummaryLine(m)}`)].join("\n")
+        });
+      }
       ctx.send({ type: "info", message: `Loaded session: ${found.id.slice(0, 8)} "${found.title ?? ""}" (${found.messageCount} messages)` });
       const loadedSession = ctx.sessions.current;
       if (loadedSession && loadedSession.messages.length > 0) {
@@ -16252,52 +16739,81 @@ async function handleSession(args, ctx) {
     return;
   }
   if (sub === "list") {
-    ctx.sendSessionList();
+    if (args.length <= 1) {
+      ctx.sendSessionList();
+      return;
+    }
+    const opts = parseSessionListArgs(args);
+    const all = ctx.sessions.listSessions({ includeFileSize: sessionListNeedsFileSize(opts) });
+    if (all.length === 0) {
+      ctx.send({ type: "info", message: "No saved sessions." });
+      return;
+    }
+    const view = selectSessions(all, opts);
+    if (view.totalCount === 0) {
+      ctx.send({
+        type: "info",
+        message: [...opts.warnings.map((w) => `\u26A0 ${w}`), "No sessions match the filter criteria."].join("\n")
+      });
+      return;
+    }
+    if (opts.json) {
+      ctx.send({
+        type: "info",
+        message: JSON.stringify(view.shown.map((s) => sessionListJsonRow(s, view.needsFileSize)), null, 2)
+      });
+      return;
+    }
+    const lines = [
+      ...opts.warnings.map((w) => `\u26A0 ${w}`),
+      ...view.shown.map((s) => formatSessionSummaryLine(s)),
+      `\u2500\u2500 ${sessionListSummary(view)}`
+    ];
+    if (view.shown.length < view.totalCount) lines.push("Use --all to show all, or --limit N to change count.");
+    ctx.send({ type: "info", message: lines.join("\n") });
     return;
   }
   if (sub === "delete" && args[1]) {
     const targetId = args[1];
     if (targetId === "--filter") {
-      let filterMessages;
-      for (let i = 1; i < args.length; i++) {
-        if (args[i] === "--filter" && i + 1 < args.length) {
-          const val = args[i + 1];
-          i++;
-          const eq = val.indexOf("=");
-          if (eq > 0) {
-            const key = val.slice(0, eq);
-            const vals = val.slice(eq + 1).split(",").map((s) => s.trim().toLowerCase());
-            if (key === "messages") {
-              const n = Number(vals[0]);
-              if (Number.isFinite(n) && n >= 0) filterMessages = n;
-            }
-          }
-        }
-      }
-      if (filterMessages === void 0) {
-        ctx.send({ type: "error", message: "Usage: /session delete --filter messages=N" });
+      const opts = parseBatchDeleteArgs(args);
+      if (opts.error) {
+        ctx.send({ type: "error", message: opts.error });
         return;
       }
-      const list2 = ctx.sessions.listSessions();
-      const matches2 = list2.filter((s) => s.messageCount === filterMessages);
+      const matches2 = ctx.sessions.listSessions().filter((s) => s.messageCount === opts.messages);
       if (matches2.length === 0) {
-        ctx.send({ type: "info", message: `No sessions with ${filterMessages} message(s) found.` });
+        ctx.send({ type: "info", message: `No sessions with ${opts.messages} message(s) found.` });
+        return;
+      }
+      const preview = [
+        `Found ${matches2.length} session(s) with ${opts.messages} message(s):`,
+        ...matches2.slice(0, 20).map((s) => `  ${formatSessionSummaryLine(s)}`),
+        ...matches2.length > 20 ? [`  ... and ${matches2.length - 20} more`] : []
+      ];
+      if (opts.dryRun) {
+        ctx.send({
+          type: "info",
+          message: [...preview, "--dry-run: no sessions were deleted. Remove --dry-run to actually delete."].join("\n")
+        });
         return;
       }
       let deleted = 0;
       let failed = 0;
       for (const s of matches2) {
-        if (ctx.sessions.deleteSession(s.id)) {
-          deleted++;
-        } else {
-          failed++;
-        }
+        if (ctx.sessions.deleteSession(s.id)) deleted++;
+        else failed++;
       }
       if (!ctx.sessions.current) {
-        ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+        const created = ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+        ctx.unsavedSessions.set(created.id, created);
         ctx.resetWebSessionUsage();
       }
-      ctx.send({ type: "info", message: `Deleted ${deleted} session(s) with ${filterMessages} message(s)${failed > 0 ? `, ${failed} failed` : ""}.` });
+      ctx.send({
+        type: "info",
+        message: [...preview, `Deleted ${deleted} session(s)${failed > 0 ? `, ${failed} failed` : ""}.`].join("\n")
+      });
+      ctx.sendStatus();
       ctx.sendSessionList();
       return;
     }
@@ -16306,20 +16822,79 @@ async function handleSession(args, ctx) {
       ctx.unsavedSessions.delete(cachedKey);
       if (ctx.sessions.current?.id === cachedKey) {
         ctx.sessions.clearCurrent();
+        const created = ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+        ctx.unsavedSessions.set(created.id, created);
+        ctx.resetWebSessionUsage();
+        ctx.sendStatus();
       }
       ctx.send({ type: "info", message: `Deleted session: ${cachedKey.slice(0, 8)}` });
       ctx.sendSessionList();
       return;
     }
-    const list = ctx.sessions.listSessions();
-    const found = list.find((s) => s.id.startsWith(targetId));
-    if (found) {
-      ctx.sessions.deleteSession(found.id);
-      ctx.send({ type: "info", message: `Deleted session: ${found.id.slice(0, 8)}` });
-      ctx.sendSessionList();
-    } else {
+    const ref = resolveSessionRef(ctx.sessions.listSessions(), targetId, "strict");
+    if (ref.status === "not-found") {
       ctx.send({ type: "error", message: `Session not found: ${targetId}` });
+      return;
+    }
+    if (ref.status === "ambiguous") {
+      ctx.send({
+        type: "error",
+        message: [ref.message, ...ref.matches.slice(0, 10).map((m) => `  ${formatSessionSummaryLine(m)}`)].join("\n")
+      });
+      return;
+    }
+    const wasCurrent = ctx.sessions.current?.id === ref.match.id;
+    if (!ctx.sessions.deleteSession(ref.match.id)) {
+      ctx.send({ type: "error", message: "Delete failed \u2014 session file not found on disk." });
+      return;
     }
+    ctx.send({ type: "info", message: `Deleted session: ${ref.match.id.slice(0, 8)}` });
+    if (wasCurrent) {
+      const created = ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+      ctx.unsavedSessions.set(created.id, created);
+      ctx.resetWebSessionUsage();
+      ctx.send({ type: "info", message: "Current session was deleted \u2014 started a fresh session." });
+      ctx.sendStatus();
+    }
+    ctx.sendSessionList();
+    return;
+  }
+  if (sub === "clean") {
+    const opts = parseCleanArgs(args);
+    const stale = selectStaleSessions(ctx.sessions.listSessions(), opts.staleDays);
+    if (stale.length === 0) {
+      ctx.send({ type: "info", message: `No sessions older than ${opts.staleDays} days found.` });
+      return;
+    }
+    const preview = [
+      `Found ${stale.length} session(s) not updated in ${opts.staleDays}+ days:`,
+      ...stale.slice(0, 20).map((s) => `  ${formatSessionSummaryLine(s)}`),
+      ...stale.length > 20 ? [`  ... and ${stale.length - 20} more`] : []
+    ];
+    if (opts.dryRun) {
+      ctx.send({
+        type: "info",
+        message: [...preview, "--dry-run: no sessions were deleted. Remove --dry-run to actually delete."].join("\n")
+      });
+      return;
+    }
+    let deleted = 0;
+    let failed = 0;
+    for (const s of stale) {
+      if (ctx.sessions.deleteSession(s.id)) deleted++;
+      else failed++;
+    }
+    if (!ctx.sessions.current) {
+      const created = ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+      ctx.unsavedSessions.set(created.id, created);
+      ctx.resetWebSessionUsage();
+      ctx.sendStatus();
+    }
+    ctx.send({
+      type: "info",
+      message: [...preview, `Cleaned up: ${deleted} deleted${failed > 0 ? `, ${failed} failed` : ""}.`].join("\n")
+    });
+    ctx.sendSessionList();
     return;
   }
   if (sub === "batch-delete") {
@@ -16343,6 +16918,12 @@ async function handleSession(args, ctx) {
         deleted++;
       }
     }
+    if (!ctx.sessions.current) {
+      const created = ctx.sessions.createSession(ctx.currentProvider, ctx.currentModel);
+      ctx.unsavedSessions.set(created.id, created);
+      ctx.resetWebSessionUsage();
+      ctx.sendStatus();
+    }
     ctx.send({ type: "info", message: `Deleted ${deleted} session(s).` });
     ctx.sendSessionList();
     return;
@@ -16356,26 +16937,40 @@ async function handleSession(args, ctx) {
     }
     const cachedKey = ctx.unsavedSessions.has(targetId) ? targetId : [...ctx.unsavedSessions.keys()].find((k) => k.startsWith(targetId));
     if (cachedKey) {
-      const session = ctx.unsavedSessions.get(cachedKey);
-      session.title = newTitle;
+      const session2 = ctx.unsavedSessions.get(cachedKey);
+      session2.title = newTitle;
       ctx.send({ type: "info", message: `Renamed session: "${newTitle}"` });
       ctx.sendSessionList();
       return;
     }
-    const list = ctx.sessions.listSessions();
-    const found = list.find((s) => s.id.startsWith(targetId));
-    if (found) {
-      const session = ctx.sessions.loadSession(found.id);
-      session.title = newTitle;
-      ctx.sessions.save();
-      ctx.send({ type: "info", message: `Renamed session: "${newTitle}"` });
-      ctx.sendSessionList();
-    } else {
+    const ref = resolveSessionRef(ctx.sessions.listSessions(), targetId, "strict");
+    if (ref.status === "not-found") {
       ctx.send({ type: "error", message: `Session not found: ${targetId}` });
+      return;
+    }
+    if (ref.status === "ambiguous") {
+      ctx.send({
+        type: "error",
+        message: [ref.message, ...ref.matches.slice(0, 10).map((m) => `  ${formatSessionSummaryLine(m)}`)].join("\n")
+      });
+      return;
     }
+    const priorId = ctx.sessions.current?.id ?? null;
+    const isCurrent = priorId === ref.match.id;
+    const session = isCurrent ? ctx.sessions.current : ctx.sessions.loadSession(ref.match.id);
+    session.title = newTitle;
+    ctx.sessions.save();
+    if (!isCurrent && priorId) {
+      ctx.sessions.loadSession(priorId);
+    }
+    ctx.send({ type: "info", message: `Renamed session: "${newTitle}"` });
+    ctx.sendSessionList();
     return;
   }
-  ctx.send({ type: "info", message: "Usage: /session new | list | load <id> | delete <id> | delete --filter messages=N | rename <id> <title>" });
+  ctx.send({
+    type: "info",
+    message: "Usage: /session new | list [--filter k=v] [--search kw] [--limit N|--all] [--sort f[:o]] [--json] | load <id> | delete <id> | delete --filter messages=N [--dry-run] | clean --stale N [--dry-run] | rename <id> <title>"
+  });
 }
 async function handleExport(args, ctx) {
   const format = args[0] === "json" ? "json" : "md";
@@ -16988,7 +17583,7 @@ async function handleTest(args, ctx) {
       const isCommand = argStr.includes(" ") || /^(mvn|gradle|npm|pytest|cargo|go)\b/.test(argStr);
       testArgs = isCommand ? { command: argStr } : { filter: argStr };
     }
-    const runTests = ctx.runTests ?? (await import("./run-tests-USV7IJ7X.js")).executeTests;
+    const runTests = ctx.runTests ?? (await import("./run-tests-HMHHIG7Y.js")).executeTests;
     const report = await runTests(testArgs);
     ctx.send({ type: "info", message: report });
   } catch (err) {
@@ -17324,7 +17919,7 @@ async function handleMemory(args, ctx) {
     ctx.handleMemoryManage(sub, args[1], sub === "expire" ? args[2] : void 0);
   } else if (sub === "export") {
     if (args[1] === "md") {
-      const { exportMemoryEntries: exportMemoryEntries2 } = await import("./persistent-memory-ZFR5GI7D.js");
+      const { exportMemoryEntries: exportMemoryEntries2 } = await import("./persistent-memory-QZN4Q3W4.js");
       ctx.send({
         type: "export_data",
         format: "md",
@@ -17766,8 +18361,9 @@ async function handleHelp(_args, ctx) {
       "  /clear               \u2014 Clear conversation & start new session",
       "  /compact [hint]      \u2014 Compress conversation history",
       "  /think [on|off]      \u2014 Toggle extended thinking mode",
-      "  /plan [enter|exit]   \u2014 Toggle read-only planning mode",
-      "  /session new|list|load|delete <id> \u2014 Session management",
+      "  /plan [execute|exit|status] \u2014 Read-only planning mode (bare /plan enters it)",
+      "  /route [on|off|show|test <msg>] \u2014 Smart model routing",
+      "  /session new|list [filters]|load <id>|delete <id>|delete --filter messages=N [--dry-run]|clean --stale N [--dry-run]|rename <id> <title> \u2014 Session management",
       "  /system [prompt|clear] \u2014 Set/view/reset system prompt",
       "  /context [status|reload] \u2014 Show/reload context layers",
       "  /status              \u2014 Show session info & token usage",
@@ -17903,8 +18499,9 @@ var CLI_ONLY_WEB_COMMANDS = /* @__PURE__ */ new Map([
   ["snapshot", "Dev-state snapshots are written when the terminal REPL exits."],
   ["hooks", "Hook trust is granted per machine from the terminal."],
   ["hook", "Hook trust is granted per machine from the terminal."],
-  // 以下两条并非「终端才有意义」，而是 Web 侧尚未实现——如实说明，别假装是设计。
-  ["route", "Smart model routing is not applied to Web sessions yet (config.routing is REPL-only)."],
+  // 以下一条并非「终端才有意义」，而是 Web 侧尚未实现——如实说明，别假装是设计。
+  // （`route` 曾在这里，理由写的是「Web 尚未应用智能路由」；v0.4.269 让 routing 在 Web
+  // 上真正生效之后那句话就不再成立，命令已在 Web 实现，见 commands/provider-commands.ts。）
   ["security", "Redaction status and toggles are terminal-only for now; /status shows the current profile."]
 ]);
 var webCommandHandlers = {
@@ -17912,6 +18509,7 @@ var webCommandHandlers = {
   model: handleModel,
   think: handleThink,
   plan: handlePlan,
+  route: handleRoute,
   clear: handleClear,
   compact: handleCompact,
   status: handleStatus,