promptopskit 0.3.5 → 0.3.6

package/README.md

@@ -474,6 +474,7 @@ Renders a prompt for a specific provider. Returns `{ resolved, request, warnings
 | `source` | `string` | Inline prompt source (alternative to path) |
 | `provider` | `string` | `'openai'`, `'anthropic'`, `'gemini'`, `'openrouter'` |
 | `variables` | `Record<string, string>` | Template variables |
+| `onContextOverflow` | `(info) => string` | Optional callback to transform oversized context values before rendering |
 | `environment` | `string` | Environment override name |
 | `tier` | `string` | Tier override name |
 | `history` | `Array<{ role, content }>` | Conversation history |
@@ -506,7 +507,7 @@ Prompt files use YAML front matter with these fields:
 | `response` | `object` | `{ format, stream }` |
 | `tools` | `array` | Tool references (string names or inline definitions) |
 | `mcp` | `object` | MCP server references |
-| `context` | `object` | `{ inputs, history }` — declare expected variables, with optional per-input `max_size` budgets |
+| `context` | `object` | `{ inputs, history }` — declare expected variables, with optional per-input `max_size`, `trim`, and `allow_regex`/`deny_regex` controls |
 | `includes` | `string[]` | Paths to included prompt files |
 | `environments` | `object` | Named environment overrides |
 | `tiers` | `object` | Named tier overrides |

package/SKILL.md

@@ -66,7 +66,7 @@ the fields required by that specific file:
 | `response` | object | no | `{ format: text|json|markdown, stream: boolean }` |
 | `tools` | array | no | Tool names (strings) or inline definitions with `{ name, description, input_schema }` |
 | `mcp` | object | no | `{ servers: [string | { name, config }] }` |
-| `context.inputs` | `Array<string | { name, max_size? }>` | no | Declared variable names used in templates, with optional size budgets |
+| `context.inputs` | `Array<string | { name, max_size?, trim?, allow_regex?, deny_regex? }>` | no | Declared variable names used in templates, with optional size budgets and runtime hardening controls |
 | `context.history` | object | no | `{ max_items: number }` |
 | `includes` | string[] | no | Relative paths to other prompt files to include |
 | `environments` | object | no | Per-environment overrides (see Overrides) |
@@ -100,6 +100,8 @@ Rules:
 - Before finishing a new prompt file, scan the body for every `{{ variable }}` and
   ensure each exact variable name appears in `context.inputs`
 - Use object-form inputs with `max_size` when a variable is likely to grow large and should trigger early warnings
+- Use `trim` to enforce byte budgets before interpolation when `max_size` is set
+- Use `allow_regex` for allowlist checks and `deny_regex` for blocklist checks on risky inputs
 - Escape literal braces with `\{{` and `\}}`
 - In strict mode, missing variables throw an error
 - In permissive mode, unresolved placeholders are left intact
@@ -115,6 +117,7 @@ context:
 ```
 
 If a rendered value exceeds `max_size`, `renderPrompt()` emits a non-blocking `POK030` warning.
+At render time, callers can also pass `onContextOverflow` to transform oversized values before warnings/rendering.
 
 Example: this is the minimal valid shape for a prompt that references
 `{{ pull_request }}` even when provider/model are inherited from defaults:

package/dist/{chunk-2LK6IILW.js → chunk-6FLNJVE7.js}

@@ -34,7 +34,10 @@ var HistorySchema = z.object({
 });
 var ContextInputDefinitionObjectSchema = z.object({
   name: z.string(),
-  max_size: z.number().int().positive().optional()
+  max_size: z.number().int().positive().optional(),
+  trim: z.union([z.boolean(), z.enum(["start", "end", "both"])]).optional(),
+  allow_regex: z.string().optional(),
+  deny_regex: z.string().optional()
 });
 var ContextInputDefinitionSchema = z.union([
   z.string(),
@@ -258,4 +261,4 @@ export {
   parsePrompt,
   loadPromptFile
 };
-//# sourceMappingURL=chunk-2LK6IILW.js.map
+//# sourceMappingURL=chunk-6FLNJVE7.js.map

package/dist/chunk-6FLNJVE7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/schema.ts","../src/parser/sections.ts","../src/parser/parser.ts","../src/parser/loader.ts"],"sourcesContent":["import { z } from 'zod';\n\n// --- Tool definitions ---\n\nexport const InlineToolDefSchema = z.object({\n  name: z.string(),\n  description: z.string().optional(),\n  input_schema: z.record(z.unknown()).optional(),\n});\n\nexport type InlineToolDef = z.infer<typeof InlineToolDefSchema>;\n\nexport const ToolRefSchema = z.union([z.string(), InlineToolDefSchema]);\n\n// --- MCP ---\n\nexport const MCPServerRefSchema = z.union([\n  z.string(),\n  z.object({\n    name: z.string(),\n    config: z.record(z.unknown()).optional(),\n  }),\n]);\n\nexport type MCPServerRef = z.infer<typeof MCPServerRefSchema>;\n\n// --- Reasoning ---\n\nexport const ReasoningSchema = z.object({\n  effort: z.enum(['low', 'medium', 'high']).optional(),\n  budget_tokens: z.number().int().positive().optional(),\n});\n\n// --- Sampling ---\n\nexport const SamplingSchema = z.object({\n  temperature: z.number().min(0).max(2).optional(),\n  top_p: z.number().min(0).max(1).optional(),\n  frequency_penalty: z.number().optional(),\n  presence_penalty: z.number().optional(),\n  stop: z.array(z.string()).optional(),\n  max_output_tokens: z.number().int().positive().optional(),\n});\n\n// --- Response ---\n\nexport const ResponseSchema = z.object({\n  format: z.enum(['text', 'json', 'markdown']).optional(),\n  stream: z.boolean().optional(),\n});\n\n// --- Context ---\n\nexport const HistorySchema = z.object({\n  max_items: z.number().int().positive().optional(),\n});\n\nexport const ContextInputDefinitionObjectSchema = z.object({\n  name: z.string(),\n  max_size: z.number().int().positive().optional(),\n  trim: z.union([z.boolean(), z.enum(['start', 'end', 'both'])]).optional(),\n  allow_regex: z.string().optional(),\n  deny_regex: z.string().optional(),\n});\n\nexport const ContextInputDefinitionSchema = z.union([\n  z.string(),\n  ContextInputDefinitionObjectSchema,\n]);\n\nexport type ContextInputDefinition = z.infer<typeof ContextInputDefinitionSchema>;\n\nexport const ContextSchema = z.object({\n  inputs: z.array(ContextInputDefinitionSchema).optional(),\n  history: HistorySchema.optional(),\n});\n\n// --- Metadata ---\n\nexport const MetadataSchema = z.object({\n  owner: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  review_required: z.boolean().optional(),\n  stable: z.boolean().optional(),\n});\n\n// --- MCP block ---\n\nexport const MCPSchema = z.object({\n  servers: z.array(MCPServerRefSchema).optional(),\n});\n\n// --- Overrides (subset allowed in environments/tiers) ---\n\nexport const PromptAssetOverridesSchema = z.object({\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n  tools: z.array(ToolRefSchema).optional(),\n});\n\nexport type PromptAssetOverrides = z.infer<typeof PromptAssetOverridesSchema>;\n\n// --- Source tracking ---\n\nexport const SourceSchema = z.object({\n  file_path: z.string().optional(),\n  checksum: z.string().optional(),\n});\n\n// --- Sections (populated by parser) ---\n\nexport const SectionsSchema = z.object({\n  system_instructions: z.string().optional(),\n  prompt_template: z.string().optional(),\n  notes: z.string().optional(),\n});\n\n// --- Defaults files (folder-level inheritance) ---\n\nexport const PromptDefaultsSchema = z.object({\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  metadata: MetadataSchema.optional(),\n  sections: z.object({\n    system_instructions: z.string().optional(),\n  }).optional(),\n});\n\nexport type PromptDefaults = z.infer<typeof PromptDefaultsSchema>;\n\n// --- Top-level PromptAsset ---\n\nexport const PromptAssetSchema = z.object({\n  id: z.string(),\n  schema_version: z.number().int().positive().default(1),\n  description: z.string().optional(),\n\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n\n  tools: z.array(ToolRefSchema).optional(),\n  mcp: MCPSchema.optional(),\n\n  context: ContextSchema.optional(),\n\n  includes: z.array(z.string()).optional(),\n\n  environments: z.record(PromptAssetOverridesSchema).optional(),\n  tiers: z.record(PromptAssetOverridesSchema).optional(),\n\n  metadata: MetadataSchema.optional(),\n\n  // Populated by parser, not authored in YAML\n  sections: SectionsSchema.optional(),\n  source: SourceSchema.optional(),\n});\n\nexport type PromptAsset = z.infer<typeof PromptAssetSchema>;\n\n// --- Resolved asset (after includes, overrides applied) ---\n\nexport interface ResolvedPromptAsset extends PromptAsset {\n  sections: {\n    system_instructions?: string;\n    prompt_template?: string;\n    notes?: string;\n  };\n  source: {\n    file_path?: string;\n    checksum?: string;\n  };\n}\n","export interface Sections {\n  system_instructions?: string;\n  prompt_template?: string;\n  notes?: string;\n}\n\nconst SECTION_MAP: Record<string, keyof Sections> = {\n  'system instructions': 'system_instructions',\n  'prompt template': 'prompt_template',\n  'notes': 'notes',\n};\n\n/**\n * Extract named sections from the markdown body using H1 headings.\n * Case-insensitive. H2+ within a section is treated as content.\n * If no H1 headings are found, the entire body is treated as prompt_template.\n */\nexport function extractSections(body: string): Sections {\n  const lines = body.split(/\\r?\\n/);\n  const sections: Sections = {};\n\n  let currentKey: keyof Sections | null = null;\n  let currentLines: string[] = [];\n  let foundAnyH1 = false;\n\n  for (const line of lines) {\n    const h1Match = line.match(/^#\\s+(.+)$/);\n    if (h1Match) {\n      // Flush previous section\n      if (currentKey) {\n        sections[currentKey] = currentLines.join('\\n').trim();\n      }\n\n      foundAnyH1 = true;\n      const heading = h1Match[1].trim().toLowerCase();\n      currentKey = SECTION_MAP[heading] ?? null;\n      currentLines = [];\n    } else {\n      currentLines.push(line);\n    }\n  }\n\n  // Flush last section\n  if (currentKey) {\n    sections[currentKey] = currentLines.join('\\n').trim();\n  }\n\n  // If no H1 headings found, treat entire body as prompt_template\n  if (!foundAnyH1) {\n    const trimmed = body.trim();\n    if (trimmed) {\n      sections.prompt_template = trimmed;\n    }\n  }\n\n  return sections;\n}\n","import matter from 'gray-matter';\nimport { PromptAssetSchema } from '../schema/index.js';\nimport type { PromptAsset } from '../schema/index.js';\nimport { extractSections } from './sections.js';\n\nexport interface ParseResult {\n  asset: PromptAsset;\n  raw: {\n    frontMatter: Record<string, unknown>;\n    body: string;\n  };\n}\n\n/**\n * Parse a prompt markdown string (YAML front matter + markdown body)\n * into a validated PromptAsset.\n */\nexport function parsePrompt(content: string, filePath?: string): ParseResult {\n  const { data: frontMatter, content: body } = matter(content);\n\n  const sections = extractSections(body);\n\n  const raw = {\n    ...frontMatter,\n    sections,\n    source: filePath ? { file_path: filePath } : undefined,\n  };\n\n  const asset = PromptAssetSchema.parse(raw);\n\n  return {\n    asset,\n    raw: {\n      frontMatter: frontMatter as Record<string, unknown>,\n      body,\n    },\n  };\n}\n","import { readFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport matter from 'gray-matter';\nimport { parsePrompt } from './parser.js';\nimport type { ParseResult } from './parser.js';\nimport { extractSections } from './sections.js';\nimport { PromptDefaultsSchema } from '../schema/index.js';\nimport type { PromptDefaults } from '../schema/index.js';\n\nconst DEFAULTS_FILE_NAME = 'defaults.md';\n\nexport interface LoadPromptOptions {\n  /**\n   * Optional boundary directory for defaults discovery.\n   * If provided, defaults are loaded from this directory down to the prompt directory.\n   */\n  defaultsRoot?: string;\n}\n\n/**\n * Load and parse a prompt file from disk.\n */\nexport async function loadPromptFile(filePath: string, options: LoadPromptOptions = {}): Promise<ParseResult> {\n  const content = await readFile(filePath, 'utf-8');\n  const parsed = parsePrompt(content, filePath);\n  // Default the boundary to the file's own directory so traversal never\n  // walks above the prompt tree when no explicit root is provided.\n  const root = options.defaultsRoot ?? dirname(filePath);\n  const defaults = await loadDefaultsForPath(filePath, root);\n  const asset = applyDefaults(parsed.asset, defaults);\n\n  return {\n    ...parsed,\n    asset,\n  };\n}\n\nasync function loadDefaultsForPath(filePath: string, defaultsRoot?: string): Promise<PromptDefaults> {\n  const directories = getDirectoriesToCheck(filePath, defaultsRoot);\n  let merged: PromptDefaults = {};\n\n  for (const dir of directories) {\n    const defaultsPath = join(dir, DEFAULTS_FILE_NAME);\n    try {\n      const defaultsContent = await readFile(defaultsPath, 'utf-8');\n      const defaults = parseDefaults(defaultsContent);\n      merged = mergeDefaults(merged, defaults);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        throw error;\n      }\n    }\n  }\n\n  return merged;\n}\n\nfunction getDirectoriesToCheck(filePath: string, defaultsRoot?: string): string[] {\n  const dirs: string[] = [];\n  let current = resolve(dirname(filePath));\n  const boundary = defaultsRoot ? resolve(defaultsRoot) : undefined;\n\n  while (true) {\n    dirs.unshift(current);\n    if ((boundary && current === boundary) || current === dirname(current)) {\n      break;\n    }\n    current = dirname(current);\n  }\n\n  return dirs;\n}\n\nfunction parseDefaults(content: string): PromptDefaults {\n  const { data: frontMatter, content: body } = matter(content);\n  const sections = extractSections(body);\n\n  return PromptDefaultsSchema.parse({\n    ...frontMatter,\n    sections: {\n      system_instructions: sections.system_instructions,\n    },\n  });\n}\n\nfunction mergeDefaults(base: PromptDefaults, local: PromptDefaults): PromptDefaults {\n  return {\n    provider: local.provider ?? base.provider,\n    model: local.model ?? base.model,\n    metadata: {\n      ...(base.metadata ?? {}),\n      ...(local.metadata ?? {}),\n    },\n    sections: {\n      ...(base.sections ?? {}),\n      ...(local.sections ?? {}),\n    },\n  };\n}\n\nfunction applyDefaults(asset: ParseResult['asset'], defaults: PromptDefaults): ParseResult['asset'] {\n  const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;\n  const hasDefaultSystem = !!defaults.sections?.system_instructions;\n  const hasDefaultScalars = defaults.provider !== undefined\n    || defaults.model !== undefined;\n\n  // Short-circuit: nothing to merge\n  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {\n    return asset;\n  }\n\n  const mergedMetadata = {\n    ...(defaults.metadata ?? {}),\n    ...(asset.metadata ?? {}),\n  };\n  const metadata = Object.keys(mergedMetadata).length > 0 ? mergedMetadata : undefined;\n\n  const systemInstructions = asset.sections?.system_instructions ?? defaults.sections?.system_instructions;\n\n  const sections = asset.sections\n    ? { ...asset.sections, system_instructions: systemInstructions }\n    : systemInstructions\n      ? { system_instructions: systemInstructions }\n      : undefined;\n\n  return {\n    ...asset,\n    provider: asset.provider ?? defaults.provider,\n    model: asset.model ?? defaults.model,\n    metadata,\n    sections,\n  };\n}\n"],"mappings":"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","names":["matter","matter"]}

package/dist/{chunk-7RWTFGMS.js → chunk-J32I6DSG.js}

@@ -2,7 +2,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-M5VKRDIY.js";
+} from "./chunk-SHYKSLVR.js";
 
 // src/providers/gemini.ts
 var geminiAdapter = withPromptInputSupport({
@@ -93,4 +93,4 @@ var geminiAdapter = withPromptInputSupport({
 export {
   geminiAdapter
 };
-//# sourceMappingURL=chunk-7RWTFGMS.js.map
+//# sourceMappingURL=chunk-J32I6DSG.js.map

package/dist/{chunk-2X5HFPSD.js → chunk-MN3RQ7DZ.js}

@@ -2,7 +2,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-M5VKRDIY.js";
+} from "./chunk-SHYKSLVR.js";
 
 // src/providers/openai.ts
 var openaiAdapter = withPromptInputSupport({
@@ -84,4 +84,4 @@ var openaiAdapter = withPromptInputSupport({
 export {
   openaiAdapter
 };
-//# sourceMappingURL=chunk-2X5HFPSD.js.map
+//# sourceMappingURL=chunk-MN3RQ7DZ.js.map

package/dist/{chunk-4QW4BSGE.js → chunk-MYXDJMWV.js}

@@ -2,7 +2,7 @@ import {
   renderSections,
   resolveAssetForProvider,
   withPromptInputSupport
-} from "./chunk-M5VKRDIY.js";
+} from "./chunk-SHYKSLVR.js";
 
 // src/providers/anthropic.ts
 var anthropicAdapter = withPromptInputSupport({
@@ -89,4 +89,4 @@ var anthropicAdapter = withPromptInputSupport({
 export {
   anthropicAdapter
 };
-//# sourceMappingURL=chunk-4QW4BSGE.js.map
+//# sourceMappingURL=chunk-MYXDJMWV.js.map

package/dist/{chunk-M5VKRDIY.js → chunk-SHYKSLVR.js}

@@ -1,7 +1,7 @@
 import {
   loadPromptFile,
   parsePrompt
-} from "./chunk-2LK6IILW.js";
+} from "./chunk-6FLNJVE7.js";
 
 // src/renderer/interpolate.ts
 var VARIABLE_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -274,6 +274,139 @@ function resolveInlinePromptSource(source, options = {}) {
   });
 }
 
+// src/context.ts
+var textEncoder = new TextEncoder();
+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: input.allow_regex,
+    deny_regex: input.deny_regex
+  };
+}
+function isTrimEnabled(mode) {
+  return mode === true || mode === "start" || mode === "end" || mode === "both";
+}
+function normalizeTrimMode(mode) {
+  if (mode === "start") {
+    return "start";
+  }
+  return "end";
+}
+function trimToMaxSize(value, maxSize, mode) {
+  const measured = measureContextValueSize(value);
+  if (measured <= maxSize) {
+    return value;
+  }
+  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;
+      }
+      collected2 = next + collected2;
+      size2 += charSize;
+    }
+    return collected2;
+  }
+  let collected = "";
+  let size = 0;
+  for (const char of characters) {
+    const charSize = measureContextValueSize(char);
+    if (size + charSize > maxSize) {
+      break;
+    }
+    collected += char;
+    size += charSize;
+  }
+  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;
+    }
+    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 = new RegExp(input.allow_regex);
+      if (!matcher.test(candidate2)) {
+        throw new Error(
+          `POK031: Context variable "${input.name}" failed allow_regex validation for prompt "${asset.id}".`
+        );
+      }
+    }
+    if (input.deny_regex) {
+      const candidate2 = sanitized[input.name];
+      const matcher = new RegExp(input.deny_regex);
+      if (matcher.test(candidate2)) {
+        throw new Error(
+          `POK032: Context variable "${input.name}" matched deny_regex for prompt "${asset.id}".`
+        );
+      }
+    }
+  }
+  return sanitized;
+}
+function measureContextValueSize(value) {
+  return textEncoder.encode(value).length;
+}
+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
+      });
+    }
+  }
+  return warnings;
+}
+
 // src/providers/prompt-input.ts
 function isPromptLookup(input) {
   return "path" in input && typeof input.path === "string";
@@ -297,7 +430,13 @@ function withPromptInputSupport(adapter) {
   };
   const renderPrompt = async (input, runtime) => {
     const resolved = await resolveProviderPromptInput(input, runtime);
-    return adapter.render(resolved, runtime);
+    const variables = sanitizeContextVariables(resolved, runtime.variables, {
+      onContextOverflow: runtime.onContextOverflow
+    });
+    return adapter.render(resolved, {
+      ...runtime,
+      variables
+    });
   };
   return {
     ...adapter,
@@ -319,6 +458,10 @@ export {
   loadPromptAsset,
   resolvePromptAsset,
   resolveInlinePromptSource,
+  getContextInputs,
+  getContextInputNames,
+  sanitizeContextVariables,
+  collectContextSizeWarnings,
   withPromptInputSupport
 };
-//# sourceMappingURL=chunk-M5VKRDIY.js.map
+//# sourceMappingURL=chunk-SHYKSLVR.js.map

package/dist/chunk-SHYKSLVR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/renderer/interpolate.ts","../src/renderer/renderer.ts","../src/overrides/apply-overrides.ts","../src/providers/resolve-asset.ts","../src/cache.ts","../src/composition/resolve-includes.ts","../src/prompt-resolution.ts","../src/context.ts","../src/providers/prompt-input.ts"],"sourcesContent":["export interface InterpolateOptions {\n  strict?: boolean;\n}\n\nconst VARIABLE_RE = /\\{\\{\\s*([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\}\\}/g;\nconst ESCAPED_OPEN = /\\\\\\{\\\\\\{/g;\nconst ESCAPE_PLACEHOLDER = '\\x00ESCAPED_OPEN\\x00';\n\n/**\n * Interpolate variables into a template string.\n *\n * Syntax: {{ variable_name }}\n * Escape: \\{\\{ produces literal {{\n *\n * In strict mode, throws on missing variables.\n * In permissive mode, leaves {{ placeholder }} intact.\n */\nexport function interpolate(\n  template: string,\n  variables: Record<string, string>,\n  options: InterpolateOptions = {},\n): string {\n  const { strict = false } = options;\n\n  // Replace escaped sequences with placeholder\n  let result = template.replace(ESCAPED_OPEN, ESCAPE_PLACEHOLDER);\n\n  result = result.replace(VARIABLE_RE, (match, name: string) => {\n    if (name in variables) {\n      return variables[name];\n    }\n    if (strict) {\n      throw new Error(`Missing required variable: \"${name}\"`);\n    }\n    return match; // leave placeholder intact in permissive mode\n  });\n\n  // Restore escaped sequences\n  result = result.replaceAll(ESCAPE_PLACEHOLDER, '{{');\n\n  return result;\n}\n\n/**\n * Extract all variable names referenced in a template.\n */\nexport function extractVariables(template: string): string[] {\n  const vars = new Set<string>();\n  let match: RegExpExecArray | null;\n  const re = new RegExp(VARIABLE_RE.source, 'g');\n  while ((match = re.exec(template)) !== null) {\n    vars.add(match[1]);\n  }\n  return [...vars];\n}\n","import type { ResolvedPromptAsset } from '../schema/index.js';\nimport { interpolate, extractVariables } from './interpolate.js';\n\nexport interface RenderOptions {\n  variables?: Record<string, string>;\n  strict?: boolean;\n}\n\nexport interface RenderedSections {\n  system_instructions?: string;\n  prompt_template?: string;\n}\n\n/**\n * Render the sections of a resolved prompt asset with variable interpolation.\n */\nexport function renderSections(\n  asset: ResolvedPromptAsset,\n  options: RenderOptions = {},\n): RenderedSections {\n  const { variables = {}, strict = false } = options;\n\n  const result: RenderedSections = {};\n\n  if (asset.sections.system_instructions) {\n    result.system_instructions = interpolate(\n      asset.sections.system_instructions,\n      variables,\n      { strict },\n    );\n  }\n\n  if (asset.sections.prompt_template) {\n    result.prompt_template = interpolate(\n      asset.sections.prompt_template,\n      variables,\n      { strict },\n    );\n  }\n\n  return result;\n}\n\n/**\n * Get all variable names used across all sections.\n */\nexport function getRequiredVariables(asset: ResolvedPromptAsset): string[] {\n  const vars = new Set<string>();\n\n  if (asset.sections.system_instructions) {\n    for (const v of extractVariables(asset.sections.system_instructions)) {\n      vars.add(v);\n    }\n  }\n\n  if (asset.sections.prompt_template) {\n    for (const v of extractVariables(asset.sections.prompt_template)) {\n      vars.add(v);\n    }\n  }\n\n  return [...vars];\n}\n","import type { PromptAsset, PromptAssetOverrides } from '../schema/index.js';\n\nexport interface OverrideOptions {\n  environment?: string;\n  tier?: string;\n  runtime?: Partial<PromptAssetOverrides>;\n}\n\n/**\n * Apply environment, tier, and runtime overrides to a prompt asset.\n *\n * Precedence: base → environment → tier → runtime\n * Scalars are replaced. Arrays are replaced (not concatenated).\n */\nexport function applyOverrides(\n  asset: PromptAsset,\n  options: OverrideOptions = {},\n): PromptAsset {\n  let result = { ...asset };\n\n  // Apply environment override\n  if (options.environment && result.environments?.[options.environment]) {\n    result = mergeOverride(result, result.environments[options.environment]);\n  }\n\n  // Apply tier override\n  if (options.tier && result.tiers?.[options.tier]) {\n    result = mergeOverride(result, result.tiers[options.tier]);\n  }\n\n  // Apply runtime overrides\n  if (options.runtime) {\n    result = mergeOverride(result, options.runtime);\n  }\n\n  return result;\n}\n\nfunction mergeOverride(\n  base: PromptAsset,\n  override: Partial<PromptAssetOverrides>,\n): PromptAsset {\n  const result = { ...base };\n\n  if (override.model !== undefined) result.model = override.model;\n  if (override.fallback_models !== undefined) result.fallback_models = override.fallback_models;\n  if (override.tools !== undefined) result.tools = override.tools;\n\n  if (override.reasoning !== undefined) {\n    result.reasoning = { ...result.reasoning, ...override.reasoning };\n  }\n  if (override.sampling !== undefined) {\n    result.sampling = { ...result.sampling, ...override.sampling };\n  }\n  if (override.response !== undefined) {\n    result.response = { ...result.response, ...override.response };\n  }\n\n  return result;\n}\n","import { applyOverrides } from '../overrides/index.js';\nimport type { ResolvedPromptAsset } from '../schema/index.js';\nimport type { RuntimeRenderOptions } from './types.js';\n\nexport function resolveAssetForProvider(\n  asset: ResolvedPromptAsset,\n  runtime: Pick<RuntimeRenderOptions, 'environment' | 'tier' | 'runtime'> = {},\n): ResolvedPromptAsset {\n  if (!runtime.environment && !runtime.tier && !runtime.runtime) {\n    return asset;\n  }\n\n  return applyOverrides(asset, {\n    environment: runtime.environment,\n    tier: runtime.tier,\n    runtime: runtime.runtime,\n  }) as ResolvedPromptAsset;\n}","import { statSync } from 'node:fs';\n\ninterface CacheEntry<T> {\n  value: T;\n  mtime: number;\n}\n\n/**\n * Simple in-memory LRU cache keyed by file path + mtime.\n * Used to avoid re-parsing prompt files on every renderPrompt() call.\n */\nexport class PromptCache<T> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private maxSize: number;\n\n  constructor(maxSize = 100) {\n    this.maxSize = maxSize;\n  }\n\n  get(filePath: string): T | undefined {\n    const entry = this.cache.get(filePath);\n    if (!entry) return undefined;\n\n    try {\n      const stat = statSync(filePath);\n      if (stat.mtimeMs !== entry.mtime) {\n        this.cache.delete(filePath);\n        return undefined;\n      }\n    } catch {\n      this.cache.delete(filePath);\n      return undefined;\n    }\n\n    // Refresh recency for true LRU semantics.\n    this.cache.delete(filePath);\n    this.cache.set(filePath, entry);\n\n    return entry.value;\n  }\n\n  set(filePath: string, value: T): void {\n    try {\n      const stat = statSync(filePath);\n\n      if (this.cache.has(filePath)) {\n        this.cache.delete(filePath);\n      } else if (this.cache.size >= this.maxSize) {\n        const oldest = this.cache.keys().next().value;\n        if (oldest) this.cache.delete(oldest);\n      }\n\n      this.cache.set(filePath, { value, mtime: stat.mtimeMs });\n    } catch {\n      // Can't stat the file — don't cache\n    }\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  get size(): number {\n    return this.cache.size;\n  }\n}\n","import { readFile } from 'node:fs/promises';\nimport { resolve, dirname } from 'node:path';\nimport { parsePrompt } from '../parser/index.js';\nimport type { PromptAsset } from '../schema/index.js';\n\n/**\n * Resolve includes for a prompt asset, inlining content from referenced files.\n * Detects and rejects circular includes.\n */\nexport async function resolveIncludes(\n  asset: PromptAsset,\n  basePath: string,\n  visited: Set<string> = new Set(),\n): Promise<PromptAsset> {\n  if (!asset.includes || asset.includes.length === 0) {\n    return asset;\n  }\n\n  const baseDir = dirname(basePath);\n  const resolvedPath = resolve(basePath);\n\n  if (visited.has(resolvedPath)) {\n    throw new Error(`Circular include detected: ${resolvedPath}`);\n  }\n  visited.add(resolvedPath);\n\n  let mergedSystemInstructions = '';\n\n  for (const includePath of asset.includes) {\n    const fullPath = resolve(baseDir, includePath);\n\n    if (visited.has(fullPath)) {\n      throw new Error(`Circular include detected: ${fullPath} (included from ${basePath})`);\n    }\n\n    const content = await readFile(fullPath, 'utf-8');\n    const { asset: includedAsset } = parsePrompt(content, fullPath);\n\n    // Recursively resolve nested includes\n    const resolved = await resolveIncludes(includedAsset, fullPath, new Set(visited));\n\n    // Append included system instructions before local ones\n    if (resolved.sections?.system_instructions) {\n      mergedSystemInstructions += resolved.sections.system_instructions + '\\n\\n';\n    }\n  }\n\n  // Prepend included system instructions before the local ones\n  const localSystem = asset.sections?.system_instructions ?? '';\n  const combinedSystem = (mergedSystemInstructions + localSystem).trim() || undefined;\n\n  return {\n    ...asset,\n    sections: {\n      ...asset.sections,\n      system_instructions: combinedSystem,\n    },\n    // Drop includes from the resolved asset — they've been inlined\n    includes: undefined,\n  };\n}\n","import { readFile } from 'node:fs/promises';\nimport { existsSync, statSync } from 'node:fs';\nimport { resolve } from 'node:path';\n\nimport { PromptCache } from './cache.js';\nimport { resolveIncludes } from './composition/index.js';\nimport { applyOverrides } from './overrides/index.js';\nimport { parsePrompt, loadPromptFile } from './parser/index.js';\nimport type { PromptAsset, PromptAssetOverrides, ResolvedPromptAsset } from './schema/index.js';\n\nexport type PromptResolutionMode = 'auto' | 'compiled-only' | 'source-only';\n\nexport const DEFAULT_PROMPTS_DIR = './prompts';\nexport const DEFAULT_COMPILED_JSON_DIR = './.generated-prompts/json';\nexport const DEFAULT_COMPILED_ESM_DIR = './.generated-prompts/esm';\n\nexport interface PromptResolutionConfig {\n  sourceDir?: string;\n  compiledDir?: string;\n  mode?: PromptResolutionMode;\n  cache?: boolean;\n}\n\nexport interface ResolvedPromptResolutionConfig {\n  sourceDir: string;\n  compiledDir: string;\n  mode?: PromptResolutionMode;\n  cache?: boolean;\n}\n\nexport function defaultCompiledDirForFormat(format: 'json' | 'esm'): string {\n  return format === 'esm' ? DEFAULT_COMPILED_ESM_DIR : DEFAULT_COMPILED_JSON_DIR;\n}\n\nexport function withPromptResolutionDefaults(config: PromptResolutionConfig): ResolvedPromptResolutionConfig {\n  return {\n    ...config,\n    sourceDir: config.sourceDir ?? DEFAULT_PROMPTS_DIR,\n    compiledDir: config.compiledDir ?? DEFAULT_COMPILED_JSON_DIR,\n  };\n}\n\nconst sharedPromptCache = new PromptCache<PromptAsset>();\n\nexport async function loadPromptAsset(\n  promptPath: string,\n  config: PromptResolutionConfig,\n  promptCache: PromptCache<PromptAsset> = sharedPromptCache,\n): Promise<PromptAsset> {\n  const resolvedConfig = withPromptResolutionDefaults(config);\n  const mode = resolvedConfig.mode ?? 'auto';\n\n  if (mode !== 'source-only' && resolvedConfig.compiledDir) {\n    const compiledFile = resolve(resolvedConfig.compiledDir, promptPath + '.json');\n    if (existsSync(compiledFile)) {\n      if (mode === 'auto') {\n        const sourceFile = resolve(resolvedConfig.sourceDir, promptPath + '.md');\n        if (existsSync(sourceFile)) {\n          const compiledMtime = statSync(compiledFile).mtimeMs;\n          const sourceMtime = statSync(sourceFile).mtimeMs;\n          if (sourceMtime > compiledMtime) {\n            console.warn(\n              `[promptopskit] Warning: compiled artifact for \"${promptPath}\" is older than source .md file.\\n`\n              + '               Run \"promptopskit compile\" or switch to source-only mode.',\n            );\n          }\n        }\n      }\n\n      const content = await readFile(compiledFile, 'utf-8');\n      return JSON.parse(content) as PromptAsset;\n    }\n\n    if (mode === 'compiled-only') {\n      throw new Error(\n        `Compiled artifact not found: ${compiledFile}\\n`\n        + 'Run \"promptopskit compile\" to generate it.',\n      );\n    }\n  }\n\n  if (mode !== 'compiled-only') {\n    const sourceFile = resolve(resolvedConfig.sourceDir, promptPath + '.md');\n\n    if (resolvedConfig.cache !== false) {\n      const cached = promptCache.get(sourceFile);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    if (!existsSync(sourceFile)) {\n      const paths = [sourceFile];\n      if (resolvedConfig.compiledDir) {\n        paths.unshift(resolve(resolvedConfig.compiledDir, promptPath + '.json'));\n      }\n\n      throw new Error(\n        `Prompt not found: \"${promptPath}\"\\nSearched:\\n${paths.map((candidate) => `  - ${candidate}`).join('\\n')}`,\n      );\n    }\n\n    const { asset } = await loadPromptFile(sourceFile, { defaultsRoot: resolvedConfig.sourceDir });\n\n    if (resolvedConfig.cache !== false) {\n      promptCache.set(sourceFile, asset);\n    }\n\n    return asset;\n  }\n\n  throw new Error(`Prompt not found: \"${promptPath}\"`);\n}\n\nexport async function resolvePromptAsset(\n  promptPath: string,\n  config: PromptResolutionConfig,\n  options: { environment?: string; tier?: string; runtime?: Partial<PromptAssetOverrides> } = {},\n  promptCache: PromptCache<PromptAsset> = sharedPromptCache,\n): Promise<ResolvedPromptAsset> {\n  const resolvedConfig = withPromptResolutionDefaults(config);\n  let asset = await loadPromptAsset(promptPath, resolvedConfig, promptCache);\n\n  const sourceFile = resolve(resolvedConfig.sourceDir, promptPath + '.md');\n  if (asset.includes && asset.includes.length > 0 && existsSync(sourceFile)) {\n    asset = await resolveIncludes(asset, sourceFile);\n  }\n\n  asset = applyOverrides(asset, {\n    environment: options.environment,\n    tier: options.tier,\n    runtime: options.runtime,\n  });\n\n  return asset as ResolvedPromptAsset;\n}\n\nexport function resolveInlinePromptSource(\n  source: string,\n  options: { environment?: string; tier?: string; runtime?: Partial<PromptAssetOverrides> } = {},\n): ResolvedPromptAsset {\n  const { asset } = parsePrompt(source);\n  return applyOverrides(asset, {\n    environment: options.environment,\n    tier: options.tier,\n    runtime: options.runtime,\n  }) as ResolvedPromptAsset;\n}","import type { PromptAsset, ResolvedPromptAsset, ContextInputDefinition } from './schema/index.js';\n\nexport interface NormalizedContextInput {\n  name: string;\n  max_size?: number;\n  trim?: boolean | 'start' | 'end' | 'both';\n  allow_regex?: string;\n  deny_regex?: string;\n}\n\nexport interface ContextSizeWarning {\n  variable: string;\n  maxSize: number;\n  actualSize: number;\n}\n\nexport interface ContextOverflowInfo {\n  promptId: string;\n  variable: string;\n  value: string;\n  maxSize: number;\n  actualSize: number;\n}\n\nexport interface SanitizeContextOptions {\n  onContextOverflow?: (info: ContextOverflowInfo) => string;\n}\n\nconst textEncoder = new TextEncoder();\n\nexport function getContextInputs(\n  asset: Pick<PromptAsset | ResolvedPromptAsset, 'context'>,\n): NormalizedContextInput[] {\n  return (asset.context?.inputs ?? []).map(normalizeContextInput);\n}\n\nexport function getContextInputNames(\n  asset: Pick<PromptAsset | ResolvedPromptAsset, 'context'>,\n): string[] {\n  return getContextInputs(asset).map((input) => input.name);\n}\n\nexport function normalizeContextInput(input: ContextInputDefinition): NormalizedContextInput {\n  if (typeof input === 'string') {\n    return { name: input };\n  }\n\n  return {\n    name: input.name,\n    max_size: input.max_size,\n    trim: input.trim,\n    allow_regex: input.allow_regex,\n    deny_regex: input.deny_regex,\n  };\n}\n\ntype TrimMode = boolean | 'start' | 'end' | 'both';\n\nfunction isTrimEnabled(mode: TrimMode | undefined): mode is true | 'start' | 'end' | 'both' {\n  return mode === true || mode === 'start' || mode === 'end' || mode === 'both';\n}\n\nfunction normalizeTrimMode(mode: TrimMode): 'start' | 'end' {\n  if (mode === 'start') {\n    return 'start';\n  }\n  return 'end';\n}\n\nfunction trimToMaxSize(\n  value: string,\n  maxSize: number,\n  mode: TrimMode,\n): string {\n  const measured = measureContextValueSize(value);\n  if (measured <= maxSize) {\n    return value;\n  }\n\n  const characters = Array.from(value);\n  const normalizedMode = normalizeTrimMode(mode);\n\n  if (normalizedMode === 'start') {\n    let collected = '';\n    let size = 0;\n    for (let i = characters.length - 1; i >= 0; i -= 1) {\n      const next = characters[i];\n      const charSize = measureContextValueSize(next);\n      if (size + charSize > maxSize) {\n        break;\n      }\n      collected = next + collected;\n      size += charSize;\n    }\n    return collected;\n  }\n\n  let collected = '';\n  let size = 0;\n  for (const char of characters) {\n    const charSize = measureContextValueSize(char);\n    if (size + charSize > maxSize) {\n      break;\n    }\n    collected += char;\n    size += charSize;\n  }\n  return collected;\n}\n\nexport function sanitizeContextVariables(\n  asset: Pick<PromptAsset | ResolvedPromptAsset, 'context' | 'id'>,\n  variables: Record<string, string> = {},\n  options: SanitizeContextOptions = {},\n): Record<string, string> {\n  const { onContextOverflow } = options;\n  const sanitized = { ...variables };\n\n  for (const input of getContextInputs(asset)) {\n    const value = sanitized[input.name];\n    if (value === undefined) {\n      continue;\n    }\n\n    let candidate = value;\n\n    if (input.max_size !== undefined) {\n      const actualSize = measureContextValueSize(candidate);\n      if (actualSize > input.max_size && onContextOverflow) {\n        candidate = onContextOverflow({\n          promptId: asset.id,\n          variable: input.name,\n          value: candidate,\n          maxSize: input.max_size,\n          actualSize,\n        });\n      }\n    }\n\n    if (isTrimEnabled(input.trim) && input.max_size !== undefined) {\n      candidate = trimToMaxSize(candidate, input.max_size, input.trim);\n    }\n\n    sanitized[input.name] = candidate;\n\n    if (input.allow_regex) {\n      const candidate = sanitized[input.name];\n      const matcher = new RegExp(input.allow_regex);\n      if (!matcher.test(candidate)) {\n        throw new Error(\n          `POK031: Context variable \"${input.name}\" failed allow_regex validation for prompt \"${asset.id}\".`,\n        );\n      }\n    }\n\n    if (input.deny_regex) {\n      const candidate = sanitized[input.name];\n      const matcher = new RegExp(input.deny_regex);\n      if (matcher.test(candidate)) {\n        throw new Error(\n          `POK032: Context variable \"${input.name}\" matched deny_regex for prompt \"${asset.id}\".`,\n        );\n      }\n    }\n  }\n\n  return sanitized;\n}\n\nexport function measureContextValueSize(value: string): number {\n  return textEncoder.encode(value).length;\n}\n\nexport function collectContextSizeWarnings(\n  asset: Pick<PromptAsset | ResolvedPromptAsset, 'context'>,\n  variables: Record<string, string> = {},\n): ContextSizeWarning[] {\n  const warnings: ContextSizeWarning[] = [];\n\n  for (const input of getContextInputs(asset)) {\n    if (input.max_size === undefined) {\n      continue;\n    }\n\n    const value = variables[input.name];\n    if (value === undefined) {\n      continue;\n    }\n\n    const actualSize = measureContextValueSize(value);\n    if (actualSize > input.max_size) {\n      warnings.push({\n        variable: input.name,\n        maxSize: input.max_size,\n        actualSize,\n      });\n    }\n  }\n\n  return warnings;\n}\n","import { resolveInlinePromptSource, resolvePromptAsset } from '../prompt-resolution.js';\nimport type { ResolvedPromptAsset } from '../schema/index.js';\nimport { sanitizeContextVariables } from '../context.js';\nimport type {\n  ProviderAdapter,\n  ProviderPromptInput,\n  RenderPromptMethod,\n  RuntimeRenderOptions,\n  ValidatePromptMethod,\n} from './types.js';\n\ntype SyncProviderAdapter = Omit<ProviderAdapter, 'validatePrompt' | 'renderPrompt'>;\n\nfunction isPromptLookup(input: ProviderPromptInput): input is Extract<ProviderPromptInput, { path: string }> {\n  return 'path' in input && typeof input.path === 'string';\n}\n\nfunction isInlinePromptSource(input: ProviderPromptInput): input is Extract<ProviderPromptInput, { source: string }> {\n  return 'source' in input && typeof input.source === 'string';\n}\n\nasync function resolveProviderPromptInput(\n  input: ProviderPromptInput,\n  runtime?: Pick<RuntimeRenderOptions, 'environment' | 'tier' | 'runtime'>,\n): Promise<ResolvedPromptAsset> {\n  if (isPromptLookup(input)) {\n    return resolvePromptAsset(input.path, input, runtime);\n  }\n\n  if (isInlinePromptSource(input)) {\n    return resolveInlinePromptSource(input.source, runtime);\n  }\n\n  return input;\n}\n\nexport function withPromptInputSupport(adapter: SyncProviderAdapter): ProviderAdapter {\n  const validatePrompt: ValidatePromptMethod = async (input, runtime) => {\n    const resolved = await resolveProviderPromptInput(input, runtime);\n    return adapter.validate(resolved, runtime);\n  };\n\n  const renderPrompt: RenderPromptMethod = async (input, runtime) => {\n    const resolved = await resolveProviderPromptInput(input, runtime);\n    const variables = sanitizeContextVariables(resolved, runtime.variables, {\n      onContextOverflow: runtime.onContextOverflow,\n    });\n    return adapter.render(resolved, {\n      ...runtime,\n      variables,\n    });\n  };\n\n  return {\n    ...adapter,\n    validatePrompt,\n    renderPrompt,\n  };\n}\n"],"mappings":"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","names":["readFile","statSync","resolve","resolve","statSync","readFile","collected","size","candidate"]}

package/dist/{chunk-ROBYCHAW.js → chunk-SOY2CEJM.js}

@@ -1,9 +1,9 @@
 import {
   openaiAdapter
-} from "./chunk-2X5HFPSD.js";
+} from "./chunk-MN3RQ7DZ.js";
 import {
   withPromptInputSupport
-} from "./chunk-M5VKRDIY.js";
+} from "./chunk-SHYKSLVR.js";
 
 // src/providers/openrouter.ts
 var openrouterAdapter = withPromptInputSupport({
@@ -23,4 +23,4 @@ var openrouterAdapter = withPromptInputSupport({
 export {
   openrouterAdapter
 };
-//# sourceMappingURL=chunk-ROBYCHAW.js.map
+//# sourceMappingURL=chunk-SOY2CEJM.js.map

package/dist/cli/index.js

@@ -43,7 +43,10 @@ var HistorySchema = z.object({
 });
 var ContextInputDefinitionObjectSchema = z.object({
   name: z.string(),
-  max_size: z.number().int().positive().optional()
+  max_size: z.number().int().positive().optional(),
+  trim: z.union([z.boolean(), z.enum(["start", "end", "both"])]).optional(),
+  allow_regex: z.string().optional(),
+  deny_regex: z.string().optional()
 });
 var ContextInputDefinitionSchema = z.union([
   z.string(),
@@ -341,7 +344,10 @@ function normalizeContextInput(input) {
   }
   return {
     name: input.name,
-    max_size: input.max_size
+    max_size: input.max_size,
+    trim: input.trim,
+    allow_regex: input.allow_regex,
+    deny_regex: input.deny_regex
   };
 }
 
@@ -456,6 +462,30 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       });
     }
   }
+  for (const input of getContextInputs(asset)) {
+    if (input.trim !== void 0 && input.trim !== false && input.max_size === void 0) {
+      warnings.push({
+        code: "POK014",
+        message: `Context input "${input.name}" sets trim but has no max_size; trim-to-budget will be skipped.`,
+        filePath
+      });
+    }
+    const checks = [];
+    if (input.allow_regex) checks.push({ pattern: input.allow_regex, kind: "allow_regex" });
+    if (input.deny_regex) checks.push({ pattern: input.deny_regex, kind: "deny_regex" });
+    for (const check of checks) {
+      try {
+        new RegExp(check.pattern);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        errors.push({
+          code: "POK013",
+          message: `Invalid context ${check.kind} for "${input.name}": ${reason}`,
+          filePath
+        });
+      }
+    }
+  }
   return {
     valid: errors.length === 0,
     errors,