@oka-core/reason 0.2.13 → 0.2.15

package/dist/auth.d.ts

@@ -39,6 +39,21 @@ export declare function resolveApiKey(): string;
  * Async version that tries token refresh before giving up.
  */
 export declare function resolveApiKeyWithRefresh(): Promise<string>;
+export declare class McpTokenManager {
+    private refreshTimer;
+    /**
+     * Get a valid token, refreshing proactively if needed.
+     * This is the single entry point for auth — replaces resolveApiKey().
+     */
+    getValidToken(): Promise<string>;
+    /**
+     * Schedule a background refresh REFRESH_BEFORE_EXPIRY_S before token expires.
+     */
+    private scheduleRefresh;
+    private backgroundRefresh;
+    private clearTimer;
+    destroy(): void;
+}
 export interface LoginResult {
     success: boolean;
     message: string;

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,IAAI,CAOhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAa/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW1D;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA0B7C;AAOD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnD;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAuBtC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBhE;AAuGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAsCtB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD,wBAAgB,qBAAqB,IAAI,iBAAiB,GAAG,IAAI,CAOhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAa/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW1D;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA0B7C;AAOD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnD;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAuBtC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAwBhE;AASD,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAA8C;IAElE;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAsCtC;;OAEG;IACH,OAAO,CAAC,eAAe;YAeT,iBAAiB;IAQ/B,OAAO,CAAC,UAAU;IAOlB,OAAO,IAAI,IAAI;CAGhB;AAuGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAsCtB"}

package/dist/auth.js

@@ -191,6 +191,83 @@ export async function resolveApiKeyWithRefresh() {
     }
     return "";
 }
+// ─── MCP Token Manager ──────────────────────────────────────────
+// Proactive token refresh adapted for Node.js file-based credentials.
+// Same pattern as @oka/auth-sdk TokenManager but reads ~/.oka/credentials.json
+// instead of window.localStorage.
+const REFRESH_BEFORE_EXPIRY_S = 300; // 5 minutes
+export class McpTokenManager {
+    refreshTimer = null;
+    /**
+     * Get a valid token, refreshing proactively if needed.
+     * This is the single entry point for auth — replaces resolveApiKey().
+     */
+    async getValidToken() {
+        // 1. Environment variable always wins
+        const envKey = process.env["OKA_API_KEY"];
+        if (envKey)
+            return envKey;
+        // 2. Check stored credentials
+        const stored = loadStoredCredentials();
+        if (stored?.api_key)
+            return stored.api_key;
+        if (stored?.access_token) {
+            const now = Date.now() / 1000;
+            const exp = extractJwtExp(stored.access_token) ?? stored.expires_at ?? 0;
+            const expiringSoon = exp - now < REFRESH_BEFORE_EXPIRY_S;
+            if (!expiringSoon) {
+                this.scheduleRefresh(exp);
+                return stored.access_token;
+            }
+            // Token expired or expiring soon — refresh now
+            if (stored.refresh_token) {
+                const newToken = await tryRefresh();
+                if (newToken) {
+                    const newExp = extractJwtExp(newToken) ?? 0;
+                    this.scheduleRefresh(newExp);
+                    return newToken;
+                }
+            }
+            // Refresh failed but token might still be technically valid
+            if (exp > now) {
+                return stored.access_token;
+            }
+        }
+        return "";
+    }
+    /**
+     * Schedule a background refresh REFRESH_BEFORE_EXPIRY_S before token expires.
+     */
+    scheduleRefresh(expiresAtSec) {
+        this.clearTimer();
+        const delayMs = (expiresAtSec - REFRESH_BEFORE_EXPIRY_S - Date.now() / 1000) * 1000;
+        if (delayMs <= 0)
+            return; // Already in refresh window, handled by getValidToken
+        this.refreshTimer = setTimeout(() => {
+            void this.backgroundRefresh();
+        }, delayMs);
+        // Don't let the timer prevent Node.js from exiting
+        if (this.refreshTimer && typeof this.refreshTimer === "object") {
+            this.refreshTimer.unref();
+        }
+    }
+    async backgroundRefresh() {
+        const newToken = await tryRefresh();
+        if (newToken) {
+            const exp = extractJwtExp(newToken) ?? 0;
+            this.scheduleRefresh(exp);
+        }
+    }
+    clearTimer() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+    destroy() {
+        this.clearTimer();
+    }
+}
 const DEFAULT_AUTH_SERVER = "https://id.oka.so";
 const DEFAULT_CLIENT_ID = "oka-reason-mcp";
 async function requestDeviceCode(authServerUrl, clientId) {

package/dist/client.d.ts

@@ -154,6 +154,7 @@ export interface HybridPipelineMeta {
     after_dedup: number;
     pipeline_stages: string[];
     elapsed_ms: number;
+    feedback_id?: string;
 }
 export interface HybridSearchResponse {
     query: string;
@@ -182,6 +183,11 @@ export declare class OkaClient {
     private readonly agentId;
     private readonly sessionId;
     private readonly timeout;
+    private readonly tokenManager;
+    /** 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>;
@@ -217,18 +223,29 @@ export declare class OkaClient {
      * 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
      */
     triggerConsolidation(req: ConsolidateRequest): Promise<ConsolidateResponse>;
     private authHeaders;
+    private buildHeaders;
     private get;
     private post;
-    /**
-     * On 401, attempt to refresh the token and retry the request once.
-     * Returns the parsed JSON response on success, or null if refresh failed.
-     */
-    private retryWithRefresh;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,5 +1,5 @@
 import { EventBuffer } from "./buffer.js";
-import { resolveApiKey, resolveApiKeyWithRefresh } from "./auth.js";
+import { McpTokenManager } from "./auth.js";
 /**
  * Unified HTTP client for Oka Reason API.
  *
@@ -21,6 +21,11 @@ export class OkaClient {
     agentId;
     sessionId;
     timeout;
+    tokenManager;
+    /** 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"] ||
@@ -31,6 +36,7 @@ export class OkaClient {
         this.sessionId = process.env["SESSION_ID"] || `session-${Date.now()}`;
         this.buffer = new EventBuffer(100);
         this.timeout = 15_000;
+        this.tokenManager = new McpTokenManager();
     }
     updateApiKey(key) {
         this.apiKey = key;
@@ -52,12 +58,10 @@ export class OkaClient {
         if (events.length === 0)
             return;
         try {
+            const headers = await this.authHeaders();
             await fetch(`${this.apiUrl}/api/reasoning/ingest`, {
                 method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    ...this.authHeaders(),
-                },
+                headers,
                 body: JSON.stringify({ events }),
                 signal: AbortSignal.timeout(5_000),
             });
@@ -96,8 +100,9 @@ export class OkaClient {
                 if (v)
                     url.searchParams.set(k, v);
             }
+            const headers = await this.authHeaders();
             const res = await fetch(url.toString(), {
-                headers: this.authHeaders(),
+                headers,
                 signal: AbortSignal.timeout(10_000),
             });
             if (!res.ok)
@@ -214,7 +219,7 @@ export class OkaClient {
             params.set("rerank", "true");
         if (options?.mode)
             params.set("mode", options.mode);
-        return this.get(`/api/learnings/query/${encodeURIComponent(query)}?${params}`).catch(() => ({
+        const data = await this.get(`/api/learnings/query/${encodeURIComponent(query)}?${params}`).catch(() => ({
             query,
             results: [],
             total_candidates: 0,
@@ -227,6 +232,60 @@ export class OkaClient {
                 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 ──────────────────────────────────────────────
     /**
@@ -238,17 +297,16 @@ export class OkaClient {
         return this.post("/api/reasoning/consolidate", body, 120_000);
     }
     // ─── HTTP helpers ───────────────────────────────────────────────
-    authHeaders() {
-        // Resolve credentials fresh each call so .env / credentials.json
-        // changes (e.g. after `login`) are picked up without MCP restart.
-        const key = this.apiKey || resolveApiKey();
+    async authHeaders() {
+        const key = this.apiKey || (await this.tokenManager.getValidToken());
+        return this.buildHeaders(key);
+    }
+    buildHeaders(key) {
         const headers = {
             "Content-Type": "application/json",
         };
         if (key) {
             // JWTs have dots (header.payload.signature); API keys don't.
-            // Sending both headers causes the server to try Bearer first and fail
-            // when the value is an API key, never falling back to X-Api-Key.
             const isJwt = key.includes(".");
             if (isJwt) {
                 headers["Authorization"] = `Bearer ${key}`;
@@ -260,22 +318,20 @@ export class OkaClient {
         return headers;
     }
     async get(path) {
+        const headers = await this.authHeaders();
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);
         try {
             const response = await fetch(`${this.apiUrl}${path}`, {
                 method: "GET",
-                headers: this.authHeaders(),
+                headers,
                 signal: controller.signal,
             });
-            if (response.status === 401) {
-                const retried = await this.retryWithRefresh("GET", path);
-                if (retried !== null)
-                    return retried;
-                throw new Error("HTTP 401: authentication failed — run mcp__oka__login to re-authenticate");
+            if (!response.ok) {
+                throw new Error(response.status === 401
+                    ? "HTTP 401: authentication failed — run mcp__oka__login to re-authenticate"
+                    : `HTTP ${response.status}`);
             }
-            if (!response.ok)
-                throw new Error(`HTTP ${response.status}`);
             return response.json();
         }
         finally {
@@ -283,22 +339,20 @@ export class OkaClient {
         }
     }
     async post(path, body, timeout) {
+        const headers = await this.authHeaders();
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), timeout ?? this.timeout);
         try {
             const response = await fetch(`${this.apiUrl}${path}`, {
                 method: "POST",
-                headers: this.authHeaders(),
+                headers,
                 body: JSON.stringify(body),
                 signal: controller.signal,
             });
-            if (response.status === 401) {
-                const retried = await this.retryWithRefresh("POST", path, body);
-                if (retried !== null)
-                    return retried;
-                throw new Error("HTTP 401: authentication failed — run mcp__oka__login to re-authenticate");
-            }
             if (!response.ok) {
+                if (response.status === 401) {
+                    throw new Error("HTTP 401: authentication failed — run mcp__oka__login to re-authenticate");
+                }
                 const text = await response.text().catch(() => "");
                 throw new Error(`HTTP ${response.status}: ${text}`);
             }
@@ -308,35 +362,4 @@ export class OkaClient {
             clearTimeout(timer);
         }
     }
-    /**
-     * On 401, attempt to refresh the token and retry the request once.
-     * Returns the parsed JSON response on success, or null if refresh failed.
-     */
-    async retryWithRefresh(method, path, body) {
-        const newKey = await resolveApiKeyWithRefresh();
-        if (!newKey)
-            return null;
-        const headers = {
-            "Content-Type": "application/json",
-        };
-        const isJwt = newKey.includes(".");
-        if (isJwt) {
-            headers["Authorization"] = `Bearer ${newKey}`;
-        }
-        else {
-            headers["X-Api-Key"] = newKey;
-        }
-        const opts = {
-            method,
-            headers,
-            signal: AbortSignal.timeout(this.timeout),
-        };
-        if (body !== undefined) {
-            opts.body = JSON.stringify(body);
-        }
-        const retryResponse = await fetch(`${this.apiUrl}${path}`, opts);
-        if (!retryResponse.ok)
-            return null;
-        return retryResponse.json();
-    }
 }

package/dist/tools/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ9C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA8I5E"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/tools/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU9C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA8I5E"}

package/dist/tools/auth.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { deviceAuthLogin, loadStoredCredentials, resolveApiKey, resolveApiKeyWithRefresh, } from "../auth.js";
+import { McpTokenManager, deviceAuthLogin, loadStoredCredentials, resolveApiKey, } from "../auth.js";
+const tokenManager = new McpTokenManager();
 /**
  * Register auth tools on the MCP server.
  */
@@ -29,10 +30,10 @@ export function registerAuthTools(server, client) {
                 ],
             };
         }
-        // Token might be expired — try refresh before opening browser
+        // Token might be expired — try proactive refresh before opening browser
         const stored = loadStoredCredentials();
         if (stored?.refresh_token) {
-            const refreshed = await resolveApiKeyWithRefresh();
+            const refreshed = await tokenManager.getValidToken();
             if (refreshed) {
                 client.updateApiKey(refreshed);
                 return {
@@ -83,11 +84,11 @@ export function registerAuthTools(server, client) {
         }
     });
     server.tool("whoami", "Check current authentication status — whether the MCP server has valid credentials.", {}, async () => {
-        // First try sync resolution
-        let key = resolveApiKey();
-        // If no key found, try async refresh
+        // Try token manager (proactive refresh)
+        let key = await tokenManager.getValidToken();
+        // If token manager returned empty, key might still be in sync path
         if (!key) {
-            key = await resolveApiKeyWithRefresh();
+            key = resolveApiKey();
             if (key) {
                 return {
                     content: [

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

@@ -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,EAKV,MAAM,cAAc,CAAC;AA+HtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAopB5E"}
+{"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

@@ -49,7 +49,7 @@ function formatHybridResults(query, results, totalCandidates, pipeline) {
     const lines = [
         `## Knowledge: ${query}`,
         ``,
-        `> ${totalCandidates} candidate(s), showing top ${results.length} | Pipeline: ${pipeline.pipeline_stages.join(" → ")} (${pipeline.elapsed_ms}ms)`,
+        `> ${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) {
@@ -83,7 +83,7 @@ function formatHybridResults(query, results, totalCandidates, pipeline) {
         if (r.tags?.length > 0) {
             lines.push(`**Tags:** ${r.tags.join(", ")}`);
         }
-        lines.push(`*Matched by: ${r.matching_strategies.join(" + ")}*`);
+        lines.push(`*ID: ${r.id.slice(0, 8)} | Matched by: ${r.matching_strategies.join(" + ")}*`);
         lines.push("");
     }
     return lines.join("\n");

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

@@ -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"}
+{"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

@@ -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

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