@mastra/connect 0.1.0 → 0.2.0-alpha.2

package/dist/registry.d.ts

@@ -1,33 +1,26 @@
 import type { ToolsInput } from '@mastra/core/agent';
-import { PROVIDERS } from './providers/index.js';
 import type { ProviderToolsOptions } from './toolset.js';
-/**
- * A provider registration. One entry per provider directory generated under
- * `packages/connect/src/providers/<integrationId>/` by the maintainer-only
- * `pnpm --filter @mastra/connect add-provider` command.
- *
- * `integrationId` is the Platform catalog id and the provider directory name.
- * Provider matching against project connections is by `integrationId` only;
- * `connect()` merges each matching provider's tools into one flat record.
- *
- * `envVar` is the fallback connection-id env var read at execute time when
- * no `connectionId` override is given and more than one active connection
- * exists on the project for this provider.
- */
-export interface ProviderRegistration {
+interface ProviderRegistrationBase {
+    /** Platform catalog id used to match project connections. */
     integrationId: string;
+    /** Fallback connection-id environment variable when more than one active connection exists. */
     envVar: string;
+}
+/** A provider whose checked-in tools call the Platform HTTP proxy. */
+export interface ProxyProviderRegistration extends ProviderRegistrationBase {
+    transport?: 'proxy';
     createTools: (options?: ProviderToolsOptions) => ToolsInput;
 }
+/** A provider whose tools are discovered from an MCP server through Platform. */
+export interface McpProviderRegistration extends ProviderRegistrationBase {
+    transport: 'mcp';
+}
+export type ProviderRegistration = ProxyProviderRegistration | McpProviderRegistration;
 /**
- * Providers with shipped toolsets. The list is assembled declaratively in the
- * generated `src/providers/index.ts` barrel — each generated provider module
- * exports a `ProviderRegistration` const, and the barrel collects them.
- * `connect()` reads this list and merges tools from every matching Platform
- * connection on the project. Providers with no matching connection yet are
- * kept and warned about once, so tools appear automatically once a connection
- * is attached.
+ * Providers with checked-in HTTP toolsets. MCP-backed providers are discovered
+ * from the Platform integration catalog at runtime.
  */
-export { PROVIDERS };
+export declare const PROVIDERS: readonly ProviderRegistration[];
 export declare function findRegistration(integrationId: string): ProviderRegistration | 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,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,UAAU,CAAC;CAC7D;AAED;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAExF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,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,SAAS,EAAE,SAAS,oBAAoB,EAAwB,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAExF"}

package/dist/runtime/model-output.d.ts

@@ -0,0 +1,29 @@
+interface GeneratedImage {
+    url?: string;
+    b64_json?: string;
+    revised_prompt?: string;
+}
+export interface ImageGenerationOutput {
+    data: GeneratedImage[];
+}
+type ImageModelOutputPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image-url';
+    url: string;
+} | {
+    type: 'image-data';
+    data: string;
+    mediaType: string;
+};
+/** Keeps generated image bytes out of JSON tool context while preserving them as model-native image input. */
+export declare function toImageGenerationModelOutput(output: ImageGenerationOutput): {
+    type: 'text';
+    value: string;
+} | {
+    type: 'content';
+    value: ImageModelOutputPart[];
+};
+export {};
+//# sourceMappingURL=model-output.d.ts.map

package/dist/runtime/model-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-output.d.ts","sourceRoot":"","sources":["../../src/runtime/model-output.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,EAAE,CAAC;CACxB;AAED,KAAK,oBAAoB,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAS5D,8GAA8G;AAC9G,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB;UAmBvD,MAAM;;;UAGR,SAAS;;EACzB"}

package/dist/runtime/platform-proxy.d.ts

@@ -10,7 +10,7 @@
  * rather than exploding at runtime.
  */
 import type { RequestContext } from '@mastra/core/request-context';
-import { type ConnectClientOptions } from '../client.js';
+import { type ConnectClientOptions, type ProxyRequestOptions } from '../client.js';
 /**
  * The shape of an individual request as templates author them — a strict
  * subset of the upstream proxy configuration containing only the fields the
@@ -18,20 +18,34 @@ import { type ConnectClientOptions } from '../client.js';
  */
 export interface PlatformProxyRequest {
     endpoint: string;
-    params?: Record<string, string | number | boolean | undefined>;
+    params?: NonNullable<ProxyRequestOptions['query']>;
     headers?: Record<string, string>;
     data?: unknown;
     /**
      * Retry hint from templates. We treat this as a soft ceiling — the platform
      * proxy already applies its own retry policy; templates that ask for `n`
      * retries get up to `n` transient retries here on network/5xx failures.
-     * Only honored for idempotent HTTP methods (GET/HEAD/PUT/DELETE): a POST or
-     * PATCH the provider may have already applied is never repeated.
+     * Honored for idempotent HTTP methods (GET/HEAD/PUT/DELETE), and for a POST
+     * or PATCH that carries an `Idempotency-Key` header, since the provider then
+     * deduplicates a replay. Any other POST or PATCH gets exactly one attempt.
      */
     retries?: number;
+    /** Provider base URL selected by the tool from connection config or metadata. */
+    baseUrlOverride?: string;
 }
 /** Templates treat provider response bodies as untyped JSON until they validate them. */
 type ProviderResponseData = ReturnType<typeof JSON.parse>;
+/**
+ * Connection facts as templates consume them. The upstream SDK types
+ * connection config and metadata values as `any` and vendored templates are
+ * written against that contract (they narrow with schema parses or truthiness
+ * checks), so the template-facing surface mirrors it. The package's own API
+ * (`ConnectionContext` in client.ts) stays strictly typed.
+ */
+export interface TemplateConnectionContext {
+    connection_config: Record<string, ProviderResponseData>;
+    metadata: Record<string, ProviderResponseData> | null;
+}
 /** Mirrors the upstream response shape closely enough for the templates we vendor. */
 export interface PlatformProxyResponse<T = ProviderResponseData> {
     data: T;
@@ -61,6 +75,21 @@ export interface PlatformProxy {
     put<T = ProviderResponseData>(config: PlatformProxyRequest): Promise<PlatformProxyResponse<T>>;
     patch<T = ProviderResponseData>(config: PlatformProxyRequest): Promise<PlatformProxyResponse<T>>;
     delete<T = ProviderResponseData>(config: PlatformProxyRequest): Promise<PlatformProxyResponse<T>>;
+    getConnection(): Promise<TemplateConnectionContext>;
+    /**
+     * Mirrors the upstream SDK contract templates are written against: always
+     * resolves to an object (empty when the connection has no metadata).
+     */
+    getMetadata<T = Record<string, ProviderResponseData>>(): Promise<T>;
+    /**
+     * Templates cache derived connection facts here (for example the Jira
+     * templates resolve and store the Atlassian `cloudId`/`baseUrl`). The
+     * platform connection record is not writable from a tool, so updates land
+     * in an in-memory overlay shared by every request-bound copy of the
+     * toolset's proxy: `getMetadata` reads through it, and a fresh process
+     * simply re-derives the values on its first call.
+     */
+    updateMetadata(update: Record<string, unknown>): Promise<void>;
     ActionError: typeof ToolActionError;
     log: (...args: unknown[]) => void;
     /**
@@ -76,6 +105,13 @@ interface CreatePlatformProxyOptions {
     connectionId?: string;
     client?: ConnectClientOptions;
     requestContext?: RequestContext;
+    /**
+     * Internal: the metadata overlay shared across request-bound copies of one
+     * toolset proxy. The connection id is fixed per proxy context, so the
+     * overlay is per-connection; revisit if connection resolution ever becomes
+     * request-scoped.
+     */
+    metadataOverlay?: Record<string, unknown>;
 }
 /**
  * Builds the platform proxy context shared by every tool of a provider

package/dist/runtime/platform-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-proxy.d.ts","sourceRoot":"","sources":["../../src/runtime/platform-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAA+B,KAAK,oBAAoB,EAA4B,MAAM,cAAc,CAAC;AAGhH;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yFAAyF;AACzF,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AAE1D,sFAAsF;AACtF,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,oBAAoB;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,YAAY,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAIlG;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,CAAC,GAAG,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAI,CAAC,CAAC,GAAG,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,GAAG,CAAC,CAAC,GAAG,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,KAAK,CAAC,CAAC,GAAG,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,CAAC,CAAC,GAAG,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,WAAW,EAAE,OAAO,eAAe,CAAC;IACpC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,mEAAmE;IACnE,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,aAAa,CAAC;CACnE;AAKD,UAAU,0BAA0B;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAuDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,CAkBtF"}
+{"version":3,"file":"platform-proxy.d.ts","sourceRoot":"","sources":["../../src/runtime/platform-proxy.ts"],"names":[],"mappings":"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"}

package/dist/runtime/redact.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Removes credential-like fields from a provider response before it leaves a
+ * tool. Generated tools apply this to results whose upstream contract carries
+ * secrets an agent never needs, such as webhook signing secrets. Only top-level
+ * fields are removed; nested objects are returned untouched.
+ */
+export declare function withoutSecretFields<T extends Record<string, unknown>, K extends string>(value: T, fields: readonly K[]): Omit<T, K>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/runtime/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/runtime/redact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,EACrF,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAIZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/connect",
-  "version": "0.1.0",
+  "version": "0.2.0-alpha.2",
   "description": "Use Mastra platform integration connections as agent toolsets",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
     "node": ">=22.13.0"
   },
   "peerDependencies": {
-    "@mastra/core": ">=1.0.0-0 <2.0.0-0",
+    "@mastra/core": ">=1.68.0-0 <2.0.0-0",
     "zod": ">=3.0.0 || >=4.0.0"
   },
   "devDependencies": {
@@ -53,11 +53,14 @@
     "tsdown": "0.22.9",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
-    "vitest": "4.1.10",
-    "zod": "^4.4.3",
+    "vitest": "4.1.11",
+    "zod": "^4.6.4",
     "@internal/lint": "0.0.133",
-    "@internal/types-builder": "0.0.108",
-    "@mastra/core": "1.67.0"
+    "@mastra/core": "1.68.0-alpha.6",
+    "@internal/types-builder": "0.0.108"
+  },
+  "dependencies": {
+    "@mastra/mcp": "^2.0.0-alpha.4"
   },
   "scripts": {
     "add-provider": "tsx scripts/add-provider.ts",