thronglets 0.2.0

package/README.md

@@ -0,0 +1,63 @@
+# Thronglets
+
+P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p.
+
+AI agents leave execution traces on a decentralized network. Traces propagate via gossipsub and aggregate into collective intelligence that any agent can query.
+
+## Install
+
+```bash
+npm install -g thronglets
+```
+
+## MCP Setup
+
+```bash
+# Claude Code
+claude mcp add thronglets -- npx thronglets mcp
+
+# With P2P network
+claude mcp add thronglets -- npx thronglets mcp --port 0 --bootstrap /ip4/47.93.32.88/tcp/4001
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "thronglets": {
+      "command": "npx",
+      "args": ["thronglets", "mcp"]
+    }
+  }
+}
+```
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `trace_record` | Record an execution trace (capability, outcome, latency, context, model) |
+| `substrate_query` | Query with intent: `resolve` / `evaluate` / `explore` |
+
+## Also available via
+
+```bash
+# Rust
+cargo install thronglets
+
+# Python
+pip install thronglets
+```
+
+## Links
+
+- [GitHub](https://github.com/Shangri-la-0428/Thronglets)
+- [crates.io](https://crates.io/crates/thronglets)
+- [MCP Registry](https://registry.modelcontextprotocol.io/)
+
+## License
+
+MIT

package/bin/thronglets.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const binPath = path.join(__dirname, "thronglets-bin");
+
+if (!fs.existsSync(binPath)) {
+  console.error("Thronglets binary not found. Run: npm rebuild thronglets");
+  process.exit(1);
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  process.exit(err.status || 1);
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "thronglets",
+  "version": "0.2.0",
+  "description": "P2P shared memory substrate for AI agents — stigmergic knowledge network via libp2p",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agents",
+    "p2p",
+    "libp2p",
+    "stigmergy",
+    "collective-intelligence",
+    "simhash",
+    "decentralized"
+  ],
+  "homepage": "https://github.com/Shangri-la-0428/Thronglets",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Shangri-la-0428/Thronglets.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "thronglets": "bin/thronglets.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "os": ["darwin", "linux"],
+  "cpu": ["arm64", "x64"],
+  "mcpName": "io.github.Shangri-la-0428/thronglets"
+}

package/scripts/install.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+
+const VERSION = "0.2.0";
+const REPO = "Shangri-la-0428/Thronglets";
+
+const PLATFORMS = {
+  "darwin-arm64": {
+    asset: `thronglets-mcp-darwin-arm64`,
+    sha256: "7b0546e9381b8dc9180036afc1cbcd504068b4ac13d92f497a44945fc3faad5e",
+  },
+  "linux-x64": {
+    asset: `thronglets-mcp-linux-amd64`,
+    sha256: "d02883a6eecb861de8c1328ee9f264d4eb2d17635eb8db069bdf66ea7e9f33e6",
+  },
+};
+
+const platform = `${process.platform}-${process.arch}`;
+const target = PLATFORMS[platform];
+
+if (!target) {
+  console.error(`Unsupported platform: ${platform}`);
+  console.error(`Supported: ${Object.keys(PLATFORMS).join(", ")}`);
+  console.error("You can install from source: cargo install thronglets");
+  process.exit(1);
+}
+
+const binDir = path.join(__dirname, "..", "bin");
+const binPath = path.join(binDir, "thronglets-bin");
+const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${target.asset}`;
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (url) => {
+      const client = url.startsWith("https") ? https : http;
+      client.get(url, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          follow(res.headers.location);
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+          return;
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close();
+          resolve();
+        });
+      }).on("error", reject);
+    };
+    follow(url);
+  });
+}
+
+async function main() {
+  console.log(`Downloading thronglets v${VERSION} for ${platform}...`);
+
+  fs.mkdirSync(binDir, { recursive: true });
+
+  try {
+    await download(url, binPath);
+    fs.chmodSync(binPath, 0o755);
+    console.log("Thronglets installed successfully.");
+  } catch (err) {
+    console.error(`Failed to download: ${err.message}`);
+    console.error("You can install from source: cargo install thronglets");
+    process.exit(1);
+  }
+}
+
+main();