promptopskit 0.3.3 → 0.3.5

package/README.md

@@ -34,7 +34,7 @@ npm install promptopskit
 ### 1. Scaffold starter prompts
 
 ```bash
-npx promptopskit init ./prompts
+npx promptopskit init
 npx promptopskit skill
 ```
 
@@ -84,7 +84,7 @@ You are a helpful support assistant working in {{ app_context }}.
 ```typescript
 import { createPromptOpsKit } from 'promptopskit';
 
-const kit = createPromptOpsKit({ sourceDir: './prompts' });
+const kit = createPromptOpsKit();
 
 const result = await kit.renderPrompt({
   path: 'support/reply',
@@ -110,7 +110,6 @@ You can control context size warning behavior at the kit level:
 
 ```typescript
 const kit = createPromptOpsKit({
-  sourceDir: './prompts',
   warnings: {
     contextSize: process.env.NODE_ENV === 'production' ? 'off' : 'console-and-result',
   },
@@ -141,7 +140,7 @@ Each adapter produces a `{ body, provider, model }` object shaped for the target
 ```typescript
 // OpenAI
 import { createPromptOpsKit } from 'promptopskit';
-const kit = createPromptOpsKit({ sourceDir: './prompts' });
+const kit = createPromptOpsKit();
 const { request } = await kit.renderPrompt({
   path: 'hello',
   provider: 'openai',
@@ -187,7 +186,7 @@ Direct adapter rendering also accepts `environment` and `tier` selectors. This i
 ```typescript
 import type { ResolvedPromptAsset } from 'promptopskit';
 import { openaiAdapter } from 'promptopskit/openai';
-import compiledPrompt from './dist/prompts/summarizePullRequest.mjs';
+import compiledPrompt from './.generated-prompts/esm/summarizePullRequest.mjs';
 
 const prompt = compiledPrompt as ResolvedPromptAsset;
 
@@ -207,17 +206,14 @@ const request = openaiAdapter.render(prompt, {
 
 In browser or client-side code, keep provider credentials on the server. Use the rendered request body with your own server endpoint, server action, or edge function rather than calling a provider directly from the client.
 
-On the server, adapters also provide async prompt-aware helpers so you can pass a prompt key plus `sourceDir` and `compiledDir` without creating a `PromptOpsKit` instance:
+On the server, adapters also provide async prompt-aware helpers so you can use the default `./prompts` and `./.generated-prompts/json` directories without creating a `PromptOpsKit` instance:
 
 ```typescript
-import path from 'node:path';
 import { openaiAdapter } from 'promptopskit/openai';
 
 const request = await openaiAdapter.renderPrompt(
   {
     path: 'summarizePullRequest',
-    sourceDir: path.join(process.cwd(), 'prompts'),
-    compiledDir: path.join(process.cwd(), 'output-json'),
   },
   {
     environment: 'dev',
@@ -229,6 +225,8 @@ const request = await openaiAdapter.renderPrompt(
 );
 ```
 
+If you need a different layout, keep passing `sourceDir` and `compiledDir` explicitly.
+
 `renderPrompt()` and `validatePrompt()` use the same source-versus-compiled resolution rules as `kit.renderPrompt()`. The existing synchronous `render()` and `validate()` methods still work for already-resolved compiled or inline assets.
 
 ## Optional UsageTap Tracking
@@ -386,7 +384,7 @@ promptopskit skill
 promptopskit validate <dir> [--strict]
 
 # Compile .md → JSON/ESM artifacts
-promptopskit compile <src> <out> [--dry-run] [--format json|esm] [--no-clean]
+promptopskit compile [src] [out] [--dry-run] [--format json|esm] [--no-clean]
 
 # Render a prompt preview (auto-loads .test.yaml sidecar)
 promptopskit render <file> [--env <name>] [--tier <name>] [--vars <file>] [--json]

package/SKILL.md

@@ -258,7 +258,7 @@ import { createPromptOpsKit } from 'promptopskit';
 
 const kit = createPromptOpsKit({
   sourceDir: './prompts',
-  compiledDir: './dist/prompts',
+  compiledDir: './.generated-prompts/json',
   warnings: {
     contextSize: process.env.NODE_ENV === 'production' ? 'off' : 'console-and-result',
   },
@@ -289,7 +289,7 @@ const request = await openaiAdapter.renderPrompt(
   {
     path: 'support/reply',
     sourceDir: path.join(process.cwd(), 'prompts'),
-    compiledDir: path.join(process.cwd(), 'dist/prompts'),
+    compiledDir: path.join(process.cwd(), '.generated-prompts', 'json'),
   },
   {
     environment: 'production',
@@ -311,7 +311,7 @@ const request = await openaiAdapter.renderPrompt(
 ```typescript
 import type { ResolvedPromptAsset } from 'promptopskit';
 import { openaiAdapter } from 'promptopskit/openai';
-import compiledPrompt from './dist/prompts/support/reply.mjs';
+import compiledPrompt from './.generated-prompts/esm/support/reply.mjs';
 
 const prompt = compiledPrompt as ResolvedPromptAsset;
 
@@ -344,13 +344,13 @@ Prompts should usually be validated and compiled as part of the normal build pip
 {
   "scripts": {
     "validate:prompts": "promptopskit validate ./prompts --strict",
-    "build:prompts": "promptopskit compile ./prompts ./dist/prompts --format json",
+    "build:prompts": "promptopskit compile",
     "build": "npm run validate:prompts && npm run build:prompts && tsup"
   }
 }
 ```
 
-Use `--format json` for server-side Node usage where prompts are loaded from disk. Use `--format esm` when prompts need to be imported into a bundle.
+`promptopskit compile` defaults to JSON output in `./.generated-prompts/json`, which matches runtime `compiledDir` loading. Use `promptopskit compile --format esm` when prompts need to be imported into a bundle; those artifacts default to `./.generated-prompts/esm`.
 
 ### Build strategy by environment
 
@@ -362,7 +362,7 @@ Use `--format json` for server-side Node usage where prompts are loaded from dis
 
 - Add `validate:prompts` before `build:prompts` so schema or variable mistakes fail fast
 - Treat compiled artifacts as build outputs, not the source of truth
-- Keep prompt source in `./prompts` and compiled output in a generated directory such as `./dist/prompts` or `./src/generated/prompts`
+- Keep prompt source in `./prompts`; use `./.generated-prompts/json` as the default server output and `./.generated-prompts/esm` for imported client artifacts unless a project-specific build layout needs something else
 - If using `createPromptOpsKit` in `auto` mode, point both `sourceDir` and `compiledDir` at those directories so local development can fall back to source when artifacts are stale or missing
 
 ### Typical server-side setup
@@ -372,7 +372,7 @@ import { createPromptOpsKit } from 'promptopskit';
 
 export const prompts = createPromptOpsKit({
   sourceDir: './prompts',
-  compiledDir: './dist/prompts',
+  compiledDir: './.generated-prompts/json',
   mode: 'auto',
 });
 ```
@@ -432,7 +432,7 @@ Hello {{ name }}
 |---------|-------------|
 | `promptopskit init [dir]` | Scaffold a prompts directory with starter files (including `defaults.md`) |
 | `promptopskit validate <dir>` | Validate all prompt files in a directory |
-| `promptopskit compile <src> <out>` | Compile `.md` prompts to JSON or ESM artifacts |
+| `promptopskit compile [src] [out]` | Compile `.md` prompts to JSON or ESM artifacts |
 | `promptopskit render <file>` | Render a prompt preview |
 | `promptopskit inspect <file>` | Print the normalized prompt asset |
 

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

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

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

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

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

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

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

@@ -185,14 +185,24 @@ async function resolveIncludes(asset, basePath, visited = /* @__PURE__ */ new Se
 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 mode = config.mode ?? "auto";
-  if (mode !== "source-only" && config.compiledDir) {
-    const compiledFile = resolve2(config.compiledDir, promptPath + ".json");
+  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(config.sourceDir, promptPath + ".md");
+        const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
         if (existsSync(sourceFile)) {
           const compiledMtime = statSync2(compiledFile).mtimeMs;
           const sourceMtime = statSync2(sourceFile).mtimeMs;
@@ -215,8 +225,8 @@ Run "promptopskit compile" to generate it.`
     }
   }
   if (mode !== "compiled-only") {
-    const sourceFile = resolve2(config.sourceDir, promptPath + ".md");
-    if (config.cache !== false) {
+    const sourceFile = resolve2(resolvedConfig.sourceDir, promptPath + ".md");
+    if (resolvedConfig.cache !== false) {
       const cached = promptCache.get(sourceFile);
       if (cached) {
         return cached;
@@ -224,8 +234,8 @@ Run "promptopskit compile" to generate it.`
     }
     if (!existsSync(sourceFile)) {
       const paths = [sourceFile];
-      if (config.compiledDir) {
-        paths.unshift(resolve2(config.compiledDir, promptPath + ".json"));
+      if (resolvedConfig.compiledDir) {
+        paths.unshift(resolve2(resolvedConfig.compiledDir, promptPath + ".json"));
       }
       throw new Error(
         `Prompt not found: "${promptPath}"
@@ -233,8 +243,8 @@ Searched:
 ${paths.map((candidate) => `  - ${candidate}`).join("\n")}`
       );
     }
-    const { asset } = await loadPromptFile(sourceFile, { defaultsRoot: config.sourceDir });
-    if (config.cache !== false) {
+    const { asset } = await loadPromptFile(sourceFile, { defaultsRoot: resolvedConfig.sourceDir });
+    if (resolvedConfig.cache !== false) {
       promptCache.set(sourceFile, asset);
     }
     return asset;
@@ -242,8 +252,9 @@ ${paths.map((candidate) => `  - ${candidate}`).join("\n")}`
   throw new Error(`Prompt not found: "${promptPath}"`);
 }
 async function resolvePromptAsset(promptPath, config, options = {}, promptCache = sharedPromptCache) {
-  let asset = await loadPromptAsset(promptPath, config, promptCache);
-  const sourceFile = resolve2(config.sourceDir, promptPath + ".md");
+  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);
   }
@@ -265,7 +276,7 @@ function resolveInlinePromptSource(source, options = {}) {
 
 // src/providers/prompt-input.ts
 function isPromptLookup(input) {
-  return "path" in input && typeof input.path === "string" && "sourceDir" in input;
+  return "path" in input && typeof input.path === "string";
 }
 function isInlinePromptSource(input) {
   return "source" in input && typeof input.source === "string";
@@ -303,9 +314,11 @@ export {
   resolveAssetForProvider,
   PromptCache,
   resolveIncludes,
+  DEFAULT_PROMPTS_DIR,
+  withPromptResolutionDefaults,
   loadPromptAsset,
   resolvePromptAsset,
   resolveInlinePromptSource,
   withPromptInputSupport
 };
-//# sourceMappingURL=chunk-S5YHGHK5.js.map
+//# sourceMappingURL=chunk-M5VKRDIY.js.map

package/dist/chunk-M5VKRDIY.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/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 { resolveInlinePromptSource, resolvePromptAsset } from '../prompt-resolution.js';\nimport type { ResolvedPromptAsset } from '../schema/index.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    return adapter.render(resolved, runtime);\n  };\n\n  return {\n    ...adapter,\n    validatePrompt,\n    renderPrompt,\n  };\n}"],"mappings":"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","names":["readFile","statSync","resolve","resolve","statSync","readFile"]}

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

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