spice-mcp 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

spice_mcp/mcp/tools/execute_query.py

@@ -80,7 +80,7 @@ class ExecuteQueryTool(MCPTool):
             "additionalProperties": False,
         }
 
-    async def execute(
+    def execute(
         self,
         *,
         query: str,
@@ -149,74 +149,41 @@ class ExecuteQueryTool(MCPTool):
                 return {"type": "execution", "execution_id": execution_id, "status": "submitted"}
 
             if format == "metadata":
-                try:
-                    meta = self.query_service.fetch_metadata(
-                        query=q_use,
-                        parameters=parameters,
-                        max_age=max_age,
-                        limit=limit,
-                        offset=offset,
-                        sample_count=sample_count,
-                        sort_by=sort_by,
-                        columns=columns,
-                        extras=extras,
-                        performance=performance,
-                    )
-                except TypeError:
-                    # Back-compat: older services without 'extras'
-                    meta = self.query_service.fetch_metadata(
-                        query=q_use,
-                        parameters=parameters,
-                        max_age=max_age,
-                        limit=limit,
-                        offset=offset,
-                        sample_count=sample_count,
-                        sort_by=sort_by,
-                        columns=columns,
-                        performance=performance,
-                    )
-                return {
-                    "type": "metadata",
-                    "metadata": meta.get("metadata"),
-                    "next_uri": meta.get("next_uri"),
-                    "next_offset": meta.get("next_offset"),
-                }
-            try:
-                result = self.query_service.execute(
+                meta = self.query_service.fetch_metadata(
                     query=q_use,
                     parameters=parameters,
-                    refresh=refresh,
                     max_age=max_age,
-                    poll=True,
-                    timeout_seconds=timeout_seconds,
                     limit=limit,
                     offset=offset,
                     sample_count=sample_count,
                     sort_by=sort_by,
                     columns=columns,
                     extras=extras,
-                    include_execution=True,
                     performance=performance,
-                    return_raw=format == "raw",
-                )
-            except TypeError:
-                # Back-compat: older services without 'extras'
-                result = self.query_service.execute(
-                    query=q_use,
-                    parameters=parameters,
-                    refresh=refresh,
-                    max_age=max_age,
-                    poll=True,
-                    timeout_seconds=timeout_seconds,
-                    limit=limit,
-                    offset=offset,
-                    sample_count=sample_count,
-                    sort_by=sort_by,
-                    columns=columns,
-                    include_execution=True,
-                    performance=performance,
-                    return_raw=format == "raw",
                 )
+                return {
+                    "type": "metadata",
+                    "metadata": meta.get("metadata"),
+                    "next_uri": meta.get("next_uri"),
+                    "next_offset": meta.get("next_offset"),
+                }
+            result = self.query_service.execute(
+                query=q_use,
+                parameters=parameters,
+                refresh=refresh,
+                max_age=max_age,
+                poll=True,
+                timeout_seconds=timeout_seconds,
+                limit=limit,
+                offset=offset,
+                sample_count=sample_count,
+                sort_by=sort_by,
+                columns=columns,
+                extras=extras,
+                include_execution=True,
+                performance=performance,
+                return_raw=format == "raw",
+            )
 
             duration_ms = int((time.time() - t0) * 1000)
             execution = result.get("execution", {})
@@ -340,7 +307,7 @@ class ExecuteQueryTool(MCPTool):
             # Add debugging information for raw SQL failures
             if q_type == "raw_sql" and "could not determine execution" in str(exc):
                 context.update({
-                    "debug_info": "Raw SQL execution failed - this may be related to FastMCP async/concurrency handling",
+                    "debug_info": "Raw SQL execution failed - check template query configuration and API key",
                     "template_query_id": template_id_value,
                     "environment_vars": {
                         "SPICE_RAW_SQL_QUERY_ID": os.getenv("SPICE_RAW_SQL_QUERY_ID"),

{spice_mcp-0.1.2.dist-info → spice_mcp-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spice-mcp
-Version: 0.1.2
+Version: 0.1.3
 Summary: MCP server for Dune Analytics data access
 Author-email: Evan-Kim2028 <ekcopersonal@gmail.com>
 License-File: LICENSE
@@ -21,7 +21,12 @@ Description-Content-Type: text/markdown
 
 # spice-mcp
 
-spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+
+[![PyPI version](https://img.shields.io/pypi/v/spice-mcp.svg)](https://pypi.org/project/spice-mcp/)
+<a href="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp/badge" alt="Spice MCP server" />
+</a>
 
 Requirements: Python 3.13+
 
@@ -31,16 +36,17 @@ This project uses FastMCP for typed, decorator-registered tools and resources.
 - Polars LazyFrame-first pipeline: results stay lazy until explicitly materialized
 - Ports/adapters layering for maintainable integrations ([docs/architecture.md](docs/architecture.md))
 - Discovery utilities (find schemas/tables, describe columns)
-- Sui package workflows (events/transactions/objects) with safe defaults
 - JSONL query history + SQL artifacts (SHA-256) for reproducibility
-- Rich MCP surface: query info/run, discovery, health, Sui, and Dune admin (create/update/fork)
+- Rich MCP surface: query info/run, discovery, health, and Dune admin (create/update/fork)
 
 ## What is Dune?
 [Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API to run and fetch query results. See the [Dune Docs](https://dune.com/docs) and [Dune API](https://dune.com/docs/api/) for full details.
 
 ## Quick Start
 - Export `DUNE_API_KEY` in your shell (the server can also load a local `.env`; set `SPICE_MCP_SKIP_DOTENV=1` to skip during tests).
-- Install dependencies (`uv sync` or `pip install -e .`).
+- Install from PyPI: `uv pip install spice-mcp`
+- Or install from source:
+  - `uv sync` then `uv pip install -e .`
 - Start the FastMCP stdio server:
   - `python -m spice_mcp.mcp.server --env PYTHONPATH=$(pwd)/src`
   - or install the console script via `uv tool install .` and run `spice-mcp`.
@@ -51,9 +57,12 @@ To use spice-mcp with Cursor IDE:
 
 1. **Install the MCP Server**:
    ```bash
-   # Install dependencies and package
+   # Install from PyPI (recommended)
+   uv pip install spice-mcp
+   
+   # Or install from source
    uv sync
-   pip install -e .
+   uv pip install -e .
    
    # Or install via uv tool (creates console script)
    uv tool install .
@@ -97,7 +106,6 @@ To use spice-mcp with Cursor IDE:
    - `dune_query`: Run Dune queries by ID, URL, or raw SQL
    - `dune_find_tables`: Search schemas and list tables
    - `dune_describe_table`: Get column metadata
-   - `sui_package_overview`: Analyze Sui packages
    - `dune_health_check`: Verify API connection
 
 **Tip**: Create a `.env` file in your project root with `DUNE_API_KEY=your-key-here` for easier configuration.
@@ -121,9 +129,6 @@ All tools expose typed parameters, titles, and tags; failures return a consisten
 - `dune_describe_table` (Describe Table, tags: dune, schema)
   - Column metadata for `schema.table` (Dune types + Polars inferred dtypes when available).
 
-- `sui_package_overview` (Sui Package Overview, tag: sui)
-  - Compact Sui activity overview for `packages[]` with `hours` (default 72) and `timeout_seconds`.
-
 - Dune Admin tools (tags: dune, admin)
   - `dune_query_create(name, query_sql, description?, tags?, parameters?)`
   - `dune_query_update(query_id, name?, query_sql?, description?, tags?, parameters?)`
@@ -178,7 +183,7 @@ Core Tools (with parameters)
 - See [docs/index.md](docs/index.md) for full documentation:
   - Dune API structure and capabilities: [docs/dune_api.md](docs/dune_api.md)
   - Discovery patterns and examples: [docs/discovery.md](docs/discovery.md)
-  - Sui package workflows: [docs/sui_packages.md](docs/sui_packages.md)
+  
   - Tool reference and schemas: [docs/tools.md](docs/tools.md)
   - Codex CLI + tooling integration: [docs/codex_cli.md](docs/codex_cli.md), [docs/codex_cli_tools.md](docs/codex_cli_tools.md)
   - Architecture overview: [docs/architecture.md](docs/architecture.md)
@@ -190,4 +195,4 @@ Notes
 - Ports and models live in `src/spice_mcp/core`; services consume ports and are exercised by FastMCP tools.
 - Query history and SQL artefacts are always-on (see `src/spice_mcp/logging/query_history.py`).
 - To bypass dot-env loading during tests/CI, export `SPICE_MCP_SKIP_DOTENV=1`.
-- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.
+- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.

{spice_mcp-0.1.2.dist-info → spice_mcp-0.1.3.dist-info}/RECORD

@@ -1,39 +1,39 @@
 spice_mcp/__init__.py,sha256=SpDcj8yU1fpT2YZCqal1R3KLZpBty3w--6bkmrmWU6o,55
-spice_mcp/config.py,sha256=edQvaksAPhOcOSvT-_KUYKvnWyGAwxbSFMO7dvfsGU0,2712
+spice_mcp/config.py,sha256=QX-c3veCFEoKjXIHsEX1_Kt4kjrd7tmrdTiOLFS5pSw,2766
 spice_mcp/polars_utils.py,sha256=hCw3M_iZhTFdBnfmcx2SN8J8jpoucfJnpX_ZrXz6JwY,442
 spice_mcp/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 spice_mcp/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/adapters/http_client.py,sha256=CYgSKAsx-5c-uxaNIBCBTgQdaoBe5J3dJvnw8iqda34,5033
-spice_mcp/adapters/dune/__init__.py,sha256=8HRHPxkz0y2cyHSs4oCkHq_LQaUW5MBevbeNxM9RZvo,372
+spice_mcp/adapters/dune/__init__.py,sha256=nspEuDpVOktAxm8B066s-d0LwouCYGpvNEexi0mRMN8,386
 spice_mcp/adapters/dune/admin.py,sha256=yxOueVz-rmgC-ZFbT06k59G24yRgYjiEkZlall5hXNQ,3157
-spice_mcp/adapters/dune/cache.py,sha256=7UmmxpBNeSGPH3KYBBSPHlVXCpiZUi4-X300U2FsSBs,5252
+spice_mcp/adapters/dune/cache.py,sha256=7ykT58WN1yHGIN2uV3t7fWOqGb1VJdCvf3I-xZwsv74,4304
 spice_mcp/adapters/dune/client.py,sha256=JPrQZ_dtaPcGf6lYUguDxGweOtxG-8qMqOiXuhWL9QA,9122
-spice_mcp/adapters/dune/extract.py,sha256=frIFRUNJ99UlP26N9F-p1psX-e_TVq9vJTQxh0MBCr8,48510
+spice_mcp/adapters/dune/extract.py,sha256=3jrXqlak4Kpl11y7C3L1AhFv09lQ-2pBqmrh-0Mwlm0,28836
 spice_mcp/adapters/dune/helpers.py,sha256=BgDKr_g-UqmU2hoMb0ejQZHta_NbKwR1eDJp33sJYNk,227
 spice_mcp/adapters/dune/transport.py,sha256=eRP-jPY2ZXxvTX9HSjIFqFUlbIzXspgH95jBFoTlpaQ,1436
 spice_mcp/adapters/dune/types.py,sha256=57TMX07u-Gq4BYwRAuZV0xI81nVXgtpp7KBID9YbKyQ,1195
 spice_mcp/adapters/dune/typing_utils.py,sha256=EpWneGDn-eQdo6lkLuESR09KXkDj9OqGz8bEF3JaFkM,574
 spice_mcp/adapters/dune/urls.py,sha256=bcuPERkFQduRTT2BrgzVhoFrMn-Lkvw9NmktcBZYEig,3902
+spice_mcp/adapters/spellbook/__init__.py,sha256=D2cdVtSUbmAJdbPRvAyKxYS4-wUQ3unXyX4ZFYxenuk,150
+spice_mcp/adapters/spellbook/explorer.py,sha256=Q3UfEGlALizCDeeW_ZZVRRedzwMXiknmxwSkeOnxxgc,11515
 spice_mcp/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/core/errors.py,sha256=jlfTuyRaAaA_oU07KUk-1pDAAa43KG0BbZc5CINXtoE,3256
-spice_mcp/core/models.py,sha256=2AgAPcaDPEXLdka1E6-0cXN_QNsN2rnDoBnDTDDsO6I,2121
-spice_mcp/core/ports.py,sha256=-wtWjpYSjL-qugUtsm0MTngtJZWzr7QNDbAUCj4BTS0,2028
+spice_mcp/core/models.py,sha256=i0C_-UE16OWyyZo_liooEJeYvbChE5lpK80aN2OF4lk,1795
+spice_mcp/core/ports.py,sha256=nEdeA3UH7v0kB_hbguMrpDljb9EhSxUAO0SdhjpoijQ,1618
 spice_mcp/logging/query_history.py,sha256=doE9lod64uzJxlA2XzHH2-VAmC6WstYAkQ0taEAxiIM,4315
 spice_mcp/mcp/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-spice_mcp/mcp/server.py,sha256=RtvK0u9Q3dp3JMALrVFL43Li1lKdaQwLvtZuoo0pkbY,18082
+spice_mcp/mcp/server.py,sha256=NNTjn5f_OLNd8zSnNsx73WhHzNGW_SBJoCrdzkgOGP4,26275
 spice_mcp/mcp/tools/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-spice_mcp/mcp/tools/base.py,sha256=Xw8k5WAXotCdZRd-cVJIFPH87JH8DH0sh1zKu-KmW3w,1047
-spice_mcp/mcp/tools/execute_query.py,sha256=y2HU3Cv6T7QBXBDMea0TlXcf8_ERkq2sJeaexR6kBXE,17556
-spice_mcp/mcp/tools/sui_package_overview.py,sha256=a1CcpfBzEFzScjXgxLu9urxdtSbXjF98ugWPOX167rc,1736
+spice_mcp/mcp/tools/base.py,sha256=zJkVxLgXR48iZcJeng8cZ2rXvbyicagoGlMN7BK7Img,1041
+spice_mcp/mcp/tools/execute_query.py,sha256=CucjxoBT22VUS-QJV1JrDjoywu2nd13fL3Lfs1qytUg,16093
 spice_mcp/observability/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/observability/logging.py,sha256=ceJUEpKGpf5PAgPBmpB49zjqhdGCAESfLemFUhDSmI8,529
 spice_mcp/service_layer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 spice_mcp/service_layer/discovery_service.py,sha256=202O0SzCZGQukd9kb2JYfarLygZHgiXlHqp_nTAdrWA,730
 spice_mcp/service_layer/query_admin_service.py,sha256=4q1NAAuTui7cm83Aq2rFDLIzKTHX17yzbSoSJyCmLbI,1356
 spice_mcp/service_layer/query_service.py,sha256=q0eAVW5I3sUxm29DgzPN_cH3rZEzmKwmdE3Xj4qP9lI,3878
-spice_mcp/service_layer/sui_service.py,sha256=G-LOsl-z-ldMxAYAetnG17IQlpVtLchGUjN6opU-PF0,4712
-spice_mcp-0.1.2.dist-info/METADATA,sha256=TB63rlJQOinwNKj3XvevK0OLLF2Ic0xYmeLU_kaiuas,9316
-spice_mcp-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-spice_mcp-0.1.2.dist-info/entry_points.txt,sha256=4XiXX13Vy-oiUJwlcO_82OltBaxFnEnkJ-76sZGm5os,56
-spice_mcp-0.1.2.dist-info/licenses/LICENSE,sha256=r0GNDnDY1RSkVQp7kEEf6MQU21OrNGJkxUHIsv6eyLk,1079
-spice_mcp-0.1.2.dist-info/RECORD,,
+spice_mcp-0.1.3.dist-info/METADATA,sha256=a44b2EfhkPbQSS_PEoU1LF4Kkr2RfSD1gS6gGlEMmnQ,9343
+spice_mcp-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+spice_mcp-0.1.3.dist-info/entry_points.txt,sha256=4XiXX13Vy-oiUJwlcO_82OltBaxFnEnkJ-76sZGm5os,56
+spice_mcp-0.1.3.dist-info/licenses/LICENSE,sha256=r0GNDnDY1RSkVQp7kEEf6MQU21OrNGJkxUHIsv6eyLk,1079
+spice_mcp-0.1.3.dist-info/RECORD,,

spice_mcp/mcp/tools/sui_package_overview.py

@@ -1,56 +0,0 @@
-from __future__ import annotations
-
-from typing import Any
-
-from ...core.errors import error_response
-from ...service_layer.sui_service import SuiService
-from .base import MCPTool
-
-
-class SuiPackageOverviewTool(MCPTool):
-    """Overview of Sui packages: events, transactions, objects (small preview)."""
-
-    def __init__(self, sui_service: SuiService):
-        self.sui_service = sui_service
-
-    @property
-    def name(self) -> str:
-        return "sui_package_overview"
-
-    @property
-    def description(self) -> str:
-        return (
-            "Return a compact overview (counts + previews) of Sui package activity "
-            "over a time window, with polling timeouts."
-        )
-
-    def get_parameter_schema(self) -> dict[str, Any]:
-        return {
-            "type": "object",
-            "properties": {
-                "packages": {"type": "array", "items": {"type": "string"}},
-                "hours": {"type": "integer", "default": 72},
-                "timeout_seconds": {"type": "number", "default": 30},
-            },
-            "required": ["packages"],
-            "additionalProperties": False,
-        }
-
-    async def execute(
-        self, *, packages: list[str], hours: int = 72, timeout_seconds: float | None = 30
-    ) -> dict[str, Any]:
-        try:
-            return self.sui_service.package_overview(
-                packages,
-                hours=hours,
-                timeout_seconds=timeout_seconds,
-            )
-        except Exception as exc:
-            return error_response(
-                exc,
-                context={
-                    "tool": "sui_package_overview",
-                    "packages": packages,
-                    "hours": hours,
-                },
-            )

spice_mcp/service_layer/sui_service.py

@@ -1,131 +0,0 @@
-from __future__ import annotations
-
-import time
-
-from .query_service import QueryService
-
-
-class SuiService:
-    """Opinionated helpers for Sui package exploration."""
-
-    def __init__(self, query_service: QueryService):
-        self.query_service = query_service
-
-    def events_preview(
-        self, packages: list[str], *, hours: int = 72, limit: int = 50, performance: str = "large"
-    ) -> dict[str, object]:
-        now_ms = int(time.time() * 1000)
-        start_ms = now_ms - hours * 3600 * 1000
-
-        norms = _normalize_packages(packages)
-        if norms:
-            preds = [f"lower(event_type) LIKE '{pkg}::%'" for pkg in norms]
-            where = " OR ".join(preds)
-            sql = (
-                "SELECT timestamp_ms, package, module, event_type FROM sui.events "
-                f"WHERE ({where}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC "
-                f"LIMIT {limit}"
-            )
-        else:
-            sql = (
-                "SELECT timestamp_ms, package, module, event_type FROM sui.events "
-                f"WHERE timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC LIMIT {limit}"
-            ).format(limit=limit)
-
-        result = self.query_service.execute(
-            sql,
-            performance=performance,
-            timeout_seconds=60,
-            limit=limit,
-        )
-        return {
-            "rowcount": result["rowcount"],
-            "columns": result["columns"],
-            "data_preview": result["data_preview"],
-        }
-
-    def package_overview(
-        self,
-        packages: list[str],
-        *,
-        hours: int = 72,
-        timeout_seconds: float | None = 30,
-        performance: str = "large",
-    ) -> dict[str, object]:
-        now_ms = int(time.time() * 1000)
-        start_ms = now_ms - hours * 3600 * 1000
-        norms = _normalize_packages(packages)
-        in_clause = ",".join(f"'{pkg}'" for pkg in norms)
-
-        out: dict[str, object] = {"ok": True}
-
-        def _run(sql: str, limit: int) -> dict[str, object]:
-            return self.query_service.execute(
-                sql,
-                performance=performance,
-                timeout_seconds=timeout_seconds,
-                limit=limit,
-            )
-
-        # Events
-        try:
-            sql_ev = (
-                "SELECT timestamp_ms, package, module, event_type, event_json FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms} "
-                "ORDER BY timestamp_ms DESC LIMIT 200"
-            )
-            ev = _run(sql_ev, 200)
-            out["events_preview"] = ev.get("data_preview")
-            out["events_count"] = ev.get("rowcount")
-        except TimeoutError:
-            out["events_timeout"] = True
-        except Exception as exc:
-            out["events_error"] = str(exc)
-
-        # Transactions
-        try:
-            sql_tx = (
-                "WITH txs AS (SELECT DISTINCT transaction_digest FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms}) "
-                "SELECT t.* FROM sui.transactions t "
-                "JOIN txs ON t.transaction_digest = txs.transaction_digest "
-                "ORDER BY t.timestamp_ms DESC LIMIT 200"
-            )
-            tx = _run(sql_tx, 200)
-            out["transactions_preview"] = tx.get("data_preview")
-            out["transactions_count"] = tx.get("rowcount")
-        except TimeoutError:
-            out["transactions_timeout"] = True
-        except Exception as exc:
-            out["transactions_error"] = str(exc)
-
-        # Objects
-        try:
-            sql_ob = (
-                "WITH txs AS (SELECT DISTINCT transaction_digest FROM sui.events "
-                f"WHERE lower(package) IN ({in_clause}) AND timestamp_ms BETWEEN {start_ms} AND {now_ms}) "
-                "SELECT o.* FROM sui.objects o "
-                "WHERE o.previous_transaction IN (SELECT transaction_digest FROM txs) "
-                "ORDER BY o.timestamp_ms DESC LIMIT 200"
-            )
-            ob = _run(sql_ob, 200)
-            out["objects_preview"] = ob.get("data_preview")
-            out["objects_count"] = ob.get("rowcount")
-        except TimeoutError:
-            out["objects_timeout"] = True
-        except Exception as exc:
-            out["objects_error"] = str(exc)
-
-        return out
-
-
-def _normalize_packages(packages: list[str]) -> list[str]:
-    norms: list[str] = []
-    for p in packages:
-        value = p.lower()
-        if not value.startswith("0x"):
-            value = "0x" + value
-        norms.append(value)
-    return norms