lonny-agent 0.2.4 → 0.2.7

package/dist/tools/install/clawhub.d.ts

@@ -0,0 +1,26 @@
+import type { ToolResult } from '../types.js';
+/** Fetch skill info from ClawHub API */
+export declare function fetchClawHubSkillInfo(slug: string): Promise<{
+    displayName: string;
+    summary: string;
+    latestVersion: string;
+} | null>;
+/** Download a ClawHub skill as a ZIP and extract its content */
+export declare function downloadClawHubSkill(slug: string, version?: string): Promise<{
+    files: Map<string, string>;
+} | null>;
+/** Extract files from a ZIP buffer */
+export declare function extractZipContent(buffer: Buffer): {
+    files: Map<string, string>;
+};
+/** Find the SKILL.md entry in the downloaded files (case-insensitive) */
+export declare function findSkillMdInZip(files: Map<string, string>): string | null;
+/** Normalize a ZIP file path, stripping common root directory */
+export declare function normalizeZipPath(filePath: string, _slug: string): string;
+/** Install a skill from ClawHub */
+export declare function installFromClawHub(cwd: string, slug: string, version: string | undefined, info: {
+    displayName: string;
+    summary: string;
+    latestVersion: string;
+}, input: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=clawhub.d.ts.map

package/dist/tools/install/clawhub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clawhub.d.ts","sourceRoot":"","sources":["../../../src/tools/install/clawhub.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,wCAAwC;AACxC,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBjF;AAED,gEAAgE;AAChE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBhD;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAYhF;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAe1E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED,mCAAmC;AACnC,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,EACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CA6GrB"}

package/dist/tools/install/clawhub.js

@@ -0,0 +1,182 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// @ts-expect-error - adm-zip has no types
+import AdmZip from 'adm-zip';
+import { fmtErr } from '../errors.js';
+import { CLAWHUB_API_BASE, SKILLS_DIR } from './constants.js';
+import { generateClawHubSkillContent, sanitizeSkillName } from './skill-content.js';
+/** Fetch skill info from ClawHub API */
+export async function fetchClawHubSkillInfo(slug) {
+    try {
+        const response = await fetch(`${CLAWHUB_API_BASE}/skills/${encodeURIComponent(slug)}`, {
+            headers: { Accept: 'application/json' },
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return {
+            displayName: data.skill?.displayName || slug,
+            summary: data.skill?.summary || '',
+            latestVersion: data.latestVersion?.version || 'latest',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Download a ClawHub skill as a ZIP and extract its content */
+export async function downloadClawHubSkill(slug, version) {
+    try {
+        const versionPath = version ? `/${version}` : '';
+        const url = `${CLAWHUB_API_BASE}/download?slug=${encodeURIComponent(slug)}${version ? `&version=${encodeURIComponent(version)}` : ''}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            // Try alternative URL patterns
+            const altUrl = `${CLAWHUB_API_BASE}/download/${encodeURIComponent(slug)}${versionPath}`;
+            const altResponse = await fetch(altUrl);
+            if (!altResponse.ok)
+                return null;
+            const buffer = await altResponse.arrayBuffer();
+            return extractZipContent(Buffer.from(buffer));
+        }
+        const buffer = await response.arrayBuffer();
+        return extractZipContent(Buffer.from(buffer));
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract files from a ZIP buffer */
+export function extractZipContent(buffer) {
+    const zip = new AdmZip(buffer);
+    const entries = zip.getEntries();
+    const files = new Map();
+    for (const entry of entries) {
+        if (!entry.isDirectory) {
+            files.set(entry.entryName, entry.getData().toString('utf-8'));
+        }
+    }
+    return { files };
+}
+/** Find the SKILL.md entry in the downloaded files (case-insensitive) */
+export function findSkillMdInZip(files) {
+    for (const [filePath] of files) {
+        const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+        if (normalized.endsWith('/skill.md')) {
+            return files.get(filePath) || null;
+        }
+    }
+    // Fallback: check root-level SKILL.md
+    for (const [filePath] of files) {
+        const normalized = filePath.replace(/\\/g, '/');
+        if (normalized.toLowerCase() === 'skill.md' || normalized.endsWith('/skill.md')) {
+            return files.get(filePath) || null;
+        }
+    }
+    return null;
+}
+/** Normalize a ZIP file path, stripping common root directory */
+export function normalizeZipPath(filePath, _slug) {
+    const normalized = filePath.replace(/\\/g, '/');
+    // Strip leading directory that matches the slug or is a common root
+    const parts = normalized.split('/');
+    if (parts.length > 1) {
+        // Remove the first segment if it's a common root
+        // ZIPs from ClawHub often have a root folder like "repo-release-notes/"
+        return parts.slice(1).join('/');
+    }
+    return normalized;
+}
+/** Install a skill from ClawHub */
+export async function installFromClawHub(cwd, slug, version, info, input) {
+    const versionToUse = version || info.latestVersion;
+    // Download the skill ZIP
+    const downloaded = await downloadClawHubSkill(slug, versionToUse);
+    if (!downloaded) {
+        return {
+            success: false,
+            output: '',
+            error: `Failed to download ClawHub skill "${slug}" (version ${versionToUse}).`,
+        };
+    }
+    const skillsDir = path.resolve(cwd, SKILLS_DIR);
+    const skillName = sanitizeSkillName(slug);
+    const skillFilePath = path.join(skillsDir, `${skillName}.md`);
+    const skillDirPath = path.join(skillsDir, skillName);
+    // Find the SKILL.md in the ZIP
+    const skillMdEntry = findSkillMdInZip(downloaded.files);
+    // Also extract supporting files into a subdirectory
+    if (skillMdEntry) {
+        // Extract all files into skill subdirectory for supporting files
+        try {
+            fs.mkdirSync(skillDirPath, { recursive: true });
+            for (const [filePath, content] of downloaded.files) {
+                // Normalize the path: strip common root directory
+                const normalizedPath = normalizeZipPath(filePath, slug);
+                if (!normalizedPath || normalizedPath === 'SKILL.md')
+                    continue; // SKILL.md goes to root
+                const fullPath = path.join(skillDirPath, normalizedPath);
+                fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+                fs.writeFileSync(fullPath, content, 'utf-8');
+            }
+        }
+        catch (err) {
+            // Non-critical: supporting files are optional
+            console.warn(`[install_skill] Warning: could not extract all supporting files: ${fmtErr(err)}`);
+        }
+        // Generate skill file (using the SKILL.md content from the ZIP)
+        const description = input.description || info.summary || slug;
+        const skillContent = generateClawHubSkillContent(slug, info.displayName, description, skillMdEntry);
+        try {
+            fs.mkdirSync(skillsDir, { recursive: true });
+            fs.writeFileSync(skillFilePath, skillContent, 'utf-8');
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Failed to write skill file: ${fmtErr(err)}`,
+            };
+        }
+    }
+    else {
+        // No SKILL.md found in ZIP, generate a wrapper skill
+        const description = input.description || info.summary || slug;
+        // Collect all extracted content as a markdown reference
+        const filesList = Array.from(downloaded.files.keys())
+            .map(f => `- ${f}`)
+            .join('\n');
+        const combinedContent = `## Files in this skill\n\n${filesList}\n\n` +
+            Array.from(downloaded.files.entries())
+                .map(([name, content]) => `### ${name}\n\n\`\`\`\n${content.slice(0, 2000)}\n\`\`\``)
+                .join('\n\n');
+        const skillContent = generateClawHubSkillContent(slug, info.displayName, description, combinedContent);
+        try {
+            fs.mkdirSync(skillsDir, { recursive: true });
+            fs.writeFileSync(skillFilePath, skillContent, 'utf-8');
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Failed to write skill file: ${fmtErr(err)}`,
+            };
+        }
+    }
+    const relPath = path.relative(cwd, skillFilePath).replace(/\\/g, '/');
+    const supportRelPath = skillMdEntry ? path.relative(cwd, skillDirPath).replace(/\\/g, '/') : '';
+    let output = `Installed ClawHub skill "${slug}" (v${versionToUse}) and created skill file "${relPath}".`;
+    if (supportRelPath) {
+        output += `\nSupporting files extracted to "${supportRelPath}/".`;
+    }
+    output += `
+
+The skill instructions will be loaded automatically on the next turn.
+
+To verify: use \`read\` on "${relPath}" to see the skill content.`;
+    return {
+        success: true,
+        output,
+    };
+}
+//# sourceMappingURL=clawhub.js.map

package/dist/tools/install/clawhub.js.map

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

package/dist/tools/install/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const SKILLS_DIR = ".lonny/skills";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org";
+export declare const CLAWHUB_API_BASE = "https://clawhub.ai/api/v1";
+export declare const CLAWHUB_SITE = "https://clawhub.ai";
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/install/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tools/install/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,kBAAkB,CAAA;AACzC,eAAO,MAAM,gBAAgB,+BAA+B,CAAA;AAC5D,eAAO,MAAM,gBAAgB,8BAA8B,CAAA;AAC3D,eAAO,MAAM,YAAY,uBAAuB,CAAA"}

package/dist/tools/install/constants.js

@@ -0,0 +1,5 @@
+export const SKILLS_DIR = '.lonny/skills';
+export const NPM_REGISTRY_URL = 'https://registry.npmjs.org';
+export const CLAWHUB_API_BASE = 'https://clawhub.ai/api/v1';
+export const CLAWHUB_SITE = 'https://clawhub.ai';
+//# sourceMappingURL=constants.js.map

package/dist/tools/install/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/install/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAA;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAA;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAA"}

package/dist/tools/install/install_skill.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '../types.js';
+export declare function createInstallSkillTool(cwd: string): Tool;
+//# sourceMappingURL=install_skill.d.ts.map

package/dist/tools/install/install_skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install_skill.d.ts","sourceRoot":"","sources":["../../../src/tools/install/install_skill.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAA;AAMnD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA4IxD"}

package/dist/tools/install/install_skill.js

@@ -0,0 +1,132 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fmtErr } from '../errors.js';
+import { fetchClawHubSkillInfo, installFromClawHub } from './clawhub.js';
+import { SKILLS_DIR } from './constants.js';
+import { fetchNpmPackageInfo, runNpmInstall } from './npm.js';
+import { extractUsageGuide, generateSkillContent, sanitizeSkillName } from './skill-content.js';
+export function createInstallSkillTool(cwd) {
+    return {
+        definition: {
+            name: 'install_skill',
+            category: 'Install',
+            group: 'Skill',
+            description: `Install an npm package or ClawHub skill. This tool:
+1. For npm packages: fetches info from npm registry, runs \`npm install\`, creates a skill file
+2. For ClawHub skills: fetches skill metadata from clawhub.ai, downloads the skill bundle, writes SKILL.md
+
+After installation, the skill will be automatically loaded on the next conversation turn (the system prompt includes active skills).
+
+Use this when you need to use a third-party npm package or install a skill from ClawHub (clawhub.ai).
+
+ClawHub skills: pass the skill slug (e.g. \`repo-release-notes\`) as package_name. The tool auto-detects ClawHub skills.`,
+            parameters: {
+                package_name: {
+                    type: 'string',
+                    description: 'The npm package name or ClawHub skill slug to install (e.g. "dayjs", "cn-time-parser", "@scope/package", or ClawHub slug like "repo-release-notes")',
+                    required: true,
+                },
+                description: {
+                    type: 'string',
+                    description: 'Optional description of what the package/skill does. If not provided, it will be fetched from the npm registry or ClawHub.',
+                    required: false,
+                },
+                usage_guide: {
+                    type: 'string',
+                    description: 'Optional custom usage guide for the AI. If not provided, it will be auto-generated from the readme or ClawHub SKILL.md. Provide this if the auto-generated guide is insufficient.',
+                    required: false,
+                },
+                clawhub: {
+                    type: 'boolean',
+                    description: "Force ClawHub mode. If true, treats package_name as a ClawHub skill slug. Auto-detected if the package doesn't exist on npm.",
+                    required: false,
+                },
+                version: {
+                    type: 'string',
+                    description: 'Optional version for ClawHub skill install (defaults to latest).',
+                    required: false,
+                },
+            },
+        },
+        async execute(input) {
+            // ── Auto-correction: if input is a string, wrap it ────────────────
+            if (typeof input === 'string') {
+                input = { package_name: input };
+            }
+            const packageName = input.package_name;
+            if (!packageName || typeof packageName !== 'string') {
+                return {
+                    success: false,
+                    output: '',
+                    error: 'package_name is required (string)',
+                };
+            }
+            const forceClawHub = input.clawhub === true;
+            const version = input.version;
+            // ── Auto-detect: try npm first, fall back to ClawHub ──────────────
+            const npmInfo = forceClawHub ? null : await fetchNpmPackageInfo(packageName);
+            // If npm lookup failed and not forced, try ClawHub
+            if (!npmInfo && !forceClawHub) {
+                const clawhubInfo = await fetchClawHubSkillInfo(packageName);
+                if (clawhubInfo) {
+                    // It's a ClawHub skill — install from ClawHub
+                    return installFromClawHub(cwd, packageName, version, clawhubInfo, input);
+                }
+                return {
+                    success: false,
+                    output: '',
+                    error: `"${packageName}" was not found on npm registry nor on ClawHub. Check the name and try again.`,
+                };
+            }
+            // If forced ClawHub mode
+            if (forceClawHub) {
+                const clawhubInfo = await fetchClawHubSkillInfo(packageName);
+                if (!clawhubInfo) {
+                    return {
+                        success: false,
+                        output: '',
+                        error: `"${packageName}" was not found on ClawHub.`,
+                    };
+                }
+                return installFromClawHub(cwd, packageName, version, clawhubInfo, input);
+            }
+            // ── npm package install path ──────────────────────────────────────
+            const description = input.description || npmInfo?.description || packageName;
+            const readme = npmInfo?.readme || '';
+            const installError = await runNpmInstall(cwd, packageName);
+            if (installError) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `npm install failed: ${installError}`,
+                };
+            }
+            const usageGuide = input.usage_guide || (readme ? extractUsageGuide(readme) : '');
+            const skillContent = generateSkillContent(packageName, description, usageGuide);
+            const skillsDir = path.resolve(cwd, SKILLS_DIR);
+            const skillName = sanitizeSkillName(packageName);
+            const skillFilePath = path.join(skillsDir, `${skillName}.md`);
+            try {
+                fs.mkdirSync(skillsDir, { recursive: true });
+                fs.writeFileSync(skillFilePath, skillContent, 'utf-8');
+            }
+            catch (err) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Failed to write skill file: ${fmtErr(err)}`,
+                };
+            }
+            const relPath = path.relative(cwd, skillFilePath).replace(/\\/g, '/');
+            return {
+                success: true,
+                output: `Installed npm package "${packageName}" and created skill "${relPath}".
+
+The package is now a project dependency. The skill file contains usage instructions for the AI and will be loaded automatically on the next turn.
+
+To verify: use \`read\` on "${relPath}" to see the skill content.`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=install_skill.js.map

package/dist/tools/install/install_skill.js.map

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

package/dist/tools/install/npm.d.ts

@@ -0,0 +1,8 @@
+/** Fetch package info from npm registry */
+export declare function fetchNpmPackageInfo(packageName: string): Promise<{
+    description: string;
+    readme: string;
+} | null>;
+/** Run npm install in the project directory */
+export declare function runNpmInstall(cwd: string, packageName: string): Promise<string | null>;
+//# sourceMappingURL=npm.d.ts.map

package/dist/tools/install/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../../src/tools/install/npm.ts"],"names":[],"mappings":"AAGA,2CAA2C;AAC3C,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkBzD;AAED,+CAA+C;AAC/C,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgC5F"}

package/dist/tools/install/npm.js

@@ -0,0 +1,52 @@
+import * as cp from 'node:child_process';
+import { NPM_REGISTRY_URL } from './constants.js';
+/** Fetch package info from npm registry */
+export async function fetchNpmPackageInfo(packageName) {
+    try {
+        const response = await fetch(`${NPM_REGISTRY_URL}/${encodeURIComponent(packageName)}`, {
+            headers: { Accept: 'application/json' },
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return {
+            description: data.description || '',
+            readme: data.readme || '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Run npm install in the project directory */
+export async function runNpmInstall(cwd, packageName) {
+    return new Promise(resolve => {
+        const child = cp.spawn('npm', ['install', packageName], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: process.platform === 'win32',
+        });
+        let stderr = '';
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        const timeout = setTimeout(() => {
+            child.kill();
+            resolve(`Timed out after 60s. ${stderr.slice(0, 500)}`);
+        }, 60_000);
+        child.on('close', code => {
+            clearTimeout(timeout);
+            if (code === 0) {
+                resolve(null); // success
+            }
+            else {
+                resolve(stderr.slice(0, 500) || `npm install exited with code ${code}`);
+            }
+        });
+        child.on('error', err => {
+            clearTimeout(timeout);
+            resolve(`Failed to start npm install: ${err.message}`);
+        });
+    });
+}
+//# sourceMappingURL=npm.js.map

package/dist/tools/install/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../../src/tools/install/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,gBAAgB,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE;YACrF,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QAE7B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAA;QACD,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;SAC1B,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,WAAmB;IAClE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE;YACtD,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;SACpC,CAAC,CAAA;QAEF,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,KAAK,CAAC,IAAI,EAAE,CAAA;YACZ,OAAO,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACzD,CAAC,EAAE,MAAM,CAAC,CAAA;QAEV,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;YACvB,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,CAAA,CAAC,UAAU;YAC1B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,gCAAgC,IAAI,EAAE,CAAC,CAAA;YACzE,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;YACtB,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QACxD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/install/skill-content.d.ts

@@ -0,0 +1,9 @@
+/** Sanitize a package name to a valid skill name (lowercase, digits, hyphens) */
+export declare function sanitizeSkillName(name: string): string;
+/** Generate a usage guide snippet from the readme */
+export declare function extractUsageGuide(readme: string): string;
+/** Generate the skill markdown content (npm package) */
+export declare function generateSkillContent(packageName: string, description: string, usageGuide: string): string;
+/** Generate the skill markdown content (ClawHub skill) */
+export declare function generateClawHubSkillContent(slug: string, displayName: string, summary: string, clawhubContent: string): string;
+//# sourceMappingURL=skill-content.d.ts.map

package/dist/tools/install/skill-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.d.ts","sourceRoot":"","sources":["../../../src/tools/install/skill-content.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQtD;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAqCR;AAED,0DAA0D;AAC1D,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,MAAM,CA4BR"}

package/dist/tools/install/skill-content.js

@@ -0,0 +1,89 @@
+import { CLAWHUB_SITE } from './constants.js';
+/** Sanitize a package name to a valid skill name (lowercase, digits, hyphens) */
+export function sanitizeSkillName(name) {
+    return name
+        .toLowerCase()
+        .replace(/@/g, '')
+        .replace(/\//g, '-')
+        .replace(/[^a-z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/** Generate a usage guide snippet from the readme */
+export function extractUsageGuide(readme) {
+    // Try to extract code examples from the readme
+    const codeBlocks = [];
+    const blockRegex = /```(?:js|javascript|ts|typescript|bash)\n([\s\S]*?)```/g;
+    let match = blockRegex.exec(readme);
+    while (match !== null) {
+        const block = match[1].trim();
+        if (block.length > 0 && block.length < 1000) {
+            codeBlocks.push(block);
+        }
+        match = blockRegex.exec(readme);
+    }
+    return codeBlocks.slice(0, 3).join('\n\n');
+}
+/** Generate the skill markdown content (npm package) */
+export function generateSkillContent(packageName, description, usageGuide) {
+    const installCmd = `npm install ${packageName}`;
+    let content = `---
+name: ${sanitizeSkillName(packageName)}
+description: ${description}
+---
+
+# ${packageName}
+
+${description}
+
+## Installation
+
+This package is already installed in the project via \`${installCmd}\`.
+
+## Usage
+
+You can import and use this package in your code:
+
+\`\`\`typescript
+import ${packageName.replace(/@/, '').replace(/[/-]/g, '_')} from '${packageName}'
+\`\`\`
+`;
+    if (usageGuide) {
+        content += `\n## Examples\n\n${usageGuide}\n`;
+    }
+    content += `
+## Notes
+
+- This skill was automatically installed. The package is available as a project dependency.
+- Refer to the package's npm page or repository for full documentation.
+`;
+    return content;
+}
+/** Generate the skill markdown content (ClawHub skill) */
+export function generateClawHubSkillContent(slug, displayName, summary, clawhubContent) {
+    // If the ZIP contains a SKILL.md, use it directly
+    // Otherwise, generate a wrapper skill file
+    let content = `---
+name: ${sanitizeSkillName(slug)}
+description: ${summary || displayName}
+clawhub: ${slug}
+---
+
+# ${displayName}
+
+${summary || `ClawHub skill: ${slug}`}
+
+`;
+    if (clawhubContent) {
+        content += `${clawhubContent}\n`;
+    }
+    content += `
+## Notes
+
+- This skill was installed from [ClawHub](${CLAWHUB_SITE}/${slug}).
+- Source: ${CLAWHUB_SITE}/${slug}
+- The skill instructions are loaded automatically on the next turn.
+`;
+    return content;
+}
+//# sourceMappingURL=skill-content.js.map

package/dist/tools/install/skill-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content.js","sourceRoot":"","sources":["../../../src/tools/install/skill-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,+CAA+C;IAC/C,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,UAAU,GAAG,yDAAyD,CAAA;IAC5E,IAAI,KAAK,GAA2B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3D,OAAO,KAAK,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,CAAC;QACD,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,WAAmB,EACnB,UAAkB;IAElB,MAAM,UAAU,GAAG,eAAe,WAAW,EAAE,CAAA;IAE/C,IAAI,OAAO,GAAG;QACR,iBAAiB,CAAC,WAAW,CAAC;eACvB,WAAW;;;IAGtB,WAAW;;EAEb,WAAW;;;;yDAI4C,UAAU;;;;;;;SAO1D,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,WAAW;;CAE/E,CAAA;IAEC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,IAAI,oBAAoB,UAAU,IAAI,CAAA;IAC/C,CAAC;IAED,OAAO,IAAI;;;;;CAKZ,CAAA;IAEC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,WAAmB,EACnB,OAAe,EACf,cAAsB;IAEtB,kDAAkD;IAClD,2CAA2C;IAC3C,IAAI,OAAO,GAAG;QACR,iBAAiB,CAAC,IAAI,CAAC;eAChB,OAAO,IAAI,WAAW;WAC1B,IAAI;;;IAGX,WAAW;;EAEb,OAAO,IAAI,kBAAkB,IAAI,EAAE;;CAEpC,CAAA;IAEC,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,IAAI,GAAG,cAAc,IAAI,CAAA;IAClC,CAAC;IAED,OAAO,IAAI;;;4CAG+B,YAAY,IAAI,IAAI;YACpD,YAAY,IAAI,IAAI;;CAE/B,CAAA;IAEC,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/tools/install_skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install_skill.d.ts","sourceRoot":"","sources":["../../src/tools/install_skill.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAqPlD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA0IxD"}
+{"version":3,"file":"install_skill.d.ts","sourceRoot":"","sources":["../../src/tools/install_skill.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAqPlD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CA4IxD"}

package/dist/tools/install_skill.js

@@ -205,6 +205,8 @@ export function createInstallSkillTool(cwd) {
     return {
         definition: {
             name: 'install_skill',
+            category: 'Install',
+            group: 'Skill',
             description: `Install an npm package or ClawHub skill. This tool:
 1. For npm packages: fetches info from npm registry, runs \`npm install\`, creates a skill file
 2. For ClawHub skills: fetches skill metadata from clawhub.ai, downloads the skill bundle, writes SKILL.md