@elizaos/macosalarm 2.0.0-beta.1

package/dist/actions.d.ts

@@ -0,0 +1,7 @@
+import { type Action } from "@elizaos/core";
+import { type HelperRunOptions } from "./helper";
+export interface MacosAlarmActionDeps {
+    helperOptions?: HelperRunOptions;
+}
+export declare function createAlarmAction(deps?: MacosAlarmActionDeps): Action;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,UAAU,CAAC;AASlB,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAuWD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,oBAAyB,GAAG,MAAM,CA8JzE"}

package/dist/actions.js

@@ -0,0 +1,443 @@
+import { randomUUID } from "node:crypto";
+import { logger, } from "@elizaos/core";
+import { MacosAlarmHelperUnavailableError, runHelper, } from "./helper";
+const ALARM_SUBACTIONS = ["set", "cancel", "list"];
+const NOT_SUPPORTED = {
+    success: false,
+    text: "I can only use native alarms on macOS.",
+    error: "macos-only",
+};
+const ALARM_CONTEXTS = ["tasks", "calendar", "automation"];
+const ALARM_TERMS = [
+    "alarm",
+    "alarms",
+    "wake",
+    "despertador",
+    "alarma",
+    "alarmas",
+    "reveil",
+    "réveil",
+    "alarme",
+    "wecker",
+    "alarm anzeigen",
+    "闹钟",
+    "提醒",
+    "アラーム",
+    "알람",
+    "báo thức",
+    "bao thuc",
+];
+function isDarwin() {
+    return process.platform === "darwin";
+}
+function getText(message) {
+    return (message.content.text ?? "").toLowerCase();
+}
+function normalizeContextList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .flatMap((item) => (typeof item === "string" ? [item.toLowerCase()] : []))
+        .filter(Boolean);
+}
+function hasAlarmContext(message, state) {
+    const values = state?.values ?? {};
+    const content = message.content;
+    const contexts = [
+        ...normalizeContextList(values.activeContexts),
+        ...normalizeContextList(values.selectedContexts),
+        ...normalizeContextList(content.activeContexts),
+        ...normalizeContextList(content.selectedContexts),
+        ...normalizeContextList(content.contexts),
+    ];
+    return contexts.some((context) => ALARM_CONTEXTS.includes(context));
+}
+function hasAlarmSignal(message, state) {
+    if (hasAlarmContext(message, state))
+        return true;
+    const text = getText(message);
+    return ALARM_TERMS.some((term) => text.includes(term.toLowerCase()));
+}
+function readParameters(options) {
+    const params = options?.parameters;
+    return params && typeof params === "object" ? params : {};
+}
+function normalizeSubactionValue(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim().toLowerCase().replace(/[\s-]+/g, "_");
+    const aliases = {
+        schedule: "set",
+        create: "set",
+        add: "set",
+        remove: "cancel",
+        delete: "cancel",
+        show: "list",
+        pending: "list",
+    };
+    if (aliases[normalized])
+        return aliases[normalized];
+    return ALARM_SUBACTIONS.includes(normalized)
+        ? normalized
+        : null;
+}
+function inferSubactionFromText(text) {
+    const lower = text.toLowerCase();
+    if (/\b(list|show|pending|view|see|what)\b.*\balarm/.test(lower) ||
+        /\balarms?\s*(?:list|pending)\b/.test(lower)) {
+        return "list";
+    }
+    if (/\b(cancel|stop|remove|delete|kill|clear)\b.*\balarm/.test(lower) ||
+        /\balarm\b.*\b(cancel|stop|remove|delete|kill|clear)\b/.test(lower)) {
+        return "cancel";
+    }
+    if (/\b(set|schedule|create|add|new|wake)\b.*\balarm/.test(lower) ||
+        /\balarm\b.*\b(set|schedule|create|add|for)\b/.test(lower) ||
+        /\bwake me\b/.test(lower)) {
+        return "set";
+    }
+    if (lower.includes("alarm")) {
+        // Default to list when alarm mentioned without a clear verb.
+        return "list";
+    }
+    return null;
+}
+function parseSchedule(params) {
+    const timeIso = typeof params.timeIso === "string" ? params.timeIso : null;
+    const title = typeof params.title === "string" ? params.title : null;
+    if (!timeIso || !title)
+        return null;
+    const body = typeof params.body === "string" ? params.body : undefined;
+    const id = typeof params.id === "string" ? params.id : undefined;
+    const sound = typeof params.sound === "string" ? params.sound : undefined;
+    return { timeIso, title, body, id, sound };
+}
+function parseCancel(params) {
+    const id = typeof params.id === "string"
+        ? params.id
+        : typeof params.alarmId === "string"
+            ? params.alarmId
+            : null;
+    if (!id)
+        return null;
+    return { id };
+}
+async function runSet(message, params, deps, callback) {
+    const parsed = parseSchedule(params);
+    if (!parsed) {
+        const err = "ALARM set requires timeIso and title parameters.";
+        logger.warn(`[ALARM/set] ${err}`);
+        if (callback) {
+            await callback({ text: err, source: message.content.source });
+        }
+        return {
+            success: false,
+            error: err,
+            data: { actionName: "ALARM", subaction: "set" },
+        };
+    }
+    const id = parsed.id ?? `alarm-${randomUUID()}`;
+    try {
+        const response = await runHelper({
+            action: "schedule",
+            id,
+            timeIso: parsed.timeIso,
+            title: parsed.title,
+            body: parsed.body,
+            sound: parsed.sound,
+        }, deps.helperOptions);
+        if (!response.success) {
+            logger.error(`[ALARM/set] helper returned error: ${response.error}`);
+            if (callback) {
+                await callback({
+                    text: `Could not set alarm: ${response.error}`,
+                    source: message.content.source,
+                });
+            }
+            return {
+                success: false,
+                error: response.error,
+                data: { actionName: "ALARM", subaction: "set" },
+            };
+        }
+        const scheduled = response;
+        logger.info(`[ALARM/set] scheduled id=${scheduled.id} fireAt=${scheduled.fireAt}`);
+        if (callback) {
+            await callback({
+                text: `Alarm set for ${scheduled.fireAt}: "${parsed.title}".`,
+                source: message.content.source,
+            });
+        }
+        return {
+            success: true,
+            data: {
+                actionName: "ALARM",
+                subaction: "set",
+                id: scheduled.id,
+                fireAt: scheduled.fireAt,
+            },
+        };
+    }
+    catch (err) {
+        if (err instanceof MacosAlarmHelperUnavailableError) {
+            logger.warn(`[ALARM/set] helper unavailable: ${err.reason}`);
+            if (callback) {
+                await callback({
+                    text: "The macOS alarm helper is not installed on this machine.",
+                    source: message.content.source,
+                });
+            }
+            return {
+                success: false,
+                error: err.reason,
+                data: { actionName: "ALARM", subaction: "set" },
+            };
+        }
+        const failureMessage = err instanceof Error ? err.message : "Unknown macOS alarm failure.";
+        logger.error(`[ALARM/set] helper failed: ${failureMessage}`);
+        return {
+            success: false,
+            text: `Could not set alarm: ${failureMessage}`,
+            error: failureMessage,
+            data: { actionName: "ALARM", subaction: "set" },
+        };
+    }
+}
+async function runCancel(message, params, deps, callback) {
+    const parsed = parseCancel(params);
+    if (!parsed) {
+        const err = "ALARM cancel requires an id parameter.";
+        logger.warn(`[ALARM/cancel] ${err}`);
+        return {
+            success: false,
+            error: err,
+            data: { actionName: "ALARM", subaction: "cancel" },
+        };
+    }
+    try {
+        const response = await runHelper({ action: "cancel", id: parsed.id }, deps.helperOptions);
+        if (!response.success) {
+            return {
+                success: false,
+                error: response.error,
+                data: { actionName: "ALARM", subaction: "cancel" },
+            };
+        }
+        const cancelled = response;
+        logger.info(`[ALARM/cancel] cancelled id=${cancelled.id}`);
+        if (callback) {
+            await callback({
+                text: `Alarm ${cancelled.id} cancelled.`,
+                source: message.content.source,
+            });
+        }
+        return {
+            success: true,
+            data: { actionName: "ALARM", subaction: "cancel", id: cancelled.id },
+        };
+    }
+    catch (err) {
+        if (err instanceof MacosAlarmHelperUnavailableError) {
+            logger.warn(`[ALARM/cancel] helper unavailable: ${err.reason}`);
+            return {
+                success: false,
+                error: err.reason,
+                data: { actionName: "ALARM", subaction: "cancel" },
+            };
+        }
+        const failureMessage = err instanceof Error ? err.message : "Unknown macOS alarm failure.";
+        logger.error(`[ALARM/cancel] helper failed: ${failureMessage}`);
+        return {
+            success: false,
+            text: `Could not cancel alarm: ${failureMessage}`,
+            error: failureMessage,
+            data: { actionName: "ALARM", subaction: "cancel" },
+        };
+    }
+}
+async function runList(message, deps, callback) {
+    try {
+        const response = await runHelper({ action: "list" }, deps.helperOptions);
+        if (!response.success) {
+            return {
+                success: false,
+                error: response.error,
+                data: { actionName: "ALARM", subaction: "list" },
+            };
+        }
+        const list = response;
+        logger.info(`[ALARM/list] pending count=${list.alarms.length}`);
+        if (callback) {
+            const summary = list.alarms.length === 0
+                ? "No macOS alarms are pending."
+                : `Pending macOS alarms: ${list.alarms
+                    .map((a) => `${a.id} @ ${a.fireAt ?? "unknown"}`)
+                    .join(", ")}`;
+            await callback({ text: summary, source: message.content.source });
+        }
+        return {
+            success: true,
+            data: {
+                actionName: "ALARM",
+                subaction: "list",
+                alarms: list.alarms,
+            },
+        };
+    }
+    catch (err) {
+        if (err instanceof MacosAlarmHelperUnavailableError) {
+            logger.warn(`[ALARM/list] helper unavailable: ${err.reason}`);
+            return {
+                success: false,
+                error: err.reason,
+                data: { actionName: "ALARM", subaction: "list" },
+            };
+        }
+        const failureMessage = err instanceof Error ? err.message : "Unknown macOS alarm failure.";
+        logger.error(`[ALARM/list] helper failed: ${failureMessage}`);
+        return {
+            success: false,
+            text: `Could not list alarms: ${failureMessage}`,
+            error: failureMessage,
+            data: { actionName: "ALARM", subaction: "list" },
+        };
+    }
+}
+export function createAlarmAction(deps = {}) {
+    return {
+        name: "ALARM",
+        description: "Manage native macOS alarms via UNUserNotificationCenter. Subactions: set (schedule a new alarm), cancel (remove a scheduled alarm by id), list (show pending alarms). Subaction inferred from message text when not explicitly provided.",
+        descriptionCompressed: "macOS alarm: set / cancel / list (UNUserNotificationCenter).",
+        contexts: [...ALARM_CONTEXTS],
+        contextGate: { anyOf: [...ALARM_CONTEXTS] },
+        roleGate: { minRole: "ADMIN" },
+        similes: [
+            "SET_ALARM_MACOS",
+            "CANCEL_ALARM_MACOS",
+            "LIST_ALARMS_MACOS",
+            "schedule macos alarm",
+            "create mac alarm",
+            "set a mac alarm",
+            "wake me up on mac",
+            "cancel macos alarm",
+            "remove mac alarm",
+            "list macos alarms",
+            "show pending alarms",
+        ],
+        parameters: [
+            {
+                name: "subaction",
+                description: "Operation to perform: set, cancel, or list. Inferred from message text when omitted.",
+                required: false,
+                schema: { type: "string", enum: [...ALARM_SUBACTIONS] },
+            },
+            {
+                name: "timeIso",
+                description: "For subaction=set: ISO-8601 timestamp when the alarm should fire.",
+                required: false,
+                schema: { type: "string" },
+            },
+            {
+                name: "title",
+                description: "For subaction=set: short title displayed in the notification.",
+                required: false,
+                schema: { type: "string" },
+            },
+            {
+                name: "body",
+                description: "For subaction=set: optional longer body text for the notification.",
+                required: false,
+                schema: { type: "string" },
+            },
+            {
+                name: "sound",
+                description: "For subaction=set: optional notification sound name.",
+                required: false,
+                schema: { type: "string" },
+            },
+            {
+                name: "id",
+                description: "For subaction=set: optional explicit alarm id; for subaction=cancel: required alarm id returned from a previous set operation.",
+                required: false,
+                schema: { type: "string" },
+            },
+        ],
+        validate: async (_runtime, message, state) => {
+            if (!isDarwin())
+                return false;
+            return hasAlarmSignal(message, state);
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            if (!isDarwin()) {
+                logger.info("[ALARM] skipping on non-darwin platform; returning macos-only");
+                if (callback) {
+                    await callback({
+                        text: "I can only set native alarms on macOS.",
+                        source: message.content.source,
+                    });
+                }
+                return NOT_SUPPORTED;
+            }
+            const params = readParameters(options);
+            const explicit = normalizeSubactionValue(params.subaction) ??
+                normalizeSubactionValue(params.op);
+            const subaction = explicit ?? inferSubactionFromText(getText(message));
+            if (!subaction) {
+                const text = `ALARM could not determine the subaction. Specify one of: ${ALARM_SUBACTIONS.join(", ")}.`;
+                if (callback) {
+                    await callback({ text, source: message.content.source });
+                }
+                return {
+                    success: false,
+                    text,
+                    values: { error: "MISSING_SUBACTION" },
+                    data: {
+                        actionName: "ALARM",
+                        availableSubactions: [...ALARM_SUBACTIONS],
+                    },
+                };
+            }
+            switch (subaction) {
+                case "set":
+                    return runSet(message, params, deps, callback);
+                case "cancel":
+                    return runCancel(message, params, deps, callback);
+                case "list":
+                    return runList(message, deps, callback);
+            }
+        },
+        examples: [
+            [
+                { name: "{{user}}", content: { text: "set an alarm for 7am tomorrow" } },
+                {
+                    name: "{{agent}}",
+                    content: {
+                        actions: ["ALARM"],
+                        text: "Alarm set for 2026-05-08T07:00:00-07:00: \"Wake up\".",
+                    },
+                },
+            ],
+            [
+                { name: "{{user}}", content: { text: "cancel alarm alarm-1234" } },
+                {
+                    name: "{{agent}}",
+                    content: {
+                        actions: ["ALARM"],
+                        text: "Alarm alarm-1234 cancelled.",
+                    },
+                },
+            ],
+            [
+                { name: "{{user}}", content: { text: "list pending alarms" } },
+                {
+                    name: "{{agent}}",
+                    content: {
+                        actions: ["ALARM"],
+                        text: "Pending macOS alarms: alarm-1234 @ 2026-05-08T07:00:00-07:00",
+                    },
+                },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/helper.d.ts

@@ -0,0 +1,16 @@
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
+import type { MacosAlarmHelperRequest, MacosAlarmHelperResponse } from "./types";
+export interface HelperSpawn {
+    (bin: string, args: string[]): ChildProcessWithoutNullStreams;
+}
+export interface HelperRunOptions {
+    spawnImpl?: HelperSpawn;
+    binPathOverride?: string;
+    timeoutMs?: number;
+}
+export declare class MacosAlarmHelperUnavailableError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+export declare function runHelper(request: MacosAlarmHelperRequest, options?: HelperRunOptions): Promise<MacosAlarmHelperResponse>;
+//# sourceMappingURL=helper.d.ts.map

package/dist/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAKhF,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAIjB,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,8BAA8B,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM;CAK3B;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA4EnC"}

package/dist/helper.js

@@ -0,0 +1,82 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger } from "@elizaos/core";
+const HELPER_ENV_OVERRIDE = "ELIZA_MACOSALARM_HELPER_BIN";
+const defaultSpawnHelper = (bin, args) => spawn(bin, args);
+function resolveHelperBin(override) {
+    if (override && override.length > 0)
+        return override;
+    const envOverride = process.env[HELPER_ENV_OVERRIDE];
+    if (envOverride && envOverride.length > 0)
+        return envOverride;
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Built binary lives at <package>/bin/macosalarm-helper; this file compiles
+    // to <package>/dist/helper.js, so one-level-up gets us to the package root.
+    const pkgRoot = resolve(here, "..");
+    return resolve(pkgRoot, "bin", "macosalarm-helper");
+}
+export class MacosAlarmHelperUnavailableError extends Error {
+    reason;
+    constructor(reason) {
+        super(`macosalarm helper unavailable: ${reason}`);
+        this.name = "MacosAlarmHelperUnavailableError";
+        this.reason = reason;
+    }
+}
+export async function runHelper(request, options = {}) {
+    if (process.platform !== "darwin" && !options.spawnImpl) {
+        logger.warn(`[MacosAlarmHelper] refusing to run helper on non-darwin platform=${process.platform}`);
+        throw new MacosAlarmHelperUnavailableError("macos-only");
+    }
+    const bin = resolveHelperBin(options.binPathOverride);
+    if (!options.spawnImpl && !existsSync(bin)) {
+        logger.warn(`[MacosAlarmHelper] helper binary missing at ${bin}; run the package build-helper script`);
+        throw new MacosAlarmHelperUnavailableError("helper-binary-missing");
+    }
+    const spawnImpl = options.spawnImpl ?? defaultSpawnHelper;
+    const proc = spawnImpl(bin, []);
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    proc.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+    proc.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+    const payload = `${JSON.stringify(request)}\n`;
+    proc.stdin.end(payload);
+    const exitCode = await new Promise((resolvePromise, rejectPromise) => {
+        let timer;
+        if (options.timeoutMs && options.timeoutMs > 0) {
+            timer = setTimeout(() => {
+                rejectPromise(new Error(`macosalarm helper timed out after ${options.timeoutMs}ms`));
+            }, options.timeoutMs);
+        }
+        proc.on("error", (err) => {
+            if (timer)
+                clearTimeout(timer);
+            rejectPromise(err);
+        });
+        proc.on("close", (code) => {
+            if (timer)
+                clearTimeout(timer);
+            resolvePromise(code);
+        });
+    });
+    const stdout = Buffer.concat(stdoutChunks).toString("utf8").trim();
+    const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+    if (stderr.length > 0) {
+        logger.debug(`[MacosAlarmHelper] stderr: ${stderr}`);
+    }
+    if (stdout.length === 0) {
+        throw new Error(`macosalarm helper produced no stdout (exit=${exitCode}); stderr=${stderr}`);
+    }
+    const lastLine = stdout
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .pop();
+    if (!lastLine) {
+        throw new Error(`macosalarm helper produced empty response (exit=${exitCode})`);
+    }
+    const parsed = JSON.parse(lastLine);
+    return parsed;
+}
+//# sourceMappingURL=helper.js.map

package/dist/helper.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./helper";
+export * from "./actions";
+export * from "./plugin";
+export { macosAlarmPlugin as default } from "./plugin";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./helper";
+export * from "./actions";
+export * from "./plugin";
+export { macosAlarmPlugin as default } from "./plugin";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "@elizaos/core";
+import { type MacosAlarmActionDeps } from "./actions";
+export declare function createMacosAlarmPlugin(deps?: MacosAlarmActionDeps): Plugin;
+export declare const macosAlarmPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,oBAAoB,EAAqB,MAAM,WAAW,CAAC;AAEzE,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,oBAAyB,GAC9B,MAAM,CAOR;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,10 @@
+import { createAlarmAction } from "./actions";
+export function createMacosAlarmPlugin(deps = {}) {
+    return {
+        name: "macosalarm",
+        description: "macOS native alarm scheduling via UNUserNotificationCenter. Auto-enabled on darwin only.",
+        actions: [createAlarmAction(deps)],
+    };
+}
+export const macosAlarmPlugin = createMacosAlarmPlugin();
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CACpC,OAA6B,EAAE;IAE/B,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,0FAA0F;QAC5F,OAAO,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAW,sBAAsB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export type MacosAlarmAction = "schedule" | "cancel" | "list" | "permission";
+export interface MacosAlarmHelperRequest {
+    action: MacosAlarmAction;
+    id?: string;
+    timeIso?: string;
+    title?: string;
+    body?: string;
+    sound?: string;
+}
+export interface MacosAlarmHelperScheduleResponse {
+    success: true;
+    id: string;
+    fireAt: string;
+}
+export interface MacosAlarmHelperCancelResponse {
+    success: true;
+    id: string;
+    cancelled: true;
+}
+export interface MacosAlarmPendingEntry {
+    id: string;
+    title: string;
+    body: string;
+    fireAt?: string;
+}
+export interface MacosAlarmHelperListResponse {
+    success: true;
+    alarms: MacosAlarmPendingEntry[];
+}
+export type MacosAlarmPermissionStatus = "authorized" | "provisional" | "denied" | "not-determined" | "ephemeral" | "unknown";
+export interface MacosAlarmHelperPermissionResponse {
+    success: true;
+    status: MacosAlarmPermissionStatus;
+}
+export interface MacosAlarmHelperErrorResponse {
+    success: false;
+    error: string;
+}
+export type MacosAlarmHelperResponse = MacosAlarmHelperScheduleResponse | MacosAlarmHelperCancelResponse | MacosAlarmHelperListResponse | MacosAlarmHelperPermissionResponse | MacosAlarmHelperErrorResponse;
+export interface MacosAlarmActionResult<T> {
+    success: boolean;
+    reason?: string;
+    data?: T;
+}
+export interface ScheduleAlarmParams {
+    timeIso: string;
+    title: string;
+    body?: string;
+    id?: string;
+    sound?: string;
+}
+export interface CancelAlarmParams {
+    id: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,IAAI,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,0BAA0B,GAClC,YAAY,GACZ,aAAa,GACb,QAAQ,GACR,gBAAgB,GAChB,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAChC,gCAAgC,GAChC,8BAA8B,GAC9B,4BAA4B,GAC5B,kCAAkC,GAClC,6BAA6B,CAAC;AAElC,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@elizaos/macosalarm",
+  "version": "2.0.0-beta.1",
+  "description": "macOS native alarm helper plugin. Schedules UNUserNotificationCenter calendar-trigger alarms via a self-contained Swift CLI invoked from the Eliza runtime.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "swift-helper/",
+    "scripts/",
+    "bin/",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "homepage": "https://github.com/elizaOS/eliza",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elizaOS/eliza.git",
+    "directory": "packages/native-plugins/macosalarm"
+  },
+  "keywords": [
+    "elizaos",
+    "macos",
+    "alarm",
+    "notifications",
+    "swift"
+  ],
+  "scripts": {
+    "prepublishOnly": "bun run build",
+    "build": "tsc -p tsconfig.json && node scripts/build-helper.mjs",
+    "build:ts": "tsc --noCheck -p tsconfig.json",
+    "build:helper": "node scripts/build-helper.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "clean": "rm -rf dist bin"
+  },
+  "dependencies": {
+    "@elizaos/core": "2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
+  },
+  "author": "elizaOS",
+  "license": "MIT",
+  "eliza": {
+    "platforms": [
+      "darwin"
+    ],
+    "runtime": "node",
+    "autoEnable": "darwin",
+    "platformDetails": {
+      "darwin": "Swift CLI helper using UNUserNotificationCenter. Non-darwin platforms receive macos-only failures."
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/build-helper.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// Builds the macOS alarm helper binary via `swiftc`.
+//
+// Outputs the binary to `bin/macosalarm-helper` inside this package so the
+// TS runtime can locate it deterministically. Skips on non-darwin platforms.
+
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(here, "..");
+const source = resolve(pkgRoot, "swift-helper", "main.swift");
+const outDir = resolve(pkgRoot, "bin");
+const outBin = resolve(outDir, "macosalarm-helper");
+const verbosePluginBuild =
+  process.env.ELIZA_VERBOSE_PLUGIN_BUILD === "1" ||
+  process.env.ELIZA_VERBOSE_PLUGIN_BUILD === "1";
+
+if (process.platform !== "darwin") {
+  console.warn(
+    `[macosalarm] skipping swift helper build on ${process.platform}`,
+  );
+  process.exit(0);
+}
+
+if (!existsSync(source)) {
+  throw new Error(`macosalarm swift source missing: ${source}`);
+}
+
+mkdirSync(outDir, { recursive: true });
+
+const result = spawnSync("swiftc", [source, "-O", "-o", outBin], {
+  stdio: "inherit",
+});
+
+if (result.status !== 0) {
+  throw new Error(`swiftc failed with status ${result.status ?? "unknown"}`);
+}
+
+if (verbosePluginBuild) {
+  console.log(`[macosalarm] built ${outBin}`);
+}

package/swift-helper/main.swift

@@ -0,0 +1,248 @@
+import Foundation
+import UserNotifications
+
+// macOS native alarm helper.
+//
+// Reads one JSON request from stdin and writes exactly one JSON response to
+// stdout before exiting. All diagnostic messages go to stderr so the parent
+// process can cleanly parse stdout as JSON.
+//
+// Request shape:
+//   { "action": "schedule" | "cancel" | "list" | "permission",
+//     "id": "...",          // required for schedule/cancel
+//     "timeIso": "...",     // required for schedule (ISO-8601)
+//     "title": "...",       // required for schedule
+//     "body": "...",        // optional for schedule
+//     "sound": "..." }      // optional for schedule ("default" or named)
+//
+// Response shape:
+//   { "success": true, ... fields per action ... }
+//   { "success": false, "error": "reason" }
+
+struct Request: Decodable {
+    let action: String
+    let id: String?
+    let timeIso: String?
+    let title: String?
+    let body: String?
+    let sound: String?
+}
+
+enum HelperError: Error {
+    case invalidRequest(String)
+    case permissionDenied(String)
+    case scheduleFailed(String)
+}
+
+func writeJSON(_ value: [String: Any]) {
+    let data = try! JSONSerialization.data(withJSONObject: value, options: [.sortedKeys])
+    FileHandle.standardOutput.write(data)
+    FileHandle.standardOutput.write("\n".data(using: .utf8)!)
+}
+
+func writeError(_ message: String) {
+    writeJSON(["success": false, "error": message])
+}
+
+func log(_ message: String) {
+    FileHandle.standardError.write("[macosalarm-helper] \(message)\n".data(using: .utf8)!)
+}
+
+func readRequest() throws -> Request {
+    let data = FileHandle.standardInput.readDataToEndOfFile()
+    guard !data.isEmpty else {
+        throw HelperError.invalidRequest("empty stdin")
+    }
+    let decoder = JSONDecoder()
+    do {
+        return try decoder.decode(Request.self, from: data)
+    } catch {
+        throw HelperError.invalidRequest("could not decode request json: \(error.localizedDescription)")
+    }
+}
+
+// UNUserNotificationCenter APIs are mostly async with completion handlers.
+// We drive them synchronously from a CLI using DispatchSemaphore.
+
+func ensureAuthorization() throws {
+    let center = UNUserNotificationCenter.current()
+    let sem = DispatchSemaphore(value: 0)
+    var authorized = false
+    var errorMessage: String?
+
+    center.getNotificationSettings { settings in
+        switch settings.authorizationStatus {
+        case .authorized, .provisional:
+            authorized = true
+            sem.signal()
+        case .notDetermined:
+            center.requestAuthorization(options: [.alert, .sound]) { granted, err in
+                authorized = granted
+                if let err = err {
+                    errorMessage = err.localizedDescription
+                }
+                sem.signal()
+            }
+        case .denied:
+            errorMessage = "notification permission denied by user"
+            sem.signal()
+        @unknown default:
+            errorMessage = "unknown notification authorization status"
+            sem.signal()
+        }
+    }
+
+    sem.wait()
+
+    if !authorized {
+        throw HelperError.permissionDenied(errorMessage ?? "notification permission not granted")
+    }
+}
+
+func schedule(_ req: Request) throws -> [String: Any] {
+    guard let id = req.id, !id.isEmpty else {
+        throw HelperError.invalidRequest("id is required")
+    }
+    guard let title = req.title, !title.isEmpty else {
+        throw HelperError.invalidRequest("title is required")
+    }
+    guard let timeIso = req.timeIso else {
+        throw HelperError.invalidRequest("timeIso is required")
+    }
+
+    let iso = ISO8601DateFormatter()
+    iso.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+    var when = iso.date(from: timeIso)
+    if when == nil {
+        iso.formatOptions = [.withInternetDateTime]
+        when = iso.date(from: timeIso)
+    }
+    guard let fireDate = when else {
+        throw HelperError.invalidRequest("timeIso is not a valid ISO-8601 timestamp")
+    }
+
+    try ensureAuthorization()
+
+    let content = UNMutableNotificationContent()
+    content.title = title
+    if let body = req.body {
+        content.body = body
+    }
+    let soundName = req.sound ?? "default"
+    if soundName == "default" {
+        content.sound = .defaultCritical
+    } else {
+        content.sound = UNNotificationSound(named: UNNotificationSoundName(rawValue: soundName))
+    }
+
+    let comps = Calendar.current.dateComponents(
+        [.year, .month, .day, .hour, .minute, .second],
+        from: fireDate
+    )
+    let trigger = UNCalendarNotificationTrigger(dateMatching: comps, repeats: false)
+    let request = UNNotificationRequest(identifier: id, content: content, trigger: trigger)
+
+    let center = UNUserNotificationCenter.current()
+    let sem = DispatchSemaphore(value: 0)
+    var addError: String?
+    center.add(request) { err in
+        if let err = err {
+            addError = err.localizedDescription
+        }
+        sem.signal()
+    }
+    sem.wait()
+
+    if let err = addError {
+        throw HelperError.scheduleFailed(err)
+    }
+
+    return [
+        "success": true,
+        "id": id,
+        "fireAt": ISO8601DateFormatter().string(from: fireDate),
+    ]
+}
+
+func cancel(_ req: Request) throws -> [String: Any] {
+    guard let id = req.id, !id.isEmpty else {
+        throw HelperError.invalidRequest("id is required")
+    }
+    UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: [id])
+    return ["success": true, "id": id, "cancelled": true]
+}
+
+func list() -> [String: Any] {
+    let center = UNUserNotificationCenter.current()
+    let sem = DispatchSemaphore(value: 0)
+    var items: [[String: Any]] = []
+    center.getPendingNotificationRequests { requests in
+        for req in requests {
+            var entry: [String: Any] = [
+                "id": req.identifier,
+                "title": req.content.title,
+                "body": req.content.body,
+            ]
+            if let cal = req.trigger as? UNCalendarNotificationTrigger,
+               let next = cal.nextTriggerDate() {
+                entry["fireAt"] = ISO8601DateFormatter().string(from: next)
+            }
+            items.append(entry)
+        }
+        sem.signal()
+    }
+    sem.wait()
+    return ["success": true, "alarms": items]
+}
+
+func permission() -> [String: Any] {
+    let center = UNUserNotificationCenter.current()
+    let sem = DispatchSemaphore(value: 0)
+    var status = "unknown"
+    center.getNotificationSettings { settings in
+        switch settings.authorizationStatus {
+        case .authorized: status = "authorized"
+        case .provisional: status = "provisional"
+        case .denied: status = "denied"
+        case .notDetermined: status = "not-determined"
+        case .ephemeral: status = "ephemeral"
+        @unknown default: status = "unknown"
+        }
+        sem.signal()
+    }
+    sem.wait()
+    return ["success": true, "status": status]
+}
+
+do {
+    let req = try readRequest()
+    switch req.action {
+    case "schedule":
+        writeJSON(try schedule(req))
+    case "cancel":
+        writeJSON(try cancel(req))
+    case "list":
+        writeJSON(list())
+    case "permission":
+        writeJSON(permission())
+    default:
+        writeError("unknown action: \(req.action)")
+        exit(2)
+    }
+} catch HelperError.invalidRequest(let msg) {
+    log("invalid request: \(msg)")
+    writeError("invalid-request: \(msg)")
+    exit(2)
+} catch HelperError.permissionDenied(let msg) {
+    log("permission denied: \(msg)")
+    writeError("permission-denied: \(msg)")
+    exit(3)
+} catch HelperError.scheduleFailed(let msg) {
+    log("schedule failed: \(msg)")
+    writeError("schedule-failed: \(msg)")
+    exit(4)
+} catch {
+    log("unexpected error: \(error.localizedDescription)")
+    writeError("unexpected: \(error.localizedDescription)")
+    exit(1)
+}