promptopskit 0.3.9 → 0.4.0

package/dist/providers/openrouter.cjs

@@ -103,6 +103,29 @@ function mergeOverride(base, override) {
   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)
+    };
+  }
   if (override.provider_options !== void 0) {
     result.provider_options = {
       ...result.provider_options,
@@ -114,11 +137,19 @@ function mergeOverride(base, override) {
       gemini: {
         ...result.provider_options?.gemini,
         ...override.provider_options.gemini
+      },
+      openrouter: {
+        ...result.provider_options?.openrouter,
+        ...override.provider_options.openrouter
       }
     };
   }
   return result;
 }
+function mergeRecordBlock(base, override) {
+  if (override === void 0) return base;
+  return { ...base, ...override };
+}
 
 // src/providers/resolve-asset.ts
 function resolveAssetForProvider(asset, runtime = {}) {
@@ -222,23 +253,42 @@ var ResponseSchema = import_zod.z.object({
   stream: import_zod.z.boolean().optional(),
   schema: import_zod.z.record(import_zod.z.unknown()).optional(),
   schema_name: import_zod.z.string().optional(),
+  schema_description: import_zod.z.string().optional(),
   schema_strict: import_zod.z.boolean().optional()
 });
 var AnthropicProviderOptionsSchema = import_zod.z.object({
   top_k: import_zod.z.number().int().min(0).optional(),
-  tool_choice: import_zod.z.record(import_zod.z.unknown()).optional()
+  tool_choice: import_zod.z.record(import_zod.z.unknown()).optional(),
+  output_config: import_zod.z.record(import_zod.z.unknown()).optional()
 });
 var GeminiProviderOptionsSchema = import_zod.z.object({
   candidate_count: import_zod.z.number().int().positive().optional(),
   top_k: import_zod.z.number().int().min(0).optional(),
   seed: import_zod.z.number().int().optional(),
   response_schema: import_zod.z.record(import_zod.z.unknown()).optional(),
+  response_json_schema: import_zod.z.record(import_zod.z.unknown()).optional(),
   response_modalities: import_zod.z.array(import_zod.z.string()).optional(),
   thinking_budget_tokens: import_zod.z.number().int().positive().optional()
 });
+var OpenRouterProviderOptionsSchema = import_zod.z.object({
+  provider: import_zod.z.record(import_zod.z.unknown()).optional(),
+  transforms: import_zod.z.array(import_zod.z.string()).optional(),
+  plugins: import_zod.z.array(import_zod.z.record(import_zod.z.unknown())).optional(),
+  models: import_zod.z.array(import_zod.z.string()).optional()
+});
 var ProviderOptionsSchema = import_zod.z.object({
   anthropic: AnthropicProviderOptionsSchema.optional(),
-  gemini: GeminiProviderOptionsSchema.optional()
+  gemini: GeminiProviderOptionsSchema.optional(),
+  openrouter: OpenRouterProviderOptionsSchema.optional()
+});
+var RawProviderBodySchema = import_zod.z.object({
+  openai: import_zod.z.record(import_zod.z.unknown()).optional(),
+  "openai-responses": import_zod.z.record(import_zod.z.unknown()).optional(),
+  openai_responses: import_zod.z.record(import_zod.z.unknown()).optional(),
+  anthropic: import_zod.z.record(import_zod.z.unknown()).optional(),
+  gemini: import_zod.z.record(import_zod.z.unknown()).optional(),
+  google: import_zod.z.record(import_zod.z.unknown()).optional(),
+  openrouter: import_zod.z.record(import_zod.z.unknown()).optional()
 });
 var OpenAICacheSchema = import_zod.z.object({
   prompt_cache_key: import_zod.z.string().min(1).optional(),
@@ -311,6 +361,7 @@ var PromptAssetOverridesSchema = import_zod.z.object({
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
   cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
   tools: import_zod.z.array(ToolRefSchema).optional(),
   provider_options: ProviderOptionsSchema.optional()
 });
@@ -343,6 +394,7 @@ var PromptAssetSchema = import_zod.z.object({
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
   cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
   tools: import_zod.z.array(ToolRefSchema).optional(),
   provider_options: ProviderOptionsSchema.optional(),
   mcp: MCPSchema.optional(),
@@ -356,6 +408,123 @@ var PromptAssetSchema = import_zod.z.object({
   source: SourceSchema.optional()
 });
 
+// src/parser/frontmatter-guard.ts
+var FRONT_MATTER_DELIMITER = /^---[ \t]*$/;
+var REGEX_FIELD = /^(?<indent>\s*)(?<field>allow_regex|deny_regex)\s*:\s*(?<value>.*)$/;
+var PATTERN_FIELD = /^(?<indent>\s*)pattern\s*:\s*(?<value>.*)$/;
+var INLINE_PATTERN_FIELD = /(?:^|[{,]\s*)pattern\s*:\s*(?<value>"(?:\\.|[^"\\])*")/;
+function assertRegexFrontMatterQuoting(content, filePath) {
+  const frontMatter = extractFrontMatter(content);
+  if (!frontMatter) {
+    return;
+  }
+  let pendingRegex;
+  for (const [index, line] of frontMatter.lines.entries()) {
+    const lineNumber = frontMatter.startLine + index;
+    const regexMatch = line.match(REGEX_FIELD);
+    if (regexMatch?.groups) {
+      const field = regexMatch.groups.field;
+      const indent2 = regexMatch.groups.indent.length;
+      const value = regexMatch.groups.value.trim();
+      pendingRegex = value === "" ? { field, indent: indent2 } : void 0;
+      assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber);
+      assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber);
+      continue;
+    }
+    if (!pendingRegex) {
+      continue;
+    }
+    if (line.trim() === "" || line.trimStart().startsWith("#")) {
+      continue;
+    }
+    const indent = line.match(/^\s*/)?.[0].length ?? 0;
+    if (indent <= pendingRegex.indent) {
+      pendingRegex = void 0;
+      continue;
+    }
+    const patternMatch = line.match(PATTERN_FIELD);
+    if (!patternMatch?.groups) {
+      continue;
+    }
+    assertNoUnescapedBackslashInDoubleQuotedRegex(
+      patternMatch.groups.value.trim(),
+      `${pendingRegex.field}.pattern`,
+      filePath,
+      lineNumber
+    );
+  }
+}
+function assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber) {
+  const match = value.match(INLINE_PATTERN_FIELD);
+  const pattern = match?.groups?.value;
+  if (!pattern) {
+    return;
+  }
+  assertNoUnescapedBackslashInDoubleQuotedRegex(pattern, `${field}.pattern`, filePath, lineNumber);
+}
+function extractFrontMatter(content) {
+  const lines = content.split(/\r?\n/);
+  if (!FRONT_MATTER_DELIMITER.test(lines[0] ?? "")) {
+    return void 0;
+  }
+  for (let index = 1; index < lines.length; index += 1) {
+    if (FRONT_MATTER_DELIMITER.test(lines[index] ?? "")) {
+      return {
+        lines: lines.slice(1, index),
+        startLine: 2
+      };
+    }
+  }
+  return void 0;
+}
+function assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber) {
+  if (!value.startsWith('"')) {
+    return;
+  }
+  const quoted = readDoubleQuotedScalar(value);
+  if (!quoted) {
+    return;
+  }
+  if (!hasUnescapedBackslash(quoted)) {
+    return;
+  }
+  const location = filePath ? `${filePath}:${lineNumber}` : `line ${lineNumber}`;
+  throw new Error(
+    `POK013: Invalid context regex YAML at ${location}, field "${field}": double-quoted regex strings treat backslashes as YAML escapes. Use unquoted /pattern/i literal form, single quotes, or double each backslash.`
+  );
+}
+function readDoubleQuotedScalar(value) {
+  let result = "";
+  for (let index = 1; index < value.length; index += 1) {
+    const char = value[index];
+    if (char === '"') {
+      return result;
+    }
+    result += char;
+    if (char === "\\" && index + 1 < value.length) {
+      index += 1;
+      result += value[index];
+    }
+  }
+  return void 0;
+}
+function hasUnescapedBackslash(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    if (value[index] !== "\\") {
+      continue;
+    }
+    let count = 1;
+    while (value[index + count] === "\\") {
+      count += 1;
+    }
+    if (count % 2 === 1) {
+      return true;
+    }
+    index += count - 1;
+  }
+  return false;
+}
+
 // src/parser/sections.ts
 var SECTION_MAP = {
   "system instructions": "system_instructions",
@@ -396,6 +565,7 @@ function extractSections(body) {
 
 // src/parser/parser.ts
 function parsePrompt(content, filePath) {
+  assertRegexFrontMatterQuoting(content, filePath);
   const { data: frontMatter, content: body } = (0, import_gray_matter.default)(content);
   const sections = extractSections(body);
   const raw = {
@@ -952,6 +1122,21 @@ function withPromptInputSupport(adapter) {
   };
 }
 
+// src/providers/raw.ts
+function applyRawProviderBody(body, asset, provider) {
+  const raw = getRawProviderBody(asset, provider);
+  return raw ? { ...body, ...raw } : body;
+}
+function getRawProviderBody(asset, provider) {
+  if (provider === "openai-responses") {
+    return asset.raw?.["openai-responses"] ?? asset.raw?.openai_responses;
+  }
+  if (provider === "gemini") {
+    return asset.raw?.gemini ?? asset.raw?.google;
+  }
+  return asset.raw?.[provider];
+}
+
 // src/providers/openai.ts
 var openaiAdapter = withPromptInputSupport({
   name: "openai",
@@ -1007,6 +1192,7 @@ var openaiAdapter = withPromptInputSupport({
         type: "json_schema",
         json_schema: {
           name: resolvedAsset.response.schema_name ?? `${resolvedAsset.id}_response`,
+          ...resolvedAsset.response.schema_description ? { description: resolvedAsset.response.schema_description } : {},
           schema: resolvedAsset.response.schema,
           strict: resolvedAsset.response.schema_strict ?? true
         }
@@ -1041,7 +1227,7 @@ var openaiAdapter = withPromptInputSupport({
       });
     }
     return {
-      body,
+      body: applyRawProviderBody(body, resolvedAsset, "openai"),
       provider: "openai",
       model: resolvedAsset.model ?? "unknown"
     };
@@ -1052,13 +1238,45 @@ var openaiAdapter = withPromptInputSupport({
 var openrouterAdapter = withPromptInputSupport({
   name: "openrouter",
   validate(asset, runtime) {
-    return openaiAdapter.validate(asset, runtime);
+    const resolvedAsset = resolveAssetForProvider(asset, runtime);
+    const validation = openaiAdapter.validate(asset, runtime);
+    const hasOpenRouterModels = (resolvedAsset.provider_options?.openrouter?.models?.length ?? 0) > 0;
+    if (!hasOpenRouterModels) {
+      return validation;
+    }
+    const modelRequiredError = "OpenAI adapter requires a model to be specified.";
+    const errors = validation.errors.filter((error) => error !== modelRequiredError);
+    const warnings = validation.warnings.filter((warning) => warning !== modelRequiredError);
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings
+    };
   },
   render(asset, runtime) {
-    const result = openaiAdapter.render(asset, runtime);
+    const resolvedAsset = resolveAssetForProvider(asset, runtime);
+    const result = openaiAdapter.render(
+      { ...resolvedAsset, raw: void 0 },
+      {
+        variables: runtime.variables,
+        history: runtime.history,
+        toolRegistry: runtime.toolRegistry,
+        strict: runtime.strict
+      }
+    );
+    const openrouterOptions = resolvedAsset.provider_options?.openrouter;
+    let body = { ...result.body };
+    if (openrouterOptions?.provider !== void 0) body.provider = openrouterOptions.provider;
+    if (openrouterOptions?.transforms !== void 0) body.transforms = openrouterOptions.transforms;
+    if (openrouterOptions?.plugins !== void 0) body.plugins = openrouterOptions.plugins;
+    if (openrouterOptions?.models !== void 0) body.models = openrouterOptions.models;
+    if (body.model === void 0) delete body.model;
+    body = applyRawProviderBody(body, resolvedAsset, "openrouter");
     return {
       ...result,
-      provider: "openrouter"
+      body,
+      provider: "openrouter",
+      model: resolvedAsset.model ?? openrouterOptions?.models?.[0] ?? "unknown"
     };
   }
 });