loopctl-mcp-server 2.37.0 → 2.38.0

package/README.md

@@ -121,7 +121,7 @@ REST endpoint (`PATCH /api/v1/tenants/me/llm-config`), and the docs — so you (
 autonomous agent) can self-remediate without a human. Full agent-tenant lifecycle:
 [`docs/onboarding-agent-tenant.md`](../docs/onboarding-agent-tenant.md).
 
-## Tools (82)
+## Tools (83)
 
 ### Project Tools
 
@@ -233,6 +233,7 @@ it is enforced server-side and a no-op for a non-superadmin key — see below.)
 | `memory_recall` | Semantically recall your own long-term memories most similar to `query`. When embedding generation is unavailable the response degrades to a recent-first text match with `meta.fallback: true` and a stable `meta.reason` (score is `null` on that path) — check `meta.fallback` before treating a short/empty result as a genuinely empty scope. `meta.total_count`/`meta.underfilled` are also returned. Optional: `limit`, `include_superseded`. |
 | `memory_list` | List your own long-term memories, newest first, paginated with `meta.total_count/limit/offset` (the true scoped count, never silently capped by `limit`). Optional: `limit`, `offset`, `include_superseded`, `all_subjects` (superadmin only; ignored for non-superadmin keys). |
 | `memory_forget` | Delete one of your own long-term memories by id. A foreign-subject, foreign-tenant, or unknown id returns 404 (no existence leak). Required: `id`. |
+| `memory_promote` | Call at session end to compile this session's short-term (`session`-tier) memory into durable `long_term` memory — unlike `memory_remember` (a single explicit write), this compiles the whole session in one shot; fire it once at session end, not per turn. Returns 202 with `{job_id, session_id, status: "enqueued"}` — promotion runs asynchronously, so the resulting memory is recallable via `memory_recall` only after the worker drains. You can only promote your own sessions (scope resolved server-side from your key). Required: `session_id`. |
 
 ### Knowledge Management Tools (orchestrator key)
 

package/index.js

@@ -1159,6 +1159,17 @@ async function memoryForget({ id }) {
   return toContent(result);
 }
 
+async function memoryPromote({ session_id }) {
+  const payload = { session_id };
+  const result = await apiCall(
+    "POST",
+    "/api/v1/memory/promote",
+    payload,
+    process.env.LOOPCTL_AGENT_KEY,
+  );
+  return toContent(result);
+}
+
 // --- Knowledge Management Tools (orch key) ---
 
 async function knowledgePublish({ article_id }) {
@@ -3298,6 +3309,29 @@ const TOOLS = [
       required: ["id"],
     },
   },
+  {
+    name: "memory_promote",
+    description:
+      "Call at session end to compile this session's short-term memory into durable long-term memory" +
+      " — private, scoped working state, NOT the shared knowledge wiki. Unlike " +
+      "memory_remember, which writes a single explicit fact, this compiles the WHOLE session's " +
+      "session-tier memory in one shot — fire it once at session end, not per turn. Scope " +
+      "(tenant_id/subject_id) is resolved server-side from your API key: you can only promote " +
+      "your OWN sessions. Returns 202 Accepted with `{job_id, session_id, status: \"enqueued\"}` " +
+      "— promotion runs asynchronously via a background worker, so the resulting long-term " +
+      "memory becomes recallable via memory_recall only after that worker drains, not " +
+      "immediately.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        session_id: {
+          type: "string",
+          description: "The session whose short-term memory to compile into long-term memory.",
+        },
+      },
+      required: ["session_id"],
+    },
+  },
 
   // Knowledge Management Tools (orchestrator key)
   {
@@ -4523,6 +4557,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     case "memory_forget":
       return await memoryForget(args);
 
+    case "memory_promote":
+      return await memoryPromote(args);
+
     // Knowledge Management Tools
     case "knowledge_publish":
       return await knowledgePublish(args);

package/package.json

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