@alfe.ai/integration-manifest 0.0.9 → 0.0.11

package/dist/index.d.ts

@@ -28,6 +28,8 @@ interface ConfigSchemaField {
   select_options?: SelectOption[];
   /** OAuth provider identifier for oauth_connect fields */
   oauth_provider?: string;
+  /** If true, this field is not shown in the dashboard UI (install wizard or configure modal) */
+  hidden?: boolean;
   /** Only show this field if another field has a truthy value (string) or matches a specific value (object) */
   depends_on_field?: string | {
     key: string;
@@ -36,6 +38,20 @@ interface ConfigSchemaField {
   /** Only show this field if a specific integration is installed */
   depends_on_integration?: string;
 }
+interface McpServerDeclaration {
+  /** Unique identifier within this integration */
+  id: string;
+  /** Command to spawn (e.g., 'npx', 'node', 'xero-mcp-proxy') */
+  command: string;
+  /** Arguments for the command */
+  args?: string[];
+  /** Environment variables — supports {{config.KEY}} interpolation from config + secrets */
+  env?: Record<string, string>;
+  /** Working directory (optional) */
+  cwd?: string;
+  /** If true, applier skips auto-application — a lifecycle hook manages this MCP server instead */
+  hook_managed?: boolean;
+}
 interface CommandDeclaration {
   /** Dot-namespaced command name (e.g. "support.diagnostic") */
   name: string;
@@ -117,6 +133,8 @@ interface IntegrationManifest {
   capabilities: string[];
   hooks: IntegrationHooks;
   commands: CommandDeclaration[];
+  /** MCP servers to configure in the agent runtime */
+  mcp_servers: McpServerDeclaration[];
   /** Git repository URL (HTTPS) — not present in YAML, injected by the publish API */
   repository?: string;
   /**
@@ -161,6 +179,8 @@ interface IntegrationStateEntry {
   installedAt: string;
   config: Record<string, unknown>;
   error?: string;
+  /** Number of consecutive auto-reinstall attempts. Reset on success or explicit reinstall. */
+  reinstallAttempts?: number;
 }
 interface IntegrationsStateFile {
   version: number;
@@ -218,6 +238,7 @@ declare const ConfigSchemaFieldSchema: z.ZodObject<{
     admin: "admin";
     agent: "agent";
   }>>>;
+  hidden: z.ZodOptional<z.ZodBoolean>;
   options: z.ZodOptional<z.ZodArray<z.ZodString>>;
   select_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
     value: z.ZodString;
@@ -230,6 +251,14 @@ declare const ConfigSchemaFieldSchema: z.ZodObject<{
   }, z.core.$strip>]>>;
   depends_on_integration: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+declare const McpServerDeclarationSchema: z.ZodObject<{
+  id: z.ZodString;
+  command: z.ZodString;
+  args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  hook_managed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
 declare const CommandDeclarationSchema: z.ZodObject<{
   name: z.ZodString;
   handler: z.ZodString;
@@ -333,6 +362,7 @@ declare const IntegrationManifestSchema: z.ZodObject<{
       admin: "admin";
       agent: "agent";
     }>>>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
     options: z.ZodOptional<z.ZodArray<z.ZodString>>;
     select_options: z.ZodOptional<z.ZodArray<z.ZodObject<{
       value: z.ZodString;
@@ -361,11 +391,21 @@ declare const IntegrationManifestSchema: z.ZodObject<{
     timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     description: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>>;
+  mcp_servers: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    hook_managed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, 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";
+    team: "team";
+    project: "project";
   }>>>>;
   publisherId: z.ZodOptional<z.ZodString>;
   icon: z.ZodOptional<z.ZodString>;
@@ -529,4 +569,4 @@ declare function migrateConfig(currentConfig: Record<string, unknown>, diff: Con
   warnings: string[];
 };
 //#endregion
-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 };
+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 McpServerDeclaration, McpServerDeclarationSchema, 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

@@ -36,6 +36,7 @@ const ConfigSchemaFieldSchema = z.object({
 		z.boolean()
 	]).optional(),
 	editable: z.enum(["admin", "agent"]).optional().default("admin"),
+	hidden: z.boolean().optional(),
 	options: z.array(z.string()).optional(),
 	select_options: z.array(SelectOptionSchema).optional(),
 	oauth_provider: z.string().optional(),
@@ -58,6 +59,14 @@ 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 McpServerDeclarationSchema = z.object({
+	id: z.string().min(1, "MCP server id must not be empty").regex(/^[a-z0-9][a-z0-9-]*$/, "MCP server id must be lowercase alphanumeric with hyphens"),
+	command: z.string().min(1, "MCP server command must not be empty"),
+	args: z.array(z.string()).optional().default([]),
+	env: z.record(z.string(), z.string()).optional(),
+	cwd: z.string().optional(),
+	hook_managed: z.boolean().optional().default(false)
+});
 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"),
@@ -138,9 +147,15 @@ const IntegrationManifestSchema = z.object({
 	capabilities: z.array(z.string()).optional().default([]),
 	hooks: IntegrationHooksSchema.optional().default({}),
 	commands: z.array(CommandDeclarationSchema).optional().default([]),
+	mcp_servers: z.array(McpServerDeclarationSchema).optional().default([]),
 	repository: z.url().optional(),
 	supported_agents: z.array(RuntimeKeySchema).optional(),
-	supported_scopes: z.array(z.enum(["agent", "org"])).optional().default(["agent"]),
+	supported_scopes: z.array(z.enum([
+		"agent",
+		"org",
+		"team",
+		"project"
+	])).optional().default(["agent"]),
 	publisherId: z.string().optional(),
 	icon: z.string().optional(),
 	pricing: IntegrationPricingSchema.optional(),
@@ -383,4 +398,4 @@ function migrateConfig(currentConfig, diff) {
 	};
 }
 //#endregion
-export { CommandDeclarationSchema, 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, McpServerDeclarationSchema, 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.9",
+  "version": "0.0.11",
   "description": "Integration manifest schema, types, and parser for Alfe integration platform",
   "type": "module",
   "main": "./dist/index.js",