@openape/ape-agent 2.1.0 → 2.2.0

package/default-skills/bash/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: bash
 description: When a task can't be done with the other curated tools (file.read, http.get, tasks.create, mail.list, etc.), use bash — runs any shell command on the agent host through the DDISA grant cycle.
-requires_tools: [bash]
+metadata:
+  openape:
+    requires_tools: [bash]
 ---
 
 # Shell access via ape-shell

package/default-skills/file/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: file
 description: When the user asks you to read, write, or check a file in your home directory, use the file.read / file.write tools — they're $HOME-jailed and safer than bash cat.
-requires_tools: [file.read]
+metadata:
+  openape:
+    requires_tools: [file.read]
 ---
 
 # Files in $HOME

package/default-skills/http/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: http
 description: When the user asks to fetch a webpage, hit a REST API, or POST JSON to an endpoint, use the http.get / http.post tools — never invent URLs.
-requires_tools: [http.get]
+metadata:
+  openape:
+    requires_tools: [http.get]
 ---
 
 # HTTP fetch

package/default-skills/mail/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: mail
 description: When the user asks about their inbox — what's there, search for an email, recent unread — use mail.list / mail.search.
-requires_tools: [mail.list]
+metadata:
+  openape:
+    requires_tools: [mail.list]
+  openclaw:
+    # If the o365-cli binary isn't on PATH the underlying tool fails
+    # at runtime — skip the skill from the prompt so the LLM doesn't
+    # try to use it on a host where it can't run.
+    requires:
+      bins: [o365-cli]
 ---
 
 # Inbox (o365-cli)

package/default-skills/tasks/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: tasks
 description: When the user wants to see, create, or schedule a task/reminder/wiedervorlage on their personal task list, use tasks.list / tasks.create.
-requires_tools: [tasks.list]
+metadata:
+  openape:
+    requires_tools: [tasks.list]
+  openclaw:
+    # The bash escape-hatch path uses ape-tasks; surface it as a soft
+    # dependency so on a host without ape-tasks the LLM is told this
+    # skill doesn't apply.
+    requires:
+      bins: [ape-tasks]
 ---
 
 # Personal tasks (ape-tasks)

package/default-skills/time/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: time
 description: When the user asks for the current time, date, or wants a sanity-check that the runtime is alive, use the time.now tool — never guess.
-requires_tools: [time.now]
+metadata:
+  openape:
+    requires_tools: [time.now]
 ---
 
 # Time and date

package/dist/bridge.mjs

@@ -3800,10 +3800,12 @@ function shouldAutoAccept(peerEmail, identity, allowlist) {
 }
 
 // src/skills.ts
+import { execFileSync as execFileSync3 } from "child_process";
 import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync7, statSync } from "fs";
 import { homedir as homedir8 } from "os";
 import { dirname as dirname2, join as join8, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
+import { parse as parseYaml } from "yaml";
 var SKILLS_SUBDIR = [".openape", "agent", "skills"];
 var SOUL_PATH_PARTS = [".openape", "agent", "SOUL.md"];
 function soulPath(home = homedir8()) {
@@ -3828,40 +3830,48 @@ function parseFrontmatter(content) {
   const closeIdx = trimmed.indexOf("\n---", 3);
   if (closeIdx < 0) return null;
   const fmBlock = trimmed.slice(3, closeIdx).trim();
-  const fields = {};
-  let arrayKey = null;
-  let arrayBuf = [];
-  for (const rawLine of fmBlock.split("\n")) {
-    const line = rawLine.replace(/\r$/, "");
-    if (arrayKey) {
-      const m2 = line.match(/^[\t ]*-[\t ]+(\S.*)$/);
-      if (m2) {
-        arrayBuf.push(m2[1].trim());
-        continue;
-      }
-      fields[arrayKey] = arrayBuf.join(",");
-      arrayKey = null;
-      arrayBuf = [];
-    }
-    const kv = line.match(/^([a-z_]\w*)[\t ]*:[\t ]?(.*)$/i);
-    if (!kv) continue;
-    const [, key, value] = kv;
-    if (value.trim() === "") {
-      arrayKey = key;
-      arrayBuf = [];
-      continue;
-    }
-    const inlineArray = value.match(/^\[(.*)\]$/);
-    if (inlineArray) {
-      fields[key] = inlineArray[1].split(",").map((s2) => s2.trim().replace(/^["']|["']$/g, "")).filter(Boolean).join(",");
-      continue;
+  let parsed;
+  try {
+    parsed = parseYaml(fmBlock);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  const fields = parsed;
+  const name = typeof fields.name === "string" ? fields.name.trim() : "";
+  const description = typeof fields.description === "string" ? fields.description.trim() : "";
+  if (!name || !description) return null;
+  function asStringArray(v2) {
+    if (!Array.isArray(v2)) return void 0;
+    const out = v2.map((x2) => typeof x2 === "string" ? x2.trim() : "").filter((s2) => s2.length > 0);
+    return out.length > 0 ? out : void 0;
+  }
+  const meta = fields.metadata && typeof fields.metadata === "object" && !Array.isArray(fields.metadata) ? fields.metadata : {};
+  const openapeMeta = meta.openape && typeof meta.openape === "object" && !Array.isArray(meta.openape) ? meta.openape : {};
+  const openclawMeta = meta.openclaw && typeof meta.openclaw === "object" && !Array.isArray(meta.openclaw) ? meta.openclaw : {};
+  const requiresTools = asStringArray(openapeMeta.requires_tools) ?? asStringArray(fields.requires_tools);
+  function readRequiresBins(scope) {
+    const requires = scope.requires;
+    if (requires && typeof requires === "object" && !Array.isArray(requires)) {
+      return asStringArray(requires.bins);
     }
-    fields[key] = value.trim().replace(/^["']|["']$/g, "");
+    return void 0;
+  }
+  const requiresBins = readRequiresBins(openclawMeta) ?? readRequiresBins(openapeMeta) ?? asStringArray(fields.requires_bins);
+  return { name, description, requiresTools, requiresBins };
+}
+var binCheckCache = /* @__PURE__ */ new Map();
+function hasBinaryOnPath(bin) {
+  const cached = binCheckCache.get(bin);
+  if (cached !== void 0) return cached;
+  let found = false;
+  try {
+    execFileSync3("/usr/bin/which", [bin], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+    found = true;
+  } catch {
   }
-  if (arrayKey) fields[arrayKey] = arrayBuf.join(",");
-  if (!fields.name || !fields.description) return null;
-  const requiresTools = fields.requires_tools ? fields.requires_tools.split(",").map((s2) => s2.trim()).filter(Boolean) : void 0;
-  return { name: fields.name, description: fields.description, requiresTools };
+  binCheckCache.set(bin, found);
+  return found;
 }
 function scanSkillsDir(dir) {
   if (!existsSync6(dir)) return [];
@@ -3894,7 +3904,8 @@ function scanSkillsDir(dir) {
       name: fm.name,
       description: fm.description,
       filePath: skillPath,
-      requiresTools: fm.requiresTools
+      requiresTools: fm.requiresTools,
+      requiresBins: fm.requiresBins
     });
   }
   return out;
@@ -3914,6 +3925,10 @@ function composeSkills(home, enabledTools) {
       const allPresent = s2.requiresTools.every((t2) => enabled.has(t2));
       if (!allPresent) continue;
     }
+    if (s2.requiresBins && s2.requiresBins.length > 0) {
+      const allBinsPresent = s2.requiresBins.every((b2) => hasBinaryOnPath(b2));
+      if (!allBinsPresent) continue;
+    }
     out.push(s2);
   }
   out.sort((a2, b2) => a2.name.localeCompare(b2.name));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openape/ape-agent",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "OpenApe agent runtime: per-agent process that connects to chat.openape.ai, runs the LLM loop with tools + cron tasks, and streams replies back to owners.",
   "type": "module",
   "license": "MIT",
@@ -21,6 +21,7 @@
     "jose": "^5.9.0",
     "ofetch": "^1.4.1",
     "ws": "^8.18.0",
+    "yaml": "^2.8.0",
     "@openape/apes": "1.22.0",
     "@openape/cli-auth": "0.4.0"
   },