npm - @oka-core/reason - Versions diffs - 0.2.12 → 0.2.14 - Mend

@oka-core/reason 0.2.12 → 0.2.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/client.d.ts CHANGED Viewed

@@ -115,6 +115,53 @@ export interface SemanticSearchResponse {
     results: SemanticSearchResult[];
     total: number;
 }
+export interface HybridSearchOptions {
+    repo?: string;
+    limit?: number;
+    min_confidence?: number;
+    min_similarity?: number;
+    rerank?: boolean;
+    file_patterns?: string;
+    visibility?: "user_repo" | "account_wide" | "user_private";
+    mode?: "hybrid" | "bm25_only" | "vector_only";
+}
+export interface HybridResultScores {
+    final_score: number;
+    bm25_score: number | null;
+    vector_similarity: number | null;
+    rrf_score: number;
+    feature_score: number;
+    rerank_score: number | null;
+}
+export interface HybridResultItem {
+    id: string;
+    summary: string;
+    detailed_description?: string;
+    tags: string[];
+    file_patterns: string[];
+    category: string;
+    confidence: number;
+    evidence_count: number;
+    suggested_action?: string;
+    status: string;
+    scores: HybridResultScores;
+    matching_strategies: string[];
+}
+export interface HybridPipelineMeta {
+    bm25_candidates: number;
+    vector_candidates: number;
+    fused_candidates: number;
+    after_dedup: number;
+    pipeline_stages: string[];
+    elapsed_ms: number;
+    feedback_id?: string;
+}
+export interface HybridSearchResponse {
+    query: string;
+    results: HybridResultItem[];
+    total_candidates: number;
+    pipeline: HybridPipelineMeta;
+}
 /**
  * Unified HTTP client for Oka Reason API.
  *
@@ -136,6 +183,10 @@ export declare class OkaClient {
     private readonly agentId;
     private readonly sessionId;
     private readonly timeout;
+    /** Maps learning_id → feedback_id for LTR attribution across tool calls. */
+    private readonly searchContext;
+    /** Reverse map: short ID prefix → full UUID */
+    private readonly idLookup;
     constructor(config?: OkaClientConfig);
     updateApiKey(key: string): void;
     ingest(event: IngestEvent): Promise<void>;
@@ -166,6 +217,26 @@ export declare class OkaClient {
      * GET /api/learnings/semantic/:query
      */
     semanticSearch(query: string, options?: SemanticSearchOptions): Promise<SemanticSearchResponse>;
+    /**
+     * Hybrid search combining BM25 + vector + RRF fusion.
+     * GET /api/learnings/query/:input
+     */
+    hybridSearch(query: string, options?: HybridSearchOptions): Promise<HybridSearchResponse>;
+    /**
+     * Submit explicit feedback on a learning (useful/not useful).
+     */
+    submitFeedback(params: {
+        learning_id?: string;
+        useful?: boolean;
+        reason?: string;
+        used_ids?: string[];
+        query_feedback_id?: string;
+    }): Promise<void>;
+    /**
+     * Report which learnings were actually used (implicit feedback).
+     * Groups by feedback_id from searchContext for correct attribution.
+     */
+    reportUsedLearnings(usedIds: string[]): void;
     /**
      * Trigger a consolidation run.
      * POST /api/reasoning/consolidate

package/dist/client.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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~~gBAErB~~,MAAM,CAAC,EAAE,eAAe;IAcpC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAYjC,KAAK;IAqBnB;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,CAAC;IAkBrB,KAAK,CACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACzC,OAAO,CAAC,WAAW,CAAC;IAoBvB;;;OAGG;IACG,YAAY,CAChB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAkB9B;;;OAGG;IACG,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAc7D;;;OAGG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAexD;;;OAGG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC;IAwBlC;;;OAGG;IACG,oBAAoB,CACxB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,mBAAmB,CAAC;IAO/B,OAAO,CAAC,WAAW;YAqBL,GAAG;YAuBH,IAAI;IA2BlB;;;OAGG;YACW,gBAAgB;CA+B/B"}
1	+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js CHANGED Viewed

@@ -21,6 +21,10 @@ export class OkaClient {
     agentId;
     sessionId;
     timeout;
+    /** Maps learning_id → feedback_id for LTR attribution across tool calls. */
+    searchContext = new Map();
+    /** Reverse map: short ID prefix → full UUID */
+    idLookup = new Map();
     constructor(config) {
         this.apiUrl = (config?.apiUrl ||
             process.env["OKA_API_URL"] ||
@@ -186,6 +190,102 @@ export class OkaClient {
             params.set("visibility", options.visibility);
         return this.get(`/api/learnings/semantic/${encodeURIComponent(query)}?${params}`).catch(() => ({ query, results: [], total: 0 }));
     }
+    // ─── Hybrid search (unified pipeline) ───────────────────────────
+    /**
+     * Hybrid search combining BM25 + vector + RRF fusion.
+     * GET /api/learnings/query/:input
+     */
+    async hybridSearch(query, options) {
+        const params = new URLSearchParams();
+        // repo scoping: same logic as semanticSearch
+        if (options?.repo)
+            params.set("repo", options.repo);
+        else if (!options?.visibility ||
+            options.visibility === "user_repo" ||
+            options.visibility === "user_private")
+            params.set("repo", this.repo);
+        if (options?.limit)
+            params.set("limit", String(options.limit));
+        if (options?.min_confidence)
+            params.set("min_confidence", String(options.min_confidence));
+        if (options?.min_similarity)
+            params.set("min_similarity", String(options.min_similarity));
+        if (options?.file_patterns)
+            params.set("file_patterns", options.file_patterns);
+        if (options?.visibility)
+            params.set("visibility", options.visibility);
+        if (options?.rerank)
+            params.set("rerank", "true");
+        if (options?.mode)
+            params.set("mode", options.mode);
+        const data = await this.get(`/api/learnings/query/${encodeURIComponent(query)}?${params}`).catch(() => ({
+            query,
+            results: [],
+            total_candidates: 0,
+            pipeline: {
+                bm25_candidates: 0,
+                vector_candidates: 0,
+                fused_candidates: 0,
+                after_dedup: 0,
+                pipeline_stages: [],
+                elapsed_ms: 0,
+            },
+        }));
+        // Track learning → feedback_id for LTR attribution.
+        // Index by both full UUID and 8-char prefix (agents see short IDs).
+        if (data.pipeline.feedback_id) {
+            const fbId = data.pipeline.feedback_id;
+            this.idLookup.set(fbId.slice(0, 8), fbId);
+            for (const r of data.results) {
+                this.searchContext.set(r.id, fbId);
+                this.searchContext.set(r.id.slice(0, 8), fbId);
+                this.idLookup.set(r.id.slice(0, 8), r.id);
+            }
+        }
+        return data;
+    }
+    // ─── Feedback (LTR training data) ────────────────────────────────
+    /**
+     * Submit explicit feedback on a learning (useful/not useful).
+     */
+    async submitFeedback(params) {
+        // Resolve short 8-char IDs to full UUIDs for the API
+        const resolved = {
+            ...params,
+            learning_id: params.learning_id
+                ? (this.idLookup.get(params.learning_id) ?? params.learning_id)
+                : undefined,
+            query_feedback_id: params.query_feedback_id
+                ? (this.idLookup.get(params.query_feedback_id) ??
+                    params.query_feedback_id)
+                : undefined,
+        };
+        await this.post("/api/reasoning/feedback", resolved).catch(() => { });
+    }
+    /**
+     * Report which learnings were actually used (implicit feedback).
+     * Groups by feedback_id from searchContext for correct attribution.
+     */
+    reportUsedLearnings(usedIds) {
+        // Group used IDs by their feedback_id, resolving short IDs to full UUIDs
+        const byFeedback = new Map();
+        for (const id of usedIds) {
+            const fullId = this.idLookup.get(id) ?? id;
+            const fbId = this.searchContext.get(id) ?? this.searchContext.get(fullId);
+            if (fbId) {
+                const list = byFeedback.get(fbId) ?? [];
+                list.push(fullId);
+                byFeedback.set(fbId, list);
+            }
+        }
+        // Fire-and-forget one request per feedback_id
+        for (const [feedbackId, ids] of byFeedback) {
+            this.submitFeedback({
+                query_feedback_id: feedbackId,
+                used_ids: ids,
+            }).catch(() => { });
+        }
+    }
     // ─── Consolidation ──────────────────────────────────────────────
     /**
      * Trigger a consolidation run.

package/dist/tools/read.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,SAAS,~~EAGV~~,MAAM,cAAc,CAAC;~~AAoEtB~~;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,~~CAwmB5E~~"}
1	+ {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,SAAS,EAKV,MAAM,cAAc,CAAC;AAiItB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAopB5E"}

package/dist/tools/read.js CHANGED Viewed

@@ -42,6 +42,52 @@ function formatContextLearnings(topic, learnings, totalMatched) {
     }
     return lines.join("\n");
 }
+function formatHybridResults(query, results, totalCandidates, pipeline) {
+    if (results.length === 0) {
+        return `No knowledge found for query "${query}".`;
+    }
+    const lines = [
+        `## Knowledge: ${query}`,
+        ``,
+        `> ${totalCandidates} candidate(s), showing top ${results.length} | Pipeline: ${pipeline.pipeline_stages.join(" → ")} (${pipeline.elapsed_ms}ms)${pipeline.feedback_id ? ` | ref: ${pipeline.feedback_id.slice(0, 8)}` : ""}`,
+        ``,
+    ];
+    for (const r of results) {
+        const finalPct = (r.scores.final_score * 100).toFixed(0);
+        const confPct = (r.confidence * 100).toFixed(0);
+        lines.push(`### ${r.summary}`);
+        const scoreParts = [
+            `**Score:** ${finalPct}%`,
+            `**Confidence:** ${confPct}%`,
+        ];
+        if (r.scores.bm25_score != null)
+            scoreParts.push(`BM25: ${r.scores.bm25_score.toFixed(2)}`);
+        if (r.scores.vector_similarity != null)
+            scoreParts.push(`Vector: ${(r.scores.vector_similarity * 100).toFixed(0)}%`);
+        if (r.scores.rerank_score != null)
+            scoreParts.push(`Rerank: ${(r.scores.rerank_score * 100).toFixed(0)}%`);
+        scoreParts.push(`**Category:** ${r.category}`);
+        lines.push(scoreParts.join(" | "));
+        if (r.evidence_count > 1) {
+            lines.push(`**Evidence:** ${r.evidence_count} source(s)`);
+        }
+        if (r.detailed_description) {
+            lines.push(`\n${r.detailed_description}`);
+        }
+        if (r.suggested_action) {
+            lines.push(`\n**Suggested action:** ${r.suggested_action}`);
+        }
+        if (r.file_patterns?.length > 0) {
+            lines.push(`**Related files:** ${r.file_patterns.join(", ")}`);
+        }
+        if (r.tags?.length > 0) {
+            lines.push(`**Tags:** ${r.tags.join(", ")}`);
+        }
+        lines.push(`*ID: ${r.id.slice(0, 8)} | Matched by: ${r.matching_strategies.join(" + ")}*`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
 // ─── Tool registration ─────────────────────────────────────────────
 /**
  * Register read tools on the MCP server.
@@ -82,7 +128,18 @@ export function registerReadTools(server, client) {
             .describe("Visibility scope: user_repo (default), account_wide (cross-repo), user_private"),
     }, async (params) => {
         try {
-            // Try the new context endpoint first
+            // 1. Try hybrid search first (BM25 + vector + RRF)
+            const hybridResult = await client.hybridSearch(params.topic, {
+                file_patterns: params.file_patterns,
+                limit: params.limit,
+                min_confidence: params.min_confidence,
+                visibility: params.visibility,
+            });
+            if (hybridResult.results.length > 0) {
+                const text = formatHybridResults(params.topic, hybridResult.results, hybridResult.total_candidates, hybridResult.pipeline);
+                return { content: [{ type: "text", text }] };
+            }
+            // 2. Fall back to legacy context endpoint
             const contextResult = await client.getContext(params.topic, {
                 file_patterns: params.file_patterns,
                 limit: params.limit,
@@ -93,7 +150,7 @@ export function registerReadTools(server, client) {
                 const text = formatContextLearnings(params.topic, contextResult.learnings, contextResult.total_matched);
                 return { content: [{ type: "text", text }] };
             }
-            // Fall back to raw event query if no learnings exist
+            // 3. Fall back to raw event query
             const rawResult = await client.query({
                 area: params.topic,
             });
@@ -470,6 +527,25 @@ export function registerReadTools(server, client) {
             "user_private (personal learnings only)"),
     }, async (params) => {
         try {
+            // Try hybrid search first (BM25 + vector + RRF fusion)
+            const hybridResult = await client
+                .hybridSearch(params.query, {
+                limit: params.limit,
+                min_similarity: params.min_similarity,
+                visibility: params.visibility,
+            })
+                .catch(() => null);
+            if (hybridResult && hybridResult.results.length > 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: formatHybridResults(params.query, hybridResult.results, hybridResult.total_candidates, hybridResult.pipeline),
+                        },
+                    ],
+                };
+            }
+            // Fall back to legacy semantic search
             const result = await client.semanticSearch(params.query, {
                 limit: params.limit,
                 min_similarity: params.min_similarity,

package/dist/tools/write.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,~~CAoK7E~~"}
1	+ {"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAqN7E"}

package/dist/tools/write.js CHANGED Viewed

@@ -61,7 +61,8 @@ export function registerWriteTools(server, client) {
             ],
         };
     });
-    server.tool("done", "Record task completion with outcome and quality signals", {
+    server.tool("done", "Record task completion with outcome and quality signals. " +
+        "If you used Oka learnings during the task, include their IDs in used_learning_ids.", {
         task_id: z.string().describe("Identifier for the completed task"),
         outcome: z
             .enum(["success", "partial", "failed"])
@@ -74,8 +75,20 @@ export function registerWriteTools(server, client) {
             .record(z.string(), z.number())
             .default({})
             .describe("Quality metrics (e.g., test_coverage: 0.92)"),
+        used_learning_ids: z
+            .array(z.string())
+            .optional()
+            .describe("IDs of Oka learnings used during the task"),
     }, async (params) => {
-        await client.ingest({ event_type: "completion", payload: params });
+        const { used_learning_ids, ...completionPayload } = params;
+        await client.ingest({
+            event_type: "completion",
+            payload: completionPayload,
+        });
+        // Report implicit feedback for LTR training
+        if (used_learning_ids?.length) {
+            client.reportUsedLearnings(used_learning_ids);
+        }
         return {
             content: [
                 {
@@ -137,4 +150,33 @@ export function registerWriteTools(server, client) {
             ],
         };
     });
+    // ─── feedback (LTR training signal) ──────────────────────────────
+    server.tool("feedback", "Report whether a learning from Oka was useful or not. " +
+        "Improves future search quality. Call after using context or semantic_search.", {
+        learning_id: z.string().describe("Learning ID from search results"),
+        useful: z.boolean().describe("Was this learning useful?"),
+        query_feedback_id: z
+            .string()
+            .optional()
+            .describe("The ref ID from the search that returned this learning"),
+        reason: z
+            .enum(["helpful", "outdated", "wrong", "irrelevant"])
+            .optional()
+            .describe("Why the learning was or wasn't useful"),
+    }, async (params) => {
+        await client.submitFeedback({
+            learning_id: params.learning_id,
+            useful: params.useful,
+            query_feedback_id: params.query_feedback_id,
+            reason: params.reason,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Feedback recorded: ${params.learning_id.slice(0, 8)} → ${params.useful ? "useful" : "not useful"}`,
+                },
+            ],
+        };
+    });
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@oka-core/reason",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "MCP server for institutional knowledge capture, semantic search, and consolidation",
   "private": false,
   "publishConfig": {