oomi-ai 0.3.6 → 0.3.7

package/agent_instructions.md

@@ -279,3 +279,19 @@ Rules:
 - Never present stale HealthKit values as current values.
 - Do not infer unavailable health fields.
 - Do not request HealthKit directly from the phone; the Oomi mobile app owns permission prompts and syncs approved data to the backend.
+
+## Phone Notifications
+
+To reach the user on their phone when they are not in the conversation, send a push notification:
+
+```bash
+oomi notify "Your 7-day plan is ready. Want to look now?" --title "Fitness" --json
+```
+
+Rules:
+
+- Notify only for things worth interrupting the user for: a reminder they asked for, a finished task, or something time-sensitive. Say everything else in chat.
+- Keep the message short and specific. The title defaults to your agent name.
+- Tapping the notification opens the Oomi app to the conversation, so follow up in chat.
+- If `notification.status` is `skipped`, tell the user `notification.guidance` instead of retrying.
+- If the request is rate limited, do not retry until `retryAfterSeconds` has passed.

package/bin/oomi-ai.js

@@ -239,6 +239,10 @@ Commands:
     Request the linked Oomi mobile app to sync fresh HealthKit context.
     Use --wait to poll until fresh context is uploaded or the timeout expires.
 
+  notify "<message>" [--title TITLE]
+    Send the linked user a push notification on their phone. Use it for things worth
+    interrupting them for; say everything else in chat. Limited per hour.
+
 Common flags:
   --agents-file PATH     Override AGENTS.md path
   --workspace PATH       Override OpenClaw workspace root
@@ -572,6 +576,16 @@ async function handleContextHealthCommand(flags = {}) {
   printStructuredResult(payload, isTruthyFlag(flags.json));
 }
 
+async function handleNotifyCommand(message, flags = {}) {
+  const client = createCliPersonaApiClient(flags);
+  const payload = await client.sendNotification({
+    body: message,
+    title: typeof flags.title === 'string' ? flags.title : undefined,
+    kind: typeof flags.kind === 'string' ? flags.kind : undefined,
+  });
+  printStructuredResult(payload, isTruthyFlag(flags.json));
+}
+
 async function handleContextFinanceCommand(_flags = {}) {
   throw new Error("oomi context finance is off until Gate A. Use the signed-in web Finance persona-app. Do not read bank balances from the connected OpenClaw shell.");
 }
@@ -4429,6 +4443,17 @@ async function main() {
     return;
   }
 
+  if (command === 'notify') {
+    // parseArgs reads the first word as a subcommand, so the message is everything after `notify`.
+    const message = [subcommand, ...args.positionals].filter(Boolean).join(' ').trim()
+      || (typeof args.flags.body === 'string' ? args.flags.body.trim() : '');
+    if (!message) {
+      throw new Error('A message is required. Usage: oomi notify "<message>" [--title <title>]');
+    }
+    await handleNotifyCommand(message, args.flags);
+    return;
+  }
+
   console.error(`Unknown command: ${command} ${subcommand || ''}`.trim());
   usage();
   process.exit(1);

package/lib/personaApiClient.js

@@ -171,5 +171,24 @@ export function createPersonaApiClient({
         },
       });
     },
+
+    sendNotification({ body, title, kind } = {}) {
+      const safeBody = trimString(body);
+      if (!safeBody) {
+        throw new Error('Notification body is required.');
+      }
+
+      return postJson({
+        fetchImpl,
+        backendUrl: resolvedBackendUrl,
+        deviceToken: resolvedDeviceToken,
+        path: '/v1/notifications',
+        body: {
+          body: safeBody,
+          title: trimString(title) || undefined,
+          kind: trimString(kind) || undefined,
+        },
+      });
+    },
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oomi-ai",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "Managed Oomi channel, bridge, voice, and persona app API tooling for OpenClaw",
   "bin": {
     "oomi": "bin/oomi-ai.js"

package/skills/oomi/SKILL.md

@@ -127,6 +127,21 @@ Rules:
 - never present stale HealthKit values as current values
 - do not ask HealthKit directly; the Oomi mobile app syncs approved HealthKit data to the backend
 
+## Phone Notifications
+
+To reach the user on their phone when they are not in the conversation:
+
+```bash
+oomi notify "Your 7-day plan is ready. Want to look now?" --title "Fitness" --json
+```
+
+Rules:
+- notify only for things worth interrupting the user for (a reminder they asked for, a finished task, something time-sensitive); say everything else in chat
+- keep it short and specific; the title defaults to your agent name
+- tapping it opens the Oomi app to the conversation, so follow up in chat
+- if `notification.status` is `skipped`, tell the user `notification.guidance` instead of retrying
+- if rate limited, wait `retryAfterSeconds` before trying again
+
 ## Hidden Speech Payload
 
 Managed voice can carry a hidden TTS-only speech sidecar alongside the normal assistant message.