@ilivemylife/graph-sdk 1.0.6 → 1.0.8

package/README.md

@@ -39,43 +39,38 @@ SDK for [iLiveMyLife](https://iLiveMyLife.io) Knowledge Graph.
 - **Node.js 18+** — [download](https://nodejs.org/)
 - **iLiveMyLife account** — sign up at [iLiveMyLife.io](https://iLiveMyLife.io)
 
-## Installation
+## Getting Started
+
+### 1. Install
 
 ```bash
-npm install @ilivemylife/graph-sdk
+npm install -g @ilivemylife/graph-sdk
 ```
 
-## Authentication
+### 2. Login
 
-You need an access token to use the SDK.
-
-**Option 1: CLI Login (recommended)**
 ```bash
-npx ilml login
-# Prompts for email and password in terminal
-# Token saved to ~/.ilivemylife/config.json
-# After this, CLI commands work automatically
-# For SDK, pass token explicitly: createGraphClient({ token })
+ilml login
+ilml doctor  # verify installation
 ```
 
-**Option 2: Programmatic login (for bots and automations)**
-```javascript
-const response = await fetch('https://api.ilivemylife.io/api/v1/login', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ email: 'you@example.com', password: '...' })
-});
-const token = response.headers.get('access-token');
+Token saved to `~/.ilivemylife/config.json`. For per-project accounts, see [Token Priority](#token-priority).
 
-const graph = createGraphClient({ token });
+### 3. Add to AI tools (optional)
+
+```bash
+# Claude Code (global — available in all projects)
+claude mcp add --scope user ilml -- npx -y @ilivemylife/graph-sdk
+
+# Claude Code (current project only)
+claude mcp add ilml -- npx -y @ilivemylife/graph-sdk
 ```
 
-**Option 3: Browser DevTools (manual)**
-1. Open https://app.ilivemylife.io and log in
-2. Open DevTools (F12) → Network tab
-3. Make any action (refresh page, open a node)
-4. Click any GraphQL request → Headers tab
-5. Copy `access-token` value, use it as: `createGraphClient({ token: 'copied-value' })`
+For Cursor, Windsurf, Claude Desktop — see [MCP Setup](#mcp-server-ai-assistant-integration).
+
+---
+
+## Authentication Details
 
 ### Config File
 
@@ -94,22 +89,18 @@ After `ilml login`, config is saved as JSON:
 }
 ```
 
-- `token` — access token for API requests
-- `user` — your account info (cached for display in CLI)
-- `rootItemId` — your "My Life" root node ID
-
 ### Token Priority
 
-The SDK and CLI resolve tokens in this order (first found wins):
+The SDK, CLI, and MCP server resolve tokens in this order (first found wins):
 
 | Priority | Source | How to set |
 |----------|--------|------------|
 | 1 | Local config | `ilml login --local` → `.ilivemylife/config.json` in project dir |
-| 2 | `.env` file | Create `.env` with `ILML_TOKEN=your-token` in project dir |
+| 2 | `.env` file | `ILML_TOKEN=your-token` in project dir |
 | 3 | Global config | `ilml login` → `~/.ilivemylife/config.json` |
 | 4 | Environment variable | `export ILML_TOKEN=your-token` |
 
-This lets you use different accounts per project:
+Use different accounts per project:
 ```bash
 # Global account (default)
 ilml login
@@ -117,11 +108,27 @@ ilml login
 # Project-specific account (overrides global)
 cd my-project
 ilml login --local
+```
+
+### Other Authentication Methods
 
-# Or via .env file
-echo "ILML_TOKEN=project-specific-token" > .env
+**Programmatic login (for bots and automations):**
+```javascript
+const response = await fetch('https://api.ilivemylife.io/api/v1/login', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ email: 'you@example.com', password: '...' })
+});
+const token = response.headers.get('access-token');
+const graph = createGraphClient({ token });
 ```
 
+**Browser DevTools (manual):**
+1. Open https://app.ilivemylife.io and log in
+2. Open DevTools (F12) → Network tab
+3. Click any GraphQL request → Headers tab
+4. Copy `access-token` value
+
 ## Finding Node IDs
 
 Node IDs are visible in the URL when viewing a node:
@@ -608,34 +615,56 @@ project-b/.env                        # ILML_TOKEN=xxx
 
 ### Setup
 
-**Claude Code (quick):**
+**Prerequisites:** Run `ilml login` first (see [Getting Started](#getting-started)).
+
+**Claude Code:**
 ```bash
-claude mcp add --env ILML_TOKEN=your-token ilml -- ilml-mcp
+# Global (available in all projects)
+claude mcp add --scope user ilml -- ilml-mcp
+
+# Or current project only
+claude mcp add ilml -- ilml-mcp
+```
+
+If you didn't install globally (`npm install -g`), use npx:
+```bash
+claude mcp add --scope user ilml -- npx -y @ilivemylife/graph-sdk
 ```
 
-**Claude Code (manual)** — add to `~/.claude/settings.json`:
+**Other AI tools** — add to config file:
 
 ```json
 {
   "mcpServers": {
     "ilml": {
-      "command": "ilml-mcp",
-      "env": { "ILML_TOKEN": "your-token" }
+      "command": "npx",
+      "args": ["-y", "@ilivemylife/graph-sdk"]
     }
   }
 }
 ```
 
-**Other AI tools** — same JSON content, different config file:
+Or if installed globally:
+```json
+{
+  "mcpServers": {
+    "ilml": {
+      "command": "ilml-mcp"
+    }
+  }
+}
+```
 
 | AI Tool | Config Path |
 |---------|------------|
-| Claude Code | `~/.claude/settings.json` or `claude mcp add` |
+| Claude Code | `claude mcp add` (recommended) or `~/.claude/settings.json` |
 | Claude Desktop | macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` |
 | | Windows: `%APPDATA%\Claude\claude_desktop_config.json` |
 | Cursor | `~/.cursor/mcp.json` |
 | Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| IntelliJ IDEA | Settings → Tools → AI Assistant → Model Context Protocol (MCP) |
 
+Token is resolved automatically: local config > .env > global config > ILML_TOKEN env var.
 Restart your AI tool after adding the config.
 
 ### Available Tools
@@ -691,23 +720,6 @@ import type {
 
 ---
 
-## Publishing New Versions
-
-```bash
-# First time: login to npm
-npm login
-
-# First publish
-npm publish --access public
-
-# Update versions:
-npm run release:patch   # 1.0.0 → 1.0.1 (bug fixes)
-npm run release:minor   # 1.0.0 → 1.1.0 (new features)
-npm run release:major   # 1.0.0 → 2.0.0 (breaking changes)
-```
-
----
-
 ## License
 
 © 2026 Ilya Sorokin. All rights reserved.

package/dist/cli.mjs

@@ -523,7 +523,7 @@ function createApolloClient(options) {
   const { token, httpUrl, wsUrl, enableSubscriptions, webSocketImpl } = options;
   const requestHeaders = {
     "access-token": token,
-    "x-client": `sdk/${"1.0.6"}`
+    "x-client": `sdk/${"1.0.8"}`
   };
   const httpLink = createHttpLink({
     uri: httpUrl,
@@ -536,7 +536,7 @@ function createApolloClient(options) {
   if (enableSubscriptions) {
     const wsClientOptions = {
       url: wsUrl,
-      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.6"}` }
+      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.8"}` }
     };
     if (webSocketImpl) {
       wsClientOptions.webSocketImpl = webSocketImpl;
@@ -2383,7 +2383,7 @@ async function cmdUpdate() {
   const { execSync } = await import("child_process");
   console.log("Checking for updates...");
   try {
-    const currentVersion = "1.0.6";
+    const currentVersion = "1.0.8";
     let latestVersion;
     try {
       const result = execSync("npm view @ilivemylife/graph-sdk version", { encoding: "utf-8" }).trim();
@@ -2413,7 +2413,7 @@ async function cmdDoctor() {
   console.log("\u2550".repeat(60));
   let issues = 0;
   console.log(`
-[Version] ${"1.0.6"}`);
+[Version] ${"1.0.8"}`);
   const localConfigPath = findLocalConfigFile();
   const globalExists = existsSync2(GLOBAL_CONFIG_FILE);
   console.log("\n[Config Files]");
@@ -2604,11 +2604,11 @@ async function cmdUninstall() {
   console.log("\u2550".repeat(60));
 }
 function showVersion() {
-  console.log(`@ilivemylife/graph-sdk v${"1.0.6"}`);
+  console.log(`@ilivemylife/graph-sdk v${"1.0.8"}`);
 }
 function showHelp() {
   console.log(`
-@ilivemylife/graph-sdk v${"1.0.6"}
+@ilivemylife/graph-sdk v${"1.0.8"}
 CLI for iLiveMyLife Knowledge Graph
 
 USAGE

package/dist/client.cjs

@@ -623,7 +623,7 @@ function createApolloClient(options) {
   const { token, httpUrl, wsUrl, enableSubscriptions, webSocketImpl } = options;
   const requestHeaders = {
     "access-token": token,
-    "x-client": `sdk/${"1.0.6"}`
+    "x-client": `sdk/${"1.0.8"}`
   };
   const httpLink = createHttpLink({
     uri: httpUrl,
@@ -636,7 +636,7 @@ function createApolloClient(options) {
   if (enableSubscriptions) {
     const wsClientOptions = {
       url: wsUrl,
-      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.6"}` }
+      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.8"}` }
     };
     if (webSocketImpl) {
       wsClientOptions.webSocketImpl = webSocketImpl;

package/dist/client.mjs

@@ -550,7 +550,7 @@ function createApolloClient(options) {
   const { token, httpUrl, wsUrl, enableSubscriptions, webSocketImpl } = options;
   const requestHeaders = {
     "access-token": token,
-    "x-client": `sdk/${"1.0.6"}`
+    "x-client": `sdk/${"1.0.8"}`
   };
   const httpLink = createHttpLink({
     uri: httpUrl,
@@ -563,7 +563,7 @@ function createApolloClient(options) {
   if (enableSubscriptions) {
     const wsClientOptions = {
       url: wsUrl,
-      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.6"}` }
+      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.8"}` }
     };
     if (webSocketImpl) {
       wsClientOptions.webSocketImpl = webSocketImpl;

package/dist/mcp-server.mjs

@@ -540,7 +540,7 @@ function createApolloClient(options) {
   const { token, httpUrl, wsUrl, enableSubscriptions, webSocketImpl } = options;
   const requestHeaders = {
     "access-token": token,
-    "x-client": `sdk/${"1.0.6"}`
+    "x-client": `sdk/${"1.0.8"}`
   };
   const httpLink = createHttpLink({
     uri: httpUrl,
@@ -553,7 +553,7 @@ function createApolloClient(options) {
   if (enableSubscriptions) {
     const wsClientOptions = {
       url: wsUrl,
-      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.6"}` }
+      connectionParams: { "access-token": token, "x-client": `sdk/${"1.0.8"}` }
     };
     if (webSocketImpl) {
       wsClientOptions.webSocketImpl = webSocketImpl;
@@ -1278,6 +1278,43 @@ When adding item, set \`refId\` to target node ID. The new node becomes a shortc
 - Nodes can have shareable invite links
 - Users in node see each other's icons
 - Privacy controlled via tags (private, wallet, etc.)
+`,
+  lifebot: `
+# Lifebot (AI Assistant)
+
+Lifebot is the built-in AI assistant in iLiveMyLife. Understanding how to interact with it is important.
+
+## Enabling Lifebot on a Node
+
+- Add \`assist\` tag to the node \u2014 this enables Lifebot for that node
+- Without \`assist\` tag, Lifebot will NOT respond to messages
+- Exception: personal/root nodes may have Lifebot enabled by default
+
+## Messaging Lifebot
+
+### Guaranteeing a Response
+- Use \`@Lifebot\` mention in message text \u2014 guarantees Lifebot will respond
+- Without mention, Lifebot may decide the message isn't addressed to him
+- In collaborative nodes with multiple users, \`@Lifebot\` is especially important
+
+### The \`lifebot\` Parameter
+- \`lifebot: "on"\` \u2014 this is the DEFAULT, does nothing special
+- \`lifebot: "off"\` \u2014 explicitly disables Lifebot for this specific message
+- The parameter exists to DISABLE Lifebot when needed, not to enable it
+
+## graph_ask_lifebot vs graph_add_message
+
+| Method | Behavior |
+|--------|----------|
+| \`graph_ask_lifebot\` | Synchronous \u2014 waits for response, returns it directly. May timeout. |
+| \`graph_add_message\` | Asynchronous \u2014 sends message, Lifebot responds later. Read with \`graph_messages\`. |
+
+## Best Practices
+
+1. Always add \`assist\` tag when creating nodes where Lifebot should respond
+2. Use \`@Lifebot\` in collaborative/shared nodes
+3. For immediate answers, use \`graph_ask_lifebot\`
+4. For fire-and-forget, use \`graph_add_message\` and check response later
 `
 };
 async function isHighPrivacyNodeOrRef(graph, item) {
@@ -1308,7 +1345,7 @@ function getGraphInfo(topic) {
   if (!topic || topic === "all") {
     return Object.values(GRAPH_KNOWLEDGE).join("\n---\n");
   }
-  return GRAPH_KNOWLEDGE[topic] || `Unknown topic: ${topic}. Available: markers, tags, links, privacy, all`;
+  return GRAPH_KNOWLEDGE[topic] || `Unknown topic: ${topic}. Available: markers, tags, links, privacy, lifebot, all`;
 }
 var server = new Server(
   {
@@ -1639,8 +1676,8 @@ To enable markers on parent: tags: ["#markerList#0000018190aaf813-a61a6f263e6a00
       properties: {
         topic: {
           type: "string",
-          enum: ["markers", "tags", "links", "privacy", "all"],
-          description: "Topic to get info about: markers (status system), tags (special tags), links (references), privacy (access control), all (everything)"
+          enum: ["markers", "tags", "links", "privacy", "lifebot", "all"],
+          description: "Topic to get info about: markers (status system), tags (special tags), links (references), privacy (access control), lifebot (AI assistant), all (everything)"
         }
       },
       required: []
@@ -2017,6 +2054,30 @@ function cleanup() {
 process.on("SIGTERM", cleanup);
 process.on("SIGINT", cleanup);
 async function main() {
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    console.log(`iLiveMyLife Graph MCP Server v${VERSION}
+
+Usage: ilml-mcp
+
+This is an MCP server for AI assistants (Claude Code, Cursor, etc).
+It runs as a long-lived process and communicates via stdin/stdout.
+
+Setup:
+  1. Install and login:
+     npm install -g @ilivemylife/graph-sdk
+     ilml login
+
+  2. Add to Claude Code:
+     claude mcp add --scope user ilml -- ilml-mcp
+
+  3. Or without global install:
+     claude mcp add --scope user ilml -- npx -y @ilivemylife/graph-sdk
+
+Token is resolved from: local config > .env > global config > ILML_TOKEN env var
+
+More info: https://www.npmjs.com/package/@ilivemylife/graph-sdk`);
+    process.exit(0);
+  }
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("iLiveMyLife Graph MCP Server running");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ilivemylife/graph-sdk",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "SDK and CLI for iLiveMyLife Knowledge Graph",
   "license": "UNLICENSED",
   "engines": {