memoryblock@0.1.10 (Live Tailing & Unified Engine)

This release brings perfect functional parity between foreground blocks and attached background daemons. We've entirely unified the CLI rendering architecture.

• Background Real-time Streaming: Attaching to a running daemon via mblk start <block> now features flawless, real-time "live typing" streaming, syncing LLM stream byte chunks identically to the raw foreground architecture via a persistent .stream OS layer.
• Unified Engine: Scrapped 150+ lines of duplicate rendering UI from the "thin-client". Daemons now directly inject into a pristine, single-source-of-truth CLIChannel rendering engine. Background daemon chats natively share exact theming, formatting, and responsive UX without redundancy.
• Architectural Cleanup (SharedChannel): Refactored the technically inaccurate WebChannel into SharedChannel. Daemons write background states explicitly to disk for seamless, multi-client, any-platform UI hydration. (Fully backwards compatible for existing saved daemon configs under ~/.memoryblock/blocks).

✨ Highlights

⚡ True Daemon Streaming (Live Typing)

Previously, tailing an autonomous daemon resulted in slightly degraded formatting without live-typing.

Now, reading a daemon block intelligently tracks byte-buffer boundaries in the background utilizing the .stream OS pipeline, syncing the headless CLIChannel to replicate a localized streaming aesthetic natively.
You can dynamically pause reading and catch back up.

Also fixed severe CLI double-printing and deduplicated multi-channel race conditions for robust file tracking.

Complete Tool Observability UI

When a daemon runs multiple background tasks invisibly, the thin client now brilliantly maps OS-level tool executions dynamically to your Assistant's UI wrapper.
Tools explicitly output underneath the Monitor's specific persona label and emoji instead of floating arbitrarily as a loose System message.

Dependency Standardization

• Replaced WebChannel implementations with SharedChannel. The block UI architecture accurately reflects memoryblock's vision: Daemons dump pure structural output to disk headers, and decoupled "Thin Client" Frontends instantly hydrate via CLI/Web/Telegram UI rendering hooks asynchronously!

Test Results

Test	Status	Notes
Foreground Streaming	✅	Native chunks verified cleanly.
Background Daemon Live Tailing	✅	.stream buffer truncates/retains state correctly globally.
Daemon Dual Interface CLI Read	✅	Tools map visually inside CLIChannel engine natively.
WebChannel to SharedChannel Migration	✅	Auto-maps legacy configured "web" strings seamlessly.
Build (all packages)	✅	TypeScript typings strictly validated via dev:build.

🚀 How to Upgrade

bun install -g memoryblock  # For Bun (recommended)
npm install -g memoryblock  # For Node/NPM

mblk init

Full Changelog: 0.1.9...0.1.10

memoryblock@0.1.9-beta 🩹 (Tool Discovery Fix)

This patch resolves a critical context-compression bug and stabilizes TUI rendering for Node.js environments.

🐛 Bug Fixes

• Tool Discovery Amnesia (monitor.ts): Fixed a bug where aggressive token-compression in list_tools_available would double-trim the result on subsequent context loops, replacing the tool list with (0 tools discovered) and blinding the LLM to its own capabilities. The system now safely preserves the most recent tool discovery output natively.
• TUI Pollution (entry.ts / mblk.js): Silenced native Node.js DeprecationWarnings globally during CLI execution (specifically resolving the punycode error thrown by downstream dependencies like AWS SDK / node-fetch in Node.js 21+). Interactive loader UI animations will no longer be broken by engine-level warnings.

🚀 How to Upgrade

If you're using Bun (recommended):

bun install -g memoryblock

If you're using Node/NPM:

npm install -g memoryblock

Full Changelog: 0.1.8...0.1.9

memoryblock@0.1.8-beta (UX + Tools Upgrade)

memoryblock is no longer Bun-required. The framework now runs on Node.js ≥20 with Bun as performance accelerator.

• API Server — Rewrote @memoryblock/api from Bun.serve() to node:http + ws, enabling the server to run natively on any Node.js environment
• Smart Runtime Detection — CLI auto-detects Bun and uses it for ~2x faster startup. Falls back to Node.js silently.
• One-Time Hint — First run on Node.js shows a single, non-intrusive suggestion to install Bun. Suppress with MEMORYBLOCK_NO_BUN=1

✨ Highlights

⚡ New Commands

mblk superblock <block>

Grant a block full, unrestricted system access in one command.

mblk superblock assistant     # scope=system, shell=on, sandbox=off
mblk superblock assistant --off  # Revoke → back to sandboxed mode

mblk config [target]

Open any config file in your terminal editor — no more hunting for dotfiles.

mblk config           # Global config
mblk config auth      # Credentials file  
mblk config <block>   # Block-specific config
mblk config --path    # Print path only (for scripting)

Auto-detects editor: $EDITOR → $VISUAL → nano → vi → notepad.

mblk update

Whether triggered via the CLI (mblk update) or the Web UI (POST /api/update), the update process is completely hands-off and safe:

1. npm install runs to fetch the new code.
2. A detached child process is spawned.
3. Graceful shutdown: All running blocks receive a SIGTERM and safely save their memory.md, session.json, and cost data. The server stops.
4. Fresh start: The detached process runs mblk restart, booting the server and all blocks with the new code. Nothing is corrupted.

8 New Built-in Tools (22 total)

Tool	Scope	Description
delete_file	block	Delete a file or empty directory (requires approval)
move_file	block	Move or rename a file (requires approval)
copy_file	block	Copy a file to a new location
append_to_file	block	Append content to a file
find_files	block	Recursive directory search by filename pattern (glob-like)
system_info	block	OS, CPU, memory, uptime, network diagnostics
list_blocks	system	List all blocks in workspace (superblock only)
get_current_time	block	Current date, time, timezone

Scope-Aware Tool Discovery

Blocks are now self-aware of their permission level. When a block calls list_tools_available, it sees:

Regular block (scope: block):

Your scope: block | Shell: no

## Available (17)
- read_file, write_file, find_files, system_info, get_current_time, ...

## Restricted (5)
- ~~execute_command~~ (requires shell access)
- ~~list_blocks~~ (requires scope: system)

*To unlock restricted tools, ask the user to run: `mblk superblock home`*

Superblock (scope: system):

Your scope: system | Shell: yes

## Available (22)
- All tools unlocked

New ToolDefinition fields:

• requiredScope?: 'block' | 'workspace' | 'system' — Minimum scope to use tool
• requiresShell?: boolean — Whether tool needs allowShell permission

Cross-Platform Compatibility

All tools now work on macOS, Linux, and Windows:

• Shell tools (execute_command, run_lint/build/test): Auto-detect cmd.exe on Windows, /bin/sh on Unix
• search_files: Uses grep on macOS/Linux for speed, falls back to a pure Node.js recursive text search on Windows
• find_files: Pure Node.js implementation — works everywhere, no external binaries
• All file tools: Use node:fs/path — fully cross-platform path handling

Full-System Self-Updates

memoryblock now features a complete, graceful self-update system that works across the CLI and Web UI.

CLI — Non-blocking version check after commands (6-hour cache, never slows startup):

  ⬡ Update available: 0.1.7 → 0.1.8
    Run mblk update to update

New APIs and Commands:

• CLI: Added mblk update
• HTTP: POST /api/update — Triggers full system update and restart

Brand & Visual Updates

• Unified brand colors — All CLI and web UI unified to #7C3AED
• SVG logo — Replaced Unicode ⬡ with inline SVG hexagon across auth, nav, and setup wizard
• Animated gradient — Logo gradient flows: violet → purple → pink → coral
• Favicons — Complete setup: .ico, apple-touch-icon.png (180×180), android-chrome (192/512)
• Theme color — Added <meta name="theme-color" content="#7C3AED"> for mobile browsers

Init Wizard Improvements

• Selected plugins are now actually installed during setup
• Credential fields are skippable — configure later with mblk config auth

Engine & Dependency Changes

• Node.js minimum: 18 → 20 (aligns with AWS SDK v3)
• Added ws package to @memoryblock/api
• Removed @types/bun from @memoryblock/api

Permissions Clarification

Feature	Regular Block	Superblock
Read/write own block files	✅	✅
update_monitor_identity	✅	✅
system_info / get_current_time	✅	✅
find_files / search_files	✅	✅
execute_command	❌	✅
run_lint/build/test	❌	✅
list_blocks	❌	✅
Access files outside block dir	❌	✅

Test Results

Test	Bun	Node.js
mblk --version → 0.1.8	✅	✅
mblk status	✅	✅
mblk superblock home / --off	✅	✅
mblk config --path / auth / home	✅	✅
mblk server status	✅	✅
GET /api/version	✅	—
GET /api/health	✅	—
Tool registry: 22 tools	✅	✅
Scope-aware discovery (block)	✅ → 17 available, 5 restricted
Scope-aware discovery (system)	✅ → 22 available, 0 restricted
All 18 functional tool tests	✅	✅ (18/18)
Build (all packages)	✅ 14/14 clean	—

🚀 How to Upgrade

If you're using Bun (recommended):

bun install -g memoryblock

If you're using Node/NPM:

npm install -g memoryblock

Full Changelog: 0.1.7...0.1.8

memoryblock@0.1.7-beta (Core Fix)

This release fixes a critical issue where core packages were being skipped during installation on certain environments (like AWS EC2), and optimizes the CLI's daemon-spawning logic.

🛠 Fixed

• Core Package Relocation: Moved core runtime packages (adapters, daemon, api, tools, channels, web) and essential plugins (agents, installer, web-search, fetch-webpage) from optionalDependencies to hard dependencies. This ensures they are always installed, fixing the Cannot find module '@memoryblock/adapters' error encountered on Linux/EC2 environments.
• Daemon Spawn Optimization: Optimized the mblk start command to prevent the parent CLI from redundantly loading the full adapter and tools stack. The parent now only displays the status banner and attaches to the daemon, making the startup process faster and more resilient.

🏗 Stability

• Verified DAG Architecture: Audited the entire monorepo dependency graph to ensure a strict, one-way flow with zero circular dependencies.
• Failsafe Verified: Successfully passed the internal dev:prep suite, including block scaffolding, isolation tests, and security audits.

To update:

npm install -g memoryblock@latest

🚀 How to Upgrade

If you're using Bun (recommended):

bun install -g memoryblock@latest

If you're using Node/NPM:

npm install -g memoryblock@latest

Full Changelog: 0.1.6...0.1.7

memoryblock@0.1.6-beta (Auto-Link)

This release introduces major improvements to global command installations, ensuring seamless execution across heavily restricted remote servers, cloud instances, and CI pipelines without manual path configuration.

✨ What's New

• Smart Auto-Linking for Linux & macOS (postinstall)
  When managing background daemons on remote instances (like AWS EC2 Amazon Linux or Ubuntu), administrators frequently install packages using sudo npm install -g. This often isolates the executable payload in a directory hidden from the standard interactive bash $PATH.
  • The Fix: memoryblock now features an intelligent postinstall system. During global installation, the installer will automatically detect UNIX-based operating systems and explicitly backward-symlink the mblk binary directly into absolute native $PATH directories (e.g., /usr/local/bin or /usr/bin).
  • The Result: Typing mblk now "just works" out-of-the-box on raw cloud instances. No more manually editing ~/.bashrc profiles or modifying $PATH.

🛡️ Core Improvements

• Decoupled Runtime Safety: By entirely delegating the heavy generic CLI wrappers back to the localized core runtime, executing the standalone mblk binary is considerably safer in multi-tenant environments.
• Privilege Grace Degradation: The auto-linking scripts gracefully handle EACCES permission errors behind the scenes. If a system is strictly locked down against Symlink creation, it silently falls back perfectly to default NPM behavioral mapping.

🧹 Deprecations

• We have officially dropped the placeholder @memoryblock/cli NPM organization namespace from legacy deployment routines. The namespace is maintained securely on NPM as a redirect to gracefully catch outdated dependency chains.

🚀 How to Upgrade

If you're using Bun (recommended):

bun install -g memoryblock

If you're using Node/NPM:

npm install -g memoryblock

Full Changelog: 0.1.5...0.1.6

memoryblock@0.1.5-beta (DAG Refactor)

A major architectural milestone for memoryblock. This release focuses entirely on stabilizing the core foundation, paving the way for the powerful plugin ecosystem we have in the pipeline.

🏗️ What's New: The DAG Refactor

Previously, as the project grew rapidly, we hit some circular dependency snags that made building and global installation trickier than it should be. In v0.1.5, we completely overhauled the monorepo architecture.

memoryblock is now a strict, one-way Directed Acyclic Graph (DAG).

Key Improvements:

• The New memoryblock Orchestrator: We extracted the CLI interface out of @memoryblock/core and into its own top-level package called memoryblock. The CLI now orchestrates everything cleanly from the top down.
• Bulletproof Global Installs: No more installation loops or unresolved dependencies. You can now reliably install memoryblock globally via npm or Bun and it will just work.
• Typing Done Right: We moved all shared interfaces, types, and Zod schemas into a brand new @memoryblock/types package, breaking any circular references across the ecosystem.
• Polished CLI: We fixed minor bugs in commands like mblk stop that were incorrectly treating system directories (like _archive) as active blocks. The terminal output is quieter, cleaner, and more helpful.
• Dead Code Purge: Cleaned up legacy files, removed stale debugger logs from the daemon runtime, and streamlined the codebase for faster execution.

🚀 How to Upgrade

If you're using Bun (recommended):

bun install -g memoryblock

If you're using Node/NPM:

npm install -g memoryblock

(Note: memoryblock automatically installs required natively-optimized runtimes like Bun under the hood if you use npm, so you get the speed of Bun no matter what!)

Full Changelog: 0.1.4...0.1.5

memoryblock@0.1.4-beta (Zero-Config )

📦 Seamless Zero-Configuration Installations

Installing memoryblock just got astonishingly easier for everyone, no matter what development environment you are coming from!

Memoryblock is built natively for Bun for maximum speed and extreme resource efficiency. However, we've now introduced an intelligent Auto-Bootstrap Node Wrapper directly into the core CLI.

This means that if you don't have Bun installed yet, you don't even have to leave your terminal or change your workflow. You can just run:

npm install -g memoryblock

...and our smart installer will automatically detect your environment, securely install the lightweight Bun runtime in the background, and configure everything instantly. Zero friction!

⚡ Zero-Latency Bootstrapping & Fallbacks

• 0ms Subsequent Starts: Reaching terminal tools through the memoryblock CLI is now instant. The bootstrap wrapper uses an aggressive fast-path detection cache to bypass all environment testing after initial setup.
• Pure-Bun Infrastructure Support: End-users are no longer required to have NPM or Node.js on their host systems. If you're running a pure Bun environment, the installer dynamically reprioritizes and utilizes Bun's native lightning-fast global package ecosystem securely.

Full Changelog: 0.1.3...0.1.4

memoryblock@0.1.3-beta (CLI Migration)

✨ New Features & Developer Experience

The biggest upgrade in this release is the complete extraction of the command-line interface from memoryblock (core) into its own dedicated package: @memoryblock/cli.

🛠️ Architecture Refactoring & Standalone CLI

By isolating the CLI, we have officially eliminated all topological and cyclic dependency loops across the entire monorepo. The core engine is now purely focused on Agent, Monitor, and Gatekeeper logic without intertwining with terminal commands and channels.

• For End Users: To install the CLI globally on your machine, you must now run:

  npm install -g @memoryblock/cli

  (Executing mblk in the terminal works exactly the same as before!)

• NPM Automation: Added a new pnpm dev:getpub automation script. Developers can quickly generate dummy placeholder packages to reserve clean NPM namespaces before automated CI/CD releases.

• Build Pipeline: pnpm dev:build was heavily simplified to use native pnpm -r run build now that cyclic chains are gone.

• Failsafe Testing: All monorepo verification, TypeScript builds, and scaffolding tests (dev:prep) now execute perfectly in isolation.

Full Changelog: 0.1.2...0.1.3

memoryblock@0.1.2-beta 🩹 (Test Patch Release)

Full Changelog: 0.1.1-beta...0.1.2

memoryblock@0.1.1-beta (Initial Release)

Welcome to the first public beta release of memoryblock! 🚀

Memoryblock is a lightweight, resource-efficient framework for running and orchestrating isolated AI agents (blocks) right on your local machine. Built purely on Bun, it solves the problem of background agents burning through your wallet by smartly truncating context, summarizing logs natively, and aggressively loading tool schemas only when demanded.

✨ Core Capabilities

• Deploy Isolated Blocks: Spin up independent agents with their own unique memories, tools, configs, and personalities. No shared state pollution.
• Built for Cost Efficiency: On-demand schema injection and history trimming slashes token usage overhead by over 50%.
• Omni-Channel Interactions: Communicate seamlessly with your blocks via your Terminal CLI, our live Web Dashboard, Telegram, Discord, and Slack platforms.
• Provider Agnostic: Plug in your API keys to instantly swap between AWS Bedrock, OpenAI, Anthropic, Google Gemini, and Local Ollama integrations.
• Extensible Ecosystem: Quickly snap in modular plugins for deep web parsing, DuckDuckGo searching, and complex multi-agent delegation.

Note: This is an active testing rollout phase. We'd love your feedback on the repository!