@clawdactual/chitin 0.1.0

package/dist/engine/retrieve.d.ts

@@ -0,0 +1,36 @@
+import type { Insight, InsightType } from '../types.js';
+import type { InsightRepository } from '../db/repository.js';
+import type { EmbeddingStore } from '../db/embeddings.js';
+export interface RetrieveOptions {
+    maxResults?: number;
+    minConfidence?: number;
+    types?: InsightType[];
+    typeBoosts?: Partial<Record<InsightType, number>>;
+}
+export interface ScoredInsight {
+    insight: Insight;
+    similarity: number;
+    score: number;
+}
+export interface SessionContext {
+    query: string;
+    channel?: string;
+    userId?: string;
+    sessionType?: 'direct' | 'group' | 'subagent';
+}
+export declare class RetrievalEngine {
+    private repo;
+    private embeddingStore;
+    constructor(repo: InsightRepository, embeddingStore: EmbeddingStore);
+    /**
+     * Retrieve relevant insights for a given query embedding.
+     *
+     * Scoring formula:
+     *   score = cosineSimilarity × confidence × log2(reinforcementCount + 2) × typeBoost
+     *
+     * The +2 in the log avoids log(1)=0 for unreinforced insights while still
+     * giving a meaningful boost to frequently-confirmed insights.
+     */
+    retrieve(queryEmbedding: Float32Array, options?: RetrieveOptions): ScoredInsight[];
+}
+//# sourceMappingURL=retrieve.d.ts.map

package/dist/engine/retrieve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../src/engine/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;CAC/C;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc;IAKnE;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAAc,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,aAAa,EAAE;CAsCvF"}

package/dist/engine/retrieve.js

@@ -0,0 +1,45 @@
+export class RetrievalEngine {
+    repo;
+    embeddingStore;
+    constructor(repo, embeddingStore) {
+        this.repo = repo;
+        this.embeddingStore = embeddingStore;
+    }
+    /**
+     * Retrieve relevant insights for a given query embedding.
+     *
+     * Scoring formula:
+     *   score = cosineSimilarity × confidence × log2(reinforcementCount + 2) × typeBoost
+     *
+     * The +2 in the log avoids log(1)=0 for unreinforced insights while still
+     * giving a meaningful boost to frequently-confirmed insights.
+     */
+    retrieve(queryEmbedding, options = {}) {
+        const { maxResults = 15, minConfidence, types, typeBoosts = {}, } = options;
+        // Get all embeddings and compute similarities
+        const nearest = this.embeddingStore.findNearest(queryEmbedding, 100);
+        if (nearest.length === 0)
+            return [];
+        // Fetch the actual insights and score them
+        const scored = [];
+        for (const { insightId, similarity } of nearest) {
+            const insight = this.repo.get(insightId);
+            if (!insight)
+                continue;
+            // Apply filters
+            if (minConfidence !== undefined && insight.confidence < minConfidence)
+                continue;
+            if (types && types.length > 0 && !types.includes(insight.type))
+                continue;
+            // Compute composite score
+            const reinforcementFactor = Math.log2(insight.reinforcementCount + 2);
+            const typeBoost = typeBoosts[insight.type] ?? 1.0;
+            const score = similarity * insight.confidence * reinforcementFactor * typeBoost;
+            scored.push({ insight, similarity, score });
+        }
+        // Sort by score descending
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, maxResults);
+    }
+}
+//# sourceMappingURL=retrieve.js.map

package/dist/engine/retrieve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../src/engine/retrieve.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,eAAe;IAClB,IAAI,CAAoB;IACxB,cAAc,CAAiB;IAEvC,YAAY,IAAuB,EAAE,cAA8B;QACjE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,cAA4B,EAAE,UAA2B,EAAE;QAClE,MAAM,EACJ,UAAU,GAAG,EAAE,EACf,aAAa,EACb,KAAK,EACL,UAAU,GAAG,EAAE,GAChB,GAAG,OAAO,CAAC;QAEZ,8CAA8C;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAErE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,2CAA2C;QAC3C,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,OAAO,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,gBAAgB;YAChB,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,GAAG,aAAa;gBAAE,SAAS;YAChF,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEzE,0BAA0B;YAC1B,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YAElD,MAAM,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAAC;YAEhF,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,2BAA2B;QAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}