@f-inverse/jammi-client 0.25.0 → 0.26.1

package/dist/gen/jammi/v1/pipeline_pb.d.ts

@@ -0,0 +1,491 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { ResultTableSchema } from "./embedding_pb";
+import type { EdgeDirection, EdgeGather } from "./inference_pb";
+import type { ArrowBatch } from "./trigger_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file jammi/v1/pipeline.proto.
+ */
+export declare const file_jammi_v1_pipeline: GenFile;
+/**
+ * Materialise a source's k-NN similarity graph. Mirrors the engine's
+ * `build_neighbor_graph` binding: the count `k` is required; `min_similarity`,
+ * `mutual`, `exact`, and `table` are optional with explicit presence so an unset
+ * field resolves to the engine default rather than a literal `0`/`false`/`""`.
+ * The engine-side build knobs `self_exclude` / `exact_max_rows` / `resolve_keys`
+ * are not on the wire — the server applies the engine defaults, the single
+ * source of those values.
+ *
+ * @generated from message jammi.v1.pipeline.BuildNeighborGraphRequest
+ */
+export type BuildNeighborGraphRequest = Message<"jammi.v1.pipeline.BuildNeighborGraphRequest"> & {
+    /**
+     * Source whose embedding table the graph is built over.
+     *
+     * @generated from field: string source_id = 1;
+     */
+    sourceId: string;
+    /**
+     * Neighbourhood size `k` (required).
+     *
+     * @generated from field: uint32 k = 2;
+     */
+    k: number;
+    /**
+     * Optional minimum cosine similarity floor for an edge.
+     *
+     * @generated from field: optional float min_similarity = 3;
+     */
+    minSimilarity?: number | undefined;
+    /**
+     * Keep only reciprocal edges.
+     *
+     * @generated from field: bool mutual = 4;
+     */
+    mutual: boolean;
+    /**
+     * Use the exact (deterministic, complete) driver, gated by a row-count
+     * ceiling; default false runs the approximate index-assisted driver.
+     *
+     * @generated from field: bool exact = 5;
+     */
+    exact: boolean;
+    /**
+     * Optional specific embedding table to build the graph over; unset resolves
+     * the source's default embedding table.
+     *
+     * @generated from field: optional string table = 6;
+     */
+    table?: string | undefined;
+};
+/**
+ * Describes the message jammi.v1.pipeline.BuildNeighborGraphRequest.
+ * Use `create(BuildNeighborGraphRequestSchema)` to create a new message.
+ */
+export declare const BuildNeighborGraphRequestSchema: GenMessage<BuildNeighborGraphRequest>;
+/**
+ * A registered external edge source and its column bindings, for the
+ * `edge_source` arm of a propagation. The endpoints join to the source on the
+ * key; `weight_column` feeds the `edge_similarity` weighting.
+ *
+ * @generated from message jammi.v1.pipeline.PropagateEdgeSource
+ */
+export type PropagateEdgeSource = Message<"jammi.v1.pipeline.PropagateEdgeSource"> & {
+    /**
+     * Registered source id holding the edge rows.
+     *
+     * @generated from field: string edge_source = 1;
+     */
+    edgeSource: string;
+    /**
+     * Column holding the edge's source endpoint (default "src" when empty).
+     *
+     * @generated from field: string src_column = 2;
+     */
+    srcColumn: string;
+    /**
+     * Column holding the edge's destination endpoint (default "dst" when empty).
+     *
+     * @generated from field: string dst_column = 3;
+     */
+    dstColumn: string;
+    /**
+     * Optional column holding the edge weight.
+     *
+     * @generated from field: optional string weight_column = 4;
+     */
+    weightColumn?: string | undefined;
+};
+/**
+ * Describes the message jammi.v1.pipeline.PropagateEdgeSource.
+ * Use `create(PropagateEdgeSourceSchema)` to create a new message.
+ */
+export declare const PropagateEdgeSourceSchema: GenMessage<PropagateEdgeSource>;
+/**
+ * Propagate an embedding table's features over a declared graph. Mirrors the
+ * engine's `propagate_embeddings` binding. The graph is either an S9 similarity
+ * graph (`edge_graph_table`, a `build_neighbor_graph` output) or a registered
+ * external edge source (`edge_source`) — exactly one, modelled as a `oneof` so
+ * both/neither is a decode error. The optional scalars carry explicit presence
+ * so an unset field resolves to the engine default.
+ *
+ * @generated from message jammi.v1.pipeline.PropagateEmbeddingsRequest
+ */
+export type PropagateEmbeddingsRequest = Message<"jammi.v1.pipeline.PropagateEmbeddingsRequest"> & {
+    /**
+     * Source whose embedding table holds the input features `X⁽⁰⁾`.
+     *
+     * @generated from field: string source_id = 1;
+     */
+    sourceId: string;
+    /**
+     * Optional specific embedding table; unset resolves the source's default.
+     *
+     * @generated from field: optional string embedding_table = 2;
+     */
+    embeddingTable?: string | undefined;
+    /**
+     * The graph to propagate over — exactly one arm.
+     *
+     * @generated from oneof jammi.v1.pipeline.PropagateEmbeddingsRequest.graph
+     */
+    graph: {
+        /**
+         * An S9 similarity graph (a `build_neighbor_graph` output table name).
+         *
+         * @generated from field: string edge_graph_table = 3;
+         */
+        value: string;
+        case: "edgeGraphTable";
+    } | {
+        /**
+         * A registered external edge source + its column bindings.
+         *
+         * @generated from field: jammi.v1.pipeline.PropagateEdgeSource edge_source = 4;
+         */
+        value: PropagateEdgeSource;
+        case: "edgeSource";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * Edge direction read when building the neighbourhood. UNSPECIFIED maps to the
+     * engine default (`Out`).
+     *
+     * @generated from field: jammi.v1.inference.EdgeDirection direction = 5;
+     */
+    direction: EdgeDirection;
+    /**
+     * Optional hop count (clamped to the engine hop cap).
+     *
+     * @generated from field: optional uint32 hops = 6;
+     */
+    hops?: number | undefined;
+    /**
+     * Neighbour-contribution weighting.
+     *
+     * @generated from field: jammi.v1.pipeline.PropagationWeighting weighting = 7;
+     */
+    weighting: PropagationWeighting;
+    /**
+     * Optional APPNP teleport probability.
+     *
+     * @generated from field: optional double alpha = 8;
+     */
+    alpha?: number | undefined;
+    /**
+     * What the propagation emits.
+     *
+     * @generated from field: jammi.v1.pipeline.PropagationOutput output = 9;
+     */
+    output: PropagationOutput;
+};
+/**
+ * Describes the message jammi.v1.pipeline.PropagateEmbeddingsRequest.
+ * Use `create(PropagateEmbeddingsRequestSchema)` to create a new message.
+ */
+export declare const PropagateEmbeddingsRequestSchema: GenMessage<PropagateEmbeddingsRequest>;
+/**
+ * Assemble and encode a target's context set. Mirrors the engine's
+ * `assemble_context` binding. `query` is the target's vector; an absent
+ * `edges` block is the ANN-only default, a present block (without `hybrid`) is a
+ * declared-edge walk, and a present block with `hybrid` is the union of both.
+ *
+ * @generated from message jammi.v1.pipeline.AssembleContextRequest
+ */
+export type AssembleContextRequest = Message<"jammi.v1.pipeline.AssembleContextRequest"> & {
+    /**
+     * Source whose embedding table the context is retrieved against and whose rows
+     * the members are pooled and hydrated from.
+     *
+     * @generated from field: string source_id = 1;
+     */
+    sourceId: string;
+    /**
+     * The target's query vector — the point whose neighbourhood is the context.
+     * IEEE-754 `float` (bit-exact for the engine's `Vec<f32>`).
+     *
+     * @generated from field: repeated float query = 2;
+     */
+    query: number[];
+    /**
+     * Neighbourhood size `k`.
+     *
+     * @generated from field: uint32 k = 3;
+     */
+    k: number;
+    /**
+     * Optional label/outcome columns hydrated for each context member.
+     *
+     * @generated from field: repeated string value_columns = 4;
+     */
+    valueColumns: string[];
+    /**
+     * The pooling reduction.
+     *
+     * @generated from field: jammi.v1.pipeline.SetAggregator aggregator = 5;
+     */
+    aggregator: SetAggregator;
+    /**
+     * Drop the target's own row (`exclude_key`) before pooling — the leakage
+     * guard. Explicit presence: an unset field resolves to the engine default
+     * (`true`), the single source of that value, so a client that omits it keeps
+     * the leakage guard on rather than silently disabling it via the proto3 bare-
+     * bool wire default (`false`).
+     *
+     * @generated from field: optional bool exclude_self = 6;
+     */
+    excludeSelf?: boolean | undefined;
+    /**
+     * Optional target row key dropped from the context when `exclude_self`.
+     *
+     * @generated from field: optional string exclude_key = 7;
+     */
+    excludeKey?: string | undefined;
+    /**
+     * Optional SQL predicate scoping the context to a split.
+     *
+     * @generated from field: optional string split = 8;
+     */
+    split?: string | undefined;
+    /**
+     * Optional declared-edge gather. Absent = ANN-only; present = declared-edge
+     * walk, or (with `hybrid`) the union with the ANN context.
+     *
+     * @generated from field: optional jammi.v1.inference.EdgeGather edges = 9;
+     */
+    edges?: EdgeGather | undefined;
+    /**
+     * Union the declared-edge and ANN candidate sets (only meaningful with
+     * `edges`).
+     *
+     * @generated from field: bool hybrid = 10;
+     */
+    hybrid: boolean;
+};
+/**
+ * Describes the message jammi.v1.pipeline.AssembleContextRequest.
+ * Use `create(AssembleContextRequestSchema)` to create a new message.
+ */
+export declare const AssembleContextRequestSchema: GenMessage<AssembleContextRequest>;
+/**
+ * The pooled fixed-width context vector. A wrapper message (carried as an
+ * `optional` field) so a degenerate empty context (`None` — no neighbour
+ * survived exclusion/split) is distinguishable from a present-but-empty vector:
+ * the absence is a correctness signal a decoder reads as low-confidence, never
+ * silently averaged into a representation.
+ *
+ * @generated from message jammi.v1.pipeline.ContextVector
+ */
+export type ContextVector = Message<"jammi.v1.pipeline.ContextVector"> & {
+    /**
+     * The pooled vector `ρ(Σ φ(xᵢ))`, in IEEE-754 `float`.
+     *
+     * @generated from field: repeated float values = 1;
+     */
+    values: number[];
+};
+/**
+ * Describes the message jammi.v1.pipeline.ContextVector.
+ * Use `create(ContextVectorSchema)` to create a new message.
+ */
+export declare const ContextVectorSchema: GenMessage<ContextVector>;
+/**
+ * Result of one AssembleContext invocation. Mirrors the dict the engine binding
+ * returns: the pooled vector (presence-wrapped), the carried set size + member
+ * keys, the hydrated value rows, and the assembly-source fact.
+ *
+ * @generated from message jammi.v1.pipeline.AssembleContextResponse
+ */
+export type AssembleContextResponse = Message<"jammi.v1.pipeline.AssembleContextResponse"> & {
+    /**
+     * The pooled context vector, or unset for a degenerate empty context.
+     *
+     * @generated from field: optional jammi.v1.pipeline.ContextVector context_vector = 1;
+     */
+    contextVector?: ContextVector | undefined;
+    /**
+     * Number of neighbours that survived exclusion and entered the pool — carried
+     * separately from the vector so a decoder uses the count without it corrupting
+     * the pooled representation.
+     *
+     * @generated from field: uint64 context_size = 2;
+     */
+    contextSize: bigint;
+    /**
+     * Keys of the context members, in retrieval (descending-similarity) order.
+     *
+     * @generated from field: repeated string context_keys = 3;
+     */
+    contextKeys: string[];
+    /**
+     * The hydrated `value_columns` of the context members, as one Arrow IPC stream
+     * (schema + batches) in `data_body`. Empty when no value columns were
+     * requested. Reuses TriggerService's `ArrowBatch` shape.
+     *
+     * @generated from field: jammi.v1.trigger.ArrowBatch value_rows = 4;
+     */
+    valueRows?: ArrowBatch | undefined;
+    /**
+     * How the context was assembled ("ann" / "edges" / "hybrid").
+     *
+     * @generated from field: string source = 5;
+     */
+    source: string;
+};
+/**
+ * Describes the message jammi.v1.pipeline.AssembleContextResponse.
+ * Use `create(AssembleContextResponseSchema)` to create a new message.
+ */
+export declare const AssembleContextResponseSchema: GenMessage<AssembleContextResponse>;
+/**
+ * Which neighbour-contribution normalisation a propagation hop uses. Mirrors the
+ * engine's `PropagationWeighting`; UNSPECIFIED maps to the engine default
+ * (`DegreeNormalized`).
+ *
+ * @generated from enum jammi.v1.pipeline.PropagationWeighting
+ */
+export declare enum PropagationWeighting {
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_DEGREE_NORMALIZED = 1;
+     */
+    DEGREE_NORMALIZED = 1,
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_UNIFORM = 2;
+     */
+    UNIFORM = 2,
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_EDGE_SIMILARITY = 3;
+     */
+    EDGE_SIMILARITY = 3
+}
+/**
+ * Describes the enum jammi.v1.pipeline.PropagationWeighting.
+ */
+export declare const PropagationWeightingSchema: GenEnum<PropagationWeighting>;
+/**
+ * What a propagation emits. Mirrors the engine's `PropagationOutput`;
+ * UNSPECIFIED maps to the engine default (`Final`).
+ *
+ * @generated from enum jammi.v1.pipeline.PropagationOutput
+ */
+export declare enum PropagationOutput {
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_FINAL = 1;
+     */
+    FINAL = 1,
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_JUMPING_KNOWLEDGE = 2;
+     */
+    JUMPING_KNOWLEDGE = 2
+}
+/**
+ * Describes the enum jammi.v1.pipeline.PropagationOutput.
+ */
+export declare const PropagationOutputSchema: GenEnum<PropagationOutput>;
+/**
+ * Which permutation-invariant reduction the context-set encoder pools with.
+ * Mirrors the engine's `SetAggregator`; UNSPECIFIED maps to the engine default
+ * (`Mean`).
+ *
+ * @generated from enum jammi.v1.pipeline.SetAggregator
+ */
+export declare enum SetAggregator {
+    /**
+     * @generated from enum value: SET_AGGREGATOR_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: SET_AGGREGATOR_MEAN = 1;
+     */
+    MEAN = 1,
+    /**
+     * @generated from enum value: SET_AGGREGATOR_SUM = 2;
+     */
+    SUM = 2,
+    /**
+     * @generated from enum value: SET_AGGREGATOR_MAX = 3;
+     */
+    MAX = 3
+}
+/**
+ * Describes the enum jammi.v1.pipeline.SetAggregator.
+ */
+export declare const SetAggregatorSchema: GenEnum<SetAggregator>;
+/**
+ * PipelineService — the wire surface for the engine's compute-to-data engine-
+ * state verbs that build durable graph/embedding artifacts or assemble a
+ * target's conditioning context.
+ *
+ * `BuildNeighborGraph`, `PropagateEmbeddings`, and `AssembleContext` are
+ * imperative session methods, not SQL queries, so they live as typed gRPC RPCs
+ * alongside SessionService / EmbeddingService / InferenceService / EvalService
+ * rather than on the Flight SQL surface (which carries query/result only, per
+ * ADR-01 §3.2). They are substrate primitives — materialising a k-NN graph,
+ * propagating features over a declared graph, or pooling a retrieval into a
+ * fixed-width context vector — and name no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the engine session; the service reimplements no
+ * retrieval, graph, or aggregation logic — it is purely a wire adapter over the
+ * in-process engine. The two graph-build verbs transport only a result-table
+ * name (the compute stays server-side, so the materialised table is
+ * byte-identical to one built in-process); `AssembleContext` carries its pooled
+ * vector inline as IEEE-754 `float` (bit-exact for the engine's `Vec<f32>`).
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor from the `jammi-session-id` header — the same
+ * mechanism every other gRPC service and Flight SQL already use.
+ *
+ * @generated from service jammi.v1.pipeline.PipelineService
+ */
+export declare const PipelineService: GenService<{
+    /**
+     * Materialise the k-nearest-neighbour graph of a source's embedding table and
+     * return the new edge table. Peer of the engine's `build_neighbor_graph`; the
+     * client reads the table via `sql(...)`.
+     *
+     * @generated from rpc jammi.v1.pipeline.PipelineService.BuildNeighborGraph
+     */
+    buildNeighborGraph: {
+        methodKind: "unary";
+        input: typeof BuildNeighborGraphRequestSchema;
+        output: typeof ResultTableSchema;
+    };
+    /**
+     * Propagate an embedding table's features over a declared graph (the
+     * decoupled-GNN forward pass) into a new, searchable embedding table. Peer of
+     * the engine's `propagate_embeddings`; the client reads the table via
+     * `sql(...)`.
+     *
+     * @generated from rpc jammi.v1.pipeline.PipelineService.PropagateEmbeddings
+     */
+    propagateEmbeddings: {
+        methodKind: "unary";
+        input: typeof PropagateEmbeddingsRequestSchema;
+        output: typeof ResultTableSchema;
+    };
+    /**
+     * Assemble and encode a target's context set: retrieve `k` nearest neighbours
+     * (or a declared-edge walk / their union), pair them with `value_columns`, and
+     * pool the neighbour vectors permutation-invariantly into one fixed-width
+     * context vector. Peer of the engine's `assemble_context`; returns the pooled
+     * vector and the carried metadata inline (no durable handle).
+     *
+     * @generated from rpc jammi.v1.pipeline.PipelineService.AssembleContext
+     */
+    assembleContext: {
+        methodKind: "unary";
+        input: typeof AssembleContextRequestSchema;
+        output: typeof AssembleContextResponseSchema;
+    };
+}>;
+//# sourceMappingURL=pipeline_pb.d.ts.map

package/dist/gen/jammi/v1/pipeline_pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline_pb.d.ts","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/pipeline_pb.ts"],"names":[],"mappings":"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"}

package/dist/gen/jammi/v1/pipeline_pb.js

@@ -0,0 +1,154 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=ts"
+// @generated from file jammi/v1/pipeline.proto (package jammi.v1.pipeline, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_jammi_v1_embedding } from "./embedding_pb";
+import { file_jammi_v1_inference } from "./inference_pb";
+import { file_jammi_v1_trigger } from "./trigger_pb";
+/**
+ * Describes the file jammi/v1/pipeline.proto.
+ */
+export const file_jammi_v1_pipeline = /*@__PURE__*/ fileDesc("ChdqYW1taS92MS9waXBlbGluZS5wcm90bxIRamFtbWkudjEucGlwZWxpbmUipgEKGUJ1aWxkTmVpZ2hib3JHcmFwaFJlcXVlc3QSEQoJc291cmNlX2lkGAEgASgJEgkKAWsYAiABKA0SGwoObWluX3NpbWlsYXJpdHkYAyABKAJIAIgBARIOCgZtdXR1YWwYBCABKAgSDQoFZXhhY3QYBSABKAgSEgoFdGFibGUYBiABKAlIAYgBAUIRCg9fbWluX3NpbWlsYXJpdHlCCAoGX3RhYmxlIoABChNQcm9wYWdhdGVFZGdlU291cmNlEhMKC2VkZ2Vfc291cmNlGAEgASgJEhIKCnNyY19jb2x1bW4YAiABKAkSEgoKZHN0X2NvbHVtbhgDIAEoCRIaCg13ZWlnaHRfY29sdW1uGAQgASgJSACIAQFCEAoOX3dlaWdodF9jb2x1bW4ipwMKGlByb3BhZ2F0ZUVtYmVkZGluZ3NSZXF1ZXN0EhEKCXNvdXJjZV9pZBgBIAEoCRIcCg9lbWJlZGRpbmdfdGFibGUYAiABKAlIAYgBARIaChBlZGdlX2dyYXBoX3RhYmxlGAMgASgJSAASPQoLZWRnZV9zb3VyY2UYBCABKAsyJi5qYW1taS52MS5waXBlbGluZS5Qcm9wYWdhdGVFZGdlU291cmNlSAASNAoJZGlyZWN0aW9uGAUgASgOMiEuamFtbWkudjEuaW5mZXJlbmNlLkVkZ2VEaXJlY3Rpb24SEQoEaG9wcxgGIAEoDUgCiAEBEjoKCXdlaWdodGluZxgHIAEoDjInLmphbW1pLnYxLnBpcGVsaW5lLlByb3BhZ2F0aW9uV2VpZ2h0aW5nEhIKBWFscGhhGAggASgBSAOIAQESNAoGb3V0cHV0GAkgASgOMiQuamFtbWkudjEucGlwZWxpbmUuUHJvcGFnYXRpb25PdXRwdXRCBwoFZ3JhcGhCEgoQX2VtYmVkZGluZ190YWJsZUIHCgVfaG9wc0IICgZfYWxwaGEi1AIKFkFzc2VtYmxlQ29udGV4dFJlcXVlc3QSEQoJc291cmNlX2lkGAEgASgJEg0KBXF1ZXJ5GAIgAygCEgkKAWsYAyABKA0SFQoNdmFsdWVfY29sdW1ucxgEIAMoCRI0CgphZ2dyZWdhdG9yGAUgASgOMiAuamFtbWkudjEucGlwZWxpbmUuU2V0QWdncmVnYXRvchIZCgxleGNsdWRlX3NlbGYYBiABKAhIAIgBARIYCgtleGNsdWRlX2tleRgHIAEoCUgBiAEBEhIKBXNwbGl0GAggASgJSAKIAQESMgoFZWRnZXMYCSABKAsyHi5qYW1taS52MS5pbmZlcmVuY2UuRWRnZUdhdGhlckgDiAEBEg4KBmh5YnJpZBgKIAEoCEIPCg1fZXhjbHVkZV9zZWxmQg4KDF9leGNsdWRlX2tleUIICgZfc3BsaXRCCAoGX2VkZ2VzIh8KDUNvbnRleHRWZWN0b3ISDgoGdmFsdWVzGAEgAygCItkBChdBc3NlbWJsZUNvbnRleHRSZXNwb25zZRI9Cg5jb250ZXh0X3ZlY3RvchgBIAEoCzIgLmphbW1pLnYxLnBpcGVsaW5lLkNvbnRleHRWZWN0b3JIAIgBARIUCgxjb250ZXh0X3NpemUYAiABKAQSFAoMY29udGV4dF9rZXlzGAMgAygJEjAKCnZhbHVlX3Jvd3MYBCABKAsyHC5qYW1taS52MS50cmlnZ2VyLkFycm93QmF0Y2gSDgoGc291cmNlGAUgASgJQhEKD19jb250ZXh0X3ZlY3Rvciq4AQoUUHJvcGFnYXRpb25XZWlnaHRpbmcSJQohUFJPUEFHQVRJT05fV0VJR0hUSU5HX1VOU1BFQ0lGSUVEEAASKwonUFJPUEFHQVRJT05fV0VJR0hUSU5HX0RFR1JFRV9OT1JNQUxJWkVEEAESIQodUFJPUEFHQVRJT05fV0VJR0hUSU5HX1VOSUZPUk0QAhIpCiVQUk9QQUdBVElPTl9XRUlHSFRJTkdfRURHRV9TSU1JTEFSSVRZEAMqfwoRUHJvcGFnYXRpb25PdXRwdXQSIgoeUFJPUEFHQVRJT05fT1VUUFVUX1VOU1BFQ0lGSUVEEAASHAoYUFJPUEFHQVRJT05fT1VUUFVUX0ZJTkFMEAESKAokUFJPUEFHQVRJT05fT1VUUFVUX0pVTVBJTkdfS05PV0xFREdFEAIqeAoNU2V0QWdncmVnYXRvchIeChpTRVRfQUdHUkVHQVRPUl9VTlNQRUNJRklFRBAAEhcKE1NFVF9BR0dSRUdBVE9SX01FQU4QARIWChJTRVRfQUdHUkVHQVRPUl9TVU0QAhIWChJTRVRfQUdHUkVHQVRPUl9NQVgQAzLHAgoPUGlwZWxpbmVTZXJ2aWNlEmMKEkJ1aWxkTmVpZ2hib3JHcmFwaBIsLmphbW1pLnYxLnBpcGVsaW5lLkJ1aWxkTmVpZ2hib3JHcmFwaFJlcXVlc3QaHy5qYW1taS52MS5lbWJlZGRpbmcuUmVzdWx0VGFibGUSZQoTUHJvcGFnYXRlRW1iZWRkaW5ncxItLmphbW1pLnYxLnBpcGVsaW5lLlByb3BhZ2F0ZUVtYmVkZGluZ3NSZXF1ZXN0Gh8uamFtbWkudjEuZW1iZWRkaW5nLlJlc3VsdFRhYmxlEmgKD0Fzc2VtYmxlQ29udGV4dBIpLmphbW1pLnYxLnBpcGVsaW5lLkFzc2VtYmxlQ29udGV4dFJlcXVlc3QaKi5qYW1taS52MS5waXBlbGluZS5Bc3NlbWJsZUNvbnRleHRSZXNwb25zZWIGcHJvdG8z", [file_jammi_v1_embedding, file_jammi_v1_inference, file_jammi_v1_trigger]);
+/**
+ * Describes the message jammi.v1.pipeline.BuildNeighborGraphRequest.
+ * Use `create(BuildNeighborGraphRequestSchema)` to create a new message.
+ */
+export const BuildNeighborGraphRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 0);
+/**
+ * Describes the message jammi.v1.pipeline.PropagateEdgeSource.
+ * Use `create(PropagateEdgeSourceSchema)` to create a new message.
+ */
+export const PropagateEdgeSourceSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 1);
+/**
+ * Describes the message jammi.v1.pipeline.PropagateEmbeddingsRequest.
+ * Use `create(PropagateEmbeddingsRequestSchema)` to create a new message.
+ */
+export const PropagateEmbeddingsRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 2);
+/**
+ * Describes the message jammi.v1.pipeline.AssembleContextRequest.
+ * Use `create(AssembleContextRequestSchema)` to create a new message.
+ */
+export const AssembleContextRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 3);
+/**
+ * Describes the message jammi.v1.pipeline.ContextVector.
+ * Use `create(ContextVectorSchema)` to create a new message.
+ */
+export const ContextVectorSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 4);
+/**
+ * Describes the message jammi.v1.pipeline.AssembleContextResponse.
+ * Use `create(AssembleContextResponseSchema)` to create a new message.
+ */
+export const AssembleContextResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_pipeline, 5);
+/**
+ * Which neighbour-contribution normalisation a propagation hop uses. Mirrors the
+ * engine's `PropagationWeighting`; UNSPECIFIED maps to the engine default
+ * (`DegreeNormalized`).
+ *
+ * @generated from enum jammi.v1.pipeline.PropagationWeighting
+ */
+export var PropagationWeighting;
+(function (PropagationWeighting) {
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_UNSPECIFIED = 0;
+     */
+    PropagationWeighting[PropagationWeighting["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_DEGREE_NORMALIZED = 1;
+     */
+    PropagationWeighting[PropagationWeighting["DEGREE_NORMALIZED"] = 1] = "DEGREE_NORMALIZED";
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_UNIFORM = 2;
+     */
+    PropagationWeighting[PropagationWeighting["UNIFORM"] = 2] = "UNIFORM";
+    /**
+     * @generated from enum value: PROPAGATION_WEIGHTING_EDGE_SIMILARITY = 3;
+     */
+    PropagationWeighting[PropagationWeighting["EDGE_SIMILARITY"] = 3] = "EDGE_SIMILARITY";
+})(PropagationWeighting || (PropagationWeighting = {}));
+/**
+ * Describes the enum jammi.v1.pipeline.PropagationWeighting.
+ */
+export const PropagationWeightingSchema = /*@__PURE__*/ enumDesc(file_jammi_v1_pipeline, 0);
+/**
+ * What a propagation emits. Mirrors the engine's `PropagationOutput`;
+ * UNSPECIFIED maps to the engine default (`Final`).
+ *
+ * @generated from enum jammi.v1.pipeline.PropagationOutput
+ */
+export var PropagationOutput;
+(function (PropagationOutput) {
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_UNSPECIFIED = 0;
+     */
+    PropagationOutput[PropagationOutput["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_FINAL = 1;
+     */
+    PropagationOutput[PropagationOutput["FINAL"] = 1] = "FINAL";
+    /**
+     * @generated from enum value: PROPAGATION_OUTPUT_JUMPING_KNOWLEDGE = 2;
+     */
+    PropagationOutput[PropagationOutput["JUMPING_KNOWLEDGE"] = 2] = "JUMPING_KNOWLEDGE";
+})(PropagationOutput || (PropagationOutput = {}));
+/**
+ * Describes the enum jammi.v1.pipeline.PropagationOutput.
+ */
+export const PropagationOutputSchema = /*@__PURE__*/ enumDesc(file_jammi_v1_pipeline, 1);
+/**
+ * Which permutation-invariant reduction the context-set encoder pools with.
+ * Mirrors the engine's `SetAggregator`; UNSPECIFIED maps to the engine default
+ * (`Mean`).
+ *
+ * @generated from enum jammi.v1.pipeline.SetAggregator
+ */
+export var SetAggregator;
+(function (SetAggregator) {
+    /**
+     * @generated from enum value: SET_AGGREGATOR_UNSPECIFIED = 0;
+     */
+    SetAggregator[SetAggregator["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: SET_AGGREGATOR_MEAN = 1;
+     */
+    SetAggregator[SetAggregator["MEAN"] = 1] = "MEAN";
+    /**
+     * @generated from enum value: SET_AGGREGATOR_SUM = 2;
+     */
+    SetAggregator[SetAggregator["SUM"] = 2] = "SUM";
+    /**
+     * @generated from enum value: SET_AGGREGATOR_MAX = 3;
+     */
+    SetAggregator[SetAggregator["MAX"] = 3] = "MAX";
+})(SetAggregator || (SetAggregator = {}));
+/**
+ * Describes the enum jammi.v1.pipeline.SetAggregator.
+ */
+export const SetAggregatorSchema = /*@__PURE__*/ enumDesc(file_jammi_v1_pipeline, 2);
+/**
+ * PipelineService — the wire surface for the engine's compute-to-data engine-
+ * state verbs that build durable graph/embedding artifacts or assemble a
+ * target's conditioning context.
+ *
+ * `BuildNeighborGraph`, `PropagateEmbeddings`, and `AssembleContext` are
+ * imperative session methods, not SQL queries, so they live as typed gRPC RPCs
+ * alongside SessionService / EmbeddingService / InferenceService / EvalService
+ * rather than on the Flight SQL surface (which carries query/result only, per
+ * ADR-01 §3.2). They are substrate primitives — materialising a k-NN graph,
+ * propagating features over a declared graph, or pooling a retrieval into a
+ * fixed-width context vector — and name no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the engine session; the service reimplements no
+ * retrieval, graph, or aggregation logic — it is purely a wire adapter over the
+ * in-process engine. The two graph-build verbs transport only a result-table
+ * name (the compute stays server-side, so the materialised table is
+ * byte-identical to one built in-process); `AssembleContext` carries its pooled
+ * vector inline as IEEE-754 `float` (bit-exact for the engine's `Vec<f32>`).
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor from the `jammi-session-id` header — the same
+ * mechanism every other gRPC service and Flight SQL already use.
+ *
+ * @generated from service jammi.v1.pipeline.PipelineService
+ */
+export const PipelineService = /*@__PURE__*/ serviceDesc(file_jammi_v1_pipeline, 0);
+//# sourceMappingURL=pipeline_pb.js.map

package/dist/gen/jammi/v1/pipeline_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline_pb.js","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/pipeline_pb.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,0FAA0F;AAC1F,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAY,aAAa,CAC1D,QAAQ,CAAC,0yFAA0yF,EAAE,CAAC,uBAAuB,EAAE,uBAAuB,EAAE,qBAAqB,CAAC,CAAC,CAAC;AA2Dl4F;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA0C,aAAa,CACjG,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAuCzC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC,aAAa,CACrF,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAuFzC;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2C,aAAa,CACnG,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AA0FzC;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuC,aAAa,CAC3F,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAoBzC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAkDzC;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,oBAoBX;AApBD,WAAY,oBAAoB;IAC9B;;OAEG;IACH,6EAAe,CAAA;IAEf;;OAEG;IACH,yFAAqB,CAAA;IAErB;;OAEG;IACH,qEAAW,CAAA;IAEX;;OAEG;IACH,qFAAmB,CAAA;AACrB,CAAC,EApBW,oBAAoB,KAApB,oBAAoB,QAoB/B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkC,aAAa,CACpF,QAAQ,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBAeX;AAfD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,uEAAe,CAAA;IAEf;;OAEG;IACH,2DAAS,CAAA;IAET;;OAEG;IACH,mFAAqB,CAAA;AACvB,CAAC,EAfW,iBAAiB,KAAjB,iBAAiB,QAe5B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA+B,aAAa,CAC9E,QAAQ,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,aAoBX;AApBD,WAAY,aAAa;IACvB;;OAEG;IACH,+DAAe,CAAA;IAEf;;OAEG;IACH,iDAAQ,CAAA;IAER;;OAEG;IACH,+CAAO,CAAA;IAEP;;OAEG;IACH,+CAAO,CAAA;AACT,CAAC,EApBW,aAAa,KAAb,aAAa,QAoBxB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA2B,aAAa,CACtE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,eAAe,GAwCvB,aAAa,CAChB,WAAW,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC"}