business-stack 0.1.0

package/backend/alembic/versions/9f0a1b2c3d4e_entity_mentions_cooccurrence.py

@@ -0,0 +1,123 @@
+"""entity_mentions (document + optional chunk) + entity_cooccurrence
+
+Revision ID: 9f0a1b2c3d4e
+Revises: 7d8e9f0a1b2c
+Create Date: 2026-04-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "9f0a1b2c3d4e"
+down_revision: str | None = "7d8e9f0a1b2c"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute(sa.text("PRAGMA foreign_keys=ON"))
+    op.create_table(
+        "entity_mentions",
+        sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
+        sa.Column("document_id", sa.Text(), nullable=False),
+        sa.Column("entity_id", sa.Integer(), nullable=False),
+        sa.Column("document_chunk_id", sa.Integer(), nullable=False),
+        sa.Column("confidence", sa.Float(), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["document_id"],
+            ["documents.id"],
+            name="fk_entity_mentions_document_id_documents",
+            ondelete="CASCADE",
+        ),
+        sa.ForeignKeyConstraint(
+            ["entity_id"],
+            ["entities.id"],
+            name="fk_entity_mentions_entity_id_entities",
+            ondelete="CASCADE",
+        ),
+        sa.ForeignKeyConstraint(
+            ["document_chunk_id"],
+            ["document_chunks.id"],
+            name="fk_entity_mentions_document_chunk_id_document_chunks",
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name="pk_entity_mentions"),
+        sa.CheckConstraint(
+            "confidence IS NULL OR (confidence >= 0 AND confidence <= 1)",
+            name="ck_entity_mentions_confidence",
+        ),
+    )
+    op.create_index(
+        "ix_entity_mentions_document",
+        "entity_mentions",
+        ["document_id"],
+    )
+    op.create_index(
+        "ix_entity_mentions_entity",
+        "entity_mentions",
+        ["entity_id"],
+    )
+    op.create_index(
+        "uq_entity_mentions_doc_entity_chunk",
+        "entity_mentions",
+        ["document_id", "entity_id", "document_chunk_id"],
+        unique=True,
+    )
+
+    op.create_table(
+        "entity_cooccurrence",
+        sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
+        sa.Column("entity_low_id", sa.Integer(), nullable=False),
+        sa.Column("entity_high_id", sa.Integer(), nullable=False),
+        sa.Column("document_id", sa.Text(), nullable=False),
+        sa.Column("weight", sa.Float(), nullable=False, server_default="1.0"),
+        sa.ForeignKeyConstraint(
+            ["document_id"],
+            ["documents.id"],
+            name="fk_entity_cooccurrence_document_id_documents",
+            ondelete="CASCADE",
+        ),
+        sa.ForeignKeyConstraint(
+            ["entity_low_id"],
+            ["entities.id"],
+            name="fk_entity_cooccurrence_entity_low_id_entities",
+            ondelete="CASCADE",
+        ),
+        sa.ForeignKeyConstraint(
+            ["entity_high_id"],
+            ["entities.id"],
+            name="fk_entity_cooccurrence_entity_high_id_entities",
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("id", name="pk_entity_cooccurrence"),
+        sa.CheckConstraint(
+            "entity_low_id < entity_high_id",
+            name="ck_entity_cooccurrence_ordered_pair",
+        ),
+        sa.UniqueConstraint(
+            "entity_low_id",
+            "entity_high_id",
+            "document_id",
+            name="uq_entity_cooccurrence_triple",
+        ),
+    )
+    op.create_index(
+        "ix_entity_cooccurrence_document",
+        "entity_cooccurrence",
+        ["document_id"],
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_entity_cooccurrence_document", table_name="entity_cooccurrence")
+    op.drop_table("entity_cooccurrence")
+    op.drop_index(
+        "uq_entity_mentions_doc_entity_chunk",
+        table_name="entity_mentions",
+    )
+    op.drop_index("ix_entity_mentions_entity", table_name="entity_mentions")
+    op.drop_index("ix_entity_mentions_document", table_name="entity_mentions")
+    op.drop_table("entity_mentions")

package/backend/alembic/versions/b1c2d3e4f5a6_pipeline_dedupe_dlq.py

@@ -0,0 +1,99 @@
+"""documents dedupe + normalization_error; embedding_dlq
+
+Revision ID: b1c2d3e4f5a6
+Revises: 9f0a1b2c3d4e
+Create Date: 2026-04-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "b1c2d3e4f5a6"
+down_revision: str | None = "9f0a1b2c3d4e"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+_TS_DEFAULT = sa.text("(strftime('%Y-%m-%dT%H:%M:%fZ','now'))")
+
+
+def upgrade() -> None:
+    op.execute(sa.text("PRAGMA foreign_keys=ON"))
+    with op.batch_alter_table("documents") as batch:
+        batch.add_column(sa.Column("external_id", sa.Text(), nullable=True))
+        batch.add_column(sa.Column("dedupe_content_hash", sa.Text(), nullable=True))
+        batch.add_column(sa.Column("normalization_error", sa.Text(), nullable=True))
+
+    op.create_index("ix_documents_source_external", "documents", ["source_id", "external_id"])
+    op.execute(
+        sa.text(
+            "CREATE UNIQUE INDEX uq_documents_source_external_id "
+            "ON documents (source_id, external_id) "
+            "WHERE external_id IS NOT NULL AND trim(external_id) != ''",
+        ),
+    )
+    op.create_index(
+        "ix_documents_source_dedupe_hash",
+        "documents",
+        ["source_id", "dedupe_content_hash"],
+    )
+    op.execute(
+        sa.text(
+            "CREATE UNIQUE INDEX uq_documents_source_dedupe_hash "
+            "ON documents (source_id, dedupe_content_hash) "
+            "WHERE dedupe_content_hash IS NOT NULL AND trim(dedupe_content_hash) != ''",
+        ),
+    )
+
+    op.create_table(
+        "embedding_dlq",
+        sa.Column("document_id", sa.Text(), nullable=False),
+        sa.Column("last_error", sa.Text(), nullable=False),
+        sa.Column("attempt_count", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("next_retry_at", sa.Text(), nullable=True),
+        sa.Column(
+            "state",
+            sa.Text(),
+            nullable=False,
+            server_default="pending_retry",
+        ),
+        sa.Column(
+            "multimodal",
+            sa.Integer(),
+            nullable=False,
+            server_default="0",
+        ),
+        sa.Column("created_at", sa.Text(), nullable=False, server_default=_TS_DEFAULT),
+        sa.Column("updated_at", sa.Text(), nullable=False, server_default=_TS_DEFAULT),
+        sa.CheckConstraint(
+            "state IN ('pending_retry','dead')",
+            name="ck_embedding_dlq_state",
+        ),
+        sa.ForeignKeyConstraint(
+            ["document_id"],
+            ["documents.id"],
+            name="fk_embedding_dlq_document_id_documents",
+            ondelete="CASCADE",
+        ),
+        sa.PrimaryKeyConstraint("document_id", name="pk_embedding_dlq"),
+    )
+    op.create_index(
+        "ix_embedding_dlq_next_retry",
+        "embedding_dlq",
+        ["next_retry_at", "state"],
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_embedding_dlq_next_retry", table_name="embedding_dlq")
+    op.drop_table("embedding_dlq")
+    op.execute(sa.text("DROP INDEX IF EXISTS uq_documents_source_dedupe_hash"))
+    op.drop_index("ix_documents_source_dedupe_hash", table_name="documents")
+    op.execute(sa.text("DROP INDEX IF EXISTS uq_documents_source_external_id"))
+    op.drop_index("ix_documents_source_external", table_name="documents")
+    with op.batch_alter_table("documents") as batch:
+        batch.drop_column("normalization_error")
+        batch.drop_column("dedupe_content_hash")
+        batch.drop_column("external_id")

package/backend/alembic/versions/c2d3e4f5061a_chat_sessions_messages.py

@@ -0,0 +1,59 @@
+"""chat_sessions and chat_messages for UI chat history
+
+Revision ID: c2d3e4f5061a
+Revises: b1c2d3e4f5a6
+Create Date: 2026-04-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "c2d3e4f5061a"
+down_revision: str | None = "b1c2d3e4f5a6"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+_TS_DEFAULT = sa.text("(strftime('%Y-%m-%dT%H:%M:%fZ','now'))")
+
+
+def upgrade() -> None:
+    op.execute(sa.text("PRAGMA foreign_keys=ON"))
+    op.create_table(
+        "chat_sessions",
+        sa.Column("id", sa.Text(), primary_key=True, nullable=False),
+        sa.Column("user_id", sa.Text(), nullable=False),
+        sa.Column("title", sa.Text(), nullable=True),
+        sa.Column("created_at", sa.Text(), nullable=False, server_default=_TS_DEFAULT),
+        sa.Column("updated_at", sa.Text(), nullable=False, server_default=_TS_DEFAULT),
+    )
+    op.create_index("ix_chat_sessions_user_id", "chat_sessions", ["user_id"])
+
+    op.create_table(
+        "chat_messages",
+        sa.Column("id", sa.Integer(), primary_key=True, autoincrement=True),
+        sa.Column("session_id", sa.Text(), nullable=False),
+        sa.Column("role", sa.Text(), nullable=False),
+        sa.Column("content", sa.Text(), nullable=False),
+        sa.Column("meta_json", sa.Text(), nullable=True),
+        sa.Column("created_at", sa.Text(), nullable=False, server_default=_TS_DEFAULT),
+        sa.ForeignKeyConstraint(
+            ["session_id"],
+            ["chat_sessions.id"],
+            ondelete="CASCADE",
+        ),
+    )
+    op.create_index(
+        "ix_chat_messages_session_created",
+        "chat_messages",
+        ["session_id", "id"],
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_chat_messages_session_created", table_name="chat_messages")
+    op.drop_table("chat_messages")
+    op.drop_index("ix_chat_sessions_user_id", table_name="chat_sessions")
+    op.drop_table("chat_sessions")

package/backend/alembic.ini

@@ -0,0 +1,42 @@
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+version_path_separator = os
+
+sqlalchemy.url = sqlite+aiosqlite:///./placeholder.sqlite
+
+[post_write_hooks]
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

package/backend/app/config.py

@@ -0,0 +1,337 @@
+from functools import lru_cache
+from pathlib import Path
+
+from pydantic import Field, computed_field, field_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+_POST_INGEST_SLACK_TEMPLATE_DEFAULT = (
+    ":white_check_mark: *KB document ready*\n"
+    "*Summary:* {summary_short}\n"
+    "*Link:* {source_link}\n"
+    "*Source:* {source_name}\n"
+    "*Id:* `{document_id}`"
+)
+_POST_INGEST_DISCORD_TEMPLATE_DEFAULT = (
+    "**KB document ready**\n"
+    "**Summary:** {summary_short}\n"
+    "**Link:** {source_link}\n"
+    "**Source:** {source_name}\n"
+    "**Id:** `{document_id}`"
+)
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    data_dir: Path = Field(default=Path("data"), validation_alias="DATA_DIR")
+    sqlite_filename: str = Field(
+        default="rag.sqlite",
+        validation_alias="SQLITE_FILENAME",
+    )
+    database_url: str | None = Field(default=None, validation_alias="DATABASE_URL")
+
+    openai_api_key: str | None = Field(default=None, validation_alias="OPENAI_API_KEY")
+    embedding_api_key: str | None = Field(
+        default=None,
+        validation_alias="EMBEDDING_API_KEY",
+    )
+    embedding_model: str = Field(
+        default="text-embedding-3-small",
+        validation_alias="EMBEDDING_MODEL",
+    )
+    vector_embedding_dim: int = Field(
+        default=1536,
+        validation_alias="VECTOR_EMBEDDING_DIM",
+    )
+
+    log_level: str = Field(default="INFO", validation_alias="LOG_LEVEL")
+    log_json: bool = Field(default=False, validation_alias="LOG_JSON")
+
+    backend_gateway_secret: str | None = Field(
+        default=None,
+        validation_alias="BACKEND_GATEWAY_SECRET",
+        description=(
+            "When set, /docs, /redoc, /openapi.json, and /docs/* require X-Gateway-Secret to match. "
+            "Configure the same value on the Hono gateway so docs are not usable by calling the "
+            "backend directly."
+        ),
+    )
+
+    link_expand_max_depth: int = Field(
+        default=2,
+        ge=1,
+        le=32,
+        validation_alias="LINK_EXPAND_MAX_DEPTH",
+    )
+    link_expand_domain_allowlist: str = Field(
+        default="",
+        validation_alias="LINK_EXPAND_DOMAIN_ALLOWLIST",
+        description="Comma-separated hostnames; empty = all (except denylist)",
+    )
+    link_expand_domain_denylist: str = Field(
+        default="",
+        validation_alias="LINK_EXPAND_DOMAIN_DENYLIST",
+        description="Comma-separated hostnames to block",
+    )
+    link_expand_politeness_delay_ms: int = Field(
+        default=750,
+        ge=0,
+        validation_alias="LINK_EXPAND_POLITENESS_DELAY_MS",
+    )
+    link_expand_per_domain_interval_ms: int = Field(
+        default=1500,
+        ge=0,
+        validation_alias="LINK_EXPAND_PER_DOMAIN_INTERVAL_MS",
+    )
+    link_expand_respect_robots: bool = Field(
+        default=True,
+        validation_alias="LINK_EXPAND_RESPECT_ROBOTS",
+    )
+    link_expand_user_agent: str = Field(
+        default="BusinessStackLinkBot/0.1 (+https://example.invalid/bot)",
+        validation_alias="LINK_EXPAND_USER_AGENT",
+    )
+    link_expand_max_response_bytes: int = Field(
+        default=5_242_880,
+        ge=4096,
+        validation_alias="LINK_EXPAND_MAX_RESPONSE_BYTES",
+    )
+    link_expand_fetch_timeout_s: float = Field(
+        default=30.0,
+        ge=1.0,
+        validation_alias="LINK_EXPAND_FETCH_TIMEOUT_S",
+    )
+
+    chunk_llm_model: str = Field(
+        default="gpt-4o-mini",
+        validation_alias="CHUNK_LLM_MODEL",
+    )
+
+    gemini_api_key: str | None = Field(
+        default=None,
+        validation_alias="GEMINI_API_KEY",
+        description="Overrides integration store when set.",
+    )
+    integrations_gateway_url: str | None = Field(
+        default=None,
+        validation_alias="INTEGRATIONS_GATEWAY_URL",
+        description=(
+            "Hono gateway origin for GET /internal/integrations "
+            "(e.g. http://127.0.0.1:3001). Used when GEMINI_API_KEY is unset."
+        ),
+    )
+    integrations_internal_secret: str | None = Field(
+        default=None,
+        validation_alias="INTEGRATIONS_INTERNAL_SECRET",
+        description="Bearer shared with gateway INTEGRATIONS_INTERNAL_SECRET.",
+    )
+    gemini_embedding_model: str = Field(
+        default="gemini-embedding-001",
+        validation_alias="GEMINI_EMBEDDING_MODEL",
+        description=(
+            "Gemini API embedding model id (Gemini Embedding / console 'Gemini Embedding 1': "
+            "gemini-embedding-001 per https://ai.google.dev/gemini-api/docs/models/gemini-embedding-001 )"
+        ),
+    )
+    gemini_embed_batch_size: int = Field(
+        default=32,
+        ge=1,
+        le=100,
+        validation_alias="GEMINI_EMBED_BATCH_SIZE",
+    )
+    gemini_embed_max_retries: int = Field(
+        default=4,
+        ge=1,
+        le=12,
+        validation_alias="GEMINI_EMBED_MAX_RETRIES",
+    )
+    gemini_embed_base_delay_s: float = Field(
+        default=1.0,
+        ge=0.1,
+        validation_alias="GEMINI_EMBED_BASE_DELAY_S",
+    )
+    gemini_embed_task_type: str = Field(
+        default="RETRIEVAL_DOCUMENT",
+        validation_alias="GEMINI_EMBED_TASK_TYPE",
+    )
+
+    embedding_dlq_max_attempts: int = Field(
+        default=5,
+        ge=1,
+        le=100,
+        validation_alias="EMBEDDING_DLQ_MAX_ATTEMPTS",
+        description="After this many failed embed jobs, row moves to dead state",
+    )
+    embedding_dlq_base_delay_s: float = Field(
+        default=60.0,
+        ge=1.0,
+        validation_alias="EMBEDDING_DLQ_BASE_DELAY_S",
+        description="Initial backoff; doubles each attempt (capped)",
+    )
+    embedding_dlq_max_backoff_s: float = Field(
+        default=3600.0,
+        ge=60.0,
+        validation_alias="EMBEDDING_DLQ_MAX_BACKOFF_S",
+    )
+
+    post_ingest_slack_webhook_url: str | None = Field(
+        default=None,
+        validation_alias="POST_INGEST_SLACK_WEBHOOK_URL",
+        description="Slack incoming webhook URL (never logged)",
+    )
+    post_ingest_discord_webhook_url: str | None = Field(
+        default=None,
+        validation_alias="POST_INGEST_DISCORD_WEBHOOK_URL",
+        description="Discord webhook URL (never logged)",
+    )
+    post_ingest_slack_template: str = Field(
+        default=_POST_INGEST_SLACK_TEMPLATE_DEFAULT,
+        validation_alias="POST_INGEST_SLACK_TEMPLATE",
+        description="str.format template; placeholders: document_id, summary, ...",
+    )
+    post_ingest_discord_template: str = Field(
+        default=_POST_INGEST_DISCORD_TEMPLATE_DEFAULT,
+        validation_alias="POST_INGEST_DISCORD_TEMPLATE",
+    )
+    post_ingest_summary_max_chars: int = Field(
+        default=400,
+        ge=20,
+        le=8000,
+        validation_alias="POST_INGEST_SUMMARY_MAX_CHARS",
+    )
+
+    entity_use_spacy: bool = Field(default=True, validation_alias="ENTITY_USE_SPACY")
+    spacy_model: str = Field(
+        default="en_core_web_sm",
+        validation_alias="SPACY_MODEL",
+    )
+    entity_use_gliner: bool = Field(
+        default=False,
+        validation_alias="ENTITY_USE_GLINER",
+    )
+    gliner_model_id: str = Field(
+        default="urchade/gliner_medium-v2.1",
+        validation_alias="GLINER_MODEL_ID",
+    )
+    entity_llm_enabled: bool = Field(
+        default=False,
+        validation_alias="ENTITY_LLM_ENABLED",
+    )
+    entity_llm_min_mentions: int = Field(
+        default=2,
+        ge=0,
+        le=50,
+        validation_alias="ENTITY_LLM_MIN_MENTIONS",
+    )
+    entity_llm_on_all_chunks: bool = Field(
+        default=False,
+        validation_alias="ENTITY_LLM_ON_ALL_CHUNKS",
+    )
+    ollama_base_url: str = Field(
+        default="http://127.0.0.1:11434",
+        validation_alias="OLLAMA_BASE_URL",
+    )
+    ollama_entity_model: str = Field(
+        default="llama3.2",
+        validation_alias="OLLAMA_ENTITY_MODEL",
+    )
+    entity_extract_strict: bool = Field(
+        default=False,
+        validation_alias="ENTITY_EXTRACT_STRICT",
+        description="If true, entity extraction failure fails the embed job",
+    )
+
+    gemini_query_task_type: str = Field(
+        default="RETRIEVAL_QUERY",
+        validation_alias="GEMINI_QUERY_TASK_TYPE",
+        description="Gemini taskType for query embeddings",
+    )
+    gemini_chat_model: str = Field(
+        default="gemini-3-flash-preview",
+        validation_alias="GEMINI_CHAT_MODEL",
+        description=(
+            "Gemini API model id for POST /chat/.../complete (generateContent). "
+            "Older ids (e.g. gemini-1.5-flash) may return 404 on v1beta; see "
+            "https://ai.google.dev/gemini-api/docs/models and ListModels."
+        ),
+    )
+
+    @field_validator("gemini_embedding_model", "gemini_chat_model", mode="after")
+    @classmethod
+    def _normalize_gemini_model_env(cls, v: str) -> str:
+        """ListModels returns ``name`` like ``models/gemini-2.5-flash``; URLs need the suffix only."""
+        s = v.strip()
+        return s.removeprefix("models/")
+
+    retrieval_score_semantic_weight: float = Field(
+        default=0.7,
+        ge=0.0,
+        le=1.0,
+        validation_alias="RETRIEVAL_SCORE_SEMANTIC_WEIGHT",
+    )
+    retrieval_score_recency_weight: float = Field(
+        default=0.2,
+        ge=0.0,
+        le=1.0,
+        validation_alias="RETRIEVAL_SCORE_RECENCY_WEIGHT",
+    )
+    retrieval_score_source_weight: float = Field(
+        default=0.1,
+        ge=0.0,
+        le=1.0,
+        validation_alias="RETRIEVAL_SCORE_SOURCE_WEIGHT",
+    )
+    retrieval_recency_half_life_days: float = Field(
+        default=30.0,
+        gt=0.0,
+        validation_alias="RETRIEVAL_RECENCY_HALF_LIFE_DAYS",
+        description="Recency score halves every this many days since ingested_at",
+    )
+    retrieval_source_weights_json: str = Field(
+        default='{"default": 1.0}',
+        validation_alias="RETRIEVAL_SOURCE_WEIGHTS_JSON",
+        description=(
+            'JSON map connector_type -> weight in [0,1] (e.g. {"default":1,"web":0.85})'
+        ),
+    )
+    retrieval_vec_candidate_multiplier: int = Field(
+        default=5,
+        ge=1,
+        le=50,
+        validation_alias="RETRIEVAL_VEC_CANDIDATE_MULTIPLIER",
+        description=(
+            "Vector search retrieves k * multiplier rows before score re-ranking"
+        ),
+    )
+
+    @field_validator(
+        "link_expand_domain_allowlist",
+        "link_expand_domain_denylist",
+        mode="before",
+    )
+    @classmethod
+    def _strip_csv(cls, v: object) -> str:
+        if v is None:
+            return ""
+        return str(v).strip()
+
+    @computed_field  # type: ignore[prop-decorator]
+    @property
+    def sqlalchemy_database_url(self) -> str:
+        if self.database_url:
+            return self.database_url
+        path = (self.data_dir / self.sqlite_filename).resolve()
+        return f"sqlite+aiosqlite:///{path.as_posix()}"
+
+
+@lru_cache
+def get_settings() -> Settings:
+    return Settings()
+
+
+def clear_settings_cache() -> None:
+    get_settings.cache_clear()

package/backend/app/connectors/__init__.py

@@ -0,0 +1,13 @@
+from app.connectors.registry import (
+    get_connector_class,
+    init_connectors,
+    list_connector_keys,
+    register_connector,
+)
+
+__all__ = [
+    "get_connector_class",
+    "init_connectors",
+    "list_connector_keys",
+    "register_connector",
+]