@alfe.ai/integration-manifest 0.0.5 → 0.0.7

package/dist/index.d.ts

@@ -36,9 +36,23 @@ interface ConfigSchemaField {
   /** Only show this field if a specific integration is installed */
   depends_on_integration?: string;
 }
+interface CommandDeclaration {
+  /** Dot-namespaced command name (e.g. "support.diagnostic") */
+  name: string;
+  /** Relative path to handler file within integration directory */
+  handler: string;
+  /** Exported function name (default: "handle") */
+  method?: string;
+  /** Timeout in milliseconds (default: 30000) */
+  timeout_ms?: number;
+  /** Human-readable description */
+  description?: string;
+}
 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 */
@@ -100,6 +114,7 @@ interface IntegrationManifest {
   config_schema: ConfigSchemaField[];
   capabilities: string[];
   hooks: IntegrationHooks;
+  commands: CommandDeclaration[];
   /** Git repository URL (HTTPS) — not present in YAML, injected by the publish API */
   repository?: string;
   /**
@@ -108,6 +123,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;
@@ -209,8 +230,16 @@ declare const ConfigSchemaFieldSchema: z.ZodObject<{
   }, z.core.$strip>]>>;
   depends_on_integration: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+declare const CommandDeclarationSchema: z.ZodObject<{
+  name: z.ZodString;
+  handler: z.ZodString;
+  method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+  timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+  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;
@@ -218,7 +247,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;
@@ -227,14 +257,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;
@@ -264,14 +296,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;
@@ -321,8 +355,19 @@ declare const IntegrationManifestSchema: z.ZodObject<{
     post_uninstall: z.ZodOptional<z.ZodString>;
     health_check: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>;
+  commands: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    handler: z.ZodString;
+    method: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    description: z.ZodOptional<z.ZodString>;
+  }, 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<{
@@ -427,6 +472,32 @@ declare function extractTemplateReferences(config: Record<string, unknown>): {
   field: string;
 }[];
 //#endregion
+//#region src/command-handler.d.ts
+/**
+ * Types for integration command handlers.
+ *
+ * Handler files are committed JS in integration repos. They export a function
+ * matching CommandHandlerFn that receives a payload and a CommandContext.
+ */
+interface CommandContext {
+  workspacePath: string;
+  aiProxyUrl: string | undefined;
+  aiProxyRunning: boolean;
+  apiKey: string;
+  exec(cmd: string, opts?: {
+    timeoutMs?: number;
+    maxBuffer?: number;
+  }): Promise<{
+    stdout: string;
+    stderr: string;
+  }>;
+}
+interface CommandResult {
+  status: "ok" | "error";
+  result: unknown;
+}
+type CommandHandlerFn = (payload: Record<string, unknown>, context: CommandContext) => Promise<CommandResult>;
+//#endregion
 //#region src/migration.d.ts
 interface ConfigSchemaDiff {
   added: ConfigSchemaField[];
@@ -457,4 +528,4 @@ declare function migrateConfig(currentConfig: Record<string, unknown>, diff: Con
   warnings: string[];
 };
 //#endregion
-export { type AgentRuntime, type ConfigFieldType, ConfigFieldTypeSchema, type ConfigSchemaDiff, type ConfigSchemaField, ConfigSchemaFieldSchema, type HealthCheckResult, type HealthReport, type InstallTargets, InstallTargetsSchema, type IntegrationHooks, IntegrationHooksSchema, type IntegrationManifest, IntegrationManifestSchema, type IntegrationPricing, type IntegrationPricingPlan, type IntegrationStateEntry, type IntegrationStatus, type IntegrationsStateFile, type InterpolationContext, ManifestParseError, type ManifestSchemaType, type PluginInstall, PluginInstallSchema, type PublishedIntegration, type PublishedVersion, type RuntimeInstall, RuntimeInstallSchema, type SelectOption, SelectOptionSchema, type SkillInstall, SkillInstallSchema, buildConfigValidationSchema, diffConfigSchemas, extractTemplateReferences, interpolateConfig, isRelativePath, migrateConfig, parseManifestFile, parseManifestString, resolveAssetUrl };
+export { type AgentRuntime, type CommandContext, type CommandDeclaration, CommandDeclarationSchema, type CommandHandlerFn, type CommandResult, type ConfigFieldType, ConfigFieldTypeSchema, type ConfigSchemaDiff, type ConfigSchemaField, ConfigSchemaFieldSchema, type HealthCheckResult, type HealthReport, type InstallTargets, InstallTargetsSchema, type IntegrationHooks, IntegrationHooksSchema, type IntegrationManifest, IntegrationManifestSchema, type IntegrationPricing, type IntegrationPricingPlan, type IntegrationStateEntry, type IntegrationStatus, type IntegrationsStateFile, type InterpolationContext, ManifestParseError, type ManifestSchemaType, type PluginInstall, PluginInstallSchema, type PublishedIntegration, type PublishedVersion, type RuntimeInstall, RuntimeInstallSchema, type SelectOption, SelectOptionSchema, type SkillInstall, SkillInstallSchema, buildConfigValidationSchema, diffConfigSchemas, extractTemplateReferences, interpolateConfig, isRelativePath, migrateConfig, parseManifestFile, parseManifestString, resolveAssetUrl };

package/dist/index.js

@@ -59,7 +59,17 @@ const ConfigSchemaFieldSchema = z.object({
 	if (field.type === "oauth_connect") return field.oauth_provider !== void 0 && field.oauth_provider.length > 0;
 	return true;
 }, { message: "oauth_connect fields must specify an oauth_provider" });
-const SkillInstallSchema = z.object({ path: z.string().min(1, "Skill path must not be empty") });
+const CommandDeclarationSchema = z.object({
+	name: z.string().min(1, "Command name must not be empty").regex(/^[a-z][a-z0-9]*\.[a-z][a-z0-9_]*$/, "Command name must be dot-namespaced (e.g. \"support.diagnostic\")"),
+	handler: z.string().min(1, "Handler path must not be empty"),
+	method: z.string().optional().default("handle"),
+	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").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({
@@ -123,8 +133,10 @@ const IntegrationManifestSchema = z.object({
 	config_schema: z.array(ConfigSchemaFieldSchema).optional().default([]),
 	capabilities: z.array(z.string()).optional().default([]),
 	hooks: IntegrationHooksSchema.optional().default({}),
+	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(),
@@ -370,4 +382,4 @@ function migrateConfig(currentConfig, diff) {
 	};
 }
 //#endregion
-export { ConfigFieldTypeSchema, ConfigSchemaFieldSchema, InstallTargetsSchema, IntegrationHooksSchema, IntegrationManifestSchema, ManifestParseError, PluginInstallSchema, RuntimeInstallSchema, SelectOptionSchema, SkillInstallSchema, buildConfigValidationSchema, diffConfigSchemas, extractTemplateReferences, interpolateConfig, isRelativePath, migrateConfig, parseManifestFile, parseManifestString, resolveAssetUrl };
+export { CommandDeclarationSchema, ConfigFieldTypeSchema, ConfigSchemaFieldSchema, InstallTargetsSchema, IntegrationHooksSchema, IntegrationManifestSchema, ManifestParseError, PluginInstallSchema, RuntimeInstallSchema, SelectOptionSchema, SkillInstallSchema, buildConfigValidationSchema, diffConfigSchemas, extractTemplateReferences, interpolateConfig, isRelativePath, migrateConfig, parseManifestFile, parseManifestString, resolveAssetUrl };

package/package.json

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