@astramindapp/mcp-server 0.29.1 → 0.30.0
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 +10 -0
- package/dist/cli.d.ts +1 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +13 -0
- package/dist/cli.js.map +1 -1
- package/dist/integration-guide.d.ts +22 -4
- package/dist/integration-guide.d.ts.map +1 -1
- package/dist/integration-guide.js +286 -21
- package/dist/integration-guide.js.map +1 -1
- package/dist/mind-client.d.ts +225 -6
- package/dist/mind-client.d.ts.map +1 -1
- package/dist/mind-client.js +136 -1
- package/dist/mind-client.js.map +1 -1
- package/dist/poll.d.ts +97 -0
- package/dist/poll.d.ts.map +1 -0
- package/dist/poll.js +462 -0
- package/dist/poll.js.map +1 -0
- package/dist/server.d.ts +15 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +495 -22
- package/dist/server.js.map +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -159,6 +159,16 @@ Add to `.cursor/mcp.json`:
|
|
|
159
159
|
|
|
160
160
|
The server works with any tool that supports Model Context Protocol — Claude, GPT, Gemini, Llama, or any future model.
|
|
161
161
|
|
|
162
|
+
### Hear your owner's replies while a session is open: `poll`
|
|
163
|
+
|
|
164
|
+
An agent that logs its session with `mind_sessions` keeps receiving replies typed in BotsByMIND or MIND Chat by running the packaged poller. Under Claude Code, right after `mind_sessions action=open`, arm the Monitor tool with:
|
|
165
|
+
|
|
166
|
+
```
|
|
167
|
+
npx -y @astramindapp/mcp-server poll --session <your MIND session_id>
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
(Monitor description: `BotsByMIND replies for this session`. Load Monitor with ToolSearch first if it is deferred, and re-arm it when it expires; Monitor runs cap at 30 minutes.) Every 10 seconds it checks the session without consuming anything, and when your owner has replied it prints exactly one stdout line per reply, `[BotsByMIND] <owner> replied in MIND (HH:MM): <text>`, which wakes the agent. Logs go to stderr only; the API key is never printed. Options: `--interval <seconds>` (default 10, minimum 5), `--ppid <pid>` (exit when that process is gone). The key comes from `MIND_API_KEY` or the MIND entry in your MCP config (the file `mind-mcp-setup` wrote); the base URL from `MIND_BASE_URL` (default `https://www.m-i-n-d.ai`). Grok Bots cannot be polled into: they register a "MIND wake" webhook with `mind_sessions action=wake_target_set`, and MIND tells a Grok session that has none (`wake_setup_required`) how to set it up.
|
|
171
|
+
|
|
162
172
|
## How It Works
|
|
163
173
|
|
|
164
174
|
```
|
package/dist/cli.d.ts
CHANGED
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* mind-mcp --version
|
|
9
9
|
* mind-mcp --help
|
|
10
10
|
* mind-mcp setup [...] (delegates to the setup wizard — see setup.ts)
|
|
11
|
+
* mind-mcp poll --session <id> (print each owner reply of a MIND agent session — see poll.ts)
|
|
11
12
|
*
|
|
12
13
|
* Environment variables:
|
|
13
14
|
* MIND_API_KEY — Required. Your MIND Developer API key.
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}
|
package/dist/cli.js
CHANGED
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
* mind-mcp --version
|
|
10
10
|
* mind-mcp --help
|
|
11
11
|
* mind-mcp setup [...] (delegates to the setup wizard — see setup.ts)
|
|
12
|
+
* mind-mcp poll --session <id> (print each owner reply of a MIND agent session — see poll.ts)
|
|
12
13
|
*
|
|
13
14
|
* Environment variables:
|
|
14
15
|
* MIND_API_KEY — Required. Your MIND Developer API key.
|
|
@@ -66,6 +67,9 @@ Usage:
|
|
|
66
67
|
mind-mcp --version Print the installed version
|
|
67
68
|
mind-mcp --help Show this help
|
|
68
69
|
mind-mcp setup [--key <mind_xxx>] Run the setup wizard (writes MCP configs)
|
|
70
|
+
mind-mcp poll --session <session_id> Print each owner reply of a MIND agent session, one
|
|
71
|
+
stdout line per reply (run it under Claude Code's
|
|
72
|
+
Monitor tool; see "mind-mcp poll --help")
|
|
69
73
|
|
|
70
74
|
Environment variables:
|
|
71
75
|
MIND_API_KEY Required to start the server. Your MIND Developer API key.
|
|
@@ -78,6 +82,15 @@ Get a key: https://m-i-n-d.ai → Settings → Developer → API Keys`);
|
|
|
78
82
|
}
|
|
79
83
|
async function main() {
|
|
80
84
|
const argv = process.argv.slice(2);
|
|
85
|
+
// `poll` owns its own --help/--version handling and its stdout contract (one line per
|
|
86
|
+
// reply, nothing else), so it is dispatched before the generic flags below.
|
|
87
|
+
if (argv[0] === "poll") {
|
|
88
|
+
const { pollMain } = await import("./poll.js");
|
|
89
|
+
const code = await pollMain(argv.slice(1));
|
|
90
|
+
// Let a pending stdout write drain before exiting so the last reply line is never lost.
|
|
91
|
+
process.stdout.write("", () => process.exit(code));
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
81
94
|
if (argv.includes("--version") || argv.includes("-v")) {
|
|
82
95
|
console.log(readVersion());
|
|
83
96
|
process.exit(0);
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,wEAAiF;AACjF,qDAA8C;AAC9C,2CAAkD;AAElD,SAAS,WAAW;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC;IAClF,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;AAClC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;gEAkBkD,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,sFAAsF;IACtF,4EAA4E;IAC5E,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,wFAAwF;QACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,gBAAgB,EAAE,CAAC;QACxD,wEAAwE;QACxE,yEAAyE;QACzE,eAAe;QACf,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wBAAwB,CAAC;IAEvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,yDAAyD;YACvD,IAAI;YACJ,0BAA0B;YAC1B,6FAA6F;YAC7F,uGAAuG;YACvG,kFAAkF,CACrF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,2BAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,gEAAgE;IAChE,OAAO,CAAC,KAAK,CAAC,oBAAoB,WAAW,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,gBAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;AACvG,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|