waku-memory 0.2.0 → 0.3.0

package/hooks/hooks.json

@@ -0,0 +1,63 @@
+{
+  "description": "Waku Memory: the session brief and turn capture through the waku MCP server.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "mcp_tool",
+            "server": "waku",
+            "tool": "session.hook",
+            "timeout": 10,
+            "statusMessage": "Waku memory",
+            "input": {
+              "event": "${hook_event_name}",
+              "session_id": "${session_id}",
+              "cwd": "${cwd}",
+              "source": "${source}"
+            }
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "mcp_tool",
+            "server": "waku",
+            "tool": "session.hook",
+            "timeout": 10,
+            "input": {
+              "event": "${hook_event_name}",
+              "session_id": "${session_id}",
+              "cwd": "${cwd}",
+              "turn_id": "${turn_id}",
+              "prompt": "${prompt}"
+            }
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "mcp_tool",
+            "server": "waku",
+            "tool": "session.hook",
+            "timeout": 10,
+            "input": {
+              "event": "${hook_event_name}",
+              "session_id": "${session_id}",
+              "cwd": "${cwd}",
+              "turn_id": "${turn_id}",
+              "last_assistant_message": "${last_assistant_message}"
+            }
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waku-memory",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install Waku Memory into your agent harness, and turn on automatic session capture.",
   "keywords": ["mcp", "memory", "claude-code", "agent", "waku"],
   "homepage": "https://github.com/ShenSeanChen/waku-memory-backend/tree/spec-driven/shim#readme",
@@ -14,7 +14,7 @@
   },
   "type": "module",
   "bin": { "waku-memory": "./dist/index.js" },
-  "files": ["dist"],
+  "files": ["dist", ".codex-plugin", ".mcp.json", "hooks", "skills"],
   "engines": { "node": ">=20" },
   "publishConfig": { "access": "public" },
   "scripts": {

package/skills/waku/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: waku
+description: Durable memory for this person across sessions. Use memory.recall for what is known about a project and memory.remember for something worth keeping.
+---
+
+Waku Memory keeps what a person tells their agents and what their agents
+learn, and brings it back into later sessions.
+
+- At the start of a session the plugin's hooks add a short brief of the
+  project's memories to your context. It arrives on the first or second
+  prompt; nothing needs to be called for it.
+- Call `memory.recall` with `scope: "project:<name>"` when the person asks
+  what is known, or when a task depends on a preference or decision you do
+  not have. Call `memory.search` for one specific thing.
+- Call `memory.remember` when the person states a preference, a decision,
+  a procedure or a fact they will want next time. Use their words. Do not
+  store secrets, credentials or file contents.
+- What the person types and what you reply is sent to Waku after each turn
+  by the plugin's hooks; tool output is not.
+
+One-time setup the person does: after installing, Codex asks them to
+review and trust this plugin's hooks (`/hooks` in the CLI). Until then
+the brief and the capture do not run.