@mastra/connect 0.4.0 → 0.5.0-alpha.1

package/dist/channels.d.ts

@@ -1,6 +1,7 @@
 import type { ChannelProvider } from '@mastra/core/channels';
 import type { ConnectClientOptions } from './client.js';
 import type { DiscordReservedProviderOption, SlackReservedProviderOption, TelegramReservedProviderOption } from './providers/channels.js';
+type ApiRoute = ReturnType<ChannelProvider['getRoutes']>[number];
 /**
  * `providerOptions` fields that `channels()` refuses to forward to a
  * `ChannelProvider` constructor. Marking them `never` here makes the compiler
@@ -33,9 +34,9 @@ export type DiscordChannelsProviderOptions = Record<string, unknown> & {
 export interface ChannelsIntegrationOptions<ProviderOptions = Record<string, unknown>> {
     /** Pin a specific connection id (bypasses single-active-connection resolution). */
     connectionId?: string;
-    /** Exclude this provider entirely, even if a connection exists. */
+    /** Exclude this provider entirely — no instance is constructed and no routes are mounted. */
     disabled?: boolean;
-    /** Provider-specific options merged into the second argument of `ChannelProviderRegistration.build()`. */
+    /** Provider-specific options merged into the first argument of `ChannelProviderRegistration.create()`. */
     providerOptions?: ProviderOptions;
 }
 /**
@@ -60,56 +61,63 @@ export interface ChannelsOptions {
 }
 /**
  * The result of resolving a project's connections into a
- * `ChannelProvider` map. Assignable directly to `Mastra({ channels })`.
+ * `ChannelProvider` map: integrations with an active connection, keyed by
+ * integrationId.
  */
 export type ResolvedChannels = Record<string, ChannelProvider>;
 /**
- * Callback context passed to `channels()`'s resolver when invoked with a
- * runtime context. Mirrors the shape used by `tools()` and other dynamic
- * agent fields — currently unused (per-request provider variance isn't
- * modeled here) but kept for signature symmetry.
+ * Callback context passed to the resolver when invoked with a runtime
+ * context. Mirrors `@mastra/core`'s `ChannelsResolverContext` — Mastra passes
+ * `{ mastra }` from `resolveChannels()`; the resolver currently doesn't vary
+ * output by context.
  */
 export interface ChannelsResolverContext {
     requestContext?: unknown;
     mastra?: unknown;
 }
 /**
- * The value returned by `channels()`. Symmetric with `tools()`:
+ * The value `channels()` resolves to. Satisfies `@mastra/core`'s
+ * `ChannelsResolver` contract, so it can be handed to
+ * `new Mastra({ channels })` directly:
  *
- * - Thenable — `await channels({ projectId })` yields a
- *   `Record<string, ChannelProvider>` directly, ready to hand to
- *   `new Mastra({ channels: await channels({ projectId }) })`.
- * - Callable — `channels(opts)(ctx)` returns the same
- *   `Record<string, ChannelProvider>`; identical to `await channels(opts)`.
- * - Handles — `invalidate()` / `refresh()` / `disconnect()` scope to the
- *   resolver's private cache only. `Mastra({ channels })` reads the
- *   `Record<string, ChannelProvider>` **synchronously** at construction time,
- *   so the constructed Mastra instance will not pick up newly-added
- *   connections or rotated credentials without a restart. These handles are
- *   for standalone/test usage where the resolver is being called directly —
- *   not for the Mastra-registered snapshot.
+ * - Callable — returns the current `Record<string, ChannelProvider>` of
+ *   integrations with an active connection. Mastra invokes it via
+ *   `resolveChannels()`; the TTL cache makes repeat calls cheap.
+ * - `getRoutes()` — the union of routes for every non-disabled channel,
+ *   available synchronously so Mastra can mount them at construction. Routes
+ *   exist before (and after) their integration has an active connection.
+ * - Handles — `invalidate()` / `refresh()` / `disconnect()` control the
+ *   resolver's private cache; `refresh()` forces a platform fetch now.
  */
-export interface ChannelsResolver extends PromiseLike<ResolvedChannels> {
-    /** Callable form used for symmetry with `tools()`; returns the resolved map. */
+export interface ChannelsResolver {
+    /** Returns the current provider map for integrations with an active connection. */
     (context?: ChannelsResolverContext): Promise<ResolvedChannels>;
+    /** Union of API routes for every non-disabled channel integration. */
+    getRoutes(): ApiRoute[];
     /** Drops the cached snapshot; the next resolution fetches fresh from the platform. */
     invalidate(): void;
-    /** Fetches providers from the platform now and updates the cache. Rejects if the platform fetch fails. */
+    /** Fetches connections from the platform now and updates the cache. Rejects if the platform fetch fails. */
     refresh(): Promise<ResolvedChannels>;
     /** Clears the cached snapshot. Reserved for symmetry with `tools()`; currently a no-op beyond invalidation. */
     disconnect(): Promise<void>;
 }
 /**
- * Returns a live channels resolver over the project's Platform connections.
- * Channel-capable integrations (Slack, Telegram, Discord) with an active
- * project connection are materialized into `ChannelProvider` instances ready
- * to hand to `new Mastra({ channels: await channels({...}) })`.
+ * Returns a live channels resolver over the project's Platform connections,
+ * ready to hand to `new Mastra({ channels: await channels({...}) })`.
+ *
+ * Provider instances for every channel-capable integration (Slack, Telegram,
+ * Discord) are constructed once, up front and credential-less, so their
+ * webhook/OAuth routes can mount at Mastra construction. Each resolution
+ * fetches the project's connections and late-binds credentials into the live
+ * instances: integrations with an active connection appear in the resolved
+ * map, others don't — so connecting a new channel on the platform takes
+ * effect without redeploying the app.
  *
  * Configuration errors (missing project id, bad ttlMs, malformed integration
- * id) throw at call time so they surface at startup. Actionable per-integration
- * problems during resolution (needs re-auth, ambiguity, missing peer package)
- * are downgraded to warn-and-skip so one bad integration never takes down the
- * whole map.
+ * id) reject at call time so they surface at startup. Actionable
+ * per-integration problems (provider construction failure, needs re-auth,
+ * ambiguity, credential sync failure) are downgraded to warn-and-skip so one
+ * bad integration never takes down the whole map.
  *
  * @example
  * ```ts
@@ -122,6 +130,6 @@ export interface ChannelsResolver extends PromiseLike<ResolvedChannels> {
  * });
  * ```
  */
-export declare function channels(options?: ChannelsOptions): ChannelsResolver;
+export declare function channels(options?: ChannelsOptions): Promise<ChannelsResolver>;
 export {};
 //# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAA2D,MAAM,aAAa,CAAC;AAIjH,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAIjC;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,qBAAqB,CAAC,QAAQ,SAAS,MAAM,IAAI;KAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK;CAAE,CAAC;AAElF,gFAAgF;AAChF,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAAC,2BAA2B,CAAC,CAAC;AACxH,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnE,qBAAqB,CAAC,8BAA8B,CAAC,CAAC;AACxD,MAAM,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,6BAA6B,CAAC,CAAC;AAEzD,wGAAwG;AACxG,MAAM,WAAW,0BAA0B,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnF,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0GAA0G;IAC1G,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,0BAA0B,CAAC,4BAA4B,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,0BAA0B,CAAC,+BAA+B,CAAC,CAAC;IACvE,OAAO,CAAC,EAAE,0BAA0B,CAAC,8BAA8B,CAAC,CAAC;IACrE,CAAC,aAAa,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mHAAmH;IACnH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IACrE,gFAAgF;IAChF,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,sFAAsF;IACtF,UAAU,IAAI,IAAI,CAAC;IACnB,0GAA0G;IAC1G,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,+GAA+G;IAC/G,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,gBAAgB,CAuGxE"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,aAAa,CAAC;AAI3E,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAIjC,KAAK,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,qBAAqB,CAAC,QAAQ,SAAS,MAAM,IAAI;KAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK;CAAE,CAAC;AAElF,gFAAgF;AAChF,MAAM,MAAM,4BAA4B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAAC,2BAA2B,CAAC,CAAC;AACxH,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnE,qBAAqB,CAAC,8BAA8B,CAAC,CAAC;AACxD,MAAM,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,qBAAqB,CAAC,6BAA6B,CAAC,CAAC;AAEzD,wGAAwG;AACxG,MAAM,WAAW,0BAA0B,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnF,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0GAA0G;IAC1G,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,0BAA0B,CAAC,4BAA4B,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,0BAA0B,CAAC,+BAA+B,CAAC,CAAC;IACvE,OAAO,CAAC,EAAE,0BAA0B,CAAC,8BAA8B,CAAC,CAAC;IACrE,CAAC,aAAa,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mHAAmH;IACnH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,sEAAsE;IACtE,SAAS,IAAI,QAAQ,EAAE,CAAC;IACxB,sFAAsF;IACtF,UAAU,IAAI,IAAI,CAAC;IACnB,4GAA4G;IAC5G,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,+GAA+G;IAC/G,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmKvF"}

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type MastraConnectErrorCode = 'missing_access_token' | 'missing_project_id' | 'missing_connection_id' | 'invalid_options' | 'connection_not_found' | 'unauthorized' | 'proxy_error' | 'unsupported_credential_type' | 'platform_error';
+export type MastraConnectErrorCode = 'missing_access_token' | 'missing_project_id' | 'missing_connection_id' | 'invalid_options' | 'connection_not_found' | 'unauthorized' | 'proxy_error' | 'unsupported_credential_type' | 'no_active_connection' | 'platform_error';
 export declare class MastraConnectError extends Error {
     readonly code: MastraConnectErrorCode;
     readonly status?: number;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,GACtB,cAAc,GACd,aAAa,GACb,6BAA6B,GAC7B,gBAAgB,CAAC;AAIrB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,YAAY,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAMxG;CACF;AAcD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBrE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,sBAAsB,GACtB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,GACjB,sBAAsB,GACtB,cAAc,GACd,aAAa,GACb,6BAA6B,GAC7B,sBAAsB,GACtB,gBAAgB,CAAC;AAIrB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,YAAY,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAMxG;CACF;AAcD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBrE"}

package/dist/index.cjs

@@ -347,14 +347,12 @@ async function proxyRequestWithResponse(client, connectionId, options) {
 function credentialToken$1(credential) {
 	return credential.type === "oauth2" ? credential.accessToken : credential.apiKey;
 }
-function missingPeerError(integrationId, packageName, error) {
-	return new MastraConnectError("invalid_options", `channels() cannot build '${integrationId}' provider: install '${packageName}' as a dependency of your app (${error instanceof Error ? error.message : String(error)}).`);
-}
 const RESERVED_OPTION_KEYS = {
 	slack: [
 		"baseUrl",
 		"refreshToken",
 		"token",
+		"tokenResolver",
 		"encryptionKey"
 	],
 	telegram: [
@@ -384,61 +382,54 @@ function stripReservedOptions(integrationId, options) {
 const CHANNELS$1 = [
 	{
 		integrationId: "slack",
-		async build(credential, options) {
-			const refreshToken = credentialToken$1(credential);
-			let mod;
-			try {
-				mod = await import("@mastra/slack");
-			} catch (error) {
-				throw missingPeerError("slack", "@mastra/slack", error);
-			}
+		async create(options, runtime) {
+			const mod = await import("@mastra/slack");
 			const safeOptions = stripReservedOptions("slack", options);
-			return new mod.SlackProvider({
-				refreshToken,
+			const tokenResolver = async () => {
+				return credentialToken$1(await runtime.getCredential());
+			};
+			return { provider: new mod.SlackProvider({
+				tokenResolver,
 				...safeOptions ?? {}
-			});
+			}) };
 		}
 	},
 	{
 		integrationId: "telegram",
-		async build(credential, options) {
-			const botToken = credentialToken$1(credential);
-			let mod;
-			try {
-				mod = await import("@mastra/telegram");
-			} catch (error) {
-				throw missingPeerError("telegram", "@mastra/telegram", error);
-			}
+		async create(options, runtime) {
+			const mod = await import("@mastra/telegram");
 			const safeOptions = stripReservedOptions("telegram", options);
-			return new mod.TelegramProvider({
-				botToken,
-				...safeOptions ?? {}
-			});
+			const provider = new mod.TelegramProvider({ ...safeOptions ?? {} });
+			return {
+				provider,
+				async sync() {
+					const botToken = credentialToken$1(await runtime.getCredential());
+					await provider.configure?.({ botToken });
+				}
+			};
 		}
 	},
 	{
 		integrationId: "discord",
-		async build(credential, options, context) {
-			const botToken = credentialToken$1(credential);
-			const metadata = context?.context?.metadata ?? {};
-			const applicationId = options?.applicationId ?? (typeof metadata.applicationId === "string" ? metadata.applicationId : void 0) ?? (typeof metadata.application_id === "string" ? metadata.application_id : void 0);
-			const publicKey = options?.publicKey ?? (typeof metadata.publicKey === "string" ? metadata.publicKey : void 0) ?? (typeof metadata.public_key === "string" ? metadata.public_key : void 0);
-			let mod;
-			try {
-				mod = await import("@mastra/discord");
-			} catch (error) {
-				throw missingPeerError("discord", "@mastra/discord", error);
-			}
-			if (!applicationId || !publicKey) console.warn(`[@mastra/connect] discord channel: missing ${[!applicationId && "applicationId", !publicKey && "publicKey"].filter(Boolean).join(" + ")} on the connection. Store them on the connection's metadata or pass them via integrations.discord.providerOptions.`);
-			const { applicationId: _optAppId, publicKey: _optPubKey, ...rest } = options ?? {};
-			return new mod.DiscordProvider({
-				app: {
-					botToken,
-					applicationId,
-					publicKey
-				},
-				...rest
-			});
+		async create(options, runtime) {
+			const mod = await import("@mastra/discord");
+			const { applicationId: optionsAppId, publicKey: optionsPublicKey, ...rest } = options ?? {};
+			const safeOptions = stripReservedOptions("discord", rest);
+			const provider = new mod.DiscordProvider({ ...safeOptions ?? {} });
+			return {
+				provider,
+				async sync() {
+					const metadata = (await runtime.getConnectionContext())?.metadata ?? {};
+					const botToken = typeof metadata.botToken === "string" && metadata.botToken || typeof metadata.bot_token === "string" && metadata.bot_token || void 0;
+					if (!botToken) throw new MastraConnectError("no_active_connection", `Discord connection ${runtime.getConnectionId()} has no botToken in its metadata. Store the bot token on the connection (Nango setMetadata) to activate the Discord channel.`);
+					const applicationId = optionsAppId ?? (typeof metadata.applicationId === "string" ? metadata.applicationId : void 0) ?? (typeof metadata.application_id === "string" ? metadata.application_id : void 0);
+					const publicKey = optionsPublicKey ?? (typeof metadata.publicKey === "string" ? metadata.publicKey : void 0) ?? (typeof metadata.public_key === "string" ? metadata.public_key : void 0);
+					const credentials = { botToken };
+					if (applicationId) credentials.applicationId = applicationId;
+					if (publicKey) credentials.publicKey = publicKey;
+					await provider.configure?.(credentials);
+				}
+			};
 		}
 	}
 ];
@@ -66154,16 +66145,22 @@ const DEFAULT_TTL_MS = 3e4;
 /** Minimum wait after a failed platform fetch before another background revalidation. */
 const FAILURE_COOLDOWN_MS = 3e4;
 /**
-* Returns a live channels resolver over the project's Platform connections.
-* Channel-capable integrations (Slack, Telegram, Discord) with an active
-* project connection are materialized into `ChannelProvider` instances ready
-* to hand to `new Mastra({ channels: await channels({...}) })`.
+* Returns a live channels resolver over the project's Platform connections,
+* ready to hand to `new Mastra({ channels: await channels({...}) })`.
+*
+* Provider instances for every channel-capable integration (Slack, Telegram,
+* Discord) are constructed once, up front and credential-less, so their
+* webhook/OAuth routes can mount at Mastra construction. Each resolution
+* fetches the project's connections and late-binds credentials into the live
+* instances: integrations with an active connection appear in the resolved
+* map, others don't — so connecting a new channel on the platform takes
+* effect without redeploying the app.
 *
 * Configuration errors (missing project id, bad ttlMs, malformed integration
-* id) throw at call time so they surface at startup. Actionable per-integration
-* problems during resolution (needs re-auth, ambiguity, missing peer package)
-* are downgraded to warn-and-skip so one bad integration never takes down the
-* whole map.
+* id) reject at call time so they surface at startup. Actionable
+* per-integration problems (provider construction failure, needs re-auth,
+* ambiguity, credential sync failure) are downgraded to warn-and-skip so one
+* bad integration never takes down the whole map.
 *
 * @example
 * ```ts
@@ -66176,13 +66173,48 @@ const FAILURE_COOLDOWN_MS = 3e4;
 * });
 * ```
 */
-function channels(options = {}) {
+async function channels(options = {}) {
 	const projectId = options.projectId?.trim() || process.env.MASTRA_PROJECT_ID?.trim();
 	if (!projectId) throw new MastraConnectError("missing_project_id", "Missing project id: set MASTRA_PROJECT_ID or pass projectId.");
 	if (options.ttlMs !== void 0 && (!Number.isFinite(options.ttlMs) || options.ttlMs < 0)) throw new MastraConnectError("invalid_options", `Invalid ttlMs (${options.ttlMs}): expected a finite number of milliseconds >= 0.`);
 	validateIntegrationOverrides(options.integrations);
 	const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
 	const client = resolveClient(options.client);
+	const states = [];
+	for (const registration of CHANNELS) {
+		const overrides = options.integrations?.[registration.integrationId] ?? {};
+		if (overrides.disabled) continue;
+		const state = {
+			registration,
+			instance: void 0,
+			connectionId: void 0
+		};
+		const runtime = {
+			client,
+			getConnectionId: () => state.connectionId,
+			getCredential: async () => {
+				const connectionId = state.connectionId;
+				if (!connectionId) throw new MastraConnectError("no_active_connection", `No active ${registration.integrationId} connection for project ${projectId}. Connect one on the platform, then retry.`);
+				return getCredential(client, connectionId);
+			},
+			getConnectionContext: async () => {
+				const connectionId = state.connectionId;
+				if (!connectionId) return void 0;
+				try {
+					return await getConnectionContext(client, connectionId);
+				} catch {
+					return;
+				}
+			}
+		};
+		try {
+			state.instance = await registration.create(overrides.providerOptions ?? {}, runtime);
+		} catch (error) {
+			console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
+			continue;
+		}
+		states.push(state);
+	}
 	let cache;
 	let inflight;
 	let lastFailureAt;
@@ -66196,17 +66228,20 @@ function channels(options = {}) {
 		}
 		const byIntegrationId = groupByIntegrationId(connections);
 		const providers = {};
-		for (const registration of CHANNELS) {
-			const integrationId = registration.integrationId;
+		for (const state of states) {
+			const integrationId = state.registration.integrationId;
 			const overrides = options.integrations?.[integrationId] ?? {};
-			if (overrides.disabled) continue;
 			const candidates = byIntegrationId.get(integrationId) ?? [];
-			if (candidates.length === 0) continue;
-			const connectionId = selectChannelConnection(integrationId, overrides.connectionId, candidates);
+			const connectionId = candidates.length === 0 ? void 0 : selectChannelConnection(integrationId, overrides.connectionId, candidates);
+			state.connectionId = connectionId;
 			if (!connectionId) continue;
-			const provider = await buildProvider(registration, connectionId, overrides, client);
-			if (!provider) continue;
-			providers[integrationId] = provider;
+			if (state.instance.sync) try {
+				await state.instance.sync();
+			} catch (error) {
+				console.warn(`[@mastra/connect] Skipping ${integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
+				continue;
+			}
+			providers[integrationId] = state.instance.provider;
 		}
 		lastFailureAt = void 0;
 		return providers;
@@ -66241,6 +66276,7 @@ function channels(options = {}) {
 		return refresh();
 	};
 	const invocable = ((_context) => resolve());
+	invocable.getRoutes = () => states.flatMap((state) => state.instance.provider.getRoutes());
 	invocable.invalidate = () => {
 		cache = void 0;
 	};
@@ -66248,35 +66284,8 @@ function channels(options = {}) {
 	invocable.disconnect = async () => {
 		cache = void 0;
 	};
-	invocable.then = ((onfulfilled, onrejected) => resolve().then(onfulfilled, onrejected));
 	return invocable;
 }
-async function buildProvider(registration, connectionId, overrides, client) {
-	let credential;
-	try {
-		credential = await getCredential(client, connectionId);
-	} catch (error) {
-		console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
-		return;
-	}
-	let context = {
-		connectionId,
-		client
-	};
-	try {
-		context = {
-			connectionId,
-			client,
-			context: await getConnectionContext(client, connectionId)
-		};
-	} catch {}
-	try {
-		return await registration.build(credential, overrides.providerOptions ?? {}, context);
-	} catch (error) {
-		console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
-		return;
-	}
-}
 /**
 * Selects the connection `channels()` should use for one provider.
 *