@hashgraphonline/conversational-agent 0.1.215 → 0.1.217

package/dist/esm/index29.js.map

@@ -1 +1 @@
-{"version":3,"file":"index29.js","sources":["../../src/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n * \n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState = 'active' | 'expired' | 'cleanup_pending' | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType = 'text' | 'json' | 'html' | 'markdown' | 'binary' | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource = 'mcp_tool' | 'user_upload' | 'agent_generated' | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n  \n  /** MIME type of the original content */\n  mimeType?: string;\n  \n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n  \n  /** When the content was originally stored */\n  createdAt: Date;\n  \n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n  \n  /** Source that created this content reference */\n  source: ContentSource;\n  \n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n  \n  /** Original filename or suggested name for the content */\n  fileName?: string;\n  \n  /** Number of times this reference has been resolved */\n  accessCount: number;\n  \n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n  \n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough \n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n  \n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n  \n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n  \n  /** Essential metadata for agent decision-making */\n  metadata: Pick<ContentMetadata, 'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'>;\n  \n  /** When this reference was created */\n  createdAt: Date;\n  \n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n  \n  /** The resolved content if successful */\n  content?: Buffer;\n  \n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n  \n  /** Error message if resolution failed */\n  error?: string;\n  \n  /** Specific error type for targeted error handling */\n  errorType?: 'not_found' | 'expired' | 'corrupted' | 'access_denied' | 'system_error';\n  \n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n  \n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n  \n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n  \n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n  \n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n  \n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n  \n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n  \n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n  \n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n    \n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024,\n  maxAgeMs: 60 * 60 * 1000,\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024,\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000,\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 },\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 },\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 },\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 }\n  }\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n  \n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n  \n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n  \n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n  \n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n  \n  /** Average content size in bytes */\n  averageContentSize: number;\n  \n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n  \n  /** Storage utilization percentage */\n  storageUtilization: number;\n  \n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n    \n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n    \n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<ContentMetadata, 'createdAt' | 'lastAccessedAt' | 'accessCount'>\n  ): Promise<ContentReference>;\n  \n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(referenceId: ReferenceId): Promise<ReferenceResolutionResult>;\n  \n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n  \n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n  \n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n  \n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}"],"names":[],"mappings":"AAiKO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"index29.js","sources":["../../src/forms/FormEngine.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { ZodError, z } from 'zod';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport { FormGenerator } from './form-generator';\nimport { isFormValidatable } from '@hashgraphonline/standards-agent-kit';\nimport type { FormMessage, FormSubmission } from './types';\n\n/**\n * Tool execution result with optional form requirement\n */\nexport interface ToolExecutionResult {\n  success: boolean;\n  output: string;\n  metadata?: Record<string, unknown>;\n  requiresForm?: boolean;\n  formMessage?: FormMessage;\n  error?: string;\n}\n\n/**\n * Context for form generation operations\n */\nexport interface FormGenerationContext {\n  tool: StructuredTool;\n  input: unknown;\n  sessionId?: string;\n  userId?: string;\n  missingFields?: Set<string>;\n}\n\n/**\n * FormEngine handles all form generation and validation logic\n */\nexport class FormEngine {\n  private formGenerator: FormGenerator;\n  private logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.formGenerator = new FormGenerator();\n    this.logger = logger || new Logger({ module: 'FormEngine' });\n  }\n\n  /**\n   * Generate a form for a tool with the given input\n   */\n  async generateForm(\n    toolName: string,\n    tool: StructuredTool,\n    input: unknown,\n    context?: Partial<FormGenerationContext>\n  ): Promise<FormMessage | null> {\n    const fullContext: FormGenerationContext = {\n      tool,\n      input,\n      ...context\n    };\n\n    try {\n      if (isFormValidatable(tool)) {\n        return await this.generateFormValidatableForm(tool, input, fullContext);\n      }\n\n      if (input instanceof ZodError) {\n        return await this.generateErrorBasedForm(tool, input, fullContext);\n      }\n\n      if (this.hasRenderConfig(tool)) {\n        return await this.generateRenderConfigForm(tool, input, fullContext);\n      }\n\n      if (this.isZodObject(tool.schema)) {\n        return await this.generateSchemaBasedForm(tool, input, fullContext);\n      }\n\n      return null;\n    } catch (error) {\n      this.logger.error(`Failed to generate form for tool: ${toolName}`, {\n        error: error instanceof Error ? error.message : String(error)\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Process a form submission\n   */\n  async processSubmission(\n    submission: FormSubmission,\n    context?: {\n      originalInput?: Record<string, unknown>;\n      schema?: unknown;\n    }\n  ): Promise<Record<string, unknown>> {\n    this.validateSubmission(submission);\n    \n    const baseToolInput = this.extractBaseToolInput(context);\n    const submissionData = this.extractSubmissionData(submission);\n    \n    return this.mergeInputData(baseToolInput, submissionData);\n  }\n\n  /**\n   * Check if a tool requires form generation based on input\n   */\n  shouldGenerateForm(tool: StructuredTool, input: unknown): boolean {\n    const inputRecord = input as Record<string, unknown>;\n    if (inputRecord?.__fromForm === true || inputRecord?.renderForm === false) {\n      return false;\n    }\n\n    if (isFormValidatable(tool)) {\n      try {\n        const formValidatableTool = tool as {\n          shouldGenerateForm: (input: unknown) => boolean;\n        };\n        return formValidatableTool.shouldGenerateForm(input);\n      } catch (error) {\n        this.logger.error(`Error calling shouldGenerateForm() on ${tool.name}:`, error);\n        return false;\n      }\n    }\n\n    const validation = this.validateInput(tool, input);\n    return !validation.isValid;\n  }\n\n  /**\n   * Generate form from error context\n   */\n  async generateFormFromError(\n    error: ZodError,\n    toolName: string,\n    toolSchema: z.ZodSchema,\n    originalPrompt: string\n  ): Promise<FormMessage> {\n    return this.formGenerator.generateFormFromError(\n      error,\n      toolSchema as z.ZodType<unknown, z.ZodTypeDef, unknown>,\n      toolName,\n      originalPrompt\n    );\n  }\n\n  /**\n   * Generate form for FormValidatable tools\n   */\n  private async generateFormValidatableForm(\n    tool: StructuredTool,\n    input: unknown,\n    _context: FormGenerationContext\n  ): Promise<FormMessage> {\n    const { schemaToUse, isFocusedSchema } = this.resolveFormSchema(tool);\n    const missingFields = this.determineMissingFields(tool, input, schemaToUse, isFocusedSchema);\n    \n    return this.generateFormWithSchema(tool, input, schemaToUse, missingFields);\n  }\n\n  /**\n   * Generate form based on schema validation\n   */\n  private async generateSchemaBasedForm(\n    tool: StructuredTool,\n    input: unknown,\n    context: FormGenerationContext\n  ): Promise<FormMessage> {\n    const schema = tool.schema;\n\n    const formMessage = await this.formGenerator.generateFormFromSchema(\n      schema as z.ZodType<unknown, z.ZodTypeDef, unknown>,\n      input,\n      {\n        toolName: tool.name,\n        toolDescription: tool.description\n      },\n      context.missingFields\n    );\n\n    if (this.isZodObject(schema)) {\n      try {\n        const { jsonSchema, uiSchema } = this.formGenerator.generateJsonSchemaForm(\n          schema,\n          input as Record<string, unknown> | undefined,\n          context.missingFields || new Set()\n        );\n        formMessage.jsonSchema = jsonSchema;\n        formMessage.uiSchema = uiSchema;\n      } catch (error) {\n        this.logger.warn('Failed to generate JSON Schema for schema-based tool:', error);\n      }\n    }\n\n    formMessage.partialInput = input;\n    return formMessage;\n  }\n\n  /**\n   * Generate form based on render config\n   */\n  private async generateRenderConfigForm(\n    tool: StructuredTool,\n    input: unknown,\n    context: FormGenerationContext\n  ): Promise<FormMessage> {\n    const schema = tool.schema;\n    const renderConfig = this.extractRenderConfig(tool);\n\n    const formMessage = await this.formGenerator.generateFormFromSchema(\n      schema as z.ZodType<unknown, z.ZodTypeDef, unknown>,\n      input,\n      {\n        toolName: tool.name,\n        toolDescription: tool.description\n      },\n      context.missingFields\n    );\n\n    if (renderConfig) {\n      formMessage.formConfig.metadata = {\n        ...formMessage.formConfig.metadata,\n        renderConfig\n      };\n    }\n    \n    formMessage.partialInput = input;\n    return formMessage;\n  }\n\n  /**\n   * Generate form from Zod validation error\n   */\n  private async generateErrorBasedForm(\n    tool: StructuredTool,\n    error: ZodError,\n    context: FormGenerationContext\n  ): Promise<FormMessage> {\n    return this.formGenerator.generateFormFromError(\n      error,\n      tool.schema as z.ZodType<unknown, z.ZodTypeDef, unknown>,\n      tool.name,\n      context.input ? String(context.input) : ''\n    );\n  }\n\n  /**\n   * Validate input against tool schema\n   */\n  private validateInput(\n    tool: StructuredTool,\n    input: unknown\n  ): { isValid: boolean; errors?: string[] } {\n    try {\n      const zodSchema = tool.schema as z.ZodType<unknown, z.ZodTypeDef, unknown>;\n      zodSchema.parse(input);\n      return { isValid: true };\n    } catch (error) {\n      if (error instanceof ZodError) {\n        const errors = error.errors.map(\n          (err) => `${err.path.join('.')}: ${err.message}`\n        );\n        return { isValid: false, errors };\n      }\n      return { isValid: false, errors: ['Validation failed'] };\n    }\n  }\n\n  /**\n   * Check if schema is ZodObject\n   */\n  private isZodObject(schema: unknown): schema is z.ZodObject<z.ZodRawShape> {\n    if (!schema || typeof schema !== 'object') {\n      return false;\n    }\n    const candidate = schema as { _def?: { typeName?: string } };\n    return Boolean(candidate._def && candidate._def.typeName === 'ZodObject');\n  }\n\n  /**\n   * Check if tool has render configuration\n   */\n  private hasRenderConfig(tool: StructuredTool): boolean {\n    const schema = tool.schema as Record<string, unknown>;\n    return !!(schema && schema._renderConfig);\n  }\n\n  /**\n   * Extract render configuration from tool\n   */\n  private extractRenderConfig(tool: StructuredTool): Record<string, unknown> | undefined {\n    const schema = tool.schema as Record<string, unknown>;\n    return schema?._renderConfig as Record<string, unknown> | undefined;\n  }\n\n  /**\n   * Resolve form schema for FormValidatable tools\n   */\n  private resolveFormSchema(tool: StructuredTool): { \n    schemaToUse: z.ZodSchema; \n    isFocusedSchema: boolean \n  } {\n    const formValidatableTool = tool as {\n      getFormSchema?: () => z.ZodSchema | null;\n    };\n    \n    if (formValidatableTool.getFormSchema) {\n      const focusedSchema = formValidatableTool.getFormSchema();\n      if (focusedSchema) {\n        return { schemaToUse: focusedSchema, isFocusedSchema: true };\n      }\n    }\n    \n    return { schemaToUse: tool.schema as z.ZodSchema, isFocusedSchema: false };\n  }\n\n  /**\n   * Determine missing fields for form generation\n   */\n  private determineMissingFields(\n    tool: StructuredTool,\n    input: unknown,\n    _schema: z.ZodSchema,\n    _isFocusedSchema: boolean\n  ): Set<string> {\n    const missingFields = new Set<string>();\n    \n    if (!input || typeof input !== 'object') {\n      return missingFields;\n    }\n    \n    const inputRecord = input as Record<string, unknown>;\n    const formValidatableTool = tool as {\n      isFieldEmpty?: (fieldName: string, value: unknown) => boolean;\n      getEssentialFields?: () => string[];\n    };\n    \n    if (formValidatableTool.getEssentialFields) {\n      const essentialFields = formValidatableTool.getEssentialFields();\n      for (const field of essentialFields) {\n        if (!(field in inputRecord) || \n            (formValidatableTool.isFieldEmpty && \n             formValidatableTool.isFieldEmpty(field, inputRecord[field]))) {\n          missingFields.add(field);\n        }\n      }\n    }\n    \n    return missingFields;\n  }\n\n  /**\n   * Generate form with resolved schema\n   */\n  private async generateFormWithSchema(\n    tool: StructuredTool,\n    input: unknown,\n    schema: z.ZodSchema,\n    missingFields: Set<string>\n  ): Promise<FormMessage> {\n    const formMessage = await this.formGenerator.generateFormFromSchema(\n      schema as z.ZodType<unknown, z.ZodTypeDef, unknown>,\n      input,\n      {\n        toolName: tool.name,\n        toolDescription: tool.description\n      },\n      missingFields\n    );\n    \n    if (this.isZodObject(schema)) {\n      try {\n        const { jsonSchema, uiSchema } = this.formGenerator.generateJsonSchemaForm(\n          schema,\n          input as Record<string, unknown> | undefined,\n          missingFields\n        );\n        formMessage.jsonSchema = jsonSchema;\n        formMessage.uiSchema = uiSchema;\n      } catch (error) {\n        this.logger.warn('Failed to generate JSON Schema:', error);\n      }\n    }\n    \n    formMessage.partialInput = input;\n    return formMessage;\n  }\n\n  /**\n   * Validate form submission\n   */\n  private validateSubmission(submission: FormSubmission): void {\n    if (!submission.toolName) {\n      throw new Error('Tool name is required in form submission');\n    }\n    if (!submission.parameters) {\n      throw new Error('Parameters are required in form submission');\n    }\n  }\n\n  /**\n   * Extract base tool input from context\n   */\n  private extractBaseToolInput(context?: {\n    originalInput?: Record<string, unknown>;\n  }): Record<string, unknown> {\n    return context?.originalInput || {};\n  }\n\n  /**\n   * Extract submission data\n   */\n  private extractSubmissionData(submission: FormSubmission): Record<string, unknown> {\n    return {\n      ...submission.parameters,\n      __fromForm: true\n    };\n  }\n\n  /**\n   * Merge input data\n   */\n  private mergeInputData(\n    baseInput: Record<string, unknown>,\n    submissionData: Record<string, unknown>\n  ): Record<string, unknown> {\n    return {\n      ...baseInput,\n      ...submissionData\n    };\n  }\n\n  /**\n   * Get registered strategies\n   */\n  getRegisteredStrategies(): string[] {\n    return ['FormValidatable', 'SchemaBased', 'RenderConfig', 'ZodErrorBased'];\n  }\n\n  /**\n   * Get registered middleware\n   */\n  getRegisteredMiddleware(): string[] {\n    return ['FormSubmissionValidator'];\n  }\n}"],"names":[],"mappings":"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"}

package/dist/esm/index30.js

@@ -1,95 +1,159 @@
-import { TransferTransaction, AccountId, Hbar } from "@hashgraph/sdk";
-import BigNumber from "bignumber.js";
-import { BaseServiceBuilder } from "hedera-agent-kit";
-class AccountBuilder extends BaseServiceBuilder {
-  constructor(hederaKit) {
-    super(hederaKit);
+class FieldTypeRegistry {
+  constructor() {
+    this.patterns = /* @__PURE__ */ new Map();
+    this.initializeDefaultPatterns();
   }
   /**
-   * Transfers HBAR between accounts with proper decimal handling
+   * Get singleton instance
    */
-  transferHbar(params, isUserInitiated = true) {
-    this.clearNotes();
-    const transaction = new TransferTransaction();
-    if (!params.transfers || params.transfers.length === 0) {
-      throw new Error("HbarTransferParams must include at least one transfer.");
+  static getInstance() {
+    if (!FieldTypeRegistry.instance) {
+      FieldTypeRegistry.instance = new FieldTypeRegistry();
     }
-    let netZeroInTinybars = new BigNumber(0);
-    let userTransferProcessedForScheduling = false;
-    if (isUserInitiated && this.kit.userAccountId && this.kit.operationalMode === "provideBytes" && params.transfers.length === 1) {
-      const receiverTransfer = params.transfers[0];
-      const amountValue = typeof receiverTransfer.amount === "string" || typeof receiverTransfer.amount === "number" ? receiverTransfer.amount : receiverTransfer.amount.toString();
-      const amountBigNum = new BigNumber(amountValue);
-      if (amountBigNum.isPositive()) {
-        const recipientAccountId = typeof receiverTransfer.accountId === "string" ? AccountId.fromString(receiverTransfer.accountId) : receiverTransfer.accountId;
-        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
-        const sdkHbarAmount = Hbar.fromString(roundedAmount);
-        this.logger.info(
-          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${this.kit.userAccountId} to ${recipientAccountId.toString()}`
-        );
-        this.addNote(
-          `Configured HBAR transfer from your account (${this.kit.userAccountId}) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`
-        );
-        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);
-        transaction.addHbarTransfer(
-          AccountId.fromString(this.kit.userAccountId),
-          sdkHbarAmount.negated()
+    return FieldTypeRegistry.instance;
+  }
+  /**
+   * Initialize default field type patterns
+   */
+  initializeDefaultPatterns() {
+    this.register("numeric-supply-exact", {
+      pattern: ["maxSupply", "minSupply", "totalSupply"],
+      type: "number",
+      priority: 15
+    });
+    this.register("numeric-supply", {
+      pattern: /supply$/i,
+      type: "number",
+      priority: 10
+    });
+    this.register("numeric-amounts", {
+      pattern: /(?:amount|quantity|count|total|sum|value)$/i,
+      type: "number",
+      priority: 8
+    });
+    this.register("numeric-time", {
+      pattern: /(?:period|duration|time|timeout|delay|interval)$/i,
+      type: "number",
+      priority: 8
+    });
+    this.register("numeric-limits", {
+      pattern: /(?:limit|max|min|threshold|size|length)$/i,
+      type: "number",
+      priority: 7
+    });
+    this.register("currency", {
+      pattern: /(?:price|cost|fee|payment|balance|amount)$/i,
+      type: "currency",
+      priority: 9
+    });
+    this.register("percentage", {
+      pattern: /(?:percent|percentage|rate|ratio)$/i,
+      type: "percentage",
+      priority: 9
+    });
+    this.register("boolean-freeze", {
+      pattern: ["freezeDefault", "freeze"],
+      type: "checkbox",
+      priority: 10
+    });
+    this.register("boolean-flags", {
+      pattern: /(?:is|has|can|should|enable|disable|active|default|allow)(?:[A-Z]|$)/,
+      type: "checkbox",
+      priority: 8
+    });
+    this.register("textarea", {
+      pattern: /(?:memo|description|notes|comment|message|content|body|text)$/i,
+      type: "textarea",
+      priority: 8
+    });
+    this.register("array-fees", {
+      pattern: ["customFees", "fees"],
+      type: "array",
+      priority: 10
+    });
+    this.register("array-general", {
+      pattern: /(?:list|items|array|collection)$/i,
+      type: "array",
+      priority: 7
+    });
+    this.register("object-options", {
+      pattern: ["metaOptions", "options"],
+      type: "object",
+      priority: 10
+    });
+    this.register("object-config", {
+      pattern: /(?:config|settings|configuration|metadata|data|info)$/i,
+      type: "object",
+      priority: 7
+    });
+    this.register("select-type", {
+      pattern: /(?:type|kind|category|status|state|mode)$/i,
+      type: "select",
+      priority: 7
+    });
+  }
+  /**
+   * Register a field type pattern
+   */
+  register(key, pattern) {
+    this.patterns.set(key, pattern);
+  }
+  /**
+   * Unregister a field type pattern
+   */
+  unregister(key) {
+    return this.patterns.delete(key);
+  }
+  /**
+   * Detect field type based on field name
+   */
+  detectType(fieldName) {
+    const matches = [];
+    for (const pattern of this.patterns.values()) {
+      let isMatch = false;
+      if (Array.isArray(pattern.pattern)) {
+        isMatch = pattern.pattern.some(
+          (p) => fieldName === p || fieldName.toLowerCase() === p.toLowerCase()
         );
-        userTransferProcessedForScheduling = true;
+      } else if (pattern.pattern instanceof RegExp) {
+        isMatch = pattern.pattern.test(fieldName);
       }
-    }
-    if (!userTransferProcessedForScheduling) {
-      const processedTransfers = [];
-      for (const transferInput of params.transfers) {
-        const accountId = typeof transferInput.accountId === "string" ? AccountId.fromString(transferInput.accountId) : transferInput.accountId;
-        const amountValue = typeof transferInput.amount === "string" || typeof transferInput.amount === "number" ? transferInput.amount : transferInput.amount.toString();
-        const amountBigNum = new BigNumber(amountValue);
-        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
-        this.logger.info(
-          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`
-        );
-        const sdkHbarAmount = Hbar.fromString(roundedAmount);
-        processedTransfers.push({
-          accountId,
-          amount: amountBigNum,
-          hbar: sdkHbarAmount
+      if (isMatch) {
+        matches.push({
+          type: pattern.type,
+          priority: pattern.priority ?? 5
         });
-        const tinybarsContribution = sdkHbarAmount.toTinybars();
-        netZeroInTinybars = netZeroInTinybars.plus(
-          tinybarsContribution.toString()
-        );
-      }
-      if (!netZeroInTinybars.isZero()) {
-        this.logger.warn(
-          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`
-        );
-        if (processedTransfers.length > 0) {
-          const lastTransfer = processedTransfers[processedTransfers.length - 1];
-          const adjustment = netZeroInTinybars.dividedBy(-1e8);
-          const adjustedAmount = lastTransfer.amount.plus(adjustment);
-          const adjustedRounded = adjustedAmount.toFixed(8, BigNumber.ROUND_DOWN);
-          lastTransfer.hbar = Hbar.fromString(adjustedRounded);
-          this.logger.info(
-            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`
-          );
-        }
-      }
-      for (const transfer of processedTransfers) {
-        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);
       }
     }
-    if (typeof params.memo !== "undefined") {
-      if (params.memo === null) {
-        this.logger.warn("Received null for memo in transferHbar.");
-      } else {
-        transaction.setTransactionMemo(params.memo);
-      }
+    if (matches.length > 0) {
+      matches.sort((a, b) => b.priority - a.priority);
+      return matches[0].type;
     }
-    this.setCurrentTransaction(transaction);
-    return this;
+    return null;
+  }
+  /**
+   * Get all registered patterns
+   */
+  getPatterns() {
+    return new Map(this.patterns);
+  }
+  /**
+   * Clear all patterns
+   */
+  clear() {
+    this.patterns.clear();
+  }
+  /**
+   * Reset to default patterns
+   */
+  reset() {
+    this.clear();
+    this.initializeDefaultPatterns();
   }
 }
+const fieldTypeRegistry = FieldTypeRegistry.getInstance();
 export {
-  AccountBuilder
+  FieldTypeRegistry,
+  fieldTypeRegistry
 };
 //# sourceMappingURL=index30.js.map

package/dist/esm/index30.js.map

@@ -1 +1 @@
-{"version":3,"file":"index30.js","sources":["../../src/plugins/hbar/AccountBuilder.ts"],"sourcesContent":["import {\n  AccountId,\n  Hbar,\n  TransferTransaction,\n} from '@hashgraph/sdk';\nimport BigNumber from 'bignumber.js';\nimport { HederaAgentKit, BaseServiceBuilder } from 'hedera-agent-kit';\nimport { HbarTransferParams } from './types';\n\n/**\n * Custom AccountBuilder that properly handles HBAR decimal conversion\n */\nexport class AccountBuilder extends BaseServiceBuilder {\n  constructor(hederaKit: HederaAgentKit) {\n    super(hederaKit);\n  }\n\n  /**\n   * Transfers HBAR between accounts with proper decimal handling\n   */\n  public transferHbar(\n    params: HbarTransferParams,\n    isUserInitiated: boolean = true\n  ): this {\n    this.clearNotes();\n    const transaction = new TransferTransaction();\n    \n    if (!params.transfers || params.transfers.length === 0) {\n      throw new Error('HbarTransferParams must include at least one transfer.');\n    }\n\n    let netZeroInTinybars = new BigNumber(0);\n    let userTransferProcessedForScheduling = false;\n\n    if (\n      isUserInitiated &&\n      this.kit.userAccountId &&\n      (this.kit.operationalMode as string) === 'provideBytes' &&\n      params.transfers.length === 1\n    ) {\n      const receiverTransfer = params.transfers[0];\n      const amountValue =\n        typeof receiverTransfer.amount === 'string' ||\n        typeof receiverTransfer.amount === 'number'\n          ? receiverTransfer.amount\n          : receiverTransfer.amount.toString();\n\n      const amountBigNum = new BigNumber(amountValue);\n\n      if (amountBigNum.isPositive()) {\n        const recipientAccountId =\n          typeof receiverTransfer.accountId === 'string'\n            ? AccountId.fromString(receiverTransfer.accountId)\n            : receiverTransfer.accountId;\n\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n\n        this.logger.info(\n          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${\n            this.kit.userAccountId\n          } to ${recipientAccountId.toString()}`\n        );\n        \n        this.addNote(\n          `Configured HBAR transfer from your account (${\n            this.kit.userAccountId\n          }) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`\n        );\n\n        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);\n        transaction.addHbarTransfer(\n          AccountId.fromString(this.kit.userAccountId),\n          sdkHbarAmount.negated()\n        );\n\n        userTransferProcessedForScheduling = true;\n      }\n    }\n\n    if (!userTransferProcessedForScheduling) {\n      const processedTransfers: Array<{\n        accountId: AccountId;\n        amount: BigNumber;\n        hbar: Hbar;\n      }> = [];\n      \n      for (const transferInput of params.transfers) {\n        const accountId =\n          typeof transferInput.accountId === 'string'\n            ? AccountId.fromString(transferInput.accountId)\n            : transferInput.accountId;\n\n        const amountValue =\n          typeof transferInput.amount === 'string' ||\n          typeof transferInput.amount === 'number'\n            ? transferInput.amount\n            : transferInput.amount.toString();\n\n        const amountBigNum = new BigNumber(amountValue);\n        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);\n        \n        this.logger.info(\n          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`\n        );\n\n        const sdkHbarAmount = Hbar.fromString(roundedAmount);\n        processedTransfers.push({\n          accountId,\n          amount: amountBigNum,\n          hbar: sdkHbarAmount\n        });\n\n        const tinybarsContribution = sdkHbarAmount.toTinybars();\n        netZeroInTinybars = netZeroInTinybars.plus(\n          tinybarsContribution.toString()\n        );\n      }\n\n      if (!netZeroInTinybars.isZero()) {\n        this.logger.warn(\n          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`\n        );\n        \n        if (processedTransfers.length > 0) {\n          const lastTransfer = processedTransfers[processedTransfers.length - 1];\n          const adjustment = netZeroInTinybars.dividedBy(-100000000);\n          const adjustedAmount = lastTransfer.amount.plus(adjustment);\n          const adjustedRounded = adjustedAmount.toFixed(8, BigNumber.ROUND_DOWN);\n          lastTransfer.hbar = Hbar.fromString(adjustedRounded);\n          \n          this.logger.info(\n            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`\n          );\n        }\n      }\n      \n      for (const transfer of processedTransfers) {\n        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);\n      }\n    }\n\n    if (typeof params.memo !== 'undefined') {\n      if (params.memo === null) {\n        this.logger.warn('Received null for memo in transferHbar.');\n      } else {\n        transaction.setTransactionMemo(params.memo);\n      }\n    }\n\n    this.setCurrentTransaction(transaction);\n    return this;\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"index30.js","sources":["../../src/forms/field-type-registry.ts"],"sourcesContent":["/**\n * Registry for field type detection patterns\n * @module FieldTypeRegistry\n */\n\nimport type { FormFieldType } from './types';\n\n/**\n * Pattern-based field type detection rule\n */\nexport interface FieldTypePattern {\n  pattern: RegExp | string[];\n  type: FormFieldType;\n  priority?: number;\n}\n\n/**\n * Registry for managing field type detection patterns\n */\nexport class FieldTypeRegistry {\n  private static instance: FieldTypeRegistry;\n  private patterns: Map<string, FieldTypePattern> = new Map();\n  \n  private constructor() {\n    this.initializeDefaultPatterns();\n  }\n  \n  /**\n   * Get singleton instance\n   */\n  static getInstance(): FieldTypeRegistry {\n    if (!FieldTypeRegistry.instance) {\n      FieldTypeRegistry.instance = new FieldTypeRegistry();\n    }\n    return FieldTypeRegistry.instance;\n  }\n  \n  /**\n   * Initialize default field type patterns\n   */\n  private initializeDefaultPatterns(): void {\n    this.register('numeric-supply-exact', {\n      pattern: ['maxSupply', 'minSupply', 'totalSupply'],\n      type: 'number',\n      priority: 15\n    });\n    \n    this.register('numeric-supply', {\n      pattern: /supply$/i,\n      type: 'number',\n      priority: 10\n    });\n    \n    this.register('numeric-amounts', {\n      pattern: /(?:amount|quantity|count|total|sum|value)$/i,\n      type: 'number',\n      priority: 8\n    });\n    \n    this.register('numeric-time', {\n      pattern: /(?:period|duration|time|timeout|delay|interval)$/i,\n      type: 'number',\n      priority: 8\n    });\n    \n    this.register('numeric-limits', {\n      pattern: /(?:limit|max|min|threshold|size|length)$/i,\n      type: 'number',\n      priority: 7\n    });\n    \n    this.register('currency', {\n      pattern: /(?:price|cost|fee|payment|balance|amount)$/i,\n      type: 'currency',\n      priority: 9\n    });\n    \n    this.register('percentage', {\n      pattern: /(?:percent|percentage|rate|ratio)$/i,\n      type: 'percentage',\n      priority: 9\n    });\n    \n    this.register('boolean-freeze', {\n      pattern: ['freezeDefault', 'freeze'],\n      type: 'checkbox',\n      priority: 10\n    });\n    \n    this.register('boolean-flags', {\n      pattern: /(?:is|has|can|should|enable|disable|active|default|allow)(?:[A-Z]|$)/,\n      type: 'checkbox',\n      priority: 8\n    });\n    \n    this.register('textarea', {\n      pattern: /(?:memo|description|notes|comment|message|content|body|text)$/i,\n      type: 'textarea',\n      priority: 8\n    });\n    \n    this.register('array-fees', {\n      pattern: ['customFees', 'fees'],\n      type: 'array',\n      priority: 10\n    });\n    \n    this.register('array-general', {\n      pattern: /(?:list|items|array|collection)$/i,\n      type: 'array',\n      priority: 7\n    });\n    \n    this.register('object-options', {\n      pattern: ['metaOptions', 'options'],\n      type: 'object',\n      priority: 10\n    });\n    \n    this.register('object-config', {\n      pattern: /(?:config|settings|configuration|metadata|data|info)$/i,\n      type: 'object',\n      priority: 7\n    });\n    \n    this.register('select-type', {\n      pattern: /(?:type|kind|category|status|state|mode)$/i,\n      type: 'select',\n      priority: 7\n    });\n  }\n  \n  /**\n   * Register a field type pattern\n   */\n  register(key: string, pattern: FieldTypePattern): void {\n    this.patterns.set(key, pattern);\n  }\n  \n  /**\n   * Unregister a field type pattern\n   */\n  unregister(key: string): boolean {\n    return this.patterns.delete(key);\n  }\n  \n  /**\n   * Detect field type based on field name\n   */\n  detectType(fieldName: string): FormFieldType | null {\n    const matches: Array<{ type: FormFieldType; priority: number }> = [];\n    \n    for (const pattern of this.patterns.values()) {\n      let isMatch = false;\n      \n      if (Array.isArray(pattern.pattern)) {\n        isMatch = pattern.pattern.some(p => \n          fieldName === p || fieldName.toLowerCase() === p.toLowerCase()\n        );\n      } else if (pattern.pattern instanceof RegExp) {\n        isMatch = pattern.pattern.test(fieldName);\n      }\n      \n      if (isMatch) {\n        matches.push({\n          type: pattern.type,\n          priority: pattern.priority ?? 5\n        });\n      }\n    }\n    \n    if (matches.length > 0) {\n      matches.sort((a, b) => b.priority - a.priority);\n      return matches[0].type;\n    }\n    \n    return null;\n  }\n  \n  /**\n   * Get all registered patterns\n   */\n  getPatterns(): Map<string, FieldTypePattern> {\n    return new Map(this.patterns);\n  }\n  \n  /**\n   * Clear all patterns\n   */\n  clear(): void {\n    this.patterns.clear();\n  }\n  \n  /**\n   * Reset to default patterns\n   */\n  reset(): void {\n    this.clear();\n    this.initializeDefaultPatterns();\n  }\n}\n\nexport const fieldTypeRegistry = FieldTypeRegistry.getInstance();"],"names":[],"mappings":"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"}

package/dist/esm/index31.js

@@ -1,12 +1,68 @@
-import { AgentExecutor } from "langchain/agents";
-import { Logger } from "@hashgraphonline/standards-sdk";
-class ContentAwareAgentExecutor extends AgentExecutor {
-  constructor(config) {
-    super(config);
-    this.logger = new Logger({ module: "ContentAwareAgentExecutor" });
+import { createHash } from "crypto";
+class ReferenceIdGenerator {
+  /**
+   * Generate a content-based reference ID using SHA-256 hashing
+   * 
+   * @param content The content to generate a reference ID for
+   * @returns Deterministic reference ID based on content hash
+   */
+  static generateId(content) {
+    const hash = createHash("sha256");
+    hash.update(content);
+    return hash.digest("hex");
+  }
+  /**
+   * Validate that a string is a properly formatted reference ID
+   * 
+   * @param id The ID to validate
+   * @returns true if the ID is valid format
+   */
+  static isValidReferenceId(id) {
+    if (!id || typeof id !== "string") {
+      return false;
+    }
+    if (id.length !== 64) {
+      return false;
+    }
+    return /^[a-f0-9]+$/.test(id);
+  }
+  /**
+   * Extract reference ID from ref:// format
+   * 
+   * @param input Input string that may contain a reference ID
+   * @returns Extracted reference ID or null if not found
+   */
+  static extractReferenceId(input) {
+    if (!input || typeof input !== "string") {
+      return null;
+    }
+    const refFormatMatch = input.match(/^ref:\/\/([a-f0-9]{64})$/);
+    if (refFormatMatch) {
+      return refFormatMatch[1];
+    }
+    return this.isValidReferenceId(input) ? input : null;
+  }
+  /**
+   * Format a reference ID in the standard ref:// format
+   * 
+   * @param referenceId The reference ID to format
+   * @returns Formatted reference string
+   */
+  static formatReference(referenceId) {
+    return `ref://${referenceId}`;
+  }
+  /**
+   * Generate a test reference ID (for testing purposes only)
+   * 
+   * @param testSeed A test seed to generate a fake but valid ID format
+   * @returns A valid format reference ID for testing
+   */
+  static generateTestId(testSeed) {
+    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);
+    return this.generateId(content);
   }
 }
 export {
-  ContentAwareAgentExecutor
+  ReferenceIdGenerator
 };
 //# sourceMappingURL=index31.js.map

package/dist/esm/index31.js.map

@@ -1 +1 @@
-{"version":3,"file":"index31.js","sources":["../../src/langchain/ContentAwareAgentExecutor.ts"],"sourcesContent":["import { AgentExecutor } from 'langchain/agents';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Custom AgentExecutor that intercepts large tool outputs and converts them to content references\n * before they are sent to the LLM to avoid token limit issues.\n * \n * Note: The content reference conversion is already handled in the MCP adapter,\n * so this class currently just extends AgentExecutor without modifications.\n * We keep it as a placeholder for future enhancements.\n */\nexport class ContentAwareAgentExecutor extends AgentExecutor {\n  private logger: Logger;\n\n  constructor(config: any) {\n    super(config);\n    this.logger = new Logger({ module: 'ContentAwareAgentExecutor' });\n  }\n}"],"names":[],"mappings":";;AAWO,MAAM,kCAAkC,cAAc;AAAA,EAG3D,YAAY,QAAa;AACvB,UAAM,MAAM;AACZ,SAAK,SAAS,IAAI,OAAO,EAAE,QAAQ,6BAA6B;AAAA,EAClE;AACF;"}
+{"version":3,"file":"index31.js","sources":["../../src/memory/ReferenceIdGenerator.ts"],"sourcesContent":["import { createHash } from 'crypto';\nimport { ReferenceId } from '../types/content-reference';\n\n/**\n * Content-based reference ID generator using SHA-256 (HCS-1 style)\n * \n * Generates deterministic reference IDs based on content hashing.\n * Same content always produces the same reference ID.\n */\nexport class ReferenceIdGenerator {\n  /**\n   * Generate a content-based reference ID using SHA-256 hashing\n   * \n   * @param content The content to generate a reference ID for\n   * @returns Deterministic reference ID based on content hash\n   */\n  static generateId(content: Buffer): ReferenceId {\n    const hash = createHash('sha256');\n    hash.update(content);\n    return hash.digest('hex');\n  }\n  \n  /**\n   * Validate that a string is a properly formatted reference ID\n   * \n   * @param id The ID to validate\n   * @returns true if the ID is valid format\n   */\n  static isValidReferenceId(id: string): id is ReferenceId {\n    if (!id || typeof id !== 'string') {\n      return false;\n    }\n    \n    if (id.length !== 64) {\n      return false;\n    }\n    \n    return /^[a-f0-9]+$/.test(id);\n  }\n  \n  /**\n   * Extract reference ID from ref:// format\n   * \n   * @param input Input string that may contain a reference ID\n   * @returns Extracted reference ID or null if not found\n   */\n  static extractReferenceId(input: string): ReferenceId | null {\n    if (!input || typeof input !== 'string') {\n      return null;\n    }\n    \n    const refFormatMatch = input.match(/^ref:\\/\\/([a-f0-9]{64})$/);\n    if (refFormatMatch) {\n      return refFormatMatch[1] as ReferenceId;\n    }\n    \n    return this.isValidReferenceId(input) ? input : null;\n  }\n  \n  /**\n   * Format a reference ID in the standard ref:// format\n   * \n   * @param referenceId The reference ID to format\n   * @returns Formatted reference string\n   */\n  static formatReference(referenceId: ReferenceId): string {\n    return `ref://${referenceId}`;\n  }\n  \n  /**\n   * Generate a test reference ID (for testing purposes only)\n   * \n   * @param testSeed A test seed to generate a fake but valid ID format\n   * @returns A valid format reference ID for testing\n   */\n  static generateTestId(testSeed: string): ReferenceId {\n    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);\n    return this.generateId(content);\n  }\n}"],"names":[],"mappings":";AASO,MAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhC,OAAO,WAAW,SAA8B;AAC9C,UAAM,OAAO,WAAW,QAAQ;AAChC,SAAK,OAAO,OAAO;AACnB,WAAO,KAAK,OAAO,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,IAA+B;AACvD,QAAI,CAAC,MAAM,OAAO,OAAO,UAAU;AACjC,aAAO;AAAA,IACT;AAEA,QAAI,GAAG,WAAW,IAAI;AACpB,aAAO;AAAA,IACT;AAEA,WAAO,cAAc,KAAK,EAAE;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,OAAmC;AAC3D,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,aAAO;AAAA,IACT;AAEA,UAAM,iBAAiB,MAAM,MAAM,0BAA0B;AAC7D,QAAI,gBAAgB;AAClB,aAAO,eAAe,CAAC;AAAA,IACzB;AAEA,WAAO,KAAK,mBAAmB,KAAK,IAAI,QAAQ;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,gBAAgB,aAAkC;AACvD,WAAO,SAAS,WAAW;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,eAAe,UAA+B;AACnD,UAAM,UAAU,OAAO,KAAK,QAAQ,QAAQ,IAAI,KAAK,IAAA,CAAK,EAAE;AAC5D,WAAO,KAAK,WAAW,OAAO;AAAA,EAChC;AACF;"}