@botbotgo/kit-builtin 0.0.92

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

@@ -0,0 +1,35 @@
+/**
+ * Set iTerm 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 iTerm session background color.
+ * @tool
+ * @effect local_write
+ */
+export async function itermSetBackgroundColor(args) {
+    const color = normalizeRgb(args);
+    const lines = [
+        'tell application "iTerm"',
+        ...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,0BAA0B;QAC1B,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/itermSetSessionColors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Set iTerm session background and/or foreground (text) color.
+ * At least one of background or foreground must be specified.
+ * Each accepts either a hex string (#RRGGBB) or individual r/g/b values (0–65535).
+ * @tool
+ * @effect local_write
+ */
+export declare function itermSetSessionColors(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+    /** Background color as #RRGGBB hex string. */
+    backgroundHex?: string;
+    /** Background red component (0–65535). */
+    backgroundRed?: number;
+    /** Background green component (0–65535). */
+    backgroundGreen?: number;
+    /** Background blue component (0–65535). */
+    backgroundBlue?: number;
+    /** Foreground (text) color as #RRGGBB hex string. */
+    foregroundHex?: string;
+    /** Foreground red component (0–65535). */
+    foregroundRed?: number;
+    /** Foreground green component (0–65535). */
+    foregroundGreen?: number;
+    /** Foreground blue component (0–65535). */
+    foregroundBlue?: number;
+}): Promise<{
+    result: {
+        colors: Record<string, {
+            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=itermSetSessionColors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itermSetSessionColors.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermSetSessionColors.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;;;iBAK2C,MAAM;mBAAS,MAAM;kBAAQ,MAAM;mBAAS,MAAM;;;;;;;;;;;;;GAiE7F"}

package/dist/src/iterm/itermSetSessionColors.js

@@ -0,0 +1,71 @@
+import { runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, normalizeRgb, } from "./common.js";
+/**
+ * Set iTerm session background and/or foreground (text) color.
+ * At least one of background or foreground must be specified.
+ * Each accepts either a hex string (#RRGGBB) or individual r/g/b values (0–65535).
+ * @tool
+ * @effect local_write
+ */
+export async function itermSetSessionColors(args) {
+    const hasBg = args.backgroundHex || args.backgroundRed != null || args.backgroundGreen != null || args.backgroundBlue != null;
+    const hasFg = args.foregroundHex || args.foregroundRed != null || args.foregroundGreen != null || args.foregroundBlue != null;
+    const colorStatements = [];
+    const resultColors = {};
+    if (hasBg) {
+        const bg = normalizeRgb({
+            hex: args.backgroundHex,
+            red: args.backgroundRed,
+            green: args.backgroundGreen,
+            blue: args.backgroundBlue,
+        });
+        colorStatements.push(`set background color of targetSession to {${bg.red}, ${bg.green}, ${bg.blue}, ${bg.alpha}}`);
+        resultColors.background = bg;
+    }
+    if (hasFg) {
+        const fg = normalizeRgb({
+            hex: args.foregroundHex,
+            red: args.foregroundRed,
+            green: args.foregroundGreen,
+            blue: args.foregroundBlue,
+        });
+        colorStatements.push(`set foreground color of targetSession to {${fg.red}, ${fg.green}, ${fg.blue}, ${fg.alpha}}`);
+        resultColors.foreground = fg;
+    }
+    const lines = [
+        'tell application "iTerm"',
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        ...colorStatements,
+        ...returnTupleScript({
+            windowRef: "targetWindow",
+            tabRef: "targetTab",
+            sessionRef: "targetSession",
+        }),
+        "end tell",
+    ];
+    const output = await runOsaScript(lines);
+    const parsed = parsePipeTuple(output);
+    const parts = [];
+    if (hasBg)
+        parts.push("background");
+    if (hasFg)
+        parts.push("foreground");
+    return {
+        result: {
+            ...parsed,
+            colors: resultColors,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "itermSetSessionColors",
+                summary: `Set ${parts.join(" + ")} color in window ${parsed.windowId}, tab ${parsed.tabIndex}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=itermSetSessionColors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itermSetSessionColors.js","sourceRoot":"","sources":["../../../src/iterm/itermSetSessionColors.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+/**
+ * Split an iTerm 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;;;;;;;;;;;;;;;;GAwEA"}

package/dist/src/iterm/itermSplitPane.js

@@ -0,0 +1,76 @@
+import { quoteAppleScriptString, runOsaScript, targetSelectorScript, returnTupleScript, parsePipeTuple, } from "./common.js";
+/**
+ * Split an iTerm 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 "iTerm"',
+        ...(activate ? ["activate"] : []),
+        ...targetSelectorScript({
+            windowId: args.windowId,
+            tabIndex: args.tabIndex,
+            sessionId: args.sessionId,
+        }),
+        "if targetSession is missing value then",
+        "try",
+        "if targetWindow is missing value then set targetWindow to current window",
+        "if targetWindow is missing value then set targetWindow to first window",
+        "if targetTab is missing value then set targetTab to current tab of targetWindow",
+        "if targetTab is missing value then set targetTab to first tab of targetWindow",
+        "if targetSession is missing value then set targetSession to current session of targetTab",
+        "if targetSession is missing value then set targetSession to first session of targetTab",
+        "end try",
+        "end if",
+        "set newSession to missing value",
+        "try",
+        "tell targetSession",
+        `set newSession to (${splitCommand})`,
+        "end tell",
+        "on error",
+        "try",
+        "tell current session of current tab of targetWindow",
+        `set newSession to (${splitCommand})`,
+        "end tell",
+        "end try",
+        "end try",
+        ...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":"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"}

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

@@ -0,0 +1,13 @@
+export * from "./itermCreateWindow.js";
+export * from "./itermCreateTab.js";
+export * from "./itermSplitPane.js";
+export * from "./itermResizeWindow.js";
+export * from "./itermRename.js";
+export * from "./itermSetBackgroundColor.js";
+export * from "./itermSetSessionColors.js";
+export * from "./itermSendText.js";
+export * from "./itermRunCommandInSession.js";
+export * from "./itermListCurrentWindowSessions.js";
+export * from "./itermGetSessionInfo.js";
+export * from "./itermListWindows.js";
+//# sourceMappingURL=itermTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itermTools.d.ts","sourceRoot":"","sources":["../../../src/iterm/itermTools.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/src/iterm/itermTools.js

@@ -0,0 +1,13 @@
+export * from "./itermCreateWindow.js";
+export * from "./itermCreateTab.js";
+export * from "./itermSplitPane.js";
+export * from "./itermResizeWindow.js";
+export * from "./itermRename.js";
+export * from "./itermSetBackgroundColor.js";
+export * from "./itermSetSessionColors.js";
+export * from "./itermSendText.js";
+export * from "./itermRunCommandInSession.js";
+export * from "./itermListCurrentWindowSessions.js";
+export * from "./itermGetSessionInfo.js";
+export * from "./itermListWindows.js";
+//# sourceMappingURL=itermTools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itermTools.js","sourceRoot":"","sources":["../../../src/iterm/itermTools.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/src/messages/messagesFindChatsByParticipant.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Find Messages chats by participant handle or chat name.
+ * @tool
+ * @effect none
+ */
+export declare function messagesFindChatsByParticipant(args: {
+    query: string;
+    limit?: number;
+}): Promise<{
+    result: {
+        query: string;
+        count: number;
+        chats: {
+            serviceType: string;
+            chatId: string;
+            chatName: string;
+            participants: string[];
+        }[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesFindChatsByParticipant.d.ts.map

package/dist/src/messages/messagesFindChatsByParticipant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesFindChatsByParticipant.d.ts","sourceRoot":"","sources":["../../../src/messages/messagesFindChatsByParticipant.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;GAyF3F"}

package/dist/src/messages/messagesFindChatsByParticipant.js

@@ -0,0 +1,95 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { parseSeparatedRows, runOsaScript } from "../osascript/common.js";
+/**
+ * Find Messages chats by participant handle or chat name.
+ * @tool
+ * @effect none
+ */
+export async function messagesFindChatsByParticipant(args) {
+    const query = args.query?.trim();
+    if (!query)
+        throw createTaggedError("MESSAGES_INVALID", "query is required", {});
+    const limit = Math.max(1, Math.min(300, Math.trunc(args.limit ?? 100)));
+    const lines = [
+        'tell application "Messages"',
+        "set rs to (ASCII character 30)",
+        "set fs to (ASCII character 31)",
+        "set rows to {}",
+        "set n to 0",
+        `set maxCount to ${limit}`,
+        "repeat with svc in services",
+        "set serviceTypeText to \"\"",
+        "try",
+        "set serviceTypeText to (service type of svc) as text",
+        "end try",
+        "repeat with c in chats of svc",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "set n to n + 1",
+        "set chatIdText to \"\"",
+        "try",
+        "set chatIdText to (id of c) as text",
+        "end try",
+        "set chatNameText to \"\"",
+        "try",
+        "set chatNameText to (name of c) as text",
+        "end try",
+        "set participantHandles to {}",
+        "try",
+        "repeat with p in participants of c",
+        "set h to \"\"",
+        "try",
+        "set h to (handle of p) as text",
+        "end try",
+        "if h is not \"\" then set end of participantHandles to h",
+        "end repeat",
+        "end try",
+        "set AppleScript's text item delimiters to \",\"",
+        "set participantsText to participantHandles as text",
+        "set AppleScript's text item delimiters to \"\"",
+        "set end of rows to serviceTypeText & fs & chatIdText & fs & chatNameText & fs & participantsText",
+        "end repeat",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "end repeat",
+        "set AppleScript's text item delimiters to rs",
+        "set outText to rows as text",
+        "set AppleScript's text item delimiters to \"\"",
+        "return outText",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "MESSAGES");
+    const rows = parseSeparatedRows(output);
+    const q = query.toLowerCase();
+    const chats = rows
+        .map((parts) => {
+        const participants = (parts[3] ?? "")
+            .split(",")
+            .map((x) => x.trim())
+            .filter((x) => x.length > 0);
+        return {
+            serviceType: parts[0] ?? "",
+            chatId: parts[1] ?? "",
+            chatName: parts[2] ?? "",
+            participants,
+        };
+    })
+        .filter((chat) => {
+        const target = `${chat.chatName} ${chat.participants.join(" ")}`.toLowerCase();
+        return target.includes(q);
+    });
+    return {
+        result: {
+            query,
+            count: chats.length,
+            chats,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesFindChatsByParticipant",
+                summary: `Found ${chats.length} chats matching ${query}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesFindChatsByParticipant.js.map

package/dist/src/messages/messagesFindChatsByParticipant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesFindChatsByParticipant.js","sourceRoot":"","sources":["../../../src/messages/messagesFindChatsByParticipant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAAuC;IAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,gCAAgC;QAChC,gCAAgC;QAChC,gBAAgB;QAChB,YAAY;QACZ,mBAAmB,KAAK,EAAE;QAC1B,6BAA6B;QAC7B,6BAA6B;QAC7B,KAAK;QACL,sDAAsD;QACtD,SAAS;QACT,+BAA+B;QAC/B,4DAA4D;QAC5D,gBAAgB;QAChB,wBAAwB;QACxB,KAAK;QACL,qCAAqC;QACrC,SAAS;QACT,0BAA0B;QAC1B,KAAK;QACL,yCAAyC;QACzC,SAAS;QACT,8BAA8B;QAC9B,KAAK;QACL,oCAAoC;QACpC,eAAe;QACf,KAAK;QACL,gCAAgC;QAChC,SAAS;QACT,0DAA0D;QAC1D,YAAY;QACZ,SAAS;QACT,iDAAiD;QACjD,oDAAoD;QACpD,gDAAgD;QAChD,kGAAkG;QAClG,YAAY;QACZ,4DAA4D;QAC5D,YAAY;QACZ,8CAA8C;QAC9C,6BAA6B;QAC7B,gDAAgD;QAChD,gBAAgB;QAChB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAC3B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACtB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACxB,YAAY;SACb,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/E,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,MAAM,EAAE;YACN,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK;SACN;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,gCAAgC;gBACrC,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,mBAAmB,KAAK,EAAE;gBACxD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/messages/messagesListChats.d.ts

@@ -0,0 +1,25 @@
+/**
+ * List chats in macOS Messages app.
+ * @tool
+ * @effect none
+ */
+export declare function messagesListChats(args?: {
+    limit?: number;
+}): Promise<{
+    result: {
+        count: number;
+        chats: {
+            serviceType: string;
+            chatId: string;
+            chatName: string;
+            participantCount: number;
+        }[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesListChats.d.ts.map

package/dist/src/messages/messagesListChats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesListChats.d.ts","sourceRoot":"","sources":["../../../src/messages/messagesListChats.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;;;;;;;GAiEpE"}

package/dist/src/messages/messagesListChats.js

@@ -0,0 +1,69 @@
+import { parseSeparatedRows, runOsaScript, } from "../osascript/common.js";
+/**
+ * List chats in macOS Messages app.
+ * @tool
+ * @effect none
+ */
+export async function messagesListChats(args = {}) {
+    const limit = Math.max(1, Math.min(200, Math.trunc(args.limit ?? 30)));
+    const lines = [
+        'tell application "Messages"',
+        "set rs to (ASCII character 30)",
+        "set fs to (ASCII character 31)",
+        "set rows to {}",
+        `set maxCount to ${limit}`,
+        "set n to 0",
+        "repeat with svc in services",
+        "repeat with c in chats of svc",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "set n to n + 1",
+        "set serviceTypeText to \"\"",
+        "try",
+        "set serviceTypeText to (service type of svc) as text",
+        "end try",
+        "set chatIdText to \"\"",
+        "try",
+        "set chatIdText to (id of c) as text",
+        "end try",
+        "set chatNameText to \"\"",
+        "try",
+        "set chatNameText to (name of c) as text",
+        "end try",
+        "set participantCountText to \"0\"",
+        "try",
+        "set participantCountText to (count of participants of c) as text",
+        "end try",
+        "set end of rows to serviceTypeText & fs & chatIdText & fs & chatNameText & fs & participantCountText",
+        "end repeat",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "end repeat",
+        "set AppleScript's text item delimiters to rs",
+        "set outText to rows as text",
+        "set AppleScript's text item delimiters to \"\"",
+        "return outText",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "MESSAGES");
+    const rows = parseSeparatedRows(output);
+    const chats = rows.map((parts) => ({
+        serviceType: parts[0] ?? "",
+        chatId: parts[1] ?? "",
+        chatName: parts[2] ?? "",
+        participantCount: Number(parts[3] ?? "0") || 0,
+    }));
+    return {
+        result: {
+            count: chats.length,
+            chats,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesListChats",
+                summary: `Listed ${chats.length} chats from Messages`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesListChats.js.map

package/dist/src/messages/messagesListChats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesListChats.js","sourceRoot":"","sources":["../../../src/messages/messagesListChats.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B,EAAE;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,gCAAgC;QAChC,gCAAgC;QAChC,gBAAgB;QAChB,mBAAmB,KAAK,EAAE;QAC1B,YAAY;QACZ,6BAA6B;QAC7B,+BAA+B;QAC/B,4DAA4D;QAC5D,gBAAgB;QAChB,6BAA6B;QAC7B,KAAK;QACL,sDAAsD;QACtD,SAAS;QACT,wBAAwB;QACxB,KAAK;QACL,qCAAqC;QACrC,SAAS;QACT,0BAA0B;QAC1B,KAAK;QACL,yCAAyC;QACzC,SAAS;QACT,mCAAmC;QACnC,KAAK;QACL,kEAAkE;QAClE,SAAS;QACT,sGAAsG;QACtG,YAAY;QACZ,4DAA4D;QAC5D,YAAY;QACZ,8CAA8C;QAC9C,6BAA6B;QAC7B,gDAAgD;QAChD,gBAAgB;QAChB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACxB,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;KAC/C,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK;SACN;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,mBAAmB;gBACxB,OAAO,EAAE,UAAU,KAAK,CAAC,MAAM,sBAAsB;gBACrD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/messages/messagesReadChat.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Read recent messages from a specific Messages chat id.
+ * You can get chatId via messagesListChats.
+ * @tool
+ * @effect none
+ */
+export declare function messagesReadChat(args: {
+    chatId: string;
+    limit?: number;
+}): Promise<{
+    result: {
+        chatId: string;
+        count: number;
+        messages: {
+            sender: string;
+            text: string;
+            timeSentText: string;
+            fromMe: boolean;
+        }[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesReadChat.d.ts.map

package/dist/src/messages/messagesReadChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesReadChat.d.ts","sourceRoot":"","sources":["../../../src/messages/messagesReadChat.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;GAkF9E"}