@mastra/connect 1.0.0-alpha.2 → 1.0.0

package/dist/instrumentation.d.ts

@@ -0,0 +1,48 @@
+import { SpanType } from '@mastra/core/observability';
+import type { Span } from '@mastra/core/observability';
+/**
+ * Observability for outbound connect HTTP: every platform API call and every
+ * vendor call routed through the connection proxy gets a GENERIC child span
+ * under the ambient current span (the TOOL_CALL span during tool execution,
+ * or whatever span is active during resolver refreshes).
+ *
+ * Resolution uses core's browser-safe `resolveCurrentSpan`, which returns
+ * `undefined` until the Mastra constructor initializes context storage — so
+ * apps without observability configured pay nothing and nothing throws.
+ *
+ * Privacy invariant: spans carry method, a safe route template, connection id,
+ * and response status only. Never record query strings, headers, request
+ * bodies, response bodies, or vendor path segments — proxy paths are built by
+ * generated templates and can embed credentials or resource identifiers (e.g.
+ * HubSpot's whoami interpolates the access token into its endpoint path).
+ */
+export interface PlatformCallDescriptor {
+    method: string;
+    /**
+     * Safe route template: connection/project ids replaced with placeholders
+     * and everything after `/proxy/` collapsed to `*` so vendor-controlled
+     * path segments (which may embed secrets or PII) never enter spans.
+     */
+    route: string;
+    isProxy: boolean;
+    connectionId?: string;
+    projectId?: string;
+}
+/** Describes a platform request for span naming without leaking query params, ids, or vendor path segments. */
+export declare function describePlatformCall(method: string, rawPath: string): PlatformCallDescriptor;
+/**
+ * Starts a GENERIC child span for an outbound connect HTTP call, or returns
+ * `undefined` when no ambient span is active. Span creation failures are
+ * swallowed: instrumentation must never break a request.
+ */
+export declare function startPlatformCallSpan(descriptor: PlatformCallDescriptor): Span<SpanType.GENERIC> | undefined;
+/** Ends a platform-call span with the response status. Never throws. */
+export declare function endPlatformCallSpan(span: Span<SpanType.GENERIC> | undefined, status: number): void;
+/**
+ * Records a transport-level failure on a platform-call span. Nothing from the
+ * original error is recorded — fetch failures can embed the request URL in
+ * both `message` and `name`, which may carry secret query params — so the
+ * span gets a fixed, constant error. Never throws.
+ */
+export declare function errorPlatformCallSpan(span: Span<SpanType.GENERIC> | undefined, _error: unknown): void;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,+GAA+G;AAC/G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAqB5F;AAUD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAkB5G;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOlG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAOrG"}

package/dist/multi-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-connection.d.ts","sourceRoot":"","sources":["../src/multi-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAGxF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6HAA6H;IAC7H,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,eAAe,EAAE,CA8BrF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,eAAe,EAAE,EAC9B,cAAc,EAAE,MAAM,GACrB,MAAM,CAgBR;AAiLD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAkDD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B,GAAG,UAAU,CAyCb;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,YAAY,EAAE,uBAAuB,CAAC;IACtC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5F,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkHtB"}
+{"version":3,"file":"multi-connection.d.ts","sourceRoot":"","sources":["../src/multi-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3F,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAGxF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,6HAA6H;IAC7H,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,eAAe,EAAE,CA8BrF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,eAAe,EAAE,EAC9B,cAAc,EAAE,MAAM,GACrB,MAAM,CAgBR;AAiLD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEpE;AAkDD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,YAAY,EAAE,yBAAyB,CAAC;IACxC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B,GAAG,UAAU,CAyCb;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,YAAY,EAAE,uBAAuB,CAAC;IACtC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5F,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyHtB"}

package/dist/providers/jira/tools/get-create-issue-metadata.d.ts

@@ -13,6 +13,27 @@ export declare const getCreateIssueMetadataOutputSchema: z.ZodObject<{
         name: z.ZodString;
         self: z.ZodOptional<z.ZodString>;
         avatarUrls: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        issuetypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            self: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            iconUrl: z.ZodOptional<z.ZodString>;
+            avatarId: z.ZodOptional<z.ZodNumber>;
+            subtask: z.ZodOptional<z.ZodBoolean>;
+            hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+            fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                name: z.ZodOptional<z.ZodString>;
+                key: z.ZodOptional<z.ZodString>;
+                hasDefaultValue: z.ZodOptional<z.ZodBoolean>;
+                operations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                allowedValues: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+                defaultValue: z.ZodOptional<z.ZodUnknown>;
+                autoCompleteUrl: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare function getCreateIssueMetadataTool(proxy: PlatformProxy): import("@mastra/core/tools").Tool<{
@@ -27,6 +48,27 @@ export declare function getCreateIssueMetadataTool(proxy: PlatformProxy): import
         name: string;
         self?: string | undefined;
         avatarUrls?: Record<string, string> | undefined;
+        issuetypes?: {
+            id: string;
+            name: string;
+            self?: string | undefined;
+            description?: string | undefined;
+            iconUrl?: string | undefined;
+            avatarId?: number | undefined;
+            subtask?: boolean | undefined;
+            hierarchyLevel?: number | undefined;
+            fields?: Record<string, {
+                required?: boolean | undefined;
+                schema?: Record<string, unknown> | undefined;
+                name?: string | undefined;
+                key?: string | undefined;
+                hasDefaultValue?: boolean | undefined;
+                operations?: string[] | undefined;
+                allowedValues?: unknown[] | undefined;
+                defaultValue?: unknown;
+                autoCompleteUrl?: string | undefined;
+            }> | undefined;
+        }[] | undefined;
     }[] | undefined;
 }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "jira_get_create_issue_metadata", unknown>;
 //# sourceMappingURL=get-create-issue-metadata.d.ts.map

package/dist/providers/jira/tools/get-create-issue-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-create-issue-metadata.d.ts","sourceRoot":"","sources":["../../../../src/providers/jira/tools/get-create-issue-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,eAAO,MAAM,iCAAiC;;;;;iBAa5C,CAAC;AAcH,eAAO,MAAM,kCAAkC;;;;;;;;iBAE7C,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;;8IA8D9D"}
+{"version":3,"file":"get-create-issue-metadata.d.ts","sourceRoot":"","sources":["../../../../src/providers/jira/tools/get-create-issue-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,eAAO,MAAM,iCAAiC;;;;;iBAa5C,CAAC;AAuCH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAE7C,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8IA8D9D"}

package/dist/providers/jira/tools/list-issue-types.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
 import type { PlatformProxy } from '../../../runtime/platform-proxy.js';
-export declare const listIssueTypesInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const listIssueTypesInputSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const listIssueTypesOutputSchema: z.ZodObject<{
     issueTypes: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -12,7 +14,9 @@ export declare const listIssueTypesOutputSchema: z.ZodObject<{
         hierarchyLevel: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare function listIssueTypesTool(proxy: PlatformProxy): import("@mastra/core/tools").Tool<Record<string, never>, {
+export declare function listIssueTypesTool(proxy: PlatformProxy): import("@mastra/core/tools").Tool<{
+    projectId?: string | undefined;
+}, {
     issueTypes: {
         id: string;
         name: string;

package/dist/providers/jira/tools/list-issue-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-issue-types.d.ts","sourceRoot":"","sources":["../../../../src/providers/jira/tools/list-issue-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,oCAAoC,CAAC;AAO9F,eAAO,MAAM,yBAAyB,gCAEpC,CAAC;AAYH,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAYrC,CAAC;AAUH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;qIA0FtD"}
+{"version":3,"file":"list-issue-types.d.ts","sourceRoot":"","sources":["../../../../src/providers/jira/tools/list-issue-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,oCAAoC,CAAC;AAO9F,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AAYH,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAYrC,CAAC;AAUH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa;;;;;;;;;;;;qIAsGtD"}

package/dist/registry.d.ts

@@ -4,7 +4,7 @@ import type { ProviderToolsOptions } from './toolset.js';
 interface ProviderRegistrationBase {
     /** Platform catalog id used to match project connections. */
     integrationId: string;
-    /** Fallback connection-id environment variable when more than one active connection exists. */
+    /** Legacy connection-id env fallback; kept working but intentionally undocumented. */
     envVar: string;
 }
 /** A provider whose checked-in tools call the Platform HTTP proxy. */
@@ -21,19 +21,12 @@ export type ProviderRegistration = ProxyProviderRegistration | McpProviderRegist
  * Providers with checked-in HTTP toolsets. MCP-backed providers are discovered
  * from the Platform integration catalog at runtime.
  */
-export declare const TOOLS: readonly ProviderRegistration[];
-/**
- * @deprecated Use `TOOLS`. This alias is retained for one release cycle so
- * downstream consumers keep working; it will be removed in the next minor.
- */
 export declare const PROVIDERS: readonly ProviderRegistration[];
-export declare function findRegistration(integrationId: string): ProviderRegistration | undefined;
 /**
  * Channel-capable providers with a hand-maintained `channels()` registration.
  * The launch ships three (Slack, Telegram, Discord); the provider generator
  * grows to cover new entries when a fourth lands.
  */
 export declare const CHANNELS: readonly ChannelProviderRegistration[];
-export declare function findChannelRegistration(integrationId: string): ChannelProviderRegistration | undefined;
 export {};
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,UAAU,wBAAwB;IAChC,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,UAAU,CAAC;CAC7D;AAED,iFAAiF;AACjF,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,SAAS,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,SAAS,oBAAoB,EAAwB,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,oBAAoB,EAAU,CAAC;AAEhE,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAExF;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,2BAA2B,EAAkB,CAAC;AAE9E,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEtG"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,UAAU,wBAAwB;IAChC,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,UAAU,CAAC;CAC7D;AAED,iFAAiF;AACjF,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,SAAS,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAEvF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,oBAAoB,EAAwB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,2BAA2B,EAAkB,CAAC"}

package/dist/resolution.d.ts

@@ -3,22 +3,14 @@ import type { NamedConnection } from './multi-connection.js';
 /** Identifies one provider's connection-resolution inputs. */
 export interface ConnectionRequest {
     integrationId: string;
-    /** Fallback connection-id environment variable when more than one active connection exists. */
+    /** Legacy connection-id env fallback; kept working but intentionally undocumented. */
     envVar: string;
     /** Pinned connection id from per-integration options. */
     connectionId?: string;
 }
-export declare function validateIntegrationOverrides(integrations: Record<string, unknown> | undefined): void;
+export declare function validateProviderIds(providers: Record<string, unknown> | undefined): void;
 export declare function connectionIdEnvVar(integrationId: string): string;
 export declare function groupByIntegrationId(connections: ProjectConnection[]): Map<string, ProjectConnection[]>;
-/**
- * Resolves the connection to use for one provider, per the contract:
- * option/env var wins; else a single active connection; anything else
- * (ambiguity, needs_reauth, no usable candidate) warns and skips so one bad
- * integration never takes down the whole resolution. A needs_reauth
- * connection is never silently mapped.
- */
-export declare function resolveConnection(request: ConnectionRequest, candidates: ProjectConnection[]): string | undefined;
 /**
  * Discriminated resolution of one provider request against its candidate
  * connections. `single` maps to unwrapped tools with the connection id baked
@@ -36,7 +28,7 @@ export type ProviderResolution = {
 };
 /**
  * Resolves how to configure one provider given its candidate connections:
- *   - An explicit pin (option or env var) forces `single` at that id.
+ *   - An explicit pin (`connectionId`) forces `single` at that id.
  *   - Exactly one active connection → `single`.
  *   - Two or more active connections → `multi`; the caller wraps tools with
  *     `connection_name` so the agent chooses per call at execute time.

package/dist/resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../src/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CASpG;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAQvG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,MAAM,GAAG,SAAS,CAoCjH;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,eAAe,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,iBAAiB,EAAE,GAC9B,kBAAkB,CAmCpB"}
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../src/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CASxF;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAQvG;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,eAAe,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,iBAAiB,EAAE,GAC9B,kBAAkB,CAmCpB"}

package/dist/tools.d.ts

@@ -1,5 +1,5 @@
 import type { ConnectClientOptions } from './client.js';
-interface ToolsIntegrationOptionsBase {
+interface ToolsProviderOptionsBase {
     /** Pin a specific connection id (bypasses env-var fallback and single-active-connection resolution). */
     connectionId?: string;
     /**
@@ -7,13 +7,13 @@ interface ToolsIntegrationOptionsBase {
      * and checked-in HTTP tools alike. Tools do not require approval by
      * default, matching `@mastra/mcp`'s own default. Pass `true` to require
      * approval for every tool on this provider, or an array of tool keys to
-     * require approval only for those tools. Unknown names in the array fail
-     * resolution with an `invalid_options` error so a typo never silently
-     * widens access. (Explicit `false` is equivalent to omitting the option.)
+     * require approval only for those tools; entries containing `*` are globs
+     * (e.g. `'linear_delete_*'`). Unknown names and globs that match nothing
+     * fail resolution with an `invalid_options` error so a typo never
+     * silently widens access. (Explicit `false` is equivalent to omitting the
+     * option.)
      */
     requireApproval?: boolean | string[];
-    /** Exclude this provider entirely, even if a connection exists. */
-    disabled?: boolean;
 }
 /**
  * Per-provider overrides. `allowTools` and `disallowTools` are mutually
@@ -21,30 +21,65 @@ interface ToolsIntegrationOptionsBase {
  * accidental co-occurrence in typed object literals; `tools()` also
  * validates at build time so loosely typed callers get a clear error.
  */
-export type ToolsIntegrationOptions = ToolsIntegrationOptionsBase & ({
-    /** Restrict the returned toolset to these tool keys. Unknown names throw at build time. */
+export type ToolsProviderOptions = ToolsProviderOptionsBase & ({
+    /**
+     * Restrict the returned toolset to these tool keys. Entries containing
+     * `*` are globs (e.g. `'linear_get_*'`). Unknown names and globs that
+     * match nothing throw at build time.
+     */
     allowTools?: string[];
     disallowTools?: never;
 } | {
     allowTools?: never;
-    /** Remove these tool keys from the returned toolset. Unknown names throw at build time. */
+    /**
+     * Remove these tool keys from the returned toolset. Entries containing
+     * `*` are globs (e.g. `'linear_delete_*'`). Unknown names and globs
+     * that match nothing throw at build time.
+     */
     disallowTools?: string[];
 });
 export interface ToolsOptions {
     /** Platform project whose connections to discover. Falls back to MASTRA_PROJECT_ID. */
     projectId?: string;
     /**
-     * Providers to enable, in one of two shapes:
-     * - `["linear", "github"]` — string array shorthand for enabling providers
-     *   with no per-provider options.
-     * - `{ linear: { allowTools: [...] }, github: { disallowTools: [...] } }` —
-     *   object form for per-provider overrides. Each provider may set at most
-     *   one of `allowTools` and `disallowTools`; supplying both throws.
+     * Which providers to resolve, in one of two shapes:
+     * - `["linear", "github"]` — an allowlist: only the listed providers
+     *   resolve, with default options. Anything else connected to the project
+     *   is ignored.
+     * - `{ linear: true, github: { allowTools: [...] }, notion: false }` —
+     *   per-provider configuration. Every connected provider still resolves
+     *   unless excluded: `true` (or `{}`) enables with defaults, `false`
+     *   excludes, and an options object configures tool filters, approval
+     *   policy, or a pinned connection. Each provider may set at most one of
+     *   `allowTools` and `disallowTools`; supplying both throws.
      *
-     * Both forms may be combined by passing the object form; use the array
-     * shorthand only when no overrides are needed.
+     * Omit the option entirely to resolve every provider the project has a
+     * connection for.
+     */
+    providers?: string[] | Record<string, boolean | ToolsProviderOptions>;
+    /**
+     * Default tool filter applied to every provider that does not set its own
+     * `allowTools`/`disallowTools`. Entries containing `*` are globs. Unlike
+     * the per-provider filters, defaults apply leniently: an entry that
+     * matches nothing on a given provider simply does not apply there (the
+     * provider set is live, so a default like `['*_get_*']` must tolerate
+     * providers without matching tools). An entry that matches nothing across
+     * the whole resolution logs a warning. Mutually exclusive with
+     * `disallowTools`. A provider that sets either filter option opts out of
+     * both defaults.
+     */
+    allowTools?: string[];
+    /** Default disallow filter; see {@link ToolsOptions.allowTools} for semantics. */
+    disallowTools?: string[];
+    /**
+     * Default tool-approval policy applied to every provider that does not set
+     * its own `requireApproval`. `true` gates every tool (except the synthetic
+     * `<provider>__list_connections` wrappers); an array gates matching keys,
+     * with the same lenient glob semantics as the default filters. A provider
+     * can opt out of a global `requireApproval: true` with
+     * `requireApproval: false`.
      */
-    integrations?: string[] | Record<string, ToolsIntegrationOptions>;
+    requireApproval?: boolean | string[];
     client?: ConnectClientOptions;
     /** How long a resolved snapshot stays fresh, in milliseconds. Default 30_000. `0` revalidates every resolution. */
     ttlMs?: number;
@@ -52,33 +87,54 @@ export interface ToolsOptions {
 type ResolvedToolsRecord = Record<string, {
     id: string;
 }>;
+/** Context Mastra passes when invoking the resolver as a dynamic `tools` argument. */
+export interface ToolsResolverContext {
+    requestContext?: unknown;
+    mastra?: unknown;
+}
+/**
+ * Tools accepted by {@link ToolsResolver.with}: a static tool record (e.g.
+ * `createTool()` outputs) or a function — sync or async, optionally reading
+ * the per-request context — returning one.
+ */
+export type ToolsWithInput = Record<string, {
+    id: string;
+}> | ((ctx?: ToolsResolverContext) => Record<string, {
+    id: string;
+}> | Promise<Record<string, {
+    id: string;
+}>>);
 /**
  * Live tool resolver returned by `tools()`. Pass it straight to an agent's
- * dynamic `tools` argument: Mastra calls it per generate/stream, so project
- * integrations attached or detached on the platform are reflected without
+ * dynamic `tools` argument: Mastra calls it per generate/stream, so providers
+ * connected or disconnected on the platform are reflected without
  * restarting the server. Call it directly (`await tools()`) when you need the
  * current flat tool record.
  */
 export interface ToolsResolver {
-    (ctx?: {
-        requestContext?: unknown;
-        mastra?: unknown;
-    }): Promise<ResolvedToolsRecord>;
-    /** Drops the cached snapshot; the next resolution fetches fresh from the platform. */
-    invalidate(): void;
+    (ctx?: ToolsResolverContext): Promise<ResolvedToolsRecord>;
     /** Fetches tools from the platform now and updates the cache. Rejects if the platform fetch fails. */
     refresh(): Promise<ResolvedToolsRecord>;
     /** Closes MCP transports owned by this resolver and clears its cached snapshot. */
     disconnect(): Promise<void>;
+    /**
+     * Returns a new resolver that merges `extra` tools into every resolution,
+     * so an agent can combine its own tools with connect tools in one
+     * expression: `tools: connectTools.with({ weatherTool })`. On a key
+     * collision the extra tools win — connect keys are provider-prefixed, so
+     * collisions only happen deliberately. The cache handles (`refresh`,
+     * `disconnect`) delegate to the base resolver, and `.with()` calls chain.
+     */
+    with(extra: ToolsWithInput): ToolsResolver;
 }
 /**
  * Returns a live toolset resolver over the project's Platform connections.
- * HTTP providers are loaded from the shipped `TOOLS` registry. MCP providers
+ * HTTP providers are loaded from the shipped `PROVIDERS` registry. MCP providers
  * are discovered from the Platform integration catalog. Tools from every supported
  * provider with a matching project connection are merged into one flat record
  * (matched by `integrationId`). The resolver serves a cached snapshot,
- * revalidating from the platform every `ttlMs`, so integrations attached
- * to (or detached from) the project are picked up (or dropped) without a
+ * revalidating from the platform every `ttlMs`, so providers connected
+ * to (or disconnected from) the project are picked up (or dropped) without a
  * restart.
  *
  * Configuration errors (missing project id, bad ttlMs, malformed integration id,

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAA8D,MAAM,aAAa,CAAC;AAkBpH,UAAU,2BAA2B;IACnC,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAC/D,CACI;IACE,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CACJ,CAAC;AAEJ,MAAM,WAAW,YAAY;IAC3B,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mHAAmH;IACnH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,KAAK,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrF,sFAAsF;IACtF,UAAU,IAAI,IAAI,CAAC;IACnB,sGAAsG;IACtG,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxC,mFAAmF;IACnF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,aAAa,CAwI/D"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAA8D,MAAM,aAAa,CAAC;AAkBpH,UAAU,wBAAwB;IAChC,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GACzD,CACI;IACE;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CACJ,CAAC;AAEJ,MAAM,WAAW,YAAY;IAC3B,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CAAC,CAAC;IACtE;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mHAAmH;IACnH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,KAAK,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1D,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9B,CAAC,CAAC,GAAG,CAAC,EAAE,oBAAoB,KAAK,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC,CAAC;AAE/G;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3D,sGAAsG;IACtG,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxC,mFAAmF;IACnF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAAC;CAC5C;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,aAAa,CA4J/D"}

package/dist/toolset.d.ts

@@ -3,9 +3,9 @@ import type { z } from 'zod';
 import type { ConnectClientOptions, ProxyRequestOptions } from './client.js';
 interface ProviderToolsOptionsBase {
     /**
-     * Connection to use. `connect()` always supplies one (resolving the
-     * registration's env var itself); direct `create<Provider>Tools` callers
-     * must pass it or tool calls fail with `missing_connection_id`.
+     * Connection to use. `tools()` always supplies one; direct
+     * `create<Provider>Tools` callers must pass it or tool calls fail with
+     * `missing_connection_id`.
      */
     connectionId?: string;
     client?: ConnectClientOptions;
@@ -17,15 +17,23 @@ interface ProviderToolsOptionsBase {
  * callers still get a clear error instead of silent surprising behavior.
  */
 export type ProviderToolsOptions = ProviderToolsOptionsBase & ({
-    /** Restrict the returned toolset to these tool keys. Unknown names throw immediately. */
+    /**
+     * Restrict the returned toolset to these tool keys. Entries containing
+     * `*` are globs (e.g. `'linear_get_*'`). Unknown names and globs that
+     * match nothing throw immediately.
+     */
     allowTools?: string[];
     disallowTools?: never;
 } | {
     allowTools?: never;
-    /** Remove these tool keys from the returned toolset. Unknown names throw immediately. */
+    /**
+     * Remove these tool keys from the returned toolset. Entries containing
+     * `*` are globs (e.g. `'linear_delete_*'`). Unknown names and globs
+     * that match nothing throw immediately.
+     */
     disallowTools?: string[];
 });
-/** Resolves a connection id lazily at execute time: option → env var → typed error naming the env var. */
+/** Resolves a connection id lazily at execute time: explicit option first, then a legacy env fallback. */
 export declare function resolveConnectionId(envVar: string, connectionId?: string): string;
 export interface ProxyToolConfig<TIn, TOut> {
     id: string;
@@ -48,16 +56,34 @@ export interface ProxyToolContext {
  */
 export declare function defineProxyTool<TIn, TOut>(context: ProxyToolContext, config: ProxyToolConfig<TIn, TOut>): import("@mastra/core/tools").Tool<TIn, TOut, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, string, unknown>;
 /**
- * Filters a toolset by tool key. Throws at build time on unknown names so
- * typos in access-limiting config surface immediately.
+ * Returns a predicate testing tool keys against filter `entries`, where an
+ * entry containing `*` is a glob and anything else matches literally. Used
+ * where keys are only known later (MCP approval predicates); list-shaped
+ * call sites expand eagerly with {@link expandToolPatterns} instead.
+ */
+export declare function compileToolMatcher(entries: string[]): (toolKey: string) => boolean;
+/**
+ * Expands `*` glob entries against the known tool keys, preserving order and
+ * de-duplicating. Literal entries pass through untouched (callers validate
+ * those against their own key sets). A glob that matches nothing throws:
+ * like an unknown literal name, a dead pattern in access-limiting config is
+ * a typo that must surface instead of silently filtering nothing.
+ */
+export declare function expandToolPatterns(entries: string[], knownKeys: string[], label: string): string[];
+/**
+ * Filters a toolset by tool key. Entries containing `*` are globs expanded
+ * against the toolset's keys. Throws at build time on unknown names and on
+ * globs that match nothing, so typos in access-limiting config surface
+ * immediately.
  */
-export declare function applyAllowTools<T extends ToolsInput>(tools: T, allowTools?: string[]): ToolsInput;
+export declare function applyAllowTools<T extends ToolsInput>(tools: T, allowToolsInput?: string[]): ToolsInput;
 /**
- * Removes tool keys from a toolset. Throws at build time on unknown names so
- * typos in access-limiting config surface immediately instead of silently
- * removing nothing.
+ * Removes tool keys from a toolset. Entries containing `*` are globs
+ * expanded against the toolset's keys. Throws at build time on unknown names
+ * and on globs that match nothing, so typos in access-limiting config
+ * surface immediately instead of silently removing nothing.
  */
-export declare function applyDisallowTools<T extends ToolsInput>(tools: T, disallowTools?: string[]): ToolsInput;
+export declare function applyDisallowTools<T extends ToolsInput>(tools: T, disallowToolsInput?: string[]): ToolsInput;
 /**
  * Applies whichever of `allowTools` or `disallowTools` was configured on a
  * provider. Rejects at build time when both are set so a caller who bypasses

package/dist/toolset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../src/toolset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI7E,UAAU,wBAAwB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GACzD,CACI;IACE,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CACJ,CAAC;AAEJ,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED,MAAM,WAAW,eAAe,CAAC,GAAG,EAAE,IAAI;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,mBAAmB,CAAC;IAC7C,qEAAqE;IACrE,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,iKAavG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAYjG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAcvG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAClD,KAAK,EAAE,CAAC,EACR,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D,UAAU,CAYZ"}
+{"version":3,"file":"toolset.d.ts","sourceRoot":"","sources":["../src/toolset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI7E,UAAU,wBAAwB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GACzD,CACI;IACE;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACD;IACE,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CACJ,CAAC;AAEJ,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED,MAAM,WAAW,eAAe,CAAC,GAAG,EAAE,IAAI;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,mBAAmB,CAAC;IAC7C,qEAAqE;IACrE,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,iKAavG;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAQlF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuBlG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAatG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAe5G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAClD,KAAK,EAAE,CAAC,EACR,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D,UAAU,CAYZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/connect",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0",
   "description": "Use Mastra platform integration connections as agent toolsets",
   "type": "module",
   "main": "./dist/index.js",
@@ -56,16 +56,16 @@
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
     "zod": "^4.6.4",
-    "@internal/lint": "0.0.140",
-    "@internal/types-builder": "0.0.115",
-    "@mastra/core": "1.75.0-alpha.5"
+    "@internal/types-builder": "0.0.116",
+    "@mastra/core": "1.75.0",
+    "@internal/lint": "0.0.141"
   },
   "dependencies": {
-    "@mastra/mcp": "^2.2.0-alpha.1",
-    "@mastra/discord": "^1.3.0-alpha.0",
-    "@mastra/teams": "^0.1.0",
-    "@mastra/slack": "^1.7.2-alpha.0",
-    "@mastra/telegram": "^0.2.2-alpha.0"
+    "@mastra/mcp": "^2.2.0",
+    "@mastra/slack": "^1.7.2",
+    "@mastra/telegram": "^0.2.2",
+    "@mastra/teams": "^0.1.1",
+    "@mastra/discord": "^1.3.0"
   },
   "scripts": {
     "add-provider": "tsx scripts/add-provider.ts",

package/dist/connect.d.ts

@@ -1,22 +0,0 @@
-import type { ToolsIntegrationOptions, ToolsOptions, ToolsResolver } from './tools.js';
-/**
- * @deprecated Renamed to {@link ToolsIntegrationOptions}.
- */
-export type ConnectIntegrationOptions = ToolsIntegrationOptions;
-/**
- * @deprecated Renamed to {@link ToolsOptions}.
- */
-export type ConnectOptions = ToolsOptions;
-/**
- * @deprecated Renamed to {@link ToolsResolver}.
- */
-export type ConnectTools = ToolsResolver;
-/**
- * @deprecated Renamed to {@link tools}.
- *
- * `connect(options)` is a drop-in alias for `tools(options)`. Prefer `tools`
- * from `@mastra/connect` in new code; this export will be removed in the next
- * minor version.
- */
-export declare function connect(options?: ConnectOptions): ConnectTools;
-//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,YAAY,CAElE"}

package/dist/environment.d.ts

@@ -1,48 +0,0 @@
-import type { SandboxStartHook } from '@mastra/core/workspace';
-import type { ConnectClientOptions } from './client.js';
-export interface EnvironmentIntegrationOptions {
-    /** Pin a specific connection id (bypasses env-var fallback and single-active-connection resolution). */
-    connectionId?: string;
-    /** Exclude this provider entirely, even if a connection exists. */
-    disabled?: boolean;
-}
-export interface EnvironmentOptions {
-    /** Platform project whose connections to discover. Falls back to MASTRA_PROJECT_ID. */
-    projectId?: string;
-    /** Optional per-provider overrides keyed by integrationId. */
-    integrations?: Record<string, EnvironmentIntegrationOptions>;
-    client?: ConnectClientOptions;
-}
-/**
- * Sandbox credentials materialized from the project's Platform connections.
- * Pass `env` into the sandbox's environment and `onStart` as (or inside) its
- * start hook so CLI tooling in the sandbox is authenticated out of the box.
- */
-export interface ConnectEnvironment {
-    /** Environment variables to inject into the sandbox (e.g. GH_TOKEN). Never log these. */
-    env: Record<string, string | undefined>;
-    /** Runs provider setup inside the sandbox (e.g. git credential wiring). Safe no-op when nothing to do. */
-    onStart: SandboxStartHook;
-}
-/**
- * Resolves the project's Platform connections into sandbox credentials:
- * environment variables plus a start hook that finishes in-sandbox setup.
- * Currently GitHub-aware (`GH_TOKEN`/`GITHUB_TOKEN` + git credential helper);
- * more providers plug in over time.
- *
- * Connection resolution matches `connect()`: a per-integration `connectionId`
- * or the provider's `MASTRA_*_CONNECTION_ID` env var wins, else a single
- * active connection; ambiguity, needs_reauth, and credential-fetch failures
- * warn and skip that provider. Configuration errors (missing project id,
- * malformed integration id) throw here so they surface at startup.
- *
- * The returned `env` is a snapshot: call `environment()` again for a fresh
- * token when starting new sandboxes.
- *
- * @example
- * const { env, onStart } = await environment({ projectId });
- * const sandbox = new E2BSandbox({ env, onStart });
- * // in the sandbox: `gh pr list`, `git clone https://github.com/org/repo` just work
- */
-export declare function environment(options?: EnvironmentOptions): Promise<ConnectEnvironment>;
-//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,aAAa,CAAC;AAK9E,MAAM,WAAW,6BAA6B;IAC5C,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,0GAA0G;IAC1G,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAyDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuD/F"}