@undefineds.co/xpod 0.3.75 → 0.4.0-rc.140

package/dist/storage/rdf/XpodComunicaQueryEngine.d.ts

@@ -0,0 +1,10 @@
+import { QueryEngine } from '@comunica/query-sparql-solid';
+/**
+ * Creates the public Cloud evaluator with Xpod's QLever-aligned NaN ordering.
+ *
+ * Comunica exposes term comparison through a shared actor bus used by ORDER BY
+ * and MIN/MAX. Its generated engine does not expose that bus on QueryEngine's
+ * public type, so this adapter locates the named actors and fails at startup if
+ * a future Comunica upgrade changes the integration boundary.
+ */
+export declare function createXpodComunicaQueryEngine(): QueryEngine;

package/dist/storage/rdf/XpodComunicaQueryEngine.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createXpodComunicaQueryEngine = createXpodComunicaQueryEngine;
+const query_sparql_solid_1 = require("@comunica/query-sparql-solid");
+const RdfTermSemantics_1 = require("./RdfTermSemantics");
+const ORDER_BY_ACTOR = 'urn:comunica:default:query-operation/actors#orderby';
+const TERM_COMPARATOR_ACTOR = 'urn:comunica:default:term-comparator-factory/actors#expression-evaluator';
+/**
+ * Creates the public Cloud evaluator with Xpod's QLever-aligned NaN ordering.
+ *
+ * Comunica exposes term comparison through a shared actor bus used by ORDER BY
+ * and MIN/MAX. Its generated engine does not expose that bus on QueryEngine's
+ * public type, so this adapter locates the named actors and fails at startup if
+ * a future Comunica upgrade changes the integration boundary.
+ */
+function createXpodComunicaQueryEngine() {
+    const engine = new query_sparql_solid_1.QueryEngine();
+    const init = objectProperty(engine, 'actorInitQuery', 'query init actor');
+    const queryProcess = objectProperty(init, 'mediatorQueryProcess', 'query-process mediator');
+    const processActor = actorWithProperty(queryProcess, 'mediatorQueryOperation', 'query-process actor');
+    const queryOperation = objectProperty(processActor, 'mediatorQueryOperation', 'query-operation mediator');
+    const orderBy = namedActor(queryOperation, ORDER_BY_ACTOR);
+    const termComparator = objectProperty(orderBy, 'mediatorTermComparatorFactory', 'term-comparator mediator');
+    const comparatorActor = namedActor(termComparator, TERM_COMPARATOR_ACTOR);
+    const run = comparatorActor.run;
+    if (typeof run !== 'function') {
+        throw new Error(`Comunica actor ${TERM_COMPARATOR_ACTOR} does not expose run()`);
+    }
+    const originalRun = run.bind(comparatorActor);
+    comparatorActor.run = async (action) => {
+        const comparator = await originalRun(action);
+        return {
+            ...comparator,
+            orderTypes(left, right) {
+                return (0, RdfTermSemantics_1.compareRdfNumericNaNOrder)(left, right) ?? comparator.orderTypes(left, right);
+            },
+        };
+    };
+    return engine;
+}
+function actorWithProperty(mediator, property, label) {
+    const actor = actors(mediator).find((candidate) => property in candidate);
+    if (!actor) {
+        throw new Error(`Comunica ${label} with ${property} was not found`);
+    }
+    return actor;
+}
+function namedActor(mediator, name) {
+    const actor = actors(mediator).find((candidate) => candidate.name === name);
+    if (!actor) {
+        throw new Error(`Comunica actor ${name} was not found`);
+    }
+    return actor;
+}
+function actors(mediator) {
+    const bus = objectProperty(mediator, 'bus', 'actor bus');
+    const value = bus.actors;
+    if (!Array.isArray(value)) {
+        throw new Error('Comunica actor bus does not expose its actors');
+    }
+    return value.map((actor, index) => objectValue(actor, `actor ${index}`));
+}
+function objectProperty(value, property, label) {
+    return objectValue(value[property], label);
+}
+function objectValue(value, label) {
+    if (!value || typeof value !== 'object') {
+        throw new Error(`Comunica ${label} was not found`);
+    }
+    return value;
+}
+//# sourceMappingURL=XpodComunicaQueryEngine.js.map

package/dist/storage/rdf/index.d.ts

@@ -5,7 +5,7 @@ export { Rdf3xIndex } from './Rdf3xIndex';
 export { RDF_TEXT_SCHEMA_VERSION, RdfTextIndex, tokenizeNormalizedRdfText } from './RdfTextIndex';
 export { createRdfEntityTextChunks, createRdfEntityTextChunksFromText, parseRdfTextProjectionQuads, rdfTextIndexPolicyRole, type TextIndexPolicyRole, } from './RdfTextProjection';
 export { PostgresRdfTextIndex, type PostgresRdfTextIndexOptions, type PostgresRdfTextSearchBackend, } from './PostgresRdfTextIndex';
-export { RdfVectorIndex } from './RdfVectorIndex';
+export { RDF_VECTOR_SCHEMA_VERSION, RdfVectorIndex } from './RdfVectorIndex';
 export { PostgresRdfVectorIndex, type PostgresRdfVectorIndexOptions } from './PostgresRdfVectorIndex';
 export { PostgresRdfStatisticsStore } from './PostgresRdfStatisticsStore';
 export type { RdfStatisticsDimensionKind, RdfStatisticsDimensionSnapshot, RdfStatisticsPairKind, RdfStatisticsPairSnapshot, RdfStatisticsPodSnapshot, RdfStatisticsStore, } from './RdfStatisticsStore';
@@ -14,10 +14,11 @@ export { isLineAddressableRdf, isLineAddressableRdfContentType, isLineAddressabl
 export { RdfShadowComparator, canonicalQuadKey, diffQuads } from './RdfShadowComparator';
 export { RdfQueryExecutor, variable as rdfVar } from './RdfQueryExecutor';
 export { applyRdfAccessScope, filterRdfAccessGraphs, isRestrictiveRdfAccessScope, rdfAccessCacheScope, rdfAccessGraphAllowed, type RdfAccessMode, type RdfAccessScope, } from './RdfAccessScope';
-export { ShadowRdfQuintStore, type ShadowRdfQuintStoreOptions } from './ShadowRdfQuintStore';
-export { SolidRdfEngine, type SolidRdfEngineOptions } from './SolidRdfEngine';
+export { SolidRdfEngine, type LocalNativeSparqlClientLike, type SolidRdfEngineOptions, } from './SolidRdfEngine';
+export { LocalQleverNativeSparqlClient, LocalQleverRuntimeError, type LocalQleverNativeSparqlClientOptions, type LocalQleverRuntimeErrorCode, } from './LocalQleverNativeSparqlClient';
+export { QleverSparqlEngine } from './QleverSparqlEngine';
+export { RdfQuerySparqlEngine } from './RdfQuerySparqlEngine';
 export { PostgresRdfEngine, type PostgresRdfEngineOptions, } from './PostgresRdfEngine';
-export { DisabledSparqlFeatureError, NativeSparqlExecutionError, RdfSparqlAdapter, UnsupportedSparqlQueryError, sparqlCorrectionForCapability, type RdfSparqlCompileResult, type RdfSparqlDeleteOperation, type RdfSparqlDeleteWhereOperation, type RdfSparqlDeleteWhereTemplate, type RdfSparqlInsertOperation, type RdfSparqlUpdateDelta, type RdfSparqlUpdateDeltaOperation, type SparqlCorrection, type SparqlCorrectionAction, type SparqlCorrectionTarget, } from './RdfSparqlAdapter';
-export { SolidRdfSparqlEngine, type SolidRdfSparqlEngineOptions, type SolidRdfSparqlFallback, type SolidRdfSparqlFallbackMetric, type SolidRdfSparqlMetricsSnapshot, type SolidRdfSparqlOperation, type SolidRdfSparqlOperationCount, type SolidRdfSparqlPrimaryMetric, } from './SolidRdfSparqlEngine';
+export { DisabledSparqlFeatureError, NativeSparqlExecutionError, NativeSparqlTimeoutError, UnsupportedSparqlQueryError, sparqlCorrectionForCapability, assertServerOwnedNativeSparqlQuery, type SparqlCorrection, type SparqlCorrectionAction, type SparqlCorrectionTarget, } from './RdfSparqlBoundary';
 export { rdfModelsBenchmarkCases, rdfModelsBenchmarkCaseNames, rdfModelsBenchmarkCasesForProfile, rdfModelsExtremeBenchmarkCases, rdfModelsExtremeBenchmarkCaseNames, rdfModelsExtremeQueryBenchmarkCases, rdfModelsExtremeQueryBenchmarkCaseNames, rdfModelsPostgresMaterializedQueryBenchmarkCases, rdfModelsPostgresMaterializedQueryBenchmarkCaseNames, rdfModelsPostgresQueryBenchmarkCases, rdfModelsPostgresQueryBenchmarkCaseNames, rdfModelsPostgresQueryBenchmarkCasesForProfile, rdfModelsQueryBenchmarkCases, rdfModelsQueryBenchmarkCaseNames, rdfModelsQueryBenchmarkCasesForProfile, rdfModelsSearchFusionQueryBenchmarkCases, rdfModelsSearchFusionQueryBenchmarkCaseNames, RDF_MODELS_BENCHMARK_POD, buildRdfModelsBenchmarkSeed, defaultSyntheticMessagesForRdfModelsScale, estimateRdfModelsSyntheticQuadCount, syntheticMessagesForRdfModelsTargetQuads, rdfModelsBenchmarkProfileRequiresSearchFusion, rdfModelsBenchmarkScaleSatisfied, rdfModelsBenchmarkTargetSatisfied, rdfModelsBenchmarkSyntheticPodCount, rdfModelsBenchmarkScaleTargetQuads, rdfModelsSearchFusionBroadSourceCountForScale, runRdfModelsBenchmark, runRdfModelsPostgresBenchmark, runRdfModelsRdf3xShadowBenchmark, runRdfModelsShadowBenchmark, seedRdfModelsSearchFusionIndexes, RDF_MODELS_SYNTHETIC_MESSAGE_QUADS, type RdfBenchmarkCaseProfile, type RdfBenchmarkScale, type RdfModelBenchmarkCase, type RdfModelQueryBenchmarkCase, type RdfModelQueryBenchmarkResult, type RdfModelBenchmarkReport, type RdfModelBenchmarkResult, type RdfModelBenchmarkRunOptions, type RdfModelPostgresConcurrencyGate, type RdfModelPostgresConcurrencyGateCase, type RdfModelPostgresBenchmarkReport, type RdfModelPostgresBenchmarkGateBaseline, type RdfModelPostgresBenchmarkGateCaseThresholds, type RdfModelPostgresBenchmarkGateThresholds, type RdfModelPostgresBenchmarkRunOptions, type RdfModelPostgresColdStartBenchmark, type RdfModelPostgresColdStartQueryBenchmark, type RdfModelPostgresPostWriteRefreshBenchmark, type RdfModelPostgresRefreshBenchmark, type RdfModelPostgresWarmSteadyStateBenchmark, type RdfModelsBenchmarkSeedOptions, type RdfModelShadowBenchmarkReport, type RdfModelRdf3xShadowBenchmarkReport, type RdfModelRdf3xShadowJoinBenchmarkResult, type RdfModelRdf3xShadowBenchmarkResult, type RdfModelShadowBenchmarkResult, type RdfModelShadowBenchmarkRunOptions, type RdfModelShadowBenchmarkSide, } from './models-benchmark';
-export type { RdfEngineLike, RdfEngineColdStartPhaseStats, RdfEngineColdStartStats, RdfEngineLifecycleStats, RdfEngineStorageStats, RdfStorageStatsOptions, RdfDerivedCacheScopeStatsOptions, RdfDerivedIndexMaintenanceResult, RdfDerivedIndexRefreshResult, RdfPlannerStatsRefreshResult, RdfIndexStats, RdfDerivedIndexProfile, RdfPgAccelerationFallbackReason, RdfPgAccelerationProfile, RdfPgAccelerationStats, Rdf3xCardinalityEstimate, Rdf3xCountResult, Rdf3xJoinMetrics, Rdf3xJoinOptions, Rdf3xJoinScanResult, Rdf3xIndexMetrics, Rdf3xIndexStats, Rdf3xObjectOperatorPattern, Rdf3xObjectRangePattern, Rdf3xPairProjectionName, Rdf3xPatternKey, Rdf3xPermutationName, Rdf3xRebuildResult, Rdf3xTermKey, Rdf3xTermInPattern, Rdf3xTermMetadataPattern, Rdf3xTermNotInPattern, Rdf3xTermProjectionName, Rdf3xTermTypePatternValue, Rdf3xIndexOptions, Rdf3xTriplePattern, Rdf3xTripleScanOptions, Rdf3xTripleScanResult, Rdf3xShadowBindingDiff, Rdf3xShadowQuadDiff, Rdf3xShadowJoinResult, Rdf3xShadowScanResult, RdfIndexSpaceObject, RdfIndexMetrics, RdfIndexPutOptions, RdfBoundedPath, RdfBoundedPathEdge, RdfBoundedPathSearchOptions, RdfBoundedPathSearchResult, RdfBindingRow, RdfMaterializedViewBindingSource, RdfMaterializedViewActivationInput, RdfMaterializedViewActivationResult, RdfMaterializedViewBuildInput, RdfMaterializedViewBuildResult, RdfMaterializedViewReadResult, RdfNativeSparqlAccessScope, RdfNativeSparqlQueryOptions, RdfNativeSparqlResult, RdfConstructTemplate, RdfQuadJoinOptions, RdfQuadJoinCountOptions, RdfQuadJoinOrder, RdfQuadJoinPattern, RdfQuadJoinScanResult, RdfQuery, RdfQueryAggregate, RdfQueryMetrics, RdfQueryResult, RdfPatternQuery, RdfQuadIndexOptions, RdfQuadIndexScanResult, RdfQuadRow, RdfQueryOrder, RdfQueryPattern, RdfQueryPatternKey, RdfQueryTermPattern, RdfQueryVariable, RdfPathEdgeDirection, RdfPathSearchDirection, RdfSchemaExplorerOptions, RdfSchemaExplorerResult, RdfSchemaExplorerTermEntry, RdfShadowBackfillOptions, RdfShadowBackfillResult, RdfShadowDiff, RdfShadowScanResult, RdfSourceInput, RdfSourceRow, RdfTextChunkInput, RdfTextChunkRow, RdfTextIndexLike, RdfTextIndexOptions, RdfTextIndexSyncLike, RdfTextIndexStats, RdfTextRebuildStatus, RdfTextRebuildStatusInput, RdfTextRebuildStatusKind, RdfTextSearchOptions, RdfTextSearchPattern, RdfTextSearchResult, RdfTextSourceInput, RdfTextSourceMetadata, RdfTextTermDocumentFrequency, RdfVectorChunkInput, RdfVectorChunkRow, RdfVectorDistanceMetric, RdfVectorIndexLike, RdfVectorIndexOptions, RdfVectorIndexSyncLike, RdfVectorIndexStats, RdfVectorModelDistribution, RdfVectorSearchOptions, RdfVectorSearchPattern, RdfVectorSearchResult, RdfVectorSourceInput, RdfVectorSummaryLifecycleEntry, RdfVectorSummaryLifecycleOptions, RdfVectorSummaryMetadata, RdfTermKind, RdfTermLookup, RdfTermRow, RdfTermRewriteInput, RdfTermRewriteMode, RdfTermRewriteResult, RdfTermRewriteScope, RdfTermRewriteSkippedTerm, RdfTermSelection, } from './types';
+export type { RdfEngineLike, RdfEngineColdStartPhaseStats, RdfEngineColdStartStats, RdfEngineLifecycleStats, RdfEngineStorageStats, RdfStorageStatsOptions, RdfDerivedCacheScopeStatsOptions, RdfDerivedIndexMaintenanceResult, RdfDerivedIndexRefreshResult, RdfPlannerStatsRefreshResult, RdfIndexStats, RdfDerivedIndexProfile, RdfPgAccelerationFallbackReason, RdfPgAccelerationProfile, RdfPgAccelerationStats, Rdf3xCardinalityEstimate, Rdf3xCountResult, Rdf3xJoinMetrics, Rdf3xJoinOptions, Rdf3xJoinScanResult, Rdf3xIndexMetrics, Rdf3xIndexStats, Rdf3xObjectOperatorPattern, Rdf3xObjectRangePattern, Rdf3xPairProjectionName, Rdf3xPatternKey, Rdf3xPermutationName, Rdf3xRebuildResult, Rdf3xTermKey, Rdf3xTermInPattern, Rdf3xTermMetadataPattern, Rdf3xTermNotInPattern, Rdf3xTermProjectionName, Rdf3xTermTypePatternValue, Rdf3xIndexOptions, Rdf3xTriplePattern, Rdf3xTripleScanOptions, Rdf3xTripleScanResult, Rdf3xShadowBindingDiff, Rdf3xShadowQuadDiff, Rdf3xShadowJoinResult, Rdf3xShadowScanResult, RdfIndexSpaceObject, RdfIndexMetrics, RdfIndexPutOptions, RdfBoundedPath, RdfBoundedPathEdge, RdfBoundedPathSearchOptions, RdfBoundedPathSearchResult, RdfBindingRow, RdfMaterializedViewBindingSource, RdfMaterializedViewActivationInput, RdfMaterializedViewActivationResult, RdfMaterializedViewBuildInput, RdfMaterializedViewBuildResult, RdfMaterializedViewReadResult, RdfNativeSparqlAccessScope, RdfNativeSparqlQueryOptions, RdfNativeSparqlVectorQueryOptions, RdfNativeSparqlResult, RdfPreparedUpdateDelta, RdfPreparedUpdateGraphDelta, RdfConstructTemplate, RdfQuadJoinOptions, RdfQuadJoinCountOptions, RdfQuadJoinOrder, RdfQuadJoinPattern, RdfQuadJoinScanResult, RdfQuery, RdfQueryAggregate, RdfQueryMetrics, RdfQueryResult, RdfPatternQuery, RdfQuadIndexOptions, RdfQuadIndexScanResult, RdfQuadRow, RdfQueryOrder, RdfQueryPattern, RdfQueryPatternKey, RdfQueryTermPattern, RdfQueryVariable, RdfPathEdgeDirection, RdfPathSearchDirection, RdfSchemaExplorerOptions, RdfSchemaExplorerResult, RdfSchemaExplorerTermEntry, RdfShadowBackfillOptions, RdfShadowBackfillResult, RdfShadowDiff, RdfShadowScanResult, RdfSourceInput, RdfSourceScope, RdfSourceRow, RdfTextChunkInput, RdfTextChunkRow, RdfTextIndexLike, RdfTextIndexOptions, RdfTextIndexSyncLike, RdfTextIndexStats, RdfTextRebuildStatus, RdfTextRebuildStatusInput, RdfTextRebuildStatusKind, RdfTextSearchOptions, RdfTextSearchPattern, RdfTextSearchResult, RdfTextSourceInput, RdfTextSourceMetadata, RdfTextSourceListOptions, RdfTextTermDocumentFrequency, RdfVectorChunkInput, RdfVectorChunkRow, RdfVectorDistanceMetric, RdfVectorIndexLike, RdfVectorIndexOptions, RdfVectorIndexSyncLike, RdfVectorIndexStats, RdfVectorModelDistribution, RdfVectorSearchOptions, RdfVectorSearchPattern, RdfVectorSearchResult, RdfVectorSourceInput, RdfVectorSummaryLifecycleEntry, RdfVectorSummaryLifecycleOptions, RdfVectorSummaryMetadata, RdfTermKind, RdfTermLookup, RdfTermRow, RdfTermRewriteInput, RdfTermRewriteMode, RdfTermRewriteResult, RdfTermRewriteScope, RdfTermRewriteSkippedTerm, RdfTermSelection, } from './types';

package/dist/storage/rdf/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rdfModelsBenchmarkCasesForProfile = exports.rdfModelsBenchmarkCaseNames = exports.rdfModelsBenchmarkCases = exports.SolidRdfSparqlEngine = exports.sparqlCorrectionForCapability = exports.UnsupportedSparqlQueryError = exports.RdfSparqlAdapter = exports.NativeSparqlExecutionError = exports.DisabledSparqlFeatureError = exports.PostgresRdfEngine = exports.SolidRdfEngine = exports.ShadowRdfQuintStore = exports.rdfAccessGraphAllowed = exports.rdfAccessCacheScope = exports.isRestrictiveRdfAccessScope = exports.filterRdfAccessGraphs = exports.applyRdfAccessScope = exports.rdfVar = exports.RdfQueryExecutor = exports.diffQuads = exports.canonicalQuadKey = exports.RdfShadowComparator = exports.rdfContentTypeForPath = exports.normalizeContentType = exports.isSafeRdfDocumentContentType = exports.isRdfDocumentPath = exports.isRdfDocumentContentType = exports.isRdfDocument = exports.isLineAddressableRdfPath = exports.isLineAddressableRdfContentType = exports.isLineAddressableRdf = exports.PostgresRdfStatisticsStore = exports.PostgresRdfVectorIndex = exports.RdfVectorIndex = exports.PostgresRdfTextIndex = exports.rdfTextIndexPolicyRole = exports.parseRdfTextProjectionQuads = exports.createRdfEntityTextChunksFromText = exports.createRdfEntityTextChunks = exports.tokenizeNormalizedRdfText = exports.RdfTextIndex = exports.RDF_TEXT_SCHEMA_VERSION = exports.Rdf3xIndex = exports.RdfQuadIndex = exports.rdfNumericValue = exports.isRdfNumericTerm = exports.isRdfNumericDatatype = exports.isFiniteNumericLexical = exports.RDF_NUMERIC_DATATYPES = exports.RdfTermDictionary = void 0;
-exports.RDF_MODELS_SYNTHETIC_MESSAGE_QUADS = exports.seedRdfModelsSearchFusionIndexes = exports.runRdfModelsShadowBenchmark = exports.runRdfModelsRdf3xShadowBenchmark = exports.runRdfModelsPostgresBenchmark = exports.runRdfModelsBenchmark = exports.rdfModelsSearchFusionBroadSourceCountForScale = exports.rdfModelsBenchmarkScaleTargetQuads = exports.rdfModelsBenchmarkSyntheticPodCount = exports.rdfModelsBenchmarkTargetSatisfied = exports.rdfModelsBenchmarkScaleSatisfied = exports.rdfModelsBenchmarkProfileRequiresSearchFusion = exports.syntheticMessagesForRdfModelsTargetQuads = exports.estimateRdfModelsSyntheticQuadCount = exports.defaultSyntheticMessagesForRdfModelsScale = exports.buildRdfModelsBenchmarkSeed = exports.RDF_MODELS_BENCHMARK_POD = exports.rdfModelsSearchFusionQueryBenchmarkCaseNames = exports.rdfModelsSearchFusionQueryBenchmarkCases = exports.rdfModelsQueryBenchmarkCasesForProfile = exports.rdfModelsQueryBenchmarkCaseNames = exports.rdfModelsQueryBenchmarkCases = exports.rdfModelsPostgresQueryBenchmarkCasesForProfile = exports.rdfModelsPostgresQueryBenchmarkCaseNames = exports.rdfModelsPostgresQueryBenchmarkCases = exports.rdfModelsPostgresMaterializedQueryBenchmarkCaseNames = exports.rdfModelsPostgresMaterializedQueryBenchmarkCases = exports.rdfModelsExtremeQueryBenchmarkCaseNames = exports.rdfModelsExtremeQueryBenchmarkCases = exports.rdfModelsExtremeBenchmarkCaseNames = exports.rdfModelsExtremeBenchmarkCases = void 0;
+exports.sparqlCorrectionForCapability = exports.UnsupportedSparqlQueryError = exports.NativeSparqlTimeoutError = exports.NativeSparqlExecutionError = exports.DisabledSparqlFeatureError = exports.PostgresRdfEngine = exports.RdfQuerySparqlEngine = exports.QleverSparqlEngine = exports.LocalQleverRuntimeError = exports.LocalQleverNativeSparqlClient = exports.SolidRdfEngine = exports.rdfAccessGraphAllowed = exports.rdfAccessCacheScope = exports.isRestrictiveRdfAccessScope = exports.filterRdfAccessGraphs = exports.applyRdfAccessScope = exports.rdfVar = exports.RdfQueryExecutor = exports.diffQuads = exports.canonicalQuadKey = exports.RdfShadowComparator = exports.rdfContentTypeForPath = exports.normalizeContentType = exports.isSafeRdfDocumentContentType = exports.isRdfDocumentPath = exports.isRdfDocumentContentType = exports.isRdfDocument = exports.isLineAddressableRdfPath = exports.isLineAddressableRdfContentType = exports.isLineAddressableRdf = exports.PostgresRdfStatisticsStore = exports.PostgresRdfVectorIndex = exports.RdfVectorIndex = exports.RDF_VECTOR_SCHEMA_VERSION = exports.PostgresRdfTextIndex = exports.rdfTextIndexPolicyRole = exports.parseRdfTextProjectionQuads = exports.createRdfEntityTextChunksFromText = exports.createRdfEntityTextChunks = exports.tokenizeNormalizedRdfText = exports.RdfTextIndex = exports.RDF_TEXT_SCHEMA_VERSION = exports.Rdf3xIndex = exports.RdfQuadIndex = exports.rdfNumericValue = exports.isRdfNumericTerm = exports.isRdfNumericDatatype = exports.isFiniteNumericLexical = exports.RDF_NUMERIC_DATATYPES = exports.RdfTermDictionary = void 0;
+exports.RDF_MODELS_SYNTHETIC_MESSAGE_QUADS = exports.seedRdfModelsSearchFusionIndexes = exports.runRdfModelsShadowBenchmark = exports.runRdfModelsRdf3xShadowBenchmark = exports.runRdfModelsPostgresBenchmark = exports.runRdfModelsBenchmark = exports.rdfModelsSearchFusionBroadSourceCountForScale = exports.rdfModelsBenchmarkScaleTargetQuads = exports.rdfModelsBenchmarkSyntheticPodCount = exports.rdfModelsBenchmarkTargetSatisfied = exports.rdfModelsBenchmarkScaleSatisfied = exports.rdfModelsBenchmarkProfileRequiresSearchFusion = exports.syntheticMessagesForRdfModelsTargetQuads = exports.estimateRdfModelsSyntheticQuadCount = exports.defaultSyntheticMessagesForRdfModelsScale = exports.buildRdfModelsBenchmarkSeed = exports.RDF_MODELS_BENCHMARK_POD = exports.rdfModelsSearchFusionQueryBenchmarkCaseNames = exports.rdfModelsSearchFusionQueryBenchmarkCases = exports.rdfModelsQueryBenchmarkCasesForProfile = exports.rdfModelsQueryBenchmarkCaseNames = exports.rdfModelsQueryBenchmarkCases = exports.rdfModelsPostgresQueryBenchmarkCasesForProfile = exports.rdfModelsPostgresQueryBenchmarkCaseNames = exports.rdfModelsPostgresQueryBenchmarkCases = exports.rdfModelsPostgresMaterializedQueryBenchmarkCaseNames = exports.rdfModelsPostgresMaterializedQueryBenchmarkCases = exports.rdfModelsExtremeQueryBenchmarkCaseNames = exports.rdfModelsExtremeQueryBenchmarkCases = exports.rdfModelsExtremeBenchmarkCaseNames = exports.rdfModelsExtremeBenchmarkCases = exports.rdfModelsBenchmarkCasesForProfile = exports.rdfModelsBenchmarkCaseNames = exports.rdfModelsBenchmarkCases = exports.assertServerOwnedNativeSparqlQuery = void 0;
 var RdfTermDictionary_1 = require("./RdfTermDictionary");
 Object.defineProperty(exports, "RdfTermDictionary", { enumerable: true, get: function () { return RdfTermDictionary_1.RdfTermDictionary; } });
 var RdfTermSemantics_1 = require("./RdfTermSemantics");
@@ -26,6 +26,7 @@ Object.defineProperty(exports, "rdfTextIndexPolicyRole", { enumerable: true, get
 var PostgresRdfTextIndex_1 = require("./PostgresRdfTextIndex");
 Object.defineProperty(exports, "PostgresRdfTextIndex", { enumerable: true, get: function () { return PostgresRdfTextIndex_1.PostgresRdfTextIndex; } });
 var RdfVectorIndex_1 = require("./RdfVectorIndex");
+Object.defineProperty(exports, "RDF_VECTOR_SCHEMA_VERSION", { enumerable: true, get: function () { return RdfVectorIndex_1.RDF_VECTOR_SCHEMA_VERSION; } });
 Object.defineProperty(exports, "RdfVectorIndex", { enumerable: true, get: function () { return RdfVectorIndex_1.RdfVectorIndex; } });
 var PostgresRdfVectorIndex_1 = require("./PostgresRdfVectorIndex");
 Object.defineProperty(exports, "PostgresRdfVectorIndex", { enumerable: true, get: function () { return PostgresRdfVectorIndex_1.PostgresRdfVectorIndex; } });
@@ -54,20 +55,24 @@ Object.defineProperty(exports, "filterRdfAccessGraphs", { enumerable: true, get:
 Object.defineProperty(exports, "isRestrictiveRdfAccessScope", { enumerable: true, get: function () { return RdfAccessScope_1.isRestrictiveRdfAccessScope; } });
 Object.defineProperty(exports, "rdfAccessCacheScope", { enumerable: true, get: function () { return RdfAccessScope_1.rdfAccessCacheScope; } });
 Object.defineProperty(exports, "rdfAccessGraphAllowed", { enumerable: true, get: function () { return RdfAccessScope_1.rdfAccessGraphAllowed; } });
-var ShadowRdfQuintStore_1 = require("./ShadowRdfQuintStore");
-Object.defineProperty(exports, "ShadowRdfQuintStore", { enumerable: true, get: function () { return ShadowRdfQuintStore_1.ShadowRdfQuintStore; } });
 var SolidRdfEngine_1 = require("./SolidRdfEngine");
 Object.defineProperty(exports, "SolidRdfEngine", { enumerable: true, get: function () { return SolidRdfEngine_1.SolidRdfEngine; } });
+var LocalQleverNativeSparqlClient_1 = require("./LocalQleverNativeSparqlClient");
+Object.defineProperty(exports, "LocalQleverNativeSparqlClient", { enumerable: true, get: function () { return LocalQleverNativeSparqlClient_1.LocalQleverNativeSparqlClient; } });
+Object.defineProperty(exports, "LocalQleverRuntimeError", { enumerable: true, get: function () { return LocalQleverNativeSparqlClient_1.LocalQleverRuntimeError; } });
+var QleverSparqlEngine_1 = require("./QleverSparqlEngine");
+Object.defineProperty(exports, "QleverSparqlEngine", { enumerable: true, get: function () { return QleverSparqlEngine_1.QleverSparqlEngine; } });
+var RdfQuerySparqlEngine_1 = require("./RdfQuerySparqlEngine");
+Object.defineProperty(exports, "RdfQuerySparqlEngine", { enumerable: true, get: function () { return RdfQuerySparqlEngine_1.RdfQuerySparqlEngine; } });
 var PostgresRdfEngine_1 = require("./PostgresRdfEngine");
 Object.defineProperty(exports, "PostgresRdfEngine", { enumerable: true, get: function () { return PostgresRdfEngine_1.PostgresRdfEngine; } });
-var RdfSparqlAdapter_1 = require("./RdfSparqlAdapter");
-Object.defineProperty(exports, "DisabledSparqlFeatureError", { enumerable: true, get: function () { return RdfSparqlAdapter_1.DisabledSparqlFeatureError; } });
-Object.defineProperty(exports, "NativeSparqlExecutionError", { enumerable: true, get: function () { return RdfSparqlAdapter_1.NativeSparqlExecutionError; } });
-Object.defineProperty(exports, "RdfSparqlAdapter", { enumerable: true, get: function () { return RdfSparqlAdapter_1.RdfSparqlAdapter; } });
-Object.defineProperty(exports, "UnsupportedSparqlQueryError", { enumerable: true, get: function () { return RdfSparqlAdapter_1.UnsupportedSparqlQueryError; } });
-Object.defineProperty(exports, "sparqlCorrectionForCapability", { enumerable: true, get: function () { return RdfSparqlAdapter_1.sparqlCorrectionForCapability; } });
-var SolidRdfSparqlEngine_1 = require("./SolidRdfSparqlEngine");
-Object.defineProperty(exports, "SolidRdfSparqlEngine", { enumerable: true, get: function () { return SolidRdfSparqlEngine_1.SolidRdfSparqlEngine; } });
+var RdfSparqlBoundary_1 = require("./RdfSparqlBoundary");
+Object.defineProperty(exports, "DisabledSparqlFeatureError", { enumerable: true, get: function () { return RdfSparqlBoundary_1.DisabledSparqlFeatureError; } });
+Object.defineProperty(exports, "NativeSparqlExecutionError", { enumerable: true, get: function () { return RdfSparqlBoundary_1.NativeSparqlExecutionError; } });
+Object.defineProperty(exports, "NativeSparqlTimeoutError", { enumerable: true, get: function () { return RdfSparqlBoundary_1.NativeSparqlTimeoutError; } });
+Object.defineProperty(exports, "UnsupportedSparqlQueryError", { enumerable: true, get: function () { return RdfSparqlBoundary_1.UnsupportedSparqlQueryError; } });
+Object.defineProperty(exports, "sparqlCorrectionForCapability", { enumerable: true, get: function () { return RdfSparqlBoundary_1.sparqlCorrectionForCapability; } });
+Object.defineProperty(exports, "assertServerOwnedNativeSparqlQuery", { enumerable: true, get: function () { return RdfSparqlBoundary_1.assertServerOwnedNativeSparqlQuery; } });
 var models_benchmark_1 = require("./models-benchmark");
 Object.defineProperty(exports, "rdfModelsBenchmarkCases", { enumerable: true, get: function () { return models_benchmark_1.rdfModelsBenchmarkCases; } });
 Object.defineProperty(exports, "rdfModelsBenchmarkCaseNames", { enumerable: true, get: function () { return models_benchmark_1.rdfModelsBenchmarkCaseNames; } });

package/dist/storage/rdf/models-benchmark.d.ts

@@ -2,6 +2,7 @@ import type { Quad } from '@rdfjs/types';
 import type { QuintPattern, QueryOptions, QuintStore, StoreStats } from '../quint/types';
 import type { Rdf3xJoinMetrics, Rdf3xIndexMetrics, Rdf3xIndexStats, RdfDerivedIndexRefreshResult, RdfEngineColdStartPhaseStats, RdfEngineLike, RdfEngineStorageStats, RdfIndexMetrics, RdfIndexStats, RdfQuery, RdfQueryMetrics, RdfTextChunkInput, RdfTextSourceInput, RdfVectorChunkInput, RdfVectorSourceInput, RdfShadowDiff } from './types';
 import type { SolidRdfEngine } from './SolidRdfEngine';
+import type { Rdf3xIndex } from './Rdf3xIndex';
 export type RdfBenchmarkScale = 'small' | 'medium' | 'large';
 export type RdfBenchmarkCaseProfile = 'default' | 'extreme' | 'fusion' | 'all';
 export declare const RDF_MODELS_SYNTHETIC_MESSAGE_QUADS = 9;
@@ -37,6 +38,9 @@ export interface RdfModelBenchmarkRunOptions {
     scale?: RdfBenchmarkScale;
     iterations?: number;
 }
+export interface RdfModelRdf3xShadowBenchmarkRunOptions extends RdfModelBenchmarkRunOptions {
+    rdf3xIndex: Rdf3xIndex;
+}
 export interface RdfModelPostgresBenchmarkRunOptions extends RdfModelBenchmarkRunOptions {
     refreshDerivedIndexes?: boolean;
     refreshMutationSources?: number;
@@ -529,5 +533,5 @@ export declare function runRdfModelsBenchmark(engine: SolidRdfEngine, options?:
 export declare function runRdfModelsPostgresBenchmark(engine: RdfEngineLike, options?: RdfModelPostgresBenchmarkRunOptions): Promise<RdfModelPostgresBenchmarkReport>;
 export declare function postgresServingRegressionFailures(result: RdfModelQueryBenchmarkResult, thresholds?: RdfModelPostgresBenchmarkGateThresholds): string[];
 export declare function runRdfModelsShadowBenchmark(engine: SolidRdfEngine, compatibilityStore: QuintStore, options?: RdfModelShadowBenchmarkRunOptions): Promise<RdfModelShadowBenchmarkReport>;
-export declare function runRdfModelsRdf3xShadowBenchmark(engine: SolidRdfEngine, options?: RdfModelBenchmarkRunOptions): RdfModelRdf3xShadowBenchmarkReport;
+export declare function runRdfModelsRdf3xShadowBenchmark(engine: SolidRdfEngine, options: RdfModelRdf3xShadowBenchmarkRunOptions): RdfModelRdf3xShadowBenchmarkReport;
 export {};

package/dist/storage/rdf/models-benchmark.js

@@ -4524,10 +4524,8 @@ async function runRdfModelsShadowBenchmark(engine, compatibilityStore, options =
         cases: results,
     };
 }
-function runRdfModelsRdf3xShadowBenchmark(engine, options = {}) {
-    if (!engine.rdf3xIndex) {
-        throw new Error('runRdfModelsRdf3xShadowBenchmark requires SolidRdfEngine.rdf3xIndex');
-    }
+function runRdfModelsRdf3xShadowBenchmark(engine, options) {
+    const rdf3xIndex = options.rdf3xIndex;
     const scale = options.scale ?? 'small';
     const iterations = Math.max(1, Math.floor(options.iterations ?? 1));
     const caseProfile = options.caseProfile ?? 'default';
@@ -4535,9 +4533,9 @@ function runRdfModelsRdf3xShadowBenchmark(engine, options = {}) {
         .filter((testCase) => scaleRank(testCase.minScale) <= scaleRank(scale));
     const queryCases = (options.queryCases ?? rdfModelsQueryBenchmarkCasesForProfile(caseProfile))
         .filter((testCase) => scaleRank(testCase.minScale) <= scaleRank(scale));
-    const rebuild = engine.rdf3xIndex.rebuildFromCurrentQuads();
-    const results = cases.map((testCase) => runRdf3xShadowBenchmarkCase(engine, testCase, iterations));
-    const joinResults = queryCases.map((testCase) => runRdf3xShadowJoinBenchmarkCase(engine, testCase, iterations));
+    const rebuild = rdf3xIndex.rebuildFromCurrentQuads();
+    const results = cases.map((testCase) => runRdf3xShadowBenchmarkCase(engine, rdf3xIndex, testCase, iterations));
+    const joinResults = queryCases.map((testCase) => runRdf3xShadowJoinBenchmarkCase(engine, rdf3xIndex, testCase, iterations));
     const supportedResults = results.filter((result) => result.supported);
     const supportedJoinResults = joinResults.filter((result) => result.supported);
     const failedPlanCases = [
@@ -4768,7 +4766,7 @@ function asyncBenchmarkQueryFor(testCase) {
         },
     };
 }
-function runRdf3xShadowBenchmarkCase(engine, testCase, iterations) {
+function runRdf3xShadowBenchmarkCase(engine, rdf3xIndex, testCase, iterations) {
     const baseResult = baseRdf3xShadowBenchmarkResult(testCase);
     const unsupportedReason = unsupportedRdf3xPatternReason(testCase.query.pattern);
     if (unsupportedReason) {
@@ -4800,7 +4798,7 @@ function runRdf3xShadowBenchmarkCase(engine, testCase, iterations) {
         solidRdfQuads = solidRdfResult.quads;
         solidRdfMetrics = solidRdfResult.metrics;
         start = Date.now();
-        const rdf3xResult = engine.rdf3xIndex.scan(rdf3xPatternFor(testCase.query.pattern), testCase.query.options);
+        const rdf3xResult = rdf3xIndex.scan(rdf3xPatternFor(testCase.query.pattern), testCase.query.options);
         rdf3xDurationsMs.push(Math.max(0, Date.now() - start));
         rdf3xQuads = rdf3xResult.quads;
         rdf3xMetrics = rdf3xResult.metrics;
@@ -4845,11 +4843,11 @@ function runRdf3xShadowBenchmarkCase(engine, testCase, iterations) {
             ...benchmarkSide(rdf3xKeys, rdf3xDurationsMs),
             ...rdf3xBenchmarkExecution(finalRdf3xMetrics),
             metrics: finalRdf3xMetrics,
-            indexStats: engine.rdf3xIndex.stats(),
+            indexStats: rdf3xIndex.stats(),
         },
     };
 }
-function runRdf3xShadowJoinBenchmarkCase(engine, testCase, iterations) {
+function runRdf3xShadowJoinBenchmarkCase(engine, rdf3xIndex, testCase, iterations) {
     const unsupportedReason = unsupportedRdf3xJoinQueryReason(testCase.query);
     if (unsupportedReason) {
         return {
@@ -4881,7 +4879,7 @@ function runRdf3xShadowJoinBenchmarkCase(engine, testCase, iterations) {
         solidRdfBindings = solidRdfResult.bindings;
         solidRdfMetrics = solidRdfResult.metrics;
         start = Date.now();
-        const rdf3xResult = runRdf3xJoinShape(engine, joinShape);
+        const rdf3xResult = runRdf3xJoinShape(rdf3xIndex, joinShape);
         rdf3xDurationsMs.push(Math.max(0, Date.now() - start));
         rdf3xBindings = rdf3xResult.bindings;
         rdf3xMetrics = rdf3xResult.metrics;
@@ -4931,7 +4929,7 @@ function runRdf3xShadowJoinBenchmarkCase(engine, testCase, iterations) {
             ...benchmarkSide(rdf3xKeys, rdf3xDurationsMs),
             ...rdf3xJoinBenchmarkExecution(finalRdf3xMetrics),
             metrics: finalRdf3xMetrics,
-            indexStats: engine.rdf3xIndex.stats(),
+            indexStats: rdf3xIndex.stats(),
         },
     };
 }
@@ -4953,18 +4951,18 @@ function runSolidRdfJoinShape(engine, shape) {
         }
     }
 }
-function runRdf3xJoinShape(engine, shape) {
+function runRdf3xJoinShape(rdf3xIndex, shape) {
     switch (shape.kind) {
         case 'join':
-            return engine.rdf3xIndex.joinPatterns(shape.patterns, shape.options);
+            return rdf3xIndex.joinPatterns(shape.patterns, shape.options);
         case 'join-count':
-            return engine.rdf3xIndex.countJoinPatterns(shape.patterns, shape.options);
+            return rdf3xIndex.countJoinPatterns(shape.patterns, shape.options);
         case 'join-aggregate':
-            return engine.rdf3xIndex.aggregateJoinPatterns(shape.patterns, shape.options);
+            return rdf3xIndex.aggregateJoinPatterns(shape.patterns, shape.options);
         case 'group-count':
-            return engine.rdf3xIndex.groupCountJoinPatterns(shape.patterns, shape.options);
+            return rdf3xIndex.groupCountJoinPatterns(shape.patterns, shape.options);
         case 'group-aggregate':
-            return engine.rdf3xIndex.groupAggregateJoinPatterns(shape.patterns, shape.options);
+            return rdf3xIndex.groupAggregateJoinPatterns(shape.patterns, shape.options);
         default: {
             const exhaustive = shape;
             throw new Error(`Unsupported RDF-3X benchmark shape: ${JSON.stringify(exhaustive)}`);

package/dist/storage/rdf/types.d.ts

@@ -154,7 +154,7 @@ export interface RdfEngineColdStartStats {
     ownsVectorIndex: boolean;
 }
 export interface RdfEngineColdStartPhaseStats {
-    name: 'executor' | 'text-index' | 'vector-index' | 'term-dictionary' | 'schema' | 'acceleration-probe' | 'native-sparql-probe' | 'custom-indexes' | 'maintenance-scheduler';
+    name: 'executor' | 'text-index' | 'vector-index' | 'schema-compatibility' | 'term-dictionary' | 'schema' | 'acceleration-probe' | 'native-sparql-probe' | 'custom-indexes' | 'maintenance-scheduler';
     durationMs: number;
 }
 export interface RdfAccessControlOverrideIndexStats {
@@ -627,7 +627,7 @@ export interface RdfQuadTupleConstraintSource {
     rows: RdfQuadTupleConstraint[];
 }
 export interface RdfQuadJoinPattern {
-    pattern: QuintPattern;
+    pattern: RdfStoragePattern;
     variables: Partial<Record<RdfQueryPatternKey, string>>;
 }
 export interface RdfQuadJoinOrder {
@@ -664,7 +664,7 @@ export interface RdfQuadJoinGroupAggregateHaving {
 }
 export type RdfQuadJoinGroupCountHaving = RdfQuadJoinGroupAggregateHaving;
 export interface RdfPatternQuery {
-    pattern: QuintPattern;
+    pattern: RdfStoragePattern;
     options?: RdfQuadScanOptions;
 }
 export interface RdfQueryVariable {
@@ -676,6 +676,7 @@ export interface RdfQueryPattern {
     subject?: RdfQueryTermPattern;
     predicate?: RdfQueryTermPattern;
     object?: RdfQueryTermPattern;
+    sourceScope?: RdfSourceScope;
 }
 export interface RdfConstructTemplate {
     subject: RdfQueryTermPattern;
@@ -818,15 +819,17 @@ export interface RdfMaterializedViewActivationResult {
     activated: boolean;
     previousFactsDataVersion?: number;
 }
-export interface RdfSearchScope {
-    workspace?: string;
+export interface RdfSourceScope {
     sourcePrefix?: string;
     localPathPrefix?: string;
-    accessBasePath?: string;
     allowedSources?: string[];
     deniedSources?: string[];
     deniedSourcePrefixes?: string[];
 }
+export interface RdfSearchScope extends RdfSourceScope {
+    workspace?: string;
+    accessBasePath?: string;
+}
 export interface RdfTextSearchPattern {
     query: string;
     scope?: RdfSearchScope;
@@ -919,6 +922,9 @@ export interface RdfQueryCacheScopeDescriptor {
     allowedGraphUrls?: string[];
     deniedGraphUrls?: string[];
     deniedGraphPrefixes?: string[];
+    allowedSourceUrls?: string[];
+    deniedSourceUrls?: string[];
+    deniedSourcePrefixes?: string[];
     components?: RdfQueryCacheScope[];
 }
 export type RdfQueryCacheScope = string | RdfQueryCacheScopeDescriptor | RdfQueryCacheScope[];
@@ -1128,6 +1134,9 @@ export interface RdfQueryCacheScopeExplain {
     allowedGraphUrls?: string[] | null;
     deniedGraphUrls?: string[] | null;
     deniedGraphPrefixes?: string[] | null;
+    allowedSourceUrls?: string[] | null;
+    deniedSourceUrls?: string[] | null;
+    deniedSourcePrefixes?: string[] | null;
 }
 export interface RdfQueryResult {
     bindings: RdfBindingRow[];
@@ -1161,19 +1170,40 @@ export interface RdfTermRewriteResult {
 export interface RdfNativeSparqlAccessScope {
     basePath: string;
     mode: string;
+    resolved?: boolean;
     principal?: string;
     allowedGraphUrls?: string[];
     deniedGraphUrls?: string[];
     deniedGraphPrefixes?: string[];
+    allowedSourceUrls?: string[];
+    deniedSourceUrls?: string[];
+    deniedSourcePrefixes?: string[];
     version?: string;
 }
+export interface RdfNativeSparqlVectorQueryOptions {
+    embedding: number[];
+    metric: RdfVectorDistanceMetric;
+    provider: string;
+    model: string;
+    modelVersion: string;
+    inputKind: string;
+    projectionPolicyVersion: string;
+    limit: number;
+    retrievalPointVariable?: string;
+    resourceVariable?: string;
+    threshold?: number;
+}
 export interface RdfNativeSparqlQueryOptions {
     basePath: string;
+    sourceUri?: string;
+    defaultDataset?: 'physical' | 'exactSource' | 'scopedUnion';
     operation?: string;
     timeoutMs?: number;
+    signal?: AbortSignal;
     acceptMediaType?: string;
     loadDocument?: RdfNativeSparqlLoadDocumentOptions;
     accessScope?: RdfNativeSparqlAccessScope;
+    vectorQuery?: RdfNativeSparqlVectorQueryOptions;
 }
 export interface RdfNativeSparqlLoadDocumentOptions {
     sourceUri: string;
@@ -1185,8 +1215,19 @@ export interface RdfNativeSparqlResult {
     mediaType: string;
     body: string;
     profile?: unknown;
+    queryStatus?: number;
     error?: string;
 }
+export interface RdfPreparedUpdateGraphDelta {
+    graphIri: string;
+    sourceUri: string;
+    deletes: Quad[];
+    inserts: Quad[];
+}
+export interface RdfPreparedUpdateDelta {
+    version: 1;
+    graphs: RdfPreparedUpdateGraphDelta[];
+}
 export interface RdfEngineLike {
     open(): void | Promise<void>;
     close(): void | Promise<void>;
@@ -1195,8 +1236,12 @@ export interface RdfEngineLike {
     deleteSource(source: string): number | Promise<number>;
     moveSource?(oldSource: string, next: RdfSourceInput): number | Promise<number>;
     indexTextSource?(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): void | Promise<void>;
+    moveTextSource?(oldSource: string, next: RdfTextSourceInput): number | Promise<number>;
     deleteTextSource?(source: string): number | Promise<number>;
+    listTextSources?(options?: RdfTextSourceListOptions): RdfTextSourceMetadata[] | Promise<RdfTextSourceMetadata[]>;
+    listTextSourceChunks?(sourceKey: string): RdfTextSearchResult[] | Promise<RdfTextSearchResult[]>;
     indexVectorSource?(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): void | Promise<void>;
+    moveVectorSource?(oldSource: string, next: RdfVectorSourceInput): number | Promise<number>;
     deleteVectorSource?(source: string): number | Promise<number>;
     delete(pattern: QuintPattern): number | Promise<number>;
     applyDelta(deletes: QuintPattern[], inserts: Quad[], options?: RdfIndexPutOptions): {
@@ -1221,6 +1266,9 @@ export interface RdfEngineLike {
     storageStats(options?: RdfStorageStatsOptions): RdfEngineStorageStats | Promise<RdfEngineStorageStats>;
 }
 export type RdfQueryPatternKey = TermName;
+export interface RdfStoragePattern extends QuintPattern {
+    sourceScope?: RdfSourceScope;
+}
 export interface RdfShadowDiff {
     missingFromPrimary: string[];
     extraInPrimary: string[];
@@ -1260,6 +1308,8 @@ export interface RdfTextIndexLike {
     indexText(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): MaybePromise<void>;
     moveSource(oldSource: string, next: RdfTextSourceInput): MaybePromise<number>;
     deleteSource(source: string): MaybePromise<number>;
+    listSources(options?: RdfTextSourceListOptions): MaybePromise<RdfTextSourceMetadata[]>;
+    listSourceChunks(sourceKey: string): MaybePromise<RdfTextSearchResult[]>;
     search(options: RdfTextSearchOptions): MaybePromise<RdfTextSearchResult[]>;
     estimateSearchCardinality(options: RdfTextSearchOptions): MaybePromise<RdfSearchCardinalityEstimate>;
     stats(): MaybePromise<RdfTextIndexStats>;
@@ -1272,6 +1322,8 @@ export interface RdfTextIndexSyncLike extends RdfTextIndexLike {
     indexText(source: RdfTextSourceInput, text: string, chunks?: RdfTextChunkInput[]): void;
     moveSource(oldSource: string, next: RdfTextSourceInput): number;
     deleteSource(source: string): number;
+    listSources(options?: RdfTextSourceListOptions): RdfTextSourceMetadata[];
+    listSourceChunks(sourceKey: string): RdfTextSearchResult[];
     search(options: RdfTextSearchOptions): RdfTextSearchResult[];
     estimateSearchCardinality(options: RdfTextSearchOptions): RdfSearchCardinalityEstimate;
     stats(): RdfTextIndexStats;
@@ -1289,6 +1341,12 @@ export interface RdfTextSourceInput {
 export interface RdfTextSourceMetadata extends RdfTextSourceInput {
     updatedAt: string;
 }
+export interface RdfTextSourceListOptions {
+    workspace?: string;
+    sourcePrefix?: string;
+    limit?: number;
+    offset?: number;
+}
 export type RdfTextRebuildStatusKind = 'indexed' | 'skipped' | 'capped' | 'error';
 export interface RdfTextRebuildStatusInput extends RdfTextSourceInput {
     status: RdfTextRebuildStatusKind;
@@ -1301,7 +1359,9 @@ export interface RdfTextRebuildStatus extends RdfTextRebuildStatusInput {
 export type RdfTextRetrievalKind = 'entity-card' | 'field-chunk' | 'file-chunk' | 'folder-card';
 export interface RdfTextChunkInput {
     chunkKey: string;
+    retrievalPointKey?: string;
     retrievalKind?: RdfTextRetrievalKind;
+    chunkPolicyVersion?: string;
     ordinal: number;
     level: number;
     heading?: string;
@@ -1427,6 +1487,7 @@ export interface RdfVectorIndexLike {
     close(): MaybePromise<void>;
     clear(): MaybePromise<void>;
     indexVector(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): MaybePromise<void>;
+    moveSource(oldSource: string, next: RdfVectorSourceInput): MaybePromise<number>;
     deleteSource(source: string): MaybePromise<number>;
     search(options: RdfVectorSearchOptions): MaybePromise<RdfVectorSearchResult[]>;
     summaryLifecycle(options?: RdfVectorSummaryLifecycleOptions): MaybePromise<RdfVectorSummaryLifecycleEntry[]>;
@@ -1439,6 +1500,7 @@ export interface RdfVectorIndexSyncLike extends RdfVectorIndexLike {
     close(): void;
     clear(): void;
     indexVector(source: RdfVectorSourceInput, chunks: RdfVectorChunkInput[]): void;
+    moveSource(oldSource: string, next: RdfVectorSourceInput): number;
     deleteSource(source: string): number;
     search(options: RdfVectorSearchOptions): RdfVectorSearchResult[];
     summaryLifecycle(options?: RdfVectorSummaryLifecycleOptions): RdfVectorSummaryLifecycleEntry[];