@memoryblock/plugin-agents 0.1.0-beta → 0.1.1-beta

package/README.md

@@ -0,0 +1,35 @@
+# @memoryblock/plugin-agents
+
+Official plugin for orchestrating secondary AI agents in **memoryblock**.
+
+This package handles:
+- Agent delegation
+- Task sub-routing
+- Multi-agent hierarchical scaling
+
+## 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.

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@memoryblock/plugin-agents",
-  "version": "0.1.0-beta",
+  "version": "0.1.1-beta",
   "type": "module",
+  "description": "Official plugin for orchestrating secondary AI agents in memoryblock.",
+  "files": [
+    "dist/"
+  ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -10,12 +14,49 @@
       "import": "./dist/index.js"
     }
   },
-  "dependencies": {
-    "@memoryblock/tools": "0.1.0-beta",
-    "@memoryblock/adapters": "0.1.0-beta",
-    "memoryblock": "0.1.0-beta"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json"
-  }
+  },
+  "dependencies": {
+    "@memoryblock/tools": "^0.1.1-beta",
+    "@memoryblock/adapters": "^0.1.1-beta",
+    "memoryblock": "^0.1.1-beta"
+  },
+  "keywords": [
+    "memoryblock",
+    "mblk",
+    "ai-agent",
+    "assistants",
+    "agents",
+    "automation",
+    "multi-agent",
+    "agentic-framework",
+    "plugin",
+    "autonomous",
+    "orchestration",
+    "multi-agents",
+    "openai",
+    "anthropic",
+    "gemini",
+    "groq",
+    "deepseek",
+    "ollama",
+    "chatgpt",
+    "bedrock",
+    "gpt"
+  ],
+  "author": {
+    "name": "Ghazi",
+    "url": "https://mgks.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/memoryblock-io/memoryblock.git"
+  },
+  "bugs": {
+    "url": "https://github.com/memoryblock-io/memoryblock/issues"
+  },
+  "homepage": "https://memoryblock.io",
+  "funding": "https://github.com/sponsors/mgks",
+  "license": "MIT"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-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/src/index.ts

@@ -1,10 +0,0 @@
-import type { Tool } from '@memoryblock/tools';
-import { createAgentTool } from './tools/create-agent.js';
-import { listAgentsTool } from './tools/list-agents.js';
-import { queryAgentTool } from './tools/query-agent.js';
-
-export const tools: Tool[] = [
-    createAgentTool,
-    listAgentsTool,
-    queryAgentTool
-];

package/src/tools/create-agent.ts

@@ -1,84 +0,0 @@
-
-import { createSchema } from '@memoryblock/tools';
-import { join } from 'node:path';
-import { promises as fsp } from 'node:fs';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - workspace resolution cache issue
-import { loadGlobalConfig, resolveBlocksDir, saveBlockConfig, BlockConfigSchema } from 'memoryblock';
-
-export const createAgentTool = {
-    definition: {
-        name: 'create_agent',
-        description: 'Creates a new memoryblock sub-agent with a specific name, description, and model.',
-        parameters: createSchema({
-            name: { type: 'string', description: 'Agent identifier, lowercase alphanumeric and hyphens (e.g. "code-reviewer")' },
-            description: { type: 'string', description: 'What this agent is designed to do' },
-            model: { type: 'string', description: 'The LLM model to use. Defaults to bedrock but can be openai, gemini, or anthropic if api keys configured (e.g. "gpt-4o", "gemini-2.5-pro", "claude-3-5-sonnet-20241022").' }
-        }, ['name', 'description']),
-        requiresApproval: true
-    },
-    async execute(params: Record<string, unknown>) {
-        const { name, description, model = 'anthropic.claude-3-haiku-20240307-v1:0' } = params as { name: string, description: string, model?: string };
-
-        if (!/^[a-z0-9][a-z0-9-]{0,31}$/.test(name)) {
-            return { content: 'Invalid name format. Use lowercase letters, numbers, and hyphens (max 32 chars).', isError: true };
-        }
-
-        try {
-            const globalConfig = await loadGlobalConfig();
-            const blocksDir = resolveBlocksDir(globalConfig);
-            const blockPath = join(blocksDir, name);
-
-            const exists = await fsp.stat(blockPath).then(() => true).catch(() => false);
-            if (exists) {
-                return { content: `Agent "${name}" already exists.`, isError: true };
-            }
-
-            await fsp.mkdir(blockPath, { recursive: true });
-
-            // Determine provider natively based on common prefixes
-            let provider = 'bedrock';
-            if (model.includes('gpt-') || model.includes('o1-')) provider = 'openai';
-            if (model.includes('gemini-')) provider = 'gemini';
-            if (model.includes('claude-') && !model.includes('anthropic.')) provider = 'anthropic';
-
-            // Adopt default config with sandbox enabled
-            const config = BlockConfigSchema.parse({
-                name,
-                description,
-                adapter: {
-                    ...globalConfig.defaults.adapter,
-                    provider,
-                    model
-                },
-                goals: [description],
-                tools: {
-                    enabled: ['*'],
-                    searchProvider: 'brave',
-                    sandbox: true // Sub-agents must be sandboxed natively
-                },
-                channel: { type: 'cli' },
-                permissions: {
-                    scope: 'block',
-                    allowShell: false,
-                    allowNetwork: true,
-                    maxTimeout: 120_000
-                },
-                memory: globalConfig.defaults.memory,
-                pulse: globalConfig.defaults.pulse
-            });
-
-            await saveBlockConfig(blockPath, config);
-            
-            // Initial memory empty
-            await fsp.writeFile(join(blockPath, 'memory.md'), '# Memory\n\n(no memory yet)', 'utf8');
-
-            return {
-                content: `Created sub-agent "${name}" successfully in sandboxed mode using ${provider}/${model}. You can now use query_agent to assign it tasks.`,
-                isError: false
-            };
-        } catch (err) {
-            return { content: `Failed to create agent: ${(err as Error).message}`, isError: true };
-        }
-    }
-};

package/src/tools/list-agents.ts

@@ -1,50 +0,0 @@
-
-import { createSchema } from '@memoryblock/tools';
-import { join } from 'node:path';
-import { promises as fsp } from 'node:fs';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - workspace resolution cache issue
-import { loadGlobalConfig, resolveBlocksDir, loadBlockConfig } from 'memoryblock';
-
-export const listAgentsTool = {
-    definition: {
-        name: 'list_agents',
-        description: 'Discovers available memoryblock sub-agents that can be queried or delegated tasks to.',
-        parameters: createSchema({}),
-        requiresApproval: false
-    },
-    async execute() {
-        try {
-            const globalConfig = await loadGlobalConfig();
-            const blocksDir = resolveBlocksDir(globalConfig);
-            const entries = await fsp.readdir(blocksDir, { withFileTypes: true });
-
-            const agents = [];
-            for (const entry of entries) {
-                if (entry.isDirectory()) {
-                    try {
-                        const blockPath = join(blocksDir, entry.name);
-                        const config = await loadBlockConfig(blockPath);
-                        let status = 'UNKNOWN';
-                        try {
-                            const pulseRaw = await fsp.readFile(join(blockPath, 'pulse.json'), 'utf-8');
-                            status = JSON.parse(pulseRaw).status;
-                        } catch { /* ignore */ }
-
-                        agents.push(`- **${config.name}**: ${config.description} (Status: ${status})`);
-                    } catch {
-                        // skip invalid blocks
-                    }
-                }
-            }
-
-            if (agents.length === 0) return { content: 'No other agents found.', isError: false };
-            return {
-                content: `Available Agents:\n\n${agents.join('\n')}`,
-                isError: false
-            };
-        } catch (err) {
-            return { content: `Failed to list agents: ${(err as Error).message}`, isError: true };
-        }
-    }
-};

package/src/tools/query-agent.ts

@@ -1,138 +0,0 @@
-
-import { createSchema, createDefaultRegistry } from '@memoryblock/tools';
-import { join } from 'node:path';
-import { promises as fsp } from 'node:fs';
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore - workspace resolution cache issue
-import { 
-    loadGlobalConfig, resolveBlocksDir, loadBlockConfig, loadAuth,
-    Monitor
-} from 'memoryblock';
-
-// Quick inline OrchestratorChannel for interception
-class OrchestratorChannel {
-    public readonly name = 'orchestrator';
-    private messageHandler: ((msg: any) => void) | null = null;
-    private resolveResponse: ((res: string) => void) | null = null;
-    private finalResponse = '';
-
-    onMessage(handler: (msg: any) => void) {
-        this.messageHandler = handler;
-    }
-
-    async send(msg: any) {
-        if (!msg.isSystem && msg.content) {
-            this.finalResponse = msg.content;
-            if (this.resolveResponse) {
-                this.resolveResponse(this.finalResponse);
-            }
-        }
-    }
-
-    async requestApproval() {
-        // Sub-agents auto-deny unapproved actions in orchestration
-        return false;
-    }
-
-    async start() {}
-    async stop() {}
-
-    simulateUser(content: string) {
-        if (this.messageHandler) {
-            this.messageHandler({
-                blockName: 'orchestrator',
-                monitorName: 'orchestrator',
-                content,
-                isSystem: false,
-                timestamp: new Date().toISOString()
-            });
-        }
-    }
-
-    waitForResponse(): Promise<string> {
-        return new Promise(resolve => {
-            this.resolveResponse = resolve;
-        });
-    }
-}
-
-export const queryAgentTool = {
-    definition: {
-        name: 'query_agent',
-        description: 'Delegates a task to a sub-agent. The orchestrator will pause until the sub-agent completes the request and returns its response.',
-        parameters: createSchema({
-            agent_name: { type: 'string', description: 'Name of the sub-agent to query.' },
-            prompt: { type: 'string', description: 'The objective, task, or question to delegate to the sub-agent.' }
-        }, ['agent_name', 'prompt']),
-        requiresApproval: true // Delegating tasks is a major action
-    },
-    async execute(params: Record<string, unknown>) {
-        const { agent_name, prompt } = params as { agent_name: string, prompt: string };
-
-        try {
-            const globalConfig = await loadGlobalConfig();
-            const blockPath = join(resolveBlocksDir(globalConfig), agent_name);
-
-            const exists = await fsp.stat(blockPath).then(() => true).catch(() => false);
-            if (!exists) {
-                return { content: `Agent "${agent_name}" does not exist. Use create_agent first.`, isError: true };
-            }
-
-            const blockConfig = await loadBlockConfig(blockPath);
-
-            // Load adapter natively
-            const adapters = await import('@memoryblock/adapters');
-            let adapter: any;
-            const provider = blockConfig.adapter.provider || 'bedrock';
-            if (provider === 'openai') {
-                const auth = await loadAuth();
-                adapter = new adapters.OpenAIAdapter({
-                    model: blockConfig.adapter.model,
-                    apiKey: auth?.openai?.apiKey || process.env.OPENAI_API_KEY || '',
-                });
-            } else if (provider === 'gemini') {
-                const auth = await loadAuth();
-                adapter = new adapters.GeminiAdapter({
-                    model: blockConfig.adapter.model,
-                    apiKey: auth?.gemini?.apiKey || process.env.GEMINI_API_KEY || '',
-                });
-            } else {
-                adapter = new adapters.BedrockAdapter({
-                    model: blockConfig.adapter.model,
-                    region: blockConfig.adapter.region,
-                    maxTokens: blockConfig.adapter.maxTokens,
-                });
-            }
-
-            const registry = createDefaultRegistry();
-            const channel = new OrchestratorChannel();
-
-            const monitor = new Monitor({
-                blockPath,
-                blockConfig,
-                adapter,
-                registry,
-                channel: channel as any
-            });
-
-            // Start monitor
-            await monitor.start();
-            
-            // Push prompt
-            channel.simulateUser(prompt);
-
-            // Wait until the monitor emits a non-system message
-            const finalResponse = await channel.waitForResponse();
-
-            // Stop monitor cleanup
-            await monitor.stop();
-
-            return {
-                content: `Response from ${agent_name}:\n\n${finalResponse}`,
-                isError: false
-            };
-        } catch (err) {
-            return { content: `Agent query failed: ${(err as Error).message}`, isError: true };
-        }
-    }
-};

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-    "extends": "../../../tsconfig.json",
-    "compilerOptions": {
-        "outDir": "dist",
-        "rootDir": "src"
-    },
-    "include": [
-        "src"
-    ]
-}