@fortemi/core 2026.6.3 → 2026.6.4

package/README.md

@@ -4,7 +4,7 @@
 
 **Headless browser knowledge-management core powered by PGlite, typed repositories, semantic retrieval, and agent tool helpers**
 
-Build local-first knowledge apps with PostgreSQL-compatible storage in the browser, production-ready repositories, search primitives, Knowledge Shard portability, optional local AI wiring, and bridge-ready tool metadata.
+Build local-first knowledge apps where data stays in the browser on the user's device — no server, no account — with PostgreSQL-compatible storage, production-ready repositories, hybrid search primitives, portable Knowledge Shard archives, opt-in bring-your-own AI wiring, and bridge-ready tool metadata.
 
 ```bash
 pnpm add @fortemi/core

package/dist/index.d.ts

@@ -1468,19 +1468,19 @@ declare const CaptureKnowledgeInputSchema: z.ZodObject<{
     }, {
         content: string;
         title?: string | undefined;
-        tags?: string[] | undefined;
         format?: "markdown" | "plain" | "html" | undefined;
+        tags?: string[] | undefined;
     }>, "many">>;
     template: z.ZodOptional<z.ZodString>;
     variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     source: string;
     format: "markdown" | "plain" | "html";
-    visibility: "private" | "public" | "shared";
+    visibility: "private" | "shared" | "public";
     action: "create" | "bulk_create" | "from_template";
     title?: string | undefined;
-    tags?: string[] | undefined;
     archive_id?: string | undefined;
+    tags?: string[] | undefined;
     content?: string | undefined;
     notes?: {
         format: "markdown" | "plain" | "html";
@@ -1494,16 +1494,16 @@ declare const CaptureKnowledgeInputSchema: z.ZodObject<{
     action: "create" | "bulk_create" | "from_template";
     source?: string | undefined;
     title?: string | undefined;
-    tags?: string[] | undefined;
     archive_id?: string | undefined;
     format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "public" | "shared" | undefined;
+    visibility?: "private" | "shared" | "public" | undefined;
+    tags?: string[] | undefined;
     content?: string | undefined;
     notes?: {
         content: string;
         title?: string | undefined;
-        tags?: string[] | undefined;
         format?: "markdown" | "plain" | "html" | undefined;
+        tags?: string[] | undefined;
     }[] | undefined;
     template?: string | undefined;
     variables?: Record<string, string> | undefined;
@@ -1548,35 +1548,35 @@ declare const SearchInputSchema: z.ZodObject<{
     visibility: z.ZodOptional<z.ZodEnum<["private", "shared", "public"]>>;
     include_facets: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    query: string;
-    offset: number;
     limit: number;
+    offset: number;
     include_facets: boolean;
-    mode: "text" | "semantic" | "hybrid";
+    mode: "semantic" | "text" | "hybrid";
+    query: string;
     source?: string | undefined;
-    tags?: string[] | undefined;
     format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "public" | "shared" | undefined;
+    visibility?: "private" | "shared" | "public" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
+    tags?: string[] | undefined;
     collection_id?: string | undefined;
     date_from?: Date | undefined;
     date_to?: Date | undefined;
 }, {
     query: string;
     source?: string | undefined;
-    tags?: string[] | undefined;
-    offset?: number | undefined;
     format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "public" | "shared" | undefined;
+    visibility?: "private" | "shared" | "public" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
+    tags?: string[] | undefined;
     limit?: number | undefined;
+    offset?: number | undefined;
     collection_id?: string | undefined;
     date_from?: Date | undefined;
     date_to?: Date | undefined;
     include_facets?: boolean | undefined;
-    mode?: "text" | "semantic" | "hybrid" | undefined;
+    mode?: "semantic" | "text" | "hybrid" | undefined;
 }>;
 type SearchInput = z.infer<typeof SearchInputSchema>;
 
@@ -1654,22 +1654,22 @@ declare const ListNotesInputSchema: z.ZodObject<{
     collection_id: z.ZodOptional<z.ZodString>;
     include_deleted: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    sort: "title" | "updated_at" | "created_at";
-    offset: number;
+    sort: "created_at" | "updated_at" | "title";
     limit: number;
+    offset: number;
     order: "asc" | "desc";
-    tags?: string[] | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
+    tags?: string[] | undefined;
     include_deleted?: boolean | undefined;
     collection_id?: string | undefined;
 }, {
-    tags?: string[] | undefined;
-    sort?: "title" | "updated_at" | "created_at" | undefined;
-    offset?: number | undefined;
+    sort?: "created_at" | "updated_at" | "title" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
+    tags?: string[] | undefined;
     limit?: number | undefined;
+    offset?: number | undefined;
     order?: "asc" | "desc" | undefined;
     include_deleted?: boolean | undefined;
     collection_id?: string | undefined;
@@ -1683,12 +1683,12 @@ declare const ManageTagsInputSchema: z.ZodObject<{
     tag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     action: "add" | "remove" | "list_for_note" | "list_all";
-    tag?: string | undefined;
     note_id?: string | undefined;
+    tag?: string | undefined;
 }, {
     action: "add" | "remove" | "list_for_note" | "list_all";
-    tag?: string | undefined;
     note_id?: string | undefined;
+    tag?: string | undefined;
 }>;
 type ManageTagsInput = z.infer<typeof ManageTagsInputSchema>;
 interface ManageTagsResult {
@@ -2041,13 +2041,142 @@ declare function cosineSimilarity(a: number[], b: number[]): number;
  */
 declare function suggestTags(noteEmbedding: number[], tagEmbeddings: Map<string, number[]>, threshold?: number, maxTags?: number): string[];
 
+/**
+ * Off-main-thread query-embedding transport for the semantic capability.
+ *
+ * The semantic capability consumes a single `EmbedFunction`
+ * (`(texts: string[]) => Promise<number[][]>`). With `executionMode="worker"`
+ * (#146) the PGlite DB + HNSW query run off the main thread, but a
+ * main-thread `EmbedFunction` closure still blocks the UI: model load janks
+ * first paint of search, and every per-query embed blocks input.
+ *
+ * This module lets the host run the embed function inside a Worker (or behind
+ * a MessagePort) so semantic search is off-thread end-to-end. Core posts
+ * `{ texts }` to the port and awaits `number[][]`; the host owns the worker,
+ * the model, and the model params (so build-time corpus embeddings stay an
+ * exact match: `Xenova/all-MiniLM-L6-v2`, fp32, `{ pooling:'mean', normalize:true }`,
+ * 384-d).
+ *
+ * Two halves:
+ *  - {@link createWorkerEmbedFunction} — main-thread side. Wraps a transport
+ *    into an `EmbedFunction` that round-trips each request to the worker.
+ *  - {@link handleEmbedRequests} — worker side. Wires a host-owned
+ *    `(texts) => Promise<number[][]>` to the message protocol.
+ *
+ * The existing main-thread `registerSemanticCapability(manager, embedFn)` path
+ * is unchanged. This transport is additive and opt-in.
+ *
+ * @implements #180 off-main-thread / pluggable query-embedding transport
+ */
+
+/**
+ * Minimal transport contract satisfied by both `Worker` and `MessagePort`.
+ * Core only needs to post messages and listen for replies.
+ */
+interface EmbedTransportPort {
+    postMessage(message: unknown): void;
+    addEventListener(type: 'message', listener: (event: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: 'message', listener: (event: {
+        data: unknown;
+    }) => void): void;
+    /** MessagePort requires start() when using addEventListener; Worker does not. */
+    start?(): void;
+}
+/** Message discriminators for the embed protocol. */
+declare const EMBED_REQUEST_KIND: "fortemi:embed:request";
+declare const EMBED_RESPONSE_KIND: "fortemi:embed:response";
+/** Request posted by core (main thread) to the worker. */
+interface EmbedRequestMessage {
+    kind: typeof EMBED_REQUEST_KIND;
+    id: number;
+    texts: string[];
+}
+/** Reply posted by the worker back to core. Exactly one of `vectors`/`error`. */
+interface EmbedResponseMessage {
+    kind: typeof EMBED_RESPONSE_KIND;
+    id: number;
+    vectors?: number[][];
+    error?: string;
+}
+/** Options for the main-thread worker embed function. */
+interface EmbedWorkerOptions {
+    /**
+     * Per-request timeout in milliseconds. A request that receives no reply
+     * within this window rejects with a timeout error. Set to `0` to disable.
+     * Default: 30000 (30s).
+     */
+    timeoutMs?: number;
+}
+/**
+ * Wrap a Worker/MessagePort transport into an `EmbedFunction` (main-thread side).
+ *
+ * Each `embed(texts)` call posts an {@link EmbedRequestMessage} with a unique id
+ * and resolves when the matching {@link EmbedResponseMessage} arrives. The
+ * message listener is attached immediately and removed by `dispose()`.
+ *
+ * @param port - A `Worker`, `MessagePort`, or any {@link EmbedTransportPort}.
+ * @param options - Optional timeout configuration.
+ * @returns The `embed` function and a `dispose` cleanup (removes the listener
+ *          and rejects any in-flight requests).
+ *
+ * @example
+ * ```ts
+ * const worker = new Worker(new URL('./queryEmbed.worker.ts', import.meta.url), { type: 'module' })
+ * const { embed, dispose } = createWorkerEmbedFunction(worker)
+ * setEmbedFunction(embed) // query + job embedding now run off-thread
+ * // later: dispose(); worker.terminate()
+ * ```
+ */
+declare function createWorkerEmbedFunction(port: EmbedTransportPort, options?: EmbedWorkerOptions): {
+    embed: EmbedFunction;
+    dispose: () => void;
+};
+/**
+ * Wire a host-owned embed function to the message protocol (worker side).
+ *
+ * Call this inside the worker (or behind a MessagePort) with the function that
+ * loads the model and runs inference. It answers each {@link EmbedRequestMessage}
+ * with an {@link EmbedResponseMessage}.
+ *
+ * @param port - The worker scope (`self`) or a `MessagePort`.
+ * @param embed - The host embed function `(texts) => Promise<number[][]>`.
+ * @returns A disposer that removes the listener.
+ *
+ * @example
+ * ```ts
+ * // queryEmbed.worker.ts
+ * import { handleEmbedRequests } from '@fortemi/core'
+ * import { pipeline } from '@huggingface/transformers'
+ *
+ * const extractor = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2')
+ * handleEmbedRequests(self as unknown as EmbedTransportPort, async (texts) => {
+ *   const out = await Promise.all(
+ *     texts.map(async (t) => {
+ *       const r = await extractor(t, { pooling: 'mean', normalize: true })
+ *       return Array.from(r.data as Float32Array)
+ *     }),
+ *   )
+ *   return out
+ * })
+ * ```
+ */
+declare function handleEmbedRequests(port: EmbedTransportPort, embed: EmbedFunction): () => void;
+
 /**
  * Semantic capability loader — registers the embedding pipeline with CapabilityManager.
  *
  * In production (browser), this loads @huggingface/transformers in a Web Worker.
  * In tests, call registerSemanticCapability() with a mock embed function.
  *
+ * Two registration paths, both additive:
+ *  - registerSemanticCapability(manager, embedFn) — main-thread embed closure.
+ *  - registerSemanticCapabilityWorker(manager, port) — off-main-thread embed
+ *    transport (#180), so semantic search runs off-thread end-to-end.
+ *
  * @implements #62 semantic capability loader
+ * @implements #180 off-main-thread / pluggable query-embedding transport
  */
 
 /**
@@ -2060,8 +2189,31 @@ declare function suggestTags(noteEmbedding: number[], tagEmbeddings: Map<string,
  */
 declare function registerSemanticCapability(manager: CapabilityManager, embedFn: EmbedFunction, onProgress?: (pct: number) => void): void;
 /**
- * Unregister the semantic capability — clears the embed function.
- * Called when the capability is disabled.
+ * Register the semantic capability backed by an off-main-thread transport (#180).
+ *
+ * The embed function round-trips each request to a host-owned Worker/MessagePort,
+ * so model load and per-query inference never touch the main thread. The host
+ * owns the worker and the model params (build-time corpus match stays exact).
+ *
+ * The loader runs when `capabilityManager.enable('semantic')` is invoked; the
+ * message listener is attached then and removed on
+ * {@link unregisterSemanticCapability} (i.e. on `disable`).
+ *
+ * @param manager - The CapabilityManager instance.
+ * @param port - A `Worker`, `MessagePort`, or any {@link EmbedTransportPort}.
+ * @param options - Optional transport options (e.g. per-request timeout).
+ *
+ * @example
+ * ```ts
+ * const worker = new Worker(new URL('./queryEmbed.worker.ts', import.meta.url), { type: 'module' })
+ * registerSemanticCapabilityWorker(capabilityManager, worker)
+ * await capabilityManager.enable('semantic') // off-thread end-to-end
+ * ```
+ */
+declare function registerSemanticCapabilityWorker(manager: CapabilityManager, port: EmbedTransportPort, options?: EmbedWorkerOptions): void;
+/**
+ * Unregister the semantic capability — clears the embed function and tears down
+ * any active off-main-thread transport. Called when the capability is disabled.
  */
 declare function unregisterSemanticCapability(): void;
 
@@ -2928,6 +3080,129 @@ declare function exportShard(db: DatabaseClient, options?: ExportOptions): Promi
  */
 declare function importShard(db: DatabaseClient, data: Uint8Array | ArrayBuffer, options?: ImportOptions): Promise<ImportResult>;
 
-declare const VERSION = "2026.6.2";
+/**
+ * Shard warm / prefetch API — pre-stage and (optionally) verify shard bytes
+ * without building the index.
+ *
+ * Staged corpus loading (text-first, then opt-in summary vectors, then opt-in
+ * full content) wants the operator's hard rule honored: **no blocking waits**.
+ * The HNSW index build has to happen on the user's click (it is heavy and is
+ * shown with progress — that is correct). The *download* of the shard bytes
+ * does not: it can be warmed in the background on idle so the click is purely
+ * the index build.
+ *
+ * fortemi-react is server-free and local-first — shards are **static assets**
+ * (typically generated at build time and served as static files, or bundled
+ * and handed in directly as bytes). `prefetchShard` warms those static bytes;
+ * it does not assume any API/server. The eventual `importShard` reads the warm
+ * bytes via {@link fromPrefetched}, so import is just the index build.
+ *
+ * Two-layer integrity:
+ *  - `prefetchShard(url, { expectedSha256 })` verifies the whole-archive SHA-256
+ *    against a build-time-known hash (emitted alongside the static shard).
+ *  - `importShard` still validates the per-file checksums inside the manifest
+ *    on import. Both layers share core's `sha256Hex`.
+ *
+ * @implements #181 prefetchShard / shard warm API
+ */
+/** Options for {@link prefetchShard}. */
+interface PrefetchOptions {
+    /**
+     * Provide the shard bytes directly instead of fetching `url` — e.g. a
+     * build-time-generated `.shard` imported as a bundled asset. The `url` is
+     * still used as the warm-store key. When set, no network/disk fetch happens.
+     */
+    bytes?: ArrayBuffer | Uint8Array;
+    /**
+     * Compute the SHA-256 of the warmed bytes (stored on the result and in the
+     * warm store). Implied when `expectedSha256` is set.
+     */
+    verify?: boolean;
+    /**
+     * Build-time-known SHA-256 (hex) of the whole shard archive. When set, the
+     * warmed bytes are verified against it and a mismatch throws — nothing is
+     * stored. Case-insensitive.
+     */
+    expectedSha256?: string;
+    /**
+     * Fetch implementation to use. Defaults to `globalThis.fetch`. Inject for
+     * tests or non-standard environments.
+     */
+    fetchImpl?: typeof fetch;
+    /**
+     * Also persist the warmed bytes to the Cache Storage API so warmth survives
+     * a reload. Feature-detected — a no-op when `caches` is unavailable (e.g.
+     * Node, or a worker without Cache access).
+     */
+    useCacheStorage?: boolean;
+    /** Cache Storage cache name. Default: `'fortemi-shards'`. */
+    cacheName?: string;
+    /** Abort signal forwarded to the fetch. */
+    signal?: AbortSignal;
+}
+/** Result of a {@link prefetchShard} call. */
+interface PrefetchResult {
+    /** The warm-store key (the `url` passed to prefetchShard). */
+    url: string;
+    /** The warmed shard bytes (also retrievable via {@link fromPrefetched}). */
+    bytes: Uint8Array;
+    /** Convenience: `bytes.byteLength`. */
+    byteLength: number;
+    /** SHA-256 hex of the warmed bytes when computed (`verify` or `expectedSha256`), else `undefined`. */
+    sha256?: string;
+    /** True when the bytes came from the Cache Storage API rather than a fresh fetch. */
+    fromCache: boolean;
+}
+/**
+ * Pre-stage shard bytes into the warm store without building the index.
+ *
+ * Resolution order for the bytes:
+ *  1. `options.bytes` (a directly-provided / bundled asset), else
+ *  2. the Cache Storage API (when `useCacheStorage` and a prior write exists), else
+ *  3. `fetch(url)` of the static asset.
+ *
+ * Concurrent calls for the same `url` (without `options.bytes`) share a single
+ * fetch. On `expectedSha256` mismatch the call throws and nothing is stored.
+ *
+ * @param url - Static asset URL (also the warm-store key).
+ * @param options - See {@link PrefetchOptions}.
+ * @returns The warm result (bytes are also retrievable via {@link fromPrefetched}).
+ *
+ * @example
+ * ```ts
+ * // Warm on idle so the user's opt-in click is just the index build.
+ * requestIdleCallback(() => {
+ *   void prefetchShard('/shards/research.shard', { expectedSha256: RESEARCH_SHARD_SHA256 })
+ * })
+ * // ...later, on click:
+ * await importShard(db, fromPrefetched('/shards/research.shard'), { onProgress })
+ * ```
+ */
+declare function prefetchShard(url: string, options?: PrefetchOptions): Promise<PrefetchResult>;
+/**
+ * Return previously-warmed shard bytes for `url`, ready to hand to `importShard`.
+ *
+ * @throws If the url was not prefetched (call {@link prefetchShard} first).
+ *
+ * @example
+ * ```ts
+ * await importShard(db, fromPrefetched('/shards/research.shard'), { onProgress })
+ * ```
+ */
+declare function fromPrefetched(url: string): Uint8Array;
+/** Whether `url` has warm bytes in the in-memory store. */
+declare function isShardPrefetched(url: string): boolean;
+/** The computed SHA-256 (hex) of a warmed shard, if it was verified/hashed. */
+declare function getPrefetchedSha256(url: string): string | undefined;
+/**
+ * Evict warm bytes from the in-memory store. With no argument, clears all.
+ *
+ * Note: this does not delete Cache Storage entries — those persist by design
+ * (that is the cross-reload warmth). Manage the Cache Storage cache directly if
+ * you need to evict it.
+ */
+declare function clearPrefetchedShard(url?: string): void;
+
+declare const VERSION = "2026.6.4";
 
-export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BlobStore, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, 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 CspDirectiveName, type CspDirectives, type CspViolationReport, type DatabaseClient, type DiscoveredProvider, type DiscoveryOptions, type EmbedFunction, type EmbedRequest, type EmbedResponse, 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 NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, type PGliteWorkerStorageBackendFactoryOptions, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type ProbeResult, type ProbeStatus, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RouteHandler, SHARD_FORMAT, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardCollection, type ShardComponent, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLink, type ShardManifest, type ShardNote, type ShardNoteSkosTag, type ShardProvenanceEdge, type ShardSkosConcept, type ShardSkosRelation, type ShardSkosScheme, type ShardTag, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createBlobStore, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, generateId, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getLlmFunction, getNote, hasFortemiSecureSecrets, importShard, isPluginScriptAllowed, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteSkosTagToShard, noteToShard, packTarGz, parseCspReport, provenanceEdgeToShard, registerLlmCapability, registerSemanticCapability, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifySri };
+export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BlobStore, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, 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 CspDirectiveName, type CspDirectives, type CspViolationReport, type DatabaseClient, type DiscoveredProvider, type DiscoveryOptions, 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 NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, 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 ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RouteHandler, SHARD_FORMAT, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardCollection, type ShardComponent, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLink, type ShardManifest, type ShardNote, type ShardNoteSkosTag, type ShardProvenanceEdge, type ShardSkosConcept, type ShardSkosRelation, type ShardSkosScheme, type ShardTag, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, 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, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, 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, packTarGz, parseCspReport, prefetchShard, provenanceEdgeToShard, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifySri };