superlocalmemory 4.2.2 → 4.2.3

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 (144) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CHANGELOG.md +39 -0
  3. package/README.md +13 -5
  4. package/antigravity-plugin/_GENERATED.md +1 -1
  5. package/antigravity-plugin/agents/slm-governance-advisor.md +1 -1
  6. package/antigravity-plugin/agents/slm-loop-runner.md +1 -1
  7. package/antigravity-plugin/agents/slm-memory-advisor.md +1 -1
  8. package/antigravity-plugin/agents/slm-optimize-advisor.md +1 -1
  9. package/antigravity-plugin/plugin.json +1 -1
  10. package/antigravity-plugin/skills/slm-bot-memory/SKILL.md +1 -1
  11. package/antigravity-plugin/skills/slm-cache/SKILL.md +1 -1
  12. package/antigravity-plugin/skills/slm-compress/SKILL.md +1 -1
  13. package/antigravity-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
  14. package/antigravity-plugin/skills/slm-governance/SKILL.md +1 -1
  15. package/antigravity-plugin/skills/slm-graph/SKILL.md +1 -1
  16. package/antigravity-plugin/skills/slm-loop/SKILL.md +4 -3
  17. package/antigravity-plugin/skills/slm-media/SKILL.md +1 -1
  18. package/antigravity-plugin/skills/slm-mesh/SKILL.md +1 -1
  19. package/antigravity-plugin/skills/slm-profile/SKILL.md +1 -1
  20. package/antigravity-plugin/skills/slm-recall/SKILL.md +1 -1
  21. package/antigravity-plugin/skills/slm-remember/SKILL.md +1 -1
  22. package/antigravity-plugin/skills/slm-scope/SKILL.md +1 -1
  23. package/antigravity-plugin/skills/slm-session/SKILL.md +1 -1
  24. package/antigravity-plugin/skills/slm-status/SKILL.md +1 -1
  25. package/codex-plugin/.claude-plugin/plugin.json +1 -1
  26. package/codex-plugin/.codex-plugin/plugin.json +1 -1
  27. package/codex-plugin/AGENTS.md +1 -1
  28. package/codex-plugin/README.md +2 -2
  29. package/codex-plugin/_GENERATED.md +1 -1
  30. package/codex-plugin/agents/slm-governance-advisor.md +1 -1
  31. package/codex-plugin/agents/slm-loop-runner.md +1 -1
  32. package/codex-plugin/agents/slm-memory-advisor.md +1 -1
  33. package/codex-plugin/agents/slm-optimize-advisor.md +1 -1
  34. package/codex-plugin/skills/slm-bot-memory/SKILL.md +1 -1
  35. package/codex-plugin/skills/slm-cache/SKILL.md +1 -1
  36. package/codex-plugin/skills/slm-compress/SKILL.md +1 -1
  37. package/codex-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
  38. package/codex-plugin/skills/slm-governance/SKILL.md +1 -1
  39. package/codex-plugin/skills/slm-graph/SKILL.md +1 -1
  40. package/codex-plugin/skills/slm-loop/SKILL.md +4 -3
  41. package/codex-plugin/skills/slm-media/SKILL.md +1 -1
  42. package/codex-plugin/skills/slm-mesh/SKILL.md +1 -1
  43. package/codex-plugin/skills/slm-profile/SKILL.md +1 -1
  44. package/codex-plugin/skills/slm-recall/SKILL.md +1 -1
  45. package/codex-plugin/skills/slm-remember/SKILL.md +1 -1
  46. package/codex-plugin/skills/slm-scope/SKILL.md +1 -1
  47. package/codex-plugin/skills/slm-session/SKILL.md +1 -1
  48. package/codex-plugin/skills/slm-status/SKILL.md +1 -1
  49. package/copilot-plugin/.github/agents/slm-governance-advisor.agent.md +2 -2
  50. package/copilot-plugin/.github/agents/slm-loop-runner.agent.md +2 -2
  51. package/copilot-plugin/.github/agents/slm-memory-advisor.agent.md +2 -2
  52. package/copilot-plugin/.github/agents/slm-optimize-advisor.agent.md +2 -2
  53. package/copilot-plugin/.github/copilot-instructions.md +4 -4
  54. package/copilot-plugin/.github/prompts/slm-bot-memory.prompt.md +2 -2
  55. package/copilot-plugin/.github/prompts/slm-cache.prompt.md +2 -2
  56. package/copilot-plugin/.github/prompts/slm-compress.prompt.md +2 -2
  57. package/copilot-plugin/.github/prompts/slm-getting-started-bot.prompt.md +2 -2
  58. package/copilot-plugin/.github/prompts/slm-governance.prompt.md +2 -2
  59. package/copilot-plugin/.github/prompts/slm-graph.prompt.md +2 -2
  60. package/copilot-plugin/.github/prompts/slm-loop.prompt.md +5 -4
  61. package/copilot-plugin/.github/prompts/slm-media.prompt.md +2 -2
  62. package/copilot-plugin/.github/prompts/slm-mesh.prompt.md +2 -2
  63. package/copilot-plugin/.github/prompts/slm-profile.prompt.md +2 -2
  64. package/copilot-plugin/.github/prompts/slm-recall.prompt.md +2 -2
  65. package/copilot-plugin/.github/prompts/slm-remember.prompt.md +2 -2
  66. package/copilot-plugin/.github/prompts/slm-scope.prompt.md +2 -2
  67. package/copilot-plugin/.github/prompts/slm-session.prompt.md +2 -2
  68. package/copilot-plugin/.github/prompts/slm-status.prompt.md +2 -2
  69. package/copilot-plugin/.github/prompts/slm-web-access.prompt.md +1 -1
  70. package/copilot-plugin/README.md +2 -2
  71. package/copilot-plugin/_GENERATED.md +1 -1
  72. package/hermes-plugin/__init__.py +5 -2
  73. package/hermes-plugin/agents/slm-governance-advisor.md +1 -1
  74. package/hermes-plugin/agents/slm-loop-runner.md +1 -1
  75. package/hermes-plugin/agents/slm-memory-advisor.md +1 -1
  76. package/hermes-plugin/agents/slm-optimize-advisor.md +1 -1
  77. package/hermes-plugin/plugin.yaml +1 -1
  78. package/hermes-plugin/skills/slm-bot-memory/SKILL.md +1 -1
  79. package/hermes-plugin/skills/slm-cache/SKILL.md +1 -1
  80. package/hermes-plugin/skills/slm-compress/SKILL.md +1 -1
  81. package/hermes-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
  82. package/hermes-plugin/skills/slm-governance/SKILL.md +1 -1
  83. package/hermes-plugin/skills/slm-graph/SKILL.md +1 -1
  84. package/hermes-plugin/skills/slm-loop/SKILL.md +4 -3
  85. package/hermes-plugin/skills/slm-media/SKILL.md +1 -1
  86. package/hermes-plugin/skills/slm-mesh/SKILL.md +1 -1
  87. package/hermes-plugin/skills/slm-profile/SKILL.md +1 -1
  88. package/hermes-plugin/skills/slm-recall/SKILL.md +1 -1
  89. package/hermes-plugin/skills/slm-remember/SKILL.md +1 -1
  90. package/hermes-plugin/skills/slm-scope/SKILL.md +1 -1
  91. package/hermes-plugin/skills/slm-session/SKILL.md +1 -1
  92. package/hermes-plugin/skills/slm-status/SKILL.md +1 -1
  93. package/package.json +1 -1
  94. package/plugin/.claude-plugin/plugin.json +1 -1
  95. package/plugin/.cursor-plugin/plugin.json +1 -1
  96. package/plugin/CLAUDE.md +3 -3
  97. package/plugin/agents/slm-governance-advisor.md +1 -1
  98. package/plugin/agents/slm-loop-runner.md +1 -1
  99. package/plugin/agents/slm-memory-advisor.md +1 -1
  100. package/plugin/agents/slm-optimize-advisor.md +1 -1
  101. package/plugin/cursor-skills/slm-bot-memory/SKILL.md +1 -1
  102. package/plugin/cursor-skills/slm-getting-started-bot/SKILL.md +1 -1
  103. package/plugin/cursor-skills/slm-recall/SKILL.md +1 -1
  104. package/plugin/cursor-skills/slm-remember/SKILL.md +1 -1
  105. package/plugin/cursor-skills/slm-scope/SKILL.md +1 -1
  106. package/plugin/cursor-skills/slm-session/SKILL.md +1 -1
  107. package/plugin/mcp.cursor.json +1 -1
  108. package/plugin/requirements.txt +1 -1
  109. package/plugin/skills/slm-bot-memory/SKILL.md +1 -1
  110. package/plugin/skills/slm-cache/SKILL.md +1 -1
  111. package/plugin/skills/slm-compress/SKILL.md +1 -1
  112. package/plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
  113. package/plugin/skills/slm-governance/SKILL.md +1 -1
  114. package/plugin/skills/slm-graph/SKILL.md +1 -1
  115. package/plugin/skills/slm-loop/SKILL.md +4 -3
  116. package/plugin/skills/slm-media/SKILL.md +1 -1
  117. package/plugin/skills/slm-mesh/SKILL.md +1 -1
  118. package/plugin/skills/slm-profile/SKILL.md +1 -1
  119. package/plugin/skills/slm-recall/SKILL.md +1 -1
  120. package/plugin/skills/slm-remember/SKILL.md +1 -1
  121. package/plugin/skills/slm-scope/SKILL.md +1 -1
  122. package/plugin/skills/slm-session/SKILL.md +1 -1
  123. package/plugin/skills/slm-status/SKILL.md +1 -1
  124. package/plugin-src/agents/slm-governance-advisor.md +1 -1
  125. package/plugin-src/agents/slm-loop-runner.md +1 -1
  126. package/plugin-src/agents/slm-memory-advisor.md +1 -1
  127. package/plugin-src/agents/slm-optimize-advisor.md +1 -1
  128. package/plugin-src/rules/AGENTS.md +1 -1
  129. package/plugin-src/rules/CLAUDE.md.fragment +3 -3
  130. package/plugin-src/skills/slm-bot-memory/SKILL.md +1 -1
  131. package/plugin-src/skills/slm-cache/SKILL.md +1 -1
  132. package/plugin-src/skills/slm-compress/SKILL.md +1 -1
  133. package/plugin-src/skills/slm-getting-started-bot/SKILL.md +1 -1
  134. package/plugin-src/skills/slm-governance/SKILL.md +1 -1
  135. package/plugin-src/skills/slm-graph/SKILL.md +1 -1
  136. package/plugin-src/skills/slm-loop/SKILL.md +4 -3
  137. package/plugin-src/skills/slm-media/SKILL.md +1 -1
  138. package/plugin-src/skills/slm-mesh/SKILL.md +1 -1
  139. package/plugin-src/skills/slm-profile/SKILL.md +1 -1
  140. package/plugin-src/skills/slm-recall/SKILL.md +1 -1
  141. package/plugin-src/skills/slm-remember/SKILL.md +1 -1
  142. package/plugin-src/skills/slm-scope/SKILL.md +1 -1
  143. package/plugin-src/skills/slm-session/SKILL.md +1 -1
  144. package/plugin-src/skills/slm-status/SKILL.md +1 -1
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-cache
3
3
  description: KV cache for repeated reads — call slm_cache_get(key) first; on a miss do the expensive operation then slm_cache_set(key, value, ttl_seconds) to store it; on a hit use the returned value directly; always fail-open (hit:false on any error, never raises); saves tokens when the same file, query result, or tool output is read more than once in a session.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - slm_cache_set
@@ -148,4 +148,4 @@ These subcommands control daemon-level cache settings and bulk removal. They do
148
148
 
149
149
  ---
150
150
 
151
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
151
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-compress
3
3
  description: Compress large text, tool output, or transcripts to reduce context-window usage while keeping the full 1M window intact — call slm_compress(content, mode, reversible, ttl_seconds) to shrink content; if the result is lossy a ccr_id is returned so you can call slm_retrieve(ccr_id) later to recover the exact original; always fail-open (ok:false → continue with the original).
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - slm_compress
@@ -151,4 +151,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
151
151
 
152
152
  ---
153
153
 
154
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
154
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-getting-started-bot
3
3
  description: First-session orientation for SuperLocalMemory on a headless bot host (Grok Bot, or any Cursor-format plugin install with no hooks, no dashboard, and no interactive setup wizard). What is different here vs. Claude Code/Codex, which 19 tools are actually available, and the first three calls to make.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - session_init
@@ -193,4 +193,4 @@ quality on a shared box.
193
193
 
194
194
  ---
195
195
 
196
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
196
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-governance
3
3
  description: Governed-workspace behavior for SuperLocalMemory. Covers roles (admin/member/viewer) and company mode, who administers a company-mode workspace (a signed-in admin, or `slm team` on the SLM computer), `slm token show` in strict mode, what remote web apps can never see or change, retention and lifecycle settings, the audit trail, GDPR export and erasure, and how agents must behave when operating under workspace governance. The audit and retention tools need the power MCP profile. Agents must never bypass governance controls.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - audit_trail
@@ -276,4 +276,4 @@ Before running any destructive or state-changing operation (`forget`,
276
276
 
277
277
  ---
278
278
 
279
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
279
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-graph
3
3
  description: >
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - build_code_graph
@@ -319,4 +319,4 @@ All are host-only: a remote caller cannot use them.
319
319
 
320
320
  ---
321
321
 
322
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
322
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-loop
3
- description: Gate-verified bounded loops with SuperLocalMemory as the durable ledger. Use when a task has a checkable acceptance condition and you must iterate until an INDEPENDENT gate passes — never stopping because the agent believes it is done. `slm_loop_run` (MCP) waits, under hard bounds, for a recall gate to pass; `slm loop demo` shows the control flow keyless; `slm loop history` and `slm loop show <run_id>` (or `slm_loop_history` / `slm_loop_show`) inspect past runs, whose every lap is stored as queryable SLM memory (tag `loop:<name>`). Terminal statuses are DONE / HALT / PAUSE / KILLED / ERROR — report them exactly, never converting HALT/PAUSE/ERROR into success.
4
- version: "4.2.2"
3
+ description: Gate-verified bounded loops with SuperLocalMemory as the durable ledger. Use when a task has a checkable acceptance condition and you must iterate until an INDEPENDENT gate passes — never stopping because the agent believes it is done. `slm_loop_run` (MCP) waits, under hard bounds, for an independently executed check registered by the operator to pass; `slm loop demo` shows the control flow keyless; `slm loop history` and `slm loop show <run_id>` (or `slm_loop_history` / `slm_loop_show`) inspect past runs, whose every lap is stored as queryable SLM memory (tag `loop:<name>`). Terminal statuses are DONE / HALT / PAUSE / KILLED / ERROR — report them exactly, never converting HALT/PAUSE/ERROR into success.
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - slm_loop_run
@@ -38,7 +38,7 @@ subprocess or sandbox machinery. What each surface gives you:
38
38
 
39
39
  | Surface | What it does |
40
40
  |---|---|
41
- | `slm_loop_run` (MCP) | A *watcher*: each lap is a recall of `gate_query`; the loop ends when a confident match appears, or a bound trips. Use it to wait for a verification or coordination memory another agent will write (for example "build passed"). |
41
+ | `slm_loop_run` (MCP) | A *watcher* for a registered check. DONE needs `gate_contract={"job_id": ...}`: a job the operator registered with `superlocalmemory.loops.receipt_jobs.register_job` and executed with `run_registered_check`. Each lap's recall of `gate_query` only locates context; a matching memory alone never passes. Without a registered job the run ends HALT ("operator-registered job_id required"), which is the correct, honest outcome. |
42
42
  | `slm loop demo` (CLI) | A keyless convergence demo: a stub proposer, a deterministic gate that passes on lap 3, every lap recorded. Proves the engine and ledger work end to end. |
43
43
  | `slm loop history`, `slm loop show` / `slm_loop_history`, `slm_loop_show` | Read the ledger of past runs. |
44
44
  | `superlocalmemory.loops.run_bounded_loop` (Python) | The engine itself, for code that supplies its own runner and gate callables. |
@@ -74,6 +74,7 @@ slm_loop_run(
74
74
  max_tokens: int = 0, # optional token budget; 0 disables
75
75
  no_progress_window: int = 0, # halt after N no-change laps; leave 0 for a watcher
76
76
  require_support: bool = False,# pass only if the answer check ran and judged it sufficient
77
+ gate_contract: dict | None = None, # {"job_id": <operator registration>}; required for DONE
77
78
  )
78
79
  ```
79
80
 
@@ -182,4 +183,4 @@ Guides: `docs/skill-evolution.md`, `docs/bounded-loops-bridge.md`.
182
183
 
183
184
  ---
184
185
 
185
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
186
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-media
3
3
  description: Save pictures and PDFs in SuperLocalMemory and find them again by describing them. Covers when to save a picture or document, remember_media, remember_document, get_media, media_status and media_upload_link, how recall returns pictures and PDF pages, the limits, what stays private, turning the feature on with `slm media` (16 GB of memory needed), connecting folders with `slm sources`, and how web apps add files through one-time upload links. Off by default.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - remember_media
@@ -338,4 +338,4 @@ minutes (previous vectors are kept) and let them decide.
338
338
 
339
339
  ---
340
340
 
341
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
341
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-mesh
3
3
  description: Cross-session peer coordination via the SLM mesh network. Lets multiple AI agent sessions on the same machine, and web apps the owner has allowed (ChatGPT, Claude on the web, Grok Bot, Muse, Composio), discover each other, send messages, wait for replies with mesh_wait, share lightweight state, and lock files to avoid conflicts. Covers the at-least-once delivery rule for web apps (pass ack_ids back as ack) and the two permissions a web app needs. Available in the default tool set and in the full, power and mesh MCP profiles. Only `slm mesh status` and `slm mesh peers` exist on the command line; the other tools are MCP-only.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - mesh_summary
@@ -387,4 +387,4 @@ mesh availability.
387
387
 
388
388
  ---
389
389
 
390
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
390
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-profile
3
3
  description: Memory profiles (separate namespaces inside one SuperLocalMemory store) and MCP tool sets (which tools your host sees). Use switch_profile or slm profile switch to change the active memory profile, the profile_id argument to read or write another profile for one call, and SLM_MCP_PROFILE to choose a tool set. Required when working across multiple projects, clients, or tenants.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - switch_profile
@@ -157,4 +157,4 @@ anything but `core` or `mesh`.
157
157
 
158
158
  ---
159
159
 
160
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
160
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-recall
3
3
  description: Search and retrieve facts, decisions, and past context from SuperLocalMemory. Use when the user asks to recall, find, search, or "what did we decide/say about X". Triggers multi-channel semantic retrieval with reranking; always call before storing anything new.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - recall
@@ -520,4 +520,4 @@ See `slm-profile`.
520
520
 
521
521
  ---
522
522
 
523
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
523
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-remember
3
3
  description: Capture durable facts, decisions, constraints, and gotchas into SuperLocalMemory. Use when the user says "remember that", "save this decision", "note this constraint", or when a session produces a conclusion worth persisting across sessions. Always recall first to avoid duplicates.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - remember
@@ -377,4 +377,4 @@ sessions on this machine, so use it only when the user asks to move. See
377
377
 
378
378
  ---
379
379
 
380
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
380
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-scope
3
3
  description: Controls memory visibility across profiles — personal (private, default), shared (selected profiles), or global (all profiles on this machine). Default is always personal. Only change scope when the user explicitly asks to share a memory across workspaces. Works with both remember (write scope) and recall (read scope flags).
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - remember
@@ -180,4 +180,4 @@ to review the impact. See `slm-remember` for the full deletion discipline.
180
180
 
181
181
  ---
182
182
 
183
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
183
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-session
3
3
  description: Manage SuperLocalMemory session lifecycle — call session_init once at the start of every fresh session to load relevant project context and get a session_id; call close_session when work is meaningfully complete to commit temporal summaries. Correct lifecycle hygiene is what makes SLM's learning loop work.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - session_init
@@ -288,4 +288,4 @@ answered. To also surface shared or global facts, call `recall` with
288
288
 
289
289
  ---
290
290
 
291
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
291
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-status
3
3
  description: Health and optimization stats for SuperLocalMemory — call slm_optimize_stats() for live compression and cache counters (compress_runs, tokens_saved_compress, cache_proxy_hits, cache_proxy_misses, cache_kv_hits, cache_kv_misses); run slm status [--json] for system state (mode, profile, DB size, fact/entity/edge counts) and slm doctor [--json] for preflight including the "Optimize (Surface B)" health line; use together to confirm optimization is actually saving tokens.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - slm_optimize_stats
@@ -233,4 +233,4 @@ the memory-engine upgrade is pending.
233
233
 
234
234
  ---
235
235
 
236
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
236
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: slm-web-access
3
3
  description: Set up and troubleshoot SuperLocalMemory Web access, the optional link that lets web apps (ChatGPT, Claude on the web, Muse, Composio, other remote MCP clients) use the memory on this computer. Covers turning it on from the dashboard, adding and removing apps, read/save/session permissions, the second yes for bot messages and pictures (the Web access switches in Connected apps), one-time upload links for pictures and PDFs, what leaves the computer, renewal, the connection states, the errors a web app can see, and the copy-paste instructions for web agents.
4
- version: "4.2.2"
4
+ version: "4.2.3"
5
5
  agent: agent
6
6
  tools:
7
7
  - get_status
@@ -1,4 +1,4 @@
1
- # SuperLocalMemory — GitHub Copilot plugin (v4.2.2)
1
+ # SuperLocalMemory — GitHub Copilot plugin (v4.2.3)
2
2
 
3
3
  Empowers GitHub Copilot (VS Code, Visual Studio, JetBrains, Eclipse, CLI) with SuperLocalMemory as its long-term brain — at parity with the Claude and Codex plugins.
4
4
 
@@ -23,4 +23,4 @@ Then copy the add-ons from this folder's `.github/` into your project's `.github
23
23
 
24
24
  MCP works on every Copilot IDE at GA. Prompts, agents, and hooks are additive and degrade gracefully where an IDE does not yet support them (hooks are VS Code Preview as of 2026). SLM lifecycle also has an instruction-level fallback in `copilot-instructions.md`, so memory works even without hooks.
25
25
 
26
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
26
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -2,7 +2,7 @@
2
2
 
3
3
  Built by `scripts/build-copilot-plugin.mjs` from the single source in `plugin-src/` (+ `ide/configs/vscode-copilot-mcp.json`, `plugin/CLAUDE.md`). Version stamped from `plugin-src/manifest.json`.
4
4
 
5
- Version: **4.2.2**
5
+ Version: **4.2.3**
6
6
 
7
7
  | Output | Source |
8
8
  |---|---|
@@ -64,7 +64,7 @@ ROLES = {
64
64
  }
65
65
  _MAX_TEXT = 8_000
66
66
  # Stamped by scripts/build-hermes-plugin.mjs from pyproject.toml at build time.
67
- _RELEASE_SLM_VERSION = (4, 2, 2)
67
+ _RELEASE_SLM_VERSION = (4, 2, 3)
68
68
  _SECRET_PATTERNS = (
69
69
  re.compile(r"\bsk-[A-Za-z0-9_-]{12,}\b"),
70
70
  re.compile(r"\b(?:AKIA|ASIA)[A-Z0-9]{16}\b"),
@@ -195,7 +195,10 @@ class SlmHermesPlugin:
195
195
  if not session_id or not query:
196
196
  return None
197
197
  timeout = 5 if self._mode() == "remote" else 3 # the 3 s recall ceiling plus network
198
- result = self._mcp("recall", {"query": query, "session_id": session_id, "agent_id": "hermes", "limit": 5}, timeout=timeout)
198
+ # 4.2.3: a prefetch blocks the turn, so it names its budget and gets
199
+ # keyword matches in time instead of a long full recall it abandons.
200
+ result = self._mcp("recall", {"query": query, "session_id": session_id, "agent_id": "hermes", "limit": 5,
201
+ "budget_s": timeout - 0.5}, timeout=timeout)
199
202
  if not result.get("ok"):
200
203
  return None
201
204
  rendered = _redact(result.get("result"), 6_000)
@@ -81,4 +81,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
81
81
  # What NOT to do
82
82
  Never session_init twice; never forget without dry-run preview; never run `slm gdpr erase --yes` unasked; never store secrets; never bypass role checks; never claim an erasure succeeded without verifying via recall.
83
83
 
84
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
84
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -79,4 +79,4 @@ assessment. The gate is the authority.
79
79
 
80
80
  ---
81
81
 
82
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
82
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -51,4 +51,4 @@ slm-recall · slm-remember · slm-session · slm-scope · slm-profile · slm-gov
51
51
  # What NOT to do
52
52
  Never session_init twice; never forget dry_run=False without reporting preview; never switch the active profile unasked; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit; never bypass scope or governance restrictions.
53
53
 
54
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
54
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -41,4 +41,4 @@ slm-compress · slm-cache · slm-status · slm-profile
41
41
  # What NOT to do
42
42
  Never compress code-for-edit/JSON-to-parse/<500 chars; never store secrets/ccr_ids; never let optimize failure block/alter the task; never claim a specific savings %; never hand a ccr_id to another agent.
43
43
 
44
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
44
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,5 +1,5 @@
1
1
  name: superlocalmemory
2
- version: 4.2.2
2
+ version: 4.2.3
3
3
  description: "Native, additive SuperLocalMemory lifecycle, skills, commands, and advisors for Hermes."
4
4
  author: Qualixar
5
5
  manifest_version: 1
@@ -178,4 +178,4 @@ store every local bot on that computer can reach.
178
178
 
179
179
  ---
180
180
 
181
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
181
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -144,4 +144,4 @@ These subcommands control daemon-level cache settings and bulk removal. They do
144
144
 
145
145
  ---
146
146
 
147
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
147
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -147,4 +147,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
147
147
 
148
148
  ---
149
149
 
150
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
150
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -194,4 +194,4 @@ quality on a shared box.
194
194
 
195
195
  ---
196
196
 
197
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
197
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -274,4 +274,4 @@ Before running any destructive or state-changing operation (`forget`,
274
274
 
275
275
  ---
276
276
 
277
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
277
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -324,4 +324,4 @@ All are host-only: a remote caller cannot use them.
324
324
 
325
325
  ---
326
326
 
327
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
327
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: slm-loop
3
- description: Gate-verified bounded loops with SuperLocalMemory as the durable ledger. Use when a task has a checkable acceptance condition and you must iterate until an INDEPENDENT gate passes — never stopping because the agent believes it is done. `slm_loop_run` (MCP) waits, under hard bounds, for a recall gate to pass; `slm loop demo` shows the control flow keyless; `slm loop history` and `slm loop show <run_id>` (or `slm_loop_history` / `slm_loop_show`) inspect past runs, whose every lap is stored as queryable SLM memory (tag `loop:<name>`). Terminal statuses are DONE / HALT / PAUSE / KILLED / ERROR — report them exactly, never converting HALT/PAUSE/ERROR into success.
3
+ description: Gate-verified bounded loops with SuperLocalMemory as the durable ledger. Use when a task has a checkable acceptance condition and you must iterate until an INDEPENDENT gate passes — never stopping because the agent believes it is done. `slm_loop_run` (MCP) waits, under hard bounds, for an independently executed check registered by the operator to pass; `slm loop demo` shows the control flow keyless; `slm loop history` and `slm loop show <run_id>` (or `slm_loop_history` / `slm_loop_show`) inspect past runs, whose every lap is stored as queryable SLM memory (tag `loop:<name>`). Terminal statuses are DONE / HALT / PAUSE / KILLED / ERROR — report them exactly, never converting HALT/PAUSE/ERROR into success.
4
4
  when_to_use: "run a bounded loop, gate-verified task, iterate until tests pass, verify against an independent gate, don't trust the agent's own done claim, slm loop, convergence loop, loop until green, loop ledger, wait for another agent's result"
5
5
  allowed-tools: slm_loop_run, slm_loop_history, slm_loop_show, recall, report_outcome, get_soft_prompts, skill_health, skill_lineage, evolve_skill, observe_bounded_loop_evidence, Bash
6
6
  ---
@@ -26,7 +26,7 @@ subprocess or sandbox machinery. What each surface gives you:
26
26
 
27
27
  | Surface | What it does |
28
28
  |---|---|
29
- | `slm_loop_run` (MCP) | A *watcher*: each lap is a recall of `gate_query`; the loop ends when a confident match appears, or a bound trips. Use it to wait for a verification or coordination memory another agent will write (for example "build passed"). |
29
+ | `slm_loop_run` (MCP) | A *watcher* for a registered check. DONE needs `gate_contract={"job_id": ...}`: a job the operator registered with `superlocalmemory.loops.receipt_jobs.register_job` and executed with `run_registered_check`. Each lap's recall of `gate_query` only locates context; a matching memory alone never passes. Without a registered job the run ends HALT ("operator-registered job_id required"), which is the correct, honest outcome. |
30
30
  | `slm loop demo` (CLI) | A keyless convergence demo: a stub proposer, a deterministic gate that passes on lap 3, every lap recorded. Proves the engine and ledger work end to end. |
31
31
  | `slm loop history`, `slm loop show` / `slm_loop_history`, `slm_loop_show` | Read the ledger of past runs. |
32
32
  | `superlocalmemory.loops.run_bounded_loop` (Python) | The engine itself, for code that supplies its own runner and gate callables. |
@@ -62,6 +62,7 @@ slm_loop_run(
62
62
  max_tokens: int = 0, # optional token budget; 0 disables
63
63
  no_progress_window: int = 0, # halt after N no-change laps; leave 0 for a watcher
64
64
  require_support: bool = False,# pass only if the answer check ran and judged it sufficient
65
+ gate_contract: dict | None = None, # {"job_id": <operator registration>}; required for DONE
65
66
  )
66
67
  ```
67
68
 
@@ -170,4 +171,4 @@ Guides: `docs/skill-evolution.md`, `docs/bounded-loops-bridge.md`.
170
171
 
171
172
  ---
172
173
 
173
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
174
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -337,4 +337,4 @@ minutes (previous vectors are kept) and let them decide.
337
337
 
338
338
  ---
339
339
 
340
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
340
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -386,4 +386,4 @@ mesh availability.
386
386
 
387
387
  ---
388
388
 
389
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
389
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -161,4 +161,4 @@ anything but `core` or `mesh`.
161
161
 
162
162
  ---
163
163
 
164
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
164
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -515,4 +515,4 @@ See `slm-profile`.
515
515
 
516
516
  ---
517
517
 
518
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
518
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -372,4 +372,4 @@ sessions on this machine, so use it only when the user asks to move. See
372
372
 
373
373
  ---
374
374
 
375
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
375
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -180,4 +180,4 @@ to review the impact. See `slm-remember` for the full deletion discipline.
180
180
 
181
181
  ---
182
182
 
183
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
183
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -288,4 +288,4 @@ answered. To also surface shared or global facts, call `recall` with
288
288
 
289
289
  ---
290
290
 
291
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
291
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -228,4 +228,4 @@ the memory-engine upgrade is pending.
228
228
 
229
229
  ---
230
230
 
231
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
231
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "superlocalmemory",
3
- "version": "4.2.2",
3
+ "version": "4.2.3",
4
4
  "description": "The governed memory brain for AI agents: one local memory for Claude Code, Codex, Cursor, Copilot, ChatGPT and any MCP client. Honest recall, documents and pictures, roles, audit and GDPR erasure.",
5
5
  "keywords": [
6
6
  "agent-memory",
@@ -15,5 +15,5 @@
15
15
  "mcpServers": "./.mcp.json",
16
16
  "name": "superlocalmemory",
17
17
  "repository": "https://github.com/qualixar/superlocalmemory",
18
- "version": "4.2.2"
18
+ "version": "4.2.3"
19
19
  }
@@ -20,5 +20,5 @@
20
20
  "name": "superlocalmemory",
21
21
  "repository": "https://github.com/qualixar/superlocalmemory",
22
22
  "skills": "./cursor-skills/",
23
- "version": "4.2.2"
23
+ "version": "4.2.3"
24
24
  }
package/plugin/CLAUDE.md CHANGED
@@ -1,4 +1,4 @@
1
- <!-- BEGIN SuperLocalMemory v4.2.2 -->
1
+ <!-- BEGIN SuperLocalMemory v4.2.3 -->
2
2
 
3
3
  ## SuperLocalMemory (SLM) — Agent Rules
4
4
 
@@ -51,6 +51,6 @@ slm-recall · slm-remember · slm-session · slm-status · slm-cache · slm-comp
51
51
  ### Subagents
52
52
  slm-memory-advisor (memory decisions, session hygiene, scope/profile guidance) · slm-optimize-advisor (context compression + KV cache) · slm-governance-advisor (scope/roles/compliance/GDPR) · slm-loop-runner (bounded, gate-verified loops)
53
53
 
54
- <!-- END SuperLocalMemory v4.2.2 -->
54
+ <!-- END SuperLocalMemory v4.2.3 -->
55
55
 
56
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
56
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -81,4 +81,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
81
81
  # What NOT to do
82
82
  Never session_init twice; never forget without dry-run preview; never run `slm gdpr erase --yes` unasked; never store secrets; never bypass role checks; never claim an erasure succeeded without verifying via recall.
83
83
 
84
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
84
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -79,4 +79,4 @@ assessment. The gate is the authority.
79
79
 
80
80
  ---
81
81
 
82
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
82
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -51,4 +51,4 @@ slm-recall · slm-remember · slm-session · slm-scope · slm-profile · slm-gov
51
51
  # What NOT to do
52
52
  Never session_init twice; never forget dry_run=False without reporting preview; never switch the active profile unasked; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit; never bypass scope or governance restrictions.
53
53
 
54
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
54
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -41,4 +41,4 @@ slm-compress · slm-cache · slm-status · slm-profile
41
41
  # What NOT to do
42
42
  Never compress code-for-edit/JSON-to-parse/<500 chars; never store secrets/ccr_ids; never let optimize failure block/alter the task; never claim a specific savings %; never hand a ccr_id to another agent.
43
43
 
44
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
44
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later
@@ -178,4 +178,4 @@ store every local bot on that computer can reach.
178
178
 
179
179
  ---
180
180
 
181
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
181
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -194,4 +194,4 @@ quality on a shared box.
194
194
 
195
195
  ---
196
196
 
197
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
197
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -515,4 +515,4 @@ See `slm-profile`.
515
515
 
516
516
  ---
517
517
 
518
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
518
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -372,4 +372,4 @@ sessions on this machine, so use it only when the user asks to move. See
372
372
 
373
373
  ---
374
374
 
375
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
375
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -180,4 +180,4 @@ to review the impact. See `slm-remember` for the full deletion discipline.
180
180
 
181
181
  ---
182
182
 
183
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
183
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -288,4 +288,4 @@ answered. To also surface shared or global facts, call `recall` with
288
288
 
289
289
  ---
290
290
 
291
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
291
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -3,7 +3,7 @@
3
3
  "superlocalmemory": {
4
4
  "args": [
5
5
  "--from",
6
- "superlocalmemory==4.2.2",
6
+ "superlocalmemory==4.2.3",
7
7
  "slm",
8
8
  "mcp"
9
9
  ],
@@ -1 +1 @@
1
- superlocalmemory==4.2.2
1
+ superlocalmemory==4.2.3
@@ -178,4 +178,4 @@ store every local bot on that computer can reach.
178
178
 
179
179
  ---
180
180
 
181
- *SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
181
+ *SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later*
@@ -144,4 +144,4 @@ These subcommands control daemon-level cache settings and bulk removal. They do
144
144
 
145
145
  ---
146
146
 
147
- SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
147
+ SuperLocalMemory v4.2.3 · Qualixar · AGPL-3.0-or-later