@farazirfan/costar-server-executor 1.0.0

package/dist/utils/log-buffer.js

@@ -0,0 +1,100 @@
+/**
+ * CoStar Server Executor - In-Memory Log Buffer
+ * Captures console output into a ring buffer for the web dashboard
+ */
+const MAX_BUFFER_SIZE = 2000;
+let logBuffer = [];
+let logIdCounter = 0;
+let sseClients = [];
+let sseClientIdCounter = 0;
+/** Add a log entry to the buffer */
+export function addLog(level, component, message) {
+    const entry = {
+        id: ++logIdCounter,
+        timestamp: new Date().toISOString(),
+        level,
+        component,
+        message,
+    };
+    logBuffer.push(entry);
+    // Trim buffer if over max size
+    if (logBuffer.length > MAX_BUFFER_SIZE) {
+        logBuffer = logBuffer.slice(-MAX_BUFFER_SIZE);
+    }
+    // Push to SSE clients
+    for (const client of sseClients) {
+        try {
+            client.res.write(`data: ${JSON.stringify(entry)}\n\n`);
+        }
+        catch {
+            // Client disconnected, will be cleaned up
+        }
+    }
+}
+/** Get recent log entries with optional filtering */
+export function getLogs(options) {
+    let filtered = logBuffer;
+    if (options?.component) {
+        filtered = filtered.filter((e) => e.component === options.component);
+    }
+    if (options?.level) {
+        filtered = filtered.filter((e) => e.level === options.level);
+    }
+    const total = filtered.length;
+    const offset = options?.offset || 0;
+    const limit = options?.limit || 100;
+    // Return most recent first
+    const entries = filtered.slice().reverse().slice(offset, offset + limit);
+    return { entries, total };
+}
+/** Register an SSE client */
+export function addSSEClient(res) {
+    const id = ++sseClientIdCounter;
+    sseClients.push({ id, res });
+    return id;
+}
+/** Remove an SSE client */
+export function removeSSEClient(id) {
+    sseClients = sseClients.filter((c) => c.id !== id);
+}
+/** Get available component names */
+export function getLogComponents() {
+    const components = new Set(logBuffer.map((e) => e.component));
+    return Array.from(components).sort();
+}
+/**
+ * Intercept console methods to capture logs into the buffer.
+ * Call this once at server startup.
+ */
+export function interceptConsoleLogs() {
+    const originalLog = console.log;
+    const originalWarn = console.warn;
+    const originalError = console.error;
+    function parseComponent(msg) {
+        // Parse [COMPONENT] prefix from log messages
+        const match = msg.match(/^\[([A-Z_]+)\]\s*/);
+        if (match) {
+            return { component: match[1].toLowerCase(), cleanMsg: msg.slice(match[0].length) };
+        }
+        return { component: "system", cleanMsg: msg };
+    }
+    console.log = (...args) => {
+        originalLog.apply(console, args);
+        const msg = args.map(String).join(" ");
+        const { component, cleanMsg } = parseComponent(msg);
+        addLog("info", component, cleanMsg);
+    };
+    console.warn = (...args) => {
+        originalWarn.apply(console, args);
+        const msg = args.map(String).join(" ");
+        const { component, cleanMsg } = parseComponent(msg);
+        addLog("warn", component, cleanMsg);
+    };
+    console.error = (...args) => {
+        originalError.apply(console, args);
+        const msg = args.map(String).join(" ");
+        const { component, cleanMsg } = parseComponent(msg);
+        addLog("error", component, cleanMsg);
+    };
+}
+//# sourceMappingURL=log-buffer.js.map

package/dist/utils/log-buffer.js.map

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

package/dist/utils/tool-helpers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * CoStar Server Executor - Tool Helper Functions
+ * Cloned from OpenClaw's agents/tools/common.ts patterns
+ */
+import type { AgentToolResult } from "../types/tool.js";
+/**
+ * Create a JSON result for tool responses
+ */
+export declare function jsonResult(data: unknown): AgentToolResult;
+/**
+ * Read a string parameter from tool args with validation
+ */
+export declare function readStringParam(params: Record<string, unknown>, key: string, options?: {
+    required?: boolean;
+    trim?: boolean;
+}): string | undefined;
+/**
+ * Read a number parameter from tool args with validation
+ */
+export declare function readNumberParam(params: Record<string, unknown>, key: string, options?: {
+    required?: boolean;
+    integer?: boolean;
+    min?: number;
+    max?: number;
+}): number | undefined;
+/**
+ * Read a boolean parameter from tool args
+ */
+export declare function readBooleanParam(params: Record<string, unknown>, key: string, defaultValue?: boolean): boolean;
+/**
+ * Read an array parameter from tool args
+ */
+export declare function readArrayParam<T>(params: Record<string, unknown>, key: string, options?: {
+    required?: boolean;
+}): T[] | undefined;
+/**
+ * Truncate text to max length with ellipsis
+ */
+export declare function truncateText(text: string, maxLength: number): string;
+/**
+ * Truncate text in the middle to fit max length
+ */
+export declare function truncateMiddle(text: string, maxLength: number): string;
+/**
+ * Format duration in milliseconds to human-readable string
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/utils/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAUzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,MAAM,GAAG,SAAS,CAYpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,MAAM,GAAG,SAAS,CAqBpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,UAAQ,GACnB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,CAAC,EAAE,GAAG,SAAS,CAYjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/utils/tool-helpers.js

@@ -0,0 +1,125 @@
+/**
+ * CoStar Server Executor - Tool Helper Functions
+ * Cloned from OpenClaw's agents/tools/common.ts patterns
+ */
+/**
+ * Create a JSON result for tool responses
+ */
+export function jsonResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+        details: data,
+    };
+}
+/**
+ * Read a string parameter from tool args with validation
+ */
+export function readStringParam(params, key, options) {
+    const value = params[key];
+    if (value === undefined || value === null) {
+        if (options?.required) {
+            throw new Error(`Required parameter "${key}" is missing`);
+        }
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new Error(`Parameter "${key}" must be a string`);
+    }
+    return options?.trim === false ? value : value.trim();
+}
+/**
+ * Read a number parameter from tool args with validation
+ */
+export function readNumberParam(params, key, options) {
+    const value = params[key];
+    if (value === undefined || value === null) {
+        if (options?.required) {
+            throw new Error(`Required parameter "${key}" is missing`);
+        }
+        return undefined;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`Parameter "${key}" must be a finite number`);
+    }
+    if (options?.integer && !Number.isInteger(value)) {
+        throw new Error(`Parameter "${key}" must be an integer`);
+    }
+    if (options?.min !== undefined && value < options.min) {
+        throw new Error(`Parameter "${key}" must be >= ${options.min}`);
+    }
+    if (options?.max !== undefined && value > options.max) {
+        throw new Error(`Parameter "${key}" must be <= ${options.max}`);
+    }
+    return value;
+}
+/**
+ * Read a boolean parameter from tool args
+ */
+export function readBooleanParam(params, key, defaultValue = false) {
+    const value = params[key];
+    if (value === undefined || value === null) {
+        return defaultValue;
+    }
+    return Boolean(value);
+}
+/**
+ * Read an array parameter from tool args
+ */
+export function readArrayParam(params, key, options) {
+    const value = params[key];
+    if (value === undefined || value === null) {
+        if (options?.required) {
+            throw new Error(`Required parameter "${key}" is missing`);
+        }
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`Parameter "${key}" must be an array`);
+    }
+    return value;
+}
+/**
+ * Truncate text to max length with ellipsis
+ */
+export function truncateText(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.slice(0, maxLength - 3) + "...";
+}
+/**
+ * Truncate text in the middle to fit max length
+ */
+export function truncateMiddle(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    const ellipsis = "...";
+    const sideLength = Math.floor((maxLength - ellipsis.length) / 2);
+    return text.slice(0, sideLength) + ellipsis + text.slice(-sideLength);
+}
+/**
+ * Format duration in milliseconds to human-readable string
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    if (ms < 3600000) {
+        const minutes = Math.floor(ms / 60000);
+        const seconds = Math.floor((ms % 60000) / 1000);
+        return `${minutes}m ${seconds}s`;
+    }
+    const hours = Math.floor(ms / 3600000);
+    const minutes = Math.floor((ms % 3600000) / 60000);
+    return `${hours}h ${minutes}m`;
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/utils/tool-helpers.js.map

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

package/dist/utils/utils.d.ts

@@ -0,0 +1,44 @@
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function clampNumber(value: number, min: number, max: number): number;
+export declare function clampInt(value: number, min: number, max: number): number;
+export type WebChannel = "web";
+export declare function assertWebChannel(input: string): asserts input is WebChannel;
+export declare function normalizePath(p: string): string;
+export declare function withWhatsAppPrefix(number: string): string;
+export declare function normalizeE164(number: string): string;
+/**
+ * "Self-chat mode" heuristic (single phone): the gateway is logged in as the owner's own WhatsApp account,
+ * and `channels.whatsapp.allowFrom` includes that same number. Used to avoid side-effects that make no sense when the
+ * "bot" and the human are the same WhatsApp identity (e.g. auto read receipts, @mention JID triggers).
+ */
+export declare function isSelfChatMode(selfE164: string | null | undefined, allowFrom?: Array<string | number> | null): boolean;
+export declare function toWhatsappJid(number: string): string;
+export type JidToE164Options = {
+    authDir?: string;
+    lidMappingDirs?: string[];
+    logMissing?: boolean;
+};
+type LidLookup = {
+    getPNForLID?: (jid: string) => Promise<string | null>;
+};
+export declare function jidToE164(jid: string, opts?: JidToE164Options): string | null;
+export declare function resolveJidToE164(jid: string | null | undefined, opts?: JidToE164Options & {
+    lidLookup?: LidLookup;
+}): Promise<string | null>;
+export declare function sleep(ms: number): Promise<unknown>;
+export declare function sliceUtf16Safe(input: string, start: number, end?: number): string;
+export declare function truncateUtf16Safe(input: string, maxLen: number): string;
+export declare function resolveUserPath(input: string): string;
+export declare function resolveConfigDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
+export declare function resolveHomeDir(): string | undefined;
+export declare function shortenHomePath(input: string): string;
+export declare function shortenHomeInString(input: string): string;
+export declare function displayPath(input: string): string;
+export declare function displayString(input: string): string;
+export declare function formatTerminalLink(label: string, url: string, opts?: {
+    fallback?: string;
+    force?: boolean;
+}): string;
+export declare const CONFIG_DIR: string;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

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

package/dist/utils/utils.js

@@ -0,0 +1,257 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { resolveOAuthDir } from "./config/paths.js";
+import { logVerbose, shouldLogVerbose } from "./globals.js";
+export async function ensureDir(dir) {
+    await fs.promises.mkdir(dir, { recursive: true });
+}
+export function clampNumber(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+export function clampInt(value, min, max) {
+    return clampNumber(Math.floor(value), min, max);
+}
+export function assertWebChannel(input) {
+    if (input !== "web") {
+        throw new Error("Web channel must be 'web'");
+    }
+}
+export function normalizePath(p) {
+    if (!p.startsWith("/"))
+        return `/${p}`;
+    return p;
+}
+export function withWhatsAppPrefix(number) {
+    return number.startsWith("whatsapp:") ? number : `whatsapp:${number}`;
+}
+export function normalizeE164(number) {
+    const withoutPrefix = number.replace(/^whatsapp:/, "").trim();
+    const digits = withoutPrefix.replace(/[^\d+]/g, "");
+    if (digits.startsWith("+"))
+        return `+${digits.slice(1)}`;
+    return `+${digits}`;
+}
+/**
+ * "Self-chat mode" heuristic (single phone): the gateway is logged in as the owner's own WhatsApp account,
+ * and `channels.whatsapp.allowFrom` includes that same number. Used to avoid side-effects that make no sense when the
+ * "bot" and the human are the same WhatsApp identity (e.g. auto read receipts, @mention JID triggers).
+ */
+export function isSelfChatMode(selfE164, allowFrom) {
+    if (!selfE164)
+        return false;
+    if (!Array.isArray(allowFrom) || allowFrom.length === 0)
+        return false;
+    const normalizedSelf = normalizeE164(selfE164);
+    return allowFrom.some((n) => {
+        if (n === "*")
+            return false;
+        try {
+            return normalizeE164(String(n)) === normalizedSelf;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+export function toWhatsappJid(number) {
+    const withoutPrefix = number.replace(/^whatsapp:/, "").trim();
+    if (withoutPrefix.includes("@"))
+        return withoutPrefix;
+    const e164 = normalizeE164(withoutPrefix);
+    const digits = e164.replace(/\D/g, "");
+    return `${digits}@s.whatsapp.net`;
+}
+function resolveLidMappingDirs(opts) {
+    const dirs = new Set();
+    const addDir = (dir) => {
+        if (!dir)
+            return;
+        dirs.add(resolveUserPath(dir));
+    };
+    addDir(opts?.authDir);
+    for (const dir of opts?.lidMappingDirs ?? [])
+        addDir(dir);
+    addDir(resolveOAuthDir());
+    addDir(path.join(CONFIG_DIR, "credentials"));
+    return [...dirs];
+}
+function readLidReverseMapping(lid, opts) {
+    const mappingFilename = `lid-mapping-${lid}_reverse.json`;
+    const mappingDirs = resolveLidMappingDirs(opts);
+    for (const dir of mappingDirs) {
+        const mappingPath = path.join(dir, mappingFilename);
+        try {
+            const data = fs.readFileSync(mappingPath, "utf8");
+            const phone = JSON.parse(data);
+            if (phone === null || phone === undefined)
+                continue;
+            return normalizeE164(String(phone));
+        }
+        catch {
+            // Try the next location.
+        }
+    }
+    return null;
+}
+export function jidToE164(jid, opts) {
+    // Convert a WhatsApp JID (with optional device suffix, e.g. 1234:1@s.whatsapp.net) back to +1234.
+    const match = jid.match(/^(\d+)(?::\d+)?@(s\.whatsapp\.net|hosted)$/);
+    if (match) {
+        const digits = match[1];
+        return `+${digits}`;
+    }
+    // Support @lid format (WhatsApp Linked ID) - look up reverse mapping
+    const lidMatch = jid.match(/^(\d+)(?::\d+)?@(lid|hosted\.lid)$/);
+    if (lidMatch) {
+        const lid = lidMatch[1];
+        const phone = readLidReverseMapping(lid, opts);
+        if (phone)
+            return phone;
+        const shouldLog = opts?.logMissing ?? shouldLogVerbose();
+        if (shouldLog) {
+            logVerbose(`LID mapping not found for ${lid}; skipping inbound message`);
+        }
+    }
+    return null;
+}
+export async function resolveJidToE164(jid, opts) {
+    if (!jid)
+        return null;
+    const direct = jidToE164(jid, opts);
+    if (direct)
+        return direct;
+    if (!/(@lid|@hosted\.lid)$/.test(jid))
+        return null;
+    if (!opts?.lidLookup?.getPNForLID)
+        return null;
+    try {
+        const pnJid = await opts.lidLookup.getPNForLID(jid);
+        if (!pnJid)
+            return null;
+        return jidToE164(pnJid, opts);
+    }
+    catch (err) {
+        if (shouldLogVerbose()) {
+            logVerbose(`LID mapping lookup failed for ${jid}: ${String(err)}`);
+        }
+        return null;
+    }
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isHighSurrogate(codeUnit) {
+    return codeUnit >= 0xd800 && codeUnit <= 0xdbff;
+}
+function isLowSurrogate(codeUnit) {
+    return codeUnit >= 0xdc00 && codeUnit <= 0xdfff;
+}
+export function sliceUtf16Safe(input, start, end) {
+    const len = input.length;
+    let from = start < 0 ? Math.max(len + start, 0) : Math.min(start, len);
+    let to = end === undefined ? len : end < 0 ? Math.max(len + end, 0) : Math.min(end, len);
+    if (to < from) {
+        const tmp = from;
+        from = to;
+        to = tmp;
+    }
+    if (from > 0 && from < len) {
+        const codeUnit = input.charCodeAt(from);
+        if (isLowSurrogate(codeUnit) && isHighSurrogate(input.charCodeAt(from - 1))) {
+            from += 1;
+        }
+    }
+    if (to > 0 && to < len) {
+        const codeUnit = input.charCodeAt(to - 1);
+        if (isHighSurrogate(codeUnit) && isLowSurrogate(input.charCodeAt(to))) {
+            to -= 1;
+        }
+    }
+    return input.slice(from, to);
+}
+export function truncateUtf16Safe(input, maxLen) {
+    const limit = Math.max(0, Math.floor(maxLen));
+    if (input.length <= limit)
+        return input;
+    return sliceUtf16Safe(input, 0, limit);
+}
+export function resolveUserPath(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return trimmed;
+    if (trimmed.startsWith("~")) {
+        const expanded = trimmed.replace(/^~(?=$|[\\/])/, os.homedir());
+        return path.resolve(expanded);
+    }
+    return path.resolve(trimmed);
+}
+export function resolveConfigDir(env = process.env, homedir = os.homedir) {
+    const override = env.OPENCLAW_STATE_DIR?.trim() || env.CLAWDBOT_STATE_DIR?.trim();
+    if (override)
+        return resolveUserPath(override);
+    const newDir = path.join(homedir(), ".openclaw");
+    try {
+        const hasNew = fs.existsSync(newDir);
+        if (hasNew)
+            return newDir;
+    }
+    catch {
+        // best-effort
+    }
+    return newDir;
+}
+export function resolveHomeDir() {
+    const envHome = process.env.HOME?.trim();
+    if (envHome)
+        return envHome;
+    const envProfile = process.env.USERPROFILE?.trim();
+    if (envProfile)
+        return envProfile;
+    try {
+        const home = os.homedir();
+        return home?.trim() ? home : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function shortenHomePath(input) {
+    if (!input)
+        return input;
+    const home = resolveHomeDir();
+    if (!home)
+        return input;
+    if (input === home)
+        return "~";
+    if (input.startsWith(`${home}/`))
+        return `~${input.slice(home.length)}`;
+    return input;
+}
+export function shortenHomeInString(input) {
+    if (!input)
+        return input;
+    const home = resolveHomeDir();
+    if (!home)
+        return input;
+    return input.split(home).join("~");
+}
+export function displayPath(input) {
+    return shortenHomePath(input);
+}
+export function displayString(input) {
+    return shortenHomeInString(input);
+}
+export function formatTerminalLink(label, url, opts) {
+    const esc = "\u001b";
+    const safeLabel = label.replaceAll(esc, "");
+    const safeUrl = url.replaceAll(esc, "");
+    const allow = opts?.force === true ? true : opts?.force === false ? false : Boolean(process.stdout.isTTY);
+    if (!allow) {
+        return opts?.fallback ?? `${safeLabel} (${safeUrl})`;
+    }
+    return `\u001b]8;;${safeUrl}\u0007${safeLabel}\u001b]8;;\u0007`;
+}
+// Configuration root; can be overridden via OPENCLAW_STATE_DIR.
+export const CONFIG_DIR = resolveConfigDir();
+//# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map

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

package/dist/web-server.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CoStar Server Executor - Web Dashboard Server
+ * Serves the web UI and all API endpoints for managing the agent, cron, skills, etc.
+ * Pattern follows OpenClaw's gateway server but simplified for our architecture.
+ */
+import express from "express";
+import type { Agent } from "./agent/agent.js";
+import type { CronScheduler } from "./cron/scheduler.js";
+import type { HeartbeatRunner } from "./heartbeat/runner.js";
+import type { SkillsManager } from "./skills/manager.js";
+export type WebServerDeps = {
+    agent: Agent;
+    cronScheduler: CronScheduler | null;
+    heartbeatRunner: HeartbeatRunner | null;
+    skillsManager: SkillsManager | null;
+    workspaceDir: string;
+    userId: string;
+};
+/**
+ * Create and configure the Express app with all routes
+ */
+export declare function createWebServer(deps: WebServerDeps): express.Application;
+/**
+ * Start the web dashboard server
+ */
+export declare function startWebServer(deps: WebServerDeps, port?: number): {
+    app: express.Application;
+    server: ReturnType<express.Application["listen"]>;
+};
+//# sourceMappingURL=web-server.d.ts.map

package/dist/web-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-server.d.ts","sourceRoot":"","sources":["../src/web-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAwXxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,MAAa,GAClB;IAAE,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAA;CAAE,CASjF"}