promptopskit 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-BgVLZ2u5.cjs';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BgVLZ2u5.cjs';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest, b as PromptCompressionResult, c as PromptCompressionSummary } from './types-2hnZmCkH.cjs';
-export { O as OpenAIResponsesRuntimeOptions, d as ProviderInlinePromptSource, e as ProviderPromptInput, f as ProviderPromptLookup, g as ProviderPromptRenderResult, h as RuntimeHistoryCompactionInfo, i as RuntimeHistoryCompactionResult, j as RuntimeHistoryMessage, T as THETOKENCOMPANY_DEFAULT_BASE_URL, k as THETOKENCOMPANY_DEFAULT_MODEL, l as TheTokenCompanyRuntimeOptions, V as ValidationResult, s as summarizePromptCompression } from './types-2hnZmCkH.cjs';
+import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-BkOMklgI.cjs';
+export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BkOMklgI.cjs';
+import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest, b as PromptCompressionResult, c as PromptCompressionSummary } from './types-B4TWRzUY.cjs';
+export { O as OpenAIResponsesRuntimeOptions, d as ProviderInlinePromptSource, e as ProviderPromptInput, f as ProviderPromptLookup, g as ProviderPromptRenderResult, h as RuntimeHistoryCompactionInfo, i as RuntimeHistoryCompactionResult, j as RuntimeHistoryMessage, T as THETOKENCOMPANY_DEFAULT_BASE_URL, k as THETOKENCOMPANY_DEFAULT_MODEL, l as TheTokenCompanyRuntimeOptions, V as ValidationResult, s as summarizePromptCompression } from './types-B4TWRzUY.cjs';
 export { UsageTapAllowed, UsageTapAllowedCapability, UsageTapBeginRequest, UsageTapBeginResponse, UsageTapCallOptions, UsageTapCallResult, UsageTapClient, UsageTapClientConfig, UsageTapEndRequest, UsageTapEndResponse, UsageTapEndUsage, UsageTapEntitlementMode, UsageTapEntitlementOptions, UsageTapErrorPayload, UsageTapInvokeContext, UsageTapInvokeResult, UsageTapProviderRunOptions, UsageTapProviderRunResult, UsageTapReasoningLevel, applyUsageTapEntitlements, beginUsageTapCall, createUsageTapClient, defaultUsageTapErrorMapper, endUsageTapCall, extractAnthropicUsage, extractGeminiUsage, extractOpenAIUsage, runAnthropicWithUsageTap, runGeminiWithUsageTap, runLLMAsAServiceWithUsageTap, runOpenAIWithUsageTap, runOpenRouterWithUsageTap, withUsageTapCall } from './usagetap/index.cjs';
 export { anthropicAdapter } from './providers/anthropic.cjs';
 export { geminiAdapter } from './providers/gemini.cjs';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-BgVLZ2u5.js';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BgVLZ2u5.js';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest, b as PromptCompressionResult, c as PromptCompressionSummary } from './types-DgAT4jSR.js';
-export { O as OpenAIResponsesRuntimeOptions, d as ProviderInlinePromptSource, e as ProviderPromptInput, f as ProviderPromptLookup, g as ProviderPromptRenderResult, h as RuntimeHistoryCompactionInfo, i as RuntimeHistoryCompactionResult, j as RuntimeHistoryMessage, T as THETOKENCOMPANY_DEFAULT_BASE_URL, k as THETOKENCOMPANY_DEFAULT_MODEL, l as TheTokenCompanyRuntimeOptions, V as ValidationResult, s as summarizePromptCompression } from './types-DgAT4jSR.js';
+import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-BkOMklgI.js';
+export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BkOMklgI.js';
+import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest, b as PromptCompressionResult, c as PromptCompressionSummary } from './types-D6VJJo1x.js';
+export { O as OpenAIResponsesRuntimeOptions, d as ProviderInlinePromptSource, e as ProviderPromptInput, f as ProviderPromptLookup, g as ProviderPromptRenderResult, h as RuntimeHistoryCompactionInfo, i as RuntimeHistoryCompactionResult, j as RuntimeHistoryMessage, T as THETOKENCOMPANY_DEFAULT_BASE_URL, k as THETOKENCOMPANY_DEFAULT_MODEL, l as TheTokenCompanyRuntimeOptions, V as ValidationResult, s as summarizePromptCompression } from './types-D6VJJo1x.js';
 export { UsageTapAllowed, UsageTapAllowedCapability, UsageTapBeginRequest, UsageTapBeginResponse, UsageTapCallOptions, UsageTapCallResult, UsageTapClient, UsageTapClientConfig, UsageTapEndRequest, UsageTapEndResponse, UsageTapEndUsage, UsageTapEntitlementMode, UsageTapEntitlementOptions, UsageTapErrorPayload, UsageTapInvokeContext, UsageTapInvokeResult, UsageTapProviderRunOptions, UsageTapProviderRunResult, UsageTapReasoningLevel, applyUsageTapEntitlements, beginUsageTapCall, createUsageTapClient, defaultUsageTapErrorMapper, endUsageTapCall, extractAnthropicUsage, extractGeminiUsage, extractOpenAIUsage, runAnthropicWithUsageTap, runGeminiWithUsageTap, runLLMAsAServiceWithUsageTap, runOpenAIWithUsageTap, runOpenRouterWithUsageTap, withUsageTapCall } from './usagetap/index.js';
 export { anthropicAdapter } from './providers/anthropic.js';
 export { geminiAdapter } from './providers/gemini.js';

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,
   createLLMAsAServiceOpenAIConfig,
   llmasaserviceAdapter
-} from "./chunk-DI7Q4T7A.js";
+} from "./chunk-W6XHGSPJ.js";
 import {
   applyUsageTapEntitlements,
   beginUsageTapCall,
@@ -24,19 +24,19 @@ import {
 } from "./chunk-AGTGIZMR.js";
 import {
   openaiResponsesAdapter
-} from "./chunk-5XH2GROP.js";
+} from "./chunk-E2AIIPQC.js";
 import {
   anthropicAdapter
-} from "./chunk-Z3DPPJNU.js";
+} from "./chunk-Q67E2GGD.js";
 import {
   geminiAdapter
-} from "./chunk-UQLAWU67.js";
+} from "./chunk-FJ3D76IV.js";
 import {
   openrouterAdapter
-} from "./chunk-ZVCKP4EM.js";
+} from "./chunk-AAQNCAVA.js";
 import {
   openaiAdapter
-} from "./chunk-PDVUVZAU.js";
+} from "./chunk-SVNQNMMV.js";
 import {
   DEFAULT_PROMPTS_DIR,
   PromptCache,
@@ -58,14 +58,14 @@ import {
   sanitizeContextVariables,
   summarizePromptCompression,
   withPromptResolutionDefaults
-} from "./chunk-RVAFVWR2.js";
+} from "./chunk-NS6OTKY2.js";
 import {
   PromptAssetOverridesSchema,
   PromptAssetSchema,
   extractSections,
   loadPromptFile,
   parsePrompt
-} from "./chunk-E4GEKWVP.js";
+} from "./chunk-VOXMOGU5.js";
 
 // src/index.ts
 import { resolve } from "path";
@@ -158,6 +158,7 @@ var RISKY_UNBOUNDED_INPUT_NAMES = [
   "body",
   "context"
 ];
+var COMPRESS_MODIFIER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\|\s*compress\s*\}\}/g;
 function validateAsset(asset, frontMatterKeys, filePath) {
   const errors = [];
   const warnings = [];
@@ -239,6 +240,26 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       suggestion: "Declare context.inputs to enable input policy validation."
     });
   }
+  if (asset.compression?.heuristic?.enabled === true && asset.compression.heuristic.json_to_toon !== true) {
+    warnings.push({
+      code: "POK055",
+      message: "Prompt-level heuristic compression is enabled for the full prompt template.",
+      filePath,
+      suggestion: "Prefer per-placeholder compression for bulky context values so instructions, output constraints, and safety conditions are not sentence-selected away."
+    });
+  }
+  const systemHeuristicCompressionVariables = findSystemHeuristicCompressionVariables(
+    asset.sections?.system_instructions,
+    declaredInputsByName
+  );
+  if (systemHeuristicCompressionVariables.length > 0) {
+    warnings.push({
+      code: "POK056",
+      message: `System instructions use heuristic compression for ${formatQuotedList(systemHeuristicCompressionVariables)}.`,
+      filePath,
+      suggestion: "Avoid compressing values inside system instructions; move lossy compression to prompt-template context placeholders when possible."
+    });
+  }
   for (const input of contextInputs) {
     const lowerName = input.name.toLowerCase();
     const inputWarningsEnabled = areContextInputWarningsEnabled(input);
@@ -430,6 +451,26 @@ function findClosestMatch(input, candidates) {
   }
   return best;
 }
+function findSystemHeuristicCompressionVariables(systemInstructions, declaredInputsByName) {
+  if (!systemInstructions) {
+    return [];
+  }
+  const variables = /* @__PURE__ */ new Set();
+  for (const match of systemInstructions.matchAll(COMPRESS_MODIFIER_RE)) {
+    variables.add(match[1]);
+  }
+  for (const variable of extractVariables(systemInstructions)) {
+    const input = declaredInputsByName.get(variable);
+    const heuristic = input?.compression?.heuristic;
+    if (heuristic?.enabled === true && heuristic.json_to_toon !== true) {
+      variables.add(variable);
+    }
+  }
+  return [...variables].sort();
+}
+function formatQuotedList(values) {
+  return values.map((value) => `"${value}"`).join(", ");
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/providers/index.ts","../src/validation/levenshtein.ts","../src/validation/validate.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, join } from 'node:path';\n\nimport { parsePrompt, loadPromptFile } from './parser/index.js';\nimport { resolveIncludes } from './composition/index.js';\nimport { applyOverrides } from './overrides/index.js';\nimport { renderSections } from './renderer/index.js';\nimport { getAdapter } from './providers/index.js';\nimport { validateAsset, validateAssetWithIncludes } from './validation/index.js';\nimport { PromptCache } from './cache.js';\nimport { collectContextSizeWarnings, sanitizeContextVariables } from './context.js';\nimport { compactHistoryForPrompt } from './history.js';\nimport { applyPromptCompressionForRender, summarizePromptCompression } from './compression.js';\nimport {\n  DEFAULT_PROMPTS_DIR,\n  loadPromptAsset,\n  resolveInlinePromptSource,\n  resolvePromptAsset,\n  withPromptResolutionDefaults,\n} from './prompt-resolution.js';\nimport type { PromptAsset, PromptAssetOverrides, ResolvedPromptAsset } from './schema/index.js';\nimport type { ProviderRequest, RuntimeRenderOptions } from './providers/types.js';\nimport type {\n  PromptCompressionResult,\n  PromptCompressionSummary,\n  TheTokenCompanyRuntimeOptions,\n} from './compression.js';\nimport type { PromptValidationResult } from './validation/index.js';\n\n// --- Re-exports ---\nexport type { PromptAsset, ResolvedPromptAsset } from './schema/index.js';\nexport type {\n  ProviderRequest,\n  ProviderPromptRenderResult,\n  RuntimeRenderOptions,\n  RuntimeHistoryCompactionInfo,\n  RuntimeHistoryCompactionResult,\n  RuntimeHistoryMessage,\n  OpenAIResponsesRuntimeOptions,\n  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ValidationResult,\n} from './providers/types.js';\nexport type {\n  PromptCompressionResult,\n  PromptCompressionSummary,\n  TheTokenCompanyRuntimeOptions,\n} from './compression.js';\nexport type { PromptValidationResult, ValidationError } from './validation/index.js';\nexport type { RenderedSections, RenderOptions } from './renderer/index.js';\nexport type { ParseResult } from './parser/index.js';\nexport type { OverrideOptions } from './overrides/index.js';\nexport type {\n  UsageTapAllowed,\n  UsageTapAllowedCapability,\n  UsageTapBeginRequest,\n  UsageTapBeginResponse,\n  UsageTapCallOptions,\n  UsageTapCallResult,\n  UsageTapClient,\n  UsageTapClientConfig,\n  UsageTapEndRequest,\n  UsageTapEndResponse,\n  UsageTapEndUsage,\n  UsageTapEntitlementMode,\n  UsageTapEntitlementOptions,\n  UsageTapErrorPayload,\n  UsageTapInvokeContext,\n  UsageTapInvokeResult,\n  UsageTapProviderRunOptions,\n  UsageTapProviderRunResult,\n  UsageTapReasoningLevel,\n} from './usagetap/index.js';\n\nexport { parsePrompt, loadPromptFile, extractSections } from './parser/index.js';\nexport { interpolate, extractVariables } from './renderer/index.js';\nexport { resolveIncludes } from './composition/index.js';\nexport { applyOverrides } from './overrides/index.js';\nexport { validateAsset, validateAssetWithIncludes } from './validation/index.js';\nexport { getAdapter, openaiAdapter, openaiResponsesAdapter } from './providers/index.js';\nexport { anthropicAdapter } from './providers/anthropic.js';\nexport { geminiAdapter } from './providers/gemini.js';\nexport { openrouterAdapter } from './providers/openrouter.js';\nexport {\n  LLMASASERVICE_BASE_URL,\n  LLMASASERVICE_DEFAULT_MODEL,\n  LLMASASERVICE_RESPONSE_HEADER_NAMES,\n  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,\n  createLLMAsAServiceOpenAIConfig,\n  llmasaserviceAdapter,\n} from './providers/llmasaservice.js';\nexport { PromptAssetSchema, PromptAssetOverridesSchema } from './schema/index.js';\nexport {\n  summarizePromptCompression,\n  THETOKENCOMPANY_DEFAULT_BASE_URL,\n  THETOKENCOMPANY_DEFAULT_MODEL,\n} from './compression.js';\nexport {\n  applyUsageTapEntitlements,\n  beginUsageTapCall,\n  createUsageTapClient,\n  defaultUsageTapErrorMapper,\n  endUsageTapCall,\n  extractAnthropicUsage,\n  extractGeminiUsage,\n  extractOpenAIUsage,\n  runAnthropicWithUsageTap,\n  runGeminiWithUsageTap,\n  runLLMAsAServiceWithUsageTap,\n  runOpenAIWithUsageTap,\n  runOpenRouterWithUsageTap,\n  withUsageTapCall,\n} from './usagetap/index.js';\n\n// --- Config ---\n\nexport interface PromptOpsKitConfig {\n  sourceDir?: string;\n  compiledDir?: string;\n  mode?: 'auto' | 'compiled-only' | 'source-only';\n  cache?: boolean;\n  warnings?: {\n    contextSize?: 'auto' | 'off' | 'result-only' | 'console' | 'console-and-result';\n  };\n}\n\n// --- Render options ---\n\nexport interface RenderPromptOptions {\n  /** Prompt path (no extension), e.g. 'support/reply' */\n  path?: string;\n  /** Inline prompt source string (alternative to path) */\n  source?: string;\n  /** Provider name */\n  provider: string;\n  /** Environment override */\n  environment?: string;\n  /** Tier override */\n  tier?: string;\n  /** Runtime overrides applied after environment and tier */\n  runtime?: Partial<PromptAssetOverrides>;\n  /** Variables for interpolation */\n  variables?: Record<string, string>;\n  /** Optional callback to transform oversized context values before warnings/rendering */\n  onContextOverflow?: RuntimeRenderOptions['onContextOverflow'];\n  /** Conversation history */\n  history?: RuntimeRenderOptions['history'];\n  /** Optional callback to compact history overflow when context.history.max_items is exceeded */\n  onHistoryCompaction?: RuntimeRenderOptions['onHistoryCompaction'];\n  /** Tool registry for resolving tool references */\n  toolRegistry?: Record<string, unknown>;\n  /** Strict mode — fail on missing variables */\n  strict?: boolean;\n  /** OpenAI Responses API-specific request options */\n  openaiResponses?: RuntimeRenderOptions['openaiResponses'];\n  /** TheTokenCompany compression credentials and transport options */\n  theTokenCompany?: RuntimeRenderOptions['theTokenCompany'];\n}\n\n// --- Result ---\n\nexport interface RenderResult {\n  resolved: ResolvedPromptAsset;\n  request?: ProviderRequest;\n  returnMessage?: string;\n  compression?: PromptCompressionResult[];\n  compressionSummary?: PromptCompressionSummary;\n  warnings: string[];\n}\n\nfunction shouldIncludeContextWarningsInResult(\n  policy: NonNullable<PromptOpsKitConfig['warnings']>['contextSize'] | undefined,\n): boolean {\n  return policy === undefined\n    || policy === 'auto'\n    || policy === 'result-only'\n    || policy === 'console-and-result';\n}\n\nfunction shouldLogContextWarnings(\n  policy: NonNullable<PromptOpsKitConfig['warnings']>['contextSize'] | undefined,\n  options: Pick<RenderPromptOptions, 'source'>,\n  mode: PromptOpsKitConfig['mode'],\n): boolean {\n  if (policy === 'off' || policy === 'result-only') {\n    return false;\n  }\n\n  if (policy === 'console' || policy === 'console-and-result') {\n    return true;\n  }\n\n  return Boolean(options.source || mode !== 'compiled-only');\n}\n\nfunction formatContextSizeWarning(\n  asset: ResolvedPromptAsset,\n  warning: { variable: string; maxSize: number; actualSize: number },\n): string {\n  return [\n    'POK030:',\n    `Context variable \"${warning.variable}\" exceeded max_size`,\n    `for prompt \"${asset.id}\"`,\n    `(${warning.actualSize} bytes > ${warning.maxSize} bytes).`,\n  ].join(' ');\n}\n\n// --- Main class ---\n\nexport class PromptOpsKit {\n  private config: Required<Pick<PromptOpsKitConfig, 'sourceDir' | 'mode'>> & PromptOpsKitConfig;\n  private promptCache: PromptCache<PromptAsset>;\n\n  constructor(config: PromptOpsKitConfig) {\n    const resolvedConfig = withPromptResolutionDefaults(config);\n    this.config = {\n      ...resolvedConfig,\n      mode: resolvedConfig.mode ?? 'auto',\n      cache: resolvedConfig.cache ?? true,\n    };\n    this.promptCache = new PromptCache();\n  }\n\n  /**\n   * Load a prompt asset from compiled or source, based on mode.\n   */\n  async loadPrompt(promptPath: string): Promise<PromptAsset> {\n    return loadPromptAsset(promptPath, this.config, this.promptCache);\n  }\n\n  /**\n   * Resolve a prompt: load, resolve includes, apply overrides.\n   */\n  async resolvePrompt(\n    promptPath: string,\n    options: { environment?: string; tier?: string; runtime?: Partial<PromptAssetOverrides> } = {},\n  ): Promise<ResolvedPromptAsset> {\n    return resolvePromptAsset(promptPath, this.config, options, this.promptCache);\n  }\n\n  /**\n   * Render a prompt for a specific provider.\n   */\n  async renderPrompt(options: RenderPromptOptions): Promise<RenderResult> {\n    let resolved: ResolvedPromptAsset;\n\n    if (options.source) {\n      resolved = resolveInlinePromptSource(options.source, {\n        environment: options.environment,\n        tier: options.tier,\n        runtime: options.runtime,\n      });\n    } else if (options.path) {\n      resolved = await this.resolvePrompt(options.path, {\n        environment: options.environment,\n        tier: options.tier,\n        runtime: options.runtime,\n      });\n    } else {\n      throw new Error('Either \"path\" or \"source\" must be provided to renderPrompt()');\n    }\n\n    const adapter = getAdapter(options.provider);\n    const validation = adapter.validate(resolved, {\n      openaiResponses: options.openaiResponses,\n    });\n\n    if (!validation.valid) {\n      throw new Error(\n        `Provider validation failed for \"${options.provider}\":\\n` +\n        validation.errors.map((e) => `  - ${e}`).join('\\n'),\n      );\n    }\n\n    const sanitization = sanitizeContextVariables(resolved, options.variables, {\n      onContextOverflow: options.onContextOverflow,\n    });\n\n    if (sanitization.shortCircuit) {\n      return {\n        resolved,\n        returnMessage: sanitization.shortCircuit.returnMessage,\n        warnings: validation.warnings,\n      };\n    }\n\n    const contextSizeWarnings = collectContextSizeWarnings(resolved, sanitization.variables).map((warning) =>\n      formatContextSizeWarning(resolved, warning),\n    );\n\n    const contextWarningPolicy = this.config.warnings?.contextSize;\n\n    if (contextSizeWarnings.length > 0 && shouldLogContextWarnings(contextWarningPolicy, options, this.config.mode)) {\n      for (const warning of contextSizeWarnings) {\n        console.warn(`[promptopskit] Warning: ${warning}`);\n      }\n    }\n\n    const prepared = await applyPromptCompressionForRender(resolved, {\n      variables: sanitization.variables,\n      history: compactHistoryForPrompt(resolved, {\n        history: options.history,\n        onHistoryCompaction: options.onHistoryCompaction,\n      }),\n      onHistoryCompaction: options.onHistoryCompaction,\n      toolRegistry: options.toolRegistry,\n      strict: options.strict,\n      openaiResponses: options.openaiResponses,\n      theTokenCompany: options.theTokenCompany,\n    });\n    const request = adapter.render(prepared.asset, prepared.runtime);\n    const compressionSummary = prepared.compression.length > 0\n      ? summarizePromptCompression(prepared.compression)\n      : undefined;\n\n    return {\n      resolved,\n      request: prepared.compression.length > 0 || prepared.warnings.length > 0\n        ? {\n          ...request,\n          ...(prepared.compression.length > 0 ? { compression: prepared.compression, compressionSummary } : {}),\n          ...(prepared.warnings.length > 0 ? { warnings: prepared.warnings } : {}),\n        }\n        : request,\n      ...(prepared.compression.length > 0 ? { compression: prepared.compression } : {}),\n      ...(compressionSummary ? { compressionSummary } : {}),\n      warnings: shouldIncludeContextWarningsInResult(contextWarningPolicy)\n        ? [...validation.warnings, ...contextSizeWarnings, ...prepared.warnings]\n        : [...validation.warnings, ...prepared.warnings],\n    };\n  }\n\n  /**\n   * Validate a prompt file.\n   */\n  async validatePrompt(promptPath: string): Promise<PromptValidationResult> {\n    const sourceFile = resolve(this.config.sourceDir, promptPath + '.md');\n\n    try {\n      const asset = await this.loadPrompt(promptPath);\n      return validateAssetWithIncludes(asset, sourceFile);\n    } catch (error) {\n      const validationError = toPromptValidationError(error, sourceFile);\n      if (validationError) {\n        return {\n          valid: false,\n          errors: [validationError],\n          warnings: [],\n        };\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Clear the internal cache.\n   */\n  clearCache(): void {\n    this.promptCache.clear();\n  }\n}\n\n// --- Factory ---\n\nexport function createPromptOpsKit(config: PromptOpsKitConfig = {}): PromptOpsKit {\n  return new PromptOpsKit(config);\n}\n\nfunction toPromptValidationError(error: unknown, filePath: string): PromptValidationResult['errors'][number] | undefined {\n  if (!(error instanceof Error)) {\n    return undefined;\n  }\n\n  const match = error.message.match(/^(POK\\d+):\\s*(.*)$/);\n  if (!match) {\n    return undefined;\n  }\n\n  return {\n    code: match[1],\n    message: match[2],\n    filePath,\n  };\n}\n\n// --- Standalone convenience ---\n\n/**\n * Standalone renderPrompt for quick usage without creating a PromptOpsKit instance.\n * Requires either `source` (inline) or `path` + implicit sourceDir of ./prompts.\n */\nexport async function renderPrompt(\n  options: RenderPromptOptions & {\n    sourceDir?: string;\n    warnings?: PromptOpsKitConfig['warnings'];\n  },\n): Promise<RenderResult> {\n  const kit = createPromptOpsKit({\n    sourceDir: options.sourceDir ?? DEFAULT_PROMPTS_DIR,\n    cache: false,\n    warnings: options.warnings,\n  });\n  return kit.renderPrompt(options);\n}\n","export type {\n  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ProviderRequest,\n  ValidationResult,\n  RuntimeRenderOptions,\n} from './types.js';\nexport { openaiAdapter } from './openai.js';\nexport { openaiResponsesAdapter } from './openai-responses.js';\nexport { anthropicAdapter } from './anthropic.js';\nexport { geminiAdapter } from './gemini.js';\nexport { openrouterAdapter } from './openrouter.js';\nexport {\n  LLMASASERVICE_BASE_URL,\n  LLMASASERVICE_DEFAULT_MODEL,\n  LLMASASERVICE_RESPONSE_HEADER_NAMES,\n  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,\n  createLLMAsAServiceOpenAIConfig,\n  llmasaserviceAdapter,\n} from './llmasaservice.js';\n\nimport type { ProviderAdapter } from './types.js';\nimport { openaiAdapter } from './openai.js';\nimport { openaiResponsesAdapter } from './openai-responses.js';\nimport { anthropicAdapter } from './anthropic.js';\nimport { geminiAdapter } from './gemini.js';\nimport { openrouterAdapter } from './openrouter.js';\nimport { llmasaserviceAdapter } from './llmasaservice.js';\n\nconst adapters: Record<string, ProviderAdapter> = {\n  openai: openaiAdapter,\n  'openai-responses': openaiResponsesAdapter,\n  anthropic: anthropicAdapter,\n  google: geminiAdapter,\n  gemini: geminiAdapter,\n  openrouter: openrouterAdapter,\n  llmasaservice: llmasaserviceAdapter,\n};\n\n/**\n * Get a provider adapter by name.\n */\nexport function getAdapter(provider: string): ProviderAdapter {\n  const adapter = adapters[provider];\n  if (!adapter) {\n    throw new Error(\n      `Unknown provider: \"${provider}\". Supported: ${Object.keys(adapters).join(', ')}`,\n    );\n  }\n  return adapter;\n}\n","/**\n * Compute the Levenshtein distance between two strings.\n * Used for \"did you mean?\" suggestions on unknown fields.\n */\nexport function levenshtein(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n\n  if (m === 0) return n;\n  if (n === 0) return m;\n\n  const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0) as number[]);\n\n  for (let i = 0; i <= m; i++) dp[i][0] = i;\n  for (let j = 0; j <= n; j++) dp[0][j] = j;\n\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      dp[i][j] = Math.min(\n        dp[i - 1][j] + 1,\n        dp[i][j - 1] + 1,\n        dp[i - 1][j - 1] + cost,\n      );\n    }\n  }\n\n  return dp[m][n];\n}\n","import { PromptAssetSchema } from '../schema/index.js';\nimport type { PromptAsset } from '../schema/index.js';\nimport { extractVariables } from '../renderer/index.js';\nimport { resolveIncludes } from '../composition/index.js';\nimport {\n  areContextInputWarningsEnabled,\n  compileContextRegex,\n  getContextInputs,\n} from '../context.js';\nimport { levenshtein } from './levenshtein.js';\n\nexport interface ValidationError {\n  code: string;\n  message: string;\n  filePath?: string;\n  suggestion?: string;\n}\n\nexport interface PromptValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n  warnings: ValidationError[];\n}\n\nconst KNOWN_FRONT_MATTER_KEYS = new Set([\n  'id', 'schema_version', 'description', 'provider', 'model', 'fallback_models',\n  'reasoning', 'sampling', 'response', 'tools', 'mcp', 'context', 'includes',\n  'environments', 'tiers', 'metadata', 'cache', 'compression', 'provider_options', 'raw',\n]);\n\n\n\nfunction collectSchemaKeywords(value: unknown, acc: Set<string>): void {\n  if (!value || typeof value !== 'object') return;\n  if (Array.isArray(value)) {\n    for (const item of value) collectSchemaKeywords(item, acc);\n    return;\n  }\n\n  const record = value as Record<string, unknown>;\n  for (const [key, child] of Object.entries(record)) {\n    acc.add(key);\n    collectSchemaKeywords(child, acc);\n  }\n}\n\nconst RISKY_UNBOUNDED_INPUT_NAMES = [\n  'message',\n  'prompt',\n  'history',\n  'transcript',\n  'document',\n  'content',\n  'input',\n  'body',\n  'context',\n];\n\n/**\n * Validate a parsed prompt asset, returning all errors and warnings.\n */\nexport function validateAsset(\n  asset: PromptAsset,\n  frontMatterKeys?: string[],\n  filePath?: string,\n): PromptValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: ValidationError[] = [];\n\n  // Schema validation\n  const result = PromptAssetSchema.safeParse(asset);\n  if (!result.success) {\n    for (const issue of result.error.issues) {\n      errors.push({\n        code: 'POK001',\n        message: `Schema error at ${issue.path.join('.')}: ${issue.message}`,\n        filePath,\n      });\n    }\n  }\n\n  // Missing id\n  if (!asset.id) {\n    errors.push({\n      code: 'POK002',\n      message: 'Missing required field: \"id\"',\n      filePath,\n    });\n  }\n\n  // Missing body sections\n  if (!asset.sections?.system_instructions && !asset.sections?.prompt_template) {\n    errors.push({\n      code: 'POK003',\n      message: 'Prompt must have at least one body section (System instructions or Prompt template)',\n      filePath,\n    });\n  }\n\n  // Unknown front matter keys with \"did you mean?\"\n  if (frontMatterKeys) {\n    for (const key of frontMatterKeys) {\n      if (!KNOWN_FRONT_MATTER_KEYS.has(key)) {\n        const suggestion = findClosestMatch(key, KNOWN_FRONT_MATTER_KEYS);\n        warnings.push({\n          code: 'POK010',\n          message: `Unknown front matter field: \"${key}\"`,\n          filePath,\n          suggestion: suggestion ? `Did you mean \"${suggestion}\"?` : undefined,\n        });\n      }\n    }\n  }\n\n  // Variable validation: used but not declared\n  const contextInputs = getContextInputs(asset);\n  const declaredInputs = new Set(contextInputs.map((input) => input.name));\n  const declaredInputsByName = new Map(contextInputs.map((input) => [input.name, input]));\n  const usedVars = new Set<string>();\n\n  if (asset.sections?.system_instructions) {\n    for (const v of extractVariables(asset.sections.system_instructions)) {\n      usedVars.add(v);\n    }\n  }\n  if (asset.sections?.prompt_template) {\n    for (const v of extractVariables(asset.sections.prompt_template)) {\n      usedVars.add(v);\n    }\n  }\n\n  for (const v of usedVars) {\n    if (!declaredInputs.has(v)) {\n      warnings.push({\n        code: 'POK011',\n        message: `Variable \"{{ ${v} }}\" is used but not declared in context.inputs`,\n        filePath,\n      });\n    }\n  }\n\n  // Declared but unused\n  for (const v of declaredInputs) {\n    const input = declaredInputsByName.get(v);\n    if (!usedVars.has(v) && input?.optional !== true && areContextInputWarningsEnabled(input ?? {})) {\n      warnings.push({\n        code: 'POK012',\n        message: `Variable \"${v}\" is declared in context.inputs but never used`,\n        filePath,\n      });\n    }\n  }\n\n  if (usedVars.size > 0 && (!asset.context?.inputs || asset.context.inputs.length === 0)) {\n    warnings.push({\n      code: 'POK046',\n      message: `Template uses ${usedVars.size === 1 ? 'a variable' : 'variables'} but context.inputs is not declared.`,\n      filePath,\n      suggestion: 'Declare context.inputs to enable input policy validation.',\n    });\n  }\n\n  // Context regex definitions compile successfully\n  for (const input of contextInputs) {\n    const lowerName = input.name.toLowerCase();\n    const inputWarningsEnabled = areContextInputWarningsEnabled(input);\n\n    if (\n      inputWarningsEnabled\n      && input.max_size === undefined\n      && RISKY_UNBOUNDED_INPUT_NAMES.some((needle) => lowerName.includes(needle))\n    ) {\n      warnings.push({\n        code: 'POK040',\n        message: `Context input \"${input.name}\" has no max_size and appears unbounded.`,\n        filePath,\n        suggestion: 'Add max_size to constrain prompt payload growth.',\n      });\n    }\n\n    if (\n      inputWarningsEnabled\n      && input.optional !== true\n      && input.allow_regex === undefined\n      && input.deny_regex === undefined\n      && input.non_empty === undefined\n      && input.reject_secrets === undefined\n    ) {\n      warnings.push({\n        code: 'POK041',\n        message: `Context input \"${input.name}\" has no input hardening validators.`,\n        filePath,\n        suggestion: 'Consider non_empty/reject_secrets and allow/deny regex validators.',\n      });\n    }\n\n    if (inputWarningsEnabled && input.trim !== undefined && input.trim !== false && input.max_size === undefined) {\n      warnings.push({\n        code: 'POK014',\n        message: `Context input \"${input.name}\" sets trim but has no max_size; trim-to-budget will be skipped.`,\n        filePath,\n      });\n    }\n\n    const checks: Array<{\n      regex: NonNullable<typeof input.allow_regex>;\n      kind: 'allow_regex' | 'deny_regex';\n    }> = [];\n\n    if (input.allow_regex) checks.push({ regex: input.allow_regex, kind: 'allow_regex' });\n    if (input.deny_regex) checks.push({ regex: input.deny_regex, kind: 'deny_regex' });\n\n    for (const check of checks) {\n      try {\n        compileContextRegex(check.regex, {\n          promptId: asset.id,\n          variable: input.name,\n          field: check.kind,\n        });\n      } catch (error) {\n        const reason = error instanceof Error ? error.message.replace(/^POK013:\\s*/, '') : String(error);\n        errors.push({\n          code: 'POK013',\n          message: reason,\n          filePath,\n        });\n      }\n    }\n  }\n\n\n  if (asset.response?.schema && asset.provider) {\n    const keywords = new Set<string>();\n    collectSchemaKeywords(asset.response.schema, keywords);\n\n    const openAIUnsupported = ['patternProperties', 'unevaluatedProperties', '$dynamicRef'];\n    const geminiUnsupported = ['patternProperties', '$dynamicRef', 'dependentSchemas'];\n    const anthropicCaution = ['if', 'then', 'else'];\n\n    const checks: Array<{ provider: string[]; unsupported: string[]; code: string }> = [\n      { provider: ['openai', 'openai-responses', 'openrouter', 'llmasaservice'], unsupported: openAIUnsupported, code: 'POK052' },\n      { provider: ['gemini', 'google'], unsupported: geminiUnsupported, code: 'POK053' },\n      { provider: ['anthropic'], unsupported: anthropicCaution, code: 'POK054' },\n    ];\n\n    for (const check of checks) {\n      if (!check.provider.includes(asset.provider)) continue;\n      const hits = check.unsupported.filter((k) => keywords.has(k));\n      if (hits.length > 0) {\n        warnings.push({\n          code: check.code,\n          message: `response.schema includes provider-sensitive JSON Schema keywords for \"${asset.provider}\": ${hits.join(', ')}`,\n          filePath,\n          suggestion: 'Validate schema compatibility with your provider docs or simplify the schema dialect.',\n        });\n      }\n    }\n  }\n\n  if (asset.provider) {\n    let providerCache: unknown;\n    let cacheSuggestionField: string | undefined;\n\n    switch (asset.provider) {\n      case 'openai':\n        providerCache = asset.cache?.openai;\n        cacheSuggestionField = 'cache.openai';\n        break;\n      case 'anthropic':\n        providerCache = asset.cache?.anthropic;\n        cacheSuggestionField = 'cache.anthropic';\n        break;\n      case 'gemini':\n      case 'google':\n        providerCache = asset.cache?.gemini ?? asset.cache?.google;\n        cacheSuggestionField = 'cache.gemini';\n        break;\n      default:\n        break;\n    }\n\n    if (cacheSuggestionField && providerCache === undefined) {\n      warnings.push({\n        code: 'POK042',\n        message: `Provider \"${asset.provider}\" has no provider-specific cache settings.`,\n        filePath,\n        suggestion: `Consider configuring ${cacheSuggestionField} for better cache-hit behavior.`,\n      });\n    }\n\n    if (!asset.model) {\n      warnings.push({\n        code: 'POK044',\n        message: `Provider \"${asset.provider}\" is configured without a model.`,\n        filePath,\n        suggestion: 'Set model in prompt or defaults to avoid adapter-time errors.',\n      });\n    }\n  }\n\n  if (\n    asset.cache?.gemini?.cached_content\n    && asset.cache.google?.cached_content\n    && asset.cache.gemini.cached_content !== asset.cache.google.cached_content\n  ) {\n    warnings.push({\n      code: 'POK043',\n      message: 'cache.gemini.cached_content and cache.google.cached_content are both set to different values.',\n      filePath,\n      suggestion: 'Use one canonical value; Gemini prefers cache.gemini.cached_content.',\n    });\n  }\n\n  for (const [envName, overrides] of Object.entries(asset.environments ?? {})) {\n    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {\n      warnings.push({\n        code: 'POK045',\n        message: `Environment \"${envName}\" does not override cache while prompt-level cache is defined.`,\n        filePath,\n        suggestion: 'Confirm cache strategy is intentionally shared across environments.',\n      });\n    }\n  }\n\n  for (const [tierName, overrides] of Object.entries(asset.tiers ?? {})) {\n    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {\n      warnings.push({\n        code: 'POK045',\n        message: `Tier \"${tierName}\" does not override cache while prompt-level cache is defined.`,\n        filePath,\n        suggestion: 'Confirm cache strategy is intentionally shared across tiers.',\n      });\n    }\n  }\n\n  for (const tool of asset.tools ?? []) {\n    if (isRecord(tool)) {\n      if (!tool.description) {\n        warnings.push({\n          code: 'POK047',\n          message: `Inline tool \"${tool.name}\" is missing a description.`,\n          filePath,\n          suggestion: 'Add description to improve model tool-selection quality.',\n        });\n      }\n      if (!tool.input_schema) {\n        warnings.push({\n          code: 'POK047',\n          message: `Inline tool \"${tool.name}\" is missing input_schema.`,\n          filePath,\n          suggestion: 'Add input_schema so tool inputs are strongly typed.',\n        });\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Validate a prompt asset including its include graph.\n * Catches missing include files, circular includes, and parse errors in included files.\n */\nexport async function validateAssetWithIncludes(\n  asset: PromptAsset,\n  filePath: string,\n  frontMatterKeys?: string[],\n): Promise<PromptValidationResult> {\n  // Run standard validation first\n  const result = validateAsset(asset, frontMatterKeys, filePath);\n\n  // Validate includes\n  if (asset.includes && asset.includes.length > 0) {\n    try {\n      await resolveIncludes(asset, filePath);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const isCircular = message.includes('Circular include');\n      result.errors.push({\n        code: isCircular ? 'POK021' : 'POK020',\n        message: isCircular\n          ? `Circular include detected: ${message}`\n          : `Include resolution failed: ${message}`,\n        filePath,\n      });\n      result.valid = false;\n    }\n  }\n\n  return result;\n}\n\nfunction findClosestMatch(input: string, candidates: Set<string>): string | undefined {\n  let best: string | undefined;\n  let bestDist = Infinity;\n\n  for (const candidate of candidates) {\n    const dist = levenshtein(input.toLowerCase(), candidate.toLowerCase());\n    if (dist < bestDist && dist <= 3) {\n      bestDist = dist;\n      best = candidate;\n    }\n  }\n\n  return best;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/providers/index.ts","../src/validation/levenshtein.ts","../src/validation/validate.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, join } from 'node:path';\n\nimport { parsePrompt, loadPromptFile } from './parser/index.js';\nimport { resolveIncludes } from './composition/index.js';\nimport { applyOverrides } from './overrides/index.js';\nimport { renderSections } from './renderer/index.js';\nimport { getAdapter } from './providers/index.js';\nimport { validateAsset, validateAssetWithIncludes } from './validation/index.js';\nimport { PromptCache } from './cache.js';\nimport { collectContextSizeWarnings, sanitizeContextVariables } from './context.js';\nimport { compactHistoryForPrompt } from './history.js';\nimport { applyPromptCompressionForRender, summarizePromptCompression } from './compression.js';\nimport {\n  DEFAULT_PROMPTS_DIR,\n  loadPromptAsset,\n  resolveInlinePromptSource,\n  resolvePromptAsset,\n  withPromptResolutionDefaults,\n} from './prompt-resolution.js';\nimport type { PromptAsset, PromptAssetOverrides, ResolvedPromptAsset } from './schema/index.js';\nimport type { ProviderRequest, RuntimeRenderOptions } from './providers/types.js';\nimport type {\n  PromptCompressionResult,\n  PromptCompressionSummary,\n  TheTokenCompanyRuntimeOptions,\n} from './compression.js';\nimport type { PromptValidationResult } from './validation/index.js';\n\n// --- Re-exports ---\nexport type { PromptAsset, ResolvedPromptAsset } from './schema/index.js';\nexport type {\n  ProviderRequest,\n  ProviderPromptRenderResult,\n  RuntimeRenderOptions,\n  RuntimeHistoryCompactionInfo,\n  RuntimeHistoryCompactionResult,\n  RuntimeHistoryMessage,\n  OpenAIResponsesRuntimeOptions,\n  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ValidationResult,\n} from './providers/types.js';\nexport type {\n  PromptCompressionResult,\n  PromptCompressionSummary,\n  TheTokenCompanyRuntimeOptions,\n} from './compression.js';\nexport type { PromptValidationResult, ValidationError } from './validation/index.js';\nexport type { RenderedSections, RenderOptions } from './renderer/index.js';\nexport type { ParseResult } from './parser/index.js';\nexport type { OverrideOptions } from './overrides/index.js';\nexport type {\n  UsageTapAllowed,\n  UsageTapAllowedCapability,\n  UsageTapBeginRequest,\n  UsageTapBeginResponse,\n  UsageTapCallOptions,\n  UsageTapCallResult,\n  UsageTapClient,\n  UsageTapClientConfig,\n  UsageTapEndRequest,\n  UsageTapEndResponse,\n  UsageTapEndUsage,\n  UsageTapEntitlementMode,\n  UsageTapEntitlementOptions,\n  UsageTapErrorPayload,\n  UsageTapInvokeContext,\n  UsageTapInvokeResult,\n  UsageTapProviderRunOptions,\n  UsageTapProviderRunResult,\n  UsageTapReasoningLevel,\n} from './usagetap/index.js';\n\nexport { parsePrompt, loadPromptFile, extractSections } from './parser/index.js';\nexport { interpolate, extractVariables } from './renderer/index.js';\nexport { resolveIncludes } from './composition/index.js';\nexport { applyOverrides } from './overrides/index.js';\nexport { validateAsset, validateAssetWithIncludes } from './validation/index.js';\nexport { getAdapter, openaiAdapter, openaiResponsesAdapter } from './providers/index.js';\nexport { anthropicAdapter } from './providers/anthropic.js';\nexport { geminiAdapter } from './providers/gemini.js';\nexport { openrouterAdapter } from './providers/openrouter.js';\nexport {\n  LLMASASERVICE_BASE_URL,\n  LLMASASERVICE_DEFAULT_MODEL,\n  LLMASASERVICE_RESPONSE_HEADER_NAMES,\n  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,\n  createLLMAsAServiceOpenAIConfig,\n  llmasaserviceAdapter,\n} from './providers/llmasaservice.js';\nexport { PromptAssetSchema, PromptAssetOverridesSchema } from './schema/index.js';\nexport {\n  summarizePromptCompression,\n  THETOKENCOMPANY_DEFAULT_BASE_URL,\n  THETOKENCOMPANY_DEFAULT_MODEL,\n} from './compression.js';\nexport {\n  applyUsageTapEntitlements,\n  beginUsageTapCall,\n  createUsageTapClient,\n  defaultUsageTapErrorMapper,\n  endUsageTapCall,\n  extractAnthropicUsage,\n  extractGeminiUsage,\n  extractOpenAIUsage,\n  runAnthropicWithUsageTap,\n  runGeminiWithUsageTap,\n  runLLMAsAServiceWithUsageTap,\n  runOpenAIWithUsageTap,\n  runOpenRouterWithUsageTap,\n  withUsageTapCall,\n} from './usagetap/index.js';\n\n// --- Config ---\n\nexport interface PromptOpsKitConfig {\n  sourceDir?: string;\n  compiledDir?: string;\n  mode?: 'auto' | 'compiled-only' | 'source-only';\n  cache?: boolean;\n  warnings?: {\n    contextSize?: 'auto' | 'off' | 'result-only' | 'console' | 'console-and-result';\n  };\n}\n\n// --- Render options ---\n\nexport interface RenderPromptOptions {\n  /** Prompt path (no extension), e.g. 'support/reply' */\n  path?: string;\n  /** Inline prompt source string (alternative to path) */\n  source?: string;\n  /** Provider name */\n  provider: string;\n  /** Environment override */\n  environment?: string;\n  /** Tier override */\n  tier?: string;\n  /** Runtime overrides applied after environment and tier */\n  runtime?: Partial<PromptAssetOverrides>;\n  /** Variables for interpolation */\n  variables?: Record<string, string>;\n  /** Optional callback to transform oversized context values before warnings/rendering */\n  onContextOverflow?: RuntimeRenderOptions['onContextOverflow'];\n  /** Conversation history */\n  history?: RuntimeRenderOptions['history'];\n  /** Optional callback to compact history overflow when context.history.max_items is exceeded */\n  onHistoryCompaction?: RuntimeRenderOptions['onHistoryCompaction'];\n  /** Tool registry for resolving tool references */\n  toolRegistry?: Record<string, unknown>;\n  /** Strict mode — fail on missing variables */\n  strict?: boolean;\n  /** OpenAI Responses API-specific request options */\n  openaiResponses?: RuntimeRenderOptions['openaiResponses'];\n  /** TheTokenCompany compression credentials and transport options */\n  theTokenCompany?: RuntimeRenderOptions['theTokenCompany'];\n}\n\n// --- Result ---\n\nexport interface RenderResult {\n  resolved: ResolvedPromptAsset;\n  request?: ProviderRequest;\n  returnMessage?: string;\n  compression?: PromptCompressionResult[];\n  compressionSummary?: PromptCompressionSummary;\n  warnings: string[];\n}\n\nfunction shouldIncludeContextWarningsInResult(\n  policy: NonNullable<PromptOpsKitConfig['warnings']>['contextSize'] | undefined,\n): boolean {\n  return policy === undefined\n    || policy === 'auto'\n    || policy === 'result-only'\n    || policy === 'console-and-result';\n}\n\nfunction shouldLogContextWarnings(\n  policy: NonNullable<PromptOpsKitConfig['warnings']>['contextSize'] | undefined,\n  options: Pick<RenderPromptOptions, 'source'>,\n  mode: PromptOpsKitConfig['mode'],\n): boolean {\n  if (policy === 'off' || policy === 'result-only') {\n    return false;\n  }\n\n  if (policy === 'console' || policy === 'console-and-result') {\n    return true;\n  }\n\n  return Boolean(options.source || mode !== 'compiled-only');\n}\n\nfunction formatContextSizeWarning(\n  asset: ResolvedPromptAsset,\n  warning: { variable: string; maxSize: number; actualSize: number },\n): string {\n  return [\n    'POK030:',\n    `Context variable \"${warning.variable}\" exceeded max_size`,\n    `for prompt \"${asset.id}\"`,\n    `(${warning.actualSize} bytes > ${warning.maxSize} bytes).`,\n  ].join(' ');\n}\n\n// --- Main class ---\n\nexport class PromptOpsKit {\n  private config: Required<Pick<PromptOpsKitConfig, 'sourceDir' | 'mode'>> & PromptOpsKitConfig;\n  private promptCache: PromptCache<PromptAsset>;\n\n  constructor(config: PromptOpsKitConfig) {\n    const resolvedConfig = withPromptResolutionDefaults(config);\n    this.config = {\n      ...resolvedConfig,\n      mode: resolvedConfig.mode ?? 'auto',\n      cache: resolvedConfig.cache ?? true,\n    };\n    this.promptCache = new PromptCache();\n  }\n\n  /**\n   * Load a prompt asset from compiled or source, based on mode.\n   */\n  async loadPrompt(promptPath: string): Promise<PromptAsset> {\n    return loadPromptAsset(promptPath, this.config, this.promptCache);\n  }\n\n  /**\n   * Resolve a prompt: load, resolve includes, apply overrides.\n   */\n  async resolvePrompt(\n    promptPath: string,\n    options: { environment?: string; tier?: string; runtime?: Partial<PromptAssetOverrides> } = {},\n  ): Promise<ResolvedPromptAsset> {\n    return resolvePromptAsset(promptPath, this.config, options, this.promptCache);\n  }\n\n  /**\n   * Render a prompt for a specific provider.\n   */\n  async renderPrompt(options: RenderPromptOptions): Promise<RenderResult> {\n    let resolved: ResolvedPromptAsset;\n\n    if (options.source) {\n      resolved = resolveInlinePromptSource(options.source, {\n        environment: options.environment,\n        tier: options.tier,\n        runtime: options.runtime,\n      });\n    } else if (options.path) {\n      resolved = await this.resolvePrompt(options.path, {\n        environment: options.environment,\n        tier: options.tier,\n        runtime: options.runtime,\n      });\n    } else {\n      throw new Error('Either \"path\" or \"source\" must be provided to renderPrompt()');\n    }\n\n    const adapter = getAdapter(options.provider);\n    const validation = adapter.validate(resolved, {\n      openaiResponses: options.openaiResponses,\n    });\n\n    if (!validation.valid) {\n      throw new Error(\n        `Provider validation failed for \"${options.provider}\":\\n` +\n        validation.errors.map((e) => `  - ${e}`).join('\\n'),\n      );\n    }\n\n    const sanitization = sanitizeContextVariables(resolved, options.variables, {\n      onContextOverflow: options.onContextOverflow,\n    });\n\n    if (sanitization.shortCircuit) {\n      return {\n        resolved,\n        returnMessage: sanitization.shortCircuit.returnMessage,\n        warnings: validation.warnings,\n      };\n    }\n\n    const contextSizeWarnings = collectContextSizeWarnings(resolved, sanitization.variables).map((warning) =>\n      formatContextSizeWarning(resolved, warning),\n    );\n\n    const contextWarningPolicy = this.config.warnings?.contextSize;\n\n    if (contextSizeWarnings.length > 0 && shouldLogContextWarnings(contextWarningPolicy, options, this.config.mode)) {\n      for (const warning of contextSizeWarnings) {\n        console.warn(`[promptopskit] Warning: ${warning}`);\n      }\n    }\n\n    const prepared = await applyPromptCompressionForRender(resolved, {\n      variables: sanitization.variables,\n      history: compactHistoryForPrompt(resolved, {\n        history: options.history,\n        onHistoryCompaction: options.onHistoryCompaction,\n      }),\n      onHistoryCompaction: options.onHistoryCompaction,\n      toolRegistry: options.toolRegistry,\n      strict: options.strict,\n      openaiResponses: options.openaiResponses,\n      theTokenCompany: options.theTokenCompany,\n    });\n    const request = adapter.render(prepared.asset, prepared.runtime);\n    const compressionSummary = prepared.compression.length > 0\n      ? summarizePromptCompression(prepared.compression)\n      : undefined;\n\n    return {\n      resolved,\n      request: prepared.compression.length > 0 || prepared.warnings.length > 0\n        ? {\n          ...request,\n          ...(prepared.compression.length > 0 ? { compression: prepared.compression, compressionSummary } : {}),\n          ...(prepared.warnings.length > 0 ? { warnings: prepared.warnings } : {}),\n        }\n        : request,\n      ...(prepared.compression.length > 0 ? { compression: prepared.compression } : {}),\n      ...(compressionSummary ? { compressionSummary } : {}),\n      warnings: shouldIncludeContextWarningsInResult(contextWarningPolicy)\n        ? [...validation.warnings, ...contextSizeWarnings, ...prepared.warnings]\n        : [...validation.warnings, ...prepared.warnings],\n    };\n  }\n\n  /**\n   * Validate a prompt file.\n   */\n  async validatePrompt(promptPath: string): Promise<PromptValidationResult> {\n    const sourceFile = resolve(this.config.sourceDir, promptPath + '.md');\n\n    try {\n      const asset = await this.loadPrompt(promptPath);\n      return validateAssetWithIncludes(asset, sourceFile);\n    } catch (error) {\n      const validationError = toPromptValidationError(error, sourceFile);\n      if (validationError) {\n        return {\n          valid: false,\n          errors: [validationError],\n          warnings: [],\n        };\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Clear the internal cache.\n   */\n  clearCache(): void {\n    this.promptCache.clear();\n  }\n}\n\n// --- Factory ---\n\nexport function createPromptOpsKit(config: PromptOpsKitConfig = {}): PromptOpsKit {\n  return new PromptOpsKit(config);\n}\n\nfunction toPromptValidationError(error: unknown, filePath: string): PromptValidationResult['errors'][number] | undefined {\n  if (!(error instanceof Error)) {\n    return undefined;\n  }\n\n  const match = error.message.match(/^(POK\\d+):\\s*(.*)$/);\n  if (!match) {\n    return undefined;\n  }\n\n  return {\n    code: match[1],\n    message: match[2],\n    filePath,\n  };\n}\n\n// --- Standalone convenience ---\n\n/**\n * Standalone renderPrompt for quick usage without creating a PromptOpsKit instance.\n * Requires either `source` (inline) or `path` + implicit sourceDir of ./prompts.\n */\nexport async function renderPrompt(\n  options: RenderPromptOptions & {\n    sourceDir?: string;\n    warnings?: PromptOpsKitConfig['warnings'];\n  },\n): Promise<RenderResult> {\n  const kit = createPromptOpsKit({\n    sourceDir: options.sourceDir ?? DEFAULT_PROMPTS_DIR,\n    cache: false,\n    warnings: options.warnings,\n  });\n  return kit.renderPrompt(options);\n}\n","export type {\n  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ProviderRequest,\n  ValidationResult,\n  RuntimeRenderOptions,\n} from './types.js';\nexport { openaiAdapter } from './openai.js';\nexport { openaiResponsesAdapter } from './openai-responses.js';\nexport { anthropicAdapter } from './anthropic.js';\nexport { geminiAdapter } from './gemini.js';\nexport { openrouterAdapter } from './openrouter.js';\nexport {\n  LLMASASERVICE_BASE_URL,\n  LLMASASERVICE_DEFAULT_MODEL,\n  LLMASASERVICE_RESPONSE_HEADER_NAMES,\n  LLMASASERVICE_SDK_PLACEHOLDER_API_KEY,\n  createLLMAsAServiceOpenAIConfig,\n  llmasaserviceAdapter,\n} from './llmasaservice.js';\n\nimport type { ProviderAdapter } from './types.js';\nimport { openaiAdapter } from './openai.js';\nimport { openaiResponsesAdapter } from './openai-responses.js';\nimport { anthropicAdapter } from './anthropic.js';\nimport { geminiAdapter } from './gemini.js';\nimport { openrouterAdapter } from './openrouter.js';\nimport { llmasaserviceAdapter } from './llmasaservice.js';\n\nconst adapters: Record<string, ProviderAdapter> = {\n  openai: openaiAdapter,\n  'openai-responses': openaiResponsesAdapter,\n  anthropic: anthropicAdapter,\n  google: geminiAdapter,\n  gemini: geminiAdapter,\n  openrouter: openrouterAdapter,\n  llmasaservice: llmasaserviceAdapter,\n};\n\n/**\n * Get a provider adapter by name.\n */\nexport function getAdapter(provider: string): ProviderAdapter {\n  const adapter = adapters[provider];\n  if (!adapter) {\n    throw new Error(\n      `Unknown provider: \"${provider}\". Supported: ${Object.keys(adapters).join(', ')}`,\n    );\n  }\n  return adapter;\n}\n","/**\n * Compute the Levenshtein distance between two strings.\n * Used for \"did you mean?\" suggestions on unknown fields.\n */\nexport function levenshtein(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n\n  if (m === 0) return n;\n  if (n === 0) return m;\n\n  const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0) as number[]);\n\n  for (let i = 0; i <= m; i++) dp[i][0] = i;\n  for (let j = 0; j <= n; j++) dp[0][j] = j;\n\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      dp[i][j] = Math.min(\n        dp[i - 1][j] + 1,\n        dp[i][j - 1] + 1,\n        dp[i - 1][j - 1] + cost,\n      );\n    }\n  }\n\n  return dp[m][n];\n}\n","import { PromptAssetSchema } from '../schema/index.js';\nimport type { PromptAsset } from '../schema/index.js';\nimport { extractVariables } from '../renderer/index.js';\nimport { resolveIncludes } from '../composition/index.js';\nimport {\n  areContextInputWarningsEnabled,\n  compileContextRegex,\n  getContextInputs,\n} from '../context.js';\nimport { levenshtein } from './levenshtein.js';\n\nexport interface ValidationError {\n  code: string;\n  message: string;\n  filePath?: string;\n  suggestion?: string;\n}\n\nexport interface PromptValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n  warnings: ValidationError[];\n}\n\nconst KNOWN_FRONT_MATTER_KEYS = new Set([\n  'id', 'schema_version', 'description', 'provider', 'model', 'fallback_models',\n  'reasoning', 'sampling', 'response', 'tools', 'mcp', 'context', 'includes',\n  'environments', 'tiers', 'metadata', 'cache', 'compression', 'provider_options', 'raw',\n]);\n\n\n\nfunction collectSchemaKeywords(value: unknown, acc: Set<string>): void {\n  if (!value || typeof value !== 'object') return;\n  if (Array.isArray(value)) {\n    for (const item of value) collectSchemaKeywords(item, acc);\n    return;\n  }\n\n  const record = value as Record<string, unknown>;\n  for (const [key, child] of Object.entries(record)) {\n    acc.add(key);\n    collectSchemaKeywords(child, acc);\n  }\n}\n\nconst RISKY_UNBOUNDED_INPUT_NAMES = [\n  'message',\n  'prompt',\n  'history',\n  'transcript',\n  'document',\n  'content',\n  'input',\n  'body',\n  'context',\n];\n\nconst COMPRESS_MODIFIER_RE = /\\{\\{\\s*([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\|\\s*compress\\s*\\}\\}/g;\n\n/**\n * Validate a parsed prompt asset, returning all errors and warnings.\n */\nexport function validateAsset(\n  asset: PromptAsset,\n  frontMatterKeys?: string[],\n  filePath?: string,\n): PromptValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: ValidationError[] = [];\n\n  // Schema validation\n  const result = PromptAssetSchema.safeParse(asset);\n  if (!result.success) {\n    for (const issue of result.error.issues) {\n      errors.push({\n        code: 'POK001',\n        message: `Schema error at ${issue.path.join('.')}: ${issue.message}`,\n        filePath,\n      });\n    }\n  }\n\n  // Missing id\n  if (!asset.id) {\n    errors.push({\n      code: 'POK002',\n      message: 'Missing required field: \"id\"',\n      filePath,\n    });\n  }\n\n  // Missing body sections\n  if (!asset.sections?.system_instructions && !asset.sections?.prompt_template) {\n    errors.push({\n      code: 'POK003',\n      message: 'Prompt must have at least one body section (System instructions or Prompt template)',\n      filePath,\n    });\n  }\n\n  // Unknown front matter keys with \"did you mean?\"\n  if (frontMatterKeys) {\n    for (const key of frontMatterKeys) {\n      if (!KNOWN_FRONT_MATTER_KEYS.has(key)) {\n        const suggestion = findClosestMatch(key, KNOWN_FRONT_MATTER_KEYS);\n        warnings.push({\n          code: 'POK010',\n          message: `Unknown front matter field: \"${key}\"`,\n          filePath,\n          suggestion: suggestion ? `Did you mean \"${suggestion}\"?` : undefined,\n        });\n      }\n    }\n  }\n\n  // Variable validation: used but not declared\n  const contextInputs = getContextInputs(asset);\n  const declaredInputs = new Set(contextInputs.map((input) => input.name));\n  const declaredInputsByName = new Map(contextInputs.map((input) => [input.name, input]));\n  const usedVars = new Set<string>();\n\n  if (asset.sections?.system_instructions) {\n    for (const v of extractVariables(asset.sections.system_instructions)) {\n      usedVars.add(v);\n    }\n  }\n  if (asset.sections?.prompt_template) {\n    for (const v of extractVariables(asset.sections.prompt_template)) {\n      usedVars.add(v);\n    }\n  }\n\n  for (const v of usedVars) {\n    if (!declaredInputs.has(v)) {\n      warnings.push({\n        code: 'POK011',\n        message: `Variable \"{{ ${v} }}\" is used but not declared in context.inputs`,\n        filePath,\n      });\n    }\n  }\n\n  // Declared but unused\n  for (const v of declaredInputs) {\n    const input = declaredInputsByName.get(v);\n    if (!usedVars.has(v) && input?.optional !== true && areContextInputWarningsEnabled(input ?? {})) {\n      warnings.push({\n        code: 'POK012',\n        message: `Variable \"${v}\" is declared in context.inputs but never used`,\n        filePath,\n      });\n    }\n  }\n\n  if (usedVars.size > 0 && (!asset.context?.inputs || asset.context.inputs.length === 0)) {\n    warnings.push({\n      code: 'POK046',\n      message: `Template uses ${usedVars.size === 1 ? 'a variable' : 'variables'} but context.inputs is not declared.`,\n      filePath,\n      suggestion: 'Declare context.inputs to enable input policy validation.',\n    });\n  }\n\n  if (asset.compression?.heuristic?.enabled === true && asset.compression.heuristic.json_to_toon !== true) {\n    warnings.push({\n      code: 'POK055',\n      message: 'Prompt-level heuristic compression is enabled for the full prompt template.',\n      filePath,\n      suggestion: 'Prefer per-placeholder compression for bulky context values so instructions, output constraints, and safety conditions are not sentence-selected away.',\n    });\n  }\n\n  const systemHeuristicCompressionVariables = findSystemHeuristicCompressionVariables(\n    asset.sections?.system_instructions,\n    declaredInputsByName,\n  );\n  if (systemHeuristicCompressionVariables.length > 0) {\n    warnings.push({\n      code: 'POK056',\n      message: `System instructions use heuristic compression for ${formatQuotedList(systemHeuristicCompressionVariables)}.`,\n      filePath,\n      suggestion: 'Avoid compressing values inside system instructions; move lossy compression to prompt-template context placeholders when possible.',\n    });\n  }\n\n  // Context regex definitions compile successfully\n  for (const input of contextInputs) {\n    const lowerName = input.name.toLowerCase();\n    const inputWarningsEnabled = areContextInputWarningsEnabled(input);\n\n    if (\n      inputWarningsEnabled\n      && input.max_size === undefined\n      && RISKY_UNBOUNDED_INPUT_NAMES.some((needle) => lowerName.includes(needle))\n    ) {\n      warnings.push({\n        code: 'POK040',\n        message: `Context input \"${input.name}\" has no max_size and appears unbounded.`,\n        filePath,\n        suggestion: 'Add max_size to constrain prompt payload growth.',\n      });\n    }\n\n    if (\n      inputWarningsEnabled\n      && input.optional !== true\n      && input.allow_regex === undefined\n      && input.deny_regex === undefined\n      && input.non_empty === undefined\n      && input.reject_secrets === undefined\n    ) {\n      warnings.push({\n        code: 'POK041',\n        message: `Context input \"${input.name}\" has no input hardening validators.`,\n        filePath,\n        suggestion: 'Consider non_empty/reject_secrets and allow/deny regex validators.',\n      });\n    }\n\n    if (inputWarningsEnabled && input.trim !== undefined && input.trim !== false && input.max_size === undefined) {\n      warnings.push({\n        code: 'POK014',\n        message: `Context input \"${input.name}\" sets trim but has no max_size; trim-to-budget will be skipped.`,\n        filePath,\n      });\n    }\n\n    const checks: Array<{\n      regex: NonNullable<typeof input.allow_regex>;\n      kind: 'allow_regex' | 'deny_regex';\n    }> = [];\n\n    if (input.allow_regex) checks.push({ regex: input.allow_regex, kind: 'allow_regex' });\n    if (input.deny_regex) checks.push({ regex: input.deny_regex, kind: 'deny_regex' });\n\n    for (const check of checks) {\n      try {\n        compileContextRegex(check.regex, {\n          promptId: asset.id,\n          variable: input.name,\n          field: check.kind,\n        });\n      } catch (error) {\n        const reason = error instanceof Error ? error.message.replace(/^POK013:\\s*/, '') : String(error);\n        errors.push({\n          code: 'POK013',\n          message: reason,\n          filePath,\n        });\n      }\n    }\n  }\n\n\n  if (asset.response?.schema && asset.provider) {\n    const keywords = new Set<string>();\n    collectSchemaKeywords(asset.response.schema, keywords);\n\n    const openAIUnsupported = ['patternProperties', 'unevaluatedProperties', '$dynamicRef'];\n    const geminiUnsupported = ['patternProperties', '$dynamicRef', 'dependentSchemas'];\n    const anthropicCaution = ['if', 'then', 'else'];\n\n    const checks: Array<{ provider: string[]; unsupported: string[]; code: string }> = [\n      { provider: ['openai', 'openai-responses', 'openrouter', 'llmasaservice'], unsupported: openAIUnsupported, code: 'POK052' },\n      { provider: ['gemini', 'google'], unsupported: geminiUnsupported, code: 'POK053' },\n      { provider: ['anthropic'], unsupported: anthropicCaution, code: 'POK054' },\n    ];\n\n    for (const check of checks) {\n      if (!check.provider.includes(asset.provider)) continue;\n      const hits = check.unsupported.filter((k) => keywords.has(k));\n      if (hits.length > 0) {\n        warnings.push({\n          code: check.code,\n          message: `response.schema includes provider-sensitive JSON Schema keywords for \"${asset.provider}\": ${hits.join(', ')}`,\n          filePath,\n          suggestion: 'Validate schema compatibility with your provider docs or simplify the schema dialect.',\n        });\n      }\n    }\n  }\n\n  if (asset.provider) {\n    let providerCache: unknown;\n    let cacheSuggestionField: string | undefined;\n\n    switch (asset.provider) {\n      case 'openai':\n        providerCache = asset.cache?.openai;\n        cacheSuggestionField = 'cache.openai';\n        break;\n      case 'anthropic':\n        providerCache = asset.cache?.anthropic;\n        cacheSuggestionField = 'cache.anthropic';\n        break;\n      case 'gemini':\n      case 'google':\n        providerCache = asset.cache?.gemini ?? asset.cache?.google;\n        cacheSuggestionField = 'cache.gemini';\n        break;\n      default:\n        break;\n    }\n\n    if (cacheSuggestionField && providerCache === undefined) {\n      warnings.push({\n        code: 'POK042',\n        message: `Provider \"${asset.provider}\" has no provider-specific cache settings.`,\n        filePath,\n        suggestion: `Consider configuring ${cacheSuggestionField} for better cache-hit behavior.`,\n      });\n    }\n\n    if (!asset.model) {\n      warnings.push({\n        code: 'POK044',\n        message: `Provider \"${asset.provider}\" is configured without a model.`,\n        filePath,\n        suggestion: 'Set model in prompt or defaults to avoid adapter-time errors.',\n      });\n    }\n  }\n\n  if (\n    asset.cache?.gemini?.cached_content\n    && asset.cache.google?.cached_content\n    && asset.cache.gemini.cached_content !== asset.cache.google.cached_content\n  ) {\n    warnings.push({\n      code: 'POK043',\n      message: 'cache.gemini.cached_content and cache.google.cached_content are both set to different values.',\n      filePath,\n      suggestion: 'Use one canonical value; Gemini prefers cache.gemini.cached_content.',\n    });\n  }\n\n  for (const [envName, overrides] of Object.entries(asset.environments ?? {})) {\n    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {\n      warnings.push({\n        code: 'POK045',\n        message: `Environment \"${envName}\" does not override cache while prompt-level cache is defined.`,\n        filePath,\n        suggestion: 'Confirm cache strategy is intentionally shared across environments.',\n      });\n    }\n  }\n\n  for (const [tierName, overrides] of Object.entries(asset.tiers ?? {})) {\n    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {\n      warnings.push({\n        code: 'POK045',\n        message: `Tier \"${tierName}\" does not override cache while prompt-level cache is defined.`,\n        filePath,\n        suggestion: 'Confirm cache strategy is intentionally shared across tiers.',\n      });\n    }\n  }\n\n  for (const tool of asset.tools ?? []) {\n    if (isRecord(tool)) {\n      if (!tool.description) {\n        warnings.push({\n          code: 'POK047',\n          message: `Inline tool \"${tool.name}\" is missing a description.`,\n          filePath,\n          suggestion: 'Add description to improve model tool-selection quality.',\n        });\n      }\n      if (!tool.input_schema) {\n        warnings.push({\n          code: 'POK047',\n          message: `Inline tool \"${tool.name}\" is missing input_schema.`,\n          filePath,\n          suggestion: 'Add input_schema so tool inputs are strongly typed.',\n        });\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Validate a prompt asset including its include graph.\n * Catches missing include files, circular includes, and parse errors in included files.\n */\nexport async function validateAssetWithIncludes(\n  asset: PromptAsset,\n  filePath: string,\n  frontMatterKeys?: string[],\n): Promise<PromptValidationResult> {\n  // Run standard validation first\n  const result = validateAsset(asset, frontMatterKeys, filePath);\n\n  // Validate includes\n  if (asset.includes && asset.includes.length > 0) {\n    try {\n      await resolveIncludes(asset, filePath);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const isCircular = message.includes('Circular include');\n      result.errors.push({\n        code: isCircular ? 'POK021' : 'POK020',\n        message: isCircular\n          ? `Circular include detected: ${message}`\n          : `Include resolution failed: ${message}`,\n        filePath,\n      });\n      result.valid = false;\n    }\n  }\n\n  return result;\n}\n\nfunction findClosestMatch(input: string, candidates: Set<string>): string | undefined {\n  let best: string | undefined;\n  let bestDist = Infinity;\n\n  for (const candidate of candidates) {\n    const dist = levenshtein(input.toLowerCase(), candidate.toLowerCase());\n    if (dist < bestDist && dist <= 3) {\n      bestDist = dist;\n      best = candidate;\n    }\n  }\n\n  return best;\n}\n\nfunction findSystemHeuristicCompressionVariables(\n  systemInstructions: string | undefined,\n  declaredInputsByName: Map<string, ReturnType<typeof getContextInputs>[number]>,\n): string[] {\n  if (!systemInstructions) {\n    return [];\n  }\n\n  const variables = new Set<string>();\n\n  for (const match of systemInstructions.matchAll(COMPRESS_MODIFIER_RE)) {\n    variables.add(match[1]);\n  }\n\n  for (const variable of extractVariables(systemInstructions)) {\n    const input = declaredInputsByName.get(variable);\n    const heuristic = input?.compression?.heuristic;\n    if (heuristic?.enabled === true && heuristic.json_to_toon !== true) {\n      variables.add(variable);\n    }\n  }\n\n  return [...variables].sort();\n}\n\nfunction formatQuotedList(values: string[]): string {\n  return values.map((value) => `\"${value}\"`).join(', ');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":"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","names":[]}

package/dist/providers/anthropic.cjs

@@ -101,7 +101,10 @@ function normalizeContextInputCompression(value) {
       target_reduction: value.heuristic.target_reduction,
       query: value.heuristic.query,
       query_variable: value.heuristic.query_variable,
-      json_to_toon: value.heuristic.json_to_toon
+      json_to_toon: value.heuristic.json_to_toon,
+      mode: value.heuristic.mode,
+      preserve_neighbors: value.heuristic.preserve_neighbors,
+      fail_on_low_confidence: value.heuristic.fail_on_low_confidence
     }
   };
   const code = normalizeCodeCompression(value.code);
@@ -579,7 +582,10 @@ function line(depth, content, indent) {
 var TOKEN_REGEX = /[\p{L}\p{N}]+|[^\s]/gu;
 var TOKEN_NORMALIZE_REGEX = /[^\p{L}\p{N}]/gu;
 var DEDUPE_NORMALIZE_REGEX = /[^\p{L}\p{N}\s]/gu;
-var BOILERPLATE_REGEX = /copyright|all rights reserved|disclaimer|confidential/i;
+var BOILERPLATE_REGEX = /copyright|all rights reserved|disclaimer/i;
+var STRUCTURED_BLOCK_REGEX = /(^|\n)\s*```|(^|\n)\s*\|.+\|\s*(\n|$)/;
+var PROTECTED_SIGNAL_REGEX = /\b(?:must|shall|should|required|requires|requirement|never|do not|don't|only|except|unless|however|but|constraint|constraints|safety|security|deadline|sla)\b|output\s+format/i;
+var EVIDENCE_SIGNAL_REGEX = /https?:\/\/|\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b|[$€£]\s?\d|\b\d+(?:[.,:/-]\d+)*%?\b|\b[A-Z]{2,}[-_A-Z0-9]*\b|\b[A-Z]\d\b/i;
 var MAX_SEGMENT_TOKENS = 120;
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "a",
@@ -613,7 +619,8 @@ var STOP_WORDS = /* @__PURE__ */ new Set([
 var DEFAULT_OPTIONS = {
   min_tokens: 80,
   max_sentences: 10,
-  target_reduction: 0.45
+  target_reduction: 0.45,
+  mode: "conservative"
 };
 function tokenizeForHeuristicCompression(text) {
   if (!text) {
@@ -647,25 +654,46 @@ function compressHeuristicText(input, options = {}) {
       warnings: ["JSON-to-TOON skipped because the input is not a complete valid JSON object or array."]
     };
   }
-  const analysis = preprocessContext(inputText);
   if (inputTokens === 0) {
     return toCompressionOutput(inputText, inputTokens);
   }
+  const mode = options.mode ?? DEFAULT_OPTIONS.mode;
+  const isConservative = mode === "conservative";
+  const failOnLowConfidence = options.fail_on_low_confidence ?? isConservative;
+  const preserveNeighbors = options.preserve_neighbors ?? isConservative;
   const minTokens = options.min_tokens ?? DEFAULT_OPTIONS.min_tokens;
   if (inputTokens <= minTokens) {
     return toCompressionOutput(inputText, inputTokens);
   }
+  if (isConservative && looksStructured(inputText)) {
+    return toCompressionOutput(inputText, inputTokens, [
+      "Heuristic compression skipped because the input appears to contain structured blocks; use TOON or code compaction for structured content."
+    ]);
+  }
+  const analysis = preprocessContext(inputText);
   const targetReduction = options.target_reduction ?? DEFAULT_OPTIONS.target_reduction;
   const targetTokens = Math.max(1, Math.max(minTokens, Math.floor(inputTokens * (1 - targetReduction))));
   const maxSentences = options.max_sentences ?? DEFAULT_OPTIONS.max_sentences;
   const query = options.query ?? "";
   const terms = queryTerms(query);
+  if (failOnLowConfidence && terms.size === 0) {
+    return toCompressionOutput(inputText, inputTokens, [
+      "Heuristic compression skipped because no usable relevance query terms were available."
+    ]);
+  }
   const scoredSentences = analysis.candidates.map((candidate) => ({
     sentence: candidate.sentence,
     index: candidate.index,
     ...scoreSentenceCandidate(candidate, terms),
-    tokens: candidate.tokenCount
+    tokens: candidate.tokenCount,
+    isProtected: candidate.isProtected,
+    hasEvidence: candidate.hasEvidence
   }));
+  if (failOnLowConfidence && terms.size > 0 && !scoredSentences.some((candidate) => candidate.overlapCount > 0)) {
+    return toCompressionOutput(inputText, inputTokens, [
+      "Heuristic compression skipped because no sentence matched the relevance query."
+    ]);
+  }
   const selected = [];
   const selectedIndices = /* @__PURE__ */ new Set();
   const coveredTerms = /* @__PURE__ */ new Set();
@@ -705,19 +733,15 @@ function compressHeuristicText(input, options = {}) {
       coveredTerms.add(term);
     }
   }
-  selected.sort((left, right) => left.index - right.index);
-  let output = selected.map((item) => item.sentence).join(" ");
+  const finalSelection = preserveNeighbors ? expandSelectionWithNeighbors(selected, scoredSentences, maxSentences) : selected;
+  finalSelection.sort((left, right) => left.index - right.index);
+  let output = finalSelection.map((item) => item.sentence).join(" ");
   if (!output) {
-    output = tokenizeForHeuristicCompression(inputText).slice(0, targetTokens).join(" ");
-  } else {
-    const outputTokens = tokenizeForHeuristicCompression(output);
-    if (outputTokens.length > targetTokens) {
-      output = outputTokens.slice(0, targetTokens).join(" ");
-    }
+    output = takeWholeCandidatesWithinBudget(analysis.candidates, targetTokens) || inputText;
   }
   return toCompressionOutput(output, inputTokens);
 }
-function toCompressionOutput(output, inputTokens) {
+function toCompressionOutput(output, inputTokens, warnings = []) {
   const outputTokens = estimateHeuristicTokens(output);
   const tokensSaved = Math.max(0, inputTokens - outputTokens);
   return {
@@ -725,7 +749,8 @@ function toCompressionOutput(output, inputTokens) {
     inputTokens,
     outputTokens,
     tokensSaved,
-    compressionRatio: outputTokens === 0 ? 0 : inputTokens / outputTokens
+    compressionRatio: outputTokens === 0 ? 0 : inputTokens / outputTokens,
+    ...warnings.length > 0 ? { warnings } : {}
   };
 }
 function isBetterTieBreak(candidate, bestCandidate) {
@@ -743,13 +768,6 @@ function normalizeForDeduping(sentence) {
 function splitIntoSentences(text) {
   return text.split(/(?<=[.!?])\s+|\n+/g).map((sentence) => sentence.trim()).filter(Boolean);
 }
-function chunkTokens(tokens, chunkSize) {
-  const chunks = [];
-  for (let index = 0; index < tokens.length; index += chunkSize) {
-    chunks.push(tokens.slice(index, index + chunkSize));
-  }
-  return chunks;
-}
 function splitOversizedSentence(sentence, maxTokens = MAX_SEGMENT_TOKENS) {
   const rawTokens = tokenizeForHeuristicCompression(sentence);
   if (rawTokens.length <= maxTokens) {
@@ -761,10 +779,10 @@ function splitOversizedSentence(sentence, maxTokens = MAX_SEGMENT_TOKENS) {
       if (estimateHeuristicTokens(segment) <= maxTokens) {
         return [segment];
       }
-      return chunkTokens(tokenizeForHeuristicCompression(segment), maxTokens).map((chunk) => chunk.join(" "));
+      return [segment];
     });
   }
-  return chunkTokens(rawTokens, maxTokens).map((chunk) => chunk.join(" "));
+  return [sentence];
 }
 function normalizeToken(token) {
   return token.replace(TOKEN_NORMALIZE_REGEX, "").trim();
@@ -773,19 +791,24 @@ function tokenizeNormalized(text) {
   return tokenizeForHeuristicCompression(text.toLowerCase()).map(normalizeToken).filter(Boolean);
 }
 function queryTerms(query) {
-  return new Set(tokenizeNormalized(query).filter((term) => term.length >= 3 && !STOP_WORDS.has(term)));
+  return new Set(tokenizeNormalized(query).filter((term) => {
+    if (STOP_WORDS.has(term)) {
+      return false;
+    }
+    return term.length >= 3 || /^(?:[a-z]\d|\d+[a-z]?|[a-z]{2})$/i.test(term);
+  }));
 }
 function preprocessContext(context) {
   const originalTokens = estimateHeuristicTokens(context);
-  const dedupeSet = /* @__PURE__ */ new Set();
   const candidates = [];
+  let previousNormalized = "";
   for (const sentence of splitIntoSentences(context)) {
     for (const segment of splitOversizedSentence(sentence)) {
       const normalized = normalizeForDeduping(segment);
-      if (!normalized || dedupeSet.has(normalized)) {
+      if (!normalized || normalized === previousNormalized) {
         continue;
       }
-      dedupeSet.add(normalized);
+      previousNormalized = normalized;
       const rawTokens = tokenizeForHeuristicCompression(segment);
       const normalizedTerms = rawTokens.map((token) => normalizeToken(token.toLowerCase())).filter(Boolean);
       const lowered = segment.toLowerCase();
@@ -794,7 +817,9 @@ function preprocessContext(context) {
         index: candidates.length,
         tokenCount: rawTokens.length,
         uniqueTerms: new Set(normalizedTerms),
-        isBoilerplate: BOILERPLATE_REGEX.test(lowered)
+        isBoilerplate: BOILERPLATE_REGEX.test(lowered),
+        isProtected: PROTECTED_SIGNAL_REGEX.test(segment),
+        hasEvidence: EVIDENCE_SIGNAL_REGEX.test(segment)
       });
     }
   }
@@ -820,12 +845,62 @@ function scoreSentenceCandidate(candidate, terms) {
   const densityScore = terms.size > 0 ? overlap / terms.size : 0;
   const lengthScore = Math.min(candidate.tokenCount, 40) / 40;
   const boilerplatePenalty = candidate.isBoilerplate ? 0.5 : 0;
+  const protectedScore = candidate.isProtected ? 0.9 : 0;
+  const evidenceScore = candidate.hasEvidence ? 0.4 : 0;
   return {
-    score: overlapScore + densityScore + lengthScore - boilerplatePenalty,
+    score: overlapScore + densityScore + lengthScore + protectedScore + evidenceScore - boilerplatePenalty,
     overlapCount: overlap,
     overlapTerms
   };
 }
+function looksStructured(text) {
+  if (STRUCTURED_BLOCK_REGEX.test(text)) {
+    return true;
+  }
+  const lines = text.split(/\r?\n/).map((line2) => line2.trim()).filter(Boolean);
+  if (lines.length < 3) {
+    return false;
+  }
+  const listLikeLines = lines.filter((line2) => /^[-*+] |\d+[.)] /.test(line2)).length;
+  return listLikeLines >= 3 && listLikeLines / lines.length >= 0.6;
+}
+function expandSelectionWithNeighbors(selected, scoredSentences, maxSentences) {
+  if (selected.length === 0 || selected.length >= maxSentences) {
+    return selected;
+  }
+  const byIndex = new Map(scoredSentences.map((candidate) => [candidate.index, candidate]));
+  const expanded = new Map(selected.map((candidate) => [candidate.index, candidate]));
+  for (const candidate of selected) {
+    if (expanded.size >= maxSentences) {
+      break;
+    }
+    if (candidate.overlapCount === 0 && !candidate.isProtected && !candidate.hasEvidence) {
+      continue;
+    }
+    for (const neighborIndex of [candidate.index - 1, candidate.index + 1]) {
+      if (expanded.size >= maxSentences) {
+        break;
+      }
+      const neighbor = byIndex.get(neighborIndex);
+      if (neighbor && !expanded.has(neighbor.index)) {
+        expanded.set(neighbor.index, neighbor);
+      }
+    }
+  }
+  return [...expanded.values()];
+}
+function takeWholeCandidatesWithinBudget(candidates, targetTokens) {
+  const selected = [];
+  let tokens = 0;
+  for (const candidate of candidates) {
+    if (tokens + candidate.tokenCount > targetTokens) {
+      break;
+    }
+    selected.push(candidate.sentence);
+    tokens += candidate.tokenCount;
+  }
+  return selected.join(" ");
+}
 
 // src/code-compaction.ts
 function compactCode(input, options = {}) {
@@ -991,7 +1066,10 @@ function renderSections(asset, options = {}) {
         max_sentences: configuredHeuristic?.max_sentences,
         target_reduction: configuredHeuristic?.target_reduction,
         query,
-        json_to_toon: configuredHeuristic?.json_to_toon
+        json_to_toon: configuredHeuristic?.json_to_toon,
+        mode: configuredHeuristic?.mode,
+        preserve_neighbors: configuredHeuristic?.preserve_neighbors,
+        fail_on_low_confidence: configuredHeuristic?.fail_on_low_confidence
       };
       const cacheKey = JSON.stringify([name, value, compressionOptions]);
       const cached = compressionCache.get(cacheKey);
@@ -1357,7 +1435,10 @@ var HeuristicCompressionSchema = import_zod.z.object({
   target_reduction: import_zod.z.number().min(0).max(1).optional(),
   query: import_zod.z.string().optional(),
   query_variable: import_zod.z.string().min(1).optional(),
-  json_to_toon: import_zod.z.boolean().optional()
+  json_to_toon: import_zod.z.boolean().optional(),
+  mode: import_zod.z.enum(["conservative", "balanced"]).optional(),
+  preserve_neighbors: import_zod.z.boolean().optional(),
+  fail_on_low_confidence: import_zod.z.boolean().optional()
 });
 var CodeCompactionSchema = import_zod.z.object({
   enabled: import_zod.z.boolean().optional(),
@@ -2342,7 +2423,10 @@ async function applyPromptCompressionForRender(asset, runtime) {
       max_sentences: heuristicConfig?.max_sentences,
       target_reduction: heuristicConfig?.target_reduction,
       query: resolveHeuristicPromptQuery(heuristicConfig, runtime.variables, sections.system_instructions),
-      json_to_toon: heuristicConfig?.json_to_toon
+      json_to_toon: heuristicConfig?.json_to_toon,
+      mode: heuristicConfig?.mode,
+      preserve_neighbors: heuristicConfig?.preserve_neighbors,
+      fail_on_low_confidence: heuristicConfig?.fail_on_low_confidence
     });
     promptTemplate = result.output;
     reportHeuristicCompressionWarnings2(warnings, result.warnings, "prompt template");