@query-farm/vgi 0.29.0 → 0.30.0

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,24 +32,21 @@ 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[][];
     check_constraints: string[];
     primary_key_constraints: number[][];
     foreign_key_constraints: Uint8Array[];
-    supports_insert: boolean;
-    supports_update: boolean;
-    supports_delete: boolean;
-    supports_returning: boolean;
+    write_result_modes: Record<string, string>;
     supports_column_statistics: boolean;
     scan_function?: Uint8Array | null;
     insert_function?: Uint8Array | null;
@@ -64,7 +62,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 +71,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 +94,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,7 +109,10 @@ 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;
@@ -120,7 +137,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;
@@ -131,7 +148,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;
@@ -145,7 +162,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;
@@ -156,7 +174,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 {
 }
@@ -165,7 +183,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 {
 }
@@ -175,7 +193,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;
@@ -185,7 +203,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;
@@ -194,7 +212,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 {
 }
@@ -208,7 +226,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;
@@ -218,7 +236,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 {
 }
@@ -230,7 +248,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;
@@ -245,7 +263,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;
@@ -255,7 +273,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 {
 }
@@ -270,7 +288,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 {
 }
@@ -297,7 +315,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;
@@ -306,12 +325,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?: Uint8Array | null;
+    client_capabilities?: ClientCapabilities | null;
 }
 export interface CatalogAttachResult {
     attach_opaque_data: Uint8Array;
@@ -345,7 +371,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;
@@ -360,7 +386,7 @@ export interface IndexesResponse {
 }
 export interface MacroCreateRequest {
     attach_opaque_data: Uint8Array;
-    schema_name: string;
+    schema_path: string[];
     name: string;
     macro_type: MacroType;
     parameters: string[];
@@ -387,7 +413,7 @@ export interface SchemasResponse {
 }
 export interface TableCreateRequest {
     attach_opaque_data: Uint8Array;
-    schema_name: string;
+    schema_path: string[];
     name: string;
     columns: Uint8Array;
     on_conflict: OnConflict;
@@ -431,7 +457,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[];
@@ -441,7 +467,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 {
 }
@@ -452,7 +478,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;

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

@@ -11,22 +11,37 @@ export declare const ScanBranchesResultSchema: import("../index.core.js").VgiSch
 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;

package/dist/http/fetch.d.ts

@@ -1,4 +1,4 @@
-import { type AuthenticateFn } from "@query-farm/vgi-rpc";
+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 {
@@ -52,6 +52,12 @@ export interface VgiFetchOptions {
      *  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

@@ -12,7 +12,7 @@ export type { CatalogDescriptor, SchemaDescriptor, TableDescriptor, ViewDescript
 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";
@@ -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";