@openclaw-cloud/agent-controller 1.0.0 → 2.1.0

package/dist/memory-mcp-server.js

@@ -0,0 +1,291 @@
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Zod schemas — exact match with @modelcontextprotocol/server-memory
+// ---------------------------------------------------------------------------
+const EntitySchema = z.object({
+    name: z.string().describe('The name of the entity'),
+    entityType: z.string().describe('The type of the entity'),
+    observations: z
+        .array(z.string())
+        .describe('An array of observation contents associated with the entity'),
+});
+const RelationSchema = z.object({
+    from: z.string().describe('The name of the entity where the relation starts'),
+    to: z.string().describe('The name of the entity where the relation ends'),
+    relationType: z.string().describe('The type of the relation'),
+});
+// ---------------------------------------------------------------------------
+// MCP server factory
+// ---------------------------------------------------------------------------
+export function createMemoryMcpServer(manager) {
+    const server = new McpServer({
+        name: 'agent-memory',
+        version: '1.0.0',
+    });
+    // --- create_entities ---
+    server.registerTool('create_entities', {
+        title: 'Create Entities',
+        description: 'Create multiple new entities in the knowledge graph',
+        inputSchema: { entities: z.array(EntitySchema) },
+        outputSchema: { entities: z.array(EntitySchema) },
+    }, async ({ entities }) => {
+        const result = await manager.createEntities(entities);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            structuredContent: { entities: result },
+        };
+    });
+    // --- create_relations ---
+    server.registerTool('create_relations', {
+        title: 'Create Relations',
+        description: 'Create multiple new relations between entities in the knowledge graph. Relations should be in active voice',
+        inputSchema: { relations: z.array(RelationSchema) },
+        outputSchema: { relations: z.array(RelationSchema) },
+    }, async ({ relations }) => {
+        const result = await manager.createRelations(relations);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            structuredContent: { relations: result },
+        };
+    });
+    // --- add_observations ---
+    server.registerTool('add_observations', {
+        title: 'Add Observations',
+        description: 'Add new observations to existing entities in the knowledge graph',
+        inputSchema: {
+            observations: z.array(z.object({
+                entityName: z.string().describe('The name of the entity to add the observations to'),
+                contents: z.array(z.string()).describe('An array of observation contents to add'),
+            })),
+        },
+        outputSchema: {
+            results: z.array(z.object({
+                entityName: z.string(),
+                addedObservations: z.array(z.string()),
+            })),
+        },
+    }, async ({ observations }) => {
+        const result = await manager.addObservations(observations);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            structuredContent: { results: result },
+        };
+    });
+    // --- delete_entities ---
+    server.registerTool('delete_entities', {
+        title: 'Delete Entities',
+        description: 'Delete multiple entities and their associated relations from the knowledge graph',
+        inputSchema: {
+            entityNames: z.array(z.string()).describe('An array of entity names to delete'),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            message: z.string(),
+        },
+    }, async ({ entityNames }) => {
+        await manager.deleteEntities(entityNames);
+        return {
+            content: [{ type: 'text', text: 'Entities deleted successfully' }],
+            structuredContent: { success: true, message: 'Entities deleted successfully' },
+        };
+    });
+    // --- delete_observations ---
+    server.registerTool('delete_observations', {
+        title: 'Delete Observations',
+        description: 'Delete specific observations from entities in the knowledge graph',
+        inputSchema: {
+            deletions: z.array(z.object({
+                entityName: z.string().describe('The name of the entity containing the observations'),
+                observations: z.array(z.string()).describe('An array of observations to delete'),
+            })),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            message: z.string(),
+        },
+    }, async ({ deletions }) => {
+        await manager.deleteObservations(deletions);
+        return {
+            content: [{ type: 'text', text: 'Observations deleted successfully' }],
+            structuredContent: { success: true, message: 'Observations deleted successfully' },
+        };
+    });
+    // --- delete_relations ---
+    server.registerTool('delete_relations', {
+        title: 'Delete Relations',
+        description: 'Delete multiple relations from the knowledge graph',
+        inputSchema: {
+            relations: z.array(RelationSchema).describe('An array of relations to delete'),
+        },
+        outputSchema: {
+            success: z.boolean(),
+            message: z.string(),
+        },
+    }, async ({ relations }) => {
+        await manager.deleteRelations(relations);
+        return {
+            content: [{ type: 'text', text: 'Relations deleted successfully' }],
+            structuredContent: { success: true, message: 'Relations deleted successfully' },
+        };
+    });
+    // --- read_graph ---
+    server.registerTool('read_graph', {
+        title: 'Read Graph',
+        description: 'Read the entire knowledge graph',
+        inputSchema: {},
+        outputSchema: {
+            entities: z.array(EntitySchema),
+            relations: z.array(RelationSchema),
+        },
+    }, async () => {
+        const graph = manager.readGraph();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(graph, null, 2) }],
+            structuredContent: { ...graph },
+        };
+    });
+    // --- search_nodes ---
+    server.registerTool('search_nodes', {
+        title: 'Search Nodes',
+        description: 'Search for nodes in the knowledge graph based on a query',
+        inputSchema: {
+            query: z
+                .string()
+                .describe('The search query to match against entity names, types, and observation content'),
+        },
+        outputSchema: {
+            entities: z.array(EntitySchema),
+            relations: z.array(RelationSchema),
+        },
+    }, async ({ query }) => {
+        const graph = manager.searchNodes(query);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(graph, null, 2) }],
+            structuredContent: { ...graph },
+        };
+    });
+    // --- open_nodes ---
+    server.registerTool('open_nodes', {
+        title: 'Open Nodes',
+        description: 'Open specific nodes in the knowledge graph by their names',
+        inputSchema: {
+            names: z.array(z.string()).describe('An array of entity names to retrieve'),
+        },
+        outputSchema: {
+            entities: z.array(EntitySchema),
+            relations: z.array(RelationSchema),
+        },
+    }, async ({ names }) => {
+        const graph = manager.openNodes(names);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(graph, null, 2) }],
+            structuredContent: { ...graph },
+        };
+    });
+    return server;
+}
+// ---------------------------------------------------------------------------
+// HTTP transport — Node.js http server on localhost:3457
+// ---------------------------------------------------------------------------
+const MEMORY_MCP_PORT = 3457;
+/**
+ * Start the MCP memory server on localhost.
+ * Returns a close function for graceful shutdown.
+ */
+export async function startMemoryMcpServer(manager) {
+    // Map of sessionId -> { transport, server } for stateful session management.
+    // Each session gets its own McpServer instance because the SDK only allows
+    // one transport per McpServer (Protocol.connect throws on second call).
+    const sessions = new Map();
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+        if (url.pathname !== '/mcp') {
+            res.writeHead(404);
+            res.end('Not found');
+            return;
+        }
+        // Parse body for POST
+        const MAX_BODY_SIZE = 10 * 1024 * 1024; // 10MB
+        let body = undefined;
+        if (req.method === 'POST') {
+            const chunks = [];
+            let totalSize = 0;
+            let aborted = false;
+            for await (const chunk of req) {
+                const buf = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+                totalSize += buf.length;
+                if (totalSize > MAX_BODY_SIZE) {
+                    res.writeHead(413, { 'Content-Type': 'text/plain' });
+                    res.end('Payload too large');
+                    req.destroy();
+                    aborted = true;
+                    break;
+                }
+                chunks.push(buf);
+            }
+            if (aborted)
+                return;
+            try {
+                body = JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+            }
+            catch {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                return;
+            }
+        }
+        // Check for existing session
+        const sessionId = req.headers['mcp-session-id'];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            await session.transport.handleRequest(req, res, body);
+            return;
+        }
+        // Handle DELETE for session termination
+        if (req.method === 'DELETE') {
+            if (sessionId && sessions.has(sessionId)) {
+                const session = sessions.get(sessionId);
+                await session.transport.close();
+                await session.server.close();
+                sessions.delete(sessionId);
+            }
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        // New session — create a fresh McpServer + transport pair
+        const mcpServer = createMemoryMcpServer(manager);
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+        });
+        transport.onclose = () => {
+            if (transport.sessionId) {
+                sessions.delete(transport.sessionId);
+            }
+        };
+        await mcpServer.connect(transport);
+        await transport.handleRequest(req, res, body);
+        // sessionId is assigned during handleRequest (after initialize handshake)
+        if (transport.sessionId) {
+            sessions.set(transport.sessionId, { transport, server: mcpServer });
+        }
+    });
+    return new Promise((resolve) => {
+        httpServer.listen(MEMORY_MCP_PORT, '127.0.0.1', () => {
+            console.log(`[memory-mcp] MCP memory server listening on http://127.0.0.1:${MEMORY_MCP_PORT}/mcp`);
+            resolve(() => {
+                for (const session of sessions.values()) {
+                    session.transport.close().catch(() => { });
+                    session.server.close().catch(() => { });
+                }
+                sessions.clear();
+                httpServer.close();
+            });
+        });
+    });
+}
+//# sourceMappingURL=memory-mcp-server.js.map

package/dist/memory-mcp-server.js.map

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

package/dist/providers/claude-code/channel-server.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from 'node:events';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+export interface ChannelReplyMeta {
+    chat_id?: string;
+    message_id?: string;
+    source?: string;
+    user?: string;
+    ts?: string;
+    [k: string]: unknown;
+}
+export interface ChannelReply {
+    text: string;
+    reply_to?: string;
+    files?: string[];
+}
+export interface ChannelMessageMeta {
+    chat_id: string;
+    source: string;
+    message_id?: string;
+    user?: string;
+    ts?: string;
+    file_path?: string;
+}
+export type ReplyHandler = (reply: ChannelReply, tool: 'reply' | 'edit_message') => void;
+/**
+ * MCP channel server — stdio-based, modeled after anthropics/claude-plugins-official
+ * `fakechat/server.ts`. When Claude Code is launched with
+ * `--channels plugin:<plugin-name>` and a `.mcp.json` entry that spawns this
+ * process, it advertises the `claude/channel` experimental capability.
+ *
+ * Inbound (we → Claude): `pushChatMessage(content, meta)` emits an MCP
+ * notification `notifications/claude/channel`.
+ *
+ * Outbound (Claude → we): Claude calls our `reply` / `edit_message` tool.
+ * Listeners registered via `onReply(handler)` receive the call args.
+ */
+export declare class ClaudeChannelServer extends EventEmitter {
+    private readonly opts;
+    private server;
+    private transport;
+    private started;
+    constructor(opts?: {
+        name?: string;
+        version?: string;
+        instructions?: string;
+    });
+    private registerHandlers;
+    /**
+     * Start the MCP server on a given transport (stdio by default).
+     * Pass a custom transport for in-process tests.
+     */
+    start(transport?: Transport): Promise<void>;
+    /** Emit a channel notification to Claude. */
+    pushChatMessage(content: string, meta: ChannelMessageMeta): Promise<void>;
+    /** Register a callback for incoming reply/edit tool calls from Claude. */
+    onReply(handler: ReplyHandler): () => void;
+    /** Graceful shutdown. */
+    stop(): Promise<void>;
+    isStarted(): boolean;
+}

package/dist/providers/claude-code/channel-server.js

@@ -0,0 +1,155 @@
+import { EventEmitter } from 'node:events';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * MCP channel server — stdio-based, modeled after anthropics/claude-plugins-official
+ * `fakechat/server.ts`. When Claude Code is launched with
+ * `--channels plugin:<plugin-name>` and a `.mcp.json` entry that spawns this
+ * process, it advertises the `claude/channel` experimental capability.
+ *
+ * Inbound (we → Claude): `pushChatMessage(content, meta)` emits an MCP
+ * notification `notifications/claude/channel`.
+ *
+ * Outbound (Claude → we): Claude calls our `reply` / `edit_message` tool.
+ * Listeners registered via `onReply(handler)` receive the call args.
+ */
+export class ClaudeChannelServer extends EventEmitter {
+    opts;
+    server;
+    transport = null;
+    started = false;
+    constructor(opts = {}) {
+        super();
+        this.opts = opts;
+        this.server = new Server({
+            name: opts.name ?? 'agent-controller',
+            version: opts.version ?? '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+                experimental: { 'claude/channel': {} },
+            },
+            instructions: opts.instructions ??
+                'OpenClaw agent-controller channel. Inbound messages arrive as <channel source="..." chat_id="..."> tags. Always reply via the `reply` tool — your transcript output is not forwarded to the user.',
+        });
+        this.registerHandlers();
+    }
+    registerHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'reply',
+                    description: 'Send a message to the user. Pass `reply_to` for quote-reply, `files` for attachments.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            text: { type: 'string' },
+                            reply_to: { type: 'string' },
+                            files: { type: 'array', items: { type: 'string' } },
+                        },
+                        required: ['text'],
+                    },
+                },
+                {
+                    name: 'edit_message',
+                    description: 'Edit a previously-sent message in place.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            message_id: { type: 'string' },
+                            text: { type: 'string' },
+                        },
+                        required: ['message_id', 'text'],
+                    },
+                },
+            ],
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (req) => {
+            const args = (req.params.arguments ?? {});
+            try {
+                switch (req.params.name) {
+                    case 'reply': {
+                        const reply = {
+                            text: String(args.text ?? ''),
+                            reply_to: typeof args.reply_to === 'string' ? args.reply_to : undefined,
+                            files: Array.isArray(args.files) ? args.files : undefined,
+                        };
+                        this.emit('reply', reply, 'reply');
+                        return { content: [{ type: 'text', text: 'ok' }] };
+                    }
+                    case 'edit_message': {
+                        const reply = {
+                            text: String(args.text ?? ''),
+                            reply_to: typeof args.message_id === 'string' ? args.message_id : undefined,
+                        };
+                        this.emit('reply', reply, 'edit_message');
+                        return { content: [{ type: 'text', text: 'ok' }] };
+                    }
+                    default:
+                        return {
+                            content: [{ type: 'text', text: `unknown tool: ${req.params.name}` }],
+                            isError: true,
+                        };
+                }
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${req.params.name} failed: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Start the MCP server on a given transport (stdio by default).
+     * Pass a custom transport for in-process tests.
+     */
+    async start(transport) {
+        if (this.started)
+            return;
+        this.transport = transport ?? new StdioServerTransport();
+        await this.server.connect(this.transport);
+        this.started = true;
+    }
+    /** Emit a channel notification to Claude. */
+    async pushChatMessage(content, meta) {
+        await this.server.notification({
+            method: 'notifications/claude/channel',
+            params: {
+                content,
+                meta: {
+                    ...meta,
+                    ts: meta.ts ?? new Date().toISOString(),
+                },
+            },
+        });
+    }
+    /** Register a callback for incoming reply/edit tool calls from Claude. */
+    onReply(handler) {
+        this.on('reply', handler);
+        return () => this.off('reply', handler);
+    }
+    /** Graceful shutdown. */
+    async stop() {
+        if (!this.started)
+            return;
+        try {
+            await this.server.close();
+        }
+        catch {
+            /* ignore */
+        }
+        this.started = false;
+        this.transport = null;
+    }
+    isStarted() {
+        return this.started;
+    }
+}
+//# sourceMappingURL=channel-server.js.map

package/dist/providers/claude-code/channel-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-server.js","sourceRoot":"","sources":["../../../src/providers/claude-code/channel-server.ts"],"names":[],"mappings":"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"}

package/dist/providers/claude-code/index.d.ts

@@ -0,0 +1,68 @@
+import type { IAgentProvider, AgentHealthStatus, SendMessageParams } from '../types.js';
+import type { ChatSession, ChatMessage } from '../chat-types.js';
+import type { ChannelReply, ChannelReplyMeta, ChannelMessageMeta } from './channel-server.js';
+export interface ClaudeCodeProviderConfig {
+    workspaceDir: string;
+    anthropicApiKey?: string;
+    anthropicAuthToken?: string;
+    claudeCodeOauthToken?: string;
+    /** Content for CLAUDE.md in the workspace (persona / bootstrap). */
+    claudeMdContent?: string;
+    /** Backend URL for openclaw-backend MCP entry. */
+    backendUrl?: string;
+    /** Agent token for openclaw-backend MCP auth. */
+    agentToken?: string;
+    /** Override socket path (tests). */
+    socketPath?: string;
+    /** Absolute path to the `agent-controller` executable used to spawn the
+     *  channel-server worker. Defaults to `agent-controller` on PATH. */
+    agentControllerBin?: string;
+}
+export type ReplyPublisher = (reply: ChannelReply, tool: 'reply' | 'edit_message', meta: ChannelReplyMeta) => void;
+/**
+ * Claude Code provider — orchestrates a local Claude Code subprocess plus a
+ * channel-server worker that bridges Claude's stdio MCP channel into this
+ * controller process via a Unix domain socket.
+ *
+ * Architecture:
+ *   [Claude Code] ── stdio MCP ──> [agent-controller channel-server worker]
+ *                                  ── unix socket ──> [main agent-controller]
+ *
+ * See `socket-bridge.ts` for the wire protocol.
+ */
+export declare class ClaudeCodeProvider implements IAgentProvider {
+    private readonly cfg;
+    readonly name = "claude-code";
+    private _connected;
+    private bridge;
+    private claude;
+    private lastHeartbeatAt;
+    private pendingLoginUrl;
+    private pendingCodeResolvers;
+    private replyPublisher;
+    constructor(cfg: ClaudeCodeProviderConfig);
+    /** Register an outbound publisher; called by the chat handler at startup. */
+    setReplyPublisher(fn: ReplyPublisher): void;
+    /** Used by the chat handler to feed user-submitted codes into the login flow. */
+    submitLoginCode(code: string): boolean;
+    /** The chat handler checks this to short-circuit the first message with the login URL. */
+    getPendingLoginUrl(): string | null;
+    /** Push an inbound chat/board message to Claude via the channel worker. */
+    pushToChannel(content: string, meta: ChannelMessageMeta): void;
+    /** Internal — invoked by the bridge when Claude replies via the tool. */
+    handleChannelReply(content: string, meta: ChannelReplyMeta, tool: 'reply' | 'edit_message'): void;
+    connect(): Promise<void>;
+    disconnect(): void;
+    isConnected(): boolean;
+    healthCheck(): Promise<AgentHealthStatus>;
+    restart(): Promise<void>;
+    abort(): Promise<void>;
+    sendMessage(params: SendMessageParams): Promise<void>;
+    listSessions(): Promise<ChatSession[]>;
+    getHistory(sessionKey: string, limit?: number): Promise<ChatMessage[]>;
+    private hasCredentials;
+    private materializeWorkspace;
+    private startBridgeAndClaude;
+    private startLoginFlow;
+    private projectJsonlDir;
+}