@senpi/runtime 1.1.0-dev.runtime-phase-2.20260512102629 → 1.1.0-dev.runtime-phase-2.20260514134437

package/dist/skills-manager/writer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Installs a skill from a cloned repo directory into the target skills
+ * directory using a crash-safe swap flow.
+ */
+import type { LoggerLike } from "./types.js";
+/**
+ * Copy a skill's subdirectory from `cloneDir` into `skillsDir/<skillName>/`,
+ * replacing the existing copy via a crash-safe swap.
+ *
+ * Strategy:
+ *  1. Validate source directory exists in the clone.
+ *  2. Write to a `.tmp-<skillName>` staging path inside `skillsDir`.
+ *  3. Move existing target to a hidden backup path (if present).
+ *  4. Move staging → target (atomic on same fs).
+ *  5. Delete the backup only after the new target is in place.
+ *
+ * This avoids destroying the previous skill copy before the new one is ready.
+ * There is still a brief window where `targetPath` may be absent, but the old
+ * content remains recoverable from the backup path until install succeeds.
+ *
+ * The `.tmp-` prefix hides the staging directory from skill discovery, which
+ * only reads immediate subdirectories of `skillsDir`.
+ *
+ * @throws When the skill subdirectory is absent in the clone.
+ * @throws When the staging copy fails.
+ */
+export declare function installSkill(cloneDir: string, skillName: string, skillsDir: string, logger?: LoggerLike): Promise<void>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/skills-manager/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/skills-manager/writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Ff"}

package/dist/skills-manager/writer.js

@@ -0,0 +1,101 @@
+/**
+ * Installs a skill from a cloned repo directory into the target skills
+ * directory using a crash-safe swap flow.
+ */
+import * as fs from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { ALLOWED_SKILLS } from "./constants.js";
+import { formatErr } from "./utils.js";
+/**
+ * Copy a skill's subdirectory from `cloneDir` into `skillsDir/<skillName>/`,
+ * replacing the existing copy via a crash-safe swap.
+ *
+ * Strategy:
+ *  1. Validate source directory exists in the clone.
+ *  2. Write to a `.tmp-<skillName>` staging path inside `skillsDir`.
+ *  3. Move existing target to a hidden backup path (if present).
+ *  4. Move staging → target (atomic on same fs).
+ *  5. Delete the backup only after the new target is in place.
+ *
+ * This avoids destroying the previous skill copy before the new one is ready.
+ * There is still a brief window where `targetPath` may be absent, but the old
+ * content remains recoverable from the backup path until install succeeds.
+ *
+ * The `.tmp-` prefix hides the staging directory from skill discovery, which
+ * only reads immediate subdirectories of `skillsDir`.
+ *
+ * @throws When the skill subdirectory is absent in the clone.
+ * @throws When the staging copy fails.
+ */
+export async function installSkill(cloneDir, skillName, skillsDir, logger) {
+    if (!ALLOWED_SKILLS.includes(skillName)) {
+        throw new Error(`Skill "${skillName}" is not in the allowed skills list: ${ALLOWED_SKILLS.join(", ")}`);
+    }
+    const sourcePath = join(cloneDir, skillName);
+    const targetPath = join(skillsDir, skillName);
+    const stagingPath = join(skillsDir, `.tmp-${skillName}`);
+    const backupPath = join(skillsDir, `.bak-${skillName}-${randomUUID()}`);
+    logger?.info(`[senpi-skills-manager] installing skill | skill=${skillName} from=${sourcePath} to=${targetPath}`);
+    // Validate source exists and is a directory
+    try {
+        const info = await fs.stat(sourcePath);
+        if (!info.isDirectory()) {
+            throw new Error(`Expected a directory at "${sourcePath}" for skill "${skillName}" but found a file`);
+        }
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`Skill "${skillName}" not found in cloned repo at "${sourcePath}"`);
+        }
+        throw err;
+    }
+    // Ensure skillsDir exists
+    await fs.mkdir(skillsDir, { recursive: true });
+    // Remove any leftover staging dir from a previous failed install
+    await fs.rm(stagingPath, { recursive: true, force: true });
+    logger?.info(`[senpi-skills-manager] cleared leftover staging dir | path=${stagingPath}`);
+    // Copy source → staging
+    logger?.info(`[senpi-skills-manager] copying skill to staging | from=${sourcePath} to=${stagingPath}`);
+    await fs.cp(sourcePath, stagingPath, { recursive: true });
+    // Move current target out of the way first so old data is recoverable on failure.
+    let movedTargetToBackup = false;
+    try {
+        await fs.rename(targetPath, backupPath);
+        movedTargetToBackup = true;
+        logger?.info(`[senpi-skills-manager] backed up existing install | from=${targetPath} to=${backupPath}`);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            throw err;
+        }
+        logger?.info(`[senpi-skills-manager] no existing install to back up | skill=${skillName}`);
+    }
+    try {
+        logger?.info(`[senpi-skills-manager] swapping staging to target | from=${stagingPath} to=${targetPath}`);
+        await fs.rename(stagingPath, targetPath);
+    }
+    catch (err) {
+        logger?.warn(`[senpi-skills-manager] swap failed, rolling back | skill=${skillName} err=${formatErr(err)}`);
+        // Remove any partial target before restoring old contents.
+        await fs.rm(targetPath, { recursive: true, force: true });
+        if (movedTargetToBackup) {
+            await fs.rename(backupPath, targetPath).catch((restoreErr) => {
+                logger?.warn(`[senpi-skills-manager] failed to restore backup after swap failure | skill=${skillName} backup=${backupPath} err=${formatErr(restoreErr)}`);
+            });
+        }
+        throw err;
+    }
+    finally {
+        // On successful rename this path no longer exists; rm is still safe with force=true.
+        await fs.rm(stagingPath, { recursive: true, force: true });
+    }
+    // Backup cleanup is best-effort once the new target is in place.
+    if (movedTargetToBackup) {
+        await fs.rm(backupPath, { recursive: true, force: true }).catch((err) => {
+            logger?.warn(`[senpi-skills-manager] failed to remove backup dir | path=${backupPath} err=${formatErr(err)}`);
+        });
+    }
+    logger?.info(`[senpi-skills-manager] skill installed successfully | skill=${skillName} path=${targetPath}`);
+}
+//# sourceMappingURL=writer.js.map

package/dist/skills-manager/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/skills-manager/writer.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -71,6 +71,33 @@
           }
         }
       },
+      "skillsManager": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Skills manager configuration. Checks the senpi-skills repo for updates to declared skills after each plugin auto-update tick and applies patch/minor updates automatically (major updates are notify-only). Cadence is inherited from `autoUpdate.pollIntervalMinutes`; this block has no independent poll interval. Omit this block to use defaults.",
+        "default": {
+          "enabled": true,
+          "skills": ["senpi-trading-runtime"]
+        },
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable or disable the skills manager (default: true)"
+          },
+          "skillsDir": {
+            "oneOf": [
+              { "type": "string" },
+              { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
+            ],
+            "description": "Directory (or directories) where managed skills are installed. Accepts a single string for one dir, or an array for a search path. With multiple, the first is the *primary* (writes go here on bootstrap/install); the rest are read-only mirrors scanned during version checks and discovery. Default: /data/.openclaw/skills. Env override: SENPI_SKILLS_DIR (comma-separated for multi-dir; use the JSON array form for paths containing commas)."
+          },
+          "skills": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Explicit skill names to manage. Omitting the field falls back to the canonical default [\"senpi-trading-runtime\"]; passing an explicit empty array [] switches to discovery mode (scan subdirs under skillsDir)."
+          }
+        }
+      },
       "api": {
         "type": "object",
         "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senpi/runtime",
-  "version": "1.1.0-dev.runtime-phase-2.20260512102629",
+  "version": "1.1.0-dev.runtime-phase-2.20260514134437",
   "description": "Senpi runtime plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",
@@ -33,6 +33,7 @@
     "@anthropic-ai/sdk": "^0.39.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@sinclair/typebox": "^0.34.0",
+    "async-retry": "^1.3.3",
     "dd-trace": "^5.99.1",
     "dotenv": "^16.4.5",
     "fastify": "^5.8.5",
@@ -44,6 +45,7 @@
     "openclaw": ">=2026.2.0"
   },
   "devDependencies": {
+    "@types/async-retry": "^1.4.9",
     "@types/node": "^22.0.0",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",