@botbotgo/kit-builtin 0.0.92

package/dist/src/messages/messagesReadChat.js

@@ -0,0 +1,88 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { parseSeparatedRows, quoteAppleScriptString, runOsaScript, } from "../osascript/common.js";
+/**
+ * Read recent messages from a specific Messages chat id.
+ * You can get chatId via messagesListChats.
+ * @tool
+ * @effect none
+ */
+export async function messagesReadChat(args) {
+    const chatId = args.chatId?.trim();
+    if (!chatId) {
+        throw createTaggedError("MESSAGES_INVALID", "chatId is required", {});
+    }
+    const limit = Math.max(1, Math.min(200, Math.trunc(args.limit ?? 20)));
+    const lines = [
+        'tell application "Messages"',
+        "set rs to (ASCII character 30)",
+        "set fs to (ASCII character 31)",
+        `set wantedChatId to ${quoteAppleScriptString(chatId)}`,
+        "repeat with svc in services",
+        "repeat with c in chats of svc",
+        "set cid to \"\"",
+        "try",
+        "set cid to (id of c) as text",
+        "end try",
+        "if cid is wantedChatId then",
+        "set totalCount to 0",
+        "try",
+        "set totalCount to count of messages of c",
+        "end try",
+        "set startIndex to totalCount - " + (limit - 1) + "",
+        "if startIndex < 1 then set startIndex to 1",
+        "set rows to {}",
+        "repeat with i from startIndex to totalCount",
+        "set m to item i of (messages of c)",
+        "set senderText to \"\"",
+        "try",
+        "set senderText to sender of m as text",
+        "end try",
+        "set bodyText to \"\"",
+        "try",
+        "set bodyText to text of m",
+        "end try",
+        "set dateText to \"\"",
+        "try",
+        "set dateText to (|time sent| of m) as text",
+        "end try",
+        "set fromMeText to \"\"",
+        "try",
+        "set fromMeText to (|from me| of m) as text",
+        "end try",
+        "set end of rows to senderText & fs & bodyText & fs & dateText & fs & fromMeText",
+        "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 if",
+        "end repeat",
+        "end repeat",
+        'error "Chat not found: " & wantedChatId',
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "MESSAGES");
+    const rows = parseSeparatedRows(output);
+    const messages = rows.map((parts) => ({
+        sender: parts[0] ?? "",
+        text: parts[1] ?? "",
+        timeSentText: parts[2] ?? "",
+        fromMe: (parts[3] ?? "").toLowerCase() === "true",
+    }));
+    return {
+        result: {
+            chatId,
+            count: messages.length,
+            messages,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesReadChat",
+                summary: `Read ${messages.length} messages from chat ${chatId}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesReadChat.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesReadChat.js","sourceRoot":"","sources":["../../../src/messages/messagesReadChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAwC;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,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,uBAAuB,sBAAsB,CAAC,MAAM,CAAC,EAAE;QACvD,6BAA6B;QAC7B,+BAA+B;QAC/B,iBAAiB;QACjB,KAAK;QACL,8BAA8B;QAC9B,SAAS;QACT,6BAA6B;QAC7B,qBAAqB;QACrB,KAAK;QACL,0CAA0C;QAC1C,SAAS;QACT,iCAAiC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE;QACpD,4CAA4C;QAC5C,gBAAgB;QAChB,6CAA6C;QAC7C,oCAAoC;QACpC,wBAAwB;QACxB,KAAK;QACL,uCAAuC;QACvC,SAAS;QACT,sBAAsB;QACtB,KAAK;QACL,2BAA2B;QAC3B,SAAS;QACT,sBAAsB;QACtB,KAAK;QACL,4CAA4C;QAC5C,SAAS;QACT,wBAAwB;QACxB,KAAK;QACL,4CAA4C;QAC5C,SAAS;QACT,iFAAiF;QACjF,YAAY;QACZ,8CAA8C;QAC9C,6BAA6B;QAC7B,gDAAgD;QAChD,gBAAgB;QAChB,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,yCAAyC;QACzC,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,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACpB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAC5B,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;KAClD,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE;YACN,MAAM;YACN,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ;SACT;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,kBAAkB;gBACvB,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,uBAAuB,MAAM,EAAE;gBAC/D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Send a message to a specific Messages chat by chat id.
+ * @tool
+ * @effect local_write
+ */
+export declare function messagesSendByChatId(args: {
+    chatId: string;
+    text: string;
+}): Promise<{
+    result: {
+        chatId: string;
+        text: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesSendByChatId.d.ts.map

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

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

package/dist/src/messages/messagesSendByChatId.js

@@ -0,0 +1,48 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Send a message to a specific Messages chat by chat id.
+ * @tool
+ * @effect local_write
+ */
+export async function messagesSendByChatId(args) {
+    const chatId = args.chatId?.trim();
+    const text = args.text?.trim();
+    if (!chatId)
+        throw createTaggedError("MESSAGES_INVALID", "chatId is required", {});
+    if (!text)
+        throw createTaggedError("MESSAGES_INVALID", "text is required", {});
+    const lines = [
+        'tell application "Messages"',
+        `set wantedChatId to ${quoteAppleScriptString(chatId)}`,
+        `set messageBody to ${quoteAppleScriptString(text)}`,
+        "set targetChat to missing value",
+        "repeat with svc in services",
+        "try",
+        "set targetChat to first chat of svc whose (id as text) is wantedChatId",
+        "exit repeat",
+        "end try",
+        "end repeat",
+        'if targetChat is missing value then error "Chat not found: " & wantedChatId',
+        "send messageBody to targetChat",
+        'return "sent"',
+        "end tell",
+    ];
+    const status = await runOsaScript(lines, "MESSAGES");
+    return {
+        result: {
+            chatId,
+            text,
+            status: status || "sent",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesSendByChatId",
+                summary: `Sent message to chat ${chatId}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesSendByChatId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesSendByChatId.js","sourceRoot":"","sources":["../../../src/messages/messagesSendByChatId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAsC;IAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,IAAI;QAAE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAE/E,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,uBAAuB,sBAAsB,CAAC,MAAM,CAAC,EAAE;QACvD,sBAAsB,sBAAsB,CAAC,IAAI,CAAC,EAAE;QACpD,iCAAiC;QACjC,6BAA6B;QAC7B,KAAK;QACL,wEAAwE;QACxE,aAAa;QACb,SAAS;QACT,YAAY;QACZ,6EAA6E;QAC7E,gCAAgC;QAChC,eAAe;QACf,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAErD,OAAO;QACL,MAAM,EAAE;YACN,MAAM;YACN,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,MAAM;SACzB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,sBAAsB;gBAC3B,OAAO,EAAE,wBAAwB,MAAM,EAAE;gBACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Send a message by handle (phone/email) via macOS Messages.
+ * Use this when you know the exact recipient handle.
+ * @tool
+ * @effect local_write
+ */
+export declare function messagesSendByHandle(args: {
+    to: string;
+    text: string;
+    serviceType?: "iMessage" | "SMS";
+}): Promise<{
+    result: {
+        to: string;
+        text: string;
+        serviceType: "iMessage" | "SMS";
+        deliveryTarget: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesSendByHandle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesSendByHandle.d.ts","sourceRoot":"","sources":["../../../src/messages/messagesSendByHandle.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAClC;;;;;;;;;;;;;;GAqDA"}

package/dist/src/messages/messagesSendByHandle.js

@@ -0,0 +1,67 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+function normalizeServiceType(input) {
+    const raw = (input ?? "iMessage").trim().toLowerCase();
+    if (raw === "imessage")
+        return "iMessage";
+    if (raw === "sms")
+        return "SMS";
+    throw createTaggedError("MESSAGES_INVALID", "serviceType must be one of: iMessage, SMS", { serviceType: input ?? null });
+}
+/**
+ * Send a message by handle (phone/email) via macOS Messages.
+ * Use this when you know the exact recipient handle.
+ * @tool
+ * @effect local_write
+ */
+export async function messagesSendByHandle(args) {
+    const to = args.to?.trim();
+    const text = args.text?.trim();
+    if (!to) {
+        throw createTaggedError("MESSAGES_INVALID", "to is required", {});
+    }
+    if (!text) {
+        throw createTaggedError("MESSAGES_INVALID", "text is required", {});
+    }
+    const serviceType = normalizeServiceType(args.serviceType);
+    const serviceScriptValue = serviceType === "SMS" ? "SMS" : "iMessage";
+    const lines = [
+        'tell application "Messages"',
+        `set targetService to first service whose service type = ${serviceScriptValue}`,
+        `set targetHandle to ${quoteAppleScriptString(to)}`,
+        `set messageBody to ${quoteAppleScriptString(text)}`,
+        "try",
+        "set targetBuddy to buddy targetHandle of targetService",
+        "send messageBody to targetBuddy",
+        'return "buddy"',
+        "on error",
+        "try",
+        "set targetParticipant to participant targetHandle of targetService",
+        "send messageBody to targetParticipant",
+        'return "participant"',
+        "on error errMsg number errNum",
+        'error "Unable to send message to " & targetHandle & ": " & errMsg number errNum',
+        "end try",
+        "end try",
+        "end tell",
+    ];
+    const deliveryTarget = await runOsaScript(lines, "MESSAGES");
+    return {
+        result: {
+            to,
+            text,
+            serviceType,
+            deliveryTarget: deliveryTarget || "unknown",
+            status: "sent",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesSendByHandle",
+                summary: `Sent ${serviceType} message to ${to}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesSendByHandle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesSendByHandle.js","sourceRoot":"","sources":["../../../src/messages/messagesSendByHandle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,SAAS,oBAAoB,CAAC,KAAc;IAC1C,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvD,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC1C,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,iBAAiB,CACrB,kBAAkB,EAClB,2CAA2C,EAC3C,EAAE,WAAW,EAAE,KAAK,IAAI,IAAI,EAAE,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAI1C;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,kBAAkB,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IAEtE,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,2DAA2D,kBAAkB,EAAE;QAC/E,uBAAuB,sBAAsB,CAAC,EAAE,CAAC,EAAE;QACnD,sBAAsB,sBAAsB,CAAC,IAAI,CAAC,EAAE;QACpD,KAAK;QACL,wDAAwD;QACxD,iCAAiC;QACjC,gBAAgB;QAChB,UAAU;QACV,KAAK;QACL,oEAAoE;QACpE,uCAAuC;QACvC,sBAAsB;QACtB,+BAA+B;QAC/B,iFAAiF;QACjF,SAAS;QACT,SAAS;QACT,UAAU;KACX,CAAC;IAEF,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE;YACN,EAAE;YACF,IAAI;YACJ,WAAW;YACX,cAAc,EAAE,cAAc,IAAI,SAAS;YAC3C,MAAM,EAAE,MAAM;SACf;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,sBAAsB;gBAC3B,OAAO,EAAE,QAAQ,WAAW,eAAe,EAAE,EAAE;gBAC/C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Find the first chat matching participant query and send a message.
+ * @tool
+ * @effect local_write
+ */
+export declare function messagesSendByParticipantQuery(args: {
+    participantQuery: string;
+    text: string;
+    serviceType?: "iMessage" | "SMS";
+}): Promise<{
+    result: {
+        participantQuery: string;
+        text: string;
+        serviceType: string;
+        chatId: string;
+        chatName: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=messagesSendByParticipantQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesSendByParticipantQuery.d.ts","sourceRoot":"","sources":["../../../src/messages/messagesSendByParticipantQuery.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAClC;;;;;;;;;;;;;;;GAwFA"}

package/dist/src/messages/messagesSendByParticipantQuery.js

@@ -0,0 +1,93 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Find the first chat matching participant query and send a message.
+ * @tool
+ * @effect local_write
+ */
+export async function messagesSendByParticipantQuery(args) {
+    const participantQuery = args.participantQuery?.trim();
+    const text = args.text?.trim();
+    if (!participantQuery) {
+        throw createTaggedError("MESSAGES_INVALID", "participantQuery is required", {});
+    }
+    if (!text) {
+        throw createTaggedError("MESSAGES_INVALID", "text is required", {});
+    }
+    const serviceType = (args.serviceType ?? "iMessage").trim().toLowerCase();
+    if (serviceType !== "imessage" && serviceType !== "sms") {
+        throw createTaggedError("MESSAGES_INVALID", "serviceType must be iMessage or SMS", {
+            serviceType: args.serviceType ?? null,
+        });
+    }
+    const serviceScriptValue = serviceType === "sms" ? "SMS" : "iMessage";
+    const lines = [
+        'tell application "Messages"',
+        `set q to ${quoteAppleScriptString(participantQuery.toLowerCase())}`,
+        `set bodyText to ${quoteAppleScriptString(text)}`,
+        "set targetChat to missing value",
+        "set matchedChatId to \"\"",
+        "set matchedChatName to \"\"",
+        `set targetService to first service whose service type = ${serviceScriptValue}`,
+        "repeat with c in chats of targetService",
+        "set cName to \"\"",
+        "try",
+        "set cName to (name of c) as text",
+        "end try",
+        "set hit to false",
+        "if (cName is not \"\") then",
+        "if ((cName as lowercase) contains q) then set hit to true",
+        "end if",
+        "if hit is false then",
+        "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",
+        "if ((h as lowercase) contains q) then",
+        "set hit to true",
+        "exit repeat",
+        "end if",
+        "end if",
+        "end repeat",
+        "end try",
+        "end if",
+        "if hit then",
+        "set targetChat to c",
+        "try",
+        "set matchedChatId to (id of c) as text",
+        "end try",
+        "set matchedChatName to cName",
+        "exit repeat",
+        "end if",
+        "end repeat",
+        'if targetChat is missing value then error "No chat found for participant query: " & q',
+        "send bodyText to targetChat",
+        "set fs to (ASCII character 31)",
+        "return matchedChatId & fs & matchedChatName",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "MESSAGES");
+    const [chatId = "", chatName = ""] = output.split("\x1f");
+    return {
+        result: {
+            participantQuery,
+            text,
+            serviceType: serviceType === "sms" ? "SMS" : "iMessage",
+            chatId,
+            chatName,
+            status: "sent",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "messagesSendByParticipantQuery",
+                summary: `Sent message to query ${participantQuery}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=messagesSendByParticipantQuery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messagesSendByParticipantQuery.js","sourceRoot":"","sources":["../../../src/messages/messagesSendByParticipantQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAIpD;IACC,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1E,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QACxD,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,qCAAqC,EAAE;YACjF,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;SACtC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,kBAAkB,GAAG,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IAEtE,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,YAAY,sBAAsB,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,EAAE;QACpE,mBAAmB,sBAAsB,CAAC,IAAI,CAAC,EAAE;QACjD,iCAAiC;QACjC,2BAA2B;QAC3B,6BAA6B;QAC7B,2DAA2D,kBAAkB,EAAE;QAC/E,yCAAyC;QACzC,mBAAmB;QACnB,KAAK;QACL,kCAAkC;QAClC,SAAS;QACT,kBAAkB;QAClB,6BAA6B;QAC7B,2DAA2D;QAC3D,QAAQ;QACR,sBAAsB;QACtB,KAAK;QACL,oCAAoC;QACpC,eAAe;QACf,KAAK;QACL,gCAAgC;QAChC,SAAS;QACT,yBAAyB;QACzB,uCAAuC;QACvC,iBAAiB;QACjB,aAAa;QACb,QAAQ;QACR,QAAQ;QACR,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,aAAa;QACb,qBAAqB;QACrB,KAAK;QACL,wCAAwC;QACxC,SAAS;QACT,8BAA8B;QAC9B,aAAa;QACb,QAAQ;QACR,YAAY;QACZ,uFAAuF;QACvF,6BAA6B;QAC7B,gCAAgC;QAChC,6CAA6C;QAC7C,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1D,OAAO;QACL,MAAM,EAAE;YACN,gBAAgB;YAChB,IAAI;YACJ,WAAW,EAAE,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU;YACvD,MAAM;YACN,QAAQ;YACR,MAAM,EAAE,MAAM;SACf;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,gCAAgC;gBACrC,OAAO,EAAE,yBAAyB,gBAAgB,EAAE;gBACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/notes/notesCreate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Create a note in macOS Notes.
+ * @tool
+ * @effect local_write
+ */
+export declare function notesCreate(args: {
+    title: string;
+    body: string;
+    folder?: string;
+}): Promise<{
+    result: {
+        id: string;
+        title: string;
+        folder: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=notesCreate.d.ts.map

package/dist/src/notes/notesCreate.d.ts.map

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

package/dist/src/notes/notesCreate.js

@@ -0,0 +1,56 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { parseSeparatedRows, quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Create a note in macOS Notes.
+ * @tool
+ * @effect local_write
+ */
+export async function notesCreate(args) {
+    const title = args.title?.trim();
+    const body = args.body?.trim();
+    const folder = args.folder?.trim() || "Notes";
+    if (!title)
+        throw createTaggedError("NOTES_INVALID", "title is required", {});
+    if (!body)
+        throw createTaggedError("NOTES_INVALID", "body is required", {});
+    const lines = [
+        'tell application "Notes"',
+        `set folderNameText to ${quoteAppleScriptString(folder)}`,
+        `set noteTitleText to ${quoteAppleScriptString(title)}`,
+        `set noteBodyText to ${quoteAppleScriptString(body)}`,
+        "set targetFolder to missing value",
+        "try",
+        "set targetFolder to folder folderNameText",
+        "on error",
+        "set targetFolder to make new folder with properties {name:folderNameText}",
+        "end try",
+        "tell targetFolder",
+        "set newNote to make new note with properties {name:noteTitleText, body:noteBodyText}",
+        "set noteIdText to \"\"",
+        "try",
+        "set noteIdText to (id of newNote) as text",
+        "end try",
+        "set outText to noteIdText & (ASCII character 31) & noteTitleText & (ASCII character 31) & folderNameText",
+        "end tell",
+        "return outText",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "NOTES");
+    const row = parseSeparatedRows(output)[0] ?? [];
+    return {
+        result: {
+            id: row[0] ?? "",
+            title: row[1] ?? title,
+            folder: row[2] ?? folder,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "notesCreate",
+                summary: `Created note \"${title}\" in folder \"${folder}\"`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=notesCreate.js.map

package/dist/src/notes/notesCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notesCreate.js","sourceRoot":"","sources":["../../../src/notes/notesCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAElG;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAsD;IACtF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;IAE9C,IAAI,CAAC,KAAK;QAAE,MAAM,iBAAiB,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,IAAI;QAAE,MAAM,iBAAiB,CAAC,eAAe,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG;QACZ,0BAA0B;QAC1B,yBAAyB,sBAAsB,CAAC,MAAM,CAAC,EAAE;QACzD,wBAAwB,sBAAsB,CAAC,KAAK,CAAC,EAAE;QACvD,uBAAuB,sBAAsB,CAAC,IAAI,CAAC,EAAE;QACrD,mCAAmC;QACnC,KAAK;QACL,2CAA2C;QAC3C,UAAU;QACV,2EAA2E;QAC3E,SAAS;QACT,mBAAmB;QACnB,sFAAsF;QACtF,wBAAwB;QACxB,KAAK;QACL,2CAA2C;QAC3C,SAAS;QACT,0GAA0G;QAC1G,UAAU;QACV,gBAAgB;QAChB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YAChB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;YACtB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM;SACzB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,aAAa;gBAClB,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,MAAM,IAAI;gBAC5D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/notes/notesDelete.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Delete a note by id or title in macOS Notes.
+ * @tool
+ * @effect destructive
+ */
+export declare function notesDelete(args: {
+    noteRef: string;
+}): Promise<{
+    result: {
+        noteRef: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=notesDelete.d.ts.map

package/dist/src/notes/notesDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notesDelete.d.ts","sourceRoot":"","sources":["../../../src/notes/notesDelete.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;GAmD1D"}

package/dist/src/notes/notesDelete.js

@@ -0,0 +1,58 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Delete a note by id or title in macOS Notes.
+ * @tool
+ * @effect destructive
+ */
+export async function notesDelete(args) {
+    const noteRef = args.noteRef?.trim();
+    if (!noteRef)
+        throw createTaggedError("NOTES_INVALID", "noteRef is required", {});
+    const lines = [
+        'tell application "Notes"',
+        `set wanted to ${quoteAppleScriptString(noteRef)}`,
+        "set targetNote to missing value",
+        "repeat with f in folders",
+        "try",
+        "set noteCount to count of notes of f",
+        "repeat with i from 1 to noteCount",
+        "set nt to item i of notes of f",
+        "set nid to \"\"",
+        "try",
+        "set nid to (id of nt) as text",
+        "end try",
+        "set nname to \"\"",
+        "try",
+        "set nname to (name of nt) as text",
+        "end try",
+        "if nid is wanted or nname is wanted then",
+        "set targetNote to nt",
+        "exit repeat",
+        "end if",
+        "end repeat",
+        "end try",
+        "if targetNote is not missing value then exit repeat",
+        "end repeat",
+        'if targetNote is missing value then error "Note not found: " & wanted',
+        "delete targetNote",
+        'return "deleted"',
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "NOTES");
+    return {
+        result: {
+            noteRef,
+            status: output || "deleted",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "notesDelete",
+                summary: `Deleted note ${noteRef}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=notesDelete.js.map

package/dist/src/notes/notesDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notesDelete.js","sourceRoot":"","sources":["../../../src/notes/notesDelete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAyB;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,MAAM,iBAAiB,CAAC,eAAe,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAElF,MAAM,KAAK,GAAG;QACZ,0BAA0B;QAC1B,iBAAiB,sBAAsB,CAAC,OAAO,CAAC,EAAE;QAClD,iCAAiC;QACjC,0BAA0B;QAC1B,KAAK;QACL,sCAAsC;QACtC,mCAAmC;QACnC,gCAAgC;QAChC,iBAAiB;QACjB,KAAK;QACL,+BAA+B;QAC/B,SAAS;QACT,mBAAmB;QACnB,KAAK;QACL,mCAAmC;QACnC,SAAS;QACT,0CAA0C;QAC1C,sBAAsB;QACtB,aAAa;QACb,QAAQ;QACR,YAAY;QACZ,SAAS;QACT,qDAAqD;QACrD,YAAY;QACZ,uEAAuE;QACvE,mBAAmB;QACnB,kBAAkB;QAClB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAElD,OAAO;QACL,MAAM,EAAE;YACN,OAAO;YACP,MAAM,EAAE,MAAM,IAAI,SAAS;SAC5B;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,aAAa;gBAClB,OAAO,EAAE,gBAAgB,OAAO,EAAE;gBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/notes/notesList.d.ts

@@ -0,0 +1,26 @@
+/**
+ * List notes from macOS Notes.
+ * @tool
+ * @effect none
+ */
+export declare function notesList(args?: {
+    folder?: string;
+    limit?: number;
+}): Promise<{
+    result: {
+        count: number;
+        notes: {
+            id: string;
+            title: string;
+            folder: string;
+            modificationDateText: string;
+        }[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=notesList.d.ts.map

package/dist/src/notes/notesList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notesList.d.ts","sourceRoot":"","sources":["../../../src/notes/notesList.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;;;;;;;;;;;;GA2E7E"}