Add ExtensionOption, update FunctionInfo.examples, and add bind error handling

- Add ExtensionOption dataclass for DuckDB extension configuration settings
- Update FunctionInfo.examples to use list[CatalogExample | str] with structured
  Arrow schema (sql, description, expected_output fields)
- Add _create_bind_error_batch method to Worker for bind-time exception handling
- Add bind error detection to Client._initialize_stream_common()
- Update CLI display to use dict(tags) instead of list(tags)
- Replace hardcoded expected_functions in tests with dynamic extraction
- Export CatalogExample and ExtensionOption from vgi.catalog

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: rustyconover

tests/catalog/test_catalog_interface.py

@@ -530,7 +530,10 @@ def test_serialization_roundtrip_with_all_fields(self) -> None:
         # New fields
         assert restored.stability == info.stability
         assert restored.null_handling == info.null_handling
-        assert restored.examples == info.examples
+        # Examples are deserialized to CatalogExample objects
+        assert [
+            ex.sql for ex in restored.examples if hasattr(ex, "sql")
+        ] == info.examples
         assert restored.categories == info.categories
         assert restored.projection_pushdown == info.projection_pushdown
         assert restored.filter_pushdown == info.filter_pushdown
@@ -718,7 +721,12 @@ def test_list_fields_serialization(self) -> None:
         batch = deserialize_record_batch(serialized)
         restored = FunctionInfo.deserialize(batch)
 
-        assert restored.examples == ["SELECT f(1)", "SELECT f(2)", "SELECT f(3)"]
+        # Examples are deserialized to CatalogExample objects
+        assert [ex.sql for ex in restored.examples if hasattr(ex, "sql")] == [
+            "SELECT f(1)",
+            "SELECT f(2)",
+            "SELECT f(3)",
+        ]
         assert restored.categories == ["a", "b"]
         assert restored.required_settings == ["setting1"]
 

tests/catalog/test_example_worker_catalog.py

@@ -8,11 +8,21 @@
 
 from vgi.catalog import FunctionInfo, FunctionType, TableInfo, ViewInfo
 from vgi.client import Client
+from vgi.examples.worker import ExampleWorker
 
 # Worker command for catalog tests
 EXAMPLE_WORKER = "vgi-example-worker"
 
 
+def _get_expected_function_names() -> set[str]:
+    """Get all function names from ExampleWorker dynamically."""
+    names = set()
+    for func_cls in ExampleWorker.functions:
+        meta = func_cls.get_metadata()
+        names.add(meta.name)
+    return names
+
+
 def _get_functions(
     contents: list[TableInfo | ViewInfo | FunctionInfo],
 ) -> list[FunctionInfo]:
@@ -69,28 +79,17 @@ def test_all_example_functions_listed(self) -> None:
         # Get function names
         function_names = {item.name for item in contents}
 
-        # Check for known example functions
-        expected_functions = {
-            # TableInOutGenerator functions
-            "echo",
-            "buffer_input",
-            "repeat_inputs",
-            "sum_all_columns",
-            # TableFunctionGenerator functions
-            "sequence",
-            "range",
-            "constant_table",
-            "random_sample",
-            # ScalarFunctionGenerator functions
-            "double_column",
-            "add_columns",
-            "upper_case",
-        }
+        # Get expected functions from ExampleWorker dynamically
+        expected_functions = _get_expected_function_names()
 
         # All expected functions should be present
         missing = expected_functions - function_names
         assert not missing, f"Missing functions: {missing}"
 
+        # No extra functions should be present
+        extra = function_names - expected_functions
+        assert not extra, f"Unexpected functions: {extra}"
+
     def test_function_info_has_correct_types(self) -> None:
         """FunctionInfo has correct function types."""
         client = Client(EXAMPLE_WORKER)