@botbotgo/kit-builtin 0.0.92

package/dist/src/safari/safariGetActiveTab.js

@@ -0,0 +1,34 @@
+import { parseSeparatedRows, runOsaScript } from "../osascript/common.js";
+/**
+ * Canonical name for reading Safari active tab metadata.
+ * @tool
+ * @effect none
+ */
+export async function safariGetActiveTab(_ = {}) {
+    const lines = [
+        'tell application "Safari"',
+        'if (count of windows) is 0 then error "Safari has no open windows"',
+        "set fs to (ASCII character 31)",
+        "set u to URL of current tab of front window",
+        "set t to name of current tab of front window",
+        "return t & fs & u",
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "SAFARI");
+    const row = parseSeparatedRows(output)[0] ?? output.split("\x1f");
+    return {
+        result: {
+            title: row[0] ?? "",
+            url: row[1] ?? "",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "safariGetActiveTab",
+                summary: "Fetched Safari active tab info",
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=safariGetActiveTab.js.map

package/dist/src/safari/safariGetActiveTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariGetActiveTab.js","sourceRoot":"","sources":["../../../src/safari/safariGetActiveTab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAQ,EAAE;IACjD,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,oEAAoE;QACpE,gCAAgC;QAChC,6CAA6C;QAC7C,8CAA8C;QAC9C,mBAAmB;QACnB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElE,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YACnB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;SAClB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,oBAAoB;gBACzB,OAAO,EAAE,gCAAgC;gBACzC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/safari/safariListTabs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * List tabs in Safari windows.
+ * @tool
+ * @effect none
+ */
+export declare function safariListTabs(args?: {
+    windowIndex?: number;
+    limit?: number;
+}): Promise<{
+    result: {
+        count: number;
+        tabs: {
+            windowIndex: number;
+            tabIndex: number;
+            title: string;
+            url: string;
+        }[];
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=safariListTabs.d.ts.map

package/dist/src/safari/safariListTabs.d.ts.map

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

package/dist/src/safari/safariListTabs.js

@@ -0,0 +1,71 @@
+import { parseSeparatedRows, runOsaScript } from "../osascript/common.js";
+/**
+ * List tabs in Safari windows.
+ * @tool
+ * @effect none
+ */
+export async function safariListTabs(args = {}) {
+    const windowIndex = args.windowIndex != null ? Math.max(1, Math.trunc(args.windowIndex)) : null;
+    const limit = Math.max(1, Math.min(500, Math.trunc(args.limit ?? 100)));
+    const lines = [
+        'tell application "Safari"',
+        'if (count of windows) is 0 then return ""',
+        "set rs to (ASCII character 30)",
+        "set fs to (ASCII character 31)",
+        "set rows to {}",
+        "set n to 0",
+        `set maxCount to ${limit}`,
+        ...(windowIndex
+            ? [
+                `set sourceWindows to {window ${windowIndex}}`,
+            ]
+            : ["set sourceWindows to windows"]),
+        "repeat with w in sourceWindows",
+        "set wIdx to index of w",
+        "set tIdx to 0",
+        "repeat with tb in tabs of w",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "set n to n + 1",
+        "set tIdx to tIdx + 1",
+        "set titleText to \"\"",
+        "try",
+        "set titleText to (name of tb) as text",
+        "end try",
+        "set urlText to \"\"",
+        "try",
+        "set urlText to (URL of tb) as text",
+        "end try",
+        "set end of rows to (wIdx as text) & fs & (tIdx as text) & fs & titleText & fs & urlText",
+        "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, "SAFARI");
+    const rows = parseSeparatedRows(output);
+    const tabs = rows.map((parts) => ({
+        windowIndex: Number(parts[0] ?? "0") || 0,
+        tabIndex: Number(parts[1] ?? "0") || 0,
+        title: parts[2] ?? "",
+        url: parts[3] ?? "",
+    }));
+    return {
+        result: {
+            count: tabs.length,
+            tabs,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "safariListTabs",
+                summary: `Listed ${tabs.length} Safari tabs`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=safariListTabs.js.map

package/dist/src/safari/safariListTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariListTabs.js","sourceRoot":"","sources":["../../../src/safari/safariListTabs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAiD,EAAE;IACtF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChG,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,2BAA2B;QAC3B,2CAA2C;QAC3C,gCAAgC;QAChC,gCAAgC;QAChC,gBAAgB;QAChB,YAAY;QACZ,mBAAmB,KAAK,EAAE;QAC1B,GAAG,CAAC,WAAW;YACb,CAAC,CAAC;gBACE,gCAAgC,WAAW,GAAG;aAC/C;YACH,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACrC,gCAAgC;QAChC,wBAAwB;QACxB,eAAe;QACf,6BAA6B;QAC7B,4DAA4D;QAC5D,gBAAgB;QAChB,sBAAsB;QACtB,uBAAuB;QACvB,KAAK;QACL,uCAAuC;QACvC,SAAS;QACT,qBAAqB;QACrB,KAAK;QACL,oCAAoC;QACpC,SAAS;QACT,yFAAyF;QACzF,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,QAAQ,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QACzC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACrB,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;KACpB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,IAAI;SACL;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,gBAAgB;gBACrB,OAAO,EAAE,UAAU,IAAI,CAAC,MAAM,cAAc;gBAC5C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/safari/safariOpenWebUrl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Open a web URL in Safari.
+ * @tool
+ * @effect local_write
+ */
+export declare function safariOpenWebUrl(args: {
+    url: string;
+    newTab?: boolean;
+}): Promise<{
+    result: {
+        url: string;
+        newTab: boolean;
+        title: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=safariOpenWebUrl.d.ts.map

package/dist/src/safari/safariOpenWebUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariOpenWebUrl.d.ts","sourceRoot":"","sources":["../../../src/safari/safariOpenWebUrl.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;GA0C7E"}

package/dist/src/safari/safariOpenWebUrl.js

@@ -0,0 +1,49 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Open a web URL in Safari.
+ * @tool
+ * @effect local_write
+ */
+export async function safariOpenWebUrl(args) {
+    const url = args.url?.trim();
+    if (!url)
+        throw createTaggedError("SAFARI_INVALID", "url is required", {});
+    const newTab = Boolean(args.newTab ?? true);
+    const lines = [
+        'tell application "Safari"',
+        "activate",
+        'if (count of windows) is 0 then make new document with properties {URL:"about:blank"}',
+        ...(newTab
+            ? [
+                "tell front window",
+                "set newTabRef to make new tab with properties {URL:" + quoteAppleScriptString(url) + "}",
+                "set current tab to newTabRef",
+                "end tell",
+            ]
+            : ["set URL of current tab of front window to " + quoteAppleScriptString(url)]),
+        "set outTitle to \"\"",
+        "try",
+        "set outTitle to (name of current tab of front window) as text",
+        "end try",
+        "return outTitle",
+        "end tell",
+    ];
+    const title = await runOsaScript(lines, "SAFARI");
+    return {
+        result: {
+            url,
+            newTab,
+            title,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "safariOpenWebUrl",
+                summary: `Opened URL in Safari: ${url}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=safariOpenWebUrl.js.map

package/dist/src/safari/safariOpenWebUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariOpenWebUrl.js","sourceRoot":"","sources":["../../../src/safari/safariOpenWebUrl.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,gBAAgB,CAAC,IAAuC;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,MAAM,iBAAiB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,UAAU;QACV,uFAAuF;QACvF,GAAG,CAAC,MAAM;YACR,CAAC,CAAC;gBACE,mBAAmB;gBACnB,qDAAqD,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,GAAG;gBACzF,8BAA8B;gBAC9B,UAAU;aACX;YACH,CAAC,CAAC,CAAC,4CAA4C,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;QACjF,sBAAsB;QACtB,KAAK;QACL,+DAA+D;QAC/D,SAAS;QACT,iBAAiB;QACjB,UAAU;KACX,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAElD,OAAO;QACL,MAAM,EAAE;YACN,GAAG;YACH,MAAM;YACN,KAAK;SACN;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,kBAAkB;gBACvB,OAAO,EAAE,yBAAyB,GAAG,EAAE;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/safari/safariReadPageContent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Read Safari page main content from front tab or a specified tab.
+ * @tool
+ * @effect none
+ */
+export declare function safariReadPageContent(args?: {
+    windowIndex?: number;
+    tabIndex?: number;
+    maxChars?: number;
+    timeoutMs?: number;
+    maxBytes?: number;
+}): Promise<{
+    result: {
+        url: string;
+        tabTitle: string;
+        pageTitle: string | null;
+        status: number;
+        isHtml: boolean;
+        bytes: number;
+        mainContent: string;
+        truncated: boolean;
+        maxChars: number;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=safariReadPageContent.d.ts.map

package/dist/src/safari/safariReadPageContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariReadPageContent.d.ts","sourceRoot":"","sources":["../../../src/safari/safariReadPageContent.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,GAAE;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;GAmEL"}

package/dist/src/safari/safariReadPageContent.js

@@ -0,0 +1,69 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { runOsaScript } from "../osascript/common.js";
+import { fetchPageMainContent } from "../http/fetchPageMainContent.js";
+/**
+ * Read Safari page main content from front tab or a specified tab.
+ * @tool
+ * @effect none
+ */
+export async function safariReadPageContent(args = {}) {
+    const maxChars = Math.max(200, Math.min(200000, Math.trunc(args.maxChars ?? 12000)));
+    const useSpecificTab = typeof args.windowIndex === "number" && Number.isFinite(args.windowIndex) &&
+        typeof args.tabIndex === "number" && Number.isFinite(args.tabIndex);
+    const lines = useSpecificTab
+        ? [
+            'tell application "Safari"',
+            'if (count of windows) is 0 then error "Safari has no open windows"',
+            `set w to window ${Math.max(1, Math.trunc(args.windowIndex ?? 1))}`,
+            `set t to tab ${Math.max(1, Math.trunc(args.tabIndex ?? 1))} of w`,
+            "set fs to (ASCII character 31)",
+            "set pageTitle to (name of t) as text",
+            "set pageUrl to (URL of t) as text",
+            "return pageTitle & fs & pageUrl",
+            "end tell",
+        ]
+        : [
+            'tell application "Safari"',
+            'if (count of windows) is 0 then error "Safari has no open windows"',
+            "set fs to (ASCII character 31)",
+            "set pageTitle to (name of current tab of front window) as text",
+            "set pageUrl to (URL of current tab of front window) as text",
+            "return pageTitle & fs & pageUrl",
+            "end tell",
+        ];
+    const output = await runOsaScript(lines, "SAFARI");
+    const [tabTitle = "", url = ""] = output.split("\x1f");
+    if (!url.trim()) {
+        throw createTaggedError("SAFARI_INVALID", "Cannot read URL from Safari tab", {});
+    }
+    const page = await fetchPageMainContent({
+        url,
+        timeoutMs: args.timeoutMs,
+        maxBytes: args.maxBytes,
+    });
+    const mainContent = (page.result.mainContent ?? "");
+    const truncatedContent = mainContent.length > maxChars ? `${mainContent.slice(0, maxChars)}...` : mainContent;
+    return {
+        result: {
+            url,
+            tabTitle,
+            pageTitle: page.result.title ?? null,
+            status: page.result.status,
+            isHtml: page.result.isHtml,
+            bytes: page.result.bytes,
+            mainContent: truncatedContent,
+            truncated: mainContent.length > maxChars,
+            maxChars,
+        },
+        evidence: [
+            ...(Array.isArray(page.evidence) ? page.evidence : []),
+            {
+                type: "tool",
+                ref: "safariReadPageContent",
+                summary: `Read Safari page content from ${url}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=safariReadPageContent.js.map

package/dist/src/safari/safariReadPageContent.js.map

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

package/dist/src/safari/safariReadSelection.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Read selected text from Safari page (front tab by default).
+ * @tool
+ * @effect none
+ */
+export declare function safariReadSelection(args?: {
+    windowIndex?: number;
+    tabIndex?: number;
+    maxChars?: number;
+}): Promise<{
+    result: {
+        title: string;
+        url: string;
+        hasSelection: boolean;
+        selection: string;
+        truncated: boolean;
+        maxChars: number;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=safariReadSelection.d.ts.map

package/dist/src/safari/safariReadSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safariReadSelection.d.ts","sourceRoot":"","sources":["../../../src/safari/safariReadSelection.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,GAAE;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;GA6EL"}

package/dist/src/safari/safariReadSelection.js

@@ -0,0 +1,75 @@
+import { runOsaScript } from "../osascript/common.js";
+/**
+ * Read selected text from Safari page (front tab by default).
+ * @tool
+ * @effect none
+ */
+export async function safariReadSelection(args = {}) {
+    const windowIndex = typeof args.windowIndex === "number" && Number.isFinite(args.windowIndex)
+        ? Math.max(1, Math.trunc(args.windowIndex))
+        : null;
+    const tabIndex = typeof args.tabIndex === "number" && Number.isFinite(args.tabIndex)
+        ? Math.max(1, Math.trunc(args.tabIndex))
+        : null;
+    const maxChars = Math.max(50, Math.min(200000, Math.trunc(args.maxChars ?? 20000)));
+    const jsExpr = "(function(){" +
+        "var t='';" +
+        "try{t=String(window.getSelection?window.getSelection().toString():'');}catch(e){}" +
+        "return t || '';" +
+        "})()";
+    const lines = windowIndex != null && tabIndex != null
+        ? [
+            'tell application "Safari"',
+            'if (count of windows) is 0 then error "Safari has no open windows"',
+            `set w to window ${windowIndex}`,
+            `set t to tab ${tabIndex} of w`,
+            "set fs to (ASCII character 31)",
+            "set titleText to (name of t) as text",
+            "set urlText to (URL of t) as text",
+            "set selText to \"\"",
+            "try",
+            `set selText to (do JavaScript ${JSON.stringify(jsExpr)} in t) as text`,
+            "end try",
+            "return titleText & fs & urlText & fs & selText",
+            "end tell",
+        ]
+        : [
+            'tell application "Safari"',
+            'if (count of windows) is 0 then error "Safari has no open windows"',
+            "set t to current tab of front window",
+            "set fs to (ASCII character 31)",
+            "set titleText to (name of t) as text",
+            "set urlText to (URL of t) as text",
+            "set selText to \"\"",
+            "try",
+            `set selText to (do JavaScript ${JSON.stringify(jsExpr)} in t) as text`,
+            "end try",
+            "return titleText & fs & urlText & fs & selText",
+            "end tell",
+        ];
+    const output = await runOsaScript(lines, "SAFARI");
+    const parts = output.split("\x1f");
+    const title = parts[0] ?? "";
+    const url = parts[1] ?? "";
+    const selectionRaw = parts.slice(2).join("\x1f");
+    const selection = selectionRaw.length > maxChars ? `${selectionRaw.slice(0, maxChars)}...` : selectionRaw;
+    return {
+        result: {
+            title,
+            url,
+            hasSelection: selectionRaw.trim().length > 0,
+            selection,
+            truncated: selectionRaw.length > maxChars,
+            maxChars,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "safariReadSelection",
+                summary: `Read Safari selected text from ${url || "front tab"}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=safariReadSelection.js.map

package/dist/src/safari/safariReadSelection.js.map

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

package/dist/src/util/hashText.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Compute SHA-256 hash of a text string.
+ * @tool
+ * @effect none
+ */
+export declare function hashText(args: {
+    text: string;
+}): Promise<{
+    result: {
+        sha256: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=hashText.d.ts.map

package/dist/src/util/hashText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashText.d.ts","sourceRoot":"","sources":["../../../src/util/hashText.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;GAiBpD"}

package/dist/src/util/hashText.js

@@ -0,0 +1,24 @@
+import { computeChecksum } from "@botbotgo/common/utils";
+/**
+ * Compute SHA-256 hash of a text string.
+ * @tool
+ * @effect none
+ */
+export async function hashText(args) {
+    // Step 1: Compute SHA-256 of input text.
+    const text = args.text;
+    const sha256 = computeChecksum(text);
+    // Step 2: Return hash and evidence.
+    return {
+        result: { sha256 },
+        evidence: [
+            {
+                type: "tool",
+                ref: "core/util.hash.sha256Text",
+                summary: `SHA-256 of ${text.length} chars: ${sha256.slice(0, 16)}...`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=hashText.js.map

package/dist/src/util/hashText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashText.js","sourceRoot":"","sources":["../../../src/util/hashText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAsB;IACnD,yCAAyC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAErC,oCAAoC;IACpC,OAAO;QACL,MAAM,EAAE,EAAE,MAAM,EAAE;QAClB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,2BAA2B;gBAChC,OAAO,EAAE,cAAc,IAAI,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK;gBACrE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/util/jsonSelect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Extract values from JSON data using a JMESPath query expression.
+ * @tool
+ * @effect none
+ */
+export declare function jsonSelect(args: {
+    json: unknown;
+    path: string;
+    /** Alias for path (JMESPath expression; accepted when agents send "expression"). */
+    expression?: string;
+}): Promise<{
+    result: {
+        value: unknown;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=jsonSelect.d.ts.map

package/dist/src/util/jsonSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSelect.d.ts","sourceRoot":"","sources":["../../../src/util/jsonSelect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;;;;;;;;;GAuCA"}

package/dist/src/util/jsonSelect.js

@@ -0,0 +1,41 @@
+/**
+ * Extract values from JSON data using a JMESPath query expression.
+ * @tool
+ * @effect none
+ */
+export async function jsonSelect(args) {
+    // Step 1: Validate path (JMESPath expression) input.
+    const json = args.json;
+    const path = (args.path ?? args.expression)?.trim();
+    if (path === undefined || path === "") {
+        throw new Error("path is required (pass 'path' or 'expression')");
+    }
+    // Step 2: Load jmespath and evaluate expression.
+    let jmespath;
+    try {
+        jmespath = await import("jmespath");
+    }
+    catch {
+        throw new Error("jmespath package is required for core/util.json.select. Install it with: npm install jmespath");
+    }
+    let value;
+    try {
+        value = jmespath.search(json, path);
+    }
+    catch (err) {
+        throw new Error(`JMESPath expression error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Step 3: Return selected value and evidence.
+    return {
+        result: { value },
+        evidence: [
+            {
+                type: "tool",
+                ref: "core/util.json.select",
+                summary: `Selected "${path}" from JSON → ${typeof value === "object" ? JSON.stringify(value).slice(0, 100) : String(value).slice(0, 100)}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=jsonSelect.js.map

package/dist/src/util/jsonSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonSelect.js","sourceRoot":"","sources":["../../../src/util/jsonSelect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAKhC;IACC,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,iDAAiD;IACjD,IAAI,QAAoE,CAAC;IACzE,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,OAAO;QACL,MAAM,EAAE,EAAE,KAAK,EAAE;QACjB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,uBAAuB;gBAC5B,OAAO,EAAE,aAAa,IAAI,iBAAiB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBAC1I,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/util/now.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Get the current date and time in ISO, epoch, and formatted forms with timezone support.
+ * @tool
+ * @effect none
+ */
+export declare function now(args: {
+    timezone?: string;
+}): Promise<{
+    result: {
+        iso: string;
+        epochMs: number;
+        timezone: string;
+        formatted: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=now.d.ts.map

package/dist/src/util/now.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.d.ts","sourceRoot":"","sources":["../../../src/util/now.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;GA2CpD"}