@nebulaos/client 0.1.2 → 0.1.3

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present, iamkun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -186,34 +186,6 @@ declare const clientConfigSchema: z.ZodObject<{
 }>;
 type ClientConfig = z.infer<typeof clientConfigSchema>;
 
-declare class NebulaClient {
-    private readonly config;
-    private readonly registry;
-    private readonly serverConnection?;
-    private readonly telemetryExporter?;
-    private readonly domainEventsExporter?;
-    private readonly logger?;
-    constructor(config: ClientConfig);
-    registerAgent(agent: Parameters<Registry["registerAgent"]>[0]): void;
-    registerTool(tool: Parameters<Registry["registerTool"]>[0]): void;
-    registerWorkflow(workflow: Parameters<Registry["registerWorkflow"]>[0]): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getClientId(): string | undefined;
-    isConnected(): boolean;
-    /**
-     * Sets global client context for skills to access API key and server URL
-     * This allows skills like RagOpenAISkill to automatically use the client's credentials
-     */
-    private setGlobalClientContext;
-}
-
-declare class TelemetryService {
-}
-
-declare class Batcher {
-}
-
 /**
  * WebSocket Event Types for NebulaOS Client-Server Communication
  */
@@ -328,6 +300,61 @@ interface ClientToServerEvents {
     "command:response": (response: CommandResponse) => void;
     "command:error": (error: CommandError) => void;
     "telemetry:batch": (payload: unknown) => void;
+    "memory:addMessage": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        message: unknown;
+        maxMessages?: number;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:getMessages": (payload: {
+        featureKey: string;
+        memoryKey: string;
+    }, callback: (response: {
+        success: boolean;
+        messages?: unknown[];
+        error?: string;
+    }) => void) => void;
+    "memory:clear": (payload: {
+        featureKey: string;
+        memoryKey: string;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:setState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+        value: unknown;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:getState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+    }, callback: (response: {
+        success: boolean;
+        value?: unknown;
+        error?: string;
+    }) => void) => void;
+    "memory:deleteState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "telemetry:client_metric": (payload: {
+        metric: string;
+        value: number;
+        attributes?: Record<string, string>;
+    }) => void;
 }
 /**
  * WebSocket server-to-client events
@@ -339,6 +366,30 @@ interface ServerToClientEvents {
     "command:execute:tool": (payload: ToolCommandPayload) => void;
 }
 
+declare class NebulaClient {
+    private readonly config;
+    private readonly registry;
+    private readonly serverConnection?;
+    private readonly telemetryExporter?;
+    private readonly domainEventsExporter?;
+    private readonly logger?;
+    constructor(config: ClientConfig);
+    registerAgent(agent: Parameters<Registry["registerAgent"]>[0]): void;
+    registerTool(tool: Parameters<Registry["registerTool"]>[0]): void;
+    registerWorkflow(workflow: Parameters<Registry["registerWorkflow"]>[0]): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getClientId(): string | undefined;
+    isConnected(): boolean;
+    getSocket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined;
+}
+
+declare class TelemetryService {
+}
+
+declare class Batcher {
+}
+
 interface ServerConnectionConfig {
     url: string;
     apiKey: string;

package/dist/index.d.ts

@@ -186,34 +186,6 @@ declare const clientConfigSchema: z.ZodObject<{
 }>;
 type ClientConfig = z.infer<typeof clientConfigSchema>;
 
-declare class NebulaClient {
-    private readonly config;
-    private readonly registry;
-    private readonly serverConnection?;
-    private readonly telemetryExporter?;
-    private readonly domainEventsExporter?;
-    private readonly logger?;
-    constructor(config: ClientConfig);
-    registerAgent(agent: Parameters<Registry["registerAgent"]>[0]): void;
-    registerTool(tool: Parameters<Registry["registerTool"]>[0]): void;
-    registerWorkflow(workflow: Parameters<Registry["registerWorkflow"]>[0]): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getClientId(): string | undefined;
-    isConnected(): boolean;
-    /**
-     * Sets global client context for skills to access API key and server URL
-     * This allows skills like RagOpenAISkill to automatically use the client's credentials
-     */
-    private setGlobalClientContext;
-}
-
-declare class TelemetryService {
-}
-
-declare class Batcher {
-}
-
 /**
  * WebSocket Event Types for NebulaOS Client-Server Communication
  */
@@ -328,6 +300,61 @@ interface ClientToServerEvents {
     "command:response": (response: CommandResponse) => void;
     "command:error": (error: CommandError) => void;
     "telemetry:batch": (payload: unknown) => void;
+    "memory:addMessage": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        message: unknown;
+        maxMessages?: number;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:getMessages": (payload: {
+        featureKey: string;
+        memoryKey: string;
+    }, callback: (response: {
+        success: boolean;
+        messages?: unknown[];
+        error?: string;
+    }) => void) => void;
+    "memory:clear": (payload: {
+        featureKey: string;
+        memoryKey: string;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:setState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+        value: unknown;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "memory:getState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+    }, callback: (response: {
+        success: boolean;
+        value?: unknown;
+        error?: string;
+    }) => void) => void;
+    "memory:deleteState": (payload: {
+        featureKey: string;
+        memoryKey: string;
+        key: string;
+    }, callback: (response: {
+        success: boolean;
+        error?: string;
+    }) => void) => void;
+    "telemetry:client_metric": (payload: {
+        metric: string;
+        value: number;
+        attributes?: Record<string, string>;
+    }) => void;
 }
 /**
  * WebSocket server-to-client events
@@ -339,6 +366,30 @@ interface ServerToClientEvents {
     "command:execute:tool": (payload: ToolCommandPayload) => void;
 }
 
+declare class NebulaClient {
+    private readonly config;
+    private readonly registry;
+    private readonly serverConnection?;
+    private readonly telemetryExporter?;
+    private readonly domainEventsExporter?;
+    private readonly logger?;
+    constructor(config: ClientConfig);
+    registerAgent(agent: Parameters<Registry["registerAgent"]>[0]): void;
+    registerTool(tool: Parameters<Registry["registerTool"]>[0]): void;
+    registerWorkflow(workflow: Parameters<Registry["registerWorkflow"]>[0]): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getClientId(): string | undefined;
+    isConnected(): boolean;
+    getSocket(): Socket<ServerToClientEvents, ClientToServerEvents> | undefined;
+}
+
+declare class TelemetryService {
+}
+
+declare class Batcher {
+}
+
 interface ServerConnectionConfig {
     url: string;
     apiKey: string;

package/dist/index.js

@@ -5,9 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -30,172 +27,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../rag-openai-skill/dist/ClientContext.js
-var require_ClientContext = __commonJS({
-  "../rag-openai-skill/dist/ClientContext.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.ClientContext = void 0;
-    var ClientContextManager = class {
-      apiKey;
-      serverUrl;
-      setApiKey(apiKey) {
-        this.apiKey = apiKey;
-      }
-      setServerUrl(url) {
-        this.serverUrl = url;
-      }
-      getApiKey() {
-        return this.apiKey;
-      }
-      getServerUrl() {
-        return this.serverUrl;
-      }
-      clear() {
-        this.apiKey = void 0;
-        this.serverUrl = void 0;
-      }
-    };
-    exports2.ClientContext = new ClientContextManager();
-  }
-});
-
-// ../rag-openai-skill/dist/RagOpenAISkill.js
-var require_RagOpenAISkill = __commonJS({
-  "../rag-openai-skill/dist/RagOpenAISkill.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.RagOpenAISkill = void 0;
-    var core_1 = require("@nebulaos/core");
-    var ClientContext_js_1 = require_ClientContext();
-    var RagOpenAISkill = class {
-      config;
-      constructor(config) {
-        const apiKey = config.apiKey || ClientContext_js_1.ClientContext.getApiKey();
-        const apiEndpoint = config.apiEndpoint || ClientContext_js_1.ClientContext.getServerUrl() || "https://api.nebulaos.com";
-        this.config = {
-          connectionId: config.connectionId,
-          apiKey: apiKey || "",
-          // Will be validated in initialize
-          apiEndpoint,
-          timeout: config.timeout || 3e4,
-          maxResults: config.maxResults,
-          minScore: config.minScore
-        };
-      }
-      /**
-       * Optional initialization - validates configuration
-       */
-      async initialize() {
-        if (!this.config.connectionId) {
-          throw new Error("RagOpenAISkill: connectionId is required");
-        }
-        if (!this.config.apiKey) {
-          const contextApiKey = ClientContext_js_1.ClientContext.getApiKey();
-          if (contextApiKey) {
-            this.config.apiKey = contextApiKey;
-          }
-        }
-        if (!this.config.apiKey) {
-          throw new Error("RagOpenAISkill: apiKey is required. Make sure your agent is registered with a NebulaClient that has server.apiKey configured.");
-        }
-      }
-      /**
-       * Returns the vector store search tool
-       */
-      getTools() {
-        const toolId = `search_vector_store_${this.config.connectionId.slice(-8)}`;
-        return [
-          new core_1.Tool({
-            id: toolId,
-            description: `Search through the knowledge base using semantic search. Returns relevant documents and information based on the query.`,
-            inputSchema: core_1.z.object({
-              query: core_1.z.string().describe("The search query or question to find relevant information"),
-              maxResults: core_1.z.number().optional().describe("Maximum number of results to return (overrides default)"),
-              minScore: core_1.z.number().min(0).max(1).optional().describe("Minimum relevance score threshold (0-1, overrides default)")
-            }),
-            handler: async (ctx, input) => {
-              return this.searchVectorStore(input.query, {
-                maxResults: input.maxResults,
-                minScore: input.minScore
-              });
-            }
-          })
-        ];
-      }
-      /**
-       * Optional instructions for the agent on how to use the RAG tool
-       */
-      getInstructions() {
-        return `You have access to a knowledge base search tool. Use it whenever you need to:
-- Find specific information or documentation
-- Answer questions that require domain knowledge
-- Retrieve relevant context before responding
-
-The search results include relevance scores. Prioritize higher-scoring results when formulating your response.`;
-      }
-      /**
-       * Search the vector store via NebulaOS Cloud API
-       */
-      async searchVectorStore(query, options = {}) {
-        const url = `${this.config.apiEndpoint}/rag-openai/search`;
-        const requestBody = {
-          connectionId: this.config.connectionId,
-          query,
-          maxResults: options.maxResults ?? this.config.maxResults,
-          minScore: options.minScore ?? this.config.minScore
-        };
-        try {
-          const controller = new AbortController();
-          const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-          const response = await fetch(url, {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json",
-              Authorization: `Bearer ${this.config.apiKey}`
-            },
-            body: JSON.stringify(requestBody),
-            signal: controller.signal
-          });
-          clearTimeout(timeoutId);
-          if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`RAG search failed: ${response.status} ${response.statusText}. ${errorText}`);
-          }
-          const data = await response.json();
-          return data;
-        } catch (error) {
-          if (error instanceof Error) {
-            if (error.name === "AbortError") {
-              throw new Error(`RAG search timeout after ${this.config.timeout}ms`);
-            }
-            throw new Error(`RAG search error: ${error.message}`);
-          }
-          throw error;
-        }
-      }
-    };
-    exports2.RagOpenAISkill = RagOpenAISkill;
-  }
-});
-
-// ../rag-openai-skill/dist/index.js
-var require_dist = __commonJS({
-  "../rag-openai-skill/dist/index.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.ClientContext = exports2.RagOpenAISkill = void 0;
-    var RagOpenAISkill_js_1 = require_RagOpenAISkill();
-    Object.defineProperty(exports2, "RagOpenAISkill", { enumerable: true, get: function() {
-      return RagOpenAISkill_js_1.RagOpenAISkill;
-    } });
-    var ClientContext_js_1 = require_ClientContext();
-    Object.defineProperty(exports2, "ClientContext", { enumerable: true, get: function() {
-      return ClientContext_js_1.ClientContext;
-    } });
-  }
-});
-
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
@@ -1753,9 +1584,6 @@ var NebulaClient = class {
     if (!config.clientId) {
       config.clientId = `client-${(0, import_uuid2.v4)()}`;
     }
-    if (config.server) {
-      this.setGlobalClientContext(config.server.apiKey, config.server.url);
-    }
     this.registry = new Registry();
     this.registry.setHttpClient(new InstrumentedHttpClient());
     config.agents?.forEach((agent) => this.registry.registerAgent(agent));
@@ -1844,6 +1672,11 @@ var NebulaClient = class {
         }
         throw new Error(`Failed to connect to NebulaOS Cloud: ${String(error)}`);
       }
+      for (const agent of this.registry.listAgents()) {
+        if (typeof agent.setClient === "function") {
+          agent.setClient(this);
+        }
+      }
     }
   }
   async stop() {
@@ -1855,21 +1688,8 @@ var NebulaClient = class {
   isConnected() {
     return this.serverConnection?.isConnected() ?? false;
   }
-  /**
-   * Sets global client context for skills to access API key and server URL
-   * This allows skills like RagOpenAISkill to automatically use the client's credentials
-   */
-  setGlobalClientContext(apiKey, serverUrl) {
-    try {
-      Promise.resolve().then(() => __toESM(require_dist())).then((module2) => {
-        if (module2.ClientContext) {
-          module2.ClientContext.setApiKey(apiKey);
-          module2.ClientContext.setServerUrl(serverUrl);
-        }
-      }).catch(() => {
-      });
-    } catch {
-    }
+  getSocket() {
+    return this.serverConnection?.getSocket();
   }
 };