@anraktech/sync 0.5.0 → 0.6.0

package/dist/cli.js

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 import { createInterface as createInterface2 } from "readline/promises";
 import { stdin as stdin2, stdout as stdout2 } from "process";
-import { existsSync as existsSync3, statSync as statSync2 } from "fs";
+import { existsSync as existsSync4, statSync as statSync3 } from "fs";
 import { resolve as resolve3 } from "path";
 import chalk3 from "chalk";
 
@@ -416,7 +416,7 @@ function resetCache() {
 
 // src/watcher.ts
 import { watch } from "chokidar";
-import { readdirSync, statSync, existsSync as existsSync2 } from "fs";
+import { readdirSync as readdirSync2, statSync as statSync2, existsSync as existsSync3 } from "fs";
 import { join as join3, relative as relative2, basename as basename4, resolve as resolve2 } from "path";
 
 // src/uploader.ts
@@ -621,6 +621,7 @@ import { createInterface } from "readline/promises";
 import { stdin, stdout } from "process";
 import { homedir as homedir2, platform } from "os";
 import { resolve, join as join2 } from "path";
+import { existsSync as existsSync2, readdirSync, statSync } from "fs";
 import chalk2 from "chalk";
 var HOME = homedir2();
 var IS_MAC = platform() === "darwin";
@@ -652,17 +653,39 @@ function normalizePath(folderPath) {
   return resolve(HOME, trimmed);
 }
 var TOOLS = [
+  {
+    type: "function",
+    function: {
+      name: "browse_folder",
+      description: "List files and subfolders in a local directory. Shows file names, sizes, types, and whether they are syncable. Use FIRST when user wants to see what's in a folder before syncing.",
+      parameters: {
+        type: "object",
+        properties: {
+          folderPath: {
+            type: "string",
+            description: "Absolute path to the folder to browse"
+          },
+          filter: {
+            type: "string",
+            enum: ["all", "syncable", "folders"],
+            description: "Filter: 'all' shows everything, 'syncable' shows only supported file types (PDF, DOCX, etc.), 'folders' shows only subfolders. Default: all"
+          }
+        },
+        required: ["folderPath"]
+      }
+    }
+  },
   {
     type: "function",
     function: {
       name: "scan_folder",
-      description: "Scan a local folder on the user's computer and sync all supported files (PDF, DOCX, etc.) to a matching legal case. Use when user asks to scan, sync, upload, or look at a specific folder.",
+      description: "Sync all supported files from a local folder to a matching legal case. Use when user explicitly asks to sync, upload, or push files. If unsure what's in the folder, use browse_folder first.",
       parameters: {
         type: "object",
         properties: {
           folderPath: {
             type: "string",
-            description: "Absolute path to the folder, e.g. /Users/name/Downloads"
+            description: "Absolute path to the folder to sync"
           }
         },
         required: ["folderPath"]
@@ -718,7 +741,7 @@ Server: ${config.apiUrl}
 Home directory: ${HOME}
 Platform: ${IS_MAC ? "macOS" : platform()}
 
-You can scan folders, list cases, show sync status, and more using your tools.
+You can browse local folders, scan & sync files, list cases, show sync status, and more.
 
 Rules:
 - Be concise. This is a terminal \u2014 1-3 lines unless showing a list.
@@ -728,12 +751,64 @@ Rules:
   "desktop" \u2192 ${join2(HOME, "Desktop")}
   "documents" \u2192 ${join2(HOME, "Documents")}
   "~/SomeFolder" \u2192 ${HOME}/SomeFolder
+- When user says "look at" or "check" a folder, use browse_folder FIRST to show what's there.
+- When user says "sync" or "upload", use scan_folder to actually sync.
+- When browsing, highlight which files are syncable (PDF, DOCX, XLSX, etc.) vs not.
+- Present file lists in a clean table/list format with names and sizes.
 - Call tools to perform actions. Summarize results naturally after.
 - If a tool returns an error, report it clearly to the user.
 - Do NOT use thinking tags or reasoning tags in your output.`;
 }
 async function executeTool(name, args, ctx) {
   switch (name) {
+    case "browse_folder": {
+      const rawPath = args.folderPath;
+      if (!rawPath) return JSON.stringify({ error: "Missing folderPath" });
+      const folderPath = normalizePath(rawPath);
+      if (!existsSync2(folderPath)) {
+        return JSON.stringify({ error: `Folder not found: ${folderPath}` });
+      }
+      try {
+        const s = statSync(folderPath);
+        if (!s.isDirectory()) {
+          return JSON.stringify({ error: `Not a directory: ${folderPath}` });
+        }
+      } catch {
+        return JSON.stringify({ error: `Cannot access: ${folderPath}` });
+      }
+      const filter = args.filter || "all";
+      const entries = readdirSync(folderPath);
+      const items = [];
+      for (const entry of entries) {
+        if (isIgnoredFile(entry)) continue;
+        const fullPath = join2(folderPath, entry);
+        let st;
+        try {
+          st = statSync(fullPath);
+        } catch {
+          continue;
+        }
+        if (st.isDirectory()) {
+          if (filter !== "syncable") {
+            items.push({ name: entry, type: "folder" });
+          }
+        } else if (st.isFile()) {
+          if (filter === "folders") continue;
+          const syncable = isSupportedFile(entry);
+          if (filter === "syncable" && !syncable) continue;
+          const sizeKB = Math.round(st.size / 1024);
+          const size = sizeKB > 1024 ? `${(sizeKB / 1024).toFixed(1)} MB` : `${sizeKB} KB`;
+          items.push({ name: entry, type: "file", size, syncable });
+        }
+      }
+      return JSON.stringify({
+        folder: folderPath,
+        totalItems: items.length,
+        items: items.slice(0, 50),
+        // Cap at 50 to avoid token explosion
+        truncated: items.length > 50
+      });
+    }
     case "scan_folder": {
       const rawPath = args.folderPath;
       if (!rawPath) return JSON.stringify({ error: "Missing folderPath" });
@@ -950,7 +1025,7 @@ async function scanFolder(config) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
@@ -959,7 +1034,7 @@ async function scanFolder(config) {
       const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -992,11 +1067,11 @@ async function pushSync(config) {
 }
 async function scanExternalFolder(config, folderPath, cases) {
   const absPath = resolve2(folderPath);
-  if (!existsSync2(absPath)) {
+  if (!existsSync3(absPath)) {
     log.error(`Folder not found: ${absPath}`);
     return;
   }
-  if (!statSync(absPath).isDirectory()) {
+  if (!statSync2(absPath).isDirectory()) {
     log.error(`Not a directory: ${absPath}`);
     return;
   }
@@ -1005,7 +1080,7 @@ async function scanExternalFolder(config, folderPath, cases) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
@@ -1014,7 +1089,7 @@ async function scanExternalFolder(config, folderPath, cases) {
       const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -1185,11 +1260,11 @@ program.command("init").description("Set up AnrakLegal Sync (first-time configur
     );
     const watchFolder = resolve3(watchInput || defaultFolder);
     rl2.close();
-    if (!existsSync3(watchFolder)) {
+    if (!existsSync4(watchFolder)) {
       log.warn(
         `Folder ${watchFolder} does not exist \u2014 it will be created when you add files`
       );
-    } else if (!statSync2(watchFolder).isDirectory()) {
+    } else if (!statSync3(watchFolder).isDirectory()) {
       log.error(`${watchFolder} is not a directory`);
       process.exit(1);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anraktech/sync",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AnrakLegal desktop file sync agent — watches local folders and syncs to case management",
   "type": "module",
   "bin": {