promptopskit 0.3.8 → 0.4.0

package/dist/providers/gemini.cjs

@@ -103,8 +103,53 @@ 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,
+      ...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
+      }
+    };
+  }
   return result;
 }
+function mergeRecordBlock(base, override) {
+  if (override === void 0) return base;
+  return { ...base, ...override };
+}
 
 // src/providers/resolve-asset.ts
 function resolveAssetForProvider(asset, runtime = {}) {
@@ -205,7 +250,66 @@ var SamplingSchema = import_zod.z.object({
 });
 var ResponseSchema = import_zod.z.object({
   format: import_zod.z.enum(["text", "json", "markdown"]).optional(),
-  stream: import_zod.z.boolean().optional()
+  stream: import_zod.z.boolean().optional(),
+  schema: import_zod.z.record(import_zod.z.unknown()).optional(),
+  schema_name: import_zod.z.string().optional(),
+  schema_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(),
+  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(),
+  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(),
+  retention: import_zod.z.enum(["in_memory", "24h"]).optional()
+});
+var AnthropicCacheSchema = import_zod.z.object({
+  mode: import_zod.z.enum(["automatic", "explicit"]).optional(),
+  type: import_zod.z.literal("ephemeral").optional(),
+  ttl: import_zod.z.enum(["5m", "1h"]).optional(),
+  cache_system_instructions: import_zod.z.boolean().optional(),
+  cache_tools: import_zod.z.boolean().optional(),
+  cache_prompt_template: import_zod.z.boolean().optional()
+});
+var GeminiCacheSchema = import_zod.z.object({
+  cached_content: import_zod.z.string().min(1).optional()
+});
+var CacheSchema = import_zod.z.object({
+  openai: OpenAICacheSchema.optional(),
+  anthropic: AnthropicCacheSchema.optional(),
+  gemini: GeminiCacheSchema.optional(),
+  google: GeminiCacheSchema.optional()
 });
 var HistorySchema = import_zod.z.object({
   max_items: import_zod.z.number().int().positive().optional()
@@ -256,7 +360,10 @@ var PromptAssetOverridesSchema = import_zod.z.object({
   reasoning: ReasoningSchema.optional(),
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
-  tools: import_zod.z.array(ToolRefSchema).optional()
+  cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
+  tools: import_zod.z.array(ToolRefSchema).optional(),
+  provider_options: ProviderOptionsSchema.optional()
 });
 var SourceSchema = import_zod.z.object({
   file_path: import_zod.z.string().optional(),
@@ -268,8 +375,9 @@ var SectionsSchema = import_zod.z.object({
   notes: import_zod.z.string().optional()
 });
 var PromptDefaultsSchema = import_zod.z.object({
-  provider: import_zod.z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  provider: import_zod.z.enum(["openai", "openai-responses", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
   model: import_zod.z.string().optional(),
+  cache: CacheSchema.optional(),
   metadata: MetadataSchema.optional(),
   sections: import_zod.z.object({
     system_instructions: import_zod.z.string().optional()
@@ -279,13 +387,16 @@ var PromptAssetSchema = import_zod.z.object({
   id: import_zod.z.string(),
   schema_version: import_zod.z.number().int().positive().default(1),
   description: import_zod.z.string().optional(),
-  provider: import_zod.z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  provider: import_zod.z.enum(["openai", "openai-responses", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
   model: import_zod.z.string().optional(),
   fallback_models: import_zod.z.array(import_zod.z.string()).optional(),
   reasoning: ReasoningSchema.optional(),
   sampling: SamplingSchema.optional(),
   response: ResponseSchema.optional(),
+  cache: CacheSchema.optional(),
+  raw: RawProviderBodySchema.optional(),
   tools: import_zod.z.array(ToolRefSchema).optional(),
+  provider_options: ProviderOptionsSchema.optional(),
   mcp: MCPSchema.optional(),
   context: ContextSchema.optional(),
   includes: import_zod.z.array(import_zod.z.string()).optional(),
@@ -297,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",
@@ -337,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 = {
@@ -893,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/gemini.ts
 var geminiAdapter = withPromptInputSupport({
   name: "gemini",
@@ -900,6 +1144,8 @@ var geminiAdapter = withPromptInputSupport({
     const resolvedAsset = resolveAssetForProvider(asset, runtime);
     const errors = [];
     const warnings = [];
+    const geminiCache = resolvedAsset.cache?.gemini?.cached_content;
+    const googleCache = resolvedAsset.cache?.google?.cached_content;
     if (!resolvedAsset.model) {
       errors.push("Gemini adapter requires a model to be specified.");
     }
@@ -909,6 +1155,12 @@ var geminiAdapter = withPromptInputSupport({
     if (resolvedAsset.sampling?.presence_penalty !== void 0) {
       warnings.push("Gemini does not support presence_penalty. It will be ignored.");
     }
+    if (geminiCache && googleCache && geminiCache !== googleCache) {
+      warnings.push("Both cache.gemini.cached_content and cache.google.cached_content are set. Gemini uses cache.gemini.cached_content.");
+    }
+    if (resolvedAsset.response?.stream !== void 0) {
+      warnings.push("Gemini streaming is endpoint-based (streamGenerateContent), not body-based. response.stream will be ignored.");
+    }
     return { valid: errors.length === 0, errors, warnings };
   },
   render(asset, runtime) {
@@ -935,20 +1187,33 @@ var geminiAdapter = withPromptInputSupport({
     const body = {
       contents
     };
+    const geminiCacheConfig = resolvedAsset.cache?.gemini ?? resolvedAsset.cache?.google;
     if (sections.system_instructions) {
       body.systemInstruction = {
         parts: [{ text: sections.system_instructions }]
       };
     }
     const generationConfig = {};
+    const geminiOptions = resolvedAsset.provider_options?.gemini;
     if (resolvedAsset.sampling?.temperature !== void 0) generationConfig.temperature = resolvedAsset.sampling.temperature;
     if (resolvedAsset.sampling?.top_p !== void 0) generationConfig.topP = resolvedAsset.sampling.top_p;
     if (resolvedAsset.sampling?.max_output_tokens !== void 0) generationConfig.maxOutputTokens = resolvedAsset.sampling.max_output_tokens;
     if (resolvedAsset.sampling?.stop !== void 0) generationConfig.stopSequences = resolvedAsset.sampling.stop;
+    if (geminiOptions?.candidate_count !== void 0) generationConfig.candidateCount = geminiOptions.candidate_count;
+    if (geminiOptions?.top_k !== void 0) generationConfig.topK = geminiOptions.top_k;
+    if (geminiOptions?.seed !== void 0) generationConfig.seed = geminiOptions.seed;
+    if (geminiOptions?.response_modalities !== void 0) generationConfig.responseModalities = geminiOptions.response_modalities;
+    if (resolvedAsset.response?.schema !== void 0) generationConfig.responseJsonSchema = resolvedAsset.response.schema;
+    if (geminiOptions?.response_schema !== void 0) generationConfig.responseSchema = geminiOptions.response_schema;
+    if (geminiOptions?.response_json_schema !== void 0) generationConfig.responseJsonSchema = geminiOptions.response_json_schema;
     if (resolvedAsset.response?.format === "json") {
       generationConfig.responseMimeType = "application/json";
     }
-    if (resolvedAsset.reasoning?.effort) {
+    if (geminiOptions?.thinking_budget_tokens !== void 0) {
+      body.thinkingConfig = {
+        thinkingBudget: geminiOptions.thinking_budget_tokens
+      };
+    } else if (resolvedAsset.reasoning?.effort) {
       body.thinkingConfig = {
         thinkingBudget: resolvedAsset.reasoning.effort === "high" ? 8192 : resolvedAsset.reasoning.effort === "medium" ? 4096 : 1024
       };
@@ -956,6 +1221,9 @@ var geminiAdapter = withPromptInputSupport({
     if (Object.keys(generationConfig).length > 0) {
       body.generationConfig = generationConfig;
     }
+    if (geminiCacheConfig?.cached_content) {
+      body.cachedContent = geminiCacheConfig.cached_content;
+    }
     if (resolvedAsset.tools && resolvedAsset.tools.length > 0) {
       const functionDeclarations = resolvedAsset.tools.map((tool) => {
         if (typeof tool === "string") {
@@ -972,7 +1240,7 @@ var geminiAdapter = withPromptInputSupport({
       body.tools = [{ functionDeclarations }];
     }
     return {
-      body,
+      body: applyRawProviderBody(body, resolvedAsset, "gemini"),
       provider: "gemini",
       model: resolvedAsset.model ?? "unknown"
     };