@geckovision/gecko 0.3.1

package/bin/gecko.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+"use strict";
+// Launcher: resolve the native gecko binary for this platform and exec it,
+// forwarding argv, stdio, and the exit code. No Python, no download.
+
+const { execFileSync } = require("node:child_process");
+const { resolveBinary } = require("../lib/resolve.js");
+
+const { binary, error } = resolveBinary(process.platform, process.arch, (s) =>
+  require.resolve(s),
+);
+
+if (error) {
+  process.stderr.write(`gecko: ${error}\n`);
+  process.exit(1);
+}
+
+try {
+  execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+  // execFileSync throws on a non-zero exit; propagate the child's code.
+  process.exit(typeof e.status === "number" ? e.status : 1);
+}

package/lib/resolve.js

@@ -0,0 +1,52 @@
+"use strict";
+// Pure binary-resolution logic for the @geckovision/gecko launcher.
+// Kept dependency-free and side-effect-free so it unit-tests with a fake resolver.
+
+const path = require("node:path");
+
+// node's process.arch -> our binary arch label. Currently an identity map (a no-op
+// guard that degrades an unknown arch to a non-matching key); kept so a future arch
+// rename (e.g. ia32/ppc) has one place to translate. The x86_64<->x64 rename lives in
+// release.yml, mapping the binary asset filename to the package name.
+const ARCH = { x64: "x64", arm64: "arm64" };
+
+// The (platform-arch) targets we publish a binary package for. Extend as
+// release.yml gains targets (win32-x64, darwin-x64, …).
+const SUPPORTED = new Set(["linux-x64", "linux-arm64", "darwin-arm64"]);
+
+/** The @geckovision platform package for this (platform, arch), or null if unsupported. */
+function targetPackage(platform, arch) {
+  const key = `${platform}-${ARCH[arch] || arch}`;
+  return SUPPORTED.has(key) ? `@geckovision/gecko-${key}` : null;
+}
+
+/**
+ * Resolve the native binary path for this platform.
+ * `resolve` is an injected `require.resolve`-like fn (specifier -> absolute path).
+ * Returns { binary, pkg } on success or { error } with an actionable message.
+ */
+function resolveBinary(platform, arch, resolve) {
+  const pkg = targetPackage(platform, arch);
+  if (!pkg) {
+    return {
+      error:
+        `unsupported platform ${platform}-${arch}. ` +
+        `Supported: ${[...SUPPORTED].join(", ")}. ` +
+        `Download a binary from https://github.com/GeckoVision/gecko-surf/releases`,
+    };
+  }
+  let pkgJson;
+  try {
+    pkgJson = resolve(`${pkg}/package.json`);
+  } catch {
+    return {
+      error:
+        `${pkg} is not installed (its optionalDependency was skipped). ` +
+        `Reinstall without --no-optional / --ignore-optional.`,
+    };
+  }
+  const binName = platform === "win32" ? "gecko.exe" : "gecko";
+  return { binary: path.join(path.dirname(pkgJson), "bin", binName), pkg };
+}
+
+module.exports = { targetPackage, resolveBinary, SUPPORTED, ARCH };

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@geckovision/gecko",
+  "version": "0.3.1",
+  "description": "Make any API agent-usable — first call correct. Point gecko at an API and your agent can use it.",
+  "keywords": [
+    "gecko",
+    "mcp",
+    "api",
+    "agent",
+    "openapi",
+    "cli"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://geckovision.tech",
+  "repository": "github:GeckoVision/gecko-surf",
+  "bin": {
+    "gecko": "bin/gecko.js"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "optionalDependencies": {
+    "@geckovision/gecko-linux-x64": "=0.3.1",
+    "@geckovision/gecko-linux-arm64": "=0.3.1",
+    "@geckovision/gecko-darwin-arm64": "=0.3.1"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  }
+}