agent-job-relay-runtime 0.0.0-stage → 0.1.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentJobRelay contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# AgentJobRelay runtime
 
-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.
+Shared native Rust/MCP executable for the AgentJobRelay OpenCode V1 and ChatGPT Desktop/Codex plugins. Linux x86_64/glibc or Windows x86_64 with Node.js 20+; no Rust compiler, install script, separate binary download, global PATH change or system service is required. The package includes the native executable and a platform-specific SHA-256 manifest. The manifest records the Linux build's minimum glibc version; incompatible platforms fail explicitly. Windows uses a statically linked MSVC runtime. Hashes check integrity, not publisher authenticity. Use the official npm registry and verify the publisher/provenance when available.
+
+This is an experimental package. See the [repository](https://github.com/MorningFrog/agent-job-relay) for release availability, supported hosts and known limits. An npm version being downloadable is separate from official plugin-directory approval.
+
+`agent-job-relay codex <arguments>` and `agent-job-relay opencode <arguments>` select persistent host profiles under `$XDG_STATE_HOME/agent-job-relay/<host>`, or `$HOME/.local/state/agent-job-relay/<host>`. Windows uses `%LOCALAPPDATA%\AgentJobRelay\profiles\<host>`. An explicit absolute `AJR_STATE_DIR` overrides that choice. Ordinary arguments pass to the same native CLI. These profiles are outside npm/host caches and stable across version updates; they contain no guessed caller identity. New profiles do not migrate a prior offline installation. Review its recorded state path before deliberately selecting it.
+
+Installation runs no code. Invoking the CLI or plugin validates the packaged executable, then runs it with your OS permissions. First submission/explicit session binding starts the per-profile daemon. Removal preserves jobs/logs/history and does not stop daemons. Finish jobs and explicitly stop the original profile before an incompatible upgrade; no automatic daemon stop, database rollback or workload replay is performed.
+
+Development: this source directory intentionally has no native payload. Build and pack from the repository with `python3 scripts/prepare_release.py --binary target/release/agent-job-relay --output .tmp/release-candidate`.
+
+Windows 0.1.8 starts its daemon on demand, including host cleanup jobs, through verified same-user local CIM when native startup is denied. No login task/service is installed. Built-in Windows PowerShell/CIM must be permitted; diagnostics provide a copyable same-profile outside-terminal fallback when policy blocks it. `AJR_WINDOWS_STARTUP=direct` disables CIM.

package/cli.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { constants } from "node:os";
+import { resolveExecutable, defaultStateDir } from "./index.mjs";
+
+try {
+  const args = process.argv.slice(2);
+  if (["codex", "opencode"].includes(args[0])) {
+    const host = args.shift();
+    args.unshift("--state-dir", defaultStateDir(host));
+  }
+  const child = spawn(resolveExecutable(), args, { stdio: "inherit" });
+  for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(signal, () => child.kill(signal));
+  child.once("error", (error) => { console.error(`AgentJobRelay: ${error.message}`); process.exitCode = 1; });
+  child.once("exit", (code, signal) => { process.exitCode = code ?? 128 + (constants.signals[signal] ?? 1); });
+} catch (error) {
+  console.error(`AgentJobRelay: ${error.message}`);
+  process.exitCode = 1;
+}

package/index.mjs

@@ -0,0 +1,46 @@
+import { readFileSync, lstatSync, accessSync, constants } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname, join, isAbsolute } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = dirname(fileURLToPath(import.meta.url));
+
+export function resolveExecutable() {
+  const platform = `${process.platform}-${process.arch}`;
+  if (!["linux-x64", "win32-x64"].includes(platform)) {
+    throw new Error("AgentJobRelay supports Linux x86_64/glibc and Windows x86_64; macOS/ARM are not implemented");
+  }
+  const manifest = JSON.parse(readFileSync(join(root, "native/manifest.json"), "utf8"));
+  const metadata = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+  const target = manifest.format === 2 ? manifest.targets?.[platform] : manifest.format === 1 && manifest.platform === platform ? manifest : undefined;
+  if (manifest.version !== metadata.version || !target || !/^[0-9a-f]{64}$/.test(target.sha256)) {
+    throw new Error("Invalid or missing AgentJobRelay native target; reinstall the matching trusted package");
+  }
+  if (process.platform === "linux") {
+    if (!/^\d+\.\d+$/.test(target.minimumGlibc)) throw new Error("Invalid native glibc requirement");
+    const libc = process.report?.getReport?.().header.glibcVersionRuntime;
+    const [major, minor] = (libc ?? "").split(".").map(Number);
+    const [requiredMajor, requiredMinor] = target.minimumGlibc.split(".").map(Number);
+    if (!libc || major < requiredMajor || major === requiredMajor && minor < requiredMinor) {
+      throw new Error(`AgentJobRelay requires glibc >=${target.minimumGlibc}; musl/unknown libc is unsupported`);
+    }
+  }
+  const executable = join(root, "native", platform, process.platform === "win32" ? "agent-job-relay.exe" : "agent-job-relay");
+  const stat = lstatSync(executable);
+  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 128 * 1024 * 1024 || createHash("sha256").update(readFileSync(executable)).digest("hex") !== target.sha256) {
+    throw new Error("AgentJobRelay native payload failed integrity validation; nothing was executed");
+  }
+  accessSync(executable, constants.X_OK);
+  return executable;
+}
+
+export function defaultStateDir(host) {
+  if (!["codex", "opencode"].includes(host)) throw new Error("Unknown AgentJobRelay host profile");
+  const linuxState = process.env.XDG_STATE_HOME || (process.env.HOME && join(process.env.HOME, ".local/state"));
+  const base = process.platform === "win32"
+    ? process.env.LOCALAPPDATA && join(process.env.LOCALAPPDATA, "AgentJobRelay", "profiles")
+    : linuxState && join(linuxState, "agent-job-relay");
+  const state = process.env.AJR_STATE_DIR || (base && join(base, host));
+  if (!state || !isAbsolute(state)) throw new Error("AgentJobRelay state path must be absolute; set AJR_STATE_DIR or the platform's state base");
+  return state;
+}

package/native/manifest.json

@@ -0,0 +1,13 @@
+{
+  "format": 2,
+  "version": "0.1.8",
+  "targets": {
+    "linux-x64": {
+      "minimumGlibc": "2.34",
+      "sha256": "8b86b7e83fa3b8e3b25330226bae1dd77f29cf646a5b79577d626a1c8d669b12"
+    },
+    "win32-x64": {
+      "sha256": "a0e34708285b681466bf97d7a2384086619a8f12c889c3dd7aae35ed940d01b9"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "agent-job-relay-runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.8",
+  "description": "Shared Linux and Windows native runtime for AgentJobRelay host plugins",
+  "type": "module",
+  "exports": "./index.mjs",
+  "bin": {
+    "agent-job-relay": "./cli.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "cli.mjs",
+    "native",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "os": [
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MorningFrog/agent-job-relay.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/MorningFrog/agent-job-relay",
+  "bugs": {
+    "url": "https://github.com/MorningFrog/agent-job-relay/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}