@botbotgo/kit-builtin 0.0.92

package/dist/src/calendar/calendarSearchEventsByTitle.js

@@ -0,0 +1,95 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { parseSeparatedRows, quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Canonical name for searching calendar events by title.
+ * @tool
+ * @effect none
+ */
+export async function calendarSearchEventsByTitle(args) {
+    const titleQuery = args.titleQuery?.trim();
+    if (!titleQuery)
+        throw createTaggedError("CALENDAR_INVALID", "titleQuery is required", {});
+    const calendar = args.calendar?.trim() || "Home";
+    const fromDateText = args.fromDateText?.trim() || null;
+    const toDateText = args.toDateText?.trim() || null;
+    const hasRange = Boolean(fromDateText && toDateText);
+    const limit = Math.max(1, Math.min(500, Math.trunc(args.limit ?? 100)));
+    const lines = [
+        'tell application "Calendar"',
+        "activate",
+        "set rs to (ASCII character 30)",
+        "set fs to (ASCII character 31)",
+        `set calName to ${quoteAppleScriptString(calendar)}`,
+        ...(hasRange
+            ? [
+                `set fromText to ${quoteAppleScriptString(fromDateText)}`,
+                `set toText to ${quoteAppleScriptString(toDateText)}`,
+                "set fromDate to date fromText",
+                "set toDate to date toText",
+            ]
+            : []),
+        "set targetCal to calendar calName",
+        "set rows to {}",
+        "set n to 0",
+        `set maxCount to ${limit}`,
+        ...(hasRange
+            ? ["set matchedEvents to (every event of targetCal whose start date >= fromDate and start date <= toDate)"]
+            : ["set matchedEvents to every event of targetCal"]),
+        "repeat with ev in matchedEvents",
+        "if n is greater than or equal to maxCount then exit repeat",
+        "set n to n + 1",
+        "set eid to \"\"",
+        "try",
+        "set eid to (uid of ev) as text",
+        "end try",
+        "set titleText to \"\"",
+        "try",
+        "set titleText to (summary of ev) as text",
+        "end try",
+        "set startText to \"\"",
+        "try",
+        "set startText to (start date of ev) as text",
+        "end try",
+        "set endText to \"\"",
+        "try",
+        "set endText to (end date of ev) as text",
+        "end try",
+        "set end of rows to eid & fs & titleText & fs & startText & fs & endText",
+        "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, "CALENDAR");
+    const rows = parseSeparatedRows(output);
+    const q = titleQuery.toLowerCase();
+    const events = rows
+        .map((parts) => ({
+        id: parts[0] ?? "",
+        title: parts[1] ?? "",
+        startDateText: parts[2] ?? "",
+        endDateText: parts[3] ?? "",
+    }))
+        .filter((event) => event.title.toLowerCase().includes(q));
+    return {
+        result: {
+            titleQuery,
+            calendar,
+            fromDateText,
+            toDateText,
+            count: events.length,
+            events,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "calendarSearchEventsByTitle",
+                summary: `Found ${events.length} events matching \"${titleQuery}\"`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=calendarSearchEventsByTitle.js.map

package/dist/src/calendar/calendarSearchEventsByTitle.js.map

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

package/dist/src/calendar/calendarUpdateEvent.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Update calendar event by uid in specific calendar.
+ * @tool
+ * @effect local_write
+ */
+export declare function calendarUpdateEvent(args: {
+    id: string;
+    calendar?: string;
+    title?: string;
+    startDateText?: string;
+    endDateText?: string;
+    location?: string;
+    notes?: string;
+}): Promise<{
+    result: {
+        id: string;
+        calendar: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=calendarUpdateEvent.d.ts.map

package/dist/src/calendar/calendarUpdateEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarUpdateEvent.d.ts","sourceRoot":"","sources":["../../../src/calendar/calendarUpdateEvent.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;;;;;;;;;;GAmDA"}

package/dist/src/calendar/calendarUpdateEvent.js

@@ -0,0 +1,58 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Update calendar event by uid in specific calendar.
+ * @tool
+ * @effect local_write
+ */
+export async function calendarUpdateEvent(args) {
+    const id = args.id?.trim();
+    const calendar = args.calendar?.trim() || "Home";
+    if (!id)
+        throw createTaggedError("CALENDAR_INVALID", "id is required", {});
+    if (!args.title && !args.startDateText && !args.endDateText && !args.location && !args.notes) {
+        throw createTaggedError("CALENDAR_INVALID", "at least one field to update is required", {});
+    }
+    const lines = [
+        'tell application "Calendar"',
+        "activate",
+        `set calName to ${quoteAppleScriptString(calendar)}`,
+        `set wantedId to ${quoteAppleScriptString(id)}`,
+        "set targetCal to calendar calName",
+        "set targetEvent to first event of targetCal whose (uid as text) is wantedId",
+        ...(args.title?.trim() ? [`set summary of targetEvent to ${quoteAppleScriptString(args.title.trim())}`] : []),
+        ...(args.startDateText?.trim()
+            ? [
+                `set stText to ${quoteAppleScriptString(args.startDateText.trim())}`,
+                "set start date of targetEvent to date stText",
+            ]
+            : []),
+        ...(args.endDateText?.trim()
+            ? [
+                `set edText to ${quoteAppleScriptString(args.endDateText.trim())}`,
+                "set end date of targetEvent to date edText",
+            ]
+            : []),
+        ...(args.location?.trim() ? [`set location of targetEvent to ${quoteAppleScriptString(args.location.trim())}`] : []),
+        ...(args.notes?.trim() ? [`set description of targetEvent to ${quoteAppleScriptString(args.notes.trim())}`] : []),
+        'return "updated"',
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "CALENDAR");
+    return {
+        result: {
+            id,
+            calendar,
+            status: output || "updated",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "calendarUpdateEvent",
+                summary: `Updated calendar event ${id} in ${calendar}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=calendarUpdateEvent.js.map

package/dist/src/calendar/calendarUpdateEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarUpdateEvent.js","sourceRoot":"","sources":["../../../src/calendar/calendarUpdateEvent.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,mBAAmB,CAAC,IAQzC;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IACjD,IAAI,CAAC,EAAE;QAAE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7F,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,0CAA0C,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,UAAU;QACV,kBAAkB,sBAAsB,CAAC,QAAQ,CAAC,EAAE;QACpD,mBAAmB,sBAAsB,CAAC,EAAE,CAAC,EAAE;QAC/C,mCAAmC;QACnC,6EAA6E;QAC7E,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,iCAAiC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE;YAC5B,CAAC,CAAC;gBACE,iBAAiB,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE;gBACpE,8CAA8C;aAC/C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;YAC1B,CAAC,CAAC;gBACE,iBAAiB,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE;gBAClE,4CAA4C;aAC7C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,kCAAkC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpH,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,qCAAqC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,kBAAkB;QAClB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAErD,OAAO;QACL,MAAM,EAAE;YACN,EAAE;YACF,QAAQ;YACR,MAAM,EAAE,MAAM,IAAI,SAAS;SAC5B;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,qBAAqB;gBAC1B,OAAO,EAAE,0BAA0B,EAAE,OAAO,QAAQ,EAAE;gBACtD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronListEntries.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical name for listing cron entries.
+ * @tool
+ * @effect none
+ */
+export declare function cronListEntries(_?: {}): Promise<{
+    result: {
+        count: number;
+        entries: string[];
+        raw: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronListEntries.d.ts.map

package/dist/src/cron/cronListEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronListEntries.d.ts","sourceRoot":"","sources":["../../../src/cron/cronListEntries.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAE,EAAO;;;;;;;;;;;;GA2B/C"}

package/dist/src/cron/cronListEntries.js

@@ -0,0 +1,33 @@
+import { runOsaScript } from "../osascript/common.js";
+/**
+ * Canonical name for listing cron entries.
+ * @tool
+ * @effect none
+ */
+export async function cronListEntries(_ = {}) {
+    const lines = [
+        "set sh to \"crontab -l 2>/dev/null || true\"",
+        "return do shell script sh",
+    ];
+    const output = await runOsaScript(lines, "CRON");
+    const linesOut = output
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    return {
+        result: {
+            count: linesOut.length,
+            entries: linesOut,
+            raw: output,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronListEntries",
+                summary: `Listed ${linesOut.length} cron entries`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronListEntries.js.map

package/dist/src/cron/cronListEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronListEntries.js","sourceRoot":"","sources":["../../../src/cron/cronListEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAQ,EAAE;IAC9C,MAAM,KAAK,GAAG;QACZ,8CAA8C;QAC9C,2BAA2B;KAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM;SACpB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,MAAM;SACZ;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,iBAAiB;gBACtB,OAAO,EAAE,UAAU,QAAQ,CAAC,MAAM,eAAe;gBACjD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronRemoveTaggedEntries.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canonical name for removing tagged cron entries.
+ * @tool
+ * @effect local_write
+ */
+export declare function cronRemoveTaggedEntries(args: {
+    tag: string;
+}): Promise<{
+    result: {
+        tag: string;
+        marker: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronRemoveTaggedEntries.d.ts.map

package/dist/src/cron/cronRemoveTaggedEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronRemoveTaggedEntries.d.ts","sourceRoot":"","sources":["../../../src/cron/cronRemoveTaggedEntries.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA+BlE"}

package/dist/src/cron/cronRemoveTaggedEntries.js

@@ -0,0 +1,41 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+function b64(input) {
+    return Buffer.from(input, "utf-8").toString("base64");
+}
+/**
+ * Canonical name for removing tagged cron entries.
+ * @tool
+ * @effect local_write
+ */
+export async function cronRemoveTaggedEntries(args) {
+    const tag = args.tag?.trim();
+    if (!tag)
+        throw createTaggedError("CRON_INVALID", "tag is required", {});
+    const marker = `# botbotgo:${tag}`;
+    const script = [
+        "set -e",
+        `marker=$(printf '%s' ${JSON.stringify(b64(marker))} | base64 -D)`,
+        "existing=$(crontab -l 2>/dev/null || true)",
+        "filtered=$(printf '%s\\n' \"$existing\" | grep -vF \"$marker\" || true)",
+        "printf '%s\\n' \"$filtered\" | sed '/^[[:space:]]*$/d' | crontab -",
+        "printf '%s' \"$marker\"",
+    ].join("; ");
+    const output = await runOsaScript([`return do shell script ${quoteAppleScriptString(script)}`], "CRON");
+    return {
+        result: {
+            tag,
+            marker: output || marker,
+            status: "removed",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronRemoveTaggedEntries",
+                summary: `Removed cron entries with tag ${tag}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronRemoveTaggedEntries.js.map

package/dist/src/cron/cronRemoveTaggedEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronRemoveTaggedEntries.js","sourceRoot":"","sources":["../../../src/cron/cronRemoveTaggedEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAqB;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,cAAc,GAAG,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG;QACb,QAAQ;QACR,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe;QAClE,4CAA4C;QAC5C,yEAAyE;QACzE,oEAAoE;QACpE,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,CAAC,0BAA0B,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAExG,OAAO;QACL,MAAM,EAAE;YACN,GAAG;YACH,MAAM,EAAE,MAAM,IAAI,MAAM;YACxB,MAAM,EAAE,SAAS;SAClB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,yBAAyB;gBAC9B,OAAO,EAAE,iCAAiC,GAAG,EAAE;gBAC/C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronSetTaggedEntry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical name for creating/updating a tagged cron entry.
+ * @tool
+ * @effect local_write
+ */
+export declare function cronSetTaggedEntry(args: {
+    expression: string;
+    command: string;
+    tag: string;
+}): Promise<{
+    result: {
+        tag: string;
+        marker: string;
+        line: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronSetTaggedEntry.d.ts.map

package/dist/src/cron/cronSetTaggedEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSetTaggedEntry.d.ts","sourceRoot":"","sources":["../../../src/cron/cronSetTaggedEntry.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;;;;;;;;;;;;;GAyCA"}

package/dist/src/cron/cronSetTaggedEntry.js

@@ -0,0 +1,51 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+function b64(input) {
+    return Buffer.from(input, "utf-8").toString("base64");
+}
+/**
+ * Canonical name for creating/updating a tagged cron entry.
+ * @tool
+ * @effect local_write
+ */
+export async function cronSetTaggedEntry(args) {
+    const expression = args.expression?.trim();
+    const command = args.command?.trim();
+    const tag = args.tag?.trim();
+    if (!expression)
+        throw createTaggedError("CRON_INVALID", "expression is required", {});
+    if (!command)
+        throw createTaggedError("CRON_INVALID", "command is required", {});
+    if (!tag)
+        throw createTaggedError("CRON_INVALID", "tag is required", {});
+    const marker = `# botbotgo:${tag}`;
+    const newLine = `${expression} ${command} ${marker}`;
+    const script = [
+        "set -e",
+        `marker=$(printf '%s' ${JSON.stringify(b64(marker))} | base64 -D)`,
+        `new_line=$(printf '%s' ${JSON.stringify(b64(newLine))} | base64 -D)`,
+        "existing=$(crontab -l 2>/dev/null || true)",
+        "filtered=$(printf '%s\\n' \"$existing\" | grep -vF \"$marker\" || true)",
+        "next=$(printf '%s\\n%s\\n' \"$filtered\" \"$new_line\" | sed '/^[[:space:]]*$/d')",
+        "printf '%s\\n' \"$next\" | crontab -",
+        "printf '%s' \"$new_line\"",
+    ].join("; ");
+    const output = await runOsaScript([`return do shell script ${quoteAppleScriptString(script)}`], "CRON");
+    return {
+        result: {
+            tag,
+            marker,
+            line: output || newLine,
+            status: "upserted",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronSetTaggedEntry",
+                summary: `Upserted cron entry with tag ${tag}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronSetTaggedEntry.js.map

package/dist/src/cron/cronSetTaggedEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSetTaggedEntry.js","sourceRoot":"","sources":["../../../src/cron/cronSetTaggedEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAIxC;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,UAAU;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACvF,IAAI,CAAC,OAAO;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,cAAc,GAAG,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;IAErD,MAAM,MAAM,GAAG;QACb,QAAQ;QACR,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe;QAClE,0BAA0B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,eAAe;QACrE,4CAA4C;QAC5C,yEAAyE;QACzE,mFAAmF;QACnF,sCAAsC;QACtC,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,CAAC,0BAA0B,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAExG,OAAO;QACL,MAAM,EAAE;YACN,GAAG;YACH,MAAM;YACN,IAAI,EAAE,MAAM,IAAI,OAAO;YACvB,MAAM,EAAE,UAAU;SACnB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,oBAAoB;gBACzB,OAAO,EAAE,gCAAgC,GAAG,EAAE;gBAC9C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/exec/defaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exec tool defaults (max output bytes, timeout).
+ * Config: these constants or user's tool config at invoke (e.g. allowedCommands).
+ */
+export declare const DEFAULT_ALLOWED_COMMANDS: string[];
+export declare const DEFAULT_MAX_COMMAND_OUTPUT_BYTES: number;
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 10000;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/exec/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/exec/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAoBpC,CAAC;AAEF,eAAO,MAAM,gCAAgC,QAAc,CAAC;AAC5D,eAAO,MAAM,0BAA0B,QAAS,CAAC"}

package/dist/src/exec/defaults.js

@@ -0,0 +1,28 @@
+/**
+ * Exec tool defaults (max output bytes, timeout).
+ * Config: these constants or user's tool config at invoke (e.g. allowedCommands).
+ */
+export const DEFAULT_ALLOWED_COMMANDS = [
+    "awk",
+    "cat",
+    "cut",
+    "echo",
+    "env",
+    "find",
+    "grep",
+    "head",
+    "ls",
+    "pwd",
+    "rg",
+    "sed",
+    "sort",
+    "tail",
+    "tr",
+    "uniq",
+    "wc",
+    "whoami",
+    "xargs",
+];
+export const DEFAULT_MAX_COMMAND_OUTPUT_BYTES = 1024 * 1024;
+export const DEFAULT_COMMAND_TIMEOUT_MS = 10_000;
+//# sourceMappingURL=defaults.js.map

package/dist/src/exec/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/exec/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,OAAO;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC"}

package/dist/src/exec/runCommand.d.ts

@@ -0,0 +1,31 @@
+type RunCommandOutput = {
+    result: {
+        stdout: string;
+        stderr: string;
+        exitCode: number | null;
+        timedOut: boolean;
+        signal?: string;
+    };
+    evidence: Array<{
+        type: string;
+        ref?: string;
+        summary: string;
+        createdAt: string;
+    }>;
+};
+/**
+ * Run a whitelisted command with bounded output/timeout inside sandbox.
+ * @tool
+ * @effect local_write
+ */
+export declare function runCommand(args: {
+    command?: string;
+    cmd?: string;
+    cmdArray?: string[];
+    args?: string[];
+    arguments?: string[];
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<RunCommandOutput>;
+export {};
+//# sourceMappingURL=runCommand.d.ts.map

package/dist/src/exec/runCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../../src/exec/runCommand.ts"],"names":[],"mappings":"AAYA,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC;AAmKF;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc5B"}

package/dist/src/exec/runCommand.js

@@ -0,0 +1,158 @@
+import { spawn } from "node:child_process";
+import { resolve as pathResolve } from "node:path";
+import { getExtensionContext } from "../../index.js";
+import { DEFAULT_ALLOWED_COMMANDS, DEFAULT_MAX_COMMAND_OUTPUT_BYTES, DEFAULT_COMMAND_TIMEOUT_MS, } from "./defaults.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { resolveSandboxedPath } from "../platform/securityCompat.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+function getCommandConfig() {
+    const defaults = {
+        allowedCommands: DEFAULT_ALLOWED_COMMANDS,
+        maxCommandOutputBytes: DEFAULT_MAX_COMMAND_OUTPUT_BYTES,
+        commandTimeoutMs: DEFAULT_COMMAND_TIMEOUT_MS,
+        sandboxRoot: "",
+        enableSandboxValidation: false,
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const timeoutMs = typeof ctx.config?.timeoutMs === "number"
+        ? ctx.config.timeoutMs
+        : cfg.commandTimeoutMs;
+    return {
+        allowedCommands: cfg.allowedCommands,
+        maxCommandOutputBytes: cfg.maxCommandOutputBytes,
+        timeoutMs,
+        sandboxRoot: cfg.sandboxRoot ?? "",
+    };
+}
+function normalizeCommandInput(args) {
+    if (Array.isArray(args.cmdArray) && args.cmdArray.length > 0) {
+        return { rawCommand: String(args.cmdArray[0]).trim(), cmdArgs: args.cmdArray.slice(1).map(String) };
+    }
+    const rawCommand = (args.command ?? args.cmd)?.trim() ?? "";
+    if (!rawCommand) {
+        throw createTaggedError("EXEC_INVALID", "command is required (pass 'command', 'cmd', or 'cmdArray')", {});
+    }
+    const cmdArgs = Array.isArray(args.args)
+        ? args.args
+        : Array.isArray(args.arguments)
+            ? args.arguments
+            : [];
+    return { rawCommand, cmdArgs };
+}
+function validateAllowedCommand(rawCommand, allowedCommands) {
+    if (!allowedCommands.length) {
+        throw createTaggedError("EXEC_DISABLED", "Exec is disabled: allowedCommands is empty", {});
+    }
+    const baseName = rawCommand.replace(/^.*\//, "").trim();
+    if (baseName !== rawCommand || /[;&|$`\s]/.test(rawCommand)) {
+        throw createTaggedError("EXEC_INVALID", "command must be a single executable name (no path, no shell chars)", {
+            command: rawCommand,
+        });
+    }
+    if (!allowedCommands.includes(baseName)) {
+        throw createTaggedError("EXEC_NOT_ALLOWED", `Command "${baseName}" is not in allowedCommands`, {
+            command: baseName,
+            allowed: allowedCommands,
+        });
+    }
+    return baseName;
+}
+async function resolveCommandCwd(inputCwd, sandboxRoot) {
+    if (inputCwd != null && inputCwd !== "") {
+        return resolveSandboxedPath(inputCwd, sandboxRoot);
+    }
+    return pathResolve(sandboxRoot);
+}
+function runSpawnedCommand(args) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        const proc = spawn(args.baseName, args.cmdArgs, {
+            cwd: args.cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        let stdout = "";
+        let stderr = "";
+        let totalBytes = 0;
+        let settled = false;
+        const rejectOnce = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            rejectPromise(error);
+        };
+        const resolveOnce = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolvePromise(value);
+        };
+        const append = (chunk, dest) => {
+            const len = Buffer.byteLength(chunk, "utf-8");
+            if (totalBytes + len > args.maxCommandOutputBytes) {
+                proc.kill("SIGKILL");
+                rejectOnce(createTaggedError("EXEC_OUTPUT_TOO_LARGE", `Command output exceeded ${args.maxCommandOutputBytes} bytes`, {
+                    maxBytes: args.maxCommandOutputBytes,
+                }));
+                return;
+            }
+            totalBytes += len;
+            if (dest === "stdout")
+                stdout += chunk;
+            else
+                stderr += chunk;
+        };
+        proc.stdout?.setEncoding("utf-8");
+        proc.stderr?.setEncoding("utf-8");
+        proc.stdout?.on("data", (chunk) => append(chunk, "stdout"));
+        proc.stderr?.on("data", (chunk) => append(chunk, "stderr"));
+        const timeout = setTimeout(() => {
+            proc.kill("SIGKILL");
+            resolveOnce({
+                result: { stdout, stderr, exitCode: null, timedOut: true, signal: "SIGKILL" },
+                evidence: [{
+                        type: "exec",
+                        summary: `Command "${args.baseName}" timed out after ${args.timeoutMs}ms`,
+                        createdAt: new Date().toISOString(),
+                    }],
+            });
+        }, args.timeoutMs);
+        proc.on("error", (err) => {
+            clearTimeout(timeout);
+            rejectOnce(createTaggedError("EXEC_SPAWN_ERROR", err.message, { command: args.baseName }));
+        });
+        proc.on("close", (code, signal) => {
+            clearTimeout(timeout);
+            resolveOnce({
+                result: { stdout, stderr, exitCode: code, timedOut: false, signal: signal ?? undefined },
+                evidence: [{
+                        type: "exec",
+                        ref: args.baseName,
+                        summary: `Ran ${args.baseName} (exit ${code ?? signal})`,
+                        createdAt: new Date().toISOString(),
+                    }],
+            });
+        });
+    });
+}
+/**
+ * Run a whitelisted command with bounded output/timeout inside sandbox.
+ * @tool
+ * @effect local_write
+ */
+export async function runCommand(args) {
+    const config = getCommandConfig();
+    const normalized = normalizeCommandInput(args);
+    const baseName = validateAllowedCommand(normalized.rawCommand, config.allowedCommands);
+    const cwd = await resolveCommandCwd(args.cwd, config.sandboxRoot);
+    const timeoutMs = args.timeoutMs ?? config.timeoutMs;
+    return runSpawnedCommand({
+        baseName,
+        cmdArgs: normalized.cmdArgs,
+        cwd,
+        timeoutMs,
+        maxCommandOutputBytes: config.maxCommandOutputBytes,
+    });
+}
+//# sourceMappingURL=runCommand.js.map