@alfe.ai/integration-manifest 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -36,6 +36,18 @@ 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;
@@ -62,6 +74,7 @@ interface InstallTargets {
 interface IntegrationHooks {
   pre_install?: string;
   post_install?: string;
+  post_activate?: string;
   pre_uninstall?: string;
   post_uninstall?: string;
   health_check?: string;
@@ -99,6 +112,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;
   /**
@@ -208,6 +222,13 @@ 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;
 }, z.core.$strip>;
@@ -244,6 +265,7 @@ declare const InstallTargetsSchema: z.ZodObject<{
 declare const IntegrationHooksSchema: z.ZodObject<{
   pre_install: z.ZodOptional<z.ZodString>;
   post_install: z.ZodOptional<z.ZodString>;
+  post_activate: z.ZodOptional<z.ZodString>;
   pre_uninstall: z.ZodOptional<z.ZodString>;
   post_uninstall: z.ZodOptional<z.ZodString>;
   health_check: z.ZodOptional<z.ZodString>;
@@ -314,10 +336,18 @@ declare const IntegrationManifestSchema: z.ZodObject<{
   hooks: z.ZodDefault<z.ZodOptional<z.ZodObject<{
     pre_install: z.ZodOptional<z.ZodString>;
     post_install: z.ZodOptional<z.ZodString>;
+    post_activate: z.ZodOptional<z.ZodString>;
     pre_uninstall: z.ZodOptional<z.ZodString>;
     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>>;
   publisherId: z.ZodOptional<z.ZodString>;
@@ -424,6 +454,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[];
@@ -454,4 +510,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,6 +59,13 @@ 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 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") });
 const PluginInstallSchema = z.object({ package: z.string().min(1, "Plugin package name must not be empty") });
 /** Per-runtime install overrides */
@@ -77,6 +84,7 @@ const InstallTargetsSchema = z.object({
 const IntegrationHooksSchema = z.object({
 	pre_install: z.string().optional(),
 	post_install: z.string().optional(),
+	post_activate: z.string().optional(),
 	pre_uninstall: z.string().optional(),
 	post_uninstall: z.string().optional(),
 	health_check: z.string().optional()
@@ -122,6 +130,7 @@ 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(),
 	publisherId: z.string().optional(),
@@ -369,4 +378,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.4",
+  "version": "0.0.6",
   "description": "Integration manifest schema, types, and parser for Alfe integration platform",
   "type": "module",
   "main": "./dist/index.js",