@f-inverse/jammi-client 0.14.0

package/README.md

@@ -0,0 +1,68 @@
+# @f-inverse/jammi-client
+
+The official TypeScript gRPC-web client for the Jammi engine.
+
+It is **generated from the canonical proto** at `crates/jammi-ai/proto/jammi/v1`
+(the single codegen source for every language binding — Rust, Python, and this
+one) using [buf] + [protobuf-es] (`protoc-gen-es`) + [Connect-ES]. The transport
+is gRPC-web over `fetch`, so the client runs unchanged in a browser, a
+**Cloudflare Worker / V8 isolate** (no native code), or Node — interoperating
+with the server's `tonic-web` surface.
+
+## Use
+
+```ts
+import { connect, Modality } from "@f-inverse/jammi-client";
+
+// One transport, one session-scoped tenant binding, a client per service.
+const jammi = connect("https://engine.example.com");
+
+await jammi.session.setTenant({ tenant: { id: tenantUuid } });
+
+const hits = await jammi.embedding.search({
+  sourceId: "corpus",
+  query: { case: "rowKey", value: "track-42" },
+  k: 10,
+});
+
+// Server-streaming subscribe is an async iterable.
+for await (const batch of jammi.trigger.subscribe({ topic: { name: "events" } })) {
+  // ...
+}
+```
+
+`connect(endpoint, opts?)` builds the gRPC-web transport and returns a
+`JammiClient` with one client per service (`session`, `embedding`, `inference`,
+`eval`, `fineTune`, `mutableTable`, `channel`, `trigger`, `audit`). Each
+connection mints an opaque session id (overridable via `opts.sessionId`) and
+injects it as the `jammi-session-id` header on every request — the key the
+server binds tenant state against. Pass extra interceptors via
+`opts.interceptors`.
+
+## Regenerate the client surface
+
+The generated code lives in `src/gen/` and is **never committed** — it is
+emitted at build time from the repo proto, so it cannot drift. One command:
+
+```sh
+npm run generate   # == buf generate ../../crates/jammi-ai/proto
+```
+
+`npm run build` (and `typecheck` / `test`) regenerate first, so you rarely call
+`generate` directly. After changing a `.proto`, just rebuild.
+
+## Develop
+
+```sh
+npm install
+npm run typecheck   # tsc --noEmit (strict), regenerates first
+npm run test        # vitest (hermetic — no network), regenerates first
+npm run build       # clean + generate + tsc → dist/
+```
+
+Versioned in lockstep with the engine (`workspace.package.version`); the npm
+publish runs only on the engine's release tag.
+
+[buf]: https://buf.build
+[protobuf-es]: https://github.com/bufbuild/protobuf-es
+[Connect-ES]: https://github.com/connectrpc/connect-es

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

@@ -0,0 +1,213 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { EmptySchema } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file jammi/v1/audit.proto.
+ */
+export declare const file_jammi_v1_audit: GenFile;
+/**
+ * One per-query audit record. Mirrors the Rust `jammi_db::PerQueryAudit`.
+ *
+ * On `AuditLog` the caller leaves `tenant_id` and `signature` empty — the
+ * engine stamps the session tenant and computes the HMAC signature on write.
+ * Both fields are populated on every record returned by a fetch verb.
+ *
+ * @generated from message jammi.v1.audit.PerQueryAudit
+ */
+export type PerQueryAudit = Message<"jammi.v1.audit.PerQueryAudit"> & {
+    /**
+     * Unique identifier for this query invocation (UUID string).
+     *
+     * @generated from field: string query_id = 1;
+     */
+    queryId: string;
+    /**
+     * Tenant scope, the tenant's canonical string form. Auto-injected on write;
+     * present on reads. Callers leave it empty when logging.
+     *
+     * @generated from field: string tenant_id = 2;
+     */
+    tenantId: string;
+    /**
+     * Model identifier (e.g. a HuggingFace repo id).
+     *
+     * @generated from field: string model_id = 3;
+     */
+    modelId: string;
+    /**
+     * Specific model version/revision (commit SHA, HF revision, etc.).
+     *
+     * @generated from field: string model_version = 4;
+     */
+    modelVersion: string;
+    /**
+     * Open-ended tenant-defined query metadata as a JSON value string. The engine
+     * stores it verbatim and never interprets it.
+     *
+     * @generated from field: string query_lineage = 5;
+     */
+    queryLineage: string;
+    /**
+     * Top-K result identifiers (whatever stable key the tenant uses).
+     *
+     * @generated from field: repeated string top_k_result_ids = 6;
+     */
+    topKResultIds: string[];
+    /**
+     * Distance/similarity scores, parallel to `top_k_result_ids`.
+     *
+     * @generated from field: repeated float retrieval_scores = 7;
+     */
+    retrievalScores: number[];
+    /**
+     * When the query executed, as epoch microseconds (the audit table's storage
+     * form). Server-side timestamp; ignored on write, present on reads.
+     *
+     * @generated from field: int64 executed_at_micros = 8;
+     */
+    executedAtMicros: bigint;
+    /**
+     * HMAC-SHA256 signature over the canonical serialization. Computed by the
+     * engine on write; never caller-supplied. Present on reads.
+     *
+     * @generated from field: string signature = 9;
+     */
+    signature: string;
+};
+/**
+ * Describes the message jammi.v1.audit.PerQueryAudit.
+ * Use `create(PerQueryAuditSchema)` to create a new message.
+ */
+export declare const PerQueryAuditSchema: GenMessage<PerQueryAudit>;
+/**
+ * @generated from message jammi.v1.audit.AuditLogRequest
+ */
+export type AuditLogRequest = Message<"jammi.v1.audit.AuditLogRequest"> & {
+    /**
+     * @generated from field: repeated jammi.v1.audit.PerQueryAudit records = 1;
+     */
+    records: PerQueryAudit[];
+};
+/**
+ * Describes the message jammi.v1.audit.AuditLogRequest.
+ * Use `create(AuditLogRequestSchema)` to create a new message.
+ */
+export declare const AuditLogRequestSchema: GenMessage<AuditLogRequest>;
+/**
+ * @generated from message jammi.v1.audit.AuditFetchByQueryIdRequest
+ */
+export type AuditFetchByQueryIdRequest = Message<"jammi.v1.audit.AuditFetchByQueryIdRequest"> & {
+    /**
+     * @generated from field: string query_id = 1;
+     */
+    queryId: string;
+};
+/**
+ * Describes the message jammi.v1.audit.AuditFetchByQueryIdRequest.
+ * Use `create(AuditFetchByQueryIdRequestSchema)` to create a new message.
+ */
+export declare const AuditFetchByQueryIdRequestSchema: GenMessage<AuditFetchByQueryIdRequest>;
+/**
+ * @generated from message jammi.v1.audit.AuditFetchByQueryIdResponse
+ */
+export type AuditFetchByQueryIdResponse = Message<"jammi.v1.audit.AuditFetchByQueryIdResponse"> & {
+    /**
+     * The record, or unset if no record with that id is visible to the tenant.
+     *
+     * @generated from field: optional jammi.v1.audit.PerQueryAudit record = 1;
+     */
+    record?: PerQueryAudit | undefined;
+};
+/**
+ * Describes the message jammi.v1.audit.AuditFetchByQueryIdResponse.
+ * Use `create(AuditFetchByQueryIdResponseSchema)` to create a new message.
+ */
+export declare const AuditFetchByQueryIdResponseSchema: GenMessage<AuditFetchByQueryIdResponse>;
+/**
+ * @generated from message jammi.v1.audit.AuditFetchRecentRequest
+ */
+export type AuditFetchRecentRequest = Message<"jammi.v1.audit.AuditFetchRecentRequest"> & {
+    /**
+     * Maximum number of records to return, newest first.
+     *
+     * @generated from field: uint32 limit = 1;
+     */
+    limit: number;
+};
+/**
+ * Describes the message jammi.v1.audit.AuditFetchRecentRequest.
+ * Use `create(AuditFetchRecentRequestSchema)` to create a new message.
+ */
+export declare const AuditFetchRecentRequestSchema: GenMessage<AuditFetchRecentRequest>;
+/**
+ * @generated from message jammi.v1.audit.AuditFetchRecentResponse
+ */
+export type AuditFetchRecentResponse = Message<"jammi.v1.audit.AuditFetchRecentResponse"> & {
+    /**
+     * @generated from field: repeated jammi.v1.audit.PerQueryAudit records = 1;
+     */
+    records: PerQueryAudit[];
+};
+/**
+ * Describes the message jammi.v1.audit.AuditFetchRecentResponse.
+ * Use `create(AuditFetchRecentResponseSchema)` to create a new message.
+ */
+export declare const AuditFetchRecentResponseSchema: GenMessage<AuditFetchRecentResponse>;
+/**
+ * AuditService — the wire surface for the engine's per-query audit verbs.
+ *
+ * `AuditLog`, `AuditFetchByQueryId`, and `AuditFetchRecent` are imperative
+ * session methods — signing, tenant-injection, and signature-verified decode
+ * are non-SQL logic — so they live as typed gRPC RPCs alongside the other
+ * engine-backed services rather than on the Flight SQL surface (query/result
+ * only, per ADR-01 §3.2). The verbs name a substrate primitive — a signed
+ * per-query audit log — and carry no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the consumer-facing `Session`/`LocalSession`
+ * abstraction (`audit_log` / `audit_fetch_by_query_id` / `audit_fetch_recent`);
+ * the service reimplements no signing, storage, or query logic. The
+ * `PerQueryAudit` message mirrors the Rust record field for field, including
+ * its server-computed `signature`.
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor. The audit primitive requires a bound tenant — an
+ * unscoped call is rejected by the engine.
+ *
+ * @generated from service jammi.v1.audit.AuditService
+ */
+export declare const AuditService: GenService<{
+    /**
+     * Sign and persist a batch of audit records under the session's tenant,
+     * publishing them to the audit topic. Peer of the abstraction's `audit_log`.
+     *
+     * @generated from rpc jammi.v1.audit.AuditService.AuditLog
+     */
+    auditLog: {
+        methodKind: "unary";
+        input: typeof AuditLogRequestSchema;
+        output: typeof EmptySchema;
+    };
+    /**
+     * Fetch one audit record by query id (tenant-scoped). Peer of the
+     * abstraction's `audit_fetch_by_query_id`.
+     *
+     * @generated from rpc jammi.v1.audit.AuditService.AuditFetchByQueryId
+     */
+    auditFetchByQueryId: {
+        methodKind: "unary";
+        input: typeof AuditFetchByQueryIdRequestSchema;
+        output: typeof AuditFetchByQueryIdResponseSchema;
+    };
+    /**
+     * Fetch the most recent audit records (tenant-scoped), newest first. Peer of
+     * the abstraction's `audit_fetch_recent`.
+     *
+     * @generated from rpc jammi.v1.audit.AuditService.AuditFetchRecent
+     */
+    auditFetchRecent: {
+        methodKind: "unary";
+        input: typeof AuditFetchRecentRequestSchema;
+        output: typeof AuditFetchRecentResponseSchema;
+    };
+}>;
+//# sourceMappingURL=audit_pb.d.ts.map

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

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

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

@@ -0,0 +1,63 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=ts"
+// @generated from file jammi/v1/audit.proto (package jammi.v1.audit, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file jammi/v1/audit.proto.
+ */
+export const file_jammi_v1_audit = /*@__PURE__*/ fileDesc("ChRqYW1taS92MS9hdWRpdC5wcm90bxIOamFtbWkudjEuYXVkaXQi1wEKDVBlclF1ZXJ5QXVkaXQSEAoIcXVlcnlfaWQYASABKAkSEQoJdGVuYW50X2lkGAIgASgJEhAKCG1vZGVsX2lkGAMgASgJEhUKDW1vZGVsX3ZlcnNpb24YBCABKAkSFQoNcXVlcnlfbGluZWFnZRgFIAEoCRIYChB0b3Bfa19yZXN1bHRfaWRzGAYgAygJEhgKEHJldHJpZXZhbF9zY29yZXMYByADKAISGgoSZXhlY3V0ZWRfYXRfbWljcm9zGAggASgDEhEKCXNpZ25hdHVyZRgJIAEoCSJBCg9BdWRpdExvZ1JlcXVlc3QSLgoHcmVjb3JkcxgBIAMoCzIdLmphbW1pLnYxLmF1ZGl0LlBlclF1ZXJ5QXVkaXQiLgoaQXVkaXRGZXRjaEJ5UXVlcnlJZFJlcXVlc3QSEAoIcXVlcnlfaWQYASABKAkiXAobQXVkaXRGZXRjaEJ5UXVlcnlJZFJlc3BvbnNlEjIKBnJlY29yZBgBIAEoCzIdLmphbW1pLnYxLmF1ZGl0LlBlclF1ZXJ5QXVkaXRIAIgBAUIJCgdfcmVjb3JkIigKF0F1ZGl0RmV0Y2hSZWNlbnRSZXF1ZXN0Eg0KBWxpbWl0GAEgASgNIkoKGEF1ZGl0RmV0Y2hSZWNlbnRSZXNwb25zZRIuCgdyZWNvcmRzGAEgAygLMh0uamFtbWkudjEuYXVkaXQuUGVyUXVlcnlBdWRpdDKqAgoMQXVkaXRTZXJ2aWNlEkMKCEF1ZGl0TG9nEh8uamFtbWkudjEuYXVkaXQuQXVkaXRMb2dSZXF1ZXN0GhYuZ29vZ2xlLnByb3RvYnVmLkVtcHR5Em4KE0F1ZGl0RmV0Y2hCeVF1ZXJ5SWQSKi5qYW1taS52MS5hdWRpdC5BdWRpdEZldGNoQnlRdWVyeUlkUmVxdWVzdBorLmphbW1pLnYxLmF1ZGl0LkF1ZGl0RmV0Y2hCeVF1ZXJ5SWRSZXNwb25zZRJlChBBdWRpdEZldGNoUmVjZW50EicuamFtbWkudjEuYXVkaXQuQXVkaXRGZXRjaFJlY2VudFJlcXVlc3QaKC5qYW1taS52MS5hdWRpdC5BdWRpdEZldGNoUmVjZW50UmVzcG9uc2ViBnByb3RvMw", [file_google_protobuf_empty]);
+/**
+ * Describes the message jammi.v1.audit.PerQueryAudit.
+ * Use `create(PerQueryAuditSchema)` to create a new message.
+ */
+export const PerQueryAuditSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 0);
+/**
+ * Describes the message jammi.v1.audit.AuditLogRequest.
+ * Use `create(AuditLogRequestSchema)` to create a new message.
+ */
+export const AuditLogRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 1);
+/**
+ * Describes the message jammi.v1.audit.AuditFetchByQueryIdRequest.
+ * Use `create(AuditFetchByQueryIdRequestSchema)` to create a new message.
+ */
+export const AuditFetchByQueryIdRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 2);
+/**
+ * Describes the message jammi.v1.audit.AuditFetchByQueryIdResponse.
+ * Use `create(AuditFetchByQueryIdResponseSchema)` to create a new message.
+ */
+export const AuditFetchByQueryIdResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 3);
+/**
+ * Describes the message jammi.v1.audit.AuditFetchRecentRequest.
+ * Use `create(AuditFetchRecentRequestSchema)` to create a new message.
+ */
+export const AuditFetchRecentRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 4);
+/**
+ * Describes the message jammi.v1.audit.AuditFetchRecentResponse.
+ * Use `create(AuditFetchRecentResponseSchema)` to create a new message.
+ */
+export const AuditFetchRecentResponseSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_audit, 5);
+/**
+ * AuditService — the wire surface for the engine's per-query audit verbs.
+ *
+ * `AuditLog`, `AuditFetchByQueryId`, and `AuditFetchRecent` are imperative
+ * session methods — signing, tenant-injection, and signature-verified decode
+ * are non-SQL logic — so they live as typed gRPC RPCs alongside the other
+ * engine-backed services rather than on the Flight SQL surface (query/result
+ * only, per ADR-01 §3.2). The verbs name a substrate primitive — a signed
+ * per-query audit log — and carry no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the consumer-facing `Session`/`LocalSession`
+ * abstraction (`audit_log` / `audit_fetch_by_query_id` / `audit_fetch_recent`);
+ * the service reimplements no signing, storage, or query logic. The
+ * `PerQueryAudit` message mirrors the Rust record field for field, including
+ * its server-computed `signature`.
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor. The audit primitive requires a bound tenant — an
+ * unscoped call is rejected by the engine.
+ *
+ * @generated from service jammi.v1.audit.AuditService
+ */
+export const AuditService = /*@__PURE__*/ serviceDesc(file_jammi_v1_audit, 0);
+//# sourceMappingURL=audit_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit_pb.js","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/audit_pb.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,oFAAoF;AACpF,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAElF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAY,aAAa,CACvD,QAAQ,CAAC,wqCAAwqC,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAgFntC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AAYtC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AAYtC;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2C,aAAa,CACnG,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AActC;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA4C,aAAa,CACrG,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AActC;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AAYtC;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyC,aAAa,CAC/F,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,YAAY,GAkCpB,aAAa,CAChB,WAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,158 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { EmptySchema } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file jammi/v1/channel.proto.
+ */
+export declare const file_jammi_v1_channel: GenFile;
+/**
+ * One declared column on a channel. Mirrors the engine's `ChannelColumn`.
+ *
+ * @generated from message jammi.v1.channel.ChannelColumn
+ */
+export type ChannelColumn = Message<"jammi.v1.channel.ChannelColumn"> & {
+    /**
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * @generated from field: jammi.v1.channel.ChannelColumnType data_type = 2;
+     */
+    dataType: ChannelColumnType;
+};
+/**
+ * Describes the message jammi.v1.channel.ChannelColumn.
+ * Use `create(ChannelColumnSchema)` to create a new message.
+ */
+export declare const ChannelColumnSchema: GenMessage<ChannelColumn>;
+/**
+ * @generated from message jammi.v1.channel.RegisterChannelRequest
+ */
+export type RegisterChannelRequest = Message<"jammi.v1.channel.RegisterChannelRequest"> & {
+    /**
+     * Channel id: ASCII slug `[a-z][a-z0-9_]{0,63}`.
+     *
+     * @generated from field: string channel_id = 1;
+     */
+    channelId: string;
+    /**
+     * Resolution priority among channels.
+     *
+     * @generated from field: int32 priority = 2;
+     */
+    priority: number;
+    /**
+     * Ordered columns declared on the channel.
+     *
+     * @generated from field: repeated jammi.v1.channel.ChannelColumn columns = 3;
+     */
+    columns: ChannelColumn[];
+};
+/**
+ * Describes the message jammi.v1.channel.RegisterChannelRequest.
+ * Use `create(RegisterChannelRequestSchema)` to create a new message.
+ */
+export declare const RegisterChannelRequestSchema: GenMessage<RegisterChannelRequest>;
+/**
+ * @generated from message jammi.v1.channel.AddChannelColumnsRequest
+ */
+export type AddChannelColumnsRequest = Message<"jammi.v1.channel.AddChannelColumnsRequest"> & {
+    /**
+     * @generated from field: string channel_id = 1;
+     */
+    channelId: string;
+    /**
+     * @generated from field: repeated jammi.v1.channel.ChannelColumn columns = 2;
+     */
+    columns: ChannelColumn[];
+};
+/**
+ * Describes the message jammi.v1.channel.AddChannelColumnsRequest.
+ * Use `create(AddChannelColumnsRequestSchema)` to create a new message.
+ */
+export declare const AddChannelColumnsRequestSchema: GenMessage<AddChannelColumnsRequest>;
+/**
+ * The closed set of Arrow types a channel column may declare. Mirrors the
+ * engine's `ChannelColumnType`.
+ *
+ * @generated from enum jammi.v1.channel.ChannelColumnType
+ */
+export declare enum ChannelColumnType {
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_FLOAT32 = 1;
+     */
+    FLOAT32 = 1,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_FLOAT64 = 2;
+     */
+    FLOAT64 = 2,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_INT32 = 3;
+     */
+    INT32 = 3,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_INT64 = 4;
+     */
+    INT64 = 4,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_UTF8 = 5;
+     */
+    UTF8 = 5,
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_BOOLEAN = 6;
+     */
+    BOOLEAN = 6
+}
+/**
+ * Describes the enum jammi.v1.channel.ChannelColumnType.
+ */
+export declare const ChannelColumnTypeSchema: GenEnum<ChannelColumnType>;
+/**
+ * ChannelService — the wire surface for the engine's provenance-channel
+ * declaration verbs.
+ *
+ * `RegisterChannel` and `AddChannelColumns` are imperative session methods, not
+ * SQL queries, so they live as typed gRPC RPCs alongside the other engine-
+ * backed services rather than on the Flight SQL surface (query/result only, per
+ * ADR-01 §3.2). The verbs name a substrate primitive — a provenance channel and
+ * its declared columns — and carry no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the consumer-facing `Session`/`LocalSession`
+ * abstraction (`register_channel` / `add_channel_columns`); the service
+ * reimplements no catalog logic. The messages mirror the Rust `ChannelSpec` /
+ * `ChannelColumn` field for field.
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor — the same mechanism every other gRPC service uses.
+ *
+ * @generated from service jammi.v1.channel.ChannelService
+ */
+export declare const ChannelService: GenService<{
+    /**
+     * Register a provenance channel and its initial columns. Peer of the
+     * abstraction's `register_channel`.
+     *
+     * @generated from rpc jammi.v1.channel.ChannelService.RegisterChannel
+     */
+    registerChannel: {
+        methodKind: "unary";
+        input: typeof RegisterChannelRequestSchema;
+        output: typeof EmptySchema;
+    };
+    /**
+     * Append columns to an already-registered channel (append-only). Peer of the
+     * abstraction's `add_channel_columns`.
+     *
+     * @generated from rpc jammi.v1.channel.ChannelService.AddChannelColumns
+     */
+    addChannelColumns: {
+        methodKind: "unary";
+        input: typeof AddChannelColumnsRequestSchema;
+        output: typeof EmptySchema;
+    };
+}>;
+//# sourceMappingURL=channel_pb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel_pb.d.ts","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/channel_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,OACwiC,CAAC;AAE7kC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,gCAAgC,CAAC,GAAG;IACtE;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC,aAAa,CACnB,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,yCAAyC,CAAC,GAAG;IACxF;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAAU,CAAC,sBAAsB,CACrC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,2CAA2C,CAAC,GAAG;IAC5F;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,UAAU,CAAC,wBAAwB,CACzC,CAAC;AAExC;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,OAAO,IAAI;CACZ;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,iBAAiB,CAC3B,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC;IACtC;;;;;OAKG;IACH,eAAe,EAAE;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,4BAA4B,CAAC;QAC3C,MAAM,EAAE,OAAO,WAAW,CAAC;KAC5B,CAAC;IACF;;;;;OAKG;IACH,iBAAiB,EAAE;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,8BAA8B,CAAC;QAC7C,MAAM,EAAE,OAAO,WAAW,CAAC;KAC5B,CAAC;CACH,CACsC,CAAC"}

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

@@ -0,0 +1,87 @@
+// @generated by protoc-gen-es v2.12.0 with parameter "target=ts"
+// @generated from file jammi/v1/channel.proto (package jammi.v1.channel, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_empty } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file jammi/v1/channel.proto.
+ */
+export const file_jammi_v1_channel = /*@__PURE__*/ fileDesc("ChZqYW1taS92MS9jaGFubmVsLnByb3RvEhBqYW1taS52MS5jaGFubmVsIlUKDUNoYW5uZWxDb2x1bW4SDAoEbmFtZRgBIAEoCRI2CglkYXRhX3R5cGUYAiABKA4yIy5qYW1taS52MS5jaGFubmVsLkNoYW5uZWxDb2x1bW5UeXBlInAKFlJlZ2lzdGVyQ2hhbm5lbFJlcXVlc3QSEgoKY2hhbm5lbF9pZBgBIAEoCRIQCghwcmlvcml0eRgCIAEoBRIwCgdjb2x1bW5zGAMgAygLMh8uamFtbWkudjEuY2hhbm5lbC5DaGFubmVsQ29sdW1uImAKGEFkZENoYW5uZWxDb2x1bW5zUmVxdWVzdBISCgpjaGFubmVsX2lkGAEgASgJEjAKB2NvbHVtbnMYAiADKAsyHy5qYW1taS52MS5jaGFubmVsLkNoYW5uZWxDb2x1bW4q9wEKEUNoYW5uZWxDb2x1bW5UeXBlEiMKH0NIQU5ORUxfQ09MVU1OX1RZUEVfVU5TUEVDSUZJRUQQABIfChtDSEFOTkVMX0NPTFVNTl9UWVBFX0ZMT0FUMzIQARIfChtDSEFOTkVMX0NPTFVNTl9UWVBFX0ZMT0FUNjQQAhIdChlDSEFOTkVMX0NPTFVNTl9UWVBFX0lOVDMyEAMSHQoZQ0hBTk5FTF9DT0xVTU5fVFlQRV9JTlQ2NBAEEhwKGENIQU5ORUxfQ09MVU1OX1RZUEVfVVRGOBAFEh8KG0NIQU5ORUxfQ09MVU1OX1RZUEVfQk9PTEVBThAGMr4BCg5DaGFubmVsU2VydmljZRJTCg9SZWdpc3RlckNoYW5uZWwSKC5qYW1taS52MS5jaGFubmVsLlJlZ2lzdGVyQ2hhbm5lbFJlcXVlc3QaFi5nb29nbGUucHJvdG9idWYuRW1wdHkSVwoRQWRkQ2hhbm5lbENvbHVtbnMSKi5qYW1taS52MS5jaGFubmVsLkFkZENoYW5uZWxDb2x1bW5zUmVxdWVzdBoWLmdvb2dsZS5wcm90b2J1Zi5FbXB0eWIGcHJvdG8z", [file_google_protobuf_empty]);
+/**
+ * Describes the message jammi.v1.channel.ChannelColumn.
+ * Use `create(ChannelColumnSchema)` to create a new message.
+ */
+export const ChannelColumnSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_channel, 0);
+/**
+ * Describes the message jammi.v1.channel.RegisterChannelRequest.
+ * Use `create(RegisterChannelRequestSchema)` to create a new message.
+ */
+export const RegisterChannelRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_channel, 1);
+/**
+ * Describes the message jammi.v1.channel.AddChannelColumnsRequest.
+ * Use `create(AddChannelColumnsRequestSchema)` to create a new message.
+ */
+export const AddChannelColumnsRequestSchema = /*@__PURE__*/ messageDesc(file_jammi_v1_channel, 2);
+/**
+ * The closed set of Arrow types a channel column may declare. Mirrors the
+ * engine's `ChannelColumnType`.
+ *
+ * @generated from enum jammi.v1.channel.ChannelColumnType
+ */
+export var ChannelColumnType;
+(function (ChannelColumnType) {
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_UNSPECIFIED = 0;
+     */
+    ChannelColumnType[ChannelColumnType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_FLOAT32 = 1;
+     */
+    ChannelColumnType[ChannelColumnType["FLOAT32"] = 1] = "FLOAT32";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_FLOAT64 = 2;
+     */
+    ChannelColumnType[ChannelColumnType["FLOAT64"] = 2] = "FLOAT64";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_INT32 = 3;
+     */
+    ChannelColumnType[ChannelColumnType["INT32"] = 3] = "INT32";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_INT64 = 4;
+     */
+    ChannelColumnType[ChannelColumnType["INT64"] = 4] = "INT64";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_UTF8 = 5;
+     */
+    ChannelColumnType[ChannelColumnType["UTF8"] = 5] = "UTF8";
+    /**
+     * @generated from enum value: CHANNEL_COLUMN_TYPE_BOOLEAN = 6;
+     */
+    ChannelColumnType[ChannelColumnType["BOOLEAN"] = 6] = "BOOLEAN";
+})(ChannelColumnType || (ChannelColumnType = {}));
+/**
+ * Describes the enum jammi.v1.channel.ChannelColumnType.
+ */
+export const ChannelColumnTypeSchema = /*@__PURE__*/ enumDesc(file_jammi_v1_channel, 0);
+/**
+ * ChannelService — the wire surface for the engine's provenance-channel
+ * declaration verbs.
+ *
+ * `RegisterChannel` and `AddChannelColumns` are imperative session methods, not
+ * SQL queries, so they live as typed gRPC RPCs alongside the other engine-
+ * backed services rather than on the Flight SQL surface (query/result only, per
+ * ADR-01 §3.2). The verbs name a substrate primitive — a provenance channel and
+ * its declared columns — and carry no tenant-domain concept.
+ *
+ * Each verb delegates 1:1 to the consumer-facing `Session`/`LocalSession`
+ * abstraction (`register_channel` / `add_channel_columns`); the service
+ * reimplements no catalog logic. The messages mirror the Rust `ChannelSpec` /
+ * `ChannelColumn` field for field.
+ *
+ * Tenant scope is read from the request's `SessionTenant` extension, set by the
+ * shared TenantInterceptor — the same mechanism every other gRPC service uses.
+ *
+ * @generated from service jammi.v1.channel.ChannelService
+ */
+export const ChannelService = /*@__PURE__*/ serviceDesc(file_jammi_v1_channel, 0);
+//# sourceMappingURL=channel_pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel_pb.js","sourceRoot":"","sources":["../../../../src/gen/jammi/v1/channel_pb.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,wFAAwF;AACxF,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAY,aAAa,CACzD,QAAQ,CAAC,kiCAAkiC,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAmB7kC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AA4BxC;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuC,aAAa,CAC3F,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAiBxC;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyC,aAAa,CAC/F,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBAmCX;AAnCD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,uEAAe,CAAA;IAEf;;OAEG;IACH,+DAAW,CAAA;IAEX;;OAEG;IACH,+DAAW,CAAA;IAEX;;OAEG;IACH,2DAAS,CAAA;IAET;;OAEG;IACH,2DAAS,CAAA;IAET;;OAEG;IACH,yDAAQ,CAAA;IAER;;OAEG;IACH,+DAAW,CAAA;AACb,CAAC,EAnCW,iBAAiB,KAAjB,iBAAiB,QAmC5B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA+B,aAAa,CAC9E,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,cAAc,GAuBtB,aAAa,CAChB,WAAW,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC"}