agenticros 0.2.4 → 0.3.0

package/README.md

@@ -56,6 +56,10 @@ Three ways, listed easiest first:
 | `agenticros status` | Snapshot of running components + last mode. |
 | `agenticros logs [target]` | Tail `camera` / `mcp` / `sim` / `rosbridge` / `gateway`. |
 | `agenticros config [show\|set\|edit\|reset]` | Read or edit `~/.agenticros/config.json`. |
+| `agenticros create-skill <slug>` | Scaffold a new skill package in cwd. |
+| `agenticros publish` | Publish skill in cwd to skills.agenticros.com. |
+| `agenticros skills dev` | Local skill dev harness (`npm run dev` in skill repos). |
+| `agenticros skills install <owner/skill>` | Install from the marketplace. |
 | `agenticros --help` | Full help text. |
 
 ## How `init` works

package/dist/__tests__/skill-scaffold.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-scaffold.test.d.ts.map

package/dist/__tests__/skill-scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scaffold.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/skill-scaffold.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/skill-scaffold.test.js

@@ -0,0 +1,80 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { normalizeSkillSlug, normalizeTemplate, scaffoldSkill, slugToToolName, hashSkillSource, } from "../util/skill-scaffold.js";
+import { isValidSlug, parseMarketplaceRef, validateManifest, ManifestError, marketplaceRef, firestoreDocId, } from "../util/skill-manifest.js";
+import { mkdtempSync, rmSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+describe("skill-scaffold", () => {
+    it("normalizes slugs", () => {
+        assert.equal(normalizeSkillSlug("Hello-World"), "hello-world");
+        assert.equal(slugToToolName("hello-world"), "hello_world");
+    });
+    it("rejects invalid slugs", () => {
+        assert.throws(() => normalizeSkillSlug("a"), /kebab-case/);
+    });
+    it("normalizes templates", () => {
+        assert.equal(normalizeTemplate("robot"), "robot");
+        assert.throws(() => normalizeTemplate("invalid"));
+    });
+    it("scaffolds hello template into temp dir", () => {
+        const parent = mkdtempSync(join(tmpdir(), "agenticros-skill-"));
+        try {
+            const result = scaffoldSkill({
+                slug: "test-hello",
+                template: "hello",
+                cwd: parent,
+            });
+            assert.equal(result.slug, "test-hello");
+            assert.ok(existsSync(join(result.dir, "package.json")));
+            assert.ok(existsSync(join(result.dir, "src", "index.ts")));
+            assert.ok(existsSync(join(result.dir, "demo.md")));
+        }
+        finally {
+            rmSync(parent, { recursive: true, force: true });
+        }
+    });
+    it("hashes source consistently", () => {
+        const a = hashSkillSource("hello\nworld");
+        const b = hashSkillSource("hello world");
+        assert.equal(a, b);
+    });
+});
+describe("skill-manifest", () => {
+    it("validates minimal manifest", () => {
+        const { block, warnings } = validateManifest({
+            name: "agenticros-skill-x",
+            version: "0.1.0",
+            main: "dist/index.js",
+            agenticros: {
+                id: "test-skill",
+                capabilities: [{ id: "t", verb: "run", description: "d" }],
+            },
+        });
+        assert.equal(block.id, "test-skill");
+        assert.ok(warnings.length > 0);
+    });
+    it("rejects missing agenticros block", () => {
+        assert.throws(() => validateManifest({
+            name: "x",
+            version: "0.1.0",
+            main: "dist/index.js",
+        }), ManifestError);
+    });
+    it("parses marketplace refs", () => {
+        assert.deepEqual(parseMarketplaceRef("chrismatthieu/follow-me"), {
+            owner: "chrismatthieu",
+            skill: "follow-me",
+        });
+        assert.equal(parseMarketplaceRef("bad"), null);
+    });
+    it("builds firestore doc ids", () => {
+        assert.equal(firestoreDocId("Chris", "follow-me"), "chris__follow-me");
+        assert.equal(marketplaceRef("chris", "follow-me"), "chris/follow-me");
+    });
+    it("validates slug shape", () => {
+        assert.ok(isValidSlug("hello-world"));
+        assert.ok(!isValidSlug("Hello"));
+    });
+});
+//# sourceMappingURL=skill-scaffold.test.js.map

package/dist/__tests__/skill-scaffold.test.js.map

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

package/dist/commands/create-skill.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agenticros create-skill <slug>` — scaffold a new skill package in cwd.
+ */
+export interface CreateSkillOptions {
+    slug: string;
+    template?: string;
+}
+export declare function createSkillCommand(opts: CreateSkillOptions): Promise<void>;
+//# sourceMappingURL=create-skill.d.ts.map

package/dist/commands/create-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.d.ts","sourceRoot":"","sources":["../../src/commands/create-skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoChF"}

package/dist/commands/create-skill.js

@@ -0,0 +1,41 @@
+/**
+ * `agenticros create-skill <slug>` — scaffold a new skill package in cwd.
+ */
+import { basename } from "node:path";
+import { scaffoldSkill } from "../util/skill-scaffold.js";
+import { dim, err, header, info, ok } from "../util/logger.js";
+export async function createSkillCommand(opts) {
+    if (!opts.slug?.trim()) {
+        err("Usage: agenticros create-skill <slug> [--template hello|robot|camera|depth]");
+        process.exit(1);
+    }
+    header("Creating skill");
+    let result;
+    try {
+        result = scaffoldSkill({ slug: opts.slug, template: opts.template });
+    }
+    catch (e) {
+        err(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    ok(`Creating skill ${result.slug}`);
+    const dirName = basename(result.dir);
+    info("");
+    info("Skill created:");
+    info("");
+    info(`  ${dirName}/`);
+    info("    src/index.ts");
+    info("    package.json");
+    info("    README.md");
+    info("    demo.md");
+    info("    docs/icon.png");
+    info("");
+    info("Next steps:");
+    info("");
+    info(`  cd ${dirName}`);
+    info("  npm install");
+    info("  npm run dev");
+    info("");
+    dim(`Template: ${result.template}  |  Tool: ${result.toolName}`);
+}
+//# sourceMappingURL=create-skill.js.map

package/dist/commands/create-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.js","sourceRoot":"","sources":["../../src/commands/create-skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAU,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAOvE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAwB;IAC/D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACvB,GAAG,CAAC,6EAA6E,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAEzB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,EAAE,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzB,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzB,IAAI,CAAC,eAAe,CAAC,CAAC;IACtB,IAAI,CAAC,aAAa,CAAC,CAAC;IACpB,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,aAAa,CAAC,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,eAAe,CAAC,CAAC;IACtB,IAAI,CAAC,eAAe,CAAC,CAAC;IACtB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/commands/publish-skill.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `agenticros publish` — validate, push to GitHub, submit to skills marketplace.
+ */
+export interface PublishSkillOptions {
+    graduate?: boolean;
+    cwd?: string;
+    yes?: boolean;
+}
+export declare function publishSkillCommand(opts: PublishSkillOptions): Promise<void>;
+//# sourceMappingURL=publish-skill.d.ts.map

package/dist/commands/publish-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-skill.d.ts","sourceRoot":"","sources":["../../src/commands/publish-skill.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmCH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAyFD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+HlF"}

package/dist/commands/publish-skill.js

@@ -0,0 +1,222 @@
+/**
+ * `agenticros publish` — validate, push to GitHub, submit to skills marketplace.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { checkbox, confirm, input } from "@inquirer/prompts";
+import { execa } from "execa";
+import { skillsDevCommand } from "./skills-dev.js";
+import { isUnmodifiedTemplate, readSkillIndexSource, } from "../util/skill-scaffold.js";
+import { validateManifest, } from "../util/skill-manifest.js";
+import { apiBase, submitSkillToMarketplace, validateSkillOnMarketplace, } from "../util/marketplace.js";
+import { colors, err, header, info, ok, warn } from "../util/logger.js";
+const MARKETPLACE_CATEGORIES = [
+    "navigation",
+    "vision",
+    "human-interaction",
+    "manipulation",
+    "search",
+    "audio",
+    "communication",
+    "telemetry",
+];
+async function getGithubToken() {
+    const env = process.env.GH_TOKEN || process.env.GITHUB_TOKEN;
+    if (env?.trim())
+        return env.trim();
+    try {
+        const { stdout } = await execa("gh", ["auth", "token"], { reject: false });
+        const t = stdout.trim();
+        return t || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function getGithubLogin(token) {
+    const res = await fetch("https://api.github.com/user", {
+        headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: "application/vnd.github+json",
+            "User-Agent": "agenticros-cli",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub auth failed (${res.status}). Run: gh auth login -s public_repo`);
+    }
+    const data = (await res.json());
+    if (!data.login)
+        throw new Error("Could not read GitHub login from token.");
+    return data.login;
+}
+function readSkillPackage(cwd) {
+    const path = join(cwd, "package.json");
+    if (!existsSync(path)) {
+        throw new Error("No package.json in current directory. Run from your skill root.");
+    }
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+function writeSkillPackage(cwd, manifest) {
+    writeFileSync(join(cwd, "package.json"), `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+function detectTemplate(manifest) {
+    if (manifest.agenticros?.tutorial === true)
+        return "hello";
+    const source = readSkillIndexSource(process.cwd());
+    if (!source)
+        return null;
+    for (const t of ["hello", "robot", "camera", "depth"]) {
+        if (isUnmodifiedTemplate(source, t))
+            return t;
+    }
+    return null;
+}
+async function ensureGitRemote(cwd, slug) {
+    try {
+        const { stdout } = await execa("git", ["remote", "get-url", "origin"], { cwd });
+        const url = stdout.trim();
+        if (url)
+            return normalizeGithubUrl(url);
+    }
+    catch {
+        // no remote
+    }
+    const token = await getGithubToken();
+    if (!token) {
+        throw new Error("No git remote origin. Create a GitHub repo and run:\n" +
+            `  gh repo create agenticros-skill-${slug} --public --source=. --remote=origin --push`);
+    }
+    const login = await getGithubLogin(token);
+    const repoName = `agenticros-skill-${slug}`;
+    info(`Creating GitHub repo ${login}/${repoName}…`);
+    await execa("gh", ["repo", "create", repoName, "--public", "--source=.", "--remote=origin", "--push"], { cwd, stdio: "inherit" });
+    const { stdout } = await execa("git", ["remote", "get-url", "origin"], { cwd });
+    return normalizeGithubUrl(stdout.trim());
+}
+function normalizeGithubUrl(url) {
+    let u = url.replace(/\.git$/, "");
+    if (u.startsWith("git@github.com:")) {
+        u = `https://github.com/${u.slice("git@github.com:".length)}`;
+    }
+    return u;
+}
+export async function publishSkillCommand(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    header("Publish skill to marketplace");
+    let manifest = readSkillPackage(cwd);
+    const { block, warnings } = validateManifest(manifest);
+    if (block.tutorial === true && !opts.graduate) {
+        err("This is a tutorial skill (agenticros.tutorial: true). " +
+            "Customize src/index.ts and run with --graduate to publish to the public catalog, " +
+            "or use --template robot|camera|depth for a publish-ready skill.");
+        process.exit(1);
+    }
+    const source = readSkillIndexSource(cwd);
+    const detectedTemplate = detectTemplate(manifest);
+    if (opts.graduate) {
+        if (!source || (detectedTemplate && isUnmodifiedTemplate(source, detectedTemplate))) {
+            err("Source still matches the default template. Customize src/index.ts before --graduate.");
+            process.exit(1);
+        }
+        const yes = await confirm({
+            message: "Remove tutorial flag and publish to the public catalog?",
+            default: false,
+        });
+        if (!yes) {
+            info("Publish cancelled.");
+            return;
+        }
+        if (manifest.agenticros) {
+            manifest.agenticros.tutorial = false;
+            writeSkillPackage(cwd, manifest);
+        }
+    }
+    try {
+        await execa("npm", ["run", "build"], { cwd, stdio: "inherit" });
+    }
+    catch {
+        err("Build failed.");
+        process.exit(1);
+    }
+    try {
+        await skillsDevCommand({ cwd, live: false });
+    }
+    catch {
+        // skillsDevCommand exits on failure
+        return;
+    }
+    if (!opts.yes) {
+        if (!block.description) {
+            const description = await input({
+                message: "Description (one sentence):",
+                validate: (v) => v.trim().length > 0 || "Required",
+            });
+            manifest.agenticros = { ...block, description: description.trim() };
+            manifest.description = description.trim();
+            writeSkillPackage(cwd, manifest);
+        }
+        if (!block.categories || block.categories.length === 0) {
+            const categories = await checkbox({
+                message: "Categories:",
+                choices: MARKETPLACE_CATEGORIES.map((c) => ({ name: c, value: c })),
+            });
+            manifest.agenticros = {
+                ...(manifest.agenticros ?? block),
+                categories,
+            };
+            writeSkillPackage(cwd, manifest);
+        }
+    }
+    manifest = readSkillPackage(cwd);
+    const remoteUrl = await ensureGitRemote(cwd, block.id);
+    try {
+        await execa("git", ["add", "-A"], { cwd });
+        const { stdout: status } = await execa("git", ["status", "--porcelain"], { cwd });
+        if (status.trim()) {
+            await execa("git", ["commit", "-m", `chore: prepare ${block.id} for marketplace`], {
+                cwd,
+                stdio: "inherit",
+            });
+        }
+        await execa("git", ["push", "-u", "origin", "HEAD"], { cwd, stdio: "inherit" });
+    }
+    catch (e) {
+        warn(`Git push issue: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const remoteValidation = await validateSkillOnMarketplace(manifest);
+    if (!remoteValidation.ok) {
+        for (const e of remoteValidation.errors)
+            err(e);
+        process.exit(1);
+    }
+    for (const w of [...warnings, ...remoteValidation.warnings]) {
+        warn(w);
+    }
+    const token = await getGithubToken();
+    if (!token) {
+        err("GitHub token required. Run: gh auth login -s public_repo");
+        info(`Or submit manually: ${apiBase().replace("/api", "")}/submit`);
+        process.exit(1);
+    }
+    const login = await getGithubLogin(token);
+    let result;
+    try {
+        result = await submitSkillToMarketplace({ githubUrl: remoteUrl, githubAccessToken: token });
+    }
+    catch (e) {
+        err(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    const ref = result.marketplaceRef ?? `${login}/${block.id}`;
+    const site = apiBase().replace(/\/api$/, "");
+    ok("Published to skills.agenticros.com");
+    info(`  ${site}/${ref}`);
+    info(`  Profile: ${site}/${login}`);
+    info("");
+    info(`Install: ${colors.bold(`npx agenticros skills install ${ref}`)}`);
+    if (result.warnings?.length) {
+        for (const w of result.warnings)
+            warn(w);
+    }
+}
+//# sourceMappingURL=publish-skill.js.map

package/dist/commands/publish-skill.js.map

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

package/dist/commands/skills-dev.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `agenticros skills dev` — load a skill locally without the OpenClaw gateway.
+ */
+export interface SkillsDevOptions {
+    invoke?: string;
+    watch?: boolean;
+    live?: boolean;
+    cwd?: string;
+}
+export declare function skillsDevCommand(opts: SkillsDevOptions): Promise<void>;
+//# sourceMappingURL=skills-dev.d.ts.map

package/dist/commands/skills-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-dev.d.ts","sourceRoot":"","sources":["../../src/commands/skills-dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAyGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D5E"}

package/dist/commands/skills-dev.js

@@ -0,0 +1,154 @@
+/**
+ * `agenticros skills dev` — load a skill locally without the OpenClaw gateway.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+import { execa } from "execa";
+import { validateManifest } from "../util/skill-manifest.js";
+import { err, ok, info, warn } from "../util/logger.js";
+function readPackageJson(dir) {
+    const path = join(dir, "package.json");
+    if (!existsSync(path)) {
+        throw new Error("No package.json in current directory. Run from your skill root.");
+    }
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+function stubContext(live) {
+    const noopTransport = {
+        async publish() { },
+        async subscribeOnce() {
+            return null;
+        },
+        async listTopics() {
+            return [];
+        },
+        async callService() {
+            return null;
+        },
+        async sendActionGoal() {
+            return null;
+        },
+        async getParameter() {
+            return null;
+        },
+        async setParameter() { },
+        status: live ? "connected" : "disconnected",
+    };
+    return {
+        getTransport() {
+            if (!live) {
+                throw new Error("Transport not connected. Use --live when a gateway is running, or test tool registration only.");
+            }
+            return noopTransport;
+        },
+        async getDepthDistance() {
+            return {
+                distance_m: 0,
+                median_m: 0,
+                valid: false,
+                topic: "",
+                encoding: "",
+                width: 0,
+                height: 0,
+                sample_count: 0,
+                min_m: 0,
+                max_m: 0,
+            };
+        },
+        async getDepthSectors() {
+            return {
+                left_m: 0,
+                center_m: 0,
+                right_m: 0,
+                valid: false,
+                topic: "",
+            };
+        },
+        logger: {
+            info: (...m) => console.log("[skill]", ...m),
+            warn: (...m) => console.warn("[skill]", ...m),
+            error: (...m) => console.error("[skill]", ...m),
+            debug: () => { },
+        },
+    };
+}
+function loadRegisteredTools(entryPath, config, live) {
+    const tools = [];
+    const api = {
+        registerTool(tool) {
+            tools.push({ name: tool.name, execute: tool.execute });
+        },
+        logger: {
+            info: () => { },
+            warn: () => { },
+            error: () => { },
+            debug: () => { },
+        },
+    };
+    const require = createRequire(pathToFileURL(entryPath).href);
+    const mod = require(entryPath);
+    if (typeof mod.registerSkill !== "function") {
+        throw new Error(`${entryPath} must export registerSkill(api, config, context).`);
+    }
+    mod.registerSkill(api, config, stubContext(live));
+    return tools;
+}
+export async function skillsDevCommand(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const pkg = readPackageJson(cwd);
+    const { block } = validateManifest(pkg);
+    const skillId = block.id;
+    if (!opts.watch) {
+        try {
+            await execa("npm", ["run", "build"], { cwd, stdio: "inherit" });
+        }
+        catch {
+            err("Build failed. Fix TypeScript errors and retry.");
+            process.exit(1);
+        }
+    }
+    const main = typeof pkg.main === "string" ? pkg.main : "dist/index.js";
+    const entryPath = resolve(cwd, main);
+    if (!existsSync(entryPath)) {
+        err(`Built entry not found: ${entryPath}. Run npm run build first.`);
+        process.exit(1);
+    }
+    const agenticrosConfig = {
+        skills: { [skillId]: {} },
+        robot: {
+            cameraTopic: "camera/color/image_raw",
+            depthTopic: "depth/image_rect_raw",
+        },
+    };
+    let tools;
+    try {
+        tools = loadRegisteredTools(entryPath, agenticrosConfig, opts.live === true);
+    }
+    catch (e) {
+        err(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    ok(`Skill loaded: ${skillId}`);
+    info(`  Tools: ${tools.map((t) => t.name).join(", ") || "(none)"}`);
+    if (opts.invoke) {
+        const tool = tools.find((t) => t.name === opts.invoke);
+        if (!tool) {
+            err(`Tool not found: ${opts.invoke}`);
+            process.exit(1);
+        }
+        try {
+            const result = await tool.execute("dev", {}, undefined);
+            info(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            if (!opts.live) {
+                warn("Tool execution failed (expected without --live for robot/camera/depth tools).");
+            }
+            err(e instanceof Error ? e.message : String(e));
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=skills-dev.js.map

package/dist/commands/skills-dev.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAkCH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BtE"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsCH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCtE"}