@mastra/connect 0.5.0-alpha.2 → 0.5.0

package/README.md

@@ -25,7 +25,19 @@ const tools = connect({
 });
 ```
 
-The resolver discovers active project connections. Where multiple connections match, select one with `MASTRA_RESEND_CONNECTION_ID`, `MASTRA_INCIDENT_IO_CONNECTION_ID`, or the integration's `connectionId` option. The `integrations` entries configure individual providers; they do not disable other attached providers. Set `disabled: true` on providers you want to exclude.
+The `integrations` option accepts two shapes. Use the string-array shorthand when you don't need per-provider overrides:
+
+```ts
+const tools = connect({
+  projectId: process.env.MASTRA_PROJECT_ID,
+  client: { accessToken: process.env.MASTRA_PLATFORM_ACCESS_TOKEN },
+  integrations: ['resend', 'incident-io'],
+});
+```
+
+Use the object form (shown above) whenever you need `allowTools`, `disallowTools`, `autoApproveTools`, `connectionId`, or `disabled` for any provider. `allowTools` and `disallowTools` are mutually exclusive on the same provider.
+
+The resolver discovers active project connections. Where multiple connections match, you can either pin one — via `MASTRA_RESEND_CONNECTION_ID`, `MASTRA_INCIDENT_IO_CONNECTION_ID`, or the integration's `connectionId` option — or leave it unpinned and let the agent route each call. When unpinned, the provider's `<integrationId>__list_connections` tool is added to the toolset, every other tool takes a required `connection_name`, and the agent uses the display name returned by `list_connections` to pick a connection per call. The `integrations` entries configure individual providers; they do not disable other attached providers. Set `disabled: true` on providers you want to exclude.
 
 | Provider    | Tool source          | Scope                                                                                                                                                     |
 | ----------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |

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' | 'no_active_connection' | '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' | 'unknown_connection';
 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,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"}
+{"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,GAIhB,oBAAoB,CAAC;AAIzB,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"}