promptopskit 0.3.8 → 0.3.9

package/dist/index.d.cts

@@ -1,12 +1,13 @@
-import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-DwzYbZba.cjs';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-DwzYbZba.cjs';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-C6RG0Si0.cjs';
-export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-C6RG0Si0.cjs';
+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';
 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';
 export { openrouterAdapter } from './providers/openrouter.cjs';
 export { openaiAdapter } from './providers/openai.cjs';
+export { openaiResponsesAdapter } from './providers/openai-responses.cjs';
 import 'zod';
 
 interface ValidationError {
@@ -153,6 +154,8 @@ interface RenderPromptOptions {
     toolRegistry?: Record<string, unknown>;
     /** Strict mode — fail on missing variables */
     strict?: boolean;
+    /** OpenAI Responses API-specific request options */
+    openaiResponses?: RuntimeRenderOptions['openaiResponses'];
 }
 interface RenderResult {
     resolved: ResolvedPromptAsset;

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-import { P as PromptAsset, a as PromptAssetOverrides, R as ResolvedPromptAsset } from './schema-DwzYbZba.js';
-export { b as PromptAssetOverridesSchema, c as PromptAssetSchema } from './schema-DwzYbZba.js';
-import { P as ProviderAdapter, R as RuntimeRenderOptions, a as ProviderRequest } from './types-fBvo_d4k.js';
-export { b as ProviderInlinePromptSource, c as ProviderPromptInput, d as ProviderPromptLookup, e as ProviderPromptRenderResult, V as ValidationResult } from './types-fBvo_d4k.js';
+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';
 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';
 export { openrouterAdapter } from './providers/openrouter.js';
 export { openaiAdapter } from './providers/openai.js';
+export { openaiResponsesAdapter } from './providers/openai-responses.js';
 import 'zod';
 
 interface ValidationError {
@@ -153,6 +154,8 @@ interface RenderPromptOptions {
     toolRegistry?: Record<string, unknown>;
     /** Strict mode — fail on missing variables */
     strict?: boolean;
+    /** OpenAI Responses API-specific request options */
+    openaiResponses?: RuntimeRenderOptions['openaiResponses'];
 }
 interface RenderResult {
     resolved: ResolvedPromptAsset;

package/dist/index.js

@@ -13,18 +13,21 @@ import {
   runOpenRouterWithUsageTap,
   withUsageTapCall
 } from "./chunk-HWEVRBKZ.js";
+import {
+  openaiResponsesAdapter
+} from "./chunk-YNIAA4ZJ.js";
 import {
   anthropicAdapter
-} from "./chunk-BBVVA27J.js";
+} from "./chunk-O6RQZYS4.js";
 import {
   geminiAdapter
-} from "./chunk-E6NPZOJL.js";
+} from "./chunk-AN3OR7YC.js";
 import {
   openrouterAdapter
-} from "./chunk-E2NXJLS6.js";
+} from "./chunk-YAD6COQX.js";
 import {
   openaiAdapter
-} from "./chunk-UJU5XERR.js";
+} from "./chunk-LMURMZUA.js";
 import {
   DEFAULT_PROMPTS_DIR,
   PromptCache,
@@ -41,14 +44,14 @@ import {
   resolvePromptAsset,
   sanitizeContextVariables,
   withPromptResolutionDefaults
-} from "./chunk-X73VG645.js";
+} from "./chunk-V7QY7MRM.js";
 import {
   PromptAssetOverridesSchema,
   PromptAssetSchema,
   extractSections,
   loadPromptFile,
   parsePrompt
-} from "./chunk-5OYWNRNC.js";
+} from "./chunk-4LEPCCSA.js";
 
 // src/index.ts
 import { resolve } from "path";
@@ -56,6 +59,7 @@ import { resolve } from "path";
 // src/providers/index.ts
 var adapters = {
   openai: openaiAdapter,
+  "openai-responses": openaiResponsesAdapter,
   anthropic: anthropicAdapter,
   google: geminiAdapter,
   gemini: geminiAdapter,
@@ -110,7 +114,8 @@ var KNOWN_FRONT_MATTER_KEYS = /* @__PURE__ */ new Set([
   "includes",
   "environments",
   "tiers",
-  "metadata"
+  "metadata",
+  "cache"
 ]);
 function validateAsset(asset, frontMatterKeys, filePath) {
   const errors = [];
@@ -313,7 +318,9 @@ var PromptOpsKit = class {
       throw new Error('Either "path" or "source" must be provided to renderPrompt()');
     }
     const adapter = getAdapter(options.provider);
-    const validation = adapter.validate(resolved);
+    const validation = adapter.validate(resolved, {
+      openaiResponses: options.openaiResponses
+    });
     if (!validation.valid) {
       throw new Error(
         `Provider validation failed for "${options.provider}":
@@ -343,7 +350,8 @@ var PromptOpsKit = class {
       variables: sanitization.variables,
       history: options.history,
       toolRegistry: options.toolRegistry,
-      strict: options.strict
+      strict: options.strict,
+      openaiResponses: options.openaiResponses
     });
     return {
       resolved,
@@ -399,6 +407,7 @@ export {
   interpolate,
   loadPromptFile,
   openaiAdapter,
+  openaiResponsesAdapter,
   openrouterAdapter,
   parsePrompt,
   renderPrompt,

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 } 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}\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\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    });\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 { 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 { anthropicAdapter } from './anthropic.js';\nimport { geminiAdapter } from './gemini.js';\nimport { openrouterAdapter } from './openrouter.js';\n\nconst adapters: Record<string, ProviderAdapter> = {\n  openai: openaiAdapter,\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',\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 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":[]}

package/dist/providers/anthropic.cjs

@@ -103,6 +103,20 @@ function mergeOverride(base, override) {
   if (override.response !== void 0) {
     result.response = { ...result.response, ...override.response };
   }
+  if (override.provider_options !== void 0) {
+    result.provider_options = {
+      ...result.provider_options,
+      ...override.provider_options,
+      anthropic: {
+        ...result.provider_options?.anthropic,
+        ...override.provider_options.anthropic
+      },
+      gemini: {
+        ...result.provider_options?.gemini,
+        ...override.provider_options.gemini
+      }
+    };
+  }
   return result;
 }
 
@@ -205,7 +219,47 @@ var SamplingSchema = import_zod.z.object({
 });
 var ResponseSchema = import_zod.z.object({
   format: import_zod.z.enum(["text", "json", "markdown"]).optional(),
-  stream: import_zod.z.boolean().optional()
+  stream: import_zod.z.boolean().optional(),
+  schema: import_zod.z.record(import_zod.z.unknown()).optional(),
+  schema_name: import_zod.z.string().optional(),
+  schema_strict: import_zod.z.boolean().optional()
+});
+var AnthropicProviderOptionsSchema = import_zod.z.object({
+  top_k: import_zod.z.number().int().min(0).optional(),
+  tool_choice: import_zod.z.record(import_zod.z.unknown()).optional()
+});
+var GeminiProviderOptionsSchema = import_zod.z.object({
+  candidate_count: import_zod.z.number().int().positive().optional(),
+  top_k: import_zod.z.number().int().min(0).optional(),
+  seed: import_zod.z.number().int().optional(),
+  response_schema: import_zod.z.record(import_zod.z.unknown()).optional(),
+  response_modalities: import_zod.z.array(import_zod.z.string()).optional(),
+  thinking_budget_tokens: import_zod.z.number().int().positive().optional()
+});
+var ProviderOptionsSchema = import_zod.z.object({
+  anthropic: AnthropicProviderOptionsSchema.optional(),
+  gemini: GeminiProviderOptionsSchema.optional()
+});
+var OpenAICacheSchema = import_zod.z.object({
+  prompt_cache_key: import_zod.z.string().min(1).optional(),
+  retention: import_zod.z.enum(["in_memory", "24h"]).optional()
+});
+var AnthropicCacheSchema = import_zod.z.object({
+  mode: import_zod.z.enum(["automatic", "explicit"]).optional(),
+  type: import_zod.z.literal("ephemeral").optional(),
+  ttl: import_zod.z.enum(["5m", "1h"]).optional(),
+  cache_system_instructions: import_zod.z.boolean().optional(),
+  cache_tools: import_zod.z.boolean().optional(),
+  cache_prompt_template: import_zod.z.boolean().optional()
+});
+var GeminiCacheSchema = import_zod.z.object({
+  cached_content: import_zod.z.string().min(1).optional()
+});
+var CacheSchema = import_zod.z.object({
+  openai: OpenAICacheSchema.optional(),
+  anthropic: AnthropicCacheSchema.optional(),
+  gemini: GeminiCacheSchema.optional(),
+  google: GeminiCacheSchema.optional()
 });
 var HistorySchema = import_zod.z.object({
   max_items: import_zod.z.number().int().positive().optional()
@@ -256,7 +310,9 @@ var PromptAssetOverridesSchema = import_zod.z.object({
   reasoning: ReasoningSchema.optional(),
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
-  tools: import_zod.z.array(ToolRefSchema).optional()
+  cache: CacheSchema.optional(),
+  tools: import_zod.z.array(ToolRefSchema).optional(),
+  provider_options: ProviderOptionsSchema.optional()
 });
 var SourceSchema = import_zod.z.object({
   file_path: import_zod.z.string().optional(),
@@ -268,8 +324,9 @@ var SectionsSchema = import_zod.z.object({
   notes: import_zod.z.string().optional()
 });
 var PromptDefaultsSchema = import_zod.z.object({
-  provider: import_zod.z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  provider: import_zod.z.enum(["openai", "openai-responses", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
   model: import_zod.z.string().optional(),
+  cache: CacheSchema.optional(),
   metadata: MetadataSchema.optional(),
   sections: import_zod.z.object({
     system_instructions: import_zod.z.string().optional()
@@ -279,13 +336,15 @@ var PromptAssetSchema = import_zod.z.object({
   id: import_zod.z.string(),
   schema_version: import_zod.z.number().int().positive().default(1),
   description: import_zod.z.string().optional(),
-  provider: import_zod.z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  provider: import_zod.z.enum(["openai", "openai-responses", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
   model: import_zod.z.string().optional(),
   fallback_models: import_zod.z.array(import_zod.z.string()).optional(),
   reasoning: ReasoningSchema.optional(),
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
+  cache: CacheSchema.optional(),
   tools: import_zod.z.array(ToolRefSchema).optional(),
+  provider_options: ProviderOptionsSchema.optional(),
   mcp: MCPSchema.optional(),
   context: ContextSchema.optional(),
   includes: import_zod.z.array(import_zod.z.string()).optional(),
@@ -912,6 +971,12 @@ var anthropicAdapter = withPromptInputSupport({
     if (resolvedAsset.reasoning?.effort !== void 0) {
       warnings.push("Anthropic uses budget_tokens for thinking, not effort. effort will be mapped approximately.");
     }
+    if (resolvedAsset.response?.schema !== void 0) {
+      warnings.push("Anthropic does not support response.schema structured output in this adapter. It will be ignored.");
+    }
+    if (resolvedAsset.provider_options?.anthropic?.top_k !== void 0 && resolvedAsset.provider_options.anthropic.top_k < 0) {
+      errors.push("Anthropic provider_options.top_k must be >= 0.");
+    }
     return { valid: errors.length === 0, errors, warnings };
   },
   render(asset, runtime) {
@@ -921,20 +986,38 @@ var anthropicAdapter = withPromptInputSupport({
       strict: runtime.strict
     });
     const messages = [];
+    const anthropicCacheConfig = resolvedAsset.cache?.anthropic;
+    const cacheType = anthropicCacheConfig?.type ?? "ephemeral";
+    const cacheControl = anthropicCacheConfig ? {
+      type: cacheType,
+      ...anthropicCacheConfig.ttl ? { ttl: anthropicCacheConfig.ttl } : {}
+    } : void 0;
+    const cacheMode = anthropicCacheConfig?.mode ?? "automatic";
     if (runtime.history) {
       for (const msg of runtime.history) {
         messages.push({ role: msg.role, content: msg.content });
       }
     }
     if (sections.prompt_template) {
-      messages.push({ role: "user", content: sections.prompt_template });
+      if (cacheControl && cacheMode === "explicit" && anthropicCacheConfig?.cache_prompt_template) {
+        messages.push({
+          role: "user",
+          content: [{ type: "text", text: sections.prompt_template, cache_control: cacheControl }]
+        });
+      } else {
+        messages.push({ role: "user", content: sections.prompt_template });
+      }
     }
     const body = {
       model: resolvedAsset.model,
       messages
     };
     if (sections.system_instructions) {
-      body.system = sections.system_instructions;
+      if (cacheControl && cacheMode === "explicit" && anthropicCacheConfig?.cache_system_instructions !== false) {
+        body.system = [{ type: "text", text: sections.system_instructions, cache_control: cacheControl }];
+      } else {
+        body.system = sections.system_instructions;
+      }
     }
     if (resolvedAsset.sampling?.temperature !== void 0) body.temperature = resolvedAsset.sampling.temperature;
     if (resolvedAsset.sampling?.top_p !== void 0) body.top_p = resolvedAsset.sampling.top_p;
@@ -950,23 +1033,41 @@ var anthropicAdapter = withPromptInputSupport({
         budget_tokens: resolvedAsset.reasoning.budget_tokens
       };
     }
+    if (resolvedAsset.provider_options?.anthropic?.top_k !== void 0) {
+      body.top_k = resolvedAsset.provider_options.anthropic.top_k;
+    }
     if (resolvedAsset.response?.stream !== void 0) {
       body.stream = resolvedAsset.response.stream;
     }
+    if (cacheControl && cacheMode === "automatic") {
+      body.cache_control = cacheControl;
+    }
     if (resolvedAsset.tools && resolvedAsset.tools.length > 0) {
       body.tools = resolvedAsset.tools.map((tool) => {
         if (typeof tool === "string") {
           const def = runtime.toolRegistry?.[tool];
-          if (def) return def;
-          return { name: tool };
+          if (def) {
+            if (cacheControl && cacheMode === "explicit" && anthropicCacheConfig?.cache_tools) {
+              return { ...def, cache_control: cacheControl };
+            }
+            return def;
+          }
+          return {
+            name: tool,
+            ...cacheControl && cacheMode === "explicit" && anthropicCacheConfig?.cache_tools ? { cache_control: cacheControl } : {}
+          };
         }
         return {
           name: tool.name,
           description: tool.description,
-          input_schema: tool.input_schema ?? { type: "object", properties: {} }
+          input_schema: tool.input_schema ?? { type: "object", properties: {} },
+          ...cacheControl && cacheMode === "explicit" && anthropicCacheConfig?.cache_tools ? { cache_control: cacheControl } : {}
         };
       });
     }
+    if (resolvedAsset.provider_options?.anthropic?.tool_choice !== void 0) {
+      body.tool_choice = resolvedAsset.provider_options.anthropic.tool_choice;
+    }
     return {
       body,
       provider: "anthropic",