heady-sdk 3.2.0

package/README.md

@@ -0,0 +1,40 @@
+# @heady/sdk
+
+> TypeScript client SDK for the Heady™ AI Platform — MCP tool calls, vector memory, and health checks.
+
+## Install
+
+```bash
+npm install @heady/sdk
+```
+
+## Quick Start
+
+```ts
+import { HeadyClient } from '@heady/sdk';
+
+const client = new HeadyClient('your-api-key');
+
+// Store a memory
+await client.storeMemory('user-1', 0.5, 1.2, -0.3, [0.1, 0.2, 0.3], { topic: 'ai' });
+
+// Query memories
+const results = await client.queryMemory('user-1', [0.1, 0.2, 0.3], 10);
+
+// Health check
+const health = await client.healthCheck();
+```
+
+## API
+
+| Method | Description |
+|--------|-------------|
+| `callTool(name, args)` | Call any MCP tool by name |
+| `storeMemory(...)` | Store a 3D vector memory |
+| `queryMemory(...)` | Query by embedding similarity |
+| `getMemoryStats(userId)` | Get user memory statistics |
+| `healthCheck()` | Server health probe |
+
+## License
+
+Proprietary — © 2026 HeadySystems Inc.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export declare class HeadyClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    callTool(name: string, args: any): Promise<any>;
+    storeMemory(userId: string, x: number, y: number, z: number, embedding: number[], metadata: any): Promise<any>;
+    queryMemory(userId: string, embedding: number[], limit?: number): Promise<any>;
+    getMemoryStats(userId: string): Promise<any>;
+    healthCheck(): Promise<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;IAAU,OAAO,CAAC,OAAO;gBAA/B,MAAM,EAAE,MAAM,EAAU,OAAO,SAA6B;IAE1E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB/C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG;IAI/F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,SAAK;IAI3D,cAAc,CAAC,MAAM,EAAE,MAAM;IAI7B,WAAW;CAGlB"}

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeadyClient = void 0;
+const core_1 = require("@heady/core");
+class HeadyClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = 'https://mcp.headymcp.com') {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async callTool(name, args) {
+        const response = await fetch(this.baseUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: Date.now(),
+                method: 'tools/call',
+                params: { name, arguments: args }
+            })
+        });
+        const data = await response.json();
+        if (data.error) {
+            throw new core_1.HeadyError(data.error.message, 'MCP_ERROR');
+        }
+        return data.result;
+    }
+    async storeMemory(userId, x, y, z, embedding, metadata) {
+        return this.callTool('memory.store', { userId, x, y, z, embedding, metadata });
+    }
+    async queryMemory(userId, embedding, limit = 10) {
+        return this.callTool('memory.query', { userId, embedding, limit });
+    }
+    async getMemoryStats(userId) {
+        return this.callTool('memory.stats', { userId });
+    }
+    async healthCheck() {
+        return this.callTool('server.health', {});
+    }
+}
+exports.HeadyClient = HeadyClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,sCAAyC;AAEzC,MAAa,WAAW;IACF;IAAwB;IAA5C,YAAoB,MAAc,EAAU,UAAU,0BAA0B;QAA5D,WAAM,GAAN,MAAM,CAAQ;QAAU,YAAO,GAAP,OAAO,CAA6B;IAAG,CAAC;IAEpF,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAAS;QACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;YACzC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACzC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;aAClC,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,iBAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,SAAmB,EAAE,QAAa;QACnG,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,SAAmB,EAAE,KAAK,GAAG,EAAE;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF;AA1CD,kCA0CC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "heady-sdk",
+  "version": "3.2.0",
+  "description": "TypeScript client SDK for the Heady AI Platform — MCP tool calls, vector memory operations, and health checks.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "heady-core": "^3.2.0"
+  },
+  "license": "UNLICENSED",
+  "author": {
+    "name": "HeadySystems Inc.",
+    "email": "eric@headyconnection.org",
+    "url": "https://headyme.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HeadyMe/heady-production.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://headysystems.com",
+  "bugs": {
+    "url": "https://github.com/HeadyMe/heady-production/issues"
+  },
+  "keywords": [
+    "heady",
+    "ai",
+    "sdk",
+    "mcp",
+    "client",
+    "multi-agent"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}