@rynx-ai/skills 0.1.0 → 0.1.1

package/dist/artifact.js

@@ -121,14 +121,12 @@ export function parseSkillRefValue(value) {
             ...(typeof install.skill === "string" && install.skill ? { skill: install.skill } : {}),
         };
     }
-    else if (install.tool === "npx") {
-        if (typeof install.package !== "string" || !install.package.trim())
-            return null;
-        if (typeof install.version !== "string" || !install.version.trim())
+    else if (install.tool === "command") {
+        if (typeof install.command !== "string" || !install.command.trim())
             return null;
         if (!Array.isArray(install.args) || install.args.some((a) => typeof a !== "string"))
             return null;
-        recipe = { tool: "npx", package: install.package, version: install.version, args: install.args };
+        recipe = { tool: "command", command: install.command, args: install.args };
     }
     else {
         return null;

package/dist/install.d.ts

@@ -7,14 +7,16 @@ export interface InstalledSkill {
     dir: string;
     contentHash?: string;
 }
-/** Runs `npx <args>` with cwd = the temp install dir. Injectable (tests). */
-export type NpxRunner = (args: string[], opts: {
+/** Runs `command args…` with cwd = the temp install dir. Injectable (tests). */
+export type CommandRunner = (command: string, args: string[], opts: {
     cwd: string;
 }) => Promise<void>;
-/** Turn install params into the command line that performs them. Both tools
- *  produce an `npx` invocation, run with cwd = the temp install dir. */
+/** Turn install params into the `{ command, args }` that performs them, run
+ *  with cwd = the temp install dir. skills-cli shells out through npx; the
+ *  command recipe runs its executable directly. */
 export declare function buildInstallCommand(recipe: SkillInstallRecipe): {
-    npxArgs: string[];
+    command: string;
+    args: string[];
 };
 /**
  * INSTALL ONLY: run `recipe`'s install command in a throwaway temp dir and
@@ -22,7 +24,7 @@ export declare function buildInstallCommand(recipe: SkillInstallRecipe): {
  * observations come back as the return value. Throws on bad input / failure.
  */
 export declare function installFromRecipe(recipe: SkillInstallRecipe, targetDir: string, opts?: {
-    runNpx?: NpxRunner;
+    runCommand?: CommandRunner;
 }): Promise<InstalledSkill[]>;
 /** Write one skill dir's `.rynx-skill.json` v3 install-info file (catalog
  *  artifact: the payload IS the SkillRef — declaration ≡ record, literally). */
@@ -33,5 +35,5 @@ export declare function writeSkillInstallInfo(skillDir: string, ref: SkillRef):
  * content hash. Returns the installed skills' catalog metadata.
  */
 export declare function installIntoCatalog(recipe: SkillInstallRecipe, catalogRoot: string, opts?: {
-    runNpx?: NpxRunner;
+    runCommand?: CommandRunner;
 }): Promise<SkillMeta[]>;

package/dist/install.js

@@ -17,9 +17,11 @@
  *     write each produced skill an info file recording these exact params +
  *     the observed hash.
  *
- * Every install bottoms out at `npx skills add` (the npx recipe variant is a
- * self-installing proxy that runs it in its cwd), so both tools share one
- * pickup path and one hash algorithm; they differ only in the command line.
+ * Every install runs a command in a throwaway temp dir that bottoms out at
+ * `skills add` (skills-cli shells out through `npx -y skills add …`; the command
+ * recipe runs a globally-installed self-installing proxy directly), so both
+ * share one pickup path (`.agents/skills/`) and one hash algorithm; they differ
+ * only in the command line.
  */
 import { execFile } from "node:child_process";
 import { cp, mkdir, mkdtemp, readdir, readFile, rm, writeFile } from "node:fs/promises";
@@ -27,8 +29,11 @@ import { tmpdir } from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
 import { readSkillMeta, SKILL_RECEIPT_FILE } from "./artifact.js";
-const runNpxDefault = async (args, opts) => {
-    await promisify(execFile)("npx", args, { cwd: opts.cwd, timeout: 180_000 }).catch((err) => {
+const runCommandDefault = async (command, args, opts) => {
+    await promisify(execFile)(command, args, { cwd: opts.cwd, timeout: 180_000 }).catch((err) => {
+        if (err.code === "ENOENT") {
+            throw new Error(`command not found: ${command} — install it (e.g. \`npm i -g @rynx-ai/emulator\` for rynx-emulator)`);
+        }
         throw new Error(`skills install failed: ${cliErrorDetail(err)}`);
     });
 };
@@ -40,8 +45,9 @@ function assertSafeArg(label, value) {
     if (/[;&|`$()<>\x00-\x1f]/.test(value))
         throw new Error(`invalid ${label}: ${value}`);
 }
-/** Turn install params into the command line that performs them. Both tools
- *  produce an `npx` invocation, run with cwd = the temp install dir. */
+/** Turn install params into the `{ command, args }` that performs them, run
+ *  with cwd = the temp install dir. skills-cli shells out through npx; the
+ *  command recipe runs its executable directly. */
 export function buildInstallCommand(recipe) {
     if (recipe.tool === "skills-cli") {
         const src = recipe.source.trim();
@@ -63,15 +69,13 @@ export function buildInstallCommand(recipe) {
         // predictable pickup location inside the throwaway temp dir. Which agent
         // actually sees a skill is decided downstream, at materialize time.
         args.push("--full-depth", "--agent", "universal", "--copy", "--yes");
-        return { npxArgs: args };
+        return { command: "npx", args };
     }
-    const pkg = recipe.package.trim();
-    const version = recipe.version.trim();
-    if (!pkg || !version)
-        throw new Error("missing npx package/version");
-    assertSafeArg("package", pkg);
-    assertSafeArg("version", version);
-    return { npxArgs: ["-y", `${pkg}@${version}`, ...recipe.args] };
+    const command = recipe.command.trim();
+    if (!command)
+        throw new Error("missing install command");
+    assertSafeArg("command", command);
+    return { command, args: recipe.args };
 }
 /**
  * INSTALL ONLY: run `recipe`'s install command in a throwaway temp dir and
@@ -79,7 +83,8 @@ export function buildInstallCommand(recipe) {
  * observations come back as the return value. Throws on bad input / failure.
  */
 export async function installFromRecipe(recipe, targetDir, opts = {}) {
-    const staged = await execStagedInstall(buildInstallCommand(recipe).npxArgs, opts.runNpx);
+    const { command, args } = buildInstallCommand(recipe);
+    const staged = await execStagedInstall(command, args, opts.runCommand);
     try {
         if (staged.names.length === 0)
             throw new Error("no skill was installed — check the source identifier");
@@ -128,15 +133,15 @@ export async function installIntoCatalog(recipe, catalogRoot, opts = {}) {
     return metas;
 }
 /**
- * Run one `npx` command in a throwaway temp dir, list the skill folders it
+ * Run one install command in a throwaway temp dir, list the skill folders it
  * produced under `.agents/skills/`, and pick up the `skills` CLI's per-skill
  * content hashes from its `skills-lock.json`. The caller moves the folders
  * and owns the temp dir's cleanup.
  */
-async function execStagedInstall(npxArgs, runNpx = runNpxDefault) {
+async function execStagedInstall(command, args, runCommand = runCommandDefault) {
     const staging = await mkdtemp(path.join(tmpdir(), "rynx-skill-"));
     try {
-        await runNpx(npxArgs, { cwd: staging });
+        await runCommand(command, args, { cwd: staging });
     }
     catch (err) {
         await rm(staging, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynx-ai/skills",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "The rynx skill artifact domain: discover/parse on-disk skills (SKILL.md), install them from replayable recipes (everything bottoms out at `npx skills add`), and read/write the catalog's `.rynx-skill.json` install-info files. Node built-ins + @rynx-ai/protocol only.",
   "license": "MIT",
   "type": "module",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@rynx-ai/protocol": "0.1.0"
+    "@rynx-ai/protocol": "0.1.1"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json"