openaivec 0.13.7__tar.gz → 0.14.1__tar.gz

{openaivec-0.13.7 → openaivec-0.14.1}/.github/copilot-instructions.md

@@ -13,37 +13,40 @@ This repository-wide guide tells GitHub Copilot how to propose code that fits ou
 
 ## Architecture and roles
 
-- `src/openaivec/proxy.py`
+- `src/openaivec/_proxy.py` (internal)
   - Core batching, deduplication, order preservation, and caching
   - `BatchingMapProxy[S, T]` (sync) / `AsyncBatchingMapProxy[S, T]` (async)
   - The map_func contract is strict: return a list of the same length and order as the inputs
   - Progress bars only in notebook environments via `tqdm.auto`, gated by `show_progress=True`
-- `src/openaivec/responses.py`
+- `src/openaivec/_responses.py` (internal)
   - Batched wrapper over OpenAI Responses JSON-mode API
   - `BatchResponses` / `AsyncBatchResponses` use the proxy internally
   - Retries via `backoff`/`backoff_async` for transient errors (RateLimit, 5xx)
   - Reasoning models (o1/o3 family) must use `temperature=None`; helpful guidance on errors
-- `src/openaivec/embeddings.py`
+- `src/openaivec/_embeddings.py` (internal)
   - Batched embeddings (sync/async)
-- `src/openaivec/pandas_ext.py`
+- `src/openaivec/pandas_ext.py` (public)
   - `Series.ai` / `Series.aio` entry points for responses/embeddings
-  - Uses DI container (`provider.CONTAINER`) to get client and model names
+  - Uses DI container (`_provider.CONTAINER`) to get client and model names
   - Supports batch size, progress, and cache sharing (`*_with_cache`)
-- `src/openaivec/spark.py`
+- `src/openaivec/spark.py` (public)
   - UDF builders: `responses_udf` / `task_udf` / `embeddings_udf` / `count_tokens_udf` / `split_to_chunks_udf`
   - Per-partition duplicate caching to reduce API calls
   - Pydantic → Spark StructType schema conversion
-- `src/openaivec/provider.py`
+- `src/openaivec/_provider.py` (internal)
   - DI container and automatic OpenAI/Azure OpenAI client provisioning
-  - Warns if Azure base URL isn’t v1 format
-- `src/openaivec/util.py`
+  - Warns if Azure base URL isn't v1 format
+- `src/openaivec/_util.py` (internal)
   - `backoff` / `backoff_async` and `TextChunker`
-- Additional modules from CLAUDE.md
-  - `src/openaivec/di.py`: lightweight DI container
-  - `src/openaivec/log.py`: logging/observe helpers
-  - `src/openaivec/prompt.py`: few-shot prompt building
-  - `src/openaivec/serialize.py`: Pydantic schema (de)serialization
-  - `src/openaivec/task/`: pre-built, structured task library
+- Additional internal modules
+  - `src/openaivec/_di.py`: lightweight DI container
+  - `src/openaivec/_log.py`: logging/observe helpers
+  - `src/openaivec/_prompt.py`: few-shot prompt building
+  - `src/openaivec/_serialize.py`: Pydantic schema (de)serialization
+  - `src/openaivec/_model.py`: task configuration models
+  - `src/openaivec/_optimize.py`: performance optimization
+- `src/openaivec/task/` (public)
+  - Pre-built, structured task library
 
 ## Dev commands (uv)
 
@@ -76,17 +79,17 @@ uv run mkdocs serve
 
 ## API contracts and critical rules
 
-- Proxy (BatchingMapProxy / AsyncBatchingMapProxy)
+- Proxy (`_proxy.py` - BatchingMapProxy / AsyncBatchingMapProxy)
   - map_func must return a list with the same length and order as inputs; on mismatch, release events and raise ValueError
   - Inputs are de-duplicated while preserving first-occurrence order; outputs are restored to the original order
   - Progress is only shown in notebooks when `show_progress=True`
   - Async version enforces `max_concurrency` via `asyncio.Semaphore`
-- Responses
+- Responses (`_responses.py`)
   - Use OpenAI Responses JSON mode (`responses.parse`)
   - For reasoning models (o1/o3 families), you MUST set `temperature=None`; helpful error messaging is built-in
   - Strongly prefer structured outputs with Pydantic models
   - Retries with exponential backoff for RateLimit/5xx
-- Embeddings
+- Embeddings (`_embeddings.py`)
   - Return NumPy float32 arrays
 - pandas extensions
   - `.ai.responses` / `.ai.embeddings` strictly preserve Series index and length
@@ -97,9 +100,9 @@ uv run mkdocs serve
   - Convert Pydantic models to Spark schemas; treat Enum/Literal as strings
   - Reasoning models require `temperature=None`
   - Provide token counting and text chunking helpers
-- Provider/DI and Azure
+- Provider/DI and Azure (`_provider.py` / `_di.py`)
   - Auto-detect OpenAI vs Azure OpenAI from env vars
-  - Azure requires v1 base URL (warn otherwise) and uses deployment name as the “model”
+  - Azure requires v1 base URL (warn otherwise) and uses deployment name as the "model"
 
 ## Preferred patterns (Do) and Avoid (Don’t)
 
@@ -141,20 +144,26 @@ Don’t
 ## Package Visibility Guidelines (`__all__`)
 
 ### Public API Modules
-These modules are part of the public API and should have comprehensive `__all__` declarations:
-
-- `embeddings.py` - Batch embedding processing
-- `model.py` - Task configuration models  
-- `prompt.py` - Few-shot prompt building
-- `responses.py` - Batch response processing
-- `spark.py` - Apache Spark UDF builders
-- `pandas_ext.py` - Pandas DataFrame/Series extensions
+These modules are part of the public API and have appropriate `__all__` declarations:
+
+- `pandas_ext.py` - Pandas DataFrame/Series extensions with `.ai/.aio` accessors
+- `spark.py` - Apache Spark UDF builders for distributed processing
 - `task/*` - All task modules (NLP, customer support, table operations)
 
-### Internal Modules
-These modules are for internal use only and should have `__all__ = []`:
+### Internal Modules (underscore-prefixed)
+These modules are for internal use only and have `__all__ = []`:
+
+- `_embeddings.py` - Batch embedding processing (internal implementation)
+- `_model.py` - Task configuration models (internal types)
+- `_prompt.py` - Few-shot prompt building (internal implementation)  
+- `_responses.py` - Batch response processing (internal implementation)
+- `_util.py`, `_serialize.py`, `_log.py`, `_provider.py`, `_proxy.py`, `_di.py`, `_optimize.py` - Internal utilities
 
-- All other modules not listed above (util.py, serialize.py, log.py, provider.py, proxy.py, di.py, optimize.py, etc.)
+### Main Package API
+Users access core functionality through `__init__.py` exports:
+- `BatchResponses`, `AsyncBatchResponses`
+- `BatchEmbeddings`, `AsyncBatchEmbeddings` 
+- `PreparedTask`, `FewShotPromptBuilder`
 
 ### `__all__` Best Practices
 
@@ -202,7 +211,7 @@ These modules are for internal use only and should have `__all__ = []`:
 - pandas `.ai` with shared cache
 
   ```python
-  from openaivec.proxy import BatchingMapProxy
+  from openaivec._proxy import BatchingMapProxy
 
   shared = BatchingMapProxy[str, str](batch_size=64)
   df["text"].ai.responses_with_cache("instructions", cache=shared)

{openaivec-0.13.7 → openaivec-0.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openaivec
-Version: 0.13.7
+Version: 0.14.1
 Summary: Generative mutation for tabular calculation
 Project-URL: Homepage, https://microsoft.github.io/openaivec/
 Project-URL: Repository, https://github.com/microsoft/openaivec
@@ -98,7 +98,7 @@ survey_responses.assign(
 ).ai.extract("structured")  # Auto-expands to columns
 ```
 
-📓 **[See more examples →](https://microsoft.github.io/openaivec/examples/)**
+📓 **[See more examples →](https://microsoft.github.io/openaivec/examples/pandas/)**
 
 # Overview
 
@@ -514,7 +514,7 @@ return rendered prompt with XML format.
 Here is an example:
 
 ```python
-from openaivec.prompt import FewShotPromptBuilder
+from openaivec import FewShotPromptBuilder
 
 prompt: str = (
     FewShotPromptBuilder()
@@ -577,7 +577,7 @@ Here is an example:
 
 ```python
 from openai import OpenAI
-from openaivec.prompt import FewShotPromptBuilder
+from openaivec import FewShotPromptBuilder
 
 client = OpenAI(...)
 model_name = "<your-model-name>"
@@ -746,7 +746,7 @@ uv run ruff check . --fix
 📓 **[Survey data transformation →](https://microsoft.github.io/openaivec/examples/survey_transformation/)** - Unstructured to structured data  
 📓 **[Asynchronous processing examples →](https://microsoft.github.io/openaivec/examples/aio/)** - High-performance async workflows  
 📓 **[Auto-generate FAQs from documents →](https://microsoft.github.io/openaivec/examples/generate_faq/)** - Create FAQs using AI  
-📓 **[All examples →](https://microsoft.github.io/openaivec/examples/)** - Complete collection of tutorials and use cases
+📓 **[All examples →](https://microsoft.github.io/openaivec/examples/pandas/)** - Complete collection of tutorials and use cases
 
 ## Community
 

{openaivec-0.13.7 → openaivec-0.14.1}/README.md

@@ -72,7 +72,7 @@ survey_responses.assign(
 ).ai.extract("structured")  # Auto-expands to columns
 ```
 
-📓 **[See more examples →](https://microsoft.github.io/openaivec/examples/)**
+📓 **[See more examples →](https://microsoft.github.io/openaivec/examples/pandas/)**
 
 # Overview
 
@@ -488,7 +488,7 @@ return rendered prompt with XML format.
 Here is an example:
 
 ```python
-from openaivec.prompt import FewShotPromptBuilder
+from openaivec import FewShotPromptBuilder
 
 prompt: str = (
     FewShotPromptBuilder()
@@ -551,7 +551,7 @@ Here is an example:
 
 ```python
 from openai import OpenAI
-from openaivec.prompt import FewShotPromptBuilder
+from openaivec import FewShotPromptBuilder
 
 client = OpenAI(...)
 model_name = "<your-model-name>"
@@ -720,7 +720,7 @@ uv run ruff check . --fix
 📓 **[Survey data transformation →](https://microsoft.github.io/openaivec/examples/survey_transformation/)** - Unstructured to structured data  
 📓 **[Asynchronous processing examples →](https://microsoft.github.io/openaivec/examples/aio/)** - High-performance async workflows  
 📓 **[Auto-generate FAQs from documents →](https://microsoft.github.io/openaivec/examples/generate_faq/)** - Create FAQs using AI  
-📓 **[All examples →](https://microsoft.github.io/openaivec/examples/)** - Complete collection of tutorials and use cases
+📓 **[All examples →](https://microsoft.github.io/openaivec/examples/pandas/)** - Complete collection of tutorials and use cases
 
 ## Community
 

openaivec-0.14.1/docs/api/main.md

@@ -0,0 +1,19 @@
+# Main Package API
+
+The main `openaivec` package provides the core classes for AI-powered data processing.
+
+## Core Classes
+
+All core functionality is accessible through the main package imports:
+
+::: openaivec.BatchResponses
+
+::: openaivec.AsyncBatchResponses
+
+::: openaivec.BatchEmbeddings
+
+::: openaivec.AsyncBatchEmbeddings
+
+## Prompt Building
+
+::: openaivec.FewShotPromptBuilder

openaivec-0.14.1/docs/api/pandas_ext.md

@@ -0,0 +1,3 @@
+# Pandas Extension
+
+::: openaivec.pandas_ext

openaivec-0.14.1/docs/api/spark.md

@@ -0,0 +1,3 @@
+# Spark Extension
+
+::: openaivec.spark

openaivec-0.14.1/docs/api/task.md

@@ -0,0 +1,3 @@
+# Task Module
+
+::: openaivec.task

openaivec-0.14.1/docs/api/tasks/customer_support/customer_sentiment.md

@@ -0,0 +1,3 @@
+# Customer Sentiment Analysis
+
+::: openaivec.task.customer_support.customer_sentiment

openaivec-0.14.1/docs/api/tasks/customer_support/inquiry_classification.md

@@ -0,0 +1,3 @@
+# Inquiry Classification
+
+::: openaivec.task.customer_support.inquiry_classification

openaivec-0.14.1/docs/api/tasks/customer_support/inquiry_summary.md

@@ -0,0 +1,3 @@
+# Inquiry Summary
+
+::: openaivec.task.customer_support.inquiry_summary

openaivec-0.14.1/docs/api/tasks/customer_support/intent_analysis.md

@@ -0,0 +1,3 @@
+# Intent Analysis
+
+::: openaivec.task.customer_support.intent_analysis

openaivec-0.14.1/docs/api/tasks/customer_support/response_suggestion.md

@@ -0,0 +1,3 @@
+# Response Suggestion
+
+::: openaivec.task.customer_support.response_suggestion

openaivec-0.14.1/docs/api/tasks/customer_support/urgency_analysis.md

@@ -0,0 +1,3 @@
+# Urgency Analysis
+
+::: openaivec.task.customer_support.urgency_analysis

openaivec-0.14.1/docs/api/tasks/nlp/dependency_parsing.md

@@ -0,0 +1,3 @@
+# Dependency Parsing Task
+
+::: openaivec.task.nlp.dependency_parsing

openaivec-0.14.1/docs/api/tasks/nlp/keyword_extraction.md

@@ -0,0 +1,3 @@
+# Keyword Extraction Task
+
+::: openaivec.task.nlp.keyword_extraction

openaivec-0.14.1/docs/api/tasks/nlp/morphological_analysis.md

@@ -0,0 +1,3 @@
+# Morphological Analysis Task
+
+::: openaivec.task.nlp.morphological_analysis

openaivec-0.14.1/docs/api/tasks/nlp/named_entity_recognition.md

@@ -0,0 +1,3 @@
+# Named Entity Recognition Task
+
+::: openaivec.task.nlp.named_entity_recognition

openaivec-0.14.1/docs/api/tasks/nlp/sentiment_analysis.md

@@ -0,0 +1,3 @@
+# Sentiment Analysis Task
+
+::: openaivec.task.nlp.sentiment_analysis

openaivec-0.14.1/docs/api/tasks/nlp/translation.md

@@ -0,0 +1,3 @@
+# Translation Task
+
+::: openaivec.task.nlp.translation

{openaivec-0.13.7 → openaivec-0.14.1}/docs/index.md

@@ -67,12 +67,10 @@ Get started with these comprehensive examples:
 
 Detailed documentation for all components:
 
+🔗 **[Main Package](api/main.md)** - Core classes (BatchResponses, BatchEmbeddings, FewShotPromptBuilder)  
 🔗 **[pandas_ext](api/pandas_ext.md)** - Pandas Series and DataFrame extensions  
 🔗 **[spark](api/spark.md)** - Apache Spark UDF builders  
-🔗 **[responses](api/responses.md)** - Batch response processing  
-🔗 **[embeddings](api/embeddings.md)** - Batch embedding generation  
-🔗 **[prompt](api/prompt.md)** - Few-shot prompt building  
-🔗 **[util](api/util.md)** - Utility functions and helpers
+🔗 **[task](api/task.md)** - Pre-built task modules for NLP and customer support
 
 ## Quick Start
 

{openaivec-0.13.7 → openaivec-0.14.1}/mkdocs.yml

@@ -63,13 +63,9 @@ nav:
       - FAQ Generation: examples/generate_faq.ipynb
       - Token Count and Processing Time: examples/batch_size.ipynb
   - API Reference:
-      - di: api/di.md
+      - Main Package: api/main.md
       - pandas_ext: api/pandas_ext.md
       - spark: api/spark.md
-      - prompt: api/prompt.md
-      - util: api/util.md
-      - responses: api/responses.md
-      - embeddings: api/embeddings.md
       - task: api/task.md
   - Task Domains:
       - Natural Language Processing:
@@ -135,8 +131,25 @@ plugins:
         python:
           paths:
             - src
-          docstring_style: google
-          show_submodules: true
+          options:
+            docstring_style: google
+            show_submodules: true
+            show_source: true
+            show_root_heading: true
+            show_root_toc_entry: true
+            heading_level: 2
+            members_order: source
+            show_signature_annotations: true
+            separate_signature: true
+            show_bases: true
+            show_docstring_parameters: true
+            show_docstring_returns: true
+            show_docstring_examples: true
+            show_category_heading: true
+            group_by_category: true
+            show_if_no_docstring: false
+            inherited_members: false
+            merge_init_into_class: true
 
 markdown_extensions:
   - abbr

openaivec-0.14.1/src/openaivec/__init__.py

@@ -0,0 +1,13 @@
+from ._embeddings import AsyncBatchEmbeddings, BatchEmbeddings
+from ._model import PreparedTask
+from ._prompt import FewShotPromptBuilder
+from ._responses import AsyncBatchResponses, BatchResponses
+
+__all__ = [
+    "AsyncBatchEmbeddings",
+    "AsyncBatchResponses",
+    "BatchEmbeddings",
+    "BatchResponses",
+    "FewShotPromptBuilder",
+    "PreparedTask",
+]

openaivec-0.13.7/src/openaivec/embeddings.py → openaivec-0.14.1/src/openaivec/_embeddings.py

@@ -6,9 +6,9 @@ import numpy as np
 from numpy.typing import NDArray
 from openai import AsyncOpenAI, InternalServerError, OpenAI, RateLimitError
 
-from openaivec.log import observe
-from openaivec.proxy import AsyncBatchingMapProxy, BatchingMapProxy
-from openaivec.util import backoff, backoff_async
+from openaivec._log import observe
+from openaivec._proxy import AsyncBatchingMapProxy, BatchingMapProxy
+from openaivec._util import backoff, backoff_async
 
 __all__ = [
     "BatchEmbeddings",

openaivec-0.13.7/src/openaivec/prompt.py → openaivec-0.14.1/src/openaivec/_prompt.py

@@ -51,8 +51,8 @@ from openai import OpenAI
 from openai.types.responses import ParsedResponse
 from pydantic import BaseModel
 
-from openaivec.model import ResponsesModelName
-from openaivec.provider import CONTAINER
+from openaivec._model import ResponsesModelName
+from openaivec._provider import CONTAINER
 
 __all__ = [
     "FewShotPrompt",

openaivec-0.13.7/src/openaivec/provider.py → openaivec-0.14.1/src/openaivec/_provider.py

@@ -4,8 +4,8 @@ import warnings
 import tiktoken
 from openai import AsyncAzureOpenAI, AsyncOpenAI, AzureOpenAI, OpenAI
 
-from openaivec import di
-from openaivec.model import (
+from openaivec import _di as di
+from openaivec._model import (
     AzureOpenAIAPIKey,
     AzureOpenAIAPIVersion,
     AzureOpenAIBaseURL,
@@ -13,7 +13,7 @@ from openaivec.model import (
     OpenAIAPIKey,
     ResponsesModelName,
 )
-from openaivec.util import TextChunker
+from openaivec._util import TextChunker
 
 __all__ = []
 

openaivec-0.13.7/src/openaivec/proxy.py → openaivec-0.14.1/src/openaivec/_proxy.py

@@ -4,7 +4,7 @@ from collections.abc import Hashable
 from dataclasses import dataclass, field
 from typing import Any, Awaitable, Callable, Dict, Generic, List, TypeVar
 
-from openaivec.optimize import BatchSizeSuggester
+from openaivec._optimize import BatchSizeSuggester
 
 __all__ = []
 

openaivec-0.13.7/src/openaivec/responses.py → openaivec-0.14.1/src/openaivec/_responses.py

@@ -7,10 +7,10 @@ from openai import AsyncOpenAI, BadRequestError, InternalServerError, OpenAI, Ra
 from openai.types.responses import ParsedResponse
 from pydantic import BaseModel
 
-from openaivec.log import observe
-from openaivec.model import PreparedTask, ResponseFormat
-from openaivec.proxy import AsyncBatchingMapProxy, BatchingMapProxy
-from openaivec.util import backoff, backoff_async
+from openaivec._log import observe
+from openaivec._model import PreparedTask, ResponseFormat
+from openaivec._proxy import AsyncBatchingMapProxy, BatchingMapProxy
+from openaivec._util import backoff, backoff_async
 
 __all__ = [
     "BatchResponses",

{openaivec-0.13.7 → openaivec-0.14.1}/src/openaivec/pandas_ext.py

@@ -57,11 +57,11 @@ __all__ = [
 ]
 from pydantic import BaseModel
 
-from openaivec.embeddings import AsyncBatchEmbeddings, BatchEmbeddings
-from openaivec.model import EmbeddingsModelName, PreparedTask, ResponseFormat, ResponsesModelName
-from openaivec.provider import CONTAINER, _check_azure_v1_api_url
-from openaivec.proxy import AsyncBatchingMapProxy, BatchingMapProxy
-from openaivec.responses import AsyncBatchResponses, BatchResponses
+from openaivec._embeddings import AsyncBatchEmbeddings, BatchEmbeddings
+from openaivec._model import EmbeddingsModelName, PreparedTask, ResponseFormat, ResponsesModelName
+from openaivec._provider import CONTAINER, _check_azure_v1_api_url
+from openaivec._proxy import AsyncBatchingMapProxy, BatchingMapProxy
+from openaivec._responses import AsyncBatchResponses, BatchResponses
 from openaivec.task.table import FillNaResponse, fillna
 
 __all__ = [
@@ -199,7 +199,7 @@ class OpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.proxy import BatchingMapProxy
+            from openaivec._proxy import BatchingMapProxy
             import numpy as np
 
             # Create a shared cache with custom batch size
@@ -297,8 +297,8 @@ class OpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
-            from openaivec.proxy import BatchingMapProxy
+            from openaivec._model import PreparedTask
+            from openaivec._proxy import BatchingMapProxy
 
             # Create a shared cache with custom batch size
             shared_cache = BatchingMapProxy(batch_size=64)
@@ -330,7 +330,7 @@ class OpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
+            from openaivec._model import PreparedTask
 
             # Assume you have a prepared task for sentiment analysis
             sentiment_task = PreparedTask(...)
@@ -517,7 +517,7 @@ class OpenAIVecDataFrameAccessor:
 
         Example:
             ```python
-            from openaivec.proxy import BatchingMapProxy
+            from openaivec._proxy import BatchingMapProxy
 
             # Create a shared cache with custom batch size
             shared_cache = BatchingMapProxy(batch_size=64)
@@ -614,7 +614,7 @@ class OpenAIVecDataFrameAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
+            from openaivec._model import PreparedTask
 
             # Assume you have a prepared task for data analysis
             analysis_task = PreparedTask(...)
@@ -777,7 +777,7 @@ class AsyncOpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.proxy import AsyncBatchingMapProxy
+            from openaivec._proxy import AsyncBatchingMapProxy
 
             # Create a shared cache with custom batch size and concurrency
             shared_cache = AsyncBatchingMapProxy(batch_size=64, max_concurrency=4)
@@ -829,7 +829,7 @@ class AsyncOpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.proxy import AsyncBatchingMapProxy
+            from openaivec._proxy import AsyncBatchingMapProxy
             import numpy as np
 
             # Create a shared cache with custom batch size and concurrency
@@ -885,8 +885,8 @@ class AsyncOpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
-            from openaivec.proxy import AsyncBatchingMapProxy
+            from openaivec._model import PreparedTask
+            from openaivec._proxy import AsyncBatchingMapProxy
 
             # Create a shared cache with custom batch size and concurrency
             shared_cache = AsyncBatchingMapProxy(batch_size=64, max_concurrency=4)
@@ -1034,7 +1034,7 @@ class AsyncOpenAIVecSeriesAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
+            from openaivec._model import PreparedTask
 
             # Assume you have a prepared task for sentiment analysis
             sentiment_task = PreparedTask(...)
@@ -1117,7 +1117,7 @@ class AsyncOpenAIVecDataFrameAccessor:
 
         Example:
             ```python
-            from openaivec.proxy import AsyncBatchingMapProxy
+            from openaivec._proxy import AsyncBatchingMapProxy
 
             # Create a shared cache with custom batch size and concurrency
             shared_cache = AsyncBatchingMapProxy(batch_size=64, max_concurrency=4)
@@ -1231,7 +1231,7 @@ class AsyncOpenAIVecDataFrameAccessor:
 
         Example:
             ```python
-            from openaivec.model import PreparedTask
+            from openaivec._model import PreparedTask
 
             # Assume you have a prepared task for data analysis
             analysis_task = PreparedTask(...)

{openaivec-0.13.7 → openaivec-0.14.1}/src/openaivec/spark.py

@@ -136,10 +136,10 @@ from pyspark.sql.udf import UserDefinedFunction
 from typing_extensions import Literal
 
 from openaivec import pandas_ext
-from openaivec.model import PreparedTask, ResponseFormat
-from openaivec.proxy import AsyncBatchingMapProxy
-from openaivec.serialize import deserialize_base_model, serialize_base_model
-from openaivec.util import TextChunker
+from openaivec._model import PreparedTask, ResponseFormat
+from openaivec._proxy import AsyncBatchingMapProxy
+from openaivec._serialize import deserialize_base_model, serialize_base_model
+from openaivec._util import TextChunker
 
 __all__ = [
     "responses_udf",

{openaivec-0.13.7 → openaivec-0.14.1}/src/openaivec/task/__init__.py

@@ -32,7 +32,7 @@ Specialized tasks for customer service operations:
 ### Quick Start with Default Tasks
 ```python
 from openai import OpenAI
-from openaivec.responses import BatchResponses
+from openaivec._responses import BatchResponses
 from openaivec.task import nlp, customer_support
 
 client = OpenAI()

{openaivec-0.13.7 → openaivec-0.14.1}/src/openaivec/task/customer_support/customer_sentiment.py

@@ -9,7 +9,7 @@ Example:
 
     ```python
     from openai import OpenAI
-    from openaivec.responses import BatchResponses
+    from openaivec._responses import BatchResponses
     from openaivec.task import customer_support
 
     client = OpenAI()
@@ -65,7 +65,7 @@ from typing import List, Literal
 
 from pydantic import BaseModel, Field
 
-from openaivec.model import PreparedTask
+from openaivec._model import PreparedTask
 
 __all__ = ["customer_sentiment"]
 

{openaivec-0.13.7 → openaivec-0.14.1}/src/openaivec/task/customer_support/inquiry_classification.py

@@ -8,7 +8,7 @@ Example:
 
     ```python
     from openai import OpenAI
-    from openaivec.responses import BatchResponses
+    from openaivec._responses import BatchResponses
     from openaivec.task import customer_support
 
     client = OpenAI()
@@ -96,7 +96,7 @@ from typing import Dict, List, Literal
 
 from pydantic import BaseModel, Field
 
-from openaivec.model import PreparedTask
+from openaivec._model import PreparedTask
 
 __all__ = ["inquiry_classification"]