@alfe.ai/integration-manifest 0.3.0 → 0.3.2

package/README.md

@@ -135,3 +135,8 @@ pnpm --filter @alfe.ai/integration-manifest test
 
 - `yaml` — YAML parsing
 - `zod` — Schema validation
+
+## Links
+
+- 🌐 Website: <https://alfe.ai>
+- 📚 Docs: <https://docs.alfe.ai>

package/dist/index.d.ts

@@ -15,7 +15,7 @@ import { z } from "zod";
  * caught at runtime when the integrations service tries to resolve the
  * provider and gets nothing back.
  */
-declare const KNOWN_CONNECT_PROVIDER_IDS: readonly ["atlassian", "custom", "discord", "github", "google", "microsoft", "mobile", "myob", "notion", "salesforce", "slack", "xero"];
+declare const KNOWN_CONNECT_PROVIDER_IDS: readonly ["atlassian", "ctrader", "custom", "discord", "github", "google", "microsoft", "mobile", "myob", "notion", "salesforce", "slack", "xero"];
 type KnownConnectProviderId = (typeof KNOWN_CONNECT_PROVIDER_IDS)[number];
 /**
  * `custom` is a special provider id: it doesn't correspond to a fixed
@@ -283,29 +283,8 @@ declare const IntegrationManifestSchema: z.ZodObject<{
     requires_credentials: z.ZodOptional<z.ZodString>;
     hook_managed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>>>>;
-  requires_connection: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    atlassian: "atlassian";
-    custom: "custom";
-    discord: "discord";
-    github: "github";
-    google: "google";
-    microsoft: "microsoft";
-    mobile: "mobile";
-    myob: "myob";
-    notion: "notion";
-    salesforce: "salesforce";
-    slack: "slack";
-    xero: "xero";
-  }>>>;
-  channel_type: z.ZodOptional<z.ZodEnum<{
-    discord: "discord";
-    slack: "slack";
-    whatsapp: "whatsapp";
-    sms: "sms";
-    voice: "voice";
-    google_chat: "google_chat";
-    teams: "teams";
-  }>>;
+  requires_connection: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  channel_type: z.ZodOptional<z.ZodString>;
   expected_credentials: z.ZodOptional<z.ZodArray<z.ZodObject<{
     key: z.ZodString;
     type: z.ZodEnum<{
@@ -542,16 +521,25 @@ interface IntegrationManifest {
    * Connect provider ids whose credentials this integration resolves at
    * runtime. OR-semantics: any one in the list satisfies activation. See
    * the `requires_connection` field in `schema.ts` for full semantics.
-   * Typed as `KnownConnectProviderId[]` so consumers get compile-time
-   * narrowing matching the schema's runtime validation.
+   *
+   * Typed as `KnownConnectProviderId | (string & {})` — the union keeps
+   * IDE autocomplete for known provider ids while the `string` arm mirrors
+   * the RUNTIME parser, which is intentionally lenient (an unknown id is a
+   * no-op credential hint, never an install-blocking error). Do NOT narrow
+   * this back to `KnownConnectProviderId[]`: that reintroduces the
+   * forward-compat hazard where an older daemon crashes on a newly-added id.
    */
-  requires_connection?: KnownConnectProviderId[];
+  requires_connection?: (KnownConnectProviderId | (string & {}))[];
   /**
    * Channel type this integration adapts. Populated on integrations under
    * the submodule's `channels/<id>/` folder that map to a single channel
    * type. See `channel_type` in `schema.ts` for full semantics.
+   *
+   * Typed as `ChannelType | (string & {})` for the same forward-compat
+   * reason as `requires_connection` — the runtime parser accepts any
+   * string so a newly-added channel type can't strand an older daemon.
    */
-  channel_type?: ChannelType;
+  channel_type?: ChannelType | (string & {});
   /**
    * Credential fields the manifest expects a Custom Connection's owner
    * to fill in at create time. Used ONLY by manifests authored against

package/dist/index.js

@@ -24,6 +24,7 @@ import { parse } from "yaml";
 */
 const KNOWN_CONNECT_PROVIDER_IDS = [
 	"atlassian",
+	"ctrader",
 	"custom",
 	"discord",
 	"github",
@@ -235,8 +236,8 @@ const IntegrationManifestSchema = z.object({
 	hooks: IntegrationHooksSchema.optional().default({}),
 	commands: z.array(CommandDeclarationSchema).optional().default([]),
 	mcp_servers: z.array(McpServerDeclarationSchema).optional().default([]),
-	requires_connection: z.array(z.enum(KNOWN_CONNECT_PROVIDER_IDS)).optional(),
-	channel_type: ChannelTypeSchema.optional(),
+	requires_connection: z.array(z.string().min(1)).optional(),
+	channel_type: z.string().min(1).optional(),
 	expected_credentials: z.array(CredentialFieldSpecSchema).optional(),
 	repository: z.url().optional(),
 	supported_agents: z.array(RuntimeKeySchema).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/integration-manifest",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Integration manifest schema, types, and parser for Alfe integration platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,6 +19,14 @@
     "dist"
   ],
   "license": "UNLICENSED",
+  "homepage": "https://alfe.ai",
+  "author": "Alfe (https://alfe.ai)",
+  "keywords": [
+    "alfe",
+    "ai-agents",
+    "agent",
+    "llm"
+  ],
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",