neoagent 2.5.2-beta.8 → 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.8",
-  "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 @@
-bb621393d8fc51c33384ab5b836db272
+0aebc22637251b8ff07f20355c6f3771

package/server/public/flutter_bootstrap.js

@@ -37,6 +37,6 @@ _flutter.buildConfig = {"engineRevision":"77e2e94772b6eb43759e34ed1ad7da4674e19c
 
 _flutter.loader.load({
   serviceWorkerSettings: {
-    serviceWorkerVersion: "2920927188" /* 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("mqfpjvdl-88fa84f").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("mqfpjvdl-88fa84f").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,"mqfpjvdl-88fa84f")){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("mqfpjvdl-88fa84f").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;
 }
 
@@ -129,15 +206,19 @@ async function buildArtifactFromCandidate(candidate, fallbackKind = 'artifact')
   return artifact.path || artifact.uri ? artifact : null;
 }
 
-function scanStringForCandidates(text) {
+function scanStringForCandidates(text, { explicit = false } = {}) {
   const input = String(text || '');
   const matches = [];
-  const regexes = [
-    /\/api\/artifacts\/[A-Za-z0-9%_-]+\/content/g,
-    /\/[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
-    /[A-Za-z]:\\[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
-    /https?:\/\/[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
-  ];
+  const regexes = explicit
+    ? [
+      /\/api\/artifacts\/[A-Za-z0-9%_-]+\/content/g,
+      /\/[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
+      /[A-Za-z]:\\[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
+      /https?:\/\/[^\s"'`]+?\.(?:pptx?|pdf|docx?|md|txt|html?|csv|tsv|xlsx?|json|png|jpe?g|gif|webp|svg|mp4|mov|m4v|webm)\b/g,
+    ]
+    : [
+      /\/api\/artifacts\/[A-Za-z0-9%_-]+\/content/g,
+    ];
   for (const regex of regexes) {
     const found = input.match(regex);
     if (found) matches.push(...found);
@@ -148,9 +229,14 @@ function scanStringForCandidates(text) {
 async function extractArtifactsFromResult(toolName, result) {
   const artifacts = [];
   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();
+    if (!candidateKey || seenCandidates.has(candidateKey)) return;
+    seenCandidates.add(candidateKey);
     const artifact = await buildArtifactFromCandidate(candidate, fallbackKind);
     if (!artifact) return;
     const key = `${artifact.kind}:${artifact.path || artifact.uri}`;
@@ -159,22 +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') {
-      if (CANDIDATE_KEYS.includes(keyHint)) await pushCandidate(value);
-      for (const candidate of scanStringForCandidates(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);
       }
     }
   }
@@ -184,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,