@getpaseo/server 0.1.97 → 0.1.98

package/dist/server/utils/directory-suggestions.js

@@ -24,6 +24,15 @@ const IGNORED_SUGGESTION_DIRECTORY_NAMES = new Set([
     "coverage",
     "vendor",
     "__pycache__",
+    ".git",
+]);
+const TRAVERSABLE_HIDDEN_WORKSPACE_DIRECTORY_NAMES = new Set([
+    ".agents",
+    ".claude",
+    ".codex",
+    ".github",
+    ".paseo",
+    ".vscode",
 ]);
 export async function searchHomeDirectories(options) {
     const query = options.query.trim();
@@ -71,6 +80,17 @@ export async function searchWorkspaceEntries(options) {
         return [];
     }
     const matchMode = options.matchMode ?? "fuzzy";
+    const exactEntry = queryParts.isPathQuery && matchMode === "suffix"
+        ? await resolveWorkspaceExactEntry({
+            workspaceRoot,
+            query: options.query,
+            includeDirectories,
+            includeFiles,
+        })
+        : null;
+    if (exactEntry && limit <= 1) {
+        return [exactEntry];
+    }
     if (queryParts.isPathQuery && matchMode !== "suffix") {
         return searchWorkspaceWithinParentDirectory({
             workspaceRoot,
@@ -84,7 +104,7 @@ export async function searchWorkspaceEntries(options) {
     const searchTerm = matchMode === "suffix"
         ? [queryParts.parentPart, queryParts.searchTerm].filter(Boolean).join("/")
         : queryParts.searchTerm;
-    return searchWorkspaceAcrossTree({
+    const entries = await searchWorkspaceAcrossTree({
         workspaceRoot,
         searchTerm,
         limit,
@@ -94,6 +114,53 @@ export async function searchWorkspaceEntries(options) {
         maxDepth: options.maxDepth ?? DEFAULT_MAX_DEPTH,
         maxEntriesScanned: options.maxEntriesScanned ?? DEFAULT_MAX_DIRECTORIES_SCANNED,
     });
+    return exactEntry ? prependWorkspaceEntry(exactEntry, entries).slice(0, limit) : entries;
+}
+async function resolveWorkspaceExactEntry(input) {
+    const normalized = input.query
+        .trim()
+        .replace(/\\/g, "/")
+        .replace(/^\.\/+/, "")
+        .replace(/\/{2,}/g, "/");
+    if (!normalized) {
+        return null;
+    }
+    const candidatePath = path.isAbsolute(normalized)
+        ? path.resolve(normalized)
+        : path.resolve(input.workspaceRoot, normalized);
+    let resolvedPath;
+    try {
+        resolvedPath = await realpath(candidatePath);
+    }
+    catch {
+        return null;
+    }
+    if (!isPathInsideRoot(input.workspaceRoot, resolvedPath)) {
+        return null;
+    }
+    const stats = await stat(resolvedPath).catch(() => null);
+    if (!stats) {
+        return null;
+    }
+    if (stats.isFile() && input.includeFiles) {
+        return {
+            path: normalizeRelativePath(input.workspaceRoot, resolvedPath),
+            kind: "file",
+        };
+    }
+    if (stats.isDirectory() && input.includeDirectories) {
+        return {
+            path: normalizeRelativePath(input.workspaceRoot, resolvedPath),
+            kind: "directory",
+        };
+    }
+    return null;
+}
+function prependWorkspaceEntry(entry, entries) {
+    return [
+        entry,
+        ...entries.filter((candidate) => candidate.kind !== entry.kind || candidate.path !== entry.path),
+    ];
 }
 function normalizeLimit(limit) {
     const candidate = limit ?? DEFAULT_LIMIT;
@@ -185,6 +252,9 @@ async function searchWorkspaceWithinParentDirectory(input) {
         if (entry.kind === "file" && !input.includeFiles) {
             continue;
         }
+        if (isHiddenWorkspaceSuggestion(entry)) {
+            continue;
+        }
         const rankedEntry = rankWorkspaceEntry({
             absolutePath: entry.absolutePath,
             kind: entry.kind,
@@ -230,6 +300,10 @@ async function searchWorkspaceAcrossTree(input) {
             if (entry.kind === "directory" && !input.includeDirectories) {
                 continue;
             }
+            // Hidden directories are traversed, but not offered as suggestions.
+            if (isHiddenWorkspaceSuggestion(entry)) {
+                continue;
+            }
             if (entry.kind === "file" && !input.includeFiles) {
                 continue;
             }
@@ -618,7 +692,23 @@ async function listWorkspaceChildEntries(input) {
         return cached.entries;
     }
     const dirents = await readdir(input.directory, { withFileTypes: true }).catch(() => []);
-    const candidates = dirents.filter((dirent) => !isHiddenDirectoryName(dirent.name) && !isIgnoredSuggestionDirectoryName(dirent.name));
+    const candidates = dirents.filter((dirent) => {
+        if (isIgnoredSuggestionDirectoryName(dirent.name)) {
+            return false;
+        }
+        if (isHiddenDirectoryName(dirent.name) &&
+            !dirent.isFile() &&
+            !isTraversableHiddenWorkspaceDirectoryName(dirent.name)) {
+            return false;
+        }
+        // Allowlisted hidden directories remain traversable so file links like
+        // `.claude/settings.local.json` can resolve, but hidden files (e.g.
+        // `.DS_Store`) should never be suggested.
+        if (dirent.isFile() && isHiddenDirectoryName(dirent.name)) {
+            return false;
+        }
+        return true;
+    });
     const resolved = await Promise.all(candidates.map(async (dirent) => {
         const candidatePath = path.join(input.directory, dirent.name);
         const entry = await resolveWorkspaceCandidate({
@@ -687,9 +777,15 @@ async function resolveWorkspaceCandidate(input) {
 function isHiddenDirectoryName(name) {
     return name.startsWith(".");
 }
+function isHiddenWorkspaceSuggestion(entry) {
+    return isHiddenDirectoryName(entry.name);
+}
 function isIgnoredSuggestionDirectoryName(name) {
     return IGNORED_SUGGESTION_DIRECTORY_NAMES.has(name);
 }
+function isTraversableHiddenWorkspaceDirectoryName(name) {
+    return TRAVERSABLE_HIDDEN_WORKSPACE_DIRECTORY_NAMES.has(name);
+}
 function setDirectoryListCache(cacheKey, entry) {
     directoryListCache.set(cacheKey, entry);
     pruneDirectoryListCache();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/server",
-  "version": "0.1.97",
+  "version": "0.1.98",
   "description": "Paseo backend server",
   "files": [
     "dist/server",
@@ -65,10 +65,10 @@
     "@agentclientprotocol/sdk": "^0.17.1",
     "@anthropic-ai/claude-agent-sdk": "^0.3.181",
     "@anthropic-ai/sdk": "^0.104.2",
-    "@getpaseo/client": "0.1.97",
-    "@getpaseo/highlight": "0.1.97",
-    "@getpaseo/protocol": "0.1.97",
-    "@getpaseo/relay": "0.1.97",
+    "@getpaseo/client": "0.1.98",
+    "@getpaseo/highlight": "0.1.98",
+    "@getpaseo/protocol": "0.1.98",
+    "@getpaseo/relay": "0.1.98",
     "@isaacs/ttlcache": "^2.1.4",
     "@modelcontextprotocol/sdk": "^1.20.1",
     "@opencode-ai/sdk": "1.14.46",