@lucern/sdk 0.3.0-alpha.1 → 0.3.0-alpha.11

package/dist/embeddingsClient.d.ts

@@ -0,0 +1,106 @@
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+import { TopicProjectAliasInput } from './boundaryClientSurface.js';
+import { JsonObject, ListResult } from './types.js';
+import './authContext.js';
+import './contracts/auth-session.contract.js';
+import './contracts/workflow-runtime.contract.js';
+import './contracts/lens-workflow.contract.js';
+import './contracts/lens-filter.contract.js';
+
+type EmbeddingsClientConfig = GatewayClientConfig;
+declare const EMBEDDINGS_FIELDS: readonly ["topicId", "projectId", "workspaceId", "nodeIds", "nodeType", "embeddingModel", "queryText", "queryVector", "minScore", "limit", "cursor", "metadata"];
+type EmbeddingProvenance = {
+    sourceNodeId?: string;
+    sourceGlobalId?: string;
+    embeddingModel?: string;
+    embeddedAt?: number;
+    contentHash?: string;
+    metadata?: JsonObject | null;
+};
+type EmbeddingRecord = {
+    nodeId: string;
+    globalId?: string;
+    topicId?: string;
+    workspaceId?: string;
+    nodeType?: string;
+    embeddingModel?: string;
+    vectorDimensions?: number;
+    hasEmbedding?: boolean;
+    provenance?: EmbeddingProvenance;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+};
+type MissingEmbeddingCandidate = {
+    nodeId: string;
+    globalId?: string;
+    topicId?: string;
+    workspaceId?: string;
+    nodeType?: string;
+    embeddingModel?: string;
+    reason?: string;
+    contentHash?: string;
+    metadata?: JsonObject | null;
+};
+type VectorSearchMatch = {
+    nodeId: string;
+    globalId?: string;
+    topicId?: string;
+    workspaceId?: string;
+    nodeType?: string;
+    score: number;
+    text?: string;
+    title?: string;
+    embeddingModel?: string;
+    provenance?: EmbeddingProvenance;
+    metadata?: JsonObject | null;
+};
+type GetEmbeddingsByNodeIdsInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    nodeIds: string[];
+    nodeType?: string;
+    embeddingModel?: string;
+    limit?: number;
+    cursor?: string;
+};
+type ListMissingEmbeddingsInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    nodeType?: string;
+    embeddingModel?: string;
+    limit?: number;
+    cursor?: string;
+};
+type VectorSearchByTopicInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    queryText?: string;
+    queryVector?: number[];
+    nodeType?: string;
+    embeddingModel?: string;
+    minScore?: number;
+    limit?: number;
+    cursor?: string;
+    metadata?: JsonObject;
+};
+type MarkEmbeddingBackfillQueuedInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    nodeIds: string[];
+    nodeType?: string;
+    embeddingModel?: string;
+    metadata?: JsonObject;
+};
+type EmbeddingsLookupResponse = ListResult<EmbeddingRecord, "embeddings">;
+type MissingEmbeddingsResponse = ListResult<MissingEmbeddingCandidate, "nodes">;
+type VectorSearchResponse = ListResult<VectorSearchMatch, "results">;
+declare function createEmbeddingsClient(config?: EmbeddingsClientConfig): {
+    getByNodeIds(input: GetEmbeddingsByNodeIdsInput): Promise<PlatformGatewaySuccess<ListResult<EmbeddingRecord, "embeddings">>>;
+    listMissingForTopic(input: ListMissingEmbeddingsInput): Promise<PlatformGatewaySuccess<ListResult<MissingEmbeddingCandidate, "nodes">>>;
+    vectorSearchByTopic(input: VectorSearchByTopicInput): Promise<PlatformGatewaySuccess<ListResult<VectorSearchMatch, "results">>>;
+    markEmbeddingBackfillQueued(input: MarkEmbeddingBackfillQueuedInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<{
+        queued: number;
+        topicId: string;
+        workspaceId: string;
+        nodeIds: string[];
+    }>>;
+};
+
+export { EMBEDDINGS_FIELDS, type EmbeddingProvenance, type EmbeddingRecord, type EmbeddingsClientConfig, type EmbeddingsLookupResponse, type GetEmbeddingsByNodeIdsInput, type ListMissingEmbeddingsInput, type MarkEmbeddingBackfillQueuedInput, type MissingEmbeddingCandidate, type MissingEmbeddingsResponse, type VectorSearchByTopicInput, type VectorSearchMatch, type VectorSearchResponse, createEmbeddingsClient };