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 / utils / DateTimeFormatter.ts

/**
 * Formats the user's current local date, time, and timezone into a natural-language context message.
 * Evaluated fresh from the operating system on every prompt preprocessing turn.
 *
 * Example output:
 * "User's current date is Sunday, July 26, 2026, 9:19 PM IST (Asia/Kolkata). Use this as the present and not your training cutoff date."
 *
 * @param now Optional Date instance for testing (defaults to new Date()).
 */
export function formatCurrentDateTimeContext(now: Date = new Date()): string {
  const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";

  const dateStr = now.toLocaleDateString("en-US", {
    weekday: "long",
    year: "numeric",
    month: "long",
    day: "numeric",
  });

  const timeStr = now.toLocaleTimeString("en-US", {
    hour: "numeric",
    minute: "2-digit",
    hour12: true,
    timeZoneName: "short",
  });

  return `User's real-time date is ${dateStr}, ${timeStr} (${timeZone}). Treat this as the current date and time when interpreting relative expressions such as "today", "yesterday", "tomorrow", "this week", and "latest".`;
}

browse

browse