@skill-test/sdk 0.1.1 → 0.2.0

package/dist/runner.d.ts

@@ -21,6 +21,26 @@ export interface RunOptions {
     /** Working directory for the subprocess. */
     cwd?: string;
 }
+/**
+ * The optional platform package that carries the prebuilt binary for this host,
+ * e.g. `@skill-test/cli-linux-x64`. One is published per supported target and
+ * declared in `optionalDependencies`; the package manager installs only the one
+ * matching the host's `os`/`cpu`, so this name resolves to an installed package
+ * on exactly the supported platforms.
+ */
+export declare function platformPackage(): string;
+/**
+ * Absolute path to the binary bundled in the matching platform package, or
+ * `undefined` when none is installed — a source/dev checkout (the package links
+ * but ships no binary), or a platform with no published package. Callers fall
+ * back to `$SKILLTEST_BIN`/`PATH`.
+ */
+export declare function bundledBin(): string | undefined;
+/**
+ * Resolve the binary to run, most explicit first: an explicit `bin`, then
+ * `$SKILLTEST_BIN`, then the bundled platform binary, then `skilltest` on PATH.
+ */
+export declare function resolveBin(bin: string | undefined): string;
 /**
  * Run one or more test cases and return the parsed {@link Report}. A failing
  * eval is reported in `report.passed`, not thrown; only bad input

package/dist/runner.js

@@ -6,12 +6,67 @@
  * against the transcript.
  */
 import { spawn } from "node:child_process";
+import { constants, accessSync, chmodSync, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
 import { SkilltestError, SkilltestProviderError, SkilltestUsageError } from "./errors.js";
 /** Environment variables supplying defaults for the binary and provider. */
 export const ENV_BIN = "SKILLTEST_BIN";
 export const ENV_PROVIDER = "SKILLTEST_PROVIDER";
-function resolveBin(bin) {
-    return bin ?? process.env[ENV_BIN] ?? "skilltest";
+const require = createRequire(import.meta.url);
+/**
+ * The optional platform package that carries the prebuilt binary for this host,
+ * e.g. `@skill-test/cli-linux-x64`. One is published per supported target and
+ * declared in `optionalDependencies`; the package manager installs only the one
+ * matching the host's `os`/`cpu`, so this name resolves to an installed package
+ * on exactly the supported platforms.
+ */
+export function platformPackage() {
+    return `@skill-test/cli-${process.platform}-${process.arch}`;
+}
+/**
+ * Absolute path to the binary bundled in the matching platform package, or
+ * `undefined` when none is installed — a source/dev checkout (the package links
+ * but ships no binary), or a platform with no published package. Callers fall
+ * back to `$SKILLTEST_BIN`/`PATH`.
+ */
+export function bundledBin() {
+    try {
+        const pkgJson = require.resolve(`${platformPackage()}/package.json`);
+        const exe = process.platform === "win32" ? "skilltest.exe" : "skilltest";
+        const bin = join(dirname(pkgJson), "bin", exe);
+        if (!existsSync(bin))
+            return undefined;
+        ensureExecutable(bin);
+        return bin;
+    }
+    catch {
+        return undefined;
+    }
+}
+// Some packers (pnpm pack) drop the executable bit; restore it best-effort. The
+// platform packages publish via `npm` (which preserves +x), so this only matters
+// as a fallback — and a read-only install keeps the packed mode regardless.
+function ensureExecutable(bin) {
+    try {
+        accessSync(bin, constants.X_OK);
+    }
+    catch {
+        try {
+            chmodSync(bin, 0o755);
+        }
+        catch {
+            // best effort; if it is not executable and not chmod-able, the spawn fails
+            // with a clear EACCES that points at $SKILLTEST_BIN.
+        }
+    }
+}
+/**
+ * Resolve the binary to run, most explicit first: an explicit `bin`, then
+ * `$SKILLTEST_BIN`, then the bundled platform binary, then `skilltest` on PATH.
+ */
+export function resolveBin(bin) {
+    return bin ?? process.env[ENV_BIN] ?? bundledBin() ?? "skilltest";
 }
 function resolveProvider(provider) {
     const value = provider ?? process.env[ENV_PROVIDER];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skill-test/sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "TypeScript SDK for the skilltest CLI: run AI-skill tests and natural-language evals from TypeScript, with a typed report contract generated from the CLI's JSON Schemas.",
   "license": "MIT",
   "repository": {
@@ -23,6 +23,12 @@
   "files": [
     "dist"
   ],
+  "optionalDependencies": {
+    "@skill-test/cli-linux-x64": "0.1.1",
+    "@skill-test/cli-linux-arm64": "0.1.1",
+    "@skill-test/cli-darwin-x64": "0.1.1",
+    "@skill-test/cli-darwin-arm64": "0.1.1"
+  },
   "devDependencies": {
     "@types/node": "^22.7.5",
     "json-schema-to-typescript": "^15.0.4",