@hashgraphonline/conversational-agent 0.2.1 → 0.2.101

package/dist/cjs/services/attachment-processor.d.ts

@@ -0,0 +1,41 @@
+import { ContentStoreManager as PackageContentStoreManager } from './content-store-manager';
+
+export interface AttachmentData {
+    name: string;
+    data: string;
+    type: string;
+    size: number;
+}
+type ContentStoreManager = PackageContentStoreManager;
+/**
+ * Utility for processing file attachments and content references
+ */
+export declare class AttachmentProcessor {
+    private logger;
+    constructor();
+    /**
+     * Process attachments and create content references
+     */
+    processAttachments(content: string, attachments: AttachmentData[], contentStoreManager?: ContentStoreManager): Promise<string>;
+    /**
+     * Process attachments using content store manager
+     */
+    private processWithContentStore;
+    /**
+     * Process attachments with simple file references
+     */
+    private processWithSimpleReferences;
+    /**
+     * Create inline reference for small files
+     */
+    private createInlineReference;
+    /**
+     * Create formatted file list
+     */
+    private createFileList;
+    /**
+     * Format file size for display
+     */
+    private formatFileSize;
+}
+export {};

package/dist/cjs/services/index.d.ts

@@ -1,3 +1,5 @@
 export * from './entity-resolver';
 export * from './content-store-manager';
 export * from './formatters';
+export * from './parameter-service';
+export * from './attachment-processor';

package/dist/cjs/services/parameter-service.d.ts

@@ -0,0 +1,43 @@
+import { NetworkType } from '@hashgraphonline/standards-sdk';
+import { FormatConverterRegistry } from './formatters';
+import { EntityAssociation } from '../memory/smart-memory-manager';
+
+/**
+ * Service for processing tool parameters and applying entity format conversions
+ */
+export declare class ParameterService {
+    private logger;
+    private formatConverterRegistry;
+    private networkType;
+    constructor(formatConverterRegistry: FormatConverterRegistry, networkType: NetworkType);
+    /**
+     * Unified preprocessing entrypoint (DRY):
+     * - Optional AI-driven resolution via provided entityResolver
+     * - Deterministic post-pass for safe format enforcement
+     */
+    preprocessParameters(toolName: string, parameters: Record<string, unknown>, entities?: EntityAssociation[], options?: {
+        entityResolver?: {
+            resolveReferences: (message: string, entities: EntityAssociation[]) => Promise<string>;
+        };
+        sessionId?: string;
+        preferences?: Record<string, string>;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Attach unified preprocessing callback directly to the agent.
+     */
+    attachToAgent(agent: unknown, deps?: {
+        getSessionId?: () => string | null;
+        getEntities?: (sessionId: string | null) => Promise<EntityAssociation[]>;
+        entityResolver?: {
+            resolveReferences: (message: string, entities: EntityAssociation[]) => Promise<string>;
+        };
+    }): void;
+    /**
+     * Preprocess tool parameters by applying format conversions based on tool's entity resolution preferences
+     */
+    preprocessToolParameters(toolName: string, parameters: Record<string, unknown>, entities?: EntityAssociation[], sessionId?: string): Promise<Record<string, unknown>>;
+    /**
+     * Convert entity references in a parameter value based on tool preferences
+     */
+    convertParameterEntities(parameterValue: string, entities: EntityAssociation[], preferences?: Record<string, string>): Promise<string>;
+}

package/dist/cjs/tools/entity-resolver-tool.d.ts

@@ -1,5 +1,7 @@
 import { StructuredTool } from '@langchain/core/tools';
 import { z } from 'zod';
+import { ChatOpenAI } from '@langchain/openai';
+import { ChatAnthropic } from '@langchain/anthropic';
 
 declare const ResolveEntitiesSchema: z.ZodObject<{
     message: z.ZodString;
@@ -75,7 +77,7 @@ export declare class ResolveEntitiesTool extends StructuredTool {
         }[];
     }>;
     private llm;
-    constructor(apiKey: string, modelName?: string);
+    constructor(llm: ChatOpenAI | ChatAnthropic);
     _call(input: z.infer<typeof ResolveEntitiesSchema>): Promise<string>;
     private groupEntitiesByType;
     private buildEntityContext;
@@ -94,10 +96,10 @@ export declare class ExtractEntitiesTool extends StructuredTool {
         userMessage: string;
     }>;
     private llm;
-    constructor(apiKey: string, modelName?: string);
+    constructor(llm: ChatOpenAI | ChatAnthropic);
     _call(input: z.infer<typeof ExtractEntitiesSchema>): Promise<string>;
 }
-export declare function createEntityTools(apiKey: string, modelName?: string): {
+export declare function createEntityTools(llm: ChatOpenAI | ChatAnthropic): {
     resolveEntities: ResolveEntitiesTool;
     extractEntities: ExtractEntitiesTool;
 };

package/dist/esm/index.js

@@ -26,12 +26,15 @@ import { FormatConverterRegistry } from "./index25.js";
 import { EntityFormat } from "./index26.js";
 import { TopicIdToHrlConverter } from "./index27.js";
 import { StringNormalizationConverter } from "./index28.js";
-import { FormAwareAgentExecutor } from "./index29.js";
-import { FormValidatingToolWrapper, wrapToolWithFormValidation } from "./index30.js";
-import { LangChainAgent } from "./index31.js";
-import { ExtractEntitiesTool, ResolveEntitiesTool, createEntityTools } from "./index32.js";
-import { ResponseFormatter } from "./index33.js";
+import { ParameterService } from "./index29.js";
+import { AttachmentProcessor } from "./index30.js";
+import { FormAwareAgentExecutor } from "./index31.js";
+import { FormValidatingToolWrapper, wrapToolWithFormValidation } from "./index32.js";
+import { LangChainAgent } from "./index33.js";
+import { ExtractEntitiesTool, ResolveEntitiesTool, createEntityTools } from "./index34.js";
+import { ResponseFormatter } from "./index35.js";
 export {
+  AttachmentProcessor,
   BaseAgent,
   ContentStorage,
   ContentStoreManager,
@@ -56,6 +59,7 @@ export {
   MCPServers,
   MemoryWindow,
   HCS10Plugin2 as OpenConvAIPlugin,
+  ParameterService,
   ReferenceIdGenerator,
   ResolveEntitiesTool,
   ResponseFormatter,

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/index10.js

@@ -3,8 +3,8 @@ import { extractRenderConfigs, generateFieldOrdering } from "@hashgraphonline/st
 import { Logger } from "@hashgraphonline/standards-sdk";
 import { fieldTypeRegistry } from "./index12.js";
 import { fieldGuidanceRegistry } from "./index13.js";
-import "./index37.js";
-import { FIELD_PRIORITIES } from "./index38.js";
+import "./index40.js";
+import { FIELD_PRIORITIES } from "./index44.js";
 function isZodObjectSchema(schema) {
   return typeof schema === "object" && schema !== null && "shape" in schema;
 }

package/dist/esm/index21.js

@@ -1,5 +1,5 @@
 import { ReferenceIdGenerator } from "./index22.js";
-import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index39.js";
+import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index43.js";
 const _ContentStorage = class _ContentStorage {
   constructor(maxStorage = _ContentStorage.DEFAULT_MAX_STORAGE, referenceConfig) {
     this.messages = [];

package/dist/esm/index23.js

@@ -1,9 +1,9 @@
 import { ChatOpenAI } from "@langchain/openai";
 import { Logger } from "@hashgraphonline/standards-sdk";
-import { ENTITY_PATTERNS } from "./index37.js";
+import { ENTITY_PATTERNS } from "./index40.js";
 import "hedera-agent-kit";
 import "@hashgraphonline/standards-agent-kit";
-import "./index34.js";
+import "./index36.js";
 import "@langchain/core/tools";
 import "zod";
 import "./index6.js";
@@ -22,7 +22,7 @@ import "./index21.js";
 import "crypto";
 import { EntityFormat } from "./index26.js";
 import "./index28.js";
-import "./index32.js";
+import "./index34.js";
 class EntityResolver {
   constructor(config) {
     this.llm = new ChatOpenAI({

package/dist/esm/index24.js

@@ -94,8 +94,20 @@ class ContentStoreManager {
       return;
     }
     try {
-      await ContentStoreService.setInstance(this.adapter);
-      ContentResolverRegistry.register(this.resolver);
+      if (ContentStoreService && typeof ContentStoreService.setInstance === "function") {
+        await ContentStoreService.setInstance(
+          this.adapter
+        );
+      } else {
+        this.logger.warn("ContentStoreService.setInstance is unavailable; skipping registration");
+      }
+      if (ContentResolverRegistry && typeof ContentResolverRegistry.register === "function") {
+        ContentResolverRegistry.register(
+          this.resolver
+        );
+      } else {
+        this.logger.warn("ContentResolverRegistry.register is unavailable; skipping registration");
+      }
       this.isRegistered = true;
       this.logger.info(
         "ContentStoreManager initialized and registered for cross-package access"
@@ -155,8 +167,12 @@ class ContentStoreManager {
   async dispose() {
     if (this.isRegistered) {
       this.contentStorage.dispose();
-      ContentStoreService.dispose();
-      ContentResolverRegistry.unregister();
+      if (ContentStoreService && typeof ContentStoreService.dispose === "function") {
+        ContentStoreService.dispose();
+      }
+      if (ContentResolverRegistry && typeof ContentResolverRegistry.unregister === "function") {
+        ContentResolverRegistry.unregister();
+      }
       this.isRegistered = false;
       this.logger.info("ContentStoreManager disposed and unregistered");
     }

package/dist/esm/index24.js.map

@@ -1 +1 @@
-{"version":3,"file":"index24.js","sources":["../../src/services/content-store-manager.ts"],"sourcesContent":["import { ContentStorage } from '../memory/content-storage';\nimport {\n  ContentStoreService,\n  extractReferenceId,\n  shouldUseReference,\n  ContentResolverRegistry,\n  type ContentStoreInterface,\n  type ContentResolverInterface,\n  type ReferenceResolutionResult,\n} from '@hashgraphonline/standards-sdk';\nimport type {\n  ContentReference,\n  ContentReferenceConfig,\n  ContentReferenceStats,\n} from '../types/content-reference';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Content metadata interface for adapter compatibility\n */\ninterface AdapterContentMetadata {\n  mimeType?: string;\n  fileName?: string;\n  sizeBytes?: number;\n  [key: string]: unknown;\n}\n\n/**\n * Configuration interface for content storage\n */\ninterface ContentStoreConfig {\n  maxSize?: number;\n  enableCompression?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Adapter to make ContentStorage compatible with ContentStoreInterface\n */\nclass ContentStorageAdapter implements ContentStoreInterface {\n  constructor(private storage: ContentStorage) {}\n\n  async storeContent(\n    content: Buffer,\n    metadata: AdapterContentMetadata\n  ): Promise<string> {\n    const storeMetadata = {\n      contentType: 'binary' as const,\n      sizeBytes: content.length,\n      source: 'system' as const,\n      ...metadata,\n    };\n    const contentRef = await this.storage.storeContent(content, storeMetadata);\n    return contentRef.referenceId;\n  }\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    const result = await this.storage.resolveReference(referenceId);\n    if (result.success && result.content) {\n      const response: ReferenceResolutionResult = {\n        content: result.content,\n      };\n      if (result.metadata) {\n        response.metadata = {\n          ...(result.metadata.mimeType !== undefined && {\n            mimeType: result.metadata.mimeType,\n          }),\n          ...(result.metadata.fileName !== undefined && {\n            fileName: result.metadata.fileName,\n          }),\n          originalSize: result.metadata.sizeBytes,\n        };\n      }\n      return response;\n    } else {\n      throw new Error(result.error || 'Reference not found');\n    }\n  }\n\n  async hasReference(referenceId: string): Promise<boolean> {\n    return await this.storage.hasReference(referenceId);\n  }\n\n  async cleanupReference(referenceId: string): Promise<void> {\n    await this.storage.cleanupReference(referenceId);\n  }\n\n  async getStats(): Promise<unknown> {\n    return await this.storage.getStats();\n  }\n\n  async updateConfig(config: ContentStoreConfig): Promise<void> {\n    const referenceConfig = {\n      sizeThresholdBytes: config.maxSize || 10240,\n      enableAutoCleanup: config.enableCompression || true,\n      ...config,\n    };\n    return await this.storage.updateConfig(referenceConfig);\n  }\n\n  async performCleanup(): Promise<void> {\n    await this.storage.performCleanup();\n  }\n\n  async dispose(): Promise<void> {\n    return Promise.resolve(this.storage.dispose());\n  }\n}\n\n/**\n * Content resolver implementation for dependency injection\n */\nclass ContentResolver implements ContentResolverInterface {\n  constructor(private adapter: ContentStorageAdapter) {}\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    return await this.adapter.resolveReference(referenceId);\n  }\n\n  shouldUseReference(content: string | Buffer): boolean {\n    return shouldUseReference(content);\n  }\n\n  extractReferenceId(input: string): string | null {\n    return extractReferenceId(input);\n  }\n}\n\n/**\n * Manages content store lifecycle and cross-package registration\n */\nexport class ContentStoreManager {\n  private contentStorage: ContentStorage;\n  private adapter: ContentStorageAdapter;\n  private resolver: ContentResolver;\n  private logger: Logger;\n  private isRegistered = false;\n\n  constructor(\n    maxMessageStorage: number = 1000,\n    referenceConfig?: Partial<ContentReferenceConfig>,\n    logger?: Logger\n  ) {\n    this.logger = logger || new Logger({ module: 'ContentStoreManager' });\n\n    this.contentStorage = new ContentStorage(\n      maxMessageStorage,\n      referenceConfig\n    );\n    this.adapter = new ContentStorageAdapter(this.contentStorage);\n    this.resolver = new ContentResolver(this.adapter);\n  }\n\n  /**\n   * Initialize and register content storage for cross-package access\n   */\n  async initialize(): Promise<void> {\n    if (this.isRegistered) {\n      this.logger.warn('ContentStoreManager is already initialized');\n      return;\n    }\n\n    try {\n      await ContentStoreService.setInstance(this.adapter);\n      ContentResolverRegistry.register(this.resolver);\n      this.isRegistered = true;\n      this.logger.info(\n        'ContentStoreManager initialized and registered for cross-package access'\n      );\n    } catch (error) {\n      this.logger.error('Failed to initialize ContentStoreManager:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the underlying ContentStorage instance\n   */\n  getContentStorage(): ContentStorage {\n    return this.contentStorage;\n  }\n\n  /**\n   * Get storage statistics\n   */\n  async getStats(): Promise<ContentReferenceStats> {\n    return await this.contentStorage.getStats();\n  }\n\n  /**\n   * Update configuration\n   */\n  async updateConfig(config: Partial<ContentReferenceConfig>): Promise<void> {\n    return await this.contentStorage.updateConfig(config);\n  }\n\n  /**\n   * Perform manual cleanup\n   */\n  async performCleanup(): Promise<{ cleanedUp: number; errors: string[] }> {\n    return await this.contentStorage.performCleanup();\n  }\n\n  /**\n   * Check if content should be stored as reference\n   */\n  shouldUseReference(content: Buffer | string): boolean {\n    return this.contentStorage.shouldUseReference(content);\n  }\n\n  /**\n   * Store content if it's large enough\n   */\n  async storeContentIfLarge(\n    content: Buffer | string,\n    metadata: AdapterContentMetadata\n  ): Promise<ContentReference | null> {\n    const storeMetadata = {\n      source: 'system' as const,\n      contentType: 'binary' as const,\n      ...metadata,\n    };\n    return await this.contentStorage.storeContentIfLarge(\n      content,\n      storeMetadata\n    );\n  }\n\n  /**\n   * Cleanup and unregister\n   */\n  async dispose(): Promise<void> {\n    if (this.isRegistered) {\n      this.contentStorage.dispose();\n      ContentStoreService.dispose();\n      ContentResolverRegistry.unregister();\n      this.isRegistered = false;\n      this.logger.info('ContentStoreManager disposed and unregistered');\n    }\n  }\n\n  /**\n   * Check if the manager is initialized\n   */\n  isInitialized(): boolean {\n    return this.isRegistered;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index24.js","sources":["../../src/services/content-store-manager.ts"],"sourcesContent":["import { ContentStorage } from '../memory/content-storage';\nimport {\n  ContentStoreService,\n  extractReferenceId,\n  shouldUseReference,\n  ContentResolverRegistry,\n  type ContentStoreInterface,\n  type ContentResolverInterface,\n  type ReferenceResolutionResult,\n} from '@hashgraphonline/standards-sdk';\nimport type {\n  ContentReference,\n  ContentReferenceConfig,\n  ContentReferenceStats,\n} from '../types/content-reference';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Content metadata interface for adapter compatibility\n */\ninterface AdapterContentMetadata {\n  mimeType?: string;\n  fileName?: string;\n  sizeBytes?: number;\n  [key: string]: unknown;\n}\n\n/**\n * Configuration interface for content storage\n */\ninterface ContentStoreConfig {\n  maxSize?: number;\n  enableCompression?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Adapter to make ContentStorage compatible with ContentStoreInterface\n */\nclass ContentStorageAdapter implements ContentStoreInterface {\n  constructor(private storage: ContentStorage) {}\n\n  async storeContent(\n    content: Buffer,\n    metadata: AdapterContentMetadata\n  ): Promise<string> {\n    const storeMetadata = {\n      contentType: 'binary' as const,\n      sizeBytes: content.length,\n      source: 'system' as const,\n      ...metadata,\n    };\n    const contentRef = await this.storage.storeContent(content, storeMetadata);\n    return contentRef.referenceId;\n  }\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    const result = await this.storage.resolveReference(referenceId);\n    if (result.success && result.content) {\n      const response: ReferenceResolutionResult = {\n        content: result.content,\n      };\n      if (result.metadata) {\n        response.metadata = {\n          ...(result.metadata.mimeType !== undefined && {\n            mimeType: result.metadata.mimeType,\n          }),\n          ...(result.metadata.fileName !== undefined && {\n            fileName: result.metadata.fileName,\n          }),\n          originalSize: result.metadata.sizeBytes,\n        };\n      }\n      return response;\n    } else {\n      throw new Error(result.error || 'Reference not found');\n    }\n  }\n\n  async hasReference(referenceId: string): Promise<boolean> {\n    return await this.storage.hasReference(referenceId);\n  }\n\n  async cleanupReference(referenceId: string): Promise<void> {\n    await this.storage.cleanupReference(referenceId);\n  }\n\n  async getStats(): Promise<unknown> {\n    return await this.storage.getStats();\n  }\n\n  async updateConfig(config: ContentStoreConfig): Promise<void> {\n    const referenceConfig = {\n      sizeThresholdBytes: config.maxSize || 10240,\n      enableAutoCleanup: config.enableCompression || true,\n      ...config,\n    };\n    return await this.storage.updateConfig(referenceConfig);\n  }\n\n  async performCleanup(): Promise<void> {\n    await this.storage.performCleanup();\n  }\n\n  async dispose(): Promise<void> {\n    return Promise.resolve(this.storage.dispose());\n  }\n}\n\n/**\n * Content resolver implementation for dependency injection\n */\nclass ContentResolver implements ContentResolverInterface {\n  constructor(private adapter: ContentStorageAdapter) {}\n\n  async resolveReference(\n    referenceId: string\n  ): Promise<ReferenceResolutionResult> {\n    return await this.adapter.resolveReference(referenceId);\n  }\n\n  shouldUseReference(content: string | Buffer): boolean {\n    return shouldUseReference(content);\n  }\n\n  extractReferenceId(input: string): string | null {\n    return extractReferenceId(input);\n  }\n}\n\n/**\n * Manages content store lifecycle and cross-package registration\n */\nexport class ContentStoreManager {\n  private contentStorage: ContentStorage;\n  private adapter: ContentStorageAdapter;\n  private resolver: ContentResolver;\n  private logger: Logger;\n  private isRegistered = false;\n\n  constructor(\n    maxMessageStorage: number = 1000,\n    referenceConfig?: Partial<ContentReferenceConfig>,\n    logger?: Logger\n  ) {\n    this.logger = logger || new Logger({ module: 'ContentStoreManager' });\n\n    this.contentStorage = new ContentStorage(\n      maxMessageStorage,\n      referenceConfig\n    );\n    this.adapter = new ContentStorageAdapter(this.contentStorage);\n    this.resolver = new ContentResolver(this.adapter);\n  }\n\n  /**\n   * Initialize and register content storage for cross-package access\n   */\n  async initialize(): Promise<void> {\n    if (this.isRegistered) {\n      this.logger.warn('ContentStoreManager is already initialized');\n      return;\n    }\n\n    try {\n      if (\n        ContentStoreService &&\n        typeof (ContentStoreService as unknown as { setInstance?: Function }).setInstance === 'function'\n      ) {\n        await (ContentStoreService as unknown as { setInstance: (adapter: unknown) => Promise<void> }).setInstance(\n          this.adapter\n        );\n      } else {\n        this.logger.warn('ContentStoreService.setInstance is unavailable; skipping registration');\n      }\n      if (\n        ContentResolverRegistry &&\n        typeof (ContentResolverRegistry as unknown as { register?: Function }).register === 'function'\n      ) {\n        (ContentResolverRegistry as unknown as { register: (resolver: unknown) => void }).register(\n          this.resolver\n        );\n      } else {\n        this.logger.warn('ContentResolverRegistry.register is unavailable; skipping registration');\n      }\n      this.isRegistered = true;\n      this.logger.info(\n        'ContentStoreManager initialized and registered for cross-package access'\n      );\n    } catch (error) {\n      this.logger.error('Failed to initialize ContentStoreManager:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the underlying ContentStorage instance\n   */\n  getContentStorage(): ContentStorage {\n    return this.contentStorage;\n  }\n\n  /**\n   * Get storage statistics\n   */\n  async getStats(): Promise<ContentReferenceStats> {\n    return await this.contentStorage.getStats();\n  }\n\n  /**\n   * Update configuration\n   */\n  async updateConfig(config: Partial<ContentReferenceConfig>): Promise<void> {\n    return await this.contentStorage.updateConfig(config);\n  }\n\n  /**\n   * Perform manual cleanup\n   */\n  async performCleanup(): Promise<{ cleanedUp: number; errors: string[] }> {\n    return await this.contentStorage.performCleanup();\n  }\n\n  /**\n   * Check if content should be stored as reference\n   */\n  shouldUseReference(content: Buffer | string): boolean {\n    return this.contentStorage.shouldUseReference(content);\n  }\n\n  /**\n   * Store content if it's large enough\n   */\n  async storeContentIfLarge(\n    content: Buffer | string,\n    metadata: AdapterContentMetadata\n  ): Promise<ContentReference | null> {\n    const storeMetadata = {\n      source: 'system' as const,\n      contentType: 'binary' as const,\n      ...metadata,\n    };\n    return await this.contentStorage.storeContentIfLarge(\n      content,\n      storeMetadata\n    );\n  }\n\n  /**\n   * Cleanup and unregister\n   */\n  async dispose(): Promise<void> {\n    if (this.isRegistered) {\n      this.contentStorage.dispose();\n      if (\n        ContentStoreService &&\n        typeof (ContentStoreService as unknown as { dispose?: Function }).dispose === 'function'\n      ) {\n        (ContentStoreService as unknown as { dispose: () => void }).dispose();\n      }\n      if (\n        ContentResolverRegistry &&\n        typeof (ContentResolverRegistry as unknown as { unregister?: Function }).unregister === 'function'\n      ) {\n        (ContentResolverRegistry as unknown as { unregister: () => void }).unregister();\n      }\n      this.isRegistered = false;\n      this.logger.info('ContentStoreManager disposed and unregistered');\n    }\n  }\n\n  /**\n   * Check if the manager is initialized\n   */\n  isInitialized(): boolean {\n    return this.isRegistered;\n  }\n}\n"],"names":[],"mappings":";;AAuCA,MAAM,sBAAuD;AAAA,EAC3D,YAAoB,SAAyB;AAAzB,SAAA,UAAA;AAAA,EAA0B;AAAA,EAE9C,MAAM,aACJ,SACA,UACiB;AACjB,UAAM,gBAAgB;AAAA,MACpB,aAAa;AAAA,MACb,WAAW,QAAQ;AAAA,MACnB,QAAQ;AAAA,MACR,GAAG;AAAA,IAAA;AAEL,UAAM,aAAa,MAAM,KAAK,QAAQ,aAAa,SAAS,aAAa;AACzE,WAAO,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,iBACJ,aACoC;AACpC,UAAM,SAAS,MAAM,KAAK,QAAQ,iBAAiB,WAAW;AAC9D,QAAI,OAAO,WAAW,OAAO,SAAS;AACpC,YAAM,WAAsC;AAAA,QAC1C,SAAS,OAAO;AAAA,MAAA;AAElB,UAAI,OAAO,UAAU;AACnB,iBAAS,WAAW;AAAA,UAClB,GAAI,OAAO,SAAS,aAAa,UAAa;AAAA,YAC5C,UAAU,OAAO,SAAS;AAAA,UAAA;AAAA,UAE5B,GAAI,OAAO,SAAS,aAAa,UAAa;AAAA,YAC5C,UAAU,OAAO,SAAS;AAAA,UAAA;AAAA,UAE5B,cAAc,OAAO,SAAS;AAAA,QAAA;AAAA,MAElC;AACA,aAAO;AAAA,IACT,OAAO;AACL,YAAM,IAAI,MAAM,OAAO,SAAS,qBAAqB;AAAA,IACvD;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,aAAuC;AACxD,WAAO,MAAM,KAAK,QAAQ,aAAa,WAAW;AAAA,EACpD;AAAA,EAEA,MAAM,iBAAiB,aAAoC;AACzD,UAAM,KAAK,QAAQ,iBAAiB,WAAW;AAAA,EACjD;AAAA,EAEA,MAAM,WAA6B;AACjC,WAAO,MAAM,KAAK,QAAQ,SAAA;AAAA,EAC5B;AAAA,EAEA,MAAM,aAAa,QAA2C;AAC5D,UAAM,kBAAkB;AAAA,MACtB,oBAAoB,OAAO,WAAW;AAAA,MACtC,mBAAmB,OAAO,qBAAqB;AAAA,MAC/C,GAAG;AAAA,IAAA;AAEL,WAAO,MAAM,KAAK,QAAQ,aAAa,eAAe;AAAA,EACxD;AAAA,EAEA,MAAM,iBAAgC;AACpC,UAAM,KAAK,QAAQ,eAAA;AAAA,EACrB;AAAA,EAEA,MAAM,UAAyB;AAC7B,WAAO,QAAQ,QAAQ,KAAK,QAAQ,SAAS;AAAA,EAC/C;AACF;AAKA,MAAM,gBAAoD;AAAA,EACxD,YAAoB,SAAgC;AAAhC,SAAA,UAAA;AAAA,EAAiC;AAAA,EAErD,MAAM,iBACJ,aACoC;AACpC,WAAO,MAAM,KAAK,QAAQ,iBAAiB,WAAW;AAAA,EACxD;AAAA,EAEA,mBAAmB,SAAmC;AACpD,WAAO,mBAAmB,OAAO;AAAA,EACnC;AAAA,EAEA,mBAAmB,OAA8B;AAC/C,WAAO,mBAAmB,KAAK;AAAA,EACjC;AACF;AAKO,MAAM,oBAAoB;AAAA,EAO/B,YACE,oBAA4B,KAC5B,iBACA,QACA;AANF,SAAQ,eAAe;AAOrB,SAAK,SAAS,UAAU,IAAI,OAAO,EAAE,QAAQ,uBAAuB;AAEpE,SAAK,iBAAiB,IAAI;AAAA,MACxB;AAAA,MACA;AAAA,IAAA;AAEF,SAAK,UAAU,IAAI,sBAAsB,KAAK,cAAc;AAC5D,SAAK,WAAW,IAAI,gBAAgB,KAAK,OAAO;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAA4B;AAChC,QAAI,KAAK,cAAc;AACrB,WAAK,OAAO,KAAK,4CAA4C;AAC7D;AAAA,IACF;AAEA,QAAI;AACF,UACE,uBACA,OAAQ,oBAA8D,gBAAgB,YACtF;AACA,cAAO,oBAAwF;AAAA,UAC7F,KAAK;AAAA,QAAA;AAAA,MAET,OAAO;AACL,aAAK,OAAO,KAAK,uEAAuE;AAAA,MAC1F;AACA,UACE,2BACA,OAAQ,wBAA+D,aAAa,YACpF;AACC,gCAAiF;AAAA,UAChF,KAAK;AAAA,QAAA;AAAA,MAET,OAAO;AACL,aAAK,OAAO,KAAK,wEAAwE;AAAA,MAC3F;AACA,WAAK,eAAe;AACpB,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAAA,IAEJ,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,6CAA6C,KAAK;AACpE,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAA2C;AAC/C,WAAO,MAAM,KAAK,eAAe,SAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAwD;AACzE,WAAO,MAAM,KAAK,eAAe,aAAa,MAAM;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAmE;AACvE,WAAO,MAAM,KAAK,eAAe,eAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,SAAmC;AACpD,WAAO,KAAK,eAAe,mBAAmB,OAAO;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBACJ,SACA,UACkC;AAClC,UAAM,gBAAgB;AAAA,MACpB,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,GAAG;AAAA,IAAA;AAEL,WAAO,MAAM,KAAK,eAAe;AAAA,MAC/B;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAyB;AAC7B,QAAI,KAAK,cAAc;AACrB,WAAK,eAAe,QAAA;AACpB,UACE,uBACA,OAAQ,oBAA0D,YAAY,YAC9E;AACC,4BAA2D,QAAA;AAAA,MAC9D;AACA,UACE,2BACA,OAAQ,wBAAiE,eAAe,YACxF;AACC,gCAAkE,WAAA;AAAA,MACrE;AACA,WAAK,eAAe;AACpB,WAAK,OAAO,KAAK,+CAA+C;AAAA,IAClE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AACF;"}