promptopskit 0.3.9 → 0.4.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-BKkg93rL.cjs';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BKkg93rL.cjs';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-7cC17GWp.cjs';
-export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-7cC17GWp.cjs';
+import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-B9A1zLRk.cjs';
+export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-B9A1zLRk.cjs';
+import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-DpbzzZO2.cjs';
+export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-DpbzzZO2.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, 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-BKkg93rL.js';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-BKkg93rL.js';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-CsQ8tON_.js';
-export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-CsQ8tON_.js';
+import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-B9A1zLRk.js';
+export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-B9A1zLRk.js';
+import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-DjGAwJxC.js';
+export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-DjGAwJxC.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, runOpenAIWithUsageTap, runOpenRouterWithUsageTap, withUsageTapCall } from './usagetap/index.js';
 export { anthropicAdapter } from './providers/anthropic.js';
 export { geminiAdapter } from './providers/gemini.js';

package/dist/index.js

@@ -15,19 +15,19 @@ import {
 } from "./chunk-HWEVRBKZ.js";
 import {
   openaiResponsesAdapter
-} from "./chunk-YNIAA4ZJ.js";
+} from "./chunk-F6UJ73Y6.js";
 import {
   anthropicAdapter
-} from "./chunk-O6RQZYS4.js";
+} from "./chunk-HLNVKKMS.js";
 import {
   geminiAdapter
-} from "./chunk-AN3OR7YC.js";
+} from "./chunk-RY5DVTLV.js";
 import {
   openrouterAdapter
-} from "./chunk-YAD6COQX.js";
+} from "./chunk-UPTCSWK3.js";
 import {
   openaiAdapter
-} from "./chunk-LMURMZUA.js";
+} from "./chunk-L2V7LDKD.js";
 import {
   DEFAULT_PROMPTS_DIR,
   PromptCache,
@@ -44,14 +44,14 @@ import {
   resolvePromptAsset,
   sanitizeContextVariables,
   withPromptResolutionDefaults
-} from "./chunk-V7QY7MRM.js";
+} from "./chunk-XNNDGDPI.js";
 import {
   PromptAssetOverridesSchema,
   PromptAssetSchema,
   extractSections,
   loadPromptFile,
   parsePrompt
-} from "./chunk-4LEPCCSA.js";
+} from "./chunk-JBLUPKY4.js";
 
 // src/index.ts
 import { resolve } from "path";
@@ -115,8 +115,21 @@ var KNOWN_FRONT_MATTER_KEYS = /* @__PURE__ */ new Set([
   "environments",
   "tiers",
   "metadata",
-  "cache"
+  "cache",
+  "provider_options",
+  "raw"
 ]);
+var RISKY_UNBOUNDED_INPUT_NAMES = [
+  "message",
+  "prompt",
+  "history",
+  "transcript",
+  "document",
+  "content",
+  "input",
+  "body",
+  "context"
+];
 function validateAsset(asset, frontMatterKeys, filePath) {
   const errors = [];
   const warnings = [];
@@ -187,7 +200,32 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       });
     }
   }
+  if (usedVars.size > 0 && (!asset.context?.inputs || asset.context.inputs.length === 0)) {
+    warnings.push({
+      code: "POK046",
+      message: `Template uses ${usedVars.size === 1 ? "a variable" : "variables"} but context.inputs is not declared.`,
+      filePath,
+      suggestion: "Declare context.inputs to enable input policy validation."
+    });
+  }
   for (const input of getContextInputs(asset)) {
+    const lowerName = input.name.toLowerCase();
+    if (input.max_size === void 0 && RISKY_UNBOUNDED_INPUT_NAMES.some((needle) => lowerName.includes(needle))) {
+      warnings.push({
+        code: "POK040",
+        message: `Context input "${input.name}" has no max_size and appears unbounded.`,
+        filePath,
+        suggestion: "Add max_size to constrain prompt payload growth."
+      });
+    }
+    if (input.allow_regex === void 0 && input.deny_regex === void 0 && input.non_empty === void 0 && input.reject_secrets === void 0) {
+      warnings.push({
+        code: "POK041",
+        message: `Context input "${input.name}" has no input hardening validators.`,
+        filePath,
+        suggestion: "Consider non_empty/reject_secrets and allow/deny regex validators."
+      });
+    }
     if (input.trim !== void 0 && input.trim !== false && input.max_size === void 0) {
       warnings.push({
         code: "POK014",
@@ -215,6 +253,91 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       }
     }
   }
+  if (asset.provider) {
+    let providerCache;
+    let cacheSuggestionField;
+    switch (asset.provider) {
+      case "openai":
+        providerCache = asset.cache?.openai;
+        cacheSuggestionField = "cache.openai";
+        break;
+      case "anthropic":
+        providerCache = asset.cache?.anthropic;
+        cacheSuggestionField = "cache.anthropic";
+        break;
+      case "gemini":
+      case "google":
+        providerCache = asset.cache?.gemini ?? asset.cache?.google;
+        cacheSuggestionField = "cache.gemini";
+        break;
+      default:
+        break;
+    }
+    if (cacheSuggestionField && providerCache === void 0) {
+      warnings.push({
+        code: "POK042",
+        message: `Provider "${asset.provider}" has no provider-specific cache settings.`,
+        filePath,
+        suggestion: `Consider configuring ${cacheSuggestionField} for better cache-hit behavior.`
+      });
+    }
+    if (!asset.model) {
+      warnings.push({
+        code: "POK044",
+        message: `Provider "${asset.provider}" is configured without a model.`,
+        filePath,
+        suggestion: "Set model in prompt or defaults to avoid adapter-time errors."
+      });
+    }
+  }
+  if (asset.cache?.gemini?.cached_content && asset.cache.google?.cached_content && asset.cache.gemini.cached_content !== asset.cache.google.cached_content) {
+    warnings.push({
+      code: "POK043",
+      message: "cache.gemini.cached_content and cache.google.cached_content are both set to different values.",
+      filePath,
+      suggestion: "Use one canonical value; Gemini prefers cache.gemini.cached_content."
+    });
+  }
+  for (const [envName, overrides] of Object.entries(asset.environments ?? {})) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
+      warnings.push({
+        code: "POK045",
+        message: `Environment "${envName}" does not override cache while prompt-level cache is defined.`,
+        filePath,
+        suggestion: "Confirm cache strategy is intentionally shared across environments."
+      });
+    }
+  }
+  for (const [tierName, overrides] of Object.entries(asset.tiers ?? {})) {
+    if (asset.cache && (!isRecord(overrides) || !overrides.cache)) {
+      warnings.push({
+        code: "POK045",
+        message: `Tier "${tierName}" does not override cache while prompt-level cache is defined.`,
+        filePath,
+        suggestion: "Confirm cache strategy is intentionally shared across tiers."
+      });
+    }
+  }
+  for (const tool of asset.tools ?? []) {
+    if (isRecord(tool)) {
+      if (!tool.description) {
+        warnings.push({
+          code: "POK047",
+          message: `Inline tool "${tool.name}" is missing a description.`,
+          filePath,
+          suggestion: "Add description to improve model tool-selection quality."
+        });
+      }
+      if (!tool.input_schema) {
+        warnings.push({
+          code: "POK047",
+          message: `Inline tool "${tool.name}" is missing input_schema.`,
+          filePath,
+          suggestion: "Add input_schema so tool inputs are strongly typed."
+        });
+      }
+    }
+  }
   return {
     valid: errors.length === 0,
     errors,
@@ -251,6 +374,9 @@ function findClosestMatch(input, candidates) {
   }
   return best;
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/index.ts
 function shouldIncludeContextWarningsInResult(policy) {
@@ -363,9 +489,21 @@ var PromptOpsKit = class {
    * Validate a prompt file.
    */
   async validatePrompt(promptPath) {
-    const asset = await this.loadPrompt(promptPath);
     const sourceFile = resolve(this.config.sourceDir, promptPath + ".md");
-    return validateAssetWithIncludes(asset, sourceFile);
+    try {
+      const asset = await this.loadPrompt(promptPath);
+      return validateAssetWithIncludes(asset, sourceFile);
+    } catch (error) {
+      const validationError = toPromptValidationError(error, sourceFile);
+      if (validationError) {
+        return {
+          valid: false,
+          errors: [validationError],
+          warnings: []
+        };
+      }
+      throw error;
+    }
   }
   /**
    * Clear the internal cache.
@@ -377,6 +515,20 @@ var PromptOpsKit = class {
 function createPromptOpsKit(config = {}) {
   return new PromptOpsKit(config);
 }
+function toPromptValidationError(error, filePath) {
+  if (!(error instanceof Error)) {
+    return void 0;
+  }
+  const match = error.message.match(/^(POK\d+):\s*(.*)$/);
+  if (!match) {
+    return void 0;
+  }
+  return {
+    code: match[1],
+    message: match[2],
+    filePath
+  };
+}
 async function renderPrompt(options) {
   const kit = createPromptOpsKit({
     sourceDir: options.sourceDir ?? DEFAULT_PROMPTS_DIR,

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 {\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 { 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  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ValidationResult,\n} from './providers/types.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 { PromptAssetSchema, PromptAssetOverridesSchema } from './schema/index.js';\nexport {\n  applyUsageTapEntitlements,\n  beginUsageTapCall,\n  createUsageTapClient,\n  defaultUsageTapErrorMapper,\n  endUsageTapCall,\n  extractAnthropicUsage,\n  extractGeminiUsage,\n  extractOpenAIUsage,\n  runAnthropicWithUsageTap,\n  runGeminiWithUsageTap,\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?: Array<{ role: string; content: string }>;\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}\n\n// --- Result ---\n\nexport interface RenderResult {\n  resolved: ResolvedPromptAsset;\n  request?: ProviderRequest;\n  returnMessage?: string;\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 request = adapter.render(resolved, {\n      variables: sanitization.variables,\n      history: options.history,\n      toolRegistry: options.toolRegistry,\n      strict: options.strict,\n      openaiResponses: options.openaiResponses,\n    });\n\n    return {\n      resolved,\n      request,\n      warnings: shouldIncludeContextWarningsInResult(contextWarningPolicy)\n        ? [...validation.warnings, ...contextSizeWarnings]\n        : validation.warnings,\n    };\n  }\n\n  /**\n   * Validate a prompt file.\n   */\n  async validatePrompt(promptPath: string): Promise<PromptValidationResult> {\n    const asset = await this.loadPrompt(promptPath);\n\n    const sourceFile = resolve(this.config.sourceDir, promptPath + '.md');\n    return validateAssetWithIncludes(asset, sourceFile);\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\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';\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';\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};\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  compileContextRegex,\n  formatInvalidContextRegexMessage,\n  getContextInputs,\n  getContextInputNames,\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',\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 declaredInputs = new Set(getContextInputNames(asset));\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    if (!usedVars.has(v)) {\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  // Context regex definitions compile successfully\n  for (const input of getContextInputs(asset)) {\n    if (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  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"],"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 {\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 { 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  ProviderAdapter,\n  ProviderInlinePromptSource,\n  ProviderPromptInput,\n  ProviderPromptLookup,\n  ValidationResult,\n} from './providers/types.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 { PromptAssetSchema, PromptAssetOverridesSchema } from './schema/index.js';\nexport {\n  applyUsageTapEntitlements,\n  beginUsageTapCall,\n  createUsageTapClient,\n  defaultUsageTapErrorMapper,\n  endUsageTapCall,\n  extractAnthropicUsage,\n  extractGeminiUsage,\n  extractOpenAIUsage,\n  runAnthropicWithUsageTap,\n  runGeminiWithUsageTap,\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?: Array<{ role: string; content: string }>;\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}\n\n// --- Result ---\n\nexport interface RenderResult {\n  resolved: ResolvedPromptAsset;\n  request?: ProviderRequest;\n  returnMessage?: string;\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 request = adapter.render(resolved, {\n      variables: sanitization.variables,\n      history: options.history,\n      toolRegistry: options.toolRegistry,\n      strict: options.strict,\n      openaiResponses: options.openaiResponses,\n    });\n\n    return {\n      resolved,\n      request,\n      warnings: shouldIncludeContextWarningsInResult(contextWarningPolicy)\n        ? [...validation.warnings, ...contextSizeWarnings]\n        : validation.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';\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';\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};\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  compileContextRegex,\n  getContextInputs,\n  getContextInputNames,\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', 'provider_options', 'raw',\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 declaredInputs = new Set(getContextInputNames(asset));\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    if (!usedVars.has(v)) {\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 getContextInputs(asset)) {\n    const lowerName = input.name.toLowerCase();\n\n    if (input.max_size === undefined && RISKY_UNBOUNDED_INPUT_NAMES.some((needle) => lowerName.includes(needle))) {\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      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 (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  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":[]}