@nebulaos/client 0.1.0 → 0.1.1

package/dist/index.mjs

@@ -1,3 +1,201 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// ../rag-openai-skill/dist/ClientContext.js
+var require_ClientContext = __commonJS({
+  "../rag-openai-skill/dist/ClientContext.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.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;
+      }
+    };
+    exports.ClientContext = new ClientContextManager();
+  }
+});
+
+// ../rag-openai-skill/dist/RagOpenAISkill.js
+var require_RagOpenAISkill = __commonJS({
+  "../rag-openai-skill/dist/RagOpenAISkill.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.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;
+        }
+      }
+    };
+    exports.RagOpenAISkill = RagOpenAISkill;
+  }
+});
+
+// ../rag-openai-skill/dist/index.js
+var require_dist = __commonJS({
+  "../rag-openai-skill/dist/index.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.ClientContext = exports.RagOpenAISkill = void 0;
+    var RagOpenAISkill_js_1 = require_RagOpenAISkill();
+    Object.defineProperty(exports, "RagOpenAISkill", { enumerable: true, get: function() {
+      return RagOpenAISkill_js_1.RagOpenAISkill;
+    } });
+    var ClientContext_js_1 = require_ClientContext();
+    Object.defineProperty(exports, "ClientContext", { enumerable: true, get: function() {
+      return ClientContext_js_1.ClientContext;
+    } });
+  }
+});
+
 // src/config/client-config.ts
 import { z } from "zod";
 var serverConfigSchema = z.object({
@@ -1640,7 +1838,7 @@ var NebulaClient = class {
    */
   setGlobalClientContext(apiKey, serverUrl) {
     try {
-      import("@nebulaos/rag-openai-skill").then((module) => {
+      Promise.resolve().then(() => __toESM(require_dist())).then((module) => {
         if (module.ClientContext) {
           module.ClientContext.setApiKey(apiKey);
           module.ClientContext.setServerUrl(serverUrl);
@@ -1736,10 +1934,6 @@ var DBMemory = class {
 // src/prompts/prompt-capture.ts
 var PromptCapture = class {
 };
-
-// src/rag/rag-client.ts
-var RAGClient = class {
-};
 export {
   AuthenticationError,
   Batcher,
@@ -1753,7 +1947,6 @@ export {
   NotFoundError,
   OTelTracingProvider,
   PromptCapture,
-  RAGClient,
   RegistryError,
   SocketTelemetryExporter,
   TelemetryService,