PyPI - remdb - Versions diffs - 0.3.242__py3-none-any.whl - Mend

remdb 0.3.242__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of remdb might be problematic. Click here for more details.

Files changed (235) hide show

rem/__init__.py +129 -0
rem/agentic/README.md +760 -0
rem/agentic/__init__.py +54 -0
rem/agentic/agents/README.md +155 -0
rem/agentic/agents/__init__.py +38 -0
rem/agentic/agents/agent_manager.py +311 -0
rem/agentic/agents/sse_simulator.py +502 -0
rem/agentic/context.py +425 -0
rem/agentic/context_builder.py +360 -0
rem/agentic/llm_provider_models.py +301 -0
rem/agentic/mcp/__init__.py +0 -0
rem/agentic/mcp/tool_wrapper.py +273 -0
rem/agentic/otel/__init__.py +5 -0
rem/agentic/otel/setup.py +240 -0
rem/agentic/providers/phoenix.py +926 -0
rem/agentic/providers/pydantic_ai.py +854 -0
rem/agentic/query.py +117 -0
rem/agentic/query_helper.py +89 -0
rem/agentic/schema.py +737 -0
rem/agentic/serialization.py +245 -0
rem/agentic/tools/__init__.py +5 -0
rem/agentic/tools/rem_tools.py +242 -0
rem/api/README.md +657 -0
rem/api/deps.py +253 -0
rem/api/main.py +460 -0
rem/api/mcp_router/prompts.py +182 -0
rem/api/mcp_router/resources.py +820 -0
rem/api/mcp_router/server.py +243 -0
rem/api/mcp_router/tools.py +1605 -0
rem/api/middleware/tracking.py +172 -0
rem/api/routers/admin.py +520 -0
rem/api/routers/auth.py +898 -0
rem/api/routers/chat/__init__.py +5 -0
rem/api/routers/chat/child_streaming.py +394 -0
rem/api/routers/chat/completions.py +702 -0
rem/api/routers/chat/json_utils.py +76 -0
rem/api/routers/chat/models.py +202 -0
rem/api/routers/chat/otel_utils.py +33 -0
rem/api/routers/chat/sse_events.py +546 -0
rem/api/routers/chat/streaming.py +950 -0
rem/api/routers/chat/streaming_utils.py +327 -0
rem/api/routers/common.py +18 -0
rem/api/routers/dev.py +87 -0
rem/api/routers/feedback.py +276 -0
rem/api/routers/messages.py +620 -0
rem/api/routers/models.py +86 -0
rem/api/routers/query.py +362 -0
rem/api/routers/shared_sessions.py +422 -0
rem/auth/README.md +258 -0
rem/auth/__init__.py +36 -0
rem/auth/jwt.py +367 -0
rem/auth/middleware.py +318 -0
rem/auth/providers/__init__.py +16 -0
rem/auth/providers/base.py +376 -0
rem/auth/providers/email.py +215 -0
rem/auth/providers/google.py +163 -0
rem/auth/providers/microsoft.py +237 -0
rem/cli/README.md +517 -0
rem/cli/__init__.py +8 -0
rem/cli/commands/README.md +299 -0
rem/cli/commands/__init__.py +3 -0
rem/cli/commands/ask.py +549 -0
rem/cli/commands/cluster.py +1808 -0
rem/cli/commands/configure.py +495 -0
rem/cli/commands/db.py +828 -0
rem/cli/commands/dreaming.py +324 -0
rem/cli/commands/experiments.py +1698 -0
rem/cli/commands/mcp.py +66 -0
rem/cli/commands/process.py +388 -0
rem/cli/commands/query.py +109 -0
rem/cli/commands/scaffold.py +47 -0
rem/cli/commands/schema.py +230 -0
rem/cli/commands/serve.py +106 -0
rem/cli/commands/session.py +453 -0
rem/cli/dreaming.py +363 -0
rem/cli/main.py +123 -0
rem/config.py +244 -0
rem/mcp_server.py +41 -0
rem/models/core/__init__.py +49 -0
rem/models/core/core_model.py +70 -0
rem/models/core/engram.py +333 -0
rem/models/core/experiment.py +672 -0
rem/models/core/inline_edge.py +132 -0
rem/models/core/rem_query.py +246 -0
rem/models/entities/__init__.py +68 -0
rem/models/entities/domain_resource.py +38 -0
rem/models/entities/feedback.py +123 -0
rem/models/entities/file.py +57 -0
rem/models/entities/image_resource.py +88 -0
rem/models/entities/message.py +64 -0
rem/models/entities/moment.py +123 -0
rem/models/entities/ontology.py +181 -0
rem/models/entities/ontology_config.py +131 -0
rem/models/entities/resource.py +95 -0
rem/models/entities/schema.py +87 -0
rem/models/entities/session.py +84 -0
rem/models/entities/shared_session.py +180 -0
rem/models/entities/subscriber.py +175 -0
rem/models/entities/user.py +93 -0
rem/py.typed +0 -0
rem/registry.py +373 -0
rem/schemas/README.md +507 -0
rem/schemas/__init__.py +6 -0
rem/schemas/agents/README.md +92 -0
rem/schemas/agents/core/agent-builder.yaml +235 -0
rem/schemas/agents/core/moment-builder.yaml +178 -0
rem/schemas/agents/core/rem-query-agent.yaml +226 -0
rem/schemas/agents/core/resource-affinity-assessor.yaml +99 -0
rem/schemas/agents/core/simple-assistant.yaml +19 -0
rem/schemas/agents/core/user-profile-builder.yaml +163 -0
rem/schemas/agents/examples/contract-analyzer.yaml +317 -0
rem/schemas/agents/examples/contract-extractor.yaml +134 -0
rem/schemas/agents/examples/cv-parser.yaml +263 -0
rem/schemas/agents/examples/hello-world.yaml +37 -0
rem/schemas/agents/examples/query.yaml +54 -0
rem/schemas/agents/examples/simple.yaml +21 -0
rem/schemas/agents/examples/test.yaml +29 -0
rem/schemas/agents/rem.yaml +132 -0
rem/schemas/evaluators/hello-world/default.yaml +77 -0
rem/schemas/evaluators/rem/faithfulness.yaml +219 -0
rem/schemas/evaluators/rem/lookup-correctness.yaml +182 -0
rem/schemas/evaluators/rem/retrieval-precision.yaml +199 -0
rem/schemas/evaluators/rem/retrieval-recall.yaml +211 -0
rem/schemas/evaluators/rem/search-correctness.yaml +192 -0
rem/services/__init__.py +18 -0
rem/services/audio/INTEGRATION.md +308 -0
rem/services/audio/README.md +376 -0
rem/services/audio/__init__.py +15 -0
rem/services/audio/chunker.py +354 -0
rem/services/audio/transcriber.py +259 -0
rem/services/content/README.md +1269 -0
rem/services/content/__init__.py +5 -0
rem/services/content/providers.py +760 -0
rem/services/content/service.py +762 -0
rem/services/dreaming/README.md +230 -0
rem/services/dreaming/__init__.py +53 -0
rem/services/dreaming/affinity_service.py +322 -0
rem/services/dreaming/moment_service.py +251 -0
rem/services/dreaming/ontology_service.py +54 -0
rem/services/dreaming/user_model_service.py +297 -0
rem/services/dreaming/utils.py +39 -0
rem/services/email/__init__.py +10 -0
rem/services/email/service.py +522 -0
rem/services/email/templates.py +360 -0
rem/services/embeddings/__init__.py +11 -0
rem/services/embeddings/api.py +127 -0
rem/services/embeddings/worker.py +435 -0
rem/services/fs/README.md +662 -0
rem/services/fs/__init__.py +62 -0
rem/services/fs/examples.py +206 -0
rem/services/fs/examples_paths.py +204 -0
rem/services/fs/git_provider.py +935 -0
rem/services/fs/local_provider.py +760 -0
rem/services/fs/parsing-hooks-examples.md +172 -0
rem/services/fs/paths.py +276 -0
rem/services/fs/provider.py +460 -0
rem/services/fs/s3_provider.py +1042 -0
rem/services/fs/service.py +186 -0
rem/services/git/README.md +1075 -0
rem/services/git/__init__.py +17 -0
rem/services/git/service.py +469 -0
rem/services/phoenix/EXPERIMENT_DESIGN.md +1146 -0
rem/services/phoenix/README.md +453 -0
rem/services/phoenix/__init__.py +46 -0
rem/services/phoenix/client.py +960 -0
rem/services/phoenix/config.py +88 -0
rem/services/phoenix/prompt_labels.py +477 -0
rem/services/postgres/README.md +757 -0
rem/services/postgres/__init__.py +49 -0
rem/services/postgres/diff_service.py +599 -0
rem/services/postgres/migration_service.py +427 -0
rem/services/postgres/programmable_diff_service.py +635 -0
rem/services/postgres/pydantic_to_sqlalchemy.py +562 -0
rem/services/postgres/register_type.py +353 -0
rem/services/postgres/repository.py +481 -0
rem/services/postgres/schema_generator.py +661 -0
rem/services/postgres/service.py +802 -0
rem/services/postgres/sql_builder.py +355 -0
rem/services/rate_limit.py +113 -0
rem/services/rem/README.md +318 -0
rem/services/rem/__init__.py +23 -0
rem/services/rem/exceptions.py +71 -0
rem/services/rem/executor.py +293 -0
rem/services/rem/parser.py +180 -0
rem/services/rem/queries.py +196 -0
rem/services/rem/query.py +371 -0
rem/services/rem/service.py +608 -0
rem/services/session/README.md +374 -0
rem/services/session/__init__.py +13 -0
rem/services/session/compression.py +488 -0
rem/services/session/pydantic_messages.py +310 -0
rem/services/session/reload.py +85 -0
rem/services/user_service.py +130 -0
rem/settings.py +1877 -0
rem/sql/background_indexes.sql +52 -0
rem/sql/migrations/001_install.sql +983 -0
rem/sql/migrations/002_install_models.sql +3157 -0
rem/sql/migrations/003_optional_extensions.sql +326 -0
rem/sql/migrations/004_cache_system.sql +282 -0
rem/sql/migrations/005_schema_update.sql +145 -0
rem/sql/migrations/migrate_session_id_to_uuid.sql +45 -0
rem/utils/AGENTIC_CHUNKING.md +597 -0
rem/utils/README.md +628 -0
rem/utils/__init__.py +61 -0
rem/utils/agentic_chunking.py +622 -0
rem/utils/batch_ops.py +343 -0
rem/utils/chunking.py +108 -0
rem/utils/clip_embeddings.py +276 -0
rem/utils/constants.py +97 -0
rem/utils/date_utils.py +228 -0
rem/utils/dict_utils.py +98 -0
rem/utils/embeddings.py +436 -0
rem/utils/examples/embeddings_example.py +305 -0
rem/utils/examples/sql_types_example.py +202 -0
rem/utils/files.py +323 -0
rem/utils/markdown.py +16 -0
rem/utils/mime_types.py +158 -0
rem/utils/model_helpers.py +492 -0
rem/utils/schema_loader.py +649 -0
rem/utils/sql_paths.py +146 -0
rem/utils/sql_types.py +350 -0
rem/utils/user_id.py +81 -0
rem/utils/vision.py +325 -0
rem/workers/README.md +506 -0
rem/workers/__init__.py +7 -0
rem/workers/db_listener.py +579 -0
rem/workers/db_maintainer.py +74 -0
rem/workers/dreaming.py +502 -0
rem/workers/engram_processor.py +312 -0
rem/workers/sqs_file_processor.py +193 -0
rem/workers/unlogged_maintainer.py +463 -0
remdb-0.3.242.dist-info/METADATA +1632 -0
remdb-0.3.242.dist-info/RECORD +235 -0
remdb-0.3.242.dist-info/WHEEL +4 -0
remdb-0.3.242.dist-info/entry_points.txt +2 -0

rem/services/email/templates.py ADDED Viewed

@@ -0,0 +1,360 @@
+"""
+Email Templates.
+HTML email templates for transactional emails.
+Uses inline CSS for maximum email client compatibility.
+Downstream apps can customize by:
+1. Overriding COLORS dict
+2. Setting custom LOGO_URL and TAGLINE
+3. Creating custom templates using base_template()
+"""
+from dataclasses import dataclass
+from typing import Optional
+# Default colors - override in downstream apps
+COLORS = {
+    "background": "#F5F5F5",
+    "foreground": "#333333",
+    "primary": "#4A90D9",
+    "accent": "#5CB85C",
+    "card": "#FFFFFF",
+    "muted": "#6b7280",
+    "border": "#E0E0E0",
+}
+# Branding - override in downstream apps
+LOGO_URL: str | None = None
+APP_NAME = "REM"
+TAGLINE = "Your AI-powered platform"
+WEBSITE_URL = "https://rem.ai"
+PRIVACY_URL = "https://rem.ai/privacy"
+TERMS_URL = "https://rem.ai/terms"
+@dataclass
+class EmailTemplate:
+    """Email template with subject and HTML body."""
+    subject: str
+    html_body: str
+def base_template(
+    content: str,
+    preheader: Optional[str] = None,
+    colors: dict | None = None,
+    logo_url: str | None = None,
+    app_name: str | None = None,
+    tagline: str | None = None,
+    website_url: str | None = None,
+    privacy_url: str | None = None,
+    terms_url: str | None = None,
+) -> str:
+    """
+    Base email template.
+    Args:
+        content: The main content HTML
+        preheader: Optional preview text shown in email clients
+        colors: Color overrides (merges with COLORS)
+        logo_url: Logo image URL
+        app_name: Application name
+        tagline: Footer tagline
+        website_url: Main website URL
+        privacy_url: Privacy policy URL
+        terms_url: Terms of service URL
+    Returns:
+        Complete HTML email
+    """
+    # Merge colors
+    c = {**COLORS, **(colors or {})}
+    # Use provided values or module defaults
+    logo = logo_url or LOGO_URL
+    name = app_name or APP_NAME
+    tag = tagline or TAGLINE
+    web = website_url or WEBSITE_URL
+    privacy = privacy_url or PRIVACY_URL
+    terms = terms_url or TERMS_URL
+    preheader_html = ""
+    if preheader:
+        preheader_html = f'''
+        <div style="display: none; max-height: 0; overflow: hidden;">
+            {preheader}
+        </div>
+        '''
+    logo_html = ""
+    if logo:
+        logo_html = f'''
+            <img src="{logo}" alt="{name}" width="40" height="40" style="display: block; margin: 0 auto 16px auto; border-radius: 8px;">
+        '''
+    return f'''<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <title>{name}</title>
+    <!--[if mso]>
+    <style type="text/css">
+        body, table, td {{font-family: Arial, sans-serif !important;}}
+    </style>
+    <![endif]-->
+</head>
+<body style="margin: 0; padding: 0; background-color: {c['background']}; font-family: 'Georgia', 'Times New Roman', serif;">
+    {preheader_html}
+    <!-- Email Container -->
+    <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="background-color: {c['background']};">
+        <tr>
+            <td style="padding: 40px 20px;">
+                <!-- Inner Container -->
+                <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="max-width: 560px; margin: 0 auto;">
+                    <!-- Main Content Card -->
+                    <tr>
+                        <td style="background-color: {c['card']}; border-radius: 16px; box-shadow: 0 4px 6px rgba(0, 0, 0, 0.05);">
+                            <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+                                <tr>
+                                    <td style="padding: 40px;">
+                                        {content}
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    <!-- Footer -->
+                    <tr>
+                        <td style="padding: 32px 20px; text-align: center;">
+                            {logo_html}
+                            <!-- Tagline -->
+                            <p style="margin: 0 0 8px 0; font-family: 'Georgia', serif; font-size: 14px; color: {c['muted']}; font-style: italic;">
+                                {tag}
+                            </p>
+                            <!-- Footer Links -->
+                            <p style="margin: 0; font-family: Arial, sans-serif; font-size: 12px; color: {c['muted']};">
+                                <a href="{web}" style="color: {c['primary']}; text-decoration: none;">{name}</a>
+                                &nbsp;&bull;&nbsp;
+                                <a href="{privacy}" style="color: {c['primary']}; text-decoration: none;">Privacy</a>
+                                &nbsp;&bull;&nbsp;
+                                <a href="{terms}" style="color: {c['primary']}; text-decoration: none;">Terms</a>
+                            </p>
+                            <!-- Copyright -->
+                            <p style="margin: 16px 0 0 0; font-family: Arial, sans-serif; font-size: 11px; color: {c['muted']};">
+                                &copy; 2025 {name}. All rights reserved.
+                            </p>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>'''
+def login_code_template(
+    code: str,
+    email: str,
+    colors: dict | None = None,
+    app_name: str | None = None,
+    **kwargs,
+) -> EmailTemplate:
+    """
+    Generate a login code email template.
+    Args:
+        code: The 6-digit login code
+        email: The recipient's email address
+        colors: Color overrides
+        app_name: Application name
+        **kwargs: Additional arguments passed to base_template
+    Returns:
+        EmailTemplate with subject and HTML body
+    """
+    c = {**COLORS, **(colors or {})}
+    name = app_name or APP_NAME
+    # Format code with spaces for readability (e.g., "123 456")
+    formatted_code = f"{code[:3]} {code[3:]}" if len(code) == 6 else code
+    content = f'''
+        <!-- Greeting -->
+        <h1 style="margin: 0 0 8px 0; font-family: 'Arial', sans-serif; font-size: 24px; font-weight: 600; color: {c['foreground']};">
+            Hi there!
+        </h1>
+        <p style="margin: 0 0 24px 0; font-family: 'Georgia', serif; font-size: 16px; line-height: 1.6; color: {c['foreground']};">
+            Here's your login code for {name}. Enter this code to securely access your account.
+        </p>
+        <!-- Code Box -->
+        <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="margin: 0 0 24px 0;">
+            <tr>
+                <td align="center">
+                    <div style="
+                        display: inline-block;
+                        padding: 20px 40px;
+                        background-color: {c['background']};
+                        border: 2px solid {c['border']};
+                        border-radius: 12px;
+                    ">
+                        <span style="
+                            font-family: 'Courier New', monospace;
+                            font-size: 32px;
+                            font-weight: 700;
+                            letter-spacing: 6px;
+                            color: {c['foreground']};
+                        ">{formatted_code}</span>
+                    </div>
+                </td>
+            </tr>
+        </table>
+        <!-- Instructions -->
+        <p style="margin: 0 0 8px 0; font-family: 'Georgia', serif; font-size: 14px; line-height: 1.6; color: {c['muted']};">
+            This code expires in <strong>10 minutes</strong>.
+        </p>
+        <p style="margin: 0 0 24px 0; font-family: 'Georgia', serif; font-size: 14px; line-height: 1.6; color: {c['muted']};">
+            If you didn't request this code, you can safely ignore this email.
+        </p>
+        <!-- Divider -->
+        <hr style="border: none; border-top: 1px solid {c['border']}; margin: 24px 0;">
+        <!-- Security Note -->
+        <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+            <tr>
+                <td style="padding: 16px; background-color: {c['background']}; border-radius: 8px;">
+                    <p style="margin: 0; font-family: Arial, sans-serif; font-size: 12px; color: {c['muted']};">
+                        <strong style="color: {c['primary']};">Security tip:</strong>
+                        Never share your login code with anyone. {name} will never ask for your code via phone or text.
+                    </p>
+                </td>
+            </tr>
+        </table>
+    '''
+    return EmailTemplate(
+        subject=f"Your {name} Login Code",
+        html_body=base_template(
+            content=content,
+            preheader=f"Your login code is {formatted_code}",
+            colors=colors,
+            app_name=app_name,
+            **kwargs,
+        ),
+    )
+def welcome_template(
+    name: Optional[str] = None,
+    colors: dict | None = None,
+    app_name: str | None = None,
+    features: list[str] | None = None,
+    cta_url: str | None = None,
+    cta_text: str = "Get Started",
+    **kwargs,
+) -> EmailTemplate:
+    """
+    Generate a welcome email template for new users.
+    Args:
+        name: Optional user's name
+        colors: Color overrides
+        app_name: Application name
+        features: List of feature descriptions
+        cta_url: Call-to-action button URL
+        cta_text: Call-to-action button text
+        **kwargs: Additional arguments passed to base_template
+    Returns:
+        EmailTemplate with subject and HTML body
+    """
+    c = {**COLORS, **(colors or {})}
+    app = app_name or APP_NAME
+    greeting = f"Hi {name}!" if name else "Welcome!"
+    url = cta_url or WEBSITE_URL
+    # Default features if not provided
+    default_features = [
+        "Access powerful AI capabilities",
+        "Store and organize your data",
+        "Collaborate with your team",
+    ]
+    feature_list = features or default_features
+    features_html = "".join(f"<li>{f}</li>" for f in feature_list)
+    content = f'''
+        <!-- Greeting -->
+        <h1 style="margin: 0 0 8px 0; font-family: 'Arial', sans-serif; font-size: 24px; font-weight: 600; color: {c['foreground']};">
+            {greeting}
+        </h1>
+        <p style="margin: 0 0 24px 0; font-family: 'Georgia', serif; font-size: 16px; line-height: 1.6; color: {c['foreground']};">
+            Welcome to {app}! We're excited to have you on board.
+        </p>
+        <!-- Feature List -->
+        <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="margin: 0 0 24px 0;">
+            <tr>
+                <td style="padding: 16px; background-color: {c['background']}; border-radius: 8px;">
+                    <p style="margin: 0 0 12px 0; font-family: Arial, sans-serif; font-size: 14px; font-weight: 600; color: {c['primary']};">
+                        What you can do with {app}:
+                    </p>
+                    <ul style="margin: 0; padding-left: 20px; font-family: 'Georgia', serif; font-size: 14px; line-height: 1.8; color: {c['foreground']};">
+                        {features_html}
+                    </ul>
+                </td>
+            </tr>
+        </table>
+        <!-- CTA Button -->
+        <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="margin: 0 0 24px 0;">
+            <tr>
+                <td align="center">
+                    <a href="{url}" style="
+                        display: inline-block;
+                        padding: 14px 32px;
+                        background-color: {c['primary']};
+                        color: #FFFFFF;
+                        font-family: Arial, sans-serif;
+                        font-size: 16px;
+                        font-weight: 600;
+                        text-decoration: none;
+                        border-radius: 8px;
+                    ">{cta_text}</a>
+                </td>
+            </tr>
+        </table>
+        <p style="margin: 0; font-family: 'Georgia', serif; font-size: 14px; line-height: 1.6; color: {c['muted']}; text-align: center;">
+            We're glad you're here!
+        </p>
+    '''
+    return EmailTemplate(
+        subject=f"Welcome to {app}",
+        html_body=base_template(
+            content=content,
+            preheader=f"Welcome to {app}! Get started today.",
+            colors=colors,
+            app_name=app_name,
+            **kwargs,
+        ),
+    )

rem/services/embeddings/__init__.py ADDED Viewed

@@ -0,0 +1,11 @@
+"""Embeddings service for background embedding generation."""
+from .api import generate_embedding, generate_embedding_async
+from .worker import EmbeddingTask, EmbeddingWorker
+__all__ = [
+    "EmbeddingTask",
+    "EmbeddingWorker",
+    "generate_embedding",
+    "generate_embedding_async",
+]

rem/services/embeddings/api.py ADDED Viewed

@@ -0,0 +1,127 @@
+"""
+Embedding API utilities for generating embeddings from text.
+Provides synchronous and async wrappers for embedding generation using
+raw HTTP requests (no OpenAI SDK dependency).
+"""
+from typing import Optional, cast
+import httpx
+import requests
+from loguru import logger
+from rem.utils.constants import DEFAULT_EMBEDDING_DIMS, HTTP_TIMEOUT_DEFAULT
+def _get_openai_api_key() -> Optional[str]:
+    """Get OpenAI API key from settings."""
+    from rem.settings import settings
+    return settings.llm.openai_api_key
+def generate_embedding(
+    text: str,
+    model: str = "text-embedding-3-small",
+    provider: str = "openai",
+    api_key: Optional[str] = None,
+) -> list[float]:
+    """
+    Generate embedding for a single text string using requests.
+    Args:
+        text: Text to embed
+        model: Model name (default: text-embedding-3-small)
+        provider: Provider name (default: openai)
+        api_key: API key (defaults to settings.llm.openai_api_key)
+    Returns:
+        Embedding vector (1536 dimensions for text-embedding-3-small)
+    """
+    if provider == "openai":
+        api_key = api_key or _get_openai_api_key()
+        if not api_key:
+            logger.warning("No OpenAI API key - returning zero vector")
+            return [0.0] * DEFAULT_EMBEDDING_DIMS
+        try:
+            logger.debug(f"Generating OpenAI embedding for text using {model}")
+            response = requests.post(
+                "https://api.openai.com/v1/embeddings",
+                headers={
+                    "Authorization": f"Bearer {api_key}",
+                    "Content-Type": "application/json",
+                },
+                json={"input": [text], "model": model},
+                timeout=HTTP_TIMEOUT_DEFAULT,
+            )
+            response.raise_for_status()
+            data = response.json()
+            embedding = data["data"][0]["embedding"]
+            logger.debug(f"Successfully generated embedding (dimension: {len(embedding)})")
+            return cast(list[float], embedding)
+        except Exception as e:
+            logger.error(f"Failed to generate embedding from OpenAI: {e}", exc_info=True)
+            return [0.0] * DEFAULT_EMBEDDING_DIMS
+    else:
+        logger.warning(f"Unsupported provider '{provider}' - returning zero vector")
+        return [0.0] * DEFAULT_EMBEDDING_DIMS
+async def generate_embedding_async(
+    text: str,
+    model: str = "text-embedding-3-small",
+    provider: str = "openai",
+    api_key: Optional[str] = None,
+) -> list[float]:
+    """
+    Generate embedding for a single text string (async version) using httpx.
+    Args:
+        text: Text to embed
+        model: Model name (default: text-embedding-3-small)
+        provider: Provider name (default: openai)
+        api_key: API key (defaults to settings.llm.openai_api_key)
+    Returns:
+        Embedding vector (1536 dimensions for text-embedding-3-small)
+    """
+    if provider == "openai":
+        api_key = api_key or _get_openai_api_key()
+        if not api_key:
+            logger.warning("No OpenAI API key - returning zero vector")
+            return [0.0] * DEFAULT_EMBEDDING_DIMS
+        try:
+            logger.debug(f"Generating OpenAI embedding for text using {model}")
+            async with httpx.AsyncClient() as client:
+                response = await client.post(
+                    "https://api.openai.com/v1/embeddings",
+                    headers={
+                        "Authorization": f"Bearer {api_key}",
+                        "Content-Type": "application/json",
+                    },
+                    json={"input": [text], "model": model},
+                    timeout=HTTP_TIMEOUT_DEFAULT,
+                )
+                response.raise_for_status()
+                data = response.json()
+                embedding = data["data"][0]["embedding"]
+                logger.debug(
+                    f"Successfully generated embedding (dimension: {len(embedding)})"
+                )
+                return cast(list[float], embedding)
+        except Exception as e:
+            logger.error(f"Failed to generate embedding from OpenAI: {e}", exc_info=True)
+            return [0.0] * DEFAULT_EMBEDDING_DIMS
+    else:
+        logger.warning(f"Unsupported provider '{provider}' - returning zero vector")
+        return [0.0] * DEFAULT_EMBEDDING_DIMS