@talotrace/connect 0.0.0-stage → 0.2.0

package/bin/talotrace-connect.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('node:child_process');
+const { binaryPath } = require('../lib/resolve');
+
+let binary;
+try {
+  binary = binaryPath(process.platform, process.arch, require.resolve);
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}
+
+// stdio is inherited: `mcp` speaks the protocol on this process's stdin and stdout.
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' });
+for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+  process.on(signal, () => child.kill(signal));
+}
+child.on('error', (error) => {
+  console.error(`could not start ${binary}: ${error.message}`);
+  process.exit(1);
+});
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});

package/lib/platform.js

@@ -0,0 +1,27 @@
+'use strict';
+
+// The one table that says which npm package carries the Go build for which OS and CPU. The release
+// script (npm/scripts/stage.mjs) builds its package list from the same names.
+const SCOPE = '@talotrace';
+const PLATFORMS = {
+  'darwin-arm64': { pkg: `${SCOPE}/connect-darwin-arm64`, binary: 'talotrace-connect' },
+  'darwin-x64': { pkg: `${SCOPE}/connect-darwin-x64`, binary: 'talotrace-connect' },
+  'linux-arm64': { pkg: `${SCOPE}/connect-linux-arm64`, binary: 'talotrace-connect' },
+  'linux-x64': { pkg: `${SCOPE}/connect-linux-x64`, binary: 'talotrace-connect' },
+  'win32-x64': { pkg: `${SCOPE}/connect-win32-x64`, binary: 'talotrace-connect.exe' },
+};
+
+/** The platform entry for an OS and CPU, or null when no build exists for them. */
+function platformFor(platform, arch) {
+  return PLATFORMS[`${platform}-${arch}`] || null;
+}
+
+/** An error message that names what was asked for and what is supported. */
+function unsupportedMessage(platform, arch) {
+  return (
+    `@talotrace/connect has no build for ${platform}/${arch}. ` +
+    `Supported: ${Object.keys(PLATFORMS).join(', ')}.`
+  );
+}
+
+module.exports = { PLATFORMS, platformFor, unsupportedMessage };

package/lib/resolve.js

@@ -0,0 +1,27 @@
+'use strict';
+
+const path = require('node:path');
+const { platformFor, unsupportedMessage } = require('./platform');
+
+/**
+ * The absolute path of the Go binary for this machine. `resolvePackage` finds a package's
+ * directory (require.resolve of its package.json); tests pass a fake one.
+ */
+function binaryPath(platform, arch, resolvePackage) {
+  const entry = platformFor(platform, arch);
+  if (!entry) {
+    throw new Error(unsupportedMessage(platform, arch));
+  }
+  let manifest;
+  try {
+    manifest = resolvePackage(`${entry.pkg}/package.json`);
+  } catch {
+    throw new Error(
+      `${entry.pkg} is not installed. It is an optional dependency of @talotrace/connect; ` +
+        'reinstall without --no-optional / --omit=optional.',
+    );
+  }
+  return path.join(path.dirname(manifest), 'bin', entry.binary);
+}
+
+module.exports = { binaryPath };

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@talotrace/connect",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "TaloTrace Connect: the TaloTrace MCP server for your coding agent, with a tunnel to the app on your laptop.",
+  "license": "UNLICENSED",
+  "bin": {
+    "talotrace-connect": "bin/talotrace-connect.js"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@talotrace/connect-darwin-arm64": "0.2.0",
+    "@talotrace/connect-darwin-x64": "0.2.0",
+    "@talotrace/connect-linux-arm64": "0.2.0",
+    "@talotrace/connect-linux-x64": "0.2.0",
+    "@talotrace/connect-win32-x64": "0.2.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.