@heybox/hb-sdk 0.2.0-alpha.2 → 0.3.1

package/dist/index.esm.js

@@ -236,8 +236,9 @@ class MiniProgramBridgeClient {
         this.eventBus.off(eventName, handler);
     }
     /** 调用父容器开放能力。 */
-    async request(method, payload) {
+    async request(method, ...args) {
         await this.ready();
+        const payload = args[0];
         const id = createMessageId();
         const message = {
             namespace: MINI_PROGRAM_MESSAGE_NAMESPACE,
@@ -884,4 +885,4 @@ const hbSDK = {
     network,
 };
 
-export { AUTH_LOGIN_METHOD, HbMiniProgramNetworkError, HbMiniProgramSDKError, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MiniProgramSDK, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, auth, createMiniProgramSDK, hbSDK as default, isMiniProgramBridgeMessage, network, off, on, ready, share, storage, user, viewport };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, MiniProgramSDK, auth, createMiniProgramSDK, hbSDK as default, network, off, on, ready, share, storage, user, viewport };

package/dist/miniapp-publish.cjs.js

@@ -1,14 +1,15 @@
 'use strict';
 
+const PUBLISH_VERSION_RE = /^\d+\.\d+\.\d+$/;
+function isValidMiniappManifestVersion(version) {
+    return PUBLISH_VERSION_RE.test(String(version || '').trim());
+}
+
 const MINIAPP_UPLOAD_SCOPE = 'activity';
 const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 const PUBLISH_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/publish';
-const VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
 const FNV_OFFSET = 0x811c9dc5;
 const FNV_PRIME = 0x01000193;
-function isValidVersion(version) {
-    return VERSION_PATTERN.test(String(version || '').trim());
-}
 function normalizeRelativePath(relativePath) {
     return String(relativePath || '')
         .replace(/\\/g, '/')
@@ -70,7 +71,7 @@ exports.MINIAPP_UPLOAD_SCOPE = MINIAPP_UPLOAD_SCOPE;
 exports.PUBLISH_USER_MINIPROGRAM_API_PATH = PUBLISH_USER_MINIPROGRAM_API_PATH;
 exports.getMiniProgramUploadAlias = getMiniProgramUploadAlias;
 exports.getMiniappUploadKey = getMiniappUploadKey;
-exports.isValidVersion = isValidVersion;
+exports.isValidVersion = isValidMiniappManifestVersion;
 exports.normalizeRelativePath = normalizeRelativePath;
 exports.relativePathContainsNodeModulesSegment = relativePathContainsNodeModulesSegment;
 exports.shouldUploadDistFile = shouldUploadDistFile;

package/dist/miniapp-publish.esm.js

@@ -1,12 +1,13 @@
+const PUBLISH_VERSION_RE = /^\d+\.\d+\.\d+$/;
+function isValidMiniappManifestVersion(version) {
+    return PUBLISH_VERSION_RE.test(String(version || '').trim());
+}
+
 const MINIAPP_UPLOAD_SCOPE = 'activity';
 const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 const PUBLISH_USER_MINIPROGRAM_API_PATH = '/mall/developer/user_miniprogram/publish';
-const VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
 const FNV_OFFSET = 0x811c9dc5;
 const FNV_PRIME = 0x01000193;
-function isValidVersion(version) {
-    return VERSION_PATTERN.test(String(version || '').trim());
-}
 function normalizeRelativePath(relativePath) {
     return String(relativePath || '')
         .replace(/\\/g, '/')
@@ -63,4 +64,4 @@ function shouldUploadDistFile(relativePath) {
     return true;
 }
 
-export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, MINIAPP_UPLOAD_SCOPE, PUBLISH_USER_MINIPROGRAM_API_PATH, getMiniProgramUploadAlias, getMiniappUploadKey, isValidVersion, normalizeRelativePath, relativePathContainsNodeModulesSegment, shouldUploadDistFile, validateUploadPaths };
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, MINIAPP_UPLOAD_SCOPE, PUBLISH_USER_MINIPROGRAM_API_PATH, getMiniProgramUploadAlias, getMiniappUploadKey, isValidMiniappManifestVersion as isValidVersion, normalizeRelativePath, relativePathContainsNodeModulesSegment, shouldUploadDistFile, validateUploadPaths };

package/dist/templates/vue3-vite-ts/README.md.ejs

@@ -10,12 +10,14 @@ npm run dev
 npm run typecheck
 npm run test:unit
 npm run build
+npm run deploy
 ```
 
 ## 开发模式
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面。
 - `npm run build`：先执行 TypeScript 检查，再构建生产产物。
+- `npm run deploy`：构建并发布当前小程序。发布前需要先把 `package.json` 中的 `heybox.miniProgramId` 改成后台分配的真实小程序 id，并执行过 `npx hb-sdk login`。
 
 ## 更多能力
 

package/dist/templates/vue3-vite-ts/package.json.ejs

@@ -3,8 +3,13 @@
   "version": "0.0.0",
   "private": true,
   "type": "module",
+  "heybox": {
+    "miniProgramId": ""
+  },
   "scripts": {
+    "hb-sdk": "hb-sdk",
     "dev": "hb-sdk dev",
+    "deploy": "hb-sdk deploy",
     "build": "vue-tsc --noEmit && vite build",
     "preview": "vite preview",
     "typecheck": "vue-tsc --noEmit",

package/dist/vite.cjs.js

@@ -3,32 +3,37 @@
 var node_fs = require('node:fs');
 var path = require('node:path');
 
-const TEMPLATE_VERSION = '0.0.0';
-const SEMVER_LIKE_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
-const TEMPLATE_VERSION_ERROR = '@heybox/hb-sdk 提示：请把 package.json.version 从模板默认的 0.0.0 改成实际版本号再发布';
-function miniappManifest() {
-    let root = process.cwd();
-    let outDir = 'dist';
-    return {
-        name: 'heybox-miniapp-manifest',
-        apply: 'build',
-        configResolved(resolved) {
-            root = resolved.root;
-            outDir = resolved.build.outDir;
-        },
-        writeBundle() {
-            const version = readMiniappVersion(root);
-            if (!SEMVER_LIKE_RE.test(version)) {
-                this.warn(`package.json.version "${version}" 不是标准 semver，仍会写入 manifest.json`);
-            }
-            const manifestPath = path.resolve(root, outDir, 'manifest.json');
-            node_fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
-            node_fs.writeFileSync(manifestPath, `${JSON.stringify({ version }, null, 2)}\n`);
-        },
-    };
+const MINIAPP_TEMPLATE_VERSION = '0.0.0';
+const BUILD_VERSION_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
+function getMiniappManifestBuildWarning(version) {
+    if (version === MINIAPP_TEMPLATE_VERSION) {
+        return '@heybox/hb-sdk 提示：package.json.version 仍是模板默认的 0.0.0；manifest 会写入，但发布前必须改成实际 x.y.z 版本';
+    }
+    if (!BUILD_VERSION_RE.test(version)) {
+        return `package.json.version "${version}" 不是标准 semver，仍会写入 manifest.json`;
+    }
+    return undefined;
+}
+function renderMiniappManifest(manifest) {
+    return `${JSON.stringify({ version: manifest.version }, null, 2)}\n`;
 }
-function readMiniappVersion(root) {
-    const packageJsonPath = path.join(root, 'package.json');
+
+function findNearestPackageJsonPath(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const packageJsonPath = path.join(current, 'package.json');
+        if (node_fs.existsSync(packageJsonPath)) {
+            return packageJsonPath;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return path.join(path.resolve(startDir), 'package.json');
+        }
+        current = parent;
+    }
+}
+function readMiniappVersionFromPackageJson(root) {
+    const packageJsonPath = findNearestPackageJsonPath(root);
     let content;
     try {
         content = node_fs.readFileSync(packageJsonPath, 'utf8');
@@ -46,11 +51,7 @@ function readMiniappVersion(root) {
     if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {
         throw new Error('@heybox/hb-sdk 提示：package.json.version 必须是非空字符串');
     }
-    const version = packageJson.version.trim();
-    if (version === TEMPLATE_VERSION) {
-        throw new Error(TEMPLATE_VERSION_ERROR);
-    }
-    return version;
+    return packageJson.version.trim();
 }
 function formatReason(error) {
     if (error instanceof Error && error.message) {
@@ -59,4 +60,27 @@ function formatReason(error) {
     return String(error);
 }
 
+function miniappManifest() {
+    let root = process.cwd();
+    let outDir = 'dist';
+    return {
+        name: 'heybox-miniapp-manifest',
+        apply: 'build',
+        configResolved(resolved) {
+            root = resolved.root;
+            outDir = resolved.build.outDir;
+        },
+        writeBundle() {
+            const version = readMiniappVersionFromPackageJson(root);
+            const warning = getMiniappManifestBuildWarning(version);
+            if (warning) {
+                this.warn(warning);
+            }
+            const manifestPath = path.resolve(root, outDir, 'manifest.json');
+            node_fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+            node_fs.writeFileSync(manifestPath, renderMiniappManifest({ version }));
+        },
+    };
+}
+
 exports.miniappManifest = miniappManifest;

package/dist/vite.esm.js

@@ -1,32 +1,37 @@
-import { mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 
-const TEMPLATE_VERSION = '0.0.0';
-const SEMVER_LIKE_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
-const TEMPLATE_VERSION_ERROR = '@heybox/hb-sdk 提示：请把 package.json.version 从模板默认的 0.0.0 改成实际版本号再发布';
-function miniappManifest() {
-    let root = process.cwd();
-    let outDir = 'dist';
-    return {
-        name: 'heybox-miniapp-manifest',
-        apply: 'build',
-        configResolved(resolved) {
-            root = resolved.root;
-            outDir = resolved.build.outDir;
-        },
-        writeBundle() {
-            const version = readMiniappVersion(root);
-            if (!SEMVER_LIKE_RE.test(version)) {
-                this.warn(`package.json.version "${version}" 不是标准 semver，仍会写入 manifest.json`);
-            }
-            const manifestPath = path.resolve(root, outDir, 'manifest.json');
-            mkdirSync(path.dirname(manifestPath), { recursive: true });
-            writeFileSync(manifestPath, `${JSON.stringify({ version }, null, 2)}\n`);
-        },
-    };
+const MINIAPP_TEMPLATE_VERSION = '0.0.0';
+const BUILD_VERSION_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
+function getMiniappManifestBuildWarning(version) {
+    if (version === MINIAPP_TEMPLATE_VERSION) {
+        return '@heybox/hb-sdk 提示：package.json.version 仍是模板默认的 0.0.0；manifest 会写入，但发布前必须改成实际 x.y.z 版本';
+    }
+    if (!BUILD_VERSION_RE.test(version)) {
+        return `package.json.version "${version}" 不是标准 semver，仍会写入 manifest.json`;
+    }
+    return undefined;
+}
+function renderMiniappManifest(manifest) {
+    return `${JSON.stringify({ version: manifest.version }, null, 2)}\n`;
 }
-function readMiniappVersion(root) {
-    const packageJsonPath = path.join(root, 'package.json');
+
+function findNearestPackageJsonPath(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const packageJsonPath = path.join(current, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            return packageJsonPath;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return path.join(path.resolve(startDir), 'package.json');
+        }
+        current = parent;
+    }
+}
+function readMiniappVersionFromPackageJson(root) {
+    const packageJsonPath = findNearestPackageJsonPath(root);
     let content;
     try {
         content = readFileSync(packageJsonPath, 'utf8');
@@ -44,11 +49,7 @@ function readMiniappVersion(root) {
     if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {
         throw new Error('@heybox/hb-sdk 提示：package.json.version 必须是非空字符串');
     }
-    const version = packageJson.version.trim();
-    if (version === TEMPLATE_VERSION) {
-        throw new Error(TEMPLATE_VERSION_ERROR);
-    }
-    return version;
+    return packageJson.version.trim();
 }
 function formatReason(error) {
     if (error instanceof Error && error.message) {
@@ -57,4 +58,27 @@ function formatReason(error) {
     return String(error);
 }
 
+function miniappManifest() {
+    let root = process.cwd();
+    let outDir = 'dist';
+    return {
+        name: 'heybox-miniapp-manifest',
+        apply: 'build',
+        configResolved(resolved) {
+            root = resolved.root;
+            outDir = resolved.build.outDir;
+        },
+        writeBundle() {
+            const version = readMiniappVersionFromPackageJson(root);
+            const warning = getMiniappManifestBuildWarning(version);
+            if (warning) {
+                this.warn(warning);
+            }
+            const manifestPath = path.resolve(root, outDir, 'manifest.json');
+            mkdirSync(path.dirname(manifestPath), { recursive: true });
+            writeFileSync(manifestPath, renderMiniappManifest({ version }));
+        },
+    };
+}
+
 export { miniappManifest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.2.0-alpha.2",
+  "version": "0.3.1",
   "description": "",
   "exports": {
     ".": {
@@ -43,9 +43,7 @@
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "dependencies": {
-    "cos-nodejs-sdk-v5": "2.15.4"
-  },
+  "dependencies": {},
   "peerDependencies": {
     "vite": ">=5"
   },
@@ -66,6 +64,7 @@
     "@types/node": "24.10.1",
     "@vitest/coverage-v8": "^3.2.4",
     "commander": "^12.1.0",
+    "cos-nodejs-sdk-v5": "2.15.4",
     "ejs": "^3.1.10",
     "env-paths": "^2.2.1",
     "fs-extra": "^11.3.0",

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.2.0-alpha.2`
+- Version at generation time: `0.3.1`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -29,49 +29,13 @@
 ```ts
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
-export type { MiniProgramRequester, MiniProgramSDKOptions } from './core/client';
+export type { MiniProgramSDKOptions } from './core/client';
 export { ready, on, off, auth, user, share, viewport, storage, network } from './core/singleton';
-export {
-  MINI_PROGRAM_BRIDGE_NONCE_PARAM,
-  MINI_PROGRAM_MESSAGE_NAMESPACE,
-  MINI_PROGRAM_MESSAGE_VERSION,
-  SDK_HANDSHAKE_METHOD,
-} from './protocol/constants';
-export { isMiniProgramBridgeMessage } from './protocol/guards';
 export type {
-  MiniProgramBridgeError,
-  MiniProgramBridgeMessage,
-  MiniProgramBridgeMessageType,
   MiniProgramEventHandler,
   MiniProgramEventName,
   MiniProgramEventPayloadMap,
 } from './protocol/types';
-export {
-  AUTH_LOGIN_METHOD,
-  NETWORK_REQUEST_METHOD,
-  SHARE_SCREENSHOT_METHOD,
-  SHARE_SHOW_SHARE_MENU_METHOD,
-  STORAGE_GET_STORAGE_METHOD,
-  STORAGE_SET_STORAGE_METHOD,
-  USER_GET_INFO_METHOD,
-  VIEWPORT_GET_WINDOW_INFO_METHOD,
-} from './protocol/capabilities';
-export type {
-  MiniProgramAuthMethod,
-  MiniProgramBridgeMethod,
-  MiniProgramCapabilityDefinition,
-  MiniProgramCapabilityModule,
-  MiniProgramCapabilityPayload,
-  MiniProgramCapabilityPayloadMap,
-  MiniProgramCapabilityResult,
-  MiniProgramCapabilityResultMap,
-  MiniProgramCapabilityRisk,
-  MiniProgramNetworkMethod,
-  MiniProgramShareMethod,
-  MiniProgramStorageMethod,
-  MiniProgramUserMethod,
-  MiniProgramViewportMethod,
-} from './protocol/capabilities';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type {
   GetUserInfoPayload,
@@ -138,12 +102,13 @@ export default hbSDK;
 Use `@heybox/hb-sdk/vite` only in `vite.config.ts`. Do not import it from iframe mini-program business code.
 
 ```ts
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdirSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
-
-const TEMPLATE_VERSION = '0.0.0';
-const SEMVER_LIKE_RE = /^\d+\.\d+\.\d+(?:[-+].*)?$/;
-const TEMPLATE_VERSION_ERROR = '@heybox/hb-sdk 提示：请把 package.json.version 从模板默认的 0.0.0 改成实际版本号再发布';
+import {
+  getMiniappManifestBuildWarning,
+  renderMiniappManifest,
+} from '../miniapp-manifest/schema';
+import { readMiniappVersionFromPackageJson } from '../miniapp-manifest/node';
 
 type MiniappManifestPlugin = {
   name: string;
@@ -175,57 +140,19 @@ export function miniappManifest(): MiniappManifestPlugin {
       outDir = resolved.build.outDir;
     },
     writeBundle() {
-      const version = readMiniappVersion(root);
+      const version = readMiniappVersionFromPackageJson(root);
+      const warning = getMiniappManifestBuildWarning(version);
 
-      if (!SEMVER_LIKE_RE.test(version)) {
-        this.warn(`package.json.version "${version}" 不是标准 semver，仍会写入 manifest.json`);
+      if (warning) {
+        this.warn(warning);
       }
 
       const manifestPath = path.resolve(root, outDir, 'manifest.json');
       mkdirSync(path.dirname(manifestPath), { recursive: true });
-      writeFileSync(manifestPath, `${JSON.stringify({ version }, null, 2)}\n`);
+      writeFileSync(manifestPath, renderMiniappManifest({ version }));
     },
   };
 }
-
-function readMiniappVersion(root: string): string {
-  const packageJsonPath = path.join(root, 'package.json');
-  let content: string;
-
-  try {
-    content = readFileSync(packageJsonPath, 'utf8');
-  } catch (error) {
-    throw new Error(`@heybox/hb-sdk 读取 package.json 失败：${formatReason(error)}`);
-  }
-
-  let packageJson: { version?: unknown };
-
-  try {
-    packageJson = JSON.parse(content) as { version?: unknown };
-  } catch (error) {
-    throw new Error(`@heybox/hb-sdk 解析 package.json 失败：${formatReason(error)}`);
-  }
-
-  if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {
-    throw new Error('@heybox/hb-sdk 提示：package.json.version 必须是非空字符串');
-  }
-
-  const version = packageJson.version.trim();
-
-  if (version === TEMPLATE_VERSION) {
-    throw new Error(TEMPLATE_VERSION_ERROR);
-  }
-
-  return version;
-}
-
-function formatReason(error: unknown): string {
-  if (error instanceof Error && error.message) {
-    return error.message;
-  }
-
-  return String(error);
-}
 ```
 
 ## Manifest
@@ -253,7 +180,7 @@ export default defineConfig({
 
 - 读取 `package.json` 失败或 JSON 解析失败：`vite build` 直接失败，并输出具体原因。
 - `package.json.version` 不是非空字符串：`vite build` 直接失败。
-- `package.json.version` 仍是模板默认值 `0.0.0`：`vite build` 直接失败，并提示把模板默认版本改成实际版本号再发布。
+- `package.json.version` 仍是模板默认值 `0.0.0`：`vite build` 输出 warning 并写入 manifest；`hb-sdk deploy` 会拒绝发布，必须改成实际 `x.y.z` 版本。
 - 版本号不满足极简 semver 形态 `x.y.z`：只输出 Rollup/Vite warning，仍会写入 manifest。
 
 `manifest.json` 不部署到 CDN，只交给发布流水线读取后上送后台；Host 通过后台 API 间接读取版本信息。第一阶段只支持 Vite 项目，非 Vite 打包器未来通过其他子入口扩展。

package/skill/references/cli.md

@@ -343,12 +343,14 @@ npm run dev
 npm run typecheck
 npm run test:unit
 npm run build
+npm run deploy
 ```
 
 ## 开发模式
 
 - `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面。
 - `npm run build`：先执行 TypeScript 检查，再构建生产产物。
+- `npm run deploy`：构建并发布当前小程序。发布前需要先把 `package.json` 中的 `heybox.miniProgramId` 改成后台分配的真实小程序 id，并执行过 `npx hb-sdk login`。
 
 ## 更多能力
 

package/skill/scripts/skill-metadata.mjs

@@ -2,7 +2,10 @@ import { createHash } from 'node:crypto';
 
 export const HB_SDK_SKILL_NAME = 'hb-sdk';
 export const HB_SDK_PACKAGE_NAME = '@heybox/hb-sdk';
-export const HB_SDK_SKILL_SOURCE = 'https://open.xiaoheihe.cn/agent-skills/hb-sdk';
+export const HB_SDK_AGENT_SKILLS_BASE_URL = 'https://open.xiaoheihe.cn/agent-skills';
+export const HB_SDK_SKILL_SOURCE = `${HB_SDK_AGENT_SKILLS_BASE_URL}/${HB_SDK_SKILL_NAME}`;
+export const HB_SDK_SKILL_INDEX_URL = `${HB_SDK_AGENT_SKILLS_BASE_URL}/.well-known/agent-skills/index.json`;
+export const HB_SDK_SKILL_INSTALL_COMMAND = `npx skills add ${HB_SDK_SKILL_SOURCE}`;
 
 export function createSkillContentHash(fileEntries) {
   const hash = createHash('sha256');

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.2.0-alpha.2+skill.57e0cec11058",
+  "skillVersion": "0.3.1+skill.3af1f225a627",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.2.0-alpha.2",
-    "compatibility": "0.2.0-alpha.2"
+    "version": "0.3.1",
+    "compatibility": "0.3.1"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-57e0cec1105894712e82600045659d9f08fedc9e0e4c3159445168eaec6675e7"
+  "integrity": "sha256-3af1f225a627e3a1f6f4e01a98cc4e38bc571cb911a0e27cf0919784c6b9014f"
 }

package/types/core/client.d.ts

@@ -1,3 +1,4 @@
+import type { MiniProgramBridgeMethod, MiniProgramCapabilityPayload, MiniProgramCapabilityResult } from '../protocol/capabilities';
 import type { MiniProgramEventHandler, MiniProgramEventName } from '../protocol/types';
 /**
  * 创建 SDK bridge client 的配置项。
@@ -17,22 +18,11 @@ export interface MiniProgramSDKOptions {
     /** 精准 postMessage 目标 origin；未传时尝试推断，失败则回退为 `*`。 */
     targetOrigin?: string;
 }
-/**
- * 模块 API 发起请求所需的最小能力。
- *
- * @remarks
- * 各公开模块只依赖该最小接口发起 bridge 请求，以保持模块层与底层实现解耦。
- */
+type MiniProgramRequesterArgs<Method extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayload<Method> extends void ? [payload?: MiniProgramCapabilityPayload<Method>] : [payload: MiniProgramCapabilityPayload<Method>];
+/** 模块 API 发起请求所需的最小能力。 */
 export interface MiniProgramRequester {
-    /**
-     * 向父容器调用指定开放能力。
-     *
-     * @typeParam T 标准化后的返回值类型。
-     * @param method bridge method 名称。
-     * @param payload 可序列化请求载荷。
-     * @returns 由父容器返回的标准化结果。
-     */
-    request<T>(method: string, payload?: unknown): Promise<T>;
+    /** 向父容器调用指定开放能力。 */
+    request<Method extends MiniProgramBridgeMethod>(method: Method, ...args: MiniProgramRequesterArgs<Method>): Promise<MiniProgramCapabilityResult<Method>>;
 }
 /** 底层 bridge client，负责握手、请求响应、事件分发与超时清理。 */
 export declare class MiniProgramBridgeClient implements MiniProgramRequester {
@@ -60,7 +50,7 @@ export declare class MiniProgramBridgeClient implements MiniProgramRequester {
     /** 移除小程序事件监听。 */
     off<T extends MiniProgramEventName>(eventName: T, handler: MiniProgramEventHandler<T>): void;
     /** 调用父容器开放能力。 */
-    request<T>(method: string, payload?: unknown): Promise<T>;
+    request<Method extends MiniProgramBridgeMethod>(method: Method, ...args: MiniProgramRequesterArgs<Method>): Promise<MiniProgramCapabilityResult<Method>>;
     /** 销毁 SDK 实例，并拒绝尚未完成的请求。 */
     destroy(): void;
     private ensureStarted;
@@ -74,3 +64,4 @@ export declare class MiniProgramBridgeClient implements MiniProgramRequester {
     private clearReadyTimers;
     private rejectAllPending;
 }
+export {};

package/types/index.d.ts

@@ -1,12 +1,8 @@
 export { createMiniProgramSDK, MiniProgramSDK } from './core/sdk';
 export { HbMiniProgramSDKError, HbMiniProgramNetworkError } from './core/errors';
-export type { MiniProgramRequester, MiniProgramSDKOptions } from './core/client';
+export type { MiniProgramSDKOptions } from './core/client';
 export { ready, on, off, auth, user, share, viewport, storage, network } from './core/singleton';
-export { MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, SDK_HANDSHAKE_METHOD, } from './protocol/constants';
-export { isMiniProgramBridgeMessage } from './protocol/guards';
-export type { MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
-export { AUTH_LOGIN_METHOD, NETWORK_REQUEST_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, } from './protocol/capabilities';
-export type { MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from './protocol/capabilities';
+export type { MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
 export type { LoginPayload, LoginResult, MiniProgramAuthModule } from './modules/auth';
 export type { GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, MiniProgramUserModule, } from './modules/user';
 export type { MiniProgramScreenshotOptions, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareModule, MiniProgramShowShareMenuOptions, ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult, } from './modules/share';

package/types/miniapp-manifest/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './node';

package/types/miniapp-manifest/node.d.ts

@@ -0,0 +1 @@
+export declare function readMiniappVersionFromPackageJson(root: string): string;

package/types/miniapp-manifest/schema.d.ts

@@ -0,0 +1,14 @@
+export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
+export interface MiniappManifest {
+    [key: string]: unknown;
+    version: string;
+}
+export interface ParseMiniappManifestResult {
+    manifest: MiniappManifest;
+    hadBom: boolean;
+}
+export declare function isValidMiniappManifestVersion(version: string): boolean;
+export declare function getMiniappManifestBuildWarning(version: string): string | undefined;
+export declare function renderMiniappManifest(manifest: MiniappManifest): string;
+export declare function parseMiniappManifestJson(raw: string, sourceLabel?: string): ParseMiniappManifestResult;
+export declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): string;

package/types/miniapp-publish/index.d.ts

@@ -1,7 +1,7 @@
 export declare const MINIAPP_UPLOAD_SCOPE = "activity";
 export declare const ACTIVITY_UPLOAD_KEY_MAX_LENGTH = 64;
 export declare const PUBLISH_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_miniprogram/publish";
-export declare function isValidVersion(version: string): boolean;
+export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
 export declare function normalizeRelativePath(relativePath: string): string;
 export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 export declare function getMiniProgramUploadAlias(miniProgramId: string): string;

package/types/skill-metadata.d.ts

@@ -0,0 +1,6 @@
+export declare const HB_SDK_PACKAGE_NAME = "@heybox/hb-sdk";
+export declare const HB_SDK_SKILL_NAME = "hb-sdk";
+export declare const HB_SDK_AGENT_SKILLS_BASE_URL = "https://open.xiaoheihe.cn/agent-skills";
+export declare const HB_SDK_SKILL_SOURCE = "https://open.xiaoheihe.cn/agent-skills/hb-sdk";
+export declare const HB_SDK_SKILL_INDEX_URL = "https://open.xiaoheihe.cn/agent-skills/.well-known/agent-skills/index.json";
+export declare const HB_SDK_SKILL_INSTALL_COMMAND = "npx skills add https://open.xiaoheihe.cn/agent-skills/hb-sdk";