@2en/clawly-plugins 1.1.2 → 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

@@ -45,6 +45,7 @@ export function getPushToken(): string | null {
 export async function sendPushNotification(
   opts: {body: string; title?: string; data?: Record<string, unknown>},
   api: PluginApi,
+  extras?: Record<string, unknown>,
 ): Promise<boolean> {
   const token = getPushToken()
   if (!token) {
@@ -62,6 +63,7 @@ export async function sendPushNotification(
         title: opts.title ?? 'Clawly',
         body: opts.body,
         data: opts.data,
+        ...extras,
       }),
     })
     const json = await res.json()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.1.2",
+  "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'