@a1hvdy/cc-openclaw 0.3.2

package/dist/src/session/embedded-server.js

@@ -0,0 +1,367 @@
+/**
+ * Embedded HTTP Server — auto-starts with plugin, serves CLI commands
+ *
+ * This is NOT a separate process. It runs inside the plugin (or standalone)
+ * and provides HTTP endpoints for the CLI to connect to.
+ *
+ * Users never need to configure or manage this — it just works.
+ */
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { sanitizeCwd, validateRegex } from '../validation.js';
+import { handleChatCompletion } from '../openai-compat/openai-compat.js';
+import { getModelList } from '../models.js';
+import { getHealthInfo } from '../health/index.js';
+import { DEFAULT_SERVER_PORT, MAX_BODY_SIZE, RATE_LIMIT_WINDOW_MS, OPENAI_COMPAT_SESSION_PREFIX, } from '../constants.js';
+import { getServerHost, getRateLimit, getServerToken, isCorsAllowAll, } from '../lib/config.js';
+export class EmbeddedServer {
+    server = null;
+    manager;
+    port;
+    authToken = null;
+    _rateWindows = new Map();
+    _rateLimitCleanupTimer = null;
+    _rateLimit;
+    host;
+    constructor(manager, port, host) {
+        this.manager = manager;
+        this.port = port || DEFAULT_SERVER_PORT;
+        this.host = host || getServerHost();
+        this._rateLimit = getRateLimit();
+    }
+    _checkRateLimit(ip) {
+        const now = Date.now();
+        const window = this._rateWindows.get(ip) || [];
+        const recent = window.filter((t) => now - t < RATE_LIMIT_WINDOW_MS);
+        recent.push(now);
+        this._rateWindows.set(ip, recent);
+        return recent.length <= this._rateLimit;
+    }
+    async start() {
+        // Auth token: opt-in via OPENCLAW_SERVER_TOKEN env var.
+        // When set, all requests (except /health) must include Authorization: Bearer <token>.
+        // Default: no auth (localhost-only is the primary security boundary).
+        const envToken = getServerToken();
+        if (envToken) {
+            this.authToken = envToken;
+            // Write token to file for CLI to read
+            const tokenDir = path.join(os.homedir(), '.openclaw');
+            try {
+                if (!fs.existsSync(tokenDir))
+                    fs.mkdirSync(tokenDir, { recursive: true });
+                fs.writeFileSync(path.join(tokenDir, 'server-token'), this.authToken, { mode: 0o600 });
+            }
+            catch {
+                /* best effort */
+            }
+        }
+        else {
+            this.authToken = null;
+        }
+        this._rateLimitCleanupTimer = setInterval(() => {
+            const now = Date.now();
+            for (const [ip, timestamps] of this._rateWindows) {
+                const recent = timestamps.filter((t) => now - t < RATE_LIMIT_WINDOW_MS);
+                if (recent.length === 0)
+                    this._rateWindows.delete(ip);
+                else
+                    this._rateWindows.set(ip, recent);
+            }
+        }, RATE_LIMIT_WINDOW_MS);
+        this._rateLimitCleanupTimer.unref();
+        return new Promise((resolve, reject) => {
+            this.server = http.createServer((req, res) => this.handleRequest(req, res));
+            this.server.on('error', (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    // Port already in use — another instance running, skip
+                    console.log(`[embedded-server] Port ${this.port} in use, skipping (another instance running)`);
+                    this.server = null;
+                    resolve(0);
+                }
+                else {
+                    reject(err);
+                }
+            });
+            this.server.listen(this.port, this.host, () => {
+                console.log(`[embedded-server] Listening on http://${this.host}:${this.port}${this.authToken ? ' (auth enabled)' : ''}`);
+                resolve(this.port);
+            });
+        });
+    }
+    async stop() {
+        if (this._rateLimitCleanupTimer) {
+            clearInterval(this._rateLimitCleanupTimer);
+            this._rateLimitCleanupTimer = null;
+        }
+        // Only delete token file if it matches our token
+        try {
+            const tokenPath = path.join(os.homedir(), '.openclaw', 'server-token');
+            const stored = fs.readFileSync(tokenPath, 'utf8');
+            if (stored === this.authToken)
+                fs.unlinkSync(tokenPath);
+        }
+        catch {
+            /* ignore */
+        }
+        if (!this.server)
+            return;
+        return new Promise((resolve) => {
+            this.server.close(() => resolve());
+        });
+    }
+    handleRequest(req, res) {
+        // CORS — localhost by default; /v1/ paths allow all origins (for webchat frontends)
+        const origin = req.headers.origin || '';
+        const urlPath = new URL(req.url || '/', `http://localhost:${this.port}`).pathname;
+        const corsAllowAll = isCorsAllowAll();
+        const isV1Path = urlPath.startsWith('/v1/');
+        const isLocalhost = /^https?:\/\/(localhost|127\.0\.0\.1|0\.0\.0\.0|\[::1\])(:\d+)?$/.test(origin);
+        if (isLocalhost || isV1Path || corsAllowAll) {
+            res.setHeader('Access-Control-Allow-Origin', origin || '*');
+        }
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url || '/', `http://localhost:${this.port}`);
+        const path = url.pathname;
+        // Bearer token auth (skip for health checks)
+        if (this.authToken && path !== '/health') {
+            const authHeader = req.headers.authorization || '';
+            if (authHeader !== `Bearer ${this.authToken}`) {
+                res.writeHead(401, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: 'Unauthorized — provide Authorization: Bearer <token>' }));
+                return;
+            }
+        }
+        // Rate limiting
+        const clientIp = req.socket.remoteAddress || 'unknown';
+        if (!this._checkRateLimit(clientIp)) {
+            res.writeHead(429, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: false, error: 'Rate limit exceeded' }));
+            return;
+        }
+        // Read body for POST — require JSON content type (CSRF mitigation)
+        if (req.method === 'POST') {
+            const contentType = req.headers['content-type'] || '';
+            if (!contentType.includes('application/json')) {
+                res.writeHead(415, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: 'Content-Type must be application/json' }));
+                return;
+            }
+            let body = '';
+            let aborted = false;
+            req.on('data', (chunk) => {
+                if (aborted)
+                    return;
+                body += chunk;
+                if (body.length > MAX_BODY_SIZE) {
+                    aborted = true;
+                    res.writeHead(413, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: 'Payload too large' }));
+                    req.destroy();
+                }
+            });
+            req.on('end', () => {
+                if (aborted)
+                    return;
+                let parsed = {};
+                try {
+                    parsed = JSON.parse(body || '{}');
+                }
+                catch {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: false, error: 'Invalid JSON' }));
+                    return;
+                }
+                this.route(path, parsed, url.searchParams, res, req.headers);
+            });
+        }
+        else {
+            this.route(path, {}, url.searchParams, res, req.headers);
+        }
+    }
+    async route(path, body, query, res, headers = {}) {
+        try {
+            const json = (status, data) => {
+                res.writeHead(status, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(data));
+            };
+            // ─── Session Routes ──────────────────────────────────────────
+            if (path === '/session/start') {
+                if (body.cwd)
+                    body.cwd = sanitizeCwd(body.cwd);
+                const info = await this.manager.startSession(body);
+                json(200, { ok: true, ...info });
+                return;
+            }
+            if (path === '/session/send') {
+                const result = await this.manager.sendMessage(body.name, body.message, {
+                    effort: body.effort,
+                    plan: body.plan,
+                    timeout: body.timeout,
+                });
+                json(200, { ok: true, ...result });
+                return;
+            }
+            if (path === '/session/stop') {
+                await this.manager.stopSession(body.name);
+                json(200, { ok: true });
+                return;
+            }
+            if (path === '/session/list') {
+                json(200, { ok: true, sessions: this.manager.listSessions() });
+                return;
+            }
+            if (path === '/session/status') {
+                const status = this.manager.getStatus(body.name);
+                json(200, { ok: true, ...status });
+                return;
+            }
+            if (path === '/session/grep') {
+                validateRegex(body.pattern);
+                const matches = await this.manager.grepSession(body.name, body.pattern, body.limit);
+                json(200, { ok: true, count: matches.length, matches });
+                return;
+            }
+            if (path === '/session/compact') {
+                await this.manager.compactSession(body.name, body.summary);
+                json(200, { ok: true });
+                return;
+            }
+            if (path === '/session/cost') {
+                const cost = this.manager.getCost(body.name);
+                json(200, { ok: true, ...cost });
+                return;
+            }
+            if (path === '/session/model') {
+                this.manager.setModel(body.name, body.model);
+                json(200, { ok: true });
+                return;
+            }
+            if (path === '/session/effort') {
+                this.manager.setEffort(body.name, body.level);
+                json(200, { ok: true });
+                return;
+            }
+            // ─── Agent Teams ─────────────────────────────────────────────
+            if (path === '/session/team-list') {
+                const response = await this.manager.teamList(body.name);
+                json(200, { ok: true, response });
+                return;
+            }
+            if (path === '/session/team-send') {
+                const result = await this.manager.teamSend(body.name, body.teammate, body.message);
+                json(200, { ok: true, ...result });
+                return;
+            }
+            // ─── File Management ─────────────────────────────────────────
+            if (path === '/agents') {
+                const cwd = query.get('cwd') || undefined;
+                json(200, { ok: true, agents: this.manager.listAgents(cwd) });
+                return;
+            }
+            if (path === '/agents/create') {
+                const p = this.manager.createAgent(body.name, body.cwd, body.description, body.prompt);
+                json(200, { ok: true, path: p });
+                return;
+            }
+            if (path === '/skills') {
+                const cwd = query.get('cwd') || undefined;
+                json(200, { ok: true, skills: this.manager.listSkills(cwd) });
+                return;
+            }
+            if (path === '/skills/create') {
+                const p = this.manager.createSkill(body.name, body.cwd, body);
+                json(200, { ok: true, path: p });
+                return;
+            }
+            if (path === '/rules') {
+                const cwd = query.get('cwd') || undefined;
+                json(200, { ok: true, rules: this.manager.listRules(cwd) });
+                return;
+            }
+            if (path === '/rules/create') {
+                const p = this.manager.createRule(body.name, body.cwd, body);
+                json(200, { ok: true, path: p });
+                return;
+            }
+            // ─── Health ──────────────────────────────────────────────────
+            // Delegated to src/health/handler.ts getHealthInfo() — richer payload
+            // per v3 §11 contract: status, pluginId, version, sessions {active,
+            // total}, uptime {seconds, startedAt}, timestamp. Replaces the prior
+            // inline {ok, version, sessions:N} shape; callers should migrate to
+            // `status: 'ok'` for v0.2.0.
+            if (path === '/health') {
+                json(200, getHealthInfo());
+                return;
+            }
+            // ─── OpenAI-Compatible Routes ─────────────────────────────
+            if (path === '/v1/chat/completions') {
+                await handleChatCompletion(this.manager, body, headers, res);
+                return;
+            }
+            if (path === '/v1/models') {
+                json(200, getModelList());
+                return;
+            }
+            if (path === '/v1/sessions') {
+                // Inspection endpoint for openai-compat sessions only — not interactive
+                // CLI sessions. Production observability: lets ops verify the persistent
+                // CLI is being reused (cached_tokens grows turn-over-turn) instead of
+                // killed every request. Bearer-token gated like the rest of /v1/*.
+                const rows = this.manager
+                    .listSessions()
+                    .filter((s) => s.name.startsWith(OPENAI_COMPAT_SESSION_PREFIX))
+                    .map((s) => {
+                    let stats = null;
+                    try {
+                        stats = this.manager.getStatus(s.name).stats;
+                    }
+                    catch {
+                        /* session may have just been reaped */
+                    }
+                    return {
+                        key: s.name.slice(OPENAI_COMPAT_SESSION_PREFIX.length),
+                        session_name: s.name,
+                        model: s.model,
+                        cwd: s.cwd,
+                        created: s.created,
+                        turns: stats?.turns,
+                        tokens_in: stats?.tokensIn,
+                        tokens_out: stats?.tokensOut,
+                        cached_tokens: stats?.cachedTokens,
+                        context_percent: stats?.contextPercent,
+                        cost_usd: stats?.costUsd,
+                    };
+                });
+                json(200, { object: 'list', data: rows });
+                return;
+            }
+            // Use OpenAI error format for /v1/* paths
+            if (path.startsWith('/v1/')) {
+                json(404, { error: { message: 'Not found', type: 'invalid_request_error', code: null } });
+            }
+            else {
+                json(404, { ok: false, error: 'Not found' });
+            }
+        }
+        catch (err) {
+            const message = err.message;
+            if (path.startsWith('/v1/')) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: { message, type: 'server_error', code: null } }));
+            }
+            else {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: message }));
+            }
+        }
+    }
+}
+//# sourceMappingURL=embedded-server.js.map

package/dist/src/session/embedded-server.js.map

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

package/dist/src/session/inbox-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cross-session messaging (inbox) manager.
+ *
+ * Manages message delivery between sessions. Idle sessions receive messages
+ * immediately; busy sessions queue for later delivery via deliverInbox().
+ */
+import type { InboxMessage, ISession } from '../types.js';
+/**
+ * Callback interface — allows InboxManager to look up sessions
+ * without depending on SessionManager directly.
+ */
+export interface SessionLookup {
+    getSession(name: string): {
+        session: ISession;
+    } | undefined;
+    exists(name: string): boolean;
+    allNames(): Iterable<string>;
+}
+export declare class InboxManager {
+    private inboxes;
+    static escapeXmlAttr(s: string): string;
+    wrapCrossSessionMessage(msg: InboxMessage): string;
+    /**
+     * Send a message from one session to another (or broadcast with to='*').
+     * Returns whether the message was delivered immediately or queued.
+     */
+    sendTo(from: string, to: string, message: string, lookup: SessionLookup, summary?: string, onBroadcastError?: (name: string, err: Error) => void): Promise<{
+        delivered: boolean;
+        queued: boolean;
+    }>;
+    /** Read inbox messages for a session. */
+    inbox(name: string, unreadOnly?: boolean): InboxMessage[];
+    /** Deliver all queued unread messages to a session, mark as read. */
+    deliverInbox(name: string, lookup: SessionLookup): Promise<number>;
+    /** Clear inbox for a session. */
+    clear(name: string): void;
+    private _deliverOrQueue;
+}
+//# sourceMappingURL=inbox-manager.d.ts.map

package/dist/src/session/inbox-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-manager.d.ts","sourceRoot":"","sources":["../../../src/session/inbox-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG1D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqC;IAEpD,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIvC,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IAMlD;;;OAGG;IACG,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,KAAK,IAAI,GACpD,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IA+BnD,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,YAAY,EAAE;IAKtD,qEAAqE;IAC/D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAexE,iCAAiC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;YAMX,eAAe;CA0B9B"}

package/dist/src/session/inbox-manager.js

@@ -0,0 +1,111 @@
+/**
+ * Cross-session messaging (inbox) manager.
+ *
+ * Manages message delivery between sessions. Idle sessions receive messages
+ * immediately; busy sessions queue for later delivery via deliverInbox().
+ */
+import { MAX_INBOX_SIZE } from '../constants.js';
+export class InboxManager {
+    inboxes = new Map();
+    static escapeXmlAttr(s) {
+        return s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    }
+    wrapCrossSessionMessage(msg) {
+        const esc = InboxManager.escapeXmlAttr;
+        const attrs = `from="${esc(msg.from)}"${msg.summary ? ` summary="${esc(msg.summary)}"` : ''}`;
+        return `<cross-session-message ${attrs}>\n${msg.text}\n</cross-session-message>`;
+    }
+    /**
+     * Send a message from one session to another (or broadcast with to='*').
+     * Returns whether the message was delivered immediately or queued.
+     */
+    async sendTo(from, to, message, lookup, summary, onBroadcastError) {
+        if (!lookup.exists(from))
+            throw new Error(`Sender session '${from}' not found`);
+        if (to !== '*' && !lookup.exists(to))
+            throw new Error(`Target session '${to}' not found`);
+        const inboxMsg = {
+            from,
+            text: message,
+            timestamp: new Date().toISOString(),
+            read: false,
+            summary,
+        };
+        // Broadcast
+        if (to === '*') {
+            let delivered = 0;
+            for (const name of lookup.allNames()) {
+                if (name === from)
+                    continue;
+                try {
+                    const ok = await this._deliverOrQueue(name, inboxMsg, lookup);
+                    if (ok)
+                        delivered++;
+                }
+                catch (err) {
+                    onBroadcastError?.(name, err);
+                }
+            }
+            return { delivered: delivered > 0, queued: delivered === 0 };
+        }
+        const delivered = await this._deliverOrQueue(to, inboxMsg, lookup);
+        return { delivered, queued: !delivered };
+    }
+    /** Read inbox messages for a session. */
+    inbox(name, unreadOnly = true) {
+        const box = this.inboxes.get(name) || [];
+        return unreadOnly ? box.filter((m) => !m.read) : box;
+    }
+    /** Deliver all queued unread messages to a session, mark as read. */
+    async deliverInbox(name, lookup) {
+        const managed = lookup.getSession(name);
+        if (!managed)
+            throw new Error(`Session '${name}' not found`);
+        const box = this.inboxes.get(name);
+        if (!box || box.length === 0)
+            return 0;
+        const unread = box.filter((m) => !m.read);
+        if (unread.length === 0)
+            return 0;
+        const formatted = unread.map((m) => this.wrapCrossSessionMessage(m)).join('\n\n');
+        await managed.session.send(formatted, { waitForComplete: false });
+        for (const m of unread)
+            m.read = true;
+        return unread.length;
+    }
+    /** Clear inbox for a session. */
+    clear(name) {
+        this.inboxes.delete(name);
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    async _deliverOrQueue(sessionName, msg, lookup) {
+        const managed = lookup.getSession(sessionName);
+        if (!managed)
+            return false;
+        // If session is idle, deliver directly
+        if (!managed.session.isBusy && managed.session.isReady) {
+            try {
+                await managed.session.send(this.wrapCrossSessionMessage(msg), { waitForComplete: false });
+                msg.read = true;
+                return true;
+            }
+            catch {
+                // Fall through to queue
+            }
+        }
+        // Queue in inbox (with size cap — drop oldest read messages first)
+        if (!this.inboxes.has(sessionName))
+            this.inboxes.set(sessionName, []);
+        const box = this.inboxes.get(sessionName);
+        if (box.length >= MAX_INBOX_SIZE) {
+            const readIdx = box.findIndex((m) => m.read);
+            if (readIdx >= 0)
+                box.splice(readIdx, 1);
+            else
+                box.shift(); // drop oldest unread as last resort
+        }
+        box.push(msg);
+        return false;
+    }
+}
+//# sourceMappingURL=inbox-manager.js.map

package/dist/src/session/inbox-manager.js.map

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

package/dist/src/session/index.d.ts

@@ -0,0 +1,4 @@
+export * from './session-manager.js';
+export * from './inbox-manager.js';
+export * from './embedded-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}

package/dist/src/session/index.js

@@ -0,0 +1,4 @@
+export * from './session-manager.js';
+export * from './inbox-manager.js';
+export * from './embedded-server.js';
+//# sourceMappingURL=index.js.map

package/dist/src/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC"}