apteva 0.4.56 → 0.7.0

package/README.md

@@ -1,16 +1,29 @@
-# Apteva
+<p align="center">
+  <img src="https://apteva.ai/icon.png" width="60" />
+</p>
 
-Run AI agents locally on your machine.
+<h1 align="center">Apteva</h1>
 
-[![npm version](https://img.shields.io/npm/v/apteva.svg)](https://www.npmjs.com/package/apteva)
-[![license](https://img.shields.io/badge/license-ELv2-blue.svg)](LICENSE)
+<p align="center">
+  <strong>An AI that never stops thinking.</strong>
+</p>
 
-## Features
+<p align="center">
+  Apteva is a continuous thinking engine. It doesn't wait for prompts —<br>
+  it observes, reasons, decides, and acts on its own initiative. Around the clock.
+</p>
 
-- **Multi-Provider Support** - Claude, GPT, Gemini, Llama, Grok, and more
-- **Local-First** - Your data and API keys stay on your machine
-- **Web Dashboard** - Beautiful UI for managing agents
-- **Secure** - API keys encrypted at rest
+<p align="center">
+  <a href="https://apteva.ai">Website</a> ·
+  <a href="https://apteva.ai/features">Features</a> ·
+  <a href="https://apteva.ai/cloud">Cloud</a> ·
+  <a href="https://github.com/apteva/core">Core Engine</a> ·
+  <a href="https://github.com/apteva/server">Server</a> ·
+  <a href="https://github.com/apteva/computer">Computer</a> ·
+  <a href="https://github.com/apteva/integrations">Integrations</a>
+</p>
+
+---
 
 ## Quick Start
 
@@ -18,67 +31,216 @@ Run AI agents locally on your machine.
 npx apteva
 ```
 
-Open http://localhost:4280 in your browser.
+A setup wizard guides you through provider selection, API key, and capabilities. Then the agent starts thinking.
 
-## Installation
+Or from source:
 
 ```bash
-# npm
-npm install -g apteva
-
-# bun
-bun add -g apteva
+cd core && go build -o apteva-core .
+cd ../server && go build -o apteva-server .
+cd ../apteva && go build -o apteva .
+./apteva
 ```
 
-## Usage
+Or with Docker:
 
 ```bash
-# Start server (default port 4280)
-apteva
+docker run -p 5280:5280 -v apteva-data:/data apteva
+```
+
+## What is Apteva?
+
+Every AI you use is reactive — you type, it responds, then it stops. Apteva is different. It runs a **continuous thinking loop**: observe → reason → act → sleep → repeat. It wakes when events arrive, sleeps when nothing happens, and thinks proactively in between.
 
-# Custom port
-apteva --port 8080
+It's not a chatbot. It's not an agent framework. It's **artificial consciousness** — a machine that is always aware, always ready, whether anyone is watching or not.
 
-# Custom data directory
-apteva --data-dir ./my-data
+### What it does between prompts
+
+- Notices a pattern in your support tickets before you ask
+- Follows up on a cold lead because three days passed and it remembers
+- Reorganizes inventory because it spotted a trend in last week's orders
+- Spawns a worker thread to handle a customer email at 3am
+- Evolves its own directives as it discovers better approaches
+- Browses the web, takes screenshots, clicks through pages
+- Connects to GitHub, Stripe, Slack — 263+ integrations
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────┐
+│  ./apteva                                            │
+│  Setup wizard → TUI terminal interface               │
+│  Channels: CLI, Telegram, Discord                    │
+└──────────────────┬───────────────────────────────────┘
+                   │
+┌──────────────────▼───────────────────────────────────┐
+│  apteva-server (:5280)                               │
+│  Auth · Instances · Integrations · Webhooks          │
+│                                                      │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐              │
+│  │ core-1  │  │ core-2  │  │ core-3  │  ...         │
+│  │ default │  │ support │  │ monitor │              │
+│  └────┬────┘  └────┬────┘  └────┬────┘              │
+│       │            │            │                    │
+│       ▼            ▼            ▼                    │
+│  ┌──────────────────────────────────────────────┐    │
+│  │              MCP Tools                       │    │
+│  │  channels · exec · web · browser             │    │
+│  │  github · stripe · slack · 263+ more         │    │
+│  └──────────────────────────────────────────────┘    │
+│                                                      │
+│  memory · self-pacing · evolve · persistent history  │
+└──────────────────────────────────────────────────────┘
 ```
 
-## Supported Providers
+One command (`./apteva`) starts everything. The CLI spawns the server, the server spawns core instances, and the agent begins thinking.
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Continuous Thinking** | Infinite loop — observe, reason, act, sleep. Not request-response. |
+| **Multi-Threaded** | Spawns worker threads for parallel tasks. Each has its own tools, pace, and directive. |
+| **Self-Evolving** | Persistent memory. Refines its own directives over time. Gets sharper the longer it runs. |
+| **Self-Pacing** | Sets its own sleep duration — 2 seconds when busy, hours when idle. Events wake it instantly. |
+| **Session Persistence** | Conversation history survives restarts. JSONL per thread, auto-compaction, never loses context. |
+| **Agent-Driven Safety** | No forced approval gates. The agent decides, learns from feedback, asks when unsure. Three modes: autonomous, cautious, learn. |
+| **263+ Integrations** | GitHub, Slack, Stripe, Shopify, and more. Each runs as its own MCP server. Credentials encrypted. |
+| **Browser Control** | Local Chrome or Browserbase. Navigate, click, type, screenshot. Claude gets native computer use protocol. |
+| **Multi-Channel** | CLI terminal, Telegram, Discord. Agent routes responses to the right channel. |
+| **Multi-Instance** | Run multiple agents in parallel. Each has its own directive, tools, and history. Projects for isolation. |
+| **Terminal UI** | Two-panel TUI with live status, thread thoughts, streaming responses, modal commands. |
+| **Embeddable** | The core is a standalone Go binary. Run it headless, connect via API, embed anywhere. |
+
+## Use Cases
+
+- **Run a business** — Support, sales, content, billing — fully autonomous, 24/7
+- **Content pipeline** — Research, write, publish, distribute, track — zero human input
+- **Ad operations** — Monitor ROAS, adjust budgets, generate creatives, A/B test
+- **DevOps** — Monitor deploys, triage alerts, write patches, coordinate incidents
+- **Personal assistant** — Email triage, calendar management, reminders, research
+- **Web automation** — Browse sites, fill forms, take screenshots, extract data
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `/status` | Core status |
+| `/config` | Full config |
+| `/directive [text]` | Show or set directive |
+| `/mode` | Switch mode: autonomous, cautious, learn |
+| `/threads` | List/kill threads |
+| `/computer` | Browser: local, browserbase, off |
+| `/integrate <app>` | Connect an integration (263+ apps) |
+| `/connect telegram` | Connect Telegram bot |
+| `/channels` | List connected channels |
+| `/mcp` | Manage MCP servers |
+| `/help` | All commands |
+
+Everything else you type is sent to the agent.
+
+## Modes
+
+| Mode | Behavior |
+|------|----------|
+| **autonomous** | Agent acts freely. Learns from feedback. Trusted. |
+| **cautious** | Asks before destructive or external actions. Learns from answers. |
+| **learn** | Asks about every new tool type. Builds a safety profile over time. |
+
+All modes use `[[remember]]` for persistent learning. The agent gets smarter the longer it runs.
+
+## Providers
 
 | Provider | Models |
 |----------|--------|
-| Anthropic | Claude Sonnet 4, Opus 4, Haiku |
-| OpenAI | GPT-4o, GPT-4o Mini |
-| Google | Gemini 2.0 Flash, 1.5 Pro |
-| Groq | Llama 3.3 70B, Mixtral |
-| xAI | Grok 2 |
-| Fireworks | Llama, DeepSeek V3 |
-| Together | Llama, DeepSeek R1 |
-| Moonshot | Moonshot V1 |
-| Venice | Llama 3.3 70B |
-
-## API
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/agents` | GET | List agents |
-| `/api/agents` | POST | Create agent |
-| `/api/agents/:id/start` | POST | Start agent |
-| `/api/agents/:id/stop` | POST | Stop agent |
-| `/api/agents/:id/chat` | POST | Chat (streaming) |
-| `/api/providers` | GET | List providers |
-| `/api/health` | GET | Health check |
-
-## Requirements
-
-- Node.js 18+ or Bun 1.0+
-- Linux, macOS, or Windows
+| **Fireworks** | Kimi K2.5 |
+| **Anthropic** | Claude Sonnet 4, Claude Haiku 4.5 |
+| **OpenAI** | GPT-4.1, GPT-4.1-mini |
+| **Google** | Gemini 2.5 Pro, Gemini 2.5 Flash |
+
+Select during setup. Switch anytime with `/mode` or the API.
+
+## Repositories
+
+| Repo | Description |
+|------|-------------|
+| [`apteva/apteva`](https://github.com/apteva/apteva) | This repo — CLI, setup wizard, TUI, npm launcher |
+| [`apteva/core`](https://github.com/apteva/core) | The thinking engine (Go) |
+| [`apteva/server`](https://github.com/apteva/server) | Management server — auth, instances, integrations, dashboard (Go) |
+| [`apteva/computer`](https://github.com/apteva/computer) | Browser control — local Chrome, Browserbase (Go) |
+| [`apteva/integrations`](https://github.com/apteva/integrations) | 263 app connectors + webhook registrar (TypeScript) |
+
+## Configuration
+
+```bash
+# Data stored in
+~/.apteva/apteva.json    # CLI config (capabilities, API key, instance ID)
+~/.apteva/apteva.db      # Server database (auth, connections, providers)
+```
+
+## From Source
+
+```bash
+# Build all three binaries
+cd core && go build -o apteva-core .
+cd ../server && go build -o apteva-server .
+cd ../apteva && go build -o apteva .
+
+# Run (starts server + core + TUI)
+cd apteva && ./apteva
+
+# Or run core standalone (headless)
+cd core && ./apteva-core --headless
+
+# Or connect CLI to a remote server
+./apteva --no-spawn --server <host>:5280
+```
+
+## Docker
+
+```bash
+# Build
+docker build -t apteva .
+
+# Run
+docker run -p 5280:5280 -v apteva-data:/data apteva
+
+# Connect CLI to it
+./apteva --no-spawn --server <host>:5280
+```
+
+## Migrating from OpenClaw
+
+Already running OpenClaw agents? Here's how to switch.
+
+| OpenClaw | Apteva | Notes |
+|----------|--------|-------|
+| `claw.run(prompt)` | `config.json` → directive | Apteva doesn't need prompts. It runs continuously. |
+| `claw.tool(...)` | MCP server | Any MCP server works. 263+ built-in. |
+| `claw.memory` | `[[remember]]` | Persistent across restarts. Embedding-based recall. |
+| `claw.agent(name)` | `[[spawn id="name"]]` | Threads are cheaper. They share memory and tools. |
+| Webhook handlers | Subscriptions | Events route directly to threads. |
+| `OPENCLAW_API_KEY` | `FIREWORKS_API_KEY` | Or Anthropic, OpenAI, Google. Your choice. |
+| Cron jobs | Self-pacing | No cron needed. `[[pace sleep="5m"]]` and it wakes on events. |
+| Agent state files | Evolving directives | The agent rewrites its own config. It improves itself. |
+| Session files | JSONL history | Persistent per thread, auto-compaction, survives restarts. |
+
+### Why switch?
+
+- **OpenClaw agents sleep between requests.** Apteva agents think between requests.
+- **OpenClaw needs orchestration.** Apteva orchestrates itself.
+- **OpenClaw bills per call.** Apteva self-paces to minimize cost — sleeps long when idle, thinks fast when busy.
+- **OpenClaw agents forget.** Apteva agents remember, learn, and evolve their own directives.
+
+The fundamental difference: OpenClaw agents are **functions you call**. Apteva agents are **processes that run**. One waits. The other works.
 
 ## License
 
-[Elastic License 2.0](LICENSE) - Free to use, cannot offer as a hosted service.
+[MIT](LICENSE)
 
-## Links
+---
 
-- [Issues](https://github.com/apteva/apteva/issues)
-- [Contributing](CONTRIBUTING.md)
+<p align="center">
+  <strong>Artificial consciousness for machines that work.</strong><br>
+  <a href="https://apteva.ai">apteva.ai</a>
+</p>

package/cli.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+const { spawnSync } = require("child_process");
+
+const ext = os.platform() === "win32" ? ".exe" : "";
+const DIR = __dirname;
+
+const aptevaBin = path.join(DIR, `apteva${ext}`);
+const serverBin = path.join(DIR, `apteva-server${ext}`);
+const coreBin = path.join(DIR, `apteva-core${ext}`);
+
+if (!fs.existsSync(aptevaBin)) {
+  console.error("apteva: binary not found. Try reinstalling: npm install -g apteva");
+  process.exit(1);
+}
+
+const result = spawnSync(aptevaBin, process.argv.slice(2), {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    APTEVA_SERVER_BIN: serverBin,
+    APTEVA_CORE_BIN: coreBin,
+  },
+});
+
+if (result.error) {
+  console.error(`apteva: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status || 0);

package/install.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+const { execSync } = require("child_process");
+
+const VERSION = require("./package.json").version;
+const REPO = "apteva/apteva";
+const DIR = __dirname;
+
+const PLATFORM_MAP = { linux: "linux", darwin: "darwin", win32: "windows" };
+const ARCH_MAP = { x64: "amd64", arm64: "arm64" };
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const follow = (url, redirects) => {
+      if (redirects > 5) return reject(new Error("Too many redirects"));
+      const mod = url.startsWith("https") ? https : http;
+      mod
+        .get(url, { headers: { "User-Agent": "apteva-npm" } }, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            return follow(res.headers.location, redirects + 1);
+          }
+          if (res.statusCode !== 200) {
+            return reject(new Error(`HTTP ${res.statusCode} from ${url}`));
+          }
+          const chunks = [];
+          res.on("data", (c) => chunks.push(c));
+          res.on("end", () => resolve(Buffer.concat(chunks)));
+          res.on("error", reject);
+        })
+        .on("error", reject);
+    };
+    follow(url, 0);
+  });
+}
+
+async function main() {
+  const platform = PLATFORM_MAP[os.platform()];
+  const arch = ARCH_MAP[os.arch()];
+  if (!platform || !arch) {
+    console.error(`apteva: unsupported platform ${os.platform()}-${os.arch()}`);
+    process.exit(1);
+  }
+
+  const tarName = `apteva-${VERSION}-${platform}-${arch}.tar.gz`;
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${tarName}`;
+
+  console.log(`apteva: downloading ${platform}-${arch} binaries...`);
+
+  try {
+    const buffer = await download(url);
+    const tmpFile = path.join(DIR, "_download.tar.gz");
+    fs.writeFileSync(tmpFile, buffer);
+
+    console.log(`apteva: extracting (${(buffer.length / 1024 / 1024).toFixed(1)} MB)...`);
+    execSync(`tar -xzf "${tmpFile}" -C "${DIR}"`, { stdio: "pipe" });
+    fs.unlinkSync(tmpFile);
+
+    // Make binaries executable
+    if (platform !== "windows") {
+      for (const name of ["apteva", "apteva-server", "apteva-core"]) {
+        const bin = path.join(DIR, name);
+        if (fs.existsSync(bin)) fs.chmodSync(bin, 0o755);
+      }
+    }
+
+    console.log("apteva: installed successfully.");
+  } catch (err) {
+    console.error(`apteva: binary download failed: ${err.message}`);
+    console.error("");
+    console.error("Falling back to local Go build...");
+
+    // Fallback: build from source if Go is available
+    try {
+      execSync("go version", { stdio: "pipe" });
+      console.log("apteva: building from source...");
+      execSync("go build -o apteva .", { cwd: DIR, stdio: "inherit" });
+      console.log("apteva: built from source.");
+    } catch {
+      console.error("apteva: no pre-built binary and Go not installed.");
+      console.error(`Download manually: https://github.com/${REPO}/releases/tag/v${VERSION}`);
+      process.exit(1);
+    }
+  }
+}
+
+main();

package/package.json

@@ -1,91 +1,24 @@
 {
   "name": "apteva",
-  "version": "0.4.56",
-  "description": "Run AI agents locally. Multi-provider support for Claude, GPT, Gemini, Llama, and more.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "version": "0.7.0",
+  "description": "AI agent platform with multi-thread orchestration, MCP integrations, and dashboard",
   "bin": {
-    "apteva": "./bin/apteva.js"
+    "apteva": "./cli.js"
   },
   "scripts": {
-    "dev": "bun run --watch src/server.ts",
-    "build": "bun run build.ts",
-    "build:cli": "bun build ./src/cli.ts --outdir ./dist --target node",
-    "compile": "bun run build && bun run scripts/compile.ts",
-    "compile:single": "bun run build && bun run scripts/compile.ts --single",
-    "start": "bun run src/server.ts",
-    "tui": "bun run src/tui/index.tsx",
-    "postinstall": "node scripts/postinstall.mjs",
-    "prepublishOnly": "bun run build"
+    "postinstall": "node install.js"
   },
-  "files": [
-    "bin/apteva.js",
-    "scripts/postinstall.mjs",
-    "dist/*.js",
-    "dist/*.css",
-    "dist/*.html",
-    "dist/*.png",
-    "src",
-    "LICENSE",
-    "README.md"
-  ],
-  "keywords": [
-    "apteva",
-    "ai",
-    "agents",
-    "llm",
-    "claude",
-    "anthropic",
-    "openai",
-    "gpt",
-    "gemini",
-    "llama",
-    "groq",
-    "local",
-    "cli"
-  ],
-  "author": "Apteva <hello@apteva.com>",
-  "license": "Elastic-2.0",
+  "keywords": ["ai", "agent", "mcp", "orchestration", "llm"],
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/apteva/apteva.git"
-  },
-  "homepage": "https://github.com/apteva/apteva",
-  "bugs": {
-    "url": "https://github.com/apteva/apteva/issues"
+    "url": "https://github.com/apteva/apteva"
   },
   "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "playwright": "^1.58.2",
-    "tailwindcss": "^3.4.0",
-    "typescript": "^5.0.0"
+    "node": ">=18"
   },
-  "dependencies": {
-    "@apteva/apteva-kit": "^0.1.138",
-    "grammy": "^1.40.0",
-    "ink": "^6.7.0",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
-    "react": "19",
-    "react-dom": "19",
-    "recharts": "^3.7.0"
-  },
-  "optionalDependencies": {
-    "@apteva/agent-darwin-arm64": "^1.44.9",
-    "@apteva/agent-darwin-x64": "^1.44.9",
-    "@apteva/agent-linux-arm64": "^1.44.9",
-    "@apteva/agent-linux-x64": "^1.44.9",
-    "@apteva/agent-win32-x64": "^1.44.9",
-    "@apteva/apteva-darwin-arm64": "0.4.33",
-    "@apteva/apteva-darwin-x64": "0.4.33",
-    "@apteva/apteva-linux-arm64": "0.4.33",
-    "@apteva/apteva-linux-x64": "0.4.33",
-    "@apteva/apteva-win32-x64": "0.4.33"
-  }
+  "files": [
+    "cli.js",
+    "install.js"
+  ]
 }

package/LICENSE

@@ -1,63 +0,0 @@
-Elastic License 2.0 (ELv2)
-
-## Acceptance
-
-By using the software, you agree to all of the terms and conditions below.
-
-## Copyright License
-
-The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations and conditions below.
-
-## Limitations
-
-You may not provide the software to third parties as a hosted or managed service, where the service provides users with access to any substantial set of the features or functionality of the software.
-
-You may not move, change, disable, or circumvent the license key functionality in the software, and you may not remove or obscure any functionality in the software that is protected by the license key.
-
-You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
-
-## Patents
-
-The licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms.
-
-If you modify the software, you must include in any modified copies of the software prominent notices stating that you have modified the software.
-
-## No Other Rights
-
-These terms do not imply any licenses other than those expressly granted in these terms.
-
-## Termination
-
-If you use the software in violation of these terms, such use is not licensed, and your licenses will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your licenses will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your licenses to terminate automatically and permanently.
-
-## No Liability
-
-*As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.*
-
-## Definitions
-
-The **licensor** is the entity offering these terms, and the **software** is the software the licensor makes available under these terms, including any portion of it.
-
-**you** refers to the individual or entity agreeing to these terms.
-
-**your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
-
-**your licenses** are all the licenses granted to you for the software under these terms.
-
-**use** means anything you do with the software requiring one of your licenses.
-
-**trademark** means trademarks, service marks, and similar rights.
-
----
-
-Copyright 2025 Apteva
-
-Licensed under the Elastic License 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
-
-https://www.elastic.co/licensing/elastic-license
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.