@mastra/factory 0.0.0-fix-thread-subscription-multi-instance-redis-streams-20260730204150

package/dist/storage/domains/intake/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":["#db"],"sources":["../../../../src/storage/domains/intake/base.ts"],"sourcesContent":["/**\n * Per-user intake selections for every configured intake integration.\n *\n * Integration ids are dynamic. Each integration contributes provider-neutral\n * sources through `FactoryIntegration.intake`; this domain only persists which\n * source ids the user selected.\n */\n\nimport { FactoryStorageDomain, UniqueViolationError } from '@mastra/core/storage';\nimport type { CollectionSchema, FactoryStorageOps } from '@mastra/core/storage';\n\nexport interface IntakeSelection {\n  enabled: boolean;\n  /** Provider-owned source ids; `null` means nothing is selected. */\n  sourceIds: string[] | null;\n}\n\nexport type IntakeConfig = Record<string, IntakeSelection>;\n\nexport const DEFAULT_INTAKE_CONFIG: IntakeConfig = {};\n\nexport const INTAKE_SETTINGS_SCHEMA: CollectionSchema = {\n  name: 'intake_settings',\n  columns: {\n    id: { type: 'uuid-pk' },\n    org_id: { type: 'text' },\n    user_id: { type: 'text' },\n    config: { type: 'json' },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [{ name: 'intake_settings_org_user_unique', columns: ['org_id', 'user_id'] }],\n};\n\nexport class IntakeStorage extends FactoryStorageDomain {\n  constructor() {\n    super('intake');\n  }\n\n  async init(): Promise<void> {\n    await this.ensureCollections([INTAKE_SETTINGS_SCHEMA]);\n  }\n\n  async dangerouslyClearAll(): Promise<void> {\n    await this.ops.deleteMany('intake_settings', {});\n  }\n\n  get #db(): FactoryStorageOps {\n    return this.ops;\n  }\n\n  async getConfig({\n    orgId,\n    userId,\n    integrationIds,\n  }: {\n    orgId: string;\n    userId: string;\n    /**\n     * When provided, the result contains exactly these integration ids, with\n     * unset integrations defaulting to `{ enabled: true, sourceIds: null }`.\n     */\n    integrationIds?: string[];\n  }): Promise<IntakeConfig> {\n    const row = await this.#db.findOne<{ config: IntakeConfig }>('intake_settings', {\n      org_id: orgId,\n      user_id: userId,\n    });\n    const saved = structuredClone(row?.config ?? DEFAULT_INTAKE_CONFIG);\n    if (!integrationIds) return saved;\n    return Object.fromEntries(\n      integrationIds.map(integrationId => [integrationId, saved[integrationId] ?? { enabled: true, sourceIds: null }]),\n    );\n  }\n\n  async saveConfig({ orgId, userId, config }: { orgId: string; userId: string; config: IntakeConfig }): Promise<void> {\n    const now = new Date();\n    const where = { org_id: orgId, user_id: userId };\n    const updated = await this.#db.updateMany('intake_settings', where, { config, updated_at: now });\n    if (updated > 0) return;\n    try {\n      await this.#db.insertOne('intake_settings', { ...where, config, created_at: now, updated_at: now });\n    } catch (error) {\n      if (!(error instanceof UniqueViolationError)) throw error;\n      await this.#db.updateMany('intake_settings', where, { config, updated_at: now });\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAmBA,MAAa,wBAAsC,CAAC;AAEpD,MAAa,yBAA2C;CACtD,MAAM;CACN,SAAS;EACP,IAAI,EAAE,MAAM,UAAU;EACtB,QAAQ,EAAE,MAAM,OAAO;EACvB,SAAS,EAAE,MAAM,OAAO;EACxB,QAAQ,EAAE,MAAM,OAAO;EACvB,YAAY,EAAE,MAAM,YAAY;EAChC,YAAY,EAAE,MAAM,YAAY;CAClC;CACA,eAAe,CAAC;EAAE,MAAM;EAAmC,SAAS,CAAC,UAAU,SAAS;CAAE,CAAC;AAC7F;AAEA,IAAa,gBAAb,cAAmC,qBAAqB;CACtD,cAAc;EACZ,MAAM,QAAQ;CAChB;CAEA,MAAM,OAAsB;EAC1B,MAAM,KAAK,kBAAkB,CAAC,sBAAsB,CAAC;CACvD;CAEA,MAAM,sBAAqC;EACzC,MAAM,KAAK,IAAI,WAAW,mBAAmB,CAAC,CAAC;CACjD;CAEA,IAAIA,MAAyB;EAC3B,OAAO,KAAK;CACd;CAEA,MAAM,UAAU,EACd,OACA,QACA,kBASwB;EACxB,MAAM,MAAM,MAAM,KAAKA,IAAI,QAAkC,mBAAmB;GAC9E,QAAQ;GACR,SAAS;EACX,CAAC;EACD,MAAM,QAAQ,gBAAgB,KAAK,UAAU,qBAAqB;EAClE,IAAI,CAAC,gBAAgB,OAAO;EAC5B,OAAO,OAAO,YACZ,eAAe,KAAI,kBAAiB,CAAC,eAAe,MAAM,kBAAkB;GAAE,SAAS;GAAM,WAAW;EAAK,CAAC,CAAC,CACjH;CACF;CAEA,MAAM,WAAW,EAAE,OAAO,QAAQ,UAAkF;EAClH,MAAM,sBAAM,IAAI,KAAK;EACrB,MAAM,QAAQ;GAAE,QAAQ;GAAO,SAAS;EAAO;EAE/C,IAAI,MADkB,KAAKA,IAAI,WAAW,mBAAmB,OAAO;GAAE;GAAQ,YAAY;EAAI,CAAC,IACjF,GAAG;EACjB,IAAI;GACF,MAAM,KAAKA,IAAI,UAAU,mBAAmB;IAAE,GAAG;IAAO;IAAQ,YAAY;IAAK,YAAY;GAAI,CAAC;EACpG,SAAS,OAAO;GACd,IAAI,EAAE,iBAAiB,uBAAuB,MAAM;GACpD,MAAM,KAAKA,IAAI,WAAW,mBAAmB,OAAO;IAAE;IAAQ,YAAY;GAAI,CAAC;EACjF;CACF;AACF"}

package/dist/storage/domains/integrations/base.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Generic integration storage — the default persistence surface for
+ * `FactoryIntegration`s.
+ *
+ * Most integrations persist the same three shapes: an org-owned OAuth
+ * **connection**, **subscriptions** binding external objects to
+ * sessions/threads, and per-`(org, user)` **settings**. This built-in domain
+ * stores all three in shared collections keyed by `integration_id`, so an
+ * integration author writes zero schema, zero DDL, and zero queries — and
+ * org scoping is enforced by construction through the pre-scoped handle
+ * returned by {@link IntegrationStorage.forIntegration}.
+ *
+ * Source-control integrations additionally use the shared, provider-scoped
+ * source-control domain for installations, projects, worktrees, and sandboxes.
+ *
+ * Payloads (`data` / `config`) are JSON documents typed per-integration via
+ * the handle's generics. JSON round-trips exactly what JSON can represent:
+ * store timestamps inside payloads as epoch millis or ISO strings, not
+ * `Date`s.
+ */
+import { FactoryStorageDomain } from '@mastra/core/storage';
+import type { CollectionSchema } from '@mastra/core/storage';
+export declare const INTEGRATION_CONNECTIONS_SCHEMA: CollectionSchema;
+export declare const INTEGRATION_SUBSCRIPTIONS_SCHEMA: CollectionSchema;
+export declare const INTEGRATION_SETTINGS_SCHEMA: CollectionSchema;
+/** An integration's org-owned connection (typically the OAuth grant). */
+export interface IntegrationConnection<TData> {
+    id: string;
+    orgId: string;
+    /** Who connected it (audit only). */
+    userId: string | null;
+    data: TData;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** A subscription binding an external object to a session/thread. */
+export interface IntegrationSubscription<TData> {
+    id: string;
+    orgId: string;
+    targetKey: string;
+    sessionId: string | null;
+    resourceId: string | null;
+    threadId: string | null;
+    sessionScope: string | null;
+    status: string;
+    data: TData;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type CreateIntegrationSubscriptionInput<TData> = {
+    orgId: string;
+    targetKey: string;
+    sessionId?: string | null;
+    resourceId?: string | null;
+    threadId?: string | null;
+    sessionScope?: string | null;
+    /** Defaults to `'active'`. */
+    status?: string;
+} & ({} extends TData ? {
+    data?: TData;
+} : {
+    data: TData;
+});
+/**
+ * Typed query surface pre-scoped to one `integration_id`. Every read and
+ * write is automatically filtered/stamped with the integration id, so an
+ * integration cannot reach another integration's rows.
+ */
+export interface IntegrationStorageHandle<TConnection = Record<string, unknown>, TSettings = Record<string, unknown>, TSubscription = Record<string, unknown>> {
+    readonly integrationId: string;
+    connections: {
+        /** The org's connection, or `null` when not connected. */
+        get(orgId: string): Promise<IntegrationConnection<TConnection> | null>;
+        /** Insert or replace the org's connection (one per org; `created_at` preserved on update). */
+        upsert(orgId: string, input: {
+            userId?: string | null;
+            data: TConnection;
+            metadata?: Record<string, unknown>;
+        }): Promise<void>;
+        /**
+         * Atomic read-modify-write of the connection's `data` payload (token
+         * rotation etc.). Returns the updated connection, or `null` when the org
+         * has no connection.
+         */
+        update(orgId: string, fn: (data: TConnection) => TConnection): Promise<IntegrationConnection<TConnection> | null>;
+        /** Remove the org's connection. Returns whether a row was deleted. */
+        delete(orgId: string): Promise<boolean>;
+    };
+    subscriptions: {
+        create(input: CreateIntegrationSubscriptionInput<TSubscription>): Promise<IntegrationSubscription<TSubscription>>;
+        /** All subscriptions for an external object (webhook fan-out), optionally filtered by status. */
+        listByTarget(targetKey: string, opts?: {
+            status?: string;
+        }): Promise<IntegrationSubscription<TSubscription>[]>;
+        listBySession(sessionId: string): Promise<IntegrationSubscription<TSubscription>[]>;
+        listByThread(resourceId: string, threadId: string): Promise<IntegrationSubscription<TSubscription>[]>;
+        updateStatus(id: string, status: string): Promise<void>;
+        delete(id: string): Promise<boolean>;
+        /** Targeted cleanup, always org-scoped. Returns the number of rows deleted. */
+        deleteWhere(where: {
+            orgId: string;
+            targetKey?: string;
+            sessionId?: string;
+        }): Promise<number>;
+    };
+    settings: {
+        /** The `(org, user)` config, or `null` when never saved. */
+        get(orgId: string, userId: string): Promise<TSettings | null>;
+        /** Upsert the `(org, user)` config (`created_at` preserved on update). */
+        save(orgId: string, userId: string, config: TSettings): Promise<void>;
+    };
+}
+/**
+ * The built-in generic integration domain, written once against the
+ * `FactoryStorageOps` surface — works on any `FactoryStorage` backend.
+ */
+export declare class IntegrationStorage extends FactoryStorageDomain {
+    #private;
+    constructor();
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    /** A typed handle pre-scoped to `integrationId`. */
+    forIntegration<TConnection = Record<string, unknown>, TSettings = Record<string, unknown>, TSubscription = Record<string, unknown>>(integrationId: string): IntegrationStorageHandle<TConnection, TSettings, TSubscription>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/storage/domains/integrations/base.d.ts.map

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

package/dist/storage/domains/integrations/base.js

@@ -0,0 +1,317 @@
+import { FactoryStorageDomain, UniqueViolationError } from "@mastra/core/storage";
+//#region src/storage/domains/integrations/base.ts
+/**
+* Generic integration storage — the default persistence surface for
+* `FactoryIntegration`s.
+*
+* Most integrations persist the same three shapes: an org-owned OAuth
+* **connection**, **subscriptions** binding external objects to
+* sessions/threads, and per-`(org, user)` **settings**. This built-in domain
+* stores all three in shared collections keyed by `integration_id`, so an
+* integration author writes zero schema, zero DDL, and zero queries — and
+* org scoping is enforced by construction through the pre-scoped handle
+* returned by {@link IntegrationStorage.forIntegration}.
+*
+* Source-control integrations additionally use the shared, provider-scoped
+* source-control domain for installations, projects, worktrees, and sandboxes.
+*
+* Payloads (`data` / `config`) are JSON documents typed per-integration via
+* the handle's generics. JSON round-trips exactly what JSON can represent:
+* store timestamps inside payloads as epoch millis or ISO strings, not
+* `Date`s.
+*/
+const INTEGRATION_CONNECTIONS_SCHEMA = {
+	name: "integration_connections",
+	columns: {
+		id: { type: "uuid-pk" },
+		integration_id: { type: "text" },
+		org_id: { type: "text" },
+		/** Who connected it (audit only — never scopes reads). */
+		user_id: {
+			type: "text",
+			nullable: true
+		},
+		data: { type: "json" },
+		metadata: { type: "json" },
+		created_at: { type: "timestamp" },
+		updated_at: { type: "timestamp" }
+	},
+	uniqueIndexes: [{
+		name: "integration_connections_integration_org_unique",
+		columns: ["integration_id", "org_id"]
+	}]
+};
+const INTEGRATION_SUBSCRIPTIONS_SCHEMA = {
+	name: "integration_subscriptions",
+	columns: {
+		id: { type: "uuid-pk" },
+		integration_id: { type: "text" },
+		org_id: { type: "text" },
+		/** Canonical external-object key the integration derives (e.g. `pr:{installation}:{repo}:{number}`). */
+		target_key: { type: "text" },
+		session_id: {
+			type: "text",
+			nullable: true
+		},
+		resource_id: {
+			type: "text",
+			nullable: true
+		},
+		thread_id: {
+			type: "text",
+			nullable: true
+		},
+		session_scope: {
+			type: "text",
+			nullable: true
+		},
+		status: { type: "text" },
+		data: { type: "json" },
+		created_at: { type: "timestamp" },
+		updated_at: { type: "timestamp" }
+	},
+	indexes: [{
+		name: "integration_subscriptions_target_idx",
+		columns: ["integration_id", "target_key"]
+	}, {
+		name: "integration_subscriptions_org_idx",
+		columns: ["integration_id", "org_id"]
+	}]
+};
+const INTEGRATION_SETTINGS_SCHEMA = {
+	name: "integration_settings",
+	columns: {
+		id: { type: "uuid-pk" },
+		integration_id: { type: "text" },
+		org_id: { type: "text" },
+		user_id: { type: "text" },
+		config: { type: "json" },
+		created_at: { type: "timestamp" },
+		updated_at: { type: "timestamp" }
+	},
+	uniqueIndexes: [{
+		name: "integration_settings_integration_org_user_unique",
+		columns: [
+			"integration_id",
+			"org_id",
+			"user_id"
+		]
+	}]
+};
+/**
+* The built-in generic integration domain, written once against the
+* `FactoryStorageOps` surface — works on any `FactoryStorage` backend.
+*/
+var IntegrationStorage = class extends FactoryStorageDomain {
+	constructor() {
+		super("integrations");
+	}
+	async init() {
+		await this.ensureCollections([
+			INTEGRATION_CONNECTIONS_SCHEMA,
+			INTEGRATION_SUBSCRIPTIONS_SCHEMA,
+			INTEGRATION_SETTINGS_SCHEMA
+		]);
+	}
+	async dangerouslyClearAll() {
+		await this.ops.deleteMany("integration_subscriptions", {});
+		await this.ops.deleteMany("integration_settings", {});
+		await this.ops.deleteMany("integration_connections", {});
+	}
+	get #db() {
+		return this.ops;
+	}
+	/** A typed handle pre-scoped to `integrationId`. */
+	forIntegration(integrationId) {
+		if (!integrationId) throw new Error("[IntegrationStorage] integrationId is required.");
+		const db = () => this.#db;
+		const scoped = { integration_id: integrationId };
+		const mapConnection = (row) => ({
+			id: row.id,
+			orgId: row.org_id,
+			userId: row.user_id,
+			data: row.data,
+			metadata: row.metadata ?? {},
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		});
+		const mapSubscription = (row) => ({
+			id: row.id,
+			orgId: row.org_id,
+			targetKey: row.target_key,
+			sessionId: row.session_id,
+			resourceId: row.resource_id,
+			threadId: row.thread_id,
+			sessionScope: row.session_scope,
+			status: row.status,
+			data: row.data,
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		});
+		return {
+			integrationId,
+			connections: {
+				get: async (orgId) => {
+					const row = await db().findOne("integration_connections", {
+						...scoped,
+						org_id: orgId
+					});
+					return row ? mapConnection(row) : null;
+				},
+				upsert: async (orgId, input) => {
+					const where = {
+						...scoped,
+						org_id: orgId
+					};
+					const update = async () => db().updateMany("integration_connections", where, {
+						user_id: input.userId ?? null,
+						data: input.data,
+						metadata: input.metadata ?? {},
+						updated_at: /* @__PURE__ */ new Date()
+					});
+					let lastError;
+					for (let attempt = 0; attempt < 2; attempt++) {
+						if (await update() > 0) return;
+						const now = /* @__PURE__ */ new Date();
+						try {
+							await db().insertOne("integration_connections", {
+								...where,
+								user_id: input.userId ?? null,
+								data: input.data,
+								metadata: input.metadata ?? {},
+								created_at: now,
+								updated_at: now
+							});
+							return;
+						} catch (error) {
+							if (!(error instanceof UniqueViolationError)) throw error;
+							lastError = error;
+						}
+					}
+					throw lastError;
+				},
+				update: async (orgId, fn) => {
+					const row = await db().updateAtomic("integration_connections", {
+						...scoped,
+						org_id: orgId
+					}, (current) => ({
+						data: fn(current.data),
+						updated_at: /* @__PURE__ */ new Date()
+					}));
+					return row ? mapConnection(row) : null;
+				},
+				delete: async (orgId) => {
+					return await db().deleteMany("integration_connections", {
+						...scoped,
+						org_id: orgId
+					}) > 0;
+				}
+			},
+			subscriptions: {
+				create: async (input) => {
+					const now = /* @__PURE__ */ new Date();
+					const row = await db().insertOne("integration_subscriptions", {
+						...scoped,
+						org_id: input.orgId,
+						target_key: input.targetKey,
+						session_id: input.sessionId ?? null,
+						resource_id: input.resourceId ?? null,
+						thread_id: input.threadId ?? null,
+						session_scope: input.sessionScope ?? null,
+						status: input.status ?? "active",
+						data: input.data ?? {},
+						created_at: now,
+						updated_at: now
+					});
+					return mapSubscription(row);
+				},
+				listByTarget: async (targetKey, opts) => {
+					return (await db().findMany("integration_subscriptions", {
+						...scoped,
+						target_key: targetKey,
+						...opts?.status !== void 0 ? { status: opts.status } : {}
+					}, { orderBy: [["created_at", "asc"]] })).map(mapSubscription);
+				},
+				listBySession: async (sessionId) => {
+					return (await db().findMany("integration_subscriptions", {
+						...scoped,
+						session_id: sessionId
+					}, { orderBy: [["created_at", "asc"]] })).map(mapSubscription);
+				},
+				listByThread: async (resourceId, threadId) => {
+					return (await db().findMany("integration_subscriptions", {
+						...scoped,
+						resource_id: resourceId,
+						thread_id: threadId
+					}, { orderBy: [["created_at", "asc"]] })).map(mapSubscription);
+				},
+				updateStatus: async (id, status) => {
+					await db().updateMany("integration_subscriptions", {
+						...scoped,
+						id
+					}, {
+						status,
+						updated_at: /* @__PURE__ */ new Date()
+					});
+				},
+				delete: async (id) => {
+					return await db().deleteMany("integration_subscriptions", {
+						...scoped,
+						id
+					}) > 0;
+				},
+				deleteWhere: async (where) => {
+					return db().deleteMany("integration_subscriptions", {
+						...scoped,
+						org_id: where.orgId,
+						...where.targetKey !== void 0 ? { target_key: where.targetKey } : {},
+						...where.sessionId !== void 0 ? { session_id: where.sessionId } : {}
+					});
+				}
+			},
+			settings: {
+				get: async (orgId, userId) => {
+					const row = await db().findOne("integration_settings", {
+						...scoped,
+						org_id: orgId,
+						user_id: userId
+					});
+					return row ? structuredClone(row.config) : null;
+				},
+				save: async (orgId, userId, config) => {
+					const where = {
+						...scoped,
+						org_id: orgId,
+						user_id: userId
+					};
+					const update = async () => db().updateMany("integration_settings", where, {
+						config,
+						updated_at: /* @__PURE__ */ new Date()
+					});
+					let lastError;
+					for (let attempt = 0; attempt < 2; attempt++) {
+						if (await update() > 0) return;
+						const now = /* @__PURE__ */ new Date();
+						try {
+							await db().insertOne("integration_settings", {
+								...where,
+								config,
+								created_at: now,
+								updated_at: now
+							});
+							return;
+						} catch (error) {
+							if (!(error instanceof UniqueViolationError)) throw error;
+							lastError = error;
+						}
+					}
+					throw lastError;
+				}
+			}
+		};
+	}
+};
+//#endregion
+export { INTEGRATION_CONNECTIONS_SCHEMA, INTEGRATION_SETTINGS_SCHEMA, INTEGRATION_SUBSCRIPTIONS_SCHEMA, IntegrationStorage };
+
+//# sourceMappingURL=base.js.map

package/dist/storage/domains/integrations/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":["#db"],"sources":["../../../../src/storage/domains/integrations/base.ts"],"sourcesContent":["/**\n * Generic integration storage — the default persistence surface for\n * `FactoryIntegration`s.\n *\n * Most integrations persist the same three shapes: an org-owned OAuth\n * **connection**, **subscriptions** binding external objects to\n * sessions/threads, and per-`(org, user)` **settings**. This built-in domain\n * stores all three in shared collections keyed by `integration_id`, so an\n * integration author writes zero schema, zero DDL, and zero queries — and\n * org scoping is enforced by construction through the pre-scoped handle\n * returned by {@link IntegrationStorage.forIntegration}.\n *\n * Source-control integrations additionally use the shared, provider-scoped\n * source-control domain for installations, projects, worktrees, and sandboxes.\n *\n * Payloads (`data` / `config`) are JSON documents typed per-integration via\n * the handle's generics. JSON round-trips exactly what JSON can represent:\n * store timestamps inside payloads as epoch millis or ISO strings, not\n * `Date`s.\n */\n\nimport { FactoryStorageDomain, UniqueViolationError } from '@mastra/core/storage';\nimport type { CollectionSchema, FactoryStorageOps } from '@mastra/core/storage';\n\nexport const INTEGRATION_CONNECTIONS_SCHEMA: CollectionSchema = {\n  name: 'integration_connections',\n  columns: {\n    id: { type: 'uuid-pk' },\n    integration_id: { type: 'text' },\n    org_id: { type: 'text' },\n    /** Who connected it (audit only — never scopes reads). */\n    user_id: { type: 'text', nullable: true },\n    data: { type: 'json' },\n    metadata: { type: 'json' },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [{ name: 'integration_connections_integration_org_unique', columns: ['integration_id', 'org_id'] }],\n};\n\nexport const INTEGRATION_SUBSCRIPTIONS_SCHEMA: CollectionSchema = {\n  name: 'integration_subscriptions',\n  columns: {\n    id: { type: 'uuid-pk' },\n    integration_id: { type: 'text' },\n    org_id: { type: 'text' },\n    /** Canonical external-object key the integration derives (e.g. `pr:{installation}:{repo}:{number}`). */\n    target_key: { type: 'text' },\n    session_id: { type: 'text', nullable: true },\n    resource_id: { type: 'text', nullable: true },\n    thread_id: { type: 'text', nullable: true },\n    session_scope: { type: 'text', nullable: true },\n    status: { type: 'text' },\n    data: { type: 'json' },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  indexes: [\n    { name: 'integration_subscriptions_target_idx', columns: ['integration_id', 'target_key'] },\n    { name: 'integration_subscriptions_org_idx', columns: ['integration_id', 'org_id'] },\n  ],\n};\n\nexport const INTEGRATION_SETTINGS_SCHEMA: CollectionSchema = {\n  name: 'integration_settings',\n  columns: {\n    id: { type: 'uuid-pk' },\n    integration_id: { type: 'text' },\n    org_id: { type: 'text' },\n    user_id: { type: 'text' },\n    config: { type: 'json' },\n    created_at: { type: 'timestamp' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [\n    { name: 'integration_settings_integration_org_user_unique', columns: ['integration_id', 'org_id', 'user_id'] },\n  ],\n};\n\n/** An integration's org-owned connection (typically the OAuth grant). */\nexport interface IntegrationConnection<TData> {\n  id: string;\n  orgId: string;\n  /** Who connected it (audit only). */\n  userId: string | null;\n  data: TData;\n  metadata: Record<string, unknown>;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** A subscription binding an external object to a session/thread. */\nexport interface IntegrationSubscription<TData> {\n  id: string;\n  orgId: string;\n  targetKey: string;\n  sessionId: string | null;\n  resourceId: string | null;\n  threadId: string | null;\n  sessionScope: string | null;\n  status: string;\n  data: TData;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport type CreateIntegrationSubscriptionInput<TData> = {\n  orgId: string;\n  targetKey: string;\n  sessionId?: string | null;\n  resourceId?: string | null;\n  threadId?: string | null;\n  sessionScope?: string | null;\n  /** Defaults to `'active'`. */\n  status?: string;\n} & ({} extends TData ? { data?: TData } : { data: TData });\n\n/**\n * Typed query surface pre-scoped to one `integration_id`. Every read and\n * write is automatically filtered/stamped with the integration id, so an\n * integration cannot reach another integration's rows.\n */\nexport interface IntegrationStorageHandle<\n  TConnection = Record<string, unknown>,\n  TSettings = Record<string, unknown>,\n  TSubscription = Record<string, unknown>,\n> {\n  readonly integrationId: string;\n  connections: {\n    /** The org's connection, or `null` when not connected. */\n    get(orgId: string): Promise<IntegrationConnection<TConnection> | null>;\n    /** Insert or replace the org's connection (one per org; `created_at` preserved on update). */\n    upsert(\n      orgId: string,\n      input: { userId?: string | null; data: TConnection; metadata?: Record<string, unknown> },\n    ): Promise<void>;\n    /**\n     * Atomic read-modify-write of the connection's `data` payload (token\n     * rotation etc.). Returns the updated connection, or `null` when the org\n     * has no connection.\n     */\n    update(orgId: string, fn: (data: TConnection) => TConnection): Promise<IntegrationConnection<TConnection> | null>;\n    /** Remove the org's connection. Returns whether a row was deleted. */\n    delete(orgId: string): Promise<boolean>;\n  };\n  subscriptions: {\n    create(input: CreateIntegrationSubscriptionInput<TSubscription>): Promise<IntegrationSubscription<TSubscription>>;\n    /** All subscriptions for an external object (webhook fan-out), optionally filtered by status. */\n    listByTarget(targetKey: string, opts?: { status?: string }): Promise<IntegrationSubscription<TSubscription>[]>;\n    listBySession(sessionId: string): Promise<IntegrationSubscription<TSubscription>[]>;\n    listByThread(resourceId: string, threadId: string): Promise<IntegrationSubscription<TSubscription>[]>;\n    updateStatus(id: string, status: string): Promise<void>;\n    delete(id: string): Promise<boolean>;\n    /** Targeted cleanup, always org-scoped. Returns the number of rows deleted. */\n    deleteWhere(where: { orgId: string; targetKey?: string; sessionId?: string }): Promise<number>;\n  };\n  settings: {\n    /** The `(org, user)` config, or `null` when never saved. */\n    get(orgId: string, userId: string): Promise<TSettings | null>;\n    /** Upsert the `(org, user)` config (`created_at` preserved on update). */\n    save(orgId: string, userId: string, config: TSettings): Promise<void>;\n  };\n}\n\ninterface ConnectionRow extends Record<string, unknown> {\n  id: string;\n  integration_id: string;\n  org_id: string;\n  user_id: string | null;\n  data: unknown;\n  metadata: Record<string, unknown>;\n  created_at: Date;\n  updated_at: Date;\n}\n\ninterface SubscriptionRow extends Record<string, unknown> {\n  id: string;\n  integration_id: string;\n  org_id: string;\n  target_key: string;\n  session_id: string | null;\n  resource_id: string | null;\n  thread_id: string | null;\n  session_scope: string | null;\n  status: string;\n  data: unknown;\n  created_at: Date;\n  updated_at: Date;\n}\n\n/**\n * The built-in generic integration domain, written once against the\n * `FactoryStorageOps` surface — works on any `FactoryStorage` backend.\n */\nexport class IntegrationStorage extends FactoryStorageDomain {\n  constructor() {\n    super('integrations');\n  }\n\n  async init(): Promise<void> {\n    await this.ensureCollections([\n      INTEGRATION_CONNECTIONS_SCHEMA,\n      INTEGRATION_SUBSCRIPTIONS_SCHEMA,\n      INTEGRATION_SETTINGS_SCHEMA,\n    ]);\n  }\n\n  async dangerouslyClearAll(): Promise<void> {\n    await this.ops.deleteMany('integration_subscriptions', {});\n    await this.ops.deleteMany('integration_settings', {});\n    await this.ops.deleteMany('integration_connections', {});\n  }\n\n  get #db(): FactoryStorageOps {\n    return this.ops;\n  }\n\n  /** A typed handle pre-scoped to `integrationId`. */\n  forIntegration<\n    TConnection = Record<string, unknown>,\n    TSettings = Record<string, unknown>,\n    TSubscription = Record<string, unknown>,\n  >(integrationId: string): IntegrationStorageHandle<TConnection, TSettings, TSubscription> {\n    if (!integrationId) throw new Error('[IntegrationStorage] integrationId is required.');\n    const db = () => this.#db;\n    const scoped = { integration_id: integrationId };\n\n    const mapConnection = (row: ConnectionRow): IntegrationConnection<TConnection> => ({\n      id: row.id,\n      orgId: row.org_id,\n      userId: row.user_id,\n      data: row.data as TConnection,\n      metadata: row.metadata ?? {},\n      createdAt: row.created_at,\n      updatedAt: row.updated_at,\n    });\n\n    const mapSubscription = (row: SubscriptionRow): IntegrationSubscription<TSubscription> => ({\n      id: row.id,\n      orgId: row.org_id,\n      targetKey: row.target_key,\n      sessionId: row.session_id,\n      resourceId: row.resource_id,\n      threadId: row.thread_id,\n      sessionScope: row.session_scope,\n      status: row.status,\n      data: row.data as TSubscription,\n      createdAt: row.created_at,\n      updatedAt: row.updated_at,\n    });\n\n    return {\n      integrationId,\n      connections: {\n        get: async orgId => {\n          const row = await db().findOne<ConnectionRow>('integration_connections', { ...scoped, org_id: orgId });\n          return row ? mapConnection(row) : null;\n        },\n        upsert: async (orgId, input) => {\n          const where = { ...scoped, org_id: orgId };\n          const update = async () =>\n            db().updateMany('integration_connections', where, {\n              user_id: input.userId ?? null,\n              data: input.data,\n              metadata: input.metadata ?? {},\n              updated_at: new Date(),\n            });\n\n          let lastError: unknown;\n          for (let attempt = 0; attempt < 2; attempt++) {\n            if ((await update()) > 0) return;\n\n            const now = new Date();\n            try {\n              await db().insertOne<ConnectionRow>('integration_connections', {\n                ...where,\n                user_id: input.userId ?? null,\n                data: input.data,\n                metadata: input.metadata ?? {},\n                created_at: now,\n                updated_at: now,\n              });\n              return;\n            } catch (error) {\n              if (!(error instanceof UniqueViolationError)) throw error;\n              lastError = error;\n            }\n          }\n          throw lastError;\n        },\n        update: async (orgId, fn) => {\n          const row = await db().updateAtomic<ConnectionRow>(\n            'integration_connections',\n            { ...scoped, org_id: orgId },\n            current => ({ data: fn(current.data as TConnection), updated_at: new Date() }),\n          );\n          return row ? mapConnection(row) : null;\n        },\n        delete: async orgId => {\n          const deleted = await db().deleteMany('integration_connections', { ...scoped, org_id: orgId });\n          return deleted > 0;\n        },\n      },\n      subscriptions: {\n        create: async input => {\n          const now = new Date();\n          const row = await db().insertOne<SubscriptionRow>('integration_subscriptions', {\n            ...scoped,\n            org_id: input.orgId,\n            target_key: input.targetKey,\n            session_id: input.sessionId ?? null,\n            resource_id: input.resourceId ?? null,\n            thread_id: input.threadId ?? null,\n            session_scope: input.sessionScope ?? null,\n            status: input.status ?? 'active',\n            data: input.data ?? {},\n            created_at: now,\n            updated_at: now,\n          });\n          return mapSubscription(row);\n        },\n        listByTarget: async (targetKey, opts) => {\n          const rows = await db().findMany<SubscriptionRow>(\n            'integration_subscriptions',\n            { ...scoped, target_key: targetKey, ...(opts?.status !== undefined ? { status: opts.status } : {}) },\n            { orderBy: [['created_at', 'asc']] },\n          );\n          return rows.map(mapSubscription);\n        },\n        listBySession: async sessionId => {\n          const rows = await db().findMany<SubscriptionRow>(\n            'integration_subscriptions',\n            { ...scoped, session_id: sessionId },\n            { orderBy: [['created_at', 'asc']] },\n          );\n          return rows.map(mapSubscription);\n        },\n        listByThread: async (resourceId, threadId) => {\n          const rows = await db().findMany<SubscriptionRow>(\n            'integration_subscriptions',\n            { ...scoped, resource_id: resourceId, thread_id: threadId },\n            { orderBy: [['created_at', 'asc']] },\n          );\n          return rows.map(mapSubscription);\n        },\n        updateStatus: async (id, status) => {\n          await db().updateMany('integration_subscriptions', { ...scoped, id }, { status, updated_at: new Date() });\n        },\n        delete: async id => {\n          const deleted = await db().deleteMany('integration_subscriptions', { ...scoped, id });\n          return deleted > 0;\n        },\n        deleteWhere: async where => {\n          return db().deleteMany('integration_subscriptions', {\n            ...scoped,\n            org_id: where.orgId,\n            ...(where.targetKey !== undefined ? { target_key: where.targetKey } : {}),\n            ...(where.sessionId !== undefined ? { session_id: where.sessionId } : {}),\n          });\n        },\n      },\n      settings: {\n        get: async (orgId, userId) => {\n          const row = await db().findOne<{ config: TSettings }>('integration_settings', {\n            ...scoped,\n            org_id: orgId,\n            user_id: userId,\n          });\n          return row ? structuredClone(row.config) : null;\n        },\n        save: async (orgId, userId, config) => {\n          const where = { ...scoped, org_id: orgId, user_id: userId };\n          const update = async () =>\n            db().updateMany('integration_settings', where, {\n              config,\n              updated_at: new Date(),\n            });\n\n          let lastError: unknown;\n          for (let attempt = 0; attempt < 2; attempt++) {\n            if ((await update()) > 0) return;\n\n            const now = new Date();\n            try {\n              await db().insertOne('integration_settings', {\n                ...where,\n                config,\n                created_at: now,\n                updated_at: now,\n              });\n              return;\n            } catch (error) {\n              if (!(error instanceof UniqueViolationError)) throw error;\n              lastError = error;\n            }\n          }\n          throw lastError;\n        },\n      },\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/storage/domains/memory-settings/base.d.ts

@@ -0,0 +1,62 @@
+import { FactoryStorageDomain } from '@mastra/core/storage';
+import type { CollectionSchema } from '@mastra/core/storage';
+/**
+ * A user's persisted memory (observational-memory) configuration. The
+ * DB-backed tenant counterpart of the local `settings.json` OM fields
+ * (`observerModelOverride`, `reflectorModelOverride`, `omObservationThreshold`,
+ * `omReflectionThreshold`, `omObserveAttachments`): one row per `(org, user)`,
+ * every knob nullable so only explicitly-changed values are stored.
+ */
+export interface MemorySettingsRecord {
+    orgId: string;
+    userId: string;
+    observerModelId: string | null;
+    reflectorModelId: string | null;
+    observationThreshold: number | null;
+    reflectionThreshold: number | null;
+    observeAttachments: 'auto' | boolean | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Partial update — only the provided knobs are written. */
+export interface MemorySettingsPatch {
+    observerModelId?: string;
+    reflectorModelId?: string;
+    observationThreshold?: number;
+    reflectionThreshold?: number;
+    observeAttachments?: 'auto' | boolean;
+}
+/**
+ * Knobs written only when the stored value is still unset (`NULL`). The check
+ * happens inside the backend's atomic-update primitive, so a concurrent
+ * explicit write to the same knob is never clobbered by a fill.
+ */
+export interface MemorySettingsFillIfUnset {
+    observerModelId?: string;
+    reflectorModelId?: string;
+}
+export declare const MEMORY_SETTINGS_SCHEMA: CollectionSchema;
+export declare class MemorySettingsStorage extends FactoryStorageDomain {
+    #private;
+    constructor();
+    init(): Promise<void>;
+    dangerouslyClearAll(): Promise<void>;
+    get({ orgId, userId }: {
+        orgId: string;
+        userId: string;
+    }): Promise<MemorySettingsRecord | null>;
+    /**
+     * Upsert the user's row, writing only the knobs present in `patch`.
+     * `fillIfUnset` knobs are written only where the stored value is still
+     * `NULL`, decided inside the atomic update so concurrent explicit writes
+     * win over fills. Concurrent first writes are resolved via the shared
+     * insert-then-catch-unique-violation pattern (see `queue_health`).
+     */
+    patch({ orgId, userId, patch, fillIfUnset, }: {
+        orgId: string;
+        userId: string;
+        patch: MemorySettingsPatch;
+        fillIfUnset?: MemorySettingsFillIfUnset;
+    }): Promise<MemorySettingsRecord>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/storage/domains/memory-settings/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory-settings/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,sBAAsB,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC5C,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,sBAAsB,EAAE,gBAgBpC,CAAC;AAuCF,qBAAa,qBAAsB,SAAQ,oBAAoB;;;IAKvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAKrG;;;;;;OAMG;IACG,KAAK,CAAC,EACV,KAAK,EACL,MAAM,EACN,KAAK,EACL,WAAW,GACZ,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,CAAC,EAAE,yBAAyB,CAAC;KACzC,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAuClC"}