skyloom 1.4.0

package/dist/core/logger.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Structured logging for Skyloom.
+ *
+ * Usage:
+ *   const log = getLogger("fog");
+ *   log.info("chat_request", { userMessage: "hello", agent: "fog" });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevel = void 0;
+exports.getLogger = getLogger;
+exports.setRequestId = setRequestId;
+exports.getRequestId = getRequestId;
+exports.setDefaultLogLevel = setDefaultLogLevel;
+exports.getDefaultLogLevel = getDefaultLogLevel;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * Logger instance for structured logging
+ */
+class Logger {
+    constructor(name, minLevel = LogLevel.INFO) {
+        this.name = name;
+        this.minLevel = minLevel;
+    }
+    formatEntry(levelName, msg, extra) {
+        const entry = {
+            ts: new Date().toISOString(),
+            level: levelName.toLowerCase(),
+            logger: this.name,
+            msg,
+            ...extra,
+        };
+        return entry;
+    }
+    output(level, levelName, msg, extra) {
+        if (level < this.minLevel)
+            return;
+        const entry = this.formatEntry(levelName, msg, extra);
+        const line = JSON.stringify(entry, (_key, value) => {
+            // Ensure dates are serializable
+            if (value instanceof Date) {
+                return value.toISOString();
+            }
+            if (value instanceof Error) {
+                return {
+                    name: value.name,
+                    message: value.message,
+                    stack: value.stack,
+                };
+            }
+            return value;
+        });
+        // Output to stderr for logs, stdout for normal output
+        const output = level >= LogLevel.WARN ? console.error : console.log;
+        output(line);
+    }
+    debug(msg, extra) {
+        this.output(LogLevel.DEBUG, "DEBUG", msg, extra);
+    }
+    info(msg, extra) {
+        this.output(LogLevel.INFO, "INFO", msg, extra);
+    }
+    warn(msg, extra) {
+        this.output(LogLevel.WARN, "WARN", msg, extra);
+    }
+    error(msg, extra) {
+        this.output(LogLevel.ERROR, "ERROR", msg, extra);
+    }
+    setLevel(level) {
+        this.minLevel = level;
+    }
+}
+exports.Logger = Logger;
+/**
+ * Global logger instances
+ */
+const loggers = new Map();
+let requestId = null;
+let defaultLogLevel = LogLevel.INFO;
+/**
+ * Get or create a logger for a component
+ */
+function getLogger(name) {
+    if (!loggers.has(name)) {
+        loggers.set(name, new Logger(name, defaultLogLevel));
+    }
+    return loggers.get(name);
+}
+/**
+ * Set the global request ID for tracing
+ */
+function setRequestId(id) {
+    requestId = id;
+}
+/**
+ * Get the current request ID
+ */
+function getRequestId() {
+    return requestId;
+}
+/**
+ * Set the global default log level
+ */
+function setDefaultLogLevel(level) {
+    defaultLogLevel = level;
+    loggers.forEach((logger) => {
+        logger.setLevel(level);
+    });
+}
+/**
+ * Get the current default log level
+ */
+function getDefaultLogLevel() {
+    return defaultLogLevel;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAqGH,8BAKC;AAKD,oCAEC;AAKD,oCAEC;AAKD,gDAKC;AAKD,gDAEC;AAvID,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAWD;;GAEG;AACH,MAAa,MAAM;IAIjB,YAAY,IAAY,EAAE,WAAqB,QAAQ,CAAC,IAAI;QAC1D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,WAAW,CACjB,SAAiB,EACjB,GAAW,EACX,KAA+B;QAE/B,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,GAAG;YACH,GAAG,KAAK;SACT,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,SAAiB,EAAE,GAAW,EAAE,KAA+B;QAC7F,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ;YAAE,OAAO;QAElC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACjD,gCAAgC;YAChC,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;YAC7B,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,OAAO;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC;YACJ,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,sDAAsD;QACtD,MAAM,MAAM,GAAG,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,KAA+B;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,KAA+B;QAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,KAA+B;QAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,KAA+B;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;CACF;AApED,wBAoEC;AAED;;GAEG;AACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1C,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,IAAI,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEpC;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,EAAiB;IAC5C,SAAS,GAAG,EAAE,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAe;IAChD,eAAe,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/core/mcp.d.ts

@@ -0,0 +1,190 @@
+/**
+ * MCP (Model Context Protocol) client — Anthropic-compatible transport.
+ *
+ * Implements the MCP 2025-03-26 specification with two transports:
+ * - stdio: subprocess-based with JSON-RPC over stdin/stdout
+ * - SSE: text/event-stream via HTTP/fetch with jsonrpc POST endpoint
+ */
+import type { Logger } from "./logger";
+/**
+ * MCP server configuration.
+ */
+export interface MCPServerConfig {
+    name: string;
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    enabled?: boolean;
+}
+/**
+ * MCP tool definition from server.
+ */
+export interface MCPToolDef {
+    name: string;
+    description?: string;
+    inputSchema?: {
+        type?: string;
+        properties?: Record<string, any>;
+        required?: string[];
+    };
+}
+/**
+ * Client for connecting to a single MCP server.
+ *
+ * Supports both stdio (subprocess) and SSE (text/event-stream) transports.
+ * Uses JSON-RPC 2.0 with id-based correlation for concurrent requests.
+ */
+export declare class MCPClient {
+    private config;
+    private process;
+    private serverTools;
+    private nextId;
+    private pending;
+    private log;
+    private sseResponse;
+    private sseMessageUrl;
+    constructor(config: MCPServerConfig, log?: Logger | null);
+    /**
+     * Generate next request ID.
+     */
+    private newId;
+    /**
+     * Connect to the MCP server and list available tools.
+     */
+    initialize(): Promise<MCPToolDef[]>;
+    /**
+     * Perform a health check on the MCP connection.
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details: string;
+    }>;
+    /**
+     * Initialize stdio transport.
+     */
+    private initStdio;
+    /**
+     * Initialize SSE transport.
+     */
+    private initSSE;
+    /**
+     * Health check via stdio.
+     */
+    private healthStdio;
+    /**
+     * Health check via SSE.
+     */
+    private healthSSE;
+    /**
+     * Background task: read from subprocess stdout.
+     */
+    private readStdioLoop;
+    /**
+     * Background task: drain stderr to prevent blocking.
+     */
+    private drainStderr;
+    /**
+     * Send JSON-RPC request via stdio and wait for response.
+     */
+    private requestStdio;
+    /**
+     * Send JSON-RPC request via SSE and wait for response.
+     */
+    private requestSSE;
+    /**
+     * Send JSON data via stdin.
+     */
+    private sendJson;
+    /**
+     * POST JSON data via HTTP (SSE).
+     */
+    private postJson;
+    /**
+     * Parse a single JSON line.
+     */
+    private parseJsonLine;
+    /**
+     * Call a tool on the MCP server.
+     */
+    callTool(name: string, args: Record<string, any>): Promise<string>;
+    /**
+     * Extract text content from MCP tool result.
+     */
+    private extractToolResult;
+    /**
+     * Get list of tool definitions from server.
+     */
+    getToolDefinitions(): MCPToolDef[];
+    /**
+     * Close the connection and clean up resources.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Manages multiple MCP server connections and registers their tools.
+ */
+export declare class MCPManager {
+    private toolRegistry;
+    private clients;
+    private serverConfigs;
+    private agents;
+    private log;
+    constructor(toolRegistry: any, log?: Logger);
+    /**
+     * Bind live agent instances for tool refresh.
+     */
+    bindAgents(agents: Map<string, any>): void;
+    /**
+     * Configure MCP servers from config data.
+     */
+    configure(servers: MCPServerConfig[]): void;
+    /**
+     * Connect to all configured MCP servers in parallel.
+     * Returns list of "server_name: N tools" status strings.
+     */
+    connectAll(): Promise<string[]>;
+    /**
+     * Register MCP tools into the tool registry and agents.
+     */
+    private registerMCPTools;
+    /**
+     * Create a handler function that calls an MCP tool.
+     */
+    private makeMCPHandler;
+    /**
+     * Add a new MCP server at runtime.
+     */
+    addServer(config: MCPServerConfig): Promise<string>;
+    /**
+     * Remove an MCP server and unregister its tools.
+     */
+    removeServer(name: string): Promise<string>;
+    /**
+     * Get list of connected servers and their tool counts.
+     */
+    listServers(): Array<{
+        name: string;
+        transport: string;
+        target: string;
+        tools: number;
+        connected: boolean;
+    }>;
+    /**
+     * Close all server connections and clean up.
+     */
+    closeAll(): Promise<void>;
+}
+/**
+ * Load persisted MCP server configs.
+ */
+export declare function loadPersistedServers(): MCPServerConfig[];
+/**
+ * Save MCP server config (add or update).
+ */
+export declare function savePersistedServer(config: MCPServerConfig): void;
+/**
+ * Remove persisted MCP server config.
+ */
+export declare function removePersistedServer(name: string): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/core/mcp.d.ts.map

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