@2en/clawly-plugins 1.1.1 → 1.2.0

package/index.ts

@@ -9,6 +9,10 @@
  * - clawly.agent.send        — send a message to the agent (+ optional push)
  * - clawly.agent.echo        — echo-wrapped agent message (bypasses LLM)
  *
+ * Agent tools:
+ * - clawly_is_user_online    — check if user's device is connected
+ * - clawly_send_app_push     — send a push notification to user's device
+ *
  * Commands:
  * - /clawly_echo          — echo text back without LLM
  *
@@ -17,6 +21,7 @@
  */
 
 import {registerAgentSend} from './agent-send'
+import {registerIsUserOnlineTool, registerSendAppPushTool} from './tools'
 import {registerEchoCommand} from './echo'
 import {registerNotification} from './notification'
 import {registerOutboundHook, registerOutboundMethods} from './outbound'
@@ -53,6 +58,18 @@ export type PluginApi = {
     requireAuth?: boolean
     handler: (ctx: {args?: string}) => Promise<{text: string}> | {text: string}
   }) => void
+  registerTool: (
+    tool: {
+      name: string
+      description: string
+      parameters: Record<string, unknown>
+      execute: (
+        toolCallId: string,
+        params: Record<string, unknown>,
+      ) => Promise<{content: Array<{type: string; text: string}>; details?: unknown}>
+    },
+    opts?: {optional?: boolean},
+  ) => void
 }
 
 export default {
@@ -66,6 +83,8 @@ export default {
     registerPresence(api)
     registerNotification(api)
     registerAgentSend(api)
+    registerIsUserOnlineTool(api)
+    registerSendAppPushTool(api)
     api.logger.info(`Loaded ${api.id} plugin.`)
   },
 }

package/notification.ts

@@ -19,24 +19,6 @@ const TOKEN_DIR = path.join(os.homedir(), '.openclaw', 'clawly')
 const TOKEN_FILE = path.join(TOKEN_DIR, 'expo-push-token.json')
 const EXPO_PUSH_URL = 'https://exp.host/--/api/v2/push/send'
 
-let pushToken: string | null = null
-
-function loadPersistedToken(api: PluginApi): void {
-  try {
-    if (fs.existsSync(TOKEN_FILE)) {
-      const data = JSON.parse(fs.readFileSync(TOKEN_FILE, 'utf-8'))
-      if (typeof data.token === 'string' && data.token) {
-        pushToken = data.token
-        api.logger.info(`notification: loaded persisted push token`)
-      }
-    }
-  } catch (err) {
-    api.logger.warn(
-      `notification: failed to load persisted token: ${err instanceof Error ? err.message : String(err)}`,
-    )
-  }
-}
-
 function persistToken(token: string, api: PluginApi): void {
   try {
     fs.mkdirSync(TOKEN_DIR, {recursive: true})
@@ -49,14 +31,24 @@ function persistToken(token: string, api: PluginApi): void {
 }
 
 export function getPushToken(): string | null {
-  return pushToken
+  try {
+    if (fs.existsSync(TOKEN_FILE)) {
+      const data = JSON.parse(fs.readFileSync(TOKEN_FILE, 'utf-8'))
+      if (typeof data.token === 'string' && data.token) {
+        return data.token
+      }
+    }
+  } catch {}
+  return null
 }
 
 export async function sendPushNotification(
   opts: {body: string; title?: string; data?: Record<string, unknown>},
   api: PluginApi,
+  extras?: Record<string, unknown>,
 ): Promise<boolean> {
-  if (!pushToken) {
+  const token = getPushToken()
+  if (!token) {
     api.logger.warn('notification: no push token registered, skipping notification')
     return false
   }
@@ -66,13 +58,15 @@ export async function sendPushNotification(
       method: 'POST',
       headers: {'Content-Type': 'application/json'},
       body: JSON.stringify({
-        to: pushToken,
+        to: token,
         sound: 'default',
         title: opts.title ?? 'Clawly',
         body: opts.body,
         data: opts.data,
+        ...extras,
       }),
     })
+    const json = await res.json()
 
     if (!res.ok) {
       api.logger.error(`notification: push failed — ${res.status} ${res.statusText}`)
@@ -90,8 +84,6 @@ export async function sendPushNotification(
 }
 
 export function registerNotification(api: PluginApi) {
-  loadPersistedToken(api)
-
   api.registerGatewayMethod('clawly.notification.setToken', async ({params, respond}) => {
     const token = typeof params.token === 'string' ? params.token.trim() : ''
 
@@ -100,7 +92,6 @@ export function registerNotification(api: PluginApi) {
       return
     }
 
-    pushToken = token
     persistToken(token, api)
     api.logger.info('notification: push token registered')
     respond(true, {registered: true})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "module": "index.ts",
   "type": "module",
   "repository": {
@@ -18,6 +18,7 @@
     "presence.ts",
     "notification.ts",
     "agent-send.ts",
+    "tools.ts",
     "openclaw.plugin.json"
   ],
   "publishConfig": {

package/tools.ts

@@ -0,0 +1,2 @@
+export {registerIsUserOnlineTool} from './tools/clawly-is-user-online'
+export {registerSendAppPushTool} from './tools/clawly-send-app-push'