@mastra/factory 0.6.0-alpha.1 → 0.6.0-alpha.3

package/dist/integrations/platform/linear/event-worker.js

@@ -0,0 +1,380 @@
+import { PlatformApiError } from "../api-client.js";
+import { randomUUID } from "crypto";
+import { NoopLeaseProvider, isLeaseProvider } from "@mastra/core/events";
+import { MastraWorker } from "@mastra/core/worker";
+//#region src/integrations/platform/linear/event-worker.ts
+const API_PREFIX = "/v1/server/linear";
+const DEFAULT_POLL_INTERVAL_MS = 2e4;
+const DEFAULT_RECONCILE_INTERVAL_MS = 5 * 6e4;
+const EVENT_PAGE_SIZE = 500;
+const MIN_LEASE_TTL_MS = 3e4;
+const CURSOR_ORG_ID = "__platform_linear_event_worker__";
+const CURSOR_USER_ID = "worker";
+const LEASE_KEY = "platform-linear-events:linear";
+/**
+* Tails the Platform Linear event stream (Redis-backed, per workspace) and
+* runs the same folded issue-reconcile sweep pattern as
+* `PlatformGithubEventWorker`. Issue events are translated into a normal
+* `LinearRulesIngress` so downstream rule dispatch is identical to the
+* polling path.
+*
+* Cursor state is persisted per workspace via the integration's generic
+* settings surface, keyed by a well-known worker identity. Cold start uses
+* `afterTimestamp: now - 1` to avoid replaying the 14-day stream backlog.
+*
+* ## Delivery semantics
+*
+* **At-most-once** per event. The cursor advances to the last event ID in a
+* page after all dispatch attempts on that page complete, regardless of
+* whether individual ingest calls threw. Ingest failures are logged, the
+* offending event is not retried, and drift is caught by the folded
+* `LinearIssueReconciler` sweep on its own cadence (default 5 minutes). This
+* matches `PlatformGithubEventWorker` and avoids poison-pill events blocking
+* the whole stream. Any consumer that needs exactly-once must idempotently
+* handle the same issue arriving via both the event path and the reconcile
+* path.
+*/
+var PlatformLinearEventWorker = class extends MastraWorker {
+	name = "platform-linear-events";
+	#client;
+	#linear;
+	#storage;
+	#projects;
+	#workItems;
+	#ingestFactoryIssue;
+	#reconcileFactoryState;
+	#pollEventsEnabled;
+	#intervalMs;
+	#reconcileIntervalMs;
+	#now;
+	#leaseOwner = randomUUID();
+	#running = false;
+	#timer;
+	#leaseRenewalTimer;
+	#inFlight;
+	#leaseProvider = NoopLeaseProvider;
+	#leaseTtlMs;
+	#hasLease = false;
+	#startedAt = 0;
+	#lastReconcileAt = 0;
+	#settings = {
+		version: 1,
+		workspaces: {}
+	};
+	constructor(config) {
+		super();
+		this.#client = config.client;
+		this.#linear = config.linear;
+		this.#storage = config.storage;
+		this.#projects = config.projects;
+		this.#workItems = config.workItems;
+		this.#ingestFactoryIssue = config.ingestFactoryIssue;
+		this.#reconcileFactoryState = config.reconcileFactoryState;
+		this.#pollEventsEnabled = config.pollEventsEnabled ?? true;
+		this.#intervalMs = config.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+		this.#reconcileIntervalMs = config.reconcileIntervalMs ?? DEFAULT_RECONCILE_INTERVAL_MS;
+		if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) throw new Error("Platform Linear event polling interval must be a positive number.");
+		if (!Number.isFinite(this.#reconcileIntervalMs) || this.#reconcileIntervalMs <= 0) throw new Error("Platform Linear reconcile interval must be a positive number.");
+		this.#leaseTtlMs = Math.max(MIN_LEASE_TTL_MS, this.#intervalMs * 3);
+		this.#now = config.now ?? Date.now;
+	}
+	async init(deps) {
+		await super.init(deps);
+		this.#leaseProvider = getLeaseProvider(deps.pubsub);
+	}
+	async start() {
+		if (this.#running) return;
+		if (!this.deps) throw new Error("PlatformLinearEventWorker: call init() before start()");
+		this.#startedAt = this.#now() - 1;
+		this.#settings = normalizeSettings(await this.#storage.settings.get(CURSOR_ORG_ID, CURSOR_USER_ID));
+		this.#running = true;
+		this.deps.logger.info("Platform Linear event polling started", {
+			intervalMs: this.#intervalMs,
+			leaseTtlMs: this.#leaseTtlMs
+		});
+		this.#schedule(0);
+	}
+	async stop() {
+		if (!this.#running) return;
+		this.#running = false;
+		if (this.#timer) clearTimeout(this.#timer);
+		this.#timer = void 0;
+		this.#stopLeaseRenewal();
+		await this.#inFlight;
+		if (this.#hasLease) {
+			await this.#leaseProvider.releaseLease(LEASE_KEY, this.#leaseOwner).catch(() => void 0);
+			this.#hasLease = false;
+		}
+	}
+	get isRunning() {
+		return this.#running;
+	}
+	#schedule(delayMs) {
+		if (!this.#running) return;
+		this.#timer = setTimeout(() => {
+			this.#timer = void 0;
+			const run = this.#tick();
+			this.#inFlight = run;
+			run.finally(() => {
+				if (this.#inFlight === run) this.#inFlight = void 0;
+			});
+		}, delayMs);
+		this.#timer.unref?.();
+	}
+	async #tick() {
+		let nextDelay = this.#intervalMs;
+		try {
+			if (!await this.#ensureLease()) return;
+			nextDelay = await this.#poll();
+		} catch (error) {
+			nextDelay = retryDelay(error, this.#intervalMs);
+			this.deps?.logger.error("Platform Linear event polling cycle failed", {
+				error: error instanceof Error ? error.message : String(error),
+				retryInMs: nextDelay
+			});
+		} finally {
+			this.#schedule(nextDelay);
+		}
+	}
+	async #ensureLease() {
+		if (this.#hasLease) return true;
+		const result = await this.#leaseProvider.acquireLease(LEASE_KEY, this.#leaseOwner, this.#leaseTtlMs);
+		this.#hasLease = result.acquired;
+		if (this.#hasLease) this.#startLeaseRenewal();
+		return this.#hasLease;
+	}
+	#startLeaseRenewal() {
+		if (this.#leaseRenewalTimer) return;
+		this.#leaseRenewalTimer = setInterval(() => {
+			this.#leaseProvider.renewLease(LEASE_KEY, this.#leaseOwner, this.#leaseTtlMs).then((renewed) => {
+				if (!renewed) {
+					this.#hasLease = false;
+					this.#stopLeaseRenewal();
+				}
+			}).catch((error) => {
+				this.#hasLease = false;
+				this.#stopLeaseRenewal();
+				this.deps?.logger.warn("Platform Linear event polling lease renewal failed", { error: error instanceof Error ? error.message : String(error) });
+			});
+		}, Math.floor(this.#leaseTtlMs / 3));
+		this.#leaseRenewalTimer.unref?.();
+	}
+	#stopLeaseRenewal() {
+		if (this.#leaseRenewalTimer) clearInterval(this.#leaseRenewalTimer);
+		this.#leaseRenewalTimer = void 0;
+	}
+	async #poll() {
+		let retryInMs = this.#pollEventsEnabled ? this.#intervalMs : this.#reconcileIntervalMs;
+		if (this.#pollEventsEnabled) {
+			let workspaces = [];
+			try {
+				workspaces = await this.#linear.listWorkspaces();
+			} catch (error) {
+				const delay = retryDelay(error, this.#intervalMs);
+				retryInMs = Math.max(retryInMs, delay);
+				this.deps?.logger.error("Platform Linear workspace listing failed", {
+					error: error instanceof Error ? error.message : String(error),
+					retryInMs: delay
+				});
+			}
+			for (const workspace of workspaces) {
+				if (!this.#running || !this.#hasLease) break;
+				try {
+					await this.#pollWorkspace(workspace.linearWorkspaceId);
+				} catch (error) {
+					const delay = retryDelay(error, this.#intervalMs);
+					retryInMs = Math.max(retryInMs, delay);
+					this.deps?.logger.error("Platform Linear workspace event polling failed", {
+						linearWorkspaceId: workspace.linearWorkspaceId,
+						error: error instanceof Error ? error.message : String(error),
+						retryInMs: delay
+					});
+					if (error instanceof PlatformApiError && error.status === 429) break;
+				}
+			}
+		}
+		await this.#maybeReconcile();
+		return retryInMs;
+	}
+	async #maybeReconcile() {
+		if (!this.#reconcileFactoryState || !this.#running || !this.#hasLease) return;
+		const now = this.#now();
+		if (now - this.#lastReconcileAt < this.#reconcileIntervalMs) return;
+		this.#lastReconcileAt = now;
+		const startedAt = Date.now();
+		try {
+			const { errors, ...counts } = await this.#reconcileFactoryState();
+			const context = {
+				...counts,
+				durationMs: Date.now() - startedAt
+			};
+			if (counts.failed > 0) this.deps?.logger.warn("Platform Linear issue reconcile sweep completed with failures", {
+				...context,
+				errors
+			});
+			else if (counts.updated > 0) this.deps?.logger.info("Platform Linear issue reconcile patched stale metadata", context);
+			else this.deps?.logger.debug("Platform Linear issue reconcile sweep completed", context);
+		} catch (error) {
+			this.deps?.logger.error("Platform Linear issue reconcile failed", {
+				durationMs: Date.now() - startedAt,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	async #pollWorkspace(linearWorkspaceId) {
+		if (!this.#settings.workspaces[linearWorkspaceId]) {
+			this.#settings.workspaces[linearWorkspaceId] = { afterTimestamp: this.#startedAt };
+			await this.#saveSettings();
+		}
+		while (this.#running && this.#hasLease) {
+			const cursor = this.#settings.workspaces[linearWorkspaceId];
+			const query = new URLSearchParams({
+				limit: String(EVENT_PAGE_SIZE),
+				type: "Issue"
+			});
+			if ("afterEventId" in cursor) query.set("afterEventId", cursor.afterEventId);
+			else query.set("after", String(cursor.afterTimestamp));
+			const pollStartedAt = performance.now();
+			const page = await this.#client.request("GET", `${API_PREFIX}/workspaces/${encodeURIComponent(linearWorkspaceId)}/events?${query}`);
+			this.deps?.logger.debug("Platform Linear workspace event poll completed", {
+				linearWorkspaceId,
+				eventCount: page.events.length,
+				latencyMs: Math.round(performance.now() - pollStartedAt)
+			});
+			if (page.events.length === 0) return;
+			const lastId = page.events[page.events.length - 1].id;
+			const projects = await this.#projects.listAll();
+			for (const event of page.events) {
+				if (!this.#running || !this.#hasLease) return;
+				await this.#dispatchEvent(linearWorkspaceId, event, projects);
+			}
+			if ("afterEventId" in cursor && cursor.afterEventId === lastId) return;
+			this.#settings.workspaces[linearWorkspaceId] = { afterEventId: lastId };
+			await this.#saveSettings();
+			if (page.events.length < EVENT_PAGE_SIZE) return;
+		}
+	}
+	async #dispatchEvent(linearWorkspaceId, event, projects) {
+		if (event.envelope.type !== "Issue") return;
+		if (!this.#ingestFactoryIssue) return;
+		const issue = parseIssueEnvelope(event.envelope);
+		if (!issue) {
+			this.deps?.logger.warn("Platform Linear event log returned an unusable Issue payload", {
+				linearWorkspaceId,
+				eventId: event.id
+			});
+			return;
+		}
+		const sourceKey = `linear:${issue.identifier}`;
+		let dispatched = 0;
+		for (const project of projects) {
+			let items;
+			try {
+				items = await this.#workItems.list({
+					orgId: project.orgId,
+					factoryProjectId: project.id
+				});
+			} catch (error) {
+				this.deps?.logger.error("Platform Linear work-item lookup failed", {
+					linearWorkspaceId,
+					eventId: event.id,
+					projectId: project.id,
+					error: error instanceof Error ? error.message : String(error)
+				});
+				continue;
+			}
+			if (!items.some((item) => item.externalSource?.integrationId === "linear" && item.externalSource.type === "issue" && item.externalSource.externalId === sourceKey)) continue;
+			try {
+				await this.#ingestFactoryIssue({
+					orgId: project.orgId,
+					userId: "platform-linear-event-worker",
+					factoryProjectId: project.id,
+					issues: [issue]
+				});
+				dispatched += 1;
+			} catch (error) {
+				this.deps?.logger.error("Platform Linear issue ingest failed", {
+					linearWorkspaceId,
+					eventId: event.id,
+					projectId: project.id,
+					error: error instanceof Error ? error.message : String(error)
+				});
+			}
+		}
+		if (dispatched === 0) this.deps?.logger.debug("Platform Linear Issue event had no linked work items to update", {
+			linearWorkspaceId,
+			eventId: event.id,
+			sourceKey
+		});
+	}
+	async #saveSettings() {
+		await this.#storage.settings.save(CURSOR_ORG_ID, CURSOR_USER_ID, this.#settings);
+	}
+};
+function getLeaseProvider(pubsub) {
+	const getProvider = pubsub.getLeaseProvider;
+	if (typeof getProvider === "function") return getProvider.call(pubsub) ?? NoopLeaseProvider;
+	return isLeaseProvider(pubsub) ? pubsub : NoopLeaseProvider;
+}
+function normalizeSettings(value) {
+	if (!value || value.version !== 1 || !value.workspaces || typeof value.workspaces !== "object") return {
+		version: 1,
+		workspaces: {}
+	};
+	return {
+		version: 1,
+		workspaces: { ...value.workspaces }
+	};
+}
+function retryDelay(error, fallbackMs) {
+	if (error instanceof PlatformApiError && error.status === 429 && error.retryAfterSeconds !== null) return Math.max(fallbackMs, error.retryAfterSeconds * 1e3);
+	return fallbackMs;
+}
+/**
+* Translate an Issue webhook envelope into the rules-ingress shape.
+* Returns undefined when the payload lacks the identifiers we need to
+* match a work item.
+*/
+function parseIssueEnvelope(envelope) {
+	const data = envelope.data;
+	if (!data || typeof data !== "object" || Array.isArray(data)) return void 0;
+	const raw = data;
+	const id = typeof raw.id === "string" ? raw.id : void 0;
+	const identifier = typeof raw.identifier === "string" ? raw.identifier : void 0;
+	const title = typeof raw.title === "string" ? raw.title : void 0;
+	const url = typeof raw.url === "string" ? raw.url : envelope.url ?? void 0;
+	if (!id || !identifier || !title || !url) return void 0;
+	const state = optionalObject(raw.state);
+	const team = optionalObject(raw.team);
+	const assignee = optionalObject(raw.assignee);
+	const creator = optionalObject(raw.user) ?? optionalObject(raw.creator);
+	const labels = Array.isArray(raw.labels) ? raw.labels.flatMap((label) => {
+		const obj = optionalObject(label);
+		return obj && typeof obj.name === "string" ? [obj.name] : [];
+	}) : [];
+	const createdAt = typeof raw.createdAt === "string" ? raw.createdAt : envelope.createdAt ?? "";
+	const updatedAt = typeof raw.updatedAt === "string" ? raw.updatedAt : createdAt;
+	return {
+		id,
+		identifier,
+		title,
+		url,
+		state: (state && typeof state.name === "string" ? state.name : null) ?? "",
+		stateType: (state && typeof state.type === "string" ? state.type : null) ?? "",
+		priorityLabel: typeof raw.priorityLabel === "string" ? raw.priorityLabel : "",
+		assignee: assignee && typeof assignee.name === "string" ? assignee.name : null,
+		creator: creator && typeof creator.name === "string" ? creator.name : null,
+		team: team && typeof team.name === "string" ? team.name : null,
+		labels,
+		createdAt,
+		updatedAt
+	};
+}
+function optionalObject(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+	return value;
+}
+//#endregion
+export { PlatformLinearEventWorker };
+
+//# sourceMappingURL=event-worker.js.map

package/dist/integrations/platform/linear/event-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-worker.js","names":["#client","#linear","#storage","#projects","#workItems","#ingestFactoryIssue","#reconcileFactoryState","#pollEventsEnabled","#intervalMs","#reconcileIntervalMs","#now","#leaseOwner","#leaseTtlMs","#leaseProvider","#running","#startedAt","#settings","#schedule","#timer","#stopLeaseRenewal","#inFlight","#hasLease","#tick","#ensureLease","#poll","#startLeaseRenewal","#leaseRenewalTimer","#pollWorkspace","#maybeReconcile","#lastReconcileAt","#saveSettings","#dispatchEvent"],"sources":["../../../../src/integrations/platform/linear/event-worker.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { isLeaseProvider, NoopLeaseProvider } from '@mastra/core/events';\nimport type { LeaseProvider, PubSub } from '@mastra/core/events';\nimport { MastraWorker } from '@mastra/core/worker';\nimport type { WorkerDeps } from '@mastra/core/worker';\n\nimport type { IntegrationStorageHandle } from '../../../storage/domains/integrations/base.js';\nimport type { FactoryProjectsStorage } from '../../../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../../../storage/domains/work-items/base.js';\nimport type { IssueReconciler } from '../../issue-reconciler.js';\nimport type { LinearIssueIngress, LinearRulesIngress } from '../../linear/rules.js';\nimport { PlatformApiClient, PlatformApiError } from '../api-client.js';\n\nconst API_PREFIX = '/v1/server/linear';\nconst DEFAULT_POLL_INTERVAL_MS = 20_000;\nconst DEFAULT_RECONCILE_INTERVAL_MS = 5 * 60_000;\nconst EVENT_PAGE_SIZE = 500;\nconst MIN_LEASE_TTL_MS = 30_000;\nconst CURSOR_ORG_ID = '__platform_linear_event_worker__';\nconst CURSOR_USER_ID = 'worker';\nconst LEASE_KEY = 'platform-linear-events:linear';\n\ntype EventCursor = { afterEventId: string } | { afterTimestamp: number };\ntype PlatformLinearEventWorkerSettings = {\n  version: 1;\n  workspaces: Record<string, EventCursor>;\n};\n\nexport type PlatformLinearEventStorage = IntegrationStorageHandle<\n  Record<string, unknown>,\n  PlatformLinearEventWorkerSettings,\n  Record<string, unknown>\n>;\n\n/**\n * Minimal envelope shape mirrored from `@platform/linear`. Kept opaque\n * (`data: unknown`) — every consumer demuxes by `type`.\n */\nexport interface LinearWebhookEnvelope {\n  type: string;\n  action: string | null;\n  createdAt: string | null;\n  webhookTimestamp: number | null;\n  linearOrganizationId: string | null;\n  oauthClientId: string | null;\n  url: string | null;\n  data: unknown;\n}\n\nexport interface LinearEventLogEntry {\n  id: string;\n  timestamp: number;\n  envelope: LinearWebhookEnvelope;\n}\n\nexport interface PlatformLinearWorkspace {\n  linearWorkspaceId: string;\n  linearWorkspaceName?: string;\n}\n\n/**\n * Everything the worker needs to drive ingest + reconciliation without\n * pulling in the full `PlatformLinearIntegration` type (circular).\n */\nexport interface PlatformLinearEventDispatchIntegration {\n  listWorkspaces(): Promise<PlatformLinearWorkspace[]>;\n}\n\nexport interface PlatformLinearEventWorkerConfig {\n  client: PlatformApiClient;\n  linear: PlatformLinearEventDispatchIntegration;\n  storage: PlatformLinearEventStorage;\n  projects: Pick<FactoryProjectsStorage, 'listAll'>;\n  /**\n   * Used to scope event dispatch to `(orgId, factoryProjectId)` pairs that\n   * already have a work item linked to the incoming Linear issue. Without\n   * this scoping, a workspace-scoped event would fan out to every project in\n   * every org and materialize a triage card in each — a cross-tenant leak.\n   * First-observation of a Linear issue happens through the user-authenticated\n   * `/web/linear/issues?factoryProjectId=...` intake path instead.\n   */\n  workItems: Pick<WorkItemsStorage, 'list'>;\n  /** Called with a single-issue rules ingress derived from an `Issue` webhook. */\n  ingestFactoryIssue?: (input: LinearRulesIngress) => Promise<unknown>;\n  reconcileFactoryState?: IssueReconciler;\n  /** When false the worker skips event tailing and only runs the reconcile sweep. */\n  pollEventsEnabled?: boolean;\n  intervalMs?: number;\n  reconcileIntervalMs?: number;\n  now?: () => number;\n}\n\n/**\n * Tails the Platform Linear event stream (Redis-backed, per workspace) and\n * runs the same folded issue-reconcile sweep pattern as\n * `PlatformGithubEventWorker`. Issue events are translated into a normal\n * `LinearRulesIngress` so downstream rule dispatch is identical to the\n * polling path.\n *\n * Cursor state is persisted per workspace via the integration's generic\n * settings surface, keyed by a well-known worker identity. Cold start uses\n * `afterTimestamp: now - 1` to avoid replaying the 14-day stream backlog.\n *\n * ## Delivery semantics\n *\n * **At-most-once** per event. The cursor advances to the last event ID in a\n * page after all dispatch attempts on that page complete, regardless of\n * whether individual ingest calls threw. Ingest failures are logged, the\n * offending event is not retried, and drift is caught by the folded\n * `LinearIssueReconciler` sweep on its own cadence (default 5 minutes). This\n * matches `PlatformGithubEventWorker` and avoids poison-pill events blocking\n * the whole stream. Any consumer that needs exactly-once must idempotently\n * handle the same issue arriving via both the event path and the reconcile\n * path.\n */\nexport class PlatformLinearEventWorker extends MastraWorker {\n  readonly name = 'platform-linear-events';\n\n  readonly #client: PlatformApiClient;\n  readonly #linear: PlatformLinearEventDispatchIntegration;\n  readonly #storage: PlatformLinearEventStorage;\n  readonly #projects: Pick<FactoryProjectsStorage, 'listAll'>;\n  readonly #workItems: Pick<WorkItemsStorage, 'list'>;\n  readonly #ingestFactoryIssue: ((input: LinearRulesIngress) => Promise<unknown>) | undefined;\n  readonly #reconcileFactoryState: IssueReconciler | undefined;\n  readonly #pollEventsEnabled: boolean;\n  readonly #intervalMs: number;\n  readonly #reconcileIntervalMs: number;\n  readonly #now: () => number;\n  readonly #leaseOwner = randomUUID();\n\n  #running = false;\n  #timer: ReturnType<typeof setTimeout> | undefined;\n  #leaseRenewalTimer: ReturnType<typeof setInterval> | undefined;\n  #inFlight: Promise<void> | undefined;\n  #leaseProvider: LeaseProvider = NoopLeaseProvider;\n  #leaseTtlMs: number;\n  #hasLease = false;\n  #startedAt = 0;\n  #lastReconcileAt = 0;\n  #settings: PlatformLinearEventWorkerSettings = { version: 1, workspaces: {} };\n\n  constructor(config: PlatformLinearEventWorkerConfig) {\n    super();\n    this.#client = config.client;\n    this.#linear = config.linear;\n    this.#storage = config.storage;\n    this.#projects = config.projects;\n    this.#workItems = config.workItems;\n    this.#ingestFactoryIssue = config.ingestFactoryIssue;\n    this.#reconcileFactoryState = config.reconcileFactoryState;\n    this.#pollEventsEnabled = config.pollEventsEnabled ?? true;\n    this.#intervalMs = config.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    this.#reconcileIntervalMs = config.reconcileIntervalMs ?? DEFAULT_RECONCILE_INTERVAL_MS;\n    if (!Number.isFinite(this.#intervalMs) || this.#intervalMs <= 0) {\n      throw new Error('Platform Linear event polling interval must be a positive number.');\n    }\n    if (!Number.isFinite(this.#reconcileIntervalMs) || this.#reconcileIntervalMs <= 0) {\n      throw new Error('Platform Linear reconcile interval must be a positive number.');\n    }\n    this.#leaseTtlMs = Math.max(MIN_LEASE_TTL_MS, this.#intervalMs * 3);\n    this.#now = config.now ?? Date.now;\n  }\n\n  async init(deps: WorkerDeps): Promise<void> {\n    await super.init(deps);\n    this.#leaseProvider = getLeaseProvider(deps.pubsub);\n  }\n\n  async start(): Promise<void> {\n    if (this.#running) return;\n    if (!this.deps) throw new Error('PlatformLinearEventWorker: call init() before start()');\n\n    this.#startedAt = this.#now() - 1;\n    this.#settings = normalizeSettings(await this.#storage.settings.get(CURSOR_ORG_ID, CURSOR_USER_ID));\n    this.#running = true;\n    this.deps.logger.info('Platform Linear event polling started', {\n      intervalMs: this.#intervalMs,\n      leaseTtlMs: this.#leaseTtlMs,\n    });\n    this.#schedule(0);\n  }\n\n  async stop(): Promise<void> {\n    if (!this.#running) return;\n    this.#running = false;\n    if (this.#timer) clearTimeout(this.#timer);\n    this.#timer = undefined;\n    this.#stopLeaseRenewal();\n    await this.#inFlight;\n    if (this.#hasLease) {\n      await this.#leaseProvider.releaseLease(LEASE_KEY, this.#leaseOwner).catch(() => undefined);\n      this.#hasLease = false;\n    }\n  }\n\n  get isRunning(): boolean {\n    return this.#running;\n  }\n\n  #schedule(delayMs: number): void {\n    if (!this.#running) return;\n    this.#timer = setTimeout(() => {\n      this.#timer = undefined;\n      const run = this.#tick();\n      this.#inFlight = run;\n      void run.finally(() => {\n        if (this.#inFlight === run) this.#inFlight = undefined;\n      });\n    }, delayMs);\n    this.#timer.unref?.();\n  }\n\n  async #tick(): Promise<void> {\n    let nextDelay = this.#intervalMs;\n    try {\n      if (!(await this.#ensureLease())) return;\n      nextDelay = await this.#poll();\n    } catch (error) {\n      nextDelay = retryDelay(error, this.#intervalMs);\n      this.deps?.logger.error('Platform Linear event polling cycle failed', {\n        error: error instanceof Error ? error.message : String(error),\n        retryInMs: nextDelay,\n      });\n    } finally {\n      this.#schedule(nextDelay);\n    }\n  }\n\n  async #ensureLease(): Promise<boolean> {\n    if (this.#hasLease) return true;\n    const result = await this.#leaseProvider.acquireLease(LEASE_KEY, this.#leaseOwner, this.#leaseTtlMs);\n    this.#hasLease = result.acquired;\n    if (this.#hasLease) this.#startLeaseRenewal();\n    return this.#hasLease;\n  }\n\n  #startLeaseRenewal(): void {\n    if (this.#leaseRenewalTimer) return;\n    this.#leaseRenewalTimer = setInterval(\n      () => {\n        void this.#leaseProvider\n          .renewLease(LEASE_KEY, this.#leaseOwner, this.#leaseTtlMs)\n          .then(renewed => {\n            if (!renewed) {\n              this.#hasLease = false;\n              this.#stopLeaseRenewal();\n            }\n          })\n          .catch(error => {\n            this.#hasLease = false;\n            this.#stopLeaseRenewal();\n            this.deps?.logger.warn('Platform Linear event polling lease renewal failed', {\n              error: error instanceof Error ? error.message : String(error),\n            });\n          });\n      },\n      Math.floor(this.#leaseTtlMs / 3),\n    );\n    this.#leaseRenewalTimer.unref?.();\n  }\n\n  #stopLeaseRenewal(): void {\n    if (this.#leaseRenewalTimer) clearInterval(this.#leaseRenewalTimer);\n    this.#leaseRenewalTimer = undefined;\n  }\n\n  async #poll(): Promise<number> {\n    // Reconcile-only mode has no event tail to keep fresh, so tick on the\n    // slower reconcile cadence instead of the polling interval.\n    let retryInMs = this.#pollEventsEnabled ? this.#intervalMs : this.#reconcileIntervalMs;\n\n    if (this.#pollEventsEnabled) {\n      // Only list workspaces when actually tailing events: reconciliation\n      // does not need the workspace list, and folding this call into\n      // reconcile-only mode would let one workspace-listing outage take\n      // down the reconcile sweep as well.\n      let workspaces: PlatformLinearWorkspace[] = [];\n      try {\n        workspaces = await this.#linear.listWorkspaces();\n      } catch (error) {\n        const delay = retryDelay(error, this.#intervalMs);\n        retryInMs = Math.max(retryInMs, delay);\n        this.deps?.logger.error('Platform Linear workspace listing failed', {\n          error: error instanceof Error ? error.message : String(error),\n          retryInMs: delay,\n        });\n      }\n\n      for (const workspace of workspaces) {\n        if (!this.#running || !this.#hasLease) break;\n        try {\n          await this.#pollWorkspace(workspace.linearWorkspaceId);\n        } catch (error) {\n          const delay = retryDelay(error, this.#intervalMs);\n          retryInMs = Math.max(retryInMs, delay);\n          this.deps?.logger.error('Platform Linear workspace event polling failed', {\n            linearWorkspaceId: workspace.linearWorkspaceId,\n            error: error instanceof Error ? error.message : String(error),\n            retryInMs: delay,\n          });\n          if (error instanceof PlatformApiError && error.status === 429) break;\n        }\n      }\n    }\n\n    await this.#maybeReconcile();\n\n    return retryInMs;\n  }\n\n  async #maybeReconcile(): Promise<void> {\n    if (!this.#reconcileFactoryState || !this.#running || !this.#hasLease) return;\n    const now = this.#now();\n    if (now - this.#lastReconcileAt < this.#reconcileIntervalMs) return;\n    // Advance the clock before sweeping so a persistently failing sweep stays\n    // on cadence instead of retrying every poll tick.\n    this.#lastReconcileAt = now;\n    const startedAt = Date.now();\n    try {\n      const { errors, ...counts } = await this.#reconcileFactoryState();\n      const context = { ...counts, durationMs: Date.now() - startedAt };\n      if (counts.failed > 0) {\n        this.deps?.logger.warn('Platform Linear issue reconcile sweep completed with failures', {\n          ...context,\n          errors,\n        });\n      } else if (counts.updated > 0) {\n        this.deps?.logger.info('Platform Linear issue reconcile patched stale metadata', context);\n      } else {\n        this.deps?.logger.debug('Platform Linear issue reconcile sweep completed', context);\n      }\n    } catch (error) {\n      this.deps?.logger.error('Platform Linear issue reconcile failed', {\n        durationMs: Date.now() - startedAt,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  async #pollWorkspace(linearWorkspaceId: string): Promise<void> {\n    if (!this.#settings.workspaces[linearWorkspaceId]) {\n      this.#settings.workspaces[linearWorkspaceId] = { afterTimestamp: this.#startedAt };\n      await this.#saveSettings();\n    }\n\n    while (this.#running && this.#hasLease) {\n      const cursor: EventCursor = this.#settings.workspaces[linearWorkspaceId]!;\n      const query = new URLSearchParams({ limit: String(EVENT_PAGE_SIZE), type: 'Issue' });\n      if ('afterEventId' in cursor) query.set('afterEventId', cursor.afterEventId);\n      else query.set('after', String(cursor.afterTimestamp));\n\n      const pollStartedAt = performance.now();\n      const page = await this.#client.request<{ events: LinearEventLogEntry[] }>(\n        'GET',\n        `${API_PREFIX}/workspaces/${encodeURIComponent(linearWorkspaceId)}/events?${query}`,\n      );\n      this.deps?.logger.debug('Platform Linear workspace event poll completed', {\n        linearWorkspaceId,\n        eventCount: page.events.length,\n        latencyMs: Math.round(performance.now() - pollStartedAt),\n      });\n      if (page.events.length === 0) return;\n\n      const lastId = page.events[page.events.length - 1]!.id;\n\n      // Resolve the project set once per page instead of once per event.\n      // The event stream can return up to EVENT_PAGE_SIZE (500) events; the\n      // project list rarely changes within the second or two it takes to\n      // dispatch a single page, and #dispatchEvent still consults storage\n      // per-project to check for a linked work item.\n      const projects = await this.#projects.listAll();\n\n      for (const event of page.events) {\n        if (!this.#running || !this.#hasLease) return;\n        await this.#dispatchEvent(linearWorkspaceId, event, projects);\n      }\n\n      if ('afterEventId' in cursor && cursor.afterEventId === lastId) return;\n      this.#settings.workspaces[linearWorkspaceId] = { afterEventId: lastId };\n      await this.#saveSettings();\n\n      // Short pages mean we've caught up; wait for the next tick.\n      if (page.events.length < EVENT_PAGE_SIZE) return;\n    }\n  }\n\n  async #dispatchEvent(\n    linearWorkspaceId: string,\n    event: LinearEventLogEntry,\n    projects: readonly { id: string; orgId: string }[],\n  ): Promise<void> {\n    if (event.envelope.type !== 'Issue') return;\n    if (!this.#ingestFactoryIssue) return;\n    const issue = parseIssueEnvelope(event.envelope);\n    if (!issue) {\n      this.deps?.logger.warn('Platform Linear event log returned an unusable Issue payload', {\n        linearWorkspaceId,\n        eventId: event.id,\n      });\n      return;\n    }\n\n    // The event stream is workspace-scoped and Platform Linear has no\n    // workspace→org mapping we can trust. To avoid cross-tenant fan-out (an\n    // Issue from org A materializing a triage card in org B via the default\n    // `linearIssueObserved` rule), only dispatch to `(orgId, factoryProjectId)`\n    // pairs that already have a persisted work item for this Linear issue.\n    // First-observation of a Linear issue happens through the\n    // user-authenticated `/web/linear/issues?factoryProjectId=...` intake path.\n    const sourceKey = `linear:${issue.identifier}`;\n    let dispatched = 0;\n    for (const project of projects) {\n      let items;\n      try {\n        items = await this.#workItems.list({ orgId: project.orgId, factoryProjectId: project.id });\n      } catch (error) {\n        this.deps?.logger.error('Platform Linear work-item lookup failed', {\n          linearWorkspaceId,\n          eventId: event.id,\n          projectId: project.id,\n          error: error instanceof Error ? error.message : String(error),\n        });\n        continue;\n      }\n      const linked = items.some(\n        item =>\n          item.externalSource?.integrationId === 'linear' &&\n          item.externalSource.type === 'issue' &&\n          item.externalSource.externalId === sourceKey,\n      );\n      if (!linked) continue;\n      try {\n        await this.#ingestFactoryIssue({\n          orgId: project.orgId,\n          userId: 'platform-linear-event-worker',\n          factoryProjectId: project.id,\n          issues: [issue],\n        });\n        dispatched += 1;\n      } catch (error) {\n        this.deps?.logger.error('Platform Linear issue ingest failed', {\n          linearWorkspaceId,\n          eventId: event.id,\n          projectId: project.id,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n    if (dispatched === 0) {\n      this.deps?.logger.debug('Platform Linear Issue event had no linked work items to update', {\n        linearWorkspaceId,\n        eventId: event.id,\n        sourceKey,\n      });\n    }\n  }\n\n  async #saveSettings(): Promise<void> {\n    await this.#storage.settings.save(CURSOR_ORG_ID, CURSOR_USER_ID, this.#settings);\n  }\n}\n\nfunction getLeaseProvider(pubsub: PubSub): LeaseProvider {\n  const getProvider = (pubsub as PubSub & { getLeaseProvider?: () => LeaseProvider | undefined }).getLeaseProvider;\n  if (typeof getProvider === 'function') return getProvider.call(pubsub) ?? NoopLeaseProvider;\n  return isLeaseProvider(pubsub) ? pubsub : NoopLeaseProvider;\n}\n\nfunction normalizeSettings(value: PlatformLinearEventWorkerSettings | null): PlatformLinearEventWorkerSettings {\n  if (!value || value.version !== 1 || !value.workspaces || typeof value.workspaces !== 'object') {\n    return { version: 1, workspaces: {} };\n  }\n  return { version: 1, workspaces: { ...value.workspaces } };\n}\n\nfunction retryDelay(error: unknown, fallbackMs: number): number {\n  if (error instanceof PlatformApiError && error.status === 429 && error.retryAfterSeconds !== null) {\n    return Math.max(fallbackMs, error.retryAfterSeconds * 1_000);\n  }\n  return fallbackMs;\n}\n\n/**\n * Translate an Issue webhook envelope into the rules-ingress shape.\n * Returns undefined when the payload lacks the identifiers we need to\n * match a work item.\n */\nfunction parseIssueEnvelope(envelope: LinearWebhookEnvelope): LinearIssueIngress | undefined {\n  const data = envelope.data;\n  if (!data || typeof data !== 'object' || Array.isArray(data)) return undefined;\n  const raw = data as Record<string, unknown>;\n  const id = typeof raw.id === 'string' ? raw.id : undefined;\n  const identifier = typeof raw.identifier === 'string' ? raw.identifier : undefined;\n  const title = typeof raw.title === 'string' ? raw.title : undefined;\n  const url = typeof raw.url === 'string' ? raw.url : envelope.url ?? undefined;\n  if (!id || !identifier || !title || !url) return undefined;\n\n  const state = optionalObject(raw.state);\n  const team = optionalObject(raw.team);\n  const assignee = optionalObject(raw.assignee);\n  const creator = optionalObject(raw.user) ?? optionalObject(raw.creator);\n  const labels = Array.isArray(raw.labels)\n    ? raw.labels.flatMap(label => {\n        const obj = optionalObject(label);\n        return obj && typeof obj.name === 'string' ? [obj.name] : [];\n      })\n    : [];\n\n  const createdAt = typeof raw.createdAt === 'string' ? raw.createdAt : envelope.createdAt ?? '';\n  const updatedAt = typeof raw.updatedAt === 'string' ? raw.updatedAt : createdAt;\n\n  return {\n    id,\n    identifier,\n    title,\n    url,\n    state: (state && typeof state.name === 'string' ? state.name : null) ?? '',\n    stateType: (state && typeof state.type === 'string' ? state.type : null) ?? '',\n    priorityLabel: typeof raw.priorityLabel === 'string' ? raw.priorityLabel : '',\n    assignee: assignee && typeof assignee.name === 'string' ? assignee.name : null,\n    creator: creator && typeof creator.name === 'string' ? creator.name : null,\n    team: team && typeof team.name === 'string' ? team.name : null,\n    labels,\n    createdAt,\n    updatedAt,\n  };\n}\n\nfunction optionalObject(value: unknown): Record<string, unknown> | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;\n  return value as Record<string, unknown>;\n}\n"],"mappings":"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"}

package/dist/integrations/platform/linear/integration.d.ts

@@ -1,11 +1,18 @@
 import type { RequestContext } from '@mastra/core/request-context';
 import type { ApiRoute } from '@mastra/core/server';
+import type { MastraWorker } from '@mastra/core/worker';
 import type { Intake } from '../../../capabilities/intake.js';
 import type { RouteAuth } from '../../../routes/route.js';
 import type { FactoryProjectsStorage } from '../../../storage/domains/projects/base.js';
 import type { FactoryIntegration, IntegrationContext, IntegrationTools } from '../../base.js';
 import type { LinearConnectionCheck } from '../../linear/integration.js';
 import type { LinearConnectionRow, LinearStorageHandle } from '../../linear/storage.js';
+type LinearWorkspace = {
+    linearWorkspaceId: string;
+    linearWorkspaceName: string;
+    urlKey: string | null;
+    connected: boolean;
+};
 type LinearProject = {
     id: string;
     name: string;
@@ -33,6 +40,7 @@ export declare class PlatformLinearIntegration implements FactoryIntegration {
     getFreshAccessToken(_connection: LinearConnectionRow): Promise<string>;
     canPostComments(connection: LinearConnectionRow): boolean;
     checkConnection(orgId: string): Promise<LinearConnectionCheck>;
+    workers(ctx: IntegrationContext): MastraWorker[];
     routes(ctx: IntegrationContext): ApiRoute[];
     agentTools({ requestContext }: {
         requestContext: RequestContext;
@@ -41,6 +49,7 @@ export declare class PlatformLinearIntegration implements FactoryIntegration {
     listProjects(): Promise<Array<LinearProject & {
         workspaceId: string;
     }>>;
+    listWorkspaces(): Promise<LinearWorkspace[]>;
 }
 export {};
 //# sourceMappingURL=integration.d.ts.map

package/dist/integrations/platform/linear/integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../../src/integrations/platform/linear/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,MAAM,EAA0D,MAAM,iCAAiC,CAAC;AACtH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,6BAA6B,CAAC;AAG5F,OAAO,KAAK,EAAwB,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAmD9G,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC;AAwBF,qBAAa,yBAA0B,YAAW,kBAAkB;;IAClE,QAAQ,CAAC,EAAE,YAAY;IAYvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAwIrB;;IAQF,IAAI,OAAO,IAAI,mBAAmB,CAuBjC;IAED,IAAI,QAAQ,IAAI,sBAAsB,CAGrC;IAED,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAM5F,IAAI,WAAW,IAAI,OAAO,CAEzB;IAEK,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmBlE,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB5E,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO;IAKnD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IASpE,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE;IAqCrC,UAAU,CAAC,EAAE,cAAc,EAAE,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInG,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIhC,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkK9E"}
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../../src/integrations/platform/linear/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAAE,MAAM,EAA0D,MAAM,iCAAiC,CAAC;AACtH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,6BAA6B,CAAC;AAI5F,OAAO,KAAK,EAAwB,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA+C9G,KAAK,eAAe,GAAG;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC;AAwBF,qBAAa,yBAA0B,YAAW,kBAAkB;;IAClE,QAAQ,CAAC,EAAE,YAAY;IAYvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAwIrB;;IAQF,IAAI,OAAO,IAAI,mBAAmB,CAuBjC;IAED,IAAI,QAAQ,IAAI,sBAAsB,CAGrC;IAED,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAM5F,IAAI,WAAW,IAAI,OAAO,CAEzB;IAEK,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmBlE,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB5E,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO;IAKnD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IASpE,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,YAAY,EAAE;IA8BhD,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE;IAqCrC,UAAU,CAAC,EAAE,cAAc,EAAE,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInG,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIhC,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA+BvE,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAuInD"}

package/dist/integrations/platform/linear/integration.js

@@ -1,7 +1,9 @@
 import { PlatformApiClient, PlatformApiError, logPlatformInfo, logPlatformWarn, platformApiClientConfigFromEnv } from "../api-client.js";
-import { buildLinearRoutes } from "../../linear/routes.js";
 import { attachLinearRules } from "../../linear/rules.js";
+import { attachLinearIssueReconciler } from "../../linear/issue-reconciler.js";
+import { buildLinearRoutes } from "../../linear/routes.js";
 import { buildLinearAgentTools } from "../../linear/agent-tools.js";
+import { PlatformLinearEventWorker } from "./event-worker.js";
 import { registerApiRoute } from "@mastra/core/server";
 //#region src/integrations/platform/linear/integration.ts
 const API_PREFIX = "/v1/server/linear";
@@ -241,6 +243,30 @@ var PlatformLinearIntegration = class {
 			checkedAt: Date.now()
 		};
 	}
+	workers(ctx) {
+		const pollingEnabled = process.env.MASTRACODE_PLATFORM_LINEAR_POLLING_ENABLED?.trim().toLowerCase() !== "false";
+		const reconcileEnabled = process.env.MASTRACODE_LINEAR_RECONCILE_ENABLED?.trim().toLowerCase() !== "false";
+		if (!pollingEnabled && !reconcileEnabled) return [];
+		const ingest = attachLinearRules(ctx);
+		const reconcile = reconcileEnabled ? attachLinearIssueReconciler(this, ctx) : void 0;
+		const workItems = ctx.rules?.workItems;
+		if (!workItems) return [];
+		if (!ingest && !reconcile) return [];
+		const pollIntervalMs = optionalPositiveIntegerEnv("MASTRACODE_PLATFORM_LINEAR_POLLING_INTERVAL_MS");
+		const reconcileIntervalMs = optionalPositiveIntegerEnv("MASTRACODE_LINEAR_RECONCILE_INTERVAL_MS");
+		return [new PlatformLinearEventWorker({
+			client: this.#client,
+			linear: { listWorkspaces: () => this.listWorkspaces() },
+			storage: ctx.storage.generic,
+			projects: ctx.storage.projects,
+			workItems,
+			...ingest ? { ingestFactoryIssue: ingest } : {},
+			...reconcile ? { reconcileFactoryState: reconcile } : {},
+			pollEventsEnabled: pollingEnabled,
+			...pollIntervalMs !== void 0 ? { intervalMs: pollIntervalMs } : {},
+			...reconcileIntervalMs !== void 0 ? { reconcileIntervalMs } : {}
+		})];
+	}
 	routes(ctx) {
 		return [this.#connectRoute(ctx), ...buildLinearRoutes({
 			auth: ctx.auth,
@@ -313,6 +339,9 @@ var PlatformLinearIntegration = class {
 			}));
 		}))).flat();
 	}
+	async listWorkspaces() {
+		return this.#listWorkspaces();
+	}
 	async #listWorkspaces() {
 		return (await this.#client.request("GET", `${API_PREFIX}/workspaces`)).workspaces.filter((workspace) => workspace.connected);
 	}
@@ -477,6 +506,13 @@ function requireLinearConnection(connection) {
 function isNotFound(error) {
 	return error instanceof PlatformApiError && error.status === 404;
 }
+function optionalPositiveIntegerEnv(name) {
+	const value = process.env[name]?.trim();
+	if (!value) return void 0;
+	const parsed = Number(value);
+	if (!Number.isSafeInteger(parsed) || parsed <= 0) throw new Error(`${name} must be a positive integer.`);
+	return parsed;
+}
 //#endregion
 export { PlatformLinearIntegration };