@2en/clawly-plugins 1.7.2 → 1.10.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/gateway/memory.ts

@@ -37,21 +37,25 @@ function coercePluginConfig(api: PluginApi): Record<string, unknown> {
   return isRecord(api.pluginConfig) ? api.pluginConfig : {}
 }
 
-/** Resolve the memory directory path. Memory lives under workspace (agents.defaults.workspace). */
-function resolveMemoryDir(api: PluginApi, profile?: string): string {
+/** Resolve the workspace root directory (without /memory suffix). */
+function resolveWorkspaceRoot(api: PluginApi, profile?: string): string {
   const cfg = coercePluginConfig(api)
   const configPath = configString(cfg, 'memoryDir')
-  if (configPath) return configPath
+  if (configPath) return path.dirname(configPath) // strip /memory if configured
 
   const baseDir =
     process.env.OPENCLAW_WORKSPACE ?? path.join(os.homedir(), '.openclaw', 'workspace')
-  // Profile-aware: "main" or empty → default workspace, otherwise workspace-<profile>
   if (profile && profile !== 'main') {
     const parentDir = path.dirname(baseDir)
     const baseName = path.basename(baseDir)
-    return path.join(parentDir, `${baseName}-${profile}`, 'memory')
+    return path.join(parentDir, `${baseName}-${profile}`)
   }
-  return path.join(baseDir, 'memory')
+  return baseDir
+}
+
+/** Resolve the memory directory path. Memory lives under workspace (agents.defaults.workspace). */
+function resolveMemoryDir(api: PluginApi, profile?: string): string {
+  return path.join(resolveWorkspaceRoot(api, profile), 'memory')
 }
 
 /** Check that a relative path is safe (no directory traversal). */
@@ -89,6 +93,21 @@ async function collectMdFiles(dir: string, baseDir: string, acc: string[] = []):
   return acc
 }
 
+/** List only root-level .md files in a directory (non-recursive). */
+async function listRootMdFiles(dir: string): Promise<string[]> {
+  let entries: fs.Dirent[]
+  try {
+    entries = await fs.readdir(dir, {withFileTypes: true})
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code === 'ENOENT') return []
+    throw err
+  }
+  return entries
+    .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md'))
+    .map((e) => e.name)
+    .sort()
+}
+
 export function registerMemoryBrowser(api: PluginApi) {
   const memoryDir = resolveMemoryDir(api)
   api.logger.info(`memory-browser: memory directory: ${memoryDir}`)
@@ -99,10 +118,19 @@ export function registerMemoryBrowser(api: PluginApi) {
   api.registerGatewayMethod('memory-browser.list', async ({params, respond}) => {
     try {
       const profile = readString(params, 'profile')
-      const dir = profile ? resolveMemoryDir(api, profile) : memoryDir
-      const files = await collectMdFiles(dir, dir)
-      api.logger.info(`memory-browser.list: ${files.length} files found`)
-      files.sort()
+      const scope = readString(params, 'scope') ?? 'memory'
+
+      let files: string[]
+      if (scope === 'root') {
+        const wsRoot = resolveWorkspaceRoot(api, profile)
+        files = await listRootMdFiles(wsRoot)
+        api.logger.info(`memory-browser.list (root): ${files.length} files found in ${wsRoot}`)
+      } else {
+        const dir = profile ? resolveMemoryDir(api, profile) : memoryDir
+        files = await collectMdFiles(dir, dir)
+        files.sort()
+        api.logger.info(`memory-browser.list: ${files.length} files found`)
+      }
       respond(true, {files})
     } catch (err) {
       api.logger.error(
@@ -121,7 +149,13 @@ export function registerMemoryBrowser(api: PluginApi) {
   api.registerGatewayMethod('memory-browser.get', async ({params, respond}) => {
     const relativePath = readString(params, 'path')
     const profile = readString(params, 'profile')
-    const dir = profile ? resolveMemoryDir(api, profile) : memoryDir
+    const scope = readString(params, 'scope') ?? 'memory'
+    const dir =
+      scope === 'root'
+        ? resolveWorkspaceRoot(api, profile)
+        : profile
+          ? resolveMemoryDir(api, profile)
+          : memoryDir
     if (!relativePath) {
       respond(false, undefined, {
         code: 'invalid_params',

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.10.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)
 }