Project Files

src

adapters

sites

RedditAdapter.ts

redditExtractor.ts

SiteAdapter.ts

SiteAdapterRegistry.ts

cache

WebpageCache.ts

config

sources

EnvironmentConfigurationSource.ts

LMStudioConfigurationSource.ts

PrioritySlotEditor.ts

Config.ts

configSchematics.ts

ConfigurationService.ts

IConfigurationSource.ts

index.ts

README.md

engine

budget

SearchPayloadLimiter.ts

normalization

CanonicalSearchResultBuilder.ts

HtmlCleaner.ts

TextNormalizer.ts

UrlValidator.ts

SearchEngine.ts

extractors

htmlExtractor.ts

imageExtractor.ts

jsonLdExtractor.ts

openGraphExtractor.ts

pdfExtractor.ts

rssExtractor.ts

http

HTTPClient.ts

index.ts

image_search

engine

ImageSearchEngine.ts

presentation

ImagePresentationFormatter.ts

providers

BaseImageProvider.ts

BingImageProvider.ts

DuckDuckGoImageProvider.ts

ImageProviderFactory.ts

ImageProviderRegistry.ts

PexelsImageProvider.ts

SerpApiImageProvider.ts

utils

CacheManager.ts

ImageDownloader.ts

index.ts

models.ts

models

errors.ts

index.ts

README.md

SearchResult.ts

prepend

ImageContextDetector.ts

TimeDependencyDetector.ts

VisionContextDetector.ts

providers

types

InternalProviderResult.ts

BaseProvider.ts

BraveProvider.ts

DuckDuckGoProvider.ts

DummyProvider.ts

ExaProvider.ts

FirecrawlSearchProvider.ts

index.ts

ISyncableProviderInstance.ts

ProviderInstanceRegistry.ts

ProviderRegistry.ts

SerperProvider.ts

TavilyProvider.ts

title

HeuristicTitleRules.ts

index.ts

NativeTitlePollutionPreventer.ts

tools

getCurrentTime.ts

inspectImages.ts

readWebpage.ts

searchImages.ts

searchWeb.ts

types

index.ts

pdf-parse.d.ts

provider.ts

README.md

search.ts

utils

DateTimeFormatter.ts

index.ts

KeyManager.ts

Logger.ts

README.md

bootstrap.ts

index.ts

PrependInstructionFormatter.ts

toolsProvider.ts

.env.example

.lmsignore

icon.png

manifest.json

package-lock.json

package.json

README.md

thumbnail.png

tsconfig.json

src / image_search / presentation / ImagePresentationFormatter.ts

import { LocalImage } from "../models";

/**
 * Dedicated presentation formatter for image search results.
 * Formats relative Markdown image strings for LM Studio native tool returns.
 * Mapped from Daniel Sig's working LM Studio image presentation contract.
 */
export class ImagePresentationFormatter {
  /**
   * Format local images as an array of relative Markdown image strings for LM Studio tool returns.
   * Matches Daniel Sig's LM Studio-native image presentation contract:
   * `["![Title](img_filename.jpg)", ...]`
   *
   * @param localImages Array of LocalImage objects.
   * @param displayLimit Maximum number of images to format (default: 3).
   * @returns Array of relative Markdown image strings.
   */
  public static formatMarkdownImageArray(
    localImages: LocalImage[],
    displayLimit?: number
  ): string[] {
    if (!localImages || localImages.length === 0) {
      return [];
    }

    const displayImages =
      displayLimit !== undefined && displayLimit > 0
        ? localImages.slice(0, displayLimit)
        : localImages;
    return displayImages.map((img) => {
      const titleText = img.title && img.title.trim() ? img.title.trim() : "Image";
      const safeTitle = titleText
        .replace(/\\/g, "\\\\")
        .replace(/\[/g, "\\[")
        .replace(/\]/g, "\\]")
        .replace(/\s+/g, " ")
        .trim();

      return `![${safeTitle}](${img.localFilename})`;
    });
  }
}

browse

browse