@red-hat-developer-hub/backstage-plugin-intelligent-assistant-backend 4.0.0 → 4.2.0

package/config.d.ts

@@ -1,142 +0,0 @@
-/*
- * Copyright Red Hat, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-export interface Config {
-  /**
-   * Configuration required for using intelligent-assistant
-   * @visibility frontend
-   */
-  'intelligent-assistant'?: {
-    /**
-     * configure the port number for the lightspeed service.
-     * @visibility backend
-     */
-    servicePort?: number;
-    /**
-     * customize system prompt for the lightspeed service.
-     * @visibility backend
-     */
-    systemPrompt?: string;
-    /**
-     * configure the MCP server for the lightspeed service.
-     * @visibility backend
-     */
-    mcpServers?: Array<{
-      /**
-       * The name of the MCP server. Must match the name registered in LCS config.
-       * The URL is fetched from LCS (GET /v1/mcp-servers) at startup.
-       * @visibility backend
-       */
-      name: string;
-      /**
-       * The default access token for authenticating with this MCP server.
-       * Optional — if omitted, users must provide their own token via the UI.
-       * Users can also override this with a personal token via PATCH /mcp-servers/:name.
-       * @visibility secret
-       */
-      token?: string;
-      /**
-       * Authentication mode for this MCP server.
-       * Set to 'dcr' for Dynamic Client Registration (user-bound tokens minted per-request).
-       * When omitted, falls back to static-token mode.
-       * @visibility frontend
-       */
-      auth?: 'dcr';
-    }>;
-    /**
-     * Per-user rate limiting for Lightspeed API endpoints.
-     * @visibility backend
-     */
-    rateLimit?: {
-      /**
-       * Limits for expensive endpoints (LLM queries, document uploads).
-       * @visibility backend
-       */
-      expensive?: {
-        /**
-         * Maximum requests per minute per user.
-         * Set to 0 to disable rate limiting for this tier.
-         * @default 25
-         * @visibility backend
-         */
-        max?: number;
-      };
-      /**
-       * Limits for all other authenticated endpoints.
-       * @visibility backend
-       */
-      general?: {
-        /**
-         * Maximum requests per minute per user.
-         * Set to 0 to disable rate limiting for this tier.
-         * @default 200
-         * @visibility backend
-         */
-        max?: number;
-      };
-    };
-    /**
-     * Configuration for AI Notebooks (Developer Preview)
-     */
-    notebooks?: {
-      /**
-       * Enable/disable AI Notebooks feature
-       * When enabled, exposes AI Notebooks REST API endpoints for document-based conversations with RAG.
-       * Requires Lightspeed service to be running (host and port default to 127.0.0.1 and 8080).
-       * @default false
-       * @visibility frontend
-       */
-      enabled: boolean;
-      /**
-       * Lightspeed configuration
-       * @visibility backend
-       */
-      queryDefaults: {
-        /**
-         * Model to use for answering queries. Must map to a model available through the provider set in provider_id.
-         * @visibility backend
-         */
-        model: string;
-        /**
-         * AI provider for the query model. Must map to a provider enabled in your Lightspeed config.
-         * @visibility backend
-         */
-        provider_id: string;
-      };
-      /**
-       * Chunking strategy for document processing
-       * @visibility backend
-       */
-      chunkingStrategy?: {
-        /**
-         * Document chunking strategy - 'auto' (automatic, default) or 'static' (fixed size)
-         * @visibility backend
-         */
-        type?: 'auto' | 'static';
-        /**
-         * Maximum chunk size in tokens for static chunking (default: 512)
-         * @visibility backend
-         */
-        maxChunkSizeTokens?: number;
-        /**
-         * Token overlap between chunks for static chunking (default: 50)
-         * @visibility backend
-         */
-        chunkOverlapTokens?: number;
-      };
-    };
-  };
-}

package/dist/service/notebooks/documents/fileParser.cjs.js

@@ -1,139 +0,0 @@
-'use strict';
-
-var errors = require('@backstage/errors');
-var yaml = require('js-yaml');
-var pdfjsLib = require('pdfjs-dist');
-var stream = require('stream');
-var constant = require('../../constant.cjs.js');
-
-function _interopNamespaceCompat(e) {
-  if (e && typeof e === 'object' && 'default' in e) return e;
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
-  }
-  n.default = e;
-  return Object.freeze(n);
-}
-
-var yaml__namespace = /*#__PURE__*/_interopNamespaceCompat(yaml);
-var pdfjsLib__namespace = /*#__PURE__*/_interopNamespaceCompat(pdfjsLib);
-
-function parseTextFile(buffer, fileName, fileType) {
-  const content = buffer.toString("utf-8");
-  return {
-    content,
-    metadata: {
-      fileName,
-      fileType,
-      parseTimestamp: (/* @__PURE__ */ new Date()).toISOString()
-    }
-  };
-}
-function parseJSONFile(buffer, fileName, fileType) {
-  try {
-    const content = buffer.toString("utf-8");
-    JSON.parse(content);
-    return {
-      content,
-      metadata: {
-        fileName,
-        fileType,
-        parseTimestamp: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    };
-  } catch (error) {
-    throw new errors.InputError(`Invalid JSON file: ${error}`);
-  }
-}
-function parseYAMLFile(buffer, fileName, fileType) {
-  try {
-    const content = buffer.toString("utf-8");
-    yaml__namespace.load(content);
-    return {
-      content,
-      metadata: {
-        fileName,
-        fileType,
-        parseTimestamp: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    };
-  } catch (error) {
-    throw new errors.InputError(`Invalid YAML file: ${error}`);
-  }
-}
-async function parsePDFFile(buffer, fileName, fileType) {
-  try {
-    const loadingTask = pdfjsLib__namespace.getDocument({
-      data: new Uint8Array(buffer),
-      useSystemFonts: true
-    });
-    const pdf = await loadingTask.promise;
-    const textParts = [];
-    for (let pageNum = 1; pageNum <= pdf.numPages; pageNum++) {
-      const page = await pdf.getPage(pageNum);
-      const textContent = await page.getTextContent();
-      const pageText = textContent.items.map((item) => {
-        if ("str" in item) {
-          return item.str;
-        }
-        return "";
-      }).filter((str) => str.trim().length > 0).join(" ");
-      if (pageText.trim().length > 0) {
-        textParts.push(`--- Page ${pageNum} ---
-${pageText}`);
-      }
-    }
-    const content = textParts.join("\n\n");
-    return {
-      content,
-      metadata: {
-        fileName,
-        fileType,
-        pageCount: pdf.numPages,
-        parseTimestamp: (/* @__PURE__ */ new Date()).toISOString()
-      }
-    };
-  } catch (error) {
-    throw new errors.InputError(`Error parsing PDF: ${error}`);
-  }
-}
-async function parseFile(buffer, fileName, fileType) {
-  const normalizedType = fileType.toLowerCase().replace(/^\./, "");
-  switch (normalizedType) {
-    case constant.SupportedFileType.MARKDOWN:
-    case constant.SupportedFileType.TEXT:
-    case constant.SupportedFileType.LOG:
-      return parseTextFile(buffer, fileName, fileType);
-    case constant.SupportedFileType.JSON:
-      return parseJSONFile(buffer, fileName, fileType);
-    case constant.SupportedFileType.YAML:
-    case constant.SupportedFileType.YML:
-      return parseYAMLFile(buffer, fileName, fileType);
-    case constant.SupportedFileType.PDF:
-      return parsePDFFile(buffer, fileName, fileType);
-    default:
-      throw new errors.InputError(`Unsupported file type: ${fileType}`);
-  }
-}
-async function toFile(buffer, filename, options) {
-  const stream$1 = stream.Readable.from(buffer);
-  return {
-    name: filename,
-    stream: stream$1,
-    buffer,
-    type: options?.type || "application/octet-stream"
-  };
-}
-
-exports.parseFile = parseFile;
-exports.toFile = toFile;
-//# sourceMappingURL=fileParser.cjs.js.map

package/dist/service/notebooks/documents/fileParser.cjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fileParser.cjs.js","sources":["../../../../src/service/notebooks/documents/fileParser.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { InputError } from '@backstage/errors';\n\nimport * as yaml from 'js-yaml';\nimport * as pdfjsLib from 'pdfjs-dist';\n\nimport { Readable } from 'stream';\n\nimport { SupportedFileType } from '../../constant';\n\nexport interface ParsedDocument {\n  content: string;\n  metadata: {\n    fileName: string;\n    fileType: string;\n    pageCount?: number;\n    parseTimestamp: string;\n  };\n}\n\n/**\n * Parse text-based files (md, txt, log)\n */\nfunction parseTextFile(\n  buffer: Buffer,\n  fileName: string,\n  fileType: string,\n): ParsedDocument {\n  const content = buffer.toString('utf-8');\n\n  return {\n    content,\n    metadata: {\n      fileName,\n      fileType,\n      parseTimestamp: new Date().toISOString(),\n    },\n  };\n}\n\n/**\n * Parse JSON files\n */\nfunction parseJSONFile(\n  buffer: Buffer,\n  fileName: string,\n  fileType: string,\n): ParsedDocument {\n  try {\n    const content = buffer.toString('utf-8');\n    // Validate JSON but keep original formatting\n    JSON.parse(content);\n\n    return {\n      content,\n      metadata: {\n        fileName,\n        fileType,\n        parseTimestamp: new Date().toISOString(),\n      },\n    };\n  } catch (error) {\n    throw new InputError(`Invalid JSON file: ${error}`);\n  }\n}\n\n/**\n * Parse YAML files\n */\nfunction parseYAMLFile(\n  buffer: Buffer,\n  fileName: string,\n  fileType: string,\n): ParsedDocument {\n  try {\n    const content = buffer.toString('utf-8');\n    // Validate YAML but keep original formatting and comments\n    yaml.load(content);\n\n    return {\n      content,\n      metadata: {\n        fileName,\n        fileType,\n        parseTimestamp: new Date().toISOString(),\n      },\n    };\n  } catch (error) {\n    throw new InputError(`Invalid YAML file: ${error}`);\n  }\n}\n\n/**\n * Parse PDF files\n * Extracts text content from PDF using PDF.js\n */\nasync function parsePDFFile(\n  buffer: Buffer,\n  fileName: string,\n  fileType: string,\n): Promise<ParsedDocument> {\n  try {\n    const loadingTask = pdfjsLib.getDocument({\n      data: new Uint8Array(buffer),\n      useSystemFonts: true,\n    });\n\n    const pdf = await loadingTask.promise;\n    const textParts: string[] = [];\n\n    // Extract text from each page\n    for (let pageNum = 1; pageNum <= pdf.numPages; pageNum++) {\n      const page = await pdf.getPage(pageNum);\n      const textContent = await page.getTextContent();\n\n      const pageText = textContent.items\n        .map((item: any) => {\n          if ('str' in item) {\n            return item.str;\n          }\n          return '';\n        })\n        .filter((str: string) => str.trim().length > 0)\n        .join(' ');\n\n      if (pageText.trim().length > 0) {\n        textParts.push(`--- Page ${pageNum} ---\\n${pageText}`);\n      }\n    }\n\n    const content = textParts.join('\\n\\n');\n\n    return {\n      content,\n      metadata: {\n        fileName,\n        fileType,\n        pageCount: pdf.numPages,\n        parseTimestamp: new Date().toISOString(),\n      },\n    };\n  } catch (error) {\n    throw new InputError(`Error parsing PDF: ${error}`);\n  }\n}\n\n/**\n * Parse file based on its type\n * @param buffer - File buffer\n * @param fileName - File name\n * @param fileType - File type (md, txt, pdf, json, yaml, yml, log)\n * @returns Parsed document with content and metadata\n */\nexport async function parseFile(\n  buffer: Buffer,\n  fileName: string,\n  fileType: string,\n): Promise<ParsedDocument> {\n  // Normalize file type: lowercase and remove leading dot\n  const normalizedType = fileType.toLowerCase().replace(/^\\./, '');\n\n  switch (normalizedType) {\n    case SupportedFileType.MARKDOWN:\n    case SupportedFileType.TEXT:\n    case SupportedFileType.LOG:\n      return parseTextFile(buffer, fileName, fileType);\n\n    case SupportedFileType.JSON:\n      return parseJSONFile(buffer, fileName, fileType);\n\n    case SupportedFileType.YAML:\n    case SupportedFileType.YML:\n      return parseYAMLFile(buffer, fileName, fileType);\n\n    case SupportedFileType.PDF:\n      return parsePDFFile(buffer, fileName, fileType);\n\n    default:\n      throw new InputError(`Unsupported file type: ${fileType}`);\n  }\n}\n\n/**\n * File-like object interface matching what toFile() returns\n */\nexport interface FileObject {\n  name: string;\n  stream: Readable;\n  buffer: Buffer;\n  type: string;\n}\n\n/**\n * Convert Buffer to File-like object for upload\n */\nexport async function toFile(\n  buffer: Buffer,\n  filename: string,\n  options?: { type?: string },\n): Promise<FileObject> {\n  const stream = Readable.from(buffer);\n\n  return {\n    name: filename,\n    stream,\n    buffer,\n    type: options?.type || 'application/octet-stream',\n  };\n}\n"],"names":["InputError","yaml","pdfjsLib","SupportedFileType","stream","Readable"],"mappings":"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"}