@heybox/hb-sdk 0.8.0-alpha → 0.8.0-alpha.3

package/dist/cli-chunks/doctor-tJUGOYrm.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var os = require('node:os');
+var path = require('node:path');
+var index = require('./index-De687C6-.cjs');
+require('node:module');
+require('node:fs');
+require('path');
+require('os');
+require('readline');
+require('tty');
+require('assert');
+require('events');
+require('stream');
+require('buffer');
+require('util');
+
+const CANDIDATES = [path.resolve(__dirname, '..', 'package.json'), path.resolve(__dirname, '..', '..', 'package.json'), path.resolve(__dirname, '..', '..', '..', 'package.json')];
+const AGENTS = ['codex', 'claude', 'cursor'];
+async function runDoctorCommand(runtime = {}) {
+    const logger = runtime.logger ?? index.createCliLogger();
+    const result = await logger.task('正在检查本地 Agent Skill', () => getDoctorResult(runtime), { successText: 'Agent Skill 检查完成' });
+    if (runtime.json)
+        logger.raw(JSON.stringify(result));
+    else {
+        logger.section('Doctor');
+        logger.info(`SDK version: ${result.currentSdkVersion}`);
+        for (const a of result.agents)
+            logger.info(`${a.agent}: ${a.status}${a.skillVersion ? ` (${a.skillVersion})` : ''}`);
+        logger.info(`Status: ${result.status}`);
+        if (result.status !== 'OK')
+            logger.warn('请运行 hb-sdk skill install 安装或更新对应 Skill。');
+    }
+    return result;
+}
+async function getDoctorResult(runtime = {}) {
+    const version = await readVersion(runtime.packageJsonFiles);
+    const results = await Promise.all((runtime.agentNames ?? AGENTS).map(a => inspect(a, version, runtime)));
+    const status = results.every(a => a.status === 'OK') ? 'OK' : results.find(a => a.status !== 'OK').status;
+    return { currentSdkVersion: version, status, agents: results, localSkillJsonPath: results[0]?.path ?? '', localSkillVersion: results[0]?.skillVersion };
+}
+async function inspect(agent, version, runtime) {
+    const home = runtime.agentRoots?.[agent] ?? runtime.env?.[`${agent.toUpperCase()}_HOME`] ?? process.env[`${agent.toUpperCase()}_HOME`] ?? path.join(os.homedir(), `.${agent}`);
+    const file = path.join(home, 'skills', index.HB_SDK_SKILL_NAME, 'skill.json');
+    try {
+        const m = JSON.parse(await fs.readFile(file, 'utf8'));
+        const ok = m.name === index.HB_SDK_SKILL_NAME && m.sdk?.package === index.HB_SDK_PACKAGE_NAME && m.sdk?.version === version && m.distribution?.type === 'npm' && m.distribution?.package === index.HB_SDK_PACKAGE_NAME && m.distribution?.version === version && m.skillVersion?.startsWith(`${version}+skill.`);
+        return { agent, path: file, status: ok ? 'OK' : 'SKILL_OUTDATED', skillVersion: m.skillVersion };
+    }
+    catch {
+        return { agent, path: file, status: 'SKILL_MISSING' };
+    }
+}
+async function readVersion(files = CANDIDATES) { for (const file of files) {
+    try {
+        const m = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (typeof m.version === 'string' && m.version)
+            return m.version;
+    }
+    catch { }
+} throw new Error(`未能读取 ${index.HB_SDK_PACKAGE_NAME} 当前版本号`); }
+
+exports.getDoctorResult = getDoctorResult;
+exports.runDoctorCommand = runDoctorCommand;

package/dist/cli-chunks/{index-BjoSXl8C.cjs → index-DVuD75Hr.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index$2 = require('./index-D62ANeBv.cjs');
+var index$2 = require('./index-De687C6-.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');

package/dist/cli-chunks/{index-D62ANeBv.cjs → index-De687C6-.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
+const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-De687C6-.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
+const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-De687C6-.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
+const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-De687C6-.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
+const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-De687C6-.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-De687C6-.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -3883,10 +3883,6 @@ var envPaths = /*@__PURE__*/getDefaultExportFromCjs(envPathsExports);
 
 const HB_SDK_PACKAGE_NAME = '@heybox/hb-sdk';
 const HB_SDK_SKILL_NAME = 'hb-sdk';
-const HB_SDK_AGENT_SKILLS_BASE_URL = 'https://open.xiaoheihe.cn/agent-skills';
-const HB_SDK_SKILL_SOURCE = `${HB_SDK_AGENT_SKILLS_BASE_URL}/${HB_SDK_SKILL_NAME}`;
-const HB_SDK_SKILL_INDEX_URL = `${HB_SDK_AGENT_SKILLS_BASE_URL}/.well-known/agent-skills/index.json`;
-const HB_SDK_SKILL_INSTALL_COMMAND = `npx skills add ${HB_SDK_SKILL_SOURCE}`;
 
 var ora$1 = {exports: {}};
 
@@ -13347,7 +13343,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.8.0-alpha';
+const BUILT_CLI_VERSION = '0.8.0-alpha.3';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13412,6 +13408,7 @@ function createCliProgram(overrides = {}) {
         runDevCommand: defaultRunDevCommand,
         runDoctorCommand: defaultRunDoctorCommand,
         runRemoteCommand: defaultRunRemoteCommand,
+        runSkillInstallCommand: defaultRunSkillInstallCommand,
         ...overrides,
     };
     const program = new Command();
@@ -13451,9 +13448,20 @@ function createCliProgram(overrides = {}) {
         await handlers.runBuildCommand({}, { logger });
     });
     installRemoteCommands(program, handlers, resolveLogger);
-    addVerboseOption(program.command('doctor').description('诊断 hb-sdk 本地环境和 Agent Skill 版本')).action(async (...args) => {
-        const logger = resolveLogger(readCommandFromActionArgs(args));
-        const result = await handlers.runDoctorCommand({ logger });
+    const skill = addVerboseOption(program.command('skill').description('管理 Agent Skill'));
+    skill.command('install')
+        .option('--global', '安装到用户级 Agent 目录')
+        .option('--agent <agents...>', '指定 Agent')
+        .option('--all-agents', '安装到所有检测到的 Agent')
+        .option('--force', '覆盖已存在且被修改的 Skill')
+        .action(async (options, command) => {
+        const logger = resolveLogger(command);
+        await handlers.runSkillInstallCommand({ ...options, logger });
+    });
+    addVerboseOption(program.command('doctor').description('诊断 hb-sdk 本地环境和 Agent Skill 版本').option('--json', '以 JSON 格式输出诊断结果')).action(async (...args) => {
+        const command = readCommandFromActionArgs(args);
+        const logger = resolveLogger(command);
+        const result = await handlers.runDoctorCommand({ logger, json: Boolean(command?.opts().json) });
         if (result.status !== 'SDK_MISMATCH') {
             await handlers.printUpdateReminder({ logger });
         }
@@ -13682,35 +13690,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-DJWFSM1B.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-qWzAbpS7.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-2HfoB48V.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-PV5ua977.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-Dgt2zS9k.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CwKbAm_H.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-C95gIao_.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-tJUGOYrm.cjs'); });
     return runDoctorCommand(...args);
 };
+const defaultRunSkillInstallCommand = async (...args) => {
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-CM40_9WH.cjs'); });
+    return runSkillInstallCommand(...args);
+};
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DDdP3xcE.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-rIAQE_G2.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -13804,10 +13816,7 @@ function parseNonNegativeInteger(value) {
 
 exports.CliError = CliError;
 exports.HB_SDK_PACKAGE_NAME = HB_SDK_PACKAGE_NAME;
-exports.HB_SDK_SKILL_INDEX_URL = HB_SDK_SKILL_INDEX_URL;
-exports.HB_SDK_SKILL_INSTALL_COMMAND = HB_SDK_SKILL_INSTALL_COMMAND;
 exports.HB_SDK_SKILL_NAME = HB_SDK_SKILL_NAME;
-exports.HB_SDK_SKILL_SOURCE = HB_SDK_SKILL_SOURCE;
 exports.applyServiceTagIfNeeded = applyServiceTagIfNeeded;
 exports.commonjsGlobal = commonjsGlobal;
 exports.createCliLogger = createCliLogger;

package/dist/cli-chunks/{index.esm-CigcxJ2B.cjs → index.esm-B-4yrLNm.cjs}

@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
 var require$$0 = require('zlib');
 var require$$0$1 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-D62ANeBv.cjs');
-var dev = require('./dev-Dgt2zS9k.cjs');
+var index = require('./index-De687C6-.cjs');
+var dev = require('./dev-CwKbAm_H.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');
@@ -27,8 +27,8 @@ require('node:net');
 require('node:crypto');
 require('node:dns/promises');
 require('node:http');
-require('./context-DV2UK1Nz.cjs');
-require('./session-BDi_AZSv.cjs');
+require('./context-CtS2Thp0.cjs');
+require('./session-CzaM2Cq3.cjs');
 require('fs');
 require('constants');
 require('./runtime-permission-env-CjsCe5bp.cjs');
@@ -40,7 +40,8 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-CcE-HMmd.cjs');
+require('./project-vite-1rvkK-M8.cjs');
+require('./version-Bz-AfXQU.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-Cumknwdx.cjs → login-DolpqD8K.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-BDi_AZSv.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-D62ANeBv.cjs');
+var index = require('./index-De687C6-.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-CcE-HMmd.cjs → project-vite-1rvkK-M8.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-D62ANeBv.cjs');
+var index = require('./index-De687C6-.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-DDdP3xcE.cjs → remote-rIAQE_G2.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-D62ANeBv.cjs');
-var session = require('./session-BDi_AZSv.cjs');
+var index = require('./index-De687C6-.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
@@ -10,7 +10,7 @@ var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
 var node_crypto = require('node:crypto');
-var context = require('./context-DV2UK1Nz.cjs');
+var context = require('./context-CtS2Thp0.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -271,7 +271,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-BjoSXl8C.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-DVuD75Hr.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{session-BDi_AZSv.cjs → session-CzaM2Cq3.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-D62ANeBv.cjs');
+var index = require('./index-De687C6-.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var require$$0$2 = require('fs');

package/dist/cli-chunks/skill-CM40_9WH.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+var path = require('node:path');
+var version = require('./version-Bz-AfXQU.cjs');
+var childProcess = require('node:child_process');
+var fs = require('node:fs/promises');
+var index = require('./index-De687C6-.cjs');
+require('node:module');
+require('node:fs');
+require('path');
+require('os');
+require('readline');
+require('tty');
+require('assert');
+require('events');
+require('stream');
+require('buffer');
+require('util');
+
+function installSkill(options) {
+    const binary = require.resolve('skills/bin/cli.mjs');
+    const args = ['add', path.join(options.packageRoot, 'skill'), '--copy'];
+    if (options.global)
+        args.push('--global');
+    if (options.allAgents)
+        args.push('--agent', '*');
+    else if (options.agents?.length)
+        args.push('--agent', ...options.agents);
+    if (options.force)
+        args.push('--force');
+    const env = { ...process.env, ...options.env, DISABLE_TELEMETRY: '1', DO_NOT_TRACK: '1' };
+    const run = options.spawnImpl ?? childProcess.spawn;
+    return new Promise((resolve, reject) => {
+        const child = run(process.execPath, [binary, ...args], { cwd: options.cwd, env, stdio: 'inherit' });
+        child.on('error', reject);
+        child.on('close', (code) => resolve({ code: code ?? 1 }));
+    });
+}
+
+async function findProjectPackageJson(cwd = process.cwd()) {
+    let current = path.resolve(cwd);
+    while (true) {
+        const candidate = path.join(current, 'package.json');
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch { /* continue */ }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+async function verifyProjectSdk(cwd, version) {
+    const file = await findProjectPackageJson(cwd);
+    if (!file)
+        throw new Error('未找到项目 package.json，请在项目目录执行');
+    const pkg = JSON.parse(await fs.readFile(file, 'utf8'));
+    const declared = pkg.dependencies?.['@heybox/hb-sdk'] ?? pkg.devDependencies?.['@heybox/hb-sdk'];
+    if (!declared)
+        throw new Error('项目缺少 @heybox/hb-sdk 依赖');
+    if (declared !== version && !String(declared).includes(version)) {
+        throw new Error(`项目 @heybox/hb-sdk 版本 ${declared} 与 CLI ${version} 不一致`);
+    }
+}
+
+async function runSkillInstallCommand(options = {}) {
+    if (options.agent?.length && options.allAgents)
+        throw new Error('--agent 与 --all-agents 互斥');
+    const logger = options.logger ?? index.createCliLogger();
+    const packageRoot = options.packageRoot ?? path.resolve(__dirname, '../../..');
+    const cwd = options.cwd ?? process.cwd();
+    if (!options.global)
+        await verifyProjectSdk(cwd, version.HB_SDK_VERSION);
+    const result = await installSkill({ packageRoot, cwd, global: options.global, agents: options.agent, allAgents: options.allAgents, force: options.force });
+    if (result.code !== 0)
+        throw new Error(`Skill 安装失败（退出码 ${result.code}）`);
+    logger.success('hb-sdk Skill 安装完成');
+    return result;
+}
+
+exports.runSkillInstallCommand = runSkillInstallCommand;

package/dist/cli-chunks/version-Bz-AfXQU.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+/** 构建时替换为当前发布包的实际版本。 */
+const HB_SDK_VERSION = typeof undefined === 'string'
+    ? undefined
+    : '0.8.0-alpha.3';
+
+exports.HB_SDK_VERSION = HB_SDK_VERSION;

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-D62ANeBv.cjs');
+var index = require('./cli-chunks/index-De687C6-.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');