@ai-devkit/agent-manager 0.36.0 → 0.38.0

package/dist/terminal/backends/iterm2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/iterm2.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { escapeAppleScript } from \"../../utils/applescript.js\";\nimport { TerminalType, type TerminalBackend } from \"../types.js\";\nimport { appleScriptKeyAction, isProcessRunning, sleep } from \"./shared.js\";\n\nconst execFileAsync = promisify(execFile);\n\nfunction sessionScript(tty: string, sessionCommand: string): string {\n  return `\ntell application \"iTerm\"\n  set targetSession to missing value\n  repeat with w in windows\n    repeat with t in tabs of w\n      repeat with s in sessions of t\n        if tty of s is \"${escapeAppleScript(tty)}\" then\n          set targetSession to s\n          exit repeat\n        end if\n      end repeat\n      if targetSession is not missing value then exit repeat\n    end repeat\n    if targetSession is not missing value then exit repeat\n  end repeat\n  if targetSession is missing value then return \"not_found\"\n  tell targetSession to ${sessionCommand}\nend tell\nreturn \"ok\"`;\n}\n\nexport const iterm2Backend: TerminalBackend = {\n  type: TerminalType.ITERM2,\n  label: \"iTerm2\",\n\n  async find(tty) {\n    try {\n      if (!(await isProcessRunning(\"iTerm2\"))) return null;\n      const script = `\n        tell application \"iTerm\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              repeat with s in sessions of t\n                if tty of s is \"${escapeAppleScript(tty)}\" then\n                  return \"found\"\n                end if\n              end repeat\n            end repeat\n          end repeat\n        end tell\n      `;\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      return stdout.trim() === \"found\" ? { type: TerminalType.ITERM2, identifier: tty, tty } : null;\n    } catch {\n      return null;\n    }\n  },\n\n  async focus(location) {\n    const script = `\n       tell application \"iTerm\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             repeat with s in sessions of t\n               if tty of s is \"${escapeAppleScript(location.tty)}\" then\n                 select s\n                 return \"true\"\n               end if\n             end repeat\n           end repeat\n         end repeat\n       end tell\n     `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  },\n\n  async send(location, message) {\n    const textScript = sessionScript(\n      location.tty,\n      `write text \"${escapeAppleScript(message)}\" newline no`,\n    );\n    const { stdout: textResult } = await execFileAsync(\"osascript\", [\"-e\", textScript]);\n    if (textResult.trim() !== \"ok\") {\n      throw new Error(`iTerm2 session not found for TTY ${location.tty}`);\n    }\n    await sleep(150);\n    const enterScript = sessionScript(location.tty, 'write text \"\" newline yes');\n    const { stdout: enterResult } = await execFileAsync(\"osascript\", [\"-e\", enterScript]);\n    if (enterResult.trim() !== \"ok\") {\n      throw new Error(\n        `iTerm2 session disappeared before Enter could be sent for TTY ${location.tty}`,\n      );\n    }\n  },\n\n  async sendKey(location, key) {\n    const script = `\ntell application \"iTerm\"\n  set targetSession to missing value\n  repeat with w in windows\n    repeat with t in tabs of w\n      repeat with s in sessions of t\n        if tty of s is \"${escapeAppleScript(location.tty)}\" then\n          set targetSession to s\n          set frontmost of w to true\n          tell t to select\n          tell s to select\n          exit repeat\n        end if\n      end repeat\n      if targetSession is not missing value then exit repeat\n    end repeat\n    if targetSession is not missing value then exit repeat\n  end repeat\n  if targetSession is missing value then return \"not_found\"\n  activate\nend tell\ntell application \"System Events\" to ${appleScriptKeyAction(key)}\nreturn \"ok\"`;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    if (stdout.trim() !== \"ok\") {\n      throw new Error(`iTerm2 session not found for TTY ${location.tty}`);\n    }\n  },\n};\n"],"names":["execFile","promisify","escapeAppleScript","TerminalType","appleScriptKeyAction","isProcessRunning","sleep","execFileAsync","sessionScript","tty","sessionCommand","iterm2Backend","type","ITERM2","label","find","script","stdout","trim","identifier","focus","location","send","message","textScript","textResult","Error","enterScript","enterResult","sendKey","key"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,iBAAiB,QAAQ,6BAA6B;AAC/D,SAASC,YAAY,QAA8B,cAAc;AACjE,SAASC,oBAAoB,EAAEC,gBAAgB,EAAEC,KAAK,QAAQ,cAAc;AAE5E,MAAMC,gBAAgBN,UAAUD;AAEhC,SAASQ,cAAcC,GAAW,EAAEC,cAAsB;IACxD,OAAO,CAAC;;;;;;wBAMc,EAAER,kBAAkBO,KAAK;;;;;;;;;;wBAUzB,EAAEC,eAAe;;WAE9B,CAAC;AACZ;AAEA,OAAO,MAAMC,gBAAiC;IAC5CC,MAAMT,aAAaU,MAAM;IACzBC,OAAO;IAEP,MAAMC,MAAKN,GAAG;QACZ,IAAI;YACF,IAAI,CAAE,MAAMJ,iBAAiB,WAAY,OAAO;YAChD,MAAMW,SAAS,CAAC;;;;;gCAKU,EAAEd,kBAAkBO,KAAK;;;;;;;MAOnD,CAAC;YACD,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;gBAAC;gBAAMS;aAAO;YAClE,OAAOC,OAAOC,IAAI,OAAO,UAAU;gBAAEN,MAAMT,aAAaU,MAAM;gBAAEM,YAAYV;gBAAKA;YAAI,IAAI;QAC3F,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMW,OAAMC,QAAQ;QAClB,MAAML,SAAS,CAAC;;;;;;+BAMW,EAAEd,kBAAkBmB,SAASZ,GAAG,EAAE;;;;;;;;KAQ5D,CAAC;QACF,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;YAAC;YAAMS;SAAO;QAClE,OAAOC,OAAOC,IAAI,OAAO;IAC3B;IAEA,MAAMI,MAAKD,QAAQ,EAAEE,OAAO;QAC1B,MAAMC,aAAahB,cACjBa,SAASZ,GAAG,EACZ,CAAC,YAAY,EAAEP,kBAAkBqB,SAAS,YAAY,CAAC;QAEzD,MAAM,EAAEN,QAAQQ,UAAU,EAAE,GAAG,MAAMlB,cAAc,aAAa;YAAC;YAAMiB;SAAW;QAClF,IAAIC,WAAWP,IAAI,OAAO,MAAM;YAC9B,MAAM,IAAIQ,MAAM,CAAC,iCAAiC,EAAEL,SAASZ,GAAG,EAAE;QACpE;QACA,MAAMH,MAAM;QACZ,MAAMqB,cAAcnB,cAAca,SAASZ,GAAG,EAAE;QAChD,MAAM,EAAEQ,QAAQW,WAAW,EAAE,GAAG,MAAMrB,cAAc,aAAa;YAAC;YAAMoB;SAAY;QACpF,IAAIC,YAAYV,IAAI,OAAO,MAAM;YAC/B,MAAM,IAAIQ,MACR,CAAC,8DAA8D,EAAEL,SAASZ,GAAG,EAAE;QAEnF;IACF;IAEA,MAAMoB,SAAQR,QAAQ,EAAES,GAAG;QACzB,MAAMd,SAAS,CAAC;;;;;;wBAMI,EAAEd,kBAAkBmB,SAASZ,GAAG,EAAE;;;;;;;;;;;;;;;oCAetB,EAAEL,qBAAqB0B,KAAK;WACrD,CAAC;QACR,MAAM,EAAEb,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;YAAC;YAAMS;SAAO;QAClE,IAAIC,OAAOC,IAAI,OAAO,MAAM;YAC1B,MAAM,IAAIQ,MAAM,CAAC,iCAAiC,EAAEL,SAASZ,GAAG,EAAE;QACpE;IACF;AACF,EAAE"}

package/dist/terminal/backends/shared.d.ts

@@ -0,0 +1,7 @@
+export declare const CARRIAGE_RETURN = "\r";
+export declare const ESCAPE_BYTE = "\u001B";
+export declare function sleep(ms: number): Promise<void>;
+export declare function execFileWithInput(command: string, args: string[], input: string): Promise<void>;
+export declare function appleScriptKeyAction(key: string): string;
+export declare function isProcessRunning(name: string): Promise<boolean>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/terminal/backends/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/shared.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,OAAS,CAAC;AACtC,eAAO,MAAM,WAAW,WAAS,CAAC;AAGlC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMrE"}

package/dist/terminal/backends/shared.js

@@ -0,0 +1,35 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { escapeAppleScript } from "../../utils/applescript.js";
+export const CARRIAGE_RETURN = "\x0d";
+export const ESCAPE_BYTE = "\x1b";
+const execFileAsync = promisify(execFile);
+export function sleep(ms) {
+    return new Promise((resolve)=>setTimeout(resolve, ms));
+}
+export async function execFileWithInput(command, args, input) {
+    await new Promise((resolve, reject)=>{
+        const child = execFile(command, args, (error)=>{
+            if (error) reject(error);
+            else resolve();
+        });
+        if (!child.stdin) {
+            reject(new Error(`Cannot write stdin to ${command}`));
+            return;
+        }
+        child.stdin.end(input);
+    });
+}
+export function appleScriptKeyAction(key) {
+    if (key === ESCAPE_BYTE) return "key code 53";
+    return `keystroke "${escapeAppleScript(key)}"`;
+}
+export async function isProcessRunning(name) {
+    const { stdout } = await execFileAsync("ps", [
+        "-Axo",
+        "comm"
+    ]);
+    return stdout.split("\n").map((line)=>line.trim()).some((command)=>command === name || command.endsWith(`/${name}`));
+}
+
+//# sourceMappingURL=shared.js.map

package/dist/terminal/backends/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/shared.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { escapeAppleScript } from \"../../utils/applescript.js\";\n\nexport const CARRIAGE_RETURN = \"\\x0d\";\nexport const ESCAPE_BYTE = \"\\x1b\";\nconst execFileAsync = promisify(execFile);\n\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function execFileWithInput(\n  command: string,\n  args: string[],\n  input: string,\n): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    const child = execFile(command, args, (error) => {\n      if (error) reject(error);\n      else resolve();\n    });\n    if (!child.stdin) {\n      reject(new Error(`Cannot write stdin to ${command}`));\n      return;\n    }\n    child.stdin.end(input);\n  });\n}\n\nexport function appleScriptKeyAction(key: string): string {\n  if (key === ESCAPE_BYTE) return \"key code 53\";\n  return `keystroke \"${escapeAppleScript(key)}\"`;\n}\n\nexport async function isProcessRunning(name: string): Promise<boolean> {\n  const { stdout } = await execFileAsync(\"ps\", [\"-Axo\", \"comm\"]);\n  return stdout\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .some((command) => command === name || command.endsWith(`/${name}`));\n}\n"],"names":["execFile","promisify","escapeAppleScript","CARRIAGE_RETURN","ESCAPE_BYTE","execFileAsync","sleep","ms","Promise","resolve","setTimeout","execFileWithInput","command","args","input","reject","child","error","stdin","Error","end","appleScriptKeyAction","key","isProcessRunning","name","stdout","split","map","line","trim","some","endsWith"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,iBAAiB,QAAQ,6BAA6B;AAE/D,OAAO,MAAMC,kBAAkB,OAAO;AACtC,OAAO,MAAMC,cAAc,OAAO;AAClC,MAAMC,gBAAgBJ,UAAUD;AAEhC,OAAO,SAASM,MAAMC,EAAU;IAC9B,OAAO,IAAIC,QAAQ,CAACC,UAAYC,WAAWD,SAASF;AACtD;AAEA,OAAO,eAAeI,kBACpBC,OAAe,EACfC,IAAc,EACdC,KAAa;IAEb,MAAM,IAAIN,QAAc,CAACC,SAASM;QAChC,MAAMC,QAAQhB,SAASY,SAASC,MAAM,CAACI;YACrC,IAAIA,OAAOF,OAAOE;iBACbR;QACP;QACA,IAAI,CAACO,MAAME,KAAK,EAAE;YAChBH,OAAO,IAAII,MAAM,CAAC,sBAAsB,EAAEP,SAAS;YACnD;QACF;QACAI,MAAME,KAAK,CAACE,GAAG,CAACN;IAClB;AACF;AAEA,OAAO,SAASO,qBAAqBC,GAAW;IAC9C,IAAIA,QAAQlB,aAAa,OAAO;IAChC,OAAO,CAAC,WAAW,EAAEF,kBAAkBoB,KAAK,CAAC,CAAC;AAChD;AAEA,OAAO,eAAeC,iBAAiBC,IAAY;IACjD,MAAM,EAAEC,MAAM,EAAE,GAAG,MAAMpB,cAAc,MAAM;QAAC;QAAQ;KAAO;IAC7D,OAAOoB,OACJC,KAAK,CAAC,MACNC,GAAG,CAAC,CAACC,OAASA,KAAKC,IAAI,IACvBC,IAAI,CAAC,CAAClB,UAAYA,YAAYY,QAAQZ,QAAQmB,QAAQ,CAAC,CAAC,CAAC,EAAEP,MAAM;AACtE"}

package/dist/terminal/backends/terminal-app.d.ts

@@ -0,0 +1,3 @@
+import { type TerminalBackend } from "../types.js";
+export declare const terminalAppBackend: TerminalBackend;
+//# sourceMappingURL=terminal-app.d.ts.map

package/dist/terminal/backends/terminal-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-app.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/terminal-app.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAyBjE,eAAO,MAAM,kBAAkB,EAAE,eA6FhC,CAAC"}

package/dist/terminal/backends/terminal-app.js

@@ -0,0 +1,129 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { escapeAppleScript } from "../../utils/applescript.js";
+import { TerminalType } from "../types.js";
+import { appleScriptKeyAction, isProcessRunning, sleep } from "./shared.js";
+const execFileAsync = promisify(execFile);
+function tabScript(tty, command) {
+    return `
+tell application "Terminal"
+  set targetTab to missing value
+  repeat with w in windows
+    repeat with i from 1 to count of tabs of w
+      set t to tab i of w
+      if tty of t is "${escapeAppleScript(tty)}" then
+        set targetTab to t
+        exit repeat
+      end if
+    end repeat
+    if targetTab is not missing value then exit repeat
+  end repeat
+  if targetTab is missing value then return "not_found"
+  ${command}
+end tell
+return "ok"`;
+}
+export const terminalAppBackend = {
+    type: TerminalType.TERMINAL_APP,
+    label: "Terminal.app",
+    async find (tty) {
+        try {
+            if (!await isProcessRunning("Terminal")) return null;
+            const script = `
+        tell application "Terminal"
+          repeat with w in windows
+            repeat with t in tabs of w
+              if tty of t is "${escapeAppleScript(tty)}" then
+                return "found"
+              end if
+            end repeat
+          end repeat
+        end tell
+      `;
+            const { stdout } = await execFileAsync("osascript", [
+                "-e",
+                script
+            ]);
+            return stdout.trim() === "found" ? {
+                type: TerminalType.TERMINAL_APP,
+                identifier: tty,
+                tty
+            } : null;
+        } catch  {
+            return null;
+        }
+    },
+    async focus (location) {
+        const script = `
+       tell application "Terminal"
+         activate
+         repeat with w in windows
+           repeat with t in tabs of w
+             if tty of t is "${escapeAppleScript(location.tty)}" then
+               set index of w to 1
+               set selected tab of w to t
+               return "true"
+             end if
+           end repeat
+         end repeat
+       end tell
+    `;
+        const { stdout } = await execFileAsync("osascript", [
+            "-e",
+            script
+        ]);
+        return stdout.trim() === "true";
+    },
+    async send (location, message) {
+        const textScript = tabScript(location.tty, `do script "${escapeAppleScript(message)}" in targetTab`);
+        const { stdout: textResult } = await execFileAsync("osascript", [
+            "-e",
+            textScript
+        ]);
+        if (textResult.trim() !== "ok") {
+            throw new Error(`Terminal.app tab not found for TTY ${location.tty}`);
+        }
+        await sleep(150);
+        const enterScript = tabScript(location.tty, 'do script "" in targetTab');
+        const { stdout: enterResult } = await execFileAsync("osascript", [
+            "-e",
+            enterScript
+        ]);
+        if (enterResult.trim() !== "ok") {
+            throw new Error(`Terminal.app tab disappeared before Enter could be sent for TTY ${location.tty}`);
+        }
+    },
+    async sendKey (location, key) {
+        const script = `
+tell application "Terminal"
+  set targetTab to missing value
+  set targetWindow to missing value
+  repeat with w in windows
+    repeat with i from 1 to count of tabs of w
+      set t to tab i of w
+      if tty of t is "${escapeAppleScript(location.tty)}" then
+        set targetTab to t
+        set targetWindow to w
+        exit repeat
+      end if
+    end repeat
+    if targetTab is not missing value then exit repeat
+  end repeat
+  if targetTab is missing value then return "not_found"
+  set selected of targetTab to true
+  set frontmost of targetWindow to true
+  activate
+end tell
+tell application "System Events" to ${appleScriptKeyAction(key)}
+return "ok"`;
+        const { stdout } = await execFileAsync("osascript", [
+            "-e",
+            script
+        ]);
+        if (stdout.trim() !== "ok") {
+            throw new Error(`Terminal.app tab not found for TTY ${location.tty}`);
+        }
+    }
+};
+
+//# sourceMappingURL=terminal-app.js.map

package/dist/terminal/backends/terminal-app.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/terminal-app.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { escapeAppleScript } from \"../../utils/applescript.js\";\nimport { TerminalType, type TerminalBackend } from \"../types.js\";\nimport { appleScriptKeyAction, isProcessRunning, sleep } from \"./shared.js\";\n\nconst execFileAsync = promisify(execFile);\n\nfunction tabScript(tty: string, command: string): string {\n  return `\ntell application \"Terminal\"\n  set targetTab to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${escapeAppleScript(tty)}\" then\n        set targetTab to t\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  ${command}\nend tell\nreturn \"ok\"`;\n}\n\nexport const terminalAppBackend: TerminalBackend = {\n  type: TerminalType.TERMINAL_APP,\n  label: \"Terminal.app\",\n\n  async find(tty) {\n    try {\n      if (!(await isProcessRunning(\"Terminal\"))) return null;\n      const script = `\n        tell application \"Terminal\"\n          repeat with w in windows\n            repeat with t in tabs of w\n              if tty of t is \"${escapeAppleScript(tty)}\" then\n                return \"found\"\n              end if\n            end repeat\n          end repeat\n        end tell\n      `;\n      const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n      return stdout.trim() === \"found\"\n        ? { type: TerminalType.TERMINAL_APP, identifier: tty, tty }\n        : null;\n    } catch {\n      return null;\n    }\n  },\n\n  async focus(location) {\n    const script = `\n       tell application \"Terminal\"\n         activate\n         repeat with w in windows\n           repeat with t in tabs of w\n             if tty of t is \"${escapeAppleScript(location.tty)}\" then\n               set index of w to 1\n               set selected tab of w to t\n               return \"true\"\n             end if\n           end repeat\n         end repeat\n       end tell\n    `;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    return stdout.trim() === \"true\";\n  },\n\n  async send(location, message) {\n    const textScript = tabScript(\n      location.tty,\n      `do script \"${escapeAppleScript(message)}\" in targetTab`,\n    );\n    const { stdout: textResult } = await execFileAsync(\"osascript\", [\"-e\", textScript]);\n    if (textResult.trim() !== \"ok\") {\n      throw new Error(`Terminal.app tab not found for TTY ${location.tty}`);\n    }\n    await sleep(150);\n    const enterScript = tabScript(location.tty, 'do script \"\" in targetTab');\n    const { stdout: enterResult } = await execFileAsync(\"osascript\", [\"-e\", enterScript]);\n    if (enterResult.trim() !== \"ok\") {\n      throw new Error(\n        `Terminal.app tab disappeared before Enter could be sent for TTY ${location.tty}`,\n      );\n    }\n  },\n\n  async sendKey(location, key) {\n    const script = `\ntell application \"Terminal\"\n  set targetTab to missing value\n  set targetWindow to missing value\n  repeat with w in windows\n    repeat with i from 1 to count of tabs of w\n      set t to tab i of w\n      if tty of t is \"${escapeAppleScript(location.tty)}\" then\n        set targetTab to t\n        set targetWindow to w\n        exit repeat\n      end if\n    end repeat\n    if targetTab is not missing value then exit repeat\n  end repeat\n  if targetTab is missing value then return \"not_found\"\n  set selected of targetTab to true\n  set frontmost of targetWindow to true\n  activate\nend tell\ntell application \"System Events\" to ${appleScriptKeyAction(key)}\nreturn \"ok\"`;\n    const { stdout } = await execFileAsync(\"osascript\", [\"-e\", script]);\n    if (stdout.trim() !== \"ok\") {\n      throw new Error(`Terminal.app tab not found for TTY ${location.tty}`);\n    }\n  },\n};\n"],"names":["execFile","promisify","escapeAppleScript","TerminalType","appleScriptKeyAction","isProcessRunning","sleep","execFileAsync","tabScript","tty","command","terminalAppBackend","type","TERMINAL_APP","label","find","script","stdout","trim","identifier","focus","location","send","message","textScript","textResult","Error","enterScript","enterResult","sendKey","key"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,iBAAiB,QAAQ,6BAA6B;AAC/D,SAASC,YAAY,QAA8B,cAAc;AACjE,SAASC,oBAAoB,EAAEC,gBAAgB,EAAEC,KAAK,QAAQ,cAAc;AAE5E,MAAMC,gBAAgBN,UAAUD;AAEhC,SAASQ,UAAUC,GAAW,EAAEC,OAAe;IAC7C,OAAO,CAAC;;;;;;sBAMY,EAAER,kBAAkBO,KAAK;;;;;;;;EAQ7C,EAAEC,QAAQ;;WAED,CAAC;AACZ;AAEA,OAAO,MAAMC,qBAAsC;IACjDC,MAAMT,aAAaU,YAAY;IAC/BC,OAAO;IAEP,MAAMC,MAAKN,GAAG;QACZ,IAAI;YACF,IAAI,CAAE,MAAMJ,iBAAiB,aAAc,OAAO;YAClD,MAAMW,SAAS,CAAC;;;;8BAIQ,EAAEd,kBAAkBO,KAAK;;;;;;MAMjD,CAAC;YACD,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;gBAAC;gBAAMS;aAAO;YAClE,OAAOC,OAAOC,IAAI,OAAO,UACrB;gBAAEN,MAAMT,aAAaU,YAAY;gBAAEM,YAAYV;gBAAKA;YAAI,IACxD;QACN,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMW,OAAMC,QAAQ;QAClB,MAAML,SAAS,CAAC;;;;;6BAKS,EAAEd,kBAAkBmB,SAASZ,GAAG,EAAE;;;;;;;;IAQ3D,CAAC;QACD,MAAM,EAAEQ,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;YAAC;YAAMS;SAAO;QAClE,OAAOC,OAAOC,IAAI,OAAO;IAC3B;IAEA,MAAMI,MAAKD,QAAQ,EAAEE,OAAO;QAC1B,MAAMC,aAAahB,UACjBa,SAASZ,GAAG,EACZ,CAAC,WAAW,EAAEP,kBAAkBqB,SAAS,cAAc,CAAC;QAE1D,MAAM,EAAEN,QAAQQ,UAAU,EAAE,GAAG,MAAMlB,cAAc,aAAa;YAAC;YAAMiB;SAAW;QAClF,IAAIC,WAAWP,IAAI,OAAO,MAAM;YAC9B,MAAM,IAAIQ,MAAM,CAAC,mCAAmC,EAAEL,SAASZ,GAAG,EAAE;QACtE;QACA,MAAMH,MAAM;QACZ,MAAMqB,cAAcnB,UAAUa,SAASZ,GAAG,EAAE;QAC5C,MAAM,EAAEQ,QAAQW,WAAW,EAAE,GAAG,MAAMrB,cAAc,aAAa;YAAC;YAAMoB;SAAY;QACpF,IAAIC,YAAYV,IAAI,OAAO,MAAM;YAC/B,MAAM,IAAIQ,MACR,CAAC,gEAAgE,EAAEL,SAASZ,GAAG,EAAE;QAErF;IACF;IAEA,MAAMoB,SAAQR,QAAQ,EAAES,GAAG;QACzB,MAAMd,SAAS,CAAC;;;;;;;sBAOE,EAAEd,kBAAkBmB,SAASZ,GAAG,EAAE;;;;;;;;;;;;;oCAapB,EAAEL,qBAAqB0B,KAAK;WACrD,CAAC;QACR,MAAM,EAAEb,MAAM,EAAE,GAAG,MAAMV,cAAc,aAAa;YAAC;YAAMS;SAAO;QAClE,IAAIC,OAAOC,IAAI,OAAO,MAAM;YAC1B,MAAM,IAAIQ,MAAM,CAAC,mCAAmC,EAAEL,SAASZ,GAAG,EAAE;QACtE;IACF;AACF,EAAE"}

package/dist/terminal/backends/tmux.d.ts

@@ -0,0 +1,3 @@
+import { type TerminalBackend } from "../types.js";
+export declare const tmuxBackend: TerminalBackend;
+//# sourceMappingURL=tmux.d.ts.map

package/dist/terminal/backends/tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/tmux.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAKjE,eAAO,MAAM,WAAW,EAAE,eAsDzB,CAAC"}

package/dist/terminal/backends/tmux.js

@@ -0,0 +1,76 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { TerminalType } from "../types.js";
+import { ESCAPE_BYTE, execFileWithInput, sleep } from "./shared.js";
+const execFileAsync = promisify(execFile);
+export const tmuxBackend = {
+    type: TerminalType.TMUX,
+    label: "tmux",
+    async find (tty) {
+        try {
+            const { stdout } = await execFileAsync("tmux", [
+                "list-panes",
+                "-a",
+                "-F",
+                "#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}"
+            ]);
+            for (const line of stdout.trim().split("\n")){
+                if (!line.trim()) continue;
+                const [paneTty, identifier] = line.split("|");
+                if (paneTty === tty && identifier) {
+                    return {
+                        type: TerminalType.TMUX,
+                        identifier,
+                        tty
+                    };
+                }
+            }
+        } catch  {
+        // tmux might not be installed or running
+        }
+        return null;
+    },
+    async focus (location) {
+        await execFileAsync("tmux", [
+            "switch-client",
+            "-t",
+            location.identifier
+        ]);
+        return true;
+    },
+    async send (location, message) {
+        const bufferName = `ai-devkit-send-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        await execFileWithInput("tmux", [
+            "load-buffer",
+            "-b",
+            bufferName,
+            "-"
+        ], message);
+        await execFileAsync("tmux", [
+            "paste-buffer",
+            "-t",
+            location.identifier,
+            "-b",
+            bufferName,
+            "-p",
+            "-d"
+        ]);
+        await sleep(150);
+        await execFileAsync("tmux", [
+            "send-keys",
+            "-t",
+            location.identifier,
+            "Enter"
+        ]);
+    },
+    async sendKey (location, key) {
+        await execFileAsync("tmux", [
+            "send-keys",
+            "-t",
+            location.identifier,
+            key === ESCAPE_BYTE ? "Escape" : key
+        ]);
+    }
+};
+
+//# sourceMappingURL=tmux.js.map

package/dist/terminal/backends/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/tmux.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { TerminalType, type TerminalBackend } from \"../types.js\";\nimport { ESCAPE_BYTE, execFileWithInput, sleep } from \"./shared.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport const tmuxBackend: TerminalBackend = {\n  type: TerminalType.TMUX,\n  label: \"tmux\",\n\n  async find(tty) {\n    try {\n      const { stdout } = await execFileAsync(\"tmux\", [\n        \"list-panes\",\n        \"-a\",\n        \"-F\",\n        \"#{pane_tty}|#{session_name}:#{window_index}.#{pane_index}\",\n      ]);\n      for (const line of stdout.trim().split(\"\\n\")) {\n        if (!line.trim()) continue;\n        const [paneTty, identifier] = line.split(\"|\");\n        if (paneTty === tty && identifier) {\n          return { type: TerminalType.TMUX, identifier, tty };\n        }\n      }\n    } catch {\n      // tmux might not be installed or running\n    }\n    return null;\n  },\n\n  async focus(location) {\n    await execFileAsync(\"tmux\", [\"switch-client\", \"-t\", location.identifier]);\n    return true;\n  },\n\n  async send(location, message) {\n    const bufferName = `ai-devkit-send-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n    await execFileWithInput(\"tmux\", [\"load-buffer\", \"-b\", bufferName, \"-\"], message);\n    await execFileAsync(\"tmux\", [\n      \"paste-buffer\",\n      \"-t\",\n      location.identifier,\n      \"-b\",\n      bufferName,\n      \"-p\",\n      \"-d\",\n    ]);\n    await sleep(150);\n    await execFileAsync(\"tmux\", [\"send-keys\", \"-t\", location.identifier, \"Enter\"]);\n  },\n\n  async sendKey(location, key) {\n    await execFileAsync(\"tmux\", [\n      \"send-keys\",\n      \"-t\",\n      location.identifier,\n      key === ESCAPE_BYTE ? \"Escape\" : key,\n    ]);\n  },\n};\n"],"names":["execFile","promisify","TerminalType","ESCAPE_BYTE","execFileWithInput","sleep","execFileAsync","tmuxBackend","type","TMUX","label","find","tty","stdout","line","trim","split","paneTty","identifier","focus","location","send","message","bufferName","process","pid","Date","now","Math","random","toString","slice","sendKey","key"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,YAAY,QAA8B,cAAc;AACjE,SAASC,WAAW,EAAEC,iBAAiB,EAAEC,KAAK,QAAQ,cAAc;AAEpE,MAAMC,gBAAgBL,UAAUD;AAEhC,OAAO,MAAMO,cAA+B;IAC1CC,MAAMN,aAAaO,IAAI;IACvBC,OAAO;IAEP,MAAMC,MAAKC,GAAG;QACZ,IAAI;YACF,MAAM,EAAEC,MAAM,EAAE,GAAG,MAAMP,cAAc,QAAQ;gBAC7C;gBACA;gBACA;gBACA;aACD;YACD,KAAK,MAAMQ,QAAQD,OAAOE,IAAI,GAAGC,KAAK,CAAC,MAAO;gBAC5C,IAAI,CAACF,KAAKC,IAAI,IAAI;gBAClB,MAAM,CAACE,SAASC,WAAW,GAAGJ,KAAKE,KAAK,CAAC;gBACzC,IAAIC,YAAYL,OAAOM,YAAY;oBACjC,OAAO;wBAAEV,MAAMN,aAAaO,IAAI;wBAAES;wBAAYN;oBAAI;gBACpD;YACF;QACF,EAAE,OAAM;QACN,yCAAyC;QAC3C;QACA,OAAO;IACT;IAEA,MAAMO,OAAMC,QAAQ;QAClB,MAAMd,cAAc,QAAQ;YAAC;YAAiB;YAAMc,SAASF,UAAU;SAAC;QACxE,OAAO;IACT;IAEA,MAAMG,MAAKD,QAAQ,EAAEE,OAAO;QAC1B,MAAMC,aAAa,CAAC,eAAe,EAAEC,QAAQC,GAAG,CAAC,CAAC,EAAEC,KAAKC,GAAG,GAAG,CAAC,EAAEC,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,KAAK,CAAC,IAAI;QACvG,MAAM3B,kBAAkB,QAAQ;YAAC;YAAe;YAAMmB;YAAY;SAAI,EAAED;QACxE,MAAMhB,cAAc,QAAQ;YAC1B;YACA;YACAc,SAASF,UAAU;YACnB;YACAK;YACA;YACA;SACD;QACD,MAAMlB,MAAM;QACZ,MAAMC,cAAc,QAAQ;YAAC;YAAa;YAAMc,SAASF,UAAU;YAAE;SAAQ;IAC/E;IAEA,MAAMc,SAAQZ,QAAQ,EAAEa,GAAG;QACzB,MAAM3B,cAAc,QAAQ;YAC1B;YACA;YACAc,SAASF,UAAU;YACnBe,QAAQ9B,cAAc,WAAW8B;SAClC;IACH;AACF,EAAE"}

package/dist/terminal/backends/wezterm.d.ts

@@ -0,0 +1,3 @@
+import { type TerminalBackend } from "../types.js";
+export declare const weztermBackend: TerminalBackend;
+//# sourceMappingURL=wezterm.d.ts.map

package/dist/terminal/backends/wezterm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wezterm.d.ts","sourceRoot":"","sources":["../../../src/terminal/backends/wezterm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAUjE,eAAO,MAAM,cAAc,EAAE,eAoD5B,CAAC"}

package/dist/terminal/backends/wezterm.js

@@ -0,0 +1,71 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { TerminalType } from "../types.js";
+import { CARRIAGE_RETURN, execFileWithInput, sleep } from "./shared.js";
+const execFileAsync = promisify(execFile);
+export const weztermBackend = {
+    type: TerminalType.WEZTERM,
+    label: "wezterm",
+    async find (tty) {
+        try {
+            const { stdout } = await execFileAsync("wezterm", [
+                "cli",
+                "list",
+                "--format",
+                "json"
+            ]);
+            const panes = JSON.parse(stdout);
+            if (!Array.isArray(panes)) return null;
+            for (const pane of panes){
+                if (pane?.tty_name === tty && pane.pane_id != null) {
+                    return {
+                        type: TerminalType.WEZTERM,
+                        identifier: String(pane.pane_id),
+                        tty
+                    };
+                }
+            }
+        } catch  {
+        // wezterm might not be installed, running, or returning valid JSON
+        }
+        return null;
+    },
+    async focus (location) {
+        await execFileAsync("wezterm", [
+            "cli",
+            "activate-pane",
+            "--pane-id",
+            location.identifier
+        ]);
+        return true;
+    },
+    async send (location, message) {
+        await execFileWithInput("wezterm", [
+            "cli",
+            "send-text",
+            "--pane-id",
+            location.identifier
+        ], message);
+        await sleep(150);
+        await execFileAsync("wezterm", [
+            "cli",
+            "send-text",
+            "--pane-id",
+            location.identifier,
+            "--no-paste",
+            CARRIAGE_RETURN
+        ]);
+    },
+    async sendKey (location, key) {
+        await execFileAsync("wezterm", [
+            "cli",
+            "send-text",
+            "--pane-id",
+            location.identifier,
+            "--no-paste",
+            key
+        ]);
+    }
+};
+
+//# sourceMappingURL=wezterm.js.map

package/dist/terminal/backends/wezterm.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/terminal/backends/wezterm.ts"],"sourcesContent":["import { execFile } from \"child_process\";\nimport { promisify } from \"util\";\nimport { TerminalType, type TerminalBackend } from \"../types.js\";\nimport { CARRIAGE_RETURN, execFileWithInput, sleep } from \"./shared.js\";\n\nconst execFileAsync = promisify(execFile);\n\ninterface WeztermPaneEntry {\n  pane_id?: number;\n  tty_name?: string | null;\n}\n\nexport const weztermBackend: TerminalBackend = {\n  type: TerminalType.WEZTERM,\n  label: \"wezterm\",\n\n  async find(tty) {\n    try {\n      const { stdout } = await execFileAsync(\"wezterm\", [\"cli\", \"list\", \"--format\", \"json\"]);\n      const panes = JSON.parse(stdout) as WeztermPaneEntry[];\n      if (!Array.isArray(panes)) return null;\n      for (const pane of panes) {\n        if (pane?.tty_name === tty && pane.pane_id != null) {\n          return { type: TerminalType.WEZTERM, identifier: String(pane.pane_id), tty };\n        }\n      }\n    } catch {\n      // wezterm might not be installed, running, or returning valid JSON\n    }\n    return null;\n  },\n\n  async focus(location) {\n    await execFileAsync(\"wezterm\", [\"cli\", \"activate-pane\", \"--pane-id\", location.identifier]);\n    return true;\n  },\n\n  async send(location, message) {\n    await execFileWithInput(\n      \"wezterm\",\n      [\"cli\", \"send-text\", \"--pane-id\", location.identifier],\n      message,\n    );\n    await sleep(150);\n    await execFileAsync(\"wezterm\", [\n      \"cli\",\n      \"send-text\",\n      \"--pane-id\",\n      location.identifier,\n      \"--no-paste\",\n      CARRIAGE_RETURN,\n    ]);\n  },\n\n  async sendKey(location, key) {\n    await execFileAsync(\"wezterm\", [\n      \"cli\",\n      \"send-text\",\n      \"--pane-id\",\n      location.identifier,\n      \"--no-paste\",\n      key,\n    ]);\n  },\n};\n"],"names":["execFile","promisify","TerminalType","CARRIAGE_RETURN","execFileWithInput","sleep","execFileAsync","weztermBackend","type","WEZTERM","label","find","tty","stdout","panes","JSON","parse","Array","isArray","pane","tty_name","pane_id","identifier","String","focus","location","send","message","sendKey","key"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AACjC,SAASC,YAAY,QAA8B,cAAc;AACjE,SAASC,eAAe,EAAEC,iBAAiB,EAAEC,KAAK,QAAQ,cAAc;AAExE,MAAMC,gBAAgBL,UAAUD;AAOhC,OAAO,MAAMO,iBAAkC;IAC7CC,MAAMN,aAAaO,OAAO;IAC1BC,OAAO;IAEP,MAAMC,MAAKC,GAAG;QACZ,IAAI;YACF,MAAM,EAAEC,MAAM,EAAE,GAAG,MAAMP,cAAc,WAAW;gBAAC;gBAAO;gBAAQ;gBAAY;aAAO;YACrF,MAAMQ,QAAQC,KAAKC,KAAK,CAACH;YACzB,IAAI,CAACI,MAAMC,OAAO,CAACJ,QAAQ,OAAO;YAClC,KAAK,MAAMK,QAAQL,MAAO;gBACxB,IAAIK,MAAMC,aAAaR,OAAOO,KAAKE,OAAO,IAAI,MAAM;oBAClD,OAAO;wBAAEb,MAAMN,aAAaO,OAAO;wBAAEa,YAAYC,OAAOJ,KAAKE,OAAO;wBAAGT;oBAAI;gBAC7E;YACF;QACF,EAAE,OAAM;QACN,mEAAmE;QACrE;QACA,OAAO;IACT;IAEA,MAAMY,OAAMC,QAAQ;QAClB,MAAMnB,cAAc,WAAW;YAAC;YAAO;YAAiB;YAAamB,SAASH,UAAU;SAAC;QACzF,OAAO;IACT;IAEA,MAAMI,MAAKD,QAAQ,EAAEE,OAAO;QAC1B,MAAMvB,kBACJ,WACA;YAAC;YAAO;YAAa;YAAaqB,SAASH,UAAU;SAAC,EACtDK;QAEF,MAAMtB,MAAM;QACZ,MAAMC,cAAc,WAAW;YAC7B;YACA;YACA;YACAmB,SAASH,UAAU;YACnB;YACAnB;SACD;IACH;IAEA,MAAMyB,SAAQH,QAAQ,EAAEI,GAAG;QACzB,MAAMvB,cAAc,WAAW;YAC7B;YACA;YACA;YACAmB,SAASH,UAAU;YACnB;YACAO;SACD;IACH;AACF,EAAE"}

package/dist/terminal/types.d.ts

@@ -0,0 +1,21 @@
+export declare enum TerminalType {
+    TMUX = "tmux",
+    WEZTERM = "wezterm",
+    ITERM2 = "iterm2",
+    TERMINAL_APP = "terminal-app",
+    UNKNOWN = "unknown"
+}
+export interface TerminalLocation {
+    type: TerminalType;
+    identifier: string;
+    tty: string;
+}
+export interface TerminalBackend {
+    readonly type: Exclude<TerminalType, TerminalType.UNKNOWN>;
+    readonly label: string;
+    find(tty: string): Promise<TerminalLocation | null>;
+    focus(location: TerminalLocation): Promise<boolean>;
+    send(location: TerminalLocation, message: string): Promise<void>;
+    sendKey(location: TerminalLocation, key: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/terminal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/terminal/types.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,YAAY,iBAAiB;IAC7B,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,KAAK,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE"}

package/dist/terminal/types.js

@@ -0,0 +1,10 @@
+export var TerminalType = /*#__PURE__*/ function(TerminalType) {
+    TerminalType["TMUX"] = "tmux";
+    TerminalType["WEZTERM"] = "wezterm";
+    TerminalType["ITERM2"] = "iterm2";
+    TerminalType["TERMINAL_APP"] = "terminal-app";
+    TerminalType["UNKNOWN"] = "unknown";
+    return TerminalType;
+}({});
+
+//# sourceMappingURL=types.js.map

package/dist/terminal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/terminal/types.ts"],"sourcesContent":["export enum TerminalType {\n  TMUX = \"tmux\",\n  WEZTERM = \"wezterm\",\n  ITERM2 = \"iterm2\",\n  TERMINAL_APP = \"terminal-app\",\n  UNKNOWN = \"unknown\",\n}\n\nexport interface TerminalLocation {\n  type: TerminalType;\n  identifier: string;\n  tty: string;\n}\n\nexport interface TerminalBackend {\n  readonly type: Exclude<TerminalType, TerminalType.UNKNOWN>;\n  readonly label: string;\n  find(tty: string): Promise<TerminalLocation | null>;\n  focus(location: TerminalLocation): Promise<boolean>;\n  send(location: TerminalLocation, message: string): Promise<void>;\n  sendKey(location: TerminalLocation, key: string): Promise<void>;\n}\n"],"names":["TerminalType"],"mappings":"AAAA,OAAO,IAAA,AAAKA,sCAAAA;;;;;;WAAAA;MAMX"}

package/dist/utils/IncrementalJsonlSummary.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Incremental JSONL Summary
+ *
+ * Keeps a small per-file summary of append-only JSONL transcripts so repeated
+ * refreshes only parse bytes that were appended since the previous read.
+ *
+ * Usage:
+ * ```ts
+ * const summaries = new IncrementalJsonlSummary<MyState>({
+ *   initial: () => ({ lastType: undefined }),
+ *   reduce: (state, entry) => ({ ...state, lastType: (entry as any)?.type }),
+ * });
+ *
+ * const result = summaries.read(filePath); // { state, size, mtime, skippedBytes } | null
+ * summaries.prune(); // once per refresh: evict paths not read since the last prune
+ * ```
+ *
+ * Read rules, keyed by file path:
+ * - dev, ino, size and mtimeMs unchanged → cached state, 0 bytes read.
+ * - same dev/ino and size grew → read only the bytes after the last complete line.
+ * - anything else (first read, shrink, rotation, in-place rewrite) → rebuild.
+ *
+ * A rebuild of a file larger than `headBytes + tailBytes` (default 1 MiB +
+ * 4 MiB) is a bounded cold start rather than a full parse: it folds the
+ * complete lines in `[0, headBytes)`, calls `reducer.skip(state)`, then folds
+ * the lines that start inside `[size - tailBytes, size)`, including a line
+ * that starts exactly at `size - tailBytes` (one extra byte before the window
+ * is read to tell). Lines straddling a window edge are dropped. A field whose
+ * entries all sit in the skipped middle keeps whatever `skip` leaves; there is
+ * never a hidden full scan. The result's `skippedBytes` reports the unread
+ * middle, and the cache is seeded at end of file so later appends stay
+ * incremental.
+ *
+ * An unterminated last line is never folded into the committed state. If it
+ * already parses as JSON it is applied to the returned state only, and it is
+ * re-read (from its start offset) once more bytes arrive.
+ */
+/**
+ * Pure fold over the entries of a JSONL file.
+ *
+ * `reduce` receives each non-blank line in file order: the parsed JSON value,
+ * or `undefined` when the line is not valid JSON. It must return a new state
+ * rather than mutate `state`, and the state should stay O(1) in file size
+ * (no entry arrays or raw file contents).
+ *
+ * `skip` is called once when a bounded cold start skips the middle of a file,
+ * between the head lines and the tail lines. It returns the state the tail
+ * lines fold onto: keep what the head established (e.g. the first entry) and
+ * reset fields that track the latest entry, so those come only from lines
+ * actually read. Without `skip`, tail lines fold straight onto the head state.
+ */
+export interface JsonlSummaryReducer<S> {
+    initial(): S;
+    reduce(state: S, entry: unknown): S;
+    skip?(state: S): S;
+}
+export interface JsonlSummaryResult<S> {
+    state: S;
+    /** File size in bytes when the state was computed. */
+    size: number;
+    /** File mtime (`fs.Stats.mtime`) when the state was computed. */
+    mtime: Date;
+    /** Bytes the bounded cold start did not read; 0 when the whole file was parsed. */
+    skippedBytes: number;
+}
+export interface JsonlSummaryBounds {
+    /** Bytes scanned from the start of the file on a cold start. */
+    headBytes: number;
+    /** Bytes scanned at the end of the file on a cold start. */
+    tailBytes: number;
+}
+export interface IncrementalJsonlSummaryOptions {
+    /** Bytes read per `fs.readSync` call. */
+    chunkSize?: number;
+    /** Cold-start scan bounds; `false` parses rebuilt files from byte 0. */
+    bounds?: JsonlSummaryBounds | false;
+}
+export declare const DEFAULT_HEAD_BYTES: number;
+export declare const DEFAULT_TAIL_BYTES: number;
+/** Fold a whole JSONL string with a reducer (one-shot, uncached). */
+export declare function reduceJsonlContent<S>(reducer: JsonlSummaryReducer<S>, content: string): S;
+export declare class IncrementalJsonlSummary<S> {
+    private readonly reducer;
+    private readonly entries;
+    private readonly chunkSize;
+    private readonly bounds;
+    private generation;
+    constructor(reducer: JsonlSummaryReducer<S>, options?: IncrementalJsonlSummaryOptions);
+    /** Number of cached files. */
+    get size(): number;
+    /** Return the summary of `filePath`, reading only what changed. Null if unreadable. */
+    read(filePath: string): JsonlSummaryResult<S> | null;
+    /** Evict entries not read since the previous `prune()` call. Call once per refresh. */
+    prune(): void;
+    /** Cold start: fold the head lines, `skip`, then the lines starting in the tail window. */
+    private readBounded;
+    /** Fold complete lines in `[entry.offset, end)` into `entry`. */
+    private readRange;
+}
+//# sourceMappingURL=IncrementalJsonlSummary.d.ts.map

package/dist/utils/IncrementalJsonlSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IncrementalJsonlSummary.d.ts","sourceRoot":"","sources":["../../src/utils/IncrementalJsonlSummary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC;IACT,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,IAAI,CAAC;IACZ,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CACrC;AAsBD,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAC9C,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAIlD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAMzF;AAED,qBAAa,uBAAuB,CAAC,CAAC;IAOlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAK;gBAGJ,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChD,OAAO,GAAE,8BAAmC;IAS9C,8BAA8B;IAC9B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uFAAuF;IACvF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IA0DpD,uFAAuF;IACvF,KAAK,IAAI,IAAI;IASb,2FAA2F;IAC3F,OAAO,CAAC,WAAW;IAsBnB,iEAAiE;IACjE,OAAO,CAAC,SAAS;CA0ClB"}