simen-keyboard-listener 1.1.9 → 1.1.10

package/dist/index.mjs

@@ -11,7 +11,1344 @@ import * as fs from "fs";
 import { execFileSync } from "child_process";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
+
+// src/osascript/executor.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
 var IS_MACOS = process.platform === "darwin";
+var OSASCRIPT_PATH = "/usr/bin/osascript";
+var DEFAULT_TIMEOUT = 3e4;
+function isOsascriptAvailable() {
+  return IS_MACOS;
+}
+async function executeAppleScript(script, options) {
+  if (!IS_MACOS) {
+    return {
+      success: false,
+      error: "osascript is only available on macOS"
+    };
+  }
+  const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+  const startTime = Date.now();
+  try {
+    const { stdout, stderr } = await execFileAsync(
+      OSASCRIPT_PATH,
+      ["-e", script],
+      { timeout }
+    );
+    const executionTime = Date.now() - startTime;
+    if (stderr && stderr.trim()) {
+      return {
+        success: false,
+        error: stderr.trim(),
+        executionTime
+      };
+    }
+    return {
+      success: true,
+      data: stdout.trim(),
+      executionTime
+    };
+  } catch (error) {
+    const executionTime = Date.now() - startTime;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      error: errorMessage,
+      executionTime
+    };
+  }
+}
+async function executeAppleScriptLines(lines, options) {
+  if (!IS_MACOS) {
+    return {
+      success: false,
+      error: "osascript is only available on macOS"
+    };
+  }
+  const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+  const startTime = Date.now();
+  const args = lines.flatMap((line) => ["-e", line]);
+  try {
+    const { stdout, stderr } = await execFileAsync(
+      OSASCRIPT_PATH,
+      args,
+      { timeout }
+    );
+    const executionTime = Date.now() - startTime;
+    if (stderr && stderr.trim()) {
+      return {
+        success: false,
+        error: stderr.trim(),
+        executionTime
+      };
+    }
+    return {
+      success: true,
+      data: stdout.trim(),
+      executionTime
+    };
+  } catch (error) {
+    const executionTime = Date.now() - startTime;
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      error: errorMessage,
+      executionTime
+    };
+  }
+}
+async function executeAndParse(script, parser, options) {
+  const result = await executeAppleScript(script, options);
+  if (!result.success) {
+    return {
+      success: false,
+      error: result.error,
+      executionTime: result.executionTime
+    };
+  }
+  try {
+    const parsed = parser(result.data ?? "");
+    return {
+      success: true,
+      data: parsed,
+      executionTime: result.executionTime
+    };
+  } catch (parseError) {
+    const errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+    return {
+      success: false,
+      error: `Failed to parse output: ${errorMessage}`,
+      executionTime: result.executionTime
+    };
+  }
+}
+async function executeMultilineAndParse(lines, parser, options) {
+  const result = await executeAppleScriptLines(lines, options);
+  if (!result.success) {
+    return {
+      success: false,
+      error: result.error,
+      executionTime: result.executionTime
+    };
+  }
+  try {
+    const parsed = parser(result.data ?? "");
+    return {
+      success: true,
+      data: parsed,
+      executionTime: result.executionTime
+    };
+  } catch (parseError) {
+    const errorMessage = parseError instanceof Error ? parseError.message : String(parseError);
+    return {
+      success: false,
+      error: `Failed to parse output: ${errorMessage}`,
+      executionTime: result.executionTime
+    };
+  }
+}
+function escapeForAppleScript(str) {
+  return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+// src/osascript/scripts/batchContext.ts
+var SEC = "\xA7\xA7\xA7";
+var FLD = "|||";
+var ITM = ":::";
+var SCRIPT_BASIC = `
+set d to "${FLD}"
+set s to "${SEC}"
+set i to "${ITM}"
+
+tell application "System Events"
+	set fp to first application process whose frontmost is true
+	set appName to displayed name of fp
+	set sec0 to appName & d & bundle identifier of fp & d
+	try
+		set sec0 to sec0 & POSIX path of (file of fp as alias)
+	end try
+	set finderRunning to (exists process "Finder")
+end tell
+
+set sec1 to ""
+set sec2 to ""
+set sec3 to ""
+set sec4 to do shell script "echo $HOME/Desktop/"
+
+if not finderRunning then
+	-- Skip Finder operations if not running
+else
+	-- Get Finder selection (must be in separate tell block to avoid scope issues)
+	try
+		tell application "Finder"
+			set sel to selection
+			set sc to count of sel
+			if sc > 0 then
+				set L to {}
+				repeat with j from 1 to sc
+					if j > 50 then exit repeat
+					set f to item j of sel
+					set t to "0"
+					if class of f as string contains "folder" then set t to "1"
+					set end of L to name of f & d & POSIX path of (f as alias) & d & t
+				end repeat
+				set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+				set sec1 to L as string
+				set AppleScript's text item delimiters to tid
+			end if
+		end tell
+	end try
+	
+	-- Get Finder windows (including special views like Recents)
+	try
+		tell application "Finder"
+			set wc to count of Finder windows
+			if wc > 0 then
+				-- Try to get current folder path (may fail for special views)
+				try
+					set sec2 to POSIX path of (target of front Finder window as alias)
+				on error
+					-- Special view (Recents, Search, etc.) - use window name as identifier
+					set sec2 to "special:" & (name of front Finder window)
+				end try
+				set L to {}
+				repeat with idx from 1 to wc
+					set w to Finder window idx
+					set wName to name of w
+					set wPath to ""
+					try
+						set wPath to POSIX path of (target of w as alias)
+					on error
+						-- Special view - mark with special: prefix
+						set wPath to "special:" & wName
+					end try
+					set end of L to wName & d & wPath & d & (idx as string)
+				end repeat
+				set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+				set sec3 to L as string
+				set AppleScript's text item delimiters to tid
+			end if
+		end tell
+	end try
+end if
+
+set sec5 to ""
+try
+	set c to the clipboard as text
+	if (length of c) > 2000 then set c to text 1 thru 2000 of c
+	set sec5 to c
+end try
+
+set sec6 to ""
+try
+	set cf to the clipboard as alias list
+	set L to {}
+	repeat with f in cf
+		set end of L to POSIX path of f
+	end repeat
+	set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+	set sec6 to L as string
+	set AppleScript's text item delimiters to tid
+end try
+
+set sec7 to "0"
+try
+	set imgData to the clipboard as \xABclass PNGf\xBB
+	set sec7 to "1"
+on error
+	try
+		set imgData to the clipboard as TIFF picture
+		set sec7 to "1"
+	end try
+end try
+
+return sec0 & s & sec1 & s & sec2 & s & sec3 & s & sec4 & s & sec5 & s & sec6 & s & sec7
+`;
+var SCRIPT_WITH_METADATA = `
+set d to "${FLD}"
+set s to "${SEC}"
+set i to "${ITM}"
+
+tell application "System Events"
+	set fp to first application process whose frontmost is true
+	set appName to displayed name of fp
+	set sec0 to appName & d & bundle identifier of fp & d
+	try
+		set sec0 to sec0 & POSIX path of (file of fp as alias)
+	end try
+	set finderRunning to (exists process "Finder")
+end tell
+
+set sec1 to ""
+set sec2 to ""
+set sec3 to ""
+set sec4 to do shell script "echo $HOME/Desktop/"
+
+if not finderRunning then
+	-- Skip Finder operations if not running
+else
+	-- Get Finder selection with metadata (must be in separate tell block)
+	try
+		tell application "Finder"
+			set sel to selection
+			set sc to count of sel
+			if sc > 0 then
+				set L to {}
+				repeat with j from 1 to sc
+					if j > 50 then exit repeat
+					set f to item j of sel
+					set t to "0"
+					if class of f as string contains "folder" then set t to "1"
+					set fSize to "0"
+					set fMod to ""
+					try
+						set fSize to size of f as string
+					end try
+					try
+						set fMod to (modification date of f) as string
+					end try
+					set end of L to name of f & d & POSIX path of (f as alias) & d & t & d & fSize & d & fMod
+				end repeat
+				set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+				set sec1 to L as string
+				set AppleScript's text item delimiters to tid
+			end if
+		end tell
+	end try
+	
+	-- Get Finder windows (including special views like Recents)
+	try
+		tell application "Finder"
+			set wc to count of Finder windows
+			if wc > 0 then
+				-- Try to get current folder path (may fail for special views)
+				try
+					set sec2 to POSIX path of (target of front Finder window as alias)
+				on error
+					-- Special view (Recents, Search, etc.) - use window name as identifier
+					set sec2 to "special:" & (name of front Finder window)
+				end try
+				set L to {}
+				repeat with idx from 1 to wc
+					set w to Finder window idx
+					set wName to name of w
+					set wPath to ""
+					try
+						set wPath to POSIX path of (target of w as alias)
+					on error
+						-- Special view - mark with special: prefix
+						set wPath to "special:" & wName
+					end try
+					set end of L to wName & d & wPath & d & (idx as string)
+				end repeat
+				set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+				set sec3 to L as string
+				set AppleScript's text item delimiters to tid
+			end if
+		end tell
+	end try
+end if
+
+set sec5 to ""
+try
+	set c to the clipboard as text
+	if (length of c) > 2000 then set c to text 1 thru 2000 of c
+	set sec5 to c
+end try
+
+set sec6 to ""
+try
+	set cf to the clipboard as alias list
+	set L to {}
+	repeat with f in cf
+		set end of L to POSIX path of f
+	end repeat
+	set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+	set sec6 to L as string
+	set AppleScript's text item delimiters to tid
+end try
+
+set sec7 to "0"
+try
+	set imgData to the clipboard as \xABclass PNGf\xBB
+	set sec7 to "1"
+on error
+	try
+		set imgData to the clipboard as TIFF picture
+		set sec7 to "1"
+	end try
+end try
+
+return sec0 & s & sec1 & s & sec2 & s & sec3 & s & sec4 & s & sec5 & s & sec6 & s & sec7
+`;
+function parseBasic(out) {
+  const s = out.split(SEC);
+  const app = (s[0] ?? "").split(FLD);
+  const items = [];
+  const paths = [];
+  if (s[1]?.trim()) {
+    for (const item of s[1].split(ITM)) {
+      const p = item.split(FLD);
+      if (p.length >= 3) {
+        items.push({ name: p[0], path: p[1], isFolder: p[2] === "1" });
+        paths.push(p[1]);
+      }
+    }
+  }
+  const windows = [];
+  if (s[3]?.trim()) {
+    for (const win of s[3].split(ITM)) {
+      const p = win.split(FLD);
+      if (p.length >= 3) {
+        const isSpecial = p[1].startsWith("special:");
+        windows.push({
+          name: p[0],
+          path: isSpecial ? null : p[1],
+          index: parseInt(p[2], 10) || 0,
+          isSpecialView: isSpecial
+        });
+      }
+    }
+  }
+  const currentFolder = s[2]?.trim() || null;
+  const finderCurrentFolder = currentFolder?.startsWith("special:") ? null : currentFolder;
+  const clipPaths = s[6]?.trim() ? s[6].split(ITM).filter((p) => p.trim()) : [];
+  const hasImage = s[7]?.trim() === "1";
+  return {
+    frontmostApp: {
+      name: app[0] ?? "",
+      bundleId: app[1] ?? "",
+      isFinder: app[1] === "com.apple.finder",
+      path: app[2] ?? ""
+    },
+    finderSelection: { count: items.length, items, paths },
+    finderCurrentFolder,
+    finderWindows: windows,
+    desktopPath: s[4]?.trim() || "",
+    clipboard: {
+      text: s[5]?.trim() || null,
+      hasFiles: clipPaths.length > 0,
+      filePaths: clipPaths,
+      hasImage
+    },
+    timestamp: Date.now()
+  };
+}
+function parseWithMetadata(out) {
+  const s = out.split(SEC);
+  const app = (s[0] ?? "").split(FLD);
+  const items = [];
+  const paths = [];
+  if (s[1]?.trim()) {
+    for (const item of s[1].split(ITM)) {
+      const p = item.split(FLD);
+      if (p.length >= 3) {
+        const selectedItem = {
+          name: p[0],
+          path: p[1],
+          isFolder: p[2] === "1"
+        };
+        if (p.length >= 4 && p[3]) {
+          selectedItem.size = parseInt(p[3], 10) || 0;
+        }
+        if (p.length >= 5 && p[4]) {
+          selectedItem.modifiedAt = p[4];
+        }
+        items.push(selectedItem);
+        paths.push(p[1]);
+      }
+    }
+  }
+  const windows = [];
+  if (s[3]?.trim()) {
+    for (const win of s[3].split(ITM)) {
+      const p = win.split(FLD);
+      if (p.length >= 3) {
+        const isSpecial = p[1].startsWith("special:");
+        windows.push({
+          name: p[0],
+          path: isSpecial ? null : p[1],
+          index: parseInt(p[2], 10) || 0,
+          isSpecialView: isSpecial
+        });
+      }
+    }
+  }
+  const currentFolder = s[2]?.trim() || null;
+  const finderCurrentFolder = currentFolder?.startsWith("special:") ? null : currentFolder;
+  const clipPaths = s[6]?.trim() ? s[6].split(ITM).filter((p) => p.trim()) : [];
+  const hasImage = s[7]?.trim() === "1";
+  return {
+    frontmostApp: {
+      name: app[0] ?? "",
+      bundleId: app[1] ?? "",
+      isFinder: app[1] === "com.apple.finder",
+      path: app[2] ?? ""
+    },
+    finderSelection: { count: items.length, items, paths },
+    finderCurrentFolder,
+    finderWindows: windows,
+    desktopPath: s[4]?.trim() || "",
+    clipboard: {
+      text: s[5]?.trim() || null,
+      hasFiles: clipPaths.length > 0,
+      filePaths: clipPaths,
+      hasImage
+    },
+    timestamp: Date.now()
+  };
+}
+async function getAgentContext(opts) {
+  if (!isOsascriptAvailable()) return null;
+  const script = opts?.includeMetadata ? SCRIPT_WITH_METADATA : SCRIPT_BASIC;
+  const parser = opts?.includeMetadata ? parseWithMetadata : parseBasic;
+  const r = await executeAndParse(script, parser, opts);
+  return r.success ? r.data ?? null : null;
+}
+
+// src/osascript/scripts/finderContext.ts
+var SEC2 = "\xA7\xA7\xA7";
+var FLD2 = "|||";
+var ITM2 = ":::";
+var SCRIPT = `
+set d to "${FLD2}"
+set s to "${SEC2}"
+set i to "${ITM2}"
+
+-- Check if Finder is frontmost
+set isFinderFront to "0"
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+	if finderRunning then
+		try
+			set frontApp to bundle identifier of (first application process whose frontmost is true)
+			if frontApp is "com.apple.finder" then
+				set isFinderFront to "1"
+			end if
+		end try
+	end if
+end tell
+
+set sec0 to isFinderFront
+set sec1 to ""
+set sec2 to ""
+
+if not finderRunning then
+	return sec0 & s & sec1 & s & sec2
+end if
+
+tell application "Finder"
+	-- Get all Finder windows
+	set wc to count of Finder windows
+	if wc > 0 then
+		set L to {}
+		repeat with idx from 1 to wc
+			set w to Finder window idx
+			set wName to name of w
+			set wPath to ""
+			try
+				set wPath to POSIX path of (target of w as alias)
+			on error
+				-- Special view (Recents, AirDrop, Search, Tags, etc.)
+				set wPath to "special:" & wName
+			end try
+			set end of L to wName & d & wPath & d & (idx as string)
+		end repeat
+		set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+		set sec1 to L as string
+		set AppleScript's text item delimiters to tid
+	end if
+	
+	-- Get selection only if Finder is frontmost
+	if isFinderFront is "1" then
+		set sel to selection
+		set sc to count of sel
+		if sc > 0 then
+			set L to {}
+			repeat with j from 1 to sc
+				if j > 100 then exit repeat
+				set f to item j of sel
+				try
+					set end of L to POSIX path of (f as alias)
+				end try
+			end repeat
+			set {tid, AppleScript's text item delimiters} to {AppleScript's text item delimiters, i}
+			set sec2 to L as string
+			set AppleScript's text item delimiters to tid
+		end if
+	end if
+end tell
+
+return sec0 & s & sec1 & s & sec2
+`;
+function parseOutput(out) {
+  const sections = out.split(SEC2);
+  const isFinderFrontmost = sections[0]?.trim() === "1";
+  const windows = [];
+  if (sections[1]?.trim()) {
+    for (const win of sections[1].split(ITM2)) {
+      const parts = win.split(FLD2);
+      if (parts.length >= 3) {
+        const rawPath = parts[1] ?? "";
+        const isSpecial = rawPath.startsWith("special:");
+        windows.push({
+          name: parts[0] ?? "",
+          path: isSpecial ? null : rawPath,
+          index: parseInt(parts[2] ?? "0", 10),
+          isSpecialView: isSpecial
+        });
+      }
+    }
+  }
+  const selectedPaths = [];
+  if (sections[2]?.trim()) {
+    for (const p of sections[2].split(ITM2)) {
+      if (p.trim()) {
+        selectedPaths.push(p);
+      }
+    }
+  }
+  let frontWindow = null;
+  if (isFinderFrontmost && windows.length > 0) {
+    const first = windows[0];
+    frontWindow = {
+      name: first.name,
+      path: first.path,
+      isSpecialView: first.isSpecialView
+    };
+  }
+  return {
+    windows,
+    frontWindow,
+    selectedPaths,
+    isFinderFrontmost,
+    windowCount: windows.length
+  };
+}
+async function getFinderContext(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT, parseOutput, options);
+  return result.success ? result.data ?? null : null;
+}
+
+// src/osascript/scripts/frontmostApp.ts
+var DELIMITER = "|||";
+var SCRIPT2 = `
+tell application "System Events"
+	set frontApp to first application process whose frontmost is true
+	set appName to displayed name of frontApp
+	set appId to bundle identifier of frontApp
+	try
+		set appPath to POSIX path of (file of frontApp as alias)
+	on error
+		set appPath to ""
+	end try
+	return appName & "${DELIMITER}" & appId & "${DELIMITER}" & appPath
+end tell
+`;
+function parseOutput2(output) {
+  const parts = output.split(DELIMITER);
+  const name = parts[0] ?? "";
+  const bundleId = parts[1] ?? "";
+  const path2 = parts[2] ?? "";
+  return {
+    name,
+    bundleId,
+    isFinder: bundleId === "com.apple.finder",
+    path: path2
+  };
+}
+async function getFrontmostApp(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT2, parseOutput2, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+
+// src/osascript/scripts/finderSelection.ts
+var FIELD_DELIMITER = "|||";
+var ITEM_DELIMITER = ":::";
+var SCRIPT3 = `
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+end tell
+
+if finderRunning is false then
+	return ""
+end if
+
+tell application "Finder"
+	set sel to selection
+	if (count of sel) = 0 then
+		return ""
+	end if
+	set output to ""
+	repeat with f in sel
+		set p to POSIX path of (f as alias)
+		set n to name of f
+		set k to class of f as string
+		if output is not "" then
+			set output to output & "${ITEM_DELIMITER}"
+		end if
+		set output to output & p & "${FIELD_DELIMITER}" & n & "${FIELD_DELIMITER}" & k
+	end repeat
+	return output
+end tell
+`;
+function parseOutput3(output) {
+  if (!output || output.trim() === "") {
+    return {
+      paths: [],
+      count: 0,
+      items: []
+    };
+  }
+  const itemStrings = output.split(ITEM_DELIMITER);
+  const items = [];
+  const paths = [];
+  for (const itemStr of itemStrings) {
+    const parts = itemStr.split(FIELD_DELIMITER);
+    if (parts.length >= 2) {
+      const path2 = parts[0] ?? "";
+      const name = parts[1] ?? "";
+      const classType = parts[2] ?? "";
+      const isFolder = classType.toLowerCase().includes("folder");
+      paths.push(path2);
+      items.push({
+        name,
+        path: path2,
+        isFolder
+      });
+    }
+  }
+  return {
+    paths,
+    count: items.length,
+    items
+  };
+}
+async function getFinderSelection(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT3, parseOutput3, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+var CURRENT_FOLDER_SCRIPT = `
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+end tell
+
+if finderRunning is false then
+	return ""
+end if
+
+tell application "Finder"
+	try
+		set frontWindow to front Finder window
+		set folderPath to POSIX path of (target of frontWindow as alias)
+		return folderPath
+	on error
+		return ""
+	end try
+end tell
+`;
+async function getFinderCurrentFolder(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(
+    CURRENT_FOLDER_SCRIPT,
+    (output) => output.trim() || null,
+    options
+  );
+  if (result.success) {
+    return result.data ?? null;
+  }
+  return null;
+}
+
+// src/osascript/scripts/finderWindows.ts
+var FIELD_DELIMITER2 = "|||";
+var ITEM_DELIMITER2 = ":::";
+var SCRIPT4 = `
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+end tell
+
+if finderRunning is false then
+	return ""
+end if
+
+tell application "Finder"
+	set windowList to every Finder window
+	if (count of windowList) = 0 then
+		return ""
+	end if
+	set output to ""
+	set idx to 1
+	repeat with w in windowList
+		set windowName to name of w
+		set windowPath to ""
+		try
+			set windowPath to POSIX path of (target of w as alias)
+		on error
+			-- Special view (Recents, Search, etc.) - mark with special: prefix
+			set windowPath to "special:" & windowName
+		end try
+		if output is not "" then
+			set output to output & "${ITEM_DELIMITER2}"
+		end if
+		set output to output & windowName & "${FIELD_DELIMITER2}" & windowPath & "${FIELD_DELIMITER2}" & idx
+		set idx to idx + 1
+	end repeat
+	return output
+end tell
+`;
+function parseOutput4(output) {
+  if (!output || output.trim() === "") {
+    return [];
+  }
+  const itemStrings = output.split(ITEM_DELIMITER2);
+  const windows = [];
+  for (const itemStr of itemStrings) {
+    const parts = itemStr.split(FIELD_DELIMITER2);
+    if (parts.length >= 3) {
+      const pathValue = parts[1] ?? "";
+      const isSpecial = pathValue.startsWith("special:");
+      windows.push({
+        name: parts[0] ?? "",
+        path: isSpecial ? null : pathValue,
+        index: parseInt(parts[2] ?? "0", 10),
+        isSpecialView: isSpecial
+      });
+    }
+  }
+  return windows;
+}
+async function getFinderWindows(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT4, parseOutput4, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+
+// src/osascript/scripts/fileMetadata.ts
+var DELIMITER2 = "|||";
+function buildScript(filePath) {
+  const escapedPath = escapeForAppleScript(filePath);
+  return `
+tell application "System Events"
+	set f to disk item (POSIX file "${escapedPath}")
+	set n to name of f
+	set p to "${escapedPath}"
+	try
+		set s to size of f
+	on error
+		set s to 0
+	end try
+	set isDir to (class of f is folder) as string
+	try
+		set c to creation date of f as string
+	on error
+		set c to ""
+	end try
+	try
+		set m to modification date of f as string
+	on error
+		set m to ""
+	end try
+	try
+		set ext to name extension of f
+	on error
+		set ext to ""
+	end try
+	try
+		set k to kind of f
+	on error
+		set k to ""
+	end try
+	return n & "${DELIMITER2}" & p & "${DELIMITER2}" & s & "${DELIMITER2}" & isDir & "${DELIMITER2}" & c & "${DELIMITER2}" & m & "${DELIMITER2}" & ext & "${DELIMITER2}" & k
+end tell
+`;
+}
+function parseOutput5(output) {
+  const parts = output.split(DELIMITER2);
+  return {
+    name: parts[0] ?? "",
+    path: parts[1] ?? "",
+    size: parseInt(parts[2] ?? "0", 10) || 0,
+    isFolder: (parts[3] ?? "").toLowerCase() === "true",
+    createdAt: parts[4] ?? "",
+    modifiedAt: parts[5] ?? "",
+    extension: parts[6] ?? "",
+    kind: parts[7] ?? ""
+  };
+}
+async function getFileMetadata(filePath, options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const script = buildScript(filePath);
+  const result = await executeAndParse(script, parseOutput5, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+async function getFilesMetadata(filePaths, options) {
+  if (!isOsascriptAvailable()) {
+    return filePaths.map(() => null);
+  }
+  const results = await Promise.all(
+    filePaths.map((path2) => getFileMetadata(path2, options))
+  );
+  return results;
+}
+
+// src/osascript/scripts/clipboard.ts
+var DELIMITER3 = "|||";
+var FILE_DELIMITER = ":::";
+var TEXT_SCRIPT = `
+try
+	set clipText to the clipboard as text
+	return clipText
+on error
+	return ""
+end try
+`;
+var FILES_SCRIPT = `
+try
+	set clipFiles to the clipboard as alias list
+	set output to ""
+	repeat with f in clipFiles
+		set p to POSIX path of (f as alias)
+		if output is not "" then
+			set output to output & "${FILE_DELIMITER}"
+		end if
+		set output to output & p
+	end repeat
+	if output is "" then
+		return "NOFILES${DELIMITER3}"
+	end if
+	return "FILES${DELIMITER3}" & output
+on error
+	return "NOFILES${DELIMITER3}"
+end try
+`;
+var IMAGE_SCRIPT = `
+try
+	set imgData to the clipboard as \xABclass PNGf\xBB
+	return "1"
+on error
+	try
+		set imgData to the clipboard as TIFF picture
+		return "1"
+	on error
+		return "0"
+	end try
+end try
+`;
+function parseFilesOutput(output) {
+  if (output.startsWith("FILES" + DELIMITER3)) {
+    const pathsPart = output.substring(("FILES" + DELIMITER3).length);
+    if (pathsPart.trim()) {
+      const paths = pathsPart.split(FILE_DELIMITER).filter((p) => p.trim());
+      return { hasFiles: paths.length > 0, filePaths: paths };
+    }
+  }
+  return { hasFiles: false, filePaths: [] };
+}
+async function getClipboardContent(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const [textResult, filesResult, imageResult] = await Promise.all([
+    executeAndParse(TEXT_SCRIPT, (output) => output || null, options),
+    executeAndParse(FILES_SCRIPT, parseFilesOutput, options),
+    executeAndParse(IMAGE_SCRIPT, (output) => output.trim() === "1", options)
+  ]);
+  const text = textResult.success ? textResult.data : null;
+  const filesData = filesResult.success && filesResult.data ? filesResult.data : { hasFiles: false, filePaths: [] };
+  const hasImage = imageResult.success ? imageResult.data ?? false : false;
+  return {
+    text: text ?? null,
+    hasFiles: filesData.hasFiles,
+    filePaths: filesData.filePaths,
+    hasImage
+  };
+}
+async function getClipboardText(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(TEXT_SCRIPT, (output) => output || null, options);
+  if (result.success) {
+    return result.data ?? null;
+  }
+  return null;
+}
+
+// src/osascript/scripts/desktopItems.ts
+var FIELD_DELIMITER3 = "|||";
+var ITEM_DELIMITER3 = ":::";
+var SCRIPT5 = `
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+end tell
+
+if finderRunning is false then
+	return ""
+end if
+
+tell application "Finder"
+	set desktopItems to every item of desktop
+	if (count of desktopItems) = 0 then
+		return ""
+	end if
+	set output to ""
+	repeat with f in desktopItems
+		set n to name of f
+		set p to POSIX path of (f as alias)
+		set k to class of f as string
+		if output is not "" then
+			set output to output & "${ITEM_DELIMITER3}"
+		end if
+		set output to output & n & "${FIELD_DELIMITER3}" & p & "${FIELD_DELIMITER3}" & k
+	end repeat
+	return output
+end tell
+`;
+function parseOutput6(output) {
+  if (!output || output.trim() === "") {
+    return [];
+  }
+  const itemStrings = output.split(ITEM_DELIMITER3);
+  const items = [];
+  for (const itemStr of itemStrings) {
+    const parts = itemStr.split(FIELD_DELIMITER3);
+    if (parts.length >= 2) {
+      const name = parts[0] ?? "";
+      const path2 = parts[1] ?? "";
+      const classType = parts[2] ?? "";
+      items.push({
+        name,
+        path: path2,
+        isFolder: classType.toLowerCase().includes("folder")
+      });
+    }
+  }
+  return items;
+}
+async function getDesktopItems(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT5, parseOutput6, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+async function getDesktopPath(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const script = `try
+return do shell script "echo $HOME/Desktop/"
+on error
+return ""
+end try`;
+  const result = await executeAndParse(script, (output) => output.trim() || null, options);
+  if (result.success) {
+    return result.data ?? null;
+  }
+  return null;
+}
+
+// src/osascript/scripts/recentFiles.ts
+var FIELD_DELIMITER4 = "|||";
+var ITEM_DELIMITER4 = ":::";
+function buildScript2(limit) {
+  return `
+tell application "System Events"
+	set finderRunning to (exists process "Finder")
+end tell
+
+if finderRunning is false then
+	return ""
+end if
+
+tell application "Finder"
+	try
+		set recentFolder to folder "Recents" of home
+		set recentItems to every item of recentFolder
+		set itemCount to count of recentItems
+		if itemCount > ${limit} then
+			set itemCount to ${limit}
+		end if
+		if itemCount = 0 then
+			return ""
+		end if
+		set output to ""
+		repeat with i from 1 to itemCount
+			set f to item i of recentItems
+			try
+				set n to name of f
+				set p to POSIX path of (f as alias)
+				set m to modification date of f as string
+				if output is not "" then
+					set output to output & "${ITEM_DELIMITER4}"
+				end if
+				set output to output & n & "${FIELD_DELIMITER4}" & p & "${FIELD_DELIMITER4}" & m
+			end try
+		end repeat
+		return output
+	on error
+		return ""
+	end try
+end tell
+`;
+}
+var RECENT_DOCUMENTS_SCRIPT = `
+try
+	set recentApps to paragraphs of (do shell script "mdfind -onlyin ~ 'kMDItemLastUsedDate >= $time.today(-7)' | head -50")
+	set output to ""
+	repeat with filePath in recentApps
+		if filePath is not "" then
+			try
+				tell application "System Events"
+					set f to disk item (POSIX file filePath)
+					set n to name of f
+					set m to modification date of f as string
+				end tell
+				if output is not "" then
+					set output to output & "${ITEM_DELIMITER4}"
+				end if
+				set output to output & n & "${FIELD_DELIMITER4}" & filePath & "${FIELD_DELIMITER4}" & m
+			end try
+		end if
+	end repeat
+	return output
+on error
+	return ""
+end try
+`;
+function parseOutput7(output) {
+  if (!output || output.trim() === "") {
+    return [];
+  }
+  const itemStrings = output.split(ITEM_DELIMITER4);
+  const items = [];
+  for (const itemStr of itemStrings) {
+    const parts = itemStr.split(FIELD_DELIMITER4);
+    if (parts.length >= 2) {
+      items.push({
+        name: parts[0] ?? "",
+        path: parts[1] ?? "",
+        accessedAt: parts[2] ?? ""
+      });
+    }
+  }
+  return items;
+}
+async function getRecentFiles(limit = 20, options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const script = buildScript2(limit);
+  const result = await executeAndParse(script, parseOutput7, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+async function getRecentDocuments(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(RECENT_DOCUMENTS_SCRIPT, parseOutput7, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+
+// src/osascript/scripts/runningApps.ts
+var FIELD_DELIMITER5 = "|||";
+var ITEM_DELIMITER5 = ":::";
+var SCRIPT6 = `
+tell application "System Events"
+	set appList to every application process
+	set output to ""
+	repeat with proc in appList
+		try
+			set appName to name of proc
+			set appId to bundle identifier of proc
+			set isHidden to not (visible of proc)
+			set isFront to frontmost of proc
+			if output is not "" then
+				set output to output & "${ITEM_DELIMITER5}"
+			end if
+			set output to output & appName & "${FIELD_DELIMITER5}" & appId & "${FIELD_DELIMITER5}" & (isHidden as string) & "${FIELD_DELIMITER5}" & (isFront as string)
+		end try
+	end repeat
+	return output
+end tell
+`;
+function parseOutput8(output) {
+  if (!output || output.trim() === "") {
+    return [];
+  }
+  const itemStrings = output.split(ITEM_DELIMITER5);
+  const apps = [];
+  for (const itemStr of itemStrings) {
+    const parts = itemStr.split(FIELD_DELIMITER5);
+    if (parts.length >= 4) {
+      apps.push({
+        name: parts[0] ?? "",
+        bundleId: parts[1] ?? "",
+        isHidden: (parts[2] ?? "").toLowerCase() === "true",
+        isFrontmost: (parts[3] ?? "").toLowerCase() === "true"
+      });
+    }
+  }
+  return apps;
+}
+async function getRunningApps(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const result = await executeAndParse(SCRIPT6, parseOutput8, options);
+  if (result.success && result.data) {
+    return result.data;
+  }
+  return null;
+}
+async function isAppRunning(appName, options) {
+  const apps = await getRunningApps(options);
+  if (!apps) {
+    return false;
+  }
+  const lowerName = appName.toLowerCase();
+  return apps.some(
+    (app) => app.name.toLowerCase() === lowerName || app.bundleId.toLowerCase() === lowerName
+  );
+}
+async function getFrontmostFromRunning(options) {
+  const apps = await getRunningApps(options);
+  if (!apps) {
+    return null;
+  }
+  return apps.find((app) => app.isFrontmost) ?? null;
+}
+
+// src/osascript/scripts/fileContent.ts
+var DELIMITER4 = "\xA7\xA7\xA7";
+async function readFileContent(filePath, opts) {
+  if (!isOsascriptAvailable()) return null;
+  const maxBytes = opts?.maxBytes ?? 1048576;
+  const encoding = opts?.encoding ?? "utf8";
+  const script = `
+set filePath to "${filePath.replace(/"/g, '\\"')}"
+set maxSize to ${maxBytes}
+set d to "${DELIMITER4}"
+
+try
+	set fileRef to POSIX file filePath
+	
+	-- Get file size first
+	tell application "System Events"
+		set fileSize to size of (disk item filePath)
+	end tell
+	
+	-- Check size limit
+	if fileSize > maxSize then
+		return "ERROR" & d & "File too large: " & fileSize & " bytes (max: " & maxSize & ")"
+	end if
+	
+	-- Read file content
+	set fileContent to read fileRef as \xABclass utf8\xBB
+	
+	return "OK" & d & fileSize & d & fileContent
+on error errMsg
+	return "ERROR" & d & errMsg
+end try
+`;
+  const parser = (out) => {
+    const parts = out.split(DELIMITER4);
+    const status = parts[0]?.trim();
+    if (status === "ERROR") {
+      return {
+        path: filePath,
+        content: "",
+        size: 0,
+        success: false,
+        error: parts[1]?.trim() || "Unknown error"
+      };
+    }
+    return {
+      path: filePath,
+      content: parts.slice(2).join(DELIMITER4),
+      // Content may contain delimiter
+      size: parseInt(parts[1] ?? "0", 10),
+      success: true
+    };
+  };
+  const r = await executeAndParse(script, parser, opts);
+  return r.success ? r.data ?? null : null;
+}
+async function readMultipleFiles(filePaths, opts) {
+  if (!isOsascriptAvailable()) return [];
+  const results = await Promise.all(
+    filePaths.map((path2) => readFileContent(path2, opts))
+  );
+  return results.filter((r) => r !== null);
+}
+
+// src/osascript/index.ts
+async function getSystemContext(options) {
+  if (!isOsascriptAvailable()) {
+    return null;
+  }
+  const frontmostApp = await getFrontmostApp(options);
+  if (!frontmostApp) {
+    return null;
+  }
+  let finderSelection = null;
+  let finderCurrentFolder = null;
+  if (frontmostApp.isFinder) {
+    [finderSelection, finderCurrentFolder] = await Promise.all([
+      getFinderSelection(options),
+      getFinderCurrentFolder(options)
+    ]);
+  }
+  const clipboard = await getClipboardContent(options);
+  return {
+    frontmostApp,
+    finderSelection,
+    finderCurrentFolder,
+    clipboard: clipboard ?? { text: null, hasFiles: false, filePaths: [], hasImage: false }
+  };
+}
+
+// src/index.ts
+var IS_MACOS2 = process.platform === "darwin";
 var IS_WINDOWS = process.platform === "win32";
 var PLATFORM_PACKAGES = {
   "darwin-arm64": "@simen-keyboard-listener/darwin-arm64",
@@ -48,7 +1385,7 @@ function getNativeAddon() {
     try {
       const candidate = localRequire(packageName);
       const hasCoreFunctions = candidate && typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.isRunning === "function" && typeof candidate.checkPermission === "function";
-      const hasMacOSFunctions = IS_MACOS ? typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function" : true;
+      const hasMacOSFunctions = IS_MACOS2 ? typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function" : true;
       if (hasCoreFunctions && hasMacOSFunctions) {
         nativeAddon = candidate;
         return nativeAddon;
@@ -165,7 +1502,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
   }
 };
 function getGlobalKeyboardListener() {
-  if (!IS_MACOS && !IS_WINDOWS) {
+  if (!IS_MACOS2 && !IS_WINDOWS) {
     throw new Error(`Unsupported platform for global keyboard listener: ${process.platform}`);
   }
   return NativeKeyboardListener.getInstance();
@@ -174,7 +1511,7 @@ function createGlobalKeyboardListener() {
   return getGlobalKeyboardListener();
 }
 function checkKeyboardPermission() {
-  if (!IS_MACOS && !IS_WINDOWS) {
+  if (!IS_MACOS2 && !IS_WINDOWS) {
     return false;
   }
   try {
@@ -186,7 +1523,7 @@ function checkKeyboardPermission() {
 }
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
-  if (!IS_MACOS) {
+  if (!IS_MACOS2) {
     return;
   }
   const now = Date.now();
@@ -212,7 +1549,7 @@ function ensureAccessibilityPermission(addon) {
   return false;
 }
 function getFocusedInputValue() {
-  if (!IS_MACOS) {
+  if (!IS_MACOS2) {
     return null;
   }
   const addon = getNativeAddon();
@@ -226,7 +1563,7 @@ function getFocusedInputValue() {
   }
 }
 function getFocusedInputSelectedText() {
-  if (!IS_MACOS) {
+  if (!IS_MACOS2) {
     return null;
   }
   const addon = getNativeAddon();
@@ -240,7 +1577,7 @@ function getFocusedInputSelectedText() {
   }
 }
 function getContextJSON() {
-  if (!IS_MACOS) return null;
+  if (!IS_MACOS2) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -250,7 +1587,7 @@ function getContextJSON() {
   }
 }
 function getSelectedTextSmart() {
-  if (!IS_MACOS) return null;
+  if (!IS_MACOS2) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -272,10 +1609,36 @@ function setBlockSystemHotkeys(block) {
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
+  escapeForAppleScript,
+  executeAndParse,
+  executeAppleScript,
+  executeAppleScriptLines,
+  executeMultilineAndParse,
+  getAgentContext,
+  getClipboardContent,
+  getClipboardText,
   getContextJSON,
+  getDesktopItems,
+  getDesktopPath,
+  getFileMetadata,
+  getFilesMetadata,
+  getFinderContext,
+  getFinderCurrentFolder,
+  getFinderSelection,
+  getFinderWindows,
   getFocusedInputSelectedText,
   getFocusedInputValue,
+  getFrontmostApp,
+  getFrontmostFromRunning,
   getGlobalKeyboardListener,
+  getRecentDocuments,
+  getRecentFiles,
+  getRunningApps,
   getSelectedTextSmart,
+  getSystemContext,
+  isAppRunning,
+  isOsascriptAvailable,
+  readFileContent,
+  readMultipleFiles,
   setBlockSystemHotkeys
 };