@query-farm/vgi 0.42.0 → 0.44.0

package/dist/generated/vgi-service.d.ts

@@ -0,0 +1,1315 @@
+import { type CallContext, type ExchangeFn, type ExchangeInit, type HeaderInit, type ProducerFn, type ProducerInit, Protocol, type SchemaLike } from "@query-farm/vgi-rpc";
+import { type VgiSchema } from "../arrow/index.js";
+/** The protocol's wire name: the `vgi_rpc.protocol` routing key and the HTTP path segment. */
+export declare const VGI_PROTOCOL_NAME = "vgi.v2";
+/** The protocol's semver, stamped on every request by a client of this protocol. */
+export declare const VGI_PROTOCOL_VERSION = "2.1.0";
+/** What a unary handler returns: the result row, now or later. */
+export type VgiReply<T> = T | Promise<T>;
+/** The result of a unary method with no `result` column. */
+export type NoResult = Record<string, never>;
+/** A `list` column's value as the Arrow backend decodes it: a vector on arrow-js, an array on flechette. */
+export type WireList<T> = Iterable<T>;
+/** A `map` column's value: vgi-rpc passes it through opaque, in the Arrow backend's own representation. */
+export type WireMap = unknown;
+/** The exchange (bidirectional) callbacks of a stream method. */
+export interface VgiExchangeStream<S = unknown> {
+    readonly kind: "exchange";
+    readonly inputSchema: SchemaLike;
+    readonly outputSchema: SchemaLike;
+    readonly init: ExchangeInit<S>;
+    readonly exchange: ExchangeFn<S>;
+    readonly onCancel?: (state: S) => Promise<void> | void;
+    readonly headerInit?: HeaderInit;
+}
+/** The producer (server-streaming) callbacks of a stream method. */
+export interface VgiProducerStream<S = unknown> {
+    readonly kind: "producer";
+    readonly outputSchema: SchemaLike;
+    readonly init: ProducerInit<S>;
+    readonly produce: ProducerFn<S>;
+    readonly onCancel?: (state: S) => Promise<void> | void;
+    readonly headerInit?: HeaderInit;
+}
+/**
+ * A stream method's implementation. The params and header schemas come from
+ * the registration table, never from here: only the callbacks are the
+ * implementation's to choose. Build one with {@link exchangeStream} or
+ * {@link producerStream}, which infer the state type from `init`.
+ */
+export type VgiStream = VgiExchangeStream<any> | VgiProducerStream<any>;
+/** An exchange {@link VgiStream}, its state type inferred from `init`. */
+export declare function exchangeStream<S>(callbacks: Omit<VgiExchangeStream<S>, "kind">): VgiStream;
+/** A producer {@link VgiStream}, its state type inferred from `init`. */
+export declare function producerStream<S>(callbacks: Omit<VgiProducerStream<S>, "kind">): VgiStream;
+/** The params of `aggregate_bind`, one property per params-schema column. */
+export interface AggregateBindParams {
+    /** The packed `AggregateBindRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_combine`, one property per params-schema column. */
+export interface AggregateCombineParams {
+    /** The packed `AggregateCombineRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_destructor`, one property per params-schema column. */
+export interface AggregateDestructorParams {
+    /** The packed `AggregateDestructorRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_finalize`, one property per params-schema column. */
+export interface AggregateFinalizeParams {
+    /** The packed `AggregateFinalizeRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_streaming_chunk`, one property per params-schema column. */
+export interface AggregateStreamingChunkParams {
+    /** The packed `AggregateStreamingChunkRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_streaming_close`, one property per params-schema column. */
+export interface AggregateStreamingCloseParams {
+    /** The packed `AggregateStreamingCloseRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_streaming_open`, one property per params-schema column. */
+export interface AggregateStreamingOpenParams {
+    /** The packed `AggregateStreamingOpenRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_update`, one property per params-schema column. */
+export interface AggregateUpdateParams {
+    /** The packed `AggregateUpdateRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_window`, one property per params-schema column. */
+export interface AggregateWindowParams {
+    /** The packed `AggregateWindowRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_window_batch`, one property per params-schema column. */
+export interface AggregateWindowBatchParams {
+    /** The packed `AggregateWindowBatchRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_window_destructor`, one property per params-schema column. */
+export interface AggregateWindowDestructorParams {
+    /** The packed `AggregateWindowDestructorRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `aggregate_window_init`, one property per params-schema column. */
+export interface AggregateWindowInitParams {
+    /** The packed `AggregateWindowInitRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `bind`, one property per params-schema column. */
+export interface BindParams {
+    /** The packed `BindRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_attach`, one property per params-schema column. */
+export interface CatalogAttachParams {
+    /** The packed `CatalogAttachRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_catalogs`, one property per params-schema column. */
+export type CatalogCatalogsParams = Record<string, never>;
+/** The params of `catalog_contents`, one property per params-schema column. */
+export interface CatalogContentsParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `if_none_match` column (`string`, nullable). */
+    if_none_match: string | null;
+}
+/** The params of `catalog_copy_from_formats`, one property per params-schema column. */
+export interface CatalogCopyFromFormatsParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_create`, one property per params-schema column. */
+export interface CatalogCreateParams {
+    /** The packed `CatalogCreateRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_detach`, one property per params-schema column. */
+export interface CatalogDetachParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+}
+/** The params of `catalog_drop`, one property per params-schema column. */
+export interface CatalogDropParams {
+    /** The `name` column (`string`). */
+    name: string;
+}
+/** The params of `catalog_index_create`, one property per params-schema column. */
+export interface CatalogIndexCreateParams {
+    /** The packed `IndexCreateRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_index_drop`, one property per params-schema column. */
+export interface CatalogIndexDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `cascade` column (`bool`). */
+    cascade: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_index_get`, one property per params-schema column. */
+export interface CatalogIndexGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_macro_create`, one property per params-schema column. */
+export interface CatalogMacroCreateParams {
+    /** The packed `MacroCreateRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_macro_drop`, one property per params-schema column. */
+export interface CatalogMacroDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_macro_get`, one property per params-schema column. */
+export interface CatalogMacroGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_contents_functions`, one property per params-schema column. */
+export interface CatalogSchemaContentsFunctionsParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `type` column (`dictionary<values=string, indices=int16, ordered=0>`). */
+    type: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_contents_indexes`, one property per params-schema column. */
+export interface CatalogSchemaContentsIndexesParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_contents_macros`, one property per params-schema column. */
+export interface CatalogSchemaContentsMacrosParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `type` column (`dictionary<values=string, indices=int16, ordered=0>`). */
+    type: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_contents_tables`, one property per params-schema column. */
+export interface CatalogSchemaContentsTablesParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_contents_views`, one property per params-schema column. */
+export interface CatalogSchemaContentsViewsParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_create`, one property per params-schema column. */
+export interface CatalogSchemaCreateParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `on_conflict` column (`dictionary<values=string, indices=int16, ordered=0>`). */
+    on_conflict: string;
+    /** The `comment` column (`string`, nullable). */
+    comment: string | null;
+    /** The `tags` column (`map<string, string>`, nullable). */
+    tags: WireMap | null;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_drop`, one property per params-schema column. */
+export interface CatalogSchemaDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `cascade` column (`bool`). */
+    cascade: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schema_get`, one property per params-schema column. */
+export interface CatalogSchemaGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `path` column (`list<item: string>`). */
+    path: WireList<string | null>;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_schemas`, one property per params-schema column. */
+export interface CatalogSchemasParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_add`, one property per params-schema column. */
+export interface CatalogTableColumnAddParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_definition` column (`binary`). */
+    column_definition: Uint8Array;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `if_column_not_exists` column (`bool`). */
+    if_column_not_exists: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_comment_set`, one property per params-schema column. */
+export interface CatalogTableColumnCommentSetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `comment` column (`string`, nullable). */
+    comment: string | null;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_default_drop`, one property per params-schema column. */
+export interface CatalogTableColumnDefaultDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_default_set`, one property per params-schema column. */
+export interface CatalogTableColumnDefaultSetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `expression` column (`string`). */
+    expression: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_drop`, one property per params-schema column. */
+export interface CatalogTableColumnDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `if_column_exists` column (`bool`). */
+    if_column_exists: boolean;
+    /** The `cascade` column (`bool`). */
+    cascade: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_rename`, one property per params-schema column. */
+export interface CatalogTableColumnRenameParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `new_column_name` column (`string`). */
+    new_column_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_statistics_get`, one property per params-schema column. */
+export interface CatalogTableColumnStatisticsGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_column_type_change`, one property per params-schema column. */
+export interface CatalogTableColumnTypeChangeParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_definition` column (`binary`). */
+    column_definition: Uint8Array;
+    /** The `expression` column (`string`, nullable). */
+    expression: string | null;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_comment_set`, one property per params-schema column. */
+export interface CatalogTableCommentSetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `comment` column (`string`, nullable). */
+    comment: string | null;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_create`, one property per params-schema column. */
+export interface CatalogTableCreateParams {
+    /** The packed `TableCreateRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `catalog_table_delete_function_get`, one property per params-schema column. */
+export interface CatalogTableDeleteFunctionGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_drop`, one property per params-schema column. */
+export interface CatalogTableDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `cascade` column (`bool`). */
+    cascade: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_get`, one property per params-schema column. */
+export interface CatalogTableGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `at_unit` column (`string`, nullable). */
+    at_unit: string | null;
+    /** The `at_value` column (`string`, nullable). */
+    at_value: string | null;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_insert_function_get`, one property per params-schema column. */
+export interface CatalogTableInsertFunctionGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+    /** The `writable_branch_function_name` column (`string`, nullable). */
+    writable_branch_function_name: string | null;
+}
+/** The params of `catalog_table_not_null_drop`, one property per params-schema column. */
+export interface CatalogTableNotNullDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_not_null_set`, one property per params-schema column. */
+export interface CatalogTableNotNullSetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `column_name` column (`string`). */
+    column_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_rename`, one property per params-schema column. */
+export interface CatalogTableRenameParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `new_name` column (`string`). */
+    new_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_scan_branches_get`, one property per params-schema column. */
+export interface CatalogTableScanBranchesGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `at_unit` column (`string`, nullable). */
+    at_unit: string | null;
+    /** The `at_value` column (`string`, nullable). */
+    at_value: string | null;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_scan_function_get`, one property per params-schema column. */
+export interface CatalogTableScanFunctionGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `at_unit` column (`string`, nullable). */
+    at_unit: string | null;
+    /** The `at_value` column (`string`, nullable). */
+    at_value: string | null;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_table_update_function_get`, one property per params-schema column. */
+export interface CatalogTableUpdateFunctionGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_transaction_begin`, one property per params-schema column. */
+export interface CatalogTransactionBeginParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+}
+/** The params of `catalog_transaction_commit`, one property per params-schema column. */
+export interface CatalogTransactionCommitParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `transaction_opaque_data` column (`binary`). */
+    transaction_opaque_data: Uint8Array;
+}
+/** The params of `catalog_transaction_rollback`, one property per params-schema column. */
+export interface CatalogTransactionRollbackParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `transaction_opaque_data` column (`binary`). */
+    transaction_opaque_data: Uint8Array;
+}
+/** The params of `catalog_version`, one property per params-schema column. */
+export interface CatalogVersionParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_view_comment_set`, one property per params-schema column. */
+export interface CatalogViewCommentSetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `comment` column (`string`, nullable). */
+    comment: string | null;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_view_create`, one property per params-schema column. */
+export interface CatalogViewCreateParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `definition` column (`string`). */
+    definition: string;
+    /** The `on_conflict` column (`dictionary<values=string, indices=int16, ordered=0>`). */
+    on_conflict: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_view_drop`, one property per params-schema column. */
+export interface CatalogViewDropParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `cascade` column (`bool`). */
+    cascade: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_view_get`, one property per params-schema column. */
+export interface CatalogViewGetParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `catalog_view_rename`, one property per params-schema column. */
+export interface CatalogViewRenameParams {
+    /** The `attach_opaque_data` column (`binary`). */
+    attach_opaque_data: Uint8Array;
+    /** The `schema_path` column (`list<item: string>`). */
+    schema_path: WireList<string | null>;
+    /** The `name` column (`string`). */
+    name: string;
+    /** The `new_name` column (`string`). */
+    new_name: string;
+    /** The `ignore_not_found` column (`bool`). */
+    ignore_not_found: boolean;
+    /** The `transaction_opaque_data` column (`binary`, nullable). */
+    transaction_opaque_data: Uint8Array | null;
+}
+/** The params of `init`, one property per params-schema column. */
+export interface InitParams {
+    /** The packed `InitRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_buffering_combine`, one property per params-schema column. */
+export interface TableBufferingCombineParams {
+    /** The packed `TableBufferingCombineRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_buffering_destructor`, one property per params-schema column. */
+export interface TableBufferingDestructorParams {
+    /** The packed `TableBufferingDestructorRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_buffering_process`, one property per params-schema column. */
+export interface TableBufferingProcessParams {
+    /** The packed `TableBufferingProcessRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_function_cardinality`, one property per params-schema column. */
+export interface TableFunctionCardinalityParams {
+    /** The packed `TableFunctionCardinalityRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_function_dynamic_to_string`, one property per params-schema column. */
+export interface TableFunctionDynamicToStringParams {
+    /** The packed `TableFunctionDynamicToStringRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_function_plan`, one property per params-schema column. */
+export interface TableFunctionPlanParams {
+    /** The packed `TableFunctionPlanRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/** The params of `table_function_statistics`, one property per params-schema column. */
+export interface TableFunctionStatisticsParams {
+    /** The packed `TableFunctionStatisticsRequest`, as its IPC bytes (`binary`). */
+    request: Uint8Array;
+}
+/**
+ * The `vgi.v2` protocol: every method a VGI worker serves, generated from the
+ * reference (`vgi.protocol.VgiProtocol` in vgi-python).
+ *
+ * The protocol is the unit of optionality: every method is registered, whether
+ * or not this worker implements it, so `vgi_rpc.Reflection.v1` reports one
+ * `vgi.v2` hash in every SDK. Build an implementation by spreading handlers
+ * over {@link UNIMPLEMENTED_VGI_SERVICE}; register it with
+ * {@link registerVgiService}. Never change a signature here by hand:
+ * regenerate it, so the change comes from the protocol.
+ */
+export interface VgiService {
+    /**
+     * Bind an aggregate function, return output schema and execution_id.
+     *
+     * Wire method `aggregate_bind` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateBind(params: AggregateBindParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Merge source states into target states.
+     *
+     * Wire method `aggregate_combine` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateCombine(params: AggregateCombineParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Best-effort cleanup of aggregate states. Must not raise.
+     *
+     * Wire method `aggregate_destructor` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateDestructor(params: AggregateDestructorParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Produce results for a chunk of group_ids.
+     *
+     * Wire method `aggregate_finalize` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateFinalize(params: AggregateFinalizeParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Process one input chunk; returns one output row per input row.
+     *
+     * Wire method `aggregate_streaming_chunk` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateStreamingChunk(params: AggregateStreamingChunkParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * End the streaming session, free per-session state.
+     *
+     * Wire method `aggregate_streaming_close` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateStreamingClose(params: AggregateStreamingCloseParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Start a streaming-partitioned aggregate session.
+     *
+     * Wire method `aggregate_streaming_open` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateStreamingOpen(params: AggregateStreamingOpenParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Accumulate rows from a `DataChunk` into per-group state.
+     *
+     * Wire method `aggregate_update` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateUpdate(params: AggregateUpdateParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Compute an aggregate value for one output row of the window.
+     *
+     * Wire method `aggregate_window` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateWindow(params: AggregateWindowParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Compute ``count`` window output rows in one batched RPC.
+     *
+     * Wire method `aggregate_window_batch` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateWindowBatch(params: AggregateWindowBatchParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Evict a cached partition from storage.
+     *
+     * Wire method `aggregate_window_destructor` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateWindowDestructor(params: AggregateWindowDestructorParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Ship a partition to the worker for windowed aggregation.
+     *
+     * Wire method `aggregate_window_init` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    aggregateWindowInit(params: AggregateWindowInitParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Resolve output schema and validate arguments.
+     *
+     * Wire method `bind` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    bind(params: BindParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Attach to a catalog with options.
+     *
+     * Wire method `catalog_attach` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogAttach(params: CatalogAttachParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List available catalog names.
+     *
+     * Wire method `catalog_catalogs` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogCatalogs(params: CatalogCatalogsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Return every schema and all of its contents in one result.
+     *
+     * Only called when the attach result sets ``supports_catalog_contents``. Replaces ``catalog_schemas`` plus every ``catalog_schema_contents_*`` call for a client that wants the whole catalog. Takes no transaction: the client caches the answer catalog-wide, so it is the committed catalog at ``catalog_version``.
+     *
+     * ``if_none_match`` is the ``etag`` of a snapshot the client holds. When it equals the current etag the response is ``not_modified`` with no schemas. A worker that returns ``etag = None`` ignores it.
+     *
+     * Wire method `catalog_contents` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogContents(params: CatalogContentsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List custom ``COPY ... FROM`` formats advertised by this catalog.
+     *
+     * Catalog-level (not schema-scoped). Returns an empty list for catalogs with no custom formats. Additive: workers that don't implement this method return ``MethodNotImplementedError``, which the VGI extension treats as "this catalog advertises no COPY formats" and continues the ATTACH normally.
+     *
+     * Wire method `catalog_copy_from_formats` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogCopyFromFormats(params: CatalogCopyFromFormatsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Create a new catalog.
+     *
+     * Wire method `catalog_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogCreate(params: CatalogCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Detach from a catalog.
+     *
+     * Wire method `catalog_detach` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogDetach(params: CatalogDetachParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop a catalog.
+     *
+     * Wire method `catalog_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogDrop(params: CatalogDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Create a new index.
+     *
+     * Wire method `catalog_index_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogIndexCreate(params: CatalogIndexCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop an index.
+     *
+     * Wire method `catalog_index_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogIndexDrop(params: CatalogIndexDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get information about an index. Returns 0 or 1 items.
+     *
+     * Wire method `catalog_index_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogIndexGet(params: CatalogIndexGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Create a new macro.
+     *
+     * Wire method `catalog_macro_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogMacroCreate(params: CatalogMacroCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop a macro.
+     *
+     * Wire method `catalog_macro_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogMacroDrop(params: CatalogMacroDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get information about a macro. Returns 0 or 1 items.
+     *
+     * Wire method `catalog_macro_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogMacroGet(params: CatalogMacroGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List functions in a schema (scalar or table).
+     *
+     * Wire method `catalog_schema_contents_functions` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaContentsFunctions(params: CatalogSchemaContentsFunctionsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List indexes in a schema.
+     *
+     * Wire method `catalog_schema_contents_indexes` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaContentsIndexes(params: CatalogSchemaContentsIndexesParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List macros in a schema (scalar or table).
+     *
+     * Wire method `catalog_schema_contents_macros` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaContentsMacros(params: CatalogSchemaContentsMacrosParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List tables in a schema.
+     *
+     * Wire method `catalog_schema_contents_tables` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaContentsTables(params: CatalogSchemaContentsTablesParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List views in a schema.
+     *
+     * Wire method `catalog_schema_contents_views` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaContentsViews(params: CatalogSchemaContentsViewsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Create a new schema.
+     *
+     * Wire method `catalog_schema_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaCreate(params: CatalogSchemaCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop a schema.
+     *
+     * Wire method `catalog_schema_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaDrop(params: CatalogSchemaDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get information about a schema. Returns 0 or 1 items.
+     *
+     * Wire method `catalog_schema_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemaGet(params: CatalogSchemaGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * List schemas in the catalog.
+     *
+     * Wire method `catalog_schemas` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogSchemas(params: CatalogSchemasParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Add a new column to a table.
+     *
+     * Wire method `catalog_table_column_add` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnAdd(params: CatalogTableColumnAddParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Set or clear the comment on a table column.
+     *
+     * Wire method `catalog_table_column_comment_set` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnCommentSet(params: CatalogTableColumnCommentSetParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Remove the default value from a column.
+     *
+     * Wire method `catalog_table_column_default_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnDefaultDrop(params: CatalogTableColumnDefaultDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Set the default value expression for a column.
+     *
+     * Wire method `catalog_table_column_default_set` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnDefaultSet(params: CatalogTableColumnDefaultSetParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop a column from a table.
+     *
+     * Wire method `catalog_table_column_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnDrop(params: CatalogTableColumnDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Rename a column.
+     *
+     * Wire method `catalog_table_column_rename` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnRename(params: CatalogTableColumnRenameParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get column statistics for a table.
+     *
+     * Returns IPC bytes of a `RecordBatch` with sparse-union min/max columns, or None if statistics are not available.
+     *
+     * Wire method `catalog_table_column_statistics_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnStatisticsGet(params: CatalogTableColumnStatisticsGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array | null;
+    }>;
+    /**
+     * Change the type of a column.
+     *
+     * Wire method `catalog_table_column_type_change` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableColumnTypeChange(params: CatalogTableColumnTypeChangeParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Set or clear the comment on a table.
+     *
+     * Wire method `catalog_table_comment_set` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableCommentSet(params: CatalogTableCommentSetParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Create a new table.
+     *
+     * Wire method `catalog_table_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableCreate(params: CatalogTableCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get the delete function for a table. Returns `WriteFunctionResult` as IPC bytes.
+     *
+     * Wire method `catalog_table_delete_function_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableDeleteFunctionGet(params: CatalogTableDeleteFunctionGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Drop a table.
+     *
+     * Wire method `catalog_table_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableDrop(params: CatalogTableDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get information about a table. Returns 0 or 1 items.
+     *
+     * Wire method `catalog_table_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableGet(params: CatalogTableGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Get the insert function for a table. Returns `WriteFunctionResult` as IPC bytes.
+     *
+     * ``writable_branch_function_name`` is set by the C++ extension when the table is multi-branch and a branch declared ``writable=True``: the value is the writable arm's ``ScanBranch.function_name``. The worker uses it to disambiguate which physical arm to dispatch the INSERT to without re-resolving the writable arm internally. For single-branch tables (the common case) this is None and the worker dispatches as today.
+     *
+     * Wire method `catalog_table_insert_function_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableInsertFunctionGet(params: CatalogTableInsertFunctionGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Remove NOT NULL constraint from a column.
+     *
+     * Wire method `catalog_table_not_null_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableNotNullDrop(params: CatalogTableNotNullDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Add NOT NULL constraint to a column.
+     *
+     * Wire method `catalog_table_not_null_set` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableNotNullSet(params: CatalogTableNotNullSetParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Rename a table.
+     *
+     * Wire method `catalog_table_rename` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableRename(params: CatalogTableRenameParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get the list of scan branches for a multi-branch table. Returns `ScanBranchesResult` as IPC bytes.
+     *
+     * Additive successor to ``catalog_table_scan_function_get``. Workers that only implement the legacy method continue to work — the VGI extension's C++ side catches ``MethodNotImplementedError`` and falls back to the legacy RPC, wrapping the single-function result as a one-branch list. Workers that implement BOTH the legacy and the branches method guarantee single-process compatibility with both old and new extensions.
+     *
+     * Multi-branch tables compose a logical scan from N physical sources (canonical case: Kafka hot tier + Iceberg cold tier). The extension's optimizer rewrite stitches the branches together via ``LogicalSetOperation(UNION_ALL, ...)``, one arm per branch.
+     *
+     * Wire method `catalog_table_scan_branches_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableScanBranchesGet(params: CatalogTableScanBranchesGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Get the scan function for a table. Returns `ScanFunctionResult` as IPC bytes.
+     *
+     * Wire method `catalog_table_scan_function_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableScanFunctionGet(params: CatalogTableScanFunctionGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Get the update function for a table. Returns `WriteFunctionResult` as IPC bytes.
+     *
+     * Wire method `catalog_table_update_function_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTableUpdateFunctionGet(params: CatalogTableUpdateFunctionGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Begin a new transaction.
+     *
+     * Wire method `catalog_transaction_begin` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTransactionBegin(params: CatalogTransactionBeginParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Commit a transaction.
+     *
+     * Wire method `catalog_transaction_commit` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTransactionCommit(params: CatalogTransactionCommitParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Rollback a transaction.
+     *
+     * Wire method `catalog_transaction_rollback` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogTransactionRollback(params: CatalogTransactionRollbackParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get the current catalog version.
+     *
+     * Wire method `catalog_version` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogVersion(params: CatalogVersionParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Set or clear the comment on a view.
+     *
+     * Wire method `catalog_view_comment_set` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogViewCommentSet(params: CatalogViewCommentSetParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Create a new view.
+     *
+     * Wire method `catalog_view_create` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogViewCreate(params: CatalogViewCreateParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Drop a view.
+     *
+     * Wire method `catalog_view_drop` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogViewDrop(params: CatalogViewDropParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Get information about a view. Returns 0 or 1 items.
+     *
+     * Wire method `catalog_view_get` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogViewGet(params: CatalogViewGetParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Rename a view.
+     *
+     * Wire method `catalog_view_rename` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    catalogViewRename(params: CatalogViewRenameParams, ctx: CallContext): VgiReply<NoResult>;
+    /**
+     * Initialize a function execution and return a processing stream.
+     *
+     * Wire method `init` (stream, headed by a `GlobalInitResponse`). Default: answers `UNIMPLEMENTED`.
+     */
+    readonly init: VgiStream;
+    /**
+     * Once-per-query end-of-input signal. Returns finalize_state_ids.
+     *
+     * Wire method `table_buffering_combine` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableBufferingCombine(params: TableBufferingCombineParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Best-effort end-of-query cleanup. Must not raise.
+     *
+     * Wire method `table_buffering_destructor` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableBufferingDestructor(params: TableBufferingDestructorParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Sink one input batch; return the worker-chosen state_id.
+     *
+     * Wire method `table_buffering_process` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableBufferingProcess(params: TableBufferingProcessParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Estimate the cardinality of a table function's output.
+     *
+     * Wire method `table_function_cardinality` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableFunctionCardinality(params: TableFunctionCardinalityParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Return user-defined diagnostics for EXPLAIN ANALYZE Extra Info.
+     *
+     * Fired once per parallel scan thread at end-of-stream. The function class is responsible for persisting any diagnostics it wants to report and retrieving them by ``global_execution_id`` here.
+     *
+     * Best-effort: must not raise. The dispatcher catches exceptions and returns an empty response so EXPLAIN ANALYZE never breaks the query.
+     *
+     * Wire method `table_function_dynamic_to_string` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableFunctionDynamicToString(params: TableFunctionDynamicToStringParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Plan a table-function scan into named, independently redeemable splits.
+     *
+     * Runs once with the pushdown filters; each returned split is then redeemed by ``init()`` from any process or host. Workers that do not opt in via ``supports_splits`` inherit a framework default.
+     *
+     * Wire method `table_function_plan` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableFunctionPlan(params: TableFunctionPlanParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array;
+    }>;
+    /**
+     * Return per-column statistics for a table function's output.
+     *
+     * Returns IPC bytes of a `RecordBatch` with sparse-union min/max columns (same shape as `catalog_table_column_statistics_get`), or None if no statistics are available.
+     *
+     * Wire method `table_function_statistics` (unary). Default: answers `UNIMPLEMENTED`.
+     */
+    tableFunctionStatistics(params: TableFunctionStatisticsParams, ctx: CallContext): VgiReply<{
+        result: Uint8Array | null;
+    }>;
+}
+/** One `vgi.v2` method: its wire name, its `VgiService` member, and its schemas. */
+export type VgiMethodSpec = {
+    readonly name: string;
+    readonly key: keyof VgiService;
+    readonly type: "unary";
+    readonly params: VgiSchema;
+    /** The `result` column, or no fields for a method that returns nothing. */
+    readonly result: VgiSchema;
+    readonly doc: string;
+} | {
+    readonly name: string;
+    readonly key: keyof VgiService;
+    readonly type: "stream";
+    readonly params: VgiSchema;
+    readonly header: VgiSchema | null;
+    readonly doc: string;
+};
+/**
+ * Every `vgi.v2` method, sorted by wire name, with the reference's
+ * params / result / header schemas. This table is what
+ * {@link registerVgiService} registers, so it is what reflection hashes.
+ */
+export declare const VGI_V2_METHODS: readonly VgiMethodSpec[];
+/**
+ * A `VgiService` in which every method answers `UNIMPLEMENTED` /
+ * `method_not_implemented` with `"<method> is not implemented by this worker"`.
+ */
+export declare const UNIMPLEMENTED_VGI_SERVICE: VgiService;
+/** The message every unimplemented method answers with. */
+export declare function unimplementedMessage(method: string): string;
+/**
+ * Register every `vgi.v2` method on *protocol*, with the reference's schemas
+ * from {@link VGI_V2_METHODS} and the handlers from *service*.
+ */
+export declare function registerVgiService(protocol: Protocol, service: VgiService): Protocol;
+/** A `Protocol` named {@link VGI_PROTOCOL_NAME} at {@link VGI_PROTOCOL_VERSION}, serving *service*. */
+export declare function createVgiProtocol(service: VgiService): Protocol;