@ilivemylife/graph-sdk 1.0.0

package/examples/messenger-basics.mjs

@@ -0,0 +1,189 @@
+/**
+ * Messenger Basics - Messages and Lifebot
+ *
+ * Shows how to work with the messenger in nodes:
+ * - Send messages (without AI)
+ * - Read messages
+ * - Ask Lifebot and wait for response
+ * - Ask Lifebot to create/organize nodes
+ *
+ * Getting your token:
+ *   Option 1: npx ilml login
+ *   Option 2: Browser DevTools → Network tab → any request → Headers → "access-token"
+ *
+ * Run:
+ *   node examples/messenger-basics.mjs
+ */
+
+import {
+    createGraphClient,
+    LIFEBOT_MESSAGE_TYPES,
+    LifebotTimeoutError,
+    LifebotRateLimitError
+} from '@ilivemylife/graph-sdk';
+
+const graph = createGraphClient({
+    token: process.env.ILML_TOKEN
+});
+
+console.log('='.repeat(60));
+console.log('Messenger & Lifebot Example');
+console.log('='.repeat(60));
+
+// Get user's root node for demos
+const me = await graph.me();
+console.log('\nUsing root node:', me.rootItemId);
+
+// ============================================================================
+// 1. Read existing messages
+// ============================================================================
+
+console.log('\n[Reading Messages]');
+const messages = await graph.messages(me.rootItemId, 5);
+console.log(`Found ${messages.length} messages`);
+
+messages.forEach(msg => {
+    const date = new Date(parseInt(msg.createdAt)).toLocaleString();
+    const preview = msg.content?.substring(0, 50) || '(empty)';
+    console.log(`  [${date}] ${msg.createdBy}: ${preview}...`);
+});
+
+// ============================================================================
+// 2. Send a simple message (no AI response)
+// ============================================================================
+
+console.log('\n[Sending Message - No AI]');
+const simpleMsg = await graph.addMessage(me.rootItemId, 'Hello from SDK! This is a test message.', {
+    lifebot: LIFEBOT_MESSAGE_TYPES.off  // Don't trigger AI response
+});
+console.log('  Sent message ID:', simpleMsg.id);
+console.log('  Content:', simpleMsg.content);
+
+// ============================================================================
+// 3. Ask Lifebot a simple question
+// ============================================================================
+
+console.log('\n[Asking Lifebot - Simple Question]');
+console.log('  Sending: "What is 2 + 2?"');
+console.log('  Waiting for AI response...');
+
+try {
+    const answer = await graph.askLifebot(me.rootItemId, 'What is 2 + 2?', {
+        timeout: 60000  // Wait up to 60 seconds
+    });
+    console.log('  Lifebot says:', answer.content);
+} catch (error) {
+    if (error instanceof LifebotTimeoutError) {
+        console.log('  Timeout - Lifebot did not respond in time');
+        console.log('  (Check if Lifebot is enabled in node settings)');
+    } else if (error instanceof LifebotRateLimitError) {
+        console.log('  Rate limit exceeded, try again later');
+    } else {
+        throw error;
+    }
+}
+
+// ============================================================================
+// 4. Ask Lifebot to search/analyze
+// ============================================================================
+
+console.log('\n[Asking Lifebot - Search in Graph]');
+console.log('  Sending: "What nodes do I have in my root?"');
+
+try {
+    const searchAnswer = await graph.askLifebot(
+        me.rootItemId,
+        'What nodes do I have in my root? List the first 5.',
+        { timeout: 60000 }
+    );
+    console.log('  Lifebot says:', searchAnswer.content.substring(0, 200) + '...');
+} catch (error) {
+    if (error instanceof LifebotTimeoutError) {
+        console.log('  Timeout - try with a longer timeout or check Lifebot settings');
+    } else {
+        throw error;
+    }
+}
+
+// ============================================================================
+// 5. Ask Lifebot to CREATE a node
+// ============================================================================
+
+console.log('\n[Asking Lifebot - Create Node]');
+console.log('  Asking Lifebot to create a project node...');
+
+try {
+    const createResult = await graph.askLifebot(
+        me.rootItemId,
+        `Please create a new node called "Lifebot Demo Project".
+Add a markdown description explaining that this project was created by Lifebot
+as a demonstration of AI capabilities in iLiveMyLife.`,
+        { timeout: 120000 }  // 2 minutes for complex operations
+    );
+    console.log('  Lifebot:', createResult.content.substring(0, 300));
+} catch (error) {
+    if (error instanceof LifebotTimeoutError) {
+        console.log('  Timeout on create operation');
+    } else {
+        throw error;
+    }
+}
+
+// ============================================================================
+// 6. Ask Lifebot to create STRUCTURE
+// ============================================================================
+
+console.log('\n[Asking Lifebot - Create Structure]');
+console.log('  Asking Lifebot to add child nodes to the project...');
+
+try {
+    const structureResult = await graph.askLifebot(
+        me.rootItemId,
+        `Inside the "Lifebot Demo Project" you just created, please add these child nodes:
+1. "Features" - describe what Lifebot can do
+2. "Examples" - list example use cases
+3. "Getting Started" - how to enable and use Lifebot
+
+Add helpful descriptions to each.`,
+        { timeout: 120000 }
+    );
+    console.log('  Lifebot:', structureResult.content.substring(0, 300));
+} catch (error) {
+    if (error instanceof LifebotTimeoutError) {
+        console.log('  Timeout on structure operation');
+    } else {
+        throw error;
+    }
+}
+
+// ============================================================================
+// Done!
+// ============================================================================
+
+console.log('\n' + '='.repeat(60));
+console.log('What is Lifebot?');
+console.log('='.repeat(60));
+console.log(`
+Lifebot is the AI assistant built into iLiveMyLife. It can:
+
+  - Answer questions about your knowledge graph
+  - Search and find information across your nodes
+  - CREATE new nodes with titles and descriptions
+  - ORGANIZE information by creating structure
+  - Execute actions on your behalf
+
+When you call askLifebot(), your message is sent to Lifebot which:
+  1. Receives your question/request
+  2. Has access to the current node's context
+  3. Can perform actions (create, edit, etc.)
+  4. Sends back a response
+
+Tips:
+  - Enable Lifebot in node settings (add 'assist' tag)
+  - Use clear, specific requests
+  - For complex operations, increase timeout
+  - Check node settings if Lifebot doesn't respond
+`);
+
+// Free resources and close connections
+graph.destroy();

package/examples/subscriptions.mjs

@@ -0,0 +1,60 @@
+/**
+ * Real-time Subscriptions Example
+ *
+ * Shows how to subscribe to message and item changes.
+ *
+ * Run: node examples/subscriptions.mjs
+ */
+
+import {
+    createGraphClient,
+    MESSAGE_CHANGE_TYPES,
+    ITEM_CHANGE_TYPES
+} from '@ilivemylife/graph-sdk';
+
+const graph = createGraphClient({
+    token: process.env.ILML_TOKEN
+});
+
+const nodeId = process.env.NODE_ID;
+
+// Subscribe to messages with change type handling
+console.log('Subscribing to messages...');
+const unsubscribeMessages = await graph.subscribeToMessages(nodeId, (change, message) => {
+    if (change === MESSAGE_CHANGE_TYPES.added) {
+        console.log('New message:', message.content?.substring(0, 50));
+    } else if (change === MESSAGE_CHANGE_TYPES.edited) {
+        console.log('Message edited:', message.id);
+    } else if (change === MESSAGE_CHANGE_TYPES.deleted) {
+        console.log('Message deleted:', message.id);
+    }
+});
+
+// Subscribe to item changes with change type handling
+console.log('Subscribing to items...');
+const unsubscribeItems = await graph.subscribeToItems(nodeId, (change, item) => {
+    if (change === ITEM_CHANGE_TYPES.added) {
+        console.log('New item:', item.title);
+    } else if (change === ITEM_CHANGE_TYPES.edited) {
+        console.log('Item edited:', item.title);
+    } else if (change === ITEM_CHANGE_TYPES.movedIn) {
+        console.log('Item moved here:', item.title);
+    } else if (change === ITEM_CHANGE_TYPES.reorder) {
+        console.log('Item reordered:', item.title);
+    } else if (change === ITEM_CHANGE_TYPES.deleted) {
+        console.log('Item deleted:', item.id);
+    }
+});
+
+console.log('Listening for changes... Press Ctrl+C to stop');
+
+// Clean up on exit
+process.on('SIGINT', () => {
+    console.log('\nUnsubscribing...');
+    unsubscribeMessages();
+    unsubscribeItems();
+    process.exit(0);
+});
+
+// Keep process alive
+setInterval(() => {}, 1000);

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ilivemylife/graph-sdk",
+  "version": "1.0.0",
+  "description": "SDK and CLI for iLiveMyLife Knowledge Graph",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/client.cjs",
+  "module": "./dist/client.mjs",
+  "types": "./dist/client.d.ts",
+  "bin": {
+    "ilml": "./bin/ilml",
+    "ilml-mcp": "./dist/mcp-server.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.cjs"
+    },
+    "./queries": {
+      "types": "./dist/queries.d.ts",
+      "import": "./dist/queries.mjs",
+      "require": "./dist/queries.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch && npm publish --access public",
+    "release:minor": "npm version minor && npm publish --access public",
+    "release:major": "npm version major && npm publish --access public"
+  },
+  "keywords": [
+    "ilivemylife",
+    "ilml",
+    "knowledge-graph",
+    "pkm",
+    "graphql",
+    "sdk",
+    "cli",
+    "ai",
+    "lifebot"
+  ],
+  "author": "Ilya Sorokin <info@ilivemylife.io> (https://ilivemylife.io)",
+  "homepage": "https://ilivemylife.io",
+  "dependencies": {
+    "@apollo/client": "^3.8.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "cross-fetch": "^4.0.0",
+    "graphql": "^16.8.0",
+    "graphql-ws": "^5.14.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}