@tangle-network/agent-knowledge 20.0.1 → 21.0.0

package/dist/index.js

@@ -1,5 +1,6 @@
-import { $ as assertGradeableEvidence, $n as removeDurable, $t as KnowledgeIndexSchema, A as createKnowledgeVisibilitySnapshot, An as isKnowledgeMutationHeld, At as auditKnowledgeCitations, B as snapshotImmutableVisibility, Bn as knowledgeFileTransactionPlanHash, Bt as isScaffoldPath, C as createRunScopedStores, Cn as mergeTrackedClaims, Ct as KnowledgeCitationAuditError, D as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, Dn as parseFrontmatter, Dt as assertKnowledgeCitationsResolved, E as originatedPages, En as formatFrontmatter, Et as assertKnowledgeCitationAudit, F as knowledgePageDigest, Fn as withKnowledgeRead, Ft as resolveRunScopedCitation, G as visibilityIndexOf, Gn as canonicalPathsEqual, Gt as WIKILINK_REGEX, H as validateOrigin, Hn as rollbackKnowledgeFileTransaction, Ht as layoutFor, I as knowledgeVisibilityArtifactRef, In as applyKnowledgeFileTransaction, It as resolveRunScopedCitations, J as validateKnowledgeIndex, Jn as isMissingFile, Jt as DeepQuestionSchema, K as detectNearDuplicatePages, Kn as canonicalRelativeWithinRoot, Kt as extractWikilinks, L as nonEmpty$1, Ln as assertKnowledgeMutationPath, Lt as SCAFFOLD_PAGE_BASENAMES, M as digest, Mn as recoverPendingKnowledgeMutation, Mt as parseKnowledgeCitationReference, N as encodeKnowledgeVisibilitySnapshot, Nn as runInKnowledgeMutationScope, Nt as resolveKnowledgeCitation, O as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, On as acquireDurableFileLock, Ot as assertRunScopedCitationsResolved, P as immutablePageDigest, Pn as withKnowledgeMutation, Pt as resolveKnowledgeCitations, Q as UncheckableClaimError, Qn as relativeWithinRoot, Qt as KnowledgeGraphNodeSchema, R as normalizeVisibilityArtifact, Rn as commitKnowledgeFileMutations, Rt as initKnowledgeBase, S as createFileRunLineageAuthority, Sn as mergeClaimLedgers, St as knowledgePageRelations, T as loadKnowledgeToolChain, Tn as researchSourceVersionKey, Tt as assertCurrentRunCitationsResolved, U as verifyKnowledgeVisibilitySnapshot, Un as DEFAULT_PAGES_DIRECTORY, Ut as loadKnowledgePages, V as validateKnowledgePage, Vn as prepareKnowledgeFileTransaction, Vt as knowledgePageFromMarkdown, W as visibilityIdentity, Wn as normalizePagesDirectory, Wt as writeJson, X as CHECKABLE_RUNG_THRESHOLD, Xn as readRegularFileNoFollow, Xt as KnowledgeEventSchema, Y as lintKnowledgeIndex, Yn as listRegularFilesWithinRoot, Yt as KnowledgeBaseCandidateSchema, Z as DEADLINE_EXIT_CODE, Zn as readRegularFileWithinRoot, Zt as KnowledgeGraphEdgeSchema, _ as isSafeKnowledgePath, _n as claimSourceHost, _t as KB_INDEX_PATH, a as searchKnowledge, an as ResearchClaimRecordSchema, ar as writeFileDurableWithinRoot, at as buildKnowledgeIndex, b as assertKnowledgeWriteIntake, bn as linkClaimContradictions, bt as assertClaimLedgerId, c as scoreBm25, cn as SourceRecordSchema, cr as mediaTypeFor, ct as addSourceText, d as DEFAULT_FIELD_BOOSTS, dn as assertDeepQuestionIntegrity, dt as sourceRegistryPath, en as KnowledgePageInvalidationSchema, er as renameDurable, et as claimCheckKey, f as assembleLexicalIndex, fn as assertResearchClaimEvidenceIntegrity, ft as writeSourceRegistry, g as applyKnowledgeWriteBlocksFile, gn as claimId, gt as KB_EVENTS_PATH, h as applyKnowledgeWriteBlocks, hn as claimEvidenceId, ht as KB_CLAIM_LEDGER_DIR, i as reciprocalRankFusion, in as ResearchClaimLedgerSchema, ir as writeFileDurable, it as verifyGradeableEvidence, j as decodeKnowledgeVisibilitySnapshot, jn as measureKnowledgeMutation, jt as formatKnowledgeCitationReference, k as assertSchemaVersion, kn as inspectPendingKnowledgeMutation, kt as auditCurrentRunCitations, l as tokenizeQuery, ln as KNOWLEDGE_EVENT_TYPES, lr as textSourceAdapter, lt as loadSourceRegistry, m as stringMetadata, mn as assertTrackedClaimIntegrity, mt as FileSystemKbStore, n as inspectKnowledgeIndex, nn as KnowledgeRelationSchema, nr as withSafeDescendant, nt as gradeFor, o as searchKnowledgePages, on as ResearchSourceVersionSchema, or as writeJsonDurable, ot as writeKnowledgeIndex, p as lexicalPageTerms, pn as assertResearchClaimLedgerIntegrity, pt as ClaimLedgerMigrationRequiredError, q as normalizePageText, qn as isKernelAnchoredPath, qt as normalizeLinkTarget, r as KNOWLEDGE_SEARCH_RETRIEVER_ID, rn as ResearchClaimEvidenceSchema, rr as withSafeDirectory, rt as verdictFor, s as buildKnowledgeLexicalIndex, sn as SourceAnchorSchema, sr as writeJsonDurableWithinRoot, st as addSourcePath, t as explainKnowledgeTarget, tn as KnowledgePageSchema, tr as syncDirectory, tt as gradeClaims, u as tokenizeText, un as ClaimLedgerGoalConflictError, ut as snapshotSourceTextInput, v as parseKnowledgeWriteBlocks, vn as deepQuestionId, vt as KB_STORE_DIR, w as isKnowledgeToolChain, wn as normalizeClaimText, wt as KnowledgeCitationResolutionError, x as RUN_LINEAGE_BASENAME, xn as materializeRegisteredClaimEvidence, xt as buildKnowledgeGraph, y as KnowledgeDuplicateIntakeError, yn as emptyClaimLedger, yt as MemoryKbStore, z as normalizeVisibilityRef, zn as finishKnowledgeFileTransaction, zt as isKnowledgePagePath } from "./inspect-CMigdsD5.js";
+import { $ as snapshotSourceTextInput, $t as ClaimLedgerGoalConflictError, A as validateKnowledgePage, An as prepareKnowledgeFileTransaction, At as knowledgePageFromMarkdown, B as DEADLINE_EXIT_CODE, Bn as readRegularFileWithinRoot, Bt as KnowledgeGraphEdgeSchema, C as immutablePageDigest, Cn as withKnowledgeMutation, Ct as resolveKnowledgeCitations, D as normalizeVisibilityArtifact, Dn as commitKnowledgeFileMutations, Dt as initKnowledgeBase, E as nonEmpty$1, En as assertKnowledgeMutationPath, Et as SCAFFOLD_PAGE_BASENAMES, F as detectNearDuplicatePages, Fn as canonicalRelativeWithinRoot, Ft as extractWikilinks, G as gradeFor, Gn as withSafeDescendant, Gt as KnowledgeRelationSchema, H as assertGradeableEvidence, Hn as removeDurable, Ht as KnowledgeIndexSchema, I as normalizePageText, In as isKernelAnchoredPath, It as normalizeLinkTarget, J as buildKnowledgeIndex, Jn as writeFileDurableWithinRoot, Jt as ResearchClaimRecordSchema, K as verdictFor, Kn as withSafeDirectory, Kt as ResearchClaimEvidenceSchema, L as validateKnowledgeIndex, Ln as isMissingFile, Lt as DeepQuestionSchema, M as verifyKnowledgeVisibilitySnapshot, Mn as DEFAULT_PAGES_DIRECTORY, Mt as loadKnowledgePages, N as visibilityIdentity, Nn as normalizePagesDirectory, Nt as writeJson, O as normalizeVisibilityRef, On as finishKnowledgeFileTransaction, Ot as isKnowledgePagePath, P as visibilityIndexOf, Pn as canonicalPathsEqual, Pt as WIKILINK_REGEX, Q as loadSourceRegistry, Qn as textSourceAdapter, Qt as KNOWLEDGE_EVENT_TYPES, R as lintKnowledgeIndex, Rn as listRegularFilesWithinRoot, Rt as KnowledgeBaseCandidateSchema, S as encodeKnowledgeVisibilitySnapshot, Sn as runInKnowledgeMutationScope, St as resolveKnowledgeCitation, T as knowledgeVisibilityArtifactRef, Tn as applyKnowledgeFileTransaction, Tt as resolveRunScopedCitations, U as claimCheckKey, Un as renameDurable, Ut as KnowledgePageInvalidationSchema, V as UncheckableClaimError, Vn as relativeWithinRoot, Vt as KnowledgeGraphNodeSchema, W as gradeClaims, Wn as syncDirectory, Wt as KnowledgePageSchema, X as addSourcePath, Xn as writeJsonDurableWithinRoot, Xt as SourceAnchorSchema, Y as writeKnowledgeIndex, Yn as writeJsonDurable, Yt as ResearchSourceVersionSchema, Z as addSourceText, Zn as mediaTypeFor, Zt as SourceRecordSchema, _ as KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, _n as acquireDurableFileLock, _t as assertRunScopedCitationsResolved, a as applyKnowledgeWriteBlocksFile, an as claimId, at as KB_EVENTS_PATH, b as decodeKnowledgeVisibilitySnapshot, bn as measureKnowledgeMutation, bt as formatKnowledgeCitationReference, c as KnowledgeDuplicateIntakeError, cn as emptyClaimLedger, ct as MemoryKbStore, d as createFileRunLineageAuthority, dn as mergeClaimLedgers, dt as knowledgePageRelations, en as assertDeepQuestionIntegrity, et as sourceRegistryPath, f as createRunScopedStores, fn as mergeTrackedClaims, ft as KnowledgeCitationAuditError, g as KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, gn as parseFrontmatter, gt as assertKnowledgeCitationsResolved, h as originatedPages, hn as formatFrontmatter, ht as assertKnowledgeCitationAudit, i as applyKnowledgeWriteBlocks, in as claimEvidenceId, it as KB_CLAIM_LEDGER_DIR, j as validateOrigin, jn as rollbackKnowledgeFileTransaction, jt as layoutFor, k as snapshotImmutableVisibility, kn as knowledgeFileTransactionPlanHash, kt as isScaffoldPath, l as assertKnowledgeWriteIntake, ln as linkClaimContradictions, lt as assertClaimLedgerId, m as loadKnowledgeToolChain, mn as researchSourceVersionKey, mt as assertCurrentRunCitationsResolved, n as inspectKnowledgeIndex, nn as assertResearchClaimLedgerIntegrity, nt as ClaimLedgerMigrationRequiredError, o as isSafeKnowledgePath, on as claimSourceHost, ot as KB_INDEX_PATH, p as isKnowledgeToolChain, pn as normalizeClaimText, pt as KnowledgeCitationResolutionError, q as verifyGradeableEvidence, qn as writeFileDurable, qt as ResearchClaimLedgerSchema, r as stringMetadata, rn as assertTrackedClaimIntegrity, rt as FileSystemKbStore, s as parseKnowledgeWriteBlocks, sn as deepQuestionId, st as KB_STORE_DIR, t as explainKnowledgeTarget, tn as assertResearchClaimEvidenceIntegrity, tt as writeSourceRegistry, u as RUN_LINEAGE_BASENAME, un as materializeRegisteredClaimEvidence, ut as buildKnowledgeGraph, v as assertSchemaVersion, vn as inspectPendingKnowledgeMutation, vt as auditCurrentRunCitations, w as knowledgePageDigest, wn as withKnowledgeRead, wt as resolveRunScopedCitation, x as digest, xn as recoverPendingKnowledgeMutation, xt as parseKnowledgeCitationReference, y as createKnowledgeVisibilitySnapshot, yn as isKnowledgeMutationHeld, yt as auditKnowledgeCitations, z as CHECKABLE_RUNG_THRESHOLD, zn as readRegularFileNoFollow, zt as KnowledgeEventSchema } from "./inspect-DXN6SE2o.js";
 import { i as textSourceId, n as slugify, r as stableId, t as sha256 } from "./ids-Bevz_pXV.js";
+import { a as buildKnowledgeLexicalIndex, c as tokenizeText, d as lexicalPageTerms, i as searchKnowledgePages, l as DEFAULT_FIELD_BOOSTS, n as reciprocalRankFusion, o as scoreBm25, r as searchKnowledge, s as tokenizeQuery, t as KNOWLEDGE_SEARCH_RETRIEVER_ID, u as assembleLexicalIndex } from "./search-BBr5eUyT.js";
 import { n as memoryWriteResultToSourceRecord, t as memoryHitToSourceRecord } from "./source-record-CdWvzvO6.js";
 import { n as createNoopMemoryBenchmarkAdapter, t as createInMemoryBenchmarkAdapter } from "./benchmarks-jir3ZP-M.js";
 import { A as resetRetrievalHoldoutRegistry, C as forkAgentMemoryBranchSnapshot, D as applySessionStickyRetrievalHoldout, E as applyRetrievalHoldout, M as toOffPolicyTrajectory, O as deterministicRng, S as createAgentMemoryBranch, T as renderMemoryContext, _ as resolveMemoryCleanupTimeoutMs, a as HindsightOperationUnknownError, b as createGraphitiMemoryAdapter, c as AgentMemoryHitSchema, d as AgentMemoryWriteInputSchema, f as AgentMemoryLifecycleTimeoutError, g as memoryRecoveryDelayMs, h as createMemoryExecutionPool, i as mem0MemoryAdapterIdentity, j as retrievalHoldoutConfigHash, k as emitRetrievalHoldoutBypass, l as AgentMemoryKindSchema, m as DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, n as createNeo4jAgentMemoryAdapter, o as createHindsightMemoryAdapter, p as AgentMemoryLifecycleUnsafeError, r as createMem0MemoryAdapter, s as hindsightMemoryBankId, t as createPlayMemoryTools, u as AgentMemoryScopeSchema, v as runBoundedMemoryLifecycle, w as defaultGetMemoryContext, x as graphitiMemoryAdapterIdentity, y as sleepForMemoryRecovery } from "./memory-BH6oT1Qe.js";
@@ -25,7 +26,11 @@ function normalizeKnowledgeStateScope(scope = {}) {
 		researchState: parsed.researchState ?? false
 	};
 }
-const KNOWLEDGE_RESEARCH_STATE_PATHS = [".agent-knowledge/claim-ledgers", ".agent-knowledge/events.json"];
+const KNOWLEDGE_RESEARCH_STATE_PATHS = [
+	".agent-knowledge/claim-ledgers",
+	".agent-knowledge/events.json",
+	".agent-knowledge/event-log"
+];
 //#endregion
 //#region src/kb-improvement/contracts.ts
 const digestSchema = z.string().regex(/^[a-f0-9]{64}$/);
@@ -3751,6 +3756,240 @@ function hitFromSearchResult(result) {
 	};
 }
 //#endregion
+//#region src/hub-vector-search-provider.ts
+/** A hub exec or upstream-provider failure, carrying the hub's status/code. */
+var HubVectorSearchError = class extends Error {
+	status;
+	code;
+	constructor(message, status, code) {
+		super(message);
+		this.status = status;
+		this.code = code;
+		this.name = "HubVectorSearchError";
+	}
+};
+const vectorSchema = z.array(z.number().finite()).min(1).max(2e4);
+const searchOptionsSchema = z.object({
+	limit: z.number().int().min(1).max(50).optional(),
+	vector: vectorSchema.optional(),
+	filter: z.record(z.string(), z.unknown()).optional()
+}).strict();
+const queryTextSchema = z.string().trim().min(1).max(16e3);
+const providerKindSchema = z.enum([
+	"pinecone",
+	"qdrant",
+	"weaviate"
+]);
+const graphQlNameSchema = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const pineconeResultSchema = z.object({ matches: z.array(z.object({
+	id: z.union([z.string(), z.number()]),
+	score: z.number().optional(),
+	metadata: z.record(z.string(), z.unknown()).optional()
+}).passthrough()).default([]) }).passthrough();
+const qdrantResultSchema = z.object({ result: z.array(z.object({
+	id: z.union([z.string(), z.number()]),
+	score: z.number().optional(),
+	payload: z.record(z.string(), z.unknown()).optional()
+}).passthrough()).default([]) }).passthrough();
+const weaviateResultSchema = z.object({
+	data: z.object({ Get: z.record(z.string(), z.array(z.record(z.string(), z.unknown()))).optional() }).passthrough(),
+	errors: z.array(z.unknown()).optional()
+}).passthrough();
+/** Keys commonly carrying human-readable text in vector payloads. */
+const TEXT_KEYS = [
+	"text",
+	"content",
+	"chunk",
+	"body",
+	"snippet",
+	"pageContent",
+	"summary"
+];
+const TITLE_KEYS = [
+	"title",
+	"name",
+	"heading"
+];
+const SNIPPET_MAX_CHARS = 400;
+/** Provider payloads arrive JSON-parsed; the round-trip narrows `unknown` to
+* JSON values for RetrievedKnowledgeHit.metadata without re-validating shape. */
+function jsonSafe(value) {
+	if (!value) return void 0;
+	return JSON.parse(JSON.stringify(value));
+}
+function textFromRecord(record) {
+	if (!record) return void 0;
+	for (const key of TEXT_KEYS) {
+		const value = record[key];
+		if (typeof value === "string" && value.trim()) return value;
+	}
+}
+function titleFromRecord(record) {
+	if (!record) return void 0;
+	for (const key of TITLE_KEYS) {
+		const value = record[key];
+		if (typeof value === "string" && value.trim()) return value;
+	}
+}
+function snippetFromRecord(record) {
+	const text = textFromRecord(record);
+	if (text) return text.length > SNIPPET_MAX_CHARS ? `${text.slice(0, SNIPPET_MAX_CHARS)}…` : text;
+	if (!record || Object.keys(record).length === 0) return void 0;
+	const serialized = JSON.stringify(record);
+	return serialized.length > SNIPPET_MAX_CHARS ? `${serialized.slice(0, SNIPPET_MAX_CHARS)}…` : serialized;
+}
+/** One hub exec call: bearer-authenticated, envelope-checked, result-unwrapped. */
+async function hubExec(options, path, input) {
+	const fetchImpl = options.fetchImpl ?? fetch;
+	let origin;
+	try {
+		origin = new URL(options.hubUrl).origin;
+	} catch {
+		throw new HubVectorSearchError(`invalid hubUrl: ${options.hubUrl}`, 0, "INVALID_HUB_URL");
+	}
+	let response;
+	try {
+		response = await fetchImpl(`${origin}/v1/hub/exec`, {
+			method: "POST",
+			headers: {
+				authorization: `Bearer ${options.apiKey}`,
+				"content-type": "application/json",
+				accept: "application/json"
+			},
+			body: JSON.stringify({
+				path,
+				input,
+				connectionId: options.connectionId
+			})
+		});
+	} catch (error) {
+		throw new HubVectorSearchError(`hub exec request failed: ${error instanceof Error ? error.message : String(error)}`, 0, "HUB_UNREACHABLE");
+	}
+	const text = await response.text();
+	let parsed = null;
+	if (text) try {
+		parsed = JSON.parse(text);
+	} catch {}
+	if (!response.ok || parsed?.success === false) {
+		const errorBody = parsed?.error;
+		const code = errorBody && typeof errorBody === "object" && "code" in errorBody ? String(errorBody.code) : void 0;
+		throw new HubVectorSearchError((errorBody && typeof errorBody === "object" && "message" in errorBody ? String(errorBody.message) : typeof errorBody === "string" ? errorBody : void 0) ?? `hub exec failed (${response.status})`, response.status, code);
+	}
+	if (!parsed || parsed.data === void 0 || parsed.data.result === void 0) throw new HubVectorSearchError("hub exec response envelope missing `data.result`", response.status, "HUB_INVALID_ENVELOPE");
+	return parsed.data.result;
+}
+var HubVectorSearchProvider = class {
+	provider;
+	connectionId;
+	indexName;
+	options;
+	defaultLimit;
+	hubOrigin;
+	constructor(options) {
+		this.options = options;
+		this.provider = providerKindSchema.parse(options.provider);
+		this.connectionId = z.string().trim().min(1).parse(options.connectionId);
+		this.indexName = z.string().trim().min(1).parse(options.indexName);
+		if (this.provider === "weaviate") {
+			if (!graphQlNameSchema.test(this.indexName)) throw new TypeError("Weaviate class name must be a GraphQL identifier");
+			for (const property of options.properties ?? []) if (!graphQlNameSchema.test(property)) throw new TypeError(`Weaviate property '${property}' must be a GraphQL identifier`);
+		}
+		this.defaultLimit = options.defaultLimit ?? 5;
+		this.hubOrigin = new URL(options.hubUrl).origin;
+	}
+	/** The provenance record a retrieval receipt should carry. */
+	get provenance() {
+		return {
+			provider: this.provider,
+			connectionId: this.connectionId,
+			indexName: this.indexName,
+			hubOrigin: this.hubOrigin,
+			action: this.searchAction()
+		};
+	}
+	async search(query, searchOptions = {}) {
+		const text = queryTextSchema.parse(query);
+		const options = searchOptionsSchema.parse(searchOptions);
+		const vector = vectorSchema.parse(options.vector ?? await this.options.embed(text));
+		const limit = options.limit ?? this.defaultLimit;
+		const raw = await this.searchRaw(vector, limit, options.filter);
+		return this.hitsFromRaw(raw, limit);
+	}
+	/** Alias kept for parity with `FileSystemSearchProvider.retrieve`. */
+	async retrieve(query, options = {}) {
+		return this.search(query, options);
+	}
+	asRetrievalEvalRetriever() {
+		return async ({ scenario, k }) => ({ hits: await this.search(scenario.query, { limit: k }) });
+	}
+	searchAction() {
+		if (this.provider === "pinecone") return "vectors.query";
+		if (this.provider === "qdrant") return "points.search";
+		return "graphql.query";
+	}
+	async searchRaw(vector, limit, filter) {
+		if (this.provider === "pinecone") return pineconeResultSchema.parse(await hubExec(this.options, "pinecone.vectors.query", {
+			vector: [...vector],
+			top_k: limit,
+			include_metadata: true,
+			...this.options.namespace ? { namespace: this.options.namespace } : {},
+			...filter ? { filter } : {}
+		})).matches.map((match) => ({
+			id: String(match.id),
+			score: match.score,
+			record: match.metadata
+		}));
+		if (this.provider === "qdrant") return qdrantResultSchema.parse(await hubExec(this.options, "qdrant.points.search", {
+			collection_name: this.indexName,
+			vector: [...vector],
+			limit,
+			with_payload: true,
+			...filter ? { filter } : {}
+		})).result.map((point) => ({
+			id: String(point.id),
+			score: point.score,
+			record: point.payload
+		}));
+		const propertyFields = (this.options.properties ?? []).map((property) => ` ${property}`).join("");
+		const graphQl = `{ Get { ${this.indexName}(nearVector: {vector: ${JSON.stringify([...vector])}}, limit: ${limit}) { _additional { id distance }${propertyFields} } } }`;
+		const result = weaviateResultSchema.parse(await hubExec(this.options, "weaviate.graphql.query", { query: graphQl }));
+		if (result.errors && result.errors.length > 0) throw new HubVectorSearchError(`weaviate graphql errors: ${JSON.stringify(result.errors).slice(0, SNIPPET_MAX_CHARS)}`, 200, "PROVIDER_GRAPHQL_ERROR");
+		return (result.data.Get?.[this.indexName] ?? []).map((object) => {
+			const additional = object._additional ?? {};
+			const distance = additional.distance;
+			return {
+				id: String(additional.id ?? ""),
+				score: typeof distance === "number" && Number.isFinite(distance) ? 1 / (1 + Math.max(0, distance)) : void 0,
+				record: Object.fromEntries(Object.entries(object).filter(([key]) => key !== "_additional"))
+			};
+		});
+	}
+	hitsFromRaw(raw, limit) {
+		const topScore = raw.reduce((top, hit) => hit.score !== void 0 && hit.score > top ? hit.score : top, 0);
+		return raw.slice(0, limit).map((hit, index) => ({
+			pageId: hit.id,
+			path: `${this.provider}://${this.indexName}/${hit.id}`,
+			...titleFromRecord(hit.record) !== void 0 ? { title: titleFromRecord(hit.record) } : {},
+			rank: index + 1,
+			...hit.score !== void 0 ? { score: hit.score } : {},
+			...topScore > 0 && hit.score !== void 0 ? { normalizedScore: Math.min(1, Math.max(0, hit.score / topScore)) } : {},
+			...snippetFromRecord(hit.record) !== void 0 ? { snippet: snippetFromRecord(hit.record) } : {},
+			metadata: {
+				provider: this.provider,
+				connectionId: this.connectionId,
+				indexName: this.indexName,
+				hubOrigin: this.hubOrigin,
+				action: this.searchAction(),
+				retrievedAt: (/* @__PURE__ */ new Date()).toISOString(),
+				...hit.record ? { payload: jsonSafe(hit.record) } : {}
+			}
+		}));
+	}
+};
+function createHubVectorSearchProvider(options) {
+	return new HubVectorSearchProvider(options);
+}
+//#endregion
 //#region src/knowledge-brief.ts
 /**
 * Retrieval briefing.
@@ -5237,6 +5476,6 @@ function knowledgeReleaseReport(input) {
 	};
 }
 //#endregion
-export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, CHECKABLE_RUNG_THRESHOLD, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEADLINE_EXIT_CODE, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DeepQuestionSchema, FileSystemKbStore, FileSystemSearchProvider, HindsightOperationUnknownError, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KnowledgeBaseCandidateSchema, KnowledgeCitationAuditError, KnowledgeCitationResolutionError, KnowledgeDuplicateIntakeError, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePromotionError, KnowledgeProposalParseError, KnowledgeRelationSchema, KnowledgeVisibilityUnavailableError, MemoryKbStore, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, UncheckableClaimError, WIKILINK_REGEX, addSourcePath, addSourceText, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildEvalKnowledgeBundle, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildRetrievalEvalDispatch, canonicalPathsEqual, canonicalRelativeWithinRoot, chunkMarkdown, claimCheckKey, claimEvidenceId, claimId, claimSourceHost, createAgentMemoryBranch, createFileRunLineageAuthority, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createHindsightMemoryAdapter, createInMemoryBenchmarkAdapter, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPlayMemoryTools, createQmdKnowledgeTools, createQmdSearchProvider, createRunScopedStores, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractWikilinks, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, fromAgentCandidateKnowledgeRef, gradeClaims, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, hindsightMemoryBankId, improveKnowledgeBase, initKnowledgeBase, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, isKernelAnchoredPath, isKnowledgeMutationHeld, isKnowledgePagePath, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, linkClaimContradictions, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, originatedPages, parseFrontmatter, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, runKnowledgeResearchLoop, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceRegistryPath, stableId, stripFrontmatter, syncDirectory, textSourceAdapter, textSourceId, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
+export { AgentMemoryHitSchema, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, AgentMemoryScopeSchema, AgentMemoryWriteInputSchema, CHECKABLE_RUNG_THRESHOLD, ClaimLedgerGoalConflictError, ClaimLedgerMigrationRequiredError, DEADLINE_EXIT_CODE, DEFAULT_KNOWLEDGE_BRIEF_LIMIT, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, DEFAULT_PAGES_DIRECTORY, DeepQuestionSchema, FileSystemKbStore, FileSystemSearchProvider, HindsightOperationUnknownError, HubVectorSearchError, HubVectorSearchProvider, KB_CLAIM_LEDGER_DIR, KB_EVENTS_PATH, KB_INDEX_PATH, KB_STORE_DIR, KNOWLEDGE_EVENT_TYPES, KNOWLEDGE_PROMOTIONS_DIRECTORY, KNOWLEDGE_PROMOTION_DIGEST_ALGORITHM, KNOWLEDGE_PROMOTION_SCHEMA_VERSION, KNOWLEDGE_RECEIPT_DIGEST_ALGORITHM, KNOWLEDGE_SEARCH_RETRIEVER_ID, KNOWLEDGE_USE_RECEIPT_SCHEMA_VERSION, KnowledgeBaseCandidateSchema, KnowledgeCitationAuditError, KnowledgeCitationResolutionError, KnowledgeDuplicateIntakeError, KnowledgeEventSchema, KnowledgeGraphEdgeSchema, KnowledgeGraphNodeSchema, KnowledgeImprovementCandidateRefSchema, KnowledgeImprovementEvidenceSchema, KnowledgeImprovementRunStateSchema, KnowledgeIndexSchema, KnowledgePageInvalidationSchema, KnowledgePageSchema, KnowledgePromotionError, KnowledgeProposalParseError, KnowledgeRelationSchema, KnowledgeVisibilityUnavailableError, MemoryKbStore, READINESS_SPEC_DEFAULTS, RUN_LINEAGE_BASENAME, ResearchClaimEvidenceSchema, ResearchClaimLedgerSchema, ResearchClaimRecordSchema, ResearchSourceVersionSchema, SCAFFOLD_PAGE_BASENAMES, SourceAnchorSchema, SourceRecordSchema, UncheckableClaimError, WIKILINK_REGEX, addSourcePath, addSourceText, applyKnowledgeWriteBlocks, applyKnowledgeWriteBlocksFile, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, assertClaimLedgerId, assertCurrentRunCitationsResolved, assertDeepQuestionIntegrity, assertGradeableEvidence, assertKnowledgeCitationAudit, assertKnowledgeCitationsResolved, assertKnowledgeRetrievalMatchesVisibility, assertKnowledgeRetrievalMatchesVisibilityArtifact, assertKnowledgeWriteIntake, assertResearchClaimEvidenceIntegrity, assertResearchClaimLedgerIntegrity, assertRunScopedCitationsResolved, assertTrackedClaimIntegrity, auditCurrentRunCitations, auditKnowledgeCitations, buildEvalKnowledgeBundle, buildKnowledgeBrief, buildKnowledgeGraph, buildKnowledgeIndex, buildKnowledgeLexicalIndex, buildRetrievalEvalDispatch, canonicalPathsEqual, canonicalRelativeWithinRoot, chunkMarkdown, claimCheckKey, claimEvidenceId, claimId, claimSourceHost, createAgentMemoryBranch, createFileRunLineageAuthority, createFileSystemSearchProvider, createGraphitiMemoryAdapter, createHindsightMemoryAdapter, createHubVectorSearchProvider, createInMemoryBenchmarkAdapter, createKnowledgeControlLoopAdapter, createKnowledgeEvent, createKnowledgeRetrievalDisposition, createKnowledgeRetrievalReceipt, createKnowledgeTools, createKnowledgeUseReceipt, createKnowledgeVisibilitySnapshot, createLocalDiscoveryDispatcher, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, createNoopMemoryBenchmarkAdapter, createPlayMemoryTools, createQmdKnowledgeTools, createQmdSearchProvider, createRunScopedStores, decodeKnowledgeVisibilitySnapshot, deepQuestionId, defaultGetMemoryContext, defineReadinessSpec, detectNearDuplicatePages, deterministicRng, diagnoseRagAnswerFailure, emitRetrievalHoldoutBypass, emptyClaimLedger, encodeKnowledgeVisibilitySnapshot, evaluateKnowledgeBaseReadiness, explainKnowledgeTarget, extractWikilinks, forkAgentMemoryBranchSnapshot, formatFrontmatter, formatKnowledgeCitationReference, fromAgentCandidateKnowledgeRef, gradeClaims, gradeFor, graphitiMemoryAdapterIdentity, groundClaimInText, hashKnowledgeBase, hindsightMemoryBankId, improveKnowledgeBase, initKnowledgeBase, inspectKnowledgeIndex, inspectPendingKnowledgeMutation, isKernelAnchoredPath, isKnowledgeMutationHeld, isKnowledgePagePath, isMissingFile, isSafeKnowledgePath, isScaffoldPath, jsonCandidateCodec, jsonObjectCandidateCodec, knowledgeImprovementCandidateRef, knowledgeImprovementRunDir, knowledgeImprovementRunId, knowledgePageDigest, knowledgePageFromMarkdown, knowledgePageRelations, knowledgeReleaseReport, knowledgeVisibilityArtifactRef, layoutFor, linkClaimContradictions, lintKnowledgeIndex, listRegularFilesWithinRoot, loadKnowledgeImprovementActivationResult, loadKnowledgeImprovementEvents, loadKnowledgeImprovementState, loadKnowledgePages, loadKnowledgePromotionRecord, loadSourceRegistry, materializeRegisteredClaimEvidence, mediaTypeFor, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, mergeClaimLedgers, mergeTrackedClaims, normalizeClaimText, normalizeExternalRagScores, normalizeKnowledgeStateScope, normalizeLinkTarget, normalizePageText, normalizePagesDirectory, originatedPages, parseFrontmatter, parseKnowledgeCitationReference, parseKnowledgeWriteBlocks, partitionRetrievalScenarios, promoteKnowledgeCandidate, promoteRunScopedPages, proposeFromFinding, proposeFromFindings, ragAnswerQualityJudge, readRegularFileNoFollow, readRegularFileWithinRoot, reciprocalRankFusion, recoverPendingKnowledgeMutation, relativeWithinRoot, removeDurable, renameDurable, renderMemoryContext, researchSourceVersionKey, resetRetrievalHoldoutRegistry, resolveKnowledgeCitation, resolveKnowledgeCitations, resolveMemoryCleanupTimeoutMs, resolveRunScopedCitation, resolveRunScopedCitations, restoreKnowledgeCandidateBaseline, retrievalConfigFromSurface, retrievalConfigSurface, retrievalHoldoutConfigHash, retrievalRecallJudge, runBoundedMemoryLifecycle, runDiscoveryLoop, runInKnowledgeMutationScope, runKnowledgeResearchLoop, runRagKnowledgeImprovementLoop, runRagOptimization, runRetrievalImprovementLoop, runSerializedKnowledgeOptimization, scenarioContentFingerprint, scoreBm25, scoreKnowledgeBaseIndex, scoreRagAnswerArtifact, scoreRetrievalArtifact, searchKnowledge, searchKnowledgePages, sha256, sleepForMemoryRecovery, slugify, snapshotSourceTextInput, sourceRegistryPath, stableId, stripFrontmatter, syncDirectory, textSourceAdapter, textSourceId, toAgentCandidateKnowledgeRef, toDeepEvalTestCases, toOffPolicyTrajectory, toRagCheckerRecords, toRagasEvaluationRows, toTruLensRecords, tokenizeQuery, tokenizeText, validateKnowledgeIndex, verdictFor, verifyGradeableEvidence, verifyKnowledgeRetrievalDisposition, verifyKnowledgeRetrievalReceipt, verifyKnowledgeUseReceipt, verifyKnowledgeVisibilitySnapshot, withKnowledgeImprovementCandidate, withKnowledgeImprovementComparison, withKnowledgeMutation, withKnowledgeRead, withSafeDescendant, withSafeDirectory, writeFileDurable, writeFileDurableWithinRoot, writeJson, writeJsonDurable, writeJsonDurableWithinRoot, writeKnowledgeIndex, writeSourceRegistry };
 
 //# sourceMappingURL=index.js.map