@alfe.ai/integrations 0.0.16 → 0.0.18

package/dist/index.d.ts

@@ -28,10 +28,11 @@ interface RegistryEntry {
   } | string;
   /** Pricing details */
   pricing?: {
-    type: "free" | "paid";
+    type: "free" | "paid" | "usage";
     price?: number;
     currency?: string;
     interval?: "month" | "year";
+    description?: string;
   };
   /** Feature list for marketplace display */
   features?: string[];
@@ -261,7 +262,9 @@ interface CommandDeclaration {
 }
 interface SkillInstall {
   /** Relative path within the integration repo to the skill directory */
-  path: string;
+  path?: string;
+  /** ClawHub skill slug to install from the registry */
+  clawhub?: string;
 }
 interface PluginInstall {
   /** npm package name to install */
@@ -297,11 +300,13 @@ interface IntegrationPricingPlan {
   interval?: 'month' | 'year';
 }
 interface IntegrationPricing {
-  type: 'free' | 'paid';
+  type: 'free' | 'paid' | 'usage';
   /** Single price (shorthand for integrations with one plan) */
   price?: number;
   currency?: string;
   interval?: 'month' | 'year';
+  /** Description of usage-based pricing (for type: 'usage') */
+  description?: string;
   /** Multiple plans/tiers (e.g., starter, growth, scale) */
   plans?: Record<string, IntegrationPricingPlan>;
 }
@@ -332,6 +337,12 @@ interface IntegrationManifest {
    * Example: ['openclaw'] means this integration only works with OpenClaw.
    */
   supported_agents?: AgentRuntime[];
+  /**
+   * Scopes where this integration can be installed.
+   * Default: ['agent'] (per-agent only).
+   * 'org' means it can be installed at the org level and cascades to all agents.
+   */
+  supported_scopes?: ('agent' | 'org')[];
   /** Marketplace metadata */
   publisherId?: string;
   icon?: string;
@@ -367,6 +378,8 @@ interface RuntimeApplier {
   removePlugin(pkg: string): Promise<void>;
   /** Copy a skill directory into this runtime's skills location */
   applySkill(name: string, srcPath: string): Promise<void>;
+  /** Install a skill from ClawHub registry */
+  applyClawHubSkill(slug: string): Promise<void>;
   /** Remove a skill directory from this runtime */
   removeSkill(name: string): Promise<void>;
   /** Deep-merge config into the runtime's agent configuration */
@@ -701,6 +714,7 @@ declare class OpenClawApplier implements RuntimeApplier {
   private isPluginInstalled;
   removePlugin(pkg: string): Promise<void>;
   applySkill(name: string, srcPath: string): Promise<void>;
+  applyClawHubSkill(slug: string): Promise<void>;
   removeSkill(name: string): Promise<void>;
   /**
    * Apply integration config to the OpenClaw runtime via `openclaw config set`.

package/dist/index.js

@@ -549,10 +549,11 @@ var LockManager = class {
 			integrationVersion: version
 		});
 		for (const skill of skills) {
-			const name = skill.path.split("/").pop() ?? skill.path;
+			const name = skill.clawhub ?? skill.path?.split("/").pop() ?? "unknown";
+			const sourcePath = skill.path ? join(installPath, skill.path) : `clawhub:${skill.clawhub ?? ""}`;
 			if (!state.skills.some((s) => s.name === name && s.sourceIntegration === integrationId)) state.skills.push({
 				name,
-				sourcePath: join(installPath, skill.path),
+				sourcePath,
 				sourceIntegration: integrationId,
 				integrationVersion: version
 			});
@@ -1009,7 +1010,10 @@ var IntegrationManager = class {
 					this.log.info(`Applying plugin ${plugin.package} to ${runtimeName}`);
 					await applier.applyPlugin(plugin.package, installPath);
 				}
-				for (const skill of skills) {
+				for (const skill of skills) if (skill.clawhub) {
+					this.log.info(`Installing ClawHub skill ${skill.clawhub} to ${runtimeName}`);
+					await applier.applyClawHubSkill(skill.clawhub);
+				} else if (skill.path) {
 					const skillName = skill.path.split("/").pop() ?? skill.path;
 					const srcPath = join(installPath, skill.path);
 					this.log.info(`Applying skill ${skillName} to ${runtimeName}`);
@@ -1494,6 +1498,19 @@ var OpenClawApplier = class {
 		cpSync(srcPath, join(this.skillsDir, name), { recursive: true });
 		return Promise.resolve();
 	}
+	async applyClawHubSkill(slug) {
+		log.info({ slug }, "Installing skill from ClawHub");
+		try {
+			await execFileAsync("clawhub", ["install", slug], { timeout: 6e4 });
+			log.info({ slug }, "ClawHub skill installed");
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			log.warn({
+				slug,
+				err: msg
+			}, "ClawHub skill install failed — clawhub CLI may not be available");
+		}
+	}
 	removeSkill(name) {
 		const skillPath = join(this.skillsDir, name);
 		if (existsSync(skillPath)) rmSync(skillPath, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integrations",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "Integration lifecycle management for Alfe — registry, resolution, installation, and state",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@auriclabs/logger": "^0.1.1",
-    "@alfe.ai/integration-manifest": "^0.0.6"
+    "@alfe.ai/integration-manifest": "^0.0.8"
   },
   "files": [
     "dist"