promptopskit 0.3.7 → 0.3.9

package/dist/providers/openrouter.cjs

@@ -103,6 +103,20 @@ function mergeOverride(base, override) {
   if (override.response !== void 0) {
     result.response = { ...result.response, ...override.response };
   }
+  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
+      }
+    };
+  }
   return result;
 }
 
@@ -205,7 +219,47 @@ 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_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()
+});
+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_modalities: import_zod.z.array(import_zod.z.string()).optional(),
+  thinking_budget_tokens: import_zod.z.number().int().positive().optional()
+});
+var ProviderOptionsSchema = import_zod.z.object({
+  anthropic: AnthropicProviderOptionsSchema.optional(),
+  gemini: GeminiProviderOptionsSchema.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()
@@ -214,7 +268,14 @@ var ContextRegexSchema = import_zod.z.union([
   import_zod.z.string(),
   import_zod.z.object({
     pattern: import_zod.z.string(),
-    flags: import_zod.z.string().optional()
+    flags: import_zod.z.string().optional(),
+    return_message: import_zod.z.string().optional()
+  })
+]);
+var ContextBuiltInValidatorSchema = import_zod.z.union([
+  import_zod.z.boolean(),
+  import_zod.z.object({
+    return_message: import_zod.z.string().optional()
   })
 ]);
 var ContextInputDefinitionObjectSchema = import_zod.z.object({
@@ -223,8 +284,8 @@ var ContextInputDefinitionObjectSchema = import_zod.z.object({
   trim: import_zod.z.union([import_zod.z.boolean(), import_zod.z.enum(["start", "end", "both"])]).optional(),
   allow_regex: ContextRegexSchema.optional(),
   deny_regex: ContextRegexSchema.optional(),
-  non_empty: import_zod.z.boolean().optional(),
-  reject_secrets: import_zod.z.boolean().optional()
+  non_empty: ContextBuiltInValidatorSchema.optional(),
+  reject_secrets: ContextBuiltInValidatorSchema.optional()
 });
 var ContextInputDefinitionSchema = import_zod.z.union([
   import_zod.z.string(),
@@ -249,7 +310,9 @@ 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(),
+  tools: import_zod.z.array(ToolRefSchema).optional(),
+  provider_options: ProviderOptionsSchema.optional()
 });
 var SourceSchema = import_zod.z.object({
   file_path: import_zod.z.string().optional(),
@@ -261,8 +324,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()
@@ -272,13 +336,15 @@ 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(),
   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(),
@@ -584,8 +650,8 @@ function normalizeContextInput(input) {
     trim: input.trim,
     allow_regex: normalizeContextRegex(input.allow_regex),
     deny_regex: normalizeContextRegex(input.deny_regex),
-    non_empty: input.non_empty,
-    reject_secrets: input.reject_secrets
+    non_empty: normalizeBuiltInValidator(input.non_empty),
+    reject_secrets: normalizeBuiltInValidator(input.reject_secrets)
   };
 }
 function normalizeContextRegex(value) {
@@ -611,7 +677,19 @@ function normalizeContextRegex(value) {
   return {
     pattern: value.pattern,
     flags: value.flags ?? "",
-    raw: JSON.stringify(value)
+    raw: JSON.stringify(value),
+    returnMessage: value.return_message
+  };
+}
+function normalizeBuiltInValidator(value) {
+  if (value === void 0 || value === false) {
+    return void 0;
+  }
+  if (value === true) {
+    return {};
+  }
+  return {
+    returnMessage: value.return_message
   };
 }
 function parseRegexLiteral(value) {
@@ -743,6 +821,17 @@ function sanitizeContextVariables(asset, variables = {}, options = {}) {
         field: "allow_regex"
       });
       if (!matcher.test(candidate2)) {
+        if (input.allow_regex.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.allow_regex.returnMessage,
+              code: "POK031",
+              variable: input.name,
+              field: "allow_regex"
+            }
+          };
+        }
         throw new Error(
           `POK031: Context variable "${input.name}" failed allow_regex validation for prompt "${asset.id}".`
         );
@@ -756,12 +845,34 @@ function sanitizeContextVariables(asset, variables = {}, options = {}) {
         field: "deny_regex"
       });
       if (matcher.test(candidate2)) {
+        if (input.deny_regex.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.deny_regex.returnMessage,
+              code: "POK032",
+              variable: input.name,
+              field: "deny_regex"
+            }
+          };
+        }
         throw new Error(
           `POK032: Context variable "${input.name}" matched deny_regex for prompt "${asset.id}".`
         );
       }
     }
     if (input.non_empty && candidate.trim().length === 0) {
+      if (input.non_empty.returnMessage) {
+        return {
+          variables: sanitized,
+          shortCircuit: {
+            returnMessage: input.non_empty.returnMessage,
+            code: "POK033",
+            variable: input.name,
+            field: "non_empty"
+          }
+        };
+      }
       throw new Error(
         `POK033: Context variable "${input.name}" failed non_empty validation for prompt "${asset.id}".`
       );
@@ -773,13 +884,24 @@ function sanitizeContextVariables(asset, variables = {}, options = {}) {
         field: "reject_secrets"
       });
       if (matcher.test(candidate)) {
+        if (input.reject_secrets.returnMessage) {
+          return {
+            variables: sanitized,
+            shortCircuit: {
+              returnMessage: input.reject_secrets.returnMessage,
+              code: "POK034",
+              variable: input.name,
+              field: "reject_secrets"
+            }
+          };
+        }
         throw new Error(
           `POK034: Context variable "${input.name}" matched reject_secrets validation for prompt "${asset.id}".`
         );
       }
     }
   }
-  return sanitized;
+  return { variables: sanitized };
 }
 function measureContextValueSize(value) {
   return textEncoder.encode(value).length;
@@ -808,12 +930,19 @@ function withPromptInputSupport(adapter) {
   };
   const renderPrompt = async (input, runtime) => {
     const resolved = await resolveProviderPromptInput(input, runtime);
-    const variables = sanitizeContextVariables(resolved, runtime.variables, {
+    const sanitization = sanitizeContextVariables(resolved, runtime.variables, {
       onContextOverflow: runtime.onContextOverflow
     });
+    if (sanitization.shortCircuit) {
+      return {
+        provider: adapter.name,
+        model: resolved.model ?? "",
+        returnMessage: sanitization.shortCircuit.returnMessage
+      };
+    }
     return adapter.render(resolved, {
       ...runtime,
-      variables
+      variables: sanitization.variables
     });
   };
   return {
@@ -836,6 +965,9 @@ var openaiAdapter = withPromptInputSupport({
     if (resolvedAsset.reasoning?.budget_tokens !== void 0) {
       warnings.push("OpenAI uses reasoning_effort, not budget_tokens. budget_tokens will be ignored.");
     }
+    if (resolvedAsset.response?.schema !== void 0 && resolvedAsset.response?.format !== "json") {
+      warnings.push("OpenAI response.schema requires response.format: json. schema will still be applied as JSON schema output.");
+    }
     return { valid: errors.length === 0, errors, warnings };
   },
   render(asset, runtime) {
@@ -860,6 +992,7 @@ var openaiAdapter = withPromptInputSupport({
       model: resolvedAsset.model,
       messages
     };
+    const openaiCacheConfig = resolvedAsset.cache?.openai;
     if (resolvedAsset.sampling?.temperature !== void 0) body.temperature = resolvedAsset.sampling.temperature;
     if (resolvedAsset.sampling?.top_p !== void 0) body.top_p = resolvedAsset.sampling.top_p;
     if (resolvedAsset.sampling?.frequency_penalty !== void 0) body.frequency_penalty = resolvedAsset.sampling.frequency_penalty;
@@ -869,12 +1002,27 @@ var openaiAdapter = withPromptInputSupport({
     if (resolvedAsset.reasoning?.effort) {
       body.reasoning_effort = resolvedAsset.reasoning.effort;
     }
-    if (resolvedAsset.response?.format === "json") {
+    if (resolvedAsset.response?.schema) {
+      body.response_format = {
+        type: "json_schema",
+        json_schema: {
+          name: resolvedAsset.response.schema_name ?? `${resolvedAsset.id}_response`,
+          schema: resolvedAsset.response.schema,
+          strict: resolvedAsset.response.schema_strict ?? true
+        }
+      };
+    } else if (resolvedAsset.response?.format === "json") {
       body.response_format = { type: "json_object" };
     }
     if (resolvedAsset.response?.stream !== void 0) {
       body.stream = resolvedAsset.response.stream;
     }
+    if (openaiCacheConfig?.prompt_cache_key) {
+      body.prompt_cache_key = openaiCacheConfig.prompt_cache_key;
+    }
+    if (openaiCacheConfig?.retention) {
+      body.prompt_cache_retention = openaiCacheConfig.retention;
+    }
     if (resolvedAsset.tools && resolvedAsset.tools.length > 0) {
       body.tools = resolvedAsset.tools.map((tool) => {
         if (typeof tool === "string") {