@openclaw-cloud/agent-controller 1.0.0 → 2.1.0

package/dist/providers/claude-code/socket-bridge.js

@@ -0,0 +1,302 @@
+import net from 'node:net';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { EventEmitter } from 'node:events';
+import { logCollector } from '../../connection.js';
+import { toErrorMessage } from '../../utils/response.js';
+/**
+ * Unix-domain-socket bridge between the main agent-controller process and the
+ * channel-server worker that holds Claude Code's stdio MCP channel.
+ *
+ * Protocol: newline-delimited JSON. Ops:
+ *   { op: "hello", pid }                                    — worker → main
+ *   { op: "reply", content, meta }                          — worker → main (Claude reply tool)
+ *   { op: "edit",  content, meta }                          — worker → main (Claude edit_message tool)
+ *   { op: "push",  content, meta }                          — main   → worker (inbound chat msg)
+ *
+ * Liberal parsing: malformed lines are logged + dropped (never crash the link).
+ */
+export const DEFAULT_SOCKET_PATH = path.join(os.homedir(), '.openclaw', 'claude-channel.sock');
+/**
+ * Server side — lives in the main agent-controller process.
+ *
+ * Accepts exactly one worker connection (extras are rejected + closed). Emits
+ * reply/edit ops; callers invoke `push(content, meta)` to emit an inbound
+ * chat message to the worker.
+ */
+export class ChannelBridgeServer extends EventEmitter {
+    opts;
+    server = null;
+    active = null;
+    buf = '';
+    constructor(opts = {}) {
+        super();
+        this.opts = opts;
+        // Default no-op 'error' listener so re-emitting a server error never turns
+        // into an unhandled-exception process crash if no external listener is
+        // registered. External callers can still attach their own listener.
+        this.on('error', () => {
+            /* no-op */
+        });
+    }
+    get socketPath() {
+        return this.opts.socketPath ?? DEFAULT_SOCKET_PATH;
+    }
+    async listen() {
+        const p = this.socketPath;
+        await fs.promises.mkdir(path.dirname(p), { recursive: true });
+        // Best-effort: remove stale socket file from a previous crash.
+        try {
+            await fs.promises.unlink(p);
+        }
+        catch {
+            /* not present */
+        }
+        return new Promise((resolve, reject) => {
+            const srv = net.createServer((sock) => this.handleConnection(sock));
+            // One-shot rejector so listen() failures surface to the awaiter; detach
+            // after successful bind so it doesn't leak into runtime errors.
+            const onListenError = (err) => {
+                srv.removeListener('error', onRuntimeError);
+                reject(err);
+            };
+            const onRuntimeError = (err) => {
+                logCollector?.push('channel_bridge_error', 'error', `bridge server error: ${err.message}`);
+                this.emit('error', err);
+            };
+            srv.once('error', onListenError);
+            srv.on('error', onRuntimeError);
+            srv.listen(p, () => {
+                srv.removeListener('error', onListenError);
+                this.server = srv;
+                logCollector?.push('channel_bridge_listening', 'info', `channel bridge on ${p}`);
+                resolve();
+            });
+        });
+    }
+    handleConnection(sock) {
+        if (this.active) {
+            // Reject extras — we expect exactly one worker.
+            logCollector?.push('channel_bridge_reject_extra', 'warn', 'extra worker connection rejected — one worker already active');
+            try {
+                sock.end();
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        this.active = sock;
+        sock.setEncoding('utf8');
+        sock.on('data', (chunk) => this.ingest(String(chunk)));
+        sock.on('close', () => {
+            this.active = null;
+            this.buf = '';
+            logCollector?.push('channel_bridge_closed', 'info', 'worker connection closed');
+            this.emit('close');
+        });
+        sock.on('error', (err) => {
+            logCollector?.push('channel_bridge_sock_error', 'warn', `worker socket error: ${err.message}`);
+        });
+    }
+    ingest(chunk) {
+        this.buf += chunk;
+        let idx;
+        while ((idx = this.buf.indexOf('\n')) >= 0) {
+            const line = this.buf.slice(0, idx).trim();
+            this.buf = this.buf.slice(idx + 1);
+            if (!line)
+                continue;
+            let msg = null;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                logCollector?.push('channel_bridge_bad_line', 'warn', 'dropped malformed bridge line');
+                continue;
+            }
+            this.dispatch(msg);
+        }
+    }
+    dispatch(msg) {
+        if (!msg || typeof msg !== 'object' || !msg.op)
+            return;
+        switch (msg.op) {
+            case 'hello': {
+                const pid = typeof msg.pid === 'number' ? msg.pid : null;
+                logCollector?.push('channel_bridge_hello', 'info', `worker hello pid=${pid ?? 'unknown'}`);
+                this.emit('connect', pid);
+                break;
+            }
+            case 'reply': {
+                const m = msg;
+                const content = typeof m.content === 'string' ? m.content : '';
+                const meta = (m.meta ?? {});
+                this.emit('reply', content, meta, 'reply');
+                break;
+            }
+            case 'edit': {
+                const m = msg;
+                const content = typeof m.content === 'string' ? m.content : '';
+                const meta = (m.meta ?? {});
+                this.emit('reply', content, meta, 'edit_message');
+                break;
+            }
+            default:
+                logCollector?.push('channel_bridge_unknown_op', 'warn', `unknown op: ${String(msg.op)}`);
+        }
+    }
+    /** Push an inbound chat message to the worker (→ Claude MCP notification). */
+    push(content, meta) {
+        this.write({ op: 'push', content, meta });
+    }
+    write(op) {
+        if (!this.active) {
+            logCollector?.push('channel_bridge_no_worker', 'warn', `dropped op ${op.op} — no worker`);
+            return;
+        }
+        try {
+            this.active.write(JSON.stringify(op) + '\n');
+        }
+        catch (err) {
+            logCollector?.push('channel_bridge_write_error', 'warn', `write ${op.op} failed: ${toErrorMessage(err)}`);
+        }
+    }
+    async close() {
+        try {
+            this.active?.end();
+        }
+        catch {
+            /* ignore */
+        }
+        this.active = null;
+        if (!this.server)
+            return;
+        const srv = this.server;
+        this.server = null;
+        await new Promise((resolve) => srv.close(() => resolve()));
+        try {
+            await fs.promises.unlink(this.socketPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    isConnected() {
+        return !!this.active;
+    }
+}
+/**
+ * Client side — lives in the channel-server worker subprocess.
+ *
+ * Connects to the bridge socket with retry/backoff (up to 30s). Parses
+ * incoming `push` ops and forwards outgoing `reply`/`edit` ops.
+ */
+export class ChannelBridgeClient extends EventEmitter {
+    opts;
+    sock = null;
+    buf = '';
+    closed = false;
+    constructor(opts = {}) {
+        super();
+        this.opts = opts;
+    }
+    get socketPath() {
+        return this.opts.socketPath ?? DEFAULT_SOCKET_PATH;
+    }
+    async connect() {
+        const maxWait = this.opts.maxWaitMs ?? 30_000;
+        const started = Date.now();
+        let attempt = 0;
+        // Retry with capped exponential backoff while the main process comes up.
+        while (true) {
+            try {
+                await this.connectOnce();
+                return;
+            }
+            catch (err) {
+                if (Date.now() - started > maxWait) {
+                    throw err instanceof Error ? err : new Error(String(err));
+                }
+                attempt += 1;
+                const delay = Math.min(2000, 100 * 2 ** Math.min(attempt, 6));
+                await new Promise((r) => setTimeout(r, delay));
+            }
+        }
+    }
+    connectOnce() {
+        return new Promise((resolve, reject) => {
+            const s = net.createConnection({ path: this.socketPath });
+            const onError = (err) => {
+                s.removeAllListeners();
+                reject(err);
+            };
+            s.once('error', onError);
+            s.once('connect', () => {
+                s.removeListener('error', onError);
+                s.setEncoding('utf8');
+                this.sock = s;
+                s.on('data', (chunk) => this.ingest(String(chunk)));
+                s.on('close', () => {
+                    this.sock = null;
+                    this.buf = '';
+                    if (!this.closed)
+                        this.emit('close');
+                });
+                s.on('error', (err) => this.emit('error', err));
+                resolve();
+            });
+        });
+    }
+    sendHello(pid) {
+        this.write({ op: 'hello', pid });
+    }
+    sendReply(content, meta, tool) {
+        this.write({ op: tool === 'edit_message' ? 'edit' : 'reply', content, meta });
+    }
+    ingest(chunk) {
+        this.buf += chunk;
+        let idx;
+        while ((idx = this.buf.indexOf('\n')) >= 0) {
+            const line = this.buf.slice(0, idx).trim();
+            this.buf = this.buf.slice(idx + 1);
+            if (!line)
+                continue;
+            let msg = null;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (msg && msg.op === 'push') {
+                const m = msg;
+                const content = typeof m.content === 'string' ? m.content : '';
+                const meta = (m.meta ?? {});
+                this.emit('push', content, meta);
+            }
+        }
+    }
+    write(op) {
+        if (!this.sock)
+            return;
+        try {
+            this.sock.write(JSON.stringify(op) + '\n');
+        }
+        catch {
+            /* ignore — socket will emit close/error */
+        }
+    }
+    close() {
+        this.closed = true;
+        try {
+            this.sock?.end();
+        }
+        catch {
+            /* ignore */
+        }
+        this.sock = null;
+    }
+}
+//# sourceMappingURL=socket-bridge.js.map

package/dist/providers/claude-code/socket-bridge.js.map

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

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

@@ -0,0 +1,44 @@
+import { spawn, type ChildProcess } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+export interface SpawnClaudeDeps {
+    /** Working directory for the claude process (workspace). */
+    workspaceDir: string;
+    /** Channels plugin flag argument (defaults to `plugin:agent-controller`). */
+    channelsFlag?: string;
+    /** Extra CLI flags to append. */
+    extraArgs?: string[];
+    /** Environment variables to merge on top of process.env. */
+    env?: Record<string, string | undefined>;
+    /** Allow `--dangerously-load-development-channels` (default true). */
+    danglyDev?: boolean;
+    /** Override spawn (tests). */
+    spawnFn?: typeof spawn;
+    /** Max retries on crash (default 5). */
+    maxRetries?: number;
+}
+/**
+ * Supervise a `claude` subprocess. Emits:
+ *   - `stderr` (Buffer)
+ *   - `stdout` (Buffer)
+ *   - `spawn` (ChildProcess)
+ *   - `exit` (code|null, signal|null)
+ *   - `gaveup` — too many crashes, no more restarts.
+ *
+ * Restart on crash with capped exponential backoff.
+ */
+export declare class ClaudeProcess extends EventEmitter {
+    private readonly deps;
+    private child;
+    private retries;
+    private shuttingDown;
+    private lastSpawnAt;
+    constructor(deps: SpawnClaudeDeps);
+    start(): void;
+    private spawnOnce;
+    private buildArgs;
+    /** Send SIGINT to interrupt the current turn. */
+    interrupt(): void;
+    stop(): void;
+    isRunning(): boolean;
+    getChild(): ChildProcess | null;
+}

package/dist/providers/claude-code/spawn-claude.js

@@ -0,0 +1,108 @@
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import { logCollector } from '../../connection.js';
+/**
+ * Supervise a `claude` subprocess. Emits:
+ *   - `stderr` (Buffer)
+ *   - `stdout` (Buffer)
+ *   - `spawn` (ChildProcess)
+ *   - `exit` (code|null, signal|null)
+ *   - `gaveup` — too many crashes, no more restarts.
+ *
+ * Restart on crash with capped exponential backoff.
+ */
+export class ClaudeProcess extends EventEmitter {
+    deps;
+    child = null;
+    retries = 0;
+    shuttingDown = false;
+    lastSpawnAt = 0;
+    constructor(deps) {
+        super();
+        this.deps = deps;
+    }
+    start() {
+        if (this.child)
+            return;
+        this.shuttingDown = false;
+        this.spawnOnce();
+    }
+    spawnOnce() {
+        const spawnFn = this.deps.spawnFn ?? spawn;
+        const args = this.buildArgs();
+        this.lastSpawnAt = Date.now();
+        const child = spawnFn('claude', args, {
+            cwd: this.deps.workspaceDir,
+            env: { ...process.env, ...(this.deps.env ?? {}) },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.child = child;
+        child.stdout?.on('data', (data) => this.emit('stdout', data));
+        child.stderr?.on('data', (data) => {
+            this.emit('stderr', data);
+            logCollector?.push('claude_stderr', 'debug', data.toString().slice(0, 500));
+        });
+        child.on('error', (err) => {
+            logCollector?.push('claude_spawn_error', 'error', err.message);
+            this.emit('error', err);
+        });
+        child.on('exit', (code, signal) => {
+            this.emit('exit', code, signal);
+            this.child = null;
+            if (this.shuttingDown)
+                return;
+            // Reset retries on a healthy long run
+            if (Date.now() - this.lastSpawnAt > 60_000)
+                this.retries = 0;
+            const maxRetries = this.deps.maxRetries ?? 5;
+            // Semantics: maxRetries is the number of RESTART attempts allowed.
+            // Increment first, then check — so maxRetries=5 yields exactly 5 restarts
+            // (retry counts 1..5) before giving up on the 6th crash.
+            this.retries += 1;
+            if (this.retries > maxRetries) {
+                logCollector?.push('claude_giveup', 'error', `claude crashed too many times (${this.retries - 1}/${maxRetries}), giving up`);
+                this.emit('gaveup');
+                return;
+            }
+            const backoff = Math.min(30_000, 500 * 2 ** (this.retries - 1));
+            logCollector?.push('claude_restart_scheduled', 'warn', `claude exited code=${code ?? 'null'} sig=${signal ?? 'null'}; retry ${this.retries}/${maxRetries} in ${backoff}ms`);
+            setTimeout(() => {
+                if (!this.shuttingDown)
+                    this.spawnOnce();
+            }, backoff).unref();
+        });
+        this.emit('spawn', child);
+        logCollector?.push('claude_spawned', 'info', `claude spawned (pid=${child.pid})`);
+    }
+    buildArgs() {
+        const args = ['--channels', this.deps.channelsFlag ?? 'plugin:agent-controller'];
+        if (this.deps.danglyDev !== false)
+            args.push('--dangerously-load-development-channels');
+        if (this.deps.extraArgs)
+            args.push(...this.deps.extraArgs);
+        return args;
+    }
+    /** Send SIGINT to interrupt the current turn. */
+    interrupt() {
+        this.child?.kill('SIGINT');
+    }
+    stop() {
+        this.shuttingDown = true;
+        if (this.child) {
+            try {
+                this.child.kill('SIGTERM');
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.child = null;
+    }
+    isRunning() {
+        return !!this.child && this.child.exitCode === null;
+    }
+    getChild() {
+        return this.child;
+    }
+}
+//# sourceMappingURL=spawn-claude.js.map

package/dist/providers/claude-code/spawn-claude.js.map

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

package/dist/providers/index.d.ts

@@ -4,8 +4,10 @@ export type { ChatSession, ChatMessage, ChatAttachment, ChatContentBlock, IChatP
 export { OpenclawProvider } from './openclaw/index.js';
 export { MockProvider } from './mock/index.js';
 export type { MockAction } from './mock/index.js';
+export { ClaudeCodeProvider } from './claude-code/index.js';
+export type { ClaudeCodeProviderConfig } from './claude-code/index.js';
 export declare function configureProvider(provider: IAgentProvider): void;
 export declare function getProvider(): IAgentProvider | null;
 /** For testing only — reset the global provider */
 export declare function resetProvider(): void;
-export declare function createProvider(type: string, config: Record<string, string>): IAgentProvider;
+export declare function createProvider(type: string, config: Record<string, string | undefined>): IAgentProvider;

package/dist/providers/index.js

@@ -1,7 +1,9 @@
 import { OpenclawProvider } from './openclaw/index.js';
 import { MockProvider } from './mock/index.js';
+import { ClaudeCodeProvider } from './claude-code/index.js';
 export { OpenclawProvider } from './openclaw/index.js';
 export { MockProvider } from './mock/index.js';
+export { ClaudeCodeProvider } from './claude-code/index.js';
 let _provider = null;
 export function configureProvider(provider) {
     _provider = provider;
@@ -19,6 +21,16 @@ export function createProvider(type, config) {
             return new OpenclawProvider(config.wsUrl ?? 'ws://localhost:18789', config.wsToken ?? '');
         case 'mock':
             return new MockProvider();
+        case 'claude-code':
+            return new ClaudeCodeProvider({
+                workspaceDir: config.workspaceDir ?? '/home/ubuntu/.claude/workspace',
+                anthropicApiKey: config.anthropicApiKey,
+                anthropicAuthToken: config.anthropicAuthToken,
+                claudeCodeOauthToken: config.claudeCodeOauthToken,
+                backendUrl: config.backendUrl,
+                agentToken: config.agentToken,
+                claudeMdContent: config.claudeMdContent,
+            });
         default:
             throw new Error(`Unknown provider type: ${type}`);
     }

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa;IAC3B,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAA8B;IACzE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,sBAAsB,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5F,KAAK,MAAM;YACT,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa;IAC3B,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,MAA0C;IAE1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,sBAAsB,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5F,KAAK,MAAM;YACT,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,CAAC;gBAC5B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,gCAAgC;gBACrE,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;gBAC7C,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;gBACjD,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC,CAAC;QACL;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -5,7 +5,7 @@
  *   board:<workspaceId> — board events (card:entered, card:moved, etc.)
  *   heartbeat:<agentId> — heartbeat publications from agent
  */
-export type CommandType = 'diagnostics' | 'restart' | 'deploy' | 'pair' | 'stop' | 'backup' | 'chat_list_sessions' | 'chat_history' | 'chat_send' | 'package_install' | 'file_write' | 'file_delete' | 'onboarding_complete' | 'knowledge_sync' | 'self_update' | 'telegram_webhook' | 'update_skills' | 'update_config';
+export type CommandType = 'diagnostics' | 'restart' | 'deploy' | 'pair' | 'stop' | 'backup' | 'chat_list_sessions' | 'chat_history' | 'chat_send' | 'package_install' | 'file_write' | 'file_delete' | 'onboarding_complete' | 'knowledge_sync' | 'self_update' | 'telegram_webhook' | 'update_skills' | 'update_config' | 'memory_create_entities' | 'memory_create_relations' | 'memory_add_observations' | 'memory_delete_entities' | 'memory_delete_observations' | 'memory_delete_relations' | 'memory_read_graph' | 'memory_search_nodes' | 'memory_open_nodes';
 export interface AgentCommand {
     id: string;
     type: CommandType;

package/dist/utils/knowledge-graph.d.ts

@@ -0,0 +1,66 @@
+import { EventEmitter } from 'node:events';
+export interface Entity {
+    name: string;
+    entityType: string;
+    observations: string[];
+}
+export interface Relation {
+    from: string;
+    to: string;
+    relationType: string;
+}
+export interface Graph {
+    entities: Entity[];
+    relations: Relation[];
+}
+export interface ObservationInput {
+    entityName: string;
+    contents: string[];
+}
+export interface ObservationResult {
+    entityName: string;
+    addedObservations: string[];
+}
+export interface ObservationDeletion {
+    entityName: string;
+    observations: string[];
+}
+export type MemoryDeltaAction = 'entities_created' | 'relations_created' | 'observations_added' | 'entities_deleted' | 'observations_deleted' | 'relations_deleted';
+export interface MemoryDelta {
+    action: MemoryDeltaAction;
+    data: unknown;
+}
+/**
+ * In-memory knowledge graph with atomic persistence.
+ *
+ * Ported from @modelcontextprotocol/server-memory with key differences:
+ * - Graph stays in memory (this.graph), loaded once at init()
+ * - All mutations operate on this.graph, then call persist()
+ * - persist() uses atomic write: write to .tmp file, then fs.rename()
+ * - Extends EventEmitter, emits 'delta' event after each mutation
+ * - Query methods (readGraph, searchNodes, openNodes) are synchronous
+ */
+export declare class KnowledgeGraphManager extends EventEmitter {
+    private memoryFilePath;
+    private graph;
+    private persistQueue;
+    constructor(memoryFilePath: string);
+    /** Load graph from disk into memory. Call once at startup. */
+    init(): Promise<void>;
+    private readGraphFromDisk;
+    /** Serialized persist: enqueues writes so concurrent calls never interleave. */
+    private persist;
+    /** Atomic persist: write to .tmp, then fs.rename(). */
+    private doPersist;
+    /** Emit delta event after mutation (for sync to backend). */
+    private emitDelta;
+    createEntities(entities: Entity[]): Promise<Entity[]>;
+    createRelations(relations: Relation[]): Promise<Relation[]>;
+    addObservations(observations: ObservationInput[]): Promise<ObservationResult[]>;
+    deleteEntities(names: string[]): Promise<void>;
+    deleteObservations(deletions: ObservationDeletion[]): Promise<void>;
+    deleteRelations(relations: Relation[]): Promise<void>;
+    readGraph(): Graph;
+    searchNodes(query: string): Graph;
+    openNodes(names: string[]): Graph;
+}