@query-farm/vgi 0.29.0 → 0.30.0

package/dist/metadata/types.d.ts

@@ -1,4 +1,4 @@
-import { FunctionStability, NullHandling, OrderPreservation, OrderDependence, DistinctDependence } from "../types.js";
+import { FunctionStability, NullHandling, ArgumentMonotonicity, OrderPreservation, OrderDependence, DistinctDependence } from "../types.js";
 export declare enum CatalogFunctionType {
     SCALAR = "SCALAR",
     TABLE = "TABLE",
@@ -23,6 +23,15 @@ export interface FunctionExample {
     description: string;
     expectedOutput: string | null;
 }
+export interface FilterFunctionCapability {
+    namespace: string;
+    name: string;
+    version: number;
+}
+export interface EvaluationContextCapability {
+    profile: string;
+    providerFingerprint: string | null;
+}
 export interface ResolvedMetadata {
     name: string;
     className: string;
@@ -34,12 +43,16 @@ export interface ResolvedMetadata {
     parameters: ParameterInfo[];
     stability: FunctionStability;
     nullHandling: NullHandling;
+    argumentMonotonicity: ArgumentMonotonicity[] | null;
     requiredSettings: string[];
     requiredSecrets: string[];
     projectionPushdown: boolean;
     filterPushdown: boolean;
     samplingPushdown: boolean;
-    supportedExpressionFilters: string[];
+    filterSemanticProfiles: string[];
+    additionalFilterFunctions: FilterFunctionCapability[];
+    runtimeFilterAlgorithms: FilterFunctionCapability[];
+    filterEvaluationContexts: EvaluationContextCapability[];
     preservesOrder: OrderPreservation;
     maxWorkers: number | null;
     orderDependent: OrderDependence;

package/dist/protocol/handlers/shared.d.ts

@@ -9,6 +9,8 @@ export declare const RESULT_BINARY_NULLABLE_SCHEMA: VgiSchema;
  * and return flat columns as a dict (row 0).
  */
 export declare function unwrapRequest(requestBytes: any): Record<string, any>;
+/** Convert Arrow list scalars at RPC boundaries into ordinary string arrays. */
+export declare function normalizeRequestSchemaPaths(params: Record<string, any>): void;
 /**
  * Wrap a dict of values into a single "result" Binary column.
  * Builds a 1-row batch from the values using the given schema,
@@ -22,7 +24,7 @@ export declare function overloadContext(req: {
     arguments: any;
     input_schema: any;
     function_type: any;
-    schema_name?: string | null;
+    schema_path?: string[] | null;
     attach_opaque_data?: Uint8Array | null;
 }, catalogInterface?: {
     catalogNameForAttach(a: Uint8Array): string | null;

package/dist/protocol/serializers/splits.d.ts

@@ -115,7 +115,7 @@ export declare function deserializePlanRequest(params: Record<string, any>): Tab
  * bytes are.
  */
 export declare function fingerprintInputs(bindCallBytes: Uint8Array): {
-    schemaName: string;
+    schemaPath: string[];
     functionName: string;
     args: Uint8Array;
     settings: Uint8Array;

package/dist/protocol/types.d.ts

@@ -76,11 +76,17 @@ export interface BindRequest {
     /**
      * Catalog schema that declares the function being bound. A worker may
      * register the same name in more than one schema, so the bare name does not
-     * identify an implementation — resolution is by `(schema_name,
+     * identify an implementation — resolution is by `(schema_path,
      * function_name)`. Null for callers with no catalog context (COPY handler
-     * binds). Mirrors vgi-python's `BindRequest.schema_name`.
+     * binds). Mirrors vgi-python's `BindRequest.schema_path`.
      */
-    schema_name?: string | null;
+    schema_path?: string[] | null;
+    /**
+     * Resolved name for every logical argument, in complete call order. Fixed
+     * parameters carry their declared names, unnamed varargs carry `null`, and
+     * named varargs retain the caller-provided name. `null` means unavailable.
+     */
+    argument_names?: (string | null)[] | null;
 }
 export interface BindResponse {
     output_schema: VgiSchema;

package/dist/schema-path.d.ts

@@ -0,0 +1,7 @@
+/** Raw identifier components of a catalog schema, from root to leaf. */
+export type SchemaPath = string[];
+/** Case-insensitive key used for catalog lookup and function dispatch. */
+export declare function normalizeSchemaPath(path: Iterable<unknown> | string): string[];
+export declare function schemaPathKey(path: Iterable<unknown> | string): string;
+export declare function schemaPathsEqual(left: Iterable<unknown> | string, right: Iterable<unknown> | string): boolean;
+export declare function schemaPathDisplay(path: Iterable<unknown> | string): string;

package/dist/serve-entry.d.ts

@@ -1,6 +1,6 @@
 import type { CatalogInterface } from "./catalog/interface.js";
 import type { FunctionRegistry } from "./functions/registry.js";
-import type { AuthenticateFn } from "@query-farm/vgi-rpc";
+import { type AuthenticateFn, type PeerResolutionOptions } from "@query-farm/vgi-rpc";
 /** Environment variables `serveVgiWorker` reads. Injectable for testing. */
 export interface ServeEnv {
     PORT?: string;
@@ -12,6 +12,20 @@ export declare const DEFAULT_PORT = 8787;
 export declare const DEFAULT_TOKEN_TTL = 3600;
 /** Bytes of HMAC key `createHttpHandler` expects; 64 hex characters. */
 export declare const SIGNING_KEY_BYTES = 32;
+/** HTTP trust boundary for a colocated `vgi-iroh-bridge`. */
+export interface IrohHttpBridgeOptions {
+    /** Worker-local namespace for EndpointId principals. */
+    issuer: string;
+    /** Exact bridge IP addresses. No CIDRs or hostnames. */
+    trustedProxyAddresses?: readonly string[];
+    /** Authenticate the EndpointId (default) or expose evidence only. */
+    authenticate?: boolean;
+    /**
+     * Host-specific physical peer and raw-header adapter. Required because a
+     * Fetch Request alone does not preserve duplicate header fields.
+     */
+    peerResolutionContext?: (request: Request) => PeerResolutionOptions | Promise<PeerResolutionOptions>;
+}
 export interface ServeVgiWorkerOptions {
     /** Short worker name shown on the landing page, e.g. "ishares". */
     name: string;
@@ -27,6 +41,8 @@ export interface ServeVgiWorkerOptions {
     repositoryUrl?: string;
     /** Overrides `$PORT` (default 8787). Pass 0 to bind an ephemeral port. */
     port?: number;
+    /** Bind address. Iroh bridge mode defaults to loopback; otherwise Bun's default. */
+    hostname?: string;
     /** Overrides `$VGI_SIGNING_KEY`. 32 bytes. */
     signingKey?: Uint8Array;
     /** Overrides `$VGI_TOKEN_TTL` (default 3600 seconds). */
@@ -44,12 +60,17 @@ export interface ServeVgiWorkerOptions {
     /** Authenticates each request, returning the caller's `AuthContext`.
      *  Omit for an anonymous worker (the default). */
     authenticate?: AuthenticateFn;
+    /** Preserve authenticated Iroh identity forwarded by an adjacent HTTP bridge. */
+    irohBridge?: IrohHttpBridgeOptions;
 }
 /** The slice of `Bun.serve`'s return value this module uses. */
 export interface VgiHttpServer {
     readonly port: number;
     readonly url: URL;
     stop(closeActiveConnections?: boolean): void;
+    requestIP?(request: Request): {
+        address: string;
+    } | null;
 }
 /**
  * Decode a 32-byte signing key from its hex representation.