@hraness/oh 0.2.3

package/dist/search.d.ts

@@ -0,0 +1,34 @@
+import type { KnowledgeGraphRecordV1 } from "./graph";
+import type { OhSemanticSearchBackendV1 } from "./semantic";
+import type { OhSqliteStore } from "./sqlite/store";
+export type OhSearchModeV1 = "hybrid" | "keyword" | "semantic";
+export type OhSearchDiagnosticV1 = Readonly<{
+    code: "semantic-unavailable";
+    message: string;
+    v: 1;
+}>;
+export type OhSearchResultV1 = Readonly<{
+    evidence: readonly Readonly<{
+        lane: "keyword" | "semantic";
+        rank: number;
+        score: number;
+        v: 1;
+    }>[];
+    record: KnowledgeGraphRecordV1;
+    score: number;
+    v: 1;
+}>;
+export type OhSearchResponseV1 = Readonly<{
+    diagnostics: readonly OhSearchDiagnosticV1[];
+    mode: OhSearchModeV1;
+    results: readonly OhSearchResultV1[];
+    v: 1;
+}>;
+export declare function searchOhV1(input: Readonly<{
+    backend?: OhSemanticSearchBackendV1;
+    limit?: number;
+    mode?: OhSearchModeV1;
+    query: string;
+    store: OhSqliteStore;
+}>): Promise<OhSearchResponseV1>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,CAAC;CACN,CAAC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,CAAC;IACnG,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,CAAC,CAAC;CACN,CAAC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7C,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,CAAC;CACN,CAAC,CAAC;AAEH,wBAAsB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC/C,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoC/B"}

package/dist/semantic.d.ts

@@ -0,0 +1,83 @@
+import { type Sha256Hex } from "./canonical";
+import { type KnowledgeGraphRecordV1 } from "./graph";
+import type { OhSqliteStore } from "./sqlite/store";
+export declare const OH_EMBEDDING_PROFILE_V1: Readonly<{
+    readonly dimensions: 768;
+    readonly distance: "cosine";
+    readonly documentation: "https://ai.google.dev/gemma/docs/embeddinggemma";
+    readonly documentFormat: "title: {title} | text: {content}";
+    readonly engine: "@tobilu/qmd@2.5.3";
+    readonly model: "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf";
+    readonly normalization: "l2";
+    readonly queryFormat: "task: search result | query: {query}";
+    readonly v: 1;
+}>;
+export type OhEmbeddingProfileV1 = typeof OH_EMBEDDING_PROFILE_V1;
+export declare function formatOhEmbeddingQueryV1(query: string): string;
+export declare function formatOhEmbeddingDocumentV1(title: string, content: string): string;
+export declare function normalizeOhEmbeddingV1(vector: readonly number[]): readonly number[];
+export declare function cosineSimilarityV1(left: readonly number[], right: readonly number[]): number;
+export type OhSemanticSearchResultV1 = Readonly<{
+    key: string;
+    recordSha256: Sha256Hex;
+    score: number;
+    v: 1;
+}>;
+export interface OhSemanticSearchBackendV1 {
+    readonly profile: OhEmbeddingProfileV1;
+    close(): Promise<void>;
+    index(records: readonly KnowledgeGraphRecordV1[]): Promise<Readonly<{
+        indexed: number;
+        v: 1;
+    }>>;
+    search(query: string, limit: number, authority: OhSqliteStore): Promise<readonly OhSemanticSearchResultV1[]>;
+}
+type QmdStore = {
+    close(): Promise<void>;
+    embed(options: Readonly<{
+        collection: string;
+        model: string;
+    }>): Promise<unknown>;
+    searchVector(query: string, options: Readonly<{
+        collection: string;
+        limit: number;
+    }>): Promise<unknown>;
+    update(options: Readonly<{
+        collections: readonly string[];
+    }>): Promise<unknown>;
+};
+export type QmdStoreFactoryV1 = (options: Readonly<{
+    config: Readonly<Record<string, unknown>>;
+    dbPath: string;
+}>) => Promise<QmdStore>;
+/**
+ * Optional, rebuildable local QMD index. SQLite records remain authoritative;
+ * every returned hit is rejoined to its exact current record digest.
+ */
+export declare class OhQmdSemanticBackendV1 implements OhSemanticSearchBackendV1 {
+    #private;
+    readonly profile: Readonly<{
+        readonly dimensions: 768;
+        readonly distance: "cosine";
+        readonly documentation: "https://ai.google.dev/gemma/docs/embeddinggemma";
+        readonly documentFormat: "title: {title} | text: {content}";
+        readonly engine: "@tobilu/qmd@2.5.3";
+        readonly model: "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf";
+        readonly normalization: "l2";
+        readonly queryFormat: "task: search result | query: {query}";
+        readonly v: 1;
+    }>;
+    constructor(options: Readonly<{
+        cacheDirectory: string;
+        databasePath?: string;
+        storeFactory?: QmdStoreFactoryV1;
+    }>);
+    index(records: readonly KnowledgeGraphRecordV1[]): Promise<Readonly<{
+        indexed: number;
+        v: 1;
+    }>>;
+    search(query: string, limit: number, authority: OhSqliteStore): Promise<readonly OhSemanticSearchResultV1[]>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../src/semantic.ts"],"names":[],"mappings":"AAGA,OAAO,EACgB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,uBAAuB;;;;;;;;;;EAUzB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,OAAO,uBAAuB,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAQnF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI5F;AAED,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,SAAS,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,CAAC,CAAC;CACN,CAAC,CAAC;AAEH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAChG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAAC;CAC9G;AAED,KAAK,QAAQ,GAAG;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjF,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;IACjD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA4EzB;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,yBAAyB;;IACtE,QAAQ,CAAC,OAAO;;;;;;;;;;OAA2B;gBAa/B,OAAO,EAAE,QAAQ,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAyElH,KAAK,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAyC/F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC;IAkD5G,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvB"}