promptopskit 0.4.2 → 0.6.2

package/dist/{chunk-YI4LILPY.js → chunk-JR7252DG.js}

@@ -1,7 +1,7 @@
 import {
   loadPromptFile,
   parsePrompt
-} from "./chunk-JKBWC5WJ.js";
+} from "./chunk-UY5OKMVP.js";
 
 // src/renderer/interpolate.ts
 var VARIABLE_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -9,12 +9,13 @@ var ESCAPED_OPEN = /\\\{\\\{/g;
 var ESCAPE_PLACEHOLDER = "\0ESCAPED_OPEN\0";
 function interpolate(template, variables, options = {}) {
   const { strict = false } = options;
+  const optionalVariables = new Set(options.optionalVariables ?? []);
   let result = template.replace(ESCAPED_OPEN, ESCAPE_PLACEHOLDER);
   result = result.replace(VARIABLE_RE, (match, name) => {
     if (name in variables) {
       return variables[name];
     }
-    if (strict) {
+    if (strict && !optionalVariables.has(name)) {
       throw new Error(`Missing required variable: "${name}"`);
     }
     return match;
@@ -32,589 +33,650 @@ function extractVariables(template) {
   return [...vars];
 }
 
-// src/renderer/renderer.ts
-function renderSections(asset, options = {}) {
-  const { variables = {}, strict = false } = options;
-  const result = {};
-  if (asset.sections.system_instructions) {
-    result.system_instructions = interpolate(
-      asset.sections.system_instructions,
-      variables,
-      { strict }
-    );
-  }
-  if (asset.sections.prompt_template) {
-    result.prompt_template = interpolate(
-      asset.sections.prompt_template,
-      variables,
-      { strict }
-    );
-  }
-  return result;
+// src/context.ts
+var textEncoder = new TextEncoder();
+var REJECT_SECRETS_PATTERN = "(secret|api[_-]?key|password)";
+var REJECT_SECRETS_FLAGS = "i";
+function getContextInputs(asset) {
+  return (asset.context?.inputs ?? []).map(normalizeContextInput);
 }
-
-// src/overrides/apply-overrides.ts
-function applyOverrides(asset, options = {}) {
-  let result = { ...asset };
-  if (options.environment && result.environments?.[options.environment]) {
-    result = mergeOverride(result, result.environments[options.environment]);
+function normalizeContextInput(input) {
+  if (typeof input === "string") {
+    return { name: input };
   }
-  if (options.tier && result.tiers?.[options.tier]) {
-    result = mergeOverride(result, result.tiers[options.tier]);
+  return {
+    name: input.name,
+    optional: input.optional,
+    warnings: input.warnings,
+    max_size: input.max_size,
+    trim: input.trim,
+    allow_regex: normalizeContextRegex(input.allow_regex),
+    deny_regex: normalizeContextRegex(input.deny_regex),
+    non_empty: normalizeBuiltInValidator(input.non_empty),
+    reject_secrets: normalizeBuiltInValidator(input.reject_secrets)
+  };
+}
+function areContextInputWarningsEnabled(input) {
+  return input.warnings !== false;
+}
+function normalizeContextRegex(value) {
+  if (value === void 0) {
+    return void 0;
   }
-  if (options.runtime) {
-    result = mergeOverride(result, options.runtime);
+  if (typeof value === "string") {
+    const literal = parseRegexLiteral(value);
+    if (value.startsWith("/") && !literal) {
+      return {
+        pattern: value,
+        flags: "",
+        raw: value,
+        invalidLiteral: true
+      };
+    }
+    return {
+      pattern: literal?.pattern ?? value,
+      flags: literal?.flags ?? "",
+      raw: value
+    };
   }
-  return result;
+  return {
+    pattern: value.pattern,
+    flags: value.flags ?? "",
+    raw: JSON.stringify(value),
+    returnMessage: value.return_message
+  };
 }
-function mergeOverride(base, override) {
-  const result = { ...base };
-  if (override.model !== void 0) result.model = override.model;
-  if (override.fallback_models !== void 0) result.fallback_models = override.fallback_models;
-  if (override.tools !== void 0) result.tools = override.tools;
-  if (override.reasoning !== void 0) {
-    result.reasoning = { ...result.reasoning, ...override.reasoning };
+function normalizeBuiltInValidator(value) {
+  if (value === void 0 || value === false) {
+    return void 0;
   }
-  if (override.sampling !== void 0) {
-    result.sampling = { ...result.sampling, ...override.sampling };
+  if (value === true) {
+    return {};
   }
-  if (override.response !== void 0) {
-    result.response = { ...result.response, ...override.response };
+  return {
+    returnMessage: value.return_message
+  };
+}
+function parseRegexLiteral(value) {
+  if (!value.startsWith("/")) {
+    return void 0;
   }
-  if (override.cache !== void 0) {
-    result.cache = {
-      ...result.cache,
-      ...override.cache,
-      openai: mergeRecordBlock(result.cache?.openai, override.cache.openai),
-      anthropic: mergeRecordBlock(result.cache?.anthropic, override.cache.anthropic),
-      gemini: mergeRecordBlock(result.cache?.gemini, override.cache.gemini),
-      google: mergeRecordBlock(result.cache?.google, override.cache.google)
+  for (let index = value.length - 1; index > 0; index -= 1) {
+    if (value[index] !== "/") {
+      continue;
+    }
+    let backslashCount = 0;
+    for (let cursor = index - 1; cursor >= 0 && value[cursor] === "\\"; cursor -= 1) {
+      backslashCount += 1;
+    }
+    if (backslashCount % 2 === 1) {
+      continue;
+    }
+    return {
+      pattern: value.slice(1, index),
+      flags: value.slice(index + 1)
     };
   }
-  if (override.raw !== void 0) {
-    result.raw = {
-      ...result.raw,
-      ...override.raw,
-      openai: mergeRecordBlock(result.raw?.openai, override.raw.openai),
-      "openai-responses": mergeRecordBlock(result.raw?.["openai-responses"], override.raw["openai-responses"]),
-      openai_responses: mergeRecordBlock(result.raw?.openai_responses, override.raw.openai_responses),
-      anthropic: mergeRecordBlock(result.raw?.anthropic, override.raw.anthropic),
-      gemini: mergeRecordBlock(result.raw?.gemini, override.raw.gemini),
-      google: mergeRecordBlock(result.raw?.google, override.raw.google),
-      openrouter: mergeRecordBlock(result.raw?.openrouter, override.raw.openrouter)
-    };
+  return void 0;
+}
+function formatInvalidContextRegexMessage(details) {
+  return [
+    `Invalid context regex for prompt "${details.promptId}"`,
+    `variable "${details.variable}"`,
+    `field "${details.field}"`,
+    `value ${JSON.stringify(details.raw)}: ${details.reason}`
+  ].join(", ");
+}
+function compileContextRegex(regex, details) {
+  if (regex.invalidLiteral) {
+    throw new Error(
+      `POK013: ${formatInvalidContextRegexMessage({
+        ...details,
+        raw: regex.raw,
+        reason: "Malformed regex literal. Use /pattern/flags or { pattern, flags }."
+      })}`
+    );
   }
-  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
-      },
-      openrouter: {
-        ...result.provider_options?.openrouter,
-        ...override.provider_options.openrouter
-      }
-    };
+  try {
+    return new RegExp(regex.pattern, regex.flags);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(`POK013: ${formatInvalidContextRegexMessage({ ...details, raw: regex.raw, reason })}`);
   }
-  return result;
 }
-function mergeRecordBlock(base, override) {
-  if (override === void 0) return base;
-  return { ...base, ...override };
+function getRejectSecretsRegex() {
+  return {
+    pattern: REJECT_SECRETS_PATTERN,
+    flags: REJECT_SECRETS_FLAGS,
+    raw: JSON.stringify({ pattern: REJECT_SECRETS_PATTERN, flags: REJECT_SECRETS_FLAGS })
+  };
 }
-
-// src/providers/resolve-asset.ts
-function resolveAssetForProvider(asset, runtime = {}) {
-  if (!runtime.environment && !runtime.tier && !runtime.runtime) {
-    return asset;
+function isTrimEnabled(mode) {
+  return mode === true || mode === "start" || mode === "end" || mode === "both";
+}
+function normalizeTrimMode(mode) {
+  if (mode === "start") {
+    return "start";
   }
-  return applyOverrides(asset, {
-    environment: runtime.environment,
-    tier: runtime.tier,
-    runtime: runtime.runtime
-  });
+  return "end";
 }
-
-// src/cache.ts
-import { statSync } from "fs";
-var PromptCache = class {
-  cache = /* @__PURE__ */ new Map();
-  maxSize;
-  constructor(maxSize = 100) {
-    this.maxSize = maxSize;
+function trimToMaxSize(value, maxSize, mode) {
+  const measured = measureContextValueSize(value);
+  if (measured <= maxSize) {
+    return value;
   }
-  get(filePath) {
-    const entry = this.cache.get(filePath);
-    if (!entry) return void 0;
-    try {
-      const stat = statSync(filePath);
-      if (stat.mtimeMs !== entry.mtime) {
-        this.cache.delete(filePath);
-        return void 0;
+  const characters = Array.from(value);
+  const normalizedMode = normalizeTrimMode(mode);
+  if (normalizedMode === "start") {
+    let collected2 = "";
+    let size2 = 0;
+    for (let i = characters.length - 1; i >= 0; i -= 1) {
+      const next = characters[i];
+      const charSize = measureContextValueSize(next);
+      if (size2 + charSize > maxSize) {
+        break;
       }
-    } catch {
-      this.cache.delete(filePath);
-      return void 0;
+      collected2 = next + collected2;
+      size2 += charSize;
     }
-    this.cache.delete(filePath);
-    this.cache.set(filePath, entry);
-    return entry.value;
+    return collected2;
   }
-  set(filePath, value) {
-    try {
-      const stat = statSync(filePath);
-      if (this.cache.has(filePath)) {
-        this.cache.delete(filePath);
-      } else if (this.cache.size >= this.maxSize) {
-        const oldest = this.cache.keys().next().value;
-        if (oldest) this.cache.delete(oldest);
-      }
-      this.cache.set(filePath, { value, mtime: stat.mtimeMs });
-    } catch {
+  let collected = "";
+  let size = 0;
+  for (const char of characters) {
+    const charSize = measureContextValueSize(char);
+    if (size + charSize > maxSize) {
+      break;
     }
+    collected += char;
+    size += charSize;
   }
-  clear() {
-    this.cache.clear();
-  }
-  get size() {
-    return this.cache.size;
-  }
-};
-
-// src/composition/resolve-includes.ts
-import { readFile } from "fs/promises";
-import { resolve, dirname } from "path";
-async function resolveIncludes(asset, basePath, visited = /* @__PURE__ */ new Set()) {
-  if (!asset.includes || asset.includes.length === 0) {
-    return asset;
-  }
-  const baseDir = dirname(basePath);
-  const resolvedPath = resolve(basePath);
-  if (visited.has(resolvedPath)) {
-    throw new Error(`Circular include detected: ${resolvedPath}`);
-  }
-  visited.add(resolvedPath);
-  let mergedSystemInstructions = "";
-  for (const includePath of asset.includes) {
-    const fullPath = resolve(baseDir, includePath);
-    if (visited.has(fullPath)) {
-      throw new Error(`Circular include detected: ${fullPath} (included from ${basePath})`);
+  return collected;
+}
+function sanitizeContextVariables(asset, variables = {}, options = {}) {
+  const { onContextOverflow } = options;
+  const sanitized = { ...variables };
+  for (const input of getContextInputs(asset)) {
+    const value = sanitized[input.name];
+    if (value === void 0) {
+      continue;
     }
-    const content = await readFile(fullPath, "utf-8");
-    const { asset: includedAsset } = parsePrompt(content, fullPath);
-    const resolved = await resolveIncludes(includedAsset, fullPath, new Set(visited));
-    if (resolved.sections?.system_instructions) {
-      mergedSystemInstructions += resolved.sections.system_instructions + "\n\n";
+    let candidate = value;
+    if (input.max_size !== void 0) {
+      const actualSize = measureContextValueSize(candidate);
+      if (actualSize > input.max_size && onContextOverflow) {
+        candidate = onContextOverflow({
+          promptId: asset.id,
+          variable: input.name,
+          value: candidate,
+          maxSize: input.max_size,
+          actualSize
+        });
+      }
     }
-  }
-  const localSystem = asset.sections?.system_instructions ?? "";
-  const combinedSystem = (mergedSystemInstructions + localSystem).trim() || void 0;
-  return {
-    ...asset,
-    sections: {
-      ...asset.sections,
-      system_instructions: combinedSystem
-    },
-    // Drop includes from the resolved asset — they've been inlined
-    includes: void 0
-  };
-}
-
-// src/prompt-resolution.ts
-import { readFile as readFile2 } from "fs/promises";
-import { existsSync, statSync as statSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-var DEFAULT_PROMPTS_DIR = "./prompts";
-var DEFAULT_COMPILED_JSON_DIR = "./.generated-prompts/json";
-function withPromptResolutionDefaults(config) {
-  return {
-    ...config,
-    sourceDir: config.sourceDir ?? DEFAULT_PROMPTS_DIR,
-    compiledDir: config.compiledDir ?? DEFAULT_COMPILED_JSON_DIR
-  };
-}
-var sharedPromptCache = new PromptCache();
-async function loadPromptAsset(promptPath, config, promptCache = sharedPromptCache) {
-  const resolvedConfig = withPromptResolutionDefaults(config);
-  const mode = resolvedConfig.mode ?? "auto";
-  if (mode !== "source-only" && resolvedConfig.compiledDir) {
-    const compiledFile = resolve2(resolvedConfig.compiledDir, promptPath + ".json");
-    if (existsSync(compiledFile)) {
-      if (mode === "auto") {
-        const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
-        if (existsSync(sourceFile)) {
-          const compiledMtime = statSync2(compiledFile).mtimeMs;
-          const sourceMtime = statSync2(sourceFile).mtimeMs;
-          if (sourceMtime > compiledMtime) {
-            console.warn(
-              `[promptopskit] Warning: compiled artifact for "${promptPath}" is older than source .md file.
-               Run "promptopskit compile" or switch to source-only mode.`
-            );
-          }
+    if (isTrimEnabled(input.trim) && input.max_size !== void 0) {
+      candidate = trimToMaxSize(candidate, input.max_size, input.trim);
+    }
+    sanitized[input.name] = candidate;
+    if (input.allow_regex) {
+      const candidate2 = sanitized[input.name];
+      const matcher = compileContextRegex(input.allow_regex, {
+        promptId: asset.id,
+        variable: input.name,
+        field: "allow_regex"
+      });
+      if (!matcher.test(candidate2)) {
+        if (input.allow_regex.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.allow_regex.returnMessage,
+              code: "POK031",
+              variable: input.name,
+              field: "allow_regex"
+            }
+          };
         }
+        throw new Error(
+          `POK031: Context variable "${input.name}" failed allow_regex validation for prompt "${asset.id}".`
+        );
       }
-      const content = await readFile2(compiledFile, "utf-8");
-      return JSON.parse(content);
-    }
-    if (mode === "compiled-only") {
-      throw new Error(
-        `Compiled artifact not found: ${compiledFile}
-Run "promptopskit compile" to generate it.`
-      );
     }
-  }
-  if (mode !== "compiled-only") {
-    const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
-    if (resolvedConfig.cache !== false) {
-      const cached = promptCache.get(sourceFile);
-      if (cached) {
-        return cached;
+    if (input.deny_regex) {
+      const candidate2 = sanitized[input.name];
+      const matcher = compileContextRegex(input.deny_regex, {
+        promptId: asset.id,
+        variable: input.name,
+        field: "deny_regex"
+      });
+      if (matcher.test(candidate2)) {
+        if (input.deny_regex.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.deny_regex.returnMessage,
+              code: "POK032",
+              variable: input.name,
+              field: "deny_regex"
+            }
+          };
+        }
+        throw new Error(
+          `POK032: Context variable "${input.name}" matched deny_regex for prompt "${asset.id}".`
+        );
       }
     }
-    if (!existsSync(sourceFile)) {
-      const paths = [sourceFile];
-      if (resolvedConfig.compiledDir) {
-        paths.unshift(resolve2(resolvedConfig.compiledDir, promptPath + ".json"));
+    if (input.non_empty && candidate.trim().length === 0) {
+      if (input.non_empty.returnMessage) {
+        return {
+          variables: sanitized,
+          shortCircuit: {
+            returnMessage: input.non_empty.returnMessage,
+            code: "POK033",
+            variable: input.name,
+            field: "non_empty"
+          }
+        };
       }
       throw new Error(
-        `Prompt not found: "${promptPath}"
-Searched:
-${paths.map((candidate) => `  - ${candidate}`).join("\n")}`
+        `POK033: Context variable "${input.name}" failed non_empty validation for prompt "${asset.id}".`
       );
     }
-    const { asset } = await loadPromptFile(sourceFile, { defaultsRoot: resolvedConfig.sourceDir });
-    if (resolvedConfig.cache !== false) {
-      promptCache.set(sourceFile, asset);
-    }
-    return asset;
-  }
-  throw new Error(`Prompt not found: "${promptPath}"`);
-}
-async function resolvePromptAsset(promptPath, config, options = {}, promptCache = sharedPromptCache) {
-  const resolvedConfig = withPromptResolutionDefaults(config);
-  let asset = await loadPromptAsset(promptPath, resolvedConfig, promptCache);
-  const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
-  if (asset.includes && asset.includes.length > 0 && existsSync(sourceFile)) {
-    asset = await resolveIncludes(asset, sourceFile);
-  }
-  asset = applyOverrides(asset, {
-    environment: options.environment,
-    tier: options.tier,
-    runtime: options.runtime
-  });
-  return asset;
-}
-function resolveInlinePromptSource(source, options = {}) {
-  const { asset } = parsePrompt(source);
-  return applyOverrides(asset, {
-    environment: options.environment,
-    tier: options.tier,
-    runtime: options.runtime
-  });
-}
-
-// src/context.ts
-var textEncoder = new TextEncoder();
-var REJECT_SECRETS_PATTERN = "(secret|api[_-]?key|password)";
-var REJECT_SECRETS_FLAGS = "i";
-function getContextInputs(asset) {
-  return (asset.context?.inputs ?? []).map(normalizeContextInput);
-}
-function getContextInputNames(asset) {
-  return getContextInputs(asset).map((input) => input.name);
-}
-function normalizeContextInput(input) {
-  if (typeof input === "string") {
-    return { name: input };
-  }
-  return {
-    name: input.name,
-    max_size: input.max_size,
-    trim: input.trim,
-    allow_regex: normalizeContextRegex(input.allow_regex),
-    deny_regex: normalizeContextRegex(input.deny_regex),
-    non_empty: normalizeBuiltInValidator(input.non_empty),
-    reject_secrets: normalizeBuiltInValidator(input.reject_secrets)
-  };
-}
-function normalizeContextRegex(value) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (typeof value === "string") {
-    const literal = parseRegexLiteral(value);
-    if (value.startsWith("/") && !literal) {
-      return {
-        pattern: value,
-        flags: "",
-        raw: value,
-        invalidLiteral: true
-      };
-    }
-    return {
-      pattern: literal?.pattern ?? value,
-      flags: literal?.flags ?? "",
-      raw: value
-    };
+    if (input.reject_secrets) {
+      const matcher = compileContextRegex(getRejectSecretsRegex(), {
+        promptId: asset.id,
+        variable: input.name,
+        field: "reject_secrets"
+      });
+      if (matcher.test(candidate)) {
+        if (input.reject_secrets.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.reject_secrets.returnMessage,
+              code: "POK034",
+              variable: input.name,
+              field: "reject_secrets"
+            }
+          };
+        }
+        throw new Error(
+          `POK034: Context variable "${input.name}" matched reject_secrets validation for prompt "${asset.id}".`
+        );
+      }
+    }
   }
-  return {
-    pattern: value.pattern,
-    flags: value.flags ?? "",
-    raw: JSON.stringify(value),
-    returnMessage: value.return_message
-  };
+  return { variables: sanitized };
 }
-function normalizeBuiltInValidator(value) {
-  if (value === void 0 || value === false) {
-    return void 0;
-  }
-  if (value === true) {
-    return {};
-  }
-  return {
-    returnMessage: value.return_message
-  };
+function measureContextValueSize(value) {
+  return textEncoder.encode(value).length;
 }
-function parseRegexLiteral(value) {
-  if (!value.startsWith("/")) {
-    return void 0;
-  }
-  for (let index = value.length - 1; index > 0; index -= 1) {
-    if (value[index] !== "/") {
+function collectContextSizeWarnings(asset, variables = {}) {
+  const warnings = [];
+  for (const input of getContextInputs(asset)) {
+    if (!areContextInputWarningsEnabled(input)) {
       continue;
     }
-    let backslashCount = 0;
-    for (let cursor = index - 1; cursor >= 0 && value[cursor] === "\\"; cursor -= 1) {
-      backslashCount += 1;
+    if (input.max_size === void 0) {
+      continue;
     }
-    if (backslashCount % 2 === 1) {
+    const value = variables[input.name];
+    if (value === void 0) {
       continue;
     }
-    return {
-      pattern: value.slice(1, index),
-      flags: value.slice(index + 1)
-    };
+    const actualSize = measureContextValueSize(value);
+    if (actualSize > input.max_size) {
+      warnings.push({
+        variable: input.name,
+        maxSize: input.max_size,
+        actualSize
+      });
+    }
   }
-  return void 0;
-}
-function formatInvalidContextRegexMessage(details) {
-  return [
-    `Invalid context regex for prompt "${details.promptId}"`,
-    `variable "${details.variable}"`,
-    `field "${details.field}"`,
-    `value ${JSON.stringify(details.raw)}: ${details.reason}`
-  ].join(", ");
+  return warnings;
 }
-function compileContextRegex(regex, details) {
-  if (regex.invalidLiteral) {
-    throw new Error(
-      `POK013: ${formatInvalidContextRegexMessage({
-        ...details,
-        raw: regex.raw,
-        reason: "Malformed regex literal. Use /pattern/flags or { pattern, flags }."
-      })}`
+
+// src/renderer/renderer.ts
+function renderSections(asset, options = {}) {
+  const { variables = {}, strict = false } = options;
+  const optionalVariables = getContextInputs(asset).filter((input) => input.optional === true).map((input) => input.name);
+  const result = {};
+  if (asset.sections.system_instructions) {
+    result.system_instructions = interpolate(
+      asset.sections.system_instructions,
+      variables,
+      { strict, optionalVariables }
     );
   }
-  try {
-    return new RegExp(regex.pattern, regex.flags);
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    throw new Error(`POK013: ${formatInvalidContextRegexMessage({ ...details, raw: regex.raw, reason })}`);
+  if (asset.sections.prompt_template) {
+    result.prompt_template = interpolate(
+      asset.sections.prompt_template,
+      variables,
+      { strict, optionalVariables }
+    );
   }
+  return result;
 }
-function getRejectSecretsRegex() {
-  return {
-    pattern: REJECT_SECRETS_PATTERN,
-    flags: REJECT_SECRETS_FLAGS,
-    raw: JSON.stringify({ pattern: REJECT_SECRETS_PATTERN, flags: REJECT_SECRETS_FLAGS })
-  };
+
+// src/overrides/apply-overrides.ts
+function applyOverrides(asset, options = {}) {
+  let result = { ...asset };
+  if (options.environment && result.environments?.[options.environment]) {
+    result = mergeOverride(result, result.environments[options.environment]);
+  }
+  if (options.tier && result.tiers?.[options.tier]) {
+    result = mergeOverride(result, result.tiers[options.tier]);
+  }
+  if (options.runtime) {
+    result = mergeOverride(result, options.runtime);
+  }
+  return result;
 }
-function isTrimEnabled(mode) {
-  return mode === true || mode === "start" || mode === "end" || mode === "both";
+function mergeOverride(base, override) {
+  const result = { ...base };
+  if (override.model !== void 0) result.model = override.model;
+  if (override.fallback_models !== void 0) result.fallback_models = override.fallback_models;
+  if (override.tools !== void 0) result.tools = override.tools;
+  if (override.reasoning !== void 0) {
+    result.reasoning = { ...result.reasoning, ...override.reasoning };
+  }
+  if (override.sampling !== void 0) {
+    result.sampling = { ...result.sampling, ...override.sampling };
+  }
+  if (override.response !== void 0) {
+    result.response = { ...result.response, ...override.response };
+  }
+  if (override.cache !== void 0) {
+    result.cache = {
+      ...result.cache,
+      ...override.cache,
+      openai: mergeRecordBlock(result.cache?.openai, override.cache.openai),
+      anthropic: mergeRecordBlock(result.cache?.anthropic, override.cache.anthropic),
+      gemini: mergeRecordBlock(result.cache?.gemini, override.cache.gemini),
+      google: mergeRecordBlock(result.cache?.google, override.cache.google)
+    };
+  }
+  if (override.raw !== void 0) {
+    result.raw = {
+      ...result.raw,
+      ...override.raw,
+      openai: mergeRecordBlock(result.raw?.openai, override.raw.openai),
+      "openai-responses": mergeRecordBlock(result.raw?.["openai-responses"], override.raw["openai-responses"]),
+      openai_responses: mergeRecordBlock(result.raw?.openai_responses, override.raw.openai_responses),
+      anthropic: mergeRecordBlock(result.raw?.anthropic, override.raw.anthropic),
+      gemini: mergeRecordBlock(result.raw?.gemini, override.raw.gemini),
+      google: mergeRecordBlock(result.raw?.google, override.raw.google),
+      openrouter: mergeRecordBlock(result.raw?.openrouter, override.raw.openrouter),
+      llmasaservice: mergeRecordBlock(result.raw?.llmasaservice, override.raw.llmasaservice)
+    };
+  }
+  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
+      },
+      openrouter: {
+        ...result.provider_options?.openrouter,
+        ...override.provider_options.openrouter
+      },
+      llmasaservice: {
+        ...result.provider_options?.llmasaservice,
+        ...override.provider_options.llmasaservice
+      }
+    };
+  }
+  return result;
 }
-function normalizeTrimMode(mode) {
-  if (mode === "start") {
-    return "start";
+function mergeRecordBlock(base, override) {
+  if (override === void 0) return base;
+  return { ...base, ...override };
+}
+
+// src/providers/resolve-asset.ts
+function resolveAssetForProvider(asset, runtime = {}) {
+  if (!runtime.environment && !runtime.tier && !runtime.runtime) {
+    return asset;
   }
-  return "end";
+  return applyOverrides(asset, {
+    environment: runtime.environment,
+    tier: runtime.tier,
+    runtime: runtime.runtime
+  });
 }
-function trimToMaxSize(value, maxSize, mode) {
-  const measured = measureContextValueSize(value);
-  if (measured <= maxSize) {
-    return value;
+
+// src/cache.ts
+import { statSync } from "fs";
+var PromptCache = class {
+  cache = /* @__PURE__ */ new Map();
+  maxSize;
+  constructor(maxSize = 100) {
+    this.maxSize = maxSize;
   }
-  const characters = Array.from(value);
-  const normalizedMode = normalizeTrimMode(mode);
-  if (normalizedMode === "start") {
-    let collected2 = "";
-    let size2 = 0;
-    for (let i = characters.length - 1; i >= 0; i -= 1) {
-      const next = characters[i];
-      const charSize = measureContextValueSize(next);
-      if (size2 + charSize > maxSize) {
-        break;
+  get(filePath) {
+    const entry = this.cache.get(filePath);
+    if (!entry) return void 0;
+    try {
+      const stat = statSync(filePath);
+      if (stat.mtimeMs !== entry.mtime) {
+        this.cache.delete(filePath);
+        return void 0;
       }
-      collected2 = next + collected2;
-      size2 += charSize;
+    } catch {
+      this.cache.delete(filePath);
+      return void 0;
     }
-    return collected2;
+    this.cache.delete(filePath);
+    this.cache.set(filePath, entry);
+    return entry.value;
+  }
+  set(filePath, value) {
+    try {
+      const stat = statSync(filePath);
+      if (this.cache.has(filePath)) {
+        this.cache.delete(filePath);
+      } else if (this.cache.size >= this.maxSize) {
+        const oldest = this.cache.keys().next().value;
+        if (oldest) this.cache.delete(oldest);
+      }
+      this.cache.set(filePath, { value, mtime: stat.mtimeMs });
+    } catch {
+    }
+  }
+  clear() {
+    this.cache.clear();
+  }
+  get size() {
+    return this.cache.size;
+  }
+};
+
+// src/composition/resolve-includes.ts
+import { readFile } from "fs/promises";
+import { resolve, dirname } from "path";
+async function resolveIncludes(asset, basePath, visited = /* @__PURE__ */ new Set()) {
+  if (!asset.includes || asset.includes.length === 0) {
+    return asset;
+  }
+  const baseDir = dirname(basePath);
+  const resolvedPath = resolve(basePath);
+  if (visited.has(resolvedPath)) {
+    throw new Error(`Circular include detected: ${resolvedPath}`);
   }
-  let collected = "";
-  let size = 0;
-  for (const char of characters) {
-    const charSize = measureContextValueSize(char);
-    if (size + charSize > maxSize) {
-      break;
+  visited.add(resolvedPath);
+  let mergedSystemInstructions = "";
+  for (const includePath of asset.includes) {
+    const fullPath = resolve(baseDir, includePath);
+    if (visited.has(fullPath)) {
+      throw new Error(`Circular include detected: ${fullPath} (included from ${basePath})`);
+    }
+    const content = await readFile(fullPath, "utf-8");
+    const { asset: includedAsset } = parsePrompt(content, fullPath);
+    const resolved = await resolveIncludes(includedAsset, fullPath, new Set(visited));
+    if (resolved.sections?.system_instructions) {
+      mergedSystemInstructions += resolved.sections.system_instructions + "\n\n";
     }
-    collected += char;
-    size += charSize;
   }
-  return collected;
+  const localSystem = asset.sections?.system_instructions ?? "";
+  const combinedSystem = (mergedSystemInstructions + localSystem).trim() || void 0;
+  return {
+    ...asset,
+    sections: {
+      ...asset.sections,
+      system_instructions: combinedSystem
+    },
+    // Drop includes from the resolved asset — they've been inlined
+    includes: void 0
+  };
 }
-function sanitizeContextVariables(asset, variables = {}, options = {}) {
-  const { onContextOverflow } = options;
-  const sanitized = { ...variables };
-  for (const input of getContextInputs(asset)) {
-    const value = sanitized[input.name];
-    if (value === void 0) {
-      continue;
-    }
-    let candidate = value;
-    if (input.max_size !== void 0) {
-      const actualSize = measureContextValueSize(candidate);
-      if (actualSize > input.max_size && onContextOverflow) {
-        candidate = onContextOverflow({
-          promptId: asset.id,
-          variable: input.name,
-          value: candidate,
-          maxSize: input.max_size,
-          actualSize
-        });
-      }
-    }
-    if (isTrimEnabled(input.trim) && input.max_size !== void 0) {
-      candidate = trimToMaxSize(candidate, input.max_size, input.trim);
-    }
-    sanitized[input.name] = candidate;
-    if (input.allow_regex) {
-      const candidate2 = sanitized[input.name];
-      const matcher = compileContextRegex(input.allow_regex, {
-        promptId: asset.id,
-        variable: input.name,
-        field: "allow_regex"
-      });
-      if (!matcher.test(candidate2)) {
-        if (input.allow_regex.returnMessage) {
-          return {
-            variables: sanitized,
-            shortCircuit: {
-              returnMessage: input.allow_regex.returnMessage,
-              code: "POK031",
-              variable: input.name,
-              field: "allow_regex"
-            }
-          };
+
+// src/prompt-resolution.ts
+import { readFile as readFile2 } from "fs/promises";
+import { existsSync, statSync as statSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+var DEFAULT_PROMPTS_DIR = "./prompts";
+var DEFAULT_COMPILED_JSON_DIR = "./.generated-prompts/json";
+function withPromptResolutionDefaults(config) {
+  return {
+    ...config,
+    sourceDir: config.sourceDir ?? DEFAULT_PROMPTS_DIR,
+    compiledDir: config.compiledDir ?? DEFAULT_COMPILED_JSON_DIR
+  };
+}
+var sharedPromptCache = new PromptCache();
+async function loadPromptAsset(promptPath, config, promptCache = sharedPromptCache) {
+  const resolvedConfig = withPromptResolutionDefaults(config);
+  const mode = resolvedConfig.mode ?? "auto";
+  if (mode !== "source-only" && resolvedConfig.compiledDir) {
+    const compiledFile = resolve2(resolvedConfig.compiledDir, promptPath + ".json");
+    if (existsSync(compiledFile)) {
+      if (mode === "auto") {
+        const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
+        if (existsSync(sourceFile)) {
+          const compiledMtime = statSync2(compiledFile).mtimeMs;
+          const sourceMtime = statSync2(sourceFile).mtimeMs;
+          if (sourceMtime > compiledMtime) {
+            console.warn(
+              `[promptopskit] Warning: compiled artifact for "${promptPath}" is older than source .md file.
+               Run "promptopskit compile" or switch to source-only mode.`
+            );
+          }
         }
-        throw new Error(
-          `POK031: Context variable "${input.name}" failed allow_regex validation for prompt "${asset.id}".`
-        );
       }
+      const content = await readFile2(compiledFile, "utf-8");
+      return JSON.parse(content);
     }
-    if (input.deny_regex) {
-      const candidate2 = sanitized[input.name];
-      const matcher = compileContextRegex(input.deny_regex, {
-        promptId: asset.id,
-        variable: input.name,
-        field: "deny_regex"
-      });
-      if (matcher.test(candidate2)) {
-        if (input.deny_regex.returnMessage) {
-          return {
-            variables: sanitized,
-            shortCircuit: {
-              returnMessage: input.deny_regex.returnMessage,
-              code: "POK032",
-              variable: input.name,
-              field: "deny_regex"
-            }
-          };
-        }
-        throw new Error(
-          `POK032: Context variable "${input.name}" matched deny_regex for prompt "${asset.id}".`
-        );
+    if (mode === "compiled-only") {
+      throw new Error(
+        `Compiled artifact not found: ${compiledFile}
+Run "promptopskit compile" to generate it.`
+      );
+    }
+  }
+  if (mode !== "compiled-only") {
+    const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
+    if (resolvedConfig.cache !== false) {
+      const cached = promptCache.get(sourceFile);
+      if (cached) {
+        return cached;
       }
     }
-    if (input.non_empty && candidate.trim().length === 0) {
-      if (input.non_empty.returnMessage) {
-        return {
-          variables: sanitized,
-          shortCircuit: {
-            returnMessage: input.non_empty.returnMessage,
-            code: "POK033",
-            variable: input.name,
-            field: "non_empty"
-          }
-        };
+    if (!existsSync(sourceFile)) {
+      const paths = [sourceFile];
+      if (resolvedConfig.compiledDir) {
+        paths.unshift(resolve2(resolvedConfig.compiledDir, promptPath + ".json"));
       }
       throw new Error(
-        `POK033: Context variable "${input.name}" failed non_empty validation for prompt "${asset.id}".`
+        `Prompt not found: "${promptPath}"
+Searched:
+${paths.map((candidate) => `  - ${candidate}`).join("\n")}`
       );
     }
-    if (input.reject_secrets) {
-      const matcher = compileContextRegex(getRejectSecretsRegex(), {
-        promptId: asset.id,
-        variable: input.name,
-        field: "reject_secrets"
-      });
-      if (matcher.test(candidate)) {
-        if (input.reject_secrets.returnMessage) {
-          return {
-            variables: sanitized,
-            shortCircuit: {
-              returnMessage: input.reject_secrets.returnMessage,
-              code: "POK034",
-              variable: input.name,
-              field: "reject_secrets"
-            }
-          };
-        }
-        throw new Error(
-          `POK034: Context variable "${input.name}" matched reject_secrets validation for prompt "${asset.id}".`
-        );
-      }
+    const { asset } = await loadPromptFile(sourceFile, { defaultsRoot: resolvedConfig.sourceDir });
+    if (resolvedConfig.cache !== false) {
+      promptCache.set(sourceFile, asset);
     }
+    return asset;
   }
-  return { variables: sanitized };
+  throw new Error(`Prompt not found: "${promptPath}"`);
 }
-function measureContextValueSize(value) {
-  return textEncoder.encode(value).length;
+async function resolvePromptAsset(promptPath, config, options = {}, promptCache = sharedPromptCache) {
+  const resolvedConfig = withPromptResolutionDefaults(config);
+  let asset = await loadPromptAsset(promptPath, resolvedConfig, promptCache);
+  const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
+  if (asset.includes && asset.includes.length > 0 && existsSync(sourceFile)) {
+    asset = await resolveIncludes(asset, sourceFile);
+  }
+  asset = applyOverrides(asset, {
+    environment: options.environment,
+    tier: options.tier,
+    runtime: options.runtime
+  });
+  return asset;
 }
-function collectContextSizeWarnings(asset, variables = {}) {
-  const warnings = [];
-  for (const input of getContextInputs(asset)) {
-    if (input.max_size === void 0) {
-      continue;
-    }
-    const value = variables[input.name];
-    if (value === void 0) {
-      continue;
-    }
-    const actualSize = measureContextValueSize(value);
-    if (actualSize > input.max_size) {
-      warnings.push({
-        variable: input.name,
-        maxSize: input.max_size,
-        actualSize
-      });
-    }
+function resolveInlinePromptSource(source, options = {}) {
+  const { asset } = parsePrompt(source);
+  return applyOverrides(asset, {
+    environment: options.environment,
+    tier: options.tier,
+    runtime: options.runtime
+  });
+}
+
+// src/history.ts
+function defaultCompactHistory(info) {
+  const content = info.overflow.map((message) => `${message.role}: ${message.content}`).join("\n\n");
+  return {
+    role: "user",
+    content: `Earlier conversation compacted to preserve history:
+
+${content}`
+  };
+}
+function normalizeCompactionResult(result) {
+  if (typeof result === "string") {
+    return {
+      role: "user",
+      content: result
+    };
   }
-  return warnings;
+  return result;
+}
+function compactHistoryForPrompt(asset, runtime) {
+  const history = runtime.history;
+  const maxItems = asset.context?.history?.max_items;
+  if (!history || maxItems === void 0 || history.length <= maxItems) {
+    return history;
+  }
+  if (maxItems === 1) {
+    const info2 = {
+      promptId: asset.id,
+      maxItems,
+      overflow: history,
+      preserved: [],
+      history
+    };
+    const compacted2 = runtime.onHistoryCompaction ? normalizeCompactionResult(runtime.onHistoryCompaction(info2)) : defaultCompactHistory(info2);
+    return [compacted2];
+  }
+  const preservedCount = maxItems - 1;
+  const overflow = history.slice(0, history.length - preservedCount);
+  const preserved = history.slice(-preservedCount);
+  const info = {
+    promptId: asset.id,
+    maxItems,
+    overflow,
+    preserved,
+    history
+  };
+  const compacted = runtime.onHistoryCompaction ? normalizeCompactionResult(runtime.onHistoryCompaction(info)) : defaultCompactHistory(info);
+  return [compacted, ...preserved];
 }
 
 // src/providers/prompt-input.ts
@@ -652,7 +714,8 @@ function withPromptInputSupport(adapter) {
     }
     return adapter.render(resolved, {
       ...runtime,
-      variables: sanitization.variables
+      variables: sanitization.variables,
+      history: compactHistoryForPrompt(resolved, runtime)
     });
   };
   return {
@@ -680,6 +743,11 @@ function getRawProviderBody(asset, provider) {
 export {
   interpolate,
   extractVariables,
+  getContextInputs,
+  areContextInputWarningsEnabled,
+  compileContextRegex,
+  sanitizeContextVariables,
+  collectContextSizeWarnings,
   renderSections,
   applyOverrides,
   resolveAssetForProvider,
@@ -690,12 +758,8 @@ export {
   loadPromptAsset,
   resolvePromptAsset,
   resolveInlinePromptSource,
-  getContextInputs,
-  getContextInputNames,
-  compileContextRegex,
-  sanitizeContextVariables,
-  collectContextSizeWarnings,
+  compactHistoryForPrompt,
   withPromptInputSupport,
   applyRawProviderBody
 };
-//# sourceMappingURL=chunk-YI4LILPY.js.map
+//# sourceMappingURL=chunk-JR7252DG.js.map