@xbzbing/dsh-git-panel 1.6.2 → 1.8.0

package/lib/host/queries.js

@@ -1,15 +1,21 @@
 import { join, sep } from "node:path";
 import { mapWorkspaceFailure, resolveBrowseRoot, resolveWorkspace, runCommand, snapshotForSession } from "./core.js";
 import { isSafePath, isSafeRev } from "./validate.js";
+import { walkHistoryTopology } from "./history-topology.js";
 import { commitFromFields, parseBranches, parseGraphLog, parseNameStatus, parseStashList, parseTags, sumNumstat } from "./parser.js";
-import { imageMimeFor, DIFF_CONTEXT_DEFAULT, DIFF_CONTEXT_MAX, DIFF_COUNT_READ_MAX } from "./types.js";
+import { imageMimeFor, isHistoryHashSearch, isHistoryFiltered, DIFF_CONTEXT_DEFAULT, DIFF_CONTEXT_MAX, DIFF_COUNT_READ_MAX, FILE_COPY_MAX_BYTES } from "./types.js";
 const GRAPH_FORMAT = "--format=%H%x1f%h%x1f%P%x1f%an%x1f%aI%x1f%D%x1f%s%x1e";
+const FIRST_PARENT_DIFF = "--diff-merges=first-parent";
 const VISIBLE_REFS = ["--branches", "--remotes", "--tags", "HEAD"];
-function isHexLike(text) {
-  return /^[0-9a-fA-F]{7,40}$/.test(text.trim());
-}
 async function runQuery(deps, config, request) {
   const q = request.query;
+  if (q.kind === "model-catalog") {
+    try {
+      return await queryModelCatalog(deps);
+    } catch (error) {
+      return { ok: false, error: { code: "git-error", message: error instanceof Error ? error.message : String(error) } };
+    }
+  }
   if (q.kind === "dir-list" || q.kind === "file-content") {
     const browse = await resolveBrowseRoot(deps, request.sessionId);
     if (!browse.ok) return { ok: false, error: browse.error };
@@ -61,13 +67,19 @@ async function queryHistory(deps, root, q) {
   const skip = Number.isFinite(q.skip) ? Math.max(0, Math.trunc(q.skip)) : 0;
   const args = ["git", "log", "--topo-order", "--decorate=full", GRAPH_FORMAT, `--max-count=${limit}`, `--skip=${skip}`];
   const search = q.search?.trim() ?? "";
-  const hexJump = search !== "" && isHexLike(search);
+  const hexJump = isHistoryHashSearch(search);
+  const filtered = isHistoryFiltered(q);
+  const author = q.author ?? "";
+  const since = q.since ?? "";
+  const searchFilter = search !== "";
+  const authorFilter = author !== "";
+  const sinceFilter = since !== "";
   const countArgs = ["git", "rev-list", "--count"];
   if (!hexJump) {
     const filters = [];
-    if (search !== "") filters.push("-i", "-E", `--grep=${search}`);
-    if (q.author !== void 0 && q.author !== "") filters.push(`--author=${q.author}`);
-    if (q.since !== void 0 && q.since !== "") filters.push(`--since=${q.since}`);
+    if (searchFilter) filters.push("-i", "-E", `--grep=${search}`);
+    if (authorFilter) filters.push(`--author=${author}`);
+    if (sinceFilter) filters.push(`--since=${since}`);
     if (q.ref !== void 0 && q.ref !== "") {
       if (!isSafeRev(q.ref)) return { ok: false, error: { code: "invalid-name", message: `unsafe ref: ${q.ref}` } };
       filters.push("--end-of-options", q.ref);
@@ -89,7 +101,7 @@ async function queryHistory(deps, root, q) {
   if (res.run.exitCode !== 0) {
     const stderr = res.run.stderr.trim();
     if (hexJump || /unknown revision|bad revision|does not have any commits|ambiguous argument/i.test(stderr)) {
-      return { ok: true, value: { kind: "history", commits: [], total: 0 } };
+      return { ok: true, value: { kind: "history", commits: [], total: 0, ...filtered ? { topology: [] } : {} } };
     }
     return { ok: false, error: { code: "git-error", message: stderr || `git exited ${res.run.exitCode}` } };
   }
@@ -99,7 +111,8 @@ async function queryHistory(deps, root, q) {
     const n = Number(countRes.run.stdout.trim());
     if (Number.isFinite(n)) total = n;
   }
-  return { ok: true, value: { kind: "history", commits, total } };
+  const topology = filtered ? commits.length === 0 ? [] : await walkHistoryTopology(deps.run, root, commits.map((c) => c.hash), deps.signal) : void 0;
+  return { ok: true, value: { kind: "history", commits, total, ...topology !== void 0 ? { topology } : {} } };
 }
 async function queryDiff(deps, root, q) {
   if (!isSafePath(q.path)) return { ok: false, error: { code: "invalid-path", message: q.path } };
@@ -110,7 +123,7 @@ async function queryDiff(deps, root, q) {
     args = ["git", "diff", unified, "--cached", "--", q.path];
   } else if (q.base === "commit") {
     if (!isSafeRev(q.commit)) return { ok: false, error: { code: "invalid-name", message: `unsafe commit: ${q.commit}` } };
-    args = ["git", "show", unified, "--end-of-options", q.commit, "--", q.path];
+    args = ["git", "show", unified, FIRST_PARENT_DIFF, "--end-of-options", q.commit, "--", q.path];
   } else {
     args = ["git", "diff", unified, "--", q.path];
   }
@@ -301,7 +314,8 @@ async function queryDirList(deps, root, q, isGitRepo) {
   if (rel !== "" && !isSafePath(rel) || hasGitSegment(rel)) return { ok: false, error: { code: "invalid-path", message: rel } };
   const dir = rel === "" ? root : join(root, rel);
   const inside = await isInsideRoot(deps, root, dir, true);
-  if (!inside) return { ok: false, error: { code: "invalid-path", message: rel } };
+  if (inside === "missing") return { ok: false, error: { code: "file-not-found", message: rel } };
+  if (inside === "outside") return { ok: false, error: { code: "invalid-path", message: rel } };
   let raw;
   try {
     raw = await deps.fs.readdir(dir);
@@ -352,15 +366,16 @@ async function queryFileContent(deps, config, root, q) {
   if (!isSafePath(q.path) || hasGitSegment(q.path)) return { ok: false, error: { code: "invalid-path", message: q.path } };
   const file = join(root, q.path);
   const inside = await isInsideRoot(deps, root, file, true);
-  if (!inside) return { ok: false, error: { code: "invalid-path", message: q.path } };
-  const cap = config.maxBytes;
+  if (inside === "missing") return { ok: false, error: { code: "file-not-found", message: q.path } };
+  if (inside === "outside") return { ok: false, error: { code: "invalid-path", message: q.path } };
   let info;
   try {
     info = await deps.fs.stat(file);
   } catch (error) {
-    return { ok: false, error: { code: "git-error", message: error instanceof Error ? error.message : "stat failed" } };
+    return { ok: false, error: { code: isMissingPath(error) ? "file-not-found" : "git-error", message: error instanceof Error ? error.message : "stat failed" } };
   }
   const mime = imageMimeFor(q.path);
+  const cap = mime !== null ? config.maxBytes : Math.max(config.maxBytes, FILE_COPY_MAX_BYTES);
   const statFields = { size: info.size, mtimeMs: Math.round(info.mtimeMs) };
   const tooLarge = { ok: true, value: { kind: "file-content", path: q.path, variant: mime !== null ? "image" : "text", tooLarge: true, ...statFields } };
   if (info.size > cap) return tooLarge;
@@ -368,7 +383,7 @@ async function queryFileContent(deps, config, root, q) {
   try {
     buf = await deps.fs.readFile(file);
   } catch (error) {
-    return { ok: false, error: { code: "git-error", message: error instanceof Error ? error.message : "read failed" } };
+    return { ok: false, error: { code: isMissingPath(error) ? "file-not-found" : "git-error", message: error instanceof Error ? error.message : "read failed" } };
   }
   if (buf.length > cap) return tooLarge;
   if (mime !== null) {
@@ -377,19 +392,22 @@ async function queryFileContent(deps, config, root, q) {
   if (isBinaryBuffer(buf)) return { ok: true, value: { kind: "file-content", path: q.path, variant: "binary", ...statFields } };
   const content = buf.toString("utf8");
   const lines = content === "" ? 0 : content.split("\n").length - (content.endsWith("\n") ? 1 : 0);
-  return { ok: true, value: { kind: "file-content", path: q.path, variant: "text", content, lines, ...statFields } };
+  return { ok: true, value: { kind: "file-content", path: q.path, variant: "text", content, lines, absolutePath: file, ...statFields } };
 }
 function hasGitSegment(path) {
   return path.split(/[\\/]/).includes(".git");
 }
+function isMissingPath(error) {
+  return error?.code === "ENOENT";
+}
 async function isInsideRoot(deps, root, path, hideGit = false) {
   try {
     const real = await deps.fs.realpath(path);
     const rootReal = await deps.fs.realpath(root);
-    if (real !== rootReal && !real.startsWith(rootReal + sep)) return false;
-    return !hideGit || !hasGitSegment(real.slice(rootReal.length + 1));
-  } catch {
-    return false;
+    if (real !== rootReal && !real.startsWith(rootReal + sep)) return "outside";
+    return !hideGit || !hasGitSegment(real.slice(rootReal.length + 1)) ? "inside" : "outside";
+  } catch (error) {
+    return isMissingPath(error) ? "missing" : "outside";
   }
 }
 function isBinaryBuffer(buf) {
@@ -402,8 +420,8 @@ async function queryShow(deps, root, ref) {
   const metaFormat = "--format=%H%x1f%h%x1f%s%x1f%an%x1f%aI%x1f%b";
   const [metaRes, statRes, numstatRes] = await Promise.all([
     runCommand(deps.run, ["git", "show", "-s", metaFormat, "--end-of-options", ref], root, "show-meta", deps.signal),
-    runCommand(deps.run, ["git", "show", "--name-status", "-z", "--format=", "--end-of-options", ref], root, "show-stat", deps.signal),
-    runCommand(deps.run, ["git", "show", "--numstat", "--format=", "--end-of-options", ref], root, "show-numstat", deps.signal)
+    runCommand(deps.run, ["git", "show", FIRST_PARENT_DIFF, "--name-status", "-z", "--format=", "--end-of-options", ref], root, "show-stat", deps.signal),
+    runCommand(deps.run, ["git", "show", FIRST_PARENT_DIFF, "--numstat", "--format=", "--end-of-options", ref], root, "show-numstat", deps.signal)
   ]);
   if (!("run" in metaRes)) return { ok: false, error: { code: "git-unavailable" } };
   if (metaRes.run.cancelled) return { ok: false, error: { code: "cancelled" } };
@@ -495,6 +513,53 @@ async function queryWorktreeStats(deps, config, sessionId) {
   if (!snapshot.ok) return { ok: false, error: { code: "git-error", message: "snapshot failed" } };
   return { ok: true, value: { kind: "worktree-stats", stats: snapshot.value.stats } };
 }
+async function queryModelCatalog(deps) {
+  const llm = deps.getLlm?.();
+  const empty = { kind: "model-catalog", groups: [], failures: [] };
+  if (llm === void 0 || typeof llm.listModels !== "function") {
+    return { ok: true, value: empty };
+  }
+  const listModels = llm.listModels.bind(llm);
+  const resolveModelInfo = typeof llm.resolveModelInfo === "function" ? llm.resolveModelInfo.bind(llm) : void 0;
+  const providers = llm.listProviders?.() ?? [];
+  const results = await Promise.all(providers.map(async (provider) => {
+    const name = provider.name ?? provider.id;
+    let listed;
+    try {
+      listed = await listModels(provider.id);
+    } catch (error) {
+      return { id: provider.id, name, message: error instanceof Error ? error.message : String(error) };
+    }
+    const models = await Promise.all(listed.map(async (model) => {
+      const entry = { id: model.id, name: model.name ?? model.id };
+      if (resolveModelInfo === void 0) return entry;
+      try {
+        const info = await resolveModelInfo(provider.id, model.id, deps.signal);
+        const reasoning = info.reasoning;
+        if (reasoning !== void 0 && reasoning.efforts.length > 0) {
+          return {
+            ...entry,
+            reasoning: {
+              efforts: reasoning.efforts.map((effort) => ({ id: effort.id, name: effort.name }))
+            }
+          };
+        }
+      } catch {
+      }
+      return entry;
+    }));
+    if (models.length === 0) return null;
+    return { id: provider.id, name, models };
+  }));
+  const groups = [];
+  const failures = [];
+  for (const one of results) {
+    if (one === null) continue;
+    if ("models" in one) groups.push(one);
+    else failures.push(one);
+  }
+  return { ok: true, value: { kind: "model-catalog", groups, failures } };
+}
 export {
   runQuery
 };

package/lib/host/snapshot-fingerprint.d.ts

@@ -0,0 +1,3 @@
+import type { GitSnapshot } from './types.js';
+/** Hash the final wire state; sampling time and the digest itself are not state. */
+export declare function snapshotFingerprint(snapshot: GitSnapshot): string;

package/lib/host/snapshot-fingerprint.js

@@ -0,0 +1,12 @@
+import { createHash } from "node:crypto";
+function snapshotFingerprint(snapshot) {
+  const { checkedAt: _checkedAt, stateFingerprint: _stateFingerprint, ...state } = snapshot;
+  const encoded = JSON.stringify(state, (_key, value) => {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
+    return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0));
+  });
+  return createHash("sha256").update(encoded).digest("hex");
+}
+export {
+  snapshotFingerprint
+};

package/lib/host/suggest.d.ts

@@ -19,5 +19,18 @@ export declare function parseStyleHistory(stdout: string, ownEmail: string | und
  * neutral fallback.
  */
 export declare function resolveSuggestLanguage(setting: SuggestLanguage, samples: readonly string[]): ResolvedLanguage;
+/** A diff line longer than this is replaced by a one-line marker before the
+ * model-input budget is applied. Build output is minified into single lines (a
+ * bundled `lib/client.js` line can be hundreds of KB), so shipping it verbatim
+ * spends the whole `suggestMaxBytes` budget on one line and cuts off the hunks
+ * that actually describe the change. Line count and the diff prefix are kept,
+ * so `@@` headers still describe the same regions. */
+export declare const LONG_LINE_MAX_CHARS = 400;
+/** Fold over-long lines into `<prefix>… [long line: N chars omitted]`.
+ * `N` counts UTF-16 code units (what `String.length` reports), not bytes. */
+export declare function compactLongLines(text: string, maxChars?: number): {
+    text: string;
+    folded: number;
+};
 /** Generate a commit message for the session's uncommitted changes. */
 export declare function runSuggest(deps: SnapshotDeps, config: GitPanelConfig, request: GitSuggestRequest): Promise<GitSuggestResult>;

package/lib/host/suggest.js

@@ -59,9 +59,21 @@ function systemPrompt(language) {
   ].join("\n");
 }
 const UNTRACKED_FILE_CAP = 16;
-function resolveRoute(config, agentDefaultModel) {
+const PROMPT_FILE_CAP = 200;
+function resolveRoute(config, sessionModel, agentDefaultModel) {
   if (config.suggestProvider !== void 0 && config.suggestModel !== void 0) {
-    return { provider: config.suggestProvider, model: config.suggestModel };
+    return {
+      provider: config.suggestProvider,
+      model: config.suggestModel,
+      ...config.suggestReasoningEffort !== void 0 ? { reasoningEffort: config.suggestReasoningEffort } : {}
+    };
+  }
+  if (sessionModel !== void 0) {
+    return {
+      provider: sessionModel.provider,
+      model: sessionModel.model,
+      ...sessionModel.reasoningEffort !== void 0 ? { reasoningEffort: sessionModel.reasoningEffort } : {}
+    };
   }
   return agentDefaultModel?.currentSelection();
 }
@@ -100,9 +112,23 @@ function truncateUtf8(text, maxBytes) {
   }
   return text.slice(0, lo);
 }
-function frameChanges(files, diff, styleSamples) {
+const LONG_LINE_MAX_CHARS = 400;
+const STRUCTURAL_LINE = /^(?:@@|diff --git |index |--- (?:a\/|\/dev\/null)|\+\+\+ (?:b\/|\/dev\/null)|new file mode |deleted file mode |old mode |new mode |similarity index |dissimilarity index |rename from |rename to |copy from |copy to |Binary files |GIT binary patch|literal |delta |\\ )/;
+function compactLongLines(text, maxChars = LONG_LINE_MAX_CHARS) {
+  if (maxChars <= 0) return { text, folded: 0 };
+  let folded = 0;
+  const lines = text.split("\n").map((line) => {
+    if (line.length <= maxChars || STRUCTURAL_LINE.test(line)) return line;
+    folded += 1;
+    const prefix = line[0] === "+" || line[0] === "-" || line[0] === " " || line[0] === "\\" ? line[0] : "";
+    return `${prefix}\u2026 [long line: ${line.length} chars omitted]`;
+  });
+  return { text: lines.join("\n"), folded };
+}
+function frameChanges(files, filesOmitted, diff, styleSamples) {
   return JSON.stringify({
     files,
+    ...filesOmitted > 0 ? { filesOmitted } : {},
     diff,
     commitStyleSamples: styleSamples.length === 0 ? null : styleSamples
   });
@@ -160,7 +186,7 @@ async function appendUntracked(deps, root, files, diff, budget) {
     }
     const res = await runCommand(deps.run, ["git", "diff", "--no-index", "--", "/dev/null", c.path], root, "suggest-untracked", deps.signal);
     if ("failure" in res || res.run.cancelled || res.run.timedOut) continue;
-    const chunk = res.run.stdout;
+    const chunk = compactLongLines(res.run.stdout).text;
     if (chunk === "") continue;
     const lossy = res.run.stdoutLossy;
     if (lossy || Buffer.byteLength(chunk, "utf8") > remaining) {
@@ -186,7 +212,7 @@ async function runSuggest(deps, config, request) {
   const pathArgs = paths.length > 0 ? ["--", ...paths] : [];
   const pathSet = new Set(paths);
   const [statusRes, headRes, logRes, emailRes] = await Promise.all([
-    runCommand(deps.run, ["git", "status", "--porcelain=v1", "-z"], root, "suggest-status", deps.signal),
+    runCommand(deps.run, ["git", "status", "--porcelain=v1", "-z", "--untracked-files=all"], root, "suggest-status", deps.signal),
     runCommand(deps.run, ["git", "rev-parse", "--verify", "HEAD"], root, "suggest-head", deps.signal),
     runCommand(deps.run, ["git", "log", `-n${HISTORY_SCAN}`, "-z", "--format=%ae%s"], root, "suggest-log", deps.signal),
     runCommand(deps.run, ["git", "config", "user.email"], root, "suggest-email", deps.signal)
@@ -201,13 +227,19 @@ async function runSuggest(deps, config, request) {
   const styleSamples = "run" in logRes && logRes.run.exitCode === 0 ? parseStyleHistory(logRes.run.stdout, "run" in emailRes && emailRes.run.exitCode === 0 ? emailRes.run.stdout.trim() : void 0) : [];
   const language = resolveSuggestLanguage(config.suggestLanguage, styleSamples);
   const all = statusRes.run.stdoutLossy ? [] : parseStatus(statusRes.run.stdout);
-  const files = pathSet.size > 0 ? all.filter((c) => pathSet.has(c.path)) : all;
+  const files = pathSet.size > 0 ? all.filter((c) => {
+    if (pathSet.has(c.path)) return true;
+    for (let slash = c.path.indexOf("/"); slash !== -1; slash = c.path.indexOf("/", slash + 1)) {
+      if (pathSet.has(c.path.slice(0, slash))) return true;
+    }
+    return false;
+  }) : all;
   const collected = await collectDiff(deps, root, hasHead, pathArgs);
   if (!("diff" in collected)) return collected;
   if (files.length === 0 && collected.diff.trim() === "") {
     return { ok: false, error: { code: "empty-diff", message: "no uncommitted changes to summarize" } };
   }
-  let diff = collected.diff;
+  let diff = compactLongLines(collected.diff).text;
   let truncated = collected.lossy;
   if (Buffer.byteLength(diff, "utf8") > config.suggestMaxBytes) {
     diff = truncateUtf8(diff, config.suggestMaxBytes) + "\n... [diff truncated]";
@@ -217,12 +249,13 @@ async function runSuggest(deps, config, request) {
   diff = untracked.diff;
   truncated = truncated || untracked.truncated;
   const llm = deps.getLlm?.();
-  const route = resolveRoute(config, deps.getAgentDefaultModel?.());
+  const route = resolveRoute(config, deps.getSessionModel?.(request.sessionId), deps.getAgentDefaultModel?.());
   if (llm === void 0 || route === void 0) {
     return { ok: false, error: { code: "llm-unavailable", message: "no model service or route is configured" } };
   }
   const frame = frameChanges(
-    files.map((c) => ({ path: c.path, status: c.status })),
+    files.slice(0, PROMPT_FILE_CAP).map((c) => ({ path: c.path, status: c.status })),
+    Math.max(0, files.length - PROMPT_FILE_CAP),
     diff,
     styleSamples
   );
@@ -230,6 +263,10 @@ async function runSuggest(deps, config, request) {
   const options = {
     provider: route.provider,
     model: route.model,
+    // Catalog effort ids come from the same adapter surface GenerateOptions
+    // accepts; the brand is compile-time only (the runtime factory lives in
+    // @deepseek-ai/dsh-llm, which is externalized), so a cast is the boundary.
+    ...route.reasoningEffort !== void 0 ? { reasoningEffort: route.reasoningEffort } : {},
     system: systemPrompt(language),
     messages: [{
       id: "git-panel-suggest",
@@ -270,11 +307,14 @@ async function runSuggest(deps, config, request) {
       message,
       provider: route.provider,
       model: route.model,
+      ...route.reasoningEffort !== void 0 ? { reasoningEffort: route.reasoningEffort } : {},
       ...truncated ? { truncated: true } : {}
     }
   };
 }
 export {
+  LONG_LINE_MAX_CHARS,
+  compactLongLines,
   isCjkText,
   parseStyleHistory,
   resolveSuggestLanguage,

package/lib/host/types.d.ts

@@ -72,6 +72,9 @@ export interface GitRemote {
     /** Known-host classification, for the status-bar icon. */
     readonly hostKind: RemoteHostKind;
 }
+/** Why the change list is incomplete: capped at `maxChanges`, or the status
+ * stream itself was clipped (a lossy read drops the head). */
+export type TruncationReason = 'cap' | 'lossy';
 /** Immutable snapshot of one repository's status at `checkedAt`. */
 export interface GitSnapshot {
     /** Realpath of the repository root (work tree top). */
@@ -97,8 +100,14 @@ export interface GitSnapshot {
     readonly changes: readonly GitChange[];
     /** Working-tree statistics for the changes-page header (single source). */
     readonly stats: WorktreeStats;
-    /** True when the change list was capped at maxChanges. */
+    /** True when the change list is incomplete (capped or clipped). */
     readonly truncated: boolean;
+    /** Which limit produced `truncated`; absent on older hosts. */
+    readonly truncatedReason?: TruncationReason;
+    /** True when untracked files fell back to git's collapsed `?? dir/` entries
+     * because expanding them would overflow `maxChanges` (or the status stream).
+     * Older hosts never set it. */
+    readonly untrackedCollapsed?: boolean;
     /** Polling interval the client should use after this snapshot (0 = off). */
     readonly refreshIntervalMs: number;
     /** Whether the input-bar git marker pill should render (user preference). */
@@ -109,6 +118,9 @@ export interface GitSnapshot {
     readonly graphStyle: GraphStyle;
     /** Whether the commit box shows the AI-suggest button (user preference). */
     readonly suggestEnabled: boolean;
+    /** SHA-256 of the final business snapshot, excluding checkedAt and itself.
+     * Optional for compatibility with hosts that do not provide fingerprints. */
+    readonly stateFingerprint?: string;
     /** Epoch millis of the snapshot. */
     readonly checkedAt: number;
 }
@@ -119,9 +131,15 @@ export interface GitCommit {
     readonly author: string;
     readonly dateIso: string;
 }
-/** A commit with parent links and ref decorations (graph rendering). */
-export interface GraphCommit extends GitCommit {
+/** One node of the commit graph's raw ancestry: a full hash and its raw parent
+ * hashes. `parents` is empty for a true root — and equally for a shallow
+ * boundary, which git cannot tell apart from a root. */
+export interface GitGraphNode {
+    readonly hash: string;
     readonly parents: readonly string[];
+}
+/** A commit with parent links and ref decorations (graph rendering). */
+export interface GraphCommit extends GitCommit, GitGraphNode {
     readonly refs: readonly GitRef[];
 }
 export interface GitRef {
@@ -210,7 +228,7 @@ export type GitAction = {
 /** `git reset` modes, from least to most destructive. Single source so the
  * client dialog and the command builder cannot drift. */
 export type ResetMode = 'soft' | 'mixed' | 'hard';
-export type GitErrorCode = 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'invalid-index' | 'git-error' | 'timeout' | 'cancelled' | 'empty-message' | 'local-changes-block' | 'not-ff' | 'push-rejected' | 'auth-failed' | 'conflict' | 'revert-conflict' | 'revert-stuck' | 'revert-merge' | 'not-found' | 'branch-in-use' | 'stash-switch-failed' | 'index-busy' | 'empty-diff' | 'llm-unavailable' | 'llm-error' | 'llm-output' | 'suggest-disabled';
+export type GitErrorCode = 'cwd-unavailable' | 'not-a-git-repo' | 'git-unavailable' | 'invalid-path' | 'invalid-name' | 'invalid-index' | 'git-error' | 'timeout' | 'cancelled' | 'empty-message' | 'local-changes-block' | 'not-ff' | 'push-rejected' | 'auth-failed' | 'conflict' | 'revert-conflict' | 'revert-stuck' | 'revert-merge' | 'not-found' | 'file-not-found' | 'branch-in-use' | 'stash-switch-failed' | 'index-busy' | 'nested-repo' | 'nested-repo-partial' | 'empty-diff' | 'llm-unavailable' | 'llm-error' | 'llm-output' | 'suggest-disabled';
 export type GitActionResult = {
     readonly ok: true;
     readonly snapshot: GitSnapshot;
@@ -226,6 +244,16 @@ export interface GitActionRequest {
     readonly sessionId: string;
     readonly action: GitAction;
 }
+/**
+ * True when a history `search` is a commit-hash prefix jump rather than a
+ * message regex: 7–40 hex chars after trimming.
+ */
+export declare function isHistoryHashSearch(search: string): boolean;
+/** Whether Git's effective content filters hide commits; hash jumps ignore them.
+ * Shared with clients receiving history from a host that omits topology. */
+export declare function isHistoryFiltered(query: Pick<Extract<GitQuery, {
+    kind: 'history';
+}>, 'search' | 'author' | 'since'>): boolean;
 export type GitQuery = {
     readonly kind: 'history';
     readonly limit: number;
@@ -296,6 +324,8 @@ export type GitQuery = {
     readonly kind: 'pull-preview';
 } | {
     readonly kind: 'push-preview';
+} | {
+    readonly kind: 'model-catalog';
 };
 /** One entry in a `dir-list` result. */
 export interface DirEntry {
@@ -330,6 +360,33 @@ export interface StashEntry {
     /** Human relative time (e.g. "2 hours ago"). */
     readonly relTime: string;
 }
+/** Selectable reasoning effort for one exact model route (ids go straight
+ * into `GenerateOptions.reasoningEffort`). */
+export interface ModelCatalogEffort {
+    readonly id: string;
+    readonly name: string;
+}
+/** One model inside a provider group of the host-level catalog. */
+export interface ModelCatalogModel {
+    readonly id: string;
+    readonly name: string;
+    /** Adapter-advertised efforts; absent when the model exposes none. */
+    readonly reasoning?: {
+        readonly efforts: readonly ModelCatalogEffort[];
+    };
+}
+/** One provider and its successfully listed models. */
+export interface ModelCatalogGroup {
+    readonly id: string;
+    readonly name: string;
+    readonly models: readonly ModelCatalogModel[];
+}
+/** One provider / model whose catalog lookup failed in isolation. */
+export interface ModelCatalogFailure {
+    readonly id: string;
+    readonly name: string;
+    readonly message: string;
+}
 /** Working-tree statistics for the changes page header. */
 export interface WorktreeStats {
     /** Distinct changed-file paths (staged ∪ modified ∪ untracked). */
@@ -357,6 +414,11 @@ export type GitQueryResult = {
     readonly kind: 'history';
     readonly commits: readonly GraphCommit[];
     readonly total: number;
+    /** Raw ancestry for a filtered page: the page's commits plus the ancestors
+     * an effective search/author/since filter hid from the page itself. Absent
+     * when no effective filter is active (or on a hash jump); `[]` means the
+     * bounded auxiliary walk failed, so the graph is incomplete. */
+    readonly topology?: readonly GitGraphNode[];
 }
 /**
  * Unified diff text plus the new-side line count. The count is the fact the
@@ -459,6 +521,10 @@ export type GitQueryResult = {
     readonly files: number;
     readonly insertions: number;
     readonly deletions: number;
+} | {
+    readonly kind: 'model-catalog';
+    readonly groups: readonly ModelCatalogGroup[];
+    readonly failures: readonly ModelCatalogFailure[];
 } | {
     readonly kind: 'dir-list';
     readonly path: string;
@@ -472,6 +538,11 @@ export type GitQueryResult = {
     readonly content?: string;
     /** text variant: total line count. */
     readonly lines?: number;
+    /** text variant: absolute path of this file — the rendered-Markdown
+     * image resolver needs the document's own location to resolve relative
+     * destinations onto the authenticated `api/file` route. Absent on older
+     * hosts; the client then keeps the alt-text fallback. */
+    readonly absolutePath?: string;
     /** image variant: a `data:<mime>;base64,…` URL. */
     readonly dataUrl?: string;
     /** The file exceeded the byte cap, so no content is returned. */
@@ -481,6 +552,14 @@ export type GitQueryResult = {
     /** Modification time (epoch ms) from the same stat (all variants). */
     readonly mtimeMs?: number;
 };
+/**
+ * Byte envelope of the file browser's "copy file content" action: a text
+ * document is copyable strictly below this size. Shared by both halves —
+ * the host floors its text read here (so every copyable document can
+ * actually load) and the client hides the copy button at/above it, keeping
+ * one boundary for load and copy.
+ */
+export declare const FILE_COPY_MAX_BYTES: number;
 export type GitQueryResponse = {
     readonly ok: true;
     readonly value: GitQueryResult;
@@ -550,6 +629,8 @@ export type GitSuggestResult = {
         /** Actual provider/model route used (display only). */
         readonly provider?: string;
         readonly model?: string;
+        /** Effort actually sent; absent when the request omitted it. */
+        readonly reasoningEffort?: string;
         /** The diff reached the model truncated: over the input cap, or cut
          * by the per-command runner stdout cap before it. */
         readonly truncated?: boolean;

package/lib/host/types.js

@@ -2,8 +2,16 @@ const DIFF_CONTEXT_DEFAULT = 3;
 const DIFF_CONTEXT_MAX = 1e5;
 const DIFF_EXPAND_CONTEXT = 2e3;
 const DIFF_COUNT_READ_MAX = 8 * 1024 * 1024;
+function isHistoryHashSearch(search) {
+  return /^[0-9a-fA-F]{7,40}$/.test(search.trim());
+}
+function isHistoryFiltered(query) {
+  const search = query.search?.trim() ?? "";
+  return !isHistoryHashSearch(search) && (search !== "" || (query.author ?? "") !== "" || (query.since ?? "") !== "");
+}
+const FILE_COPY_MAX_BYTES = 10 * 1024 * 1024;
 const SUGGEST_LIMITS = {
-  maxBytes: { min: 16 * 1024, max: 512 * 1024, default: 128 * 1024 },
+  maxBytes: { min: 16 * 1024, max: 512 * 1024, default: 200 * 1024 },
   maxOutputTokens: { min: 256, max: 16384, default: 4096 },
   timeoutMs: { min: 5e3, max: 12e4, default: 15e3 }
 };
@@ -32,9 +40,12 @@ export {
   DIFF_CONTEXT_MAX,
   DIFF_COUNT_READ_MAX,
   DIFF_EXPAND_CONTEXT,
+  FILE_COPY_MAX_BYTES,
   IMAGE_MIME,
   SUGGEST_LANGUAGES,
   SUGGEST_LANGUAGE_DEFAULT,
   SUGGEST_LIMITS,
-  imageMimeFor
+  imageMimeFor,
+  isHistoryFiltered,
+  isHistoryHashSearch
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbzbing/dsh-git-panel",
-  "version": "1.6.2",
+  "version": "1.8.0",
   "description": "DeepSeek Harness (dsh) plugin: an IDE-style Git panel in the Web GUI — branch/history overview, uncommitted changes with commit & amend, diff stats, and a zsh-style branch marker in the input bar.",
   "type": "module",
   "license": "MIT",
@@ -31,6 +31,7 @@
   },
   "files": [
     "lib/client.js",
+    "lib/client.mermaid.js",
     "lib/host",
     "locale/*.json",
     "icon.svg",
@@ -41,11 +42,12 @@
   ],
   "scripts": {
     "build": "node build.mjs",
+    "lint": "eslint .",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test:unit": "node build.mjs && node --test --test-force-exit test/unit/*.test.mjs",
-    "test:e2e": "node build.mjs && node test/e2e/setup.mjs && node test/e2e/run.mjs && node test/e2e/run2.mjs && node test/e2e/run3.mjs && node test/e2e/run4.mjs && node test/e2e/run5.mjs",
+    "test:unit": "node build.mjs && node --test test/unit/*.test.mjs",
+    "test:e2e": "node build.mjs && node test/e2e/setup.mjs && node test/e2e/all.mjs",
     "test": "npm run test:unit && npm run test:e2e",
-    "check": "npm run typecheck && npm run test && git diff --exit-code -- lib/"
+    "check": "npm run lint && npm run typecheck && npm run test"
   },
   "dsh": {
     "bundle": {
@@ -63,7 +65,10 @@
     "compatibility": {
       "dsh": ">=0.1.7-rc.2",
       "dshReleases": {
-        "0.2.1-alpha.2": "compatible"
+        "0.1.7-rc.2": "compatible",
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-rc.1": "compatible",
+        "0.2.1-rc.2": "compatible"
       }
     }
   },
@@ -84,14 +89,23 @@
     "@deepseek-ai/dsh-typert-protocol": ">=0.1.2-rc.1",
     "@deepseek-ai/schemastery": ">=3.18.4"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "22.10.5",
     "@types/react": "18.3.18",
     "@types/react-dom": "18.3.5",
     "esbuild": "0.24.2",
+    "eslint": "9.39.5",
+    "eslint-plugin-react-hooks": "7.1.1",
+    "mermaid": "12.2.0",
     "playwright-core": "1.63.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "typescript": "5.7.3"
+    "typescript": "5.7.3",
+    "typescript-eslint": "8.71.2"
   }
 }