promptopskit 0.3.7 → 0.3.8

package/dist/index.cjs

@@ -255,7 +255,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({
@@ -264,8 +271,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(),
@@ -628,8 +635,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) {
@@ -655,7 +662,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) {
@@ -787,6 +806,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}".`
         );
@@ -800,12 +830,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}".`
       );
@@ -817,13 +869,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;
@@ -873,12 +936,19 @@ function withPromptInputSupport(adapter) {
   };
   const renderPrompt2 = 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 {
@@ -1786,10 +1856,17 @@ var PromptOpsKit = class {
 ` + validation.errors.map((e) => `  - ${e}`).join("\n")
       );
     }
-    const sanitizedVariables = sanitizeContextVariables(resolved, options.variables, {
+    const sanitization = sanitizeContextVariables(resolved, options.variables, {
       onContextOverflow: options.onContextOverflow
     });
-    const contextSizeWarnings = collectContextSizeWarnings(resolved, sanitizedVariables).map(
+    if (sanitization.shortCircuit) {
+      return {
+        resolved,
+        returnMessage: sanitization.shortCircuit.returnMessage,
+        warnings: validation.warnings
+      };
+    }
+    const contextSizeWarnings = collectContextSizeWarnings(resolved, sanitization.variables).map(
       (warning) => formatContextSizeWarning(resolved, warning)
     );
     const contextWarningPolicy = this.config.warnings?.contextSize;
@@ -1799,7 +1876,7 @@ var PromptOpsKit = class {
       }
     }
     const request = adapter.render(resolved, {
-      variables: sanitizedVariables,
+      variables: sanitization.variables,
       history: options.history,
       toolRegistry: options.toolRegistry,
       strict: options.strict