@fortemi/core 2026.7.2 → 2026.7.4

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { PGlite } from '@electric-sql/pglite';
+import { S as ShardAttachmentProjection, a as ShardCollection, b as ShardEmbeddingConfig, c as ShardEmbedding, d as ShardEmbeddingSet, e as ShardEmbeddingSetMember, f as ShardLink, g as ShardNote, h as ShardNoteSkosTag, i as ShardProvenanceEdge, j as ShardSkosConcept, k as ShardSkosRelation, l as ShardSkosScheme, m as ShardTag, n as ShardTemplate, o as ShardManifest, B as BlobStore, E as ExportOptions, I as ImportOptions, p as ImportResult, q as ShardComponent } from './aiwg-index-C2G7iy-b.js';
+export { A as AIWG_SCAN_REQUIRED_FIELDS, r as AiwgChunkedIndexBuildOptions, s as AiwgChunkedIndexBuildResult, t as AiwgChunkedIndexDetailLoader, u as AiwgChunkedIndexLoadOptions, v as AiwgChunkedIndexLoader, w as AiwgChunkedIndexProgress, x as AiwgChunkedIndexProgressPhase, y as AiwgChunkedIndexQueryOptions, z as AiwgChunkedIndexQueryResult, C as AiwgChunkedIndexValidationResult, D as AiwgFortemiAttachmentReference, F as AiwgFortemiBinarySource, G as AiwgFortemiChunk, H as AiwgFortemiChunkDetailRef, J as AiwgFortemiChunkManifest, K as AiwgFortemiChunkPart, L as AiwgFortemiChunkPartRef, M as AiwgFortemiIndexExport, N as AiwgFortemiIndexExportSchemaVersion, O as AiwgFortemiProjectedRecord, P as AiwgFortemiProvenance, Q as AiwgFortemiProvenanceEvent, R as AiwgFortemiRecord, T as AiwgFortemiRecordEmbedding, U as AiwgFortemiRecordSchemaVersion, V as AiwgFortemiRecordSource, W as AiwgFortemiRecordType, X as AiwgFortemiRelationship, Y as AiwgFortemiRelationshipDirection, Z as AiwgFortemiSearchProjection, _ as AiwgFortemiSkosConcept, $ as AiwgFortemiSkosRelation, a0 as AiwgFortemiSkosRelationType, a1 as AiwgHeadlessEmbeddingBackend, a2 as AiwgIndexController, a3 as AiwgIndexControllerListener, a4 as AiwgIndexControllerSnapshot, a5 as AiwgIndexGraphOptions, a6 as AiwgIndexQueryMatch, a7 as AiwgIndexQueryOptions, a8 as AiwgIndexQueryRankedItem, a9 as AiwgIndexQueryResult, aa as AiwgIndexQueryWeights, ab as AiwgIndexValidationResult, ac as AiwgPrivacyClassification, ad as AiwgPrivacyFilterOptions, ae as AiwgProvenanceConfidence, af as AiwgRelationshipDirection, ag as AiwgRelationshipEdgeSummary, ah as AiwgRelationshipNodeSummary, ai as AiwgRelationshipQueryOptions, aj as AiwgRelationshipSetOperation, ak as AiwgRelationshipSetOptions, al as AiwgRelationshipSetResult, am as AiwgRelationshipTraversalOptions, an as AiwgRelationshipTraversalResult, ao as AiwgReviewAction, ap as AiwgReviewDecision, aq as AiwgReviewDecisionExport, ar as AiwgReviewInput, as as AiwgStaticDuplicatePair, at as AiwgStaticEmbeddingRecord, au as AiwgStaticEmbeddingSet, av as AiwgStaticHybridQueryOptions, aw as AiwgStaticSemanticQueryOptions, ax as AiwgStaticSemanticResult, ay as BuildAiwgStaticEmbeddingSetOptions, az as CURRENT_SHARD_VERSION, aA as ConflictStrategy, aB as ImportCounts, aC as ImportProgress, aD as ImportProgressPhase, aE as MemoryBlobStore, aF as SHARD_FORMAT, aG as ShardClusterRef, aH as ShardLayout, aI as aiwgFortemiIndexToCommunityGraph, aJ as assertAiwgFortemiChunkManifest, aK as assertAiwgFortemiChunkPart, aL as assertAiwgFortemiIndexExport, aM as assertAiwgStaticEmbeddingSet, aN as buildAiwgChunkedIndex, aO as buildAiwgStaticEmbeddingSet, aP as createAiwgFetchChunkLoader, aQ as createAiwgFetchDetailLoader, aR as createAiwgIndexController, aS as createAiwgReviewDecisionExport, aT as createBlobStore, aU as filterAiwgRecordsByPrivacy, aV as findAiwgStaticDuplicatePairs, aW as getAiwgFortemiFacets, aX as queryAiwgFortemiIndex, aY as queryAiwgHybridIndex, aZ as queryAiwgSemanticIndex, a_ as validateAiwgFortemiChunkManifest, a$ as validateAiwgFortemiChunkPart, b0 as validateAiwgFortemiIndexExport, b1 as validateAiwgStaticEmbeddingSet } from './aiwg-index-C2G7iy-b.js';
 import { z, ZodType } from 'zod';
-export { AIWG_SCAN_REQUIRED_FIELDS, AiwgChunkedIndexBuildOptions, AiwgChunkedIndexBuildResult, AiwgChunkedIndexDetailLoader, AiwgChunkedIndexLoadOptions, AiwgChunkedIndexLoader, AiwgChunkedIndexProgress, AiwgChunkedIndexProgressPhase, AiwgChunkedIndexQueryOptions, AiwgChunkedIndexQueryResult, AiwgChunkedIndexValidationResult, AiwgFortemiAttachmentReference, AiwgFortemiBinarySource, AiwgFortemiChunk, AiwgFortemiChunkDetailRef, AiwgFortemiChunkManifest, AiwgFortemiChunkPart, AiwgFortemiChunkPartRef, AiwgFortemiIndexExport, AiwgFortemiIndexExportSchemaVersion, AiwgFortemiKnownRecordType, AiwgFortemiProjectedRecord, AiwgFortemiProvenance, AiwgFortemiProvenanceEvent, AiwgFortemiRecord, AiwgFortemiRecordEmbedding, AiwgFortemiRecordSchemaVersion, AiwgFortemiRecordSource, AiwgFortemiRecordType, AiwgFortemiRelationship, AiwgFortemiRelationshipDirection, AiwgFortemiSearchProjection, AiwgFortemiSkosConcept, AiwgFortemiSkosRelation, AiwgFortemiSkosRelationType, AiwgHeadlessEmbeddingBackend, AiwgIndexController, AiwgIndexControllerListener, AiwgIndexControllerSnapshot, AiwgIndexGraphOptions, AiwgIndexQueryMatch, AiwgIndexQueryOptions, AiwgIndexQueryRankedItem, AiwgIndexQueryResult, AiwgIndexQueryWeights, AiwgIndexValidationResult, AiwgPrivacyClassification, AiwgProvenanceConfidence, AiwgRelationshipDirection, AiwgRelationshipEdgeSummary, AiwgRelationshipNodeSummary, AiwgRelationshipQueryOptions, AiwgRelationshipSetOperation, AiwgRelationshipSetOptions, AiwgRelationshipSetResult, AiwgRelationshipTraversalOptions, AiwgRelationshipTraversalResult, AiwgReviewAction, AiwgReviewDecision, AiwgReviewDecisionExport, AiwgReviewInput, AiwgStaticDuplicatePair, AiwgStaticEmbeddingRecord, AiwgStaticEmbeddingSet, AiwgStaticHybridQueryOptions, AiwgStaticSemanticQueryOptions, AiwgStaticSemanticResult, BuildAiwgStaticEmbeddingSetOptions, aiwgFortemiIndexToCommunityGraph, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, findAiwgStaticDuplicatePairs, getAiwgFortemiFacets, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgStaticEmbeddingSet } from './aiwg-index.js';
 
 /**
  * Generate a RFC 9562 UUIDv7 identifier.
@@ -128,6 +129,12 @@ declare class TypedEventBus {
  * PGlite database factory.
  * Enforces PGlite 0.4.x conventions (explicit database: 'postgres').
  * Selects persistence adapter based on config.
+ *
+ * PGlite is loaded LAZILY via dynamic `import()` inside `createPGliteInstance`
+ * (issue #261) — the top-level import is type-only so the emitted `dist/index.js`
+ * carries no static `import '@electric-sql/pglite'`. Consumers that never boot a
+ * PGlite-backed store therefore do not pull the WASM engine into their bundle,
+ * and `@electric-sql/pglite` is an OPTIONAL dependency of `@fortemi/core`.
  */
 
 type PersistenceMode = 'opfs' | 'idb' | 'memory';
@@ -356,6 +363,13 @@ declare class PGliteStorageBackend implements StorageBackend {
 declare class PGliteStorageBackendFactory implements StorageBackendFactory {
     open(input: StorageOpenRequest): Promise<StorageBackend>;
 }
+/**
+ * Built-in PGlite backend factory — the opt-in default (issue #261). PGlite is
+ * loaded lazily by `createPGliteInstance` on first `open()`, so referencing
+ * this constant does not force the WASM engine into a consumer's static graph.
+ * Hosts wanting a different store pass their own `StorageBackendFactory` to
+ * `ArchiveManager` instead.
+ */
 declare const defaultStorageBackendFactory: PGliteStorageBackendFactory;
 declare class PGliteWorkerStorageBackend implements StorageBackend {
     readonly id: string;
@@ -376,254 +390,6 @@ declare class PGliteWorkerStorageBackendFactory implements StorageBackendFactory
     open(input: StorageOpenRequest): Promise<StorageBackend>;
 }
 
-/**
- * Shard format types — matches the fortemi server matric-shard specification.
- *
- * A shard is a gzip-compressed tar archive (.shard) containing serialized
- * knowledge data with a manifest for integrity verification.
- */
-declare const CURRENT_SHARD_VERSION = "1.0.0";
-declare const SHARD_FORMAT = "matric-shard";
-/** Components that can appear in a shard archive. */
-type ShardComponent = 'notes' | 'collections' | 'tags' | 'links' | 'embedding_sets' | 'embedding_set_members' | 'embedding_configs' | 'embeddings' | 'skos_schemes' | 'skos_concepts' | 'skos_relations' | 'note_skos_tags' | 'provenance_edges' | 'community_assignments' | 'communities' | 'graph_edges' | 'graph_sources';
-interface ShardAttachmentReference {
-    id: string;
-    path: string;
-    mime: string | null;
-    checksum: string;
-    bytes: number;
-}
-interface ShardBinarySource {
-    extracted_text: string;
-    attachment: ShardAttachmentReference;
-}
-/**
- * Reference to one cluster file of a component split across addressable files
- * (`notes/000.jsonl`, `notes/001.jsonl`, …). `offset`/`count` are the record
- * range within the component, so an in-place reader fetches only the clusters a
- * query needs — the shard analog of the AIWG chunk-manifest scan parts.
- */
-interface ShardClusterRef {
-    href: string;
-    offset: number;
-    count: number;
-}
-/**
- * Optional clustered layout (additive — absent on monolithic shards). When a
- * component is present here, its records live in the listed cluster files instead
- * of (or in addition to) the single `<component>.jsonl`. Both `importShard` and
- * the in-place reader consume it; a monolithic shard omits `layout` entirely.
- */
-interface ShardLayout {
-    clusters?: Partial<Record<ShardComponent, ShardClusterRef[]>>;
-}
-/** Manifest included in every shard as manifest.json. */
-interface ShardManifest {
-    version: string;
-    matric_version: string;
-    format: typeof SHARD_FORMAT;
-    created_at: string;
-    components: ShardComponent[];
-    counts: Partial<Record<ShardComponent | 'community_sets', number>>;
-    checksums: Record<string, string>;
-    min_reader_version: string;
-    /** Clustered component layout for partial fetch (issue #189). Absent → monolithic. */
-    layout?: ShardLayout;
-}
-/** Options for shard export. */
-interface ExportOptions {
-    includeEmbeddings?: boolean;
-    /** Filter to specific collection (export only notes in this collection). */
-    collectionId?: string;
-    /** Filter to notes with this tag (e.g. 'app:research' for app-scoped export). */
-    tag?: string;
-    /** Export only these embedding sets and their member/vector rows. */
-    embeddingSetIds?: string[];
-    /** Preserve virtual selector materialization metadata and virtual member rows. */
-    includeMaterializedSelectors?: boolean;
-    /**
-     * When set to a positive integer, emit notes as clustered files
-     * (`notes/000.jsonl`, …) of this many records each, and record the layout in
-     * the manifest, so an in-place reader can fetch only the clusters it needs
-     * (issue #189). Absent → a single monolithic `notes.jsonl` (unchanged).
-     */
-    clusterNotesSize?: number;
-}
-/** Conflict resolution strategy for shard import. */
-type ConflictStrategy = 'skip' | 'replace' | 'error';
-/** Options for shard import. */
-interface ImportOptions {
-    conflictStrategy?: ConflictStrategy;
-    /** Rows processed between cooperative yields. Defaults to 250. */
-    batchSize?: number;
-    /** Progress callback for long-running import phases. */
-    onProgress?: (progress: ImportProgress) => void;
-}
-type ImportProgressPhase = 'unpack' | 'validate' | 'collections' | 'notes' | 'skos' | 'links' | 'provenance' | 'embedding_sets' | 'embeddings' | 'embedding_set_members' | 'graph' | 'communities' | 'index';
-interface ImportProgress {
-    phase: ImportProgressPhase;
-    done: number;
-    total: number;
-}
-/** Per-entity import counts. */
-interface ImportCounts {
-    notes: number;
-    collections: number;
-    tags: number;
-    links: number;
-    embedding_sets: number;
-    embedding_set_members: number;
-    embeddings: number;
-    skos_schemes: number;
-    skos_concepts: number;
-    skos_relations: number;
-    note_skos_tags: number;
-    provenance_edges: number;
-    graph_sources: number;
-    graph_edges: number;
-    community_sets: number;
-    communities: number;
-    community_assignments: number;
-}
-/** Result of a shard import operation. */
-interface ImportResult {
-    success: boolean;
-    counts: ImportCounts;
-    skipped: Partial<ImportCounts>;
-    warnings: string[];
-    errors: string[];
-    duration_ms: number;
-}
-/** Note as serialized in the shard JSONL. */
-interface ShardNote {
-    id: string;
-    title: string | null;
-    original_content: string;
-    revised_content: string | null;
-    binary_sources?: ShardBinarySource[];
-    format: string;
-    source: string;
-    starred: boolean;
-    archived: boolean;
-    tags: string[];
-    created_at: string;
-    updated_at: string;
-    deleted_at: string | null;
-}
-/** Collection as serialized in the shard JSON array. */
-interface ShardCollection {
-    id: string;
-    name: string;
-    description: string | null;
-    parent_id: string | null;
-    created_at: string;
-    note_count?: number;
-}
-/** Tag as serialized in the shard JSON array. */
-interface ShardTag {
-    name: string;
-    created_at: string;
-}
-/** Link as serialized in the shard JSONL. */
-interface ShardLink {
-    id: string;
-    from_note_id: string;
-    to_note_id: string;
-    kind: string;
-    score: number | null;
-    created_at: string;
-    metadata?: Record<string, unknown>;
-}
-/** Embedding set as serialized in the shard JSON array. */
-interface ShardEmbeddingSet {
-    id: string;
-    name?: string;
-    purpose?: string | null;
-    model: string;
-    dimension: number;
-    kind?: 'physical' | 'filter' | 'virtual';
-    mode?: 'auto' | 'manual' | 'mixed' | null;
-    truncate_dimension?: number | null;
-    criteria?: Record<string, unknown> | null;
-    source?: Record<string, unknown> | null;
-    compatibility?: Record<string, unknown> | null;
-    materialization?: Record<string, unknown> | null;
-    freshness?: ShardArtifactFreshness | null;
-    created_at: string;
-    updated_at?: string;
-}
-/** Embedding set member as serialized in the shard JSONL. */
-interface ShardEmbeddingSetMember {
-    embedding_set_id: string;
-    note_id: string;
-    embedding_id: string;
-}
-/** Embedding as serialized in the shard JSONL. */
-interface ShardEmbedding {
-    id: string;
-    note_id: string;
-    embedding_set_id: string;
-    vector: number[];
-    created_at: string;
-}
-/** SKOS scheme as serialized in the shard JSON array. */
-interface ShardSkosScheme {
-    id: string;
-    title: string;
-    description: string | null;
-    created_at: string;
-    updated_at: string;
-}
-/** SKOS concept as serialized in the shard JSON array. */
-interface ShardSkosConcept {
-    id: string;
-    scheme_id: string;
-    pref_label: string;
-    alt_labels: string[];
-    definition: string | null;
-    created_at: string;
-    updated_at: string;
-}
-/** SKOS concept relation as serialized in the shard JSONL. */
-interface ShardSkosRelation {
-    id: string;
-    source_concept_id: string;
-    target_concept_id: string;
-    relation_type: 'broader' | 'narrower' | 'related';
-    created_at: string;
-}
-/** Note-to-SKOS-concept assignment as serialized in the shard JSONL. */
-interface ShardNoteSkosTag {
-    id: string;
-    note_id: string;
-    concept_id: string;
-    created_at: string;
-}
-/** Provenance edge as serialized in the shard JSONL. */
-interface ShardProvenanceEdge {
-    id: string;
-    entity_type: string;
-    entity_id: string;
-    activity: string;
-    agent: string;
-    started_at: string;
-    ended_at: string | null;
-    attributes: Record<string, unknown> | null;
-}
-interface ShardArtifactFreshness {
-    status: 'fresh' | 'stale' | 'unknown';
-    checked_at?: string;
-    stale_reason?: string;
-    source_hashes?: {
-        notes?: string;
-        links?: string;
-        embeddings?: string;
-        embedding_set_members?: string;
-        virtual_set_definition?: string;
-        parameters?: string;
-    };
-}
-
 /**
  * LinksRepository — bidirectional note link management.
  *
@@ -717,7 +483,8 @@ interface BrowserNoteExport {
     deleted_at: Date | string | null;
     original_content: string;
     revised_content: string | null;
-    binary_sources?: ShardBinarySource[];
+    collection_id?: string | null;
+    attachments?: ShardAttachmentProjection[];
     tags: string[];
 }
 /** Convert a browser note to shard format. */
@@ -726,14 +493,26 @@ declare function noteToShard(note: BrowserNoteExport): ShardNote;
 declare function noteFromShard(shard: ShardNote): BrowserNoteExport;
 /** Convert a browser link to shard format. */
 declare function linkToShard(link: LinkRow): ShardLink;
+/** Convert a browser URL-target link row to shard format. */
+declare function urlLinkToShard(link: {
+    id: string;
+    source_note_id: string;
+    to_url: string;
+    link_type: string;
+    confidence: number | null;
+    metadata_json?: Record<string, unknown> | string | null;
+    created_at: Date | string;
+}): ShardLink;
 /** Convert a shard link back to browser-insertable format. */
 declare function linkFromShard(shard: ShardLink): {
     id: string;
     source_note_id: string;
-    target_note_id: string;
+    target_note_id: string | null;
+    to_url: string | null;
     link_type: string;
     confidence: number | null;
     created_at: string;
+    metadata: Record<string, unknown> | null;
 };
 /** Convert a browser collection to shard format. */
 declare function collectionToShard(collection: CollectionRow, noteCount?: number): ShardCollection;
@@ -753,16 +532,29 @@ declare function tagsToShard(allTags: Array<{
     name: string;
     created_at: Date | string;
 }>): ShardTag[];
-/**
- * Convert shard flat tags to browser format for insertion.
- * Returns unique tag names ready for note_tag association.
- */
-declare function tagsFromShard(shardTags: ShardTag[]): string[];
+/** Convert a browser template row to shard format. */
+declare function templateToShard(template: {
+    id: string;
+    name: string;
+    description: string | null;
+    content: string;
+    format: string;
+    default_tags: string[] | string;
+    collection_id: string | null;
+    created_at: Date | string;
+    updated_at: Date | string;
+}): ShardTemplate;
 /** Convert a browser embedding_set to shard format. */
 declare function embeddingSetToShard(set: {
     id: string;
     name?: string;
+    slug?: string | null;
+    description?: string | null;
     purpose?: string | null;
+    document_count?: number | null;
+    embedding_count?: number | null;
+    is_system?: boolean | null;
+    keywords_json?: unknown | null;
     model_name: string;
     dimensions: number;
     kind?: 'physical' | 'filter' | 'virtual';
@@ -777,10 +569,16 @@ declare function embeddingSetToShard(set: {
     updated_at?: Date | string;
 }): ShardEmbeddingSet;
 /** Convert a shard embedding set back to browser format. */
-declare function embeddingSetFromShard(shard: ShardEmbeddingSet): {
+declare function embeddingSetFromShard(shard: ShardEmbeddingSet, fallbackCreatedAt: string): {
     id: string;
     name: string;
+    slug: string | null;
+    description: string | null;
     purpose: string | null;
+    document_count: number | null;
+    embedding_count: number | null;
+    is_system: boolean;
+    keywords_json: string | null;
     model_name: string;
     dimensions: number;
     kind: 'physical' | 'filter' | 'virtual';
@@ -798,23 +596,34 @@ declare function embeddingSetFromShard(shard: ShardEmbeddingSet): {
 declare function embeddingSetMemberToShard(member: {
     embedding_set_id: string;
     note_id: string;
-    embedding_id: string;
+    membership_type?: string | null;
+    added_at?: Date | string | null;
+    added_by?: string | null;
 }): ShardEmbeddingSetMember;
+/** Convert a browser embedding_config row to shard format. */
+declare function embeddingConfigToShard(config: ShardEmbeddingConfig): ShardEmbeddingConfig;
 /** Convert a browser embedding to shard format. */
 declare function embeddingToShard(emb: {
     id: string;
     note_id: string;
     embedding_set_id: string;
+    chunk_index?: number | null;
+    text?: string | null;
     vector: string | number[];
+    model?: string | null;
+    model_name?: string | null;
     created_at: Date | string;
 }): ShardEmbedding;
 /** Convert a shard embedding back to browser format. */
 declare function embeddingFromShard(shard: ShardEmbedding): {
     id: string;
     note_id: string;
-    embedding_set_id: string;
+    embedding_set_id: string | null;
+    chunk_index: number;
+    text: string;
     vector: string;
-    created_at: string;
+    model: string;
+    created_at: string | null;
 };
 declare function skosSchemeToShard(scheme: {
     id: string;
@@ -938,6 +747,8 @@ interface OpenShardOptions {
     semantic?: StaticSemanticProvider;
     /** Bounds the cross-page search match cache (total cached note records). Default 5000. */
     maxCachedMatches?: number;
+    /** Maximum bytes fetched for any unpacked component. Default 256 MiB. */
+    maxComponentBytes?: number;
 }
 /** Reads shard component/cluster files from a packed map or a static base URL. */
 interface ShardComponentStore {
@@ -1039,7 +850,8 @@ interface BackendNoteFull extends BackendNote {
 interface BackendLink {
     id: string;
     fromNoteId: string;
-    toNoteId: string;
+    toNoteId: string | null;
+    toUrl?: string | null;
     kind: string;
     score: number | null;
     createdAt: string;
@@ -1300,6 +1112,20 @@ declare class ArchiveManager {
     private archives;
     private persistence;
     private backendFactory;
+    /**
+     * Persistence is a PLUGGABLE, opt-in backend (issue #261). Pass a
+     * `StorageBackendFactory` to run against any `StorageBackend`
+     * implementation; PGlite is merely the built-in default, selected only when
+     * the convenience `PersistenceMode` string form is used. Because
+     * `defaultStorageBackendFactory` reaches PGlite through the lazily-imported
+     * `createPGliteInstance` (see `db.ts`), a consumer that supplies its own
+     * factory — or never opens an archive at all — never pulls the PGlite WASM
+     * engine into its bundle.
+     *
+     * @param persistenceOrFactory `PersistenceMode` string (uses the built-in
+     *   PGlite backend) OR a custom `StorageBackendFactory`.
+     * @param persistenceOverride persistence hint passed to a custom factory.
+     */
     constructor(persistenceOrFactory: PersistenceMode | StorageBackendFactory, events?: TypedEventBus | undefined, persistenceOverride?: PersistenceMode);
     getCurrentArchiveName(): string;
     getDb(): StorageBackend | null;
@@ -1335,15 +1161,91 @@ interface FortemiCore {
 declare function createFortemi(config: FortemiConfig): FortemiCore;
 
 /**
- * Compute a SHA-256 content hash for the given byte array.
+ * Compute a browser-local content-identity hash (SHA-256), encoded as
+ * `sha256:<64-char lowercase hex>`.
  *
- * Returns a string in `algorithm:hex` format to match the server-side
- * convention, e.g. `sha256:a3b4c5...` (64 hex characters after the prefix).
+ * This is an internal identity/dedup digest used for note content, embedding
+ * configs, the AIWG index, and graph identity — NOT the server's attachment
+ * content-hash convention. Binary-attachment blobs use {@link computeBlobHash}
+ * (BLAKE3), which is the canonical checksum defined by the binary-attachment
+ * projection contract (`checksum: "blake3:<hex>"`). Keeping these two functions
+ * separate preserves JSON format parity for the identity hashes above while
+ * letting attachments match the server's `compute_content_hash`.
  *
  * @param data - Raw bytes to hash
  * @returns `'sha256:<64-char lowercase hex>'`
  */
 declare function computeHash(data: Uint8Array): string;
+/**
+ * Compute the canonical attachment content hash: **BLAKE3**, encoded as
+ * `blake3:<64-char lowercase hex>`.
+ *
+ * Matches the fortemi server (`crates/matric-db/src/file_storage.rs`
+ * `compute_content_hash`) and the portable Knowledge-Shard byte-sidecar
+ * contract, where the sidecar tar entry name is the bare hex (the `blake3:`
+ * prefix stripped). SubtleCrypto has no BLAKE3, so this uses `@noble/hashes`.
+ *
+ * @param data - Raw attachment bytes to hash
+ * @returns `'blake3:<64-char lowercase hex>'`
+ */
+declare function computeBlobHash(data: Uint8Array): string;
+
+declare const FORTEMI_COMPATIBILITY_PATH = "/api/v1/system/compatibility";
+declare const FORTEMI_COMPATIBILITY_STATES: readonly ["available", "degraded", "preview", "unavailable", "unknown"];
+type FortemiCompatibilityState = (typeof FORTEMI_COMPATIBILITY_STATES)[number];
+declare const FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES: readonly ["core_notes", "search", "jobs", "realtime_activity", "hosted_auth", "premium_components", "backoffice_api", "audit_posture", "quota_status", "kms_status", "mcp_scope_gate"];
+type FortemiRequiredCompatibilityCapability = (typeof FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES)[number];
+interface FortemiCompatibilityCapability {
+    state: FortemiCompatibilityState;
+    reason_code?: string;
+}
+interface FortemiCompatibilityResponse {
+    schema_version: number;
+    contract_revision: string;
+    api: {
+        name: string;
+        version: string;
+        minimum_hotm_enterprise_client: string;
+        git_sha_present: boolean;
+        build_date_present: boolean;
+    };
+    deployment: {
+        mode: string;
+        edition: string;
+        hosted_multi_tenant_ready: boolean;
+    };
+    auth: {
+        required: boolean;
+        mode: string;
+        oauth_issuer_configured: boolean;
+        tenant_context_available: boolean;
+    };
+    capabilities: Record<string, FortemiCompatibilityCapability>;
+    links: {
+        openapi: string;
+        asyncapi: string;
+        health: string;
+        streaming_health: string;
+    };
+}
+interface FortemiCompatibilityValidationResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    response?: FortemiCompatibilityResponse;
+}
+interface FetchFortemiCompatibilityOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}
+declare function fortemiCompatibilityUrl(baseUrl?: string): string;
+declare function validateFortemiCompatibilityResponse(raw: unknown): FortemiCompatibilityValidationResult;
+declare function formatFortemiCompatibilitySummary(response: FortemiCompatibilityResponse): string;
+declare function fetchAndValidateFortemiCompatibility(options?: FetchFortemiCompatibilityOptions): Promise<FortemiCompatibilityValidationResult & {
+    url: string;
+    status?: number;
+}>;
 
 interface SWRegistrationResult {
     registered: boolean;
@@ -1377,36 +1279,6 @@ declare function createRoutes(): RouteHandler[];
  */
 declare function matchRoute(routes: RouteHandler[], request: Request, url: URL): RouteHandler | null;
 
-/**
- * Content-addressable blob storage.
- *
- * Path format: blobs/{dir1}/{dir2}/{hash}
- *   dir1 = first 2 hex chars of hash
- *   dir2 = next 2 hex chars of hash
- *   filename = full hash
- *
- * Two implementations are provided:
- *   - OpfsBlobStore  — Origin Private File System (Chrome/Edge 86+)
- *   - IdbBlobStore   — IndexedDB fallback (Firefox, Safari)
- *
- * Use createBlobStore() to get the best available implementation.
- * Export MemoryBlobStore for use in tests.
- */
-interface BlobStore {
-    write(hash: string, data: Uint8Array): Promise<void>;
-    read(hash: string): Promise<Uint8Array | null>;
-    remove(hash: string): Promise<void>;
-    exists(hash: string): Promise<boolean>;
-}
-declare class MemoryBlobStore implements BlobStore {
-    private store;
-    write(hash: string, data: Uint8Array): Promise<void>;
-    read(hash: string): Promise<Uint8Array | null>;
-    remove(hash: string): Promise<void>;
-    exists(hash: string): Promise<boolean>;
-}
-declare function createBlobStore(archiveName: string): BlobStore;
-
 /**
  * Shared postMessage protocol types for the PGlite worker.
  *
@@ -2776,9 +2648,11 @@ declare class AttachmentsRepository {
     /**
      * Attach a binary file to a note.
      *
-     * If a blob with the same SHA-256 content hash already exists, the existing
+     * If a blob with the same BLAKE3 content hash already exists, the existing
      * blob row is reused (deduplication). Otherwise a new blob row is inserted
-     * and the raw bytes are written to the BlobStore.
+     * and the raw bytes are written to the BlobStore. The BLAKE3 `content_hash`
+     * (`blake3:<hex>`) matches the server convention and is the key used by the
+     * portable Knowledge-Shard byte sidecar.
      *
      * Returns the newly created AttachmentRow.
      */
@@ -3574,14 +3448,25 @@ declare function createCspReportHandler(onReport: (report: CspViolationReport) =
  * @param files Map of filename → file contents
  * @returns Compressed archive bytes (suitable for .shard file)
  */
-declare function packTarGz(files: Map<string, Uint8Array>): Uint8Array;
+declare function packTarGz(files: Map<string, Uint8Array>, opts?: {
+    maxDecompressedBytes?: number;
+}): Uint8Array;
 /**
  * Unpack a gzip-compressed tar archive.
  *
+ * Before decompressing, the gzip ISIZE footer (declared uncompressed size) is
+ * checked against `maxDecompressedBytes` and rejected if it exceeds the cap.
+ * fflate independently verifies the actual output length against ISIZE, so a
+ * lying footer fails during decompression — together this bounds the memory a
+ * malicious archive can force us to allocate.
+ *
  * @param data Compressed archive bytes
+ * @param opts.maxDecompressedBytes Cap on decompressed size (default 256 MiB)
  * @returns Map of filename → file contents
  */
-declare function unpackTarGz(data: Uint8Array): Map<string, Uint8Array>;
+declare function unpackTarGz(data: Uint8Array, opts?: {
+    maxDecompressedBytes?: number;
+}): Map<string, Uint8Array>;
 
 /**
  * SHA-256 checksum utilities for shard integrity verification.
@@ -3595,6 +3480,15 @@ declare function sha256Hex(data: Uint8Array): Promise<string>;
 /**
  * Validate checksums listed in a shard manifest against actual file contents.
  *
+ * SECURITY (SEC7 — trust model): these checksums live *inside* the same archive
+ * as the files they hash, so they detect **transport corruption**, not
+ * **tampering**. An attacker who controls the archive controls both the file
+ * bytes and the manifest hashes, so a passing result proves the archive is
+ * internally consistent — nothing more. For provenance-sensitive imports, verify
+ * integrity out-of-band: a signed manifest, or a caller-supplied expected digest
+ * checked against the whole archive (see `prefetchShard`'s `expectedSha256`,
+ * which is real integrity because the hash arrives on a separate channel).
+ *
  * @returns Object with `valid` flag and list of failed filenames.
  */
 declare function validateChecksums(checksums: Record<string, string>, files: Map<string, Uint8Array>): Promise<{
@@ -3637,6 +3531,17 @@ declare function exportShard(db: DatabaseClient, options?: ExportOptions): Promi
  */
 declare function importShard(db: DatabaseClient, data: Uint8Array | ArrayBuffer, options?: ImportOptions): Promise<ImportResult>;
 
+interface ShardSchemaValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+type ShardFiles = Map<string, Uint8Array>;
+declare function getKnowledgeShardSchema(): unknown;
+declare function validateShardManifest(value: unknown): ShardSchemaValidationResult;
+declare function validateShardArchive(input: Uint8Array | ArrayBuffer | ShardFiles): ShardSchemaValidationResult;
+declare function validateShardComponentRecord(component: ShardComponent | 'templates', value: unknown): ShardSchemaValidationResult;
+declare function assertShardComponentRecord(component: ShardComponent | 'templates', value: unknown): void;
+
 /**
  * Pluggable semantic providers for the in-place shard reader (issue #189).
  *
@@ -3803,6 +3708,14 @@ declare function getPrefetchedSha256(url: string): string | undefined;
  */
 declare function clearPrefetchedShard(url?: string): void;
 
-declare const VERSION = "2026.7.2";
+interface AiwgIndexSchemaValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+declare function getAiwgFortemiIndexExportSchema(): unknown;
+declare function validateAiwgFortemiIndexExportSchema(value: unknown): AiwgIndexSchemaValidationResult;
+declare function validateAiwgFortemiProjectedRecordSchema(value: unknown): AiwgIndexSchemaValidationResult;
+
+declare const VERSION = "2026.7.4";
 
-export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BackendCandidate, type BackendCapabilities, type BackendConcept, type BackendLink, type BackendListOptions, type BackendNote, type BackendNoteFull, type BackendProvenanceEdge, type BackendRequest, type BackendSearchHit, type BackendSearchQueryOptions, type BackendSearchResult, type BackendSelection, type BackendSemanticTier, type BackendStartupCost, type BlobStore, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionRow, CollectionsRepository, CommunitiesRepository, type CommunityAssignmentView, type CommunityCreateInput, type CommunityFilterDefinition, type CommunityGraph, type CommunityOptions, type CommunitySourceDescriptor, type CommunitySourceType, type CommunitySummary, type CompletionRequest, type CompletionResponse, type ConditionResult, type ConflictStrategy, type CooldownConfig, type CooldownEvent, type CosineSemanticProviderOptions, type CreatePGliteOptions, type CspDirectiveName, type CspDirectives, type CspViolationReport, DB_SNAPSHOT_SCHEMA_VERSION, type DataBackend, type DatabaseClient, type DbSnapshot, type DbSnapshotCompat, type DbSnapshotCompression, type DbSnapshotExpectations, type DbSnapshotMeta, type DbSnapshotSource, DbSnapshotVersionError, type DiscoveredProvider, type DiscoveryOptions, type DumpDbSnapshotOptions, type DumpableDb, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, type EmbedFunction, type EmbedRequest, type EmbedRequestMessage, type EmbedResponse, type EmbedResponseMessage, type EmbedTransportPort, type EmbedWorkerOptions, type EmbeddingCompatibilityPolicy, type EmbeddingSetCreateInput, type EmbeddingSetCriteria, type EmbeddingSetDescriptor, type EmbeddingSetEmbeddingInput, type EmbeddingSetFreshness, type EmbeddingSetKind, type EmbeddingSetMode, type EmbeddingSetRow, type EmbeddingSetSelector, EmbeddingSetsRepository, type EnqueueJobInput, type ErrorCategory, type EventMap, type ExportOptions, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FortemiBridge, type FortemiBridgeCapabilities, type FortemiBridgeHost, type FortemiConfig, type FortemiCore, type FortemiInferenceRouter, type FortemiSecretStore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type GraphCommunity, type GraphEdge, type GraphNode, GraphRepository, type IDisposable, type ImportCounts, type ImportOptions, type ImportProgress, type ImportProgressPhase, type ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, LOCAL_ENDPOINTS, type LinkRow, LinksRepository, type ListNotesInput, ListNotesInputSchema, type LlmCapabilityOptions, type LlmCompleteFn, type LoadedPluginScript, type LocalEndpoint, type ManageArchiveInput, ManageArchiveInputSchema, type ManageArchiveResult, type ManageAttachmentsInput, ManageAttachmentsInputSchema, type ManageAttachmentsResult, type ManageCapabilitiesInput, ManageCapabilitiesInputSchema, type ManageCapabilitiesResult, type ManageCollectionsInput, ManageCollectionsInputSchema, type ManageCollectionsResult, type ManageLinksInput, ManageLinksInputSchema, type ManageLinksResult, type ManageNoteInput, ManageNoteInputSchema, type ManageNoteResult, type ManageTagsInput, ManageTagsInputSchema, type ManageTagsResult, MemoryBlobStore, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteRevision, type NoteSkosTag, type NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, type OpenShardOptions, type PGliteBackendOptions, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, type PGliteWorkerStorageBackendFactoryOptions, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type PrefetchOptions, type PrefetchResult, type ProbeResult, type ProbeStatus, type ProvenanceEdge, ProvenanceRepository, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type RecordProvenanceInput, type RemoteBackendConfig, type RemoteBackendPaths, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RestoreDbSnapshotOptions, type RouteHandler, SHARD_FORMAT, SUPPORTED_PGLITE_VERSION, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardBackendOptions, type ShardClusterRef, type ShardCollection, type ShardComponent, type ShardComponentStore, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLayout, type ShardLink, type ShardListOptions, type ShardManifest, type ShardNote, type ShardNoteFull, type ShardNoteSkosTag, type ShardProvenanceEdge, type ShardReader, type ShardReaderNote, type ShardReaderSource, type ShardSearchOptions, type ShardSearchRankedNote, type ShardSearchResult, type ShardSearchWeights, type ShardSkosConcept, type ShardSkosRelation, type ShardSkosScheme, type ShardTag, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StaticSemanticProvider, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VectorEntry, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createBlobStore, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRemoteBackend, createRoutes, createShardBackend, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dumpDbSnapshot, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, fromPrefetched, generateId, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, isPluginScriptAllowed, isShardPrefetched, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, provenanceEdgeToShard, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifyDbSnapshotMeta, verifySri };
+export { type AiwgIndexSchemaValidationResult, type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BackendCandidate, type BackendCapabilities, type BackendConcept, type BackendLink, type BackendListOptions, type BackendNote, type BackendNoteFull, type BackendProvenanceEdge, type BackendRequest, type BackendSearchHit, type BackendSearchQueryOptions, type BackendSearchResult, type BackendSelection, type BackendSemanticTier, type BackendStartupCost, BlobStore, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, CURRENT_MIGRATION_HEAD, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionRow, CollectionsRepository, CommunitiesRepository, type CommunityAssignmentView, type CommunityCreateInput, type CommunityFilterDefinition, type CommunityGraph, type CommunityOptions, type CommunitySourceDescriptor, type CommunitySourceType, type CommunitySummary, type CompletionRequest, type CompletionResponse, type ConditionResult, type CooldownConfig, type CooldownEvent, type CosineSemanticProviderOptions, type CreatePGliteOptions, type CspDirectiveName, type CspDirectives, type CspViolationReport, DB_SNAPSHOT_SCHEMA_VERSION, type DataBackend, type DatabaseClient, type DbSnapshot, type DbSnapshotCompat, type DbSnapshotCompression, type DbSnapshotExpectations, type DbSnapshotMeta, type DbSnapshotSource, DbSnapshotVersionError, type DiscoveredProvider, type DiscoveryOptions, type DumpDbSnapshotOptions, type DumpableDb, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, type EmbedFunction, type EmbedRequest, type EmbedRequestMessage, type EmbedResponse, type EmbedResponseMessage, type EmbedTransportPort, type EmbedWorkerOptions, type EmbeddingCompatibilityPolicy, type EmbeddingSetCreateInput, type EmbeddingSetCriteria, type EmbeddingSetDescriptor, type EmbeddingSetEmbeddingInput, type EmbeddingSetFreshness, type EmbeddingSetKind, type EmbeddingSetMode, type EmbeddingSetRow, type EmbeddingSetSelector, EmbeddingSetsRepository, type EnqueueJobInput, type ErrorCategory, type EventMap, ExportOptions, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FetchFortemiCompatibilityOptions, type FortemiBridge, type FortemiBridgeCapabilities, type FortemiBridgeHost, type FortemiCompatibilityCapability, type FortemiCompatibilityResponse, type FortemiCompatibilityState, type FortemiCompatibilityValidationResult, type FortemiConfig, type FortemiCore, type FortemiInferenceRouter, type FortemiRequiredCompatibilityCapability, type FortemiSecretStore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type GraphCommunity, type GraphEdge, type GraphNode, GraphRepository, type IDisposable, ImportOptions, ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, LOCAL_ENDPOINTS, type LinkRow, LinksRepository, type ListNotesInput, ListNotesInputSchema, type LlmCapabilityOptions, type LlmCompleteFn, type LoadedPluginScript, type LocalEndpoint, type ManageArchiveInput, ManageArchiveInputSchema, type ManageArchiveResult, type ManageAttachmentsInput, ManageAttachmentsInputSchema, type ManageAttachmentsResult, type ManageCapabilitiesInput, ManageCapabilitiesInputSchema, type ManageCapabilitiesResult, type ManageCollectionsInput, ManageCollectionsInputSchema, type ManageCollectionsResult, type ManageLinksInput, ManageLinksInputSchema, type ManageLinksResult, type ManageNoteInput, ManageNoteInputSchema, type ManageNoteResult, type ManageTagsInput, ManageTagsInputSchema, type ManageTagsResult, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteRevision, type NoteSkosTag, type NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, type OpenShardOptions, type PGliteBackendOptions, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, type PGliteWorkerStorageBackendFactoryOptions, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type PrefetchOptions, type PrefetchResult, type ProbeResult, type ProbeStatus, type ProvenanceEdge, ProvenanceRepository, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type RecordProvenanceInput, type RemoteBackendConfig, type RemoteBackendPaths, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RestoreDbSnapshotOptions, type RouteHandler, SUPPORTED_PGLITE_VERSION, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardBackendOptions, ShardCollection, ShardComponent, type ShardComponentStore, ShardEmbedding, ShardEmbeddingConfig, ShardEmbeddingSet, ShardEmbeddingSetMember, ShardLink, type ShardListOptions, ShardManifest, ShardNote, type ShardNoteFull, ShardNoteSkosTag, ShardProvenanceEdge, type ShardReader, type ShardReaderNote, type ShardReaderSource, type ShardSchemaValidationResult, type ShardSearchOptions, type ShardSearchRankedNote, type ShardSearchResult, type ShardSearchWeights, ShardSkosConcept, ShardSkosRelation, ShardSkosScheme, ShardTag, ShardTemplate, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StaticSemanticProvider, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VectorEntry, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, assertShardComponentRecord, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeBlobHash, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRemoteBackend, createRoutes, createShardBackend, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchAndValidateFortemiCompatibility, fetchPluginScript, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiIndexExportSchema, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, isPluginScriptAllowed, isShardPrefetched, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, provenanceEdgeToShard, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, urlLinkToShard, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateChecksums, validateFortemiCompatibilityResponse, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifySri };