@memoryblock/plugin-agents 0.1.0-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/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '@memoryblock/tools';
+export declare const tools: Tool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK/C,eAAO,MAAM,KAAK,EAAE,IAAI,EAIvB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+import { createAgentTool } from './tools/create-agent.js';
+import { listAgentsTool } from './tools/list-agents.js';
+import { queryAgentTool } from './tools/query-agent.js';
+export const tools = [
+    createAgentTool,
+    listAgentsTool,
+    queryAgentTool
+];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,MAAM,KAAK,GAAW;IACzB,eAAe;IACf,cAAc;IACd,cAAc;CACjB,CAAC"}

package/dist/tools/create-agent.d.ts

@@ -0,0 +1,13 @@
+export declare const createAgentTool: {
+    definition: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        requiresApproval: boolean;
+    };
+    execute(params: Record<string, unknown>): Promise<{
+        content: string;
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=create-agent.d.ts.map

package/dist/tools/create-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../../src/tools/create-agent.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe;;;;;;;oBAWF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;CAgEhD,CAAC"}

package/dist/tools/create-agent.js

@@ -0,0 +1,78 @@
+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) {
+        const { name, description, model = 'anthropic.claude-3-haiku-20240307-v1:0' } = params;
+        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.message}`, isError: true };
+        }
+    }
+};
+//# sourceMappingURL=create-agent.js.map

package/dist/tools/create-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.js","sourceRoot":"","sources":["../../src/tools/create-agent.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-agents.d.ts

@@ -0,0 +1,13 @@
+export declare const listAgentsTool: {
+    definition: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        requiresApproval: boolean;
+    };
+    execute(): Promise<{
+        content: string;
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=list-agents.d.ts.map

package/dist/tools/list-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agents.d.ts","sourceRoot":"","sources":["../../src/tools/list-agents.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc;;;;;;;;;;;CAyC1B,CAAC"}

package/dist/tools/list-agents.js

@@ -0,0 +1,50 @@
+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.message}`, isError: true };
+        }
+    }
+};
+//# sourceMappingURL=list-agents.js.map

package/dist/tools/list-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agents.js","sourceRoot":"","sources":["../../src/tools/list-agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAC1C,6DAA6D;AAC7D,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,UAAU,EAAE;QACR,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,uFAAuF;QACpG,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;QAC5B,gBAAgB,EAAE,KAAK;KAC1B;IACD,KAAK,CAAC,OAAO;QACT,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtE,MAAM,MAAM,GAAG,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACtB,IAAI,CAAC;wBACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC9C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;wBAChD,IAAI,MAAM,GAAG,SAAS,CAAC;wBACvB,IAAI,CAAC;4BACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;4BAC5E,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;wBACzC,CAAC;wBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;wBAExB,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,WAAW,aAAa,MAAM,GAAG,CAAC,CAAC;oBACnF,CAAC;oBAAC,MAAM,CAAC;wBACL,sBAAsB;oBAC1B,CAAC;gBACL,CAAC;YACL,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACtF,OAAO;gBACH,OAAO,EAAE,wBAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACpD,OAAO,EAAE,KAAK;aACjB,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1F,CAAC;IACL,CAAC;CACJ,CAAC"}

package/dist/tools/query-agent.d.ts

@@ -0,0 +1,13 @@
+export declare const queryAgentTool: {
+    definition: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        requiresApproval: boolean;
+    };
+    execute(params: Record<string, unknown>): Promise<{
+        content: string;
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=query-agent.d.ts.map

package/dist/tools/query-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-agent.d.ts","sourceRoot":"","sources":["../../src/tools/query-agent.ts"],"names":[],"mappings":"AA0DA,eAAO,MAAM,cAAc;;;;;;;oBAUD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;CAqEhD,CAAC"}

package/dist/tools/query-agent.js

@@ -0,0 +1,119 @@
+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 {
+    name = 'orchestrator';
+    messageHandler = null;
+    resolveResponse = null;
+    finalResponse = '';
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async send(msg) {
+        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) {
+        if (this.messageHandler) {
+            this.messageHandler({
+                blockName: 'orchestrator',
+                monitorName: 'orchestrator',
+                content,
+                isSystem: false,
+                timestamp: new Date().toISOString()
+            });
+        }
+    }
+    waitForResponse() {
+        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) {
+        const { agent_name, prompt } = params;
+        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;
+            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
+            });
+            // 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.message}`, isError: true };
+        }
+    }
+};
+//# sourceMappingURL=query-agent.js.map

package/dist/tools/query-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-agent.js","sourceRoot":"","sources":["../../src/tools/query-agent.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@memoryblock/plugin-agents",
+  "version": "0.1.0-beta",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "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"
+  }
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,84 @@
+
+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

@@ -0,0 +1,50 @@
+
+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

@@ -0,0 +1,138 @@
+
+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

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