@query-farm/vgi 0.28.0 → 0.29.1

package/dist/functions/types.d.ts

@@ -1,6 +1,6 @@
 import type { VgiSchema, VgiBatch } from "../arrow/index.js";
 import type { OutputCollector } from "@query-farm/vgi-rpc";
-import type { FunctionStability, NullHandling, OrderPreservation, OrderDependence, DistinctDependence, TableCardinality } from "../types.js";
+import type { FunctionStability, NullHandling, ArgumentMonotonicity, OrderPreservation, OrderDependence, DistinctDependence, TableCardinality } from "../types.js";
 import type { BindRequest, BindResponse, InitRequest, GlobalInitResponse, TableFunctionCardinalityRequest } from "../protocol/types.js";
 import type { ArgumentSpec } from "../arguments/argument-spec.js";
 /** Convention for handler state: mutable user state lives in `.state`. */
@@ -14,14 +14,31 @@ export interface FunctionExample {
     description: string;
     expectedOutput?: string;
 }
+export interface FilterFunctionCapability {
+    namespace: string;
+    name: string;
+    version: number;
+}
+export interface EvaluationContextCapability {
+    profile: string;
+    providerFingerprint?: string | null;
+}
 export interface FunctionMeta {
     name: string;
     description?: string;
     stability?: FunctionStability;
     nullHandling?: NullHandling;
+    /** Scalar-only claims in argument declaration order. A vararg is one slot. */
+    argumentMonotonicity?: ArgumentMonotonicity[] | null;
     examples?: FunctionExample[];
     categories?: string[];
     tags?: Record<string, string>;
+    /**
+     * Authoritative typed parameter defaults. The batch must contain one row
+     * and only defaulted parameters, in signature order; a present null is an
+     * explicit null default. `vgi_default` field metadata remains discovery-only.
+     */
+    parameterDefaultValues?: VgiBatch | null;
     projectionPushdown?: boolean;
     filterPushdown?: boolean;
     samplingPushdown?: boolean;
@@ -34,7 +51,10 @@ export interface FunctionMeta {
      * for tables whose worker also guarantees a UNIQUE, snapshot-stable rowid.
      */
     lateMaterialization?: boolean;
-    supportedExpressionFilters?: string[];
+    filterSemanticProfiles?: string[];
+    additionalFilterFunctions?: FilterFunctionCapability[];
+    runtimeFilterAlgorithms?: FilterFunctionCapability[];
+    filterEvaluationContexts?: EvaluationContextCapability[];
     autoApplyFilters?: boolean;
     preservesOrder?: OrderPreservation;
     maxWorkers?: number;
@@ -82,6 +102,38 @@ export interface FunctionMeta {
      * `supports_batch_index`.
      */
     supportsBatchIndex?: boolean;
+    /**
+     * table (generator): the scan divides into named, independently redeemable
+     * splits (see the `plan` / `onSplit` hooks). Surfaces as FunctionInfo
+     * `supports_splits`.
+     *
+     * The declaration is what a distributed engine reads to decide whether it can
+     * retry a task: a split NAMES its work, so re-running one reads exactly the
+     * same rows. Without it, the division lives behind an opaque worker-side queue
+     * and a retry reads neither what it read before nor what it missed.
+     */
+    supportsSplits?: boolean;
+    /**
+     * table (generator): the worker applies every pushed filter EXACTLY, so the
+     * engine may drop its own copy rather than re-filtering. Wrong answers if
+     * declared falsely — leave unset unless certain.
+     */
+    filtersExactlyApplied?: boolean;
+    /**
+     * table (generator): addressable positions in the data, for incremental and
+     * streaming reads. The engine owns the checkpoint; this declares only that
+     * positions are meaningful to externalize.
+     */
+    supportsPositions?: boolean;
+    /**
+     * table (generator): how long a split token stays redeemable.
+     *
+     * UNSET MEANS UNBOUNDED, not "expires immediately" — a client must not assume
+     * a TTL exists, or long-running streams are foreclosed. A client rejects a
+     * plan whose TTL is below its own planning-to-task-start horizon, which on a
+     * busy cluster is hours rather than seconds.
+     */
+    splitTokenTtlSeconds?: number;
     /**
      * table (generator): Hive-style partition-columns mode. Functions declare
      * a PartitionKind and annotate bind-schema fields; emitted batches carry
@@ -146,6 +198,12 @@ export interface VgiFunction {
     globalInit(request: InitRequest): GlobalInitResponse | Promise<GlobalInitResponse>;
     createStreamHandlers(request: InitRequest, response: GlobalInitResponse, accumulatedState?: any): StreamHandlers;
     cardinality?(request: TableFunctionCardinalityRequest): TableCardinality | Promise<TableCardinality>;
+    /**
+     * Divide a scan into named, independently redeemable splits. Absent means the
+     * function is not split-capable: the whole scan is one unit of work, and the
+     * framework answers with a single empty-payload split.
+     */
+    plan?(request: import("../protocol/serializers/splits.js").TableFunctionPlanRequest): import("../protocol/serializers/splits.js").PlanResult | Promise<import("../protocol/serializers/splits.js").PlanResult>;
     /**
      * Per-column statistics for this table function's output given the user's
      * bind-time arguments. Returns null/[] when stats are unknown. Wired to the

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

@@ -1,3 +1,4 @@
+export type ArgumentMonotonicity = "UNKNOWN" | "CONSTANT" | "NON_DECREASING" | "STRICTLY_INCREASING" | "NON_INCREASING" | "STRICTLY_DECREASING";
 export type DistinctDependence = "DISTINCT_DEPENDENT" | "NOT_DISTINCT_DEPENDENT";
 export type FunctionStability = "CONSISTENT" | "VOLATILE" | "CONSISTENT_WITHIN_QUERY";
 export type FunctionType = "SCALAR" | "TABLE" | "TABLE_BUFFERING" | "AGGREGATE";
@@ -31,14 +32,14 @@ export interface SchemaInfo {
     comment?: string | null;
     tags: Record<string, string>;
     attach_opaque_data: Uint8Array;
-    name: string;
+    path: string[];
     estimated_object_count?: Record<string, number> | null;
 }
 export interface TableInfo {
     comment?: string | null;
     tags: Record<string, string>;
     name: string;
-    schema_name: string;
+    schema_path: string[];
     columns: Uint8Array;
     not_null_constraints: number[];
     unique_constraints: number[][];
@@ -64,7 +65,7 @@ export interface ViewInfo {
     comment?: string | null;
     tags: Record<string, string>;
     name: string;
-    schema_name: string;
+    schema_path: string[];
     definition: string;
     column_comments: Record<string, string>;
 }
@@ -73,6 +74,20 @@ export interface CatalogExample {
     description: string;
     expected_output?: string | null;
 }
+export interface FilterFunctionCapability {
+    namespace: string;
+    name: string;
+    version: number;
+}
+export interface RuntimeFilterAlgorithmCapability {
+    namespace: string;
+    name: string;
+    version: number;
+}
+export interface EvaluationContextCapability {
+    profile: string;
+    provider_fingerprint?: string | null;
+}
 export interface SecretLookupEntry {
     secret_type: string;
     scope?: string | null;
@@ -82,12 +97,14 @@ export interface FunctionInfo {
     comment?: string | null;
     tags: Record<string, string>;
     name: string;
-    schema_name: string;
+    schema_path: string[];
     function_type: FunctionType;
     arguments: Uint8Array;
     output_schema: Uint8Array;
+    parameter_default_values?: /** @record-batch */ Uint8Array | null;
     stability?: FunctionStability | null;
     null_handling?: NullHandling | null;
+    argument_monotonicity?: ArgumentMonotonicity[] | null;
     description: string;
     examples: CatalogExample[];
     categories: string[];
@@ -95,10 +112,17 @@ export interface FunctionInfo {
     filter_pushdown?: boolean | null;
     sampling_pushdown?: boolean | null;
     late_materialization?: boolean | null;
-    supported_expression_filters: string[];
+    filter_semantic_profiles: string[];
+    additional_filter_functions: FilterFunctionCapability[];
+    runtime_filter_algorithms: RuntimeFilterAlgorithmCapability[];
+    filter_evaluation_contexts: EvaluationContextCapability[];
     order_preservation?: OrderPreservation | null;
     max_workers?: number | null;
     supports_batch_index: boolean;
+    supports_splits: boolean;
+    filters_exactly_applied: boolean;
+    supports_positions: boolean;
+    split_token_ttl_seconds?: number | null;
     partition_kind: PartitionKind;
     order_dependent: OrderDependence;
     distinct_dependent: DistinctDependence;
@@ -116,7 +140,7 @@ export interface MacroInfo {
     comment?: string | null;
     tags: Record<string, string>;
     name: string;
-    schema_name: string;
+    schema_path: string[];
     macro_type: MacroType;
     parameters: string[];
     parameter_default_values?: /** @record-batch */ Uint8Array | null;
@@ -127,7 +151,7 @@ export interface IndexInfo {
     comment?: string | null;
     tags: Record<string, string>;
     name: string;
-    schema_name: string;
+    schema_path: string[];
     table_name: string;
     index_type: string;
     constraint_type: IndexConstraintType;
@@ -141,7 +165,8 @@ export interface AggregateBindRequest {
     settings?: /** @record-batch */ Uint8Array | null;
     secrets?: /** @record-batch */ Uint8Array | null;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
+    argument_names?: (string | null)[] | null;
 }
 export interface AggregateBindResponse {
     output_schema: Uint8Array;
@@ -152,7 +177,7 @@ export interface AggregateCombineRequest {
     execution_id: Uint8Array;
     merge_batch: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateCombineResponse {
 }
@@ -161,7 +186,7 @@ export interface AggregateDestructorRequest {
     execution_id: Uint8Array;
     group_ids_batch: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateDestructorResponse {
 }
@@ -171,7 +196,7 @@ export interface AggregateFinalizeRequest {
     group_ids_batch: Uint8Array;
     output_schema: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateFinalizeResponse {
     result_batch: Uint8Array;
@@ -181,7 +206,7 @@ export interface AggregateStreamingChunkRequest {
     execution_id: Uint8Array;
     input_batch: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateStreamingChunkResponse {
     result_batch: Uint8Array;
@@ -190,7 +215,7 @@ export interface AggregateStreamingCloseRequest {
     function_name: string;
     execution_id: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateStreamingCloseResponse {
 }
@@ -204,7 +229,7 @@ export interface AggregateStreamingOpenRequest {
     settings?: /** @record-batch */ Uint8Array | null;
     secrets?: /** @record-batch */ Uint8Array | null;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateStreamingOpenResponse {
     execution_id: Uint8Array;
@@ -214,7 +239,7 @@ export interface AggregateUpdateRequest {
     execution_id: Uint8Array;
     input_batch: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateUpdateResponse {
 }
@@ -226,7 +251,7 @@ export interface AggregateWindowRequest {
     frame_starts: number[];
     frame_ends: number[];
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateWindowResponse {
     result_batch: Uint8Array;
@@ -241,7 +266,7 @@ export interface AggregateWindowBatchRequest {
     frame_starts: number[];
     frame_ends: number[];
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateWindowBatchResponse {
     result_batch: Uint8Array;
@@ -251,7 +276,7 @@ export interface AggregateWindowDestructorRequest {
     execution_id: Uint8Array;
     partition_id: number;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateWindowDestructorResponse {
 }
@@ -266,7 +291,7 @@ export interface AggregateWindowInitRequest {
     frame_stats: Uint8Array;
     all_valid: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface AggregateWindowInitResponse {
 }
@@ -293,7 +318,8 @@ export interface BindRequest {
     at_value?: string | null;
     copy_from?: CopyFromContext | null;
     copy_to?: CopyToContext | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
+    argument_names?: (string | null)[] | null;
 }
 export interface BindResponse {
     output_schema: Uint8Array;
@@ -302,11 +328,19 @@ export interface BindResponse {
     lookup_scopes: string[];
     lookup_names: string[];
 }
+export interface ClientCapabilities {
+    engine: string;
+    native_formats: string[];
+    catalogs: string[];
+    can_stream: boolean;
+    filter_encodings: string[];
+}
 export interface CatalogAttachRequest {
     name: string;
     options?: /** @record-batch */ Uint8Array | null;
     data_version_spec?: string | null;
     implementation_version?: string | null;
+    client_capabilities?: ClientCapabilities | null;
 }
 export interface CatalogAttachResult {
     attach_opaque_data: Uint8Array;
@@ -340,7 +374,7 @@ export interface CatalogCreateRequest {
 }
 export interface IndexCreateRequest {
     attach_opaque_data: Uint8Array;
-    schema_name: string;
+    schema_path: string[];
     name: string;
     table_name: string;
     index_type: string;
@@ -355,7 +389,7 @@ export interface IndexesResponse {
 }
 export interface MacroCreateRequest {
     attach_opaque_data: Uint8Array;
-    schema_name: string;
+    schema_path: string[];
     name: string;
     macro_type: MacroType;
     parameters: string[];
@@ -382,7 +416,7 @@ export interface SchemasResponse {
 }
 export interface TableCreateRequest {
     attach_opaque_data: Uint8Array;
-    schema_name: string;
+    schema_path: string[];
     name: string;
     columns: Uint8Array;
     on_conflict: OnConflict;
@@ -406,6 +440,8 @@ export interface InitRequest {
     projection_ids?: number[] | null;
     pushdown_filters?: /** @record-batch */ Uint8Array | null;
     join_keys?: /** @record-batch */ Uint8Array[] | null;
+    split_tokens?: Uint8Array[] | null;
+    row_limit?: number | null;
     phase?: TableInOutFunctionInitPhase | null;
     finalize_state_id?: Uint8Array | null;
     execution_id?: Uint8Array | null;
@@ -424,7 +460,7 @@ export interface TableBufferingCombineRequest {
     state_ids: Uint8Array[];
     attach_opaque_data?: Uint8Array | null;
     transaction_id?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface TableBufferingCombineResponse {
     finalize_state_ids: Uint8Array[];
@@ -434,7 +470,7 @@ export interface TableBufferingDestructorRequest {
     execution_id: Uint8Array;
     attach_opaque_data?: Uint8Array | null;
     transaction_id?: Uint8Array | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface TableBufferingDestructorResponse {
 }
@@ -445,7 +481,7 @@ export interface TableBufferingProcessRequest {
     attach_opaque_data?: Uint8Array | null;
     transaction_id?: Uint8Array | null;
     batch_index?: number | null;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
 }
 export interface TableBufferingProcessResponse {
     state_id: Uint8Array;
@@ -467,6 +503,58 @@ export interface TableFunctionDynamicToStringResponse {
     keys: string[];
     values: string[];
 }
+export interface TableFunctionPlanRequest {
+    bind_call: BindRequest;
+    bind_opaque_data?: Uint8Array | null;
+    projection_ids?: number[] | null;
+    pushdown_filters?: /** @record-batch */ Uint8Array | null;
+    join_keys?: /** @record-batch */ Uint8Array[] | null;
+    row_limit?: number | null;
+    target_split_bytes?: number | null;
+    min_splits?: number | null;
+    max_splits_per_response?: number | null;
+    cursor?: Uint8Array | null;
+    refined_filters?: /** @record-batch */ Uint8Array | null;
+    filters_complete: boolean;
+    start_position?: Uint8Array | null;
+    end_position?: Uint8Array | null;
+    order_by_column_name?: string | null;
+    order_by_direction?: OrderByDirection | null;
+    order_by_null_order?: OrderByNullOrder | null;
+    order_by_limit?: number | null;
+    tablesample_percentage?: number | null;
+    tablesample_seed?: number | null;
+}
+export interface ScanSplit {
+    payload: Uint8Array;
+    token: Uint8Array;
+    estimated_rows?: number | null;
+    rows_exact: boolean;
+    estimated_bytes?: number | null;
+    partition_bounds?: /** @record-batch */ Uint8Array | null;
+    column_statistics?: Uint8Array | null;
+    location_ids?: number[] | null;
+    start_position?: Uint8Array | null;
+    end_position?: Uint8Array | null;
+}
+export interface PlanResponse {
+    splits: ScanSplit[] | Uint8Array[];
+    next_cursors?: Uint8Array[] | null;
+    execution_id?: Uint8Array | null;
+    init_opaque_data?: Uint8Array | null;
+    max_workers?: number | null;
+    estimated_total_splits?: number | null;
+    estimated_total_rows?: number | null;
+    estimated_total_bytes?: number | null;
+    catalog_version?: number | null;
+    scope: string;
+    locations?: string[] | null;
+    partitioning?: Uint8Array[] | null;
+    sort_order?: Uint8Array[] | null;
+    cache_max_age_seconds?: number | null;
+    start_position?: Uint8Array | null;
+    end_position?: Uint8Array | null;
+}
 export interface TableFunctionStatisticsRequest {
     bind_call: BindRequest;
     bind_opaque_data?: Uint8Array | null;

package/dist/generated/vgi-protocol-schemas.d.ts

@@ -9,7 +9,39 @@ export declare const CopyFromFormatInfoSchema: import("../index.core.js").VgiSch
 export declare const ScanFunctionResultSchema: import("../index.core.js").VgiSchema;
 export declare const ScanBranchesResultSchema: import("../index.core.js").VgiSchema;
 export declare const ScanBranchSchema: import("../index.core.js").VgiSchema;
+export declare const ScanSplitSchema: import("../index.core.js").VgiSchema;
 export declare const AttachCatalogInfoSchema: import("../index.core.js").VgiSchema;
+export declare const ForeignKeyInfoSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateBindRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateCombineRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateDestructorRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateFinalizeRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateStreamingChunkRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateStreamingCloseRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateStreamingOpenRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateUpdateRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateWindowBatchRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateWindowDestructorRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateWindowInitRequestSchema: import("../index.core.js").VgiSchema;
+export declare const AggregateWindowRequestSchema: import("../index.core.js").VgiSchema;
+export declare const BindRequestSchema: import("../index.core.js").VgiSchema;
+export declare const CatalogAttachRequestSchema: import("../index.core.js").VgiSchema;
+export declare const CatalogCreateRequestSchema: import("../index.core.js").VgiSchema;
+export declare const ClientCapabilitiesSchema: import("../index.core.js").VgiSchema;
+export declare const CopyFromContextSchema: import("../index.core.js").VgiSchema;
+export declare const CopyToContextSchema: import("../index.core.js").VgiSchema;
+export declare const GlobalInitResponseSchema: import("../index.core.js").VgiSchema;
+export declare const IndexCreateRequestSchema: import("../index.core.js").VgiSchema;
+export declare const InitRequestSchema: import("../index.core.js").VgiSchema;
+export declare const MacroCreateRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableCreateRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableBufferingCombineRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableBufferingDestructorRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableBufferingProcessRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionCardinalityRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionDynamicToStringRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionPlanRequestSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionStatisticsRequestSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateBindResultSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateCombineResultSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateDestructorResultSchema: import("../index.core.js").VgiSchema;
@@ -44,6 +76,7 @@ export declare const TableBufferingDestructorResultSchema: import("../index.core
 export declare const TableBufferingProcessResultSchema: import("../index.core.js").VgiSchema;
 export declare const TableFunctionCardinalityResultSchema: import("../index.core.js").VgiSchema;
 export declare const TableFunctionDynamicToStringResultSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionPlanResultSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateBindParamsSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateCombineParamsSchema: import("../index.core.js").VgiSchema;
 export declare const AggregateDestructorParamsSchema: import("../index.core.js").VgiSchema;
@@ -113,4 +146,5 @@ export declare const TableBufferingDestructorParamsSchema: import("../index.core
 export declare const TableBufferingProcessParamsSchema: import("../index.core.js").VgiSchema;
 export declare const TableFunctionCardinalityParamsSchema: import("../index.core.js").VgiSchema;
 export declare const TableFunctionDynamicToStringParamsSchema: import("../index.core.js").VgiSchema;
+export declare const TableFunctionPlanParamsSchema: import("../index.core.js").VgiSchema;
 export declare const TableFunctionStatisticsParamsSchema: import("../index.core.js").VgiSchema;

package/dist/http/fetch.d.ts

@@ -1,3 +1,4 @@
+import { type AuthenticateFn, type PeerAuthenticationPolicy, type PeerIdentityProvider, type PeerResolutionOptions } from "@query-farm/vgi-rpc";
 import { type ProtocolConfig } from "../protocol/dispatch.js";
 import { type LandingInfo } from "./landing.js";
 export interface VgiFetchOptions {
@@ -42,6 +43,21 @@ export interface VgiFetchOptions {
      *  its required name/doc/version; the CF entry had to remember, and
      *  vgi-open-meteo shipped for weeks without it. */
     landingInfo: LandingInfo;
+    /** Authenticates each incoming request, returning the caller's
+     *  {@link AuthContext}. Forwarded verbatim to `createHttpHandler`; omit it
+     *  and every caller is anonymous, which is what this package did before the
+     *  option existed.
+     *
+     *  Supplying it is what makes a worker able to serve more than one principal,
+     *  and the identity it returns is the one the worker seals `attach_opaque_data`
+     *  and split tokens under. */
+    authenticate?: AuthenticateFn;
+    /** Off-wire transport identities, including a trusted Iroh HTTP bridge. */
+    peerIdentityProviders?: readonly PeerIdentityProvider[];
+    /** Policy composing peer evidence with application authentication. */
+    peerAuthenticationPolicy?: PeerAuthenticationPolicy;
+    /** Host adapter supplying the physical peer and multiplicity-preserving headers. */
+    peerResolutionContext?: (request: Request) => PeerResolutionOptions | Promise<PeerResolutionOptions>;
 }
 /**
  * Build a fetch handler suitable for `export default { fetch }` in a CF

package/dist/index.core.d.ts

@@ -7,12 +7,12 @@ export { defineTableBufferingFunction, type TableBufferingConfig, type TableBuff
 export { defineCopyFromFunction, type CopyFromFunctionConfig, type CopyFromOption, type CopyFromReadParams, } from "./functions/copy-from.js";
 export { defineCopyToFunction, type CopyToFunctionConfig, type CopyToOption, type CopyToWriteParams, type CopyToCloseParams, } from "./functions/copy-to.js";
 export type { VgiFunction, FunctionMeta, StreamHandlers, FunctionExample, HandlerState } from "./functions/types.js";
-export { CatalogInterface, type CatalogAttachResult, type SchemaInfo, encodeSchemaInfo, decodeSchemaInfo, type TableInfo, encodeTableInfo, decodeTableInfo, type ViewInfo, encodeViewInfo, decodeViewInfo, type CatalogInfo, encodeCatalogInfo, decodeCatalogInfo, type FunctionInfo, encodeFunctionInfo, decodeFunctionInfo, type FunctionInfoOptions, type MacroInfo, encodeMacroInfo, decodeMacroInfo, type MacroType, type CopyFromFormatInfo, encodeCopyFromFormatInfo, type AttachOpaqueData, type TransactionOpaqueData, buildScanBranchesResult, type ScanBranchInput } from "./catalog/interface.js";
+export { CatalogInterface, type CatalogAttachResult, type SchemaInfo, encodeSchemaInfo, decodeSchemaInfo, type TableInfo, encodeTableInfo, decodeTableInfo, type ViewInfo, encodeViewInfo, decodeViewInfo, type CatalogInfo, encodeCatalogInfo, decodeCatalogInfo, type FunctionInfo, encodeFunctionInfo, decodeFunctionInfo, type FunctionInfoOptions, type MacroInfo, encodeMacroInfo, decodeMacroInfo, type MacroType, type CopyFromFormatInfo, encodeCopyFromFormatInfo, type AttachOpaqueData, type TransactionOpaqueData, buildScanBranchesResult, encodeFormatOptions, type ScanBranchInput } from "./catalog/interface.js";
 export type { CatalogDescriptor, SchemaDescriptor, TableDescriptor, ViewDescriptor, MacroDescriptor, SettingDescriptor, SecretTypeDescriptor, ForeignKeyDef, DefaultValue } from "./catalog/descriptors.js";
 export { ReadOnlyCatalogInterface } from "./catalog/read-only.js";
 export { CompositeCatalogInterface } from "./catalog/composite.js";
 export { FunctionRegistry } from "./functions/registry.js";
-export { FunctionType, FunctionStability, NullHandling, OrderPreservation, OrderDependence, DistinctDependence, TableInOutPhase, DEFAULT_MAX_WORKERS, } from "./types.js";
+export { FunctionType, FunctionStability, NullHandling, ArgumentMonotonicity, OrderPreservation, OrderDependence, DistinctDependence, TableInOutPhase, DEFAULT_MAX_WORKERS, } from "./types.js";
 export type { BindRequest, BindResponse, CopyFromContext, CopyToContext, InitRequest, GlobalInitResponse, TableCardinality, } from "./protocol/types.js";
 export { Arguments } from "./arguments/arguments.js";
 export { type ArgumentSpec, type ArgumentConstraints, argumentSpecsToSchema, schemaToArgumentSpecs, macroArgumentsSchema, macroParameterDocsFromSchema, formatRange, constraintSpecFields } from "./arguments/argument-spec.js";
@@ -33,7 +33,7 @@ export { toUint8Array } from "./util/bytes.js";
 export { iterRows, batchFromRows, batchFromColumns, emptyBatch, filterBatch, projectSchema, projectBatch, batchToScalarDict, batchToSecretDict, safeNumber, } from "./util/arrow/index.js";
 export { type SecretFields, type SecretsDict, secretType, secretsOfType, secretForScope, secretForScopeOfType, } from "./secrets/helpers.js";
 export { serializeSchema, deserializeSchema, serializeBatch, deserializeBatch, } from "./util/arrow/index.js";
-export { schema, field, nullType, int8, int16, int64, uint8, uint16, uint32, uint64, float16, float64, utf8, binary, fixedSizeBinary, decimal, decimal128, decimal256, date, dateDay, dateMillisecond, time, timeSecond, timeMillisecond, timeMicrosecond, timeNanosecond, timestamp, duration, interval, timestampSeconds, timestampMillis, timestampMicros, timestampNanos, durationSeconds, durationMillis, durationMicros, durationNanos, list, fixedSizeList, struct, map, dictionary, union, sparseUnion, denseUnion, TimeUnit, DateUnit, IntervalUnit, UnionMode, codecFor, asDate32, asDate64Ms, asTime32S, asTime32Ms, asTime64Us, asTime64Ns, asTimestampSeconds, asTimestampMillis, asTimestampMicros, asTimestampNanos, asDurationSeconds, asDurationMillis, asDurationMicros, asDurationNanos, asUnscaledDecimal, asInt64, asUint64, fromBranded, fromBrandedNumber, fromBrandedBigInt, TypeId, isNull, isInt, isFloat, isBinary, isUtf8, isBool, isDecimal, isDate, isTime, isTimestamp, isInterval, isList, isStruct, isUnion, isFixedSizeBinary, isFixedSizeList, isMap, isDuration, isDictionary, isBatch, typeSignature, readCanonicalValue, columnFromArray, decodeDictValue, backend, adoptArrowJsShape, } from "./arrow/index.js";
+export { schema, field, nullType, int8, int16, int64, uint8, uint16, uint32, uint64, float16, float64, utf8, largeUtf8, binary, largeBinary, fixedSizeBinary, decimal, decimal128, decimal256, date, dateDay, dateMillisecond, time, timeSecond, timeMillisecond, timeMicrosecond, timeNanosecond, timestamp, duration, interval, timestampSeconds, timestampMillis, timestampMicros, timestampNanos, durationSeconds, durationMillis, durationMicros, durationNanos, list, fixedSizeList, struct, map, dictionary, union, sparseUnion, denseUnion, TimeUnit, DateUnit, IntervalUnit, UnionMode, codecFor, asDate32, asDate64Ms, asTime32S, asTime32Ms, asTime64Us, asTime64Ns, asTimestampSeconds, asTimestampMillis, asTimestampMicros, asTimestampNanos, asDurationSeconds, asDurationMillis, asDurationMicros, asDurationNanos, asUnscaledDecimal, asInt64, asUint64, fromBranded, fromBrandedNumber, fromBrandedBigInt, TypeId, isNull, isInt, isFloat, isBinary, isUtf8, isBool, isDecimal, isDate, isTime, isTimestamp, isInterval, isList, isStruct, isUnion, isFixedSizeBinary, isFixedSizeList, isMap, isDuration, isDictionary, isBatch, typeSignature, readCanonicalValue, columnFromArray, decodeDictValue, backend, adoptArrowJsShape, } from "./arrow/index.js";
 export type { VgiTypeId, VgiDataType, VgiField, VgiSchema, VgiColumn, VgiColumnData, VgiBatch, VgiBackendInfo, TaggedUnion, NullDescriptor, BoolType, IntType, Int8Type, Int16Type, Int32Type, Int64Type, Uint8Type, Uint16Type, Uint32Type, Uint64Type, FloatType, Utf8Type, LargeUtf8Type, BinaryType, LargeBinaryType, FixedSizeBinaryType, DecimalType, Date32Type, Date64Type, Time32Type, Time64Type, TimestampType, DurationType, IntervalType, ListType, FixedSizeListType, StructType, MapType, DictionaryType, UnionType, TypedField, TUnit, RichValue, RawValue, ValueFor, Repr, Codec, Branded, Date32, Date64Ms, Time32S, Time32Ms, Time64Us, Time64Ns, TimestampSeconds, TimestampMillis, TimestampMicros, TimestampNanos, DurationSeconds, DurationMillis, DurationMicros, DurationNanos, UnscaledDecimal, Int64Raw, Uint64Raw, } from "./arrow/index.js";
 export type { ScalarComputeRow, ScalarOutputValue, ScalarComputeResult } from "./functions/scalar.js";
 export { type FunctionStorage, FunctionStorageSqlite, BoundStorage, UnknownInvocationError, resolveStorageFromEnv, setStorage, storage as functionStorage, } from "./functions/storage.js";
@@ -43,3 +43,4 @@ export type { VgiClientOptions, TableFunctionOptions, ScalarFunctionOptions, Tab
 export { str, bytes, int, int32, float, float32, bool, toSchema, OutputCollector, AuthContext } from "@query-farm/vgi-rpc";
 export { subprocessConnect, httpConnect, tcpConnect } from "@query-farm/vgi-rpc";
 export type { RpcClient, StreamSession, LogMessage } from "@query-farm/vgi-rpc";
+export { normalizeSchemaPath, schemaPathDisplay, schemaPathKey, schemaPathsEqual, type SchemaPath } from "./schema-path.js";