memoryblock 0.1.3 → 0.1.4

package/README.md

@@ -90,23 +90,33 @@ Adding a new adapter is one file. See [adapter docs](https://docs.memoryblock.io
 
 ## Quick Start
 
-**Requirements:** [Bun](https://bun.sh) ≥ 1.0 and an API key from any supported provider.
+Memoryblock is built natively for [Bun](https://bun.sh) for maximum performance, but we package a smart installer so you can get started using whatever you already have!
 
+### 1. Install memoryblock
+
+**- Option A: Bun (Recommended)**  
+If you already use Bun, this is the absolute fastest way to install:
+```bash
+bun install -g memoryblock
+```
+
+**- Option B: Node.js / NPM**
 ```bash
-# clone and set up
-git clone https://github.com/memoryblock-io/memoryblock.git
-cd memoryblock
-pnpm dev:onboard -gl
+npm install -g memoryblock
+```
 
-# run the setup wizard
+### 2. Setup your ecosystem
+Run the setup wizard to verify your local environment and enter your initial provider API keys:
+```bash
 mblk init
+```
 
-# start your first block
+### 3. Deploy your first block
+That's it! You can now start your very first personal assistant block:
+```bash
 mblk start home
 ```
 
-That's it. The wizard handles credentials, verification, and creating your first block.
-
 ### Web Dashboard
 
 ```bash
@@ -171,23 +181,8 @@ Channels are how your blocks talk to the outside world. The CLI, messaging platf
 
 Supported and upcoming channels are documented in [channels](https://docs.memoryblock.io/channels/).
 
-## Architecture
-
-```
-packages/
-├── core/          # engine, CLI, schemas, monitor loop
-├── adapters/      # LLM provider adapters
-├── channels/      # messaging channel transports
-├── api/           # HTTP + WebSocket server
-├── web/           # static web dashboard
-├── tools/         # base tool registry and schema helpers
-├── daemon/        # background process management
-└── plugins/       # extensible capability modules
-```
-
-It's a pnpm monorepo. Every package builds independently with `tsc`. No bundlers, no magic.
-
 ## Community & Support
+
 - **Contributing**: We welcome PRs! See [CONTRIBUTING.md](.github/CONTRIBUTING.md).
 - **Support**: If you find `memoryblock` useful, please consider [sponsoring the project](https://github.com/sponsors/mgks) or giving it a star ⭐.
 
@@ -200,6 +195,7 @@ It's a pnpm monorepo. Every package builds independently with `tsc`. No bundlers
 *   [**@memoryblock/daemon**](https://www.npmjs.com/package/@memoryblock/daemon) - Background daemon manager.
 *   [**@memoryblock/api**](https://www.npmjs.com/package/@memoryblock/api) - Core REST and WebSocket API server.
 *   [**@memoryblock/cli**](https://www.npmjs.com/package/@memoryblock/cli) - Command-line interface.
+*   [**@memoryblock/types**](https://www.npmjs.com/package/@memoryblock/types) - Core TypeScript definitions and schemas.
 
 **Integrations & Tooling**
 *   [**@memoryblock/adapters**](https://www.npmjs.com/package/@memoryblock/adapters) - LLM adapters (OpenAI, Anthropic, Bedrock, etc).

package/bin/mblk.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+/**
+ * memoryblock - Auto-Bootstrap CLI Wrapper
+ * 
+ * Ensures the end-user has a flawless zero-configuration setup.
+ * Automatically checks and installs Bun (the high-performance runtime) 
+ * and the @memoryblock/cli ecosystem tools if they are missing.
+ */
+const { execSync, spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// Helper to silently run commands
+const run = (cmd) => {
+    try {
+        return execSync(cmd, { stdio: 'pipe' }).toString().trim();
+    } catch {
+        return null;
+    }
+};
+
+const localBun = path.join(os.homedir(), '.bun', 'bin', 'bun');
+const bunGlobalRoot = path.join(os.homedir(), '.bun', 'install', 'global', 'node_modules');
+const cliScriptBun = path.join(bunGlobalRoot, '@memoryblock/cli', 'bin', 'mblk.js');
+
+// 0ms Fast-Path: If everything is already installed natively, skip ALL slow checks!
+if (fs.existsSync(localBun) && fs.existsSync(cliScriptBun)) {
+    const result = spawnSync(localBun, [cliScriptBun, ...process.argv.slice(2)], { stdio: 'inherit' });
+    process.exit(result.status ?? 1);
+}
+
+// Check package managers (Slow Path)
+let bunPath = run('command -v bun');
+const hasNpm = !!run('command -v npm');
+const hasBunFn = !!run('command -v bun');
+
+// 1. Install Bun if completely missing
+if (!hasBunFn && !fs.existsSync(localBun)) {
+    console.log('\n⚡ \x1b[1mmemoryblock\x1b[0m is powered by \x1b[33mBun\x1b[0m for extreme performance.');
+    console.log('   Installing the lightweight engine automatically...\n');
+    try {
+        execSync('curl -fsSL https://bun.sh/install | bash', { stdio: 'inherit' });
+        bunPath = localBun;
+        console.log('\n✅ Bun installed successfully!');
+    } catch (e) {
+        console.error('\n❌ Failed to automatically install Bun. Please run: curl -fsSL https://bun.sh/install | bash');
+        process.exit(1);
+    }
+}
+if (!bunPath) bunPath = localBun;
+
+// 2. Identify global path & manager
+const npmGlobalRoot = hasNpm ? run('npm root -g') : null;
+let cliScript = cliScriptBun;
+
+// 3. Install @memoryblock/cli if missing
+// (We also gracefully check if NPM already downloaded it first so we don't redownload)
+if (!fs.existsSync(cliScript) && npmGlobalRoot) {
+    const npmScript = path.join(npmGlobalRoot, '@memoryblock/cli', 'bin', 'mblk.js');
+    if (fs.existsSync(npmScript)) cliScript = npmScript;
+}
+
+if (!fs.existsSync(cliScript)) {
+    console.log('\n📦 Downloading memoryblock terminal interface tools...\n');
+    try {
+        execSync(`${bunPath} install -g @memoryblock/cli@latest`, { stdio: 'inherit' });
+        cliScript = path.join(bunGlobalRoot, '@memoryblock/cli', 'bin', 'mblk.js');
+    } catch (e) {
+        if (hasNpm) {
+            console.log('\n⚠️ Bun global install tripped. Falling back to NPM...\n');
+            try {
+                execSync('npm install -g @memoryblock/cli@latest', { stdio: 'inherit' });
+                cliScript = path.join(npmGlobalRoot, '@memoryblock/cli', 'bin', 'mblk.js');
+            } catch (err) {
+                console.error('\n❌ Failed to sync @memoryblock/cli. Please run manually: npm install -g @memoryblock/cli');
+                process.exit(1);
+            }
+        } else {
+            console.error(`\n❌ Failed to sync @memoryblock/cli. Please run manually: ${bunPath} install -g @memoryblock/cli`);
+            process.exit(1);
+        }
+    }
+}
+
+// 4. Hand-off execution seamlessly to Bun, passing all CLI arguments
+const result = spawnSync(bunPath, [cliScript, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(result.status ?? 1);

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "memoryblock",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Deploy isolated, multi-agent AI assistants on your local machine with extreme resource efficiency.",
   "files": [
-    "dist/"
+    "dist/",
+    "bin/"
   ],
+  "bin": {
+    "mblk": "./bin/mblk.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -17,8 +21,8 @@
     "dev": "tsc -p tsconfig.json --watch"
   },
   "dependencies": {
-    "@memoryblock/locale": "^0.1.3",
-    "@memoryblock/types": "^0.1.3",
+    "@memoryblock/locale": "^0.1.4",
+    "@memoryblock/types": "^0.1.4",
     "chalk": "^5.4.0"
   },
   "engines": {