@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/skills-commands.js

@@ -0,0 +1,187 @@
+/**
+ * synap skill — skill knowledge base commands
+ *
+ * Manage agent skills stored in the pod's agent_skills table.
+ * Skills are structured knowledge packages shared across all agents.
+ *
+ * Commands:
+ *   synap skill suggest <topic>   Search skills by topic/query
+ *   synap skill get <slug>        Fetch a single skill by slug
+ *   synap skill sync [--from]     Bulk import skills from local disk
+ */
+import chalk from "chalk";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { readFile } from "node:fs/promises";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet, hubPost } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+import ora from "ora";
+// ─── suggest ───────────────────────────────────────────────────────────────
+export async function suggestSkills(topic, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const result = await hubGet("/agent-skills", { topic, limit: 20 }, cfg);
+        const skills = unwrapList(result, ["skills"]);
+        if (skills.length === 0) {
+            log.info(`No skills found for topic "${topic}".`);
+            log.dim("Try: synap skill sync  — to import skills from ~/.claude/skills/");
+            return;
+        }
+        log.heading(`Skills matching "${topic}" (${result.total} total)`);
+        log.blank();
+        for (const s of skills) {
+            const tagStr = s.tags.length > 0 ? chalk.dim(` [${s.tags.slice(0, 3).join(", ")}${s.tags.length > 3 ? ", …" : ""}]`) : "";
+            const desc = s.description ? chalk.dim(`  ${s.description}`) : "";
+            console.log(`  ${chalk.bold(s.slug)}${tagStr}`);
+            console.log(`    ${chalk.cyan(s.name)}${desc}`);
+            const topicsStr = s.topics.length > 0 ? chalk.dim(`  topics: ${s.topics.join(", ")}`) : "";
+            if (topicsStr)
+                console.log(topicsStr);
+            console.log();
+        }
+        log.dim("To view a skill body: synap skill get <slug>");
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+// ─── get ───────────────────────────────────────────────────────────────────
+export async function getSkill(slug, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const skill = await hubGet(`/agent-skills/by-slug/${encodeURIComponent(slug)}`, {}, cfg);
+        if (!skill || !skill.slug) {
+            log.error(`Skill "${slug}" not found.`);
+            log.dim("Try: synap skill suggest <topic>  — to find available skills");
+            return;
+        }
+        log.heading(`${skill.name}  ${chalk.dim(`(${skill.slug})`)}`);
+        log.blank();
+        if (skill.description) {
+            console.log(`  ${skill.description}`);
+            log.blank();
+        }
+        if (skill.topics.length > 0) {
+            console.log(`  ${chalk.dim("topics:")} ${skill.topics.join(", ")}`);
+        }
+        if (skill.tags.length > 0) {
+            console.log(`  ${chalk.dim("tags:")} ${skill.tags.join(", ")}`);
+        }
+        if (skill.version) {
+            console.log(`  ${chalk.dim("version:")} ${skill.version}`);
+        }
+        if (skill.author) {
+            console.log(`  ${chalk.dim("author:")} ${skill.author}`);
+        }
+        log.blank();
+        // Print the skill body
+        console.log(skill.body);
+        log.blank();
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+// ─── sync ──────────────────────────────────────────────────────────────────
+/**
+ * Sync skill files from local disk into the pod's agent_skills table.
+ * Default source: ~/.claude/skills/ — each subdirectory with a SKILL.md
+ * becomes one agent_skill row. Slug = directory name.
+ */
+export async function syncSkills(opts) {
+    const skillsDir = opts.from ?? path.join(os.homedir(), ".claude", "skills");
+    if (!fs.existsSync(skillsDir)) {
+        log.error(`Skills directory not found: ${skillsDir}`);
+        log.dim("Create skill files at ~/.claude/skills/<name>/SKILL.md");
+        return;
+    }
+    const spinner = ora("Scanning skills directory...").start();
+    const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    const skillDirs = entries.filter((e) => e.isDirectory() || (e.isSymbolicLink() && fs.statSync(path.join(skillsDir, e.name)).isDirectory()));
+    if (skillDirs.length === 0) {
+        spinner.fail("No skill directories found");
+        log.dim(`Each skill needs: ${skillsDir}/<slug>/SKILL.md`);
+        return;
+    }
+    spinner.text = `Found ${skillDirs.length} skill(s)`;
+    const cfg = await resolveHubConfig(opts);
+    let imported = 0;
+    let skipped = 0;
+    let errors = 0;
+    for (const dir of skillDirs) {
+        const slug = dir.name;
+        const skillPath = path.join(skillsDir, slug, "SKILL.md");
+        const metaPath = path.join(skillsDir, slug, "meta.json");
+        if (!fs.existsSync(skillPath)) {
+            skipped++;
+            continue;
+        }
+        try {
+            const body = await readFile(skillPath, "utf-8");
+            let name = slug;
+            let description = "";
+            let topics = [];
+            let tags = [];
+            let version = "";
+            let author = "";
+            // Read optional meta.json
+            if (fs.existsSync(metaPath)) {
+                try {
+                    const meta = JSON.parse(await readFile(metaPath, "utf-8"));
+                    name = meta.name ?? slug;
+                    description = meta.description ?? "";
+                    topics = meta.topics ?? [];
+                    tags = meta.tags ?? [];
+                    version = meta.version ?? "";
+                    author = meta.author ?? "";
+                }
+                catch {
+                    // non-fatal
+                }
+            }
+            // Extract name from first heading if not from meta
+            if (name === slug) {
+                const firstLine = body.split("\n").find((l) => l.startsWith("# "));
+                if (firstLine)
+                    name = firstLine.replace(/^#\s+/, "").trim();
+            }
+            await hubPost("/agent-skills", {
+                slug,
+                name,
+                description: description || null,
+                topics,
+                body,
+                source: `file://${skillPath}`,
+                author: author || os.userInfo().username,
+                version: version || null,
+                tags,
+            }, cfg);
+            imported++;
+            spinner.text = `Imported: ${slug}`;
+        }
+        catch (e) {
+            const err = e;
+            // 409 = slug exists — skip
+            if (err.message.includes("409")) {
+                skipped++;
+                continue;
+            }
+            errors++;
+            spinner.text = `Error: ${slug} — ${err.message.slice(0, 80)}`;
+        }
+    }
+    if (errors > 0) {
+        spinner.warn(`Done: ${imported} imported, ${skipped} skipped, ${errors} errors`);
+    }
+    else {
+        spinner.succeed(`Done: ${imported} imported, ${skipped} skipped`);
+    }
+    log.blank();
+    log.dim("Try: synap skill suggest <topic>  — to search skills");
+    log.dim("     synap skill get <slug>      — to view a skill");
+}
+//# sourceMappingURL=skills-commands.js.map

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

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

package/dist/commands/skills.d.ts

@@ -0,0 +1,26 @@
+import { type BaseOpts } from "./data.js";
+export interface SkillOpts extends BaseOpts {
+    session?: string;
+    workspace?: string;
+}
+/**
+ * Gather context for a session:
+ * 1. Query /entities/recall from the pod (semantic search in pod KG)
+ * 2. Read local CLAUDE.md if it exists
+ * 3. Read .claude/kg-verify if it exists
+ * Returns a markdown context report and updates the session with it.
+ */
+export declare function gatherContext(opts: SkillOpts & {
+    session: string;
+}): Promise<void>;
+/**
+ * Run the project's type-check + test gate and store the result on the session.
+ * The AI reads CLAUDE.md to find the right commands; this function accepts them
+ * explicitly so the AI can pass exactly what to run.
+ *
+ * Usage: synap skill verify-code --session <id> --workspace <id> --cmd "pnpm type-check"
+ */
+export declare function verifyCode(opts: SkillOpts & {
+    session: string;
+    cmd?: string;
+}): Promise<void>;

package/dist/commands/skills.js

@@ -0,0 +1,196 @@
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubPatch, hubPost, renderHubError, } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+import { readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+// ─── gatherContext ────────────────────────────────────────────────────────────
+/**
+ * Gather context for a session:
+ * 1. Query /entities/recall from the pod (semantic search in pod KG)
+ * 2. Read local CLAUDE.md if it exists
+ * 3. Read .claude/kg-verify if it exists
+ * Returns a markdown context report and updates the session with it.
+ */
+export async function gatherContext(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const sessionId = opts.session;
+        if (!sessionId) {
+            console.error(chalk.red("Error: --session SESSION_ID is required"));
+            process.exit(1);
+        }
+        const workspaceId = opts.workspace || cfg.workspaceId;
+        if (!workspaceId) {
+            console.error(chalk.red("Error: --workspace is required or set active workspace with 'synap use'"));
+            process.exit(1);
+        }
+        // Phase 1: Fetch semantic recall from pod
+        let contextReport = "# Gathered Context\n\n";
+        contextReport += `**Session:** ${sessionId}\n`;
+        contextReport += `**Workspace:** ${workspaceId}\n`;
+        contextReport += `**Gathered at:** ${new Date().toISOString()}\n\n`;
+        contextReport += "## Pod Knowledge Graph\n\n";
+        try {
+            const recallRes = (await hubPost("/entities/recall", { workspaceId, limit: 10 }, cfg));
+            const entities = unwrapList(recallRes, ["entities"]);
+            if (entities.length > 0) {
+                contextReport += "### Recent Entities\n\n";
+                for (const e of entities) {
+                    const type = String(e.profileSlug ?? "unknown");
+                    contextReport += `- **${String(e.title ?? e.id)}** (${type}): ${String(e.id).slice(0, 8)}\n`;
+                }
+            }
+            else {
+                contextReport += "_(No recent entities found in pod)_\n\n";
+            }
+        }
+        catch (recallErr) {
+            contextReport += `_Note: Pod recall failed — ${recallErr.message}_\n\n`;
+        }
+        // Phase 2: Read CLAUDE.md if it exists
+        contextReport += "## Project Instructions (CLAUDE.md)\n\n";
+        const claudeMdPath = resolve(process.cwd(), "CLAUDE.md");
+        if (existsSync(claudeMdPath)) {
+            try {
+                const claudeContent = readFileSync(claudeMdPath, "utf-8");
+                const lines = claudeContent.split("\n");
+                const truncated = lines.slice(0, 50).join("\n");
+                contextReport += "```markdown\n";
+                contextReport += truncated;
+                if (lines.length > 50) {
+                    contextReport += `\n... (${lines.length - 50} more lines)\n`;
+                }
+                contextReport += "```\n\n";
+            }
+            catch (fileErr) {
+                contextReport += `_Could not read CLAUDE.md — ${fileErr.message}_\n\n`;
+            }
+        }
+        else {
+            contextReport += "_(CLAUDE.md not found in current directory)_\n\n";
+        }
+        // Phase 3: Read .claude/kg-verify if it exists
+        contextReport += "## KG Verification State (.claude/kg-verify)\n\n";
+        const kgVerifyPath = resolve(process.cwd(), ".claude", "kg-verify");
+        if (existsSync(kgVerifyPath)) {
+            try {
+                const kgVerifyContent = readFileSync(kgVerifyPath, "utf-8");
+                contextReport += "```\n";
+                contextReport += kgVerifyContent;
+                contextReport += "```\n\n";
+            }
+            catch (fileErr) {
+                contextReport += `_Could not read .claude/kg-verify — ${fileErr.message}_\n\n`;
+            }
+        }
+        else {
+            contextReport += "_(KG verification state not found)_\n\n";
+        }
+        // Phase 4: Update session with the report
+        try {
+            await hubPatch(`/focus-sessions/${sessionId}`, {
+                workspaceId,
+                contextReport,
+            }, cfg);
+        }
+        catch (patchErr) {
+            if (opts.json) {
+                console.log(JSON.stringify({
+                    success: false,
+                    error: "Failed to update session with context report",
+                    details: patchErr.message,
+                }, null, 2));
+            }
+            else {
+                console.error(chalk.yellow("⚠ Context gathered but failed to update session: " + patchErr.message));
+            }
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({
+                success: true,
+                sessionId,
+                workspaceId,
+                reportLength: contextReport.length,
+            }, null, 2));
+            return;
+        }
+        log.success(`Context gathered and session updated`);
+        log.dim(`Session: ${sessionId.slice(0, 8)}`);
+        log.dim(`Report: ${contextReport.length} bytes`);
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(1);
+    }
+}
+// ─── verifyCode ───────────────────────────────────────────────────────────────
+/**
+ * Run the project's type-check + test gate and store the result on the session.
+ * The AI reads CLAUDE.md to find the right commands; this function accepts them
+ * explicitly so the AI can pass exactly what to run.
+ *
+ * Usage: synap skill verify-code --session <id> --workspace <id> --cmd "pnpm type-check"
+ */
+export async function verifyCode(opts) {
+    const { execSync } = await import("child_process");
+    const cfg = await resolveHubConfig(opts);
+    const sessionId = opts.session;
+    if (!sessionId) {
+        console.error(chalk.red("Error: --session SESSION_ID is required"));
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace || cfg.workspaceId;
+    if (!workspaceId) {
+        console.error(chalk.red("Error: --workspace is required"));
+        process.exit(1);
+    }
+    const cmd = opts.cmd;
+    if (!cmd) {
+        console.error(chalk.red("Error: --cmd <command> is required (e.g. --cmd 'pnpm type-check')"));
+        process.exit(1);
+    }
+    const startedAt = Date.now();
+    let passed = false;
+    let output = "";
+    try {
+        output = execSync(cmd, { encoding: "utf-8", stdio: "pipe" });
+        passed = true;
+    }
+    catch (e) {
+        const err = e;
+        output = [err.stdout, err.stderr, err.message].filter(Boolean).join("\n");
+        passed = false;
+    }
+    const elapsedMs = Date.now() - startedAt;
+    const verificationReport = {
+        codeQuality: {
+            cmd,
+            passed,
+            elapsedMs,
+            output: output.slice(0, 4000),
+            ranAt: new Date().toISOString(),
+        },
+    };
+    try {
+        await hubPatch(`/focus-sessions/${sessionId}`, { workspaceId, verificationReport }, cfg);
+    }
+    catch {
+        // non-fatal — still print the result
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ passed, cmd, elapsedMs, output }, null, 2));
+        return;
+    }
+    if (passed) {
+        log.success(`Verification passed  (${elapsedMs}ms)`);
+        log.dim(`  cmd: ${cmd}`);
+    }
+    else {
+        log.warn(`Verification FAILED  (${elapsedMs}ms)`);
+        log.dim(`  cmd: ${cmd}`);
+        console.log(chalk.red(output.slice(0, 2000)));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/commands/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EACL,gBAAgB,EAEhB,QAAQ,EACR,OAAO,EACP,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAO/B,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAqC;IACvE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;QAE/B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC,CAAC;YACpG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,0CAA0C;QAC1C,IAAI,aAAa,GAAG,wBAAwB,CAAC;QAC7C,aAAa,IAAI,gBAAgB,SAAS,IAAI,CAAC;QAC/C,aAAa,IAAI,kBAAkB,WAAW,IAAI,CAAC;QACnD,aAAa,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;QAEpE,aAAa,IAAI,4BAA4B,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,CAAC,MAAM,OAAO,CAC9B,kBAAkB,EAClB,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAC1B,GAAG,CACJ,CAEA,CAAC;YACF,MAAM,QAAQ,GAAG,UAAU,CAAuD,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAE3G,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,aAAa,IAAI,yBAAyB,CAAC;gBAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC;oBAChD,aAAa,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,IAAI,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;gBAC/F,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,aAAa,IAAI,yCAAyC,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,aAAa,IAAI,8BAA+B,SAAmB,CAAC,OAAO,OAAO,CAAC;QACrF,CAAC;QAED,uCAAuC;QACvC,aAAa,IAAI,yCAAyC,CAAC;QAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBAC1D,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChD,aAAa,IAAI,eAAe,CAAC;gBACjC,aAAa,IAAI,SAAS,CAAC;gBAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;oBACtB,aAAa,IAAI,UAAU,KAAK,CAAC,MAAM,GAAG,EAAE,gBAAgB,CAAC;gBAC/D,CAAC;gBACD,aAAa,IAAI,SAAS,CAAC;YAC7B,CAAC;YAAC,OAAO,OAAO,EAAE,CAAC;gBACjB,aAAa,IAAI,+BAAgC,OAAiB,CAAC,OAAO,OAAO,CAAC;YACpF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,aAAa,IAAI,kDAAkD,CAAC;QACtE,CAAC;QAED,+CAA+C;QAC/C,aAAa,IAAI,kDAAkD,CAAC;QACpE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACpE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,eAAe,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBAC5D,aAAa,IAAI,OAAO,CAAC;gBACzB,aAAa,IAAI,eAAe,CAAC;gBACjC,aAAa,IAAI,SAAS,CAAC;YAC7B,CAAC;YAAC,OAAO,OAAO,EAAE,CAAC;gBACjB,aAAa,IAAI,uCAAwC,OAAiB,CAAC,OAAO,OAAO,CAAC;YAC5F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,aAAa,IAAI,yCAAyC,CAAC;QAC7D,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC;YACH,MAAM,QAAQ,CACZ,mBAAmB,SAAS,EAAE,EAC9B;gBACE,WAAW;gBACX,aAAa;aACd,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,QAAQ,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;oBACE,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,8CAA8C;oBACrD,OAAO,EAAG,QAAkB,CAAC,OAAO;iBACrC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,mDAAmD,GAAI,QAAkB,CAAC,OAAO,CAAC,CAChG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,WAAW;gBACX,YAAY,EAAE,aAAa,CAAC,MAAM;aACnC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,GAAG,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,YAAY,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7C,GAAG,CAAC,GAAG,CAAC,WAAW,aAAa,CAAC,MAAM,QAAQ,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,cAAc,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAmD;IAEnD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;IAE/B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC;IACtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAA2D,CAAC;QACxE,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACzC,MAAM,kBAAkB,GAAG;QACzB,WAAW,EAAE;YACX,GAAG;YACH,MAAM;YACN,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;YAC7B,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAChC;KACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CACZ,mBAAmB,SAAS,EAAE,EAC9B,EAAE,WAAW,EAAE,kBAAkB,EAAE,EACnC,GAAG,CACJ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,CAAC,OAAO,CAAC,yBAAyB,SAAS,KAAK,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,yBAAyB,SAAS,KAAK,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/status.d.ts

@@ -16,4 +16,6 @@
  *   - `docker exec openclaw openclaw skills list` (was isSynapSkillInstalledInDocker)
  * For those, the user runs `./synap health` on the pod host.
  */
-export declare function status(): Promise<void>;
+export declare function status(opts?: {
+    json?: boolean;
+}): Promise<void>;