loopctl-mcp-server 2.31.1 → 2.33.0

package/index.js

@@ -1182,12 +1182,21 @@ async function llmConfig() {
   return toContent(result);
 }
 
-async function setLlmConfig({ api_key, extraction_model, classification_model, merge_model }) {
+async function setLlmConfig({
+  api_key,
+  extraction_model,
+  classification_model,
+  merge_model,
+  embedding_api_key,
+  embedding_model,
+}) {
   const body = {};
   if (api_key != null) body.api_key = api_key;
   if (extraction_model !== undefined) body.extraction_model = extraction_model;
   if (classification_model !== undefined) body.classification_model = classification_model;
   if (merge_model !== undefined) body.merge_model = merge_model;
+  if (embedding_api_key != null) body.embedding_api_key = embedding_api_key;
+  if (embedding_model !== undefined) body.embedding_model = embedding_model;
   // PATCH (partial-merge) + EXACT user key (review #12, #13).
   const result = await apiCall(
     "PATCH",
@@ -2576,7 +2585,11 @@ const TOOLS = [
       "list mode or knowledge_stats. " +
       "Pass story_id when working on a loopctl story so reads attribute correctly. " +
       "When you knowledge_get a result and it carries `potential_conflicts`, resolve it if it's " +
-      "material to your task (see knowledge_get / the conflict-resolution wiki playbook).",
+      "material to your task (see knowledge_get / the conflict-resolution wiki playbook). " +
+      "If semantic ranking is unavailable the search transparently degrades to keyword-only " +
+      "(meta.fallback: true, meta.search_mode: 'keyword_only') and now reports meta.fallback_reason " +
+      "— a stable tag naming WHY (e.g. no_embedding_key, embedding_circuit_open, " +
+      "embedding_provider_error_<status>, embedding_timeout).",
     inputSchema: {
       type: "object",
       properties: {
@@ -2665,7 +2678,10 @@ const TOOLS = [
       "memory, scope to a memory_type/agent/conversation via the memory_types/agents/" +
       "conversation_id filters (articles whose metadata carries those keys). NOTE (#163): for " +
       "an agent key, another agent's private/owner memories are never returned (results AND " +
-      "linked refs) regardless of the agents= filter — visibility is enforced, not advisory.",
+      "linked refs) regardless of the agents= filter — visibility is enforced, not advisory. " +
+      "If semantic ranking is unavailable this degrades to keyword-only (meta.fallback: true) and " +
+      "now reports meta.fallback_reason — a stable tag naming WHY (e.g. no_embedding_key, " +
+      "embedding_circuit_open, embedding_provider_error_<status>, embedding_timeout).",
     inputSchema: {
       type: "object",
       properties: {
@@ -3364,19 +3380,23 @@ const TOOLS = [
   {
     name: "llm_config",
     description:
-      "Get the tenant's BYO Anthropic LLM configuration: the per-operation model " +
-      "choices, whether a key is configured (has_api_key), and a masked last-4 hint. " +
-      "NEVER returns the key itself. Requires user role (LOOPCTL_USER_KEY).",
+      "Get the tenant's BYO Anthropic + embedding configuration: the per-operation " +
+      "model choices, whether each key is configured (has_api_key / has_embedding_key), " +
+      "and masked last-4 hints. NEVER returns a key itself. Requires user role " +
+      "(LOOPCTL_USER_KEY).",
     inputSchema: { type: "object", properties: {}, required: [] },
   },
   {
     name: "set_llm_config",
     description:
-      "Set/rotate the tenant's OWN Anthropic API key (stored encrypted, never returned) " +
-      "and the three per-operation models (extraction/classification/merge). loopctl " +
-      "fronts no LLM cost — the tenant's key bills the tenant. Any subset of fields may " +
-      "be sent; omitting api_key leaves the existing key untouched. Model ids are " +
-      "free-form (any model the key permits). Requires user role (LOOPCTL_USER_KEY).",
+      "Set/rotate the tenant's OWN Anthropic API key AND OpenAI embedding key (both " +
+      "stored encrypted, never returned) and the per-operation models " +
+      "(extraction/classification/merge/embedding). loopctl fronts no cost — the " +
+      "tenant's keys bill the tenant. Mandatory BYO for embeddings: without an " +
+      "embedding_api_key the tenant's articles are not vector-searchable. Any subset " +
+      "of fields may be sent; omitting a key leaves the existing key untouched. Model " +
+      "ids are free-form (any model the key permits). Requires user role " +
+      "(LOOPCTL_USER_KEY).",
     inputSchema: {
       type: "object",
       properties: {
@@ -3396,6 +3416,16 @@ const TOOLS = [
           type: "string",
           description: "Model id for article merge synthesis (null → server default).",
         },
+        embedding_api_key: {
+          type: "string",
+          description:
+            "OpenAI-compatible embedding API key (write-only; stored encrypted, never returned).",
+        },
+        embedding_model: {
+          type: "string",
+          description:
+            "Embedding model id (null → server default text-embedding-3-small).",
+        },
       },
       required: [],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopctl-mcp-server",
-  "version": "2.31.1",
+  "version": "2.33.0",
   "description": "MCP server for loopctl — structural trust for AI development loops",
   "type": "module",
   "main": "index.js",