palmier 0.7.8 → 0.8.0

package/src/mcp-tools.ts

@@ -1,8 +1,8 @@
 import { StringCodec, type NatsConnection } from "nats";
 import { registerPending } from "./pending-requests.js";
 import { getCapabilityDevice } from "./device-capabilities.js";
-import { getNotifications } from "./notification-store.js";
-import { getSmsMessages } from "./sms-store.js";
+import { getNotifications, onNotificationsChanged } from "./notification-store.js";
+import { getSmsMessages, onSmsChanged } from "./sms-store.js";
 import type { HostConfig } from "./types.js";
 
 export class ToolError extends Error {
@@ -750,6 +750,8 @@ export interface ResourceDefinition {
   restPath: string;
   /** Return the current resource content. */
   read: () => unknown;
+  /** Register a listener for content changes. Returns an unsubscribe function. */
+  subscribe: (listener: () => void) => () => void;
 }
 
 const deviceNotificationsResource: ResourceDefinition = {
@@ -762,6 +764,7 @@ const deviceNotificationsResource: ResourceDefinition = {
   mimeType: "application/json",
   restPath: "/notifications",
   read: getNotifications,
+  subscribe: onNotificationsChanged,
 };
 
 const deviceSmsResource: ResourceDefinition = {
@@ -774,6 +777,7 @@ const deviceSmsResource: ResourceDefinition = {
   mimeType: "application/json",
   restPath: "/sms-messages",
   read: getSmsMessages,
+  subscribe: onSmsChanged,
 };
 
 export const agentResources: ResourceDefinition[] = [deviceNotificationsResource, deviceSmsResource];

package/src/platform/linux.ts

@@ -196,15 +196,17 @@ Environment=PATH=${process.env.PATH || "/usr/local/bin:/usr/bin:/bin"}
     fs.writeFileSync(path.join(UNIT_DIR, serviceName), serviceContent, "utf-8");
     daemonReload();
 
-    // Only create and enable a timer if triggers exist and are enabled
-    if (!task.frontmatter.triggers_enabled) return;
-    const triggers = task.frontmatter.triggers || [];
+    // Only create and enable a timer if the schedule exists and is enabled
+    if (!task.frontmatter.schedule_enabled) return;
+    const scheduleType = task.frontmatter.schedule_type;
+    const scheduleValues = task.frontmatter.schedule_values;
+    if (!scheduleType || !scheduleValues?.length) return;
     const onCalendarLines: string[] = [];
-    for (const trigger of triggers) {
-      if (trigger.type === "cron") {
-        onCalendarLines.push(`OnCalendar=${cronToOnCalendar(trigger.value)}`);
-      } else if (trigger.type === "once") {
-        onCalendarLines.push(`OnActiveSec=${trigger.value}`);
+    for (const value of scheduleValues) {
+      if (scheduleType === "crons") {
+        onCalendarLines.push(`OnCalendar=${cronToOnCalendar(value)}`);
+      } else if (scheduleType === "specific_times") {
+        onCalendarLines.push(`OnActiveSec=${value}`);
       }
     }
 

package/src/platform/windows.ts

@@ -14,22 +14,23 @@ const DAEMON_TASK_NAME = "PalmierDaemon";
 const DOW_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
 
 /**
- * Convert a cron expression or "once" trigger to Task Scheduler XML trigger elements.
+ * Convert a single schedule value to a Task Scheduler XML trigger element.
  *
- * Only these cron patterns (produced by the PWA UI) are handled:
+ * `specific_times` values are ISO datetime strings like "2026-03-28T09:00".
+ *
+ * `crons` values are cron expressions. Only these patterns (produced by the PWA UI) are handled:
  *   hourly:  "0 * * * *"
  *   daily:   "MM HH * * *"
  *   weekly:  "MM HH * * D"
  *   monthly: "MM HH D * *"
  */
-export function triggerToXml(trigger: { type: string; value: string }): string {
-  if (trigger.type === "once") {
-    // ISO datetime "2026-03-28T09:00"
-    return `<TimeTrigger><StartBoundary>${trigger.value}:00</StartBoundary></TimeTrigger>`;
+export function scheduleValueToXml(scheduleType: "crons" | "specific_times", value: string): string {
+  if (scheduleType === "specific_times") {
+    return `<TimeTrigger><StartBoundary>${value}:00</StartBoundary></TimeTrigger>`;
   }
 
-  const parts = trigger.value.trim().split(/\s+/);
-  if (parts.length !== 5) throw new Error(`Invalid cron expression: ${trigger.value}`);
+  const parts = value.trim().split(/\s+/);
+  if (parts.length !== 5) throw new Error(`Invalid cron expression: ${value}`);
   const [minute, hour, dayOfMonth, , dayOfWeek] = parts;
   const st = `${hour.padStart(2, "0")}:${minute.padStart(2, "0")}:00`;
   // StartBoundary needs a full date; use a past date as the anchor
@@ -191,14 +192,19 @@ export class WindowsPlatform implements PlatformService {
     const script = process.argv[1] || "palmier";
     const tr = `"${process.execPath}" "${script}" run ${taskId}`;
 
-    // Build trigger XML elements
+    // Build trigger XML elements. Event-based schedule types (on_new_notification,
+    // on_new_sms) carry no values and are driven by the run process, not the OS
+    // scheduler — they intentionally produce only the dummy trigger below.
     const triggerElements: string[] = [];
-    if (task.frontmatter.triggers_enabled) {
-      for (const trigger of task.frontmatter.triggers ?? []) {
+    const scheduleType = task.frontmatter.schedule_type;
+    const scheduleValues = task.frontmatter.schedule_values;
+    const isTimerSchedule = scheduleType === "crons" || scheduleType === "specific_times";
+    if (task.frontmatter.schedule_enabled && isTimerSchedule && scheduleValues?.length) {
+      for (const value of scheduleValues) {
         try {
-          triggerElements.push(triggerToXml(trigger));
+          triggerElements.push(scheduleValueToXml(scheduleType, value));
         } catch (err) {
-          console.error(`Invalid trigger: ${err}`);
+          console.error(`Invalid schedule value: ${err}`);
         }
       }
     }

package/src/rpc-handler.ts

@@ -14,6 +14,7 @@ import { publishHostEvent } from "./events.js";
 import { getCapabilityDevice, setCapabilityDevice, clearCapabilityDevice, type DeviceCapability } from "./device-capabilities.js";
 import { currentVersion, performUpdate } from "./update-checker.js";
 import { parseReportFiles, parseTaskOutcome, stripPalmierMarkers } from "./commands/run.js";
+import { clearTaskQueue } from "./event-queues.js";
 import type { HostConfig, ParsedTask, RpcMessage, ConversationMessage } from "./types.js";
 
 /**
@@ -162,7 +163,7 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
         // is active. Includes any prompts already waiting so a reconnecting
         // PWA can render their modals without replaying events.
         const capabilities: Record<string, string | null> = {};
-        for (const cap of ["location", "notifications", "sms", "contacts", "calendar", "alert", "battery", "dnd"] as const) {
+        for (const cap of ["location", "notifications", "sms", "contacts", "calendar", "alert", "battery", "dnd", "email"] as const) {
           capabilities[cap] = getCapabilityDevice(cap)?.clientToken ?? null;
         }
         return {
@@ -194,8 +195,9 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
         const params = request.params as {
           user_prompt: string;
           agent: string;
-          triggers?: Array<{ type: "cron" | "once"; value: string }>;
-          triggers_enabled?: boolean;
+          schedule_type?: "crons" | "specific_times" | "on_new_notification" | "on_new_sms";
+          schedule_values?: string[];
+          schedule_enabled?: boolean;
           requires_confirmation?: boolean;
           yolo_mode?: boolean;
           foreground_mode?: boolean;
@@ -214,9 +216,10 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
             name,
             user_prompt: params.user_prompt,
             agent: params.agent,
-            triggers: params.triggers ?? [],
-            triggers_enabled: params.triggers_enabled ?? true,
+            schedule_enabled: params.schedule_enabled ?? true,
             requires_confirmation: params.requires_confirmation ?? true,
+            ...(params.schedule_type ? { schedule_type: params.schedule_type } : {}),
+            ...(params.schedule_values?.length ? { schedule_values: params.schedule_values } : {}),
             ...(params.yolo_mode ? { yolo_mode: true } : {}),
             ...(params.foreground_mode ? { foreground_mode: true } : {}),
             ...(params.command ? { command: params.command } : {}),
@@ -235,8 +238,9 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
           id: string;
           user_prompt?: string;
           agent?: string;
-          triggers?: Array<{ type: "cron" | "once"; value: string }>;
-          triggers_enabled?: boolean;
+          schedule_type?: "crons" | "specific_times" | "on_new_notification" | "on_new_sms" | null;
+          schedule_values?: string[] | null;
+          schedule_enabled?: boolean;
           requires_confirmation?: boolean;
           yolo_mode?: boolean;
           foreground_mode?: boolean;
@@ -253,8 +257,21 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
         // Merge updates
         if (params.user_prompt !== undefined) existing.frontmatter.user_prompt = params.user_prompt;
         if (params.agent !== undefined) existing.frontmatter.agent = params.agent;
-        if (params.triggers !== undefined) existing.frontmatter.triggers = params.triggers;
-        if (params.triggers_enabled !== undefined) existing.frontmatter.triggers_enabled = params.triggers_enabled;
+        if (params.schedule_type !== undefined) {
+          if (params.schedule_type) {
+            existing.frontmatter.schedule_type = params.schedule_type;
+          } else {
+            delete existing.frontmatter.schedule_type;
+          }
+        }
+        if (params.schedule_values !== undefined) {
+          if (params.schedule_values && params.schedule_values.length > 0) {
+            existing.frontmatter.schedule_values = params.schedule_values;
+          } else {
+            delete existing.frontmatter.schedule_values;
+          }
+        }
+        if (params.schedule_enabled !== undefined) existing.frontmatter.schedule_enabled = params.schedule_enabled;
         if (params.requires_confirmation !== undefined)
           existing.frontmatter.requires_confirmation = params.requires_confirmation;
         if (params.yolo_mode !== undefined) {
@@ -290,6 +307,7 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
         const params = request.params as { id: string };
 
         getPlatform().removeTaskTimer(params.id);
+        clearTaskQueue(params.id);
         removeFromTaskList(config.projectRoot, params.id);
 
         return { ok: true, task_id: params.id };
@@ -314,8 +332,7 @@ export function createRpcHandler(config: HostConfig, nc?: NatsConnection) {
             name,
             user_prompt: params.user_prompt,
             agent: params.agent,
-            triggers: [],
-            triggers_enabled: false,
+            schedule_enabled: false,
             requires_confirmation: params.requires_confirmation ?? false,
             ...(params.yolo_mode ? { yolo_mode: true } : {}),
             ...(params.foreground_mode ? { foreground_mode: true } : {}),

package/src/task.ts

@@ -36,7 +36,7 @@ export function parseTaskContent(content: string): ParsedTask {
 
   frontmatter.name ??= frontmatter.user_prompt?.slice(0, 60) ?? "";
   frontmatter.agent ??= "claude";
-  frontmatter.triggers_enabled ??= true;
+  frontmatter.schedule_enabled ??= true;
 
   return { frontmatter };
 }

package/src/transports/http-transport.ts

@@ -9,8 +9,7 @@ import type { HostConfig, RpcMessage, RequiredPermission } from "../types.js";
 import { agentToolMap, agentResources, ToolError, type ToolContext } from "../mcp-tools.js";
 import { handleMcpRequest, getAgentName, getResourceSubscriptions } from "../mcp-handler.js";
 import { getTaskDir } from "../task.js";
-import { onNotificationsChanged } from "../notification-store.js";
-import { onSmsChanged } from "../sms-store.js";
+import { popEvent } from "../event-queues.js";
 
 // ── Bundled PWA asset serving ───────────────────────────────────────────
 
@@ -123,9 +122,9 @@ export async function startHttpTransport(
     }
   }
 
-  // Wire up resource change listeners
-  onNotificationsChanged(() => broadcastResourceUpdated("notifications://device"));
-  onSmsChanged(() => broadcastResourceUpdated("sms-messages://device"));
+  for (const resource of agentResources) {
+    resource.subscribe(() => broadcastResourceUpdated(resource.uri));
+  }
 
   // If a pairing code is provided, pre-register it
   if (pairingCode) {
@@ -281,6 +280,19 @@ export async function startHttpTransport(
       return;
     }
 
+    // ── Event queue pop (used by event-triggered palmier run) ─────────
+
+    if (req.method === "POST" && pathname === "/task-event/pop") {
+      if (!isLocalhost(req)) { sendJson(res, 403, { error: "localhost only" }); return; }
+      const taskId = url.searchParams.get("taskId");
+      if (!taskId) {
+        sendJson(res, 400, { error: "taskId query parameter is required" });
+        return;
+      }
+      sendJson(res, 200, popEvent(taskId));
+      return;
+    }
+
     // ── Localhost-only endpoints (no auth) ─────────────────────────────
 
     if (req.method === "POST" && pathname === "/event") {

package/src/types.ts

@@ -21,8 +21,16 @@ export interface TaskFrontmatter {
   name: string;
   user_prompt: string;
   agent: string;
-  triggers: Trigger[];
-  triggers_enabled: boolean;
+  /**
+   * Task schedule.
+   * - `crons`: `schedule_values` holds cron expressions (e.g. "0 9 * * *")
+   * - `specific_times`: `schedule_values` holds local datetime strings (e.g. "2026-04-20T09:00")
+   * - `on_new_notification`: fires on each new Android notification from NATS; no `schedule_values`
+   * - `on_new_sms`: fires on each new SMS from NATS; no `schedule_values`
+   */
+  schedule_type?: "crons" | "specific_times" | "on_new_notification" | "on_new_sms";
+  schedule_values?: string[];
+  schedule_enabled: boolean;
   requires_confirmation: boolean;
   yolo_mode?: boolean;
   foreground_mode?: boolean;
@@ -30,11 +38,6 @@ export interface TaskFrontmatter {
   command?: string;
 }
 
-export interface Trigger {
-  type: "cron" | "once";
-  value: string;
-}
-
 export interface ParsedTask {
   frontmatter: TaskFrontmatter;
 }