@alfe.ai/integration-manifest 0.0.8 → 0.0.10

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { z } from "zod";
  * These are the canonical types used by all packages that interact with
  * integration manifests -- registry, lifecycle manager, CLI, etc.
  */
-type ConfigFieldType = 'secret' | 'string' | 'number' | 'boolean' | 'enum' | 'select' | 'multi_select' | 'oauth_connect' | 'phone_number_picker';
+type ConfigFieldType = 'secret' | 'string' | 'number' | 'boolean' | 'enum' | 'select' | 'multi_select' | 'oauth_connect';
 interface SelectOption {
   value: string;
   label: string;
@@ -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;
@@ -192,7 +212,6 @@ declare const ConfigFieldTypeSchema: z.ZodEnum<{
   select: "select";
   multi_select: "multi_select";
   oauth_connect: "oauth_connect";
-  phone_number_picker: "phone_number_picker";
 }>;
 /** Structured option for select/multi_select fields */
 declare const SelectOptionSchema: z.ZodObject<{
@@ -210,7 +229,6 @@ declare const ConfigSchemaFieldSchema: z.ZodObject<{
     select: "select";
     multi_select: "multi_select";
     oauth_connect: "oauth_connect";
-    phone_number_picker: "phone_number_picker";
   }>;
   label: z.ZodString;
   description: z.ZodOptional<z.ZodString>;
@@ -220,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;
@@ -232,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;
@@ -326,7 +353,6 @@ declare const IntegrationManifestSchema: z.ZodObject<{
       select: "select";
       multi_select: "multi_select";
       oauth_connect: "oauth_connect";
-      phone_number_picker: "phone_number_picker";
     }>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -336,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;
@@ -364,6 +391,14 @@ 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<{
@@ -532,4 +567,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

@@ -17,8 +17,7 @@ const ConfigFieldTypeSchema = z.enum([
 	"enum",
 	"select",
 	"multi_select",
-	"oauth_connect",
-	"phone_number_picker"
+	"oauth_connect"
 ]);
 /** Structured option for select/multi_select fields */
 const SelectOptionSchema = z.object({
@@ -37,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(),
@@ -59,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"),
@@ -139,6 +147,7 @@ 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"]),
@@ -181,9 +190,6 @@ function buildConfigValidationSchema(configSchema) {
 			case "oauth_connect":
 				fieldSchema = z.string();
 				break;
-			case "phone_number_picker":
-				fieldSchema = z.string();
-				break;
 			case "number":
 				fieldSchema = z.number();
 				break;
@@ -387,4 +393,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.8",
+  "version": "0.0.10",
   "description": "Integration manifest schema, types, and parser for Alfe integration platform",
   "type": "module",
   "main": "./dist/index.js",