@anraktech/sync 0.4.0 → 0.6.0

package/dist/cli.js

@@ -4,8 +4,8 @@
 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 { resolve as resolve2 } from "path";
+import { existsSync as existsSync4, statSync as statSync3 } from "fs";
+import { resolve as resolve3 } from "path";
 import chalk3 from "chalk";
 
 // src/config.ts
@@ -86,7 +86,7 @@ function openBrowser(url) {
   exec(`${cmd} "${url}"`);
 }
 function findFreePort() {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const srv = createServer();
     srv.listen(0, () => {
       const addr = srv.address();
@@ -96,14 +96,14 @@ function findFreePort() {
         return;
       }
       const port = addr.port;
-      srv.close(() => resolve3(port));
+      srv.close(() => resolve4(port));
     });
   });
 }
 async function browserLogin(apiUrl) {
   const port = await findFreePort();
   return new Promise(
-    (resolve3, reject) => {
+    (resolve4, reject) => {
       let server;
       const timeout = setTimeout(() => {
         server?.close();
@@ -150,7 +150,7 @@ async function browserLogin(apiUrl) {
           const tokens = await resp.json();
           clearTimeout(timeout);
           server.close();
-          resolve3(tokens);
+          resolve4(tokens);
         } catch (err) {
           clearTimeout(timeout);
           server.close();
@@ -338,11 +338,11 @@ function persist() {
   if (cache) saveCache(cache);
 }
 function hashFile(filePath) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const hash = createHash("sha256");
     const stream = createReadStream(filePath);
     stream.on("data", (chunk) => hash.update(chunk));
-    stream.on("end", () => resolve3(hash.digest("hex")));
+    stream.on("end", () => resolve4(hash.digest("hex")));
     stream.on("error", reject);
   });
 }
@@ -416,8 +416,8 @@ function resetCache() {
 
 // src/watcher.ts
 import { watch } from "chokidar";
-import { readdirSync, statSync, existsSync as existsSync2 } from "fs";
-import { join as join2, relative as relative2, basename as basename4, resolve } from "path";
+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
 import { stat as stat2 } from "fs/promises";
@@ -619,19 +619,73 @@ function sleep(ms) {
 // src/agent.ts
 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";
+var FOLDER_SHORTCUTS = {
+  downloads: join2(HOME, "Downloads"),
+  download: join2(HOME, "Downloads"),
+  desktop: join2(HOME, "Desktop"),
+  documents: join2(HOME, "Documents"),
+  document: join2(HOME, "Documents"),
+  home: HOME,
+  "~": HOME
+};
+function normalizePath(folderPath) {
+  const trimmed = folderPath.trim();
+  if (trimmed.startsWith("~/") || trimmed === "~") {
+    return resolve(trimmed.replace(/^~/, HOME));
+  }
+  const lower = trimmed.toLowerCase();
+  if (FOLDER_SHORTCUTS[lower]) {
+    return FOLDER_SHORTCUTS[lower];
+  }
+  const withoutSlash = lower.replace(/^\//, "");
+  if (FOLDER_SHORTCUTS[withoutSlash]) {
+    return FOLDER_SHORTCUTS[withoutSlash];
+  }
+  if (trimmed.startsWith("/") || /^[A-Z]:\\/i.test(trimmed)) {
+    return resolve(trimmed);
+  }
+  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"]
@@ -684,21 +738,81 @@ function buildSystemPrompt(config) {
 
 Watch folder: ${config.watchFolder}
 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.
 - Do NOT use markdown. Plain text only.
-- When user mentions a folder like "downloads" or "desktop", expand to full path (macOS: /Users/<name>/Downloads, Windows: C:\\Users\\<name>\\Downloads).
+- IMPORTANT: When user mentions a folder like "downloads" or "desktop", ALWAYS use the full absolute path. Examples:
+  "downloads" or "my downloads" \u2192 ${join2(HOME, "Downloads")}
+  "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 folderPath = args.folderPath;
-      if (!folderPath) return JSON.stringify({ error: "Missing folderPath" });
+      const rawPath = args.folderPath;
+      if (!rawPath) return JSON.stringify({ error: "Missing folderPath" });
+      const folderPath = normalizePath(rawPath);
       try {
         await ctx.scanFolder(folderPath);
         const stats = getStats();
@@ -800,18 +914,9 @@ async function agentTurn(messages, ctx) {
   }
   let textContent = "";
   const toolCalls = /* @__PURE__ */ new Map();
-  let isFirstText = true;
   for await (const { delta } of parseSSE(response)) {
     if (delta.content) {
-      if (isFirstText) {
-        process.stdout.write("  ");
-        isFirstText = false;
-      }
-      const cleaned = delta.content.replace(/<\/?think>/g, "");
-      if (cleaned) {
-        process.stdout.write(cleaned);
-        textContent += cleaned;
-      }
+      textContent += delta.content;
     }
     if (delta.tool_calls) {
       for (const tc of delta.tool_calls) {
@@ -828,8 +933,10 @@ async function agentTurn(messages, ctx) {
       }
     }
   }
+  textContent = textContent.replace(/<think>[\s\S]*?<\/think>/g, "").trim();
   if (textContent) {
-    process.stdout.write("\n");
+    process.stdout.write(`  ${textContent}
+`);
   }
   if (toolCalls.size === 0) {
     return textContent;
@@ -918,16 +1025,16 @@ async function scanFolder(config) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
     for (const entry of entries) {
       if (isIgnoredFile(entry)) continue;
-      const fullPath = join2(dir, entry);
+      const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -959,12 +1066,12 @@ async function pushSync(config) {
   );
 }
 async function scanExternalFolder(config, folderPath, cases) {
-  const absPath = resolve(folderPath);
-  if (!existsSync2(absPath)) {
+  const absPath = resolve2(folderPath);
+  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;
   }
@@ -973,16 +1080,16 @@ async function scanExternalFolder(config, folderPath, cases) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
     for (const entry of entries) {
       if (isIgnoredFile(entry)) continue;
-      const fullPath = join2(dir, entry);
+      const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -990,7 +1097,7 @@ async function scanExternalFolder(config, folderPath, cases) {
         walk(fullPath);
       } else if (s.isFile() && isSupportedFile(entry)) {
         fileCount++;
-        void enqueue(fullPath, join2(absPath, ".."));
+        void enqueue(fullPath, join3(absPath, ".."));
       }
     }
   }
@@ -1107,10 +1214,10 @@ async function startWatching(config) {
 // src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname2, join as join3 } from "path";
+import { dirname as dirname2, join as join4 } from "path";
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname2(__filename2);
-var pkg = JSON.parse(readFileSync2(join3(__dirname2, "..", "package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync2(join4(__dirname2, "..", "package.json"), "utf-8"));
 var program = new Command();
 program.name("anrak-sync").description("AnrakLegal desktop file sync \u2014 watches local folders, syncs to case management").version(pkg.version);
 program.command("init").description("Set up AnrakLegal Sync (first-time configuration)").option("--password", "Use email/password login instead of browser").action(async (opts) => {
@@ -1151,13 +1258,13 @@ program.command("init").description("Set up AnrakLegal Sync (first-time configur
     const watchInput = await rl2.question(
       `  Watch folder ${chalk3.dim(`(${defaultFolder})`)}: `
     );
-    const watchFolder = resolve2(watchInput || defaultFolder);
+    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.4.0",
+  "version": "0.6.0",
   "description": "AnrakLegal desktop file sync agent — watches local folders and syncs to case management",
   "type": "module",
   "bin": {