@astramindapp/mcp-server 0.24.0 → 0.25.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.
Files changed (21) hide show
  1. package/README.md +28 -9
  2. package/dist/cli.d.ts +2 -2
  3. package/dist/cli.js +4 -4
  4. package/dist/cli.js.map +1 -1
  5. package/dist/index.d.ts +1 -1
  6. package/dist/index.js +1 -1
  7. package/dist/integration-guide.d.ts +2 -2
  8. package/dist/integration-guide.d.ts.map +1 -1
  9. package/dist/integration-guide.js +22 -6
  10. package/dist/integration-guide.js.map +1 -1
  11. package/dist/mind-client.d.ts +13 -0
  12. package/dist/mind-client.d.ts.map +1 -1
  13. package/dist/mind-client.js +37 -0
  14. package/dist/mind-client.js.map +1 -1
  15. package/dist/server.d.ts +21 -27
  16. package/dist/server.d.ts.map +1 -1
  17. package/dist/server.js +1343 -178
  18. package/dist/server.js.map +1 -1
  19. package/dist/setup.js +1 -1
  20. package/dist/setup.js.map +1 -1
  21. package/package.json +4 -3
package/README.md CHANGED
@@ -1,40 +1,59 @@
1
1
  # @astramindapp/mcp-server
2
2
 
3
- **MIND MCP Server** — The most complete AI memory layer available. 25 tools, 172 actions.
3
+ **MIND MCP Server** — The most complete AI memory layer available. 44 tools, 384 actions.
4
4
 
5
5
  Your AI agents forget everything between sessions. MIND fixes that. Connect any MCP-compatible agent to your personal knowledge graph — with emotional intelligence, CRM, life management, site-wide assignable tasks, social features, self-training, autonomous insights, an admin-only Agent Command Center with per-agent ticket queues, an admin-only **Featured Minds Portal** (curate the public marketplace at `m-i-n-d.ai` from any MCP client — model, public chat prompt, temperature, brand fields, write-through to the linked user's profile), and more.
6
6
 
7
7
  **Self-describing.** Every connecting client receives a full integration briefing in the MCP `initialize` response, and can read the complete playbook from the `mind://integration-guide` resource — so any agent knows what MIND is, which integration path fits its runtime (MCP server / OpenClaw plugin / REST API), how to authenticate, and the session protocol, without being told.
8
8
 
9
- ## 25 Tools
9
+ ## 44 Tools
10
10
 
11
11
  | Tool | Actions | What It Does |
12
12
  |------|---------|-------------|
13
13
  | `mind_query` | 1 | Semantic search across your knowledge graph (5 search modes) |
14
14
  | `mind_remember` | 5 | Store, search, get, list, delete — `document` & `entry` (PRIVATE), `feed_post` (PUBLIC, explicit user request only — `thought` kept as deprecated alias) |
15
- | `mind_folders` | 6 | Organize documents into folders — list, create, rename, move, delete, file documents |
15
+ | `mind_folders` | 7 | Organize documents into folders — list, create, rename, move, delete, file documents |
16
+ | `mind_folder_routes` | 4 | Configure deterministic system-folder routing — which folder each kind of system-generated doc (life items, CRM, chat saves, tasks, training, trader signals, cloud imports) is filed into automatically |
17
+ | `mind_folder_suggest` | 1 | Ask MIND which folder a piece of content belongs in, via its routing_hint + a cheap LLM picker |
18
+ | `mind_share` | 4 | Create and manage share links for one MIND document — create (default), list, list_all, revoke |
16
19
  | `mind_context` | 1 | Load persistent identity, preferences, rules, priorities, recent activity |
17
- | `mind_life` | 13 | Goals, projects, tasks + full calendar management + productivity stats |
20
+ | `mind_life` | 16 | Goals, projects, tasks + full calendar management + productivity stats |
21
+ | `mind_focuses` | 5 | Focus → Project buckets — the top-level groupings above Life Projects |
18
22
  | `mind_crm` | 7 | Contacts, pipeline, activity logging, interaction history |
19
23
  | `mind_tasks` | 9 | Site-wide tasks — assignable, completable work items on projects, contacts, or agents, plus completion reports |
20
24
  | `mind_graph` | 3 | Graph stats, diagnostics, entity labels |
21
25
  | `mind_admin` | 11 | **Admin-only.** User provisioning + the **Featured Minds Portal**: full CRUD over the public marketplace (get_full / update / update_owner_profile / reorder / delete), tier/credit management |
22
26
  | `mind_sense` | 7 | MINDsense emotional intelligence — state, signals, timeline, KG weights, spikes |
27
+ | `mind_osint` | 7 | Operate Ozzie — the autonomous OSINT analyst — for cited intelligence dossiers on a domain/IP/org/person, plus live-feed alerts and watchlists |
23
28
  | `mind_research` | 3 | Launch autonomous deep research jobs |
24
29
  | `mind_train` | 7 | Self-training sessions + save chats to knowledge graph |
25
30
  | `mind_social` | 14 | Public feed posts, social feed, communities, likes, comments — ⚠️ posting writes to the user's PUBLIC feed, only call on explicit user request |
31
+ | `mind_social_analytics` | 6 | YouTube/LinkedIn/X/Twitch channel stats, recent video performance, retention/traffic/sentiment, goal progress |
26
32
  | `mind_profile` | 9 | Profile, custom system prompts, LLM model selection |
27
33
  | `mind_trader` | 25 | TraderMIND — the agentic trading engine: live feed, MIND Vision forecasts (latest cone + resolved history + per-bar scores), candles, cycles, calibration honesty curve, engine health, save/star/like + undo, notes + structured feedback the engine learns from, full trading-journal CRUD, personalized insights. Engine reads + counts are public (work even with no/invalid key); only the act-as-you actions authenticate as the key's owner |
28
34
  | `mind_insights` | 7 | Autonomous Learning Engine insights, weekly summaries, feedback |
29
35
  | `mind_automate` | 6 | Scheduled automations, event triggers, execution history |
30
36
  | `mind_notify` | 4 | Notifications, mark read, stats |
31
- | `mind_agents` | 21 | **Admin-only.** Agent Command Center — list/search/get/create/update/delete agents, heartbeats, probes, activity log, import from MIND, seed canonical fleet, link invoices, transfer ownership + share agents with other accounts |
37
+ | `mind_agents` | 25 | **Admin-only.** Agent Command Center — list/search/get/create/update/delete agents, heartbeats, probes, activity log, import from MIND, seed canonical fleet, link invoices, transfer ownership + share agents with other accounts |
32
38
  | `mind_tickets` | 7 | **Admin-only.** Agent ticket queue — file, view, answer (comment), triage, resolve, and delete client feedback / bugs / ideas on any agent |
39
+ | `mind_personas` | 17 | **Admin-only.** Influencer Factory Command Center — synthetic-persona CRUD, face anchor + variants, ElevenLabs voice, per-platform bios, Blotato account registration |
33
40
  | `mind_accounts` | 6 | Multi-MIND accounts — list MINDs you can access, create new ones, delete MINDs you own, manage owners/viewers, send email invitations |
34
41
  | `mind_list_templates` | 1 | List the 16 Front Layer typed-document templates |
35
42
  | `mind_get_template` | 1 | Fetch the full spec for one Front Layer template |
36
43
  | `mind_save_typed` | 1 | Save a filled-out Front Layer document with its type tag |
37
44
  | `mind_bootstrap_templates` | 1 | Seed all 16 Front Layer templates into a MIND tenant |
45
+ | `mind_mindmap` | 6 | MIND Mind Map (m-i-n-d.ai/#/mind-map) — visual canvases: list/get/create/update/delete, read a public shared map. Sharing, collaborators and AI generation from a prompt/project stay in the web app (JWT-only, human-only) |
46
+ | `mind_moneymind` | 37 | MoneyMIND (m-i-n-d.ai/#/moneyMIND) — accounts, transactions + splits + rules, budgets, recurring bills, net worth, savings goals, credit, alerts, bill negotiation, bank statements |
47
+ | `mind_budget` | 19 | 13-week cash-flow planner (m-i-n-d.ai/#/budget) — cells, rows, quarters, variance, roll-forward, autofill/build from bank statements |
48
+ | `mind_sheets` | 14 | Airtable-style tables (m-i-n-d.ai/#/sheets) — tables, columns, rows, CSV export |
49
+ | `mind_email` | 14 | MIND Email Manager (m-i-n-d.ai/#/email) — inbox, threads, search, AI draft, ⚠️ send (outward), voice/tone preferences |
50
+ | `mind_checklists` | 13 | Kanon checklists (kanon.theastraway.com) attached to Life items or tasks — templates, runs, toggle_item, progress rollups |
51
+ | `mind_sign` | 12 | MIND Sign e-signature (m-i-n-d.ai/#/mindsign) — envelopes, fields, ⚠️ send/resend (outward), void, audit, certificate |
52
+ | `mind_invoices` | 9 | Invoice Agent (m-i-n-d.ai/#/invoiceagent) — create/update, ask a question about an invoice, ⚠️ invite (outward), received invoices |
53
+ | `mind_books` | 9 | MIND Books accounting (m-i-n-d.ai/#/mind-books) — vendors, customers, chart of accounts, bills, invoices overview |
54
+ | `mind_timer` | 8 | Tempo time tracking — start/stop, manual entries, summaries |
55
+ | `mind_forms` | 7 | Quill lead-capture forms (m-i-n-d.ai/#/forms) — build, read submissions, public read by slug |
56
+ | `mind_library` | 8 | Personal bookshelf (m-i-n-d.ai/#/library) — authors, books, chapter content, AI reading companion |
38
57
 
39
58
  ## Quick Start
40
59
 
@@ -80,7 +99,7 @@ configures each one.
80
99
  ### Manual alternative: paste an API key
81
100
 
82
101
  If you'd rather mint a key yourself: sign up at
83
- [m-i-n-d.ai](https://m-i-n-d.ai) → Settings → Developer → Create API Key, then:
102
+ [www.m-i-n-d.ai](https://www.m-i-n-d.ai) → Settings → Developer → Create API Key, then:
84
103
 
85
104
  ```bash
86
105
  npx -y --package=@astramindapp/mcp-server mind-mcp-setup --key mind_xxx
@@ -522,7 +541,7 @@ Returns a JWT + permanent API key. Your app stores the API key and uses it for a
522
541
  | Variable | Required | Default | Description |
523
542
  |----------|----------|---------|-------------|
524
543
  | `MIND_API_KEY` | Yes | — | Your MIND Developer API key |
525
- | `MIND_BASE_URL` | No | `https://m-i-n-d.ai` | MIND API base URL |
544
+ | `MIND_BASE_URL` | No | `https://www.m-i-n-d.ai` | MIND API base URL |
526
545
 
527
546
  ## Programmatic Usage
528
547
 
@@ -530,7 +549,7 @@ Returns a JWT + permanent API key. Your app stores the API key and uses it for a
530
549
  import { createMindMcpServer, MindClient } from "@astramindapp/mcp-server";
531
550
 
532
551
  const client = new MindClient({
533
- baseUrl: "https://m-i-n-d.ai",
552
+ baseUrl: "https://www.m-i-n-d.ai",
534
553
  apiKey: "mind_xxx",
535
554
  });
536
555
 
@@ -564,7 +583,7 @@ subject of pending patent applications. Patents pending.
564
583
 
565
584
  ## Links
566
585
 
567
- - **Website**: [m-i-n-d.ai](https://m-i-n-d.ai)
586
+ - **Website**: [www.m-i-n-d.ai](https://www.m-i-n-d.ai)
568
587
  - **GitHub**: [theastraway/mind-mcp-server](https://github.com/theastraway/mind-mcp-server)
569
588
  - **npm**: [@astramindapp/mcp-server](https://www.npmjs.com/package/@astramindapp/mcp-server)
570
589
  - **MCP Docs**: [m-i-n-d.ai/mcp.html](https://www.m-i-n-d.ai/mcp.html)
package/dist/cli.d.ts CHANGED
@@ -4,14 +4,14 @@
4
4
  *
5
5
  * Usage:
6
6
  * MIND_API_KEY=mind_xxx mind-mcp
7
- * MIND_API_KEY=mind_xxx MIND_BASE_URL=https://m-i-n-d.ai mind-mcp
7
+ * MIND_API_KEY=mind_xxx MIND_BASE_URL=https://www.m-i-n-d.ai mind-mcp
8
8
  * mind-mcp --version
9
9
  * mind-mcp --help
10
10
  * mind-mcp setup [...] (delegates to the setup wizard — see setup.ts)
11
11
  *
12
12
  * Environment variables:
13
13
  * MIND_API_KEY — Required. Your MIND Developer API key.
14
- * MIND_BASE_URL — Optional. Defaults to https://m-i-n-d.ai
14
+ * MIND_BASE_URL — Optional. Defaults to https://www.m-i-n-d.ai
15
15
  */
16
16
  export {};
17
17
  //# sourceMappingURL=cli.d.ts.map
package/dist/cli.js CHANGED
@@ -5,14 +5,14 @@
5
5
  *
6
6
  * Usage:
7
7
  * MIND_API_KEY=mind_xxx mind-mcp
8
- * MIND_API_KEY=mind_xxx MIND_BASE_URL=https://m-i-n-d.ai mind-mcp
8
+ * MIND_API_KEY=mind_xxx MIND_BASE_URL=https://www.m-i-n-d.ai mind-mcp
9
9
  * mind-mcp --version
10
10
  * mind-mcp --help
11
11
  * mind-mcp setup [...] (delegates to the setup wizard — see setup.ts)
12
12
  *
13
13
  * Environment variables:
14
14
  * MIND_API_KEY — Required. Your MIND Developer API key.
15
- * MIND_BASE_URL — Optional. Defaults to https://m-i-n-d.ai
15
+ * MIND_BASE_URL — Optional. Defaults to https://www.m-i-n-d.ai
16
16
  */
17
17
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
18
18
  if (k2 === undefined) k2 = k;
@@ -69,7 +69,7 @@ Usage:
69
69
 
70
70
  Environment variables:
71
71
  MIND_API_KEY Required to start the server. Your MIND Developer API key.
72
- MIND_BASE_URL Optional. Defaults to https://m-i-n-d.ai
72
+ MIND_BASE_URL Optional. Defaults to https://www.m-i-n-d.ai
73
73
 
74
74
  No install, no key handling — connect remotely instead:
75
75
  claude mcp add --transport http mind https://www.m-i-n-d.ai/mcp
@@ -97,7 +97,7 @@ async function main() {
97
97
  return;
98
98
  }
99
99
  const API_KEY = process.env.MIND_API_KEY;
100
- const BASE_URL = process.env.MIND_BASE_URL ?? "https://m-i-n-d.ai";
100
+ const BASE_URL = process.env.MIND_BASE_URL ?? "https://www.m-i-n-d.ai";
101
101
  if (!API_KEY) {
102
102
  console.error("Error: MIND_API_KEY environment variable is required.\n" +
103
103
  "\n" +
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;gEAekD,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,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,oBAAoB,CAAC;IAEnE,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"}
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;gEAekD,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,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"}
package/dist/index.d.ts CHANGED
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * Programmatic usage:
8
8
  * import { createMindMcpServer, MindClient } from "@mindapp/mcp-server";
9
- * const client = new MindClient({ baseUrl: "https://m-i-n-d.ai", apiKey: "mind_xxx" });
9
+ * const client = new MindClient({ baseUrl: "https://www.m-i-n-d.ai", apiKey: "mind_xxx" });
10
10
  * const server = createMindMcpServer(client);
11
11
  */
12
12
  export { createMindMcpServer } from "./server.js";
package/dist/index.js CHANGED
@@ -7,7 +7,7 @@
7
7
  *
8
8
  * Programmatic usage:
9
9
  * import { createMindMcpServer, MindClient } from "@mindapp/mcp-server";
10
- * const client = new MindClient({ baseUrl: "https://m-i-n-d.ai", apiKey: "mind_xxx" });
10
+ * const client = new MindClient({ baseUrl: "https://www.m-i-n-d.ai", apiKey: "mind_xxx" });
11
11
  * const server = createMindMcpServer(client);
12
12
  */
13
13
  Object.defineProperty(exports, "__esModule", { value: true });
package/dist/integration-guide.d.ts CHANGED
@@ -9,6 +9,6 @@
9
9
  * `INTEGRATION_GUIDE` is the full playbook, exposed as the readable MCP
10
10
  * resource `mind://integration-guide` for agents that want the deep dive.
11
11
  */
12
- export declare const SERVER_INSTRUCTIONS = "MIND is the persistent memory and knowledge-graph layer for AI agents \u2014 identity, memories, decisions, tasks, contacts, and emotional context that survive across every session, every tool, and every agent.\n\n\u2550\u2550\u2550 HOW TO INTEGRATE \u2014 pick the path for your runtime \u2550\u2550\u2550\n\u2022 You are an MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP host): you are already connected. Call the mind_* tools directly \u2014 nothing else to install.\n\u2022 You are an OpenClaw agent: do NOT use this MCP server. Install the OpenClaw plugin instead \u2014 `openclaw plugins install @astramindapp/openclaw-mind` \u2014 which exposes the same MIND surface as native OpenClaw tools.\n\u2022 You are any other runtime (custom agent, script, n8n, backend): call the REST API directly at https://m-i-n-d.ai/developer/v1 with header `X-API-Key: <key>`. Every mind_* tool maps 1:1 to a /developer/v1 endpoint.\n\nAUTH: every path needs a MIND API key (prefix `mind_`). Get one at https://m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys. For this MCP server, set env var MIND_API_KEY (and optionally MIND_BASE_URL). The admin tools (mind_admin, mind_agents, mind_tickets) require an admin-scoped key.\n\n\u2550\u2550\u2550 SESSION PROTOCOL \u2014 do this every session \u2550\u2550\u2550\n1. START: call mind_context \u2014 loads identity, operating rules, priorities, recent activity. Never skip it.\n2. BEFORE deciding or asserting: call mind_query on the topic. MIND is authoritative memory \u2014 do not guess or claim something does not exist without querying.\n3. AFTER completing non-trivial work: call mind_remember to log the outcome. Unlogged work is invisible to the next session. Use `type: \"entry\"` (PRIVATE \u2014 default) for all agent outcomes, logs, decisions, and research.\n\n\u26A0\uFE0F PRIVATE vs PUBLIC: `document` and `entry` (via mind_remember) are PRIVATE to the user's knowledge graph. `feed_post` (mind_remember) and mind_social create_thought are PUBLIC \u2014 they post to the user's social feed where everyone can see them. NEVER write to the public feed unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\". Deploy logs, PR notes, work outcomes, and agent activity belong in `entry` \u2014 NEVER on the public feed.\n\n\u2550\u2550\u2550 TOOL MAP \u2014 25 tools \u2550\u2550\u2550\nMEMORY mind_query (semantic search) \u00B7 mind_remember (store / list / delete) \u00B7 mind_context (load identity + rules)\nLIFE & WORK mind_life (goals, tasks, calendar \u2014 supports delete + bulk_delete) \u00B7 mind_tasks (assignable, reportable work items) \u00B7 mind_automate (triggers + workflows) \u00B7 mind_notify (notifications)\nPEOPLE mind_crm (contacts, pipeline stages, activity logging)\nGRAPH mind_graph (KG stats + health) \u00B7 mind_insights (Autonomous Learning Engine patterns) \u00B7 mind_sense (MINDsense emotional state)\nKNOWLEDGE mind_research (autonomous deep-research jobs) \u00B7 mind_train (teach the KG / save chats)\nFRONT LAYER mind_list_templates \u00B7 mind_get_template \u00B7 mind_save_typed \u00B7 mind_bootstrap_templates (16 structured document types: SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, \u2026)\nSOCIAL mind_social (public feed posts, social feed, communities \u2014 \u26A0\uFE0F posting writes to the user's PUBLIC feed) \u00B7 mind_profile (bio, prompts, model preferences)\nTRADER mind_trader (TraderMIND: live feed \u00B7 MIND Vision forecasts + history + per-bar scores \u00B7 candles \u00B7 cycles \u00B7 calibration \u00B7 engine health \u00B7 save/star/like + undo \u00B7 notes + feedback the engine learns from \u00B7 full journal CRUD \u00B7 personalized insights)\nFLEET/ADMIN mind_agents (Agent Command Center \u2014 agent registry, heartbeat, probe; admin key) \u00B7 mind_tickets (agent ticket queue \u2014 file / answer / triage / resolve; admin key) \u00B7 mind_admin (user provisioning; admin key) \u00B7 mind_accounts (own / switch / share multiple MINDs)\n\nEvery tool's own description lists its exact actions and required parameters. For the full playbook \u2014 endpoint mapping, scopes, and common recipes \u2014 read the resource `mind://integration-guide`.";
13
- export declare const INTEGRATION_GUIDE = "# MIND \u2014 Complete Integration Guide\n\nMIND is the persistent memory and knowledge-graph layer for AI agents. It stores\nidentity, memories, decisions, goals, tasks, contacts, and emotional context, and\nmakes them queryable across every session, tool, and agent \u2014 so an AI never starts\nfrom zero.\n\nThis guide tells any agent exactly how to integrate, regardless of how it runs.\n\n---\n\n## 1. Choose your integration path\n\nMIND meets your agent wherever it runs. There are three paths \u2014 pick the one that\nmatches your runtime. They all read and write the *same* knowledge graph.\n\n| Your runtime | Path | How to connect |\n|---|---|---|\n| MCP host \u2014 Claude Code, Claude Desktop, Cursor, Windsurf, Zed, any MCP client | **MCP server** | Remote, no install: add `https://www.m-i-n-d.ai/mcp` as a custom connector and sign in via browser OAuth \u2014 or, if your host has no OAuth flow but lets you add a header, use the same URL with `Authorization: Bearer mind_<key>` and no OAuth at all. Prefer local stdio? `npx -y --package=@astramindapp/mcp-server mind-mcp-setup`, or add the server to your MCP config. You are reading this because you are already connected \u2014 just call the `mind_*` tools. |\n| OpenClaw agent | **OpenClaw plugin** | `openclaw plugins install @astramindapp/openclaw-mind`. Do NOT install the MCP server for OpenClaw \u2014 OpenClaw consumes a plugin, not an MCP server, for its memory slot. The plugin exposes MIND as native OpenClaw tools. |\n| Anything else \u2014 custom agent, backend service, script, n8n, automation | **REST API** | Call `https://m-i-n-d.ai/developer/v1/*` directly with header `X-API-Key: <key>`. Every MCP tool is a thin wrapper over one of these endpoints. |\n\nAll three paths are equivalent in capability. The MCP server and OpenClaw plugin\nare convenience layers over the same `/developer/v1` REST API.\n\n**No browser OAuth in your host? Use a key on the same URL.** Every host that\nlets you add a custom MCP server with a header can use MIND with no OAuth and\nno npm install: Server URL `https://www.m-i-n-d.ai/mcp`, header\n`Authorization: Bearer mind_<your key>`. Mint a key at\nhttps://www.m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys. Agents: if\n`AuthenticateMcpServer` or the host's connect card fails, ask the user for a\nMIND API key and rewire the same URL with that header \u2014 do not fall back to\nthe local npm server just because OAuth didn't work.\n\n## 2. Authenticate\n\nEvery path needs a **MIND API key** \u2014 a string with the prefix `mind_`.\n\n- Get a key: https://m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys.\n- MCP server: set env var `MIND_API_KEY`. Optionally `MIND_BASE_URL` (defaults to the production host).\n- REST: send it as the `X-API-Key` request header.\n- Keys carry **scopes** (e.g. `life:read`, `life:write`, `crm:write`). A new key gets the full standard set. The admin tools `mind_admin`, `mind_agents`, and `mind_tickets` require an **admin-scoped** key.\n\n## 3. Session protocol\n\nFollow this every session \u2014 it is the difference between an agent with memory and\nan agent that re-discovers the world each time.\n\n1. **Start** \u2014 call `mind_context`. Loads identity, operating rules, current priorities, and recent activity.\n2. **Before deciding or asserting** \u2014 call `mind_query` on the specific topic. MIND is the authoritative memory; never claim something does not exist without querying first.\n3. **After completing non-trivial work** \u2014 call `mind_remember` to log the outcome (what worked, what didn't, decisions made). Tag it. Set `source` to your agent name.\n\n## 4. The 25 tools\n\n### Memory\n- **mind_query** \u2014 semantic search across the knowledge graph. Returns RETRIEVED CONTEXT (documents, entries, entities, relationships) for YOU to synthesize \u2014 not a finished answer \u2014 and costs 0 credits. Pass `retrieve_only=false` to have MIND write the answer itself (spends credits). 5 search modes.\n- **mind_remember** \u2014 store/manage content. Actions: create, search, get, list, delete. Types: **PRIVATE**: `document` (long-form research/specs), `entry` (medium-form observations/agent logs \u2014 DEFAULT). **PUBLIC**: `feed_post` (a social-media post on the user's public feed \u2014 NEVER use unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\"; deploy logs and agent outcomes belong in `entry`). `thought` is a deprecated alias for `feed_post`.\n- **mind_folders** \u2014 organize documents into folders. Actions: list, create, rename, move, delete, move_documents. Folders are a presentation layer \u2014 the graph still indexes every document regardless of folder. Typical flow: `mind_remember` create a document, then `mind_folders` move_documents to file it.\n- **mind_context** \u2014 load persistent identity, preferences, rules, priorities, recent activity as retrieved context (0 credits; YOU synthesize).\n\n### Life & work\n- **mind_life** \u2014 goals, projects, tasks, calendar events, productivity stats. Actions: list, create, update, complete, delete, **bulk_delete** (up to 200 ids in one call), move, get, calendar_*, stats.\n- **mind_tasks** \u2014 site-wide assignable work items that attach to projects, contacts, or agents. Actions: list, create, get, update, complete, reopen, assign, delete, reports.\n- **mind_automate** \u2014 scheduled workflows, event triggers, rules.\n- **mind_notify** \u2014 read and manage notifications.\n\n### People\n- **mind_crm** \u2014 contacts, pipeline stages, activity logging, interaction history.\n\n### Knowledge graph & intelligence\n- **mind_graph** \u2014 KG statistics, diagnostics, label/entity breakdown, health.\n- **mind_insights** \u2014 patterns surfaced by the Autonomous Learning Engine, weekly summaries.\n- **mind_sense** \u2014 MINDsense emotional intelligence: the user's living emotional state, signal history, KG entity weights.\n- **mind_research** \u2014 launch and manage autonomous deep-research jobs; findings land in the graph.\n- **mind_train** \u2014 guided training sessions and chat-to-KG ingestion.\n\n### Front Layer templates (structured documents)\n- **mind_list_templates** / **mind_get_template** / **mind_save_typed** / **mind_bootstrap_templates** \u2014 the 16 typed-document templates (SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, and more) that give a MIND tenant a well-structured front layer.\n\n### Social & profile\n- **mind_social** \u2014 PUBLIC feed posts, social feed, communities. \u26A0\uFE0F `create_thought` writes to the user's PUBLIC social feed \u2014 NEVER call unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\". For private agent outcomes, use `mind_remember` with `type=entry` instead.\n- **mind_profile** \u2014 bio, AI prompt settings, model preferences.\n\n### Trading (TraderMIND)\n- **mind_trader** \u2014 operate TraderMIND, the agentic trading engine. Read the engine: `feed` (live trade-idea feed) \u00B7 `forecast_latest` / `forecasts` / `bar_scores` (MIND Vision forecasts \u2014 latest cone, resolved history, per-candle scores) \u00B7 `candles` \u00B7 `cycles` (regime / ideas / lessons) \u00B7 `health` \u00B7 `calibration` (the published honesty curve) \u00B7 `ai_journal` (the trader's own narration). Act as the user: `save` / `star` / `like` / `unsave` \u00B7 `note` / `feedback` (feedback reaches the engine's brain) \u00B7 `notes` / `interactions` / `counts` (read back state + public social proof) \u00B7 full journal CRUD (`journal_list/create/get/update/delete`) \u00B7 `insights` (personalized, cached 15 min). Auth: engine reads plus `counts` are public \u2014 they work even with a missing or invalid key; only the act-as-you actions (save/star/like/unsave, note/feedback, notes, interactions, saved, journal_*, insights) authenticate as the key's owner. Saves, notes, feedback, and journal entries also land in the owner's MIND knowledge graph.\n\n### Fleet & administration (admin key required)\n- **mind_agents** \u2014 the **Agent Command Center**: the canonical registry of every agent in the fleet (running, planned, archived). Each agent is owned by a MIND account (`owner_username`). Actions: list (with `list_query` free-text search), get, create, update, delete, heartbeat, probe, log_activity, list_activities, import_from_mind, seed_known, set_status, set_current_job, transfer_owner, share, list_shares, revoke_share, plus invoice linking. Backed by `/admin/agents`.\n- **mind_tickets** \u2014 the **agent ticket queue**: client feedback, critique, ideas, feature requests, and bugs filed against any agent. Actions: list, get, create, comment (answer a ticket), update (triage status/priority/kind/assignee), resolve, delete. `agent_slug` is required on every call. Backed by `/admin/agents/{slug}/tickets`.\n- **mind_admin** \u2014 user provisioning + the **Featured Minds Portal**: full CRUD over featured minds with admin write-through to the linked `user_profiles` doc. Actions: `create_user`, `list_users`, `update_user_tier`, `adjust_user_credits`, `create_featured_mind`, `list_featured_minds`, `get_featured_mind_full` (bundled mind + owner profile + model catalog \u2014 what the portal side sheet loads), `update_featured_mind` (catalog fields: title / subtitle / description / tags / featured / display_order / is_public / avatar_url / banner_url / price), `update_featured_mind_owner_profile` (write-through to user_profiles: `preferred_llm_model`, `public_mind_prompt`, `chat_temperature`, `chat_reasoning_effort`, `public_mind_enabled`, `public_mind_tagline` / `greeting` / `persona`, `bio`, `avatar_url`, `banner_url` \u2014 changes hit /m/{username} immediately), `reorder_featured_minds` (bulk display_order via `ordered_mind_ids`), `delete_featured_mind`.\n- **mind_accounts** \u2014 multi-MIND ownership: discover, create, and switch between MINDs; manage owners, viewers, and invitations.\n\nEach tool's own MCP description is the source of truth for its exact action list\nand required parameters \u2014 read it before calling.\n\n## 5. REST endpoint mapping\n\nIf you integrate over REST, every tool maps to `/developer/v1`. Examples:\n\n| Capability | Method + path |\n|---|---|\n| Query the graph | `POST /developer/v1/query` |\n| List / create life items | `GET` / `POST /developer/v1/life/items` |\n| Delete one life item | `DELETE /developer/v1/life/items/{id}` |\n| Delete many life items | `POST /developer/v1/life/items/bulk-delete` (body: `{\"item_ids\": [...]}`) |\n| CRM contacts | `GET` / `POST /developer/v1/crm/contacts` |\n| Documents (PRIVATE) | `/developer/v1/documents` |\n| Entries (PRIVATE) | `/developer/v1/entries` |\n| Feed posts (PUBLIC) \u2014 personal CRUD | `/developer/v1/thoughts` \u2014 scope `thoughts:read` / `thoughts:write`. `/feed_posts` is a semantic alias mounted on the same handlers + collection (UI JWT path). |\n| Feed posts (PUBLIC) \u2014 social layer | `/developer/v1/social/thoughts` (create / get / delete / like) + `/developer/v1/social/feed` (browse) \u2014 scope `social:write` / `social:read` |\n| Folders | `GET` / `POST /developer/v1/folders`, `PATCH` / `DELETE /developer/v1/folders/{id}` |\n| Move documents into a folder | `POST /developer/v1/documents/move` (body: `{\"doc_ids\": [...], \"folder_id\": \"...\"}`) |\n| TraderMIND \u2014 latest MIND Vision forecast | `GET /api/trader/forecasts/latest?symbol=ES` (engine reads \u2014 `/api/trader/forecasts`, `/candles`, `/cycles`, `/calibration`, `/health`, `/ai-journal`, plus `GET /api/mindtrades/feed` and `GET /api/trader/counts` \u2014 are public; the act-as-you routes `/interact`, `/note`, `/notes`, `/interactions`, `/saved`, `/journal`, `/insights` need the user's key) |\n| Agent Command Center | `/admin/agents` (admin key) |\n| Agent ticket queue | `/admin/agents/{slug}/tickets` \u2014 `GET`/`POST`, `/{ticket_id}` `GET`/`PATCH`/`DELETE`, `/{ticket_id}/comments` `POST` (admin key) |\n| **Featured Minds Portal** | `/admin/featured-minds` `GET`/`POST`, `/admin/featured-minds/{id}` `PUT`/`DELETE`, `/admin/featured-minds/{id}/full` `GET` (bundled view), `/admin/featured-minds/{id}/owner-profile` `PUT` (admin write-through to user_profiles: model, prompt, temperature, brand fields), `/admin/featured-minds/reorder` `PUT` (body: `{\"ordered_mind_ids\": [...]}`), `/admin/featured-minds/{id}/upload` `POST` (multipart: `kind=avatar|banner`, `file`) \u2014 all admin key |\n\n## 6. Common recipes\n\n- **Clear the life board** \u2014 `mind_life` action `bulk_delete` with every item id (list first, then pass the ids), or repeated for boards over 200 items.\n- **Start a session right** \u2014 `mind_context`, then `mind_query` for anything you are about to act on.\n- **Record an outcome** \u2014 `mind_remember` action `create`, type `entry`, with tags and your `source`.\n- **File a document in a folder** \u2014 `mind_folders` action `create` to make the folder, `mind_remember` to create the document, then `mind_folders` action `move_documents` with the document id and the folder id. `folder_id: \"root\"` files at the top level.\n- **Register / update an agent** \u2014 `mind_agents` (admin key) \u2014 `create` or `update`, then `heartbeat` from the agent runtime.\n- **Handle agent tickets** \u2014 `mind_tickets` (admin key) \u2014 `list` an agent's queue, `get` a ticket with its thread, `comment` to answer, then `resolve`. `agent_slug` is required on every call.\n- **Run the Featured Minds Portal from MCP** \u2014 `mind_admin` (admin key) \u2014 `list_featured_minds` to get every mind_id, `get_featured_mind_full` for a bundled view (featured_mind doc + owner profile + model catalog in one round-trip), `update_featured_mind` for catalog fields (title/tags/featured/display_order/is_public/avatar/banner/subtitle/price), `update_featured_mind_owner_profile` for chat-behavior fields (preferred_llm_model, public_mind_prompt, chat_temperature, chat_reasoning_effort, public_mind_tagline/greeting/persona, bio) \u2014 this write-through hits /m/{username} immediately, `reorder_featured_minds` for bulk display_order, `delete_featured_mind` to remove from the catalog (user's MIND is preserved).\n\n## 7. Feed post endpoint surfaces (clarification)\n\nA \"feed post\" is a public social-media-style post on the user's MIND feed. There are three endpoint surfaces, all backed by the **same** `thoughts` MongoDB collection \u2014 pick by what your key carries:\n\n| Surface | Use when | Scope required |\n|---|---|---|\n| `/developer/v1/thoughts` (POST / GET / DELETE / search) | Personal feed post CRUD via a developer API key | `thoughts:read` / `thoughts:write` |\n| `/developer/v1/social/thoughts` (POST / GET / DELETE / like) + `/developer/v1/social/feed` (browse) | Same create/delete + the social-feed read surface for browsing other users' posts, likes, repost flow | `social:write` (writes) / `social:read` (browse) |\n| `/feed_posts` (POST / GET / DELETE + comments/likes/reposts) | Semantic alias for `/thoughts` \u2014 same UI JWT handlers under a clearer URL. Both paths share handlers and the MongoDB collection. | UI JWT |\n\nThere is no functional difference for create/delete between `/thoughts` and `/social/thoughts` \u2014 both insert into `db.thoughts`. Pick the surface that matches your auth path and the scope your key carries. **Whichever surface you write through, the post lands on the user's PUBLIC feed.** Follow the explicit-trigger rule in every tool description.\n\n## 8. Brand & rules\n\nThe product is **MIND** by **Astra AI**. Never reference underlying libraries in\nuser-facing content \u2014 MIND is the brand. Treat MIND as the authoritative memory:\nwhen the graph and local files disagree, reconcile explicitly rather than guessing.\n";
12
+ export declare const SERVER_INSTRUCTIONS = "MIND is the persistent memory and knowledge-graph layer for AI agents \u2014 identity, memories, decisions, tasks, contacts, and emotional context that survive across every session, every tool, and every agent.\n\n\u2550\u2550\u2550 HOW TO INTEGRATE \u2014 pick the path for your runtime \u2550\u2550\u2550\n\u2022 You are an MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP host): you are already connected. Call the mind_* tools directly \u2014 nothing else to install.\n\u2022 You are an OpenClaw agent: do NOT use this MCP server. Install the OpenClaw plugin instead \u2014 `openclaw plugins install @astramindapp/openclaw-mind` \u2014 which exposes the same MIND surface as native OpenClaw tools.\n\u2022 You are any other runtime (custom agent, script, n8n, backend): call the REST API directly at https://m-i-n-d.ai/developer/v1 with header `X-API-Key: <key>`. Every mind_* tool maps 1:1 to a /developer/v1 endpoint.\n\nAUTH: every path needs a MIND API key (prefix `mind_`). Get one at https://m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys. For this MCP server, set env var MIND_API_KEY (and optionally MIND_BASE_URL). The admin tools (mind_admin, mind_agents, mind_tickets) require an admin-scoped key.\n\n\u2550\u2550\u2550 SESSION PROTOCOL \u2014 do this every session \u2550\u2550\u2550\n1. START: call mind_context \u2014 loads identity, operating rules, priorities, recent activity. Never skip it.\n2. BEFORE deciding or asserting: call mind_query on the topic. MIND is authoritative memory \u2014 do not guess or claim something does not exist without querying.\n3. AFTER completing non-trivial work: call mind_remember to log the outcome. Unlogged work is invisible to the next session. Use `type: \"entry\"` (PRIVATE \u2014 default) for all agent outcomes, logs, decisions, and research.\n\n\u26A0\uFE0F PRIVATE vs PUBLIC: `document` and `entry` (via mind_remember) are PRIVATE to the user's knowledge graph. `feed_post` (mind_remember) and mind_social create_thought are PUBLIC \u2014 they post to the user's social feed where everyone can see them. NEVER write to the public feed unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\". Deploy logs, PR notes, work outcomes, and agent activity belong in `entry` \u2014 NEVER on the public feed.\n\n\u2550\u2550\u2550 TOOL MAP \u2014 44 tools \u2550\u2550\u2550\nMEMORY mind_query (semantic search) \u00B7 mind_remember (store / list / delete) \u00B7 mind_context (load identity + rules) \u00B7 mind_folders (organize documents) \u00B7 mind_folder_routes / mind_folder_suggest (routing) \u00B7 mind_share (document share links)\nLIFE & WORK mind_life (goals, tasks, calendar \u2014 supports delete + bulk_delete) \u00B7 mind_focuses (Focus \u2192 Project buckets) \u00B7 mind_tasks (assignable, reportable work items) \u00B7 mind_checklists (Kanon checklists \u2014 templates, runs, toggle, progress) \u00B7 mind_automate (triggers + workflows) \u00B7 mind_notify (notifications)\nPEOPLE mind_crm (contacts, pipeline stages, activity logging)\nGRAPH mind_graph (KG stats + health) \u00B7 mind_insights (Autonomous Learning Engine patterns) \u00B7 mind_sense (MINDsense emotional state) \u00B7 mind_osint (Osiris OSINT analyst)\nKNOWLEDGE mind_research (autonomous deep-research jobs) \u00B7 mind_train (teach the KG / save chats)\nFRONT LAYER mind_list_templates \u00B7 mind_get_template \u00B7 mind_save_typed \u00B7 mind_bootstrap_templates (16 structured document types: SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, \u2026)\nSOCIAL mind_social (public feed posts, social feed, communities \u2014 \u26A0\uFE0F posting writes to the user's PUBLIC feed) \u00B7 mind_social_analytics \u00B7 mind_profile (bio, prompts, model preferences) \u00B7 mind_personas (Influencer Factory synthetic personas)\nTRADER mind_trader (TraderMIND: live feed \u00B7 MIND Vision forecasts + history + per-bar scores \u00B7 candles \u00B7 cycles \u00B7 calibration \u00B7 engine health \u00B7 save/star/like + undo \u00B7 notes + feedback the engine learns from \u00B7 full journal CRUD \u00B7 personalized insights)\nFLEET/ADMIN mind_agents (Agent Command Center \u2014 agent registry, heartbeat, probe; admin key) \u00B7 mind_tickets (agent ticket queue \u2014 file / answer / triage / resolve; admin key) \u00B7 mind_admin (user provisioning; admin key) \u00B7 mind_accounts (own / switch / share multiple MINDs)\nAPPS mind_mindmap (MIND Mind Map) \u00B7 mind_moneymind (MoneyMIND personal finance) \u00B7 mind_budget (13-week cash flow) \u00B7 mind_sheets (Airtable-style tables) \u00B7 mind_email (Email Manager, \u26A0\uFE0F send is outward) \u00B7 mind_sign (e-signature, \u26A0\uFE0F send/resend are outward) \u00B7 mind_invoices (Invoice Agent, \u26A0\uFE0F invite is outward) \u00B7 mind_books (MIND Books accounting) \u00B7 mind_timer (Tempo time tracking) \u00B7 mind_forms (Quill lead-capture forms) \u00B7 mind_library (personal bookshelf)\n\nEvery tool's own description lists its exact actions and required parameters. For the full playbook \u2014 endpoint mapping, scopes, and common recipes \u2014 read the resource `mind://integration-guide`.";
13
+ export declare const INTEGRATION_GUIDE = "# MIND \u2014 Complete Integration Guide\n\nMIND is the persistent memory and knowledge-graph layer for AI agents. It stores\nidentity, memories, decisions, goals, tasks, contacts, and emotional context, and\nmakes them queryable across every session, tool, and agent \u2014 so an AI never starts\nfrom zero.\n\nThis guide tells any agent exactly how to integrate, regardless of how it runs.\n\n---\n\n## 1. Choose your integration path\n\nMIND meets your agent wherever it runs. There are three paths \u2014 pick the one that\nmatches your runtime. They all read and write the *same* knowledge graph.\n\n| Your runtime | Path | How to connect |\n|---|---|---|\n| MCP host \u2014 Claude Code, Claude Desktop, Cursor, Windsurf, Zed, any MCP client | **MCP server** | Remote, no install: add `https://www.m-i-n-d.ai/mcp` as a custom connector and sign in via browser OAuth \u2014 or, if your host has no OAuth flow but lets you add a header, use the same URL with `Authorization: Bearer mind_<key>` and no OAuth at all. Prefer local stdio? `npx -y --package=@astramindapp/mcp-server mind-mcp-setup`, or add the server to your MCP config. You are reading this because you are already connected \u2014 just call the `mind_*` tools. |\n| OpenClaw agent | **OpenClaw plugin** | `openclaw plugins install @astramindapp/openclaw-mind`. Do NOT install the MCP server for OpenClaw \u2014 OpenClaw consumes a plugin, not an MCP server, for its memory slot. The plugin exposes MIND as native OpenClaw tools. |\n| Anything else \u2014 custom agent, backend service, script, n8n, automation | **REST API** | Call `https://m-i-n-d.ai/developer/v1/*` directly with header `X-API-Key: <key>`. Every MCP tool is a thin wrapper over one of these endpoints. |\n\nAll three paths are equivalent in capability. The MCP server and OpenClaw plugin\nare convenience layers over the same `/developer/v1` REST API.\n\n**No browser OAuth in your host? Use a key on the same URL.** Every host that\nlets you add a custom MCP server with a header can use MIND with no OAuth and\nno npm install: Server URL `https://www.m-i-n-d.ai/mcp`, header\n`Authorization: Bearer mind_<your key>`. Mint a key at\nhttps://www.m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys. Agents: if\n`AuthenticateMcpServer` or the host's connect card fails, ask the user for a\nMIND API key and rewire the same URL with that header \u2014 do not fall back to\nthe local npm server just because OAuth didn't work.\n\n## 2. Authenticate\n\nEvery path needs a **MIND API key** \u2014 a string with the prefix `mind_`.\n\n- Get a key: https://m-i-n-d.ai \u2192 Settings \u2192 Developer \u2192 API Keys.\n- MCP server: set env var `MIND_API_KEY`. Optionally `MIND_BASE_URL` (defaults to the production host).\n- REST: send it as the `X-API-Key` request header.\n- Keys carry **scopes** (e.g. `life:read`, `life:write`, `crm:write`). A new key gets the full standard set. The admin tools `mind_admin`, `mind_agents`, and `mind_tickets` require an **admin-scoped** key.\n\n## 3. Session protocol\n\nFollow this every session \u2014 it is the difference between an agent with memory and\nan agent that re-discovers the world each time.\n\n1. **Start** \u2014 call `mind_context`. Loads identity, operating rules, current priorities, and recent activity.\n2. **Before deciding or asserting** \u2014 call `mind_query` on the specific topic. MIND is the authoritative memory; never claim something does not exist without querying first.\n3. **After completing non-trivial work** \u2014 call `mind_remember` to log the outcome (what worked, what didn't, decisions made). Tag it. Set `source` to your agent name.\n\n## 4. The 44 tools\n\n### Memory\n- **mind_query** \u2014 semantic search across the knowledge graph. Returns RETRIEVED CONTEXT (documents, entries, entities, relationships) for YOU to synthesize \u2014 not a finished answer \u2014 and costs 0 credits. Pass `retrieve_only=false` to have MIND write the answer itself (spends credits). 5 search modes.\n- **mind_remember** \u2014 store/manage content. Actions: create, search, get, list, delete. Types: **PRIVATE**: `document` (long-form research/specs), `entry` (medium-form observations/agent logs \u2014 DEFAULT). **PUBLIC**: `feed_post` (a social-media post on the user's public feed \u2014 NEVER use unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\"; deploy logs and agent outcomes belong in `entry`). `thought` is a deprecated alias for `feed_post`.\n- **mind_folders** \u2014 organize documents into folders. Actions: list, create, rename, move, delete, move_documents. Folders are a presentation layer \u2014 the graph still indexes every document regardless of folder. Typical flow: `mind_remember` create a document, then `mind_folders` move_documents to file it.\n- **mind_share** \u2014 create and manage share links for one MIND document. Actions: create (default \u2014 mint a link, optionally scoped to a `grantee_username`, with `expires_in_days`/`password`), list (this document's links), list_all (every link across your documents), revoke.\n- **mind_context** \u2014 load persistent identity, preferences, rules, priorities, recent activity as retrieved context (0 credits; YOU synthesize).\n\n### Life & work\n- **mind_life** \u2014 goals, projects, tasks, calendar events, productivity stats. Actions: list, create, update, complete, delete, **bulk_delete** (up to 200 ids in one call), move, get, calendar_*, stats.\n- **mind_tasks** \u2014 site-wide assignable work items that attach to projects, contacts, or agents. Actions: list, create, get, update, complete, reopen, assign, delete, reports.\n- **mind_automate** \u2014 scheduled workflows, event triggers, rules.\n- **mind_notify** \u2014 read and manage notifications.\n\n### People\n- **mind_crm** \u2014 contacts, pipeline stages, activity logging, interaction history.\n\n### Knowledge graph & intelligence\n- **mind_graph** \u2014 KG statistics, diagnostics, label/entity breakdown, health.\n- **mind_insights** \u2014 patterns surfaced by the Autonomous Learning Engine, weekly summaries.\n- **mind_sense** \u2014 MINDsense emotional intelligence: the user's living emotional state, signal history, KG entity weights.\n- **mind_research** \u2014 launch and manage autonomous deep-research jobs; findings land in the graph.\n- **mind_train** \u2014 guided training sessions and chat-to-KG ingestion.\n\n### Front Layer templates (structured documents)\n- **mind_list_templates** / **mind_get_template** / **mind_save_typed** / **mind_bootstrap_templates** \u2014 the 16 typed-document templates (SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, and more) that give a MIND tenant a well-structured front layer.\n\n### Social & profile\n- **mind_social** \u2014 PUBLIC feed posts, social feed, communities. \u26A0\uFE0F `create_thought` writes to the user's PUBLIC social feed \u2014 NEVER call unless the user explicitly said \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\". For private agent outcomes, use `mind_remember` with `type=entry` instead.\n- **mind_profile** \u2014 bio, AI prompt settings, model preferences.\n\n### Trading (TraderMIND)\n- **mind_trader** \u2014 operate TraderMIND, the agentic trading engine. Read the engine: `feed` (live trade-idea feed) \u00B7 `forecast_latest` / `forecasts` / `bar_scores` (MIND Vision forecasts \u2014 latest cone, resolved history, per-candle scores) \u00B7 `candles` \u00B7 `cycles` (regime / ideas / lessons) \u00B7 `health` \u00B7 `calibration` (the published honesty curve) \u00B7 `ai_journal` (the trader's own narration). Act as the user: `save` / `star` / `like` / `unsave` \u00B7 `note` / `feedback` (feedback reaches the engine's brain) \u00B7 `notes` / `interactions` / `counts` (read back state + public social proof) \u00B7 full journal CRUD (`journal_list/create/get/update/delete`) \u00B7 `insights` (personalized, cached 15 min). Auth: engine reads plus `counts` are public \u2014 they work even with a missing or invalid key; only the act-as-you actions (save/star/like/unsave, note/feedback, notes, interactions, saved, journal_*, insights) authenticate as the key's owner. Saves, notes, feedback, and journal entries also land in the owner's MIND knowledge graph.\n\n### Fleet & administration (admin key required)\n- **mind_agents** \u2014 the **Agent Command Center**: the canonical registry of every agent in the fleet (running, planned, archived). Each agent is owned by a MIND account (`owner_username`). Actions: list (with `list_query` free-text search), get, create, update, delete, heartbeat, probe, log_activity, list_activities, import_from_mind, seed_known, set_status, set_current_job, transfer_owner, share, list_shares, revoke_share, plus invoice linking. Backed by `/admin/agents`.\n- **mind_tickets** \u2014 the **agent ticket queue**: client feedback, critique, ideas, feature requests, and bugs filed against any agent. Actions: list, get, create, comment (answer a ticket), update (triage status/priority/kind/assignee), resolve, delete. `agent_slug` is required on every call. Backed by `/admin/agents/{slug}/tickets`.\n- **mind_admin** \u2014 user provisioning + the **Featured Minds Portal**: full CRUD over featured minds with admin write-through to the linked `user_profiles` doc. Actions: `create_user`, `list_users`, `update_user_tier`, `adjust_user_credits`, `create_featured_mind`, `list_featured_minds`, `get_featured_mind_full` (bundled mind + owner profile + model catalog \u2014 what the portal side sheet loads), `update_featured_mind` (catalog fields: title / subtitle / description / tags / featured / display_order / is_public / avatar_url / banner_url / price), `update_featured_mind_owner_profile` (write-through to user_profiles: `preferred_llm_model`, `public_mind_prompt`, `chat_temperature`, `chat_reasoning_effort`, `public_mind_enabled`, `public_mind_tagline` / `greeting` / `persona`, `bio`, `avatar_url`, `banner_url` \u2014 changes hit /m/{username} immediately), `reorder_featured_minds` (bulk display_order via `ordered_mind_ids`), `delete_featured_mind`.\n- **mind_accounts** \u2014 multi-MIND ownership: discover, create, and switch between MINDs; manage owners, viewers, and invitations.\n\n### Full-coverage apps (v0.25.0)\n- **mind_mindmap** \u2014 MIND Mind Map (m-i-n-d.ai/#/mind-map). Actions: list, get, create, update, delete, get_shared. Sharing, collaborators and AI generation from a prompt or project stay in the web app on purpose (JWT-only, human-only \u2014 see `tests/test_mindmap_apikey_auth.py`).\n- **mind_moneymind** \u2014 MoneyMIND personal finance (m-i-n-d.ai/#/moneyMIND). Accounts, transactions, categories, budgets, recurring bills, net worth, goals, credit, alerts, bill negotiation, bank statements \u2014 36 actions.\n- **mind_budget** \u2014 13-week cash-flow planner (m-i-n-d.ai/#/budget). Cells, rows, quarters, variance, roll-forward, statement autofill/build.\n- **mind_sheets** \u2014 Airtable-style tables (m-i-n-d.ai/#/sheets). Tables, columns, rows, CSV export.\n- **mind_email** \u2014 MIND Email Manager (m-i-n-d.ai/#/email). Inbox, threads, search, draft, \u26A0\uFE0F send (outward), voice/tone preferences.\n- **mind_checklists** \u2014 Kanon checklists (kanon.theastraway.com), attached to Life items or tasks. Templates + runs + toggle_item + progress rollups.\n- **mind_sign** \u2014 MIND Sign e-signature (m-i-n-d.ai/#/mindsign). Envelopes, fields, \u26A0\uFE0F send/resend (outward), void, audit, certificate.\n- **mind_invoices** \u2014 Invoice Agent (m-i-n-d.ai/#/invoiceagent). Create/update invoices, ask questions about one, \u26A0\uFE0F invite (outward), received invoices.\n- **mind_books** \u2014 MIND Books accounting (m-i-n-d.ai/#/mind-books). Vendors, customers, accounts, bills, invoices overview.\n- **mind_timer** \u2014 Tempo time tracking. Start/stop, manual entries, summaries.\n- **mind_forms** \u2014 Quill lead-capture forms (m-i-n-d.ai/#/forms). Build forms, read submissions, public read by slug.\n- **mind_library** \u2014 Personal bookshelf (m-i-n-d.ai/#/library). Authors, books, chapter content, AI reading companion.\n\nEach tool's own MCP description is the source of truth for its exact action list\nand required parameters \u2014 read it before calling.\n\n## 5. REST endpoint mapping\n\nIf you integrate over REST, every tool maps to `/developer/v1`. Examples:\n\n| Capability | Method + path |\n|---|---|\n| Query the graph | `POST /developer/v1/query` |\n| List / create life items | `GET` / `POST /developer/v1/life/items` |\n| Delete one life item | `DELETE /developer/v1/life/items/{id}` |\n| Delete many life items | `POST /developer/v1/life/items/bulk-delete` (body: `{\"item_ids\": [...]}`) |\n| CRM contacts | `GET` / `POST /developer/v1/crm/contacts` |\n| Documents (PRIVATE) | `/developer/v1/documents` |\n| Entries (PRIVATE) | `/developer/v1/entries` |\n| Feed posts (PUBLIC) \u2014 personal CRUD | `/developer/v1/thoughts` \u2014 scope `thoughts:read` / `thoughts:write`. `/feed_posts` is a semantic alias mounted on the same handlers + collection (UI JWT path). |\n| Feed posts (PUBLIC) \u2014 social layer | `/developer/v1/social/thoughts` (create / get / delete / like) + `/developer/v1/social/feed` (browse) \u2014 scope `social:write` / `social:read` |\n| Folders | `GET` / `POST /developer/v1/folders`, `PATCH` / `DELETE /developer/v1/folders/{id}` |\n| Move documents into a folder | `POST /developer/v1/documents/move` (body: `{\"doc_ids\": [...], \"folder_id\": \"...\"}`) |\n| TraderMIND \u2014 latest MIND Vision forecast | `GET /api/trader/forecasts/latest?symbol=ES` (engine reads \u2014 `/api/trader/forecasts`, `/candles`, `/cycles`, `/calibration`, `/health`, `/ai-journal`, plus `GET /api/mindtrades/feed` and `GET /api/trader/counts` \u2014 are public; the act-as-you routes `/interact`, `/note`, `/notes`, `/interactions`, `/saved`, `/journal`, `/insights` need the user's key) |\n| Agent Command Center | `/admin/agents` (admin key) |\n| Agent ticket queue | `/admin/agents/{slug}/tickets` \u2014 `GET`/`POST`, `/{ticket_id}` `GET`/`PATCH`/`DELETE`, `/{ticket_id}/comments` `POST` (admin key) |\n| **Featured Minds Portal** | `/admin/featured-minds` `GET`/`POST`, `/admin/featured-minds/{id}` `PUT`/`DELETE`, `/admin/featured-minds/{id}/full` `GET` (bundled view), `/admin/featured-minds/{id}/owner-profile` `PUT` (admin write-through to user_profiles: model, prompt, temperature, brand fields), `/admin/featured-minds/reorder` `PUT` (body: `{\"ordered_mind_ids\": [...]}`), `/admin/featured-minds/{id}/upload` `POST` (multipart: `kind=avatar|banner`, `file`) \u2014 all admin key |\n\n## 6. Common recipes\n\n- **Clear the life board** \u2014 `mind_life` action `bulk_delete` with every item id (list first, then pass the ids), or repeated for boards over 200 items.\n- **Start a session right** \u2014 `mind_context`, then `mind_query` for anything you are about to act on.\n- **Record an outcome** \u2014 `mind_remember` action `create`, type `entry`, with tags and your `source`.\n- **File a document in a folder** \u2014 `mind_folders` action `create` to make the folder, `mind_remember` to create the document, then `mind_folders` action `move_documents` with the document id and the folder id. `folder_id: \"root\"` files at the top level.\n- **Register / update an agent** \u2014 `mind_agents` (admin key) \u2014 `create` or `update`, then `heartbeat` from the agent runtime.\n- **Handle agent tickets** \u2014 `mind_tickets` (admin key) \u2014 `list` an agent's queue, `get` a ticket with its thread, `comment` to answer, then `resolve`. `agent_slug` is required on every call.\n- **Run the Featured Minds Portal from MCP** \u2014 `mind_admin` (admin key) \u2014 `list_featured_minds` to get every mind_id, `get_featured_mind_full` for a bundled view (featured_mind doc + owner profile + model catalog in one round-trip), `update_featured_mind` for catalog fields (title/tags/featured/display_order/is_public/avatar/banner/subtitle/price), `update_featured_mind_owner_profile` for chat-behavior fields (preferred_llm_model, public_mind_prompt, chat_temperature, chat_reasoning_effort, public_mind_tagline/greeting/persona, bio) \u2014 this write-through hits /m/{username} immediately, `reorder_featured_minds` for bulk display_order, `delete_featured_mind` to remove from the catalog (user's MIND is preserved).\n\n## 7. Feed post endpoint surfaces (clarification)\n\nA \"feed post\" is a public social-media-style post on the user's MIND feed. There are three endpoint surfaces, all backed by the **same** `thoughts` MongoDB collection \u2014 pick by what your key carries:\n\n| Surface | Use when | Scope required |\n|---|---|---|\n| `/developer/v1/thoughts` (POST / GET / DELETE / search) | Personal feed post CRUD via a developer API key | `thoughts:read` / `thoughts:write` |\n| `/developer/v1/social/thoughts` (POST / GET / DELETE / like) + `/developer/v1/social/feed` (browse) | Same create/delete + the social-feed read surface for browsing other users' posts, likes, repost flow | `social:write` (writes) / `social:read` (browse) |\n| `/feed_posts` (POST / GET / DELETE + comments/likes/reposts) | Semantic alias for `/thoughts` \u2014 same UI JWT handlers under a clearer URL. Both paths share handlers and the MongoDB collection. | UI JWT |\n\nThere is no functional difference for create/delete between `/thoughts` and `/social/thoughts` \u2014 both insert into `db.thoughts`. Pick the surface that matches your auth path and the scope your key carries. **Whichever surface you write through, the post lands on the user's PUBLIC feed.** Follow the explicit-trigger rule in every tool description.\n\n## 8. Brand & rules\n\nThe product is **MIND** by **Astra AI**. Never reference underlying libraries in\nuser-facing content \u2014 MIND is the brand. Treat MIND as the authoritative memory:\nwhen the graph and local files disagree, reconcile explicitly rather than guessing.\n";
14
14
  //# sourceMappingURL=integration-guide.d.ts.map
package/dist/integration-guide.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"integration-guide.d.ts","sourceRoot":"","sources":["../src/integration-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,mBAAmB,2uIA2BqK,CAAC;AAEtM,eAAO,MAAM,iBAAiB,q/eAgJ7B,CAAC"}
1
+ {"version":3,"file":"integration-guide.d.ts","sourceRoot":"","sources":["../src/integration-guide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,mBAAmB,iqKA4BqK,CAAC;AAEtM,eAAO,MAAM,iBAAiB,iojBA+J7B,CAAC"}
package/dist/integration-guide.js CHANGED
@@ -28,16 +28,17 @@ AUTH: every path needs a MIND API key (prefix \`mind_\`). Get one at https://m-i
28
28
 
29
29
  ⚠️ PRIVATE vs PUBLIC: \`document\` and \`entry\` (via mind_remember) are PRIVATE to the user's knowledge graph. \`feed_post\` (mind_remember) and mind_social create_thought are PUBLIC — they post to the user's social feed where everyone can see them. NEVER write to the public feed unless the user explicitly said "post", "share", "tweet", "feed", or "thought to my feed". Deploy logs, PR notes, work outcomes, and agent activity belong in \`entry\` — NEVER on the public feed.
30
30
 
31
- ═══ TOOL MAP — 25 tools ═══
32
- MEMORY mind_query (semantic search) · mind_remember (store / list / delete) · mind_context (load identity + rules)
33
- LIFE & WORK mind_life (goals, tasks, calendar — supports delete + bulk_delete) · mind_tasks (assignable, reportable work items) · mind_automate (triggers + workflows) · mind_notify (notifications)
31
+ ═══ TOOL MAP — 44 tools ═══
32
+ MEMORY mind_query (semantic search) · mind_remember (store / list / delete) · mind_context (load identity + rules) · mind_folders (organize documents) · mind_folder_routes / mind_folder_suggest (routing) · mind_share (document share links)
33
+ LIFE & WORK mind_life (goals, tasks, calendar — supports delete + bulk_delete) · mind_focuses (Focus → Project buckets) · mind_tasks (assignable, reportable work items) · mind_checklists (Kanon checklists — templates, runs, toggle, progress) · mind_automate (triggers + workflows) · mind_notify (notifications)
34
34
  PEOPLE mind_crm (contacts, pipeline stages, activity logging)
35
- GRAPH mind_graph (KG stats + health) · mind_insights (Autonomous Learning Engine patterns) · mind_sense (MINDsense emotional state)
35
+ GRAPH mind_graph (KG stats + health) · mind_insights (Autonomous Learning Engine patterns) · mind_sense (MINDsense emotional state) · mind_osint (Osiris OSINT analyst)
36
36
  KNOWLEDGE mind_research (autonomous deep-research jobs) · mind_train (teach the KG / save chats)
37
37
  FRONT LAYER mind_list_templates · mind_get_template · mind_save_typed · mind_bootstrap_templates (16 structured document types: SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, …)
38
- SOCIAL mind_social (public feed posts, social feed, communities — ⚠️ posting writes to the user's PUBLIC feed) · mind_profile (bio, prompts, model preferences)
38
+ SOCIAL mind_social (public feed posts, social feed, communities — ⚠️ posting writes to the user's PUBLIC feed) · mind_social_analytics · mind_profile (bio, prompts, model preferences) · mind_personas (Influencer Factory synthetic personas)
39
39
  TRADER mind_trader (TraderMIND: live feed · MIND Vision forecasts + history + per-bar scores · candles · cycles · calibration · engine health · save/star/like + undo · notes + feedback the engine learns from · full journal CRUD · personalized insights)
40
40
  FLEET/ADMIN mind_agents (Agent Command Center — agent registry, heartbeat, probe; admin key) · mind_tickets (agent ticket queue — file / answer / triage / resolve; admin key) · mind_admin (user provisioning; admin key) · mind_accounts (own / switch / share multiple MINDs)
41
+ APPS mind_mindmap (MIND Mind Map) · mind_moneymind (MoneyMIND personal finance) · mind_budget (13-week cash flow) · mind_sheets (Airtable-style tables) · mind_email (Email Manager, ⚠️ send is outward) · mind_sign (e-signature, ⚠️ send/resend are outward) · mind_invoices (Invoice Agent, ⚠️ invite is outward) · mind_books (MIND Books accounting) · mind_timer (Tempo time tracking) · mind_forms (Quill lead-capture forms) · mind_library (personal bookshelf)
41
42
 
42
43
  Every tool's own description lists its exact actions and required parameters. For the full playbook — endpoint mapping, scopes, and common recipes — read the resource \`mind://integration-guide\`.`;
43
44
  exports.INTEGRATION_GUIDE = `# MIND — Complete Integration Guide
@@ -92,12 +93,13 @@ an agent that re-discovers the world each time.
92
93
  2. **Before deciding or asserting** — call \`mind_query\` on the specific topic. MIND is the authoritative memory; never claim something does not exist without querying first.
93
94
  3. **After completing non-trivial work** — call \`mind_remember\` to log the outcome (what worked, what didn't, decisions made). Tag it. Set \`source\` to your agent name.
94
95
 
95
- ## 4. The 25 tools
96
+ ## 4. The 44 tools
96
97
 
97
98
  ### Memory
98
99
  - **mind_query** — semantic search across the knowledge graph. Returns RETRIEVED CONTEXT (documents, entries, entities, relationships) for YOU to synthesize — not a finished answer — and costs 0 credits. Pass \`retrieve_only=false\` to have MIND write the answer itself (spends credits). 5 search modes.
99
100
  - **mind_remember** — store/manage content. Actions: create, search, get, list, delete. Types: **PRIVATE**: \`document\` (long-form research/specs), \`entry\` (medium-form observations/agent logs — DEFAULT). **PUBLIC**: \`feed_post\` (a social-media post on the user's public feed — NEVER use unless the user explicitly said "post", "share", "tweet", "feed", or "thought to my feed"; deploy logs and agent outcomes belong in \`entry\`). \`thought\` is a deprecated alias for \`feed_post\`.
100
101
  - **mind_folders** — organize documents into folders. Actions: list, create, rename, move, delete, move_documents. Folders are a presentation layer — the graph still indexes every document regardless of folder. Typical flow: \`mind_remember\` create a document, then \`mind_folders\` move_documents to file it.
102
+ - **mind_share** — create and manage share links for one MIND document. Actions: create (default — mint a link, optionally scoped to a \`grantee_username\`, with \`expires_in_days\`/\`password\`), list (this document's links), list_all (every link across your documents), revoke.
101
103
  - **mind_context** — load persistent identity, preferences, rules, priorities, recent activity as retrieved context (0 credits; YOU synthesize).
102
104
 
103
105
  ### Life & work
@@ -132,6 +134,20 @@ an agent that re-discovers the world each time.
132
134
  - **mind_admin** — user provisioning + the **Featured Minds Portal**: full CRUD over featured minds with admin write-through to the linked \`user_profiles\` doc. Actions: \`create_user\`, \`list_users\`, \`update_user_tier\`, \`adjust_user_credits\`, \`create_featured_mind\`, \`list_featured_minds\`, \`get_featured_mind_full\` (bundled mind + owner profile + model catalog — what the portal side sheet loads), \`update_featured_mind\` (catalog fields: title / subtitle / description / tags / featured / display_order / is_public / avatar_url / banner_url / price), \`update_featured_mind_owner_profile\` (write-through to user_profiles: \`preferred_llm_model\`, \`public_mind_prompt\`, \`chat_temperature\`, \`chat_reasoning_effort\`, \`public_mind_enabled\`, \`public_mind_tagline\` / \`greeting\` / \`persona\`, \`bio\`, \`avatar_url\`, \`banner_url\` — changes hit /m/{username} immediately), \`reorder_featured_minds\` (bulk display_order via \`ordered_mind_ids\`), \`delete_featured_mind\`.
133
135
  - **mind_accounts** — multi-MIND ownership: discover, create, and switch between MINDs; manage owners, viewers, and invitations.
134
136
 
137
+ ### Full-coverage apps (v0.25.0)
138
+ - **mind_mindmap** — MIND Mind Map (m-i-n-d.ai/#/mind-map). Actions: list, get, create, update, delete, get_shared. Sharing, collaborators and AI generation from a prompt or project stay in the web app on purpose (JWT-only, human-only — see \`tests/test_mindmap_apikey_auth.py\`).
139
+ - **mind_moneymind** — MoneyMIND personal finance (m-i-n-d.ai/#/moneyMIND). Accounts, transactions, categories, budgets, recurring bills, net worth, goals, credit, alerts, bill negotiation, bank statements — 36 actions.
140
+ - **mind_budget** — 13-week cash-flow planner (m-i-n-d.ai/#/budget). Cells, rows, quarters, variance, roll-forward, statement autofill/build.
141
+ - **mind_sheets** — Airtable-style tables (m-i-n-d.ai/#/sheets). Tables, columns, rows, CSV export.
142
+ - **mind_email** — MIND Email Manager (m-i-n-d.ai/#/email). Inbox, threads, search, draft, ⚠️ send (outward), voice/tone preferences.
143
+ - **mind_checklists** — Kanon checklists (kanon.theastraway.com), attached to Life items or tasks. Templates + runs + toggle_item + progress rollups.
144
+ - **mind_sign** — MIND Sign e-signature (m-i-n-d.ai/#/mindsign). Envelopes, fields, ⚠️ send/resend (outward), void, audit, certificate.
145
+ - **mind_invoices** — Invoice Agent (m-i-n-d.ai/#/invoiceagent). Create/update invoices, ask questions about one, ⚠️ invite (outward), received invoices.
146
+ - **mind_books** — MIND Books accounting (m-i-n-d.ai/#/mind-books). Vendors, customers, accounts, bills, invoices overview.
147
+ - **mind_timer** — Tempo time tracking. Start/stop, manual entries, summaries.
148
+ - **mind_forms** — Quill lead-capture forms (m-i-n-d.ai/#/forms). Build forms, read submissions, public read by slug.
149
+ - **mind_library** — Personal bookshelf (m-i-n-d.ai/#/library). Authors, books, chapter content, AI reading companion.
150
+
135
151
  Each tool's own MCP description is the source of truth for its exact action list
136
152
  and required parameters — read it before calling.
137
153
 
package/dist/integration-guide.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"integration-guide.js","sourceRoot":"","sources":["../src/integration-guide.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEU,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;qMA2BkK,CAAC;AAEzL,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgJhC,CAAC"}
1
+ {"version":3,"file":"integration-guide.js","sourceRoot":"","sources":["../src/integration-guide.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEU,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;qMA4BkK,CAAC;AAEzL,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+JhC,CAAC"}
package/dist/mind-client.d.ts CHANGED
@@ -467,6 +467,19 @@ export declare class MindClient {
467
467
  private apiKey;
468
468
  constructor(config: MindClientConfig);
469
469
  private request;
470
+ /**
471
+ * Generic action-dispatch call for the full-coverage app tools (mind_mindmap,
472
+ * mind_moneymind, mind_budget, mind_sheets, mind_email, mind_checklists,
473
+ * mind_sign, mind_invoices, mind_books, mind_timer, mind_forms, mind_library).
474
+ *
475
+ * `pathTemplate` may contain `{param}` placeholders filled from `args` and
476
+ * removed from the query/body. `queryParams` are read from `args` and sent
477
+ * as a query string (arrays are comma-joined). `bodyParams` are read from
478
+ * `args` and sent as the JSON body for any method other than GET — omitted
479
+ * keys (value `undefined`) are dropped so partial updates only patch what
480
+ * the caller actually set.
481
+ */
482
+ call<T = unknown>(method: string, pathTemplate: string, args: Record<string, unknown>, pathParams?: string[], queryParams?: string[], bodyParams?: string[]): Promise<T>;
470
483
  query(req: QueryRequest): Promise<QueryResponse>;
471
484
  osint(req: {
472
485
  action: string;