docs, core: error messaging [wip] (#27397)

libs/core/langchain_core/prompts/base.py

@@ -21,6 +21,7 @@ import yaml
 from pydantic import BaseModel, ConfigDict, Field, model_validator
 from typing_extensions import Self, override
 
+from langchain_core.exceptions import ErrorCode, create_message
 from langchain_core.load import dumpd
 from langchain_core.output_parsers.base import BaseOutputParser
 from langchain_core.prompt_values import (
@@ -74,18 +75,24 @@ class BasePromptTemplate(
                 "Cannot have an input variable named 'stop', as it is used internally,"
                 " please rename."
             )
-            raise ValueError(msg)
+            raise ValueError(
+                create_message(message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT)
+            )
         if "stop" in self.partial_variables:
             msg = (
                 "Cannot have an partial variable named 'stop', as it is used "
                 "internally, please rename."
             )
-            raise ValueError(msg)
+            raise ValueError(
+                create_message(message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT)
+            )
 
         overall = set(self.input_variables).intersection(self.partial_variables)
         if overall:
             msg = f"Found overlapping input and partial variables: {overall}"
-            raise ValueError(msg)
+            raise ValueError(
+                create_message(message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT)
+            )
         return self
 
     @classmethod
@@ -148,7 +155,11 @@ class BasePromptTemplate(
                     f"Expected mapping type as input to {self.__class__.__name__}. "
                     f"Received {type(inner_input)}."
                 )
-                raise TypeError(msg)
+                raise TypeError(
+                    create_message(
+                        message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT
+                    )
+                )
         missing = set(self.input_variables).difference(inner_input)
         if missing:
             msg = (
@@ -162,7 +173,9 @@ class BasePromptTemplate(
                 " and not a variable, please escape it with double curly braces like: "
                 f"'{{{{{example_key}}}}}'."
             )
-            raise KeyError(msg)
+            raise KeyError(
+                create_message(message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT)
+            )
         return inner_input
 
     def _format_prompt_with_error_handling(self, inner_input: dict) -> PromptValue:
@@ -381,7 +394,9 @@ def _get_document_info(doc: Document, prompt: BasePromptTemplate[str]) -> dict:
             f"{required_metadata}. Received document with missing metadata: "
             f"{list(missing_metadata)}."
         )
-        raise ValueError(msg)
+        raise ValueError(
+            create_message(message=msg, error_code=ErrorCode.INVALID_PROMPT_INPUT)
+        )
     return {k: base_info[k] for k in prompt.input_variables}