memoryblock 0.0.1 → 0.1.1-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 memoryblock
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+<div align="center">
+
+  <!-- PROJECT TITLE -->
+  <h3>
+    <img width="240" alt="memoryblock logo" src="https://github.com/memoryblock-io/memoryblock/blob/main/packages/web/public/images/memoryblock-logo.png?raw=true" />
+  </h3>
+  
+  <!-- ONE LINE SUMMARY -->
+  <p>
+    <b>Run AI agents that remember, think, and work - without burning through your budget.</b>
+  </p>
+  
+  <!-- BADGES -->
+  <p>
+    <a href="https://www.npmjs.com/package/memoryblock"><img src="https://img.shields.io/npm/v/memoryblock.svg?style=flat-square&color=CB3837" alt="npm version"></a>
+    <!--<a href="https://www.npmjs.com/package/memoryblock?activeTab=versions"><img src="https://img.shields.io/npm/dt/memoryblock.svg?style=flat-square&color=38bd24" alt="downloads"></a>-->
+    <a href="https://github.com/memoryblock-io/memoryblock/stargazers"><img src="https://img.shields.io/github/stars/memoryblock-io/memoryblock?style=flat-square&logo=github" alt="stars"></a>
+    <a href="https://github.com/memoryblock-io/memoryblock/blob/main/LICENSE"><img src="https://img.shields.io/github/license/memoryblock-io/memoryblock.svg?style=flat-square&color=A31F34" alt="license"></a>
+  </p>
+
+  <!-- MENU -->
+  <p>
+    <h4>
+      <a href="https://memoryblock.io">View Demo</a> • 
+      <a href="https://docs.memoryblock.io/getting-started/installation/">Documentation</a> • 
+      <a href="https://github.com/memoryblock-io/memoryblock/issues">Report Bug</a>
+    </h4>
+  </p>
+
+  <!-- PREVIEW -->
+  <p>
+    <br/>
+    <img width="800" alt="memoryblock preview" src="https://github.com/user-attachments/assets/f7cf1e5b-e05c-4f8b-8747-0ef13adde054" />
+    <br/>
+    <sup><i>memoryblock web client dashboard preview</i></sup>
+  </p>
+
+</div>
+
+Memoryblock lets you deploy AI agents as isolated **blocks** - independent workspaces, each with their own memory, tools, and personality. Think of a block as a private office for an AI. Give it a job, point it at a channel, and let it run.
+
+One block can be your personal assistant. Another can monitor your infrastructure. A third can research topics and write summaries. They don't interfere with each other, they don't share memory, and they don't waste tokens re-learning what they already know.
+
+Need them to collaborate? A block can spawn sub-agents, the temporary workers in sandboxed environments to handle specific tasks and report back. No shared state pollution, no context confusion.
+
+```
+you ─── terminal ──── block "home"       (your daily assistant)
+    ├── channel ───── block "devops"     (monitors + alerts)
+    └── web ui ────── block "research"   (deep dives + summaries)
+```
+
+## ✨ What Makes This Different
+
+### It's cheap to run. Seriously.
+
+Most AI tools send the entire tool schema. Thousands of tokens. On *every single message*. For a background agent running all day, that's money on fire.
+
+Memoryblock was engineered around this problem:
+
+- **On-demand schema loading** - tool definitions are injected only when needed, then dropped. Payload sizes go from ~2,600 tokens to ~1,200 tokens per turn.
+- **History trimming** - large tool outputs (log dumps, file contents) are read once, then truncated in memory to 500 characters. The LLM already saw it. No need to pay for it again.
+- **Smart context recovery** - when context fills up, the engine summarizes everything into clean, actionable notes and starts fresh. No crash, no data loss, no compact context error loops.
+
+> In testing, these optimizations reduce token growth between turns from 4.2× to under 2×, resulting in over 50% cost reduction on sustained sessions.
+
+### It runs on Bun. Nothing else.
+
+No Node.js. No Electron. No heavy frameworks. The entire core, HTTP server, WebSocket streaming, static file serving, is built on native APIs. Cold starts are fast. Memory usage is small.
+
+### Every block is its own world.
+
+Each block gets its own `config.json`, `memory.md`, `monitor.md`, `costs.json`, and log directory. Move a block between machines by copying its folder. Back it up by zipping it. There's no shared database, no centralized state, no magic.
+
+### Talk to it from anywhere.
+
+Your blocks are accessible through the **CLI** (a simple interactive terminal), different **Channels** (including Telegram, Discord, Slack, and more), and a **Web Dashboard** (with live WebSocket updates). Same block, same memory, different surfaces.
+
+### Use any model you want.
+
+Memoryblock doesn't lock you into one provider. Swap models per-block, per-task, or per-agent:
+
+| Adapter | Auth |
+|:---|:---|
+| **AWS Bedrock** | AWS credentials |
+| **OpenAI** | API key |
+| **Google Gemini** | API key |
+| **Anthropic** | API key |
+
+Adding a new adapter is one file. See [adapter docs](https://docs.memoryblock.io/adapters/) for examples.
+
+## Quick Start
+
+**Requirements:** [Bun](https://bun.sh) ≥ 1.0 and an API key from any supported provider.
+
+```bash
+# clone and set up
+git clone https://github.com/memoryblock-io/memoryblock.git
+cd memoryblock
+pnpm dev:onboard -gl
+
+# run the setup wizard
+mblk init
+
+# start your first block
+mblk start home
+```
+
+That's it. The wizard handles credentials, verification, and creating your first block.
+
+### Web Dashboard
+
+```bash
+mblk web
+```
+
+Opens a live dashboard at `localhost:8420` with real-time block monitoring, cost tracking, and memory inspection.
+
+### Channels
+
+```bash
+mblk start home --channel telegram
+```
+
+Your block is now live on the channel you chose. Same memory, same tools, accessible from anywhere.
+
+## Commands
+
+Everything you can do from the terminal, you can do from chat (and soon, the web UI too):
+
+| CLI | In-Chat | What it does |
+|:---|:---|:---|
+| `mblk create <name>` | `/create-block <name>` | Create a new block |
+| `mblk start <block>` | — | Start a block's monitor |
+| `mblk stop <block>` | — | Stop a running monitor |
+| `mblk status` | `/status` | Show all blocks and their state |
+| `mblk delete <block>` | — | Archive a block safely |
+| `mblk restore <archive>` | — | Restore from archive |
+| `mblk reset <block>` | — | Reset memory and costs |
+| `mblk add <plugin>` | — | Install a plugin |
+
+Full reference: [command docs](https://docs.memoryblock.io/commands.md)
+
+## Plugins
+
+Blocks come with a core set of tools. Need more? Add them:
+
+```bash
+mblk add web-search    # search the web
+mblk add fetch-webpage # extract text from any URL
+mblk add agents        # multi-agent orchestration
+```
+
+Plugins are just npm packages. The installer resolves, downloads, and wires them in automatically.
+
+| Plugin | What it does |
+|:---|:---|
+| `web-search` | Search the web with your configured provider |
+| `fetch-webpage` | Extract clean text from URLs |
+| `agents` | Spawn sub-agents for delegated tasks |
+| `aws` | Cloud SDK code generation tools |
+
+## Adapters
+
+Each adapter is a single file that maps Memoryblock's internal message format to a provider's API. They handle authentication, request formatting, and response parsing. Writing a new adapter is straightforward — the interface is small and well-documented.
+
+See all supported adapters and how to write your own: [adapters](https://docs.memoryblock.io/adapters/)
+
+## Channels
+
+Channels are how your blocks talk to the outside world. The CLI, messaging platforms, and the web dashboard are all channels — equal citizens, not afterthoughts. Adding a new channel is a single file implementation.
+
+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 ⭐.
+
+## The `memoryblock` Ecosystem
+
+**memoryblock** is a highly modular system. Here are the official packages:
+
+**The Core**
+*   [**memoryblock**](https://www.npmjs.com/package/memoryblock) - The core engine interface and types.
+*   [**@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.
+
+**Integrations & Tooling**
+*   [**@memoryblock/adapters**](https://www.npmjs.com/package/@memoryblock/adapters) - LLM adapters (OpenAI, Anthropic, Bedrock, etc).
+*   [**@memoryblock/channels**](https://www.npmjs.com/package/@memoryblock/channels) - Communication channels (CLI, Telegram, Web).
+*   [**@memoryblock/tools**](https://www.npmjs.com/package/@memoryblock/tools) - Standard tool definitions and schemas.
+*   [**@memoryblock/locale**](https://www.npmjs.com/package/@memoryblock/locale) - Localization strings and formatting.
+*   [**@memoryblock/web**](https://www.npmjs.com/package/@memoryblock/web) - Front-end dashboard and Web UI.
+
+**Plugins**
+*   [**@memoryblock/plugin-installer**](https://www.npmjs.com/package/@memoryblock/plugin-installer) - Plugin installer and registry manager.
+*   [**@memoryblock/plugin-agents**](https://www.npmjs.com/package/@memoryblock/plugin-agents) - Secondary AI agents orchestrator.
+*   [**@memoryblock/plugin-aws**](https://www.npmjs.com/package/@memoryblock/plugin-aws) - AWS integrations.
+*   [**@memoryblock/plugin-fetch-webpage**](https://www.npmjs.com/package/@memoryblock/plugin-fetch-webpage) - Web content fetching and parsing.
+*   [**@memoryblock/plugin-web-search**](https://www.npmjs.com/package/@memoryblock/plugin-web-search) - Web search capabilities.
+
+## License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+![Website Badge](https://img.shields.io/badge/.*%20mgks.dev-blue?style=flat&link=https%3A%2F%2Fmgks.dev) ![Sponsor Badge](https://img.shields.io/badge/%20%20Become%20a%20Sponsor%20%20-red?style=flat&logo=github&link=https%3A%2F%2Fgithub.com%2Fsponsors%2Fmgks)

package/bin/mblk.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import('../dist/bin/mblk.js').catch(() => {
+  console.error('memoryblock CLI not built yet. Run `pnpm dev:build` first.');
+  process.exit(1);
+});

package/dist/bin/mblk.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=mblk.d.ts.map

package/dist/bin/mblk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mblk.d.ts","sourceRoot":"","sources":["../../src/bin/mblk.ts"],"names":[],"mappings":""}

package/dist/bin/mblk.js

@@ -0,0 +1,339 @@
+#!/usr/bin/env bun
+import { Command } from 'commander';
+import { log } from '../cli/logger.js';
+import { initCommand } from '../cli/commands/init.js';
+import { createCommand } from '../cli/commands/create.js';
+import { startCommand } from '../cli/commands/start.js';
+import { stopCommand } from '../cli/commands/stop.js';
+import { statusCommand } from '../cli/commands/status.js';
+import { resetCommand } from '../cli/commands/reset.js';
+import { serverStartCommand, serverStopCommand, serverStatusCommand, serverTokenCommand, shutdownCommand, restartCommand } from '../cli/commands/server.js';
+import { addCommand, removeCommand } from '../cli/commands/plugins.js';
+import { deleteCommand, restoreCommand } from '../cli/commands/delete.js';
+import { permissionsCommand } from '../cli/commands/permissions.js';
+import { pluginSettingsCommand } from '../cli/commands/plugin-settings.js';
+import { serviceInstallCommand, serviceUninstallCommand, serviceStatusCommand } from '../cli/commands/service.js';
+import { getVersion, DEFAULT_PORT } from '../cli/constants.js';
+(async () => {
+    const version = await getVersion();
+    const program = new Command();
+    program
+        .name('mblk')
+        .description('Deploy isolated, multi-agent AI assistants with extreme resource efficiency.')
+        .version(version)
+        .exitOverride(() => process.exit(0)) // Don't throw ELIFECYCLE when showing help
+        .configureOutput({
+        writeOut: (str) => process.stdout.write(str),
+        writeErr: (str) => process.stdout.write(str), // Prevent stderr noise from Commander
+    });
+    program
+        .command('init')
+        .description('Interactive setup — configure credentials, verify connections, create your first block.')
+        .option('-y, --yes', 'Non-interactive mode: create defaults without prompts')
+        .action(async (opts) => {
+        try {
+            await initCommand({ nonInteractive: opts.yes });
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('create <name>')
+        .description('Create a new block (isolated AI workspace).')
+        .action(async (name) => {
+        try {
+            await createCommand(name);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('start [block]')
+        .description('Start the monitor loop for a block (or all blocks).')
+        .option('-d, --daemon', 'Run the monitor in the background')
+        .option('-c, --channel <channel>', 'Specify override channel (e.g. web, cli)')
+        .action(async (block, opts) => {
+        try {
+            await startCommand(block, opts);
+        }
+        catch (err) {
+            const msg = err.message;
+            // If not initialized, auto-route to init and then retry
+            if (msg.includes('not initialized') || msg.includes('mblk init')) {
+                log.warn('Workspace not initialized. Running setup first...\n');
+                try {
+                    await initCommand();
+                    // Retry start after init completes
+                    await startCommand(block, opts);
+                }
+                catch (initErr) {
+                    log.error(initErr.message);
+                    process.exit(0);
+                }
+                return;
+            }
+            log.error(msg);
+            process.exit(0);
+        }
+    });
+    program
+        .command('stop [block]')
+        .description('Stop a running block monitor (or all blocks).')
+        .action(async (block) => {
+        try {
+            await stopCommand(block);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('status')
+        .description('Show the status of all blocks.')
+        .action(async () => {
+        try {
+            await statusCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('reset <block>')
+        .description('Reset a block state (memory, pulse, costs). Use --hard to wipe logs.')
+        .option('--hard', 'Wipe logs directory as well')
+        .action(async (block, opts) => {
+        try {
+            await resetCommand(block, opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('delete <block>')
+        .description('Archive a block to prevent data loss. Use --hard to permanently delete.')
+        .option('--hard', 'Permanently wipe the block from disk')
+        .action(async (block, opts) => {
+        try {
+            await deleteCommand(block, opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('restore <name>')
+        .description('Restore an archived block by name.')
+        .action(async (archive) => {
+        try {
+            await restoreCommand(archive);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('permissions <block>')
+        .description('View or update block permissions (CLI-only).')
+        .option('-s, --scope <level>', 'Set scope: block, workspace, or system')
+        .option('--allow-shell', 'Allow shell command execution')
+        .option('--deny-shell', 'Deny shell command execution')
+        .option('--allow-network', 'Allow network/fetch access')
+        .option('--deny-network', 'Deny network/fetch access')
+        .option('--max-timeout <seconds>', 'Max command timeout in seconds')
+        .action(async (block, opts) => {
+        try {
+            await permissionsCommand(block, opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('settings [plugin]')
+        .description('View or edit plugin settings.')
+        .action(async (pluginId) => {
+        try {
+            await pluginSettingsCommand(pluginId);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    // ===== Server Subcommand Group =====
+    const server = program
+        .command('server')
+        .description('Manage the web/API server.');
+    server
+        .command('start')
+        .description('Start the web UI and API server.')
+        .option('-p, --port <port>', 'Port to listen on', DEFAULT_PORT)
+        .option('--new-token', 'Generate a new auth token')
+        .option('-d, --daemon', 'Run the server in the background')
+        .action(async (opts) => {
+        try {
+            await serverStartCommand(opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    server
+        .command('stop')
+        .description('Stop the running server.')
+        .action(async () => {
+        try {
+            await serverStopCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    server
+        .command('status')
+        .description('Show server status (PID, port, running state).')
+        .action(async () => {
+        try {
+            await serverStatusCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    server
+        .command('token')
+        .description('View the current API token, or generate a new one.')
+        .option('--new-token', 'Generate and set a new API token')
+        .action(async (opts) => {
+        try {
+            await serverTokenCommand(opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    // ===== Service Subcommand Group =====
+    const service = program
+        .command('service')
+        .description('Manage OS-level auto-start (launchd/systemd).');
+    service
+        .command('install')
+        .description('Register memoryblock to start on boot/login.')
+        .action(async () => {
+        try {
+            await serviceInstallCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    service
+        .command('uninstall')
+        .description('Remove memoryblock from system auto-start.')
+        .action(async () => {
+        try {
+            await serviceUninstallCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    service
+        .command('status')
+        .description('Check if the auto-start service is installed.')
+        .action(async () => {
+        try {
+            await serviceStatusCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    // ===== Lifecycle Commands =====
+    program
+        .command('shutdown')
+        .description('Stop all blocks and the server.')
+        .action(async () => {
+        try {
+            await shutdownCommand();
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('restart')
+        .description('Restart: stop everything, then start server as daemon.')
+        .option('-p, --port <port>', 'Port to listen on', DEFAULT_PORT)
+        .action(async (opts) => {
+        try {
+            await restartCommand(opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    // Backward-compatible alias: `mblk web` = `mblk server start`
+    program
+        .command('web')
+        .description('Alias for `mblk server start`.')
+        .option('-p, --port <port>', 'Port to listen on', DEFAULT_PORT)
+        .option('--new-token', 'Generate a new auth token')
+        .option('-d, --daemon', 'Run the server in the background')
+        .action(async (opts) => {
+        try {
+            await serverStartCommand(opts);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('add [plugin]')
+        .description('Install a plugin (run without args to list available plugins).')
+        .action(async (plugin) => {
+        try {
+            await addCommand(plugin);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program
+        .command('remove <plugin>')
+        .description('Remove an installed plugin.')
+        .action(async (plugin) => {
+        try {
+            await removeCommand(plugin);
+        }
+        catch (err) {
+            log.error(err.message);
+            process.exit(0);
+        }
+    });
+    program.parse();
+})();
+//# sourceMappingURL=mblk.js.map

package/dist/bin/mblk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mblk.js","sourceRoot":"","sources":["../../src/bin/mblk.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC5J,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/D,CAAC,KAAK,IAAI,EAAE;IAEZ,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACF,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,8EAA8E,CAAC;SAC3F,OAAO,CAAC,OAAO,CAAC;SAChB,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,2CAA2C;SAC/E,eAAe,CAAC;QACb,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,sCAAsC;KACvF,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yFAAyF,CAAC;SACtG,MAAM,CAAC,WAAW,EAAE,uDAAuD,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACtC,IAAI,CAAC;YACD,MAAM,WAAW,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC3B,IAAI,CAAC;YACD,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,cAAc,EAAE,mCAAmC,CAAC;SAC3D,MAAM,CAAC,yBAAyB,EAAE,0CAA0C,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,IAA4C,EAAE,EAAE;QACtF,IAAI,CAAC;YACD,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,CAAC;YACnC,wDAAwD;YACxD,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;gBAChE,IAAI,CAAC;oBACD,MAAM,WAAW,EAAE,CAAC;oBACpB,mCAAmC;oBACnC,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBACf,GAAG,CAAC,KAAK,CAAE,OAAiB,CAAC,OAAO,CAAC,CAAC;oBACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,CAAC;gBACD,OAAO;YACX,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;QAC7B,IAAI,CAAC;YACD,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,aAAa,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,sEAAsE,CAAC;SACnF,MAAM,CAAC,QAAQ,EAAE,6BAA6B,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACD,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAGP,OAAO;SACF,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,yEAAyE,CAAC;SACtF,MAAM,CAAC,QAAQ,EAAE,sCAAsC,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACD,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAC9B,IAAI,CAAC;YACD,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IACP,OAAO;SACF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;SACvE,MAAM,CAAC,eAAe,EAAE,+BAA+B,CAAC;SACxD,MAAM,CAAC,cAAc,EAAE,8BAA8B,CAAC;SACtD,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC;SACrD,MAAM,CAAC,yBAAyB,EAAE,gCAAgC,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAAS,EAAE,EAAE;QACvC,IAAI,CAAC;YACD,MAAM,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IACP,OAAO;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,QAAiB,EAAE,EAAE;QAChC,IAAI,CAAC;YACD,MAAM,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,sCAAsC;IAEtC,MAAM,MAAM,GAAG,OAAO;SACjB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAE/C,MAAM;SACD,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,CAAC;SAC9D,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;SAClD,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAA6D,EAAE,EAAE;QAC5E,IAAI,CAAC;YACD,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,MAAM;SACD,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,iBAAiB,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,MAAM;SACD,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,mBAAmB,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,MAAM;SACD,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,IAA4B,EAAE,EAAE;QAC3C,IAAI,CAAC;YACD,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,uCAAuC;IAEvC,MAAM,OAAO,GAAG,OAAO;SAClB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,+CAA+C,CAAC,CAAC;IAElE,OAAO;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,qBAAqB,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,uBAAuB,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,oBAAoB,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,iCAAiC;IAEjC,OAAO;SACF,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACD,MAAM,eAAe,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,CAAC;SAC9D,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACtC,IAAI,CAAC;YACD,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,8DAA8D;IAC9D,OAAO;SACF,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,CAAC;SAC9D,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;SAClD,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAA6D,EAAE,EAAE;QAC5E,IAAI,CAAC;YACD,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC7B,IAAI,CAAC;YACD,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO;SACF,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC7B,IAAI,CAAC;YACD,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEP,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,CAAC,CAAC,EAAE,CAAC"}

package/dist/cli/commands/create.d.ts

@@ -0,0 +1,2 @@
+export declare function createCommand(blockName: string): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"AAYA,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDpE"}

package/dist/cli/commands/create.js

@@ -0,0 +1,48 @@
+import { join } from 'node:path';
+import { ensureDir, writeJson, atomicWrite, pathExists } from '../../utils/fs.js';
+import { loadGlobalConfig, resolveBlockPath, isInitialized, } from '../../utils/config.js';
+import { BlockConfigSchema, PulseStateSchema } from '../../schemas.js';
+import { log } from '../logger.js';
+import { FILE_TEMPLATES } from '../../engine/prompts.js';
+// Templates moved to prompts.ts
+export async function createCommand(blockName) {
+    if (!(await isInitialized())) {
+        throw new Error('Not initialized. Run `mblk init` first.');
+    }
+    if (!/^[a-z0-9][a-z0-9-]{0,31}$/.test(blockName)) {
+        throw new Error('Block name must start with a letter/number and contain only lowercase letters, numbers, and hyphens (max 32 chars).');
+    }
+    const globalConfig = await loadGlobalConfig();
+    const blockPath = resolveBlockPath(globalConfig, blockName);
+    if (await pathExists(blockPath)) {
+        throw new Error(`Block "${blockName}" already exists at ${blockPath}`);
+    }
+    log.brand(`Creating block: ${blockName}\n`);
+    // Directory structure
+    await ensureDir(blockPath);
+    await ensureDir(join(blockPath, 'agents'));
+    await ensureDir(join(blockPath, 'logs'));
+    // Block config (inherits global defaults)
+    const blockConfig = BlockConfigSchema.parse({
+        name: blockName,
+        adapter: globalConfig.defaults.adapter,
+        memory: globalConfig.defaults.memory,
+        pulse: globalConfig.defaults.pulse,
+    });
+    await writeJson(join(blockPath, 'config.json'), blockConfig);
+    log.success('Created config.json');
+    // Initial pulse state
+    const pulse = PulseStateSchema.parse({});
+    await writeJson(join(blockPath, 'pulse.json'), pulse);
+    log.success('Created pulse.json');
+    // Core identity files
+    await atomicWrite(join(blockPath, 'memory.md'), FILE_TEMPLATES.MEMORY_MD);
+    log.success('Created memory.md');
+    await atomicWrite(join(blockPath, 'monitor.md'), FILE_TEMPLATES.MONITOR_MD(blockName));
+    log.success('Created monitor.md');
+    console.log('');
+    log.brand(`Block "${blockName}" is ready.`);
+    log.dim(`  Path: ${blockPath}`);
+    log.dim(`  Start: mblk start ${blockName}`);
+}
+//# sourceMappingURL=create.js.map