@easynet/agent-tool-buildin 0.0.41 → 0.0.43

package/dist/src/iterm/itermListWindows.js

@@ -0,0 +1,73 @@
+import { runOsaScript, RECORD_SEPARATOR, FIELD_SEPARATOR, } from "./common.js";
+/**
+ * List iTerm2 windows, tabs, and sessions.
+ * @tool
+ * @effect none
+ */
+export async function itermListWindows(_ = {}) {
+    const lines = [
+        'tell application "iTerm2"',
+        "set rs to ASCII character 30",
+        "set fs to ASCII character 31",
+        // Avoid "rows" name collision with iTerm properties.
+        "set collectedRows to {}",
+        "repeat with aWindow in windows",
+        "set windowId to (id of aWindow) as text",
+        "set windowName to (name of aWindow) as text",
+        "set tabCount to count of tabs of aWindow",
+        "repeat with tabPos from 1 to tabCount",
+        "set aTab to tab tabPos of aWindow",
+        "set tabIdx1 to tabPos as integer",
+        "set tabIdx0 to tabIdx1 - 1",
+        "set isCurrentTab to (aTab is current tab of aWindow)",
+        "repeat with aSession in sessions of aTab",
+        "set sessionId to (id of aSession) as text",
+        "set sessionUid to (unique id of aSession) as text",
+        "set sessionName to (name of aSession) as text",
+        "set sessionTty to (tty of aSession) as text",
+        "set isCurrentSession to (aSession is current session of aWindow)",
+        "set end of collectedRows to windowId & fs & windowName & fs & (tabIdx1 as text) & fs & (tabIdx0 as text) & fs & (isCurrentTab as text) & fs & sessionId & fs & sessionUid & fs & sessionName & fs & sessionTty & fs & (isCurrentSession as text)",
+        "end repeat",
+        "end repeat",
+        "end repeat",
+        "set AppleScript's text item delimiters to rs",
+        "set outputText to collectedRows as text",
+        "set AppleScript's text item delimiters to \"\"",
+        "return outputText",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const rows = output
+        ? output.split(RECORD_SEPARATOR).filter(Boolean)
+        : [];
+    const sessions = rows.map((row) => {
+        const [windowId, windowName, tabIndex, tabIndexZero, isCurrentTab, sessionId, sessionUniqueId, sessionName, tty, isCurrentSession,] = row.split(FIELD_SEPARATOR);
+        return {
+            windowId: Number(windowId ?? "0"),
+            windowName: windowName ?? "",
+            tabIndex: Number(tabIndex ?? "0"),
+            tabIndexZeroBased: Number(tabIndexZero ?? "0"),
+            isCurrentTab: isCurrentTab === "true",
+            sessionId: sessionId ?? "",
+            sessionUniqueId: sessionUniqueId ?? "",
+            sessionName: sessionName ?? "",
+            tty: tty ?? "",
+            isCurrentSession: isCurrentSession === "true",
+        };
+    });
+    return {
+        result: {
+            sessions,
+            count: sessions.length,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermListWindows",
+                summary: `Listed ${sessions.length} iTerm2 sessions`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermListWindows.js.map

package/dist/src/iterm/itermListWindows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermListWindows.js","sourceRoot":"","sources":["../../../src/iterm/itermListWindows.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAEnC,EAAE;IACJ,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,8BAA8B;QAC9B,8BAA8B;QAC9B,qDAAqD;QACrD,yBAAyB;QACzB,gCAAgC;QAChC,yCAAyC;QACzC,6CAA6C;QAC7C,0CAA0C;QAC1C,uCAAuC;QACvC,mCAAmC;QACnC,kCAAkC;QAClC,4BAA4B;QAC5B,sDAAsD;QACtD,0CAA0C;QAC1C,2CAA2C;QAC3C,mDAAmD;QACnD,+CAA+C;QAC/C,6CAA6C;QAC7C,kEAAkE;QAClE,kPAAkP;QAClP,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,8CAA8C;QAC9C,yCAAyC;QACzC,gDAAgD;QAChD,mBAAmB;QACnB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAEzC,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,CACJ,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,GAAG,EACH,gBAAgB,EACjB,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAE/B,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;YACjC,UAAU,EAAE,UAAU,IAAI,EAAE;YAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;YACjC,iBAAiB,EAAE,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC;YAC9C,YAAY,EAAE,YAAY,KAAK,MAAM;YACrC,SAAS,EAAE,SAAS,IAAI,EAAE;YAC1B,eAAe,EAAE,eAAe,IAAI,EAAE;YACtC,WAAW,EAAE,WAAW,IAAI,EAAE;YAC9B,GAAG,EAAE,GAAG,IAAI,EAAE;YACd,gBAAgB,EAAE,gBAAgB,KAAK,MAAM;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE;YACN,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,kBAAkB;gBACvB,OAAO,EAAE,UAAU,QAAQ,CAAC,MAAM,kBAAkB;gBACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermRename.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rename iTerm2 window/tab/session targets.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermRename(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+    windowName?: string;
+    tabName?: string;
+    sessionName?: string;
+}): Promise<{
+    result: {
+        windowName: string | null;
+        tabName: string | null;
+        sessionName: string | null;
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermRename.d.ts.map

package/dist/src/iterm/itermRename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermRename.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermRename.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;;;;;;;;;;;;;;;;GAgDA"}

package/dist/src/iterm/itermRename.js

@@ -0,0 +1,49 @@
+import { runOsaScript, targetSelectorScript, applyOptionalNamingScript, returnTupleScript, parsePipeTuple, createTaggedError, } from "./common.js";
+/**
+ * Rename iTerm2 window/tab/session targets.
+ * @tool
+ * @effect local_write
+ */
+export async function itermRename(args) {
+    if (!args.windowName?.trim() && !args.tabName?.trim() && !args.sessionName?.trim()) {
+        throw createTaggedError("ITERM_INVALID", "At least one of windowName/tabName/sessionName is required", {});
+    }
+    const lines = [
+        'tell application "iTerm2"',
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        ...applyOptionalNamingScript({
+            windowName: args.windowName,
+            tabName: args.tabName,
+            sessionName: args.sessionName,
+        }),
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "targetSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    return {
+        result: {
+            ...parsed,
+            windowName: args.windowName?.trim() ?? null,
+            tabName: args.tabName?.trim() ?? null,
+            sessionName: args.sessionName?.trim() ?? null,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermRename",
+                summary: `Renamed iTerm2 targets in window ${parsed.windowId}, tab ${parsed.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermRename.js.map

package/dist/src/iterm/itermRename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermRename.js","sourceRoot":"","sources":["../../../src/iterm/itermRename.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAOjC;IACC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACnF,MAAM,iBAAiB,CACrB,eAAe,EACf,4DAA4D,EAC5D,EAAE,CACH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,oBAAoB,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,GAAG,yBAAyB,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QACF,GAAG,iBAAiB,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,eAAe;SAC5B,CAAC;QACF,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI;YAC3C,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI;SAC9C;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,aAAa;gBAClB,OAAO,EAAE,oCAAoC,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE;gBACtF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermResizeWindow.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resize the current iTerm2 window to a percentage of the main screen,
+ * and center it. Default: 85% width, 85% height.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermResizeWindow(args: {
+    windowId?: number;
+    /** Width percentage of the main screen (10–100, default 85). */
+    widthPercent?: number;
+    /** Height percentage of the main screen (10–100, default 85). */
+    heightPercent?: number;
+}): Promise<{
+    result: {
+        widthPercent: number;
+        heightPercent: number;
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermResizeWindow.d.ts.map

package/dist/src/iterm/itermResizeWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermResizeWindow.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermResizeWindow.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;;;;;;;;;;;;;;GA+CA"}

package/dist/src/iterm/itermResizeWindow.js

@@ -0,0 +1,53 @@
+import { runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, } from "./common.js";
+/**
+ * Resize the current iTerm2 window to a percentage of the main screen,
+ * and center it. Default: 85% width, 85% height.
+ * @tool
+ * @effect local_write
+ */
+export async function itermResizeWindow(args) {
+    const widthPercent = Math.max(10, Math.min(100, args.widthPercent ?? 85));
+    const heightPercent = Math.max(10, Math.min(100, args.heightPercent ?? 85));
+    const lines = [
+        // Get main screen bounds and compute target size/position.
+        'tell application "Finder"',
+        "set desktopBounds to bounds of window of desktop",
+        "set screenWidth to item 3 of desktopBounds",
+        "set screenHeight to item 4 of desktopBounds",
+        `set targetWidth to (screenWidth * ${widthPercent} / 100) as integer`,
+        `set targetHeight to (screenHeight * ${heightPercent} / 100) as integer`,
+        "set leftPos to ((screenWidth - targetWidth) / 2) as integer",
+        "set topPos to ((screenHeight - targetHeight) / 2) as integer",
+        "end tell",
+        // Resize and center the iTerm2 window.
+        'tell application "iTerm2"',
+        ...targetSelectorScript({
+            windowId: args.windowId,
+        }),
+        "set bounds of targetWindow to {leftPos, topPos, leftPos + targetWidth, topPos + targetHeight}",
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "targetSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    return {
+        result: {
+            ...parsed,
+            widthPercent,
+            heightPercent,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermResizeWindow",
+                summary: `Resized window ${parsed.windowId} to ${widthPercent}% x ${heightPercent}%`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermResizeWindow.js.map

package/dist/src/iterm/itermResizeWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermResizeWindow.js","sourceRoot":"","sources":["../../../src/iterm/itermResizeWindow.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAMvC;IACC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG;QACZ,2DAA2D;QAC3D,2BAA2B;QAC3B,kDAAkD;QAClD,4CAA4C;QAC5C,6CAA6C;QAC7C,qCAAqC,YAAY,oBAAoB;QACrE,uCAAuC,aAAa,oBAAoB;QACxE,6DAA6D;QAC7D,8DAA8D;QAC9D,UAAU;QACV,uCAAuC;QACvC,2BAA2B;QAC3B,GAAG,oBAAoB,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,+FAA+F;QAC/F,GAAG,iBAAiB,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,eAAe;SAC5B,CAAC;QACF,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,YAAY;YACZ,aAAa;SACd;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,mBAAmB;gBACxB,OAAO,EAAE,kBAAkB,MAAM,CAAC,QAAQ,OAAO,YAAY,OAAO,aAAa,GAAG;gBACpF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermRunCommandInSession.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Run a shell command in an iTerm2 session (panel).
+ * Implemented by sending one line of text via itermSendText and appending a newline.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermRunCommandInSession(args: {
+    command: string;
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+}): Promise<{
+    result: {
+        command: string;
+        text: string;
+        newline: boolean;
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermRunCommandInSession.d.ts.map

package/dist/src/iterm/itermRunCommandInSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermRunCommandInSession.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermRunCommandInSession.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;;GA6BA"}

package/dist/src/iterm/itermRunCommandInSession.js

@@ -0,0 +1,37 @@
+import { itermSendText } from "./itermSendText.js";
+import { createTaggedError } from "./common.js";
+/**
+ * Run a shell command in an iTerm2 session (panel).
+ * Implemented by sending one line of text via itermSendText and appending a newline.
+ * @tool
+ * @effect local_write
+ */
+export async function itermRunCommandInSession(args) {
+    const cmd = args.command?.trim();
+    if (!cmd) {
+        throw createTaggedError("ITERM_INVALID", "command is required", {});
+    }
+    const { result, evidence } = await itermSendText({
+        text: cmd,
+        windowId: args.windowId,
+        tabIndex: args.tabIndex,
+        sessionId: args.sessionId,
+        newline: true,
+    });
+    return {
+        result: {
+            ...result,
+            command: cmd,
+        },
+        evidence: [
+            ...(evidence ?? []),
+            {
+                type: "tool",
+                ref: "itermRunCommandInSession",
+                summary: `Ran command in window ${result.windowId}, tab ${result.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermRunCommandInSession.js.map

package/dist/src/iterm/itermRunCommandInSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermRunCommandInSession.js","sourceRoot":"","sources":["../../../src/iterm/itermRunCommandInSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAK9C;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,iBAAiB,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC;QAC/C,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,OAAO,EAAE,GAAG;SACb;QACD,QAAQ,EAAE;YACR,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;YACnB;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,0BAA0B;gBAC/B,OAAO,EAAE,yBAAyB,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE;gBAC3E,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermSendText.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Send text to an iTerm2 session as if typed.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermSendText(args: {
+    text: string;
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+    newline?: boolean;
+}): Promise<{
+    result: {
+        text: string;
+        newline: boolean;
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermSendText.d.ts.map

package/dist/src/iterm/itermSendText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSendText.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermSendText.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;;;;;;;;;;;;;;;GA2CA"}

package/dist/src/iterm/itermSendText.js

@@ -0,0 +1,47 @@
+import { runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, quoteAppleScriptString, createTaggedError, } from "./common.js";
+/**
+ * Send text to an iTerm2 session as if typed.
+ * @tool
+ * @effect local_write
+ */
+export async function itermSendText(args) {
+    const text = args.text;
+    if (!text || !text.trim()) {
+        throw createTaggedError("ITERM_INVALID", "text is required", {});
+    }
+    const newline = args.newline ?? true;
+    const newlineClause = newline ? "" : " newline NO";
+    const lines = [
+        'tell application "iTerm2"',
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        `tell targetSession to write text ${quoteAppleScriptString(text)}${newlineClause}`,
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "targetSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    return {
+        result: {
+            ...parsed,
+            text,
+            newline,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermSendText",
+                summary: `Sent ${text.length} chars to window ${parsed.windowId}, tab ${parsed.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermSendText.js.map

package/dist/src/iterm/itermSendText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSendText.js","sourceRoot":"","sources":["../../../src/iterm/itermSendText.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAMnC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1B,MAAM,iBAAiB,CAAC,eAAe,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;IAEnD,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,oBAAoB,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,oCAAoC,sBAAsB,CAAC,IAAI,CAAC,GAAG,aAAa,EAAE;QAClF,GAAG,iBAAiB,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,eAAe;SAC5B,CAAC;QACF,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,IAAI;YACJ,OAAO;SACR;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,eAAe;gBACpB,OAAO,EAAE,QAAQ,IAAI,CAAC,MAAM,oBAAoB,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE;gBACzF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermSetBackgroundColor.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Set iTerm2 session background color.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermSetBackgroundColor(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+    hex?: string;
+    red?: number;
+    green?: number;
+    blue?: number;
+    alpha?: number;
+}): Promise<{
+    result: {
+        color: {
+            red: number;
+            green: number;
+            blue: number;
+            alpha: number;
+        };
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermSetBackgroundColor.d.ts.map

package/dist/src/iterm/itermSetBackgroundColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSetBackgroundColor.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermSetBackgroundColor.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;;;;;;;;;;;;;;;;;GAoCA"}

package/dist/src/iterm/itermSetBackgroundColor.js

@@ -0,0 +1,41 @@
+import { runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, normalizeRgb, } from "./common.js";
+/**
+ * Set iTerm2 session background color.
+ * @tool
+ * @effect local_write
+ */
+export async function itermSetBackgroundColor(args) {
+    const color = normalizeRgb(args);
+    const lines = [
+        'tell application "iTerm2"',
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        `set background color of targetSession to {${color.red}, ${color.green}, ${color.blue}, ${color.alpha}}`,
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "targetSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    return {
+        result: {
+            ...parsed,
+            color,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermSetBackgroundColor",
+                summary: `Set background color in window ${parsed.windowId}, tab ${parsed.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermSetBackgroundColor.js.map

package/dist/src/iterm/itermSetBackgroundColor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSetBackgroundColor.js","sourceRoot":"","sources":["../../../src/iterm/itermSetBackgroundColor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAS7C;IACC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,oBAAoB,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,6CAA6C,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,GAAG;QACxG,GAAG,iBAAiB,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,eAAe;SAC5B,CAAC;QACF,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,KAAK;SACN;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,yBAAyB;gBAC9B,OAAO,EAAE,kCAAkC,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE;gBACpF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/iterm/itermSplitPane.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Split an iTerm2 session into a new pane.
+ * @tool
+ * @effect local_write
+ */
+export declare function itermSplitPane(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+    direction?: "horizontal" | "vertical";
+    profile?: string;
+    command?: string;
+    cmd?: string;
+    activate?: boolean;
+}): Promise<{
+    result: {
+        direction: string;
+        profile: string;
+        commandText: string;
+        windowId: number;
+        tabIndex: number;
+        sessionId: string;
+        sessionUniqueId: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=itermSplitPane.d.ts.map

package/dist/src/iterm/itermSplitPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSplitPane.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermSplitPane.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;;;;;;;;;;;;;;;;GAqDA"}

package/dist/src/iterm/itermSplitPane.js

@@ -0,0 +1,57 @@
+import { quoteAppleScriptString, runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, } from "./common.js";
+/**
+ * Split an iTerm2 session into a new pane.
+ * @tool
+ * @effect local_write
+ */
+export async function itermSplitPane(args) {
+    // Default to a vertical split (left/right panes) when direction is not specified.
+    const direction = args.direction === "horizontal" ? "horizontal" : "vertical";
+    const profile = args.profile?.trim();
+    const command = (args.command ?? args.cmd)?.trim();
+    const activate = args.activate ?? true;
+    const splitCommand = profile
+        ? command
+            ? `split ${direction === "vertical" ? "vertically" : "horizontally"} with profile ${quoteAppleScriptString(profile)} command ${quoteAppleScriptString(command)}`
+            : `split ${direction === "vertical" ? "vertically" : "horizontally"} with profile ${quoteAppleScriptString(profile)}`
+        : command
+            ? `split ${direction === "vertical" ? "vertically" : "horizontally"} with default profile command ${quoteAppleScriptString(command)}`
+            : `split ${direction === "vertical" ? "vertically" : "horizontally"} with default profile`;
+    const lines = [
+        'tell application "iTerm2"',
+        ...(activate ? ["activate"] : []),
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        "tell targetSession",
+        `set newSession to (${splitCommand})`,
+        "end tell",
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "newSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    return {
+        result: {
+            ...parsed,
+            direction,
+            profile: profile ?? "default",
+            commandText: command ?? "",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermSplitPane",
+                summary: `Split ${direction} in window ${parsed.windowId}, tab ${parsed.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermSplitPane.js.map

package/dist/src/iterm/itermSplitPane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itermSplitPane.js","sourceRoot":"","sources":["../../../src/iterm/itermSplitPane.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IASpC;IACC,kFAAkF;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IAEvC,MAAM,YAAY,GAAG,OAAO;QAC1B,CAAC,CAAC,OAAO;YACP,CAAC,CAAC,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,iBAAiB,sBAAsB,CAAC,OAAO,CAAC,YAAY,sBAAsB,CAAC,OAAO,CAAC,EAAE;YAChK,CAAC,CAAC,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,iBAAiB,sBAAsB,CAAC,OAAO,CAAC,EAAE;QACvH,CAAC,CAAC,OAAO;YACP,CAAC,CAAC,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,iCAAiC,sBAAsB,CAAC,OAAO,CAAC,EAAE;YACrI,CAAC,CAAC,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,uBAAuB,CAAC;IAE/F,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,oBAAoB,CAAC;YACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QACF,oBAAoB;QACpB,sBAAsB,YAAY,GAAG;QACrC,UAAU;QACV,GAAG,iBAAiB,CAAC;YACnB,SAAS,EAAE,cAAc;YACzB,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,YAAY;SACzB,CAAC;QACF,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,SAAS;YACT,OAAO,EAAE,OAAO,IAAI,SAAS;YAC7B,WAAW,EAAE,OAAO,IAAI,EAAE;SAC3B;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,gBAAgB;gBACrB,OAAO,EAAE,SAAS,SAAS,cAAc,MAAM,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE;gBAClF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}