neoagent 2.3.1-beta.27 → 2.3.1-beta.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neoagent",
-  "version": "2.3.1-beta.27",
+  "version": "2.3.1-beta.28",
   "description": "Proactive personal AI agent with no limits",
   "license": "MIT",
   "main": "server/index.js",

package/server/public/flutter_bootstrap.js

@@ -37,6 +37,6 @@ _flutter.buildConfig = {"engineRevision":"59aa584fdf100e6c78c785d8a5b565d1de4b48
 
 _flutter.loader.load({
   serviceWorkerSettings: {
-    serviceWorkerVersion: "450979186" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
+    serviceWorkerVersion: "2330022069" /* Flutter's service worker is deprecated and will be removed in a future Flutter release. */
   }
 });

package/server/services/ai/tools.js

@@ -192,6 +192,54 @@ function isProactiveTrigger(triggerSource) {
     return triggerSource === 'schedule' || triggerSource === 'tasks';
 }
 
+function normalizeSendMessagePurpose(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    if (normalized === 'final_result' || normalized === 'blocker' || normalized === 'no_response') {
+        return normalized;
+    }
+    return '';
+}
+
+function validateProactiveSendMessageArgs({ purpose, normalizedMessage }) {
+    const normalizedPurpose = normalizeSendMessagePurpose(purpose);
+    if (!normalizedPurpose) {
+        return {
+            ok: false,
+            error: 'Background send_message requires purpose=final_result, blocker, or no_response.',
+            reason: 'Background send_message requires purpose=final_result, blocker, or no_response.',
+        };
+    }
+
+    if (normalizedPurpose === 'no_response') {
+        if (normalizedMessage !== '[NO RESPONSE]') {
+            return {
+                ok: false,
+                error: 'purpose=no_response requires content "[NO RESPONSE]".',
+                reason: 'purpose=no_response requires content "[NO RESPONSE]".',
+            };
+        }
+        return {
+            ok: false,
+            skipped: true,
+            suppressed: true,
+            reason: 'no_response',
+        };
+    }
+
+    if (normalizedMessage === '[NO RESPONSE]') {
+        return {
+            ok: false,
+            error: `purpose=${normalizedPurpose} cannot use content "[NO RESPONSE]".`,
+            reason: `purpose=${normalizedPurpose} cannot use content "[NO RESPONSE]".`,
+        };
+    }
+
+    return {
+        ok: true,
+        purpose: normalizedPurpose,
+    };
+}
+
 function getRunState(engine, runId) {
     if (!engine || !runId) return null;
     return engine.activeRuns.get(runId) || null;
@@ -742,14 +790,15 @@ function getAvailableTools(app, options = {}) {
         },
         {
             name: 'send_message',
-            description: `Send a message on a connected messaging platform. Supports WhatsApp (text/media), Telnyx Voice (phone calls — TTS), Discord, Telegram, Slack, Google Chat, Microsoft Teams, Matrix, Signal, iMessage/BlueBubbles, IRC, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, WeChat, WebChat, and configurable webhook bridges. ${buildSendMessageFormattingReference()} For WhatsApp: use media_path to attach files. Use content "[NO RESPONSE]" only when the user explicitly asked for silence or no reply.`,
+            description: `Send a message on a connected messaging platform. Supports WhatsApp (text/media), Telnyx Voice (phone calls — TTS), Discord, Telegram, Slack, Google Chat, Microsoft Teams, Matrix, Signal, iMessage/BlueBubbles, IRC, Feishu, LINE, Mattermost, Nextcloud Talk, Nostr, Synology Chat, Tlon, Twitch, Zalo, WeChat, WebChat, and configurable webhook bridges. ${buildSendMessageFormattingReference()} For WhatsApp: use media_path to attach files. Use content "[NO RESPONSE]" only when the user explicitly asked for silence or no reply. For background task or schedule runs, set purpose to final_result, blocker, or no_response.`,
             parameters: {
                 type: 'object',
                 properties: {
                     platform: { type: 'string', description: 'Platform name, for example whatsapp, telnyx, discord, telegram, slack, google_chat, teams, matrix, signal, imessage, bluebubbles, irc, line, mattermost, or webchat' },
                     to: { type: 'string', description: 'Recipient/chat ID for the connected platform, such as a WhatsApp chat ID, Telnyx call_control_id, Slack channel ID, Matrix room ID, Discord channel snowflake / "dm_<userId>", Telegram "dm_<userId>" / raw group chat ID, IRC channel, or webhook target' },
                     content: { type: 'string', description: 'Message text. Write one compact natural chat reply; the runtime adapts final formatting for the destination platform.' },
-                    media_path: { type: 'string', description: 'WhatsApp only: absolute path to a local file to attach. Leave empty for text-only or Telnyx.' }
+                    media_path: { type: 'string', description: 'WhatsApp only: absolute path to a local file to attach. Leave empty for text-only or Telnyx.' },
+                    purpose: { type: 'string', enum: ['final_result', 'blocker', 'no_response'], description: 'For background task or schedule runs, required intent for this outbound message. Use final_result for a concrete useful outcome, blocker for a real issue the user should know about, or no_response to intentionally send nothing.' }
                 },
                 required: ['platform', 'to', 'content']
             }
@@ -1986,6 +2035,25 @@ async function executeTool(toolName, args, context, engine) {
                 stripNoResponseMarker: false
             });
             const suppressReply = normalizedMessage === '[NO RESPONSE]';
+            if (isProactiveTrigger(triggerSource)) {
+                const proactiveValidation = validateProactiveSendMessageArgs({
+                    purpose: args.purpose,
+                    normalizedMessage,
+                });
+                if (!proactiveValidation.ok) {
+                    if (proactiveValidation.error) {
+                        return {
+                            error: proactiveValidation.error,
+                        };
+                    }
+                    return {
+                        sent: false,
+                        suppressed: proactiveValidation.suppressed === true,
+                        skipped: proactiveValidation.skipped === true,
+                        reason: proactiveValidation.reason,
+                    };
+                }
+            }
             if (!suppressReply && hasAlreadySentProactiveMessage({
                 triggerSource,
                 runState,
@@ -2701,4 +2769,4 @@ async function executeTool(toolName, args, context, engine) {
     }
 }
 
-module.exports = { getAvailableTools, executeTool };
+module.exports = { getAvailableTools, executeTool, validateProactiveSendMessageArgs };

package/server/services/integrations/figma/provider.js

@@ -240,6 +240,7 @@ function createFigmaProvider() {
     description:
       'Official Figma OAuth account connections for future design file and collaboration workflows.',
     icon: 'figma',
+    requiresRefreshToken: true,
     apps: FIGMA_APPS,
     toolDefinitions: figmaToolDefinitions,
     connectPrompt:

package/server/services/integrations/google/provider.js

@@ -300,6 +300,7 @@ function createGoogleWorkspaceProvider() {
     description:
       'Official Gmail, Calendar, Drive, Docs, and Sheets integrations with app-specific accounts.',
     icon: 'google',
+    requiresRefreshToken: true,
     apps: GOOGLE_WORKSPACE_APPS.map(({ id, label, description }) => ({
       id,
       label,

package/server/services/integrations/home_assistant/provider.js

@@ -524,6 +524,7 @@ function createHomeAssistantProvider() {
     description:
       'Official Home Assistant account connections for entity state reads, service control, and automation support.',
     icon: 'home_assistant',
+    requiresRefreshToken: true,
     apps: HOME_ASSISTANT_APPS,
     toolDefinitions: homeAssistantToolDefinitions,
     connectPrompt:

package/server/services/integrations/manager.js

@@ -29,6 +29,27 @@ function isLikelyExpiredConnectionError(error) {
   ].some((hint) => message.includes(hint));
 }
 
+function assertDurableOAuthCredentials(provider, credentials) {
+  const label = String(provider?.label || 'This integration').trim() || 'This integration';
+  const normalizedCredentials =
+    credentials && typeof credentials === 'object' ? credentials : {};
+
+  if (!String(normalizedCredentials.access_token || '').trim()) {
+    throw new Error(
+      `${label} did not return an access token, so the connection could not be completed.`,
+    );
+  }
+
+  if (
+    provider?.requiresRefreshToken === true &&
+    !String(normalizedCredentials.refresh_token || '').trim()
+  ) {
+    throw new Error(
+      `${label} did not return a refresh token, so the connection would expire. Revoke the existing app grant for this provider and reconnect it so offline access is granted.`,
+    );
+  }
+}
+
 class IntegrationManager {
   constructor(options = {}) {
     this.app = options.app || null;
@@ -303,11 +324,7 @@ class IntegrationManager {
       result.accountEmail,
       result.credentials,
     );
-    if (!mergedCredentials.refresh_token) {
-      throw new Error(
-        `${provider.label} did not return a refresh token, so the connection would expire. Revoke the existing app grant for this provider and reconnect it so offline access is granted.`,
-      );
-    }
+    assertDurableOAuthCredentials(provider, mergedCredentials);
 
     db.prepare(
       `INSERT INTO integration_connections (
@@ -727,5 +744,6 @@ class IntegrationManager {
 }
 
 module.exports = {
+  assertDurableOAuthCredentials,
   IntegrationManager,
 };

package/server/services/integrations/microsoft/provider.js

@@ -346,6 +346,7 @@ function createMicrosoftProvider() {
     description:
       'Official Microsoft 365 OAuth account connections for Outlook, Calendar, OneDrive, and Teams.',
     icon: 'microsoft',
+    requiresRefreshToken: true,
     apps: MICROSOFT_APPS,
     toolDefinitions: microsoftToolDefinitions,
     connectPrompt:

package/server/services/integrations/oauth_provider.js

@@ -241,6 +241,7 @@ function createOAuthProvider(options = {}) {
     label: options.label,
     description: options.description,
     icon: options.icon,
+    requiresRefreshToken: options.requiresRefreshToken === true,
     apps: apps.map(({ id, label, description }) => ({ id, label, description })),
     connectPrompt: options.connectPrompt || null,
     supportsMultipleAccounts: options.supportsMultipleAccounts !== false,

package/server/services/integrations/spotify/provider.js

@@ -394,6 +394,7 @@ function createSpotifyProvider() {
     label: 'Spotify',
     description: 'Official Spotify account integration for music search and playback control.',
     icon: 'spotify',
+    requiresRefreshToken: true,
     apps: SPOTIFY_APPS,
     toolDefinitions: spotifyToolDefinitions,
     connectPrompt:

package/server/services/tasks/runtime.js

@@ -296,7 +296,7 @@ class TaskRuntime {
       if (normalizedConfig.callTo) {
         notifyHint = `\n\nThis task is configured to notify the user by phone. Use the make_call tool to call "${normalizedConfig.callTo}" with an appropriate greeting based on your findings. The configured greeting hint is: "${normalizedConfig.callGreeting || 'Hello, this is your task reminder.'}"`;
       } else if (normalizedConfig.notifyPlatform && normalizedConfig.notifyTo) {
-        notifyHint = `\n\nIf your task result is worth notifying the user about, send it proactively via send_message to platform="${normalizedConfig.notifyPlatform}" to="${normalizedConfig.notifyTo}".`;
+        notifyHint = `\n\nIf your task result is worth notifying the user about, send it proactively via send_message to platform="${normalizedConfig.notifyPlatform}" to="${normalizedConfig.notifyTo}" and set purpose="final_result" for a concrete useful outcome or purpose="blocker" for a real issue the user should know about. If nothing important or actionable changed, call send_message with purpose="no_response" and content="[NO RESPONSE]".`;
       }
 
       const triggerPayloadText = executionMeta.triggerPayload