@2en/clawly-plugins 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "module": "index.ts",
   "type": "module",
   "repository": {
@@ -12,6 +12,7 @@
     "zx": "npm:zx@8.8.5-lite"
   },
   "files": [
+    "tools",
     "index.ts",
     "channel.ts",
     "cron-hook.ts",

package/tools/clawly-is-user-online.ts

@@ -0,0 +1,35 @@
+/**
+ * Agent tool: clawly_is_user_online — check if the user's mobile
+ * device is currently connected to the OpenClaw gateway.
+ *
+ */
+
+import type {PluginApi} from '../index'
+import {isClientOnline} from '../presence'
+
+const TOOL_NAME = 'clawly_is_user_online'
+
+const parameters: Record<string, unknown> = {
+  type: 'object',
+  properties: {
+    host: {
+      type: 'string',
+      description: 'Presence host identifier (default: "openclaw-ios")',
+    },
+  },
+}
+
+export function registerIsUserOnlineTool(api: PluginApi) {
+  api.registerTool({
+    name: TOOL_NAME,
+    description: "Check if the user's mobile device is currently online.",
+    parameters,
+    async execute(_toolCallId, params) {
+      const host = typeof params.host === 'string' ? params.host : undefined
+      const isOnline = await isClientOnline(host)
+      return {content: [{type: 'text', text: JSON.stringify({isOnline})}]}
+    },
+  })
+
+  api.logger.info(`tool: registered ${TOOL_NAME} agent tool`)
+}

package/tools/clawly-send-app-push.ts

@@ -0,0 +1,80 @@
+/**
+ * Agent tool: clawly_send_app_push — send a push notification to
+ * the user's phone from the LLM agent during a conversation.
+ *
+ * Expo push API reference:
+ * https://docs.expo.dev/push-notifications/sending-notifications/
+ */
+
+import type {PluginApi} from '../index'
+import {sendPushNotification} from '../notification'
+
+const TOOL_NAME = 'clawly_send_app_push'
+
+const parameters: Record<string, unknown> = {
+  type: 'object',
+  required: ['body'],
+  properties: {
+    body: {type: 'string', description: 'Notification message'},
+    title: {type: 'string', description: 'Title (default: "Clawly")'},
+    subtitle: {type: 'string', description: 'iOS subtitle'},
+    sound: {
+      type: ['string', 'null'],
+      description: 'Sound name (default: "default")',
+    },
+    badge: {type: 'number', description: 'iOS badge count'},
+    data: {type: 'object', description: 'Custom JSON payload'},
+    ttl: {type: 'number', description: 'Seconds to keep for redelivery'},
+    expiration: {type: 'number', description: 'Unix timestamp expiry'},
+    priority: {
+      type: 'string',
+      enum: ['default', 'normal', 'high'],
+      description: 'Delivery priority',
+    },
+    channelId: {type: 'string', description: 'Android notification channel'},
+    categoryId: {type: 'string', description: 'Notification category'},
+    interruptionLevel: {
+      type: 'string',
+      enum: ['active', 'critical', 'passive', 'time-sensitive'],
+      description: 'iOS interruption level',
+    },
+    mutableContent: {type: 'boolean', description: 'iOS mutable content'},
+    richContent: {
+      type: 'object',
+      description: 'Rich content (e.g. {image: url})',
+    },
+  },
+}
+
+export function registerSendAppPushTool(api: PluginApi) {
+  api.registerTool({
+    name: TOOL_NAME,
+    description: "Send a push notification to the user's phone.",
+    parameters,
+    async execute(_toolCallId, params) {
+      const body = typeof params.body === 'string' ? params.body.trim() : ''
+      if (!body) {
+        return {content: [{type: 'text', text: JSON.stringify({error: 'body is required'})}]}
+      }
+
+      const title = typeof params.title === 'string' ? params.title : undefined
+      const data =
+        typeof params.data === 'object' && params.data !== null
+          ? (params.data as Record<string, unknown>)
+          : undefined
+
+      // Collect Expo-specific extras (everything except body/title/data)
+      const {body: _body, title: _title, data: _data, ...extras} = params
+      const hasExtras = Object.keys(extras).length > 0
+
+      const sent = await sendPushNotification(
+        {body, title, data},
+        api,
+        hasExtras ? extras : undefined,
+      )
+      return {content: [{type: 'text', text: JSON.stringify({sent})}]}
+    },
+  })
+
+  api.logger.info(`tool: registered ${TOOL_NAME} agent tool`)
+}