rename from utilities to internals

Author: ks6088ts

.env.template

@@ -51,7 +51,7 @@ AI_SEARCH_KEY="xxx"
 AI_SEARCH_INDEX_NAME="kabuto"
 
 # ---------
-# Utilities
+# Internals
 # ---------
 
 ## CSV Loader Settings

docs/index.ja.md

@@ -130,7 +130,7 @@ Pydantic モデルを使用して AI 応答から構造化データを取得す
 
 - **`template_langgraph/llms/`** - LLM API ラッパー（Azure OpenAI など）
 - **`template_langgraph/tools/`** - 検索、データ取得用ツール実装
-- **`template_langgraph/utilities/`** - ドキュメント読み込みと処理用ヘルパー関数
+- **`template_langgraph/internals/`** - 内部ユーティリティとヘルパー関数（CSV/PDF ローダー、Otel ラッパーなど）
 
 ## サンプルコードの実行
 

docs/index.md

@@ -130,7 +130,7 @@ Implements the supervisor pattern where one agent coordinates multiple specializ
 
 - **`template_langgraph/llms/`** - LLM API wrappers (Azure OpenAI, etc.)
 - **`template_langgraph/tools/`** - Tool implementations for search, data retrieval
-- **`template_langgraph/utilities/`** - Helper functions for document loading and processing
+- **`template_langgraph/internals/`** - Internal utilities and helper functions (CSV/PDF loaders, Otel wrappers, etc.)
 
 ## Running the Examples
 

scripts/ai_search_operator.py

@@ -3,10 +3,10 @@
 import typer
 from dotenv import load_dotenv
 
+from template_langgraph.internals.csv_loaders import CsvLoaderWrapper
+from template_langgraph.internals.pdf_loaders import PdfLoaderWrapper
 from template_langgraph.loggers import get_logger
 from template_langgraph.tools.ai_search_tool import AiSearchClientWrapper
-from template_langgraph.utilities.csv_loaders import CsvLoaderWrapper
-from template_langgraph.utilities.pdf_loaders import PdfLoaderWrapper
 
 # Initialize the Typer application
 app = typer.Typer(

scripts/cosmosdb_operator.py

@@ -3,10 +3,10 @@
 import typer
 from dotenv import load_dotenv
 
+from template_langgraph.internals.csv_loaders import CsvLoaderWrapper
+from template_langgraph.internals.pdf_loaders import PdfLoaderWrapper
 from template_langgraph.loggers import get_logger
 from template_langgraph.tools.cosmosdb_tool import CosmosdbClientWrapper
-from template_langgraph.utilities.csv_loaders import CsvLoaderWrapper
-from template_langgraph.utilities.pdf_loaders import PdfLoaderWrapper
 
 # Initialize the Typer application
 app = typer.Typer(

scripts/elasticsearch_operator.py

@@ -3,9 +3,9 @@
 import typer
 from dotenv import load_dotenv
 
+from template_langgraph.internals.pdf_loaders import PdfLoaderWrapper
 from template_langgraph.loggers import get_logger
 from template_langgraph.tools.elasticsearch_tool import ElasticsearchClientWrapper
-from template_langgraph.utilities.pdf_loaders import PdfLoaderWrapper
 
 # Initialize the Typer application
 app = typer.Typer(

scripts/otel_operator.py

@@ -4,8 +4,8 @@
 import typer
 from dotenv import load_dotenv
 
+from template_langgraph.internals.otel_helpers import OtelWrapper
 from template_langgraph.loggers import get_logger
-from template_langgraph.utilities.otel_helpers import OtelWrapper
 
 # Initialize the Typer application
 app = typer.Typer(

scripts/qdrant_operator.py

@@ -4,10 +4,10 @@
 from dotenv import load_dotenv
 from qdrant_client.models import PointStruct
 
+from template_langgraph.internals.csv_loaders import CsvLoaderWrapper
 from template_langgraph.llms.azure_openais import AzureOpenAiWrapper
 from template_langgraph.loggers import get_logger
 from template_langgraph.tools.qdrant_tool import QdrantClientWrapper
-from template_langgraph.utilities.csv_loaders import CsvLoaderWrapper
 
 # Initialize the Typer application
 app = typer.Typer(