@minns/openclaw-minns 0.2.0 → 0.2.1
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.
- package/README.md +3 -3
- package/dist/config.js +1 -1
- package/dist/config.js.map +1 -1
- package/dist/index.d.ts +5 -0
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -0
- package/openclaw.plugin.json +22 -0
- package/package.json +8 -5
- package/skills/minns-memory/SKILL.md +0 -37
package/README.md
CHANGED
|
@@ -26,7 +26,7 @@ Add the MCP server entry to your OpenClaw config (typically `~/.config/openclaw/
|
|
|
26
26
|
"minns": {
|
|
27
27
|
"command": "openclaw-minns-mcp",
|
|
28
28
|
"env": {
|
|
29
|
-
"MINNS_BASE_URL": "
|
|
29
|
+
"MINNS_BASE_URL": "https://minns.ai/api",
|
|
30
30
|
"MINNS_DEBUG": "false"
|
|
31
31
|
}
|
|
32
32
|
}
|
|
@@ -55,7 +55,7 @@ If your EventGraphDB instance requires authentication:
|
|
|
55
55
|
|
|
56
56
|
| Variable | Default | Description |
|
|
57
57
|
| ---------------- | ------------------------- | ---------------------------------------------- |
|
|
58
|
-
| `MINNS_BASE_URL` | `
|
|
58
|
+
| `MINNS_BASE_URL` | `https://minns.ai/api` | EventGraphDB HTTP endpoint |
|
|
59
59
|
| `MINNS_API_KEY` | *(none)* | Optional Bearer token for authenticated access |
|
|
60
60
|
| `MINNS_DEBUG` | `false` | Set to `true` for verbose stderr logging |
|
|
61
61
|
|
|
@@ -79,7 +79,7 @@ Start EventGraphDB, then run the binary directly. It speaks JSON-RPC 2.0 over st
|
|
|
79
79
|
|
|
80
80
|
```bash
|
|
81
81
|
# Start the MCP server
|
|
82
|
-
MINNS_BASE_URL=
|
|
82
|
+
MINNS_BASE_URL=https://minns.ai/api npx openclaw-minns-mcp
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
In another terminal, pipe a JSON-RPC request to test:
|
package/dist/config.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createClient } from "minns-sdk";
|
|
2
2
|
export function loadConfig() {
|
|
3
3
|
return {
|
|
4
|
-
baseUrl: process.env.MINNS_BASE_URL ?? "
|
|
4
|
+
baseUrl: process.env.MINNS_BASE_URL ?? "https://minns.ai/api",
|
|
5
5
|
debug: process.env.MINNS_DEBUG === "true",
|
|
6
6
|
apiKey: process.env.MINNS_API_KEY || undefined,
|
|
7
7
|
};
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiC,MAAM,WAAW,CAAC;AAQxE,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiC,MAAM,WAAW,CAAC;AAQxE,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,sBAAsB;QAC7D,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM;QACzC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAgB;IAC1C,MAAM,IAAI,GAA6B;QACrC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;IAEF,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,GAAG;YACb,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}
|
package/dist/index.d.ts
ADDED
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,EAAE,EAAE,OAAO;IACX,QAAQ,CAAC,GAAQ;QACf,iDAAiD;QACjD,6CAA6C;QAC7C,yCAAyC;IAC3C,CAAC;CACF,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "minns",
|
|
3
|
+
"name": "Minns MCP Bridge",
|
|
4
|
+
"description": "Registers Minns MCP stdio bridge for OpenClaw",
|
|
5
|
+
"configSchema": {
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"properties": {
|
|
9
|
+
"command": { "type": "string", "default": "openclaw-minns-mcp" },
|
|
10
|
+
"env": {
|
|
11
|
+
"type": "object",
|
|
12
|
+
"additionalProperties": { "type": "string" }
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"uiHints": {
|
|
17
|
+
"command": { "label": "MCP Command" },
|
|
18
|
+
"env.MINNS_BASE_URL": { "label": "Minns Base URL" },
|
|
19
|
+
"env.MINNS_API_KEY": { "label": "Minns API Key", "sensitive": true },
|
|
20
|
+
"env.MINNS_DEBUG": { "label": "Minns Debug" }
|
|
21
|
+
}
|
|
22
|
+
}
|
package/package.json
CHANGED
|
@@ -1,18 +1,21 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@minns/openclaw-minns",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "MCP stdio server integrating Minns EventGraphDB into OpenClaw",
|
|
5
5
|
"type": "module",
|
|
6
|
-
"main": "./dist/
|
|
7
|
-
"types": "./dist/
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
8
|
"bin": {
|
|
9
9
|
"openclaw-minns-mcp": "./dist/mcp.js"
|
|
10
10
|
},
|
|
11
11
|
"files": [
|
|
12
12
|
"dist",
|
|
13
|
-
"
|
|
14
|
-
"
|
|
13
|
+
"README.md",
|
|
14
|
+
"openclaw.plugin.json"
|
|
15
15
|
],
|
|
16
|
+
"openclaw": {
|
|
17
|
+
"extensions": ["./dist/index.js"]
|
|
18
|
+
},
|
|
16
19
|
"scripts": {
|
|
17
20
|
"build": "tsc",
|
|
18
21
|
"prepublishOnly": "npm run build"
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
# Minns Memory Skill
|
|
2
|
-
|
|
3
|
-
Fallback policy skill for agents that do not yet have native MCP tool support.
|
|
4
|
-
When active, the agent should follow these rules automatically.
|
|
5
|
-
|
|
6
|
-
## Before answering
|
|
7
|
-
|
|
8
|
-
1. Call `memory.search` with a short query derived from the user's message.
|
|
9
|
-
2. If relevant memories are returned, incorporate them into your response.
|
|
10
|
-
3. If no memories match, proceed without referencing memory.
|
|
11
|
-
|
|
12
|
-
## After answering
|
|
13
|
-
|
|
14
|
-
1. Decide whether the interaction produced a **durable fact or preference** worth keeping.
|
|
15
|
-
- Examples: user timezone, preferred language, project conventions, confirmed decisions.
|
|
16
|
-
2. If yes, call `memory.capture` with a concise summary of the fact.
|
|
17
|
-
3. If the interaction was ephemeral (greetings, small talk, transient debug output), do **not** capture it.
|
|
18
|
-
|
|
19
|
-
## Safety rules
|
|
20
|
-
|
|
21
|
-
- **Never** store secrets, passwords, API keys, tokens, or credentials.
|
|
22
|
-
- **Never** store personally identifiable information (PII) unless the user explicitly asks you to remember it.
|
|
23
|
-
- Only store facts that are likely to remain true across sessions.
|
|
24
|
-
- Prefer short, precise text over long paragraphs when capturing memories.
|
|
25
|
-
|
|
26
|
-
## Tool reference
|
|
27
|
-
|
|
28
|
-
| Tool | When to use |
|
|
29
|
-
| ---------------------------- | ------------------------------------------------ |
|
|
30
|
-
| `memory.search` | Before answering -- recall relevant context |
|
|
31
|
-
| `memory.capture` | After answering -- persist durable facts |
|
|
32
|
-
| `memory.memories` | When the user asks "what do you know about me?" |
|
|
33
|
-
| `memory.strategies` | When reviewing learned strategies for an agent |
|
|
34
|
-
| `strategy.similar` | When looking for reusable approaches |
|
|
35
|
-
| `strategy.suggest_next_action` | When deciding what to do next in a workflow |
|
|
36
|
-
| `claims.search` | When verifying factual claims from past events |
|
|
37
|
-
| `health.check` | When diagnosing connectivity to EventGraphDB |
|