@loams/client 0.1.0 → 0.1.2

package/dist/builders/search.js

@@ -0,0 +1,307 @@
+// The search builder (SDKP §2.4): a `loams.collection.v1.SearchRequest`, one
+// verb at a time.
+//
+//   const request = Search.on('notes')
+//     .text('refund', { fields: ['body'] })
+//     .vector('embedding', [0.1, 0.2, 0.3, 0.4], { k: 10 })
+//     .fuse(rrf(60))
+//     .filter(Filter.eq('tags', 'policy'))
+//     .highlight('body')
+//     .select({ include: ['title'] })
+//     .limit(5);
+//   const answer = await loams.search.query(request.build());
+//
+// Each verb is pure: it returns a new builder and leaves the old one as it
+// was, so a base query can be shared and specialised. `toJson()` is the
+// request's proto3 JSON, which is how the builder corpus spells each case;
+// `build()` decodes it into the generated message, refusing the requests the
+// builder can tell are wrong (a weighted fusion with the wrong number of
+// weights) before any network call.
+var _a;
+import { fromJson, toJson } from '@bufbuild/protobuf';
+import { ValueSchema } from '@bufbuild/protobuf/wkt';
+import { Code } from '@connectrpc/connect';
+import { SearchRequestSchema } from '../vendor/proto/gen/loams/collection/v1/query_pb.js';
+import { ConsistencyToken } from '../runtime/consistency.js';
+import { InvalidArgumentError } from '../runtime/errors.js';
+import { Filter } from './filter.js';
+/** Reciprocal-rank fusion; `k` absent is the engine's 60. */
+export function rrf(k) {
+    return { rrf: k === undefined ? {} : { k } };
+}
+/** Distance-based score fusion, with the engine's parameters. */
+export function dbsf() {
+    return { dbsf: {} };
+}
+/** A weighted sum, one weight per retriever in the order they were added. */
+export function weighted(...weights) {
+    return { weightedSum: { weights } };
+}
+/** The fusions, as one namespace. */
+export const Fusion = { rrf, dbsf, weighted };
+const order = (value) => (value === 'asc' ? 'SORT_ORDER_ASC' : 'SORT_ORDER_DESC');
+/** The sort keys. The primary key ascending always breaks ties on the server,
+ * but `queryAll` needs it spelled out to page. */
+export const Sort = {
+    /** By score; descending unless told otherwise. */
+    score(direction) {
+        return { score: direction === undefined ? {} : { order: order(direction) } };
+    },
+    /** By primary key; ascending unless told otherwise. */
+    pk(direction) {
+        return { pk: direction === undefined ? {} : { order: order(direction) } };
+    },
+    /** By a fast field. `missing` puts documents without it first or last. */
+    field(name, direction, missing) {
+        const key = { field: name };
+        if (direction !== undefined) {
+            key.order = order(direction);
+        }
+        if (missing !== undefined) {
+            key.missing = missing === 'first' ? 'MISSING_ORDER_FIRST' : 'MISSING_ORDER_LAST';
+        }
+        return { field: key };
+    },
+};
+/** The proto3 JSON of a `loams.collection.v1.Consistency`. */
+export function consistencyJson(level) {
+    if (level === 'strong') {
+        return { freshness: 'FRESHNESS_STRONG' };
+    }
+    if (level === 'eventual') {
+        return { freshness: 'FRESHNESS_EVENTUAL' };
+    }
+    const token = typeof level === 'string' ? ConsistencyToken.parse(level) : level;
+    return { atLeast: token.toString() };
+}
+function sortValueJson(value) {
+    if (value !== null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        value.$typeName === 'google.protobuf.Value') {
+        return toJson(ValueSchema, value);
+    }
+    return value;
+}
+function textQuery(text, fields) {
+    if (typeof text !== 'string') {
+        return text;
+    }
+    if (fields === undefined || fields.length === 0) {
+        return Filter.queryString(text);
+    }
+    if (fields.length === 1) {
+        return Filter.match(fields[0], text);
+    }
+    return Filter.multiMatch(fields, text);
+}
+/** The search builder. */
+export class Search {
+    #json;
+    constructor(json) {
+        this.#json = json;
+    }
+    /** A search of `collection` (a name or an alias). */
+    static on(collection, options = {}) {
+        return new _a({
+            ...(options.namespace === undefined ? {} : { namespace: options.namespace }),
+            collection,
+        });
+    }
+    /** A builder over an existing request's proto3 JSON. */
+    static fromJson(json) {
+        return new _a(structuredClone(json));
+    }
+    #with(patch) {
+        return new _a({ ...structuredClone(this.#json), ...patch });
+    }
+    #retrievers() {
+        return this.#json.retrievers ?? [];
+    }
+    /** The namespace, when it is not the client's default. */
+    namespace(namespace) {
+        return this.#with({ namespace });
+    }
+    /** A text retriever. A string is a `match`/`multi_match`/`query_string`
+     * by `fields`; a `Filter` (`match`, `multiMatch`, `phrase`…) is used as is. */
+    text(text, options = {}) {
+        const retriever = { query: textQuery(text, options.fields) };
+        if (options.k !== undefined) {
+            retriever.k = options.k;
+        }
+        return this.#with({ retrievers: [...this.#retrievers(), { text: retriever }] });
+    }
+    /** A dense-vector kNN retriever on `field`. */
+    vector(field, values, options = {}) {
+        const retriever = { field, query: [...values] };
+        if (options.k !== undefined) {
+            retriever.k = options.k;
+        }
+        const params = {};
+        for (const key of ['exact', 'nprobes', 'refineFactor', 'ef', 'oversampling', 'distance']) {
+            if (options[key] !== undefined) {
+                params[key] = options[key];
+            }
+        }
+        if (Object.keys(params).length > 0) {
+            retriever.params = params;
+        }
+        if (options.filter !== undefined) {
+            retriever.filter = options.filter;
+        }
+        return this.#with({ retrievers: [...this.#retrievers(), { vector: retriever }] });
+    }
+    /** A sparse-vector retriever: `{indices, values}`, or a term-to-weight map
+     * whose keys are the indices. */
+    sparse(field, terms, options = {}) {
+        const query = 'indices' in terms && Array.isArray(terms.indices)
+            ? { indices: [...terms.indices], values: [...terms.values] }
+            : (() => {
+                const entries = Object.entries(terms);
+                return { indices: entries.map(([index]) => Number(index)), values: entries.map(([, v]) => v) };
+            })();
+        const retriever = { field, query };
+        if (options.k !== undefined) {
+            retriever.k = options.k;
+        }
+        if (options.filter !== undefined) {
+            retriever.filter = options.filter;
+        }
+        return this.#with({ retrievers: [...this.#retrievers(), { sparse: retriever }] });
+    }
+    /** How the retrievers' ranked lists combine: `rrf()`, `dbsf()` or
+     * `weighted(…)`. */
+    fuse(fusion) {
+        return this.#with({ fusion });
+    }
+    /** The filter every candidate must match. */
+    filter(filter) {
+        return this.#with({ filter });
+    }
+    /** The sort, replacing any earlier one. */
+    sort(...keys) {
+        return this.#with({ sort: keys });
+    }
+    /** The window size; the engine's default is 10. */
+    limit(limit) {
+        return this.#with({ limit });
+    }
+    /** How many hits to skip before the window. */
+    offset(offset) {
+        return this.#with({ offset });
+    }
+    /** The page after the hit whose `sortValues` these are. */
+    after(sortValues) {
+        return this.#with({ searchAfter: sortValues.map(sortValueJson) });
+    }
+    /** Drops hits scoring below `score`. */
+    minScore(score) {
+        return this.#with({ scoreThreshold: score });
+    }
+    /** What to return of each hit. */
+    select(options) {
+        const select = {};
+        if (options.noSource === true) {
+            select.source = 'none';
+        }
+        else if (options.include !== undefined || options.exclude !== undefined) {
+            const source = {};
+            if (options.include !== undefined) {
+                source.include = [...options.include];
+            }
+            if (options.exclude !== undefined) {
+                source.exclude = [...options.exclude];
+            }
+            select.source = source;
+        }
+        if (options.vectors !== undefined) {
+            select.vectors = [...options.vectors];
+        }
+        if (options.fields !== undefined) {
+            select.fields = [...options.fields];
+        }
+        return this.#with({ select });
+    }
+    /** Highlights `field` in each hit; call once per field. */
+    highlight(field, options = {}) {
+        const entry = { field };
+        if (options.pre !== undefined) {
+            entry.preTag = options.pre;
+        }
+        if (options.post !== undefined) {
+            entry.postTag = options.post;
+        }
+        if (options.fragmentSize !== undefined) {
+            entry.fragmentSize = options.fragmentSize;
+        }
+        if (options.fragments !== undefined) {
+            entry.numberOfFragments = options.fragments;
+        }
+        const existing = this.#json.highlight?.fields ?? [];
+        return this.#with({ highlight: { fields: [...existing, entry] } });
+    }
+    /** Groups the hits by `field`: `size` hits per group, `limit` groups. */
+    groupBy(field, options = {}) {
+        const group = { field };
+        if (options.size !== undefined) {
+            group.groupSize = options.size;
+        }
+        if (options.limit !== undefined) {
+            group.limit = options.limit;
+        }
+        return this.#with({ groupBy: group });
+    }
+    /** Walks `graph` from the top hits and returns their neighbours. */
+    expand(graph, options = {}) {
+        const spec = { graph };
+        const copy = ['fromField', 'seedLabel', 'seeds', 'hops', 'limitPerSeed', 'limit'];
+        for (const key of copy) {
+            if (options[key] !== undefined) {
+                spec[key] = options[key];
+            }
+        }
+        if (options.direction !== undefined) {
+            spec.direction = `EXPAND_DIRECTION_${options.direction.toUpperCase()}`;
+        }
+        if (options.edgeTypes !== undefined) {
+            spec.edgeTypes = [...options.edgeTypes];
+        }
+        if (options.output !== undefined) {
+            spec.output = `EXPAND_OUTPUT_${options.output.toUpperCase()}`;
+        }
+        return this.#with({ expandSpec: spec });
+    }
+    /** How fresh the read must be. */
+    consistency(level) {
+        return this.#with({ consistency: consistencyJson(level) });
+    }
+    /** The collection searched. */
+    get collection() {
+        return this.#json.collection;
+    }
+    /** Whether the sort ends in a primary-key tiebreaker, which `queryAll`
+     * needs to page without skipping or repeating a hit. */
+    get hasTiebreak() {
+        const sort = this.#json.sort;
+        const last = sort?.[sort.length - 1];
+        return last !== undefined && 'pk' in last;
+    }
+    /** The request's proto3 JSON. */
+    toJson() {
+        return structuredClone(this.#json);
+    }
+    /** The request as the generated message, checked. */
+    build() {
+        const weights = this.#json.fusion?.weightedSum
+            ?.weights;
+        const retrievers = this.#retrievers().length;
+        if (weights !== undefined && weights.length !== retrievers) {
+            throw new InvalidArgumentError(`a weighted fusion needs one weight per retriever: ${weights.length} weights for ${retrievers} retrievers`, {
+                code: Code.InvalidArgument,
+                metadata: { field: 'fusion.weighted_sum.weights' },
+            });
+        }
+        return fromJson(SearchRequestSchema, this.#json);
+    }
+}
+_a = Search;

package/dist/gen/facade.d.ts

@@ -9,8 +9,13 @@ import type { DescService } from '@bufbuild/protobuf';
 import type { CallOptions } from '../runtime/call.js';
 import type { AddTeamMemberRequestSchema, AddTeamMemberResponse, CreateAgentRequestSchema, CreateAgentResponse, CreateEnvironmentRequestSchema, CreateEnvironmentResponse, CreateInvitationRequestSchema, CreateInvitationResponse, CreateKeyRequestSchema, CreateKeyResponse, CreateProjectRequestSchema, CreateProjectResponse, CreateServiceAccountRequestSchema, CreateServiceAccountResponse, CreateTeamRequestSchema, CreateTeamResponse, CreateTrustPolicyRequestSchema, CreateTrustPolicyResponse, GetAgentRequestSchema, GetAgentResponse, GetEnvironmentActivityRequestSchema, GetEnvironmentActivityResponse, GetEnvironmentRequestSchema, GetEnvironmentResponse, GetOrgRequestSchema, GetOrgResponse, GetProjectRequestSchema, GetProjectResponse, GetTeamRequestSchema, GetTeamResponse, GrantAccessRequestSchema, GrantAccessResponse, ListAccessRequestSchema, ListAccessResponse, ListAgentTokensRequestSchema, ListAgentTokensResponse, ListAgentsRequestSchema, ListAgentsResponse, ListAuditEventsRequestSchema, ListAuditEventsResponse, ListEnvironmentsRequestSchema, ListEnvironmentsResponse, ListInvitationsRequestSchema, ListInvitationsResponse, ListKeysRequestSchema, ListKeysResponse, ListMembersRequestSchema, ListMembersResponse, ListProjectsRequestSchema, ListProjectsResponse, ListServiceAccountsRequestSchema, ListServiceAccountsResponse, ListTeamsRequestSchema, ListTeamsResponse, ListTrustPoliciesRequestSchema, ListTrustPoliciesResponse, RemoveMemberRequestSchema, RemoveMemberResponse, ResumeAgentRequestSchema, ResumeAgentResponse, RevokeKeyRequestSchema, RevokeKeyResponse, RevokeTokenRequestSchema, RevokeTokenResponse, SuspendAgentRequestSchema, SuspendAgentResponse, UpdateAgentRequestSchema, UpdateAgentResponse, UpdateOrgRequestSchema, UpdateOrgResponse, WatchAuditEventsRequestSchema, WatchAuditEventsResponse } from '../vendor/proto/admin.js';
 import type { CompleteSetupRequestSchema, CompleteSetupResponse, CreateSessionRequestSchema, CreateSessionResponse, DecideConsentRequestSchema, DecideConsentResponse, DeleteSessionRequestSchema, DeleteSessionResponse, GetSessionRequestSchema, GetSessionResponse, ListProvidersRequestSchema, ListProvidersResponse } from '../vendor/proto/gen/loams/auth/v1/auth_pb.js';
+import type { AddFieldsRequestSchema, AddFieldsResponse, CollectionInfo, CountDocumentsRequestSchema, CountDocumentsResponse, CreateCollectionRequestSchema, CreateNamespaceRequestSchema, CreateNamespaceResponse, DeleteByFilterRequestSchema, DropCollectionRequestSchema, DropCollectionResponse, FilterWriteResponse, GetCollectionRequestSchema, GetDocumentsRequestSchema, GetDocumentsResponse, ListCollectionsRequestSchema, ListCollectionsResponse, ListNamespacesRequestSchema, ListNamespacesResponse, ListVersionsRequestSchema, ListVersionsResponse, PatchByFilterRequestSchema, ScanPlan, ScanRequestSchema, ScrollDocumentsRequestSchema, ScrollDocumentsResponse, SearchRequestSchema, SearchResponse, SetHotRequestSchema, SetHotResponse, UpdateAliasesRequestSchema, UpdateAliasesResponse, WarmCollectionRequestSchema, WarmCollectionResponse, WriteDocumentsRequestSchema, WriteDocumentsResponse } from '../vendor/proto/collection-v1.js';
+import type { CreateGraphRequestSchema, DeleteGraphRequestSchema, ExecuteBatchRequestSchema, ExecuteBatchResponse, ExecuteRequestSchema, ExecuteResponse, ExecuteStreamRequestSchema, ExplainRequestSchema, GetGraphRequestSchema, GetSchemaRequestSchema, Graph, GraphSchema, ListGraphsRequestSchema, ListGraphsResponse, Plan, ResultChunk, UpdateGraphRequestSchema } from '../vendor/proto/gen/loams/graph/v1/graph_pb.js';
 import type { GetInstanceRequestSchema, GetInstanceResponse, WhoAmIRequestSchema, WhoAmIResponse } from '../vendor/proto/gen/loams/instance/v1/instance_pb.js';
 import type { ActivateDeploymentRequestSchema, ActivateDeploymentResponse, AuthenticateRequestSchema, AuthenticateResponse, CreateAppRequestSchema, CreateAppResponse, DeleteAppRequestSchema, DeleteAppResponse, DeployRequestSchema, DeployResponse, GetAppRequestSchema, GetAppResponse, GetDeploymentRequestSchema, GetDeploymentResponse, GetIndexStatusRequestSchema, GetIndexStatusResponse, ListAppsRequestSchema, ListAppsResponse, ListDeploymentsRequestSchema, ListDeploymentsResponse, ModifyQuerySetRequestSchema, ModifyQuerySetResponse, MutateRequestSchema, MutateResponse, QueryRequestSchema, QueryResponse, TailLogsRequestSchema, TailLogsResponse, Transition, UpdateAppRequestSchema, UpdateAppResponse, WatchRequestSchema } from '@loams/live/live';
+import type { QueryArrowRequestSchema, QueryArrowResponse, QueryRequestSchema as SqlV1QueryRequestSchema, QueryResponse as SqlV1QueryResponse } from '../vendor/proto/gen/loams/sql/v1/sql_pb.js';
+import type { CreateStreamRequestSchema, CreateStreamResponse, DescribeStreamRequestSchema, DescribeStreamResponse, FetchCloudEventsRequestSchema, FetchCloudEventsResponse, FetchRequestSchema, FetchResponse, ListStreamsRequestSchema, ListStreamsResponse, ProduceCloudEventsRequestSchema, ProduceCloudEventsResponse, ProduceRequestSchema, ProduceResponse } from '../vendor/proto/gen/loams/stream/v1/stream_pb.js';
+import type { Operation } from '../vendor/proto/gen/loams/operations/v1/operations_pb.js';
 /**
  *  `loams.admin.agents` — Agents, their tokens and trust policies, and service accounts.
  *
@@ -257,6 +262,149 @@ export interface AuthModule {
      */
     listProviders(request: MessageInitShape<typeof ListProvidersRequestSchema>, options?: CallOptions): Promise<ListProvidersResponse>;
 }
+/**
+ *  `loams.collections` — Collections: schema, aliases, versions, scan plans and the hot tier.
+ *
+ *  Wraps `loams.collection.v1.CollectionService`.
+ */
+export interface CollectionsModule {
+    /** The SDK module, as it appears on `loams.collections`. */
+    readonly module: 'collections';
+    /** The service behind the module. */
+    readonly service: 'loams.collection.v1.CollectionService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.collection.v1.CollectionService/AddFields`, retried: safe.
+     */
+    addFields(request: MessageInitShape<typeof AddFieldsRequestSchema>, options?: CallOptions): Promise<AddFieldsResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/CreateCollection`, retried: safe.
+     */
+    create(request: MessageInitShape<typeof CreateCollectionRequestSchema>, options?: CallOptions): Promise<CollectionInfo>;
+    /**
+     *  `loams.collection.v1.CollectionService/DropCollection`, retried: safe.
+     */
+    drop(request: MessageInitShape<typeof DropCollectionRequestSchema>, options?: CallOptions): Promise<DropCollectionResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/GetCollection`, retried: safe.
+     */
+    get(request: MessageInitShape<typeof GetCollectionRequestSchema>, options?: CallOptions): Promise<CollectionInfo>;
+    /**
+     *  `loams.collection.v1.CollectionService/ListCollections`, retried: safe. AIP-158: page with `collections` and follow `next_page_token` through `loams.paginate`.
+     */
+    list(request: MessageInitShape<typeof ListCollectionsRequestSchema>, options?: CallOptions): Promise<ListCollectionsResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/ListVersions`, retried: safe. AIP-158: page with `versions` and follow `next_page_token` through `loams.paginate`.
+     */
+    listVersions(request: MessageInitShape<typeof ListVersionsRequestSchema>, options?: CallOptions): Promise<ListVersionsResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/Scan`, retried: manual.
+     */
+    scan(request: MessageInitShape<typeof ScanRequestSchema>, options?: CallOptions): Promise<ScanPlan>;
+    /**
+     *  `loams.collection.v1.CollectionService/SetHot`, retried: safe.
+     */
+    setHot(request: MessageInitShape<typeof SetHotRequestSchema>, options?: CallOptions): Promise<SetHotResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/UpdateAliases`, retried: safe.
+     */
+    updateAliases(request: MessageInitShape<typeof UpdateAliasesRequestSchema>, options?: CallOptions): Promise<UpdateAliasesResponse>;
+    /**
+     *  `loams.collection.v1.CollectionService/WarmCollection`, retried: safe.
+     */
+    warm(request: MessageInitShape<typeof WarmCollectionRequestSchema>, options?: CallOptions): Promise<WarmCollectionResponse>;
+}
+/**
+ *  `loams.documents` — Documents: write, get, scroll, count, delete by filter and patch by filter.
+ *
+ *  Wraps `loams.collection.v1.DocumentService`.
+ */
+export interface DocumentsModule {
+    /** The SDK module, as it appears on `loams.documents`. */
+    readonly module: 'documents';
+    /** The service behind the module. */
+    readonly service: 'loams.collection.v1.DocumentService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.collection.v1.DocumentService/CountDocuments`, retried: safe.
+     */
+    count(request: MessageInitShape<typeof CountDocumentsRequestSchema>, options?: CallOptions): Promise<CountDocumentsResponse>;
+    /**
+     *  `loams.collection.v1.DocumentService/DeleteByFilter`, retried: manual.
+     */
+    deleteByFilter(request: MessageInitShape<typeof DeleteByFilterRequestSchema>, options?: CallOptions): Promise<FilterWriteResponse>;
+    /**
+     *  `loams.collection.v1.DocumentService/GetDocuments`, retried: safe.
+     */
+    get(request: MessageInitShape<typeof GetDocumentsRequestSchema>, options?: CallOptions): Promise<GetDocumentsResponse>;
+    /**
+     *  `loams.collection.v1.DocumentService/PatchByFilter`, retried: manual.
+     */
+    patchByFilter(request: MessageInitShape<typeof PatchByFilterRequestSchema>, options?: CallOptions): Promise<FilterWriteResponse>;
+    /**
+     *  `loams.collection.v1.DocumentService/ScrollDocuments`, retried: safe.
+     */
+    scroll(request: MessageInitShape<typeof ScrollDocumentsRequestSchema>, options?: CallOptions): Promise<ScrollDocumentsResponse>;
+    /**
+     *  `loams.collection.v1.DocumentService/WriteDocuments`, retried: manual.
+     */
+    write(request: MessageInitShape<typeof WriteDocumentsRequestSchema>, options?: CallOptions): Promise<WriteDocumentsResponse>;
+}
+/**
+ *  `loams.graph` — Loams Graph: stored property graphs, queried with GQL.
+ *
+ *  Wraps `loams.graph.v1.GraphAdminService`. Its wire contract may still change, so `buf breaking` skips it and an SDK marks it experimental (§44 §10.3).
+ */
+export interface GraphModule {
+    /** The SDK module, as it appears on `loams.graph`. */
+    readonly module: 'graph';
+    /** The service behind the module. */
+    readonly service: 'loams.graph.v1.GraphAdminService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: true;
+    /**
+     *  `loams.graph.v1.GraphAdminService/CreateGraph`, retried: manual.
+     */
+    create(request: MessageInitShape<typeof CreateGraphRequestSchema>, options?: CallOptions): Promise<Graph>;
+    /**
+     *  `loams.graph.v1.GraphAdminService/DeleteGraph`, retried: manual.
+     */
+    delete(request: MessageInitShape<typeof DeleteGraphRequestSchema>, options?: CallOptions): Promise<Operation>;
+    /**
+     *  `loams.graph.v1.GraphService/Explain`, retried: safe.
+     */
+    explain(request: MessageInitShape<typeof ExplainRequestSchema>, options?: CallOptions): Promise<Plan>;
+    /**
+     *  `loams.graph.v1.GraphAdminService/GetGraph`, retried: safe.
+     */
+    get(request: MessageInitShape<typeof GetGraphRequestSchema>, options?: CallOptions): Promise<Graph>;
+    /**
+     *  `loams.graph.v1.GraphAdminService/ListGraphs`, retried: safe. AIP-158: page with `graphs` and follow `next_page_token` through `loams.paginate`.
+     */
+    list(request: MessageInitShape<typeof ListGraphsRequestSchema>, options?: CallOptions): Promise<ListGraphsResponse>;
+    /**
+     *  `loams.graph.v1.GraphService/Execute`, retried: manual.
+     */
+    query(request: MessageInitShape<typeof ExecuteRequestSchema>, options?: CallOptions): Promise<ExecuteResponse>;
+    /**
+     *  `loams.graph.v1.GraphService/ExecuteBatch`, retried: manual.
+     */
+    queryBatch(request: MessageInitShape<typeof ExecuteBatchRequestSchema>, options?: CallOptions): Promise<ExecuteBatchResponse>;
+    /**
+     *  `loams.graph.v1.GraphService/ExecuteStream`, retried: manual.
+     */
+    queryStream(request: MessageInitShape<typeof ExecuteStreamRequestSchema>, options?: CallOptions): AsyncIterable<ResultChunk>;
+    /**
+     *  `loams.graph.v1.GraphAdminService/GetSchema`, retried: safe.
+     */
+    schema(request: MessageInitShape<typeof GetSchemaRequestSchema>, options?: CallOptions): Promise<GraphSchema>;
+    /**
+     *  `loams.graph.v1.GraphAdminService/UpdateGraph`, retried: manual.
+     */
+    update(request: MessageInitShape<typeof UpdateGraphRequestSchema>, options?: CallOptions): Promise<Graph>;
+}
 /**
  *  `loams.instance` — What this instance is, and who the caller is on it.
  *
@@ -360,6 +508,106 @@ export interface LiveAdminModule {
      */
     updateApp(request: MessageInitShape<typeof UpdateAppRequestSchema>, options?: CallOptions): Promise<UpdateAppResponse>;
 }
+/**
+ *  `loams.namespaces` — Namespaces: the container every collection and stream lives in.
+ *
+ *  Wraps `loams.collection.v1.NamespaceService`.
+ */
+export interface NamespacesModule {
+    /** The SDK module, as it appears on `loams.namespaces`. */
+    readonly module: 'namespaces';
+    /** The service behind the module. */
+    readonly service: 'loams.collection.v1.NamespaceService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.collection.v1.NamespaceService/CreateNamespace`, retried: safe.
+     */
+    create(request: MessageInitShape<typeof CreateNamespaceRequestSchema>, options?: CallOptions): Promise<CreateNamespaceResponse>;
+    /**
+     *  `loams.collection.v1.NamespaceService/ListNamespaces`, retried: safe. AIP-158: page with `namespaces` and follow `next_page_token` through `loams.paginate`.
+     */
+    list(request: MessageInitShape<typeof ListNamespacesRequestSchema>, options?: CallOptions): Promise<ListNamespacesResponse>;
+}
+/**
+ *  `loams.search` — Queries: one search over one collection, dense, sparse, text or hybrid.
+ *
+ *  Wraps `loams.collection.v1.QueryService`.
+ */
+export interface SearchModule {
+    /** The SDK module, as it appears on `loams.search`. */
+    readonly module: 'search';
+    /** The service behind the module. */
+    readonly service: 'loams.collection.v1.QueryService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.collection.v1.QueryService/Search`, retried: safe.
+     */
+    query(request: MessageInitShape<typeof SearchRequestSchema>, options?: CallOptions): Promise<SearchResponse>;
+}
+/**
+ *  `loams.sql` — SQL: one read-only statement over a namespace's collections, with parameters.
+ *
+ *  Wraps `loams.sql.v1.SqlService`.
+ */
+export interface SqlModule {
+    /** The SDK module, as it appears on `loams.sql`. */
+    readonly module: 'sql';
+    /** The service behind the module. */
+    readonly service: 'loams.sql.v1.SqlService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.sql.v1.SqlService/Query`, retried: safe.
+     */
+    query(request: MessageInitShape<typeof SqlV1QueryRequestSchema>, options?: CallOptions): Promise<SqlV1QueryResponse>;
+    /**
+     *  `loams.sql.v1.SqlService/QueryArrow`, retried: safe.
+     */
+    queryArrow(request: MessageInitShape<typeof QueryArrowRequestSchema>, options?: CallOptions): Promise<QueryArrowResponse>;
+}
+/**
+ *  `loams.streams` — Streams: create, list and describe a namespace's logs; produce and fetch records and CloudEvents.
+ *
+ *  Wraps `loams.stream.v1.StreamService`.
+ */
+export interface StreamsModule {
+    /** The SDK module, as it appears on `loams.streams`. */
+    readonly module: 'streams';
+    /** The service behind the module. */
+    readonly service: 'loams.stream.v1.StreamService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.stream.v1.StreamService/CreateStream`, retried: safe.
+     */
+    create(request: MessageInitShape<typeof CreateStreamRequestSchema>, options?: CallOptions): Promise<CreateStreamResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/Fetch`, retried: safe.
+     */
+    fetch(request: MessageInitShape<typeof FetchRequestSchema>, options?: CallOptions): Promise<FetchResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/FetchCloudEvents`, retried: safe.
+     */
+    fetchEvents(request: MessageInitShape<typeof FetchCloudEventsRequestSchema>, options?: CallOptions): Promise<FetchCloudEventsResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/DescribeStream`, retried: safe.
+     */
+    get(request: MessageInitShape<typeof DescribeStreamRequestSchema>, options?: CallOptions): Promise<DescribeStreamResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/ListStreams`, retried: safe. AIP-158: page with `streams` and follow `next_page_token` through `loams.paginate`.
+     */
+    list(request: MessageInitShape<typeof ListStreamsRequestSchema>, options?: CallOptions): Promise<ListStreamsResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/Produce`, retried: manual.
+     */
+    produce(request: MessageInitShape<typeof ProduceRequestSchema>, options?: CallOptions): Promise<ProduceResponse>;
+    /**
+     *  `loams.stream.v1.StreamService/ProduceCloudEvents`, retried: manual.
+     */
+    produceEvents(request: MessageInitShape<typeof ProduceCloudEventsRequestSchema>, options?: CallOptions): Promise<ProduceCloudEventsResponse>;
+}
 /**
  *  A second facade name for the same RPCs, exposed as `loams.tables`.
  *
@@ -381,6 +629,23 @@ export interface TablesModule {
      */
     query(request: MessageInitShape<typeof QueryRequestSchema>, options?: CallOptions): Promise<QueryResponse>;
 }
+/**
+ *  A second facade name for the same RPCs, exposed as `loams.vector`.
+ *
+ *  Wraps `loams.collection.v1.QueryService`.
+ */
+export interface VectorModule {
+    /** The SDK module, as it appears on `loams.vector`. */
+    readonly module: 'vector';
+    /** The service behind the module. */
+    readonly service: 'loams.collection.v1.QueryService';
+    /** Whether the package's wire contract may still change. */
+    readonly unstable: false;
+    /**
+     *  `loams.collection.v1.QueryService/Search`, retried: safe.
+     */
+    search(request: MessageInitShape<typeof SearchRequestSchema>, options?: CallOptions): Promise<SearchResponse>;
+}
 /** One facade call, as the runtime dispatches it. */
 export interface CallBinding {
     /** The module the call is exposed on. */
@@ -424,13 +689,13 @@ export declare const MODULES: readonly ModuleBinding[];
 */
 export declare const SERVICE_DESCRIPTORS: Readonly<Record<string, DescService>>;
 /** The proto packages this SDK speaks, as `GetInstance.api_versions` names them. */
-export declare const PROTO_PACKAGES: readonly ["google.protobuf", "loams.admin.v1", "loams.approvals.v1", "loams.auth.v1", "loams.collection.v1", "loams.devices.v1", "loams.errors.v1", "loams.graph.v1", "loams.house.v1", "loams.instance.v1", "loams.live.v1", "loams.live.worker.v1", "loams.notifications.v1", "loams.operations.v1", "loams.options.v1", "loams.postgres.v1", "loams.repos.v1"];
+export declare const PROTO_PACKAGES: readonly ["google.protobuf", "loams.admin.v1", "loams.approvals.v1", "loams.auth.v1", "loams.collection.v1", "loams.devices.v1", "loams.errors.v1", "loams.graph.v1", "loams.house.v1", "loams.instance.v1", "loams.live.v1", "loams.live.worker.v1", "loams.memory.v1", "loams.notifications.v1", "loams.operations.v1", "loams.options.v1", "loams.postgres.v1", "loams.repos.v1", "loams.sql.v1", "loams.stream.v1"];
 /**
 *  Every `reason` in `docs/api/reasons.md` (design §44 §7.4, D611). Within
 *  an API major version a reason is never renamed and never removed, so
 *  this union only grows; a caller switching on it is exhaustive.
 */
-export declare const REASONS: readonly ["approval_expired", "approval_already_decided", "approval_stale_revision", "requester_cannot_approve", "decision_proof_invalid", "step_up_required", "reason_required", "invalid_decision", "pairing_expired", "pairing_used", "device_revoked", "push_target_unknown", "not_implemented", "feature_not_in_variant", "house_not_configured", "house_syntax_error", "house_unknown_table", "house_unknown_database", "house_access_denied", "house_read_only", "house_timeout", "house_memory_limit", "house_too_many_queries", "house_quota_exceeded", "house_disabled_function", "house_cancelled", "house_query_not_found", "house_query_failed", "project_not_found", "branch_has_children", "branch_protected", "lsn_out_of_retention", "endpoint_exists_for_branch", "compute_start_failed", "quota_exceeded", "storage_unavailable", "secret_already_issued", "repo_not_found", "repo_already_exists", "repo_deleting", "ref_stale", "ref_protected", "out_of_scope", "object_format_unsupported", "fork_too_deep", "sequencer_unavailable", "idempotency_key_reused", "workspace_not_found", "workspace_fenced", "workspace_read_only", "workspace_name_taken", "object_missing", "secret_detected", "env_unsealed", "env_access_denied", "env_foreign_reference", "live_bad_cursor", "live_worker_crashed", "live_deploy_conflict", "live_schema_violation", "live_index_not_ready", "live_app_disabled", "live_app_exists", "live_function_error", "live_function_timeout", "live_function_out_of_memory", "live_limit_exceeded", "live_app_mismatch", "live_origin_not_allowed", "session_rotate", "session_gone", "node_draining", "role_required", "setup_required", "token_missing", "token_malformed", "token_revoked", "token_not_yet_valid", "token_bad_signature", "token_wrong_audience", "token_wrong_issuer", "token_unknown_key", "token_algorithm_not_allowed", "api_key_invalid", "credential_not_accepted", "credential_in_query_string", "csrf_token_invalid", "principal_not_allowed", "cors_origin_not_allowed", "auth_unavailable", "invalid_argument", "not_found", "already_exists", "permission_denied", "token_expired", "unauthenticated", "failed_precondition", "resource_exhausted", "unavailable", "deadline_exceeded", "aborted", "internal"];
+export declare const REASONS: readonly ["approval_expired", "approval_already_decided", "approval_stale_revision", "requester_cannot_approve", "decision_proof_invalid", "step_up_required", "reason_required", "invalid_decision", "pairing_expired", "pairing_used", "device_revoked", "push_target_unknown", "not_implemented", "feature_not_in_variant", "house_not_configured", "house_syntax_error", "house_unknown_table", "house_unknown_database", "house_access_denied", "house_read_only", "house_timeout", "house_memory_limit", "house_too_many_queries", "house_quota_exceeded", "house_disabled_function", "house_cancelled", "house_query_not_found", "house_query_failed", "project_not_found", "branch_has_children", "branch_protected", "lsn_out_of_retention", "endpoint_exists_for_branch", "compute_start_failed", "quota_exceeded", "storage_unavailable", "secret_already_issued", "repo_not_found", "repo_already_exists", "repo_deleting", "ref_stale", "ref_protected", "out_of_scope", "object_format_unsupported", "fork_too_deep", "sequencer_unavailable", "idempotency_key_reused", "workspace_not_found", "workspace_fenced", "batch_partially_applied", "workspace_read_only", "workspace_name_taken", "object_missing", "secret_detected", "env_unsealed", "env_access_denied", "env_foreign_reference", "memory_store_not_found", "memory_space_not_found", "memory_space_limit", "memory_managed_object", "memory_block_version_mismatch", "memory_block_too_large", "memory_core_budget_exceeded", "memory_content_too_large", "memory_secret_detected", "memory_pii_refused", "memory_model_not_configured", "memory_model_not_local", "memory_token_budget_exhausted", "memory_extraction_failed", "memory_too_many_spaces", "memory_cross_space_write", "memory_not_yet_available", "code_repo_not_indexed", "code_index_building", "code_change_too_large", "code_language_unsupported", "code_scip_invalid", "live_bad_cursor", "live_worker_crashed", "live_deploy_conflict", "live_schema_violation", "filter_conflict", "search_after_needs_tiebreak", "invalid_consistency_token", "namespace_required", "sql_param_count", "live_index_not_ready", "live_app_disabled", "live_app_exists", "live_function_error", "live_function_timeout", "client_deadline_exceeded", "live_function_out_of_memory", "live_limit_exceeded", "result_too_large", "live_app_mismatch", "live_origin_not_allowed", "session_rotate", "session_gone", "node_draining", "role_required", "setup_required", "token_missing", "token_malformed", "token_revoked", "token_not_yet_valid", "token_bad_signature", "token_wrong_audience", "token_wrong_issuer", "token_unknown_key", "token_algorithm_not_allowed", "api_key_invalid", "credential_not_accepted", "credential_in_query_string", "csrf_token_invalid", "principal_not_allowed", "cors_origin_not_allowed", "auth_unavailable", "invalid_argument", "not_found", "already_exists", "permission_denied", "token_expired", "unauthenticated", "failed_precondition", "resource_exhausted", "unavailable", "deadline_exceeded", "aborted", "internal"];
 /** A stable, machine-readable cause of a failed RPC. */
 export type Reason = (typeof REASONS)[number];
 /** The Connect code each reason is raised under, from the same registry. */