neoagent 2.5.2-beta.9 → 3.0.0

package/README.md

@@ -19,7 +19,11 @@
 </p>
 
 <p align="center">
-  <img src="demo.gif" alt="NeoAgent operator interface" width="100%">
+  <a href="https://www.producthunt.com/products/neoagent-2?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-neoagent-2" target="_blank" rel="noopener noreferrer"><img alt="NeoAgent - The next-gen self-hosted AI agent that works beyond chat | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1171573&theme=light&t=1781447653039"></a>
+</p>
+
+<p align="center">
+  <img src="demo.gif" alt="NeoAgent demo" width="100%">
 </p>
 
 ## 🚀 Install

package/docs/integrations.md

@@ -36,15 +36,19 @@ or delete data.
 
 ### Setup
 
-Google, Microsoft, GitHub, Notion, Slack, Figma, and Spotify require OAuth
-application credentials on the server. The default callback is:
 
-```text
-PUBLIC_URL/api/integrations/oauth/callback
-```
+Google, Microsoft, GitHub, Notion, Slack, Figma, and Spotify require OAuth application credentials on the server. The default callback is:
+`PUBLIC_URL/api/integrations/oauth/callback`
+
+**GitHub OAuth Configuration:**
+1. Navigate to your GitHub Developer Settings and create a new **OAuth App**.
+2. Set the Authorization callback URL to: `PUBLIC_URL/api/integrations/oauth/callback`.
+3. Generate a **Client ID** and **Client Secret**.
+4. Add these to your server environment configuration:
+   - `GITHUB_CLIENT_ID=your_id_here`
+   - `GITHUB_CLIENT_SECRET=your_secret_here`
 
-Home Assistant and Trello can be configured for a user from the application.
-See [Configuration](configuration.md#official-integrations).
+Home Assistant and Trello can be configured for a user from the application. See Configuration.
 
 ## Messaging channels
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "neoagent",
-  "version": "2.5.2-beta.9",
-  "description": "Proactive personal AI agent with no limits",
+  "version": "3.0.0",
+  "description": "Self-hosted AI agent for long-running tasks, automation, messaging, device control, and local memory",
   "license": "AGPL-3.0-only",
   "main": "server/index.js",
   "engines": {

package/server/public/.last_build_id

@@ -1 +1 @@
-241a9aee71aa1081e7b09f220208b1ae
+0aebc22637251b8ff07f20355c6f3771

package/server/public/flutter_bootstrap.js

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

package/server/public/main.dart.js

@@ -134794,7 +134794,7 @@ r===$&&A.b()
 p.push(A.jP(q,A.j9(!1,new A.a_(B.uG,A.d8(new A.cA(B.jt,new A.a7N(r,q),q),q,q),q),!1,B.H,!0),q,q,0,0,0,q))}r=!1
 if(!s.ay)if(!s.ch){r=s.e
 r===$&&A.b()
-r=B.b.u("mqg8e73f-4f4cc33").length!==0&&r.b}if(r){r=s.d
+r=B.b.u("mqh4zb5l-21f53dd").length!==0&&r.b}if(r){r=s.d
 r===$&&A.b()
 r=r.aP&&!r.ai?84:0
 s=s.e
@@ -140506,7 +140506,7 @@ $S:0}
 A.a_6.prototype={}
 A.SQ.prototype={
 nb(a){var s=this
-if(B.b.u("mqg8e73f-4f4cc33").length===0||s.a!=null)return
+if(B.b.u("mqh4zb5l-21f53dd").length===0||s.a!=null)return
 s.AU()
 s.a=A.on(B.RH,new A.bc8(s))},
 AU(){var s=0,r=A.l(t.H),q,p=2,o=[],n=this,m,l,k,j,i,h,g,f
@@ -140524,7 +140524,7 @@ if(!t.f.b(k)){s=1
 break}i=J.a3(k,"buildId")
 h=i==null?null:B.b.u(J.p(i))
 j=h==null?"":h
-if(J.bi(j)===0||J.d(j,"mqg8e73f-4f4cc33")){s=1
+if(J.bi(j)===0||J.d(j,"mqh4zb5l-21f53dd")){s=1
 break}n.b=!0
 n.F()
 p=2
@@ -140541,7 +140541,7 @@ case 2:return A.i(o.at(-1),r)}})
 return A.k($async$AU,r)},
 vE(){var s=0,r=A.l(t.H),q,p=2,o=[],n=this,m,l,k,j,i,h,g,f,e,d,c,b,a,a0,a1
 var $async$vE=A.h(function(a2,a3){if(a2===1){o.push(a3)
-s=p}for(;;)switch(s){case 0:if(B.b.u("mqg8e73f-4f4cc33").length===0||n.c){s=1
+s=p}for(;;)switch(s){case 0:if(B.b.u("mqh4zb5l-21f53dd").length===0||n.c){s=1
 break}n.c=!0
 n.F()
 p=4

package/server/services/ai/deliverables/artifact_helpers.js

@@ -72,10 +72,78 @@ const CANDIDATE_KEYS = [
   'mediaPaths',
   'screenshotPath',
   'uiDumpPath',
-  'url',
-  'urls',
+  'artifact',
+  'artifacts',
+  'artifactPath',
+  'artifactPaths',
+  'artifactUrl',
+  'artifactUrls',
+  'artifactUri',
+  'artifactUris',
+  'downloadUrl',
+  'downloadUrls',
+  'downloadUri',
+  'downloadUris',
 ];
 
+const GENERIC_CANDIDATE_KEYS = new Set([
+  'path',
+  'paths',
+  'file',
+  'files',
+  'filePath',
+  'filePaths',
+  'fullPath',
+  'fullPaths',
+  'downloadUrl',
+  'downloadUrls',
+  'downloadUri',
+  'downloadUris',
+]);
+
+const EXPLICIT_CANDIDATE_KEYS = new Set(
+  CANDIDATE_KEYS.filter((key) => !GENERIC_CANDIDATE_KEYS.has(key))
+);
+
+const ARTIFACT_CONTAINER_KEYS = new Set([
+  'artifact',
+  'artifacts',
+  'attachment',
+  'attachments',
+  'deliverable',
+  'deliverables',
+  'download',
+  'downloads',
+  'file',
+  'files',
+  'media',
+  'preview',
+  'screenshot',
+  'screenshots',
+]);
+
+const CONTAINER_URL_KEYS = new Set(['url', 'urls', 'uri', 'uris', 'href', 'hrefs']);
+
+const EVIDENCE_RESULT_TOOLS = /^(execute_command|github_|list_|search_|read_|get_|find_|http_request|web_search|browser_get|browser_read|code_navigate|query_structured_data|memory_|session_search|recordings_|read_health_data)/;
+
+function allowsGenericCandidateKeys(toolName = '') {
+  return !EVIDENCE_RESULT_TOOLS.test(String(toolName || ''));
+}
+
+function isExplicitCandidateKey(keyHint = '', parentKeyHint = '', options = {}) {
+  if (EXPLICIT_CANDIDATE_KEYS.has(keyHint)) return true;
+  if (
+    ARTIFACT_CONTAINER_KEYS.has(parentKeyHint)
+    && CANDIDATE_KEYS.includes(keyHint)
+    && (!GENERIC_CANDIDATE_KEYS.has(parentKeyHint) || options.allowGenericKeys === true)
+  ) {
+    return true;
+  }
+  if (GENERIC_CANDIDATE_KEYS.has(keyHint)) return options.allowGenericKeys === true;
+  if (!CONTAINER_URL_KEYS.has(keyHint)) return false;
+  return ARTIFACT_CONTAINER_KEYS.has(parentKeyHint);
+}
+
 function inferExtension(candidate = '') {
   return path.extname(String(candidate || '').split('?')[0]).toLowerCase();
 }
@@ -102,8 +170,17 @@ function normalizePathOrUri(value) {
   if (!text) return null;
   if (text.startsWith('/api/artifacts/')) return { uri: text, path: null };
   if (/^https?:\/\//i.test(text)) return { uri: text, path: null };
-  if (/^[A-Za-z]:\\/.test(text)) return { path: text, uri: null };
-  if (path.isAbsolute(text)) return { path: text, uri: null };
+  if (text.startsWith('//')) return null;
+  if (/^[A-Za-z]:\\/.test(text)) {
+    const ext = path.extname(text.split('?')[0]).toLowerCase();
+    if (!FILE_EXTENSION_TO_KIND[ext]) return null;
+    return { path: text, uri: null };
+  }
+  if (path.isAbsolute(text)) {
+    const ext = path.extname(text.split('?')[0]).toLowerCase();
+    if (!FILE_EXTENSION_TO_KIND[ext]) return null;
+    return { path: text, uri: null };
+  }
   return null;
 }
 
@@ -154,6 +231,7 @@ async function extractArtifactsFromResult(toolName, result) {
   const seen = new Set();
   const seenCandidates = new Set();
   const fallbackKind = inferArtifactKind(toolName, 'artifact');
+  const allowGenericKeys = allowsGenericCandidateKeys(toolName);
 
   async function pushCandidate(candidate) {
     const candidateKey = String(candidate || '').trim();
@@ -167,23 +245,26 @@ async function extractArtifactsFromResult(toolName, result) {
     artifacts.push(artifact);
   }
 
-  async function visit(value, keyHint = '') {
+  async function visit(value, keyHint = '', parentKeyHint = '') {
     if (value == null) return;
     if (typeof value === 'string') {
-      const explicit = CANDIDATE_KEYS.includes(keyHint);
-      if (explicit) await pushCandidate(value);
+      const explicit = isExplicitCandidateKey(keyHint, parentKeyHint, { allowGenericKeys });
+      if (explicit) {
+        if (normalizePathOrUri(value)) await pushCandidate(value);
+        return;
+      }
       for (const candidate of scanStringForCandidates(value, { explicit })) {
         await pushCandidate(candidate);
       }
       return;
     }
     if (Array.isArray(value)) {
-      for (const item of value) await visit(item, keyHint);
+      for (const item of value) await visit(item, keyHint, parentKeyHint);
       return;
     }
     if (typeof value === 'object') {
       for (const [key, nested] of Object.entries(value)) {
-        await visit(nested, key);
+        await visit(nested, key, keyHint);
       }
     }
   }
@@ -193,8 +274,10 @@ async function extractArtifactsFromResult(toolName, result) {
 }
 
 module.exports = {
+  allowsGenericCandidateKeys,
   extractArtifactsFromResult,
   inferArtifactKind,
   inferMimeType,
+  isExplicitCandidateKey,
   normalizePathOrUri,
 };

package/server/services/ai/deliverables/selector.js

@@ -47,6 +47,23 @@ async function selectDeliverableWorkflow({
   tools = [],
   options = {},
 }) {
+  if (!engine || typeof engine.requestStructuredJson !== 'function') {
+    return {
+      selection: {
+        status: 'standard',
+        type: null,
+        confidence: 0,
+        goal: '',
+        requestedOutputs: [],
+        supportingCapabilities: [],
+      },
+      usage: 0,
+      raw: '',
+      skipped: true,
+      reason: 'structured selector unavailable',
+    };
+  }
+
   const response = await engine.requestStructuredJson({
     provider,
     providerName,

package/server/services/ai/loop/blank_recovery.js

@@ -0,0 +1,37 @@
+'use strict';
+
+const { summarizeForLog } = require('../logFormat');
+
+function latestFailedToolExecution(toolExecutions = []) {
+  return [...toolExecutions].reverse().find((item) => item && item.ok === false) || null;
+}
+
+function shouldContinueAfterBlankToolFailure({
+  lastContent = '',
+  failedStepCount = 0,
+  remainingIterations = 0,
+  toolExecutions = [],
+} = {}) {
+  return !String(lastContent || '').trim()
+    && Number(failedStepCount || 0) > 0
+    && Number(remainingIterations || 0) > 0
+    && Boolean(latestFailedToolExecution(toolExecutions));
+}
+
+function buildBlankAfterToolFailureGuidance(toolExecutions = []) {
+  const failedExecution = latestFailedToolExecution(toolExecutions);
+  if (!failedExecution) return '';
+  const toolName = failedExecution.toolName || failedExecution.tool || 'the previous tool';
+  const failure = failedExecution.error || failedExecution.summary || failedExecution.status || 'unknown failure';
+  return [
+    `The previous tool "${toolName}" failed with: ${summarizeForLog(failure, 240)}.`,
+    'The latest assistant turn returned no user-facing answer and no tool call, so the task is not terminal.',
+    'Continue with the next safe recovery action: retry with corrected arguments, use another available tool, verify from existing evidence, or report a real blocker only if no autonomous path remains.',
+  ].join(' ');
+}
+
+module.exports = {
+  buildBlankAfterToolFailureGuidance,
+  latestFailedToolExecution,
+  shouldContinueAfterBlankToolFailure,
+};