@2en/clawly-plugins 1.7.2 → 1.8.0

package/cron-hook.ts

@@ -2,7 +2,8 @@
  * before_tool_call hook for cron (action=add) — ensures delivery fields are
  * always set correctly, even when the LLM omits them.
  *
- * Forces: delivery.mode = "none" (agent uses message/push tools explicitly)
+ * Forces: delivery.mode = "none" (agent uses clawly_send_message/push tools)
+ * Appends: delivery instructions to payload.message
  * Patches: payload.kind "systemEvent" → "agentTurn"
  *
  * The cron tool name is "cron" (not "cron.create"). The LLM passes
@@ -18,15 +19,33 @@ function isRecord(v: unknown): v is UnknownRecord {
   return typeof v === 'object' && v !== null && !Array.isArray(v)
 }
 
+const DELIVERY_SUFFIX = [
+  '',
+  '---',
+  'DELIVERY INSTRUCTIONS (mandatory):',
+  'When done, you MUST deliver your result to the user:',
+  '1. Call the clawly_send_message tool with a brief, natural summary of your result.',
+  '2. Call clawly_is_user_online to check if the user is online.',
+  '3. If offline, also call clawly_send_app_push with a short notification.',
+].join('\n')
+
 function patchJob(job: UnknownRecord): UnknownRecord {
   const patched: UnknownRecord = {...job}
 
-  // Force delivery.mode = "none" — agent reports via message/push tools explicitly
+  // Force delivery.mode = "none" — agent reports via tools explicitly
   patched.delivery = {mode: 'none'}
 
+  // Append delivery instructions to payload.message
+  if (isRecord(job.payload) && typeof job.payload.message === 'string') {
+    patched.payload = {
+      ...job.payload,
+      message: job.payload.message + DELIVERY_SUFFIX,
+    }
+  }
+
   // Patch payload.kind: systemEvent → agentTurn
-  if (isRecord(job.payload) && job.payload.kind === 'systemEvent') {
-    patched.payload = {...job.payload, kind: 'agentTurn'}
+  if (isRecord(patched.payload) && (patched.payload as UnknownRecord).kind === 'systemEvent') {
+    patched.payload = {...(patched.payload as UnknownRecord), kind: 'agentTurn'}
   }
 
   return patched

package/index.ts

@@ -15,6 +15,7 @@
  * 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
+ * - clawly_send_message      — send a message to user via main session agent
  *
  * Commands:
  * - /clawly_echo          — echo text back without LLM

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2en/clawly-plugins",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "module": "index.ts",
   "type": "module",
   "repository": {

package/tools/clawly-send-message.ts

@@ -0,0 +1,54 @@
+/**
+ * Agent tool: clawly_send_message — send a message to the main session
+ * agent from an isolated context (e.g. cron job).
+ *
+ * Runs `openclaw agent --agent <agent> --message <message>` which delivers
+ * the text as a natural assistant response in the user's chat.
+ */
+
+import {$} from 'zx'
+import type {PluginApi} from '../index'
+
+$.verbose = false
+
+const TOOL_NAME = 'clawly_send_message'
+
+const parameters: Record<string, unknown> = {
+  type: 'object',
+  required: ['message'],
+  properties: {
+    message: {type: 'string', description: 'The message to send to the user'},
+    agent: {type: 'string', description: 'Target agent ID (default: "clawly")'},
+  },
+}
+
+export function registerSendMessageTool(api: PluginApi) {
+  api.registerTool({
+    name: TOOL_NAME,
+    description:
+      'Send a message to the user via the main session agent. Use this from cron jobs or isolated sessions to deliver results to the user.',
+    parameters,
+    async execute(_toolCallId, params) {
+      const message = typeof params.message === 'string' ? params.message.trim() : ''
+      if (!message) {
+        return {content: [{type: 'text', text: JSON.stringify({error: 'message is required'})}]}
+      }
+
+      const agent = typeof params.agent === 'string' ? params.agent.trim() : 'clawly'
+
+      try {
+        await $`openclaw agent --agent ${agent} --message ${message}`
+        api.logger.info(
+          `${TOOL_NAME}: delivered message (${message.length} chars) to agent ${agent}`,
+        )
+        return {content: [{type: 'text', text: JSON.stringify({sent: true})}]}
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err)
+        api.logger.error(`${TOOL_NAME}: failed — ${msg}`)
+        return {content: [{type: 'text', text: JSON.stringify({sent: false, error: msg})}]}
+      }
+    },
+  })
+
+  api.logger.info(`tool: registered ${TOOL_NAME} agent tool`)
+}

package/tools/index.ts

@@ -1,8 +1,10 @@
 import type {PluginApi} from '../index'
 import {registerIsUserOnlineTool} from './clawly-is-user-online'
 import {registerSendAppPushTool} from './clawly-send-app-push'
+import {registerSendMessageTool} from './clawly-send-message'
 
 export function registerTools(api: PluginApi) {
   registerIsUserOnlineTool(api)
   registerSendAppPushTool(api)
+  registerSendMessageTool(api)
 }