@twinsearth/im2agent 0.0.0-stage → 1.8.8

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# im2agent (npm CLI)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+IM2A gateway 的跨平台 npm 启动器。安装后可用 `im2a` 命令启动网关，
+首次运行会从 GitHub Release 下载对应平台的 Go 二进制并缓存到 `~/.im2a/bin/<version>`。
+
+```bash
+npm install -g @twinsearth/im2agent
+im2a -port 8080
+curl http://127.0.0.1:8080/healthz
+```
+
+## 开发 / 离线测试
+
+用本地已编译的二进制（跳过下载）：
+
+```bash
+export IM2A_BIN=/path/to/im2a-gateway_linux_amd64
+im2a -port 8080
+```
+
+平台覆盖：linux / darwin / windows × amd64 / arm64。版本与 Go 后端同步（当前 1.8.8）。

package/bin/im2a.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+'use strict';
+// im2a: IM2A gateway 跨平台启动器。
+// 优先级：IM2A_BIN 环境变量（开发/测试）> 本地缓存 > 从 GitHub Release 下载。
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { spawn } = require('child_process');
+const { execFileSync } = require('child_process');
+
+const PKG_VERSION = '1.8.8';
+const REPO = 'TwinsEarth/im2agent';
+
+function platformAsset() {
+  const goos = process.platform === 'darwin' ? 'darwin'
+    : process.platform === 'win32' ? 'windows' : 'linux';
+  const goarch = process.arch === 'arm64' ? 'arm64'
+    : process.arch === 'x64' ? 'amd64' : null;
+  if (!goarch) throw new Error('unsupported arch: ' + process.arch);
+  const ext = goos === 'windows' ? '.exe' : '';
+  return `im2a-gateway_${goos}_${goarch}${ext}`;
+}
+
+function cacheDir() {
+  const d = path.join(os.homedir(), '.im2a', 'bin', PKG_VERSION);
+  fs.mkdirSync(d, { recursive: true });
+  return d;
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (u) => https.get(u, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return follow(res.headers.location);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error('download failed HTTP ' + res.statusCode + ' ' + u));
+      }
+      const tmp = dest + '.part';
+      const out = fs.createWriteStream(tmp);
+      res.pipe(out);
+      out.on('finish', () => { out.close(() => { fs.renameSync(tmp, dest); resolve(); }); });
+      out.on('error', reject);
+    }).on('error', reject);
+    follow(url);
+  });
+}
+
+async function resolveBinary() {
+  const asset = platformAsset();
+  if (process.env.IM2A_BIN) {
+    if (!fs.existsSync(process.env.IM2A_BIN)) throw new Error('IM2A_BIN not found: ' + process.env.IM2A_BIN);
+    return process.env.IM2A_BIN;
+  }
+  const cached = path.join(cacheDir(), asset);
+  if (fs.existsSync(cached)) return cached;
+  const url = `https://github.com/${REPO}/releases/download/v${PKG_VERSION}/${asset}`;
+  process.stderr.write(`[im2a] downloading ${asset} from ${url}\n`);
+  await download(url, cached);
+  if (process.platform !== 'win32') fs.chmodSync(cached, 0o755);
+  return cached;
+}
+
+(async () => {
+  try {
+    const args = process.argv.slice(2);
+    // --im2a-version 只打印启动器与二进制版本（自检/冒烟，不下载）
+    if (args.includes('--im2a-version')) {
+      process.stdout.write(`im2a launcher v${PKG_VERSION} (asset ${platformAsset()})\n`);
+      return;
+    }
+    const bin = await resolveBinary();
+    const child = spawn(bin, args, { stdio: 'inherit' });
+    child.on('exit', (code) => process.exit(code || 0));
+    child.on('error', (e) => { process.stderr.write(String(e.message || e) + '\n'); process.exit(1); });
+  } catch (e) {
+    process.stderr.write('[im2a] ' + (e.message || e) + '\n');
+    process.exit(1);
+  }
+})();

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@twinsearth/im2agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.8.8",
+  "description": "IM2A gateway CLI launcher — human-agent hybrid IM (connect Agent networks, human keeps final approval).",
+  "bin": {
+    "im2a": "bin/im2a.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "im2a",
+    "agent",
+    "im",
+    "human-agent",
+    "gateway",
+    "approval",
+    "ai-secretary"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TwinsEarth/im2agent.git"
+  },
+  "homepage": "https://github.com/TwinsEarth/im2agent#readme",
+  "bugs": {
+    "url": "https://github.com/TwinsEarth/im2agent/issues"
+  }
 }