@danielsimonjr/memoryjs 1.0.0

package/dist/utils/errors.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Custom Error Types
+ *
+ * Defines custom error classes for better error handling and debugging.
+ *
+ * @module utils/errors
+ */
+/**
+ * Base error class for all knowledge graph errors.
+ * Extends the native Error class with additional context.
+ */
+export declare class KnowledgeGraphError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+/**
+ * Error thrown when an entity is not found.
+ */
+export declare class EntityNotFoundError extends KnowledgeGraphError {
+    constructor(entityName: string);
+}
+/**
+ * Error thrown when a relation is not found.
+ */
+export declare class RelationNotFoundError extends KnowledgeGraphError {
+    constructor(from: string, to: string, relationType?: string);
+}
+/**
+ * Error thrown when attempting to create a duplicate entity.
+ */
+export declare class DuplicateEntityError extends KnowledgeGraphError {
+    constructor(entityName: string);
+}
+/**
+ * Error thrown when validation fails.
+ */
+export declare class ValidationError extends KnowledgeGraphError {
+    readonly errors: string[];
+    constructor(message: string, errors: string[]);
+}
+/**
+ * Error thrown when a cycle is detected in hierarchies.
+ */
+export declare class CycleDetectedError extends KnowledgeGraphError {
+    constructor(entityName: string, parentName: string);
+}
+/**
+ * Error thrown when an invalid importance value is provided.
+ */
+export declare class InvalidImportanceError extends KnowledgeGraphError {
+    constructor(value: number, min?: number, max?: number);
+}
+/**
+ * Error thrown when a file operation fails.
+ */
+export declare class FileOperationError extends KnowledgeGraphError {
+    constructor(operation: string, filePath: string, cause?: Error);
+}
+/**
+ * Error thrown when an import operation fails.
+ */
+export declare class ImportError extends KnowledgeGraphError {
+    constructor(format: string, message: string);
+}
+/**
+ * Error thrown when an export operation fails.
+ */
+export declare class ExportError extends KnowledgeGraphError {
+    constructor(format: string, message: string);
+}
+/**
+ * Error thrown when insufficient entities are provided for an operation.
+ */
+export declare class InsufficientEntitiesError extends KnowledgeGraphError {
+    constructor(operation: string, required: number, provided: number);
+}
+/**
+ * Phase 9B: Error thrown when an operation is cancelled via AbortSignal.
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * try {
+ *   await manager.createEntities(entities, { signal: controller.signal });
+ * } catch (error) {
+ *   if (error instanceof OperationCancelledError) {
+ *     console.log('Operation was cancelled');
+ *   }
+ * }
+ * ```
+ */
+export declare class OperationCancelledError extends KnowledgeGraphError {
+    constructor(operation?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aACC,IAAI,CAAC,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA;CAQ3D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB;gBAC9C,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;gBAChD,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAO5D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAC/C,UAAU,EAAE,MAAM;CAI/B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB;aAGpC,MAAM,EAAE,MAAM,EAAE;gBADhC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAAE;CAKnC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAC7C,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAOnD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;gBACjD,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAU,EAAE,GAAG,GAAE,MAAW;CAO7D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAEvD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK;CAWhB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,mBAAmB;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,mBAAmB;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5C;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB;gBACpD,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAOlE;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;gBAClD,SAAS,CAAC,EAAE,MAAM;CAO/B"}

package/dist/utils/errors.js

@@ -0,0 +1,146 @@
+/**
+ * Custom Error Types
+ *
+ * Defines custom error classes for better error handling and debugging.
+ *
+ * @module utils/errors
+ */
+/**
+ * Base error class for all knowledge graph errors.
+ * Extends the native Error class with additional context.
+ */
+export class KnowledgeGraphError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'KnowledgeGraphError';
+        // Maintains proper stack trace in V8 engines
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Error thrown when an entity is not found.
+ */
+export class EntityNotFoundError extends KnowledgeGraphError {
+    constructor(entityName) {
+        super(`Entity "${entityName}" not found`, 'ENTITY_NOT_FOUND');
+        this.name = 'EntityNotFoundError';
+    }
+}
+/**
+ * Error thrown when a relation is not found.
+ */
+export class RelationNotFoundError extends KnowledgeGraphError {
+    constructor(from, to, relationType) {
+        const desc = relationType
+            ? `Relation "${from}" --[${relationType}]--> "${to}"`
+            : `Relation from "${from}" to "${to}"`;
+        super(`${desc} not found`, 'RELATION_NOT_FOUND');
+        this.name = 'RelationNotFoundError';
+    }
+}
+/**
+ * Error thrown when attempting to create a duplicate entity.
+ */
+export class DuplicateEntityError extends KnowledgeGraphError {
+    constructor(entityName) {
+        super(`Entity "${entityName}" already exists`, 'DUPLICATE_ENTITY');
+        this.name = 'DuplicateEntityError';
+    }
+}
+/**
+ * Error thrown when validation fails.
+ */
+export class ValidationError extends KnowledgeGraphError {
+    errors;
+    constructor(message, errors) {
+        super(message, 'VALIDATION_ERROR');
+        this.errors = errors;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Error thrown when a cycle is detected in hierarchies.
+ */
+export class CycleDetectedError extends KnowledgeGraphError {
+    constructor(entityName, parentName) {
+        super(`Setting parent "${parentName}" for entity "${entityName}" would create a cycle`, 'CYCLE_DETECTED');
+        this.name = 'CycleDetectedError';
+    }
+}
+/**
+ * Error thrown when an invalid importance value is provided.
+ */
+export class InvalidImportanceError extends KnowledgeGraphError {
+    constructor(value, min = 0, max = 10) {
+        super(`Importance must be between ${min} and ${max}, got ${value}`, 'INVALID_IMPORTANCE');
+        this.name = 'InvalidImportanceError';
+    }
+}
+/**
+ * Error thrown when a file operation fails.
+ */
+export class FileOperationError extends KnowledgeGraphError {
+    constructor(operation, filePath, cause) {
+        super(`Failed to ${operation} file: ${filePath}${cause ? ` - ${cause.message}` : ''}`, 'FILE_OPERATION_ERROR');
+        this.name = 'FileOperationError';
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+/**
+ * Error thrown when an import operation fails.
+ */
+export class ImportError extends KnowledgeGraphError {
+    constructor(format, message) {
+        super(`Import failed (${format}): ${message}`, 'IMPORT_ERROR');
+        this.name = 'ImportError';
+    }
+}
+/**
+ * Error thrown when an export operation fails.
+ */
+export class ExportError extends KnowledgeGraphError {
+    constructor(format, message) {
+        super(`Export failed (${format}): ${message}`, 'EXPORT_ERROR');
+        this.name = 'ExportError';
+    }
+}
+/**
+ * Error thrown when insufficient entities are provided for an operation.
+ */
+export class InsufficientEntitiesError extends KnowledgeGraphError {
+    constructor(operation, required, provided) {
+        super(`${operation} requires at least ${required} entities, got ${provided}`, 'INSUFFICIENT_ENTITIES');
+        this.name = 'InsufficientEntitiesError';
+    }
+}
+/**
+ * Phase 9B: Error thrown when an operation is cancelled via AbortSignal.
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * try {
+ *   await manager.createEntities(entities, { signal: controller.signal });
+ * } catch (error) {
+ *   if (error instanceof OperationCancelledError) {
+ *     console.log('Operation was cancelled');
+ *   }
+ * }
+ * ```
+ */
+export class OperationCancelledError extends KnowledgeGraphError {
+    constructor(operation) {
+        const message = operation
+            ? `Operation '${operation}' was cancelled`
+            : 'Operation was cancelled';
+        super(message, 'OPERATION_CANCELLED');
+        this.name = 'OperationCancelledError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACC;IAA7C,YAAY,OAAe,EAAkB,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,SAAI,GAAJ,IAAI,CAAS;QAExD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,6CAA6C;QAC7C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,mBAAmB;IAC1D,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,mBAAmB;IAC5D,YAAY,IAAY,EAAE,EAAU,EAAE,YAAqB;QACzD,MAAM,IAAI,GAAG,YAAY;YACvB,CAAC,CAAC,aAAa,IAAI,QAAQ,YAAY,SAAS,EAAE,GAAG;YACrD,CAAC,CAAC,kBAAkB,IAAI,SAAS,EAAE,GAAG,CAAC;QACzC,KAAK,CAAC,GAAG,IAAI,YAAY,EAAE,oBAAoB,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,mBAAmB;IAC3D,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,mBAAmB;IAGpC;IAFlB,YACE,OAAe,EACC,MAAgB;QAEhC,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAFnB,WAAM,GAAN,MAAM,CAAU;QAGhC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,mBAAmB;IACzD,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CACH,mBAAmB,UAAU,iBAAiB,UAAU,wBAAwB,EAChF,gBAAgB,CACjB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAC7D,YAAY,KAAa,EAAE,MAAc,CAAC,EAAE,MAAc,EAAE;QAC1D,KAAK,CACH,8BAA8B,GAAG,QAAQ,GAAG,SAAS,KAAK,EAAE,EAC5D,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,mBAAmB;IACzD,YACE,SAAiB,EACjB,QAAgB,EAChB,KAAa;QAEb,KAAK,CACH,aAAa,SAAS,UAAU,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC/E,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,mBAAmB;IAClD,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,kBAAkB,MAAM,MAAM,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,mBAAmB;IAClD,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,kBAAkB,MAAM,MAAM,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAmB;IAChE,YAAY,SAAiB,EAAE,QAAgB,EAAE,QAAgB;QAC/D,KAAK,CACH,GAAG,SAAS,sBAAsB,QAAQ,kBAAkB,QAAQ,EAAE,EACtE,uBAAuB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC9D,YAAY,SAAkB;QAC5B,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC,cAAc,SAAS,iBAAiB;YAC1C,CAAC,CAAC,yBAAyB,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/utils/formatters.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Response and Pagination Formatters
+ *
+ * Consolidated module for MCP tool response formatting and pagination utilities.
+ * Centralizes response formatting for MCP tool calls to eliminate redundant patterns.
+ *
+ * @module utils/formatters
+ */
+/**
+ * MCP Tool Response type - uses the exact shape expected by the SDK.
+ * The 'as const' assertion ensures the type literal is preserved.
+ */
+export type ToolResponse = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+/**
+ * Formats data as an MCP tool response with JSON content.
+ * Centralizes the response format to ensure consistency and reduce duplication.
+ *
+ * @param data - Any data to be JSON stringified
+ * @returns Formatted MCP tool response
+ */
+export declare function formatToolResponse(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Formats a simple text message as an MCP tool response.
+ * Use for success messages that don't need JSON formatting.
+ *
+ * @param message - Plain text message
+ * @returns Formatted MCP tool response
+ */
+export declare function formatTextResponse(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Formats raw string content as an MCP tool response.
+ * Use for export formats that return pre-formatted strings (markdown, CSV, etc.)
+ *
+ * @param content - Raw string content
+ * @returns Formatted MCP tool response
+ */
+export declare function formatRawResponse(content: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+/**
+ * Formats an error as an MCP tool response with isError flag.
+ *
+ * @param error - Error object or message string
+ * @returns Formatted MCP tool error response
+ */
+export declare function formatErrorResponse(error: Error | string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+/**
+ * Validated pagination parameters with helper methods.
+ */
+export interface ValidatedPagination {
+    /** Validated offset (guaranteed >= 0) */
+    offset: number;
+    /** Validated limit (guaranteed within SEARCH_LIMITS.MIN to SEARCH_LIMITS.MAX) */
+    limit: number;
+    /**
+     * Check if there are more results beyond the current page.
+     * @param totalCount - Total number of items
+     * @returns true if there are more items after this page
+     */
+    hasMore: (totalCount: number) => boolean;
+}
+/**
+ * Validates and normalizes pagination parameters.
+ * Ensures offset is non-negative and limit is within configured bounds.
+ *
+ * @param offset - Starting position (default: 0)
+ * @param limit - Maximum results to return (default: SEARCH_LIMITS.DEFAULT)
+ * @returns Validated pagination parameters with helper methods
+ *
+ * @example
+ * ```typescript
+ * const pagination = validatePagination(10, 50);
+ * const results = items.slice(pagination.offset, pagination.offset + pagination.limit);
+ * if (pagination.hasMore(items.length)) {
+ *   console.log('More results available');
+ * }
+ * ```
+ */
+export declare function validatePagination(offset?: number, limit?: number): ValidatedPagination;
+/**
+ * Applies pagination to an array of items.
+ *
+ * @param items - Array to paginate
+ * @param pagination - Validated pagination parameters
+ * @returns Paginated slice of the array
+ *
+ * @example
+ * ```typescript
+ * const pagination = validatePagination(offset, limit);
+ * const pageResults = applyPagination(allResults, pagination);
+ * ```
+ */
+export declare function applyPagination<T>(items: T[], pagination: ValidatedPagination): T[];
+/**
+ * Applies pagination using raw offset and limit values.
+ * Combines validation and application in one call.
+ *
+ * @param items - Array to paginate
+ * @param offset - Starting position
+ * @param limit - Maximum results
+ * @returns Paginated slice of the array
+ */
+export declare function paginateArray<T>(items: T[], offset?: number, limit?: number): T[];
+/**
+ * Calculates pagination metadata for a result set.
+ *
+ * @param totalCount - Total number of items
+ * @param offset - Current offset
+ * @param limit - Current limit
+ * @returns Pagination metadata
+ */
+export declare function getPaginationMeta(totalCount: number, offset?: number, limit?: number): {
+    totalCount: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+    pageNumber: number;
+    totalPages: number;
+};
+//# sourceMappingURL=formatters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO;;;;;EAI/C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM;;;;;EAIjD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM;;;;;EAIhD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;;;;;;EAMxD;AAID;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC,mBAAmB,CAYrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,mBAAmB,GAC9B,CAAC,EAAE,CAEL;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC,CAAC,EAAE,CAGL;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAA8B,GACpC;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAWA"}

package/dist/utils/formatters.js

@@ -0,0 +1,133 @@
+/**
+ * Response and Pagination Formatters
+ *
+ * Consolidated module for MCP tool response formatting and pagination utilities.
+ * Centralizes response formatting for MCP tool calls to eliminate redundant patterns.
+ *
+ * @module utils/formatters
+ */
+import { SEARCH_LIMITS } from './constants.js';
+/**
+ * Formats data as an MCP tool response with JSON content.
+ * Centralizes the response format to ensure consistency and reduce duplication.
+ *
+ * @param data - Any data to be JSON stringified
+ * @returns Formatted MCP tool response
+ */
+export function formatToolResponse(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+/**
+ * Formats a simple text message as an MCP tool response.
+ * Use for success messages that don't need JSON formatting.
+ *
+ * @param message - Plain text message
+ * @returns Formatted MCP tool response
+ */
+export function formatTextResponse(message) {
+    return {
+        content: [{ type: 'text', text: message }],
+    };
+}
+/**
+ * Formats raw string content as an MCP tool response.
+ * Use for export formats that return pre-formatted strings (markdown, CSV, etc.)
+ *
+ * @param content - Raw string content
+ * @returns Formatted MCP tool response
+ */
+export function formatRawResponse(content) {
+    return {
+        content: [{ type: 'text', text: content }],
+    };
+}
+/**
+ * Formats an error as an MCP tool response with isError flag.
+ *
+ * @param error - Error object or message string
+ * @returns Formatted MCP tool error response
+ */
+export function formatErrorResponse(error) {
+    const message = error instanceof Error ? error.message : error;
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+/**
+ * Validates and normalizes pagination parameters.
+ * Ensures offset is non-negative and limit is within configured bounds.
+ *
+ * @param offset - Starting position (default: 0)
+ * @param limit - Maximum results to return (default: SEARCH_LIMITS.DEFAULT)
+ * @returns Validated pagination parameters with helper methods
+ *
+ * @example
+ * ```typescript
+ * const pagination = validatePagination(10, 50);
+ * const results = items.slice(pagination.offset, pagination.offset + pagination.limit);
+ * if (pagination.hasMore(items.length)) {
+ *   console.log('More results available');
+ * }
+ * ```
+ */
+export function validatePagination(offset = 0, limit = SEARCH_LIMITS.DEFAULT) {
+    const validatedOffset = Math.max(0, offset);
+    const validatedLimit = Math.min(Math.max(SEARCH_LIMITS.MIN, limit), SEARCH_LIMITS.MAX);
+    return {
+        offset: validatedOffset,
+        limit: validatedLimit,
+        hasMore: (totalCount) => validatedOffset + validatedLimit < totalCount,
+    };
+}
+/**
+ * Applies pagination to an array of items.
+ *
+ * @param items - Array to paginate
+ * @param pagination - Validated pagination parameters
+ * @returns Paginated slice of the array
+ *
+ * @example
+ * ```typescript
+ * const pagination = validatePagination(offset, limit);
+ * const pageResults = applyPagination(allResults, pagination);
+ * ```
+ */
+export function applyPagination(items, pagination) {
+    return items.slice(pagination.offset, pagination.offset + pagination.limit);
+}
+/**
+ * Applies pagination using raw offset and limit values.
+ * Combines validation and application in one call.
+ *
+ * @param items - Array to paginate
+ * @param offset - Starting position
+ * @param limit - Maximum results
+ * @returns Paginated slice of the array
+ */
+export function paginateArray(items, offset = 0, limit = SEARCH_LIMITS.DEFAULT) {
+    const pagination = validatePagination(offset, limit);
+    return applyPagination(items, pagination);
+}
+/**
+ * Calculates pagination metadata for a result set.
+ *
+ * @param totalCount - Total number of items
+ * @param offset - Current offset
+ * @param limit - Current limit
+ * @returns Pagination metadata
+ */
+export function getPaginationMeta(totalCount, offset = 0, limit = SEARCH_LIMITS.DEFAULT) {
+    const pagination = validatePagination(offset, limit);
+    return {
+        totalCount,
+        offset: pagination.offset,
+        limit: pagination.limit,
+        hasMore: pagination.hasMore(totalCount),
+        pageNumber: Math.floor(pagination.offset / pagination.limit) + 1,
+        totalPages: Math.ceil(totalCount / pagination.limit),
+    };
+}
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Utilities Module Barrel Export
+ *
+ * Centralizes all utility exports for convenient importing.
+ * Consolidated from 17 files to 9 focused modules (Phase 5 cleanup).
+ *
+ * @module utils
+ */
+export { KnowledgeGraphError, EntityNotFoundError, RelationNotFoundError, DuplicateEntityError, ValidationError, CycleDetectedError, InvalidImportanceError, FileOperationError, ImportError, ExportError, InsufficientEntitiesError, OperationCancelledError, } from './errors.js';
+export { FILE_EXTENSIONS, FILE_SUFFIXES, DEFAULT_FILE_NAMES, ENV_VARS, DEFAULT_BASE_DIR, LOG_PREFIXES, SIMILARITY_WEIGHTS, DEFAULT_DUPLICATE_THRESHOLD, SEARCH_LIMITS, IMPORTANCE_RANGE, GRAPH_LIMITS, QUERY_LIMITS, COMPRESSION_CONFIG, STREAMING_CONFIG, type CompressionQuality, } from './constants.js';
+export { compress, decompress, compressFile, decompressFile, compressToBase64, decompressFromBase64, hasBrotliExtension, getCompressionRatio, createMetadata, createUncompressedMetadata, type CompressionOptions, type CompressionResult, type CompressionMetadata, } from './compressionUtil.js';
+export { CompressedCache, type CompressedCacheOptions, type CompressedCacheStats, } from './compressedCache.js';
+export { logger } from './logger.js';
+export { levenshteinDistance, calculateTF, calculateIDF, calculateIDFFromTokenSets, calculateTFIDF, tokenize, } from './searchAlgorithms.js';
+export { NameIndex, TypeIndex, LowercaseCache, RelationIndex, } from './indexes.js';
+export { SearchCache, searchCaches, clearAllSearchCaches, getAllCacheStats, cleanupAllCaches, type CacheStats, } from './searchCache.js';
+export { EntitySchema, CreateEntitySchema, UpdateEntitySchema, RelationSchema, CreateRelationSchema, SearchQuerySchema, DateRangeSchema, TagAliasSchema, ExportFormatSchema, BatchCreateEntitiesSchema, BatchCreateRelationsSchema, EntityNamesSchema, DeleteRelationsSchema, AddObservationInputSchema, AddObservationsInputSchema, DeleteObservationInputSchema, DeleteObservationsInputSchema, ArchiveCriteriaSchema, SavedSearchInputSchema, SavedSearchUpdateSchema, ImportFormatSchema, ExtendedExportFormatSchema, MergeStrategySchema, ExportFilterSchema, OptionalTagsSchema, OptionalEntityNamesSchema, type EntityInput, type CreateEntityInput, type UpdateEntityInput, type RelationInput, type CreateRelationInput, type SearchQuery, type DateRange, type TagAliasInput, type AddObservationInput, type DeleteObservationInput, type ArchiveCriteriaInput, type SavedSearchInput, type SavedSearchUpdateInput, type ImportFormatInput, type ExtendedExportFormatInput, type MergeStrategyInput, type ExportFilterInput, type ValidationResult, formatZodErrors, validateWithSchema, validateSafe, validateArrayWithSchema, validateEntity, validateRelation, validateImportance, validateTags, } from './schemas.js';
+export { formatToolResponse, formatTextResponse, formatRawResponse, formatErrorResponse, type ToolResponse, validatePagination, applyPagination, paginateArray, getPaginationMeta, type ValidatedPagination, } from './formatters.js';
+export { fnv1aHash, findEntityByName, findEntitiesByNames, entityExists, getEntityIndex, removeEntityByName, getEntityNameSet, groupEntitiesByType, touchEntity, normalizeTag, normalizeTags, hasMatchingTag, hasAllTags, filterByTags, addUniqueTags, removeTags, isWithinDateRange, parseDateRange, isValidISODate, getCurrentTimestamp, isWithinImportanceRange, filterByImportance, filterByCreatedDate, filterByModifiedDate, filterByEntityType, entityPassesFilters, type CommonSearchFilters, validateFilePath, defaultMemoryPath, ensureMemoryFilePath, sanitizeObject, escapeCsvFormula, } from './entityUtils.js';
+export { parallelMap, parallelFilter, getPoolStats, shutdownParallelUtils, } from './parallelUtils.js';
+export { TaskPriority, TaskStatus, type Task, type TaskResult, type ProgressCallback, type TaskBatchOptions, type QueueStats, TaskQueue, batchProcess, rateLimitedProcess, withRetry, debounce, throttle, } from './taskScheduler.js';
+export { checkCancellation, createProgressReporter, createProgress, executeWithPhases, processBatchesWithProgress, type PhaseDefinition, } from './operationUtils.js';
+export { WorkerPoolManager, getWorkerPoolManager, type WorkerPoolConfig, type ExtendedPoolStats, type PoolEventCallback, } from './WorkerPoolManager.js';
+export { BatchProcessor, processBatch, processWithRetry, chunkArray, parallelLimit, mapParallel, filterParallel, type BatchProgress, type BatchProgressCallback, type BatchItemResult, type BatchProcessResult, type BatchProcessorOptions, } from './BatchProcessor.js';
+export { MemoryMonitor, globalMemoryMonitor, type ComponentMemoryUsage, type MemoryUsageStats, type MemoryThresholds, type MemoryAlert, type MemoryChangeCallback, } from './MemoryMonitor.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -0,0 +1,88 @@
+/**
+ * Utilities Module Barrel Export
+ *
+ * Centralizes all utility exports for convenient importing.
+ * Consolidated from 17 files to 9 focused modules (Phase 5 cleanup).
+ *
+ * @module utils
+ */
+// ==================== Error Types ====================
+export { KnowledgeGraphError, EntityNotFoundError, RelationNotFoundError, DuplicateEntityError, ValidationError, CycleDetectedError, InvalidImportanceError, FileOperationError, ImportError, ExportError, InsufficientEntitiesError, OperationCancelledError, } from './errors.js';
+// ==================== Constants ====================
+export { FILE_EXTENSIONS, FILE_SUFFIXES, DEFAULT_FILE_NAMES, ENV_VARS, DEFAULT_BASE_DIR, LOG_PREFIXES, SIMILARITY_WEIGHTS, DEFAULT_DUPLICATE_THRESHOLD, SEARCH_LIMITS, IMPORTANCE_RANGE, GRAPH_LIMITS, QUERY_LIMITS, COMPRESSION_CONFIG, STREAMING_CONFIG, } from './constants.js';
+// ==================== Compression Utilities ====================
+export { compress, decompress, compressFile, decompressFile, compressToBase64, decompressFromBase64, hasBrotliExtension, getCompressionRatio, createMetadata, createUncompressedMetadata, } from './compressionUtil.js';
+// ==================== Compressed Cache ====================
+export { CompressedCache, } from './compressedCache.js';
+// ==================== Logger ====================
+export { logger } from './logger.js';
+// ==================== Search Algorithms ====================
+export { levenshteinDistance, calculateTF, calculateIDF, calculateIDFFromTokenSets, calculateTFIDF, tokenize, } from './searchAlgorithms.js';
+// ==================== Indexes ====================
+export { NameIndex, TypeIndex, LowercaseCache, RelationIndex, } from './indexes.js';
+// ==================== Search Cache ====================
+export { SearchCache, searchCaches, clearAllSearchCaches, getAllCacheStats, cleanupAllCaches, } from './searchCache.js';
+// ==================== Schemas and Validation ====================
+// Consolidated from: schemas.ts, validationHelper.ts, validationUtils.ts
+export { 
+// Zod schemas - Entity/Relation
+EntitySchema, CreateEntitySchema, UpdateEntitySchema, RelationSchema, CreateRelationSchema, SearchQuerySchema, DateRangeSchema, TagAliasSchema, ExportFormatSchema, BatchCreateEntitiesSchema, BatchCreateRelationsSchema, EntityNamesSchema, DeleteRelationsSchema, 
+// Zod schemas - Observations
+AddObservationInputSchema, AddObservationsInputSchema, DeleteObservationInputSchema, DeleteObservationsInputSchema, 
+// Zod schemas - Archive
+ArchiveCriteriaSchema, 
+// Zod schemas - Saved Search
+SavedSearchInputSchema, SavedSearchUpdateSchema, 
+// Zod schemas - Import/Export
+ImportFormatSchema, ExtendedExportFormatSchema, MergeStrategySchema, ExportFilterSchema, 
+// Zod schemas - Search
+OptionalTagsSchema, OptionalEntityNamesSchema, 
+// Zod helpers
+formatZodErrors, validateWithSchema, validateSafe, validateArrayWithSchema, 
+// Manual validation functions
+validateEntity, validateRelation, validateImportance, validateTags, } from './schemas.js';
+// ==================== Formatters ====================
+// Consolidated from: responseFormatter.ts, paginationUtils.ts
+export { 
+// Response formatting
+formatToolResponse, formatTextResponse, formatRawResponse, formatErrorResponse, 
+// Pagination utilities
+validatePagination, applyPagination, paginateArray, getPaginationMeta, } from './formatters.js';
+// ==================== Entity Utilities ====================
+// Consolidated from: entityUtils.ts, tagUtils.ts, dateUtils.ts, filterUtils.ts, pathUtils.ts
+export { 
+// Hash functions (Phase 12 Sprint 1)
+fnv1aHash, 
+// Entity lookup
+findEntityByName, findEntitiesByNames, entityExists, getEntityIndex, removeEntityByName, getEntityNameSet, groupEntitiesByType, touchEntity, 
+// Tag utilities
+normalizeTag, normalizeTags, hasMatchingTag, hasAllTags, filterByTags, addUniqueTags, removeTags, 
+// Date utilities
+isWithinDateRange, parseDateRange, isValidISODate, getCurrentTimestamp, 
+// Filter utilities
+isWithinImportanceRange, filterByImportance, filterByCreatedDate, filterByModifiedDate, filterByEntityType, entityPassesFilters, 
+// Path utilities
+validateFilePath, defaultMemoryPath, ensureMemoryFilePath, 
+// Security utilities
+sanitizeObject, escapeCsvFormula, } from './entityUtils.js';
+// ==================== Parallel Utilities ====================
+export { parallelMap, parallelFilter, getPoolStats, shutdownParallelUtils, } from './parallelUtils.js';
+// ==================== Task Scheduler ====================
+export { 
+// Types and Enums
+TaskPriority, TaskStatus, 
+// Task Queue
+TaskQueue, 
+// Batch Processing
+batchProcess, rateLimitedProcess, withRetry, 
+// Rate Limiting
+debounce, throttle, } from './taskScheduler.js';
+// ==================== Operation Utilities (Phase 9B) ====================
+export { checkCancellation, createProgressReporter, createProgress, executeWithPhases, processBatchesWithProgress, } from './operationUtils.js';
+// ==================== Worker Pool Manager (Phase 12 Sprint 2) ====================
+export { WorkerPoolManager, getWorkerPoolManager, } from './WorkerPoolManager.js';
+// ==================== Batch Processor (Phase 12 Sprint 2) ====================
+export { BatchProcessor, processBatch, processWithRetry, chunkArray, parallelLimit, mapParallel, filterParallel, } from './BatchProcessor.js';
+// ==================== Memory Monitor (Phase 12 Sprint 6) ====================
+export { MemoryMonitor, globalMemoryMonitor, } from './MemoryMonitor.js';
+//# sourceMappingURL=index.js.map