@tetsuo-ai/agenc 0.6.0 → 0.7.2

package/package.json

@@ -1,21 +1,41 @@
 {
   "name": "@tetsuo-ai/agenc",
-  "version": "0.6.0",
+  "version": "0.7.2",
   "description": "Public AgenC CLI launcher package",
   "license": "MIT",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tetsuo-ai/agenc-core.git",
+    "directory": "packages/agenc"
+  },
+  "homepage": "https://github.com/tetsuo-ai/agenc-core#readme",
+  "bugs": {
+    "url": "https://github.com/tetsuo-ai/agenc-core/issues"
+  },
   "bin": {
     "agenc": "bin/agenc"
   },
   "files": [
-    "bin",
-    "src",
-    "lib",
-    "scripts",
-    "generated"
+    "bin/agenc",
+    "src/launcher.mjs",
+    "lib/activation-lock-identity.d.mts",
+    "lib/activation-lock-identity.mjs",
+    "lib/generated-wrapper.d.mts",
+    "lib/generated-wrapper.mjs",
+    "lib/runtime-archive.mjs",
+    "lib/runtime-compatibility.mjs",
+    "lib/runtime-manager.mjs",
+    "lib/runtime-release-contract.d.mts",
+    "lib/runtime-release-contract.mjs",
+    "lib/sqlite-lock.d.mts",
+    "lib/sqlite-lock.mjs",
+    "scripts/postinstall.mjs",
+    "generated/agenc-runtime-manifest-v2.json"
   ],
   "scripts": {
     "postinstall": "node ./scripts/postinstall.mjs",
+    "prepack": "node ./scripts/check-package-ready.mjs && node ../../scripts/canonicalize-package-modes.mjs .",
     "build:runtime-tarball": "node ./scripts/build-runtime-tarball.mjs",
     "gen:manifest": "node ./scripts/gen-manifest.mjs",
     "test": "node --test test/*.test.mjs"
@@ -27,6 +47,6 @@
     "@tetsuo-ai/runtime": "file:../../runtime"
   },
   "engines": {
-    "node": ">=25.0.0"
+    "node": ">=25.9.0 <26.0.0"
   }
 }

package/generated/agenc-runtime-manifest.json

@@ -1,63 +0,0 @@
-{
-  "manifestVersion": 1,
-  "runtimeVersion": "0.6.0",
-  "releaseRepository": "tetsuo-ai/agenc-releases",
-  "releaseTag": "agenc-v0.6.0",
-  "artifacts": [
-    {
-      "platform": "darwin",
-      "arch": "arm64",
-      "runtimeVersion": "0.6.0",
-      "url": "https://github.com/tetsuo-ai/agenc-releases/releases/download/agenc-v0.6.0/agenc-runtime-0.6.0-darwin-arm64.tar.gz",
-      "sha256": "6f75ee2cb44deece56a6ae3185b86b256b56fae2ebb944e45120a203cf5b4eea",
-      "bytes": 82107008,
-      "bins": {
-        "agenc": "node_modules/@tetsuo-ai/runtime/bin/agenc"
-      }
-    },
-    {
-      "platform": "darwin",
-      "arch": "x64",
-      "runtimeVersion": "0.6.0",
-      "url": "https://github.com/tetsuo-ai/agenc-releases/releases/download/agenc-v0.6.0/agenc-runtime-0.6.0-darwin-x64.tar.gz",
-      "sha256": "ac47bfc9277186992318b3a303a2a06fc694560d02439f82a9e730cee3048419",
-      "bytes": 82900964,
-      "bins": {
-        "agenc": "node_modules/@tetsuo-ai/runtime/bin/agenc"
-      }
-    },
-    {
-      "platform": "linux",
-      "arch": "arm64",
-      "runtimeVersion": "0.6.0",
-      "url": "https://github.com/tetsuo-ai/agenc-releases/releases/download/agenc-v0.6.0/agenc-runtime-0.6.0-linux-arm64.tar.gz",
-      "sha256": "55e5c0325413278d75ea05777cee68a6bdd7cba79900ea61e6dcd44967a73895",
-      "bytes": 82494984,
-      "bins": {
-        "agenc": "node_modules/@tetsuo-ai/runtime/bin/agenc"
-      }
-    },
-    {
-      "platform": "linux",
-      "arch": "x64",
-      "runtimeVersion": "0.6.0",
-      "url": "https://github.com/tetsuo-ai/agenc-releases/releases/download/agenc-v0.6.0/agenc-runtime-0.6.0-linux-x64.tar.gz",
-      "sha256": "d5f460e16c1159443fbd6646b7aff0c6b281f78c72848495695a9d6e75a8bb7e",
-      "bytes": 82510381,
-      "bins": {
-        "agenc": "node_modules/@tetsuo-ai/runtime/bin/agenc"
-      }
-    },
-    {
-      "platform": "win",
-      "arch": "x64",
-      "runtimeVersion": "0.6.0",
-      "url": "https://github.com/tetsuo-ai/agenc-releases/releases/download/agenc-v0.6.0/agenc-runtime-0.6.0-win-x64.tar.gz",
-      "sha256": "3f8481fd545fe4ab04bebf09a13729319a9a7dfef6c31fb35aa3a72e19d45036",
-      "bytes": 81864491,
-      "bins": {
-        "agenc": "node_modules/@tetsuo-ai/runtime/bin/agenc"
-      }
-    }
-  ]
-}

package/scripts/build-runtime-tarball.mjs

@@ -1,201 +0,0 @@
-#!/usr/bin/env node
-// Build a self-contained, per-platform runtime artifact for GitHub Releases.
-//
-// The runtime (@tetsuo-ai/runtime) is NOT published to npm — it ships as a
-// platform-specific tarball because it pulls native deps (better-sqlite3,
-// node-pty) that must be compiled for the host OS/arch. This script produces
-// one such artifact for the CURRENT platform; the release CI matrix runs it on
-// each target runner.
-//
-// Output layout (what the install-side runtime-manager extracts verbatim into
-// ~/.agenc/runtime/<version>/):
-//
-//   node_modules/@tetsuo-ai/runtime/{bin,dist,package.json,README.md}
-//   node_modules/<every production dep, natively built for this platform>/...
-//
-// So the runtime entry after extraction is:
-//   <root>/node_modules/@tetsuo-ai/runtime/bin/agenc
-//
-// Steps: build runtime → `npm pack` it (respects its `files`) → `npm install`
-// that tarball with --omit=dev into a staging dir (resolves the prod dep tree
-// and compiles native modules for THIS platform) → tar the resulting
-// node_modules → emit sha256. Pure npm; no hand-rolled dependency resolution.
-
-import { spawnSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { existsSync, mkdtempSync, readFileSync, rmSync, mkdirSync, statSync, writeFileSync } from "node:fs";
-import { createReadStream } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const launcherDir = resolve(__dirname, "..");
-const repoRoot = resolve(launcherDir, "..", "..");
-const runtimeDir = join(repoRoot, "runtime");
-
-// On Windows, npm/tar-style launchers are .cmd shims that spawnSync cannot
-// exec directly (ENOENT surfaces as a null status — exactly the CI matrix
-// failure mode). `shell: true` resolves them through cmd.exe; argv here is
-// always static, never user input.
-const IS_WINDOWS = process.platform === "win32";
-
-function run(cmd, args, opts = {}) {
-  const res = spawnSync(cmd, args, {
-    stdio: "inherit",
-    shell: IS_WINDOWS,
-    ...opts,
-  });
-  if (res.status !== 0) {
-    throw new Error(
-      `command failed (${res.status ?? res.signal}): ${cmd} ${args.join(" ")}`,
-    );
-  }
-  return res;
-}
-
-function capture(cmd, args, opts = {}) {
-  const res = spawnSync(cmd, args, {
-    encoding: "utf8",
-    shell: IS_WINDOWS,
-    ...opts,
-  });
-  if (res.status !== 0) {
-    throw new Error(
-      `command failed (${res.status ?? res.signal}): ${cmd} ${args.join(" ")}\n${res.stderr ?? ""}`,
-    );
-  }
-  return res.stdout.trim();
-}
-
-// node platform/arch → the artifact slug used in filenames + the manifest.
-function platformSlug() {
-  const os = process.platform === "win32" ? "win" : process.platform; // linux | darwin | win
-  const arch = process.arch; // x64 | arm64
-  return { os, arch, slug: `${os}-${arch}` };
-}
-
-function sha256(file) {
-  return new Promise((resolveHash, reject) => {
-    const hash = createHash("sha256");
-    const stream = createReadStream(file);
-    stream.on("error", reject);
-    stream.on("data", (chunk) => hash.update(chunk));
-    stream.on("end", () => resolveHash(hash.digest("hex")));
-  });
-}
-
-async function main() {
-  const runtimePkg = JSON.parse(
-    readFileSync(join(runtimeDir, "package.json"), "utf8"),
-  );
-  const version = runtimePkg.version;
-  const { os, arch, slug } = platformSlug();
-
-  const outDir = resolve(
-    process.env.AGENC_RELEASE_OUT_DIR ?? join(launcherDir, "release-artifacts"),
-  );
-  mkdirSync(outDir, { recursive: true });
-
-  const stage = mkdtempSync(join(tmpdir(), "agenc-runtime-build-"));
-  try {
-    // 1. Build the runtime (produces dist/).
-    console.error(`[build] runtime ${version} (${slug})`);
-    run("npm", ["run", "build"], { cwd: runtimeDir });
-
-    // 2. Pack the runtime package into a tgz (honors runtime's `files`).
-    const packed = capture(
-      "npm",
-      ["pack", "--silent", "--pack-destination", stage],
-      { cwd: runtimeDir },
-    )
-      .split("\n")
-      .map((l) => l.trim())
-      .filter(Boolean)
-      .pop();
-    const runtimeTgz = join(stage, packed);
-
-    // 3. Install the packed runtime + its PROD deps into the staging dir,
-    //    compiling native modules for THIS platform.
-    const installRoot = join(stage, "install");
-    mkdirSync(installRoot, { recursive: true });
-    // A bare package.json so npm installs into install/node_modules.
-    // (Written in-process: a `node -e` child with embedded quotes breaks
-    // under the Windows shell resolution above.)
-    writeFileSync(
-      join(installRoot, "package.json"),
-      JSON.stringify({
-        name: "agenc-runtime-bundle",
-        private: true,
-        version: "0.0.0",
-      }),
-    );
-    run(
-      "npm",
-      [
-        "install",
-        runtimeTgz,
-        "--omit=dev",
-        "--no-audit",
-        "--no-fund",
-        "--install-strategy=hoisted",
-      ],
-      { cwd: installRoot },
-    );
-
-    const nodeModules = join(installRoot, "node_modules");
-    const runtimeEntry = join(
-      nodeModules,
-      "@tetsuo-ai",
-      "runtime",
-      "bin",
-      "agenc",
-    );
-    statSync(runtimeEntry); // hard-fail if the layout isn't what we promise
-
-    // 4. Tar node_modules into the release artifact.
-    const artifactName = `agenc-runtime-${version}-${slug}.tar.gz`;
-    const artifactPath = join(outDir, artifactName);
-    // Windows: bash-on-PATH resolves `tar` to GNU tar, which parses drive
-    // letters (D:\...) as remote hosts ("Cannot connect to D:"). The system
-    // bsdtar handles Windows paths natively — use it explicitly.
-    const tarBin =
-      IS_WINDOWS && existsSync("C:\\Windows\\System32\\tar.exe")
-        ? "C:\\Windows\\System32\\tar.exe"
-        : "tar";
-    run(tarBin, ["-czf", artifactPath, "-C", installRoot, "node_modules"]);
-
-    // 5. Hash + report.
-    const digest = await sha256(artifactPath);
-    const size = statSync(artifactPath).size;
-    const meta = {
-      platform: os,
-      arch,
-      runtimeVersion: version,
-      artifact: artifactName,
-      sha256: digest,
-      bytes: size,
-      bins: {
-        agenc: "node_modules/@tetsuo-ai/runtime/bin/agenc",
-      },
-    };
-    // Sidecar meta so gen-manifest.mjs can assemble the manifest by globbing
-    // release-artifacts/ across the CI matrix's downloaded artifacts.
-    writeFileSync(
-      join(outDir, `${artifactName}.meta.json`),
-      JSON.stringify(meta, null, 2),
-    );
-    // Machine-readable line for CI; human summary on stderr.
-    process.stdout.write(JSON.stringify(meta) + "\n");
-    console.error(
-      `[build] wrote ${artifactPath} (${(size / 1e6).toFixed(1)} MB)\n[build] sha256 ${digest}`,
-    );
-  } finally {
-    rmSync(stage, { recursive: true, force: true });
-  }
-}
-
-main().catch((err) => {
-  console.error(`[build] FAILED: ${err?.stack ?? err}`);
-  process.exitCode = 1;
-});

package/scripts/gen-manifest.mjs

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-// Assemble generated/agenc-runtime-manifest.json from the per-platform sidecar
-// meta files (release-artifacts/*.meta.json) produced by build-runtime-tarball.
-//
-// In CI the matrix builds each platform on its own runner, uploads the tarball +
-// .meta.json as workflow artifacts; this step runs after they're all collected,
-// then the manifest is committed into the npm launcher before publish.
-//
-// Usage:
-//   node scripts/gen-manifest.mjs --repo tetsuo-ai/agenc-releases --tag agenc-v0.2.0
-//   [--artifacts <dir>]   (default: packages/agenc/release-artifacts)
-//   [--base-url <url>]    (override; default: GitHub Releases download URL)
-
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const launcherDir = resolve(__dirname, "..");
-
-function arg(name, fallback) {
-  const i = process.argv.indexOf(`--${name}`);
-  return i !== -1 && i + 1 < process.argv.length ? process.argv[i + 1] : fallback;
-}
-
-const repo = arg("repo", "tetsuo-ai/agenc-releases");
-const tag = arg("tag");
-const artifactsDir = resolve(
-  arg("artifacts", join(launcherDir, "release-artifacts")),
-);
-const baseUrl =
-  arg("base-url") ??
-  (tag ? `https://github.com/${repo}/releases/download/${tag}` : undefined);
-
-if (!tag) {
-  console.error("gen-manifest: --tag is required (e.g. agenc-v0.2.0)");
-  process.exit(1);
-}
-if (!existsSync(artifactsDir)) {
-  console.error(`gen-manifest: artifacts dir not found: ${artifactsDir}`);
-  process.exit(1);
-}
-
-const metas = readdirSync(artifactsDir)
-  .filter((f) => f.endsWith(".meta.json"))
-  .map((f) => JSON.parse(readFileSync(join(artifactsDir, f), "utf8")));
-
-if (metas.length === 0) {
-  console.error(`gen-manifest: no *.meta.json in ${artifactsDir}`);
-  process.exit(1);
-}
-
-const versions = [...new Set(metas.map((m) => m.runtimeVersion))];
-if (versions.length !== 1) {
-  console.error(`gen-manifest: mixed runtime versions: ${versions.join(", ")}`);
-  process.exit(1);
-}
-
-const manifest = {
-  manifestVersion: 1,
-  runtimeVersion: versions[0],
-  releaseRepository: repo,
-  releaseTag: tag,
-  artifacts: metas
-    .map((m) => ({
-      platform: m.platform,
-      arch: m.arch,
-      runtimeVersion: m.runtimeVersion,
-      url: `${baseUrl}/${m.artifact}`,
-      sha256: m.sha256,
-      bytes: m.bytes,
-      bins: m.bins,
-    }))
-    .sort((a, b) => `${a.platform}-${a.arch}`.localeCompare(`${b.platform}-${b.arch}`)),
-};
-
-const outDir = join(launcherDir, "generated");
-mkdirSync(outDir, { recursive: true });
-const outPath = join(outDir, "agenc-runtime-manifest.json");
-writeFileSync(outPath, JSON.stringify(manifest, null, 2) + "\n");
-console.error(
-  `gen-manifest: wrote ${outPath} (${manifest.artifacts.length} platform(s): ${manifest.artifacts
-    .map((a) => `${a.platform}-${a.arch}`)
-    .join(", ")})`,
-);