@2en/clawly-plugins 1.17.0 → 1.17.1

package/cron-hook.ts

@@ -24,7 +24,7 @@ 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.',
+  '1. Call the clawly_send_message tool with role="assistant" and 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')

package/package.json

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

package/tools/clawly-send-message.ts

@@ -2,9 +2,9 @@
  * Agent tool: clawly_send_message — send a message to the main session
  * agent from an isolated context (e.g. cron job).
  *
- * - role: "user" (default) — triggers agent turn via gateway RPC
- * - role: "assistant" — injects into transcript via chat.inject (no agent trigger,
+ * - role: "assistant" (default) — injects into transcript via chat.inject (no agent trigger,
  *   since the calling agent has already decided to send)
+ * - role: "user" — triggers agent turn via gateway RPC
  */
 
 import type {PluginApi} from '../index'
@@ -23,7 +23,7 @@ const parameters: Record<string, unknown> = {
       type: 'string',
       enum: ['user', 'assistant'],
       description:
-        'Message role. "user" (default) sends as user and triggers agent run. "assistant" injects into transcript as assistant without triggering a run.',
+        'Message role. "assistant" (default) injects into transcript as assistant without triggering a run. "user" sends as user and triggers agent run.',
     },
     sessionKey: {
       type: 'string',
@@ -36,7 +36,7 @@ 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. Set role to "assistant" to inject the message directly into the transcript without triggering an agent run.',
+      'Send a message to the user via the main session. Use this from cron jobs or isolated sessions to deliver results to the user. By default injects as an assistant message (no agent run). Set role to "user" to trigger an agent run instead.',
     parameters,
     async execute(_toolCallId, params) {
       const message = typeof params.message === 'string' ? params.message.trim() : ''
@@ -45,7 +45,7 @@ export function registerSendMessageTool(api: PluginApi) {
       }
 
       const agent = typeof params.agent === 'string' ? params.agent.trim() : 'clawly'
-      const role = params.role === 'assistant' ? 'assistant' : 'user'
+      const role = params.role === 'user' ? 'user' : 'assistant'
 
       try {
         if (role === 'assistant') {