agenticros 0.1.11 → 0.1.13

package/dist/menu.js

@@ -13,8 +13,10 @@ import { doctorCommand, hasRedChecks } from "./commands/doctor.js";
 import { statusCommand } from "./commands/status.js";
 import { logsCommand } from "./commands/logs.js";
 import { configCommand } from "./commands/config.js";
+import { skillsCommand } from "./commands/skills.js";
 import { header, info, isTty, dim } from "./util/logger.js";
 import { readState, formatAge } from "./util/state.js";
+import { listSkills } from "./util/skills.js";
 export async function runMenu() {
     if (!isTty) {
         info("Interactive menu requires a TTY. Use a subcommand (e.g. `agenticros up real`) or `agenticros --help`.");
@@ -28,10 +30,13 @@ export async function runMenu() {
     }
     // Need-setup detection. Doctor returns a count; we use that to reorder.
     const setupNeeded = await hasRedChecks();
+    const skillsListing = safeListSkills();
+    const skillsSuffix = formatSkillsSuffix(skillsListing);
     const baseChoices = [
         { name: "Launch with real robot", value: "real" },
         { name: "Launch with simulation", value: "sim" },
         { name: "First-time setup (workspace + OpenClaw plugin + API key)", value: "init" },
+        { name: `Manage skills${skillsSuffix}`, value: "skills" },
         { name: "Stop everything", value: "down" },
         { name: "Doctor (health check)", value: "doctor" },
         { name: "Configure (API keys, namespace, transport)", value: "config" },
@@ -82,6 +87,9 @@ export async function runMenu() {
         case "config":
             await configCommand({ action: "show" });
             break;
+        case "skills":
+            await skillsSubmenu();
+            break;
         case "logs":
             await logsCommand({ target: undefined });
             break;
@@ -93,4 +101,59 @@ export async function runMenu() {
             break;
     }
 }
+/**
+ * Skills sub-menu. Reads the OpenClaw config so the prompt can show how many
+ * skills are registered and offer the right next step (discover when nothing
+ * is registered yet, otherwise list-first).
+ */
+async function skillsSubmenu() {
+    const listing = safeListSkills();
+    const hasAvailable = listing && listing.available.length > 0;
+    const hasRegistered = listing && listing.registered.length > 0;
+    const action = await select({
+        message: "Skills:",
+        choices: [
+            { name: "List registered + available", value: "list" },
+            {
+                name: hasAvailable
+                    ? `Discover & register (${listing.available.length} unregistered found)`
+                    : "Discover & register (interactive picker)",
+                value: "discover",
+            },
+            { name: "Add a skill by path or package name", value: "add" },
+            { name: "Remove a skill", value: "remove" },
+            { name: "Sync OpenClaw contracts.tools allowlist", value: "sync" },
+            { name: "Back", value: "back" },
+        ],
+        default: hasRegistered ? "list" : "discover",
+    });
+    if (action === "back")
+        return;
+    await skillsCommand({ action });
+}
+/** Read skills without throwing; the menu must keep working even if the config is broken. */
+function safeListSkills() {
+    try {
+        return listSkills();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Inline summary attached to the "Manage skills" menu label. */
+function formatSkillsSuffix(listing) {
+    if (!listing)
+        return "";
+    const parts = [];
+    if (listing.registered.length > 0) {
+        parts.push(`${listing.registered.length} registered`);
+    }
+    if (listing.available.length > 0) {
+        parts.push(`${listing.available.length} available`);
+    }
+    if (listing.brokenPaths.length > 0) {
+        parts.push(`${listing.brokenPaths.length} broken`);
+    }
+    return parts.length > 0 ? ` (${parts.join(", ")})` : "";
+}
 //# sourceMappingURL=menu.js.map

package/dist/menu.js.map

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

package/dist/util/openclaw-config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Safe read/write helper for the OpenClaw gateway config file.
+ *
+ * The OpenClaw config (default: `~/.openclaw/openclaw.json`) is the source of
+ * truth for the AgenticROS *plugin*'s skill configuration —
+ * `plugins.entries.agenticros.config.skillPaths` and `.skillPackages` decide
+ * which skill packages the plugin loads at gateway start. The MCP server and
+ * the Gemini CLI read their config from `~/.agenticros/config.json` instead;
+ * neither currently loads skills.
+ *
+ * This module exists so the rest of the CLI can mutate that nested
+ * `plugins.entries.agenticros.config` slice without round-tripping the entire
+ * JSON document or accidentally clobbering unrelated keys (gateway auth,
+ * other plugins, etc). Every write goes through the full JSON parse → mutate
+ * → stringify cycle to keep the file valid; comments are not supported in the
+ * source JSON either way.
+ */
+/** Default location of the OpenClaw config. Overridable via `$OPENCLAW_CONFIG`. */
+export declare function openclawConfigPath(): string;
+export declare function openclawConfigExists(): boolean;
+/**
+ * Read the OpenClaw config or return `undefined` if it doesn't exist / is
+ * not valid JSON. We never throw — callers can decide how loudly to fail.
+ */
+export declare function readOpenclawConfig(): Record<string, unknown> | undefined;
+/** Write the config back, pretty-printed (2-space indent), with a trailing newline. */
+export declare function writeOpenclawConfig(cfg: Record<string, unknown>): void;
+/**
+ * Locate (and lazily create) the `plugins.entries.agenticros.config` subtree.
+ * Mutates `cfg` in place and returns the inner config object so callers can
+ * read/modify its `skillPaths`, `skillPackages`, `skills`, etc.
+ */
+export declare function getAgenticrosPluginConfig(cfg: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Ensure `obj[key]` is an array of strings and return it (creating an empty
+ * array if needed). Non-string entries in an existing array are preserved so
+ * we don't silently drop opaque values, but lookups still operate on strings.
+ */
+export declare function ensureStringArray(obj: Record<string, unknown>, key: string): unknown[];
+//# sourceMappingURL=openclaw-config.d.ts.map

package/dist/util/openclaw-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-config.d.ts","sourceRoot":"","sources":["../../src/util/openclaw-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,mFAAmF;AACnF,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYxE;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAItE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK/F;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,EAAE,CAMX"}

package/dist/util/openclaw-config.js

@@ -0,0 +1,89 @@
+/**
+ * Safe read/write helper for the OpenClaw gateway config file.
+ *
+ * The OpenClaw config (default: `~/.openclaw/openclaw.json`) is the source of
+ * truth for the AgenticROS *plugin*'s skill configuration —
+ * `plugins.entries.agenticros.config.skillPaths` and `.skillPackages` decide
+ * which skill packages the plugin loads at gateway start. The MCP server and
+ * the Gemini CLI read their config from `~/.agenticros/config.json` instead;
+ * neither currently loads skills.
+ *
+ * This module exists so the rest of the CLI can mutate that nested
+ * `plugins.entries.agenticros.config` slice without round-tripping the entire
+ * JSON document or accidentally clobbering unrelated keys (gateway auth,
+ * other plugins, etc). Every write goes through the full JSON parse → mutate
+ * → stringify cycle to keep the file valid; comments are not supported in the
+ * source JSON either way.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+/** Default location of the OpenClaw config. Overridable via `$OPENCLAW_CONFIG`. */
+export function openclawConfigPath() {
+    const env = process.env["OPENCLAW_CONFIG"];
+    if (env && env.trim().length > 0)
+        return env;
+    return join(homedir(), ".openclaw", "openclaw.json");
+}
+export function openclawConfigExists() {
+    return existsSync(openclawConfigPath());
+}
+/**
+ * Read the OpenClaw config or return `undefined` if it doesn't exist / is
+ * not valid JSON. We never throw — callers can decide how loudly to fail.
+ */
+export function readOpenclawConfig() {
+    const p = openclawConfigPath();
+    if (!existsSync(p))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(p, "utf8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Write the config back, pretty-printed (2-space indent), with a trailing newline. */
+export function writeOpenclawConfig(cfg) {
+    const p = openclawConfigPath();
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, `${JSON.stringify(cfg, null, 2)}\n`);
+}
+/**
+ * Locate (and lazily create) the `plugins.entries.agenticros.config` subtree.
+ * Mutates `cfg` in place and returns the inner config object so callers can
+ * read/modify its `skillPaths`, `skillPackages`, `skills`, etc.
+ */
+export function getAgenticrosPluginConfig(cfg) {
+    const plugins = asObject(cfg, "plugins");
+    const entries = asObject(plugins, "entries");
+    const agenticros = asObject(entries, "agenticros");
+    return asObject(agenticros, "config");
+}
+function asObject(parent, key) {
+    const cur = parent[key];
+    if (cur && typeof cur === "object" && !Array.isArray(cur)) {
+        return cur;
+    }
+    const fresh = {};
+    parent[key] = fresh;
+    return fresh;
+}
+/**
+ * Ensure `obj[key]` is an array of strings and return it (creating an empty
+ * array if needed). Non-string entries in an existing array are preserved so
+ * we don't silently drop opaque values, but lookups still operate on strings.
+ */
+export function ensureStringArray(obj, key) {
+    const cur = obj[key];
+    if (Array.isArray(cur))
+        return cur;
+    const fresh = [];
+    obj[key] = fresh;
+    return fresh;
+}
+//# sourceMappingURL=openclaw-config.js.map

package/dist/util/openclaw-config.js.map

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

package/dist/util/skills.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Skill discovery, validation, and config-file mutation primitives.
+ *
+ * An AgenticROS skill is a Node package whose `package.json` carries
+ * `"agenticrosSkill": true` and exports a `registerSkill(api, config, context)`
+ * function from its `main` entry. The OpenClaw AgenticROS plugin loads them
+ * at gateway start by walking two arrays in its config:
+ *
+ *   - `skillPaths[]`     — absolute directories to scan (validate `package.json`)
+ *   - `skillPackages[]`  — npm-resolvable names (e.g. `agenticros-skill-find`)
+ *
+ * This module is the single place the CLI talks to those arrays. It also
+ * encapsulates discovery (where on disk users typically clone skill repos)
+ * and the `deriveSkillId` convention shared with `@agenticros/agenticros`'s
+ * skill-loader so menu / list output uses the same short ids the plugin
+ * surfaces (e.g. `followme`, `find`).
+ */
+export interface SkillRef {
+    /** Short id (matches what the OpenClaw plugin uses for `config.skills.<id>`). */
+    id: string;
+    /** npm package name (from `package.json.name`). */
+    packageName: string;
+    /** Absolute directory containing `package.json`, when known. */
+    dir?: string;
+    /** Where the skill is currently registered with the gateway. */
+    registeredAs: ("path" | "package")[];
+    /**
+     * Absolute path the skill's `package.json` declares as its entry (`main`),
+     * resolved against `dir`. Only set when we inspected the directory.
+     */
+    entry?: string;
+    /** True when `entry` exists on disk; false when the skill needs `pnpm build`. */
+    built?: boolean;
+}
+/**
+ * Apply the same short-id transform the OpenClaw plugin's skill-loader uses,
+ * so menu output and the plugin's `config.skills.<id>` keys line up exactly.
+ * `agenticros-skill-followme` → `followme`; scoped packages drop the scope.
+ */
+export declare function deriveSkillId(packageName: string): string;
+/**
+ * Inspect a directory and decide whether it's a valid AgenticROS skill clone.
+ * Returns a partial `SkillRef` (no `registeredAs`) or `undefined` when the
+ * directory is missing, lacks `package.json`, or doesn't opt in via the
+ * `agenticrosSkill: true` flag.
+ */
+export declare function inspectSkillDir(dir: string): Omit<SkillRef, "registeredAs"> | undefined;
+/**
+ * Return a deduped list of "places we should look for skill clones" — the
+ * directories whose children the CLI scans on `agenticros skills discover`.
+ *
+ * We include both the parent of the active repo / install dir (so siblings
+ * of `agenticros/` work, e.g. `../agenticros-skill-find`) and `$HOME` /
+ * `$HOME/Projects/` / `$HOME/Code/` so a vanilla clone-into-Projects flow
+ * is found without configuration.
+ */
+export declare function discoveryRoots(extra?: string[]): string[];
+/**
+ * Walk every directory in `roots`, returning a `SkillRef` for each child
+ * directory that passes `inspectSkillDir`. Used by both `discover` and
+ * `list` (which uses it to render orphaned-but-cloned skills).
+ */
+export declare function scanForSkills(extra?: string[]): SkillRef[];
+export interface SkillsListing {
+    /** Skills currently registered in the OpenClaw config (path-loaded or package-loaded). */
+    registered: SkillRef[];
+    /** Skill clones that exist on disk in known discovery roots but aren't registered. */
+    available: SkillRef[];
+    /** `skillPaths` entries that refer to a directory that no longer exists. */
+    brokenPaths: string[];
+}
+/**
+ * Build a snapshot of the user's current skill state: what's registered,
+ * what's available-but-not-registered, and what registrations are broken.
+ * The single source of truth for the `agenticros skills` (list) view.
+ */
+export declare function listSkills(): SkillsListing;
+export interface AddResult {
+    ok: boolean;
+    /** Human-readable summary of what changed (or why nothing changed). */
+    message: string;
+    skill?: SkillRef;
+}
+/**
+ * Add a skill to the OpenClaw plugin config by absolute directory path.
+ * Idempotent: re-adding an existing entry is a no-op and returns `ok: true`
+ * with an explanatory message. The directory must contain a valid
+ * `package.json` with `agenticrosSkill: true`.
+ */
+export declare function addSkillByPath(dir: string): AddResult;
+/**
+ * Add a skill by npm package name (must be resolvable on the gateway's
+ * Node search path). Mainly intended for skills published to a registry —
+ * for local clones, prefer `addSkillByPath` so the absolute directory is
+ * recorded.
+ */
+export declare function addSkillByPackage(name: string): AddResult;
+export interface RemoveResult {
+    ok: boolean;
+    message: string;
+    removedPaths: string[];
+    removedPackages: string[];
+}
+/**
+ * Remove every registration that matches `idOrName` — either a derived skill
+ * id (e.g. `find`), a full package name (e.g. `agenticros-skill-find`), or an
+ * absolute path that appears in `skillPaths`. Both `skillPaths` (matched by
+ * resolving each path back through `inspectSkillDir`) and `skillPackages`
+ * are cleaned in a single pass.
+ */
+export declare function removeSkill(idOrName: string): RemoveResult;
+//# sourceMappingURL=skills.d.ts.map

package/dist/util/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/util/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAgBH,MAAM,WAAW,QAAQ;IACvB,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,SAAS,CA6BvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAuB7D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,QAAQ,EAAE,CAqB9D;AA0BD,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,sFAAsF;IACtF,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,aAAa,CAyC1C;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAuCrD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA6BzD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CA+D1D"}