@mastra/connect 0.4.0 → 0.5.0-alpha.0

package/dist/providers/channel-provider.d.ts

@@ -1,32 +1,60 @@
 import type { ChannelProvider } from '@mastra/core/channels';
-import type { ConnectionCredential, ConnectionContext, ResolvedClient } from '../client.js';
+import type { ConnectionContext, ConnectionCredential, ResolvedClient } from '../client.js';
 /**
- * Extra inputs a channel contributor may need beyond the raw credential:
- * durable non-secret metadata that lives on the platform connection (e.g.
- * Discord's `applicationId` + `publicKey`), and a resolved client for
- * follow-up lookups when necessary.
+ * Live view of one integration's platform connection, handed to
+ * `ChannelProviderRegistration.create()`. The `channels()` resolver updates
+ * the current connection on every resolution, so a registration's provider
+ * and `sync()` closure always read the latest state through these accessors
+ * instead of capturing a connection at construction time.
  */
-export interface ChannelBuildContext {
-    connectionId: string;
-    context?: ConnectionContext;
+export interface ChannelRuntime {
+    /** Resolved platform client for follow-up lookups. */
     client: ResolvedClient;
+    /** The currently-selected active connection id, or `undefined` when the integration has none. */
+    getConnectionId(): string | undefined;
+    /**
+     * Fetches a fresh credential for the current connection. Never cached —
+     * the platform's credential vendor owns token refresh, so each call may
+     * return a newer token than the last. Throws when no connection is active.
+     */
+    getCredential(): Promise<ConnectionCredential>;
+    /** Fetches the current connection's non-secret context (metadata), or `undefined` when unavailable. */
+    getConnectionContext(): Promise<ConnectionContext | undefined>;
+}
+/**
+ * A long-lived channel provider produced by a registration. The `provider`
+ * instance survives across resolutions (its routes are mounted once, at
+ * Mastra construction); `sync()` re-applies the current connection's
+ * credential/metadata on each resolution while a connection is active.
+ */
+export interface ChannelInstance {
+    provider: ChannelProvider;
+    /**
+     * Push the current connection's credential/metadata into the live
+     * provider (via `provider.configure()` or equivalent). Called on every
+     * resolution while a connection is active; implementations should be
+     * cheap when nothing changed. Omit for providers that pull credentials
+     * lazily themselves (e.g. Slack's `tokenResolver`).
+     */
+    sync?(): Promise<void>;
 }
 /**
  * Registers one channel-capable provider with `channels()`. An `integrationId`
- * matches the project connection and `build()` materializes a Mastra
- * `ChannelProvider` from the credential (plus per-integration
- * `providerOptions`). Ambiguity is handled at the resolver level (`channels()`
- * warns and picks the first active connection when more than one is present)
- * so registrations stay minimal.
+ * matches the project connection; `create()` constructs the long-lived
+ * provider once, credential-less. Ambiguity is handled at the resolver level
+ * (`channels()` warns and picks the first active connection when more than
+ * one is present) so registrations stay minimal.
  */
 export interface ChannelProviderRegistration<Options = Record<string, unknown>> {
     /** Platform catalog id used to match project connections (e.g. 'slack', 'telegram', 'discord'). */
     integrationId: string;
     /**
-     * Build a Mastra `ChannelProvider` from a resolved credential. Peer packages
-     * are imported inside `build()` with `await import()` so they stay optional
-     * at install time.
+     * Construct the long-lived Mastra `ChannelProvider`. Channel packages are
+     * imported inside `create()` with `await import()` so only registrations
+     * that aren't disabled pay the module-load cost. Must not call the
+     * platform: construction happens before any connection is resolved, so
+     * credentials arrive later through `runtime` (lazily, or on `sync()`).
      */
-    build(credential: ConnectionCredential, options?: Options, context?: ChannelBuildContext): Promise<ChannelProvider>;
+    create(options: Options | undefined, runtime: ChannelRuntime): Promise<ChannelInstance>;
 }
 //# sourceMappingURL=channel-provider.d.ts.map

package/dist/providers/channel-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-provider.d.ts","sourceRoot":"","sources":["../../src/providers/channel-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5E,mGAAmG;IACnG,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACrH"}
+{"version":3,"file":"channel-provider.d.ts","sourceRoot":"","sources":["../../src/providers/channel-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5F;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,MAAM,EAAE,cAAc,CAAC;IACvB,iGAAiG;IACjG,eAAe,IAAI,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/C,uGAAuG;IACvG,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;CAChE;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5E,mGAAmG;IACnG,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzF"}

package/dist/providers/channels.d.ts

@@ -18,7 +18,7 @@ import type { ChannelProviderRegistration } from './channel-provider.js';
  * `providerOptions` (handlers, streaming, commands, handlers, threadContext,
  * inlineMedia, etc.) is forwarded to the provider constructor unchanged.
  */
-declare const SLACK_RESERVED_KEYS: readonly ['baseUrl', 'refreshToken', 'token', 'encryptionKey'];
+declare const SLACK_RESERVED_KEYS: readonly ['baseUrl', 'refreshToken', 'token', 'tokenResolver', 'encryptionKey'];
 declare const TELEGRAM_RESERVED_KEYS: readonly ['baseUrl', 'apiBaseUrl', 'botToken', 'encryptionKey'];
 declare const DISCORD_RESERVED_KEYS: readonly ['baseUrl', 'encryptionKey'];
 /** Reserved (credential + framework-managed) `providerOptions` keys per integration. */

package/dist/providers/channels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/providers/channels.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAczE;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,mBAAmB,YAAI,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,CAAU,CAAC;AAC3F,QAAA,MAAM,sBAAsB,YAAI,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,CAAU,CAAC;AAC/F,QAAA,MAAM,qBAAqB,YAAI,SAAS,EAAE,eAAe,CAAU,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/E,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACrF,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAuKnF,eAAO,MAAM,QAAQ,EAAE,SAAS,2BAA2B,EAAoD,CAAC"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/providers/channels.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAMzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,QAAA,MAAM,mBAAmB,YAAI,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,CAAU,CAAC;AAC5G,QAAA,MAAM,sBAAsB,YAAI,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,CAAU,CAAC;AAC/F,QAAA,MAAM,qBAAqB,YAAI,SAAS,EAAE,eAAe,CAAU,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/E,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACrF,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AA8KnF,eAAO,MAAM,QAAQ,EAAE,SAAS,2BAA2B,EAAoD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/connect",
-  "version": "0.4.0",
+  "version": "0.5.0-alpha.0",
   "description": "Use Mastra platform integration connections as agent toolsets",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,23 +44,9 @@
     "node": ">=22.13.0"
   },
   "peerDependencies": {
-    "@mastra/core": ">=1.68.0-0 <2.0.0-0",
-    "@mastra/discord": ">=1.0.0-0 <2.0.0-0",
-    "@mastra/slack": ">=1.0.0-0 <2.0.0-0",
-    "@mastra/telegram": ">=0.1.0-0 <1.0.0-0",
+    "@mastra/core": ">=1.72.0-0 <2.0.0-0",
     "zod": ">=3.0.0 || >=4.0.0"
   },
-  "peerDependenciesMeta": {
-    "@mastra/discord": {
-      "optional": true
-    },
-    "@mastra/slack": {
-      "optional": true
-    },
-    "@mastra/telegram": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "prettier": "3.9.5",
     "ts-morph": "^27.0.2",
@@ -70,14 +56,14 @@
     "vitest": "4.1.11",
     "zod": "^4.6.4",
     "@internal/lint": "0.0.137",
-    "@mastra/discord": "1.1.0",
-    "@mastra/slack": "1.6.4",
-    "@mastra/telegram": "0.1.3",
-    "@mastra/core": "1.71.0",
-    "@internal/types-builder": "0.0.112"
+    "@internal/types-builder": "0.0.112",
+    "@mastra/core": "1.72.0-alpha.2"
   },
   "dependencies": {
-    "@mastra/mcp": "^2.1.0"
+    "@mastra/discord": "^1.2.0-alpha.0",
+    "@mastra/mcp": "^2.1.0",
+    "@mastra/slack": "^1.7.0-alpha.0",
+    "@mastra/telegram": "^0.1.3"
   },
   "scripts": {
     "add-provider": "tsx scripts/add-provider.ts",