@alfe.ai/integration-manifest 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -50,7 +50,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 */
@@ -86,11 +88,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>;
 }
@@ -121,6 +125,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;
@@ -230,7 +240,8 @@ declare const CommandDeclarationSchema: z.ZodObject<{
   description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const SkillInstallSchema: z.ZodObject<{
-  path: z.ZodString;
+  path: z.ZodOptional<z.ZodString>;
+  clawhub: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const PluginInstallSchema: z.ZodObject<{
   package: z.ZodString;
@@ -238,7 +249,8 @@ declare const PluginInstallSchema: z.ZodObject<{
 /** Per-runtime install overrides */
 declare const RuntimeInstallSchema: z.ZodObject<{
   skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-    path: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    clawhub: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>>;
   plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
     package: z.ZodString;
@@ -247,14 +259,16 @@ declare const RuntimeInstallSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const InstallTargetsSchema: z.ZodObject<{
   skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-    path: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    clawhub: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>>;
   plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
     package: z.ZodString;
   }, z.core.$strip>>>>;
   runtimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
     skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-      path: z.ZodString;
+      path: z.ZodOptional<z.ZodString>;
+      clawhub: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       package: z.ZodString;
@@ -284,14 +298,16 @@ declare const IntegrationManifestSchema: z.ZodObject<{
   min_gateway_version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   installs: z.ZodDefault<z.ZodOptional<z.ZodObject<{
     skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-      path: z.ZodString;
+      path: z.ZodOptional<z.ZodString>;
+      clawhub: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
     plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       package: z.ZodString;
     }, z.core.$strip>>>>;
     runtimes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
       skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        clawhub: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>>>;
       plugins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         package: z.ZodString;
@@ -350,12 +366,17 @@ declare const IntegrationManifestSchema: z.ZodObject<{
   }, z.core.$strip>>>>;
   repository: z.ZodOptional<z.ZodURL>;
   supported_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  supported_scopes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    agent: "agent";
+    org: "org";
+  }>>>>;
   publisherId: z.ZodOptional<z.ZodString>;
   icon: z.ZodOptional<z.ZodString>;
   pricing: z.ZodOptional<z.ZodObject<{
     type: z.ZodEnum<{
       free: "free";
       paid: "paid";
+      usage: "usage";
     }>;
     price: z.ZodOptional<z.ZodNumber>;
     currency: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -363,6 +384,7 @@ declare const IntegrationManifestSchema: z.ZodObject<{
       month: "month";
       year: "year";
     }>>;
+    description: z.ZodOptional<z.ZodString>;
     plans: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
       name: z.ZodString;
       price: z.ZodNumber;

package/dist/index.js

@@ -66,7 +66,10 @@ const CommandDeclarationSchema = z.object({
 	timeout_ms: z.number().int().positive().optional().default(3e4),
 	description: z.string().optional()
 });
-const SkillInstallSchema = z.object({ path: z.string().min(1, "Skill path must not be empty") });
+const SkillInstallSchema = z.object({
+	path: z.string().min(1, "Skill path must not be empty").optional(),
+	clawhub: z.string().min(1, "ClawHub skill slug must not be empty").optional()
+}).refine((data) => data.path ?? data.clawhub, { message: "Skill must have either a path or clawhub slug" });
 const PluginInstallSchema = z.object({ package: z.string().min(1, "Plugin package name must not be empty") });
 /** Per-runtime install overrides */
 const RuntimeInstallSchema = z.object({
@@ -96,10 +99,15 @@ const IntegrationPricingPlanSchema = z.object({
 	interval: z.enum(["month", "year"]).optional().default("month")
 });
 const IntegrationPricingSchema = z.object({
-	type: z.enum(["free", "paid"]),
+	type: z.enum([
+		"free",
+		"paid",
+		"usage"
+	]),
 	price: z.number().positive().optional(),
 	currency: z.string().length(3).optional().default("USD"),
 	interval: z.enum(["month", "year"]).optional(),
+	description: z.string().optional(),
 	plans: z.record(z.string(), IntegrationPricingPlanSchema).optional()
 }).refine((pricing) => {
 	if (pricing.type === "paid") {
@@ -133,6 +141,7 @@ const IntegrationManifestSchema = z.object({
 	commands: z.array(CommandDeclarationSchema).optional().default([]),
 	repository: z.url().optional(),
 	supported_agents: z.array(RuntimeKeySchema).optional(),
+	supported_scopes: z.array(z.enum(["agent", "org"])).optional().default(["agent"]),
 	publisherId: z.string().optional(),
 	icon: z.string().optional(),
 	pricing: IntegrationPricingSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integration-manifest",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Integration manifest schema, types, and parser for Alfe integration platform",
   "type": "module",
   "main": "./dist/index.js",