@query-farm/vgi 0.40.0 → 0.42.0

package/dist/protocol/dispatch.d.ts

@@ -39,4 +39,17 @@ export interface ProtocolConfig {
  * protocol is registered under rather than a second copy of the literal.
  */
 export declare const VGI_PROTOCOL_NAME = "vgi.v2";
+/**
+ * The `vgi.v2` protocol hash `vgi_rpc.Reflection.v1` must report for this
+ * worker: the reference's (vgi-python 0.43.0, 72 methods). Every SDK hosts
+ * every `vgi.v2` method with the reference's schemas, so the hash is one value
+ * across the ports; a method this SDK does not implement is still registered
+ * (handlers/unimplemented.ts). The hash covers method names, types and the
+ * params/result/header schemas only (WIRE_PROTOCOL.md §14).
+ *
+ * It changes only with vgi.v2's protocol version (currently 2.1.0). Asserted
+ * by src/protocol/__tests__/vgi-v2-hash.test.ts; if that test fails, the
+ * surface drifted from the reference -- fix the schemas, do not bump this.
+ */
+export declare const VGI_V2_PROTOCOL_HASH = "774cb80090d71ea76d09aa311b9cda4ca4c33c3bf72c43242eb6dc87b6f79ce5";
 export declare function buildVgiProtocol(config: ProtocolConfig): Protocol;

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

@@ -0,0 +1,17 @@
+import { type Protocol } from "@query-farm/vgi-rpc";
+import type { VgiSchema } from "../../arrow/index.js";
+/** One unimplemented method: its wire name and the reference's schemas. */
+interface UnimplementedMethod {
+    readonly name: string;
+    readonly params: VgiSchema;
+    readonly result: VgiSchema;
+}
+/**
+ * The vgi.v2 methods (of the reference's 72) this SDK does not implement.
+ * Exported so a test can assert each one refuses with UNIMPLEMENTED.
+ */
+export declare const UNIMPLEMENTED_METHODS: readonly UnimplementedMethod[];
+/** The message every unimplemented method answers with. */
+export declare function unimplementedMessage(method: string): string;
+export declare function registerUnimplementedMethods(protocol: Protocol): void;
+export {};

package/dist/rpc-server.d.ts

@@ -1,4 +1,5 @@
 import { GrantKeys, type GrantMinter, type Protocol, type TokenResolver, VgiRpcServer } from "@query-farm/vgi-rpc";
+import type { CatalogInterface } from "./catalog/interface.js";
 /** The transport a server is being built for. Only `"http"` changes what is
  *  hosted (identity); the rest are recorded so the decision lives here rather
  *  than at each call site. `"iroh"` is the raw TCP upstream of a
@@ -94,6 +95,19 @@ export interface BuildRpcServerOptions {
     /** Environment to read `VGI_INTROSPECT_PRINCIPALS` from. Default
      *  `process.env` where it exists (not on Cloudflare Workers). */
     env?: Record<string, string | undefined>;
+    /**
+     * HTTP only: what `vgi.attach_tickets.v1` needs. Hosted when
+     * `signingKeyConfigured` is true -- the key came from explicit
+     * configuration, not generated for this process, which would make every
+     * ticket die on restart -- and the worker can issue grants (grant keys
+     * configured, or its own `mintGrant`). Otherwise the protocol is absent,
+     * not hosted-and-refusing.
+     */
+    attachTickets?: {
+        signingKey: Uint8Array | undefined;
+        signingKeyConfigured: boolean;
+        catalogInterface: CatalogInterface | undefined;
+    };
 }
 /**
  * Build the vgi-rpc server for a worker's `vgi.v2` protocol on `transport`.