@nebulaos/client 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -595,9 +595,6 @@ declare class DBMemory implements IMemory {
 declare class PromptCapture {
 }
 
-declare class RAGClient {
-}
-
 declare class ClientError extends Error {
     readonly code: string;
     readonly statusCode: number;
@@ -626,4 +623,4 @@ declare class InstrumentedHttpClient implements IHttpClient {
     post<T = unknown>(url: string, body?: unknown, options?: Omit<HttpRequestOptions, "method" | "body">): Promise<HttpResponse<T>>;
 }
 
-export { type AgentFactory, type AgentOrFactory, AuthenticationError, Batcher, type ClientConfig, ClientError, ConnectionError, DBMemory, HttpDomainEventsExporter, type HttpDomainEventsExporterConfig, type HttpRequestOptions, HttpTelemetryExporter, type HttpTelemetryExporterConfig, InstrumentedHttpClient, NebulaClient, NotFoundError, type OTelTracingClientConfig, type OTelTracingConfig, OTelTracingProvider, PromptCapture, RAGClient, RegistryError, type ServerConfig, SocketTelemetryExporter, type SocketTelemetryExporterConfig, TelemetryService, clientConfigSchema, otelTracingConfigSchema, serverConfigSchema, setupOTelTracing };
+export { type AgentFactory, type AgentOrFactory, AuthenticationError, Batcher, type ClientConfig, ClientError, ConnectionError, DBMemory, HttpDomainEventsExporter, type HttpDomainEventsExporterConfig, type HttpRequestOptions, HttpTelemetryExporter, type HttpTelemetryExporterConfig, InstrumentedHttpClient, NebulaClient, NotFoundError, type OTelTracingClientConfig, type OTelTracingConfig, OTelTracingProvider, PromptCapture, RegistryError, type ServerConfig, SocketTelemetryExporter, type SocketTelemetryExporterConfig, TelemetryService, clientConfigSchema, otelTracingConfigSchema, serverConfigSchema, setupOTelTracing };

package/dist/index.d.ts

@@ -595,9 +595,6 @@ declare class DBMemory implements IMemory {
 declare class PromptCapture {
 }
 
-declare class RAGClient {
-}
-
 declare class ClientError extends Error {
     readonly code: string;
     readonly statusCode: number;
@@ -626,4 +623,4 @@ declare class InstrumentedHttpClient implements IHttpClient {
     post<T = unknown>(url: string, body?: unknown, options?: Omit<HttpRequestOptions, "method" | "body">): Promise<HttpResponse<T>>;
 }
 
-export { type AgentFactory, type AgentOrFactory, AuthenticationError, Batcher, type ClientConfig, ClientError, ConnectionError, DBMemory, HttpDomainEventsExporter, type HttpDomainEventsExporterConfig, type HttpRequestOptions, HttpTelemetryExporter, type HttpTelemetryExporterConfig, InstrumentedHttpClient, NebulaClient, NotFoundError, type OTelTracingClientConfig, type OTelTracingConfig, OTelTracingProvider, PromptCapture, RAGClient, RegistryError, type ServerConfig, SocketTelemetryExporter, type SocketTelemetryExporterConfig, TelemetryService, clientConfigSchema, otelTracingConfigSchema, serverConfigSchema, setupOTelTracing };
+export { type AgentFactory, type AgentOrFactory, AuthenticationError, Batcher, type ClientConfig, ClientError, ConnectionError, DBMemory, HttpDomainEventsExporter, type HttpDomainEventsExporterConfig, type HttpRequestOptions, HttpTelemetryExporter, type HttpTelemetryExporterConfig, InstrumentedHttpClient, NebulaClient, NotFoundError, type OTelTracingClientConfig, type OTelTracingConfig, OTelTracingProvider, PromptCapture, RegistryError, type ServerConfig, SocketTelemetryExporter, type SocketTelemetryExporterConfig, TelemetryService, clientConfigSchema, otelTracingConfigSchema, serverConfigSchema, setupOTelTracing };

package/dist/index.js

@@ -5,6 +5,9 @@ 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 });
@@ -27,6 +30,172 @@ 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, {
@@ -42,7 +211,6 @@ __export(index_exports, {
   NotFoundError: () => NotFoundError,
   OTelTracingProvider: () => OTelTracingProvider,
   PromptCapture: () => PromptCapture,
-  RAGClient: () => RAGClient,
   RegistryError: () => RegistryError,
   SocketTelemetryExporter: () => SocketTelemetryExporter,
   TelemetryService: () => TelemetryService,
@@ -1693,7 +1861,7 @@ var NebulaClient = class {
    */
   setGlobalClientContext(apiKey, serverUrl) {
     try {
-      import("@nebulaos/rag-openai-skill").then((module2) => {
+      Promise.resolve().then(() => __toESM(require_dist())).then((module2) => {
         if (module2.ClientContext) {
           module2.ClientContext.setApiKey(apiKey);
           module2.ClientContext.setServerUrl(serverUrl);
@@ -1789,10 +1957,6 @@ var DBMemory = class {
 // src/prompts/prompt-capture.ts
 var PromptCapture = class {
 };
-
-// src/rag/rag-client.ts
-var RAGClient = class {
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
@@ -1807,7 +1971,6 @@ var RAGClient = class {
   NotFoundError,
   OTelTracingProvider,
   PromptCapture,
-  RAGClient,
   RegistryError,
   SocketTelemetryExporter,
   TelemetryService,