neoagent 2.1.18-beta.35 → 2.1.18-beta.37

package/README.md

@@ -3,7 +3,7 @@
 <p align="center"><strong>Your agent. Your server. Your rules.</strong></p>
 
 <p align="center">
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-18+-5fa04e?style=flat-square&logo=node.js&logoColor=white" alt="Node.js"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-20+-5fa04e?style=flat-square&logo=node.js&logoColor=white" alt="Node.js"></a>
   <a href="https://sqlite.org"><img src="https://img.shields.io/badge/SQLite-WAL-003b57?style=flat-square&logo=sqlite&logoColor=white" alt="SQLite"></a>
   <a href="https://flutter.dev"><img src="https://img.shields.io/badge/Flutter-web%20%2B%20android-02569B?style=flat-square&logo=flutter&logoColor=white" alt="Flutter"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-a855f7?style=flat-square" alt="License"></a>

package/docs/getting-started.md

@@ -4,7 +4,7 @@ NeoAgent installs as a Node CLI and runs a self-hosted server with a bundled Flu
 
 ## Requirements
 
-- Node.js 18 or newer.
+- Node.js 20 or newer.
 - A reachable server URL if you want OAuth callbacks, mobile access, or messaging webhooks.
 - At least one hosted AI provider API key, unless you only use local Ollama.
 - Android Studio or a Flutter Android toolchain if you build the Android client yourself.

package/docs/index.md

@@ -1,47 +1,14 @@
 ---
-layout: home
+slug: /
+title: NeoAgent
+sidebar_label: Overview
+---
 
-hero:
-  name: NeoAgent
-  text: Self-hosted proactive AI agent
-  tagline: Run your own server, keep credentials server-side, and operate browser, Android, recordings, schedules, integrations, memory, MCP, and messaging from one Flutter UI.
-  actions:
-    - theme: brand
-      text: Get Started
-      link: /getting-started
-    - theme: alt
-      text: Capabilities
-      link: /capabilities
-    - theme: alt
-      text: Why NeoAgent
-      link: /why-neoagent
+# NeoAgent
 
-features:
-  - title: Android Control
-    details: Let the AI operate a server-attached Android emulator or device with screenshots, UI dumps, app launch, intents, taps, typing, swipes, APK installs, and ADB shell.
-    link: /capabilities#android-control
-    linkText: Android Control
-  - title: Recordings
-    details: Capture web, Android, and wearable audio as sessions with transcripts, searchable segments, playback, retry, cleanup, and AI-generated insights.
-    link: /capabilities#recordings
-    linkText: Recordings
-  - title: Proactive Automation
-    details: Create recurring tasks and one-time runs that can use browser, files, CLI, memory, MCP, integrations, subagents, health summaries, and messaging delivery.
-    link: /automation
-    linkText: Automation
-  - title: Official Integrations
-    details: Use OAuth-backed Google Workspace, Microsoft 365, Notion, Slack, and Figma tools instead of brittle browser automation where possible.
-    link: /integrations
-    linkText: Integrations
-  - title: Server-Side Secrets
-    details: Keep AI provider keys, OAuth client secrets, Telnyx tokens, runtime settings, and deployment controls on the NeoAgent server.
-    link: /configuration
-    linkText: Configuration
-  - title: Recovery Path
-    details: Operate self-hosted installs with status, logs, release channels, update, fix, runtime paths, and the remote-server log caveat.
-    link: /operations
-    linkText: Operations
----
+NeoAgent is a self-hosted proactive AI agent with a bundled Flutter client for web and Android. It runs on your server, keeps credentials server-side, and gives you an operator UI for chat, runs, logs, scheduler tasks, skills, integrations, MCP, memory, Android control, recordings, Health Connect data, wearables, and settings.
+
+It is designed for people who want a focused personal automation server rather than a broad gateway platform. NeoAgent can run scheduled tasks, control a browser, operate a server-attached Android emulator or device, manage files, remember long-term context, connect to hosted AI providers or local Ollama, search recordings, read synced health summaries, and send results through Telegram, Discord, WhatsApp, or Telnyx Voice.
 
 ## Quick Start
 
@@ -52,7 +19,21 @@ neoagent install
 
 Open the server URL, sign in, configure providers and messaging, then create a scheduled task or chat run.
 
-## Navigation
+## What NeoAgent Does
+
+| Area | Capability |
+|---|---|
+| AI providers | OpenAI, Anthropic, xAI, Google, MiniMax Code, and local Ollama |
+| Operator UI | Chat, live runs, logs, scheduler, skills, integrations, MCP, memory, devices, recordings, health, wearables, settings |
+| Automation | Recurring scheduled tasks, one-time runs, browser control, file access, CLI skills, subagents, and messaging delivery |
+| Android control | AI control of a server-attached Android emulator or device: screenshots, UI dumps, taps, typing, intents, APK installs, and ADB shell |
+| Recordings | Web, Android, and wearable audio sessions with transcript search and AI insights |
+| Integrations | Google Workspace, Notion, Microsoft 365, Slack, Figma, and remote MCP servers |
+| Messaging | Telegram, Discord, WhatsApp text/media, and Telnyx Voice calls |
+| Outputs | Artifacts, Grok image generation, vision analysis, markdown tables, and Mermaid graphs |
+| Recovery | `neoagent status`, `neoagent logs`, `neoagent update`, release channels, and `neoagent fix` |
+
+## Main Paths
 
 | Need | Start here |
 |---|---|

package/extensions/chrome-browser/popup.js

@@ -10,6 +10,9 @@ const flowDescriptionEl = document.querySelector('#flowDescription');
 const primaryActionEl = document.querySelector('#primaryAction');
 const secondaryActionEl = document.querySelector('#secondaryAction');
 const openAppEl = document.querySelector('#openApp');
+const disconnectEl = document.querySelector('#disconnect');
+const checkUpdateEl = document.querySelector('#checkUpdate');
+const downloadEl = document.querySelector('#download');
 
 const STATUS_LABELS = {
   connected: 'Connected',
@@ -186,68 +189,38 @@ async function refresh() {
   updateFlow();
 }
 
-primaryActionEl.addEventListener('click', async () => {
-  try {
-    setMessage('');
-    await runAction(primaryActionEl.dataset.action);
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
-});
-
-secondaryActionEl.addEventListener('click', async () => {
-  try {
-    setMessage('');
-    await runAction(secondaryActionEl.dataset.action);
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
-});
-
-openAppEl.addEventListener('click', async () => {
-  try {
-    setMessage('');
-    await runAction('openApp');
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
-});
+function bindAsyncClick(element, handler) {
+  element.addEventListener('click', async () => {
+    try {
+      setMessage('');
+      await handler();
+    } catch (error) {
+      setMessage(error.message, 'error');
+    }
+  });
+}
 
 serverUrlEl.addEventListener('input', updateFlow);
 
-document.querySelector('#disconnect').addEventListener('click', async () => {
-  try {
-    setMessage('');
-    await send('disconnect');
-    await refresh();
-    setMessage('Disconnected.', 'success');
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
+bindAsyncClick(primaryActionEl, () => runAction(primaryActionEl.dataset.action));
+bindAsyncClick(secondaryActionEl, () => runAction(secondaryActionEl.dataset.action));
+bindAsyncClick(openAppEl, () => runAction('openApp'));
+bindAsyncClick(disconnectEl, async () => {
+  await send('disconnect');
+  await refresh();
+  setMessage('Disconnected.', 'success');
 });
-
-document.querySelector('#checkUpdate').addEventListener('click', async () => {
-  try {
-    setMessage('');
-    const result = await send('checkForUpdates', { serverUrl: effectiveServerUrl() });
-    setMessage(
-      result.updateAvailable
-        ? `Update available: ${result.currentVersion} -> ${result.latestVersion}.`
-        : `Current version ${result.currentVersion} is up to date.`,
-      result.updateAvailable ? '' : 'success',
-    );
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
+bindAsyncClick(checkUpdateEl, async () => {
+  const result = await send('checkForUpdates', { serverUrl: effectiveServerUrl() });
+  setMessage(
+    result.updateAvailable
+      ? `Update available: ${result.currentVersion} -> ${result.latestVersion}.`
+      : `Current version ${result.currentVersion} is up to date.`,
+    result.updateAvailable ? '' : 'success',
+  );
 });
-
-document.querySelector('#download').addEventListener('click', async () => {
-  try {
-    setMessage('');
-    await send('openDownload', { serverUrl: effectiveServerUrl() });
-  } catch (error) {
-    setMessage(error.message, 'error');
-  }
+bindAsyncClick(downloadEl, async () => {
+  await send('openDownload', { serverUrl: effectiveServerUrl() });
 });
 
 chrome.runtime.onMessage.addListener((message) => {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "neoagent",
-  "version": "2.1.18-beta.35",
+  "version": "2.1.18-beta.37",
   "description": "Proactive personal AI agent with no limits",
   "license": "MIT",
   "main": "server/index.js",
+  "engines": {
+    "node": ">=20"
+  },
   "bin": {
     "neoagent": "bin/neoagent.js"
   },
@@ -28,9 +31,9 @@
     "dev:stack": "./dev/stack.sh",
     "dev:build": "./dev/build.sh",
     "dev:test": "./dev/test.sh",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs",
+    "docs:dev": "docusaurus start",
+    "docs:build": "docusaurus build",
+    "docs:preview": "docusaurus serve build",
     "flutter:run:web": "cd flutter_app && flutter run -d chrome",
     "flutter:build:web": "cd flutter_app && flutter build web --output ../server/public --dart-define=NEOAGENT_BACKEND_URL=${NEOAGENT_BACKEND_URL:-}",
     "manage": "node bin/neoagent.js",
@@ -83,6 +86,9 @@
     "undici": "^6.24.0"
   },
   "devDependencies": {
-    "vitepress": "1.6.4"
+    "@docusaurus/core": "3.8.1",
+    "@docusaurus/preset-classic": "3.8.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
   }
 }

package/server/catalog_sources/store-bundles/skills/productivity/catbox-upload-skill/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: Catbox & Litterbox File Uploader
+description: Upload local files to Catbox for permanent sharing or Litterbox for temporary sharing. Use when you need a public link for logs, screenshots, archives, media, or other local artifacts.
+version: 1.0.0
+author: Microck
+upstream: https://github.com/Microck/opendots-microck/tree/main/skills/catbox-upload-skill
+---
+
+# Catbox & Litterbox File Uploader
+
+Use this skill when the user wants a direct public URL for a local file.
+
+- Prefer `litterbox` for temporary sharing of logs, builds, screenshots, and one-off artifacts.
+- Prefer `catbox` for permanent hosting.
+- Return the final URL plainly, and for `litterbox` also mention the selected expiry window.
+
+## Command
+
+Run the bundled uploader script:
+
+```bash
+bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh /path/to/file
+```
+
+## Arguments
+
+- `file_path` (required): local file to upload
+- `--service litterbox|catbox` (optional): defaults to `litterbox`
+- `--time 1h|12h|24h|72h` (optional): only used for `litterbox`, defaults to `24h`
+- `--userhash HASH` (optional): Catbox account hash for uploads tied to a Catbox account
+
+## Examples
+
+Temporary upload with the default 24-hour expiry:
+
+```bash
+bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./logs/server.log
+```
+
+Temporary upload that expires after 1 hour:
+
+```bash
+bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./build/output.zip --time 1h
+```
+
+Permanent upload to Catbox:
+
+```bash
+bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./artifacts/screenshot.png --service catbox
+```
+
+Permanent upload associated with a Catbox account:
+
+```bash
+bash ~/.neoagent/agent-data/skills/productivity-catbox-upload-skill/scripts/upload.sh ./artifacts/screenshot.png --service catbox --userhash YOUR_HASH
+```
+
+## Expected Output
+
+The script prints exactly one URL on success, for example:
+
+```text
+https://litterbox.catbox.moe/abc123.png
+```
+
+or:
+
+```text
+https://files.catbox.moe/abc123.png
+```
+
+## Presenting Results
+
+When the upload succeeds:
+
+- show the returned URL clearly
+- mention whether it is temporary or permanent
+- if using `litterbox`, include the expiration window
+
+Example response:
+
+```text
+File uploaded successfully.
+
+Link: https://litterbox.catbox.moe/abc123.png
+Expires in: 24 hours
+```
+
+## Limits
+
+- `litterbox`: up to 1 GB, temporary, supports `1h`, `12h`, `24h`, and `72h`
+- `catbox`: up to 200 MB, permanent
+
+## Troubleshooting
+
+- If the file does not exist or is unreadable, verify the path first.
+- If the upload fails, surface the exact error from the script.
+- If `curl` is missing, install it before retrying.
+- If Catbox rejects the file, the file may exceed the service limit or violate Catbox content rules.

package/server/catalog_sources/store-bundles/skills/productivity/catbox-upload-skill/scripts/upload.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage: upload.sh <file_path> [--service litterbox|catbox] [--time 1h|12h|24h|72h] [--userhash HASH]
+
+Options:
+  --service   Upload target. Defaults to litterbox.
+  --time      Litterbox retention window. Defaults to 24h.
+  --userhash  Optional Catbox account hash for uploads associated with an account.
+  -h, --help  Show this help text.
+
+Limits:
+  litterbox: 1 GB
+  catbox:    200 MB
+EOF
+}
+
+fail() {
+  printf 'Error: %s\n' "$1" >&2
+  exit 1
+}
+
+require_value() {
+  local option="$1"
+  local value="${2-}"
+  [[ -n "$value" ]] || fail "$option requires a value"
+}
+
+SERVICE="litterbox"
+TIME="24h"
+USERHASH=""
+FILE_PATH=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --service)
+      require_value "$1" "${2-}"
+      SERVICE="$2"
+      shift 2
+      ;;
+    --time)
+      require_value "$1" "${2-}"
+      TIME="$2"
+      shift 2
+      ;;
+    --userhash)
+      require_value "$1" "${2-}"
+      USERHASH="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --)
+      shift
+      break
+      ;;
+    -*)
+      usage
+      fail "unknown option: $1"
+      ;;
+    *)
+      [[ -z "$FILE_PATH" ]] || fail "only one file path is supported"
+      FILE_PATH="$1"
+      shift
+      ;;
+  esac
+done
+
+if [[ $# -gt 0 ]]; then
+  [[ -z "$FILE_PATH" ]] || fail "only one file path is supported"
+  FILE_PATH="$1"
+  shift
+fi
+
+[[ $# -eq 0 ]] || fail "only one file path is supported"
+
+[[ -n "$FILE_PATH" ]] || {
+  usage
+  fail "file path is required"
+}
+
+command -v curl >/dev/null 2>&1 || fail "curl is not installed"
+[[ -f "$FILE_PATH" ]] || fail "file not found: $FILE_PATH"
+[[ -r "$FILE_PATH" ]] || fail "file is not readable: $FILE_PATH"
+
+case "$SERVICE" in
+  litterbox|catbox)
+    ;;
+  *)
+    fail "service must be either 'litterbox' or 'catbox'"
+    ;;
+esac
+
+case "$TIME" in
+  1h|12h|24h|72h)
+    ;;
+  *)
+    fail "time must be one of: 1h, 12h, 24h, 72h"
+    ;;
+esac
+
+FILE_SIZE_BYTES="$(wc -c < "$FILE_PATH" | tr -d '[:space:]')"
+LITTERBOX_LIMIT_BYTES=1073741824
+CATBOX_LIMIT_BYTES=209715200
+
+if [[ "$SERVICE" == "litterbox" ]] && (( FILE_SIZE_BYTES > LITTERBOX_LIMIT_BYTES )); then
+  fail "litterbox uploads are limited to 1 GB"
+fi
+
+if [[ "$SERVICE" == "catbox" ]] && (( FILE_SIZE_BYTES > CATBOX_LIMIT_BYTES )); then
+  fail "catbox uploads are limited to 200 MB"
+fi
+
+CURL_FILE_PATH="${FILE_PATH//;/\\;}"
+
+if [[ "$SERVICE" == "litterbox" ]]; then
+  ENDPOINT="https://litterbox.catbox.moe/resources/internals/api.php"
+  RESPONSE="$(
+    curl --silent --show-error --fail \
+      --user-agent 'NeoAgent catbox-upload-skill/1.0' \
+      -F 'reqtype=fileupload' \
+      -F "time=$TIME" \
+      -F "fileToUpload=@$CURL_FILE_PATH" \
+      "$ENDPOINT"
+  )"
+else
+  ENDPOINT="https://catbox.moe/user/api.php"
+  if [[ -n "$USERHASH" ]]; then
+    RESPONSE="$(
+      curl --silent --show-error --fail \
+        --user-agent 'NeoAgent catbox-upload-skill/1.0' \
+        -F 'reqtype=fileupload' \
+        -F "userhash=$USERHASH" \
+        -F "fileToUpload=@$CURL_FILE_PATH" \
+        "$ENDPOINT"
+    )"
+  else
+    RESPONSE="$(
+      curl --silent --show-error --fail \
+        --user-agent 'NeoAgent catbox-upload-skill/1.0' \
+        -F 'reqtype=fileupload' \
+        -F "fileToUpload=@$CURL_FILE_PATH" \
+        "$ENDPOINT"
+    )"
+  fi
+fi
+
+RESPONSE="$(printf '%s' "$RESPONSE" | tr -d '\r\n')"
+[[ "$RESPONSE" =~ ^https?:// ]] || fail "upload failed: $RESPONSE"
+
+printf '%s\n' "$RESPONSE"

package/server/http/middleware.js

@@ -10,6 +10,7 @@ const { logRequestSummary } = require('../utils/logger');
 const { getSessionSecret } = require('../services/account/session_secret');
 
 const sessionsDb = new Sqlite(`${DATA_DIR}/sessions.db`);
+const LEGACY_SESSION_EXPIRE_FALLBACK = 0;
 
 function ensureSessionStoreSchema(db) {
   const table = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'sessions'").get();
@@ -35,11 +36,10 @@ function ensureSessionStoreSchema(db) {
     db.exec('CREATE TABLE sessions (sid PRIMARY KEY, sess, expire)');
 
     if (hasSid && hasSess) {
-      // TODO: Verify whether better-sqlite3-session-store treats expire=0 as already expired or non-expiring.
       const expireExpr = expireColumn ? expireColumn : 'NULL';
       db.exec(`
         INSERT OR REPLACE INTO sessions (sid, sess, expire)
-        SELECT sid, sess, COALESCE(${expireExpr}, 0) AS expire
+        SELECT sid, sess, COALESCE(${expireExpr}, ${LEGACY_SESSION_EXPIRE_FALLBACK}) AS expire
         FROM ${legacyTableName}
         WHERE sid IS NOT NULL
       `);
@@ -138,6 +138,13 @@ function applyHttpMiddleware(app, { secureCookies, sessionMiddleware, validateOr
       || path === '/api/browser-extension/pairing/request'
       || /^\/api\/browser-extension\/pairing\/[^/]+\/claim$/i.test(path);
   };
+  const requestPath = (req) => req.originalUrl || req.url || req.path || '';
+  const applyOnlyToRecordingChunk = (handler) => (req, res, next) => (
+    isRecordingChunkPath(requestPath(req)) ? handler(req, res, next) : next()
+  );
+  const skipRecordingChunk = (handler) => (req, res, next) => (
+    isRecordingChunkPath(requestPath(req)) ? next() : handler(req, res, next)
+  );
 
   if (secureCookies) {
     app.set('trust proxy', 1);
@@ -184,24 +191,9 @@ function applyHttpMiddleware(app, { secureCookies, sessionMiddleware, validateOr
 
     next();
   });
-  app.use((req, res, next) => {
-    if (isRecordingChunkPath(req.originalUrl || req.url || req.path)) {
-      return rawRecordingChunkBody(req, res, next);
-    }
-    return next();
-  });
-  app.use((req, res, next) => {
-    if (isRecordingChunkPath(req.originalUrl || req.url || req.path)) {
-      return next();
-    }
-    return jsonBody(req, res, next);
-  });
-  app.use((req, res, next) => {
-    if (isRecordingChunkPath(req.originalUrl || req.url || req.path)) {
-      return next();
-    }
-    return urlencodedBody(req, res, next);
-  });
+  app.use(applyOnlyToRecordingChunk(rawRecordingChunkBody));
+  app.use(skipRecordingChunk(jsonBody));
+  app.use(skipRecordingChunk(urlencodedBody));
   app.use(sessionMiddleware);
 }
 

package/server/public/flutter_bootstrap.js

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