@minded-ai/mindedjs 2.0.5 → 2.0.6-beta-2

package/dist/types/Platform.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Platform.types"), exports);
+//# sourceMappingURL=Platform.js.map

package/dist/types/Platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.js","sourceRoot":"","sources":["../../src/types/Platform.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/dist/types/Tools.d.ts

@@ -0,0 +1,2 @@
+export * from './Tools.types';
+//# sourceMappingURL=Tools.d.ts.map

package/dist/types/Tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tools.d.ts","sourceRoot":"","sources":["../../src/types/Tools.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/types/Tools.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Tools.types"), exports);
+//# sourceMappingURL=Tools.js.map

package/dist/types/Tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tools.js","sourceRoot":"","sources":["../../src/types/Tools.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/types/Triggers.d.ts

@@ -0,0 +1,2 @@
+export * from './Triggers.types';
+//# sourceMappingURL=Triggers.d.ts.map

package/dist/types/Triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triggers.d.ts","sourceRoot":"","sources":["../../src/types/Triggers.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/types/Triggers.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Triggers.types"), exports);
+//# sourceMappingURL=Triggers.js.map

package/dist/types/Triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triggers.js","sourceRoot":"","sources":["../../src/types/Triggers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC"}

package/dist/types/Triggers.types.d.ts

@@ -0,0 +1,25 @@
+import { KnownTriggerNames } from './Flows.types';
+export interface TriggerEvent {
+    /** The payload/data associated with the trigger */
+    triggerBody: any;
+    /** The name/type of the trigger being invoked */
+    triggerName: string;
+    /** Optional name of the application triggering the agent in case of an app trigger */
+    appName?: string;
+}
+export interface MindedPlatformTriggerEvent extends TriggerEvent {
+    /** The payload/data associated with the trigger */
+    triggerBody: {
+        content: string;
+        sessionId: string;
+        attachments: MidnedPlatformAttachment[];
+    };
+    /** The name/type of the trigger being invoked */
+    triggerName: KnownTriggerNames.DASHBOARD_MESSAGE;
+}
+export interface MidnedPlatformAttachment {
+    type: string;
+    data: any;
+    name: string;
+}
+//# sourceMappingURL=Triggers.types.d.ts.map

package/dist/types/Triggers.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triggers.types.d.ts","sourceRoot":"","sources":["../../src/types/Triggers.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,WAAW,EAAE,GAAG,CAAC;IACjB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,YAAY;IAC9D,mDAAmD;IACnD,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,wBAAwB,EAAE,CAAC;KACzC,CAAC;IACF,iDAAiD;IACjD,WAAW,EAAE,iBAAiB,CAAC,iBAAiB,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/Triggers.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Triggers.types.js.map

package/dist/types/Triggers.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Triggers.types.js","sourceRoot":"","sources":["../../src/types/Triggers.types.ts"],"names":[],"mappings":""}

package/dist/types/Voice.d.ts

@@ -0,0 +1,2 @@
+export * from './Voice.types';
+//# sourceMappingURL=Voice.d.ts.map

package/dist/types/Voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voice.d.ts","sourceRoot":"","sources":["../../src/types/Voice.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/types/Voice.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Voice.types"), exports);
+//# sourceMappingURL=Voice.js.map

package/dist/types/Voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voice.js","sourceRoot":"","sources":["../../src/types/Voice.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export * from './Agent';
+export * from './Tools';
+export * from './Flows';
+export * from './Triggers';
+export * from './LLM';
+export * from './Voice';
+export * from './Platform';
+export * from './LangGraph';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Agent"), exports);
+__exportStar(require("./Tools"), exports);
+__exportStar(require("./Flows"), exports);
+__exportStar(require("./Triggers"), exports);
+__exportStar(require("./LLM"), exports);
+__exportStar(require("./Voice"), exports);
+__exportStar(require("./Platform"), exports);
+__exportStar(require("./LangGraph"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,wCAAsB;AACtB,0CAAwB;AACxB,6CAA2B;AAC3B,8CAA4B"}

package/dist/utils/LogicalConditionDebugger.d.ts

@@ -0,0 +1,57 @@
+import { LogicalConditionEdge } from '../types/Flows.types';
+import { stateAnnotation } from '../types/LangGraph.types';
+export interface ConditionDebugInfo {
+    edge: LogicalConditionEdge;
+    state: typeof stateAnnotation.State;
+    condition: string;
+    result?: boolean;
+    error?: Error;
+    executionTimeMs?: number;
+}
+export type ConditionDebugHook = (info: ConditionDebugInfo) => void | Promise<void>;
+export declare class LogicalConditionDebugger {
+    private static instance;
+    private debugHooks;
+    private isDebugMode;
+    private constructor();
+    static getInstance(): LogicalConditionDebugger;
+    /**
+     * Register a debug hook that will be called before condition evaluation
+     * This allows users to set breakpoints in their code
+     */
+    registerDebugHook(hook: ConditionDebugHook): void;
+    /**
+     * Clear all registered debug hooks
+     */
+    clearDebugHooks(): void;
+    /**
+     * Log condition evaluation start
+     */
+    logConditionStart(edge: LogicalConditionEdge, state: typeof stateAnnotation.State): void;
+    /**
+     * Log condition evaluation result
+     */
+    logConditionResult(edge: LogicalConditionEdge, result: boolean, executionTimeMs: number, state: typeof stateAnnotation.State): void;
+    /**
+     * Log condition evaluation error
+     */
+    logConditionError(edge: LogicalConditionEdge, error: Error, state: typeof stateAnnotation.State): void;
+    /**
+     * Call all registered debug hooks
+     */
+    callDebugHooks(info: ConditionDebugInfo): Promise<void>;
+    /**
+     * Log a summary of all conditions evaluated
+     */
+    logConditionSummary(evaluatedConditions: Array<{
+        edge: LogicalConditionEdge;
+        result: boolean;
+        timeMs: number;
+    }>): void;
+    /**
+     * Check if debug mode is enabled
+     */
+    isDebugEnabled(): boolean;
+}
+export declare const conditionDebugger: LogicalConditionDebugger;
+//# sourceMappingURL=LogicalConditionDebugger.d.ts.map

package/dist/utils/LogicalConditionDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogicalConditionDebugger.d.ts","sourceRoot":"","sources":["../../src/utils/LogicalConditionDebugger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,OAAO,eAAe,CAAC,KAAK,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,WAAW,CAAU;IAE7B,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,wBAAwB;IAO9C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAQjD;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,eAAe,CAAC,KAAK,GAAG,IAAI;IAkBxF;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,eAAe,CAAC,KAAK,GAAG,IAAI;IAiBnI;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,eAAe,CAAC,KAAK,GAAG,IAAI;IAoBtG;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7D;;OAEG;IACH,mBAAmB,CAAC,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAiBtH;;OAEG;IACH,cAAc,IAAI,OAAO;CAG1B;AAGD,eAAO,MAAM,iBAAiB,0BAAyC,CAAC"}

package/dist/utils/LogicalConditionDebugger.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conditionDebugger = exports.LogicalConditionDebugger = void 0;
+const logger_1 = require("./logger");
+class LogicalConditionDebugger {
+    constructor() {
+        this.debugHooks = [];
+        this.isDebugMode = process.env.LOG_LEVEL === 'debug';
+    }
+    static getInstance() {
+        if (!LogicalConditionDebugger.instance) {
+            LogicalConditionDebugger.instance = new LogicalConditionDebugger();
+        }
+        return LogicalConditionDebugger.instance;
+    }
+    /**
+     * Register a debug hook that will be called before condition evaluation
+     * This allows users to set breakpoints in their code
+     */
+    registerDebugHook(hook) {
+        this.debugHooks.push(hook);
+        logger_1.logger.debug({
+            msg: '[LogicalConditionDebugger] Debug hook registered',
+            totalHooks: this.debugHooks.length,
+        });
+    }
+    /**
+     * Clear all registered debug hooks
+     */
+    clearDebugHooks() {
+        this.debugHooks = [];
+    }
+    /**
+     * Log condition evaluation start
+     */
+    logConditionStart(edge, state) {
+        var _a;
+        if (!this.isDebugMode)
+            return;
+        logger_1.logger.debug({
+            msg: '[LogicalCondition] Evaluating condition',
+            edge: {
+                source: edge.source,
+                target: edge.target,
+                condition: edge.condition,
+            },
+            state: {
+                memoryKeys: Object.keys(state.memory || {}),
+                messageCount: ((_a = state.messages) === null || _a === void 0 ? void 0 : _a.length) || 0,
+                hasGoto: !!state.goto,
+            },
+        });
+    }
+    /**
+     * Log condition evaluation result
+     */
+    logConditionResult(edge, result, executionTimeMs, state) {
+        if (!this.isDebugMode)
+            return;
+        logger_1.logger.debug({
+            msg: '[LogicalCondition] Condition evaluated',
+            edge: {
+                source: edge.source,
+                target: edge.target,
+                condition: edge.condition,
+            },
+            result,
+            executionTimeMs,
+            willTransition: result,
+            nextNode: result ? edge.target : null,
+        });
+    }
+    /**
+     * Log condition evaluation error
+     */
+    logConditionError(edge, error, state) {
+        var _a;
+        // Always log errors, not just in debug mode
+        logger_1.logger.error({
+            msg: '[LogicalCondition] Error evaluating condition',
+            edge: {
+                source: edge.source,
+                target: edge.target,
+                condition: edge.condition,
+            },
+            error: error.message,
+            stack: this.isDebugMode ? error.stack : undefined,
+            state: this.isDebugMode
+                ? {
+                    memorySnapshot: JSON.stringify(state.memory).substring(0, 200) + '...',
+                    messageCount: ((_a = state.messages) === null || _a === void 0 ? void 0 : _a.length) || 0,
+                }
+                : undefined,
+        });
+    }
+    /**
+     * Call all registered debug hooks
+     */
+    async callDebugHooks(info) {
+        if (!this.isDebugMode || this.debugHooks.length === 0)
+            return;
+        for (const hook of this.debugHooks) {
+            try {
+                await hook(info);
+            }
+            catch (error) {
+                logger_1.logger.warn({
+                    msg: '[LogicalConditionDebugger] Debug hook threw error',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    /**
+     * Log a summary of all conditions evaluated
+     */
+    logConditionSummary(evaluatedConditions) {
+        if (!this.isDebugMode || evaluatedConditions.length === 0)
+            return;
+        logger_1.logger.debug({
+            msg: '[LogicalCondition] Evaluation summary',
+            totalConditions: evaluatedConditions.length,
+            conditions: evaluatedConditions.map(({ edge, result, timeMs }) => ({
+                condition: edge.condition,
+                source: edge.source,
+                target: edge.target,
+                result,
+                timeMs,
+            })),
+            totalTimeMs: evaluatedConditions.reduce((sum, c) => sum + c.timeMs, 0),
+        });
+    }
+    /**
+     * Check if debug mode is enabled
+     */
+    isDebugEnabled() {
+        return this.isDebugMode;
+    }
+}
+exports.LogicalConditionDebugger = LogicalConditionDebugger;
+// Export singleton instance
+exports.conditionDebugger = LogicalConditionDebugger.getInstance();
+//# sourceMappingURL=LogicalConditionDebugger.js.map

package/dist/utils/LogicalConditionDebugger.js.map

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

package/dist/utils/documentProcessor.d.ts

@@ -0,0 +1,87 @@
+import { ZodSchema, ZodTypeAny } from 'zod';
+import { BaseLanguageModel } from '@langchain/core/language_models/base';
+export interface DocumentProcessorConfig {
+    llamaCloudApiKey?: string;
+    useBase64?: boolean;
+    maxImageWidth?: number;
+    imageQuality?: number;
+}
+export interface DocumentExtractionOptions {
+    documentPath?: string;
+    documentContent?: Buffer | string;
+    documentUrl?: string;
+    schema?: ZodSchema<any> | ZodTypeAny;
+    llmConfig?: {
+        model?: string;
+        temperature?: number;
+    };
+    systemPrompt?: string;
+}
+export interface DocumentProcessingResult<T = any> {
+    data: T;
+    metadata: {
+        fileSize?: number;
+        fileType: string;
+        processingTime: number;
+        contentLength: number;
+    };
+}
+/**
+ * Generic document processor that can extract structured data from various document types
+ * including images, PDFs, Word documents, spreadsheets, and more.
+ */
+export declare class DocumentProcessor {
+    private config;
+    private llm;
+    private llamaCloudApiKey;
+    constructor(config?: DocumentProcessorConfig, llm?: BaseLanguageModel);
+    /**
+     * Parse document using LlamaCloud REST API
+     */
+    private parseWithLlamaCloud;
+    /**
+     * Get MIME type for file extension
+     */
+    private getMimeType;
+    /**
+     * Extract data from a document - either structured data using AI or raw text
+     */
+    extractFromDocument<T = string>(options: DocumentExtractionOptions): Promise<DocumentProcessingResult<T>>;
+    /**
+     * Get document content from various sources
+     */
+    private getDocumentContent;
+    /**
+     * Process image documents by converting them to a standardized format
+     */
+    private processImageDocument;
+    /**
+     * Process text-based documents using LlamaParser or fallback methods
+     */
+    private processTextDocument;
+    /**
+     * Extract data using LLM - either structured with schema or unstructured with prompt
+     */
+    private extractStructuredData;
+    /**
+     * Check if file is an image type
+     */
+    private isImageFile;
+    /**
+     * Infer file type from buffer content
+     */
+    private inferFileTypeFromBuffer;
+    /**
+     * Infer file type from URL
+     */
+    private inferFileTypeFromUrl;
+    /**
+     * Get list of supported document types
+     */
+    static getSupportedDocumentTypes(): string[];
+    /**
+     * Check if a file type is supported
+     */
+    static isDocumentTypeSupported(fileType: string): boolean;
+}
+//# sourceMappingURL=documentProcessor.d.ts.map

package/dist/utils/documentProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentProcessor.d.ts","sourceRoot":"","sources":["../../src/utils/documentProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAQzE,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACrC,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,GAAG;IAC/C,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAkCD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,MAAM,GAAE,uBAA4B,EAAE,GAAG,CAAC,EAAE,iBAAiB;IAYzE;;OAEG;YACW,mBAAmB;IAmNjC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACG,mBAAmB,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAuE/G;;OAEG;YACW,kBAAkB;IAoFhC;;OAEG;YACW,oBAAoB;IAwGlC;;OAEG;YACW,mBAAmB;IAsDjC;;OAEG;YACW,qBAAqB;IAoFnC;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,MAAM,CAAC,yBAAyB,IAAI,MAAM,EAAE;IAI5C;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1D"}